2
0
mirror of https://github.com/lnbook/lnbook synced 2024-11-15 00:15:05 +00:00
lnbook/failure_types_table.asciidoc
2021-11-10 10:52:34 -08:00

41 lines
2.7 KiB
Plaintext

[[failure_types_table]]
.Onion error failure types
[options="header"]
|===
| Type | Symbolic name | Meaning
| PERM\|1 | +invalid_realm+ | The `realm` byte was not understood by the processing node
| NODE\|2 | +temporary_node_failure+ | General temporary failure of the processing node
| PERM\|NODE\|2 | +permanent_node_failure+ | General permanent failure of the processing node
| PERM\|NODE\|3 | +required_node_feature_missing+ | The processing node has a required feature which was not in this onion
| BADONION\|PERM\|4 | +invalid_onion_version+ | The `version` byte was not understood by the processing node
| BADONION\|PERM\|5 | +invalid_onion_hmac+ | The HMAC of the onion was incorrect when it reached the processing node
| BADONION\|PERM\|6 | +invalid_onion_key+ | The ephemeral key was unparsable by the processing node
| UPDATE\|7 | +temporary_channel_failure+ | The channel from the processing node was unable to handle this HTLC,
but may be able to handle it, or others, later
| PERM\|8 | +permanent_channel_failure+ | The channel from the processing node is unable to handle any HTLCs
| PERM\|9 | +required_channel_feature_missing+ | The channel from the processing node requires features not present in
the onion
| PERM\|10 | +unknown_next_peer+ | The onion specified a `short_channel_id` which doesn't match any
leading from the processing node
| UPDATE\|11 | +amount_below_minimum+ | The HTLC amount was below the `htlc_minimum_msat` of the channel from
the processing node
| UPDATE\|12 | +fee_insufficient+ | The fee amount was below that required by the channel from the
processing node
| UPDATE\|13 | +incorrect_cltv_expiry+ | The `cltv_expiry` does not comply with the `cltv_expiry_delta` required by
the channel from the processing node
| UPDATE\|14 | +expiry_too_soon+ | The CLTV expiry is too close to the current block height for safe
handling by the processing node
| PERM\|15 | +incorrect_or_unknown_payment_details+ | The `payment_hash` is unknown to the final node, the `payment_secret` doesn't
match the `payment_hash`, the amount for that `payment_hash` is incorrect, or
the CLTV expiry of the HTLC is too close to the current block height for safe
handling
| 18 | +final_incorrect_cltv_expiry+ | The CLTV expiry in the HTLC doesn't match the value in the onion
| 19 | +final_incorrect_htlc_amount+ | The amount in the HTLC doesn't match the value in the onion
| UPDATE\|20 | +channel_disabled+ | The channel from the processing node has been disabled
| 21 | +expiry_too_far+ | The CLTV expiry in the HTLC is too far in the future
| PERM\|22 | +invalid_onion_payload+ | The decrypted onion per-hop payload was not understood by the processing node
or is incomplete
| 23 | +mpp_timeout+ | The complete amount of the multipart payment was not received within a
reasonable time
|===