Encyclopedia How the network works · Entry 87
Output descriptors: describing what a Bitcoin wallet can find
In this article
At a glance
Key facts
| Fact | Detail | Source |
|---|---|---|
| Purpose | A descriptor describes output scripts and associated key expressions. | [1] |
| Range | Ranged descriptors can describe a sequence of derived outputs. | [1] |
| Sensitivity | A descriptor may contain public or private key material; inspect its type before sharing. | [1] |
Describe a wallet’s outputs rather than a single address
An address identifies a particular payment destination. A descriptor can describe how an entire family of output scripts is constructed. That distinction matters when a wallet needs to recognize receiving and change outputs over time.
Key-origin and derivation information helps cooperating wallets agree on which keys belong to a script. It is operational metadata, not proof that a particular person owns the funds.
What an import needs to know
Bitcoin Core’s import interface includes a descriptor, timestamp and options such as active status and ranges. A timestamp helps define the historical search required to find activity. Importing the text does not necessarily make every historical transaction appear instantly.
A descriptor that contains only public information can support recognition without supplying spending authority. A descriptor containing secret material requires the same care as other sensitive key backups.
What the checksum protects
The descriptor checksum is designed to detect transcription mistakes in the descriptor text. It is useful when copying a long expression between systems.
A correctly checksummed malicious descriptor remains malicious, and a valid public descriptor can still reveal transaction relationships. Check provenance and privacy separately from syntax.
Direct answers
Questions people ask
Is a descriptor the same as a seed phrase?
No. A descriptor describes scripts and key derivation. A mnemonic seed scheme is a way of deriving key material. Recovery may require both the appropriate keys and enough wallet-policy information to locate and spend outputs.
Inspect the evidence
The answer and key facts have stable claim links. These records retain the scope and qualification when reused.
A Bitcoin output descriptor is a text expression describing the scripts a wallet should recognize or generate, including relevant keys and derivation information. It can make wallet recovery and watch-only setup more explicit. A descriptor checksum catches certain transcription errors; it does not prove ownership, safety or secrecy.
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.
Link to this claimPurpose: A descriptor describes output scripts and associated key expressions.
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.
Link to this claimRange: Ranged descriptors can describe a sequence of derived outputs.
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.
Link to this claimSensitivity: A descriptor may contain public or private key material; inspect its type before sharing.
Scope: Bitcoin · data through 2026-10-02. Verification: verified · 2026-10-02T18:15:23.891Z.
Link to this claimRevision history
- — Initial Bitcoin encyclopedia entry at this permanent URL.
- — Added reusable claims, explicit source locators, and matching Markdown and JSON. This publishing change does not itself establish factual verification.
Source register
Sources and references
Retrieval dates and locators are recorded individually.- Output Script Descriptors General OperationBitcoin BIPs contributors
Descriptors describe output scripts, keys and derivation information.
Locator: Specification; Key expressions; Checksum · Version / scope: BIP-380; immutable revision pinned in source URL · Retrieved: 2026-10-02T17:22:20.620ZOpen source - importdescriptors RPCBitcoin Core
Descriptor import, active ranges, timestamps and watch-only use.
Locator: Arguments and result fields · Version / scope: Bitcoin Core 29.0.0 RPC · Retrieved: 2026-10-02T17:03:40.832ZOpen source - Mnemonic code for generating deterministic keysBitcoin BIPs contributors
The optional passphrase participates in deriving a different seed.
Locator: From mnemonic to seed · Version / scope: BIP-39; immutable revision pinned in source URL · Retrieved: 2026-10-02T17:22:20.588ZOpen source
Research and drafting use AI assistance. A separate automated review checks claims against primary sources; no external expert or named human review is implied. Publication, substantive editing, source retrieval and verification are recorded separately. This version was independently checked by an automated reviewer on 2 October 2026.
Editorial method and correctionsDegrees of Satoshi editorial project. “Output descriptors: describing what a Bitcoin wallet can find.” Published 2026-10-02; updated 2026-10-02. https://degreesofsatoshi.com/encyclopedia/bitcoin-output-descriptors/