davide/palladum-lightning
1
0
Fork 0
Code Issues Pull Requests Actions 5 Packages Projects Releases Wiki Activity
Files
main
palladum-lightning/doc/schemas/listchainmoves.json

555 lines
19 KiB
JSON
Raw Permalink Normal View History

lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
{
"$schema": "../rpc-schema-draft.json",
"type": "object",
"rpc": "listchainmoves",
"title": "Command to get the audit list of all onchain coin movements.",
"added": "v25.09",
"description": [
"The **listchainmoves** command returns the confirmed balance changes onchain over time."
],
"categories": [
"readonly"
],
"request": {
"required": [],
"additionalProperties": false,
"properties": {
"index": {
"type": "string",
"enum": [
"created"
],
"description": [
"How to interpret `start` and `limit`"
]
},
"start": {
"type": "u64",
"description": [
"If `index` is specified, `start` may be specified to start from that value, which is generally returned from lightning-wait(7)."
]
},
"limit": {
"type": "u32",
"description": [
"If `index` is specified, `limit` can be used to specify the maximum number of entries to return."
]
}
},
"dependentUpon": {
"index": [
"start",
"limit"
]
}
},
"response": {
"required": [
"chainmoves"
],
"additionalProperties": false,
"properties": {
"chainmoves": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
lightningd: add chainmoves and channelmoves to wait command. Only makes sense to wait on creation, since they neither are deleted nor updated. We also enhance the list commands to take the standard index options. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Changelog-Added: JSON-RPC: `wait`: new subsystems `chainmoves` and `channelmoves`.
2025-08-19 10:30:46 +09:30
"created_index",
lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
"account_id",
"primary_tag",
"extra_tags",
"credit_msat",
"debit_msat",
"timestamp",
"utxo",
"output_msat",
"blockheight"
],
"properties": {
lightningd: add chainmoves and channelmoves to wait command. Only makes sense to wait on creation, since they neither are deleted nor updated. We also enhance the list commands to take the standard index options. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Changelog-Added: JSON-RPC: `wait`: new subsystems `chainmoves` and `channelmoves`.
2025-08-19 10:30:46 +09:30
"created_index": {
"type": "u64",
"description": [
"1-based index indicating order this move was created in."
]
},
lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
"account_id": {
"type": "string",
"description": [
"This is either the channel_id corresponding to the channel involved, or a string such as `wallet` for the internal wallet, or `external` for some other external source."
]
},
"credit_msat": {
"type": "msat",
"description": [
"Amount credited (one of this or debit_msat is zero)"
]
},
"debit_msat": {
"type": "msat",
"description": [
"Amount debited (one of this or credit_msat is zero)"
]
},
"timestamp": {
"type": "u64",
"description": [
"Time of this event in seconds since January 1 1970 UTC"
]
},
"primary_tag": {
"type": "string",
"enum": [
"deposit",
"withdrawal",
"penalty",
"channel_open",
"channel_close",
"delayed_to_us",
"htlc_tx",
"htlc_timeout",
"htlc_fulfill",
"to_wallet",
"anchor",
"to_them",
"penalized",
"stolen",
common: reintroduce "ignored" primary tag. Prior to 23.05, we used this tag to mark onchain to-self inputs we didn't wait for (because they were too small). This fixes migration if that happened (and we are debating whether we should re-introduce this!). ``` lightningd: FATAL SIGNAL 6 (version v25.09rc2) 0x100c8683 send_backtrace common/daemon.c:33 0x100c876f crashdump common/daemon.c:78 0x7fffb2080493 ??? ???:0 0x7fffb1ab0cac ??? __pthread_kill_implementation+0x1bc:0 0x7fffb1a48a5b ??? __GI_raise+0x2b:0 0x7fffb1a2a3db ??? __GI_abort+0x153:0 0x100935b7 migrate_from_account_db wallet/account_migration.c:424 0x10093ff7 db_migrate wallet/db.c:1139 0x10096763 db_setup wallet/db.c:1185 0x100a1bcb wallet_new wallet/wallet.c:223 0x1004485f main lightningd/lightningd.c:1311 0x7fffb1a2aba3 ??? __libc_start_call_main+0x93:0 0x7fffb1a2adeb ??? __libc_start_main_alias_1+0x1ab:0 0xffffffffffffffff ??? ???:0 lightningd: Died with signal 6 ``` Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> Fixes: https://github.com/ElementsProject/lightning/issues/8484
2025-08-28 10:10:37 +09:30
"ignored",
lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
"to_miner"
],
"description": [
"A set of one or more tags defining the nature of the change"
]
},
"extra_tags": {
"type": "array",
"items": {
"type": "string",
"enum": [
"opener",
"leased",
"stealable",
common: use "foreign" in extra_tags to indicate a chain movement is injected. This allows the bookkeeper plugin to know it's not actually a channel account. Remove the "ignored" tag from the schema too: we removed it previously. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:50 +09:30
"splice",
"foreign"
lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
]
},
"description": [
"A set of additional tags expanding on the details"
]
},
"peer_id": {
"type": "pubkey",
"description": [
"The lightning peer associated with this onchain event"
]
},
"originating_account": {
"type": "string",
"description": [
"This is either a channel_id corresponding to the source channel involved, or a string such as `wallet` for the internal wallet."
]
},
"spending_txid": {
"type": "txid",
"description": [
"The transaction ID which did the spending."
]
},
"utxo": {
"type": "outpoint",
"description": [
"The txid and outpoint number spent for this balance change."
]
},
"payment_hash": {
"type": "hash",
"description": [
"The payment hash associated with this balance change."
]
},
"output_msat": {
"type": "msat",
"description": [
"The output amount (always a whole number of sats). Note that in some cases (e.g. channel opens), not all these belong to us."
]
},
"output_count": {
"type": "u32",
"description": [
"The number of outputs in the `txid` (so you can tell once you've seen events for all of them)."
]
},
"blockheight": {
"type": "u32",
"description": [
"The block number where `txid` appeared (alternately, where `utxo` was spent)."
]
}
}
}
}
}
},
"errors": [
"On failure, one of the following error codes may be returned:",
"",
"- -32602: Error in given parameters."
],
"resources": [
docs: Updated schema for mdx compatibility Changelog-Fixed: Ensure documentation renders correctly when adding/updating new RPCs by detecting non-MDX-compatible pages.
2025-12-17 11:30:56 -08:00
"Main web site: [https://github.com/ElementsProject/lightning](https://github.com/ElementsProject/lightning)"
autogenerate-rpc-examples.py: add examples for listchainmoves and listchannelmoves. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-10-23 10:09:12 +10:30
],
"examples": [
{
"request": {
"id": "example:listchainmoves#1",
"method": "listchainmoves",
"params": {}
},
"response": {
"chainmoves": [
{
"created_index": 1,
"account_id": "wallet",
"credit_msat": 200000000000,
"debit_msat": 0,
"timestamp": 1758192762,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "994185cba7723715c0aa1d1859ce2781116776cea917035c90f8f04c9f4e095e:1",
"output_msat": 200000000000,
"blockheight": 104
},
{
"created_index": 2,
"account_id": "252d1b0a1e57895e84137f28cf19ab2c35847e284c112fefdecc7afeaa5c1de7",
"credit_msat": 0,
"debit_msat": 0,
"timestamp": 1758192777,
"primary_tag": "channel_open",
"extra_tags": [],
"utxo": "542906c8a9d90596592459a9484f4286a3200f6540599c83b43af2ac4166c6ca:1",
"peer_id": "nodeid010101010101010101010101010101010101010101010101010101010101",
"output_msat": 1000000000,
"blockheight": 109
},
{
"created_index": 3,
"account_id": "wallet",
"credit_msat": 2000000000,
"debit_msat": 0,
"timestamp": 1758192780,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "19e9e42f2f2097ea1dc18d7eb670bc53c90cbe31bb1daba8e94abf3c6b60d2dc:1",
"output_msat": 2000000000,
"blockheight": 110
},
{
"created_index": 4,
"account_id": "wallet",
"credit_msat": 0,
"debit_msat": 200000000000,
"timestamp": 1738530000,
"primary_tag": "withdrawal",
"extra_tags": [],
"utxo": "994185cba7723715c0aa1d1859ce2781116776cea917035c90f8f04c9f4e095e:1",
"spending_txid": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc",
"output_msat": 200000000000,
"blockheight": 111
},
{
"created_index": 5,
"account_id": "wallet",
"credit_msat": 198995073000,
"debit_msat": 0,
"timestamp": 1738530000,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc:1",
"output_msat": 198995073000,
"blockheight": 111
},
{
"created_index": 6,
"account_id": "a397dd9b3e44afcb67f3f3ce1d649b74a8ade63e35505985e4cc1828634f69a2",
"credit_msat": 1000000000,
"debit_msat": 0,
"timestamp": 1738530000,
"primary_tag": "channel_open",
"extra_tags": [
"opener"
],
"utxo": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc:0",
"peer_id": "nodeid030303030303030303030303030303030303030303030303030303030303",
"output_msat": 1000000000,
"blockheight": 111
},
{
"created_index": 7,
"account_id": "wallet",
"credit_msat": 2000000000,
"debit_msat": 0,
"timestamp": 1758192792,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "b6d0090efbeb347fa59f90b321d6906cdf86779c15477582979fa427249f71f5:1",
"output_msat": 2000000000,
"blockheight": 114
},
{
"created_index": 8,
"account_id": "wallet",
"credit_msat": 0,
"debit_msat": 198995073000,
"timestamp": 1758192795,
"primary_tag": "withdrawal",
"extra_tags": [],
"utxo": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc:1",
"spending_txid": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec",
"output_msat": 198995073000,
"blockheight": 115
},
{
"created_index": 9,
"account_id": "wallet",
"credit_msat": 197990453000,
"debit_msat": 0,
"timestamp": 1758192795,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec:0",
"output_msat": 197990453000,
"blockheight": 115
},
{
"created_index": 10,
"account_id": "f8fc83a432cbfb2fffe222cc06727fdd977b5dd10ebd6707158e799e6f522d9f",
"credit_msat": 1000000000,
"debit_msat": 0,
"timestamp": 1758192795,
"primary_tag": "channel_open",
"extra_tags": [
"opener"
],
"utxo": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec:1",
"peer_id": "nodeid050505050505050505050505050505050505050505050505050505050505",
"output_msat": 1000000000,
"blockheight": 115
},
{
"created_index": 11,
"account_id": "wallet",
"credit_msat": 486914000,
"debit_msat": 0,
"timestamp": 1738520000,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "874b26d4c523a902fdc44b88ec000eb5c3fe8754c9d44190a140561e24e77781:0",
"output_msat": 486914000,
"blockheight": 121
},
{
"created_index": 12,
"account_id": "a397dd9b3e44afcb67f3f3ce1d649b74a8ade63e35505985e4cc1828634f69a2",
"credit_msat": 0,
"debit_msat": 489809898,
"timestamp": 1738520000,
"primary_tag": "channel_close",
"extra_tags": [],
"utxo": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc:0",
"spending_txid": "txid010101010101010101010101010101010101010101010101010101010101",
"output_msat": 1000000000,
"output_count": 2,
"blockheight": 121
},
{
"created_index": 13,
"account_id": "external",
"credit_msat": 510190000,
"debit_msat": 0,
"timestamp": 1738520000,
"primary_tag": "to_them",
"extra_tags": [],
"utxo": "874b26d4c523a902fdc44b88ec000eb5c3fe8754c9d44190a140561e24e77781:1",
"originating_account": "channelid0230000230000230000230000230000230000230000230000230000",
"output_msat": 510190000,
"blockheight": 121
},
{
"created_index": 14,
"account_id": "wallet",
"credit_msat": 2000000000,
"debit_msat": 0,
"timestamp": 1758192808,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "c9c9bec064382b6a6fb2a30d8923949b3c9f732465542b96e9ad1b5eebda4c7d:0",
"output_msat": 2000000000,
"blockheight": 122
},
{
"created_index": 15,
"account_id": "wallet",
"credit_msat": 0,
"debit_msat": 197990453000,
"timestamp": 1738500000,
"primary_tag": "withdrawal",
"extra_tags": [],
"utxo": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec:0",
"spending_txid": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682",
"output_msat": 197990453000,
"blockheight": 123
},
{
"created_index": 16,
"account_id": "wallet",
"credit_msat": 196985833000,
"debit_msat": 0,
"timestamp": 1738500000,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682:1",
"output_msat": 196985833000,
"blockheight": 123
},
{
"created_index": 17,
"account_id": "channelid0230200230200230200230200230200230200230200230200230200",
"credit_msat": 1000000000,
"debit_msat": 0,
"timestamp": 1738500000,
"primary_tag": "channel_open",
"extra_tags": [
"opener"
],
"utxo": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682:0",
"peer_id": "nodeid030303030303030303030303030303030303030303030303030303030303",
"output_msat": 1000000000,
"blockheight": 123
}
]
}
},
{
"request": {
"id": "example:listchainmoves#2",
"method": "listchainmoves",
"params": {
"index": "created",
"start": 10
}
},
"response": {
"chainmoves": [
{
"created_index": 10,
"account_id": "f8fc83a432cbfb2fffe222cc06727fdd977b5dd10ebd6707158e799e6f522d9f",
"credit_msat": 1000000000,
"debit_msat": 0,
"timestamp": 1758192795,
"primary_tag": "channel_open",
"extra_tags": [
"opener"
],
"utxo": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec:1",
"peer_id": "nodeid050505050505050505050505050505050505050505050505050505050505",
"output_msat": 1000000000,
"blockheight": 115
},
{
"created_index": 11,
"account_id": "wallet",
"credit_msat": 486914000,
"debit_msat": 0,
"timestamp": 1738520000,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "874b26d4c523a902fdc44b88ec000eb5c3fe8754c9d44190a140561e24e77781:0",
"output_msat": 486914000,
"blockheight": 121
},
{
"created_index": 12,
"account_id": "a397dd9b3e44afcb67f3f3ce1d649b74a8ade63e35505985e4cc1828634f69a2",
"credit_msat": 0,
"debit_msat": 489809898,
"timestamp": 1738520000,
"primary_tag": "channel_close",
"extra_tags": [],
"utxo": "94418b652c9a0d79129552d317dcc37cb55afda1387257a22c7f16aa3981b7bc:0",
"spending_txid": "txid010101010101010101010101010101010101010101010101010101010101",
"output_msat": 1000000000,
"output_count": 2,
"blockheight": 121
},
{
"created_index": 13,
"account_id": "external",
"credit_msat": 510190000,
"debit_msat": 0,
"timestamp": 1738520000,
"primary_tag": "to_them",
"extra_tags": [],
"utxo": "874b26d4c523a902fdc44b88ec000eb5c3fe8754c9d44190a140561e24e77781:1",
"originating_account": "channelid0230000230000230000230000230000230000230000230000230000",
"output_msat": 510190000,
"blockheight": 121
},
{
"created_index": 14,
"account_id": "wallet",
"credit_msat": 2000000000,
"debit_msat": 0,
"timestamp": 1758192808,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "c9c9bec064382b6a6fb2a30d8923949b3c9f732465542b96e9ad1b5eebda4c7d:0",
"output_msat": 2000000000,
"blockheight": 122
},
{
"created_index": 15,
"account_id": "wallet",
"credit_msat": 0,
"debit_msat": 197990453000,
"timestamp": 1738500000,
"primary_tag": "withdrawal",
"extra_tags": [],
"utxo": "32de3d1592062670eb8630875a28705cc1988b7f83f8c712bf9d39be2152efec:0",
"spending_txid": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682",
"output_msat": 197990453000,
"blockheight": 123
},
{
"created_index": 16,
"account_id": "wallet",
"credit_msat": 196985833000,
"debit_msat": 0,
"timestamp": 1738500000,
"primary_tag": "deposit",
"extra_tags": [],
"utxo": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682:1",
"output_msat": 196985833000,
"blockheight": 123
},
{
"created_index": 17,
"account_id": "channelid0230200230200230200230200230200230200230200230200230200",
"credit_msat": 1000000000,
"debit_msat": 0,
"timestamp": 1738500000,
"primary_tag": "channel_open",
"extra_tags": [
"opener"
],
"utxo": "0137213d852e76d48f0270a78218d2f562ac0a8974f814cab66376537cfd1682:0",
"peer_id": "nodeid030303030303030303030303030303030303030303030303030303030303",
"output_msat": 1000000000,
"blockheight": 123
}
]
}
}
lightningd: add listchainmoves and listchannelmoves commands. This is where all the previous work pays off: we can access the coinmoves in the db. Changelog-Added: JSON-RPC: `listchainmoves` and `listchannelmoves` commands to access the audit log of coin movements. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2025-08-19 10:30:45 +09:30
]
}
Reference in New Issue Copy Permalink