Skip to content Search Apps Documentation Source Content Run Reset Eval Playground File Folder Download Copy Actions State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

Community realm. Read the code first. Community realm, deployed by its author. Read the code before you interact or send coins.

upload state

Back to all declarations

ReasonNotUpload

untyped string

Readiness reasons (Status.reason).

Value

"not-upload"

ReasonNoStore

untyped string

Readiness reasons (Status.reason).

Value

"no-store"

ReasonNotSealed

untyped string

Readiness reasons (Status.reason).

Value

"store-not-sealed"

ReasonBoundElsewhere

untyped string

Readiness reasons (Status.reason).

Value

"bound-elsewhere"

ReasonSupply

untyped string

Readiness reasons (Status.reason).

Value

"supply-mismatch"

ReasonUnbound

untyped string

Readiness reasons (Status.reason).

Value

"unbound"

ReasonReady

untyped string

Readiness reasons (Status.reason).

Value

"ready"

col

type

Value

upload.col

loadCol

func(cid string) upload.col
Open
OID
0c5e11…0f84:3
loadCol details

Inspect func

mustUpload

func(cid string) upload.col
Open
OID
0c5e11…0f84:5
mustUpload details

Inspect func

IsUpload

func(cid string) bool

IsUpload reports whether cid's engine is this adapter.

Open
OID
0c5e11…0f84:6
IsUpload details

Inspect func

StoreOf

func(cid string) string

StoreOf is the store named by cid's params ("" if none).

Open
OID
0c5e11…0f84:7
StoreOf details

Inspect func

Readiness

func(cid string) (ready bool, reason string, store string, badge string)

Readiness is the typed Status for other realms.

Open
OID
0c5e11…0f84:8
Readiness details

Inspect func

Status

func(cid string) string

Status is {cid, upload, state, store, bound, ready, reason, badge, settled, maxSupply, slots}. The frontend shows the mint UI only when ready (T14).

Open
OID
0c5e11…0f84:9
Status details

Inspect func

StorageBadge

func(cid string) string

StorageBadge is "computed" (any other engine), "onchain", "ipfs", "mixed", or "unbound" for an upload collection that is not ready (§9).

Open
OID
0c5e11…0f84:10
StorageBadge details

Inspect func

SetComposition

func(cid string) string

SetComposition is {collection, store, ready, reason, set}, set = assets.Composition of the collection's store: slots per tier and per trait value over the planned set (public and fixed before the sale, D8).

Open
OID
0c5e11…0f84:11
SetComposition details

Inspect func

stHidden

untyped bigint

// not Final: placeholder

Value

(0 <untyped> bigint)

stNotReady

untyped bigint

// Final but not bound/ready: no art

Value

(1 <untyped> bigint)

stResolved

untyped bigint

Value

(2 <untyped> bigint)

readToken

func(cid string, tid string) (upload.col, upload.resolved, int, .uverse.error)
Open
OID
0c5e11…0f84:12
readToken details

Inspect func

mustReadToken

func(cid string, tid string) (upload.col, upload.resolved, int)
Open
OID
0c5e11…0f84:13
mustReadToken details

Inspect func

TokenURI

func(cid string, tid string) (string, .uverse.error)

TokenURI is the canonical art URI: "data:\<mime>;base64,…" for on-chain art, "ipfs://\<cidv1>" for IPFS art; core's placeholder before Final and core's TokenURI (the generic card) for a collection that is not ready.

Open
OID
0c5e11…0f84:14
TokenURI details

Inspect func

artURI

func(r upload.resolved) string
Open
OID
0c5e11…0f84:15
artURI details

Inspect func

TokenImage

func(cid string, tid string) string

TokenImage is the inline image: a data URI for on-chain art, "" for IPFS art (never a remote URL); core's placeholder before Final.

Open
OID
0c5e11…0f84:16
TokenImage details

Inspect func

Assignment

func(cid string, tid string) (ready bool, slot int64, edition int64, a v1.Artwork)

Assignment is the typed TokenArtwork for other realms (gallery): ready is false before Final or when the collection is not ready; a is a copy.

Open
OID
0c5e11…0f84:17
Assignment details

Inspect func

TokenArtwork

func(cid string, tid string) string

