# `gno.land/r/moul/x/pairreg/v0`

The registry every AMM pair instance announces itself to, and the unified
frontend over all of them. Third artifact of the instance-per-realm pattern; the
logic is in [`p/moul/x/pair/v0`](../../../../p/moul/x/pair/v0).

- **Registration is one line in an instance's `init`**, so a single `addpkg`
  both creates a pair and lists it.
- **The key is the caller's own package path**, taken from
  `cur.Previous().PkgPath()`, so an instance cannot claim a path that is not its
  own.
- **Entries hold a live `*pair.Pair`**, not an address, so `Render` shows every
  instance's real reserves from one `vm/qrender`. No indexer, no multicall.
- **Permissionless**, and spam is self funded: the registering transaction pays
  for the storage it adds.

## What it cannot tell you

Nothing on chain can read a package's source, so the registry cannot check that
an instance runs the shared template. Reserves shown in the index are **claimed**.
Several instances may exist for the same couple, on purpose: there is no
canonical pair and no factory to enforce one. Verify an instance by diffing its
source (`vm/qfile`) against freshly generated output before funding it.

<!-- 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/pairreg/v0 dependency graph](https://raw.githubusercontent.com/moul/gno-contracts/main/_assets/gno.land/r/moul/x/pairreg/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 -->