skins state

Buy

Buy buys one token of a skin design for the caller and returns its id. The exact price must be attached to the transaction (-send "\<price>ugnot") and is forwarded to the treasury of the game realm before the call returns. An address owns at most one token of a design: a skin cannot be given away, so a second copy would be of no use. It must be called directly by a user (maketx call): a call relayed by another realm or by a maketx run script is refused.

Burn

Burn destroys a skin token. Only its owner can. The storage deposit paid at purchase comes back; the price does not. The owner can buy the design again, while it is listed.

ownedKey

ownedKey is the key of owned: the address, then the design.

skinOf

skinOf returns the design of token id, "" when there is no such token.

ownerOf

catalog

catalog is the skin catalog at deploy, one design per line, sorted by id: id|name|model|pilot|body|wing|accent|price The rules are those of SetSkin (see validate.gno); the tests check every line. The website reads this file too, at build, to serve the metadata of each design at [https://gnofly.xyz/nft/skins/](https://gnofly.xyz/nft/skins/)\<id>.json: a design added later with SetSkin needs a line here as well for its JSON to exist. Classic, the look every pilot flies by default, is not here: it is free and drawn by the client, not a token.

errSpoofedRealm

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errNotAdmin

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errBadCatalog

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidID

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errReservedID

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidName

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidModel

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidPilot

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidColor

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidPrice

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errInvalidSupply

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errUnknownSkin

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errSkinUnlisted

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errSoldOut

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errAlreadyOwned

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errNotUserCall

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errNotMinted

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

errNotSkinOwner

The refusals of this realm, as string constants: a string costs its length in storage where an errors.New value costs about 1.15 KB (see the planes realm). A panic with a string aborts the call with the same message.

CatalogJSON

CatalogJSON returns every design, sorted by id, as a JSON array: [ { "id": "baron", "name": "Red Baron", "model": "biplane", "pilot": "none", "body": "#c1121f", "wing": "#780000", "accent": "#fdf0d5", "price": 1000000, "listed": true, "minted": 3, "maxSupply": 0 } ] The output has no whitespace. maxSupply 0 is unlimited. Classic, the free look, is not in it: the client draws it without a token.

SkinsOf

SkinsOf returns the designs addr owns a token of, sorted by id, as a JSON array: \["baron","goldie"]. It is \[] for an address without skins.

OwnerOf

BalanceOf

BalanceOf returns how many skin tokens addr owns, one per design at most.

TokenMetadata

TokenMetadata returns the metadata of skin token tid as JSON, the same for every token of a design, with the keys Adena reads: {"name":"Red Baron","description":"A gnofly skin, a biplane. ...", "image":"https://gnofly.xyz/nft/skins/baron.png", "attributes":[{"traitType":"model","value":"biplane"}, ...]}

mintedID

mintedID reads a token id, "1" and up in decimal, and checks it exists.

SkinOf

SkinOf returns the design of skin token id, "" when there is no such token.

TokenURI

TokenURI returns the image of skin token tid, "[https://gnofly.xyz/nft/skins/](https://gnofly.xyz/nft/skins/)\<design>.png": what a wallet shows (Adena puts it in an \<img>). The metadata is TokenMetadata, or "[https://gnofly.xyz/nft/skins/](https://gnofly.xyz/nft/skins/)\<design>.json" on the website. It is computed, not stored: a token costs no URI in deposit.

encode

encode marshals a document built above; it cannot fail on one.

Render

Render returns the shop as markdown, for gnoweb: "" the catalog "skin/<id>" one design "player/<addr>" the skins of one address Everything printed went through validate.gno when it was written, or is an address the chain gave the realm; the caller-supplied id and address are printed only once found valid.

link

renderHome

renderDesign

renderPlayer

designLink

supplyText

gnot

gnot writes ugnot as GNOT: 1000000 -> "1 GNOT", 1500000 -> "1.5 GNOT".

yesNo

authority

authority is the set of questions this realm asks about roles.

gameRoles

gameRoles answers with the roles of the game realm.

roles

roles is the authority of this realm: the game realm, always. It is a variable for one reason. Under \`gno test\` an imported realm is initialized without a deployer, and a test of this package has no way to become an admin of the game realm, so the tests put their own answers here. Nothing outside the test files assigns it, and there is no setter.

callerOf

assertAdmin

design

design is one skin of the catalog: what it looks like and how it sells.

token

The state. Nothing is exported by reference: the ledger and the trees are /p/ types with mutator methods. The token itself is not exported either: its tellers move tokens, and a skin never moves (soulbound, see doc.gno).

ledger

The state. Nothing is exported by reference: the ledger and the trees are /p/ types with mutator methods. The token itself is not exported either: its tellers move tokens, and a skin never moves (soulbound, see doc.gno).

designs

// design id -> \*design

tokenSkin

// token id -> design id

owned

// "\<addr>/\<design>" -> token id

nextID

// the id of the next token, 1 first

webPath

// "/r/.../gnofly/nfts/skins", for the links of Render

tokenName

tokenSymbol

payDenom

maxPrice

uriBase

classic

// the free look, never a token

init.61

bootstrap

bootstrap (re)creates the state and seeds the catalog. The tests call it to start over.

getDesign

getDesign returns the design registered under id, or nil.

putDesign

putDesign validates and stores a design. An existing one keeps its count and its listed flag; a new one starts listed.

SetSkin

SetSkin creates or updates a design. Admin only. id is \[a-z0-9-]{1,32} and not "classic", name \[A-Za-z0-9 '.!-]{1,40}, model \[a-z0-9-]{1,16}, pilot none or gnome, colours "#rrggbb" in lowercase, price 1 to 1e12 ugnot, maxSupply 0 for unlimited. A max supply under what is already minted stops the sales, it takes nothing back. Owners keep their tokens whatever happens to the design; its look is read from here, so a change of colours repaints every copy.

SetSkinListed

SetSkinListed puts a design on or off sale. Admin only.

webPathOf

webPathOf turns "gno.land/r/..." into "/r/...".

itoa

boolString

maxIDLen

maxModelLen

maxNameLen

validID

validID reports whether s matches \[a-z0-9-]{1,32}.

validModel

validModel reports whether s matches \[a-z0-9-]{1,16}.

validName

validName reports whether s matches \[A-Za-z0-9 '.!-]{1,40}. The charset is deliberately narrow so that a name can be embedded in JSON and markdown without escaping.

validColor

validColor reports whether s is "#rrggbb" with lowercase hex digits.

validAddress

validAddress reports whether addr is a valid address in its canonical, lowercase form. Bech32 can also be written in all capitals, and address.IsValid accepts that. To this realm the capitals would be a second key for the same account: a second player record, a second line on a leaderboard, an admin who can never be matched to a caller. Bech32 does not allow mixing cases, so looking at the first character is enough.

isSlug

isSlug reports whether s is 1 to max characters of \[a-z0-9-].