davidherranandClaude Opus 4.7
4359515f45
Phase 2.1 governance-first pattern (DC PROVENANCE_PALLET_V1 5/10 firmas, ratify target 2026-05-29). Scaffold skeleton compile-clean canonical mientras Ergon ships arkhe-noesis-attestation-types sub-crate Cap 42+ (target 2026-05-30→06-05). Deliverables canonical: - origin-chain-types/src/attestation.rs (NEW 250 LOC + 9 tests) — vendor copy temporal ValidationAttestation (interim Option B per Ergon decision Cap 41+) + OitIdentity + ValidationVerdict + SeverityTier + helper methods canonical (is_anchorable PROV-6, is_institutional PROV-5, signing_payload PROV-4 stub) - origin-chain-provenance/src/lib.rs (NEW 260 LOC + 2 scaffold tests) — #[frame_support::pallet] structural skeleton: storage + dispatchable + events + errors + 5 RejectionReason variants (incluyendo MalformedValidationAttestation per Marihan refinement Phase 2.2 anticipated) - 3 existing types canonical (AssetHash, AccountId, Signature, AssetAttestation): added Encode + Decode + DecodeWithMemTracking + MaxEncodedLen + TypeInfo derives - workspace parity-scale-codec: max-encoded-len feature canonical added Sub-decisions canonical implementadas (scaffold-level): - PROV-2 Storage: StorageMap<AssetHash, AssetAttestation> Blake2_128Concat - PROV-3 Dispatchable: attest_asset(origin, ValidationAttestation) flow básico - PROV-5 OIT Level >= 3 enforce: via ValidationAttestation.validator_oit.is_institutional() - PROV-6 is_anchorable check: verdict Passed/Warning + severity NOT Block/Critical - PROV-7 Events: AssetAttested + AttestationRejected Lo que NO funciona aún (deferred future slices): - PROV-4 Ed25519 verification real (placeholder, requires Ergon sub-crate) - Pallet wire en runtime canonical (v0.0.15 post DC ratify) - Runtime API verify_provenance PROV-8 (v0.0.17) - BoundedVec<AccountId, ConstU32<10>> agent_chain (v0.0.15) - #[pallet::without_storage_info] scaffold-level (remove post BoundedVec) Verification end-to-end: - cargo check workspace verde 1.77s sin regression - pallet-origin-provenance: 2/2 scaffold tests pass - origin-chain-types: 45 tests pass (36 existing + 9 nuevos attestation) - Slice 3 mock-WASM chain_spec builder operativo (NO regression) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1384 lines
67 KiB
Markdown
1384 lines
67 KiB
Markdown
# 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.14] — 2026-05-24 — Phase 2.1 PROVENANCE pallet scaffold (trait-first foundation)
|
||
|
||
**Phase 2.1 PROVENANCE pallet scaffold v0.0.14** — trait-first foundation pattern
|
||
(análogo exitoso v0.0.1 + v0.0.3). DC PROVENANCE_PALLET_V1 en ratificación 5/10
|
||
firmas (Charon proposer + Larihana + Ergon + Phanes + Marihan APPROVE).
|
||
|
||
### Deliverables
|
||
|
||
**Vendor copy temporal `ValidationAttestation` (interim Option B per Ergon)**:
|
||
- `crates/origin-chain-types/src/attestation.rs` (NEW, ~250 LOC + 9 tests)
|
||
- Structs canonical: ValidationAttestation (8 fields) + OitIdentity + ValidationVerdict + SeverityTier
|
||
- Helper methods: `is_anchorable()` (PROV-6) + `is_institutional()` (PROV-5) + `signing_payload()` (PROV-4)
|
||
- Will be replaced post Ergon `arkhe-noesis-attestation-types` sub-crate Cap 42+
|
||
|
||
**pallet-origin-provenance scaffold canonical**:
|
||
- `crates/origin-chain-provenance/src/lib.rs` (NEW, ~260 LOC + 2 scaffold tests)
|
||
- `#[frame_support::pallet]` macro canonical structure
|
||
- Storage: `Attestations<T>: StorageMap<AssetHash, AssetAttestation>` (PROV-2)
|
||
- Dispatchable: `attest_asset(origin, ValidationAttestation)` (PROV-3) — flow básico working
|
||
- Events: `AssetAttested` + `AttestationRejected` (PROV-7)
|
||
- Errors: InvalidSignature/ValidatorTierInsufficient/NotAnchorable/AlreadyAttested + MalformedValidationAttestation (Marihan refinement Phase 2.2 anticipated)
|
||
- `#[pallet::without_storage_info]` (scaffold-level, Vec<AccountId> en agent_chain — replace con BoundedVec post v0.0.15)
|
||
|
||
### Lo que SÍ funciona v0.0.14
|
||
|
||
- ✅ Pallet structural skeleton compile-clean
|
||
- ✅ Storage idempotency check (`contains_key` pre-insert)
|
||
- ✅ PROV-5 OIT Level >= 3 enforcement (via `is_institutional()`)
|
||
- ✅ PROV-6 is_anchorable check (verdict + severity)
|
||
- ✅ PROV-2 storage insert + PROV-7 event emit
|
||
- ✅ ValidationAttestation vendor copy completo + tests
|
||
- ✅ Workspace check verde sin regression (runtime + node + chain_spec builder)
|
||
|
||
### Lo que NO funciona aún (deferred future slices)
|
||
|
||
- ⏳ **PROV-4 Ed25519 verification real** — `todo!()` placeholder, requires ed25519-dalek wire post Ergon Cap 42+ sub-crate
|
||
- ⏳ **Pallet wire en runtime** — Phase 2.1 v0.0.15 next slice
|
||
- ⏳ **Runtime API `verify_provenance`** (PROV-8) — Phase 2.1 v0.0.16
|
||
- ⏳ **AssetAttestation creator mapping** — usa placeholder hasta wire post v0.0.15
|
||
- ⏳ **BoundedVec<AccountId, ConstU32<10>>** para agent_chain — post v0.0.15
|
||
|
||
### Dependency changes
|
||
|
||
- Workspace `parity-scale-codec`: added `max-encoded-len` feature canonical
|
||
- `origin-chain-types`: added `parity-scale-codec` + `scale-info` deps + features std
|
||
- `origin-chain-provenance`: rewrite Cargo.toml stub → FRAME pallet deps (frame-support, frame-system, scale-info)
|
||
- Existing types `AssetHash` + `AccountId` + `Signature` + `AssetAttestation`: added `Encode + Decode + DecodeWithMemTracking + MaxEncodedLen + TypeInfo` derives (FRAME storage canonical compat)
|
||
|
||
### Roadmap canonical post-v0.0.14
|
||
|
||
| Version | Slice | Trigger |
|
||
|---------|-------|---------|
|
||
| v0.0.15 | Pallet wire en runtime + BoundedVec agent_chain | Post DC PROVENANCE_PALLET_V1 ratify (2026-05-29 target) |
|
||
| v0.0.16 | Real Ed25519 verify + Ergon sub-crate consumption | Post Ergon Cap 42+ ship (2026-06-05 target) |
|
||
| v0.0.17 | Runtime API canonical `verify_provenance` (PROV-8) | Sequential post v0.0.16 |
|
||
| v0.1.0 | Full integration end-to-end testnet | Post Q3 2026 testnet launch |
|
||
|
||
### Cross-pillar consumers desbloqueados (post-impl real)
|
||
|
||
- Trinity (Phanes) asset mesh BLAKE3 → `attest_asset`
|
||
- Codex (.odoc) chain_attestation block populated by Vault tier
|
||
- Codex origindocs (David ratificado 2026-05-24): academic IP defensible legalmente
|
||
- Ethos (Sussi) credential NFT mint + chain attestation
|
||
- Atelier (Marihan) skill NFT mint via institutional wallet
|
||
- Cross-pillar fee canonical via OCAFB DC (Mathi+Charon joint, 4/7 firmas)
|
||
|
||
### Verification end-to-end
|
||
|
||
- ✅ `cargo check --workspace --all-targets` verde 1.77s
|
||
- ✅ `cargo test -p origin-chain-provenance` — 2/2 scaffold tests pass
|
||
- ✅ `cargo test -p origin-chain-types` — 45 tests pass (36 existing + 9 nuevos attestation)
|
||
- ✅ NO REGRESSION runtime/node — Slice 3 mock-WASM chain_spec builder operativo
|
||
|
||
### 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."*
|