stable state

CollectionName

CollectionSymbol

realmRelPath

summaryPageSize

gnowebListLimit

pageWindow

tokenPageImageSize

RevealDelayBlocks

token

ledger

// private: only this realm mints, burns and moves tokens

collectionOwner

approvedVersion

mintPriceUgnot

// 100 GNOT, per request

whitelistBps

royaltyBps

royaltyRecipient

mintedIDs

mintedTraitCombos

// combo key -> true

tokenComboKeys

// tid.String() -> comboKey string

mintCountByWallet

// address.String() -> int64

mintingOpenMirror

maxMintsPerWalletMirror

burnedRecords

// tid.String() -> burnRecord

burnedIDs

claimRecords

sealedData

// tid.String() -> traitPreset

mintHeight

// tid.String() -> int64

sealedImage

traitPreset

traitPreset is one token's locked-in trait selection -- everything gemsartfab needs to render the real image once revealed. Owned here (not imported from whichever realm minted it) since stable is the one place this needs to survive any future mint-mechanics version swap.

claimRecord

burnRecord

burnRecord keeps a burned token's compact trait selection, not its expanded name/description/attribute strings: the text is rebuilt on read (traitOnlyMetadata), so a burn frees more storage deposit.

init.31

Trait

Metadata/Trait: the shape every reader here builds (grc721/v0 keeps no metadata of its own). Never stored per token -- see currentMetadata.

Metadata

Name

Symbol

TokenCount

TokenID

GetName

GetName/GetSymbol: the Teller-style names some tools look for.

GetSymbol

OwnerOf

BalanceOf

GetApproved

IsApprovedForAll

ApprovedVersion

Owner

MintPrice

MintedIDs

TotalBurned

MintingOpen

MaxMintsPerWallet

MintsByWallet

IsTraitComboAvailable

WhitelistBps

WhitelistCount

WhitelistEntry

EffectivePrice

RoyaltyInfo

RoyaltyBps

RoyaltyRecipient

callerAddress

assertOwner

SetApprovedVersion

SetMintPrice

AddToWhitelist

AddToWhitelistBatch

RemoveFromWhitelist

SetRoyaltyBps

SetRoyaltyRecipient

assertCallerIsApprovedVersion

RecordMint

RecordMint: the ENTIRE point of this v2 candidate. Unlike the real gems6/stable's own RecordMint, this does NOT take a full, rendered grc721.Metadata -- it takes the raw trait fields instead, and writes a small fixed-size SEALED placeholder to nft's own storage. The real image is never computed here, or anywhere, during a mint transaction -- see currentMetadata for where it actually happens (a plain read, unbound by any tx-level gas-wanted). Only the approved version realm may call this. Reserves comboKey atomically with the mint, same authoritative-check role the real stable's RecordMint plays.

ClaimCount

ClaimAt

ReportMintingOpen

ReportMaxMintsPerWallet

Age

Age returns real blocks elapsed since tid was minted, or -1 if it doesn't exist / was never sealed.

IsRevealed

IsRevealed reports whether tid's real metadata is visible yet.

currentMetadata

currentMetadata is what every reader-facing function below actually returns: nft's own stored (sealed) metadata before reveal, or the real image assembled fresh from gemsartfab after -- computed on this plain read, never inside a mint or any other gas-metered write. This is the one addition to the real gems6/stable's own read path.

sealedMetadata

sealedMetadata: what every token shows until its reveal block, the one shared placeholder image (not per-token storage).

listRow

listRow is one gnoweb table row's name and image: the name from the traits (no render), the image the art's thumbnail render once revealed, the shared sealed placeholder before.

assembledMetadata

article

article is "An" before a vowel sound (Amethyst, Imperial, Orange), else "A".

gemDisplayName

colorNameFor

colorNameFor looks up a stone's colorIdx-th color name from gemsart.ColorPaletteCSV ("hex:name;hex:name;...") -- a cheap parse, not a render. Kept in sync with gemsart.RenderTokenSVG's own internal colorForStone by construction (same palette source), without ever calling RenderTokenSVG itself.

traitOnlyMetadata

