ReasonNotUpload
untyped stringReadiness reasons (Status.reason).
Value
"not-upload"
ReasonNoStore
untyped stringReadiness reasons (Status.reason).
Value
"no-store"
ReasonNotSealed
untyped stringReadiness reasons (Status.reason).
Value
"store-not-sealed"
ReasonBoundElsewhere
untyped stringReadiness reasons (Status.reason).
Value
"bound-elsewhere"
ReasonSupply
untyped stringReadiness reasons (Status.reason).
Value
"supply-mismatch"
ReasonUnbound
untyped stringReadiness reasons (Status.reason).
Value
"unbound"
ReasonReady
untyped stringReadiness reasons (Status.reason).
Value
"ready"
col
typeValue
upload.col
loadCol
func(cid string) upload.col- OID
- 0c5e11…0f84:3
loadCol details
mustUpload
func(cid string) upload.col- OID
- 0c5e11…0f84:5
mustUpload details
IsUpload
func(cid string) boolIsUpload reports whether cid's engine is this adapter.
- OID
- 0c5e11…0f84:6
IsUpload details
StoreOf
func(cid string) stringStoreOf is the store named by cid's params ("" if none).
- OID
- 0c5e11…0f84:7
StoreOf details
Readiness
func(cid string) (ready bool, reason string, store string, badge string)Readiness is the typed Status for other realms.
- OID
- 0c5e11…0f84:8
Readiness details
Status
func(cid string) stringStatus is {cid, upload, state, store, bound, ready, reason, badge, settled, maxSupply, slots}. The frontend shows the mint UI only when ready (T14).
- OID
- 0c5e11…0f84:9
Status details
StorageBadge
func(cid string) stringStorageBadge is "computed" (any other engine), "onchain", "ipfs", "mixed", or "unbound" for an upload collection that is not ready (§9).
- OID
- 0c5e11…0f84:10
StorageBadge details
SetComposition
func(cid string) stringSetComposition 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).
- OID
- 0c5e11…0f84:11
SetComposition details
stNotReady
untyped bigint// Final but not bound/ready: no art
Value
(1 <untyped> bigint)
stResolved
untyped bigintValue
(2 <untyped> bigint)
readToken
func(cid string, tid string) (upload.col, upload.resolved, int, .uverse.error)- OID
- 0c5e11…0f84:12
readToken details
mustReadToken
func(cid string, tid string) (upload.col, upload.resolved, int)- OID
- 0c5e11…0f84:13
mustReadToken details
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.
- OID
- 0c5e11…0f84:14
TokenURI details
artURI
func(r upload.resolved) string- OID
- 0c5e11…0f84:15
artURI details
TokenImage
func(cid string, tid string) stringTokenImage is the inline image: a data URI for on-chain art, "" for IPFS art (never a remote URL); core's placeholder before Final.
- OID
- 0c5e11…0f84:16
TokenImage details
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.
- OID
- 0c5e11…0f84:17
Assignment details
TokenArtwork
func(cid string, tid string) stringTokenArtwork 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).
- OID
- 0c5e11…0f84:18
TokenArtwork details
assignmentMode
func(si v1.StoreInfo) string- OID
- 0c5e11…0f84:19
assignmentMode details
realTraits
func(r upload.resolved) []v1.TraitrealTraits 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.
- OID
- 0c5e11…0f84:20
realTraits details
unrevealed
[]v1.Trait- OID
- 0c5e11…0f84:22
unrevealed details
notReady
[]v1.Trait- OID
- 0c5e11…0f84:25
notReady details
unrevealedJSON
untyped stringValue
"[{\"trait_type\":\"Status\",\"value\":\"Unrevealed\"}]"
notReadyJSON
untyped stringValue
"[{\"trait_type\":\"Status\",\"value\":\"Not ready\"}]"
realTraitsJSON
func(r upload.resolved) stringrealTraitsJSON 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).
- OID
- 0c5e11…0f84:27
realTraitsJSON details
writeTraits
func(w *v1.JSONWriter, ts []v1.Trait)- OID
- 0c5e11…0f84:28
writeTraits details
TokenTraitList
func(cid string, tid string) []v1.TraitTokenTraitList is the typed real-name trait list of one token (a copy).
- OID
- 0c5e11…0f84:29
TokenTraitList details
TokenTraits
func(cid string, tid string) stringTokenTraits is TokenTraitList as \[{"trait\_type","value"}] JSON.
- OID
- 0c5e11…0f84:30
TokenTraits details
TokenMetadata
func(cid string, tid string) stringTokenMetadata is the canonical metadata (§10.2). Before Final: core's placeholder image and \[{Status: Unrevealed}].
- OID
- 0c5e11…0f84:31
TokenMetadata details
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.
- OID
- 0c5e11…0f84:32
TraitLists details
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.
- OID
- 0c5e11…0f84:33
TraitJSONLists details
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.
- OID
- 0c5e11…0f84:34
tokenPage details
TraitCounts
func(cid string, offset int64, limit int64) stringTraitCounts 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).
- OID
- 0c5e11…0f84:35
TraitCounts details
TraitsBatch
func(cid string, offset int64, limit int64) stringTraitsBatch is \[{tid, traits:\[{trait\_type, value}]}] for tokens offset+1 … offset+limit (limit \<= MaxTraitsBatch), burned tokens skipped.
- OID
- 0c5e11…0f84:36
TraitsBatch details
traitJSONPage
func(cid string, offset int64, limit int64, max int64) ([]string, []string)- OID
- 0c5e11…0f84:37
traitJSONPage details
Render
func(path string) stringRender stays minimal; uploaded collections are browsed in the gallery.
- OID
- 0c5e11…0f84:38
Render details
cardSVG
untyped stringcardSVG 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) stringcertificateSVG 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.
- OID
- 0c5e11…0f84:39
certificateSVG details
sizeLabel
func(n int64) string- OID
- 0c5e11…0f84:41
sizeLabel details
author
.uverse.addressauthor claims the engine in core (ClaimEngine). TODO(mainnet): the platform's engine-author key, not the deployer.
Value
<gnolang.StringValue>
Author
func() .uverse.address- OID
- 0c5e11…0f84:43
Author details
FeeBps
untyped bigintFeeBps is the engine-author fee (D3: none; fixed forever at Register).
Value
(0 <untyped> bigint)
TraitTier
untyped stringCore-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 stringCore-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 stringCore-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 stringCore-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 bigintCore-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
stringValue
"gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/engines/upload"
assetsPath
stringValue
"gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1"
bound
v0.Tree// store id -> cid
- OID
- 0c5e11…0f84:48
bound details
byCID
v0.Tree// cid -> \*binding
- OID
- 0c5e11…0f84:50
byCID details
binding
typeValue
upload.binding
init.64
func()- OID
- 0c5e11…0f84:51
init.64 details
SelfPath
func() stringSelfPath and AssetsPath are the engine id and the store realm it reads.
- OID
- 0c5e11…0f84:52
SelfPath details
AssetsPath
func() string- OID
- 0c5e11…0f84:53
AssetsPath details
impl
typeimpl is zero-size and declared here, so core runs it with this realm's authority (interrealm v2 borrow rule #1).
Value
upload.impl
traitTypes
func() []string- OID
- 0c5e11…0f84:54
traitTypes details
Register
func() stringRegister is an explicit call (not init: under the inert package policy init runs in the approver's tx). Anyone may call it, once.
- OID
- 0c5e11…0f84:55
Register details
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}.
- OID
- 0c5e11…0f84:56
Bind details
Unbind
func(cid string)Unbind releases the store while the collection is still a Draft. Creator only. Event StoreUnbound{store, cid}.
- OID
- 0c5e11…0f84:57
Unbind details
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).
- OID
- 0c5e11…0f84:58
Settle details
assertWallet
func()- OID
- 0c5e11…0f84:59
assertWallet details
assertUploadDraft
func(info v1.CollectionInfo, cid string)- OID
- 0c5e11…0f84:60
assertUploadDraft details
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.
- OID
- 0c5e11…0f84:61
assertPayees details
jsonStrField
func(js string, key string) stringjsonStrField reads a string field of core's JSON. Values written by safe.JSONWriter escape '"', so the key pattern cannot be forged by user text.
- OID
- 0c5e11…0f84:62
jsonStrField details
provenanceSalt
func(prov string) stringprovenanceSalt is the final salt from core.Provenance JSON ("" before Final). The pattern \`"salt":"\` cannot be forged: JSONWriter escapes every '"' inside a secret.
- OID
- 0c5e11…0f84:63
provenanceSalt details
parseParams
func(p string) (string, bool)parseParams accepts exactly "store:\<id>" with a canonical decimal id.
- OID
- 0c5e11…0f84:64
parseParams details
storeExists
func(id string) bool- OID
- 0c5e11…0f84:65
storeExists details
tidNum
func(tid string) int64tidNum is the numeric token id, 0 for a non-canonical one.
- OID
- 0c5e11…0f84:66
tidNum details
resolved
typeresolved 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.
- OID
- 0c5e11…0f84:67
coreResolve details
saltOf
func(cid string, b *upload.binding) string- OID
- 0c5e11…0f84:68
saltOf details
keyOf
func(cid string, b *upload.binding, salt string) string- OID
- 0c5e11…0f84:69
keyOf details
assign
func(cid string, tid string, n int64, info v1.CollectionInfo, store string, si v1.StoreInfo, key string, cache map[int64]v1.Artwork) upload.resolvedassign 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.
- OID
- 0c5e11…0f84:70
assign details
editionLabel
func(e int64, of int64) string- OID
- 0c5e11…0f84:71
editionLabel details
storageLabel
func(kind int) string- OID
- 0c5e11…0f84:72