This guide explains BIP 388 Wallet Policies for Descriptor Wallets in plain English. It covers the problem behind the BIP, why it matters and whether the proposal is part of Bitcoin today.
TL;DR
- What it is: BIP 388 is a Complete application-layer specification for representing a descriptor-wallet account as a compact wallet descriptor template plus a separate key-information vector. The restricted language is designed for hardware signing devices with limited memory and display capacity, allowing them to register, inspect and later recognise a stable account policy while deriving receive and change descriptors.
- Why it matters: BIP 388 makes descriptor accounts practical to review on constrained signers by separating structure from key data. Safety depends on exact policy registration, deterministic derivation and recovery evidence across every participating device.
- Current position: BIP 388 is a Complete application-layer specification for representing a descriptor-wallet account as a compact wallet descriptor template plus a separate key-information vector.
BIP 388 Wallet Policies for Descriptor Wallets in simple English
BIP 388 Wallet Policies for Descriptor Wallets: Key origins and xpubs reveal wallet structure. Prevent reuse of one signer key across unrelated policies where it undermines isolation, and protect exported policy data.
Simple example
A node operator is checking BIP 388 Wallet Policies for Descriptor Wallets. A wallet policy contains a descriptor template with key placeholders and a key-information vector holding the corresponding extended keys and origin data.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- Consensus:
- The shared rules full nodes use to decide whether blocks and transactions are valid.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Status and layer
BIP 388 is Complete, Specification, version 1.1.0 at the Applications layer. It defines interoperability, not Bitcoin consensus or mandatory device support.
Policy components
A wallet policy contains a descriptor template with key placeholders and a key-information vector holding the corresponding extended keys and origin data.
Account scope
One policy represents the descriptors needed for a logical account, commonly including receive and change. Aggregated flows should be shown when reviewing transactions.
Restricted language
The policy grammar intentionally narrows general descriptors so constrained signers can parse and display the policy without storing an arbitrarily large descriptor.
Registration
A hardware signer can register and authenticate a policy, then recognise it during signing. Registration must bind the exact template, ordered keys and account context.
Privacy and reuse
Key origins and xpubs reveal wallet structure. Prevent reuse of one signer key across unrelated policies where it undermines isolation, and protect exported policy data.
How specialists test it
Developers test the proposal with made-up data on an isolated test network. They check normal cases and deliberately invalid cases. Different implementations should reach the same result before anyone relies on the proposal.
Frequently asked questions
What is the main point of BIP 388 Wallet Policies for Descriptor Wallets?
BIP 388 Wallet Policies for Descriptor Wallets: Key origins and xpubs reveal wallet structure. Prevent reuse of one signer key across unrelated policies where it undermines isolation, and protect exported policy data.
For BIP 388 Wallet Policies for Descriptor Wallets, what should a beginner know about status and layer?
BIP 388 is Complete, Specification, version 1.1.0 at the Applications layer.
For BIP 388 Wallet Policies for Descriptor Wallets, what should a beginner know about policy components?
A wallet policy contains a descriptor template with key placeholders and a key-information vector holding the corresponding extended keys and origin data.
For BIP 388 Wallet Policies for Descriptor Wallets, what should a beginner know about account scope?
One policy represents the descriptors needed for a logical account, commonly including receive and change.
Conclusion
BIP 388 makes descriptor accounts practical to review on constrained signers by separating structure from key data. Safety depends on exact policy registration, deterministic derivation and recovery evidence across every participating device.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.