比特币客户端钱包基础

创建和获取信息

创建钱包

钱包名称可以替换成你自己想要的。

bitcoin-cli -conf="节点配置文件路径" createwallet "wallet_name"

示例输出：

PS C:\Users\26646> bitcoin-cli -conf="C:\Users\26646\AppData\Local\Bitcoin\alice\bitcoin.conf" createwallet "LeavesWallet"  
{  
"name": "LeavesWallet"  
}  

获得钱包信息

bitcoin-cli -conf="节点配置文件路径" getwalletinfo

获得了以下输出：

PS C:\Users\26646> bitcoin-cli -regtest getwalletinfo  
{  
"walletname": "LeavesWallet",  
"walletversion": 169900,  
"format": "sqlite",  
"balance": 0.00000000,  
"unconfirmed_balance": 0.00000000,  
"immature_balance": 0.00000000,  
"txcount": 0,  

# 创建了4000 个内部密钥和外部密钥
"keypoolsize": 4000,  
"keypoolsize_hd_internal": 4000,  

"paytxfee": 0.00000000,  
"private_keys_enabled": true,  
"avoid_reuse": false,  
"scanning": false,  
"descriptors": true,  
"external_signer": false,  
"blank": false,  
"birthtime": 1742799986,  
"lastprocessedblock": {  
"hash": "0f9188f13cb7b2c71f2a335e3a4fc328bf5beb436012afca590b1a11466e2206",  
"height": 0  
}  
}

钱包地址

为钱包创建新地址

关于比特币钱包地址：

1. 一个钱包可以生成多个地址

• 每次调用 getnewaddress 都会生成一个新的地址
• 所有这些地址都属于同一个钱包
• 发送到任何一个地址的比特币都会出现在同一个钱包的余额中

1. 使用多个地址的好处：

• 提高隐私性（每次交易使用不同地址）
• 更好地追踪资金来源
• 方便资金管理（可以为不同用途使用不同地址）

创建新地址，其中的 label 字段是可选项，表示地址的标签说明：

PS C:\Users\26646> bitcoin-cli -conf="节点配置文件路径" getnewaddress "label_string"

示例输出：

bcrt1q8xe3ukkxdmhr74dhgdf9r3cy73cr69cnr4tw0m

输出值即是新地址。

查看钱包内所有地址

这个命令会显示节点的所有地址以及有关的详细信息：

bitcoin-cli -conf="节点配置文件路径" listreceivedbyaddress 0 true

其中：

• 参数 0 表示包含未确认的交易
• 参数 true 表示显示余额为 0 的地址

加载和查看

通过下面的步骤，能看出比特币钱包具有以下几个特征：

• 安全性（可以选择什么时候加载钱包）
• 灵活性（可以在同一个节点上管理多个钱包）
• 资源管理（不需要的钱包可以不加载）

加载已存在的钱包

Caution

通常在终端关闭后，重新载入钱包才能查看余额的情况。如果不先加载，会遭遇 code 18 的报错如下：

C:\Users\26646>bitcoin-cli -conf="C:\Users\26646\AppData\Local\Bitcoin\bob\bitcoin.conf" getbalance
error code: -18
error message:
No wallet is loaded. Load a wallet using loadwallet or create a new one with createwallet. (Note: A default wallet is no longer automatically created)

加载钱包：

bitcoin-cli -conf="节点配置文件路径" loadwallet "wallet_name"

示例输出：

C:\Users\26646>bitcoin-cli -conf="C:\Users\26646\AppData\Local\Bitcoin\alice\bitcoin.conf" loadwallet "alice_wallet"

{
  "name": "alice_wallet"
}

查看当前节点上所有可用的钱包

bitcoin-cli -conf="节点配置文件路径" listwallets

查看钱包目录中的所有钱包文件

bitcoin-cli -conf="节点配置文件路径" listwalletdir

使用

获取余额

1. 查看钱包总余额（最简单的方式）：

bitcoin-cli -conf="节点配置文件路径" getbalance

2. 查看未确认和已确认的余额详细信息：

bitcoin-cli -conf="节点配置文件路径" getbalances

3. 列出所有未花费的交易输出（UTXO）：

bitcoin-cli -conf="节点配置文件路径" listunspent