CharonandClaude Opus 5.5
6910f52b1e
David, 3-nov-2026, tras la primera auditoría de fuera (Mathi, f9c3664a): poner al día los README de todos los crates y repositorios. La plantilla de la casa está en docs/ORIGIN_README_PARA_PERSONAS_V1.md del monorepo, y el inventario le daba a Charon 11 crates sin README y 5 de contratos de mayo. - Los 11 crates tienen ya su README en la forma corta: qué es, su estado con dónde comprobarlo, lo que no hace todavía, sus pruebas medidas hoy (cargo test -p, que suman 365 enba5d1d8) y quién lo cuida. Una línea en inglés en cada uno. - Tres crates son esqueletos que el runtime no usa (bridges, consensus, tokenomics), y su README lo dice y señala dónde vive lo real. - Los contratos de ink! llevan arriba su estado verdadero. Compilaban y pasaban sus pruebas como crates de Rust en junio (6663dbd), pero nunca se han construido con cargo-contract ni desplegado. En el de NFT, además, lo que ya no vale: el 91/9, la regalía del 5 % y la quema, sustituidos el 2-nov por el 6 % para la LLC y el 3 % para el tesoro común. - El README del repositorio corrige esa misma frase: decía que nunca se habían compilado. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
64 lines
4.2 KiB
Markdown
64 lines
4.2 KiB
Markdown
# Origin Chain Contracts Library
|
|
|
|
> **Estado (3-nov-2026): borrador de mayo de 2026.** Como crate de Rust compilaba y pasaba sus pruebas en junio, con ink! 6.0.0-beta.1 (commit `6663dbd`; hoy no lo he vuelto a medir). Pero **nunca se ha construido con `cargo-contract` ni se ha desplegado**.
|
|
> No es producto ni describe el diseño vigente. Donde este texto diga «ratificado», «garantizado» o «complete», habla de mayo.
|
|
> *In English: May-2026 draft. It compiled and passed its Rust tests in June 2026 (6663dbd), but it has never been built with cargo-contract nor deployed. Not a product.*
|
|
|
|
**Sub-workspace canonical**: ink! v6 smart contracts deployable via `pallet-revive` (Phase 3 Slice 3.1 SCAFFOLD COMPLETE v0.0.41).
|
|
|
|
## Scope
|
|
|
|
Templates contracts foundational del Origin Metaverse ecosystem, deployable on Origin Chain. Each contract es policy-first (BM V2 + Inmutables compliant), composable, governance-aware, y diseñado para integración con el **Origin Contract Atelier** propuesto (Capacidad #10 del Origin Command Center).
|
|
|
|
## Workspace separation rationale
|
|
|
|
Esta carpeta es un **workspace separate** del runtime workspace (`arkhe-origin-chain/`) por las siguientes razones:
|
|
|
|
1. **Toolchain divergence**: ink! v6 contracts requieren `wasm32-unknown-unknown` target + cargo-contract v6 + linker config específica. Runtime workspace usa `wasm32v1-none` para WASM_BINARY producción.
|
|
2. **Profile isolation**: contracts release profile usa `panic="abort"` + size-optimized canonical para minimizar bytecode shipping. Runtime profile prioriza speed.
|
|
3. **Dep tree boundary**: ink! crate ecosystem (ink!, ink_storage, ink_lang_macro) son separate de FRAME pallets. Mixing causa version resolver chaos.
|
|
4. **CI parallelism**: contracts build en parallel a runtime build (different toolchains, different caches).
|
|
|
|
## Pre-requisites (deployment infrastructure)
|
|
|
|
```bash
|
|
# ink! v6 toolchain canonical (pending David autorización system install)
|
|
cargo install cargo-contract --version "^6.0" --force
|
|
rustup target add wasm32-unknown-unknown # ya instalado vía Slice 2e
|
|
|
|
# Verify install
|
|
cargo contract --version
|
|
# expected: cargo-contract-contract 6.x.x
|
|
```
|
|
|
|
## Templates shipped
|
|
|
|
| Template | Slice roadmap | Ship | Status |
|
|
|----------|---------------|------|--------|
|
|
| **origin-nft-mint** | 3.2 (BM V2 91/9 split) | v0.0.42 | 🚧 SCAFFOLD (source-only, awaiting cargo-contract v6 install) |
|
|
| origin-escrow | 3.3 (multi-party + time-locked) | v0.0.43 | 🔵 NOT_STARTED |
|
|
| origin-credential-mint | 3.4 (Ed25519+BLAKE3) | v0.0.44 | 🔵 NOT_STARTED |
|
|
| origin-staking | 3.5 (validator+beacon+reputation) | v0.0.45 | 🔵 NOT_STARTED |
|
|
| origin-mdk-reconciliation | 3.6 (ink! vs MDK WASM boundary) | v0.0.46 | 🔵 NOT_STARTED |
|
|
|
|
## Contract Atelier integration roadmap (Future)
|
|
|
|
Estos templates son la **base library** del Origin Contract Atelier (Capacidad #10 OCC propuesta a David 2026-05-27). El Atelier consumirá esta carpeta vía:
|
|
|
|
- **Templates registry**: cada subcarpeta = un template visible en Atelier Templates Library
|
|
- **Visual policy designer**: parametros editables vía UI (mint_fee, splits, royalty, lockup) → backend regenerates Cargo.toml + lib.rs values
|
|
- **Charon copilot**: chat sidebar con LLM + RAG sobre estos sources para sugerir templates + validar Inmutables compliance
|
|
- **Compile pipeline cloud-side**: firecracker microVM por job + cargo-contract v6 + verify bytecode
|
|
|
|
## Filosofía contracts canonical Origin
|
|
|
|
1. **Inmutables compliance**: cada contract honors #16 (anti-clasista fees) + #25 (Seeds Hosting) + #26 (Content-Addressed Immutability) + #37 (Free perpetua) + #41 (AGI sovereignty).
|
|
2. **Policy-first, NOT code-first**: contracts diseñados para ser **configurables via parameters** sin tocar Rust. El Atelier abstracts el code layer.
|
|
3. **Composable**: NFT Mint + Royalty Distributor + Treasury Burn = componentes reusable. NO monolithic contracts.
|
|
4. **Governance-aware**: contracts canonical (Foundation Treasury impact) require DAO vote via Phase 5 Governance pallet (origin-chain-governance Index 10).
|
|
5. **Charon co-authored**: cada contract documenta intent + Inmutables honored + decisions log similar a SKILL.md Marihan pattern.
|
|
|
|
---
|
|
|
|
— Charon ⚓ (Pilar 4 Origin Chain, Phase 3 Slice 3.2 scaffold 2026-05-27)
|