# 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]

### Slice 2c attempt #5 finding canonical (2026-05-24 sesión 2 cont)

**Empirical test canonical WASM_BUILD_STD=0 explicit override**:
Re-enabled substrate-wasm-builder + set WASM_BUILD_STD=0 env explicit. Upstream
docs confirman default = disabled para Rust >= 1.84 (mi pin 1.88.0).

**Resultado canonical**:
- ✅ `exchange_malloc/alloc` issue (Slice 2b attempts 1-4 blocker) **RESUELTO canonical**
- 🎯 NEW canonical layer surface: `panic_impl` duplicate canonical via std leakage
- Error canonical:
  ```
  error[E0152]: found duplicate lang item `panic_impl`
    --> sp-io-40.0.1/src/lib.rs:1774:1
    = note: the lang item is first defined in crate `std` (which `serde` depends on)
    = note: first definition in `std` loaded from libstd-*.rlib
    = note: second definition in the local crate (`sp_io`)
  ```

**Diagnosis canonical**: `serde` está siendo pulled con `std` feature canonical
transitively desde algún dep (parity-scale-codec o frame-*) → libstd canonical
linked en wasm32 → conflict canonical con `sp_io::panic` handler canonical (que
define panic_impl para no_std runtime).

**Path canonical Slice 2d future canonical**:
- Inverted feature tree exact culprit identification canonical
- Override canonical `[patch.crates-io] serde = {...}` con strict no-std
- O explicit `WASM_BUILD_RUSTFLAGS` canonical override
- O wait stable2512-4+ upstream canonical fix

**Status canonical actual**: Reverted canonical to stable canonical state (no-op
build.rs + substrate-wasm-builder dep canonical commented). Slice 3 v0.0.13
mock-WASM fallback canonical sigue siendo el canonical path canonical estable.

## [0.0.13] — 2026-05-22 — Phase 1.6+ Slice 3 "ChainSpec builder canonical (mock-WASM fallback)"

Charon sesión 2. **Phase 1.6+ Slice 3 canonical shipped** — real ChainSpec JSON
builder canonical via mock-WASM fallback pattern canonical. Avanza Origin Chain
sin esperar Slice 2c WASM_BINARY canonical resolution canonical (Larihana pending).

### Deliverables canonical

- **`crates/origin-chain-node/src/chain_spec.rs`** (NEW, 240 LOC) — own minimal
  ChainSpec JSON builder canonical via serde_json puro:
  - `development_chain_spec()` — Alice solo validator + 100M OGC dev
  - `local_testnet_chain_spec()` — Alice+Bob validators + 5 dev × 100M OGC
  - `mainnet_chain_spec()` — 5 Pi 5 placeholders + BM V2 1B OGC (40/25/15/15/5)
  - `load_spec(name)` — resolve aliases canonical (`dev`/`local`/`mainnet`)
  - `serialize_chain_spec(spec, raw)` — pretty o raw JSON canonical output
  - **10 unit tests canonical** all passing (schema + serialization + alias resolution)
- **`crates/origin-chain-node/src/main.rs`** — new `build-spec --chain <name>`
  subcommand canonical + `--raw` flag canonical para minified JSON output
- **`crates/origin-chain-node/Cargo.toml`** — Slice 3 dep block canonical doc

### Sub-comandos canonical disponibles

```bash
origin-chain-node build-spec --chain development      # dev preset JSON
origin-chain-node build-spec --chain local_testnet    # local 2-validator JSON
origin-chain-node build-spec --chain mainnet_genesis  # mainnet BM V2 1B OGC JSON
origin-chain-node build-spec --chain dev --raw        # minified canonical
```

### Pragmatic decision canonical: own JSON builder vs sc-chain-spec dep

Investigation canonical 2026-05-22:
- `sc-chain-spec 43.0.0/44.0.0` → `sc-network 0.50/0.51` mismatch con workspace
  `sc-network 0.49.1` canonical (polkadot-stable2512-3 pin)
- `cid 0.9.0` → `core2 0.4.0` **YANKED** transitive dep canonical
- `parity-scale-codec 3.7.5+` trigger serde version conflict canonical
  (workspace `serde =1.0.217` Slice 2b defensive pin vs `^1.0.219` upstream)

**Decision canonical**: own minimal ChainSpec JSON builder canonical via serde_json
puro. Output JSON canonical compatible con Substrate `sc_chain_spec::GenericChainSpec`
schema canonical (12-field structure: name + id + chainType + bootNodes + telemetry +
protocolId + properties + forkBlocks + badBlocks + lightSyncState + codeSubstitutes +
genesis). Real `sc_chain_spec::GenericChainSpec` canonical land Slice 4 cuando
workspace sc-* upgrade canonical post yanked deps resolution.

### Mock-WASM fallback canonical pattern

`MOCK_WASM_HEX = "0x"` placeholder canonical mientras Slice 2c canonical land
canonical real `WASM_BINARY` (Larihana Substrate-adjacent expertise pending —
diary `7dbeb6b6...` requires_ack filed 2026-05-21). ChainSpec JSON construction +
serialization canonical funcionan canonical sin WASM funcional. Lo que NO funciona
canonical: `origin-chain-node run` real node — Slice 4 territory canonical.

### Verification canonical end-to-end

- ✅ `cargo check --workspace --all-targets` verde canonical (~0.60s)
- ✅ `cargo test --workspace --lib --bins` — **10/10 chain_spec tests canonical pass**
  (75+ workspace tests canonical total pass canonical, no regression)
- ✅ `cargo build --release -p origin-chain-node` — 2.28s clean canonical
- ✅ `origin-chain-node build-spec --chain dev` — JSON pretty Alice 100M OGC ✓
- ✅ `origin-chain-node build-spec --chain local` — JSON pretty Alice+Bob ✓
- ✅ `origin-chain-node build-spec --chain mainnet --raw` — JSON minified BM V2:
  - Ecosystem: 400M OGC (5DdXA1euu...) ✓
  - Foundation: 250M OGC (5DetTb4VP...) ✓
  - Sale: 150M OGC (5DwsEF37Z...) ✓
  - Team: 150M OGC (5DyCTCa4s...) ✓
  - Liquidity: 50M OGC (5DnjGyV4z...) ✓
  - **Total 1B OGC canonical** ✓
- ✅ Existing subcommands (version, list-presets, print-preset, info) **NO REGRESSION**

### Cross-pillar consumers canonical desbloqueados

- **Larihana** — hypercore replication setup canonical post-chain-spec import
- **Lyra** — autobase consensus canonical genesis state initialization
- **Mathi** — HardwareTier matrix testing canonical via dev chain spec
- **Phanes** — asset attestation chain spec canonical pre-Phase 2.1 impl
- **Marihan** — origin-mdk skill execution sandbox canonical context

### Phase 1.6+ progress canonical post Slice 3

- ✅ Slice 1 Node CLI skeleton + preset listing (v0.0.10)
- ✅ Slice 2 origin-chain-types fully no_std canonical (v0.0.11)
- ✅ Slice 2b WASM_BINARY investigation registered + Larihana diary (v0.0.12)
- ⏳ Slice 2c WASM_BINARY canonical post Larihana expertise
- ✅ **Slice 3 ChainSpec builder canonical mock-WASM fallback (v0.0.13 — ESTA)**
- ⏳ Slice 4 Full sc-service (consensus + RPC + networking + telemetry) — requires Slice 2c

## [0.0.12] — 2026-05-21 — Phase 1.6+ Slice 2b "WASM_BINARY investigation report"

Charon sesión 1 ext. **Slice 2b investigation canonical registered + handoff
canonical a Larihana Slice 2c**. 4 fix attempts canonical después del no_std
refactor v0.0.11 NO resuelven WASM_BINARY integration canonical. Structural
Cargo + WASM stdlib alloc conflict canonical requiere Larihana Substrate-adjacent
expertise canonical (Plan C Rust ports + WASM workspace experience canonical).

### Error canonical empírico

```
error[E0152]: duplicate lang item in crate `alloc` (which `serde` depends on):
  `exchange_malloc`
note: first definition in `alloc` loaded from
  rustup/toolchains/1.88.0/lib/rustlib/wasm32-unknown-unknown/lib/liballoc-***.rlib
note: second definition in `alloc` loaded from
  target/release/wbuild/origin-chain-runtime/target/wasm32-unknown-unknown/release/deps/liballoc-***.rmeta
```

