admin
.uverse.addressAdmin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
Value
<gnolang.StringValue>
pendingAdmin
.uverse.addressAdmin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
Value
<zero>
fees
v1.FeesAdmin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
- OID
- 06631c…9bce:6
fees details
beacon
.uverse.addressAdmin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
Value
<gnolang.StringValue>
listingDeposit
int64Admin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
Value
407700
minters
v0.Tree// minter pkgpath -> \*minterRecord
- OID
- 06631c…9bce:10
minters details
ops
v0.Tree// safe.PadInt(op id) -> \*pendingOp
- OID
- 06631c…9bce:12
ops details
opCount
int64Admin (design §2.5.2, §7.5). The admin can only change the parameters listed in validateOp, each inside a hard cap, after a public timelock; it can pause new activity for a bounded time. It can never move, approve or burn a token, touch a collection's configuration, or receive funds (I-1). With no collection yet there is nothing to protect, so ops execute without delay — that is how the platform is configured after deploy. TODO(mainnet): the initial admin and treasury must be the 2/3 multisig. SA-I6: CreateFee starts at 0 here so tests and bootstrap stay simple; scripts/deploy-onyx.sh sets a non-zero fee.create during bootstrap.
Value
5
pauses
v0.Tree// scope -> \*pauseRecord
- OID
- 06631c…9bce:15
pauses details
pauseRecord
typepauseRecord is one scope's pause and its budget (SA-L2): within a window of PauseWindowBlocks a scope can be paused for at most MaxPauseBlocks in total; a pause cannot be renewed while it runs. Worst case two budgets meet at a window boundary (\<= 2 x MaxPauseBlocks in a row), never more.
Value
core.pauseRecord
minterRecord
typeValue
core.minterRecord
pendingOp
typeValue
core.pendingOp
OpFeeCreate
untyped string// ugnot, \<= CreateFeeCap
Value
"fee.create"
OpFeePrimary
untyped string// bps, \<= ProtocolFeeCapBps
Value
"fee.primary"
OpFeeSecondary
untyped string// bps, \<= ProtocolFeeCapBps
Value
"fee.secondary"
OpFeeEngine
untyped string// bps, \<= EngineFeeCapBps: platform cap on engine-author fees
Value
"fee.engine"
OpTreasury
untyped string// address
Value
"treasury"
OpBeacon
untyped string// address, or "" to disable new beacon launches
Value
"beacon"
OpMinterAdd
untyped string// realm pkgpath
Value
"minter.add"
OpMinterDeprecate
untyped string// realm pkgpath: no new collections
Value
"minter.deprecate"
OpEngineReview
untyped string// engine id: reviewed badge (UI only)
Value
"engine.review"
OpAdminTransfer
untyped string// address; the new admin must AcceptAdmin
Value
"admin.transfer"
OpRandomnessAdd
untyped string// registered provider path: creators may launch with it
Value
"randomness.add"
OpRandomnessDepr
untyped string// provider path: no new launches; running ones finish
Value
"randomness.deprecate"
OpListingDeposit
untyped string// ugnot, \<= ListingDepositCap: market deposit return for new listings
Value
"listing.deposit"
pauseScopes
[]string- OID
- 06631c…9bce:17
pauseScopes details
ProposeOp
func(op string, arg string) string- OID
- 06631c…9bce:18
ProposeOp details
ExecuteOp
func(opID string)ExecuteOp applies a proposed op once its timelock has passed. The delay is judged at execution, so an op proposed during bootstrap still waits the full timelock if a collection appeared in the meantime.
- OID
- 06631c…9bce:20
ExecuteOp details
CancelOp
func(opID string)- OID
- 06631c…9bce:21
CancelOp details
AcceptAdmin
func()- OID
- 06631c…9bce:22
AcceptAdmin details
Pause
func(scope string)Pause stops new activity in one scope for the rest of its budget (at most MaxPauseBlocks per PauseWindowBlocks). It never blocks exits (I-2) and cannot be renewed while it runs (SA-L2).
- OID
- 06631c…9bce:23
Pause details
Unpause
func(scope string)Unpause ends a pause early and gives the unused blocks back to the budget.
- OID
- 06631c…9bce:24
Unpause details
pauseOf
func(scope string) *core.pauseRecord- OID
- 06631c…9bce:25
pauseOf details
Paused
func(scope string) boolPaused reports whether scope ("create", "mint", "trade") is paused now.
- OID
- 06631c…9bce:26
Paused details
PauseBudget
func(scope string) stringPauseBudget is the scope's pause record as JSON: {until, used, windowStart, windowEnd, left}.
- OID
- 06631c…9bce:27
PauseBudget details
assertNotPaused
func(scope string)- OID
- 06631c…9bce:28
assertNotPaused details
assertScope
func(scope string)- OID
- 06631c…9bce:29
assertScope details
assertAdmin
func()- OID
- 06631c…9bce:30
assertAdmin details
bootstrapping
func() bool- OID
- 06631c…9bce:31
bootstrapping details
earliestExecution
func(p *core.pendingOp) int64- OID
- 06631c…9bce:32
earliestExecution details
mustOp
func(opID string) *core.pendingOp- OID
- 06631c…9bce:33
mustOp details
validateOp
func(op string, arg string)validateOp is the closed list of admin powers (I-1).
- OID
- 06631c…9bce:34
validateOp details
applyOp
func(op string, arg string)- OID
- 06631c…9bce:35
applyOp details
assertActiveMinter
func(path string)- OID
- 06631c…9bce:36
assertActiveMinter details
parseAmount
func(s string) int64- OID
- 06631c…9bce:37
parseAmount details
CreateCollection
func(creator .uverse.address, spec v1.CollectionSpec) stringCreateCollection stores a Draft collection and returns its id. Nobody can mint a Draft, so a creator can configure phases across several messages without a race (OA B2).
- OID
- 06631c…9bce:38
CreateCollection details
Launch
func(cid string, l v1.LaunchSpec)Launch freezes the configuration (I-6): sale window, reveal window and the creator's commitment. The sale must start in the future so a beacon can commit before the first mint.
- OID
- 06631c…9bce:40
Launch details
AbortLaunch
func(cid string)AbortLaunch returns a launched collection to Draft while nothing has been minted — the way out when a beacon never commits. A commitment whose secret was revealed is burned for this collection; unrevealed ones (the beacon's deterministic one included) may be committed again (SA-L1).
- OID
- 06631c…9bce:41
AbortLaunch details
ReserveTo
func(cid string, to .uverse.address, n int64) (first int64, last int64)ReserveTo mints the creator's reserve before the sale starts. Reserve mints feed the entropy like any mint, appear in Provenance, and do not count toward wallet caps.
- OID
- 06631c…9bce:42
ReserveTo details
MintTo
func(cid string, to .uverse.address, n int64) (first int64, last int64)MintTo mints n tokens during the sale. The minter has already checked phase, price, allowlist and wallet cap; core re-checks only what it owns: state, supply and the beacon commitment (I-5). The lifetime counter of I-9 is the grc721 balance itself (mintedBy).
- OID
- 06631c…9bce:43
MintTo details
assertMintCount
func(c *core.collection, n int64)- OID
- 06631c…9bce:44
assertMintCount details
mintBatchTo
func(c *core.collection, to .uverse.address, n int64, h int64) (first int64, last int64)mintBatchTo is the only place tokens come into existence.
- OID
- 06631c…9bce:45
mintBatchTo details
mintedBy
func(c *core.collection, addr .uverse.address) int64mintedBy is addr's lifetime count of sale mints (I-9) while the collection is not Final: before Final no token can move or burn (I-11, lockExt) and tokens only come from mintBatchTo, so the grc721 balance is exactly sale mints + reserves received. This replaces a stored counter (~2 KB per new wallet, storage-cost-analysis P2). After Final the balance moves freely and no minter needs the count any more: -1.
- OID
- 06631c…9bce:46
mintedBy details
reservedTo
func(c *core.collection, addr .uverse.address) int64- OID
- 06631c…9bce:47
reservedTo details
awaitingBeaconCommit
func(c *core.collection) boolawaitingBeaconCommit: a committed-beacon launch whose beacon has not committed yet; nothing may be minted (or reserved) before it does.
- OID
- 06631c…9bce:48
awaitingBeaconCommit details
CloseMint
func(cid string)CloseMint materializes Closed once the sale window has passed. Anyone may call it; reveals and Finalize work without it.
- OID
- 06631c…9bce:49
CloseMint details
TransferCreator
func(cid string, to .uverse.address)TransferCreator starts a two-step handover (RA M-11).
- OID
- 06631c…9bce:50
TransferCreator details
AcceptCreator
func(cid string)- OID
- 06631c…9bce:51
AcceptCreator details
SetPayees
func(cid string, payees string)SetPayees changes the royalty split after Final. The primary-sale split is frozen with the sale (I-6); the royalty receiver stays the collection's sub-treasury, so third-party markets are unaffected. Royalties earned so far are first paid to the current payees (SA-I4).
- OID
- 06631c…9bce:52
SetPayees details
assertPayees
func(field string, ps []v1.Payee, cid string, engineID string)assertPayees refuses payees that can never spend what they receive (SA-L5): the platform's own realms and sub-addresses. cid is the collection being configured, engineID its engine adapter.
- OID
- 06631c…9bce:53
assertPayees details
assertSpendable
func(field string, addr .uverse.address, cid string, engineID string)assertSpendable panics for core, core's sub-addresses of collection cid (token identity c/\<cid>, royalty treasury roy/\<cid>), every minter ever approved, the engine adapter, and the platform realms next to core (market, reader, gallery, the genesis adapter). None of them has a path that spends an incoming payment, so the coins would be stranded (I-3).
- OID
- 06631c…9bce:54
assertSpendable details
platformRealms
[]stringplatformRealms are the realm paths next to core (README package map).
- OID
- 06631c…9bce:56
platformRealms details
assertCreator
func(c *core.collection)- OID
- 06631c…9bce:57
assertCreator details
assertBoundMinter
func(c *core.collection)- OID
- 06631c…9bce:58
assertBoundMinter details
boolStr
func(b bool) string- OID
- 06631c…9bce:59
boolStr details
ProtocolFeeCapBps
untyped bigint// 5% of any sale
Value
(500 <untyped> bigint)
RoyaltyCapBps
untyped bigint// 10% (RA M-3)
Value
(1000 <untyped> bigint)
CreateFeeCap
untyped bigint// 1,000 GNOT in ugnot
Value
(1000000000 <untyped> bigint)
MaxPayees
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(4 <untyped> bigint)
MaxSupplyCap
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(10000 <untyped> bigint)
MaxMintPerTx
untyped bigint// hypothesis: measure n=10 gas/deposit on Onyx
Value
(10 <untyped> bigint)
MaxReserveBps
untyped bigint// creator reserve \<= 10% of supply
Value
(1000 <untyped> bigint)
MaxSaleBlocks
untyped bigint// ~30 days
Value
(732000 <untyped> bigint)
RevealWindowMin
untyped bigint// ~1 hour
Value
(1017 <untyped> bigint)
RevealWindowMax
untyped bigint// ~7 days
Value
(170000 <untyped> bigint)
BeaconGraceBlocks
untyped bigint// beacon may reveal first in the window's last ~15 min (\< RevealWindowMin, so the creator always gets to go first)
Value
(254 <untyped> bigint)
TimelockBlocks
untyped bigint// ~48 hours
Value
(48800 <untyped> bigint)
MaxPauseBlocks
untyped bigint// ~8 days: pause budget per scope and window
Value
(195000 <untyped> bigint)
PauseWindowBlocks
untyped bigint// ~30 days (SA-L2)
Value
(732000 <untyped> bigint)
EngineFeeCapBps
untyped bigint// 5%: hard cap of an engine author's fee (platform cap \<= this)
Value
(500 <untyped> bigint)
ProviderWaitBlocks
untyped bigint// ~24 h: Finalize waits this long after the deadline (or the round's binding) for a provider's round before falling back (CV-M1)
Value
(24400 <untyped> bigint)
ListingDepositCap
untyped bigint// 5 GNOT: hard cap of the market's listing deposit return (op listing.deposit, CV-L2)
Value
(5000000 <untyped> bigint)
MaxNameLen
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(64 <untyped> bigint)
MaxDescriptionLen
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(1024 <untyped> bigint)
MaxParamsLen
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(1024 <untyped> bigint)
MinSecretLen
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(32 <untyped> bigint)
MaxSecretLen
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(256 <untyped> bigint)
MaxPageSize
untyped bigintHard limits. They are constants on purpose: nobody, admin included, can raise them after deploy (block counts assume ~3.54 s blocks, RA M-1).
Value
(50 <untyped> bigint)
BadgeBoth
untyped stringProvenance badges (design §4.3).
Value
"2/2"
BadgeCreatorOnly
untyped stringProvenance badges (design §4.3).
Value
"creator-only"
BadgeBeaconOnly
untyped stringProvenance badges (design §4.3).
Value
"beacon-only"
BadgeFallback
untyped stringProvenance badges (design §4.3).
Value
"fallback"
collection
typeValue
core.collection
selfPath
stringValue
"gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/core"
collections
v0.Tree// safe.PadInt(cid) -> \*collection
- OID
- 06631c…9bce:62
collections details
byCreator
v0.Tree// creator + ":" + padded cid -> cid
- OID
- 06631c…9bce:64
byCreator details
collCount
int64Value
16
init.97
func()- OID
- 06631c…9bce:66
init.97 details
cidWidth
untyped bigintValue
(10 <untyped> bigint)
collKey
func(cid string) string- OID
- 06631c…9bce:68
collKey details
mustCollection
func(cid string) *core.collection- OID
- 06631c…9bce:69
mustCollection details
stateAt
func(c *core.collection, h int64) v1.StatestateAt is the effective state at height h; the stored state lags until the next write materializes it (refresh).
- OID
- 06631c…9bce:70
stateAt details
refresh
func(c *core.collection, h int64)- OID
- 06631c…9bce:71
refresh details
revealDeadline
func(c *core.collection) int64revealDeadline is when anyone may finalize without the missing secrets. It is at most endHeight + RevealWindowMax, which bounds the transfer lock (I-11).
- OID
- 06631c…9bce:72
revealDeadline details
caller
func() .uverse.address- OID
- 06631c…9bce:73
caller details
assertNoDeposit
func()assertNoDeposit refuses coins on functions that take none, so nothing can get stuck in core (RA L-1). The origin-send envelope belongs to the first realm of the call; it is only ours to judge when a wallet called us.
- OID
- 06631c…9bce:74
assertNoDeposit details
itoa
func(n int64) string- OID
- 06631c…9bce:75
itoa details
height
func() int64- OID
- 06631c…9bce:76
height details
engineRecord
typeEngine registry ("art as code", design §5). An engine registers itself from its own /r/ adapter realm; its id is that realm's package path, so nobody can register in someone else's name. The stored interface value's methods are declared in the adapter, so every call runs with the adapter's authority, not core's (interrealm v2 borrow rule #1): engine code cannot write core state. It also cannot call back into a core mutator: all of core's state-changing functions are crossing and need a live cur the engine never has. Honest limits, surfaced to users rather than hidden: - an adapter realm with state could change its art later; the sample fingerprint (VerifyEngine) detects a change of the sample, and review means reading the adapter for statelessness; - a private (re-deployable) adapter cannot register: the VM aborts the registration when core's state would retain the private realm's type (spike A9, observed in gno v1.7.0 test mode; confirm on Onyx).
Value
core.engineRecord
engines
v0.Tree// engine id -> \*engineRecord
- OID
- 06631c…9bce:78
engines details
engineOrder
v0.Tree// safe.PadInt(seq) -> engine id
- OID
- 06631c…9bce:80
engineOrder details
byFingerprint
v0.Tree// fingerprint + ":" + engine id -> "" (CV-L3)
- OID
- 06631c…9bce:82
byFingerprint details
engineCount
int64Value
7
RegisterEngine
func(e v1.Engine) stringRegisterEngine stores the calling realm's engine (I-12 exception: one sample render in the engine's own registration transaction). The record is immutable afterwards except for the claim/deprecate/review flags.
- OID
- 06631c…9bce:84
RegisterEngine details
assertNotRewrap
func(fp string)assertNotRewrap refuses a second engine with the same art (same sample fingerprint) as a live registered one unless the transaction is signed by that engine's author (a new version): wrapping the public /p/ art of someone else's engine in an own adapter with no fee would make the engine-author fee optional (CV-L3). A deprecated engine no longer blocks. A one-byte change of the sample defeats this; the reviewed badge and the gallery's "same art as" hint cover that.
- OID
- 06631c…9bce:86
assertNotRewrap details
ClaimEngine
func(id string)ClaimEngine proves the manifest author controls that address. Unclaimed engines cannot back a collection.
- OID
- 06631c…9bce:87
ClaimEngine details
DeprecateEngine
func(id string)DeprecateEngine stops new collections; existing ones keep rendering.
- OID
- 06631c…9bce:88
DeprecateEngine details
engineFeeOf
func(rec *core.engineRecord) int64engineFeeOf is the engine's fee under the current platform cap.
- OID
- 06631c…9bce:89
engineFeeOf details
engineFeeQuote
func(c *core.collection) (.uverse.address, int64)engineFeeQuote is what c would snapshot at a Launch now.
- OID
- 06631c…9bce:90
engineFeeQuote details
collectionEngineFee
func(c *core.collection) (.uverse.address, int64)collectionEngineFee is the fee a sale of c pays now: the Launch snapshot bounded by the current cap; before Launch, the current quote.
- OID
- 06631c…9bce:91
collectionEngineFee details
EngineFee
func(cid string) (author .uverse.address, bps int64)EngineFee is the engine-author share of cid's sales: the author and the bps a sale pays now (0 when the creator is the author). mint/v1 and market/v1 pay safe.BpsOf(amount, bps) to author.
- OID
- 06631c…9bce:92
EngineFee details
mustEngine
func(id string) *core.engineRecord- OID
- 06631c…9bce:93
mustEngine details
copyManifest
func(m v1.Manifest) v1.ManifestcopyManifest gives core its own copy: the engine's slice was allocated in the engine realm.
- OID
- 06631c…9bce:94
copyManifest details
RenderWith
func(id string, params string, seed string) stringRenderWith renders any registered engine for arbitrary params and seed as a data URI — Studio previews and the Verify button.
- OID
- 06631c…9bce:95
RenderWith details
EngineTraits
func(id string, params string, seed string) []v1.TraitEngineTraits returns a core-owned copy of the engine's traits for seed.
- OID
- 06631c…9bce:96
EngineTraits details
TraitsWith
func(id string, params string, seed string) string- OID
- 06631c…9bce:97
TraitsWith details
VerifyEngine
func(id string) boolVerifyEngine re-renders the sample and compares it with the fingerprint stored at registration.
- OID
- 06631c…9bce:98
VerifyEngine details
EngineManifest
func(id string) v1.ManifestEngineManifest is the typed read for other realms (gallery).
- OID
- 06631c…9bce:99
EngineManifest details
EngineStatus
func(id string) stringEngineStatus is "unclaimed", "unverified", "reviewed" or "deprecated".
- OID
- 06631c…9bce:100
EngineStatus details
engineStatus
func(rec *core.engineRecord) string- OID
- 06631c…9bce:101
engineStatus details
Engine
func(id string) stringEngine is the record as JSON.
- OID
- 06631c…9bce:102
Engine details
Engines
func(offset int64, limit int64) string- OID
- 06631c…9bce:103
Engines details
writeEngine
func(w *v1.JSONWriter, rec *core.engineRecord)- OID
- 06631c…9bce:104
writeEngine details
studioInput
func(params string, seed string) v1.Input- OID
- 06631c…9bce:105
studioInput details
provenance
typeCommit–reveal v2 (design §4.2–4.3, closes RA H-3, M-5, M-6). The map is fixed by three inputs: the creator's secret sc, the beacon's secret sb and the public mint-entropy accumulator acc. Neither committer knows the other's secret while minting is open, so neither can time the last mint for a good map. Order of reveals: 1. nothing is accepted before Closed (an early reveal informs the other side); 2. the creator may reveal until revealDeadline - BeaconGraceBlocks; the beacon follows at any time before the deadline; 3. inside the last BeaconGraceBlocks only the beacon may reveal. If the creator stayed silent, the beacon's reveal finalizes at once ("beacon-only"), so the creator never sees sb while it can still choose (SA-M1; this also closes the mempool race of a creator front-running the beacon's grace reveal); 4. after revealDeadline anyone finalizes with whatever was revealed. What stays open, by design: the beacon, as last revealer after the creator, can still choose between revealing and not (one bit). It runs public code and the badge shows the outcome. The transfer lock (tokens.gno) keeps anyone from trading on early knowledge until Final. The second secret sb comes from the committed beacon (below) or, when the collection was launched with a randomness provider, from the provider's round bound after the creator's turn (randomness.gno); the order rules and badges are the same. A collection launched without the beacon (only possible while no beacon or provider is configured, SA-M2) gives the creator the whole choice of the map; it can have no creator reserve and is never reported as a fair launch (FairLaunch, Provenance "fair").
Value
core.provenance
roleCreator
untyped stringValue
"creator"
roleBeacon
untyped stringValue
"beacon"
BeaconCommit
func(cid string, commitHex string)BeaconCommit is the beacon's commitment, before any token exists.
- OID
- 06631c…9bce:106
BeaconCommit details
RevealCreatorSecret
func(cid string, secret string)- OID
- 06631c…9bce:108
RevealCreatorSecret details
RevealBeaconSecret
func(cid string, secret string)- OID
- 06631c…9bce:109
RevealBeaconSecret details
Finalize
func(cid string)Finalize is permissionless and never paused (I-2): immediately once every expected secret is revealed, otherwise after revealDeadline (fallback). For a provider collection it first binds or consumes the provider's round (settleProvider) and falls back only when the provider failed to deliver.
- OID
- 06631c…9bce:110
Finalize details
assertRevealOpen
func(c *core.collection, h int64)- OID
- 06631c…9bce:111
assertRevealOpen details
assertSecret
func(c *core.collection, role string, secret string, commit string)- OID
- 06631c…9bce:112
assertSecret details
revealsComplete
func(c *core.collection) bool- OID
- 06631c…9bce:113
revealsComplete details
finalize
func(c *core.collection, h int64)finalize runs at most once per collection (I-10): every caller checks state Closed, and this sets Final.
- OID
- 06631c…9bce:114
finalize details
VerifyProvenance
func(cid string) boolVerifyProvenance recomputes every commitment and the salt from public data. True only for a Final collection whose record is consistent.
- OID
- 06631c…9bce:115
VerifyProvenance details
FairLaunch
func(cid string) boolFairLaunch is true only for a Final, consistent collection whose map no single party could choose: launched with the beacon and finalized with both secrets or with the beacon's alone (after the creator stayed silent). Creator-only collections (no beacon: the creator alone knew the only secret and could steer the last mint, SA-M2) and fallbacks are not fair launches, even when VerifyProvenance is true.
- OID
- 06631c…9bce:116
FairLaunch details
isBurned
func(c *core.collection, commit string) bool- OID
- 06631c…9bce:117
isBurned details
Provenance
func(cid string) stringProvenance is the whole record as JSON; secrets and salt stay "" until revealed / final.
- OID
- 06631c…9bce:118
Provenance details
RandomnessProvider
typePluggable randomness sources (beacon v2). A collection launched with useBeacon picks its second entropy source at Launch (LaunchSpec.BeaconSource, frozen by I-6): - types.BeaconCommitted: the platform beacon's commit-reveal (provenance.gno; BeaconCommit before the first mint, RevealBeaconSecret after the creator). - the package path of a randomness provider realm: a public random value nobody can know in advance, e.g. a drand round relayed and BLS-verified on chain (gnolang/gno#6268 p/drand + r/drand). Nothing is committed before the sale; the round is fixed by the creator's reveal (same transaction) or, for a silent creator, in the grace period / at the deadline, and its value is then consumed by whoever calls first (FulfillRandomness or Finalize): no caller can skip it. Before any provider is approved (randomness.add) a keeper must run that requests in the grace period for silent creators and fulfills bound rounds as soon as they are published (README "Randomness keeper"). A provider realm registers itself (its id is its package path, as for engines) and is usable only after the admin approves it through the timelocked op randomness.add; randomness.deprecate stops new launches, running collections finish with it. So a drand provider plugs in without a core redeploy. Its methods are declared in its own realm, so core calling them runs the provider with the provider's authority (interrealm v2 borrow rule #1): it cannot write core state, and with no cur it cannot call a core mutator. Order with a provider (same guarantees as the committed beacon, SA-M1; CV-M1: the outcome never depends on who calls, or when): 1. the creator reveals until revealDeadline - BeaconGraceBlocks; the reveal itself binds the collection to provider.Target() in the same transaction, a round nobody knows yet (its secret is public now, so nobody holding a choice learns anything new later); 2. a silent creator: RequestRandomness (anyone, a keeper) inside the grace period, or the first Finalize after revealDeadline, binds the round instead — the creator's window is closed by then; 3. once the provider has the bound round (and not in the binding block, CV-I6), FulfillRandomness or Finalize (anyone, before or after the deadline) takes its value as the beacon secret and the collection is Final (2/2 after the creator, beacon-only otherwise). After the deadline Finalize refuses to fall back while the bound round may still arrive; 4. fallback (creator-only / fallback badge, never a FairLaunch) only once the provider failed to deliver for ProviderWaitBlocks after the deadline or the binding, whichever is later. A provider that panics aborts the calling transaction (a realm-boundary panic cannot be recovered); if an approved provider breaks, the admin deprecates it and, after the wait, Finalize stops calling it.
Value
core.RandomnessProvider
providerRecord
typeValue
core.providerRecord
providers
v0.Tree// provider pkgpath -> \*providerRecord
- OID
- 06631c…9bce:120
providers details
activeProviders
int64Value
0
MaxProviderNameLen
untyped bigintValue
(64 <untyped> bigint)
RegisterRandomnessProvider
func(p core.RandomnessProvider) stringRegisterRandomnessProvider stores the calling realm's provider. It is inert until the admin approves it (randomness.add, timelocked).
- OID
- 06631c…9bce:122
RegisterRandomnessProvider details
mustProvider
func(id string) *core.providerRecord- OID
- 06631c…9bce:124
mustProvider details
assertActiveProvider
func(id string)- OID
- 06631c…9bce:125
assertActiveProvider details
beaconAvailable
func() boolbeaconAvailable: some unpredictable second source exists, so no launch may opt out of it (SA-M2).
- OID
- 06631c…9bce:126
beaconAvailable details
usesProvider
func(c *core.collection) bool- OID
- 06631c…9bce:127
usesProvider details
RequestRandomness
func(cid string) int64RequestRandomness binds a provider-backed collection whose creator stayed silent to the provider's next unknowable round (a creator's reveal binds it itself). Permissionless and never paused (I-2); after the deadline the first Finalize binds instead.
- OID
- 06631c…9bce:128
RequestRandomness details
FulfillRandomness
func(cid string)FulfillRandomness takes the bound round's value from the provider as the beacon secret and finalizes (2/2 after the creator, beacon-only when it stayed silent). Permissionless and never paused (I-2); works before and after the deadline while the collection is Closed.
- OID
- 06631c…9bce:129
FulfillRandomness details
bindRound
func(c *core.collection, h int64) boolbindRound fixes the collection's round to provider.Target() at height h. It refuses (false) a non-positive round or one whose value the provider already has: that value would be known before binding (CV-I6).
- OID
- 06631c…9bce:130
bindRound details
consumeRound
func(c *core.collection, v string, h int64)- OID
- 06631c…9bce:131
consumeRound details
providerWaitEnd
func(c *core.collection) int64providerWaitEnd is the last height at which Finalize still waits for the provider: ProviderWaitBlocks after the deadline or the binding.
- OID
- 06631c…9bce:132
providerWaitEnd details
settleProvider
func(c *core.collection, h int64) boolsettleProvider is Finalize's provider step after the deadline (CV-M1). It returns true when Finalize is done: the round was bound now (a later Finalize or FulfillRandomness takes its value), or its value finalized the collection. It returns false only when the provider is provably unavailable — no usable value after providerWaitEnd — and Finalize falls back (creator-only / fallback, never a FairLaunch). While the bound round may still arrive it refuses, so nobody can pick the fallback by not fulfilling. After the wait a deprecated provider is not called at all (escape hatch for a provider whose code aborts every call).
- OID
- 06631c…9bce:133
settleProvider details
isRandomness
func(v string) boolisRandomness: a provider value core accepts (64 hex characters).
- OID
- 06631c…9bce:134
isRandomness details
RandomnessProviders
func(offset int64, limit int64) stringRandomnessProviders lists registered providers (by path) as JSON: \[{id, name, active, registeredHeight}]. Registration is open, so only "active" ones (admin-approved) can be chosen at Launch.
- OID
- 06631c…9bce:135
RandomnessProviders details
SelfAddress
func() .uverse.address- OID
- 06631c…9bce:136
SelfAddress details
CollectionCount
func() int64- OID
- 06631c…9bce:138
CollectionCount details
MintedTotal
func(cid string) int64MintedTotal counts every token ever minted, burned ones included (OA B4).
- OID
- 06631c…9bce:139
MintedTotal details
MintedBy
func(cid string, addr .uverse.address) int64MintedBy is addr's lifetime count of sale mints in cid (OA B3, I-9), reserves excluded. Exact until the collection is Final, -1 afterwards (derived from the locked grc721 balance; see mintedBy).
- OID
- 06631c…9bce:140
MintedBy details
Info
func(cid string) v1.CollectionInfoInfo is the typed collection view for other realms.
- OID
- 06631c…9bce:141
Info details
PrimaryPayees
func(cid string) []v1.PayeePrimaryPayees returns a copy of the frozen primary-sale split.
- OID
- 06631c…9bce:142
PrimaryPayees details
FeeConfig
func() v1.FeesFeeConfig is the typed fee view minters and markets settle with.
- OID
- 06631c…9bce:143
FeeConfig details
ListingDeposit
func() int64ListingDeposit is the deposit return (ugnot) market/v1 pins into a new listing (CV-L2); 0..ListingDepositCap, admin op listing.deposit.
- OID
- 06631c…9bce:144
ListingDeposit details
PrimaryFeeBps
func(cid string) int64PrimaryFeeBps is the protocol fee on cid's primary sale: the fee at Launch, or the current one if the admin lowered it since (SA-I5: a fee cannot rise during a sale).
- OID
- 06631c…9bce:145
PrimaryFeeBps details
Beacon
func() .uverse.address- OID
- 06631c…9bce:146
Beacon details
Admin
func() .uverse.address- OID
- 06631c…9bce:147
Admin details
IsMinter
func(path string) bool- OID
- 06631c…9bce:148
IsMinter details
Collection
func(cid string) stringCollection is the collection record as JSON.
- OID
- 06631c…9bce:149
Collection details
Collections
func(offset int64, limit int64) string- OID
- 06631c…9bce:150
Collections details
CollectionsByCreator
func(creator .uverse.address, offset int64, limit int64) string- OID
- 06631c…9bce:151
CollectionsByCreator details
Fees
func() stringFees is the fee configuration and its hard caps as JSON.
- OID
- 06631c…9bce:152
Fees details
PendingOps
func() stringPendingOps is the timelock queue as JSON.
- OID
- 06631c…9bce:153
PendingOps details
writeCollection
func(w *v1.JSONWriter, c *core.collection)- OID
- 06631c…9bce:154
writeCollection details
clampLimit
func(limit int64) int64- OID
- 06631c…9bce:155
clampLimit details
Render
func(path string) stringRender stays minimal in the immutable realm; the browsable gallery is the private, re-deployable gallery realm (design §2.5.7).
- OID
- 06631c…9bce:156
Render details
royaltyAddress
func(cid string) .uverse.address- OID
- 06631c…9bce:157
royaltyAddress details
RoyaltyAddress
func(cid string) .uverse.address- OID
- 06631c…9bce:159
RoyaltyAddress details
DistributeRoyalties
func(cid string) int64DistributeRoyalties pushes the whole sub-treasury balance to the royalty payees. Permissionless and never paused (I-2); market/v1 calls it after every sale. Returns the amount distributed. The sub-realm banker spend is verified by spike/subtoken, core and market tests on gno v1.7.0.
- OID
- 06631c…9bce:160
DistributeRoyalties details
distribute
func(c *core.collection) int64- OID
- 06631c…9bce:161
distribute details
tokenState
typetokenState is the per-collection data the transfer hook needs. It is shared by the collection and its lockExt, so neither points at the other. Per-token state is packed (storage-cost-analysis P1+P3): one fixed-width entry of packEntry bytes per token, packSlots tokens per avl key. Entry = four big-endian uint32 fields: mint height, transfer count (H-2), height of the last transfer, and the token's approval nonce (SA-L3). A mint appends entries in tid order (a new key every packSlots tokens, ~2 KB the minter of that bucket's first token pays); a transfer or an Approve only rewrites bytes in place, so neither creates a storage object.
Value
core.tokenState
packSlots
untyped bigintValue
(128 <untyped> bigint)
packFields
untyped bigintValue
(4 <untyped> bigint)
packEntry
untyped bigintValue
(16 <untyped> bigint)
packKeyWidth
untyped bigint// MaxSupplyCap/packSlots \< 1000
Value
(3 <untyped> bigint)
fieldMintHeight
untyped bigintValue
(0 <untyped> bigint)
fieldMoves
untyped bigintValue
(1 <untyped> bigint)
fieldLastMove
untyped bigintValue
(2 <untyped> bigint)
fieldNonce
untyped bigintValue
(3 <untyped> bigint)
packKey
func(tid int64) string- OID
- 06631c…9bce:162
packKey details
u32
func(v int64) stringu32 encodes v as 4 big-endian bytes. Heights stay below 2^32 for ~470 years of 3.5 s blocks; 2^32 transfers or approvals of one token cannot happen, so overflow is a hard error rather than a wrap.
- OID
- 06631c…9bce:164
u32 details
tidNum
func(tid string) int64tidNum is the numeric token id, or 0 for anything that is not a canonical positive decimal (no such token exists).
- OID
- 06631c…9bce:165
tidNum details
lockExt
typelockExt is the grc721 Extension behind two invariants: - I-11: before Final no token moves or burns (the reveal lock that closes RA H-3's information-advantage branch). The veto is a panic, which aborts the whole transaction — the documented Extension semantics of p/nt/grc721/v0. - H-2: every transfer bumps the token's move counter, so a market listing taken at moves=N is dead after any transfer, even if the token later comes back to the seller. It is declared in this realm, so the hooks write core state with core's authority even when another realm moves the token via RealmTeller.
Value
core.lockExt
lockKind
untyped stringValue
"art-lock"
Approve
func(cid string, tid string, to .uverse.address)Every Approve of a token and every SetApprovalForAll of an (owner, operator) pair bumps a nonce. A market pins the nonces at listing time, so revoking an approval kills a listing for good: approving again later starts a new nonce and never revives the old listing (SA-L3).
- OID
- 06631c…9bce:166
Approve details
SetApprovalForAll
func(cid string, operator .uverse.address, approved bool)- OID
- 06631c…9bce:167
SetApprovalForAll details
ApprovalNonces
func(cid string, tid string, owner .uverse.address, operator .uverse.address) (tokenNonce int64, operatorNonce int64)ApprovalNonces returns the token's approval nonce and the (owner, operator) approval-for-all nonce. Approvals made directly through Token(cid).RealmTeller by a realm acting for itself do not bump them.
- OID
- 06631c…9bce:168
ApprovalNonces details
bumpNonce
func(c *core.collection, key string)- OID
- 06631c…9bce:169
bumpNonce details
nonceOf
func(c *core.collection, key string) int64- OID
- 06631c…9bce:170
nonceOf details
TransferFrom
func(cid string, tid string, from .uverse.address, to .uverse.address)- OID
- 06631c…9bce:171
TransferFrom details
Burn
func(cid string, tid string)Burn is owner-only. The supply gate uses nextTID, so a burn never reopens a slot (I-5).
- OID
- 06631c…9bce:172
Burn details
Token
func(cid string) *v0.TokenToken publishes the collection's official \*grc721.Token. Its exported methods are reads or teller factories that need the caller's live realm; the ledger itself is never published.
- OID
- 06631c…9bce:173
Token details
Royalty
func(cid string) *v0.RoyaltyRoyalty publishes the read-only royalty view (EIP-2981 RoyaltyInfo).
- OID
- 06631c…9bce:174
Royalty details
OwnerOf
func(cid string, tid string) (.uverse.address, .uverse.error)- OID
- 06631c…9bce:175
OwnerOf details
BalanceOf
func(cid string, owner .uverse.address) (int64, .uverse.error)- OID
- 06631c…9bce:176
BalanceOf details
TokenMoves
func(cid string, tid string) int64TokenMoves is the transfer counter market/v1 pins in a listing (H-2).
- OID
- 06631c…9bce:177
TokenMoves details
TokenSeed
func(cid string, tid string) stringTokenSeed is "" until the collection is Final: no read path can leak the rarity map early.
- OID
- 06631c…9bce:178
TokenSeed details
TokenState
func(cid string, tid string) stringTokenState is {mintHeight, lastMoveHeight, moves} as JSON.
- OID
- 06631c…9bce:179
TokenState details
TokenURI
func(cid string, tid string) (string, .uverse.error)TokenURI is a base64 SVG data URI. Before Final every token shows core's neutral placeholder, never engine output (design §4.2).
- OID
- 06631c…9bce:180
TokenURI details
TokenTraits
func(cid string, tid string) stringTokenTraits is \[{"trait\_type":…,"value":…}] JSON.
- OID
- 06631c…9bce:181
TokenTraits details
TokenTraitList
func(cid string, tid string) []v1.TraitTokenTraitList is the typed form of TokenTraits for other realms (a copy).
- OID
- 06631c…9bce:182
TokenTraitList details
TokenMetadata
func(cid string, tid string) stringTokenMetadata is OpenSea-style metadata JSON.
- OID
- 06631c…9bce:183
TokenMetadata details
exists
func(c *core.collection, tid string) bool- OID
- 06631c…9bce:184
exists details
tokenInput
func(c *core.collection, tid string) v1.Input- OID
- 06631c…9bce:185
tokenInput details
renderToken
func(c *core.collection, tid string) stringrenderToken runs the collection's engine on a read path. A bad output degrades to a placeholder; a panicking engine only fails reads of its own collections (interrealm v2 §9: cross-realm panics abort the query).
- OID
- 06631c…9bce:186
renderToken details
tokenTraits
func(c *core.collection, tid string) []v1.Trait- OID
- 06631c…9bce:187
tokenTraits details
writeTraits
func(w *v1.JSONWriter, ts []v1.Trait)- OID
- 06631c…9bce:188
writeTraits details
placeholderSVG
func(name string, label string) stringplaceholderSVG is core's own neutral art: identical for every token of a collection, so it carries no rarity signal.
- OID
- 06631c…9bce:189
placeholderSVG details
dataURI
func(svg string) string- OID
- 06631c…9bce:190
dataURI details
emitBatch
func(kind string, c *core.collection, to .uverse.address, first int64, last int64)emitBatch announces one MintTo ("MintBatch") or ReserveTo ("Reserved") call; each token also gets its own "Minted" event from lockExt.
- OID
- 06631c…9bce:191