比特币派生子地址收款后主地址余额未更新，请求排查原因

核心误解：主地址与子地址的关系 #

比特币HD钱包的主地址和子地址是独立的区块链地址，各自拥有独立的未花费交易输出（UTXO）。主地址的余额仅统计直接打入该地址的资金，不会自动包含子地址的收款。你需要通过根密钥对应的整个HD钱包，查询所有派生地址的总余额，才能看到钱包的全部资金。

代码存在的问题及修正方案 #

现存问题 #

1. 混用bip32utils和bitcoinlib两个HD密钥处理库，存在兼容性风险；
2. 派生路径不符合比特币标准：未使用硬化派生（路径带'），既存在私钥泄露风险，也可能导致主流钱包无法识别该子地址属于你的根钱包；
3. 未通过钱包工具统一管理地址，无法自动汇总所有派生地址的资金。

修正后的代码（统一用bitcoinlib实现） #

from bitcoinlib.mnemonic import Mnemonic
from bitcoinlib.wallets import Wallet

# 导入你的助记词
from data.config import SECRET_PHRASE_BTC

# 从助记词生成种子并创建HD钱包
mnemo = Mnemonic('english')
seed = mnemo.to_seed(SECRET_PHRASE_BTC)
# 创建钱包，默认遵循比特币标准派生路径（m/0'/0/0、m/0'/0/1...）
wallet = Wallet.create('my_btc_wallet', seed, network='bitcoin')

# 生成第一个外部链子地址（用于收款）
child_address = wallet.get_key().address
print(f"子地址: {child_address}")

# 查询钱包总余额（包含所有派生地址的资金）
total_balance = wallet.balance()
print(f"钱包总余额: {total_balance} satoshi")

# 单独查询主地址（m/0'/0/0）的余额
main_key = wallet.get_key(path="m/0'/0/0")
main_balance = main_key.balance()
print(f"主地址余额: {main_balance} satoshi")

说明 #

• 子地址收款后，调用wallet.balance()即可查看钱包所有地址的总资金，主地址余额仍仅显示直接打入它的资金；
• 若你之前用旧代码生成的子地址属于同一根密钥派生，导入相同助记词到该钱包后，会自动识别并统计该子地址的资金。

内容的提问来源于stack exchange，提问作者blankerino