ListSinceBlock/查询指定区块后发生的钱包交易

listsinceblock调用返回指定区块之后发生的与钱包相关的所有交易。 该调用需要节点启用钱包功能。

参数

• HeaderHash：区块哈希
• TargetConfirmations：目标确认数，默认值：1
• IncludeWatchOnly：是否包含watch-only地址，默认值：false

返回值

listsinceblock调用返回一个描述对象，其结构如下：

• transactions：交易数组，成员对象的结构如下：
  • involvesWatchOnly：是否包含watch-only地址
    • account：账户名称
    • address：地址
    • category：交易类别：
      • send：发送交易
        • receive：接收交易
        • generate：成熟币基交易
        • immature：未成熟币基交易
        • orphan：孤儿块币基交易
    • amount：数量，负数表示支付，整数表示接收支付
    • vout：交易输出序号
    • fee：手续费
    • confirmations：确认数
    • generated：是否币基交易
    • blockhash：区块哈希
    • blockindex：区块序号
    • blocktime：区块时间戳
    • txid：交易id
    • walletconflicts：冲突交易数组，成员为交易ID
    • time：交易打包时间戳
    • timereceived：节点接收到交易时刻的时间戳
    • bip125-replaceable：是否可调换交易
    • comment：备注信息
    • to：目标备注信息
• lastblock： 前一个区块的哈希

示例代码

下面的命令返回自指定区块之后发生的与钱包有关的交易列表：

~$ bitcoin-cli -testnet listsinceblock \
              00000000688633a503f69818a70eac281302e9189b1bb57a76a05c329fcda718 \
              6 true

输出结果如下：

{
    "transactions" : [
        {
            "account" : "doc test",
            "address" : "mmXgiR6KAhZCyQ8ndr2BCfEq1wNG2UnyG6",
            "category" : "receive",
            "amount" : 0.10000000,
            "vout" : 0,
            "confirmations" : 76478,
            "blockhash" : "000000000017c84015f254498c62a7c884a51ccd75d4dd6dbdcb6434aa3bd44d",
            "blockindex" : 1,
            "blocktime" : 1399294967,
            "txid" : "85a98fdf1529f7d5156483ad020a51b7f3340e47448cf932f470b72ff01a6821",
            "walletconflicts" : [
            ],
            "time" : 1399294967,
            "timereceived" : 1418924714,
            "bip125-replaceable": "no"        
        },
        {
            "involvesWatchonly" : true,
            "account" : "someone else's address2",
            "address" : "n3GNqMveyvaPvUbH469vDRadqpJMPc84JA",
            "category" : "receive",
            "amount" : 0.00050000,
            "vout" : 0,
            "confirmations" : 34714,
            "blockhash" : "00000000bd0ed80435fc9fe3269da69bb0730ebb454d0a29128a870ea1a37929",
            "blockindex" : 11,
            "blocktime" : 1411051649,
            "txid" : "99845fd840ad2cc4d6f93fafb8b072d188821f55d9298772415175c456f3077d",
            "walletconflicts" : [
            ],
            "time" : 1418695703,
            "timereceived" : 1418925580,
            "bip125-replaceable": "no"
        }
    ],
    "lastblock" : "0000000000984add1a686d513e66d25686572c7276ec3e358a7e3e9f7eb88619"
}