store state

DELAY

// seconds of block time

maxKey

The bounds of every call: none can be made to run, or to store, unbounded.

maxValue

The bounds of every call: none can be made to run, or to store, unbounded.

maxPage

The bounds of every call: none can be made to run, or to store, unbounded.

maxOps

The bounds of every call: none can be made to run, or to store, unbounded.

maxName

The bounds of every call: none can be made to run, or to store, unbounded.

self

writer

proposed

at

paused

owner

pending

colls

standard

the collections v2 keeps its data in, made at deploy: a first save never pays a whole new tree

init.15

seeded

seeded is a collection whose first leaf the deployer pays, not its first player: its key "", which no write can make (checkKey) and no read shows, sorts before every other.

Writer

Writer is the realm whose writes store takes now: the proposed one once its delay is over ("" while paused).

matured

Proposed

Proposed is the writer proposed and when it takes over (unix seconds; 0 while its code has not called Ready), or "" and 0.

settle

settle makes a proposed writer whose delay is over the writer, as it is already for every read (Writer).

Owner

gate

gate lets the writer through, and only it: the immediate caller's pkgpath, never the signer (an account, a MsgRun script or another realm is refused). A proposed writer whose delay is over becomes the writer at its first write.

onlyOwner

Propose

Propose names the next writer, a realm's pkgpath under gno.land/r/. Only the owner can; a new proposal replaces the last. Its delay starts when that realm, on chain, calls Ready: its code can then be read, as it will run.

Ready

Ready is the proposed writer's own call, once it is on chain: it takes over DELAY later, with no transaction to send. Only that realm can, once.

validPkgPath

validPkgPath is golf v1's: gno.land/r/, up to 100 of a-z, 0-9 and \_-/., no "", "." or ".." segment.

Cancel

Cancel drops the proposed writer before it takes over. Only the owner can.

Pause

Pause stops every write at once (the reads go on), and drops any proposal. Only the owner can: for a bug in the rules, or one feared. Resume starts the same rules again at once; new rules take their delay.

Resume

Resume starts again, at once, the rules a Pause stopped: their code was in force already, so nothing new runs. Only the owner can.

drop

drop forgets a proposal not in force, and says so.

Transfer

Transfer offers the owner's role, which the address offered takes with Accept.

Accept

Accept takes the role offered.

Renounce

Renounce gives the role up for good: the writer can then never change, nor be paused; a proposal not yet in force is dropped. Only the owner can, and not while paused: no rules could ever write again.

coll

checkKey

set

(a string is a value: what store keeps is its own, never the caller's slice)

Set

Set keeps value under key in a collection. The writer only.

Remove

Remove drops a key from a collection, reporting whether it was there. The writer only.

Batch

Batch applies a save's writes in one call: ops is "set", collection, key, value or "del", collection, key, "" (four strings an op), at most 64 ops. A transaction is all or nothing: a bad op undoes the whole batch.

Make

Make adds a collection, for rules that need one more. The writer only.

Get

Get is a key's value in a collection, and whether it is there.

Has

Has reports whether a collection holds a key.

Size

Size is how many keys a collection holds.

Index

Index is how many keys of a collection sort before key: its place, from 0 (O(log n) a step of a binary search, as golf v1's boards).

At

At is the key and value at a place in a collection's order.

Page

Page is up to limit keys of a collection from start (included) to end (excluded; "" to its end), in order, as rows one after another: each the key's length, ":", the key, the value's length, ":", the value (no separator to escape: the lengths say where each ends). limit is 1 to 300.

PageBack

PageBack is Page from end (kept, as bptree's back walk) down to start.

PageAt

PageAt is up to limit keys from the offset-th of a collection (from 0), as Page's rows.

page

row

row writes one key and its value into a page.

Render

Render says who writes, what is proposed and who may change it.