DelegatedEntry and the Stats Family¶

The delegated-stats family of types models the line-oriented "registry | country | type | start | value | date | status | extensions" format that APNIC publishes for its public registry statistics. This family covers five source files — delegated, extended, assigned, delegated-apnic-ipv6-assigned and legacy — each with its own entry struct but a shared wrapper shape (*Result = header + summaries + entries).

All types below live in models.go.

Class Diagram¶

classDiagram
    class StatsFileHeader {
        +string Version
        +string Registry
        +int64 Serial
        +int64 Records
        +time.Time StartDate
        +time.Time EndDate
        +int UTCOffset
    }

    class StatsSummary {
        +string Registry
        +string Type
        +int64 Count
    }

    class DelegatedEntry {
        +string Registry
        +string Country
        +string Type
        +string Start
        +int64 Value
        +time.Time Date
        +string Status
        +[]string Extensions
        +CIDR() (string, error)
    }

    class DelegatedExtendedEntry {
        +string Registry
        +string Country
        +string Type
        +string Start
        +int64 Value
        +time.Time Date
        +string Status
        +string OpaqueID
        +[]string Extensions
        +CIDR() (string, error)
    }

    class AssignedEntry {
        +string Registry
        +string Country
        +string Type
        +string Prefix
        +int64 Count
        +string Status
    }

    class IPv6AssignedEntry {
        +string Registry
        +string Country
        +string Start
        +int64 Value
        +time.Time Date
    }

    class LegacyEntry {
        +string Registry
        +string Country
        +string Type
        +string Start
        +int64 Value
        +time.Time Date
        +string Status
        +CIDR() (string, error)
    }

    class DelegatedResult {
        +StatsFileHeader Header
        +[]StatsSummary Summaries
        +[]DelegatedEntry Entries
    }

    class ExtendedResult {
        +StatsFileHeader Header
        +[]StatsSummary Summaries
        +[]DelegatedExtendedEntry Entries
    }

    class AssignedResult {
        +StatsFileHeader Header
        +[]StatsSummary Summaries
        +[]AssignedEntry Entries
    }

    class IPv6AssignedResult {
        +StatsFileHeader Header
        +[]StatsSummary Summaries
        +[]IPv6AssignedEntry Entries
    }

    class LegacyResult {
        +StatsFileHeader Header
        +[]StatsSummary Summaries
        +[]LegacyEntry Entries
    }

    DelegatedResult --> StatsFileHeader
    DelegatedResult --> StatsSummary
    DelegatedResult --> DelegatedEntry
    ExtendedResult --> DelegatedExtendedEntry
    AssignedResult --> AssignedEntry
    IPv6AssignedResult --> IPv6AssignedEntry
    LegacyResult --> LegacyEntry

DelegatedEntry¶

A single allocation/assignment record from the standard delegated stats file (delegated-apnic-latest).

DelegatedExtendedEntry¶

A record from the extended delegated stats file (delegated-apnic-extended-latest). Identical to DelegatedEntry plus the OpaqueID field, which uniquely identifies the resource-holder organization without revealing its name.

AssignedEntry¶

An aggregated assignment count by prefix size from the assigned stats file. Unlike DelegatedEntry, each row reports a count of assignments of a given prefix size rather than a single range.

IPv6AssignedEntry¶

A single IPv6 assignment record from delegated-apnic-ipv6-assigned. This file has a reduced column set — no status and no extensions — so the struct is correspondingly smaller.

LegacyEntry¶

A historical (pre-RIR) resource record from the legacy stats file. Field layout matches DelegatedEntry minus Extensions.

*Result wrappers¶

Each entry type is wrapped in a result struct that bundles the file header and per-type summaries alongside the entries:

All wrappers share the same three fields:

• Header StatsFileHeader — version, registry, serial, record count, start/end date, UTC offset.
• Summaries []StatsSummary — per-type (asn/ipv4/ipv6) counts the file reports about itself.
• Entries []<EntryType> — the actual records, in file order.

CIDR() method¶

DelegatedEntry, DelegatedExtendedEntry and LegacyEntry each implement:

func (e <EntryType>) CIDR() (string, error)

The conversion depends on Type:

• ipv4 — Value is the number of hosts; the prefix length is 32 - log2(Value). Returns "start/prefix" (e.g. 1.1.1.0/24). Returns ErrInvalidIP if Value is out of range.
• ipv6 — Value is already the prefix length; returns "start/value" (e.g. 2001:240::/32). Returns ErrInvalidIP if Value is not in [0, 128].
• anything else — returns ErrUnsupportedType (notably "asn" rows, which have no CIDR form).

This is the canonical way to turn a stats row into a routable prefix; do not compute it by hand from Start/Value because the IPv4 host-count→prefix conversion is easy to get wrong.

entries, _ := client.GetDelegatedEntries(ctx)
for _, e := range entries {
    if e.Type == "ipv4" {
        if cidr, err := e.CIDR(); err == nil {
            fmt.Println(cidr) // 1.1.1.0/24
        }
    }
}

Where these types are produced¶

flowchart LR
    subgraph FTP["ftp.apanic.net"]
        F1["delegated-apnic-latest"]
        F2["delegated-apnic-extended-latest"]
        F3["assigned stats"]
        F4["delegated-apnic-ipv6-assigned"]
        F5["legacy stats"]
    end

    F1 -->|FetchDelegated| DR["DelegatedResult"]
    F2 -->|FetchExtended| ER["ExtendedResult"]
    F3 -->|FetchAssigned| AR["AssignedResult"]
    F4 -->|FetchIPv6Assigned| V6R["IPv6AssignedResult"]
    F5 -->|FetchLegacy| LR["LegacyResult"]

    DR --> DE["DelegatedEntry.CIDR()"]
    ER --> EX["DelegatedExtendedEntry.CIDR()"]
    LR --> LE["LegacyEntry.CIDR()"]