首页 > golang > bitcoin core中RPC接口listtransactions详解
2024
02-13

bitcoin core中RPC接口listtransactions详解

在 Bitcoin Core 客户端中,`listtransactions` 是一个 RPC (远程过程调用) 命令,它用于列出属于特定账户或所有账户的最近交易。这个命令对于查看您的比特币地址上的资金流动非常有用。


以下是 `listtransactions` 命令的一些基本用法:


基本用法

bitcoin-cli listtransactions


这将列出默认账户(通常是 "" 或 "walletname")的所有最近交易。


指定账户

bitcoin-cli listtransactions "account_name"


将 `"account_name"` 替换为您想要查看交易的账户名称。


指定计数

bitcoin-cli listtransactions "account_name" 10


这将列出指定账户的最后10笔交易。


指定从某一笔交易开始

bitcoin_cli listtransactions "account_name" 10 "starting_txid"

将 `"starting_txid"` 替换为您想要作为开始点的交易ID。


包括已花费的交易输出

默认情况下,`listtransactions` 只显示未花费的交易输出(UTXOs)。要包括已花费的输出,可以使用 `include_watchonly` 和 `include_spent` 参数:

bitcoin-cli listtransactions "account_name" 10 0 true true


示例输出

执行 `listtransactions` 命令后,您将得到一个包含交易列表的 JSON 对象,其中每个交易都是对象的一个条目,包含以下信息:


- `account`: 交易发生的账户。

- `address`: 交易发生时使用的比特币地址。

- `category`: 交易类型,如 'send'、'receive'、'move' 等。

- `amount`: 交易的比特币数量,如果是支出则为负数。

- `vout`: 交易输出的序号。

- `fee`: 交易费用。

- `confirmations`: 交易的确认数。

- `txid`: 交易的哈希值。

- `walletconflicts`: 与该交易冲突的其它钱包交易 ID。

- `time`: 交易发生的时间戳。

- `timereceived`: 交易被接收到的时间戳。


注意事项


- 请确保您的 Bitcoin Core 客户端已经完全同步到区块链。

- 如果您的客户端是加密的,您可能需要先解锁钱包才能使用 `bitcoin-cli` 命令。


`listtransactions` 是 Bitcoin Core 提供的众多 RPC 命令之一,它允许用户以编程方式与客户端进行交互,执行各种操作。


本文》有 0 条评论

留下一个回复