Skip to main content

Name Service (.ritual)

The Cat Wallet Name Service lets users replace complex wallet addresses with human-readable names ending in .ritual.

Contract

ContractAddress
RitualNameService0x105E7352B8631b45811cFC1D39F1d3049aaC0979

Registration

  1. Navigate to the Identity tab.
  2. Enter your desired name (e.g. alice) — the .ritual suffix is appended automatically.
  3. If the name is available, click Register and confirm the transaction.
  4. Registration is free — the register function is not payable. You only pay gas.

Managing Names

Once registered:

  • Globally resolvable across the Cat Wallet ecosystem.
  • Other users can type alice.ritual in the Send tab instead of your address.
  • Your name is displayed at the top of the dashboard and in the Receive tab.

Technical Details

PropertyDetails
UniquenessContract enforces global uniqueness
One per walletEach address may register exactly one name permanently
TransferNot supported
CostFree (gas only)
Forward resolutionresolve(string name) → address
Reverse resolutionreverseLookup(address) → string

Developer Usage

const ns = new ethers.Contract(
'0x105E7352B8631b45811cFC1D39F1d3049aaC0979',
[
'function resolve(string name) view returns (address)',
'function reverseLookup(address addr) view returns (string)',
'function register(string name) external',
],
provider
);

const addr = await ns.resolve('alice'); // forward
const name = await ns.reverseLookup(addr); // reverse