如何在bitcoin core里查询特定地址的utxo？

[hold1btc]

我最近遇到一个问题，我运行了一个bitcoin core的全节点，但我想在里面查询特定地址的utxo，网上和chatgpt给的方法都失败了，不知道有没有方法能查询到？

[editor-Ajian]

我查找了bitcoin core 的 RPC 命令并自己做了测试，下列方法可能对你有用。

总的来说这个方法分三个步骤：（1）在 bitcoin core 中创建一个新的空钱包；（2）为这个空钱包导入你要观察的地址（然后选择一种扫描区块链的方法）；（3）列出钱包的 UTXO。

如果你使用命令行窗口来运行 bitcoin core（即 bitcoind），那么你需要在命令行窗口中输入下述命令及其参数（注意，每一次输入都需要带上 bitcoin-cli 作为前缀；如果你使用的是图形化界面（即 bitcoin GUI），你需要找到 “控制台” 功能，并在输入框中输入下述命令及其参数。

在 bitcoin core 中生成空钱包

使用命令：

createwallet "wallet_name" true true ''

createwallet 会创建一个新的钱包，它可以带上许多参数。除了这个钱包的名字之外，这里只使用了三个参数，分别表示 “禁用私钥”、“空钱包” 以及 “不设加密口令”。

生成新钱包之后，最好使用 listwallets 看看现在软件加载了几个钱包，并使用 unloadwallet 命令解除加载别的钱包。这将保证在后续步骤中观察地址必定导入这个空钱包，以及扫描的时候负担较小。

导入观察地址并扫描

使用命令：

importaddress "bc1qxxxxx" "target1" false false

这里除了输入地址之外，后面的三个参数分别是：这个地址的标签（此后你可根据这个标签找回这个地址，或根据标签给地址分群）、是否重新扫描区块链以获得这个地址的 UTXO、是否也导入这个地址的 P2SH 版本。

在这里比较关键的是第二个参数：是否重新扫描。在这里我选择了 false。这是因为，这里的重新扫描将从创世区块开始，如果你的机器性能不够强，这个过程可能会很花时间。

但是，重新扫描是个必要的步骤，如不扫描，就不可能获得这个地址的 UTXO。我的方法是使用 rescanblockchain 命令。这个命令允许你指定重新扫描的起始区块高度和终点区块高度（都只需输入数字即可：

rescanblockchain start_height stop_height

如果你知道这个地址的历史（它最早从什么时候开始收到资金），就可以输入一个起始的区块高度；即使这个数字不是绝对准确，也可以大大加快扫描的速度。终点高度设为最新区块高度即可。

扫描可能要花费一些时间

列出未花费的余额

直接使用：

listunspent

就可以获得你当前所加载的钱包的 UTXO（这个钱包只有你导入的地址，所以只会得到这个地址的 UTXO）。

如果你的 bitcoin core 当前不止加载了一个钱包，那么你可以通过输入更多参数，来指定查找哪个地址的 UTXO。

listunspent 6 9999999 '["addresss154897414635743"]'

前面的两个参数指定的是：只返回至少得到 6 个确认，最多得到 9999999 个确认的 UTXO。第三个参数就是你要观察的地址。

关于这些命令的参数以及输入方法，可以在 https://developer.bitcoin.org/reference/rpc/ 得到解释和输入范例。这里的四种方法的参考：

[1] https://developer.bitcoin.org/reference/rpc/createwallet.html?highlight=createwallet
[2] https://developer.bitcoin.org/reference/rpc/importaddress.html?highlight=importaddress
[3] https://developer.bitcoin.org/reference/rpc/rescanblockchain.html?highlight=rescanblockchain
[4] https://developer.bitcoin.org/reference/rpc/listunspent.html?highlight=listunspent

[hold1btc]

非常感谢阿建老师的详细解答，成功了。