This guide explains Bitcoin Core getdeploymentinfo RPC in plain English. It shows what the command does, what its result means and what it cannot prove.
TL;DR
- What it is: Bitcoin Core 23.0 moved soft-fork deployment reporting into getdeploymentinfo. The RPC reports state at the chain tip or an explicitly supplied known block, separating buried deployments from BIP9 deployments and exposing active enforcement, activation height, state transitions and signalling statistics where applicable.
- Why it matters: getdeploymentinfo is authoritative for one node’s deployment view at one block. Reliable automation preserves that context, distinguishes signalling from enforcement and re-evaluates state across reorganisations and upgrades.
- Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.
Bitcoin Core getdeploymentinfo RPC in simple English
Bitcoin Core getdeploymentinfo RPC: With no argument the RPC uses the current chain tip. A block hash queries deployment state at that block.
Simple example
A node operator is checking Bitcoin Core getdeploymentinfo RPC. Record returned hash and height so dashboards do not silently mix observations. Cross-check chain tip, deployment name, state, height and expected network parameters against independently managed policy, and retain raw snapshots around transition boundaries.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- RPC:
- A command that software sends to a node to request information or a local action.
- Mempool:
- A node’s changing local collection of valid, unconfirmed transactions.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Query point
With no argument the RPC uses the current chain tip; a block hash queries deployment state at that block. Record returned hash and height so dashboards do not silently mix observations.
Deployment types
Each named deployment is buried or bip9. Buried entries chiefly report enforcement height, while BIP9 entries can include bit, start time, timeout, minimum activation height and period state.
Active field
active says rules are enforced for the mempool and the next block at the queried point. For BIP9, status describes the selected block while status_next describes the following block.
Signalling statistics
During started or locked_in periods the response can include period, threshold, elapsed, count, possible and a signalling string. Miner signalling is not identical to final activation or user acceptance.
Reorganisations
A queried tip can become stale. Store block identity, repeat after reorgs and alert on chain disagreement before treating a deployment transition as durable.
Version boundary
Client code must pin the 23.0 schema and not scrape the deprecated getblockchaininfo shape. Optional fields depend on type and status and must be handled conditionally.
Monitoring
Cross-check chain tip, deployment name, state, height and expected network parameters against independently managed policy, and retain raw snapshots around transition boundaries. Build a revision-pinned evidence pack on an isolated node, wallet or protocol harness. Record source commit, binary hash, network, chain identity, configuration and dependencies.
Frequently asked questions
What is the main point of Bitcoin Core getdeploymentinfo RPC?
Bitcoin Core getdeploymentinfo RPC: With no argument the RPC uses the current chain tip. A block hash queries deployment state at that block.
For Bitcoin Core getdeploymentinfo RPC, what should a beginner know about query point?
With no argument the RPC uses the current chain tip. A block hash queries deployment state at that block.
For Bitcoin Core getdeploymentinfo RPC, what should a beginner know about deployment types?
Each named deployment is buried or bip9. Buried entries chiefly report enforcement height, while BIP9 entries can include bit, start time, timeout, minimum activation height and period state.
For Bitcoin Core getdeploymentinfo RPC, what should a beginner know about active field?
active says rules are enforced for the mempool and the next block at the queried point.
Conclusion
getdeploymentinfo is authoritative for one node’s deployment view at one block. Reliable automation preserves that context, distinguishes signalling from enforcement and re-evaluates state across reorganisations and upgrades.
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.