143 / 691GAP

Gap Limit

连续未使用地址的上限

Gap Limit 决定钱包在恢复时何时停止寻找更多地址。位于一长串未使用地址之后的支付,可能无法被默认扫描发现。

Gap Limit 限定搜索确定性分支时遇到的连续未使用地址数量。它限制的是历史发现,而非可派生密钥数量;超过上限本身不意味着资金在密码学意义上丢失。

已使用地址会打断未使用序列,并重置间隔计数器。以 20 为上限:索引 0 有历史,索引 1–20 没有,扫描便在索引 21 之前停止,可能漏掉该处的支付。这不是整个钱包最多只能有二十个地址。 [BIP 44 — Account discovery and address gap limit]

BIP 44 为外部收款分支的发现规定 Address gap limit 为 20。生成超出此边界的地址时,软件应发出提示。这是特定的恢复约定,而非共识规则,也非所有钱包的强制设置;其他系统可以采用不同范围。 [BIP 44 — Account discovery and address gap limit]

BIP 44 查找的是交易历史,而非正余额。曾收到资金、后来全部花完的地址仍是已使用地址。将空余额误判为未使用地址,可能导致提前停止扫描并漏掉后续支付。 [BIP 44 — Account discovery and address gap limit]

BIP 44 从账户 0 开始检查其外部分支;找到历史后才继续下一个账户。change=0 接收支付,change=1 接收自己的找零。第一个没有历史的账户会终止账户发现,因此标准限制跳过空账户创建后续账户。单个分支的上限不是所有账户共用的计数器。 [BIP 44 — Account discovery and address gap limit]

Electrum FAQ 明确提醒,普通的 seed 恢复可能不会自动找到超出 Gap Limit 生成的地址。文档给出的补救方法是提高上限,或继续派生地址直到已使用的位置。FAQ 中默认 20 的说法针对 Electrum 2.0;这里并未将它当作所有当前钱包的设置。 [Electrum FAQ — Gap limit and generated addresses]

Bitcoin Core 29.0 的 importdescriptors RPC 区分 range、next_index 和 timestamp。派生索引范围不等于遇到未使用地址后的停止规则;next_index 指定下一个生成的索引。timestamp 指定扫描起点。now 不能代替完整历史恢复;文档还包含最早 timestamp 之前最多两小时的区块以及 Mempool。因此,范围正确但扫描历史不合适仍然不够。 [Bitcoin Core 29.0 — importdescriptors RPC]

BIP 32 以确定性方式派生密钥,但搜索必须从正确的钱包、账户、派生路径和脚本类型开始。更大的 Gap Limit 无法修正不同的 seed 或 passphrase。单凭 xpub 也不能派生 hardened 后代;扩大扫描无法补足缺失的派生能力。 [BIP 32 — Hierarchical Deterministic Wallets] [BIP 39 — From mnemonic to seed]

扩大搜索意味着更多派生地址和查询,可能向远程服务器揭示更多钱包关联。恢复应通过已知地址和交易核对,包括已经花掉的收款。扩大扫描既不改变区块链,也不移动币;能否成功还取决于正确的起始信息和可用历史。 [BIP 44 — Account discovery and address gap limit] [Electrum FAQ — Gap limit and generated addresses] [BIP 32 — Hierarchical Deterministic Wallets]

要获得更完整的理解,请将本词条与以下词条结合阅读: HD Wallet, Derivation Path, Extended Public Key (xpub), Output Descriptor, 找零输出. 反向关联还来自: HD Wallet, Derivation Path.

DOC · 001BIP 44 — Account discovery and address gap limit规范DOC · 002Electrum FAQ — Gap limit and generated addresses文档DOC · 003Bitcoin Core 29.0 — importdescriptors RPC文档DOC · 004BIP 32 — Hierarchical Deterministic Wallets规范DOC · 005BIP 39 — From mnemonic to seed规范
来源优先 · 非投资建议