This guide explains BIP 390 musig() Descriptor Key Expression 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 390 is a Draft informational specification for expressing a MuSig2 aggregate public key inside output script descriptors. The musig() expression accepts several descriptor keys, applies their child derivation, sorts the resulting public keys with KeySort and aggregates them using BIP 327.
- Why it matters: BIP 390 can give MuSig2 wallets a concise, reproducible policy description. Until the Draft stabilises, deployments should pin the grammar, preserve complete descriptors and verify derived Taproot outputs across independent implementations.
- Current position: BIP 390 is a Draft informational specification for expressing a MuSig2 aggregate public key inside output script descriptors.
BIP 390 musig() Descriptor Key Expression in simple English
BIP 390 musig() Descriptor Key Expression: BIP 390 is Draft, Informational, version 0.2.0. Wallet exports must retain a version and should not imply that every descriptor implementation accepts the expression.
Simple example
A node operator is checking BIP 390 musig() Descriptor Key Expression. The derived keys are then ordered with KeySort before aggregation, so sorting original xpub strings is incorrect.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- Taproot:
- A Bitcoin upgrade that added new signature and script options for spending outputs.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Status
BIP 390 is Draft, Informational, version 0.2.0. Wallet exports must retain a version and should not imply that every descriptor implementation accepts the expression.
Allowed contexts
musig() can be used as a key expression inside tr(), rawtr() or sp(). It cannot be nested inside another musig() expression.
Derive then sort
Each participant key performs its specified derivation first. The derived keys are then ordered with KeySort before aggregation, so sorting original xpub strings is incorrect.
Per-index aggregation
When participant expressions contain a wildcard, a new aggregate key is computed for every child index. All devices must derive the same branch and index.
Aggregate derivation form
A path following musig() derives from the synthetic aggregate xpub described by BIP 328. Participant keys must be xpub-based and cannot also contain wildcard or multipath derivation.
No hardened aggregate path
Because no aggregate private key exists, derivation after musig() is unhardened only. Reject hardened markers anywhere in that aggregate path.
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 390 musig() Descriptor Key Expression?
BIP 390 musig() Descriptor Key Expression: BIP 390 is Draft, Informational, version 0.2.0.
For BIP 390 musig() Descriptor Key Expression, what should a beginner know about status?
BIP 390 is Draft, Informational, version 0.2.0. Wallet exports must retain a version and should not imply that every descriptor implementation accepts the expression.
For BIP 390 musig() Descriptor Key Expression, what should a beginner know about allowed contexts?
musig() can be used as a key expression inside tr(), rawtr() or sp().
For BIP 390 musig() Descriptor Key Expression, what should a beginner know about derive then sort?
Each participant key performs its specified derivation first. The derived keys are then ordered with KeySort before aggregation, so sorting original xpub strings is incorrect.
Conclusion
BIP 390 can give MuSig2 wallets a concise, reproducible policy description. Until the Draft stabilises, deployments should pin the grammar, preserve complete descriptors and verify derived Taproot outputs across independent implementations.
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.