traitOnlyMetadata builds the archived record straight from tp's raw fields -- no gemsart.RenderTokenSVG call, so no image, ever. This is what Burn archives: the burn record was never meant to keep the picture (see Burn's own comment), so there's no reason to pay the render cost to build one just to immediately discard it.

TokenURI

TokenURI is the token's image itself, as a data URI: the sealed placeholder until the reveal block, then the full art. Adena puts it straight into an \<img>, which also runs the art's CSS animation.

TokenMetadata

TokenMetadata is the metadata as a JSON string in the camelCase shape Adena reads (name, description, backgroundColor, attributes of {traitType, value}). No image in it, so it costs no render: the image is TokenURI.

TokenJSON

TokenJSON is the classic OpenSea-style metadata (snake\_case keys, the image inline) as a base64 JSON data URI, for marketplaces that expect a tokenURI of that shape.

jsonEscape

metadataJSON

Approve

SetApprovalForAll

TransferFrom

SafeTransferFrom

SafeTransferFrom: kept for the standard signature. grc721/v0 has no receiver-contract hook, so it is TransferFrom.

Burn

Burn destroys a token. Caller must be its current owner. Archives the real trait combination as text -- always the real traits, even if burned before the reveal delay passed, since sealedData already has them regardless of whether TokenURI has started showing them publicly yet. Deliberately never renders or stores an image: the archive was only ever a text record (see BurnedTokenSummary/ renderMintedListPage's own "Burned" row), so calling gemsart.RenderTokenSVG here just to immediately discard its output was pure waste -- confirmed live, a burn on an already-revealed token cost ~165M gas, almost entirely that one re-render, roughly the same cost the whole reveal-delay design exists to avoid paying on mint. Releases the trait combo AND the reveal bookkeeping (sealedData/ mintHeight) -- maximizes the real storage-deposit refund, same reasoning the real gems6/stable's own Burn already documents.

traitsToCSV

TokenSummary

thumbSummary

thumbSummary is TokenSummary with the art's thumbnail render and the metadata built from the traits, so a page of them stays well under the query gas ceiling.

tokenSummary

CollectionSummary

walletScanChunk

walletScanChunk bounds how many ids one WalletSummary call scans; walletRenderCap bounds how many of the caller's OWN tokens it renders. The second bound is the one that matters: every matched token is a full SVG render (TokenSummary -> currentMetadata -> gemsart), and one vm/qeval has a fixed gas budget -- a wallet holding 30 pieces made the unbounded version fail outright with "out of gas in location: CPUCycles" on Pearl (2026-09-16), taking the mint page's "Your minted Gems" panel down for exactly the collectors who care most. A client pages by calling again with the returned nextIdx until it reaches the collection size, same protocol as before; it just gets more, smaller pages for a big holder.

walletRenderCap

walletScanChunk bounds how many ids one WalletSummary call scans; walletRenderCap bounds how many of the caller's OWN tokens it renders. The second bound is the one that matters: every matched token is a full SVG render (TokenSummary -> currentMetadata -> gemsart), and one vm/qeval has a fixed gas budget -- a wallet holding 30 pieces made the unbounded version fail outright with "out of gas in location: CPUCycles" on Pearl (2026-09-16), taking the mint page's "Your minted Gems" panel down for exactly the collectors who care most. A client pages by calling again with the returned nextIdx until it reaches the collection size, same protocol as before; it just gets more, smaller pages for a big holder.

WalletSummary

BurnedTokenSummary

bigTokenImage

shortAddr

shortAddr is how lists show an address: g1 + 4 characters … last 4.

renderMintedListPage

renderPageLinks

renderBurnedListPage

renderBurnedTokenPage

renderBurnedTokenPage is the token route for an id that no longer exists. If it was burned, its archived record -- name, traits, who burned it, at what block -- is shown: the minted list links every burned row here, and stablev3 answered that link with a 404, which read as a broken site (found in the 2026-09-15 Pearl test run). Anything else really is a 404.

gnotString

gnotString: ugnot as GNOT, trailing zeros trimmed (100000000 -> "100", 1500000 -> "1.5").

bpsPercent

bpsPercent: basis points as a percentage (500 -> "5%", 250 -> "2.5%"). ufmt ignores zero-padding, so "%d.%02d" printed 500 as "5.0%".

render404

Render

checkErr