moul/gno-contracts
September 4, 2026 · View on GitHub
moul's personal gno.land contracts — every p/moul/*
package and r/moul/* realm, developed in one place, versioned from day one,
self-contained (dependencies vendored), and continuously tested against
gno master.
This repository is the home for contracts that previously lived in the
gnolang/gno monorepo under examples/gno.land/{p,r}/moul/*. It is designed so
that a single git clone + a gno toolchain is enough to build, test, lint, and
publish everything.
Features
- Mandatory versioning — every contract is
.../<name>/vN; breaking changes ship as a newvN, never an in-place edit. Originals that no longer build on master are kept asignore = true(archived, 💤, skipped by CI) beside a portedvN+1. - Autonomous builds — external
gno.land/*deps are vendored; only the gno stdlibs come from the toolchain. One clone builds offline, independent of monorepo drift. - CI against gno master — every package is
gno lint-ed andgno test-ed on each PR;make syncreports drift from the upstream monorepo copies. - Self-maintaining catalog —
contracts.json+ the table below, every per-package README (docs + repo link + disclaimer + embedded dependency graph), and the_assets/graphs are regenerated after merge by a bot, so PRs carry only source and never conflict on generated files. - Dependency graphs — per-package and a global graph of everything, in
_assets/. - On-chain status — the table shows where each contract is published
(✅
/v1, 📦 un-versioned monorepo path), refreshed by a scheduled job. - PR bots — a sticky analysis report (new/updated packages, sizes, test
counts, ⚠️/🔥 signals), automatic path labels (
p/r/meta), and a live realm preview (below). - Publishing —
gnopublishqueries a network for what's missing, orders by dependency, and broadcasts (one tx per package or merged), asking your gnokey password once.
🖼️ Realm previews on every PR
When a PR touches a realm, a bot renders it with gnodev → static gnoweb and
publishes a browsable snapshot to https://moul.github.io/gno-contracts/pr-<N>/,
linked from a sticky PR comment — so reviewers can see the rendered output
without checking out the branch. The preview is removed when the PR closes.
(See tools/gnopreview.)
Layout
p/moul/<name>/v1/ pure packages → gno.land/p/moul/<name>/v1
r/moul/<name>/v1/ realms → gno.land/r/moul/<name>/v1
vendor/gno.land/... vendored dependencies (committed, autonomous)
tools/ Go maintenance CLI (manifest, readme, vendor, sync, publish)
contracts.json the contract catalog (source of truth for the table below)
gnowork.toml gno workspace marker (enables local package resolution)
Makefile test / lint / deps / gen / sync / publish
Versioning (mandatory)
Every contract lives under an explicit version segment: .../<name>/v1,
/v2, /v3, … There is no un-versioned contract. A breaking change ships as a
new vN directory; the old version keeps working for existing callers. This is
adopted from the very first commit so callers can always pin, and so drift from
the (un-versioned) monorepo copies can be tracked and bumped deliberately.
Autonomy (vendored dependencies)
gnowork.toml makes the whole repo one gno workspace, so gno.land/p/moul/*
imports resolve locally. External gno.land/* dependencies are copied into
vendor/gno.land/... (each with its gnomod.toml) by make deps, so the repo
resolves them without relying on $GNOROOT/examples. Only the gno stdlibs
come from the toolchain ($GNOROOT).
Usage
export GNOROOT=/path/to/gnolang/gno # a gno master checkout (stdlibs + gno binary)
make deps # vendor external dependencies into vendor/
make test # gno test every p/moul and r/moul package
make lint # gno lint every package
make gen # refresh contracts.json + the table below
make sync # report drift vs the monorepo (someone changed my contract?)
make publish # print dependency-ordered publish plan (-net/-check for status)
make upload ARGS="-net portal-loop -key mykey -dry-run ./..." # broadcast (gnopublish)
make help # list all targets
Contracts
📦 pkg · 🏛️ realm · 🚧 draft · 💤 archived (ignore = true in gnomod, skipped by CI; kept for reference, superseded by a later version).
Monorepo src vs our copy: 🟰 identical · ≈ identical .gno (meta differs) · 〜 identical .gno except tests · ✂️ .gno drifted.
On-chain status last checked: 2026-09-04T15:05:05Z (✅ = /v1, 🗄️ = un-versioned monorepo path).
The table is generated from contracts.json by
make readme; CI fails if it is stale (make check). Descriptions and upload
status are hand-authored/queried and preserved across regenerations.
Dependency graph
Whole-repo dependency graph (generated into _assets/ by
make graph; each package also has its own _assets/<pkgpath>/deps.svg):
Contributing / agents
This repo is built to be worked on by humans and coding agents alike. Start with
AGENTS.md (and CLAUDE.md, which points to it)
for the conventions: versioning, workspace/vendor model, how to add a contract,
and the invariants CI enforces.
License
See LICENSE — distributed under the GNO Network General Public
License, consistent with gnolang/gno.