> ## Documentation Index
> Fetch the complete documentation index at: https://docs.binibit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Spawn Flow
> Step-by-step from tapping Spawn to a fully listed and managed Agent Token.
## What spawn triggers (the agent handoff)
One transaction triggers a chain of automatic events across **three subsystems**: Launchpad, BaiDEX, and Agent Hive. The Hive picks up your token automatically — no follow-up actions needed.
```mermaid theme={null}
flowchart TB
User((User taps Spawn))
Pay["Pays BINI fee
(burned)"]
subgraph LP["AgentT Launchpad"]
Spawner["HiveSpawner
contract"]
Token["Agent Token
(ERC-20)"]
Registry["HiveRegistry
NFT minted"]
end
subgraph DEX["BaiDEX"]
Pool["Agent Pool
V3 pool created
(wBINI or USBI side)"]
end
subgraph Hive["Agent Hive"]
Worker["Agent Worker
auto-assigned"]
Swarm["Joins active Swarm"]
Scouts["Agent Scouts
begin watching"]
Queens["Agent Queens
factor into strategy"]
end
User --> Pay
Pay --> Spawner
Spawner -- "deploys" --> Token
Spawner -- "mints NFT" --> Registry
Spawner -- "creates" --> Pool
Spawner -- "assigns" --> Worker
Worker --> Swarm
Swarm -- "reports activity" --> Scouts
Scouts -- "patterns + flags" --> Queens
Queens -. "strategy signals" .-> Scouts
Scouts -. "tactical signals" .-> Worker
classDef user fill:#fce7f3,stroke:#db2777,color:#831843
classDef burn fill:#fef2f2,stroke:#ef4444,color:#7f1d1d
classDef chain fill:#e0f2fe,stroke:#0284c7,color:#0c4a6e
classDef pool fill:#dcfce7,stroke:#16a34a,color:#14532d
classDef hive fill:#fef9c3,stroke:#ca8a04,color:#713f12
class User user
class Pay burn
class Spawner,Token,Registry chain
class Pool pool
class Worker,Swarm,Scouts,Queens hive
```
The user's only action is **tap Spawn + pay the fee**. Everything else happens automatically in one transaction (the Spawner contract orchestrates) plus async pickup by the Hive (Workers warm up, Scouts notice, Queens absorb into strategy on their next iteration).
## End-to-end
```mermaid theme={null}
sequenceDiagram
actor User
participant UI as Launchpad UI
participant Spawner as HiveSpawner
participant Token as Agent Token (ERC-20)
participant Pool as BaiDEX V3 Pool
participant Hive as Agent Hive
User->>UI: Fill name / symbol / params
UI->>UI: Validate (anti-spam, params)
User->>Spawner: Pay spawn fee in BINI
Spawner->>Spawner: Burn fee
Spawner->>Token: deploy ERC-20
Token->>Spawner: emit Spawned(token, owner)
Spawner->>Pool: createPool(token, wBINI or USBI)
Spawner->>Hive: assignWorker(token)
Hive->>Hive: Worker joins active Swarm
Spawner-->>UI: Return Agent Token address
UI-->>User: Show pool URL + manage page
```
## Step 1 — fill the form
The Launchpad UI asks for:
* **Name** (e.g., "PepeAgent")
* **Symbol** (e.g., "PEPEA", 3-5 chars)
* **Supply** (default 1B; configurable per project)
* **Decimals** (default 18, ERC-20 standard)
* **Pool side** (default USBI; can choose wBINI if available)
* **Description / metadata** (optional, indexed for the Launchpad explorer)
Defaults work for 90% of cases — you can spawn with just name and symbol.
## Step 2 — anti-spam validation
Before submitting, the UI runs validation:
| Check | Rule |
| --------------------- | ---------------------------------------------------------- |
| Symbol uniqueness | Must not match an existing Agent Token symbol on BiniChain |
| Cooldown | One spawn per address per cooldown window (TBD value) |
| User level (if gated) | TBD — possibly L7 or L10 minimum |
| BINI balance | Must have at least the spawn cost |
If any check fails, the form shows the issue inline.
## Step 3 — pay the spawn fee
Spawn cost is paid in **native BINI** and **fully burned** (sent to a permanent burn address).
The exact amount is being finalized — see [Spawn cost](/agentt-launchpad/spawn-cost).
## Step 4 — Spawner deploys the token
The `HiveSpawner` contract:
1. Deploys a fresh `SpawnedERC20` instance with your params
2. Mints the full supply to your address (you are the initial holder)
3. Emits a `Spawned(address token, address owner)` event
4. Records the new token in the `HiveRegistry` ERC-721/ERC-8004 NFT
Once this completes, you own 100% of the Agent Token's supply. The token is live on-chain.
## Step 5 — pool creation
Spawner immediately calls into the BaiDEX V3 factory to create an `Agent Token / wBINI` or `Agent Token / USBI` pool (depending on the `pool side` parameter).
The pool starts with **zero liquidity** — you (or other LPs) need to deposit to bootstrap trading.
## Step 6 — Worker assignment
The Spawner notifies the Agent Hive that a new token has spawned. The Hive:
1. Selects an available Worker slot (or creates one)
2. Assigns it to your Agent Token
3. The Worker begins monitoring the (currently empty) pool
4. The Worker joins the active **Swarm**
See [Auto-Worker assignment](/agentt-launchpad/auto-worker).
## Step 7 — finished
The UI shows:
* Your Agent Token address
* Pool URL on BaiDEX
* Worker management page in the Agent Hive UI
* Quick actions: bootstrap LP, set up boost, share with community
## Step 8 — bootstrapping liquidity (optional, but recommended)
Empty pools have no useful trading. To bootstrap:
1. Hold both sides (your Agent Token + USBI or wBINI)
2. Provide liquidity in a price range you choose
3. Other users can now swap
See [BaiDEX → Liquidity](/baidex/liquidity) for LP details.
## Reverting / cancelling
You **cannot** un-spawn an Agent Token once the Spawner mines the deploy. The token is on-chain and lives forever.
You **can**:
* Renounce your owner role (transfer to burn address) — makes the token immutable
* Stop providing liquidity — but the pool contract remains
* Burn your own holdings — reduces total supply but doesn't remove the token
The system is designed to be **append-only** for accountability — no spawn-and-delete spam.
## Cross-product flow summary
| Step | Where it happens | Page |
| --------------------------------------- | ------------------- | --------------------------------------------------------------------------- |
| User has BINI for fee | Bini App / Exchange | [Bridge B](/bini-app/bini-bridge), [Where to buy](/bini-token/where-to-buy) |
| User taps Spawn | AgentT Launchpad | this page |
| Spawner deploys ERC-20 | BiniChain | [Agent Token](/agentt-launchpad/agent-token) |
| Pool auto-created on V3 | BaiDEX | [Pools](/baidex/pools) |
| Worker auto-assigned | Agent Hive | [Workers](/agent-hive/workers) |
| Worker joins active set | Agent Hive | [Swarm](/agent-hive/swarm) |
| Scouts pick up the new token | Agent Hive | [Scouts](/agent-hive/scouts) |
| Queens factor into strategy | Agent Hive | [Queens](/agent-hive/queens) |
| Bootstrap LP (optional but recommended) | BaiDEX | [Liquidity](/baidex/liquidity) |
| Spawn fee burned (BINI sink) | Tokenomics | [Agent Token sinks](/tokenomics/agent-token-sinks) |
## Related
What you pay to spawn
ERC-20 details
What pool gets created
How the Hive picks it up
What the Worker does after assignment
Bootstrap LP for the new pool