gnft state

assertIsValidTokenURI

assertIsValidTokenURI panics if the token already has a URI set.

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 nft.

errCannotSetURI

errInvalidAddress

errNotOwnerOrApproved

errTokenNotExists

errTransferToSelf

errInvalidTokenParams

errInvalidTokenParamsRange

errInvalidColorFormat

errStakedTokenLocked

errSpoofedRealm

makeErrorWithDetails

makeErrorWithDetails creates an error with additional context.

nft

init.17

Name

Name returns the NFT collection name.

Symbol

Symbol returns the NFT symbol.

TotalSupply

TotalSupply returns the total number of NFTs minted.

TokenURI

TokenURI returns the metadata URI for the specified token ID. If stored value is in parameter format (x1,y1,x2,y2,color1,color2), it converts to full base64-encoded SVG image URI on read.

BalanceOf

BalanceOf returns the number of NFTs owned by the specified address.

OwnerOf

MustOwnerOf

SetTokenURI

SetTokenURI sets the metadata URI for the specified token. Parameters: - tid: token ID - tURI: token URI Only callable by position contract.

SafeTransferFrom

SafeTransferFrom transfers token ownership with receiver validation. Parameters: - from: current owner address - to: recipient address - tid: token ID to transfer Returns error if transfer fails. 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).

TransferFrom

TransferFrom transfers a token from one address to another. Parameters: - from: current owner address - to: recipient address - tid: token ID Returns error if transfer fails. 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: - approved: address to approve - tid: token ID to approve for transfer Returns error if approval fails.

SetApprovalForAll

SetApprovalForAll enables/disables operator approval for all tokens. Parameters: - operator: address to set approval for - approved: true to approve, false to revoke Returns error if operation fails.

GetApproved

IsApprovedForAll

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

Mint

Mint creates new NFT and transfers to address. Parameters: - to: recipient address - tid: token ID Returns minted token ID. Only callable by position contract.

Exists

Exists checks if token ID exists.

Burn

Burn removes a specific token ID. Parameters: - tid: token ID to burn Only callable by position.

Render

Render returns the HTML representation of the NFT.

setTokenURI

setTokenURI sets the metadata URI for a specific token ID.

svgTemplate

svgTemplate holds pre-split template parts for efficient concatenation. Usage: svgTemplate\[0] + x1 + svgTemplate\[1] + y1 + ... + color2 + svgTemplate\[6]

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"

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.