{
  "$schema": "https://degreesofsatoshi.com/encyclopedia/schemas/article-v1.json",
  "schemaVersion": "1.0.0",
  "id": "bitcoin-wallet-gap-limit",
  "canonical": "https://degreesofsatoshi.com/encyclopedia/bitcoin-wallet-gap-limit/",
  "collection": "bitcoin",
  "title": "Bitcoin wallet gap limits: why an address can be missed during recovery",
  "description": "Learn how Bitcoin address gap limits affect recovery, why later receipts can be missed and how to investigate without exposing the seed.",
  "aliases": [
    "bitcoin wallet gap limit",
    "bitcoin wallet gap limit explained"
  ],
  "dates": {
    "published": "2026-10-02",
    "modified": "2026-10-02",
    "verified": "2026-10-02T19:29:20.637Z",
    "dataAsOf": "2026-10-02"
  },
  "authorship": {
    "publisher": "Degrees of Satoshi editorial project",
    "process": "AI-assisted research and drafting with a separate automated source-verification pass; no external expert or named human review is implied."
  },
  "quickAnswer": {
    "text": "A wallet gap limit tells address discovery when to stop after consecutive unused derived addresses. It prevents an endless search, but a used address beyond a large unused gap can be missed. BIP-44 specifies a 20-address external-chain discovery gap; other wallets and policies can differ. The funds are not deleted when discovery stops—the wallet has not found that part of its address sequence.",
    "claimId": "bitcoin-wallet-gap-limit-quick-answer",
    "sourceIds": [
      "x425-btc-bip44",
      "x425-btc-electrum-faq",
      "x425-btc-bip32"
    ]
  },
  "keyFacts": [
    {
      "label": "Purpose",
      "value": "Bound the search through derived addresses",
      "sourceIds": [
        "x425-btc-bip44"
      ],
      "id": "purpose",
      "claimId": "bitcoin-wallet-gap-limit-fact-purpose"
    },
    {
      "label": "BIP-44 rule",
      "value": "20 consecutive unused external addresses",
      "sourceIds": [
        "x425-btc-bip44"
      ],
      "id": "bip-44-rule",
      "claimId": "bitcoin-wallet-gap-limit-fact-bip-44-rule"
    },
    {
      "label": "Limit",
      "value": "A discovery stop is not a consensus spending rule",
      "sourceIds": [
        "x425-btc-bip32",
        "x425-btc-bip44"
      ],
      "id": "limit",
      "claimId": "bitcoin-wallet-gap-limit-fact-limit"
    }
  ],
  "prerequisites": [
    "bitcoin-extended-public-keys",
    "bitcoin-output-descriptors"
  ],
  "sections": [
    {
      "id": "sequence",
      "heading": "Count consecutive unused addresses",
      "sourceIds": [
        "x425-btc-bip44"
      ],
      "paragraphs": [
        "A discovery algorithm derives addresses along the relevant branch and checks their history. Under the cited BIP-44 rule, finding used addresses restarts the unused-gap count. The rule concerns transaction history, not merely whether an address has a nonzero balance today.",
        "Account discovery and address discovery also have different steps. The correct seed is only one part of locating the intended account hierarchy and address type."
      ]
    },
    {
      "id": "example",
      "heading": "A payment after the gap can be invisible initially",
      "sourceIds": [
        "x425-btc-bip44"
      ],
      "paragraphs": [
        "Suppose external address index 0 was used, indices 1 through 20 were never used, and index 21 later received a payment. A search that stops after 20 consecutive unused addresses can end at index 20 before discovering index 21.",
        "The example assumes that exact derivation branch and gap rule. It does not mean every wallet searches only 20 addresses in total or uses the same limit for change addresses."
      ]
    },
    {
      "id": "investigate",
      "heading": "Use known public evidence to narrow the search",
      "sourceIds": [
        "x425-btc-electrum-faq",
        "x425-btc-bip32"
      ],
      "paragraphs": [
        "Record known receiving addresses, account type and wallet version. Electrum’s documentation warns that addresses generated beyond its normal gap may require a larger search or explicit address generation during recovery. Use the product’s supported procedure, recognizing that historical defaults are version-specific.",
        "A broader search can cost time and reveal more address information to a queried server. Do not publish a seed or extended private key merely to ask whether an address has transaction history."
      ]
    }
  ],
  "faq": [
    {
      "question": "Does the gap limit restrict how many Bitcoin addresses a wallet can have?",
      "answer": "No. It limits a discovery search under a wallet policy, not the number of derivable addresses or a Bitcoin consensus rule. A wallet can derive beyond the normal search window, which is why recovery settings matter.",
      "sourceIds": [
        "x425-btc-bip32",
        "x425-btc-bip44"
      ]
    },
    {
      "question": "Does an emptied address count as unused?",
      "answer": "Under BIP-44 account discovery, use is based on transaction history rather than current balance. An address that received and later spent funds has history even if it now holds no unspent output.",
      "sourceIds": [
        "x425-btc-bip44"
      ]
    }
  ],
  "claims": [
    {
      "id": "bitcoin-wallet-gap-limit-quick-answer",
      "articleSlug": "bitcoin-wallet-gap-limit",
      "statement": "A wallet gap limit tells address discovery when to stop after consecutive unused derived addresses. It prevents an endless search, but a used address beyond a large unused gap can be missed. BIP-44 specifies a 20-address external-chain discovery gap; other wallets and policies can differ. The funds are not deleted when discovery stops—the wallet has not found that part of its address sequence.",
      "sourceIds": [
        "source-43d35242be710673",
        "source-82375415e215e2f2",
        "source-225ce32b9f96878c"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-43d35242be710673",
          "locator": "Path levels; Account discovery; Address gap limit"
        },
        {
          "sourceId": "source-82375415e215e2f2",
          "locator": "Does Electrum trust servers?; Can I import private keys from other Bitcoin clients?; Can I sweep private keys from other Bitcoin clients?; What is the gap limit?; How do I upgrade Electrum?"
        },
        {
          "sourceId": "source-225ce32b9f96878c",
          "locator": "Motivation; Extended keys; Security"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "Educational explanation. Product-specific behavior is scoped to the cited documentation, checked 2026-10-02.",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Read BIP44 account discovery and20-unused-external-address stop condition plus Electrum gap-limit warnings. The index1–20 gap before index21 is consistent; discovery uses transaction history rather than current balance and does not imply absent funds."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-gap-limit-fact-purpose",
      "articleSlug": "bitcoin-wallet-gap-limit",
      "statement": "Purpose: Bound the search through derived addresses",
      "sourceIds": [
        "source-43d35242be710673"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-43d35242be710673",
          "locator": "Path levels; Account discovery; Address gap limit"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Read BIP44 account discovery and20-unused-external-address stop condition plus Electrum gap-limit warnings. The index1–20 gap before index21 is consistent; discovery uses transaction history rather than current balance and does not imply absent funds."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-gap-limit-fact-bip-44-rule",
      "articleSlug": "bitcoin-wallet-gap-limit",
      "statement": "BIP-44 rule: 20 consecutive unused external addresses",
      "sourceIds": [
        "source-43d35242be710673"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-43d35242be710673",
          "locator": "Path levels; Account discovery; Address gap limit"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Read BIP44 account discovery and20-unused-external-address stop condition plus Electrum gap-limit warnings. The index1–20 gap before index21 is consistent; discovery uses transaction history rather than current balance and does not imply absent funds."
        ]
      }
    },
    {
      "id": "bitcoin-wallet-gap-limit-fact-limit",
      "articleSlug": "bitcoin-wallet-gap-limit",
      "statement": "Limit: A discovery stop is not a consensus spending rule",
      "sourceIds": [
        "source-225ce32b9f96878c",
        "source-43d35242be710673"
      ],
      "sourceLocators": [
        {
          "sourceId": "source-225ce32b9f96878c",
          "locator": "Motivation; Extended keys; Security"
        },
        {
          "sourceId": "source-43d35242be710673",
          "locator": "Path levels; Account discovery; Address gap limit"
        }
      ],
      "scope": {
        "collection": "bitcoin",
        "dataAsOf": "2026-10-02",
        "blockHeight": null
      },
      "qualification": "",
      "evidenceStatus": "documented",
      "verification": {
        "status": "verified",
        "method": "independent automated source review",
        "checkedAt": "2026-10-02T19:29:20.637Z",
        "reviewer": "Independent automated verification — Codex /root/verify_ethereum_100, separate from the Bitcoin drafting agent",
        "notes": [
          "Read BIP44 account discovery and20-unused-external-address stop condition plus Electrum gap-limit warnings. The index1–20 gap before index21 is consistent; discovery uses transaction history rather than current balance and does not imply absent funds."
        ]
      }
    }
  ],
  "sources": [
    {
      "id": "x425-btc-bip44",
      "label": "Multi-Account Hierarchy for Deterministic Wallets",
      "publisher": "Bitcoin Improvement Proposals",
      "url": "https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0044.mediawiki",
      "locator": "Path levels; Account discovery; Address gap limit",
      "note": "Hardened account paths and external-chain discovery gap rule.",
      "version": "Pinned BIPs revision",
      "checkedAt": "2026-10-02T18:53:54.097Z",
      "contentSha256": "6a541c79f94077ac529941a8cbd373ce077a5d6e97b6dd8209b45ac10f737eaf",
      "recordId": "source-43d35242be710673"
    },
    {
      "id": "x425-btc-electrum-faq",
      "label": "Frequently Asked Questions",
      "publisher": "Electrum",
      "url": "https://electrum.readthedocs.io/en/latest/faq.html",
      "locator": "Does Electrum trust servers?; Can I import private keys from other Bitcoin clients?; Can I sweep private keys from other Bitcoin clients?; What is the gap limit?; How do I upgrade Electrum?",
      "note": "Electrum-specific sweep/import distinctions, seed recovery scope and address discovery.",
      "checkedAt": "2026-10-02T18:53:56.378Z",
      "contentSha256": "a7f9a2d109a2a753b0010cda1bd2d789a0417a0788a48ea6632c3fe3b391fb06",
      "recordId": "source-82375415e215e2f2",
      "version": null
    },
    {
      "id": "x425-btc-bip32",
      "label": "Hierarchical Deterministic Wallets",
      "publisher": "Bitcoin Improvement Proposals",
      "url": "https://raw.githubusercontent.com/bitcoin/bips/927b6de9915c9262615a6399de51b200f81e5aa4/bip-0032.mediawiki",
      "locator": "Motivation; Extended keys; Security",
      "note": "Deterministic key derivation, backup scope and public/private child derivation.",
      "version": "Pinned BIPs revision",
      "checkedAt": "2026-10-02T18:53:54.013Z",
      "contentSha256": "e5e00a8289db2f681052cf24a745320afc225e66b25d1e489a7c884d2fc7f11f",
      "recordId": "source-225ce32b9f96878c"
    }
  ],
  "related": {
    "articles": [
      "bitcoin-extended-public-keys",
      "bitcoin-output-descriptors",
      "bitcoin-12-vs-24-word-seed",
      "bitcoin-wallet-file-backups"
    ],
    "dossiers": [],
    "wallets": []
  },
  "revisionHistory": [
    {
      "date": "2026-10-02",
      "kind": "published",
      "summary": "First publication after primary-source research and separate automated verification."
    }
  ],
  "citation": "Degrees of Satoshi editorial project. “Bitcoin wallet gap limits: why an address can be missed during recovery.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-wallet-gap-limit/"
}