This guide explains Bitcoin Core blockfilterindex in plain English. It focuses on what the subject is, why it matters and what a beginner should remember.
TL;DR
- What it is: Bitcoin Core 0.19.0 added the blockfilterindex setting to create BIP 158 compact block filters across the blockchain. Construction ran in the background, used extra disk space and enabled local getblockfilter access.
- Why it matters: blockfilterindex made deterministic compact filters available to local Bitcoin Core 0.19 users. Reliable operation requires separate readiness monitoring, independent verification and a rebuild plan for this derived index.
- 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 blockfilterindex in simple English
Bitcoin Core blockfilterindex: Bitcoin Core 0.19 did not serve compact filters over P2P. Do not advertise a network service merely because local RPC queries work.
Simple example
A node operator is checking Bitcoin Core blockfilterindex. BIP 157 chains filter headers so clients can compare peers and locate disagreement. Gate dependent jobs on an explicit best indexed height and compare it with the active chain tip.
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.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Historical feature scope
In 0.19 the option built filters for the entire blockchain and the release notes estimated about 4 GiB. Capacity plans should use measured current data, filesystem headroom and I/O rather than freezing that estimate.
Background construction
A synced chain does not imply a caught-up filter index. Gate dependent jobs on an explicit best indexed height and compare it with the active chain tip.
Basic filter semantics
BIP 158 defines the initial basic Golomb-coded set filter. It is probabilistic: false positives are possible, while correct construction aims to include the specified block elements.
Header commitments
BIP 157 chains filter headers so clients can compare peers and locate disagreement. The local index is one source; independent checkpoints or peers are needed for adversarial assurance.
Local-only boundary
Bitcoin Core 0.19 did not serve compact filters over P2P. Do not advertise a network service merely because local RPC queries work.
Resource and recovery plan
Record added storage, build duration and read latency. Back up configuration, not disposable derived index data, and rehearse disabling or rebuilding without risking wallet or chainstate.
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 Bitcoin Core blockfilterindex?
Bitcoin Core blockfilterindex: Bitcoin Core 0.19 did not serve compact filters over P2P. Do not advertise a network service merely because local RPC queries work.
For Bitcoin Core blockfilterindex, what should a beginner know about historical feature scope?
In 0.19 the option built filters for the entire blockchain and the release notes estimated about 4 GiB.
For Bitcoin Core blockfilterindex, what should a beginner know about background construction?
A synced chain does not imply a caught-up filter index. Gate dependent jobs on an explicit best indexed height and compare it with the active chain tip.
For Bitcoin Core blockfilterindex, what should a beginner know about basic filter semantics?
BIP 158 defines the initial basic Golomb-coded set filter. It is probabilistic: false positives are possible, while correct construction aims to include the specified block elements.
Conclusion
blockfilterindex made deterministic compact filters available to local Bitcoin Core 0.19 users. Reliable operation requires separate readiness monitoring, independent verification and a rebuild plan for this derived index.
Primary sources
- Bitcoin Core 0.19.0.1 release notes
- BIP 157 Client Side Block Filtering
- BIP 158 Compact Block Filters
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.