validator_scores state

admin

publisher

caller

requirePublisher

isCanonicalAddress

isCanonicalAddress accepts only a lowercase, checksummed g1 address.

SetPublisher

SetPublisher replaces the publisher. Admin only.

GetAdmin

GetAdmin returns the admin address, for post-deployment checks.

GetPublisher

GetPublisher returns the current publisher address.

edition

An edition keeps each candidate as its validated payload line, in the order added. One string per candidate costs about 160 bytes of storage deposit; a struct in an AVL tree cost about 3,700 bytes (measured on gnodev at the gnoland-1 runtime).

editions

editions holds the sealed editions in order, then at most one open edition, always last.

operatorLen

operatorLen is the length of a canonical g1 address, the prefix of a line.

openEdition

requireOpen

OpenEdition

OpenEdition starts a new edition and returns its number. Publisher only. arenas is a comma-separated list, for example "challenge,test13,firedrill".

AddCandidates

AddCandidates adds one candidate per payload line to the open edition. Publisher only. The whole payload is validated before anything is stored.

Seal

Seal closes the open edition for good. Publisher only. It fails unless the edition holds exactly expectedCount candidates (at least one).

DiscardOpen

DiscardOpen drops the open edition. Publisher only. Its number is reused by the next OpenEdition. The slot is cleared first so the backing array does not keep the discarded edition stored.

hexDigits

quoteSafe

quoteSafe quotes a string the realm validated to need no JSON escaping (addresses, dates, hashes, arena names). Concatenation is cheap in gas; per-byte loops are not.

quoteMoniker

quoteMoniker quotes a validated moniker (valid UTF-8, no control characters): only '"' and '\\' need escaping.

writeJSONString

writeJSONString writes any string as a JSON string. Invalid UTF-8 bytes become U+FFFD. It costs gas per rune: use it only for short or unvalidated input.

writeStrings

candidate

candidate is a stored line split into its fields. Numbers stay in their canonical decimal text, which is valid JSON.

decode

byRank

sortedCandidates

sortedCandidates lists an edition's candidates by rank, then moniker (byte order), then operator.

latestSealed

scoreFields

scoreFields is \`"moniker":M,"total":T,"rank":R,"github":G\`, shared by both JSON shapes.

editionJSON

LatestJSON

LatestJSON returns the latest sealed edition, or "null".

EditionJSON

EditionJSON returns sealed edition n, or "null".

CandidateJSON

CandidateJSON returns the operator's entries across sealed editions, in edition order; "entries" is \[] for an unknown address.

OpenEditionJSON

OpenEditionJSON returns the open edition (number, scorecard hash and the operators already added, in the order added), or "null".

initialPublisher

formatHundredths

formatHundredths renders the canonical decimal "8743" as "87.43".

mdEscape

mdEscape backslash-escapes every ASCII punctuation character, so a moniker renders as plain text and never as an author-chosen link, image or HTML. gnoweb still turns a g1 address that follows a space into a link to its /u/ page, with the address itself as the link text.

Render

Render shows the latest sealed edition as a Markdown table. The path is ignored.

maxMonikerBytes

maxArenas

maxArenaName

maxScore

// 100.00 in hundredths: total and each arena score

maxGithub

// 10.00 in hundredths: the GitHub bonus

maxRank

isComputedAt

isComputedAt accepts a UTC date ("2026-10-13") or a UTC RFC 3339 time without fraction ("2026-10-13T09:00:00Z").

isSHA256Hex

parseArenas

parseArenas splits a comma-separated list of 1 to 16 distinct names made of \[a-z0-9\_-], each 1 to 32 bytes.

isMoniker

isMoniker rejects empty or oversized monikers, invalid UTF-8, ASCII and C1 control characters (U+0000-U+001F, U+007F, U+0080-U+009F), bidirectional control characters (U+202A-U+202E, U+2066-U+2069), surrounding spaces, and the separator and contact characters '|' and '@'. Zero-width and directional marks (U+200B-U+200F) stay allowed: emoji monikers use U+200D.

parseNat

parseNat parses a canonical non-negative decimal (no sign, no leading zero) not above max.

lineError

checkLine

checkLine validates "operator|moniker|total|rank|github|s1,...,sN" and returns the operator. Every number must be canonical, so a stored line can be copied into JSON as is.