AION
/Substrate Codex
The Answer ContractCryptographic Provenance

Evidence & Hash Provenance

Constitutional Law 1 mandates: Evidence over generation. Generated language is never the source of truth. Every claim, observation, and timeline milestone structurally binds to immutable primary evidence with cryptographic tamper-verification.

How Cryptographic Verification Operates

1. AT INGESTION

When a document or circular is captured, AION stores the unmodified raw HTML/PDF payload into Cloudflare R2 / S3 and computes an unalterable SHA-256 hash.

2. AT EXTRACTION

Every extracted Observation and Claim retains a foreign key to the Evidence UUID, preserving the sentence-level offset and author timestamp.

3. AT AUDIT

Anyone can download the raw snapshot, compute sha256sum independently, and verify that the stored record matches bit-for-bit with the citation.

Evidence Entity Properties

PropertyTypeDescription
evidenceIdUUIDUnique immutable identifier for this atomic record of ingested evidence.
canonicalUrlstring (URI)Original HTTP(S) origin URL from monitored gazettes, court archives, or national circulars.
contentHashstring (64-char hex)Cryptographic SHA-256 digest computed over the raw ingested payload at time of collection.
publishedAtISO-8601 stringOfficial publication timestamp as declared by the primary source entity.
collectedAtISO-8601 stringExact station ingestion timestamp recorded when AION collected the record.
sourceIdUUIDForeign reference to the attributed source publisher profile in AION's source registry.
rawTextSnippetstringContextual raw excerpt containing the exact sentence from which claims were extracted.

Provenance Resolver Endpoints

GET /v1/evidence/{id}Returns Typed JSON Provenance Record
curl -H "X-AION-Key: aion_live_..." https://api.aion.ng/v1/evidence/069255b3-f46b-4c97-938b-e2d85e17504c
GET /v1/evidence/{id}/artifactRenders Immutable HTML Artifact in Browser
# Opens the high-fidelity Editorial Provenance Viewer https://api.aion.ng/v1/evidence/069255b3-f46b-4c97-938b-e2d85e17504c/artifact

Independent Terminal Verification

Verify an AION evidence artifact independently without trusting the server:

# 1. Download the raw snapshot payload
curl -s https://api.aion.ng/v1/evidence/069255b3-f46b-4c97-938b-e2d85e17504c/artifact?raw=1 > snapshot.html

# 2. Compute local SHA-256 digest
shasum -a 256 snapshot.html

# 3. Compare with the contentHash declared in the Answer Contract citation:
# e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 (MATCH)
Next Module
Quickstart: Executing Your First Analytical Query
Follow Quickstart →