TokenArtwork is the token's assignment as JSON: {collection, tid, revealed, ready, reason} and, once revealed and ready, {store, artwork, slot, edition, editions, assignment, kind, mime, mimeType, size, sha256, digest, cid, uri, tier, tierSource, title, traits}. uri is "ipfs://\<cid>" for IPFS art and "" for on-chain art (read its bytes with TokenImage / TokenURI: base64 of up to 256 KiB is not free).

Open
OID
0c5e11…0f84:18
TokenArtwork details

Inspect func

assignmentMode

func(si v1.StoreInfo) string
Open
OID
0c5e11…0f84:19
assignmentMode details

Inspect func

realTraits

func(r upload.resolved) []v1.Trait

realTraits are the upload-path attributes with the creator's real type names: Tier, the creator's traits in store order, Edition (when the artwork has more than one) and Storage.

Open
OID
0c5e11…0f84:20
realTraits details

Inspect func

unrevealedJSON

untyped string

Value

"[{\"trait_type\":\"Status\",\"value\":\"Unrevealed\"}]"

notReadyJSON

untyped string

Value

"[{\"trait_type\":\"Status\",\"value\":\"Not ready\"}]"

realTraitsJSON

func(r upload.resolved) string

realTraitsJSON is realTraits as JSON, from the names the store escaped once (media.Artwork.TierJSON / TraitsJSON): same bytes as writeTraits of realTraits, without escaping creator text on every read (review UP-M1).

Open
OID
0c5e11…0f84:27
realTraitsJSON details

Inspect func

writeTraits

func(w *v1.JSONWriter, ts []v1.Trait)
Open
OID
0c5e11…0f84:28
writeTraits details

Inspect func

TokenTraitList

func(cid string, tid string) []v1.Trait

TokenTraitList is the typed real-name trait list of one token (a copy).

Open
OID
0c5e11…0f84:29
TokenTraitList details

Inspect func

TokenTraits

func(cid string, tid string) string

TokenTraits is TokenTraitList as \[{"trait\_type","value"}] JSON.

Open
OID
0c5e11…0f84:30
TokenTraits details

Inspect func

TokenMetadata

func(cid string, tid string) string

TokenMetadata is the canonical metadata (§10.2). Before Final: core's placeholder image and \[{Status: Unrevealed}].

Open
OID
0c5e11…0f84:31
TokenMetadata details

Inspect func

TraitLists

func(cid string, offset int64, limit int64) ([]string, [][]v1.Trait)

TraitLists returns, for tokens offset+1 … offset+limit (limit \<= MaxTraitLists, burned tokens skipped), the token ids and their real-name traits. The permutation key is computed once per call.

Open
OID
0c5e11…0f84:32
TraitLists details

Inspect func

TraitJSONLists

func(cid string, offset int64, limit int64) ([]string, []string)

TraitJSONLists is TraitLists with each token's traits as a JSON array (the bytes TokenTraits returns), for pages that print them (reader.Cards). limit \<= MaxTraitJSONLists.

Open
OID
0c5e11…0f84:33
TraitJSONLists details

Inspect func

tokenPage

func(cid string, offset int64, limit int64, max int64) ([]string, []upload.resolved, int)

tokenPage resolves tokens offset+1 … offset+limit (limit \<= max, burned skipped) with one permutation key per call and one record read per distinct artwork. st is stHidden before Final, stNotReady when the collection is Final but not ready, else stResolved.

Open
OID
0c5e11…0f84:34
tokenPage details

Inspect func

TraitCounts

func(cid string, offset int64, limit int64) string

TraitCounts is {"n": tokens counted, "counts": {type: {value: count}}} over tokens offset+1 … offset+limit (limit \<= MaxTraitCounts, burned skipped), with the creator's real names: Tier, the creator's trait types (store order, values in dictionary order), Edition, Storage. Before Final every token counts as {"Status": "Unrevealed"}, Final but not ready as {"Status": "Not ready"}. One permutation key per call; the counting runs in assets/v1 over integer ids (review UP-M1).

Open
OID
0c5e11…0f84:35
TraitCounts details

Inspect func

TraitsBatch

func(cid string, offset int64, limit int64) string

TraitsBatch is \[{tid, traits:\[{trait\_type, value}]}] for tokens offset+1 … offset+limit (limit \<= MaxTraitsBatch), burned tokens skipped.

Open
OID
0c5e11…0f84:36
TraitsBatch details

Inspect func

traitJSONPage

func(cid string, offset int64, limit int64, max int64) ([]string, []string)
Open
OID
0c5e11…0f84:37
traitJSONPage details

