Skills
Chapter 5 of 20
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.
1 minute · 212 words · 5 sections
CNS maps human-readable names (like convex.fungible) to on-chain addresses.
See the convex-lisp skill for CVM conventions.
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:
java -jar convex.jar client query '@convex.fungible'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:
;; 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*/change-control 'my.name #NEW-CONTROLLER)These are transactions (they change state). Notes:
(*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).(*registry*/register {:name "..."}) is unrelated — it registers
metadata for the caller’s own account, not a CNS name.@convex.fungible in CVM source resolves to the actor address at runtime(@convex.fungible/balance #TOKEN #USER) calls balance on the resolved actor| 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.)
Install this repository
npx skills add Convex-Dev/convexSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
develop, last pushed 10 August 2026.SKILL.md, not by matching a directory convention. One layout observed: .claude/skills/*/SKILL.md.h1 and no skipped levels:/Convex-Dev/convex.md, and each chapter at its own .md URL.