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.

assets/v1 package

Overview

Package assets is Sinopia's immutable asset store for uploaded collections (docs/uploaded-collections.md §4–§6, §0a). An artist creates a store, declares artworks (on-chain bytes or IPFS CIDs, each with its sha256, editions, a creator-assigned tier and trait values), uploads the on-chain bytes in chunks, and seals it. A sealed store never changes: the upload engine (r/…/engines/upload) binds one sealed store to one Draft collection and reads its art from here.

Guarantees (design §14):

  • only the store's owner writes, and only from a wallet (direct MsgCall, IsUserCall); nothing here accepts or holds coins;
  • a store is Draft until Seal, which is irreversible: records, titles, dictionaries and bytes are immutable afterwards;
  • an "on-chain" artwork is complete only when every byte is stored, its sha256 equals the declared one and media.CheckImage passed (magic + dimensions; SVG through safe.AssertSVG, 16 KiB cap);
  • an "ipfs" artwork always says ipfs; a raw CID's digest is checked against the declared sha256 on chain;
  • every user string passed safe.AssertText; JSON goes through safe.JSONWriter.

Storage is paid by the owner who writes it, and only the owner can free Draft data (Truncate), so refunds go back to the payer (T8).

Function

AddArtworks

func AddArtworks(cur realm, storeID, batch string) string
Ask AI Claude ChatGPT

AddArtworks declares up to MaxBatch artworks, one per '\n'-separated line:

Example
1kind|mime|size|sha256|cid|editions|tier|title|v1|…|vN

with exactly one value per trait type of the store (N = len(traitTypes)):

  • kind "chain" | "ipfs"; mime "svg" | "png" | "webp" | "jpeg";
  • size: decimal bytes, chain svg <= 16,384, chain raster <= 262,144, ipfs raw <= 1 MiB, ipfs dag-pb <= 50 MiB; the store's on-chain total stays <= 4 MiB;
  • sha256: 64 lower-case hex of the file bytes, unique in the store (use editions for copies);
  • cid: "" for chain; for ipfs a CIDv1 (media.ParseCIDv1): raw codec ⇒ its digest must equal sha256 (verified binding), dag-pb ⇒ digest stored;
  • editions 1..10,000 (the store's slots stay <= 10,000);
  • tier "" or one of the store's tiers; title <= 64 bytes;
  • values "" (none) or <= 32 bytes, no leading/trailing space; at most 100 distinct values per trait type and 255 over all types of a store.

Returns "first-last" (0-based indexes). Event ArtworkAdded per line.

Params

Command

# WARNING: This command is running in an INSECURE mode.
# It is strongly recommended to use a hardware device for signing
# and avoid trusting any computer connected to the internet,
# as your private keys could be exposed.

gnokey maketx call -pkgpath "gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1" -func "AddArtworks" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -chainid "onyx-1" -remote "https://rpc.onyx.testnets.gno.land" ADDRESSgnokey query -remote "https://rpc.onyx.testnets.gno.land" auth/accounts/ADDRESS
gnokey maketx call -pkgpath "gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1" -func "AddArtworks" -args $'' -args $'' -gas-fee 1000000ugnot -gas-wanted 1_000_000_000 -send "" -broadcast=false ADDRESS > call.tx
gnokey sign -tx-path call.tx -chainid "onyx-1" -account-number ACCOUNTNUMBER -account-sequence SEQUENCENUMBER ADDRESS
gnokey broadcast -remote "https://rpc.onyx.testnets.gno.land" call.tx
  

Gno Expression Evaluator

Evaluate any read-only Gno expression against gno.land/r/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia3/assets/v1, for example a function call with arguments.