Inspect func

Render

func(path string) string

Render stays minimal; uploaded collections are browsed in the gallery.

Open
OID
0c5e11…0f84:38
Render details

Inspect func

cardSVG

untyped string

cardSVG is the generic card: the registration sample (unique fingerprint, CV-L3), RenderWith output, and the answer to any call that is not core's real render of a revealed, bound token.

Value

"<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\" width=\"512\" height=\"512\"><rect width=\"512\" height=\"512\" fill=\"#16130f\"/><rect x=\"20\" y=\"20\" width=\"472\" height=\"472\" fill=\"none\" stroke=\"#b5332e\" stroke-width=\"3\"/><text x=\"256\" y=\"240\" fill=\"#e"...

certificateSVG

func(r upload.resolved) string

certificateSVG stands in for raster and IPFS art on core's TokenURI path, which only carries allowlisted SVG (§10.1). Every text is XML-escaped; the document stays far below MaxSVGBytes.

Open
OID
0c5e11…0f84:39
certificateSVG details

Inspect func

author

.uverse.address

author claims the engine in core (ClaimEngine). TODO(mainnet): the platform's engine-author key, not the deployer.

Value

<gnolang.StringValue>

FeeBps

untyped bigint

FeeBps is the engine-author fee (D3: none; fixed forever at Register).

Value

(0 <untyped> bigint)

TraitTier

untyped string

Core-path trait slots (engine/v1 manifests fix their trait types at registration, so creator trait types appear as "Trait k" = "\<Type>: \<Value>").

Value

"Creator tier"

TraitArtwork

untyped string

Core-path trait slots (engine/v1 manifests fix their trait types at registration, so creator trait types appear as "Trait k" = "\<Type>: \<Value>").

Value

"Artwork"

TraitEdition

untyped string

Core-path trait slots (engine/v1 manifests fix their trait types at registration, so creator trait types appear as "Trait k" = "\<Type>: \<Value>").

Value

"Edition"

TraitStorage

untyped string

Core-path trait slots (engine/v1 manifests fix their trait types at registration, so creator trait types appear as "Trait k" = "\<Type>: \<Value>").

Value

"Storage"

TraitSlots

untyped bigint

Core-path trait slots (engine/v1 manifests fix their trait types at registration, so creator trait types appear as "Trait k" = "\<Type>: \<Value>").

Value

(8 <untyped> bigint)

MaxTraitsBatch

untyped bigint

// JSON (was 50)

Value

(20 <untyped> bigint)

MaxTraitJSONLists

untyped bigint

// typed, JSON per token (reader.Cards)

Value

(20 <untyped> bigint)

MaxTraitLists

untyped bigint

// typed (was 500)

Value

(250 <untyped> bigint)

MaxTraitCounts

untyped bigint

// TraitCounts (reader.TraitCounts)

Value

(200 <untyped> bigint)

selfPath

string

Value

"gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/engines/upload"

assetsPath

string

Value

"gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1"

bound

v0.Tree

// store id -> cid

Open
OID
0c5e11…0f84:48
bound details

Inspect ref

byCID

v0.Tree

// cid -> \*binding

Open
OID
0c5e11…0f84:50
byCID details

Inspect ref

binding

type

Value

upload.binding

SelfPath

func() string

SelfPath and AssetsPath are the engine id and the store realm it reads.

Open
OID
0c5e11…0f84:52
SelfPath details

Inspect func

impl

type

impl is zero-size and declared here, so core runs it with this realm's authority (interrealm v2 borrow rule #1).

Value

upload.impl

Register

func() string

