PathrockNetwork Gno Explorer
HomeBlocksTransactionsTokensRealmsPackagesValidatorsAnalytics

PathrockNetwork Gno Explorer — an independent explorer for Gno.land Mainnet (gnoland-1), operated by PathrockNetwork. Not an official Gno.land service.

gnowebarchive RPC

gno.land/r/moul/x/allinone/devtools/v0

Realm
Open in gnoweb ↗

Overview

Kind
Realm (renderable)
Name
v0
Namespace
moul / x / allinone / devtools
Files
5 (README)(gnomod.toml)
Exported functions
3
Module
gno.land/r/moul/x/allinone/devtools/v0
gno
0.9

Files (5)

  • README.mdmarkdown
  • gnomod.tomltoml
  • devtools.gnogno
  • devtools_test.gnogno
  • zz_zerowidth_test.gnogno
README.mdPreviewRaw
# `gno.land/r/moul/x/allinone/devtools`

The worked example of wiring moul's developer packages into one realm: what a
new realm should copy.

Eight packages, each earning its place in the output:

| package | what it contributes |
|---|---|
| [`r/moul/config`](../../../config) | the notice block, the pause guard, which explorer to link |
| [`p/moul/mygnoscan`](../../../../p/moul/mygnoscan) | the explorer routes |
| [`p/moul/debug`](../../../../p/moul/debug) | the `?debug=1` panel |
| [`p/moul/realmpath`](../../../../p/moul/realmpath) | reading the render path |
| [`p/moul/kit/ui`](../../../../p/moul/kit/ui) | escaping caller input, and the tables |
| [`p/moul/md`](../../../../p/moul/md) | the markdown |
| [`p/moul/txlink`](../../../../p/moul/txlink) | the call links |
| [`p/moul/fifo`](../../../../p/moul/fifo) | the bounded note list |

## The three lines worth copying

```go
func Render(path string) string {
	return config.TopBlockFor(realmPath) + body + config.BottomBlockFor(realmPath)
}

func Add(cur realm, body string) {
	config.AssertWritableFor(realmPath)  // honours the pause switch
	notes.Append(ui.Inline(body))        // escapes what a caller typed
}
```

The first gives the realm a place for a warning and a pause banner without
shipping any banner code, and returns `""` while nothing is set, so a page that
concatenates it unconditionally is unchanged by default.

The second is two separate guards and both have to be there: the pause one so
an incident can stop writes from outside this realm and without a redeploy, and
the escaping one because a string a caller typed is the oldest way to break a
page.

## Two views

`Render("")` is the root and is free of anything that moves, so an example test
can pin it. Everything live (the height, the chain id, the links built from
them) is under `:chain`, which is also what keeps the pinned output stable.

State is disposable: the note list is bounded by `fifo` at 10 entries and this
realm is `private = true`, so a redeploy wipes it on purpose.

<!-- BEGIN GNOCONTRACTS FOOTER (generated by `make readmes`; do not edit below) -->

---

Part of **[moul/gno-contracts](https://github.com/moul/gno-contracts)** — moul's versioned gno.land contracts. See the repository for the full catalog, build/test tooling, and usage.

**Dependency graph:**

![gno.land/r/moul/x/allinone/devtools/v0 dependency graph](https://raw.githubusercontent.com/moul/gno-contracts/main/_assets/gno.land/r/moul/x/allinone/devtools/v0/deps.png)

> 🧪 **Highly experimental — potentially vibe-coded.** Not audited; may break, change, or be removed at any time. Do not use with anything of value. Full disclaimer: [DISCLAIMER](https://github.com/moul/gno-contracts/blob/main/DISCLAIMER.md).

<!-- END GNOCONTRACTS FOOTER -->

Functions

  • Add(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string}, body string)

  • Render(path string) string

  • Reset(cur interface {.seal func(); Address func() .uverse.address; IsCode func() bool; IsCurrent func() bool; IsEphemeral func() bool; IsUser func() bool; IsUserCall func() bool; IsUserRun func() bool; PkgPath func() string; Previous func() .uverse.realm; String func() string; Sub func(string) .uverse.realm; Subpath func() string})

Signatures reconstructed verbatim from vm/qfuncs — interface params keep their inline definitions.

Rendered

RenderedRawgnoweb ↗

vm/qrender output, sanitized (docs/render-security.md) and displayed in an empty-sandbox iframe — scripts, forms and popups cannot run. Links stay inert in-preview; right-click to open.