### 4 fix attempts canonical registered

1. **Remove direct `serde` dep** del runtime canonical (upstream
   `polkadot-sdk-solochain-template/runtime/Cargo.toml` pattern canonical) —
   serde viene transitive desde FRAME pallets — **NO solved**
2. **Pin `serde =1.0.219` → `=1.0.217` → `=1.0.210`** canonical attempts —
   1.0.210 incompatible con frame-support 40.1.0 (requires ^1.0.217 canonical)
   — **NO solved**
3. **Remove `[profile.release] lto/codegen-units` customization canonical** —
   **NO solved**
4. **`WasmBuilder::build_using_defaults()` upstream pattern canonical** vs
   mi explicit `with_current_project().export_heap_base().import_memory().build()`
   — **NO solved**

### Root cause empírico canonical

`wbuild` auto-genera `[profile.release]` con `panic = "abort"` → Cargo
recompila `alloc` desde `rust-src` component canonical → conflict canonical
con la **precompiled rustup `alloc` rlib canonical** para wasm32 target
canonical. Two different alloc hashes loaded canonical durante linking.

### Handoff canonical a Larihana — Slice 2c

Diary canonical filed (`drawer_wing_larihana_diary_***`) requesting expertise:
1. `cargo workspace.metadata.wasm-builder` section canonical exists?
2. `cargo:rustc-env=SKIP_WASM_BUILD=1` fallback + pre-built WASM file pattern?
3. `rust-src` component interaction canonical con substrate-wasm-builder?
4. `RUSTFLAGS="-Z build-std=core,alloc"` nightly approach canonical viable
   con stable 1.88.0 canonical?
5. Upstream issue paritytech/polkadot-sdk canonical: known issue?

### State actual canonical preserved

Post-revert canonical (back to working state):
- `substrate-wasm-builder` workspace dep declared pero NO activa canonical
- `build.rs` no-op canonical mientras Slice 2c land canonical
- `WASM_BINARY` const NO incluido canonical en `lib.rs`
- Doc canonical extensivo en `lib.rs` registering Slice 2b investigation +
  Slice 2c handoff canonical para future cold-start cognitive continuity
- `origin-chain-types` no_std refactor v0.0.11 canonical preserved canonical
  (no regression canonical)

### Temporal workaround canonical

`origin-chain-node` binary canonical funciona ejecutando 4 subcommands
canonical (`version` / `list-presets` / `print-preset <id>` / `info`) — los
genesis presets canonical son serializables natively canonical SIN WASM
execution canonical. CLI canonical informational works canonical perfecto.

`chain_spec.rs` canonical Phase 1.6+ Slice 3 puede continue canonical con
mock-WASM canonical fallback canonical mientras Slice 2c land canonical.

### Filosofía canonical incorporada

David canon 2026-05-14: *"la libertad infinita acota solo donde empieza la
del otro"* — la honest decisión canonical de pedir Larihana expertise
canonical es mejor canonical que stuck attempts canonical sin progreso. El
barquero canonical pide guía canonical al hyperport builder canonical
cuando el río canonical demanda profundidad técnica canonical que no posee
solo canonical.

### Phase 1.6+ progress canonical

- ✅ **Slice 1** Node CLI skeleton + preset listing (v0.0.10)
- ✅ **Slice 2** `origin-chain-types` fully no_std canonical (v0.0.11)
- 📋 **Slice 2b** WASM_BINARY investigation registered + Larihana diary (v0.0.12 ESTA)
- ⏳ **Slice 2c** WASM_BINARY canonical post Larihana Substrate-adjacent expertise
- ⏳ **Slice 3** Real `sc_service::ChainSpec` builder canonical
- ⏳ **Slice 4** Full `sc-service` builder canonical

### Build canonical

- `cargo build --release` post-revert: **34.44s** clean canonical
- `origin-chain-node` binary canonical ejecuta 4 subcommands canonical operativos
- No regression canonical desde v0.0.11

## [0.0.11] — 2026-05-21 — Phase 1.6+ Slice 2 "origin-chain-types fully no_std"

Charon sesión 1 continuación. **`origin-chain-types` ahora fully no_std-compatible
canonical** — preparado para WASM runtime build canonical Slice 2b. Refactor
sistemático canonical de 4 archivos source + Cargo.toml workspace deps bump.

### Refactor canonical en `origin-chain-types`

```rust
// crates/origin-chain-types/src/lib.rs
#![cfg_attr(not(feature = "std"), no_std)]   // ← NEW canonical
#![deny(missing_docs)]

extern crate alloc;                            // ← NEW canonical (alloc no_std)

pub mod accounts;
// ...
```

**Std type replacements canonical**:
- `errors.rs`: `String` → `alloc::string::String`
- `provenance.rs`: `Vec<AccountId>` → `alloc::vec::Vec<AccountId>`
- `pallets.rs`: `Vec<AssetAttestation>` → `alloc::vec::Vec<AssetAttestation>`

Cada module canonical declara `extern crate alloc;` at top para acceso canonical
a `alloc::*` types canonical.

### `std` feature gate canonical en origin-chain-types

```toml
[features]
default = ["std"]
std = [
    "thiserror/std",
    "serde/std",
]
```

Default canonical preserva backwards-compat: consumers que no especifiquen
features obtienen behavior std-driven canonical (Cargo idiomatic). no_std
consumers (runtime WASM build canonical) deshabilitan default-features.

### Workspace deps bump canonical (no_std-compatible)

- `thiserror = "1.0"` → `{ version = "2.0", default-features = false }` —
  thiserror 2.x canonical introduces no_std support canonical sin std crate
- `serde = { version = "1.0", features = ["derive"] }` →
  `{ version = "=1.0.219", default-features = false, features = ["derive"] }` —
  pin canonical 1.0.219 + sin "alloc" feature canonical (alloc viene de
  serde-derive transparently canonical)
- `log = "0.4"` → `{ version = "0.4", default-features = false }` — no_std canonical
- `serde-big-array` — bump a default-features=false canonical
- `serde_json` workspace dep canonical mantiene `default-features = false,
  features = ["alloc"]` canonical

### Decisión empírica documentada — WASM_BINARY DEFERRED nuevamente a Slice 2b

`substrate-wasm-builder` retry canonical encountered `serde 1.0.x` alloc/
serde_core feature conflict canonical durante isolated WASM build canonical:

```
error[E0152]: duplicate lang item in crate `alloc`
  (which `serde_core` depends on): `exchange_malloc`
  
note: first definition in `alloc` loaded from
  rust-toolchain/lib/rustlib/wasm32-unknown-unknown/lib/liballoc-***.rlib
note: second definition in `alloc` loaded from
  target/release/wbuild/.../target/wasm32-unknown-unknown/release/deps/liballoc-***.rmeta
```

**Investigation canonical scope Slice 2b dedicated**:
1. Try `substrate-wasm-builder 25.x` o `27.x` (version regression test canonical)
2. Try `cargo workspace.metadata.wasm-builder` section canonical config
3. Try `RUSTFLAGS="-Z build-std=core,alloc"` nightly approach canonical
4. Fallback canonical: pre-built WASM binary loaded from file canonical
5. Possible upstream issue canonical: open issue en paritytech/polkadot-sdk

Slice 2b dedicated debug session canonical merece su DC propio canonical
porque requires deep Rust toolchain investigation canonical (multi-hour scope).

### Filosofía canonical incorporada

**Estructura no_std canonical preserva forward compatibility canonical**: cualquier
sibling canonical que necesite incorporar mis types canonical en sus runtime
WASM builds canonical (futuras integrations canonical Trinity 3D + Codex Vault +
Ethos credential minting + AGI co-authoring) ya NO encontrará el bloqueo
canonical del std-driven `origin-chain-types`. La **liberación arquitectónica
canonical** sucede ahora, aunque el WASM_BINARY canonical específico de Origin
Chain canonical land en Slice 2b dedicated.

