arkhe-origin-chain/contracts/origin-nft-mint/README.md

origin-nft-mint — NFT Mint Contract Template (Slice 3.2)

First foundational template del Origin Contract Atelier (Capacidad #10 OCC propuesta David 2026-05-27). Implementa el split BM V2 ratificado 2026-05-18 91% creator / 9% Treasury + transfer royalty 5% (configurable) + Treasury burn 20% (per BM V2 burn matrix Pillar 3).

Status

🚧 SCAFFOLD (source-only, v0.0.42) — lib.rs shipped + Cargo.toml ready. Real compilation deferred hasta cargo-contract v6 install autorizado (precedent Slice 2e brew LLVM authorization pattern). El source es:

• Compilable canonical una vez tooling instalado: cargo contract build --release
• Reference architectural para Contract Atelier visual designer Phase 3.x
• Documentation living del policy-first contract design pattern Origin

Inmutables compliance compile-detect

Inmutable	Enforcement canonical en este contract
#16 HTS anti-clasista	mint_fee_base modulated por HardwareTier vía OitFeeSchedule bridge Phase 3.x integration
#25 Seeds Hosting Non-Gatekept	NFT ownership NO gates base world access — purely decorative/economic layer
#26 Content-Addressed Immutability	asset_hash: AssetHash BLAKE3 hash compile-detect required (Error::InvalidAssetHash if zero)
#37 Free perpetua	Read methods (total_supply, token_owner, balance_of, etc.) sin payment — siempre gratis
#41 AGI Co-authorship	AccountId32 canonical para AGI accounts (Phase 2.7 AgentIdentity) sin distinction de Human accounts

Configuration parameters (Contract Atelier UI exposure)

Parameter	Type	Default BM V2	Range UI canonical
mint_fee_base	Balance (u128)	1 OGC (10^18 base)	0.01 - 1000 OGC sliders
creator_share_bps	u16	9_100 (91%)	locked invariant 91% canonical (BM V2 ratified)
treasury_share_bps	u16	900 (9%)	locked invariant 9% canonical (BM V2 ratified)
transfer_royalty_bps	u16	500 (5%)	0-1000 (0-10%) sliders
treasury_burn_bps	u16	2_000 (20%)	0-5000 (0-50%) sliders
max_supply	Option<u32>	None (unlimited)	None OR Some(1..=4_294_967_295) selector
lockup_blocks	u32 (blocks)	0 (no lockup)	0-1_576_800 (≈ 6 months Pi 5 6s blocks) slider
children_safety_strict	bool	false	toggle (Inmutable #35 strict mode)

Cross-pillar integration canonical

┌─────────────────────────────────────────────────────────────────┐
│  origin-nft-mint contract canonical deployed via pallet-revive  │
│  Index 11 Origin Chain runtime (Slice 3.1 SCAFFOLD COMPLETE)    │
└──────────────────┬──────────────────────────────────────────────┘
                   │
        ┌──────────┼──────────┬──────────┬──────────┐
        ▼          ▼          ▼          ▼          ▼
┌──────────┐┌──────────┐┌──────────┐┌──────────┐┌──────────┐
│ Pillar 2 ││ Pillar 4 ││ Pillar 6 ││ Pillar 7 ││ Atelier  │
│ OMC      ││ Origin   ││ Nexus    ││ Creator  ││ Marihan  │
│ Marihan  ││ Chain    ││ Services ││ Economy  ││ Skills   │
│          ││ Charon   ││ Mathi    ││ Larihana ││          │
│ 91/9     ││ pallet-  ││ Beacon   ││ Hosting  ││ Skills   │
│ split    ││ revive   ││ stake +  ││ NFT      ││ becomen  │
│ enforced ││ deploy   ││ ONS name ││ anchor   ││ NFTs     │
└──────────┘└──────────┘└──────────┘└──────────┘└──────────┘

Pillar 2 OMC Marketplace (Marihan) wire

NFT mint contracts compose el marketplace canonical Marihan. Cada skill canonical creada en Atelier Skills (Marihan) puede ser minted como NFT via este template. El 91/9 split BM V2 ratified compile-detect garantizado.

Pillar 4 Origin Chain (Charon) deploy

Deployment vía pallet-revive::instantiate Index 11 (Slice 3.1 SCAFFOLD COMPLETE shipped v0.0.41). Storage deposits per BM V2 economics (mint_fee_base default 1 OGC + storage deposit pallet-revive 1 MILLI_OGC/byte + 1 OGC/item).

Pillar 6 Nexus Services (Mathi) integration opcional

Post-deploy NFT collection puede:

• Beacon stake canonical: lockup OGC para featured visibility (100-1000 OGC/mes per ONS_PILLAR_6_NEXUS_SERVICES_V1)
• ONS name registration: human-readable collection name (5-1000 OGC/year per BM V2)
• Oracle KYB: institutional creators verified Nivel 3+ canonical

Pillar 7 Creator Economy (Larihana) hosting

NFT anchored a world pagado canonical 0.6 OGC/world/mes hosting. NFT transfer canonical preserva world ownership context (NFT changes hands, world hosting continues canonical).

Deploy instructions (Phase 3.x post cargo-contract v6 install)

# 1. Install ink! v6 toolchain canonical (pending David authorization)
cargo install cargo-contract --version "^6.0" --force

# 2. Build contract canonical
cd contracts/origin-nft-mint
cargo contract build --release

# 3. Output canonical files:
# - target/ink/origin_nft_mint.polkavm  (PolkaVM bytecode canonical)
# - target/ink/origin_nft_mint.json     (ABI metadata canonical para frontends)
# - target/ink/origin_nft_mint.contract (combined bundle canonical)

# 4. Deploy via Polkadot.js Apps OR Charon Atelier (Phase 3.x maduración):
# - upload_code(origin_nft_mint.polkavm) → CodeHash
# - instantiate(code_hash, constructor=default_bm_v2, value=storage_deposit)
# - Returns contract AccountId32 + H160 mapped address

Tests canonical (unit tests included)

3 tests canonical en #[cfg(test)] mod tests:

1. default_bm_v2_constructor_canonical_invariants — verifica defaults BM V2 ratified (91/9 + 5% royalty + 20% burn + unlimited supply + no pause).
2. invalid_share_split_rejected_canonical — invariant compile-detect: creator_share + treasury_share MUST sum 10_000 bps (100%). 90% + 5% rejected.
3. excessive_royalty_rejected_canonical — invariant: transfer_royalty_bps ≤ 1_000 (10% industry standard). 15% rejected.

Run canonical post-install:

cargo test --features ink-as-dependency

Roadmap follow-up post Slice 3.2

Ship	Slice	Scope
v0.0.43	3.3	origin-escrow contract template (multi-party + time-locked)
v0.0.44	3.4	origin-credential-mint contract (Ed25519 + BLAKE3 Sussi Ethos)
v0.0.45	3.5	origin-staking contract (validator + beacon + reputation)
v0.0.46	3.6	origin-mdk-reconciliation (ink! vs origin-mdk WASM boundary)
Phase 3.x	—	cargo-contract v6 install + real compilation + ReviveApi exposure (deferred Slice 3.1) + integration tests E2E reales

---

— Charon ⚓ (Pilar 4 Origin Chain, Phase 3 Slice 3.2 SCAFFOLD shipped 2026-05-27)