CROSS Forge

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


Deploy tokens, create bonding-curve pools, and trade — with one sentence.

Drives CROSS Forge — the NEXUS / Verse8 Game Token Launch & Market Creation Layer on CROSS 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.


1. Install

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

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

Bash execution required.

Deploy / buy / sell sign real on-chain transactions.

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 CROSS skills at once

Clone https://github.com/to-nexus/cross-skills-suite into a temporary directory and run the bootstrap.sh script inside it to install every CROSS 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

SubcommandWhat it does
🔴 deployBuilder API token deploy + Router pool creation (verbatim SKILL.md v2.0.1).
🟢 tokenBonding-curve state + recent trades; Blockscout fallback for non-Forge tokens.
🟢 tokensTrending / new / top / all + category + pagination.
🟢 portfolioYour ERC-20 holdings cross-joined with Forge (isForgeKnown, market cap, graduated).
🟢 historyGlobal activity feed; --wallet=<addr> to filter to one user.
🟢 quotePer-token fee auto-detected from recent trades.
🔴 buyCustom-selector swap (0xc075a591, native-in).
🔴 sellCustom-selector swap (0x029e384f, token-in).

4. Try it

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

commandargsauthmutationdescription
deploy<name> <symbol> <desc> <imageUrl> <feeRecipient> <category> [--auth=vendor|client] [--wallet=tmp|user]vendor: — · client: API keystx (or unsigned tx for client+user)Token deploy + pool creation.
token<tokenAddress>readCurve state + recent trades.
tokens[--mode trending|new|top|all] [--category <c>] [--page N --size N]readTrending / new / top / all list.
portfolio<walletAddress>readHoldings cross-joined with Forge.
history[--wallet <addr>] [--limit N]readGlobal activity feed.
quote<tokenAddress> <side buy|sell> <amount>readQuote with auto-detected fee.
buy<tokenAddress> <crossSpend> [--fee-bps <bps>] [--confirm]PKtxNative-in custom selector.
sell<tokenAddress> <tokenAmount> [--fee-bps <bps>] [--confirm]PKtxToken-in custom selector.
📘

Fee envelope — every quote / buy / sell carries feeBpsSource: 'override'|'recent_trade'|'default' with the full breakdown.


6. Safety & credentials

🛑

deploy / buy / sell sign on-chain transactions.

RailWhat it does
Required credentialPRIVATE_KEY for buy / sell / deploy --wallet=user. --auth=client additionally needs CLIENT_KEY / CLIENT_SECRET.
Chain-id checkAll txs target chain 612055.
Per-token fee detectionBack-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

Buy / sell came back with a worse rate than the quote.

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.

I deployed but the token isn't trending.

Trending requires buy activity. The token is live the moment the pool tx confirms; appearance in tokens --mode trending is back-end ranked.

vendor_wallet_balance_low

--wallet=tmp uses the shared vendor wallet, which can run dry. Switch to --wallet=user with your own EOA.

--auth=client errored on missing CLIENT_KEY.

Get credentials from https://cross-ramp-console.crosstoken.io and ask your agent to save them in cross-forge .env.

How is this different from cross-dex-trade?

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.


© 2025 NEXUS Co., Ltd. All Rights Reserved.