pixels state

InitialMinX

InitialMaxX

InitialMinY

InitialMaxY

MaxBoardDim

ExpandStep

ExpandThresholdPercent

CooldownBlocks

cellPx

FeePerPixelUgnot

// 0.1 GNOT

VandalismFeeUgnot

// 1 GNOT

MaxBulkPixels

MaxCommunityDesignPixels

MaxCommunityDesignNameLen

palette

collectionOwner

minX

maxX

minY

maxY

grid

placedBy

placedAtHeight

lastPlacedBlock

placementCounts

// address.String() -> int64, total successful placements (leaderboard)

officialTarget

// key(x,y) -> int64 colorIndex, owner-curated free-to-place design

communityDesigns

// designID -> encoded "x,y,c;x,y,c;..." string

communityDesignNames

// designID -> display name

communityDesignCount

totalPlacements

occupiedCells

expansionsCount

migrationOpen

key

callerAddress

assertOwner

getPixel

boardArea

boardWidth

maybeExpand

expand

ForceExpand

inBounds

recordPlacement

bumpPlacementCount

bumpPlacementCount counts every successful placement action (including recolors and erasures of an existing cell) toward the leaderboard -- simpler and more transparent than trying to track "cells currently attributed to this address", which is a fuzzy concept on a canvas anyone can recolor.

isOfficialTarget

inOfficialTargetArea

inOfficialTargetArea reports whether (x, y) has ANY owner-curated target color registered, regardless of what colorIndex is being proposed -- used to tell "wrong color on a logo cell" (vandalism, charged VandalismFeeUgnot) apart from "cell outside the design entirely" (charged the normal FeePerPixelUgnot).

IsOfficialTarget

InOfficialTargetArea

pixelFee

pixelFee returns what a single (x, y, colorIndex) placement costs: free if it matches the official target exactly, VandalismFeeUgnot if the cell is part of the target area but the color is wrong, or the normal FeePerPixelUgnot for anywhere else on the board.

FeePerPixel

VandalismFeePerPixel

MaxBulkPixelsPerTx

SetOfficialTarget

SetOfficialTarget merges entries into the free-to-place design -- owner-only, additive rather than replacing. Registering the full ~800-cell logo costs real storage deposit (measured ~0.19 GNOT/cell on testnet), enough that doing it in one transaction risks needing the whole amount upfront in a single call; additive means it can be split across as many affordable calls as needed, called repeatedly over time. encoded is "x,y,c;x,y,c;...", matching the CSV-ish convention already used by TopPlacers. Calling this with a coordinate already in the target just overwrites that one entry's color, same as you'd expect.

ClearOfficialTarget

ClearOfficialTarget wipes the entire free-to-place design -- owner- only. Split out from SetOfficialTarget now that registration is additive, so "start over from nothing" is still possible but isn't the default behavior of every registration call.

SubmitCommunityDesign

SubmitCommunityDesign registers a new community-submitted design -- anyone can call this, not just the owner. encoded is "x,y,c;x,y,c;...", already in absolute board coordinates (the submitter positions it client-side before submitting). Placing any of these cells still costs the normal FeePerPixelUgnot, same as any other free-form cell -- this just makes the design's shape and position visible on-chain so other visitors' browsers can render a progress bar for it and help fill it in, the same way everyone already helps finish the owner-curated logo.

ListCommunityDesigns

ListCommunityDesigns returns "id,name,pixelCount;id,name,pixelCount;..." for every submitted design, in submission order.

GetCommunityDesign

GetCommunityDesign returns the raw "x,y,c;x,y,c;..." for one design, or "" if id doesn't exist.

RemoveCommunityDesign

RemoveCommunityDesign lets the owner delist a design (offensive name, spam, abuse of the free-submission path) -- owner-only moderation hook. Pixels already placed toward it stay exactly as painted (this only removes it from ListCommunityDesigns/GetCommunityDesign, it doesn't touch the grid), and the id is never reused.

collectPayment

collectPayment verifies at least feeUgnot of ugnot was attached to this call (via the standard "send" field on /vm.m\_call) and forwards exactly that much from the realm's own balance to collectionOwner, leaving any overpayment sitting in the realm's balance rather than dealing with refund complexity -- callers control how much they attach, so overpaying is their own choice, not something to protect against. chain/runtime/unsafe's own doc on OriginSend warns the envelope is shared across the whole call chain, so a malicious intermediate realm could consume it after a naive check passes (TOCTOU) -- the doc recommends pairing OriginSend with AssertOriginCall AND IsUserCall. AssertOriginCall specifically panics if invoked from anywhere but a top-level entry point (its own doc: "panic... when invoked by another method, even from the same realm or package"), so callers (SetPixel, SetPixels) call it themselves before reaching here rather than this helper calling it on their behalf.

SetPixel

SetPixels

SetPixels places up to MaxBulkPixels pixels in one transaction. encoded is "x,y,c;x,y,c;...". Cooldown is checked and updated once for the whole batch rather than per pixel -- SetPixel's own per-call cooldown would otherwise reject every entry after the first within the same block, since they all execute in the same transaction/ height. Fee is the sum of pixelFee(x, y, c) across every entry, collected as one payment.

ImportHistoricalPixel

CloseMigrationWindow

MigrationOpen

GetPixel

PlacedBy

Bounds

BoardWidth

BoardHeight

TotalPlacements

OccupiedCells

ExpansionsCount

PaletteCSV

placerCount

TopPlacers

TopPlacers returns up to n "address,count" pairs, semicolon-separated, sorted by count descending -- the leaderboard. Iterated fresh on every call rather than kept pre-sorted, since contributor counts are small enough (real participants, not per-pixel) for a plain insertion sort to be cheap regardless of how large the canvas itself grows. Gno's "sort" package predates Go's generics-based sort.Slice, so this is hand-rolled rather than using sort.Interface for a one-off local type.

CooldownRemaining

Snapshot

canvasDataURI

Render