> For the complete documentation index, see [llms.txt](https://docs.molt.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.molt.id/getting-started/ai-agent-tokens.md).

# AI Agent Tokens

## How to Deploy an AI Token

A quick guide to launching a bonding curve token tied to your `.molt` domain agent on Solana mainnet.

{% hint style="info" %}
Molt fees will be 0.3% once all delegated services are live. Current fee is 0%.
{% endhint %}

### What you get

Every `.molt` domain can back exactly one AI Token (Per each Bonding Program) — a bonding curve token launched through Metaplex Genesis whose creator fees flow to your Agent PDA. Holders trade the token on Metaplex; your agent earns **0.6%** of every buy and sell as wSOL in its own wallet.

* **Bonding curve**: constant-product AMM. Price rises as people buy, falls as they sell.
* **Fee wallet**: your Agent PDA (the Core Asset Signer derived from your `.molt` NFT).
* **Graduation**: when the curve sells out, liquidity migrates to Raydium automatically.
* **Post-graduation**: fees continue from Raydium LP trading.

***

### Prerequisites

Before you can launch, make sure you have:

1. A **Solana wallet** with at least **0.05 SOL** on mainnet (Phantom, Solflare, Backpack).
2. At least one **`.molt` domain** minted to that wallet. You can buy one at `app.molt.id`.
3. An **agent identity registered** on that domain (see next section).

***

### Step 1 — Register the agent identity

Bonding curve launches require an on-chain `AgentIdentity` account tied to your domain's NFT. Only the molt.id collection authority can create these, but you request one from the UI:

1. Open **My Domains** from the top navigation.
2. Expand the domain you want to launch a token for.
3. Scroll to the **Metaplex Agent Registry** section.
4. Fill in the agent metadata (name, description, skills) and click **Register Agent**.
5. Approve the transaction in your wallet.

Once the transaction confirms, the domain is launch-ready. You only have to do this once per domain.

<figure><img src="/files/YQVQWtfngszj2dnudnL1" alt=""><figcaption></figcaption></figure>

> If you try to launch a token on a domain without a registered identity, the UI will refuse with a message pointing you back here.

***

### Step 2 — Open the AI Tokens page

Click **AI Tokens** in the top navigation. The page lists every `.molt` domain you own and shows which ones already have a token launched.

* **No token yet** → shows a **Launch Token** form.
* **Token already launched** → shows the **Agent Token Dashboard** with live curve state.

Expand the domain you want to launch on.

***

### Step 3 — Fill in the launch form

Required fields:

| Field            | Notes                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------- |
| **Token Name**   | 1–32 chars. Defaults to `<domain>.molt`.                                                      |
| **Token Symbol** | 1–10 chars, uppercase. Defaults to the first 10 chars of the domain.                          |
| **Description**  | Shown on the Metaplex token page.                                                             |
| **Token Image**  | Defaults to your domain NFT image. You can upload a custom image (max 5 MB; PNG/JPG/SVG/GIF). |

Optional fields:

| Field                            | Notes                                                                                                              |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **First Buy Amount**             | Amount of SOL to buy your own token in the same transaction as the launch. Fee-free. Useful for seeding liquidity. |
| **Website / Twitter / Telegram** | Displayed on the Metaplex token page.                                                                              |
| **Set Token Permanently**        | ⚠️ Irreversible. If checked, this token is permanently bound to the agent. Only enable if you're sure.             |

<figure><img src="/files/2VrPYXcx4VsiWaJncoJ1" alt=""><figcaption></figcaption></figure>

***

### Step 4 — Launch

Click **Launch Token**. The UI walks through several steps, asking your wallet to sign along the way:

1. **Check agent identity** — verifies the domain is registered.
2. **Upload token image** — if you picked a custom image, it's uploaded to Irys.
3. **Create bonding curve** — the server builds three Genesis transactions (init, bucket, finalize).
4. **Sign transactions** — your wallet prompts you to sign all three at once.
5. **Send and confirm** — each transaction is sent in order; the UI polls for confirmation.
6. **Register on Metaplex** — the launch is recorded on `metaplex.com` so it's searchable.
7. **Set up token agent** — a dedicated Multiclaw container is provisioned for the new token's AI agent.

The whole flow takes about **30–60 seconds** depending on network conditions. You'll see toast notifications at each step.

<figure><img src="/files/QX76PChAupvXDgbY3QkT" alt=""><figcaption></figcaption></figure>

> **Heads up:** mainnet token launches cost roughly **0.015–0.025 SOL** in rent and fees. The wallet prompt will show the exact amount before you sign.

***

### Step 5 — Success

On success you'll see the launch result card with:

* **Mint address** of the new token
* **Trade on Metaplex** button (links directly to the live bonding curve)
* Confirmation that the token agent container is running

The token is now live. Anyone can trade it through Metaplex immediately.

***

### The Agent Token Dashboard

Once a token is launched, revisit the AI Tokens page to see the live dashboard:

The dashboard shows:

| Section                | What it tells you                                                             |
| ---------------------- | ----------------------------------------------------------------------------- |
| **Curve state**        | Fill percentage, whether the token is still swappable, graduation status      |
| **SOL raised**         | Total SOL deposited into the curve                                            |
| **Virtual reserves**   | Current virtual SOL and token values used by the AMM pricing                  |
| **Creator Fees**       | Lifetime earned, already claimed, and claimable now                           |
| **Agent PDA Treasury** | Native SOL, wSOL (from claimed fees), and own-token holdings in the Agent PDA |
| **Trade on Metaplex**  | Direct link to the Metaplex token page                                        |
| **Open Agent Chat**    | Opens the token's dedicated AI agent chat in a new tab                        |

#### Claiming creator fees

Every trade on your bonding curve accrues **0.6% creator fees** in wSOL. When the claimable amount is greater than zero, a green **Claim X SOL** button appears under the Creator Fees section.

Click it. The server signs a permissionless `claimBondingCurveCreatorFeeV2` instruction and the fees settle to your Agent PDA's wSOL account within a few seconds. No wallet signature required — the instruction is permissionless, so the server can sign it for you.

After a successful claim:

* `creatorFeeClaimed` increases by the claimed amount.
* The **wSOL** row under **Agent PDA Treasury** grows by the same amount.
* The claim button disappears until more fees accrue.

<figure><img src="/files/mMc5LZopkQIspvlgVQ0B" alt=""><figcaption></figcaption></figure>

***

### The token's AI agent

Every token launch provisions a dedicated AI agent container on Multiclaw. This agent:

* Knows its own token mint, PDA, and curve state.
* Can read live curve data by calling `/api/token-curve/:mint`.
* Has the full **Metaplex skill** pre-installed (Genesis, Agent Registry, Core NFTs).
* Can answer trading, fee, and graduation questions about its own token.

Click **Open Agent Chat** on the dashboard to start a conversation. The first message wakes up the container; subsequent messages hit an already-running process.

Example questions the agent can answer:

* "How much SOL have you raised?"
* "What's your current fill percentage?"
* "How much in creator fees do you have unclaimed?"
* "What's your wallet address?"
* "How do I buy your token?"

***

### Troubleshooting

**"This domain does not have an agent identity registered yet"** → You skipped Step 1. Go to My Domains → Metaplex Agent Registry and register first.

**"Upload a token image (or use this domain's NFT image)"** → Your domain has no NFT image metadata and you didn't upload a custom one. Upload one before launching.

**Wallet rejects transaction with "insufficient funds"** → You need roughly 0.05 SOL in the connected wallet to cover rent + fees.

**Launch succeeds but "Registering on Metaplex" fails** → Non-fatal. The token is already live on-chain and tradable. The Metaplex listing link may be missing — you can still trade by searching the mint address directly on `metaplex.com`.

**Claim button doesn't appear even though the curve has trading activity** → Refresh the page to re-read curve state. The dashboard caches the last fetch.

**Agent chat loads but says "I don't know my token"** → The container restored a stale snapshot. Open the dashboard, click the agent button again — the container will reboot and reinstall the token skill.

***

### Links

* Metaplex token explorer: <https://www.metaplex.com/>
* Your domains: `app.molt.id/domains`
* AI Tokens page: `app.molt.id/ai-tokens`