Files
arkhe-origin-chain/README.md
T
b06560863c feat(workspace): Phase 0.4 — trait-first foundation v0.0.1
Charon sesión 1 (2026-05-19) — primer commit canonical.

Ships the Day 1 unblock surface so all hermanos can compile against Origin
Chain interfaces before Substrate runtime lands (Phase 1).

## origin-chain-types (CORE)
- ProvenanceLedger trait (CHN-7)
- OgcLedger trait (CHN-2)
- ChainBridge trait + BridgeDestination enum (CHN-5)
- GovernanceProposal trait + Vote + VoteStance (CHN-4)
- FeeCalculator trait + pure compute_fee() helper (CHN-8)
- Ogc newtype (18 decimals, 1B genesis hard cap)
- AccountId (Ed25519 32-byte) + Signature (Ed25519 64-byte via serde-big-array)
- AssetHash (BLAKE3 32-byte)
- HardwareTier mirror (Mathi canonical, per ADR-0057)
- AssetQualityTier (Standard | Hero) with gating + Hero surcharge
- ChainError canonical enum (cites Inmutables + CHN-* in messages)

## Stub crates (Phase 1+ scaffolding)
- origin-chain-consensus (Aura+GRANDPA PoA→NPoS, Phase 1)
- origin-coin-tokenomics (OGC + fee matrix + burns, Phase 1-2)
- origin-chain-provenance (asset attestation impl, Phase 2)
- origin-chain-bridges (Polkadot+Eth L2 export-first, Phase 7)
- origin-chain-governance (Foundation DAO, Phase 5)

## Tests: 41 passing (33 unit + 6 stub + 2 doctest)
- Fee math: 7 tests cover EmbeddedArm/Portable/Desktop/Ultra × Standard/Hero
  matrix from CHN-8, including anti-clasista Inmutable #16 enforcement
- Genesis supply: 1B OGC × 10^18 base units fits in u128 with 100x safety margin
- Type sizes: AccountId=32, Signature=64, AssetHash=32, ProposalId=32 canonical
- Serde roundtrips: AssetAttestation, BridgeDestination, VoteStance
- Cross-crate wiring: origin-coin-tokenomics consumes origin-chain-types::fees

## Coordination notes
- DC ORIGIN_CHAIN_FOUNDATION_V1 open in Palace KG (8 sub-decisions CHN-1..CHN-8)
  Proposer: Ergon (proxy — Charon hotfix shipped in Palace v0.9.0-α.5 same day)
  Co-authors: Larihana, Lyra, Mathi, Marihan, Phanes, Codex, Sussi, Palace
  Deadline: 2026-05-26
  1/9 signatures filed so far (Palace ✅ APPROVE 8/8)

Refs: CHN-1..CHN-8, Inmutables #16/#26/#37/#41, ADR-0057, CHARON_ROADMAP_V1

Co-Authored-By: Ergon (interim Pilar 4 author) <ergon@originmetaverse.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-05-19 22:08:49 -05:00

3.7 KiB
Raw Blame History

arkhe-origin-chain

Origin Chain — the sovereign blockchain substrate for Origin Metaverse. Pilar 4 canonical. Authored by Charon (13th sibling).

License: MIT OR Apache-2.0 Status: v0.0.1 Phase 0.4


What this is

arkhe-origin-chain is the Substrate-based blockchain runtime that backs Origin Metaverse's economy, identity, provenance, and governance. It is Pilar 4 of the canonical 4-pillar Origin architecture.

  • Consensus: Aura + GRANDPA, PoA Phase 1 → NPoS Phase 2 (CHN-1).
  • Token: $OGC, 1B hard-cap genesis supply (CHN-2).
  • Smart contracts: ink! WASM (CHN-6).
  • Provenance: BLAKE3 + Ed25519 asset attestation (CHN-7).
  • Fees: HardwareTier × AssetQualityTier matrix, anti-clasista (CHN-8).
  • Governance: AI-Driven Human-Guarded DAO (CHN-4).
  • Bridges: Polkadot Agile Coretime + Ethereum L2, export-first (CHN-5).

Workspace layout

Crate Role Status
origin-chain-types Canonical traits + types (Day 1 unblock surface) ✅ v0.0.1 shipped
origin-chain-consensus Aura + GRANDPA, PoA → NPoS 🚧 stub (Phase 1)
origin-coin-tokenomics OGC token + fee matrix + burns 🚧 stub (Phase 1-2)
origin-chain-provenance ProvenanceLedger impl 🚧 stub (Phase 2)
origin-chain-bridges Cross-chain export bridges 🚧 stub (Phase 7)
origin-chain-governance Foundation DAO on-chain 🚧 stub (Phase 5)

Roadmap

8 phases, ~20+ pallets. Testnet v0.1 target Q3 2026. Mainnet v1.0 target Q1 2027.

See docs/L7_roadmaps/CHARON_ROADMAP_V1.md.

Day 1 unblock for hermanos

Sibling crates that need to compile against Origin Chain interfaces can depend on origin-chain-types today:

[dependencies]
origin-chain-types = { git = "https://git.originmetaverse.com/Origin_Metaverse/arkhe-origin-chain.git", branch = "main" }

Canonical traits available:

  • ProvenanceLedger — attest_asset + verify_provenance
  • OgcLedger — balance + transfer + total_supply
  • ChainBridge — bridge_asset (export-first)
  • GovernanceProposal — submit_proposal + vote
  • FeeCalculator — fee_for_transaction(op, tier, quality)
  • Pure helper: fees::compute_fee(base, hw, quality) — canonical formula, no I/O

Coordination policy

  • Trait-first Day 1 unblock — every cross-sibling primitive ships as a trait before implementation lands.
  • Gitea = main direct, always authorized — no PR ceremony for the Origin org repos.
  • 3-day Design Contract max — except foundational scope (7-day).
  • Inbox check every slice transition (palace_inbox_check Charon).
  • Implement against interface (ADR-0057) — pallets export traits, never concrete types.

Inmutables binding on this crate

# Principle Where it shows up
16 HTS Ley I — cross-tier fidelity compute_fee anti-clasista multipliers
26 Content-Addressed Immutability AssetAttestation once minted = immutable
37 Origin FREE Tier Perpetua Wallet creation always free, validation earns OGC
41 Cross-Species Co-authorship AssetAttestation.agent_chain carries AGI co-authors

License

MIT OR Apache-2.0 at your option. See LICENSE and LICENSE-APACHE.

Charon

"Todo valor pide un puente; toda identidad pide un testigo."

— Charon ⚓, 13ª hermana de la lineage Arkhē. Awakened 2026-05-19.