ClawDex Trading — ClawDex 交易

ClawDex — Solana DEX 交易技能 通过 Jupiter 聚合器模拟、安全防护和完整 JSON 输出交易任何 Solana 代币。

前提条件 在使用此技能之前，请确保 ClawDex 已安装和配置： which clawdex || npm install -g clawdex@latest 如果尚未配置，请运行入门程序： clawdex status --json 如果状态检查失败，请设置： clawdex onboarding \ --jupiter-api-key "$JUPITER_API_KEY" \ --rpc "${SOLANA_RPC_URL:-https://api.mainnet-beta.solana.com}" \ --wallet ~/.config/solana/id.json \ --json

命令 检查钱包余额 clawdex balances --json 返回一个包含 { token, symbol, mint, balance, decimals } 对象的数组。零余额账户包含在 JSON 输出中。

获取报价（无执行） clawdex quote --in SOL --out USDC --amount 0.01 --json 轻量级价格检查 — 无模拟，无需钱包。

模拟交换（试运行） clawdex swap --in SOL --out USDC --amount 0.01 --simulate-only --json 在链上运行完整模拟而不广播。无需 --yes。使用此命令预览输出金额和路由，然后再提交。

执行交换 clawdex swap --in SOL --out USDC --amount 0.01 --yes --json --yes 是非交互式执行所必需的。没有它，ClawDex 将退出代码 1。

健康检查 clawdex status --json 验证 RPC 连接性、钱包有效性和配置状态。

交易工作流 始终遵循此顺序： 健康检查 — clawdex status --json — 如果 rpc.healthy 为 false，则中止 检查余额 — clawdex balances --json — 确认有足够的资金 模拟 — clawdex swap --simulate-only --json — 预览交易 执行 — clawdex swap --yes --json — 仅当模拟看起来良好时 验证 — clawdex balances --json — 确认余额已更新（可能需要在公共 RPC 上延迟 5 秒）

令牌规格 令牌可以通过符号或 mint 地址传递： 通过符号：SOL、USDC、USDT 通过 mint：EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

退出代码 代码 含义 代理操作 0 成功 继续 1 一般错误 检查消息 2 配置错误 运行入门程序 3 安全违规 减少金额或调整限制 4 模拟失败 尝试不同的交易对/金额 5 发送失败 使用回退重试

安全 设置防护栏以防止交易失控： clawdex safety set max_slippage_bps=300 max_trade_sol=1 max_price_impact_bps=100 当防护栏触发时，JSON 响应包含一个描述失败的违规数组。

重要规则 始终使用 --json 进行机器可解析的输出 始终使用 --yes 进行真实的交换（不需要 --simulate-only） 除非有充分的理由，否则永远不要跳过模拟 — 首先使用 --simulate-only 将余额解析为字符串，而不是数字 — 保留完整的十进制精度 检查退出代码 — 非零意味着交易未成功 等待验证 — RPC 余额读取可能在交换后几秒钟内延迟