cross-crossd
A Claude Code skill that drives the CrossDefi swap-bridge backend (https://www.crossdefi.io/swap-bridge) — list supported pairs, resolve token metadata, build quotes (ETA + swap-pool route), poll bridge status, and read history. Targets BSC (chain id 56), CROSS Chain (612055), and Klaytn (8217).
- Stack: EOA + viem (no ERC-4337, no paymaster, no Playwright)
- Backends:
bridge-api.crosstoken.io/bridge/* — pairs, swap-pools, tx-time, token-config, permit, permit-hash, check-cached-tx-hashes, historywallet-server.crosstoken.io/v1/public/* — chain info, token metadata, gas suggestion
- Subcommands:
pairs, tokens, quote, status, history, bridge
- Distribution: standalone Claude skill and wrapped as a Claude Code plugin
v0.2 ships read + write. bridge.mjs auto-detects the right execution path per the live frontend logic:
- native — from-token is the chain's native asset → encodes
bridgeToken(...) against the source-chain bridge router and sends the tx with msg.value = value + gasFee + exFee. Returns the on-chain tx hash.
- permit — from-token supports EIP-2612 → signs typed data offline, POSTs to
/bridge/permit. The backend submits the on-chain call; the user pays no source-chain gas. Returns the permitId.
- approve — non-permit ERC-20 → approves the bridge router (exact amount by default;
--max-approve for unlimited), then sends bridgeToken(...) with msg.value = 0. Returns approve + bridge tx hashes.
Override with --path=native|permit|approve if needed.
Install — Recommended (via Marketplace)
/plugin marketplace add github.com/to-nexus/cross-skills-suite
/plugin install cross-crossd@cross-skills-suite
Part of the CROSS Skills Suite — installs alongside cross-rewards, cross-dex-trade, cross-prediction.
Install — Standalone
Option 1 — Plain skill (one user, fastest)
git clone <this-repo> /tmp/skill-cross-crossd
bash /tmp/skill-cross-crossd/install.sh # symlinks into ~/.claude/skills/
Or manually:
cp -r skills/cross-crossd ~/.claude/skills/
cd ~/.claude/skills/cross-crossd && npm install
Option 2 — Claude Code plugin (marketplace-installable)
{
"name": "cross-crossd",
"source": { "source": "github", "repo": "to-nexus/skill-cross-crossd" },
"category": "blockchain"
}
Configuration
Read-path commands (pairs, tokens, quote, status) do not require a private key. Only history and bridge need one.
cp skills/cross-crossd/.env.example skills/cross-crossd/.env
chmod 600 skills/cross-crossd/.env
| Variable | Required | Default | Notes |
|---|
PRIVATE_KEY | only for history / future bridge | — | EOA signer, 0x + 64 hex chars |
WALLET_ADDRESS | optional | derived from PK | Mismatch warns via signerWarn |
BSC_RPC_URL | optional | wallet-server lookup | Override only if you have a private RPC |
CROSS_RPC_URL | optional | wallet-server lookup | Override only if you have a private RPC |
KLAYTN_RPC_URL | optional | wallet-server lookup | Override only if you have a private RPC |
MAX_BRIDGE_NOTIONAL | recommended | unset | Per-bridge cap; aborts above this |
CONFIRM_THRESHOLD | recommended | 1 | Bridges above this require --confirm |
MIN_GAS_NATIVE | optional | 0.001 | Source-chain native floor |
Quick start
Inside Claude Code, just describe the action in plain language. The skill activates on phrases like:
- "list bridge pairs"
- "BSC에서 CROSS로 브릿지"
- "USDT BSC to CROSS"
- "swap-bridge 견적 1 USDT"
- "내 브릿지 진행상황 0xabc..."
- "permit-hash status 12345"
Direct CLI:
cd ~/.claude/skills/cross-crossd
node scripts/pairs.mjs
node scripts/tokens.mjs --chain 56
node scripts/quote.mjs 56-0x6bf62ca91e397b5a7d1d6bce97d9092065d7a510 612055-0x0000000000000000000000000000000000000001 1.0
node scripts/status.mjs <permitId>
node scripts/status.mjs --tx 0xabc...
PRIVATE_KEY=0x... node scripts/history.mjs
PRIVATE_KEY=0x... node scripts/bridge.mjs 612055-0x0000000000000000000000000000000000000001 56-0x6bf62ca91e397b5a7d1d6bce97d9092065d7a510 1.0 --confirm
All commands emit a single JSON object on stdout.
Layout
