Insights on Crypto Payments, Infrastructure, and Operations

Address Gap Limit

Wallets, Custody & Treasury

Pronunciation: AD-dres GAP LIM-it

Also known as: HD Wallet Gap Limit, Discovery Gap Limit

Definition

An address gap limit is the number of consecutive unused derived wallet addresses that certain hierarchical deterministic wallet discovery methods scan before assuming there are no more used addresses. It affects recovery visibility, not the coins' existence.

Overview

Contents Hide
  1. What it means and why it matters
  2. How it works in practice
  3. Technical detail without the jargon
  4. A deeper point to understand
  5. Common mistakes and limitations
  6. What to check in a real payment system
  7. Related concepts
  8. Further reading

What it means and why it matters

An address gap limit is the number of consecutive unused derived wallet addresses that certain hierarchical deterministic wallet discovery methods scan before assuming there are no more used addresses. It affects recovery visibility, not the coins’ existence.

How it works in practice

An HD wallet derives addresses in a deterministic order from account keys. During restoration it scans chain history until a configured run of unused addresses is found. If earlier software created many unused addresses and later used a further address, a limited scan may stop too early.

Technical detail without the jargon

The exact discovery rule depends on wallet software, account type and derivation path. Bitcoin wallet specifications commonly discuss a gap limit of 20 for certain schemes, but this is not universal for every chain or implementation. Changing the path can hide accounts even with the right seed.

A deeper point to understand

Wallet discovery can fail for reasons besides a gap limit, including wrong script type or account derivation. A recovery process should first verify those parameters with a public address known to belong to the wallet. This allows careful troubleshooting without exposing secret recovery material.

Common mistakes and limitations

A missing transaction in the restored interface does not necessarily mean a private key is lost. Conversely, sharing a seed phrase with support staff is never an appropriate recovery step. Increase scan range only in trusted wallet software and verify derivation details.

What to check in a real payment system

When a recovered wallet appears empty, verify network, address script type, derivation path and discovery limit before concluding keys are missing. Search beyond the initial unused-address run only in trusted software. Do not disclose recovery words during troubleshooting.

Crypto Wallet, Private Key, Seed Phrase.

Further reading

BIP-44 — Account Discovery.

Example

A merchant system generates 40 addresses without receiving funds, then accepts a payment to address 41. A recovering wallet that stops after 20 unused addresses may fail to display that later deposit until its discovery settings are adjusted.

Comparison

Gap limit concerns wallet address discovery; address rotation concerns assigning fresh receiving addresses, and account derivation defines how addresses are generated.

Key Takeaway

The exact discovery rule depends on wallet software, account type and derivation path.

Sources

  1. BIP 32: Hierarchical Deterministic Wallets — Bitcoin Improvement Proposals (2026-08-02)
  2. Bitcoin Core getnewaddress RPC — Bitcoin.org (2026-08-02)
  3. Bitcoin Core getrawchangeaddress RPC — Bitcoin.org (2026-08-02)