Skip to main content
£0.00 0

Basket

No products in the basket.

ASIC mining knowledge centre

Bitcoin Core asmap: Network-Diverse Peer Selection Guide

Bitcoin Core 0.20 asmap guide covering experimental ASN mapping, peer bucketing, map provenance and freshness, mapped_as evidence, failure modes and rollback.

Bitcoin Core asmap guide cover

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.

What this means in simple English

Technical standards often describe several layers at once. This article separates the basic idea from the detailed rules so the practical meaning is clear.

Start with the simple explanation and current status. Use the later sections and primary sources only when you need more detail.

Simple example

Think of the transaction as a form passed between several authorised signers. Each person or device checks the same payment details before adding approval. Passing the form around does not make the payment safe unless every signer checks what it contains.

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 obtain 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.

Bitcoin Core asmap technical diagram
Map provenance: the fields, validation boundary and operational evidence that implementations need to agree.

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 Bitcoin Core asmap?

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.

Is Bitcoin Core asmap active or supported today?

Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.

Why does Bitcoin Core matter?

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.

Do beginners need to use the technical details?

No. The opening explanation and questions cover the main idea. The detailed sections are available for readers who need to go further.

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.

On this page

Search More Guides

Continue Reading

Explore more practical guidance on ASIC hardware, profitability, setup, hosting and maintenance.

Need Advice for Your Mining Setup?

Use our guidance to build your shortlist, then speak to our team when you want help comparing hardware, power, hosting or repairs.
Contact our team
Browse ASIC miners