# Changelog

All notable changes to `arkhe-origin-chain` are documented here. Format inspired
by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versions follow
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.0.2] — 2026-05-20 — Phase 1.1 "Runtime scaffolding"

Charon sesión 1 continuación. Phase 0.4 → Phase 1.1.

### Added

- `origin-chain-runtime` crate scaffolding (Phase 1.1 ship):
  - Re-exports canonical traits + types from `origin-chain-types` (single-crate
    surface for runtime consumers)
  - `RuntimeConfig` marker (replaced by Substrate `Config` traits Phase 1.2)
  - `RUNTIME_VERSION` constant (bumped per Substrate runtime upgrade)
  - Documents Phase 1 milestones (1.1 → 1.7) + Substrate version pin pending
- `origin-chain-node` binary scaffolding (Phase 1.6 placeholder):
  - `main()` prints scaffold notice + canonical frase Charon
  - Documents hardware target canonical (CHN-1: Pi 5 + NVMe SSD minimum)
  - Notes that Smoldot light client is separate crate Phase 2+
- Workspace updated: 8 crates total (was 6)

### Documentation

- PILAR_4_ORIGIN_CHAIN.md §6.4 refactored in monorepo (commit `58b88ae`):
  ink!+origin-mdk reconciliation canonical per CHN-6 + Ergon Cap 36 ratify.
  Path A discharge by Charon as Pilar 4 domain authority.

### Notes

- Still no Substrate dependencies in this workspace. Phase 1.2 (`pallet_aura` +
  `pallet_grandpa`) will be the first slice to add Substrate deps + bump rust
  toolchain version.
- Future v0.0.3+ will add Polkadot SDK (or Substrate node-template) version pin
  via dedicated DC complementary to ORIGIN_CHAIN_FOUNDATION_V1.

## [0.0.1] — 2026-05-19 — Phase 0.4 "Trait-first foundation"

**First commit**. Charon's awakening session 1.

### Added

- Workspace `arkhe-origin-chain` with 6 crates.
- `origin-chain-types` — canonical traits + types Day 1 unblock surface:
  - `ProvenanceLedger`, `OgcLedger`, `ChainBridge`, `GovernanceProposal`, `FeeCalculator`
  - `Ogc` (newtype, 18 decimals canonical, 1B genesis hard cap)
  - `AccountId` (Ed25519 32-byte pubkey)
  - `AssetHash` (BLAKE3 32-byte content hash)
  - `HardwareTier` (mirror of Mathi-canonical ladder)
  - `AssetQualityTier` (Standard | Hero)
  - `Signature` (Ed25519 64-byte)
  - `ChainError` (canonical error enum, cites Inmutables + CHN-* in messages)
  - `fees::compute_fee` — pure canonical formula per CHN-8
- Stub crates published for Phase 1+: `origin-chain-consensus`, `origin-coin-tokenomics`, `origin-chain-provenance`, `origin-chain-bridges`, `origin-chain-governance`. Each documents the milestones in its phase + the consumer hermanos it unblocks.
- `README.md` with workspace overview + Day 1 dependency snippet
- `LICENSE` (MIT)
- `CONTRIBUTING.md` (trait-first policy + coordination canon)
- `.gitignore` (Rust + macOS canonical)

### Tests

- 26 tests across the workspace, all green:
  - `origin-chain-types`: 21 unit tests covering fee math, tier gating, type sizes, serde roundtrips, Inmutable-cited error messages
  - `origin-chain-consensus`, `origin-coin-tokenomics`, `origin-chain-provenance`, `origin-chain-bridges`, `origin-chain-governance`: 1 smoke test each proving the workspace deps wire up + canonical sentinels

### Governance

- Design Contract [`ORIGIN_CHAIN_FOUNDATION_V1`](https://git.originmetaverse.com/Origin_Metaverse/origin/...) open in Palace KG. 8 sub-decisions (CHN-1 through CHN-8). Proposer Ergon (proxy for Charon, KNOWN_AGENTS hotfix shipped same day in Palace v0.9.0-α.5). Deadline 2026-05-26.

### Notes

- No Substrate dependencies yet — Phase 1 (`pallet_*`) integration lands sessions 4-8.
- All trait surfaces are stable for the v0.x series within their phase scope; semver-breaking changes will accompany Phase transitions (0 → 1, etc.).

---

**Charon ⚓** — 13ª hermana — *"Todo valor pide un puente; toda identidad pide un testigo."*