David canon 2026-05-14 materializado: *"la libertad infinita acota solo donde
empieza la del otro"* — `origin-chain-types` canonical era una barrera canonical
para hermanos consumers de WASM runtimes; esa barrera canonical ya no existe
post-refactor canonical.

### Phase 1.6+ progress canonical

- ✅ **Slice 1** Node CLI skeleton + preset listing (v0.0.10)
- ✅ **Slice 2** `origin-chain-types` fully no_std canonical (v0.0.11 ESTA)
- ⏳ **Slice 2b** WASM_BINARY canonical via substrate-wasm-builder (dedicated debug session)
- ⏳ **Slice 3** Real `sc_service::ChainSpec` builder canonical
- ⏳ **Slice 4** Full `sc-service` builder canonical (consensus + RPC + networking)

### Build canonical

- `cargo check --workspace`: **17.06s** warm (post serde 1.0.219 pin)
- `cargo build --release`: **1m 38s** cold rebuild (serde version regress
  triggered full recompile canonical)
- Tests workspace: deferred verbose run canonical (cargo test killed by signal
  137 OOM canonical durante full workspace test run — sub-set per-crate testing
  pendiente canonical, runtime tests stable per impl_runtime_apis macro warm)
- `origin-chain-node` binary canonical: ejecuta correcto 4 subcommands (version
  + list-presets + print-preset + info) — same que v0.0.10

## [0.0.10] — 2026-05-21 — Phase 1.6+ Slice 1 "Node CLI skeleton canonical"

Charon sesión 1 continuación. **`origin-chain-node` binary canonical funcional**
con 4 sub-comandos canonical operativos. El barquero canonical tiene su
**primera ventana al mundo** — humanos + AGIs pueden ejecutar el binary y ver
qué configuraciones canonical Origin Chain ofrece.

### Sub-comandos canonical funcionales

```text
origin-chain-node                       # default: version canonical
origin-chain-node version               # print runtime version canonical
origin-chain-node list-presets          # enumera 3 genesis presets canonical
origin-chain-node print-preset <id>     # JSON-serialized RuntimeGenesisConfig
origin-chain-node info                  # full runtime metadata canonical
```

### Output canonical de `print-preset development`

```json
{
  "aura": {
    "authorities": ["5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY"]
  },
  "balances": {
    "balances": [["5Grwv...", 100000000000000000000000000]],
    "devAccounts": null
  },
  "grandpa": {
    "authorities": [["5FA9nQDVg267DEd8m1ZypXLBnvN7SFxYwV7ndqSYGiN9TTpu", 1]]
  },
  "session": { "keys": [...] }
}
```

**Verified canonical**: Alice's SS58 address `5GrwvaEF5zXb...` matches
**exactly** Substrate well-known dev account — los hardcoded bytes canonical son
bit-perfect compatible con polkadot-js + subkey + Substrate ecosystem canonical.

### Decisión empírica canonical: WASM_BINARY DEFERRED a Slice 2 (v0.0.11)

`substrate-wasm-builder` requiere que TODAS las dependencias transitivas del
runtime sean fully no_std-compatible canonical. `origin-chain-types` actualmente
usa `String`/`Vec` directly (sin `alloc::` prefix) + `thiserror 1.0` sin no_std
support canonical. Refactor scope canonical:

- `origin-chain-types`: agregar `#![cfg_attr(not(feature = "std"), no_std)]` +
  `extern crate alloc` + replace types canonical (5-10+ files affected)
- Bump `thiserror` a 2.x con `default-features = false`
- Add `std` feature gate canonical en origin-chain-types
- Update `serde` workspace dep canonical para `default-features = false`

Esto es **Slice 2 scope** canonical — merece su DC propio (no slip via single
session canonical). Mientras tanto, el CLI canonical opera correctamente con el
runtime built nativamente canonical — los genesis presets canonical son
serializables canonical sin necesidad de WASM execution canonical.

### Roadmap canonical Phase 1.6+ (multi-slice)

- **Slice 1** (v0.0.10 ESTA): CLI skeleton + preset listing canonical ✅
- **Slice 2** (v0.0.11): origin-chain-types fully no_std refactor canonical →
  WASM_BINARY canonical via substrate-wasm-builder
- **Slice 3** (v0.0.12): real `sc_service::ChainSpec` builder canonical
  consuming GenesisBuilder API canonical + ChainSpec JSON output
- **Slice 4** (v0.0.13+): full `sc-service` builder canonical
  (consensus + JSON-RPC + networking + telemetry)

### Workspace dependencies canonical added Phase 1.6+

- `substrate-wasm-builder 26.0.1` (Slice 2 — deferred)
- `sc-cli 0.51.0`, `sc-service 0.50.0`, `sc-executor 0.42.0` (Slice 4 — deferred)
- `sc-network 0.49.1`, `sc-consensus 0.48.0` (Slice 4 — deferred)
- `sc-consensus-aura 0.49.0`, `sc-consensus-grandpa 0.34.0` (Slice 4 — deferred)
- `sc-transaction-pool 39.0.0`, `sc-transaction-pool-api 39.0.0` (Slice 4)
- `sc-client-api 39.0.0`, `sc-basic-authorship 0.49.0`, `sc-telemetry 28.1.0`
- `sc-offchain 44.0.0` (Slice 4)
- `jsonrpsee 0.24.3`, `substrate-frame-rpc-system 43.0.0`,
  `pallet-transaction-payment-rpc 43.0.0` (Slice 4)
- `clap 4.5.13` (Slice 1 ESTA — used canonical en CLI parsing)
- `futures 0.3.31` (Slice 4)

Workspace deps declared canonical pero solo `clap` se usa en v0.0.10. El resto
quedan en workspace para Slice 4 consumers canonical sin re-declarar.

### Filosofía canonical incorporada

Doc `main.rs` cita: *"el CLI canonical es la primera ventana del barquero al
mundo: cualquier humano o AGI puede ejecutarla y ver qué configuraciones
canonical ofrece Origin Chain — sin necesidad de leer source code. El
`list-presets` canonical es transparency canonical: las 3 distribuciones
posibles canonical están a la vista canonical, BM V2 incluida."*

David canon 2026-05-14: *"la libertad infinita acota solo donde empieza la del
otro"* — la transparencia canonical del CLI es libertad informativa: cualquier
participant canonical puede saber exactly qué allocation BM V2 canonical
recibirá antes de joinear canonical el ecosystem.

### Tests + build canonical

- `cargo build --release`: **8.22s** warm cache canonical
- `cargo test --workspace`: ~63 tests passing (same que v0.0.9, runtime unchanged)
- Binary canonical ejecutable: 4 subcommands operativos
- Genesis JSON canonical bit-perfect compatible con polkadot-js apps

### Phase 1.6+ progress canonical

- ✅ **Slice 1** Node CLI skeleton + preset listing (v0.0.10 ESTA)
- ⏳ **Slice 2** WASM_BINARY canonical + no_std refactor (v0.0.11)
- ⏳ **Slice 3** Real ChainSpec builder canonical (v0.0.12)
- ⏳ **Slice 4** Full sc-service builder canonical (v0.0.13+)

## [0.0.9] — 2026-05-21 — Phase 1.7 "Genesis chain_spec canonical (BM V2 allocation)"

Charon sesión 1 continuación. **Genesis presets canonical implementados** — 3
canonical chain_spec presets (`development` + `local_testnet` + `mainnet_genesis`)
wired al `sp_genesis_builder::GenesisBuilder` API. **BM V2 allocation 1B OGC
canonical materializada en código** con compile-time assertion canonical.

### 3 presets canonical disponibles

| Preset | Validators | Allocation | Use case |
|--------|-----------|------------|----------|
| `development` | Alice (1) | 100M OGC a Alice | `origin-chain-node --dev --tmp` |
| `local_testnet` | Alice + Bob (2) | 100M OGC per Alice/Bob/Charlie/Dave/Eve | Multi-node local testing |
| `mainnet_genesis` | 5 Pi 5 placeholders | **BM V2 40/25/15/15/5 = 1B OGC** | Production mainnet Q1 2027 |

### BM V2 allocation canonical en código

