This guide explains Bitcoin Core getaddrmaninfo 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 26.0 introduced getaddrmaninfo to report how the node address manager distributes known addresses across new and tried tables for IPv4, IPv6, onion, I2P, CJDNS and all networks. New addresses are discovered but not yet successfully connected; tried addresses have succeeded before.
- Why it matters: getaddrmaninfo is a compact diagnostic for the breadth and history of peer discovery. It becomes operationally useful only when paired with live peer, reachability and long-term trend evidence.
- 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 getaddrmaninfo RPC in simple English
Bitcoin Core getaddrmaninfo RPC: new counts potential peers the node has learned but not successfully connected to. A large count can be healthy discovery or low-quality inventory.
Simple example
A node operator is checking Bitcoin Core getaddrmaninfo RPC. Pin the 26.0 schema because later releases may add or alter network families. Record source commit, binary hash, network, chain identity, configuration and dependencies.
Key terms in plain English
- 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.
No arguments
The RPC accepts no parameters and returns a map keyed by network. Pin the 26.0 schema because later releases may add or alter network families.
New table
new counts potential peers the node has learned but not successfully connected to. A large count can be healthy discovery or low-quality inventory; it is not availability proof.
Tried table
tried counts addresses with a successful historical connection. It does not say a peer is currently reachable, honest, recent or suitable for an outbound slot.
Network totals
Each family reports new, tried and total, with all_networks aggregating them. Compare sums and track trends while allowing for normal address-manager churn.
Diversity
Use the RPC with getpeerinfo, getnetworkinfo and configured reachability to distinguish known-address diversity from active connection diversity.
Privacy
Aggregate counts are safer than dumping addresses, but RPC access still exposes node topology and operational behaviour. Keep it authenticated and off public dashboards.
Alerts
Alert on sustained disappearance of expected networks, zero tried inventory, abrupt resets or mismatch with active peers, then investigate peers.dat, configuration and network reachability. 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 getaddrmaninfo RPC?
Bitcoin Core getaddrmaninfo RPC: new counts potential peers the node has learned but not successfully connected to.
For Bitcoin Core getaddrmaninfo RPC, what should a beginner know about no arguments?
The RPC accepts no parameters and returns a map keyed by network.
For Bitcoin Core getaddrmaninfo RPC, what should a beginner know about new table?
new counts potential peers the node has learned but not successfully connected to.
For Bitcoin Core getaddrmaninfo RPC, what should a beginner know about tried table?
tried counts addresses with a successful historical connection. It does not say a peer is currently reachable, honest, recent or suitable for an outbound slot.
Conclusion
getaddrmaninfo is a compact diagnostic for the breadth and history of peer discovery. It becomes operationally useful only when paired with live peer, reachability and long-term trend evidence.
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.