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.

toolbox package

Overview

Package toolbox is the directory of moul's small gno.land utilities: one page listing every tool, each tool a realm of its own at `r/moul/toolbox/<slug>`.

It holds no logic. A tool composes other contracts (resolve a username, read a DAO, decode a denom) and renders the answer; this realm only says which tools exist and where they are. The model, the rendering and the query-form builder are p/moul/toolbox(/p/moul/toolbox/v0).

Why the catalog is compiled in and not registered

The obvious design is the opposite one: each tool calls `Register` on this realm from its own init, and the directory assembles itself. That design is unavailable here, and the reason is worth stating because it is not a preference.

`private = true` buys redeploy-in-place at the same path and costs the ability to be imported: the type checker refuses any realm importing a private one (`ImportPrivateError`, `gnovm/pkg/gnolang/gotypecheck.go`). So a private hub cannot be imported by its tools, and a hub that accepts registration has to be public. A public realm can never be redeployed, which would freeze this path at v0 and move the directory's URL on the first bug in it.

A stable URL is the whole point of a directory, so the trade goes the other way: everything here is private and redeployable, and adding a tool is one entry in [tools] plus a redeploy. The catalog is rebuilt from source every time, so the redeploy wipe costs nothing: there is no state to lose.

p/moul/toolbox.Catalog stays mutable for whoever wants the other trade.

Functions

Count

func Count() int
Ask AI Claude ChatGPT

Count is how many tools the directory holds.

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.Count()"

Result

DescOf

func DescOf(slug string) string
Ask AI Claude ChatGPT

DescOf returns the one-line description of one tool, or "".

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.DescOf()"

Result

Has

func Has(slug string) bool
Ask AI Claude ChatGPT

Has reports whether a tool with that slug is listed.

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.Has()"

Result

PathOf

func PathOf(slug string) string
Ask AI Claude ChatGPT

PathOf returns the package path of one tool, or "" when there is no such tool. Flat strings rather than the struct: a nested value inside a persisted object prints as an opaque `ref(...)` over `vm/qeval`, so a read API that is meant to be queried returns scalars.

Example
1gnokey query vm/qeval -data 'gno.land/r/moul/toolbox.PathOf("usernames")'

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.PathOf()"

Result

Render

func Render(path string) string
Ask AI Claude ChatGPT

Render routes gnoweb paths:

Example
1/                 the directory
2/?tag=identity    the directory, filtered to one tag
3/<slug>           one tool

Param

Command

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

Result

Slugs

func Slugs() []string
Ask AI Claude ChatGPT

Slugs lists every tool's slug, in directory order.

Example
1gnokey query vm/qeval -data 'gno.land/r/moul/toolbox.Slugs()'

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.Slugs()"

Result

Tags

func Tags() []string
Ask AI Claude ChatGPT

Tags lists every tag any tool carries, each once.

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.Tags()"

Result

TitleOf

func TitleOf(slug string) string
Ask AI Claude ChatGPT

TitleOf returns the human name of one tool, or "".

Param

Command

gnokey query vm/qeval -remote "https://rpc.onyx.testnets.gno.land" -data "gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox.TitleOf()"

Result

Gno Expression Evaluator

Evaluate any read-only Gno expression against gno.land/r/g1magld5ptgzaktqcexxq0pgq5lmdf0kz6re8hlv/toolbox, for example a function call with arguments.