Package core is the platform's immutable ledger (design §2.5.2): every collection, its official grc721 token and royalty, its provenance (commit–reveal v2), the engine registry, fees and the admin timelock.
What core guarantees, whoever holds the admin key:
- I-1 admin cannot move, approve or burn a token, and holds no funds; the op list is a closed set of parameters (admin.gno).
- I-2 pause only gates create, mint and trade. Transfer, burn, finalize, distribute and every cancel stay open. A pause expires by itself, cannot be renewed while it runs, and each scope has a budget of MaxPauseBlocks per PauseWindowBlocks (SA-L2).
- I-5 supply only grows through the collection's bound minter, never past maxSupply, and a token id is never minted twice.
- I-6 after Launch the engine, params, supply, payees, sale window, commitments, randomness source and fee snapshots are frozen.
- I-9 MintedBy(addr) is exact while a collection is not Final: grc721 balance minus the reserves sent to addr. It needs I-11 (no token moves or burns before Final); if that lock is ever relaxed the counter must be stored again (TestRegress_P2_*).
- I-10/11 a collection becomes Final at most once, only with both reveals or after revealDeadline, and that deadline is bounded, so the pre-reveal transfer lock always ends.
- I-12 engine code never runs on a state-changing path, except the creator's own CreateCollection (ValidateParams) and the engine's own RegisterEngine (one sample render). Every exported non-crossing function is read-only, so an engine cannot call back into a mutator. An admin-approved randomness provider (randomness.gno) runs only in RequestRandomness/FulfillRandomness of collections launched with it.
- I-13 every stored string passed safe.AssertText.
core imports no mutable realm: minters and engines are known only by package path and interface value.