Documentation · MVP

The technical specification.

Everything you need to publish, resolve and audit listings against the v0.4 reference implementation at www.airegistry.mu.

OverviewAIR-ID formatListing metadataProvider verificationReview workflow

§ 01 Overview

The specification defines the listing schema, sovereignty rubric, identifier format, and verification proofs the registry implements.

# example
GET /.well-known/air-spec/overview
→ 200 OK  application/yaml

§ 02 AIR-ID format

air://[jurisdiction]/[kind]/[provider]/[name]@[version] - stable, resolvable, and human-readable.

# example
GET /.well-known/air-spec/air-id
→ 200 OK  application/yaml

§ 03 Listing metadata

Provider, kind, sovereignty bases with evidence, contact, terms, license, region, optional SPIFFE trust domain.

# example
GET /.well-known/air-spec/metadata
→ 200 OK  application/yaml

§ 04 Provider verification

DNS TXT and email-based proofs. Any mismatch flips status to "unverified" and surfaces a public note.

# example
GET /.well-known/air-spec/verification
→ 200 OK  application/yaml

§ 05 Review workflow

Reviewers apply the published checklist, record signed notes, and assign a status. Appeals are public.

# example
GET /.well-known/air-spec/review
→ 200 OK  application/yaml