This guide explains Bitcoin Core asmap 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.20.0 introduced the experimental asmap option to improve network diversity by mapping peer IP addresses to autonomous-system numbers and limiting concentration within one ASN. Without a supplied map, the legacy IPv4 /16 grouping remained the default.
- Why it matters: Bitcoin Core asmap can improve address-manager bucketing when its routing map is authentic and maintained. It remains defence in depth, so operators must monitor actual peer diversity and preserve a tested fallback.
- 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 asmap in simple English
Bitcoin Core asmap: Diverse peer buckets make eclipse-style concentration harder when addresses controlled through related networks would otherwise appear separate.
Simple example
A node operator is checking Bitcoin Core asmap. Define the attacker and connectivity assumptions before claiming benefit. The 0.20 release explicitly called asmap experimental and subject to removal or breaking changes.
Key terms in plain English
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Threat model
Diverse peer buckets make eclipse-style concentration harder when addresses controlled through related networks would otherwise appear separate. Define the attacker and connectivity assumptions before claiming benefit.
Experimental status
The 0.20 release explicitly called asmap experimental and subject to removal or breaking changes. Pin the Core version, file format and startup behaviour.
Map provenance
Build or get the map from a documented routing-data source, verify its hash and creation time and transfer it as configuration evidence. An untrusted map can manipulate bucketing.
Freshness and accuracy
ASN allocations and announcements change. Establish an update cadence and compare material mapping shifts, but avoid replacing a known map automatically without validation.
Runtime evidence
getpeerinfo added mapped_as to show the chosen mapping. Review outbound-peer distribution alongside address family, direction and reachability; mapped_as alone is not a health score.
Failure handling
Test missing, unreadable, malformed, empty and stale files and verify whether startup fails or falls back for the exact version. Alert on unexpected legacy mapping rather than silently continuing.
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 asmap?
Bitcoin Core asmap: Diverse peer buckets make eclipse-style concentration harder when addresses controlled through related networks would otherwise appear separate.
For Bitcoin Core asmap, what should a beginner know about threat model?
Diverse peer buckets make eclipse-style concentration harder when addresses controlled through related networks would otherwise appear separate.
For Bitcoin Core asmap, what should a beginner know about experimental status?
The 0.20 release explicitly called asmap experimental and subject to removal or breaking changes.
For Bitcoin Core asmap, what should a beginner know about map provenance?
Build or get the map from a documented routing-data source, verify its hash and creation time and transfer it as configuration evidence.
Conclusion
Bitcoin Core can improve address-manager bucketing when its routing map is authentic and maintained. It remains defence in depth, so operators must monitor actual peer diversity and preserve a tested fallback.
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.