Name Service (.ritual)

The Cat Wallet Name Service allows users to replace their complex hexadecimal wallet addresses with human-readable domain names ending in .ritual.

Registration

To claim your identity on the Ritual Chain:

1. Navigate to the Identity tab.
2. Enter your desired name in the search bar (e.g., alice). And the .ritual suffix is appended automatically.
3. If the name is available, then the "Register" button will become active.
4. Click Register and confirm the transaction in your wallet. Registration itself is free – also the register function is not payable, so the only cost is the network's gas fee.

Managing Names

Once a name is registered:

• It becomes globally resolvable across the Cat Wallet ecosystem.
• Other users can type your name (e.g., alice.ritual) into the Send tab instead of copy-pasting your address.
• Your primary .ritual name will be displayed at the top of the dashboard and in the Receive tab.

Technical Details

The Name Service is powered by the RitualNameService smart contract.

• Storage: Names are mapped to addresses and vice versa in mapping structures.
• Uniqueness: The contract enforces global uniqueness. Once a name is registered, it cannot be claimed by another address.
• One per wallet: Each address may register exactly one identity, permanently – the contract rejects a second register call from the same address (already registered). There's no way to register a second name or transfer a name to a different address for now.
• Free to register: register is not payable and there is no protocol fee, only the gas cost of the transaction.
• Reverse Resolution: The contract supports reverse lookups, allowing the UI to instantly display a user's name if they have one linked to their connected address.