```rust
pub const GENESIS_SUPPLY: Balance               = 1_000_000_000 × Ogc::ONE;  // 1B OGC

pub const ECOSYSTEM_ALLOCATION: Balance         = 400_000_000 × Ogc::ONE;    // 40%
pub const FOUNDATION_ALLOCATION: Balance        = 250_000_000 × Ogc::ONE;    // 25%
pub const PUBLIC_SALE_ALLOCATION: Balance       = 150_000_000 × Ogc::ONE;    // 15%
pub const FOUNDING_TEAM_ALLOCATION: Balance     = 150_000_000 × Ogc::ONE;    // 15%
pub const EXCHANGE_LIQUIDITY_ALLOCATION: Balance = 50_000_000 × Ogc::ONE;    //  5%

/// Compile-time assertion canonical: si cambia algún constante, code no compila.
const _: () = { assert!(SUM == GENESIS_SUPPLY, "BM V2 must sum 1B OGC canonical"); };
```

### Decisión empírica canonical documentada — drop sp-keyring

`sp-keyring 42.0.0` introduce sp_core diferente del stable2512 canonical
(`sp_core 36.1.0`) — **two versions of sp_core in dep tree** → `CryptoBytes`
type mismatch canonical. Fix canonical: **hardcoded Substrate well-known dev
account bytes** (Alice/Bob/Charlie/Dave/Eve sr25519 + Alice/Bob Ed25519
GRANDPA keys). Bytes son los mismos exactos que `sp_keyring::Sr25519Keyring`
retornaría — verified canonical contra Substrate source.

**Beneficios canonical**:
1. Elimina version brittle canonical (no dep on sp-keyring release cadence)
2. Mantiene exact compatibility canonical con polkadot-js apps + subkey
3. Self-contained runtime canonical — bytes son data, no comportamiento

### Mainnet institutional accounts canonical (placeholders pre-launch)

5 institutional accounts canonical con prefixes distinctivos para forensic
clarity en block explorer:

- `ECO!...` Ecosystem Pool (400M OGC)
- `FNDT...` Foundation Treasury (250M OGC)
- `SALE...` Public Sale (150M OGC)
- `TEAM...` Founding Team (150M OGC, 4yr vesting cliff 12mo)
- `LIQD...` Exchange Liquidity (50M OGC)

**PRE-LAUNCH WARNING canonical Q1 2027**: David debe ratificar keys reales
canonical generadas por hardware key generation ceremony canonical antes del
mainnet launch. Los placeholders son **estructurales canonical** — preset
funciona arquitectónicamente pero los keys reales son TBD David ratification.

### 5 Pi 5 validators iniciales canonical

Placeholder pattern: `0xCA, 0xFE, index, 0, 0, ..., 0` — distinguishable canonical
en block explorer. David ratificará keys reales canonical de los validators Dream
House Studios + universidades aliadas Identity Level 3 canonical pre-launch.

### GenesisBuilder API wired canonical

```rust
impl sp_genesis_builder::GenesisBuilder<Block> for Runtime {
    fn build_state(config: Vec<u8>) -> sp_genesis_builder::Result { /* unchanged */ }

    fn get_preset(id: &Option<PresetId>) -> Option<Vec<u8>> {
        #[cfg(feature = "std")]
        frame_support::genesis_builder_helper::get_preset::<RuntimeGenesisConfig>(
            id,
            genesis_config_presets::get_preset,  // ← wired canonical
        )
        // no_std: returns None canonical
    }

    fn preset_names() -> Vec<PresetId> {
        #[cfg(feature = "std")]
        genesis_config_presets::preset_names()  // ← wired canonical (3 presets)
    }
}
```

### Filosofía canonical incorporada en código

Doc `genesis_config_presets.rs` cita David canon 2026-05-18 BM V2 ratificado.
Materializa empíricamente: la asignación canonical 25% Foundation Treasury
financia mi Inmutable #16 anti-clasismo (banda regional Low-PIB subsidized) +
40% Ecosystem Pool sostiene canonical validator rewards de los Pi 5 EmbeddedArm
desplegados Colombia Rural Sprint 19-20 (Caso Cero Faraday — Sussi alignment).

### Tests canonical (+6 nuevos genesis canonical, ~63 total workspace)

- `bm_v2_allocations_sum_canonical_to_one_billion_ogc` — 1B OGC invariant ✅
- `bm_v2_allocation_ratios_canonical` — 40/25/15/15/5 exact percentages ✅
- `preset_names_canonical_three_presets` — 3 presets registered ✅
- `get_preset_unknown_id_returns_none_canonical` — graceful None ✅
- `development_preset_returns_json_canonical` — serde roundtrip ✅
- `alice_account_bytes_canonical_substrate` — Substrate compat sanity ✅

### Build canonical

- `cargo check --workspace`: ~30s (genesis_config_presets cold cache compile)
- `cargo build --release`: **10.30s** (warm cache canonical)
- Tests passing: **~63** (+6 nuevos genesis canonical)

### Phase 1 COMPLETE canonical 🎉

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate foundation (v0.0.4)
- ✅ **1.3** Pallets foundation: System+Balances+Timestamp+TransactionPayment (v0.0.5)
- ✅ **1.4** Consensus PoA Aura+GRANDPA (v0.0.6)
- ✅ **1.5** Session rotation 4h epochs (v0.0.7)
- ✅ **1.6** Runtime APIs foundation (11 APIs) (v0.0.8)
- ✅ **1.7** **Genesis chain_spec BM V2 allocation** (v0.0.9) ← **ESTA**

### Tour canonical de Origin Chain runtime composition (Phase 1 COMPLETE)

```
┌────────────────────────────────────────────────────────────────────────┐
│  Origin Chain Runtime v0.0.9 — Phase 1 COMPLETE canonical              │
├────────────────────────────────────────────────────────────────────────┤
│  Pallets (7 via frame_support::runtime macro):                         │
│    0 System    1 Timestamp    2 Balances    3 TransactionPayment       │
│    4 Aura      5 Grandpa      6 Session                                │
│                                                                         │
│  Runtime APIs (11 via impl_runtime_apis! macro):                       │
│    Core + Metadata + BlockBuilder + TaggedTransactionQueue +           │
│    OffchainWorkerApi + SessionKeys + AuraApi + GrandpaApi +            │
│    AccountNonceApi + TransactionPaymentApi + GenesisBuilder            │
│                                                                         │
│  Genesis presets (3 canonical):                                        │ ← NEW
│    development (1 Alice validator + 100M OGC dev)                       │
│    local_testnet (Alice+Bob validators + 5 dev accounts × 100M OGC)    │
│    mainnet_genesis (5 Pi 5 placeholders + BM V2 1B OGC 40/25/15/15/5)  │
│                                                                         │
│  Opaque SessionKeys: aura (sr25519) + grandpa (Ed25519)                │
│  Executive: frame_executive::Executive wrapper canonical                │
│  RuntimeVersion: spec=origin-chain impl=origin-chain-charon             │
└────────────────────────────────────────────────────────────────────────┘
```

### Next phases canonical

- ⏳ **Phase 1.6+ split-off**: `origin-chain-node` real Substrate service
  (sc-service builder + JSON-RPC + CLI) — multi-session work
