convez.ai
SkillFinanceiroAvançado
to-nexus

Cross-Dex Trade

to-nexus/skill-cross-dex-trade

Trading e liquidez de GameTokens no CROSS Chain via Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill Claude Code para cotações e execução de trades de GameTokens via AMM no CROSS Chain (chain 612055), suportando swaps CROSS ↔ GameToken, depósito/saque de liquidez e gerenciamento de LP. Usa EOA + viem para assinar e transmitir transações reais diretamente na blockchain.

Instalação

$npx convez-ai to-nexus/skill-cross-dex-trade

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
1
Saúde
37%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Executar swaps de CROSS para GameTokens e vice-versa com slippage controlado
  • Descobrir tokens e pares AMM, consultar gráficos e histórico de trades
  • Gerenciar posições de liquidez (depositar/sacar de pools) e monitorar saldos em tempo real

Veredito

Ferramenta especializada e bem-documentada para trading automatizado no CROSS Chain, com segurança explícita (caps, chain validation). Recomendado apenas para usuários com experiência em criptografia e testes com valores pequenos inicialmente.

README

A tradução para o português deste README ainda está na fila.

cross-dex-trade

A Claude Code skill that quotes and executes swap-based GameToken trades and AMM liquidity actions on CROSS Chain (chain id 612055).

The old orderbook flow has been removed. This skill now follows the current x.crosstoken.io/tokens service: token/game metadata, market stats, chart candles, recent swaps, token discovery, AMM pair discovery, quotes, CROSS -> GameToken swaps, exact-output buys, GameToken -> CROSS swaps, liquidity deposit/withdraw, LP balance checks, and wallet balance checks.

  • Stack: EOA + viem
  • API: https://game-swap-api.cross.nexus/v1
  • Router: 0x639Adf46ac111399361c422bC32c3892f0cbb70c
  • Wrapped CROSS: 0x8739bC962460a8a25184aaa9166b74dd8448a194
  • Subcommands: tokens, token-info, pairs, quote, balance, buy, buy-exact, sell, quote-deposit, deposit, quote-deposit-token, deposit-token, quote-withdraw, withdraw

This skill signs and broadcasts real swap and liquidity transactions with the private key you provide. Test with small amounts and set MAX_TRADE_CROSS in .env.

Install

/plugin marketplace add github.com/to-nexus/cross-skills-suite
/plugin install cross-dex-trade@cross-skills-suite

Standalone:

git clone <this-repo> /tmp/skill-cross-dex-trade
bash /tmp/skill-cross-dex-trade/install.sh

Configuration

cp skills/cross-dex-trade/.env.example skills/cross-dex-trade/.env
chmod 600 skills/cross-dex-trade/.env
VariableRequiredDefaultNotes
PRIVATE_KEYwrite commands-EOA signer, 0x + 64 hex chars
MAX_TRADE_CROSSrecommendedunsetPer-transaction CROSS notional cap
CROSS_RPC_URLnohttps://mainnet.crosstoken.io:22001/RPC override
WALLET_ADDRESSnoderived from PKMismatch aborts
GAME_SWAP_API_URLnohttps://game-swap-api.cross.nexus/v1API override

Usage

Inside Claude Code, describe the swap in plain language:

  • "RUBYx 1 CROSS어치 견적 내줘"
  • "SHILTZx 게임 정보랑 최근 거래 보여줘"
  • "RUBYx 1 CROSS어치 사줘"
  • "RUBYx 10개 정확히 사줘"
  • "RUBYx 10개 팔아줘"
  • "RUBYx pool에 1 CROSS 예치해줘"
  • "SHILTZx 20개를 pool에 예치해줘"
  • "RUBYx LP 0.5개 출금해줘"
  • "내 GameToken 잔고 보여줘"

Direct CLI:

cd ~/.claude/skills/cross-dex-trade
node scripts/trade.mjs tokens --query=RUBY
node scripts/trade.mjs token-info SHILTZx --history=5 --candles=12 --tick=1h
node scripts/trade.mjs token-info all --limit=20
node scripts/trade.mjs pairs
node scripts/trade.mjs quote buy RUBYx 1
node scripts/trade.mjs quote buy-exact RUBYx 10
node scripts/trade.mjs quote sell RUBYx 10
node scripts/trade.mjs quote-deposit RUBYx 1
node scripts/trade.mjs quote-deposit-token SHILTZx 20
node scripts/trade.mjs quote-withdraw RUBYx 0.5
PRIVATE_KEY=0x... node scripts/trade.mjs balance
PRIVATE_KEY=0x... node scripts/trade.mjs buy RUBYx 1 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs buy-exact RUBYx 10 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs sell RUBYx 10 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs deposit RUBYx 1 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs deposit-token SHILTZx 20 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs withdraw RUBYx 0.5 --slippage-bps=300
PRIVATE_KEY=0x... node scripts/trade.mjs withdraw RUBYx all --slippage-bps=300

All commands emit one JSON object on stdout.

Safety Model

  1. Chain id must be 612055.
  2. MAX_TRADE_CROSS caps buy spend, buy-exact max input, sell quoted output, deposit CROSS input, and withdraw quoted CROSS output.
  3. Default slippage is 300 bps. Values above 5000 bps are refused.
  4. sell, deposit, and withdraw auto-approve the router only when allowance is insufficient.

Verification

Run the network-backed smoke test after any swap API or router change:

cd skills/cross-dex-trade
npm test

The test validates token discovery, token-info discovery, pair discovery, buy / buy-exact / sell quote schema, deposit/withdraw quote math, router calldata selectors, and removal of legacy orderbook commands from SKILL.md. It does not sign or broadcast transactions.

Removed Legacy Behavior

Orderbook commands are intentionally gone: no limit orders, no market matcher, no open orders, no cancels, no bid/ask depth, and no fill/open/partial state. Use quote plus swap slippage bounds instead.

Layout

skill-cross-dex-trade/
├── .claude-plugin/plugin.json
├── install.sh
├── README.md
└── skills/cross-dex-trade/
    ├── SKILL.md
    ├── package.json
    ├── .env.example
    ├── scripts/trade.mjs
    ├── references/cross-chain.md
    └── assets/SOUL.template.md

License

MIT

Ver o original no GitHub

Bom para

Relacionados