Register is an explicit call (not init: under the inert package policy init runs in the approver's tx). Anyone may call it, once.

Open
OID
0c5e11…0f84:55
Register details

Inspect func

Bind

func(cid string)

Bind locks the collection's store (its params "store:\<id>") to the collection. Caller == core creator == store owner, from a wallet; core state Draft; the collection uses this engine; the store is sealed and not bound elsewhere; maxSupply == the store's slots; no primary or royalty payee is this realm or assets/v1 (SA-L5). Event StoreBound{store, cid}.

Open
OID
0c5e11…0f84:56
Bind details

Inspect func

Unbind

func(cid string)

Unbind releases the store while the collection is still a Draft. Creator only. Event StoreUnbound{store, cid}.

Open
OID
0c5e11…0f84:57
Unbind details

Inspect func

Settle

func(cid string)

Settle caches the permutation key once the collection is Final. Anyone may call it; it is deterministic (the salt is final) and idempotent, and it only saves read gas: the lazy path computes the same key. Event Settled{cid, key} (first call only).

Open
OID
0c5e11…0f84:58
Settle details

Inspect func

assertUploadDraft

func(info v1.CollectionInfo, cid string)
Open
OID
0c5e11…0f84:60
assertUploadDraft details

Inspect func

assertPayees

func(cid string)

assertPayees refuses this realm and assets/v1 as primary or royalty payees (SA-L5: neither can ever spend a payment). Core already refuses itself, its sub-addresses, minters, the engine adapter and its siblings.

Open
OID
0c5e11…0f84:61
assertPayees details

Inspect func

jsonStrField

func(js string, key string) string

jsonStrField reads a string field of core's JSON. Values written by safe.JSONWriter escape '"', so the key pattern cannot be forged by user text.

Open
OID
0c5e11…0f84:62
jsonStrField details

Inspect func

provenanceSalt

func(prov string) string

provenanceSalt is the final salt from core.Provenance JSON ("" before Final). The pattern \`"salt":"\` cannot be forged: JSONWriter escapes every '"' inside a secret.

Open
OID
0c5e11…0f84:63
provenanceSalt details

Inspect func

parseParams

func(p string) (string, bool)

parseParams accepts exactly "store:\<id>" with a canonical decimal id.

Open
OID
0c5e11…0f84:64
parseParams details

Inspect func

storeExists

func(id string) bool
Open
OID
0c5e11…0f84:65
storeExists details

Inspect func

tidNum

func(tid string) int64

tidNum is the numeric token id, 0 for a non-canonical one.

Open
OID
0c5e11…0f84:66
tidNum details

Inspect func

resolved

type

resolved is one token's assignment.

Value

upload.resolved

coreResolve

func(in v1.Input) (upload.resolved, bool)

coreResolve answers only core's own TokenURI/TokenTraits call for a Final, bound collection: CollectionID, params and seed must be exactly what core passes (§7 snipe resistance). Anything else gets the card.

Open
OID
0c5e11…0f84:67
coreResolve details

Inspect func

saltOf

func(cid string, b *upload.binding) string
Open
OID
0c5e11…0f84:68
saltOf details

Inspect func

keyOf

func(cid string, b *upload.binding, salt string) string
Open
OID
0c5e11…0f84:69
keyOf details

Inspect func

assign

func(cid string, tid string, n int64, info v1.CollectionInfo, store string, si v1.StoreInfo, key string, cache map[int64]v1.Artwork) upload.resolved

assign maps token n to its slot, artwork and edition. With a cache (trait batches) artworks are read once per batch and without their hashes/CID (assets.ArtworkMeta); without one the full record is read.

Open
OID
0c5e11…0f84:70
assign details

Inspect func

editionLabel

func(e int64, of int64) string
Open
OID
0c5e11…0f84:71
editionLabel details

Inspect func

storageLabel

func(kind int) string
Open
OID
0c5e11…0f84:72
storageLabel details

Inspect func
ReasonNotUpload : untyped string ="not-upload"
ReasonNoStore : untyped string ="no-store"
ReasonNotSealed : untyped string ="store-not-sealed"
ReasonBoundElsewhere : untyped string ="bound-elsewhere"
ReasonSupply : untyped string ="supply-mismatch"
ReasonUnbound : untyped string ="unbound"
ReasonReady : untyped string ="ready"
col : type =upload.col
loadCol : func(cid string) upload.col Inspect
mustUpload : func(cid string) upload.col Inspect
IsUpload : func(cid string) bool Inspect
StoreOf : func(cid string) string Inspect
Readiness : func(cid string) (ready bool, reason string, store string, badge string) Inspect
Status : func(cid string) string Inspect
StorageBadge : func(cid string) string Inspect
SetComposition : func(cid string) string Inspect
stHidden : untyped bigint =(0 <untyped> bigint)
stNotReady : untyped bigint =(1 <untyped> bigint)
stResolved : untyped bigint =(2 <untyped> bigint)
readToken : func(cid string, tid string) (upload.col, upload.resolved, int, .uverse.error) Inspect
mustReadToken : func(cid string, tid string) (upload.col, upload.resolved, int) Inspect
TokenURI : func(cid string, tid string) (string, .uverse.error) Inspect
artURI : func(r upload.resolved) string Inspect
TokenImage : func(cid string, tid string) string Inspect
Assignment : func(cid string, tid string) (ready bool, slot int64, edition int64, a v1.Artwork) Inspect
TokenArtwork : func(cid string, tid string) string Inspect
assignmentMode : func(si v1.StoreInfo) string Inspect
realTraits : func(r upload.resolved) []v1.Trait Inspect
unrevealed : []v1.Trait (len=1) Inspect
notReady : []v1.Trait (len=1) Inspect
unrevealedJSON : untyped string ="[{\"trait_type\":\"Status\",\"value\":\"Unrevealed\"}]"
notReadyJSON : untyped string ="[{\"trait_type\":\"Status\",\"value\":\"Not ready\"}]"
realTraitsJSON : func(r upload.resolved) string Inspect
writeTraits : func(w *v1.JSONWriter, ts []v1.Trait) Inspect
TokenTraitList : func(cid string, tid string) []v1.Trait Inspect
TokenTraits : func(cid string, tid string) string Inspect
TokenMetadata : func(cid string, tid string) string Inspect
TraitLists : func(cid string, offset int64, limit int64) ([]string, [][]v1.Trait) Inspect
TraitJSONLists : func(cid string, offset int64, limit int64) ([]string, []string) Inspect
tokenPage : func(cid string, offset int64, limit int64, max int64) ([]string, []upload.resolved, int) Inspect
TraitCounts : func(cid string, offset int64, limit int64) string Inspect
TraitsBatch : func(cid string, offset int64, limit int64) string Inspect
traitJSONPage : func(cid string, offset int64, limit int64, max int64) ([]string, []string) Inspect
Render : func(path string) string Inspect
cardSVG : untyped string ="<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\" width=\"512\" height=\"512\"><rect width=\"512\" height=\"512\" fill=\"#16130f\"/><rect x=\"20\" y=\"20\" width=\"472\" height=\"472\" fill=\"none\" stroke=\"#b5332e\" stroke-width=\"3\"/><text x=\"256\" y=\"240\" fill=\"#e"...
certificateSVG : func(r upload.resolved) string Inspect
sizeLabel : func(n int64) string Inspect
author : .uverse.address =<gnolang.StringValue>
Author : func() .uverse.address Inspect
FeeBps : untyped bigint =(0 <untyped> bigint)
TraitTier : untyped string ="Creator tier"
TraitArtwork : untyped string ="Artwork"
TraitEdition : untyped string ="Edition"
TraitStorage : untyped string ="Storage"
TraitSlots : untyped bigint =(8 <untyped> bigint)
MaxTraitsBatch : untyped bigint =(20 <untyped> bigint)
MaxTraitJSONLists : untyped bigint =(20 <untyped> bigint)
MaxTraitLists : untyped bigint =(250 <untyped> bigint)
MaxTraitCounts : untyped bigint =(200 <untyped> bigint)
selfPath : string ="gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/engines/upload"
assetsPath : string ="gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1"
bound : v0.Tree Inspect
byCID : v0.Tree Inspect
binding : type =upload.binding
init.64 : func() Inspect
SelfPath : func() string Inspect
AssetsPath : func() string Inspect
impl : type =upload.impl
traitTypes : func() []string Inspect
Register : func() string Inspect
Bind : func(cid string) Inspect
Unbind : func(cid string) Inspect
Settle : func(cid string) Inspect
assertWallet : func() Inspect
assertUploadDraft : func(info v1.CollectionInfo, cid string) Inspect
assertPayees : func(cid string) Inspect
jsonStrField : func(js string, key string) string Inspect
provenanceSalt : func(prov string) string Inspect
parseParams : func(p string) (string, bool) Inspect
storeExists : func(id string) bool Inspect
tidNum : func(tid string) int64 Inspect
resolved : type =upload.resolved
coreResolve : func(in v1.Input) (upload.resolved, bool) Inspect
saltOf : func(cid string, b *upload.binding) string Inspect
keyOf : func(cid string, b *upload.binding, salt string) string Inspect
assign : func(cid string, tid string, n int64, info v1.CollectionInfo, store string, si v1.StoreInfo, key string, cache map[int64]v1.Artwork) upload.resolved Inspect
editionLabel : func(e int64, of int64) string Inspect
storageLabel : func(kind int) string Inspect