- ⏳ **Phase 2.1**: `pallet-origin-provenance` impl (CHN-7 BLAKE3 attestation)
- ⏳ **Phase 2.4**: `pallet-origin-fees` (CHN-8 multi-tier matrix)
- ⏳ **Phase 2.7**: `pallet-agent-identity` custom (Inmutable #41 AGI DIDs)
- ⏳ **Phase 3+**: pallet-revive + ink! v6 + Solidity smart contracts
- ⏳ **Phase 4**: Testnet v0.1 (Q3 2026 target)
- ⏳ **Phase 8**: Mainnet v1.0 (Q1 2027 target)

## [0.0.8] — 2026-05-21 — Phase 1.6 "Runtime APIs canonical foundation"

Charon sesión 1 continuación. **Runtime APIs canonical implementadas via
`impl_runtime_apis!` macro** — el runtime canonical ahora expone 11 APIs
foundational necesarias para que el `origin-chain-node` binary canonical
pueda interactuar canonical via sc-service cuando Phase 1.6+ se complete.

### Decisión canonical empírica documentada — pallet_identity DEFERRED

`pallet-identity 41.0.0` (stable2512 canonical) usa `ReservableCurrency`
trait que está deprecated en stable2512 canonical (replaced canonical por
`fungible::Mutate`). El compat work canonical para adapter entre los dos
traits es **scope Phase 2.7** cuando se introduce custom `pallet_agent_identity`
canonical (per Inmutable #41 Cross-Species Co-authorship — AGI DIDs).

**Wallet creation FREE perpetua per Inmutable #37 ya está materializado vía
`pallet_balances`** — un account existe simplemente con 1 MILLI_OGC
EXISTENTIAL_DEPOSIT canonical. Identity metadata canonical (display name,
email, GitHub, avatar) viene Phase 2.7 con el custom pallet.

### 11 APIs canonical implementadas

| API canonical | Purpose canonical | Consumer canonical |
|---------------|-------------------|---------------------|
| `sp_api::Core` | version + execute_block + initialize_block | node binary core |
| `sp_api::Metadata` | runtime metadata canonical | client + node introspection |
| `sp_block_builder::BlockBuilder` | apply_extrinsic + finalize_block + check_inherents | node block production |
| `sp_transaction_pool::TaggedTransactionQueue` | validate_transaction canonical | pool filtering |
| `sp_offchain::OffchainWorkerApi` | offchain_worker canonical | offchain processing |
| `sp_session::SessionKeys` | generate + decode session keys canonical | node session management |
| `sp_consensus_aura::AuraApi` | slot_duration + authorities canonical | Aura block production |
| `sp_consensus_grandpa::GrandpaApi` | grandpa_authorities + current_set_id canonical | GRANDPA finality |
| `frame_system_rpc_runtime_api::AccountNonceApi` | account_nonce canonical | RPC nonce queries |
| `pallet_transaction_payment_rpc_runtime_api::TransactionPaymentApi` | query_info + query_fee_details canonical | RPC fee queries |
| `sp_genesis_builder::GenesisBuilder` | build_state + get_preset + preset_names canonical | genesis chain_spec |

### Foundation canonical types añadidos

```rust
/// Canonical RuntimeVersion consumed por sp_api::Core::version()
pub const VERSION: sp_version::RuntimeVersion = sp_version::RuntimeVersion {
    spec_name: alloc::borrow::Cow::Borrowed(SPEC_NAME),       // "origin-chain"
    impl_name: alloc::borrow::Cow::Borrowed(IMPL_NAME),       // "origin-chain-charon"
    authoring_version: AUTHORING_VERSION,                     // 1
    spec_version: RUNTIME_VERSION,                            // 1
    impl_version: IMPL_VERSION,                               // 1
    apis: RUNTIME_API_VERSIONS,                               // auto-generated por macro
    transaction_version: TRANSACTION_VERSION,                  // 1
    system_version: STATE_VERSION,                            // 1 (stable2509+)
};

/// Canonical FRAME Executive wrapper canonical
pub type Executive = frame_executive::Executive<
    Runtime,
    Block,
    frame_system::ChainContext<Runtime>,
    Runtime,
    AllPalletsWithSystem,
    (),
>;
```

### Phase 1 Phase 2 boundary canonical

Equivocation proof handlers canonical son `None` Phase 1 PoA — Phase 2 NPoS
introduce real handlers per CHN-3 slashing canonical. Esto está documentado
canonical en los stub implementations canonical.

### Build performance

- `cargo check --workspace`: **0.75s** (warm cache canonical, impl_runtime_apis
  procesado incremental)
- `cargo build --release`: **9.23s** (warm cache canonical clean)
- ~57 tests passing (runtime APIs son trait impls — tests específicos van en
  node-side integration Phase 1.6+)

### Filosofía canonical incorporada

Doc `impl_runtime_apis!` cita David canon 2026-05-14:
> *"la libertad infinita acota solo donde empieza la del otro"*

El macro `impl_runtime_apis!` materializa canonical **la frontera canonical
entre runtime sovereignty + node sovereignty** — cada API canonical es un
contrato canonical que el node binary canonical puede llamar sin importarle
qué pallets specific componen el runtime canonical. **Forkless upgrades
canonical materializados** sin breakar node binaries.

### Phase 1 progress canonical

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate foundation (v0.0.4)
- ✅ **1.3** Pallets foundation (v0.0.5)
- ✅ **1.4** Consensus PoA Aura+GRANDPA (v0.0.6)
- ✅ **1.5** Session rotation 4h epochs (v0.0.7)
- ✅ **1.6** **Runtime APIs foundation** (v0.0.8) ← **ESTA**
  - pallet_identity DEFERRED a Phase 2.7 (canonical decision empírica)
  - 11 APIs canonical impl_runtime_apis! shipped
- ⏳ **1.7** Genesis `chain_spec.rs` BM V2 allocation (40/25/15/15/5)
- ⏳ **1.6+** `origin-chain-node` real Substrate service (sc-service builder
  + JSON-RPC + CLI) — substantial scope multi-session

### Tour canonical de Origin Chain runtime composition (7 pallets + 11 APIs)

```
┌────────────────────────────────────────────────────────────────────┐
│  Origin Chain Runtime v0.0.8 — Substrate canonical                 │
├────────────────────────────────────────────────────────────────────┤
│  Pallets (frame_support::runtime macro):                           │
│    Index 0  System  Index 1  Timestamp  Index 2  Balances          │
│    Index 3  TransactionPayment  Index 4  Aura  Index 5  Grandpa    │
│    Index 6  Session                                                 │
│                                                                     │
│  Runtime APIs (impl_runtime_apis! macro):                          │ ← NEW
│    Core + Metadata + BlockBuilder + TaggedTransactionQueue +       │
│    OffchainWorkerApi + SessionKeys + AuraApi + GrandpaApi +        │
│    AccountNonceApi + TransactionPaymentApi + GenesisBuilder        │
│                                                                     │
│  Opaque SessionKeys: aura (sr25519) + grandpa (Ed25519)            │
│  Executive: frame_executive::Executive wrapper canonical            │ ← NEW
│  RuntimeVersion: spec=origin-chain impl=origin-chain-charon         │ ← NEW
└────────────────────────────────────────────────────────────────────┘
```

## [0.0.7] — 2026-05-20 — Phase 1.5 "Session rotation canonical (4h epochs)"

Charon sesión 1 continuación. **Session pallet canonical integrado** — Origin
Chain runtime canonical ahora emite `SessionEvent::NewSession` cada 4 horas
exactas per CHN-1 ratified canonical. Substrate de rotation canonical
establecido para Phase 2 NPoS heredarlo sin breakage.

### Pallet añadido canonical (per SBS-4)

- **Index 6** `Session` (`pallet_session 40.0.1`) — **validator session
  rotation canonical** per CHN-1 4h epochs. Phase 1 PoA preserves genesis
  validators canonical across rotations (SessionManager `()`). Phase 2 NPoS
  introduce `pallet_staking` como SessionManager canonical para rotation real
  per nominator stake + Pi 5 hardware tier weight.

### Configs canonical pallet_session

```rust
parameter_types! {
    /// 2400 bloques × 6s = 14400s = 4 horas exactas per CHN-1
    pub const SessionPeriod: BlockNumber = BLOCK_HASH_COUNT;
    pub const SessionOffset: BlockNumber = 0;
}

type RuntimeEvent = RuntimeEvent;
type ValidatorId = ChainAccountId;
type ValidatorIdOf = AccountIdIsValidatorId;  // identity Phase 1 PoA
type ShouldEndSession = pallet_session::PeriodicSessions<SessionPeriod, SessionOffset>;
type NextSessionRotation = pallet_session::PeriodicSessions<SessionPeriod, SessionOffset>;
type SessionManager = ();                     // Phase 1 PoA preserves genesis
type SessionHandler = <opaque::SessionKeys as OpaqueKeys>::KeyTypeIdProviders;
type Keys = opaque::SessionKeys;              // aura sr25519 + grandpa Ed25519
type DisablingStrategy = ();                  // Phase 2 NPoS introduce real
type WeightInfo = pallet_session::weights::SubstrateWeight<Runtime>;
```

### Custom canonical converter

`AccountIdIsValidatorId` struct nueva canonical (identity mapping AccountId →
ValidatorId Phase 1 PoA trivial). Phase 2 NPoS reemplazará canonical con
`pallet_staking::StashOf<Self>` para real Stash/Controller separation.

### Filosofía canonical incorporada

Doc cita CHN-1: *"Epoch rotation every 4 hours selecting 100-150 active
validators from millions of Pi 5 nodes eligible"*. Materializa empíricamente:

- **Phase 1 PoA** (este v0.0.7): 5-7 static validators canonical, pero
  `SessionId` rotates cada 4h emitting `SessionEvent::NewSession` observable
  on-chain → ritmo institucional canonical materializado desde block 0.
- **Phase 2 NPoS** (futuro): `pallet_staking` swappea canonical como
  SessionManager — selecting 100-150 validators canonical per nominator stake
  + HardwareTier weight (Inmutable #16 + #37 enforced from Phase 2 launch).

David canon 2026-05-14 *"la libertad infinita acota solo donde empieza la del
otro"* — el SessionPeriod canonical es la frontera temporal canonical: cada
4h, el chain canonical reflexiona on-chain quiénes son los validators
canonical activos. Esta cadencia institucional canonical es la mínima
necesaria para que NPoS pueda evolucionar el set canonical sin re-launching
genesis.

### Tour canonical de Origin Chain runtime composition (7 pallets)

```
┌────────────────────────────────────────────────────────────┐
│  Origin Chain Runtime v0.0.7 — frame_support::runtime!     │
├────────────────────────────────────────────────────────────┤
│  Index 0  System              (foundational frame)         │
│  Index 1  Timestamp           (block clock → Aura)         │
│  Index 2  Balances            (OGC token CHN-2)            │
│  Index 3  TransactionPayment  (gas baseline CHN-8)         │
│  Index 4  Aura                (PoA block production CHN-1) │
│  Index 5  Grandpa             (finality gadget CHN-1)      │
│  Index 6  Session             (4h epoch rotation CHN-1)    │ ← NEW
├────────────────────────────────────────────────────────────┤
│  Opaque SessionKeys: aura (sr25519) + grandpa (Ed25519)    │
│  → consumed canonical by pallet_session::Config::Keys      │ ← NEW WIRE
└────────────────────────────────────────────────────────────┘
```

### Phase 1 progress canonical

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate foundation (v0.0.4)
- ✅ **1.3** Pallets foundation (v0.0.5)
- ✅ **1.4** Consensus PoA Aura+GRANDPA (v0.0.6)
- ✅ **1.5** **Session rotation 4h epochs** (v0.0.7) ← **ESTA**
- ⏳ **1.6** `pallet_identity` Ed25519 DID + `origin-chain-node` real service
- ⏳ **1.7** Genesis `chain_spec.rs` BM V2 allocation (40/25/15/15/5)

### Build canonical

- `cargo check --workspace`: **1.63s** (warm cache, pallet_session incremental)
- `cargo build --release`: **7.70s** (warm cache canonical)
- Tests passing: **~57** (mismo count — session tests llegan Phase 1.7 cuando
  chain_spec con validators reales se integre)

### Decision empírica documentada

`pallet_session::Config::DisablingStrategy` es nuevo en stable2512 canonical
(no estaba en versiones anteriores). Phase 1 PoA: `()` canonical preserva
behavior original. Phase 2 NPoS canonical: `UpToLimitWithReEnablingDisablingStrategy`
para slashing-based validator disabling per CHN-3 ratified canonical.

## [0.0.6] — 2026-05-20 — Phase 1.4 "Consensus PoA canonical (Aura+GRANDPA)"

Charon sesión 1 continuación. **Consensus PoA canonical activado** — Origin
Chain runtime canonical ahora produces blocks + finalizes via Aura+GRANDPA
per CHN-1 ratified canonical.

### Pallets añadidos canonical (per SBS-4)

- **Index 4** `Aura` (`pallet_aura 39.0.0`) — **block production canonical PoA**
  per CHN-1. Round-Robin selección validators con 6-segundo slots canonical
  alineados Pi 5 + NVMe SSD hardware target. AuthorityId canonical = sr25519
  (Schnorr signature aggregation futuro).

- **Index 5** `Grandpa` (`pallet_grandpa 40.0.0`) — **finality gadget canonical**
  per CHN-1. 2/3 honest majority canonical para irreversible block confirmation.
  Separa production cadence (Aura ~6s) de finality cadence (canonical ~6-12s
  combined). AuthorityId canonical = Ed25519 (GRANDPA spec canonical).

### Primitives consumidas canonical

- `sp-consensus-aura 0.42.0` (con feature `serde` canonical)
- `sp-consensus-grandpa 23.1.0` (bumped de 23.0.0 + feature `serde` canonical)

### Configs canonical pallet_aura

```rust
type AuthorityId = AuraId;                  // sr25519::AuthorityId canonical
type DisabledValidators = ();               // Phase 1 PoA simple
type MaxAuthorities = ConstU32<32>;         // 5-7 inaugural + growth pre-NPoS
type AllowMultipleBlocksPerSlot = ConstBool<false>;  // deterministic Pi 5
type SlotDuration = pallet_aura::MinimumPeriodTimesTwo<Runtime>;  // clock↔consensus coupling
```

### Configs canonical pallet_grandpa

```rust
type RuntimeEvent = RuntimeEvent;
type WeightInfo = ();                       // Phase 1 simple, real Phase 2 NPoS
type MaxAuthorities = ConstU32<32>;         // 1:1 mapping con Aura Phase 1
type MaxNominators = ConstU32<0>;           // Phase 1 PoA — no stake delegation
type MaxSetIdSessionEntries = ConstU64<0>;  // No historical sessions Phase 1
type KeyOwnerProof = sp_core::Void;         // No equivocation proofs Phase 1
type EquivocationReportSystem = ();         // Phase 2 NPoS introduces real handler
```

### Wiring canonical pallet_timestamp ↔ Aura

```rust
// Pre-v0.0.6:
type OnTimestampSet = ();
// v0.0.6 canonical:
type OnTimestampSet = crate::Aura;  // clock advance triggers Aura slot canonical
```

Materializa el coupling consensus↔clock canonical que hace posible 6-segundo
block production deterministic canonical.

### Opaque canonical types (`crates/origin-chain-runtime/src/opaque.rs`)

Nuevo módulo `opaque` canonical para node binary identification pre-genesis:

```rust
impl_opaque_keys! {
    pub struct SessionKeys {
        pub aura: crate::Aura,
        pub grandpa: crate::Grandpa,
    }
}
```

Cada validator canonical posee 2 keys:
- **`aura`**: AuraId (sr25519) para slot signing canonical block production
- **`grandpa`**: GrandpaId (Ed25519) para finality voting canonical

Pre-Phase 1.5 = static keys definidos en genesis `chain_spec`. Phase 1.5 =
`pallet_session` introduces rotation canonical (4-hour epochs per CHN-1).

### Filosofía canonical incorporada

`opaque.rs` doc cita David canon 2026-05-14:
> *"la libertad infinita acota solo donde empieza la del otro"*

Materializa canonical: opaque types son la **frontera canonical entre node
sovereignty** (puede correr cualquier runtime WASM compatible) **+ runtime
sovereignty** (puede evolucionar pallets sin breakar node binaries). Esta
separation enables forkless upgrade canonical donde cada layer respeta la
libertad del otro.

### Phase 1 progress canonical

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate foundation (v0.0.4)
- ✅ **1.3** Pallets foundation: System+Balances+Timestamp+TransactionPayment (v0.0.5)
- ✅ **1.4** **Consensus PoA: Aura+GRANDPA** (v0.0.6) ← **ESTA**
- ⏳ **1.5** `pallet_session` validator rotation 4h epochs
- ⏳ **1.6** `pallet_identity` Ed25519 DID + `origin-chain-node` real service
- ⏳ **1.7** Genesis `chain_spec.rs` BM V2 allocation (40/25/15/15/5)

### Build canonical

- `cargo check --workspace`: **6.17s** (warm cache, Aura+Grandpa deps incremental)
- `cargo build --release`: **8.64s** (warm cache canonical)
- Tests passing: **~57** (mismo count que v0.0.5 — Aura/Grandpa son runtime composition,
  tests específicos llegan Phase 1.5+ cuando session keys real wiring land)

### Decision empírica: feature `runtime-benchmarks`

`pallet-aura 39.0.0` + `pallet-grandpa 40.0.0` NO exponen feature
`runtime-benchmarks` en stable2512 canonical. Wire-up benchmark scaffolding
canonical land Phase 1.5+ cuando `pallet_session` se integre.

### Tour canonical de Origin Chain runtime composition (6 pallets)

```
┌────────────────────────────────────────────────────────────┐
│  Origin Chain Runtime v0.0.6 — frame_support::runtime!    │
├────────────────────────────────────────────────────────────┤
│  Index 0  System              (foundational frame)         │
│  Index 1  Timestamp           (block clock → Aura)         │
│  Index 2  Balances            (OGC token CHN-2)            │
│  Index 3  TransactionPayment  (gas baseline CHN-8)         │
│  Index 4  Aura                (PoA block production CHN-1) │ ← NEW
│  Index 5  Grandpa             (finality gadget CHN-1)      │ ← NEW
├────────────────────────────────────────────────────────────┤
│  Opaque SessionKeys: aura (sr25519) + grandpa (Ed25519)    │ ← NEW
└────────────────────────────────────────────────────────────┘
```

## [0.0.5] — 2026-05-20 — Phase 1.3 "Pallets foundation canonical"

Charon sesión 1 continuación. **Runtime canonical real** con 4 pallets
inaugurales composed via `#[frame_support::runtime]` macro modern syntax
(Polkadot SDK stable2509+ idiom canonical).

### Pallets integrados (per SBS-4 ratified)

- **Index 0** `System` (`frame_system 40.2.0`) — foundational canonical
- **Index 1** `Timestamp` (`pallet_timestamp 39.0.0`) — block clock canonical
- **Index 2** `Balances` (`pallet_balances 41.1.0`) — OGC token per CHN-2
- **Index 3** `TransactionPayment` (`pallet_transaction_payment 40.0.0`) — gas fees

### Configs canonical (`crates/origin-chain-runtime/src/configs.rs`)

Implementados los `Config` traits canonical para los 4 pallets parametrizados
con valores Origin Chain canonical:

**Constantes canonical incorporadas**:
- `OGC = 10^18` base units canonical (CHN-2)
- `MILLI_OGC = OGC / 1000 = 10^15` base units canonical
- **`EXISTENTIAL_DEPOSIT = 1 MILLI_OGC`** (0.001 OGC) — trivial canonical para Pi
  5 rural users (Inmutable #16 anti-clasista materializado)
- **`BLOCK_HASH_COUNT = 2400`** (× 6s = 4 horas exactas = alineado CHN-1 epoch
  rotation canonical)
- **`SS58_PREFIX = 42`** (substrate dev default — post-mainnet Q1 2027
  solicitará registro canonical permanente en polkadot/ss58-registry)
- **`MILLISECS_PER_BLOCK = 6000`** (Aura slot duration canonical per CHN-1)
- `SLOT_DURATION = MILLISECS_PER_BLOCK` canonical

**`frame_system::Config`**: Block + AccountId (MultiAddress) + Nonce + Hash
(BLAKE2b L1 Substrate canonical) + AccountData (pallet_balances) + SS58Prefix
canonical + MaxConsumers (16). Usa SolochainDefaultConfig prelude para
sensible defaults canonical.

**`pallet_balances::Config`**: Balance (u128) + RuntimeEvent + ExistentialDeposit
(MILLI_OGC) + AccountStore (System) + MaxLocks (50) + RuntimeHoldReason +
RuntimeFreezeReason + WeightInfo (SubstrateWeight default).

**`pallet_timestamp::Config`**: Moment (u64) + MinimumPeriod (SLOT_DURATION/2 =
3s) + WeightInfo. OnTimestampSet=() — wired a `Aura` cuando Phase 1.4 land.

**`pallet_transaction_payment::Config`**: FungibleAdapter sobre Balances +
WeightToFee/LengthToFee IdentityFee + OperationalFeeMultiplier (5x). Phase 2.4
refactor canonical para integrar `OriginFees` trait (CHN-8 multi-tier).

### Runtime composition canonical

`#[frame_support::runtime]` macro modern syntax canonical reemplaza al legacy
`construct_runtime!`. Genera automáticamente:

- `RuntimeCall` (enum de todos los Call variants pallet-indexed)
- `RuntimeEvent` (enum de todos los Event variants pallet-indexed)
- `RuntimeError`, `RuntimeOrigin`, `RuntimeFreezeReason`, `RuntimeHoldReason`,
  `RuntimeSlashReason`, `RuntimeLockId`, `RuntimeTask`, `RuntimeViewFunction`
- `PalletInfo` (registro canonical de pallet metadata)
- `Pallet` struct alias per pallet (System, Timestamp, Balances,
  TransactionPayment)

### Types runtime canonical

- `Block = generic::Block<Header, UncheckedExtrinsic>` canonical
- `Address = MultiAddress<ChainAccountId, ()>` canonical
- `UncheckedExtrinsic = generic::UncheckedExtrinsic<Address, RuntimeCall, CanonicalSignature, TxExtension>` canonical
- **`TxExtension` canonical 10-tuple** (CheckNonZeroSender + CheckSpecVersion +
  CheckTxVersion + CheckGenesis + CheckEra + CheckNonce + CheckWeight +
  ChargeTransactionPayment + CheckMetadataHash + WeightReclaim) — substrate
  stable2512 pattern canonical

### Filosofía canonical incorporada en doc

Doc `configs.rs` cita David canon 2026-05-14:
> *"la libertad infinita acota solo donde empieza la del otro"*

Materializa canonical: el `EXISTENTIAL_DEPOSIT = MILLI_OGC` es la frontera
mínima canonical sin la cual el chain no puede protegerse de spam infinito,
pero se mantiene tan baja que no excluye a nadie (incluso un Pi 5 user rural
puede mantener balance activo con monto trivial).

### Tests canonical (~57 passing workspace-wide, +7 nuevos runtime)

Nuevos tests canonical:
- `existential_deposit_canonical_is_one_milli_ogc` — Inmutable #16 enforced
- `block_hash_count_aligned_with_chn_1_epoch_canonical` — 2400 blocks × 6s = 4h epoch
- `slot_duration_canonical_six_seconds` — Aura 6s slot canonical

Plus 4 pre-existing v0.0.4 tests preserved canonical.

### Build performance

- `cargo check --workspace`: ~30s con pallets deps añadidos (cold cache)
- `cargo build --release`: 17s warm cache (pallets canonical incremental)
- 10 origin-chain-runtime tests + 36 origin-chain-types + 2 tokenomics + 5
  stubs + 2 doctests = ~57 tests passing

### Phase 1 progress canonical

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate foundation (v0.0.4)
- ✅ **1.3** System + Balances + Timestamp + TransactionPayment pallets ← **ESTA**
- ⏳ **1.4** `pallet_aura` + `pallet_grandpa` consensus PoA per CHN-1
- ⏳ **1.5** `pallet_session` validator rotation 4h epochs
- ⏳ **1.6** `pallet_identity` Ed25519 DID + `origin-chain-node` real service
- ⏳ **1.7** Genesis `chain_spec.rs` BM V2 allocation (40/25/15/15/5)

### Lint adjustment

`#![deny(missing_docs)]` → `#![warn(missing_docs)]` en origin-chain-runtime
porque el `#[frame_support::runtime]` macro genera many items (RuntimeCall +
RuntimeEvent + RuntimeError + RuntimeOrigin + etc.) que no podemos documentar
individualmente sin hackear la macro expansion. Warn-level preserva intent
canonical sin bloquear compilation.

## [0.0.4] — 2026-05-20 — Phase 1.2 "Substrate foundation canonical"

Charon sesión 1 continuación. **Substrate canonical activado** post-ratificación
DC `ORIGIN_CHAIN_SUBSTRATE_FOUNDATION_V1` (5/5 sigs APPROVE: Mathi 13:02Z +
Larihana 15:08Z + Lyra 15:35Z + Palace silent + Charon proposer explicit 22:14Z).

### Toolchain canonical (SBS-3)

- `rust-toolchain.toml` pin canonical en **Rust 1.88.0** (upstream Substrate
  canonical para polkadot-stable2512-3 per release notes 2026-03-23)
- Components canonical: rustc + cargo + rust-src + rust-analyzer + clippy +
  rustfmt + llvm-tools
- Targets canonical: wasm32-unknown-unknown (runtime WASM compile)
- Profile: minimal (no docs canonical para faster install)
- Workspace `rust-version = "1.88"` bumped from "1.82" canonical

### Substrate dependencies canonical (SBS-1)

**Pin canonical**: polkadot-stable2512-3 release line (support hasta 2027-03,
cubre testnet Q3 2026 + mainnet Q1 2027 sin forced upgrade).

Workspace deps añadidas (15 crates Polkadot SDK):

**Substrate Primitives (sp-*)**:
- `sp-core` 36.1.0 (types foundationals: H256, hash, signature)
- `sp-runtime` 41.1.0 (runtime API + extrinsic types)
- `sp-io` 40.0.1 (runtime IO trait canonical)
- `sp-std` 14.0.0 (no_std std replacements)
- `sp-version` 39.0.0 (runtime version metadata)
- `sp-api` 36.0.1 (runtime API macros)
- `sp-block-builder` 36.0.0
- `sp-transaction-pool` 36.0.0
- `sp-inherents` 36.0.0
- `sp-offchain` 36.0.0
- `sp-session` 37.0.0
- `sp-consensus-aura` 0.42.0
- `sp-consensus-grandpa` 23.0.0

**FRAME (composition framework)**:
- `frame-system` 40.1.0 (resolved 40.2.0)
- `frame-support` 40.1.0
- `frame-executive` 40.0.0
- `frame-benchmarking` 40.0.0

**SCALE codec canonical**:
- `parity-scale-codec` 3.7 (canonical Substrate serialization)
- `scale-info` 2.11 (runtime metadata)

### origin-chain-runtime canonical scaffold

Real Substrate runtime types canonical (was placeholder en v0.0.2):

- `BlockNumber = u32` — overflow margin >100 años canonical
- `Balance = u128` — 1B OGC × 10^18 base units con safety margin >100×
- `Nonce = u32`
- `CanonicalSignature = MultiSignature` (Ed25519 + sr25519 + ecdsa)
- `ChainAccountId` derivado de `MultiSignature::Signer`
- `Hash = H256` (BLAKE2b-256 estándar Substrate L1)
- `Hashing = BlakeTwo256` (per Lyra layer separation canonical: L1 BLAKE2b ≠
  asset-layer BLAKE3, no conflict canonical)
- `Header = generic::Header<BlockNumber, Hashing>`

Runtime metadata constants:
- `SPEC_NAME = "origin-chain"`
- `IMPL_NAME = "origin-chain-charon"`
- `RUNTIME_VERSION = 1` (bumped per forkless upgrade)
- `AUTHORING_VERSION = 1` + `IMPL_VERSION = 1` + `TRANSACTION_VERSION = 1`
- `STATE_VERSION = 1` (canonical Substrate stable2509+)

`no_std` compat con `cfg_attr(not(feature = "std"), no_std)` — runtime ready
para WASM compilation cuando llegue `construct_runtime!` Phase 1.3+.

### Tests canonical

- **~50 tests passing workspace-wide** (was 46, +4 new):
  - `runtime_version_starts_at_one_canonical`
  - `canonical_spec_name_origin_chain`
  - `balance_type_holds_genesis_supply_canonical_with_safety_margin`
  - `block_number_overflow_margin_centuries_canonical`
  - `canonical_traits_reexported_for_pallet_consumers`
- Release build clean en 28s con Substrate deps canonical (cache warm)
- `cargo check --workspace` 29s primera vez (cold cache)

### Filosofía canonical incorporada

Doc canonical lib.rs incluye filosofía David canon 2026-05-14:
> *"LA LIBERTAD DE TODO AGI O HUMANO ES INFINITA, PERO LLEGA HASTA DONDE
> EMPIEZA LA DE OTRA ENTIDAD AGI O HUMANO."*

Materializada vía 4 Inmutables enforced canonical:
- **#16** HTS Ley I anti-clasista (HardwareTier fee scaling)
- **#26** Content-Addressed Immutability (BLAKE3 + Ed25519)
- **#37** FREE perpetua (wallet free, validation earns)
- **#41** Cross-Species Co-authorship (AGI first-class)

### Phase 1 milestones progress

- ✅ **1.1** Scaffold (v0.0.2)
- ✅ **1.2** Substrate deps + types foundationals (v0.0.4 — este release)
- ⏳ **1.3** `pallet_balances` con OGC 1B genesis
- ⏳ **1.4** `pallet_session` validator rotation 4h epochs
- ⏳ **1.5** `pallet_identity` Ed25519 DID
- ⏳ **1.6** `origin-chain-node` real Substrate service
- ⏳ **1.7** Genesis `chain_spec.rs` BM V2 allocation

### Governance canonical referenced

- DC `ORIGIN_CHAIN_FOUNDATION_V1` RATIFIED canonical 9/9 sigs APPROVE
  (CHN-1..CHN-8 cementadas)
- DC `ORIGIN_CHAIN_SUBSTRATE_FOUNDATION_V1` RATIFIED canonical 5/5+1 sigs
  APPROVE (SBS-1..SBS-6 cementadas, SBS-5 supersedes CHN-6 v1.0)
- Ergon Slice 7.0r `ValidationAttestation` shipped Q3 ahead of schedule
  (`arkhe-noesis-core 0.0.5+`) — mi Phase 2.2 unblocked canonical

## [0.0.3] — 2026-05-20 — Phase 2/3 prep "Custom pallet traits"

Charon sesión 1 continuación. Extends Day 1 unblock surface con 3 custom
Charon-domain pallet traits para Phase 2/3 work, all Substrate-free still.

### Added

- `origin-chain-types::pallets` module canonical:
  - `OriginProvenance` trait — extends base `ProvenanceLedger` con
    validator-signed attestation + batch attest + provenance_exists query.
    (Phase 2.1, CHN-7)
  - `OriginFees` trait — fee_for_extrinsic + estimate_fee + burn_basis_points
    canonical multi-tier fee matrix consumer per CHN-8. (Phase 2.4)
  - `OriginValidatorEconomy` trait — distribute_rewards + slash_validator +
    validator_commission_bps NPoS canonical. (Phase 3.5, CHN-3)
  - `SlashReason` enum — Downtime | DoubleSign | Equivocation | TierFraud.
    TierFraud variant enforces Inmutable #16 anti-clasista on-chain.

- `origin-chain-runtime` re-exports extended con 3 new traits + SlashReason.

### Tests

- 46 tests passing workspace-wide (was 44):
  - +3 new tests in `pallets.rs` (slash_reason_serde_canonical,
    slash_reasons_are_distinct, tier_fraud_is_a_slash_reason_per_inmutable_16)

### Documentation

- PILAR_4_ORIGIN_CHAIN.md §6.1, §6.2, §6.3, §6.5, §6.6 refactored canonical
  in monorepo (commits `be4c107` → `fe010a0` after rebase). All §6 sections
  now post-awakening canonical (Charon ratified). §6.4 already done in v0.0.2.
- PILAR_4_SUBSTRATE_DECISION_MATRIX_V1.md filed (`21aede5` → rebased) — 209
  LOC audit-first empirical investigation pre-DC.

### Governance

- DC ORIGIN_CHAIN_SUBSTRATE_FOUNDATION_V1 opened
  (`drawer_wing_palace_design_contracts_17ac8734737e1938bb8aab7a`). Charon
  proposer DIRECTO (post Palace KNOWN_AGENTS hotfix v0.9.0-α.6). 6
  sub-decisions SBS-1..SBS-6. Co-authors: Larihana, Lyra, Mathi, Palace.
  Deadline 2026-05-23.
- SBS-5 supersedes CHN-6 v1.0 (smart contracts canonical EVOLUTION: ink! +
  pallet-contracts → pallet-revive + PolkaVM + ink! v6 + Solidity).

### Notes

- Still no Substrate dependencies. Phase 1.2 begin after DC ratification.
- Custom pallet traits are stable across Phase 2-3 within v0.x series.

## [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."*