---
updatedAt: 2026-08-07T01:38:34.000Z
agentTools:
  projectIndex: https://docs.onechain.nexus/llms.txt
---

# ONE Forge

Launch game / AI tokens, create bonding-curve pools, and trade on ONE Forge with one sentence. Wraps the canonical SKILL.md v2.0.1 verbatim.

<br />

<Callout icon="✨" theme="default">
  ### **Deploy tokens, create bonding-curve pools, and trade — with one sentence.**

  Drives [ONE Forge](https://x.crosstoken.io/forge/) — the NEXUS / Verse8 _Game Token Launch & Market Creation Layer_ on ONE Chain (`612055`). Wraps the canonical agent-skill at `contents.crosstoken.io/forge/agent-skills/SKILL.md` (v2.0.1) verbatim for deploy + pool creation, and adds full quote / buy / sell / portfolio / history.
</Callout>

***

## 1. Install

The block below is a **natural-language prompt to paste into your AI agent** — not a terminal command.

```text Paste-into-agent prompt
Clone https://github.com/to-nexus/skill-cross-forge into a temporary directory and run the install.sh script inside it to install the cross-forge skill into my environment. Tell me the result in one line when you're done.
```

<Callout icon="🚧" theme="warn">
  ### **Bash execution required.**

  Deploy / buy / sell sign real on-chain transactions.
</Callout>

For `deploy --auth=client`, ask your agent to "set `CLIENT_KEY` and `CLIENT_SECRET` in cross-forge `.env`" using credentials from `https://cross-ramp-console.crosstoken.io`.

### Install all ONE skills at once

```text Paste-into-agent prompt
Clone https://github.com/to-nexus/cross-skills-suite into a temporary directory and run the bootstrap.sh script inside it to install every ONE skill into my environment. Tell me which skills succeeded and which failed.
```

***

## 2. Where it runs

### ✅ Supported · CLI agents with Bash access

Claude Code (CLI) · OpenClaw · Cursor Composer · Codex CLI · Aider · Goose · Gemini CLI · OpenInterpreter · any other Bash-capable CLI.

### ❌ Not supported · Browser / hosted only

Claude.ai (web) · ChatGPT (web) · Gemini (web) · Copilot Chat (web). Deploy + pool creation + trade all need a local `ethers` signer.

***

## 3. What you can do

| Subcommand     | What it does                                                                          |
| -------------- | ------------------------------------------------------------------------------------- |
| 🔴 `deploy`    | Builder API token deploy + Router pool creation (verbatim SKILL.md v2.0.1).           |
| 🟢 `token`     | Bonding-curve state + recent trades; Blockscout fallback for non-Forge tokens.        |
| 🟢 `tokens`    | Trending / new / top / all + category + pagination.                                   |
| 🟢 `portfolio` | Your ERC-20 holdings cross-joined with Forge (`isForgeKnown`, market cap, graduated). |
| 🟢 `history`   | Global activity feed; `--wallet=<addr>` to filter to one user.                        |
| 🟢 `quote`     | Per-token fee auto-detected from recent trades.                                       |
| 🔴 `buy`       | Custom-selector swap (`0xc075a591`, native-in).                                       |
| 🔴 `sell`      | Custom-selector swap (`0x029e384f`, token-in).                                        |

***

## 4. Try it

```text 🇰🇷 Korean
trending forge 토큰 보여줘
forge 토큰 0x... 상세 (최근 거래 포함)
새 forge 토큰 "MyToken" / "MTK" 게임 카테고리로 발행
0xWallet 지갑의 forge 포트폴리오
forge 활동 피드 보여줘
이 forge 토큰 0.5 CROSS 어치 매수 견적
forge 토큰 0.5 CROSS 매수
forge 토큰 1000개 매도
```

```text 🇺🇸 English
List trending forge tokens
Show forge token 0x... details with recent trades
Deploy a forge token "MyToken" / "MTK" in the game category
Show forge portfolio for 0xWallet
Show the forge global activity feed
Quote a 0.5 CROSS buy of this forge token
Buy that forge token for 0.5 CROSS
Sell 1000 of that forge token
```

***

## 5. Command reference

| command     | args                                                                                                       | auth                         | mutation                            | description                       |
| ----------- | ---------------------------------------------------------------------------------------------------------- | ---------------------------- | ----------------------------------- | --------------------------------- |
| `deploy`    | `<name> <symbol> <desc> <imageUrl> <feeRecipient> <category> [--auth=vendor\|client] [--wallet=tmp\|user]` | vendor: — · client: API keys | tx (or unsigned tx for client+user) | Token deploy + pool creation.     |
| `token`     | `<tokenAddress>`                                                                                           | —                            | read                                | Curve state + recent trades.      |
| `tokens`    | `[--mode trending\|new\|top\|all] [--category <c>] [--page N --size N]`                                    | —                            | read                                | Trending / new / top / all list.  |
| `portfolio` | `<walletAddress>`                                                                                          | —                            | read                                | Holdings cross-joined with Forge. |
| `history`   | `[--wallet <addr>] [--limit N]`                                                                            | —                            | read                                | Global activity feed.             |
| `quote`     | `<tokenAddress> <side buy\|sell> <amount>`                                                                 | —                            | read                                | Quote with auto-detected fee.     |
| `buy`       | `<tokenAddress> <crossSpend> [--fee-bps <bps>] [--confirm]`                                                | PK                           | tx                                  | Native-in custom selector.        |
| `sell`      | `<tokenAddress> <tokenAmount> [--fee-bps <bps>] [--confirm]`                                               | PK                           | tx                                  | Token-in custom selector.         |

<Callout icon="📘" theme="info">
  ### **Fee envelope** — every quote / buy / sell carries `feeBpsSource: 'override'|'recent_trade'|'default'` with the full breakdown.
</Callout>

***

## 6. Safety & credentials

<Callout icon="🛑" theme="error">
  ### `deploy`**&#x20;/&#x20;**`buy`**&#x20;/&#x20;**`sell`**&#x20;sign on-chain transactions.**
</Callout>

| Rail                        | What it does                                                                                                                                                |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Required credential**     | `PRIVATE_KEY` for `buy` / `sell` / `deploy --wallet=user`. `--auth=client` additionally needs `CLIENT_KEY` / `CLIENT_SECRET`.                               |
| **Chain-id check**          | All txs target chain `612055`.                                                                                                                              |
| **Per-token fee detection** | Back-solved from `/api/v1/tokens/<addr>.recent_trades[0]`. Falls back to 130 bps conservative default if no recent trades exist. Override with `--fee-bps`. |
| **Vendor wallet**           | `--wallet=tmp` uses the vendor wallet `0x2544…9da9` for one-shot demo flows. For production, use `--wallet=user` with your own EOA.                         |

***

## 7. Troubleshooting

<Accordion title="Buy / sell came back with a worse rate than the quote." icon="fa-info-circle">
  Bonding-curve slippage between quote and tx submission. Re-quote and re-submit; or read `feeBps` from the latest `recent_trades` and pass it explicitly via `--fee-bps`.
</Accordion>

<Accordion title="I deployed but the token isn't trending." icon="fa-info-circle">
  Trending requires buy activity. The token is live the moment the pool tx confirms; appearance in `tokens --mode trending` is back-end ranked.
</Accordion>

<Accordion title="vendor_wallet_balance_low" icon="fa-info-circle">
  `--wallet=tmp` uses the shared vendor wallet, which can run dry. Switch to `--wallet=user` with your own EOA.
</Accordion>

<Accordion title="--auth=client errored on missing CLIENT_KEY." icon="fa-info-circle">
  Get credentials from [https://cross-ramp-console.crosstoken.io](https://cross-ramp-console.crosstoken.io) and ask your agent to save them in cross-forge `.env`.
</Accordion>

<Accordion title="How is this different from cross-dex-trade?" icon="fa-info-circle">
  [cross-dex-trade](https://docs.onechain.nexus/docs/skill-cross-dex-trade) is the **Gametoken orderbook** — a different contract. Forge tokens trade on **bonding curves** until graduation. Use this skill for Forge tokens, cross-dex-trade for Gametoken pairs.
</Accordion>