Skip to content Search Apps Documentation Source Content 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.

maintainer/v0 package

Overview

Package maintainer models an AI agent stewarding a versioned on-chain package — without ever letting it deploy on its own authority.

The agent can do the tedious, valuable parts: open a version proposal, collect reviews, record CI test attestations, write release notes, deprecate a vulnerable version, keep a compatibility matrix. What it cannot do is ship. Approval is gated by an explicit, machine-checked policy:

Example
1tests pass  AND  ≥ MinReviewers independent reviews  AND
2every review scores ≥ MinScore  AND  the challenge window has elapsed

This is the difference between "an agent with commit access" and "an agent that drives a process a human (or a DAO, or a policy) still gates." The realm records *approved* releases; the actual package publish is a separate, deliberately human/authority step.

Functions

AddReview

func AddReview(cur realm, propID uint64, score uint8, note string)
Ask AI Claude ChatGPT

AddReview records a reviewer's score. Reviewers must be independent of the proposer, and each address reviews at most once.

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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "AddReview" -args $'' -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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "AddReview" -args $'' -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

Approve

func Approve(cur realm, propID uint64)
Ask AI Claude ChatGPT

Approve promotes a proposal to a release iff every policy condition holds. It panics with the first unmet condition — the policy is the gate, not a suggestion.

Param

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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Approve" -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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Approve" -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

AttestTests

func AttestTests(cur realm, propID uint64, pass bool)
Ask AI Claude ChatGPT

AttestTests records whether CI's test suite passed for the proposal.

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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "AttestTests" -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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "AttestTests" -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

Deprecate

func Deprecate(cur realm, version, reason string)
Ask AI Claude ChatGPT

Deprecate flags a released version (e.g. a vulnerability was found).

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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Deprecate" -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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Deprecate" -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

IsDeprecated

func IsDeprecated(version string) bool
Ask AI Claude ChatGPT

IsDeprecated reports whether a released version is deprecated.

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0.IsDeprecated()"

Result

LatestVersion

func LatestVersion() string
Ask AI Claude ChatGPT

LatestVersion returns the most recently released version, or "".

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0.LatestVersion()"

Result

Propose

func Propose(cur realm, version, artifactHash string, challengeBlocks int64) uint64
Ask AI Claude ChatGPT

Propose opens a version proposal with a challenge window of the given number of blocks (during which reviews accrue and approval is blocked).

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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Propose" -args $'' -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/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0" -func "Propose" -args $'' -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

Render

func Render(path string) string
Ask AI Claude ChatGPT

Render shows the release matrix + open proposals, or one proposal at :<id>.

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0.Render()"

Result

GetProposal

func GetProposal(id uint64) Proposal
Ask AI Claude ChatGPT

GetProposal returns a copy of a proposal.

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/agents/maintainer/v0.GetProposal()"

Result