mirrors/core-lightning
1
0
Fork 0
mirror of https://github.com/ElementsProject/lightning.git synced 2024-11-19 09:54:16 +01:00
Code Issues Projects Releases Wiki Activity
d32433a553
core-lightning/doc/schemas/lightning-listpeerchannels.json
ShahanaFarooqui f92a4ccea5 doc: Updated json examples in schema files
2024-08-09 23:56:45 -07:00

1653 lines
60 KiB
JSON
Raw Blame History

{
"$schema": "../rpc-schema-draft.json",
"type": "object",
"additionalProperties": false,
"added": "v23.02",
"rpc": "listpeerchannels",
"title": "Command returning data on channels of connected lightning nodes",
"description": [
"The **listpeerchannels** RPC command returns list of this node's channels, with the possibility to filter them by peer's node id.",
"",
"If no *id* is supplied, then channel data on all lightning nodes that are connected, or not connected but have open channels with this node, are returned."
],
"categories": [
"readonly"
],
"request": {
"required": [],
"properties": {
"id": {
"type": "pubkey",
"description": [
"If supplied, limits the channels to just the peer with the given ID, if it exists."
]
}
}
},
"response": {
"required": [
"channels"
],
"properties": {
"channels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"required": [
"state",
"opener",
"features",
"peer_connected",
"peer_id"
],
"properties": {
"peer_id": {
"type": "pubkey",
"description": [
"Node Public key."
]
},
"peer_connected": {
"type": "boolean",
"description": [
"A boolean flag that is set to true if the peer is online."
]
},
"reestablished": {
"type": "boolean",
"added": "v24.02",
"description": [
"A boolean flag that is set to true if we have successfully exchanged reestablish messages with this connection."
]
},
"state": {
"type": "string",
"enum": [
"OPENINGD",
"CHANNELD_AWAITING_LOCKIN",
"CHANNELD_NORMAL",
"CHANNELD_SHUTTING_DOWN",
"CLOSINGD_SIGEXCHANGE",
"CLOSINGD_COMPLETE",
"AWAITING_UNILATERAL",
"FUNDING_SPEND_SEEN",
"ONCHAIN",
"DUALOPEND_OPEN_INIT",
"DUALOPEND_AWAITING_LOCKIN",
"CHANNELD_AWAITING_SPLICE",
"DUALOPEND_OPEN_COMMITTED",
"DUALOPEND_OPEN_COMMIT_READY"
],
"description": [
"The channel state, in particular `CHANNELD_NORMAL` means the channel can be used normally."
]
},
"scratch_txid": {
"type": "txid",
"description": [
"The txid we would use if we went onchain now."
]
},
"channel_type": {
"type": "object",
"description": [
"Channel_type as negotiated with peer."
],
"added": "v23.05",
"additionalProperties": false,
"required": [
"bits",
"names"
],
"properties": {
"bits": {
"type": "array",
"description": [
"Each bit set in this channel_type."
],
"items": {
"type": "u32",
"description": [
"Bit number."
]
}
},
"names": {
"type": "array",
"description": [
"Feature name for each bit set in this channel_type. Note that *anchors_zero_fee_htlc_tx* is a deprecated synonym for *anchors*."
],
"items": {
"type": "string",
"enum": [
"static_remotekey/even",
"anchor_outputs/even",
"anchors/even",
"anchors_zero_fee_htlc_tx/even",
"scid_alias/even",
"zeroconf/even"
],
"description": [
"Name of feature bit."
]
}
}
}
},
"updates": {
"type": "object",
"added": "v24.02",
"description": [
"Latest gossip updates sent/received."
],
"additionalProperties": false,
"required": [
"local"
],
"properties": {
"local": {
"type": "object",
"description": [
"Our gossip for channel."
],
"additionalProperties": false,
"added": "v24.02",
"required": [
"htlc_minimum_msat",
"htlc_maximum_msat",
"cltv_expiry_delta",
"fee_base_msat",
"fee_proportional_millionths"
],
"properties": {
"htlc_minimum_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Minimum msat amount we allow."
]
},
"htlc_maximum_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Maximum msat amount we allow."
]
},
"cltv_expiry_delta": {
"type": "u32",
"added": "v24.02",
"description": [
"Blocks delay required between incoming and outgoing HTLCs."
]
},
"fee_base_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Amount we charge to use the channel."
]
},
"fee_proportional_millionths": {
"type": "u32",
"added": "v24.02",
"description": [
"Amount we charge to use the channel in parts-per-million."
]
}
}
},
"remote": {
"type": "object",
"added": "v24.02",
"description": [
"Peer's gossip for channel."
],
"additionalProperties": false,
"required": [
"htlc_minimum_msat",
"htlc_maximum_msat",
"cltv_expiry_delta",
"fee_base_msat",
"fee_proportional_millionths"
],
"properties": {
"htlc_minimum_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Minimum msat amount they allow."
]
},
"htlc_maximum_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Maximum msat amount they allow."
]
},
"cltv_expiry_delta": {
"type": "u32",
"added": "v24.02",
"description": [
"Blocks delay required between incoming and outgoing HTLCs."
]
},
"fee_base_msat": {
"type": "msat",
"added": "v24.02",
"description": [
"Amount they charge to use the channel."
]
},
"fee_proportional_millionths": {
"type": "u32",
"added": "v24.02",
"description": [
"Amount they charge to use the channel in parts-per-million."
]
}
}
}
}
},
"ignore_fee_limits": {
"type": "boolean",
"added": "v23.08",
"description": [
"Set if we allow this peer to set fees to anything they want."
]
},
"lost_state": {
"type": "boolean",
"added": "v24.02",
"description": [
"Set if we are fallen behind i.e. lost some channel state."
]
},
"feerate": {
"type": "object",
"description": [
"Feerates for the current tx."
],
"additionalProperties": false,
"required": [
"perkw",
"perkb"
],
"properties": {
"perkw": {
"type": "u32",
"description": [
"Feerate per 1000 weight (i.e kSipa)."
]
},
"perkb": {
"type": "u32",
"description": [
"Feerate per 1000 virtual bytes."
]
}
}
},
"owner": {
"type": "string",
"description": [
"The current subdaemon controlling this connection."
]
},
"short_channel_id": {
"type": "short_channel_id",
"description": [
"The short_channel_id (once locked in)."
]
},
"channel_id": {
"type": "hash",
"description": [
"The full channel_id (funding txid Xored with output number)."
]
},
"funding_txid": {
"type": "txid",
"description": [
"ID of the funding transaction."
]
},
"funding_outnum": {
"type": "u32",
"description": [
"The 0-based output number of the funding transaction which opens the channel."
]
},
"initial_feerate": {
"type": "string",
"description": [
"For inflight opens, the first feerate used to initiate the channel open."
]
},
"last_feerate": {
"type": "string",
"description": [
"For inflight opens, the most recent feerate used on the channel open."
]
},
"next_feerate": {
"type": "string",
"description": [
"For inflight opens, the next feerate we'll use for the channel open."
]
},
"next_fee_step": {
"type": "u32",
"description": [
"For inflight opens, the next feerate step we'll use for the channel open."
]
},
"inflight": {
"type": "array",
"description": [
"Current candidate funding transactions."
],
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"funding_txid",
"funding_outnum",
"feerate",
"total_funding_msat",
"splice_amount",
"our_funding_msat"
],
"properties": {
"funding_txid": {
"type": "txid",
"description": [
"ID of the funding transaction."
]
},
"funding_outnum": {
"type": "u32",
"description": [
"The 0-based output number of the funding transaction which opens the channel."
]
},
"feerate": {
"type": "string",
"description": [
"The feerate for this funding transaction in per-1000-weight, with `kpw` appended."
]
},
"total_funding_msat": {
"type": "msat",
"description": [
"Total amount in the channel."
]
},
"splice_amount": {
"type": "integer",
"added": "v23.08",
"description": [
"The amount of sats we're splicing in or out."
]
},
"our_funding_msat": {
"type": "msat",
"description": [
"Amount we have in the channel."
]
},
"scratch_txid": {
"type": "txid",
"description": [
"The commitment transaction txid we would use if we went onchain now."
]
}
}
}
},
"close_to": {
"type": "hex",
"description": [
"ScriptPubkey which we have to close to if we mutual close."
]
},
"private": {
"type": "boolean",
"description": [
"If True, we will not announce this channel."
]
},
"opener": {
"type": "string",
"enum": [
"local",
"remote"
],
"description": [
"Who initiated the channel."
]
},
"closer": {
"type": "string",
"enum": [
"local",
"remote"
],
"description": [
"Who initiated the channel close (only present if closing)."
]
},
"features": {
"type": "array",
"items": {
"type": "string",
"enum": [
"option_static_remotekey",
"option_anchor_outputs",
"option_anchors",
"option_anchors_zero_fee_htlc_tx",
"option_scid_alias",
"option_zeroconf"
],
"description": [
"BOLT #9 features which apply to this channel. Note that *anchors_zero_fee_htlc_tx* is a deprecated synonym for *anchors*."
]
}
},
"funding": {
"type": "object",
"additionalProperties": false,
"required": [
"local_funds_msat",
"remote_funds_msat"
],
"properties": {
"pushed_msat": {
"type": "msat",
"description": [
"Amount pushed from opener to peer."
]
},
"local_funds_msat": {
"type": "msat",
"description": [
"Amount of channel we funded."
]
},
"remote_funds_msat": {
"type": "msat",
"description": [
"Amount of channel they funded."
]
},
"fee_paid_msat": {
"type": "msat",
"description": [
"Amount we paid peer at open."
]
},
"fee_rcvd_msat": {
"type": "msat",
"description": [
"Amount we were paid by peer at open."
]
}
}
},
"to_us_msat": {
"type": "msat",
"description": [
"How much of channel is owed to us."
]
},
"min_to_us_msat": {
"type": "msat",
"description": [
"Least amount owed to us ever. If the peer were to successfully steal from us, this is the amount we would still retain."
]
},
"max_to_us_msat": {
"type": "msat",
"description": [
"Most amount owed to us ever. If we were to successfully steal from the peer, this is the amount we could potentially get."
]
},
"total_msat": {
"type": "msat",
"description": [
"Total amount in the channel."
]
},
"fee_base_msat": {
"type": "msat",
"description": [
"Amount we charge to use the channel."
]
},
"fee_proportional_millionths": {
"type": "u32",
"description": [
"Amount we charge to use the channel in parts-per-million."
]
},
"dust_limit_msat": {
"type": "msat",
"description": [
"Minimum amount for an output on the channel transactions."
]
},
"max_total_htlc_in_msat": {
"type": "msat",
"description": [
"Max amount accept in a single payment."
]
},
"their_reserve_msat": {
"type": "msat",
"description": [
"Minimum we insist they keep in channel. If they have less than this in the channel, they cannot send to us on that channel."
],
"default": "1% of the total channel capacity"
},
"our_reserve_msat": {
"type": "msat",
"description": [
"Minimum they insist we keep in channel. If you have less than this in the channel, you cannot send out via this channel."
]
},
"spendable_msat": {
"type": "msat",
"description": [
"An estimate of the total we could send through channel (can be wrong because adding HTLCs requires an increase in fees paid to onchain miners, and onchain fees change dynamically according to onchain activity)."
]
},
"receivable_msat": {
"type": "msat",
"description": [
"An estimate of the total peer could send through channel."
]
},
"minimum_htlc_in_msat": {
"type": "msat",
"description": [
"The minimum amount HTLC we accept."
]
},
"minimum_htlc_out_msat": {
"type": "msat",
"description": [
"The minimum amount HTLC we will send."
]
},
"maximum_htlc_out_msat": {
"type": "msat",
"description": [
"The maximum amount HTLC we will send."
]
},
"their_to_self_delay": {
"type": "u32",
"description": [
"The number of blocks before they can take their funds if they unilateral close."
]
},
"our_to_self_delay": {
"type": "u32",
"description": [
"The number of blocks before we can take our funds if we unilateral close."
]
},
"max_accepted_htlcs": {
"type": "u32",
"description": [
"Maximum number of incoming HTLC we will accept at once."
]
},
"alias": {
"type": "object",
"required": [],
"properties": {
"local": {
"type": "short_channel_id",
"description": [
"An alias assigned by this node to this channel, used for outgoing payments."
]
},
"remote": {
"type": "short_channel_id",
"description": [
"An alias assigned by the remote node to this channel, usable in routehints and invoices."
]
}
}
},
"state_changes": {
"type": "array",
"description": [
"Prior state changes."
],
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"timestamp",
"old_state",
"new_state",
"cause",
"message"
],
"properties": {
"timestamp": {
"type": "string",
"description": [
"UTC timestamp of form YYYY-mm-ddTHH:MM:SS.%03dZ."
]
},
"old_state": {
"type": "string",
"enum": [
"OPENINGD",
"CHANNELD_AWAITING_LOCKIN",
"CHANNELD_NORMAL",
"CHANNELD_SHUTTING_DOWN",
"CLOSINGD_SIGEXCHANGE",
"CLOSINGD_COMPLETE",
"AWAITING_UNILATERAL",
"FUNDING_SPEND_SEEN",
"ONCHAIN",
"DUALOPEND_OPEN_INIT",
"DUALOPEND_AWAITING_LOCKIN",
"DUALOPEND_OPEN_COMMITTED",
"DUALOPEND_OPEN_COMMIT_READY",
"CHANNELD_AWAITING_SPLICE"
],
"description": [
"Previous state."
]
},
"new_state": {
"type": "string",
"enum": [
"OPENINGD",
"CHANNELD_AWAITING_LOCKIN",
"CHANNELD_NORMAL",
"CHANNELD_SHUTTING_DOWN",
"CLOSINGD_SIGEXCHANGE",
"CLOSINGD_COMPLETE",
"AWAITING_UNILATERAL",
"FUNDING_SPEND_SEEN",
"ONCHAIN",
"DUALOPEND_OPEN_INIT",
"DUALOPEND_AWAITING_LOCKIN",
"DUALOPEND_OPEN_COMMITTED",
"DUALOPEND_OPEN_COMMIT_READY",
"CHANNELD_AWAITING_SPLICE"
],
"description": [
"New state."
]
},
"cause": {
"type": "string",
"enum": [
"unknown",
"local",
"user",
"remote",
"protocol",
"onchain"
],
"description": [
"What caused the change."
]
},
"message": {
"type": "string",
"description": [
"Human-readable explanation."
]
}
}
}
},
"status": {
"type": "array",
"items": {
"type": "string",
"description": [
"Billboard log of significant changes."
]
}
},
"in_payments_offered": {
"type": "u64",
"description": [
"Number of incoming payment attempts."
]
},
"in_offered_msat": {
"type": "msat",
"description": [
"Total amount of incoming payment attempts."
]
},
"in_payments_fulfilled": {
"type": "u64",
"description": [
"Number of successful incoming payment attempts."
]
},
"in_fulfilled_msat": {
"type": "msat",
"description": [
"Total amount of successful incoming payment attempts."
]
},
"out_payments_offered": {
"type": "u64",
"description": [
"Number of outgoing payment attempts."
]
},
"out_offered_msat": {
"type": "msat",
"description": [
"Total amount of outgoing payment attempts."
]
},
"out_payments_fulfilled": {
"type": "u64",
"description": [
"Number of successful outgoing payment attempts."
]
},
"out_fulfilled_msat": {
"type": "msat",
"description": [
"Total amount of successful outgoing payment attempts."
]
},
"last_stable_connection": {
"type": "u64",
"added": "v24.02",
"description": [
"Last time we reestablished the open channel and stayed connected for 1 minute."
]
},
"htlcs": {
"type": "array",
"description": [
"Current HTLCs in this channel."
],
"items": {
"type": "object",
"additionalProperties": true,
"required": [
"direction",
"id",
"amount_msat",
"expiry",
"payment_hash",
"state"
],
"properties": {
"direction": {
"type": "string",
"added": "v23.02",
"enum": [
"in",
"out"
],
"description": [
"Whether it came from peer, or is going to peer."
]
},
"id": {
"type": "u64",
"description": [
"Unique ID for this htlc on this channel in this direction."
]
},
"amount_msat": {
"type": "msat",
"description": [
"Amount send/received for this HTLC."
]
},
"expiry": {
"type": "u32",
"description": [
"Block this HTLC expires at (after which an `in` direction HTLC will be returned to the peer, an `out` returned to us). If this expiry is too close, lightningd(8) will automatically unilaterally close the channel in order to enforce the timeout onchain."
]
},
"payment_hash": {
"type": "hash",
"description": [
"The hash of the payment_preimage which will prove payment."
]
},
"local_trimmed": {
"type": "boolean",
"enum": [
true
],
"description": [
"If this is too small to enforce onchain; it doesn't appear in the commitment transaction and will not be enforced in a unilateral close. Generally true if the HTLC (after subtracting onchain fees) is below the `dust_limit_msat` for the channel."
]
},
"status": {
"type": "string",
"description": [
"Set if this HTLC is currently waiting on a hook (and shows what plugin)."
]
}
},
"allOf": [
{
"if": {
"properties": {
"direction": {
"enum": [
"out"
]
}
}
},
"then": {
"additionalProperties": false,
"required": [
"state"
],
"properties": {
"direction": {},
"id": {},
"amount_msat": {},
"msatoshi": {},
"expiry": {},
"payment_hash": {},
"local_trimmed": {},
"status": {},
"alias": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"state": {
"type": "string",
"enum": [
"SENT_ADD_HTLC",
"SENT_ADD_COMMIT",
"RCVD_ADD_REVOCATION",
"RCVD_ADD_ACK_COMMIT",
"SENT_ADD_ACK_REVOCATION",
"RCVD_REMOVE_HTLC",
"RCVD_REMOVE_COMMIT",
"SENT_REMOVE_REVOCATION",
"SENT_REMOVE_ACK_COMMIT",
"RCVD_REMOVE_ACK_REVOCATION"
],
"description": [
"Status of the HTLC."
]
}
}
}
},
{
"if": {
"properties": {
"direction": {
"enum": [
"in"
]
}
}
},
"then": {
"additionalProperties": false,
"required": [
"state"
],
"properties": {
"direction": {},
"id": {},
"amount_msat": {},
"msatoshi": {},
"expiry": {},
"payment_hash": {},
"local_trimmed": {},
"status": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"state": {
"type": "string",
"enum": [
"RCVD_ADD_HTLC",
"RCVD_ADD_COMMIT",
"SENT_ADD_REVOCATION",
"SENT_ADD_ACK_COMMIT",
"RCVD_ADD_ACK_REVOCATION",
"SENT_REMOVE_HTLC",
"SENT_REMOVE_COMMIT",
"RCVD_REMOVE_REVOCATION",
"RCVD_REMOVE_ACK_COMMIT",
"SENT_REMOVE_ACK_REVOCATION"
],
"description": [
"Status of the HTLC."
]
}
}
}
}
]
}
}
},
"allOf": [
{
"if": {
"properties": {
"peer_connected": {
"type": "boolean",
"enum": [
true
]
}
}
},
"then": {
"properties": {
"reestablished": {
"type": "boolean",
"description": [
"True if we have successfully exchanged reestablish messages this connection."
]
}
}
}
},
{
"if": {
"required": [
"close_to"
]
},
"then": {
"additionalProperties": false,
"required": [],
"properties": {
"state": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"scratch_txid": {},
"channel_type": {},
"feerate": {},
"ignore_fee_limits": {},
"lost_state": {},
"owner": {},
"short_channel_id": {},
"channel_id": {},
"updates": {},
"funding_txid": {},
"funding_outnum": {},
"close_to": {},
"private": {},
"alias": {},
"opener": {},
"closer": {},
"features": {},
"funding": {},
"to_us_msat": {},
"min_to_us_msat": {},
"max_to_us_msat": {},
"total_msat": {},
"fee_base_msat": {},
"fee_proportional_millionths": {},
"dust_limit_msat": {},
"max_total_htlc_in_msat": {},
"their_reserve_msat": {},
"our_reserve_msat": {},
"spendable_msat": {},
"receivable_msat": {},
"minimum_htlc_in_msat": {},
"minimum_htlc_out_msat": {},
"maximum_htlc_out_msat": {},
"spendable_msatoshi": {},
"receivable_msatoshi": {},
"their_to_self_delay": {},
"our_to_self_delay": {},
"max_accepted_htlcs": {},
"msatoshi_to_us": {},
"msatoshi_to_us_min": {},
"msatoshi_to_us_max": {},
"msatoshi_total": {},
"dust_limit_satoshis": {},
"max_htlc_value_in_flight_msat": {},
"our_channel_reserve_satoshis": {},
"their_channel_reserve_satoshis": {},
"spendable_satoshis": {},
"receivable_satoshis": {},
"htlc_minimum_msat": {},
"state_changes": {},
"status": {},
"in_payments_offered": {},
"in_offered_msat": {},
"in_msatoshi_offered": {},
"in_payments_fulfilled": {},
"in_fulfilled_msat": {},
"in_msatoshi_fulfilled": {},
"out_payments_offered": {},
"out_offered_msat": {},
"out_msatoshi_offered": {},
"out_payments_fulfilled": {},
"out_fulfilled_msat": {},
"out_msatoshi_fulfilled": {},
"last_stable_connection": {},
"htlcs": {},
"initial_feerate": {},
"last_feerate": {},
"next_feerate": {},
"inflight": {},
"last_tx_fee_msat": {},
"direction": {},
"close_to_addr": {
"type": "string",
"description": [
"The bitcoin address we will close to (present if close_to_addr is a standardized address)."
]
}
}
}
},
{
"if": {
"required": [
"scratch_txid"
]
},
"then": {
"additionalProperties": false,
"required": [
"last_tx_fee_msat"
],
"properties": {
"state": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"alias": {},
"scratch_txid": {},
"channel_type": {},
"feerate": {},
"ignore_fee_limits": {},
"lost_state": {},
"owner": {},
"short_channel_id": {},
"channel_id": {},
"updates": {},
"funding_txid": {},
"funding_outnum": {},
"inflight": {},
"close_to": {},
"private": {},
"opener": {},
"closer": {},
"features": {},
"funding": {},
"to_us_msat": {},
"min_to_us_msat": {},
"max_to_us_msat": {},
"total_msat": {},
"fee_base_msat": {},
"fee_proportional_millionths": {},
"dust_limit_msat": {},
"max_total_htlc_in_msat": {},
"their_reserve_msat": {},
"our_reserve_msat": {},
"spendable_msat": {},
"receivable_msat": {},
"minimum_htlc_in_msat": {},
"minimum_htlc_out_msat": {},
"maximum_htlc_out_msat": {},
"spendable_msatoshi": {},
"receivable_msatoshi": {},
"their_to_self_delay": {},
"our_to_self_delay": {},
"max_accepted_htlcs": {},
"msatoshi_to_us": {},
"msatoshi_to_us_min": {},
"msatoshi_to_us_max": {},
"msatoshi_total": {},
"dust_limit_satoshis": {},
"max_htlc_value_in_flight_msat": {},
"our_channel_reserve_satoshis": {},
"their_channel_reserve_satoshis": {},
"spendable_satoshis": {},
"receivable_satoshis": {},
"htlc_minimum_msat": {},
"state_changes": {},
"status": {},
"in_payments_offered": {},
"in_offered_msat": {},
"in_msatoshi_offered": {},
"in_payments_fulfilled": {},
"in_fulfilled_msat": {},
"in_msatoshi_fulfilled": {},
"out_payments_offered": {},
"out_offered_msat": {},
"out_msatoshi_offered": {},
"out_payments_fulfilled": {},
"out_fulfilled_msat": {},
"out_msatoshi_fulfilled": {},
"last_stable_connection": {},
"htlcs": {},
"initial_feerate": {},
"last_feerate": {},
"next_feerate": {},
"close_to_addr": {},
"direction": {},
"last_tx_fee_msat": {
"type": "msat",
"description": [
"Fee attached to this the current tx."
]
}
}
}
},
{
"if": {
"required": [
"short_channel_id"
]
},
"then": {
"additionalProperties": false,
"required": [
"direction"
],
"properties": {
"alias": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"state": {},
"scratch_txid": {},
"channel_type": {},
"feerate": {},
"ignore_fee_limits": {},
"lost_state": {},
"owner": {},
"short_channel_id": {},
"channel_id": {},
"updates": {},
"funding_txid": {},
"funding_outnum": {},
"inflight": {},
"close_to": {},
"private": {},
"opener": {},
"closer": {},
"features": {},
"funding": {},
"to_us_msat": {},
"min_to_us_msat": {},
"max_to_us_msat": {},
"total_msat": {},
"fee_base_msat": {},
"fee_proportional_millionths": {},
"dust_limit_msat": {},
"max_total_htlc_in_msat": {},
"their_reserve_msat": {},
"our_reserve_msat": {},
"spendable_msat": {},
"receivable_msat": {},
"minimum_htlc_in_msat": {},
"minimum_htlc_out_msat": {},
"maximum_htlc_out_msat": {},
"spendable_msatoshi": {},
"receivable_msatoshi": {},
"their_to_self_delay": {},
"our_to_self_delay": {},
"max_accepted_htlcs": {},
"msatoshi_to_us": {},
"msatoshi_to_us_min": {},
"msatoshi_to_us_max": {},
"msatoshi_total": {},
"dust_limit_satoshis": {},
"max_htlc_value_in_flight_msat": {},
"our_channel_reserve_satoshis": {},
"their_channel_reserve_satoshis": {},
"spendable_satoshis": {},
"receivable_satoshis": {},
"htlc_minimum_msat": {},
"state_changes": {},
"status": {},
"in_payments_offered": {},
"in_offered_msat": {},
"in_msatoshi_offered": {},
"in_payments_fulfilled": {},
"in_fulfilled_msat": {},
"in_msatoshi_fulfilled": {},
"out_payments_offered": {},
"out_offered_msat": {},
"out_msatoshi_offered": {},
"out_payments_fulfilled": {},
"out_fulfilled_msat": {},
"out_msatoshi_fulfilled": {},
"last_stable_connection": {},
"htlcs": {},
"initial_feerate": {},
"last_feerate": {},
"next_feerate": {},
"close_to_addr": {},
"last_tx_fee_msat": {},
"direction": {
"type": "u32",
"added": "v23.02",
"description": [
"0 if we're the lesser node_id, 1 if we're the greater (as used in BOLT #7 channel_update)."
]
}
}
}
},
{
"if": {
"required": [
"inflight"
]
},
"then": {
"additionalProperties": false,
"required": [
"initial_feerate",
"last_feerate",
"next_feerate"
],
"properties": {
"state": {},
"peer_id": {},
"peer_connected": {},
"reestablished": {},
"scratch_txid": {},
"channel_type": {},
"feerate": {},
"ignore_fee_limits": {},
"lost_state": {},
"owner": {},
"alias": {},
"short_channel_id": {},
"channel_id": {},
"updates": {},
"funding_txid": {},
"funding_outnum": {},
"close_to": {},
"private": {},
"opener": {},
"closer": {},
"features": {},
"funding": {},
"to_us_msat": {},
"min_to_us_msat": {},
"max_to_us_msat": {},
"total_msat": {},
"fee_base_msat": {},
"fee_proportional_millionths": {},
"dust_limit_msat": {},
"max_total_htlc_in_msat": {},
"their_reserve_msat": {},
"our_reserve_msat": {},
"spendable_msat": {},
"receivable_msat": {},
"minimum_htlc_in_msat": {},
"minimum_htlc_out_msat": {},
"maximum_htlc_out_msat": {},
"spendable_msatoshi": {},
"receivable_msatoshi": {},
"their_to_self_delay": {},
"our_to_self_delay": {},
"max_accepted_htlcs": {},
"msatoshi_to_us": {},
"msatoshi_to_us_min": {},
"msatoshi_to_us_max": {},
"msatoshi_total": {},
"dust_limit_satoshis": {},
"max_htlc_value_in_flight_msat": {},
"our_channel_reserve_satoshis": {},
"their_channel_reserve_satoshis": {},
"spendable_satoshis": {},
"receivable_satoshis": {},
"htlc_minimum_msat": {},
"state_changes": {},
"status": {},
"in_payments_offered": {},
"in_offered_msat": {},
"in_msatoshi_offered": {},
"in_payments_fulfilled": {},
"in_fulfilled_msat": {},
"in_msatoshi_fulfilled": {},
"out_payments_offered": {},
"out_offered_msat": {},
"out_msatoshi_offered": {},
"out_payments_fulfilled": {},
"out_fulfilled_msat": {},
"out_msatoshi_fulfilled": {},
"last_stable_connection": {},
"htlcs": {},
"inflight": {},
"close_to_addr": {},
"direction": {},
"last_tx_fee_msat": {},
"initial_feerate": {
"type": "string",
"description": [
"The feerate for the initial funding transaction in per-1000-weight, with `kpw` appended."
]
},
"last_feerate": {
"type": "string",
"description": [
"The feerate for the latest funding transaction in per-1000-weight, with `kpw` appended."
]
},
"next_feerate": {
"type": "string",
"description": [
"The minimum feerate for the next funding transaction in per-1000-weight, with `kpw` appended."
]
}
}
}
}
]
}
}
},
"post_return_value_notes": [
"The *state* field values (and *old_state* / *new_state*) are worth describing further:",
"",
" * `OPENINGD`: The channel funding protocol with the peer is ongoing and both sides are negotiating parameters.",
" * `DUALOPEND_OPEN_INIT`: Like `OPENINGD`, but for v2 connections which are using collaborative opens.",
" * `DUALOPEND_OPEN_COMMIT_READY`: Like `OPENINGD`, but for v2 connections which are using collaborative opens. You're ready to send your commitment signed to your peer.",
" * `DUALOPEND_OPEN_COMMITTED`: Like `OPENINGD`, but for v2 connections which are using collaborative opens. You've gotten an initial signed commitment from your peer.",
" * `CHANNELD_AWAITING_LOCKIN` / `DUALOPEND_AWAITING_LOCKIN`: The peer and you have agreed on channel parameters and are just waiting for the channel funding transaction to be confirmed deeply (original and collaborative open protocols, respectively). Both you and the peer must acknowledge the channel funding transaction to be confirmed deeply before entering the next state. Also, you can increase the onchain fee for channels in `DUALOPEND_AWAITING_LOCKIN` using lightning-openchannel_bump(7).",
" * `CHANNELD_NORMAL`: The channel can be used for normal payments.",
" * `CHANNELD_SHUTTING_DOWN`: A mutual close was requested (by you or peer) and both of you are waiting for HTLCs in-flight to be either failed or succeeded. The channel can no longer be used for normal payments and forwarding. Mutual close will proceed only once all HTLCs in the channel have either been fulfilled or failed.",
" * `CLOSINGD_SIGEXCHANGE`: You and the peer are negotiating the mutual close onchain fee.",
" * `CLOSINGD_COMPLETE`: You and the peer have agreed on the mutual close onchain fee and are awaiting the mutual close getting confirmed deeply.",
" * `AWAITING_UNILATERAL`: You initiated a unilateral close, and are now waiting for the peer-selected unilateral close timeout to complete.",
" * `FUNDING_SPEND_SEEN`: You saw the funding transaction getting spent (usually the peer initiated a unilateral close) and will now determine what exactly happened (i.e. if it was a theft attempt).",
" * `ONCHAIN`: You saw the funding transaction getting spent and now know what happened (i.e. if it was a proper unilateral close by the peer, or a theft attempt)."
]
},
"errors": [
"On error the returned object will contain `code` and `message` properties, with `code` being one of the following:",
"",
"- -32602: If the given parameters are wrong."
],
"author": [
"Michael Hawkins <<michael.hawkins@protonmail.com>>."
],
"see_also": [
"lightning-connect(7)",
"lightning-fundchannel_start(7)"
],
"resources": [
"Main web site: <https://github.com/ElementsProject/lightning>",
"Lightning RFC site (BOLT #9): ",
"<https://github.com/lightningnetwork/lightning-rfc/blob/master/09-features.md>"
],
"examples": [
{
"request": {
"id": "example:listpeerchannels#1",
"method": "listpeerchannels",
"params": {
"id": "022d223620a359a47ff7f7ac447c85c46c923da53389221a0054c11c1e3ca31d59"
}
},
"response": {
"channels": [
{
"peer_id": "022d223620a359a47ff7f7ac447c85c46c923da53389221a0054c11c1e3ca31d59",
"peer_connected": true,
"reestablished": true,
"channel_type": {
"bits": [
12,
22
],
"names": [
"static_remotekey/even",
"anchors/even"
]
},
"updates": {
"local": {
"htlc_minimum_msat": 0,
"htlc_maximum_msat": 990000000,
"cltv_expiry_delta": 6,
"fee_base_msat": 1,
"fee_proportional_millionths": 10
},
"remote": {
"htlc_minimum_msat": 0,
"htlc_maximum_msat": 990000000,
"cltv_expiry_delta": 6,
"fee_base_msat": 1,
"fee_proportional_millionths": 10
}
},
"last_stable_connection": 1722303707,
"state": "CHANNELD_NORMAL",
"scratch_txid": "80aa008578b3b6924f2362146907e46ad83351d5b9b056bd8537befc3f1d7d65",
"last_tx_fee_msat": 4221000,
"lost_state": false,
"feerate": {
"perkw": 3755,
"perkb": 15020
},
"owner": "channeld",
"short_channel_id": "109x1x1",
"direction": 1,
"channel_id": "252d1b0a1e57895e84137f28cf19ab2c35847e284c112fefdecc7afeaa5c1de7",
"funding_txid": "737d6835ddafd515ba9e9def733bb4e4211f6053a32b1422bf1c8cc240850f96",
"funding_outnum": 1,
"close_to_addr": "bcrt1p8c0ku4mpxq3443rss8e6rjwamztvv8yxvmxtetal5d0n6v39rlwqvfqy6n",
"close_to": "51203e1f6e576130235ac47081f3a1c9ddd896c61c8666ccbcafbfa35f3d32251fdc",
"private": false,
"opener": "local",
"alias": {
"local": "2240075x4300189x56636",
"remote": "3321841x5311416x1695"
},
"features": [
"option_static_remotekey",
"option_anchors_zero_fee_htlc_tx",
"option_anchors"
],
"funding": {
"local_funds_msat": 1000000000,
"remote_funds_msat": 0,
"pushed_msat": 0
},
"to_us_msat": 490518792,
"min_to_us_msat": 489918792,
"max_to_us_msat": 1000000000,
"total_msat": 1000000000,
"fee_base_msat": 1,
"fee_proportional_millionths": 10,
"dust_limit_msat": 546000,
"max_total_htlc_in_msat": 18446744073709552000,
"their_reserve_msat": 10000000,
"our_reserve_msat": 10000000,
"spendable_msat": 469223792,
"receivable_msat": 499481208,
"minimum_htlc_in_msat": 0,
"minimum_htlc_out_msat": 0,
"maximum_htlc_out_msat": 990000000,
"their_to_self_delay": 5,
"our_to_self_delay": 5,
"max_accepted_htlcs": 483,
"state_changes": [
{
"timestamp": "2024-07-30T01:40:45.942Z",
"old_state": "DUALOPEND_OPEN_COMMITTED",
"new_state": "DUALOPEND_AWAITING_LOCKIN",
"cause": "user",
"message": "Sigs exchanged, waiting for lock-in"
},
{
"timestamp": "2024-07-30T01:40:47.619Z",
"old_state": "DUALOPEND_AWAITING_LOCKIN",
"new_state": "CHANNELD_NORMAL",
"cause": "user",
"message": "Lockin complete"
}
],
"status": [
"CHANNELD_NORMAL:Channel ready for use."
],
"in_payments_offered": 1,
"in_offered_msat": 1000000,
"in_payments_fulfilled": 1,
"in_fulfilled_msat": 1000000,
"out_payments_offered": 10,
"out_offered_msat": 510501210,
"out_payments_fulfilled": 8,
"out_fulfilled_msat": 510481208,
"htlcs": []
}
]
}
},
{
"request": {
"id": "example:listpeerchannels#2",
"method": "listpeerchannels",
"params": {}
},
"response": {
"channels": [
{
"peer_id": "022d223620a359a47ff7f7ac447c85c46c923da53389221a0054c11c1e3ca31d59",
"peer_connected": true,
"reestablished": true,
"channel_type": {
"bits": [
12,
22
],
"names": [
"static_remotekey/even",
"anchors/even"
]
},
"updates": {
"local": {
"htlc_minimum_msat": 0,
"htlc_maximum_msat": 990000000,
"cltv_expiry_delta": 6,
"fee_base_msat": 1,
"fee_proportional_millionths": 10
},
"remote": {
"htlc_minimum_msat": 0,
"htlc_maximum_msat": 990000000,
"cltv_expiry_delta": 6,
"fee_base_msat": 1,
"fee_proportional_millionths": 10
}
},
"last_stable_connection": 1722303707,
"state": "CHANNELD_NORMAL",
"scratch_txid": "80aa008578b3b6924f2362146907e46ad83351d5b9b056bd8537befc3f1d7d65",
"last_tx_fee_msat": 4221000,
"lost_state": false,
"feerate": {
"perkw": 3755,
"perkb": 15020
},
"owner": "channeld",
"short_channel_id": "109x1x1",
"direction": 1,
"channel_id": "252d1b0a1e57895e84137f28cf19ab2c35847e284c112fefdecc7afeaa5c1de7",
"funding_txid": "737d6835ddafd515ba9e9def733bb4e4211f6053a32b1422bf1c8cc240850f96",
"funding_outnum": 1,
"close_to_addr": "bcrt1p8c0ku4mpxq3443rss8e6rjwamztvv8yxvmxtetal5d0n6v39rlwqvfqy6n",
"close_to": "51203e1f6e576130235ac47081f3a1c9ddd896c61c8666ccbcafbfa35f3d32251fdc",
"private": false,
"opener": "local",
"alias": {
"local": "2240075x4300189x56636",
"remote": "3321841x5311416x1695"
},
"features": [
"option_static_remotekey",
"option_anchors_zero_fee_htlc_tx",
"option_anchors"
],
"funding": {
"local_funds_msat": 1000000000,
"remote_funds_msat": 0,
"pushed_msat": 0
},
"to_us_msat": 490518792,
"min_to_us_msat": 489918792,
"max_to_us_msat": 1000000000,
"total_msat": 1000000000,
"fee_base_msat": 1,
"fee_proportional_millionths": 10,
"dust_limit_msat": 546000,
"max_total_htlc_in_msat": 18446744073709552000,
"their_reserve_msat": 10000000,
"our_reserve_msat": 10000000,
"spendable_msat": 469223792,
"receivable_msat": 499481208,
"minimum_htlc_in_msat": 0,
"minimum_htlc_out_msat": 0,
"maximum_htlc_out_msat": 990000000,
"their_to_self_delay": 5,
"our_to_self_delay": 5,
"max_accepted_htlcs": 483,
"state_changes": [
{
"timestamp": "2024-07-30T01:40:45.942Z",
"old_state": "DUALOPEND_OPEN_COMMITTED",
"new_state": "DUALOPEND_AWAITING_LOCKIN",
"cause": "user",
"message": "Sigs exchanged, waiting for lock-in"
},
{
"timestamp": "2024-07-30T01:40:47.619Z",
"old_state": "DUALOPEND_AWAITING_LOCKIN",
"new_state": "CHANNELD_NORMAL",
"cause": "user",
"message": "Lockin complete"
}
],
"status": [
"CHANNELD_NORMAL:Channel ready for use."
],
"in_payments_offered": 1,
"in_offered_msat": 1000000,
"in_payments_fulfilled": 1,
"in_fulfilled_msat": 1000000,
"out_payments_offered": 10,
"out_offered_msat": 510501210,
"out_payments_fulfilled": 8,
"out_fulfilled_msat": 510481208,
"htlcs": []
}
]
}
}
]
}
Reference in New Issue View Git Blame Copy Permalink