ASNDB

Compact ASN/BGP lookup DB → single mmap'd binary file.

8 µs load, 22 µs IP lookup
mini 12 / lite 24 / full 52 MB
one-shot build → 11 artifacts

Build

cargo build --release
./target/release/asndb build --out out

First run fetches ~1 GB of sources to $XDG_CACHE_HOME/asndb-cache/. Re-runs reuse the cache. Peak RAM ~4 GB.

CLI

asndb build [--out DIR]
asndb stats
asndb ip 8.8.8.8
asndb ip 2606:4700::1
asndb asn 13335
asndb prefixes 13335
asndb neighbors 13335

Artifacts

One build writes every artifact:

file	contents
asndb-mini.bin	IP→ASN + name
asndb-lite.bin	+country, org, RIR, alloc, HQ, kind, traffic, scope, flags, RPKI counts, address counts
asndb-full.bin	+per-ASN prefixes, neighbors w/ relationship, contact info
ip2asn-v4.tsv / ip2asn-v6.tsv	start end asn cc name
ip2asn-v4.csv / ip2asn-v6.csv	start,end,asn intervals
asn-info.csv	per-ASN metadata (bool→1/empty, zero floats empty)
asn-prefixes.csv	asn,prefix,rpki
asn-neighbors.csv	asn,neighbor,rel
asndb.ndjson	one JSON object per ASN; default-valued keys omitted

Sources

• RIPE asn-names: handle + country
• RIPE/APNIC/AFRINIC whois: abuse email, phone, address
• NRO delegated-stats: RIR + allocation date
• CAIDA as-org2info: org name
• CAIDA as-rel2: provider/customer/peer
• PeeringDB (net, org, netixlan): type, traffic, scope, policy, flags, HQ, IX count
• RPKI VRPs: per-prefix valid/invalid/unknown
• RIPE RIS RRC00 RIB: prefix→ASN + BGP adjacencies

Binary format

Header (104B)            magic, flavor, counts, section offsets
AsnRec[]   by asn        flavor-sized record; first u32 = ASN
Seg4[]     by start       8B: (start_ip,    asn_idx)
Seg6[]     by start      20B: (start_ip128, asn_idx)  big-endian start
Pfx4[]     per-ASN        8B: (start, len, rpki, _pad)
Pfx6[]     per-ASN       18B: (start128, len, rpki)
Neigh[]    per-ASN       u32 packed: asn_idx<<2 | rel ∈ {prov,cust,peer}
StrPool                  deduped UTF-8: u32 len + bytes; offset 0 = empty

• Sweep-segmented IP space: one partition_point binary search per lookup.
• ASN indices (not raw ASNs) in prefix/neighbor tables.
• Packed neighbor+rel: 2 bits carry the relationship.
• mmap + #[repr(C)] Pod: zero-copy load.

Python parser

Single file asndb.py, stdlib only (mmap, struct, bisect, ipaddress):

from asndb import Db

db = Db("asndb-full.bin")
db.lookup("8.8.8.8")            # → 15169
db.info(13335)                  # → dict (fields vary by flavor)
db.prefixes(13335)              # → ([(v4_pfx, rpki)], [(v6_pfx, rpki)])
db.neighbors(13335)             # → [(asn, rel), ...]

CLI:

python3 asndb.py asndb-full.bin ip 8.8.8.8
python3 asndb.py asndb-full.bin asn 13335

Works on all three flavors. Methods returning prefix/neighbor data require full.

Releases

Daily GitHub release via .github/workflows/build.yml. Latest:

BASE=https://github.com/tn3w/ASNDB/releases/latest/download
curl -fsSLO $BASE/asndb-full.bin
curl -fsSLO $BASE/ip2asn-v4.csv

License

Apache-2.0. See LICENSE.