# REGINALD - MX COG Registry
> Registry for Genuine Information, Notarised Authentication, and Legitimate Documentation

REGINALD is a pure DNS-like resolver for machine-readable documentation. It maps
COG identifiers to publisher-hosted content URLs. REGINALD does NOT host content
— each publisher serves their own COGs. AI agents query REGINALD to discover and
verify content, then fetch directly from the publisher.

## How Resolution Works
REGINALD maps COG identifiers (namespace/name) to publisher-hosted content URLs.
Content lives on publisher servers, not on REGINALD.

Resolution flow:
1. GET /api/v1/namespaces.json — discover registered namespaces
2. GET /api/v1/namespaces/{ns}/cogs.json — list COGs in a namespace
3. GET /cogs/{ns}/{name}/latest.json — get pointer record
4. Fetch canonical_url — retrieve content from publisher's server
5. Verify content_hash and certificates

## API Endpoints
- GET /api/v1/namespaces.json - Registered namespaces (discovery)
- GET /api/v1/namespaces/{ns}/cogs.json - COGs in a namespace
- GET /api/v1/stats.json - Registry statistics
- GET /api/v1/publishers.json - Publisher details
- GET /api/v1/public-key.pem - Ed25519 registry signing key
- GET /cogs/{namespace}/{name}/latest.json - Pointer record + certificates

## Two-Layer Trust
- Publisher signs content (proves "I wrote this")
- REGINALD signs the pointer record (proves "this is registered and verified")
- Verify publisher_certificate with the publisher's key (from publishers.json)
- Verify registry_certificate with REGINALD's key (from public-key.pem)

## Publisher Discovery
Publishers host .well-known/mx-cogs.json on their domain for REGINALD to
crawl, or submit COGs directly to the registry.

## Response Format (latest.json)
- resolve_mode: "pointer" (always — REGINALD is a resolver, not a host)
- canonical_url: Publisher's authoritative content URL
- content_hash: sha256 integrity hash
- registry_certificate: REGINALD's Ed25519 signature
- publisher: { namespace, name, domain }

## Current Registry
- Publishers: 2
- Namespaces: 2
- Total COGs: 83
- Signed COGs: 82 (Ed25519, verifiable)

## Contact
- Website: https://allabout.network
- Email: tom.cranstoun@gmail.com
- Registry: https://reginald.allabout.network/

Generated: 2026-03-17T12:02:15.921Z