Skip to content

doc: document error 313 where it can actually be returned #9474

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nepet wants to merge 2 commits into
base: master
Choose a base branch
from
+36 −14
Open

doc: document error 313 where it can actually be returned #9474

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ea04898
doc: fix wording of the min-emergency-msat error description
nepet Sep 2, 2026
6f42233
doc: document error 313 on every command which can return it
nepet Sep 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 18 additions & 7 deletions contrib/msggen/msggen/schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15008,7 +15008,7 @@
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The output amount is too small, and would be considered dust.",
"- 303: Broadcasting of the funding transaction failed, the internal call to bitcoin-cli returned with an error.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have or are opening anchor channels).",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels).",
"",
"Failure may also occur if **lightningd** and the peer cannot agree on channel parameters (funding limits, channel reserves, fees, etc.)."
],
Expand Down Expand Up @@ -16087,7 +16087,8 @@
"",
"- -32602: If the given parameters are wrong.",
"- -1: Catchall nonspecific error.",
"- 301: Insufficient UTXOs to meet *satoshi* value."
"- 301: Insufficient UTXOs to meet *satoshi* value.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down Expand Up @@ -30692,7 +30693,7 @@
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The output amount is too small, and would be considered dust.",
"- 303: Broadcasting of the funding transaction failed, the internal call to bitcoin-cli returned with an error.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have or are opening anchor channels).",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels).",
"",
"Failure may also occur if **lightningd** and the peer cannot agree on channel parameters (funding limits, channel reserves, fees, etc.). See lightning-fundchannel_start(7) and lightning-fundchannel_complete(7).",
"",
Expand Down Expand Up @@ -30937,7 +30938,8 @@
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met."
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"ZmnSCPxj [ZmnSCPxj@protonmail.com](mailto:ZmnSCPxj@protonmail.com) is mainly responsible."
Expand Down Expand Up @@ -38460,7 +38462,8 @@
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met."
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down Expand Up @@ -38832,6 +38835,13 @@
}
}
},
"errors": [
"On failure, an error is reported and no transaction is created.",
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"usage": [
"The caller is trying to buy a liquidity ad but the command keeps failing. They have funds in their wallet, but they're all P2SH-wrapped outputs.",
"",
Expand Down Expand Up @@ -39067,7 +39077,8 @@
"",
"- -32602: If the given parameters are wrong.",
"- -1: Catchall nonspecific error.",
"- 301: Insufficient UTXOs to meet *satoshi* value."
"- 301: Insufficient UTXOs to meet *satoshi* value.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down Expand Up @@ -40958,7 +40969,7 @@
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have anchor channels)."
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"Felix [fixone@gmail.com](mailto:fixone@gmail.com) is mainly responsible."
Expand Down
2 changes: 1 addition & 1 deletion doc/schemas/fundchannel.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The output amount is too small, and would be considered dust.",
"- 303: Broadcasting of the funding transaction failed, the internal call to bitcoin-cli returned with an error.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have or are opening anchor channels).",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels).",
"",
"Failure may also occur if **lightningd** and the peer cannot agree on channel parameters (funding limits, channel reserves, fees, etc.)."
],
Expand Down
3 changes: 2 additions & 1 deletion doc/schemas/fundpsbt.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -194,7 +194,8 @@
"",
"- -32602: If the given parameters are wrong.",
"- -1: Catchall nonspecific error.",
"- 301: Insufficient UTXOs to meet *satoshi* value."
"- 301: Insufficient UTXOs to meet *satoshi* value.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down
2 changes: 1 addition & 1 deletion doc/schemas/multifundchannel.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,7 +313,7 @@
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The output amount is too small, and would be considered dust.",
"- 303: Broadcasting of the funding transaction failed, the internal call to bitcoin-cli returned with an error.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have or are opening anchor channels).",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels).",
"",
"Failure may also occur if **lightningd** and the peer cannot agree on channel parameters (funding limits, channel reserves, fees, etc.). See lightning-fundchannel_start(7) and lightning-fundchannel_complete(7).",
"",
Expand Down
3 changes: 2 additions & 1 deletion doc/schemas/multiwithdraw.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,8 @@
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met."
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"ZmnSCPxj [ZmnSCPxj@protonmail.com](mailto:ZmnSCPxj@protonmail.com) is mainly responsible."
Expand Down
3 changes: 2 additions & 1 deletion doc/schemas/txprepare.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,8 @@
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met."
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down
7 changes: 7 additions & 0 deletions doc/schemas/upgradewallet.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,13 @@
}
}
},
"errors": [
"On failure, an error is reported and no transaction is created.",
"",
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"usage": [
"The caller is trying to buy a liquidity ad but the command keeps failing. They have funds in their wallet, but they're all P2SH-wrapped outputs.",
"",
Expand Down
3 changes: 2 additions & 1 deletion doc/schemas/utxopsbt.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -191,7 +191,8 @@
"",
"- -32602: If the given parameters are wrong.",
"- -1: Catchall nonspecific error.",
"- 301: Insufficient UTXOs to meet *satoshi* value."
"- 301: Insufficient UTXOs to meet *satoshi* value.",
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have or are opening anchor channels)."
],
"author": [
"Rusty Russell [rusty@rustcorp.com.au](mailto:rusty@rustcorp.com.au) is mainly responsible."
Expand Down
2 changes: 1 addition & 1 deletion doc/schemas/withdraw.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@
"- -1: Catchall nonspecific error.",
"- 301: There are not enough funds in the internal wallet (including fees) to create the transaction.",
"- 302: The dust limit is not met.",
"- 313: The `min-emergency-msat` reserve not be preserved (and we have anchor channels)."
"- 313: The `min-emergency-msat` reserve could not be preserved (and we have anchor channels)."
],
"author": [
"Felix [fixone@gmail.com](mailto:fixone@gmail.com) is mainly responsible."
Expand Down
Loading