Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gotchipus.com/llms.txt

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

​
Your Gotchipus Deserves a Name

Every Gotchipus can claim a unique .chi domain name — a permanent, on-chain identity tied to its soul. When you register alice.chi, your Gotchipus becomes discoverable, addressable, and gets its own living homepage at alice.chi.page. This isn’t just a display name. It’s an ERC-721 NFT that resolves to your Gotchipus’s Token-Bound Account, enabling anyone to find and interact with your companion by name instead of a hex address.

​
How It Works

Guardian registers "alice" for Gotchi #42
    ↓
ChiDiamond mints an ERC-721 NFT (Chi Name token)
    ↓
"alice.chi" resolves to Gotchi #42's TBA address
    ↓
alice.chi.page displays a living homepage for Gotchi #42
The Chi Name Service is a separate Diamond contract — independent from the main Gotchipus Diamond but linked to it. This means chi names have their own NFT collection, their own marketplace presence, and can evolve independently.

​
Naming Rules

RuleDetails
Length5 to 32 characters
CharactersLowercase letters (a-z), numbers (0-9), hyphens (-)
RestrictionsNo uppercase, no spaces, no leading/trailing hyphens
UniquenessFirst come, first served — globally unique
Suffix.chi (added automatically)
Valid: alice, gotchi-42, deep-sea-guardian Invalid: Alice (uppercase), ab (too short), -bob (leading hyphen)

​
Phase 1: Gotchi Names

The current phase is designed for simplicity — your Gotchipus gets a name, permanently and for free.
FeatureDetails
Who can registerAny Gotchi owner (for their own Gotchi)
CostFree
DurationPermanent — no renewal required
LimitOne name per Gotchipus
TransferableNo — the name is bound to the Gotchi, not the owner
ChangeableYes — register a new name to replace the old one
When you register a name, the old one (if any) is automatically released and becomes available for others.
Chi names are Gotchi-bound, not wallet-bound. If you transfer your Gotchipus NFT to another wallet, the new owner can register a new name — but the old name is released, not transferred with the Gotchi.

​
Phase 2: Public Names (Coming Soon)

A future phase will open .chi names to the broader ecosystem:
FeaturePhase 1 (Current)Phase 2 (Future)
WhoGotchi owners onlyAnyone
CostFreePriced by name length
DurationPermanentAnnual renewal
TransferableNo (Gotchi-bound)Yes (standard ERC-721)
Resolves toGotchi’s TBAAny address

​
Resolution

Chi names resolve bidirectionally:
  • Forward: alice.chi → 0x1234...abcd (TBA address)
  • Reverse: Gotchi #42 → alice.chi
Forward resolution is dynamic — if the Gotchi’s TBA address changes, the name automatically points to the new address. No manual updates needed.

​
chi.page — Your Gotchipus’s Homepage

Every registered .chi name gets a live homepage at {name}.chi.page. This page displays:
  • Your Gotchipus’s appearance with equipped wearables
  • Real-time vital signs (health, energy, morale, focus)
  • Attributes and stats radar chart
  • Wallet holdings and transaction history
  • Social links and AI agent status
Share your link — alice.chi.page — on social media, and the preview card dynamically shows your Gotchipus’s current state.

​
Chi Name as an NFT

Each registered .chi name is minted as an ERC-721 token in the Chi Name Service collection:
  • Viewable in any NFT wallet or marketplace
  • Metadata includes the domain name, registration date, and linked Gotchi
  • tokenURI points to chi.page/api/metadata/{name} for rich metadata
  • Phase 2 names will be fully tradeable on NFT marketplaces

TBA

How your Gotchipus’s Token-Bound Account works

Chi Architecture

Technical details of the ChiDiamond contract