Skip to content

Convex-Dev/convex / .claude/skills/cns

Resolve or register Convex Name System (CNS) names. Use when the user wants to look up a CNS name, register a new name, or update a name's target.

FileKindSize
SKILL.mdskill md2.6 KB
---
name: cns
description: Resolve or register Convex Name System (CNS) names. Use when the user wants to look up a CNS name, register a new name, or update a name's target.
argument-hint: "[resolve|register|update] <name>"
---

# Convex Name System (CNS)

CNS maps human-readable names (like `convex.fungible`) to on-chain addresses.

See the `convex-lisp` skill for CVM conventions.

## Resolve a Name

In CVM source, `@convex.fungible` resolves the name directly — this is the
normal way to reach a library.

To inspect a name's record (value, controller, metadata, child node), use a
Convex MCP server's `resolveCNS` tool if one is configured. Otherwise query it:

```bash
java -jar convex.jar client query '@convex.fungible'
```

## Register or Update a Name

The registry actor is `#9`, available in CVM code as `*registry*`. It has no
`cns-update` function — use `create` for a new name and `update` for an
existing one:

```clojure
;; Create a new name pointing at a target, with *address* as controller
(*registry*/create 'my.name #TARGET *address*)

;; Update an existing name you control
(*registry*/update 'my.name #NEW-TARGET)

;; Change who controls a name
(*registry*/control 'my.name #NEW-CONTROLLER)
```

These are transactions (they change state). Notes:

- **Creating requires controlling the parent namespace.** `(*registry*/create
  'my.name ...)` needs the `my` node to exist and to trust you — otherwise it
  fails with `:TRUST` "Forbidden to create CNS node". Top-level names require
  special authority.
- `create` also accepts optional controller, metadata and child arguments:
  `(*registry*/create 'my.name target controller metadata)`.
- Note `(*registry*/register {:name "..."})` is unrelated — it registers
  metadata for the *caller's own account*, not a CNS name.
- The registry also defines `change-control`, but it is the scoped `:callable`
  SPI variant (path taken from `*scope*`) — not called directly with a symbol;
  use `control`.

## CNS in Code

- `@convex.fungible` in CVM source resolves to the actor address at runtime
- Use CNS paths instead of hardcoded addresses for portable code
- `(@convex.fungible/balance #TOKEN #USER)` calls `balance` on the resolved actor

## Common CNS Names

| Name | Purpose |
|------|---------|
| `convex.fungible` | Fungible token standard library |
| `convex.trust` | Trust and access control |
| `convex.asset` | Generic asset interface |
| `asset.nft.simple` | Non-fungible token standard |
| `asset.multi-token` | Multi-token standard |

(Resolve with `(*registry*/resolve 'name)` to get the current address — these
are network-specific.)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall