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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.molt.id/getting-started/ai-agent-tokens.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.