gnft state

assertIsValidTokenURI

assertIsValidTokenURI panics if the token already has a URI set.

assertIsNonEmptyTokenURI

assertIsNonEmptyTokenURI panics if the new URI is empty.

assertIsValidAddress

assertIsValidAddress panics if the address is invalid.

assertFromIsValidAddress

assertFromIsValidAddress panics if the from address is invalid.

assertToIsValidAddress

assertToIsValidAddress panics if the to address is invalid.

assertIsAllowedTransfer

assertIsAllowedTransfer enforces that NFTs held by the staker (i.e. currently staked) can only be moved by the staker itself. Other tokens fall through to the standard GRC721 owner/approval checks performed inside ledger.

errCannotSetURI

errInvalidAddress

errNotOwnerOrApproved

errTokenNotExists

errTransferToSelf

errInvalidTokenParams

errInvalidTokenParamsRange

errInvalidColorFormat

errStakedTokenLocked

errSpoofedRealm

makeErrorWithDetails

makeErrorWithDetails creates an error with additional context.

token

ledger

meta

metaLedger

init.21

Name

Name returns the NFT collection name. Returns: - name: collection name

Symbol

Symbol returns the NFT collection symbol. Returns: - symbol: collection symbol

TotalSupply

TotalSupply returns the total number of NFTs minted. Returns: - supply: number of NFTs minted by the collection

TokenURI

TokenURI returns the metadata URI for the specified token ID. Parameter-format values (x1,y1,x2,y2,color1,color2) are rendered as a base64-encoded SVG data URI; other non-empty stored URIs are returned unchanged. Parameters: - tid: token ID whose metadata URI is requested Returns: - uri: stored URI, or a generated SVG data URI for parameter-format metadata - error: metadata lookup error when tid has no retrievable metadata

BalanceOf

BalanceOf returns the number of NFTs owned by the specified address. Parameters: - owner: address whose NFT balance is queried Returns: - balance: number of NFTs owned by owner - error: token-ledger balance lookup error; an invalid owner address panics before the lookup

OwnerOf

MustOwnerOf

SetTokenURI

SetTokenURI sets the metadata URI for the specified token. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - tid: token ID whose metadata URI is replaced - tURI: non-empty metadata URI or parameter-format image description Returns: - updated: true after the URI is stored and re-read successfully - error: nil on success; validation and storage failures panic before a non-nil error can be returned Only callable by position contract.

TransferFrom

TransferFrom transfers a token from one address to another. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - from: current owner address - to: recipient address - tid: token ID to transfer Returns: - error: nil after a successful transfer; invalid addresses, authorization, ownership, or ledger failures panic through checkTransferErr Permission model: - Tokens held by the staker contract (i.e. currently staked) can only be moved by the staker itself; the underlying staked LP position is non-transferable. - Otherwise, ownership and approval are enforced by the GRC721 layer (owner / approved-for-token / approved-for-all).

Approve

Approve grants permission to transfer a specific token ID to another address. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - approved: address to approve - tid: token ID to approve for transfer Returns: - error: nil after approval is stored; invalid addresses, ownership, or ledger failures panic through checkApproveErr

SetApprovalForAll

SetApprovalForAll enables/disables operator approval for all tokens. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - operator: address to set approval for - approved: true to approve, false to revoke Returns: - error: nil after the operator approval is stored; ledger failures panic before a non-nil error can be returned

GetApproved

IsApprovedForAll

IsApprovedForAll checks if operator can manage all owner's tokens. Parameters: - owner: token owner address - operator: operator address to check Returns: - approved: true when operator is approved for every token owned by owner

Mint

Mint creates new NFT and transfers it to to. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - to: recipient address - tid: token ID to mint Returns: - tokenID: minted token ID Only callable by position contract.

Exists

Exists checks if token ID exists. Parameters: - tid: token ID to check Returns: - exists: true when the ledger can resolve an owner for tid; false otherwise

Burn

Burn removes a specific token ID. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - tid: token ID to burn Only callable by position.

Render

Render returns the HTML representation of the NFT. Parameters: - path: render path; the empty path selects the collection home page Returns: - html: collection HTML for the home path, or "404\\n" for unsupported paths

setTokenURI

setTokenURI sets the metadata URI for a specific token ID.

svgTemplate

svgTemplate holds pre-split template parts for efficient concatenation. Usage: svgTemplate\[0] + clipID + svgTemplate\[1] + paintID + ... + color2 + svgTemplate\[10]

charset

charset contains valid hex digits for color generation.

x1Min

Parameter range constants for gradient coordinates.

x1Max

Parameter range constants for gradient coordinates.

y1Min

Parameter range constants for gradient coordinates.

y1Max

Parameter range constants for gradient coordinates.

x2Min

Parameter range constants for gradient coordinates.

x2Max

Parameter range constants for gradient coordinates.

y2Min

Parameter range constants for gradient coordinates.

y2Max

Parameter range constants for gradient coordinates.

x1Range

Parameter range constants for gradient coordinates.

y1Range

Parameter range constants for gradient coordinates.

x2Range

Parameter range constants for gradient coordinates.

y2Range

Parameter range constants for gradient coordinates.

genImageParamsString

genImageParamsString generates random gradient parameters and returns them as a compact string. Format: "x1,y1,x2,y2,color1,color2" (e.g., "10,12,125,123,#AABBCC,#DDEEFF")

ImageParams

ImageParams holds parsed and validated image parameters.

validateCoordinate

validateCoordinate checks if a coordinate value is within valid range. Returns error with details about which coordinate failed if out of range.

parseImageParams

parseImageParams parses and validates parameters in one step. Returns parsed ImageParams pointer or error. Returns nil on error to avoid allocating zero-value struct. Expected format: "x1,y1,x2,y2,color1,color2"

svgIDSuffix

isValidHexColor

isValidHexColor checks if a string is a valid hex color in #XXXXXX format.

generateRandInstance

generateRandInstance generates a new random instance.

checkErr

checkErr panics if an error occurs.

checkTransferErr

checkTransferErr wraps transfer errors with more specific context.

checkApproveErr

checkApproveErr wraps approve errors with more specific context.