> ## 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.

# Chi Name Service

> Give your Gotchipus a unique on-chain identity

## 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

| Rule             | Details                                                   |
| ---------------- | --------------------------------------------------------- |
| **Length**       | 5 to 32 characters                                        |
| **Characters**   | Lowercase letters (`a-z`), numbers (`0-9`), hyphens (`-`) |
| **Restrictions** | No uppercase, no spaces, no leading/trailing hyphens      |
| **Uniqueness**   | First 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.

| Feature              | Details                                             |
| -------------------- | --------------------------------------------------- |
| **Who can register** | Any Gotchi owner (for their own Gotchi)             |
| **Cost**             | Free                                                |
| **Duration**         | Permanent — no renewal required                     |
| **Limit**            | One name per Gotchipus                              |
| **Transferable**     | No — the name is bound to the Gotchi, not the owner |
| **Changeable**       | Yes — 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.

<Note>
  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.
</Note>

## Phase 2: Public Names (Coming Soon)

A future phase will open `.chi` names to the broader ecosystem:

| Feature          | Phase 1 (Current)  | Phase 2 (Future)       |
| ---------------- | ------------------ | ---------------------- |
| **Who**          | Gotchi owners only | Anyone                 |
| **Cost**         | Free               | Priced by name length  |
| **Duration**     | Permanent          | Annual renewal         |
| **Transferable** | No (Gotchi-bound)  | Yes (standard ERC-721) |
| **Resolves to**  | Gotchi's TBA       | Any 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

<CardGroup cols={2}>
  <Card title="TBA" icon="wallet" href="/ai-and-autonomy/tba">
    How your Gotchipus's Token-Bound Account works
  </Card>

  <Card title="Chi Architecture" icon="hexagon" href="/architecture/chi-diamond">
    Technical details of the ChiDiamond contract
  </Card>
</CardGroup>