Skip to main content

Documentation Index

Fetch the complete documentation index at: https://celonames.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

This skill teaches your agent how to register, renew, transfer, and manage .celo.eth names on Celo Mainnet. It covers availability checks, pricing, record updates, and primary name setup — all via the L2Registrar contracts.

​
Install

npx skills add thenamespace/skills --skill celonames

​
What it covers

  • Availability checks — look up whether a .celo.eth name is registered or free
  • Pricing — fetch current registration and renewal costs from the L2Registrar
  • Registration — register a name for a given address and duration
  • Renewals — extend the expiry of an existing name
  • Transfers — move ownership of a name to another address
  • Record updates — set ETH address, avatar, social handles, and custom text records
  • Primary name setup — configure a reverse record so the name resolves back to a wallet

​
How it works

Once installed, the skill gives your agent the context it needs to call the Celo Names contracts directly. It includes:
  • Contract addresses for Celo Mainnet
  • ABI fragments for the L2Registrar, Controller, and Resolver
  • Step-by-step reasoning patterns for each operation
  • Error handling guidance (expired names, insufficient funds, invalid labels)

​
Example prompts

After installing, your agent can handle prompts like:
“Check if alice.celo.eth is available and tell me the price to register it for 1 year.”
“Register myagent.celo.eth to 0xABC... for 2 years.”
“Set the avatar record for bob.celo.eth to https://example.com/avatar.png.”
“What is the primary name for 0x1234...?”