mcpField
S
SunSwap DEX Trading

SunSwap DEX Trading

github.com/bofai其他163144 次安装6 天前更新
代码仓库

关于 SunSwap DEX Trading

SunSwap DEX Trading 是供 AI Agent 使用 `sun-cli` 查询和交易 TRON DEX SunSwap 的技能。它将只读市场与资金池查询和交易执行结合起来，并支持 V2、V3、V4 流动性操作。

主要功能

  1. 01查询代币价格和兑换报价
  2. 02设置滑点并执行代币兑换
  3. 03添加或移除 V2 流动性
  4. 04创建和管理 V3、V4 仓位
  5. 05搜索资金池并查看数据
  6. 06使用 `--dry-run` 预览写入操作

适用场景

  1. 01交易前比较兑换报价
  2. 02执行 TRON 代币兑换
  3. 03向资金池添加或撤出流动性
  4. 04查看资金池并管理集中流动性仓位

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bofai/skills --skill sunswap-dex-trading

安装后在 Claude Code 中输入/sunswap-dex-trading确认已加载。

附带文件CHANGELOG.mdREADME.md

详细介绍

SunSwap DEX 交易技能

快速入门

此技能可让 AI Agent 通过 sun-cli 与 TRON 区块链上的 SunSwap DEX 交互。sun-cli 是一款统一的 CLI，可用于查询兑换报价、执行交易、管理流动性（V2/V3/V4）、查询资金池、价格、头寸等。

前置条件

仅执行实际写入操作时需要钱包： 在兑换、更改流动性或执行 contract send 之前，请配置受支持的 sun-cli 钱包来源， 然后使用 sun wallet address 验证公开地址。只读查询和 --dry-run 预览无需钱包。 已停用的钱包和入门 Skills 并非前置条件；wallet-cli 账户不会自动提供给 sun-cli 使用。切勿在聊天中索取或显示机密信息。

  1. 验证 sun-cli：

    sun --version

    所需版本必须恰好为 1.2.2。如果未安装或安装的是其他版本，请先获得批准，再更改全局软件包：

    npm install -g @sun-protocol/[email protected]

  2. 配置钱包（仅写入操作需要）：

    export TRON_PRIVATE_KEY="your_private_key_here"

    其他钱包来源：TRON_MNEMONIC 或 AGENT_WALLET_PASSWORD。

  3. 可选环境变量：

    export TRON_NETWORK=mainnet
export TRONGRID_API_KEY=your_key

只读命令（价格、报价、资金池列表等）和 --dry-run 预览无需钱包凭据即可使用。

AI Agent 标志

AI Agent 调用 sun 时，始终使用以下标志：

标志用途
--json将机器可读的 JSON 输出到 stdout
--yes跳过交互式确认提示
--dry-run模拟写入操作，但不发送交易
--fields将输出限制为指定的逗号分隔字段
--network覆盖网络：mainnet、nile、shasta

标准 Agent 调用模式：

sun --json price TRX

写入操作添加 --yes 以跳过提示：

sun --json --yes swap TRX USDT 100000000

警告：--network 仅接受 mainnet、nile 或 shasta。 无效的网络名称会静默回退到 mainnet，不会报错。 AI Agent 必须在传入网络值之前对其进行验证。

警告：--dry-run 仅构建交易预览。 它不会检查余额、验证费用层级、验证 tick 对齐情况，也不会拒绝相同代币兑换。 Agent 必须在执行前完成这些验证。 请参阅下文的Agent 执行前检查清单。

Agent 执行前检查清单

执行任何写入操作（swap、liquidity、contract send）之前，AI Agent 必须完成以下检查。CLI 的 --dry-run 不会验证这些内容，它只会构建交易预览。

兑换前

  1. 检查余额是否充足：

    sun --json wallet balances

    将代币余额与 amountIn 进行比较。余额不足时中止操作。

  2. 确认 tokenIn ≠ tokenOut： --dry-run 不会拒绝相同代币兑换（例如 TRX → TRX）。Agent 必须在执行前检查两个代币是否不同。

  3. 验证滑点是否合理： 建议范围：0.001（0.1%）至 0.05（5%）。如果超出此范围，请警告用户。

创建 V3 流动性前（Mint）

  1. 仅使用有效的费用层级： 100、500、3000 或 10000。 --dry-run 不会拒绝无效的费用值（例如 9999）。

  2. 确保 tick 与 tick 间距对齐：

    费用值Tick 间距有效 tick 示例
    1001任意整数
    50010-10、0、10、20
    300060-120、-60、0、60
    10000200-400、-200、0、200

    --tick-lower 和 --tick-upper 都必须是 tick 间距的整数倍。 --dry-run 不会拒绝未对齐的 tick，但此类操作会在链上失败。

  3. 检查余额是否充足，确保 token0 和 token1 的金额都足够。

V3/V4 头寸操作（增加/减少/收取）前
  1. 确认代币 ID 存在： 先查询用户的头寸： 
    sun --json position list --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW --protocol V3
    确认结果中包含目标 --token-id。传入不存在的代币 ID 可能会产生误导性错误（例如显示“需要金额”，而不是“未找到头寸”）。
V2 流动性操作（添加）前
  1. 检查余额是否充足，确保 token-a 和 token-b 的数量均足够。
通用
  • 验证 --network 是否为以下值之一：mainnet、nile、shasta。无效值会静默回退到 mainnet。
  • 验证 tx scan 的 --type 是否为以下值之一：swap、add、withdraw。无效值会返回空结果，而不会报错。

命令参考

1. 钱包

检查钱包地址和代币余额。

sun --json wallet address

sun --json wallet balances

检查特定所有者地址的余额：

sun --json wallet balances --owner TDqSquXBgUCLYvYC4XZgrprLK589dkhSCf

按特定代币筛选（仅支持合约地址，不支持 TRX/USDT 等符号）：

sun --json wallet balances --tokens TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t,TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR

WARNING： --tokens 仅接受合约地址。传入符号（例如 TRX,USDT）将返回 Invalid contract address provided。请先使用支持的代币符号中的地址表，将符号解析为地址。

2. 代币价格

从 SUN.IO 获取代币价格。

sun --json price TRX

sun --json price USDT

按合约地址查询：

sun --json price --address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
3. 兑换报价（只读）

获取价格报价，不执行兑换。无需钱包。

参数： tokenIn 和 tokenOut 接受代币符号（TRX、USDT）或 TRC20 地址。amountIn 的单位为 sun（最小单位，例如 1000000 = 1 TRX）。

sun --json swap:quote TRX USDT 100000000

获取包含所有路由详情的报价：

sun --json swap:quote TRX USDT 100000000 --all

在指定网络上获取报价：

sun --json swap:quote TRX USDT 100000000 --network nile

反向查询：

sun --json swap:quote USDT TRX 1000000
4. 执行兑换

通过 SunSwap Universal Router 执行代币兑换。

参数： tokenIn 和 tokenOut 接受符号或地址。amountIn 的单位为 sun。--slippage 为小数（默认值：0.005 = 0.5%）。

sun --json --yes swap TRX USDT 100000000

使用自定义滑点（1%）兑换：

sun --json --yes swap TRX USDT 100000000 --slippage 0.01

试运行（模拟操作，不发送交易）：

sun --json --yes --dry-run swap TRX USDT 100000000

使用合约地址而非符号：

sun --json --yes swap T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t 100000000

在 nile 测试网上兑换：

sun --json --yes swap TRX USDT 1000000 --network nile
5. V2 流动性

在 SunSwap V2 AMM 池中添加或移除流动性。

添加参数： --token-a 和 --token-b 接受符号或地址。--amount-a 和 --amount-b 的单位为 sun。可选：--min-a、--min-b、--to、--deadline。

移除参数： --token-a、--token-b、--liquidity（原始 LP 数量）。可选：--min-a、--min-b、--to、--deadline。

添加流动性

单边添加（自动计算另一边）：

sun --json --yes liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000

双边添加：

sun --json --yes liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000 --amount-b 290000

试运行：

sun --json --yes --dry-run liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000

设置最低数量和接收方：

sun --json --yes liquidity v2:add --token-a TRX --token-b USDT --amount-a 1000000 --amount-b 290000 --min-a 950000 --min-b 275000
移除流动性
sun --json --yes liquidity v2:remove --token-a TRX --token-b USDT --liquidity 500000

试运行：

sun --json --yes --dry-run liquidity v2:remove --token-a TRX --token-b USDT --liquidity 500000
6. V3 流动性（集中流动性）

管理 SunSwap V3 上的集中流动性头寸。

费率档位（仅以下值有效）：

费率费用值Tick 间距全范围 Tick
0.01%1001-887272 / 887272
0.05%50010-887270 / 887270
0.3%300060-887220 / 887220
1%10000200-887200 / 887200

IMPORTANT： --fee 必须严格为以下值之一：100、500、3000、10000。 其他值不会被 --dry-run 拒绝，但会在链上执行失败。

--tick-lower 和 --tick-upper 必须是 tick 间距的整数倍。 不对齐的 tick 不会被 --dry-run 拒绝，但会在链上执行失败。

铸造参数： --token0、--token1（符号或地址）、--fee、--tick-lower、--tick-upper、--amount0、--amount1。可选：--recipient、--deadline。

铸造新头寸

使用默认值创建全范围头寸：

sun --json --yes liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000

使用指定费率和 Tick 范围（fee=3000，tick 间距=60）：

sun --json --yes liquidity v3:mint --token0 TRX --token1 USDT --fee 3000 --tick-lower -887220 --tick-upper 887220 --amount0 1000000

试运行：

sun --json --yes --dry-run liquidity v3:mint --token0 TRX --token1 USDT --amount0 1000000

使用指定费率档位（fee=500，tick 间距=10）：

sun --json --yes liquidity v3:mint --token0 TRX --token1 USDT --fee 500 --tick-lower -887270 --tick-upper 887270 --amount0 1000000

指定接收方：

sun --json --yes liquidity v3:mint --token0 TRX --token1 USDT --fee 3000 --tick-lower -60 --tick-upper 60 --amount0 1000000 --recipient TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW
增加头寸
sun --json --yes liquidity v3:increase --token-id 123 --amount0 500000
减少仓位
sun --json --yes liquidity v3:decrease --token-id 123 --liquidity 1000
收取手续费
sun --json --yes liquidity v3:collect --token-id 123
7. V4 流动性

管理 SunSwap V4 池中的流动性（支持钩子）。

铸造参数： --token0、--token1、--fee、--tick-lower、--tick-upper、--amount0、--amount1。可选参数：--slippage、--recipient、--create-pool。

铸造新仓位
sun --json --yes liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000

如果池不存在，则创建池：

sun --json --yes liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000 --create-pool

设置滑点：

sun --json --yes liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000 --slippage 0.01

试运行：

sun --json --yes --dry-run liquidity v4:mint --token0 TRX --token1 USDT --amount0 1000000
增加仓位
sun --json --yes liquidity v4:increase --token-id 123 --token0 TRX --token1 USDT --amount0 500000
减少仓位
sun --json --yes liquidity v4:decrease --token-id 123 --liquidity 1000 --token0 TRX --token1 USDT
收取手续费
sun --json --yes liquidity v4:collect --token-id 123
查询仓位信息
sun --json liquidity v4:info --pm TLSWrv7eC1AZCXkRjpqMZUmvgd99cj7pPF --token-id 123
8. 池发现

搜索并查看流动性池。

按代币地址列出池：

sun --json pool list --token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

按关键词搜索：

sun --json pool search "TRX USDT"

APY 最高的池：

sun --json pool top-apy --page-size 10

池交易量历史记录（需要池地址）：

sun --json pool vol-history TSUUVjysXV8YqHytSNjfkNXnnB49QDvZpx --start 2026-01-01 --end 2026-03-15

池流动性历史记录：

sun --json pool liq-history TSUUVjysXV8YqHytSNjfkNXnnB49QDvZpx --start 2026-01-01 --end 2026-03-15

池钩子（V4）：

sun --json pool hooks
9. 代币发现

搜索并列出代币元数据。

sun --json token list

按协议筛选：

sun --json token list --protocol V3

按关键词搜索：

sun --json token search USDT
10. 仓位管理

查询用户的流动性仓位。

列出某个所有者的所有仓位：

sun --json position list --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW

按协议筛选：

sun --json position list --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW --protocol V3

池 tick 信息：

sun --json position tick TSUUVjysXV8YqHytSNjfkNXnnB49QDvZpx
11. 交易对信息

查询交易对信息。

警告： pair info --token 仅接受合约地址。传入代币符号 （例如 USDT）会导致 API 错误或返回意外结果。 请先使用支持的代币符号表或 token search 将代币符号解析为合约地址。

查询 USDT 合约地址：

sun --json pair info --token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

查询 WTRX 合约地址：

sun --json pair info --token T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb
12. 协议分析

获取协议级指标。

sun --json protocol info

sun --json protocol vol-history --start 2026-01-01 --end 2026-03-15

sun --json protocol users-history --start 2026-01-01 --end 2026-03-15

sun --json protocol tx-history --start 2026-01-01 --end 2026-03-15

sun --json protocol pools-history --start 2026-01-01 --end 2026-03-15

sun --json protocol liq-history --start 2026-01-01 --end 2026-03-15
13. Farm

查看 SUN.IO 农场。

sun --json farm list

特定所有者的农场交易：

sun --json farm tx --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW --type stake

用户农场仓位：

sun --json farm positions --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW
14. 交易扫描

扫描 DEX 交易活动。

重要： --type 必须严格为以下值之一：swap、add、withdraw。 无效类型会返回空结果，而不是报错。

sun --json tx scan --type swap --token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t --start 2026-01-01 --end 2026-03-15

sun --json tx scan --type add --start 2026-01-01 --end 2026-03-15

sun --json tx scan --type withdraw --start 2026-01-01 --end 2026-03-15
15. 通用合约调用

在高级命令无法满足需求时，读取或发送任意 TRON 合约调用。

读取合约（无需钱包）：

sun --json contract read TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t name

sun --json contract read TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t balanceOf --args '["TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW"]'

发送合约调用（需要钱包；使用 --dry-run 进行模拟）：

sun --json --yes --dry-run contract send TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t approve --args '["TKzxdSv2FZKQrEqkKVgp5DcwEXBEKMg2Ax","1000000"]' --value 0

为 AI Agent 推荐的工作流

模式 1：快速兑换（三步验证）

适用于： 面向用户的兑换操作。

步骤 1 — 验证输入（Agent 端，无需调用 CLI）：

  • 确认 tokenIn ≠ tokenOut（CLI 不会拒绝相同代币的兑换，例如 TRX→TRX）
  • 确认 --network 有效（mainnet、nile 或 shasta）

步骤 2 — 检查余额并获取报价：

sun --json wallet balances

sun --json swap:quote TRX USDT 100000000

确认余额 ≥ amountIn。向用户展示：预期输出数量、价格影响和路由。

步骤 3 — 用户确认后执行：

sun --json --yes swap TRX USDT 100000000 --slippage 0.005
模式 2：安全执行（先试运行）

适用于： 大额操作或谨慎操作。

注意： --dry-run 只会预览交易结构，不会检查 余额、验证手续费等级或拒绝无效参数。

先检查余额：

sun --json wallet balances

模拟（预览交易结构）：

sun --json --yes --dry-run swap TRX USDT 100000000

查看试运行结果并确认余额后执行：

sun --json --yes swap TRX USDT 100000000
模式 3：流动性管理（V3 示例）

适用于： 添加集中流动性。

步骤 1 — 验证参数（Agent 端）：

  • 确认 --fee 为以下值之一：100、500、3000、10000
  • 确认 --tick-lower 和 --tick-upper 是 tick 间距的倍数（例如 fee=3000 时为 60）
  • 确认 token0 ≠ token1

步骤 2 — 检查余额和池信息：

sun --json wallet balances

sun --json pool search "TRX USDT"

确认余额足以满足 amount0 和 amount1。

步骤 3 — 试运行铸造（仅预览，不会验证余额或参数）：

sun --json --yes --dry-run liquidity v3:mint --token0 TRX --token1 USDT --fee 3000 --tick-lower -887220 --tick-upper 887220 --amount0 1000000

步骤 4 — 用户确认后执行：

sun --json --yes liquidity v3:mint --token0 TRX --token1 USDT --fee 3000 --tick-lower -887220 --tick-upper 887220 --amount0 1000000
模式 4：信息收集

适用场景： 回答用户有关代币、资金池和价格的问题。

查询代币价格：

sun --json price TRX

APY 最高的资金池：

sun --json pool top-apy --page-size 10

用户持仓：

sun --json position list --owner TMgYX7m37cyyTSgVbtCoDUAQcFZ9RoYxJW

交易对信息（需要合约地址，不能使用代币符号）：

sun --json pair info --token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

限制输出字段以减少响应大小：

sun --json --fields address,network wallet address

支持的代币符号

sun-cli 内置符号解析功能。常见符号：

符号主网地址小数位数
TRXT9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb6
WTRXTNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR6
USDTTR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t6
USDCTEkxiTehnzSmSe2XqrBj4w32RUN966rdz86
USDDTPYmHEhy5n8TCEfYGqW2rPxsghSfzghPDn18
SUNTSSMHYeV2uE9qYH95DqyoCuNCzEL1NvU3S18
JSTTCFLL5dx5ZJdKnWuesXxi1VPwjLVmWZZy918
BTTTAFjULxiVgT4qWk6UZwjqwZXTSaGaqnVp418
WINTLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU76

任何 TRC20 代币也可以直接使用其合约地址引用。

安全规则

严重：切勿显示私钥

禁止： 私钥、助记词、记忆短语、包含机密的环境变量值、Agent 钱包密码。

允许： 公开钱包地址、交易哈希、代币余额和价格。

验证输出中不会泄露机密：

sun --json wallet address

输出中不得包含私钥材料。

严重：防止重复交易
  • 一条用户命令 = 一笔交易
  • 交易成功后，将其标记为已完成
  • 切勿重试已成功的交易
严重：执行前验证输入

CLI 在 --dry-run 模式下不会验证所有输入。Agent 必须：

  • 在交换前确认 tokenIn ≠ tokenOut
  • 在 V3 mint 前确认 --fee 的值为：100、500、3000、10000 之一
  • 在 V3 mint 前确认 tick 值与 tick 间距对齐
  • 确认 --network 的值为：mainnet、nile、shasta 之一
  • 在执行任何写入操作前，检查 wallet balances，确认资金充足
严重：高价值操作前使用报价和余额检查
sun --json wallet balances

sun --json swap:quote TRX USDT 1000000000

执行前务必检查余额并获取报价。--dry-run 只会显示交易结构，不会验证余额或参数。

严重：写入操作前务必预览

AI Agent 绝不能在未先向用户展示预览的情况下执行写入操作（swap、liquidity add/remove/mint、contract send）。正确流程如下：

  1. 获取报价或运行 dry-run，展示将要发生的操作
  2. 向用户展示预览（金额、路径、价格影响、费用）
  3. 请求用户明确确认
  4. 然后才使用 --yes 执行

警告： 首次调用时不要传入 --yes。只有在用户查看预览并确认后，才能使用 --yes。跳过预览会违反安全协议。

正确模式：

sun --json swap:quote TRX USDT 100000000

向用户展示结果。用户确认后：

sun --json --yes swap TRX USDT 100000000

对于高价值操作（大额）： 除获取报价外，务必先使用 --dry-run：

sun --json --yes --dry-run swap TRX USDT 1000000000

只有在用户查看报价和 dry-run 结果后，才能执行操作。

用户沟通协议

执行交易或流动性操作时，请清楚地沟通：

执行前：

Getting quote for 100 TRX → USDT...

Quote received:
  100 TRX → 15.234 USDT
  Price Impact: 0.12%
  Route: TRX → WTRX → USDT

Proceed with swap?

成功后：

Swap completed!
  Transaction: abc123def456...
  Explorer: https://tronscan.org/#/transaction/abc123def456...
  Swapped: 100 TRX → 15.234 USDT

已知限制

以下是 AI Agent 必须设法应对的 CLI 层级行为：

问题受影响的命令行为Agent 的应对方法
--dry-run 不会检查余额swap、liquidity v2:add、所有 V3/V4 操作即使余额不足，也会返回预览执行前检查 wallet balances
--dry-run 不会验证 V3 手续费档位liquidity v3:mint接受 9999 等无效费用值仅传入 100、500、3000 或 10000
--dry-run 不会验证 tick 对齐liquidity v3:mint接受未对齐的 tick确保 tick 是 tick 间距的倍数
不会拒绝相同代币之间的交换swap在 dry-run 中接受 TRX→TRX调用前确认 tokenIn ≠ tokenOut
无效的 --network 会静默回退所有命令未知网络名称会使用主网仅传入 mainnet、nile 或 shasta
无效的 --type 会返回空结果tx scan未知类型会返回空列表，不报错仅传入 swap、add 或 withdraw
pair info --token 需要地址pair info使用代币符号会导致 API 错误或结果异常使用合约地址，而非代币符号
--tokens 过滤器需要地址wallet balances使用 TRX,USDT 等符号会导致 Invalid contract address provided调用前将符号解析为地址
JSON 输出中的 BigInt 序列化contract read返回大整数（例如 totalSupply）的函数可能因 Do not know how to serialize a BigInt 而崩溃在客户端将结果包装为 .toString()，或对这些调用避免使用 --json
V3 无效的 --token-id 会产生误导性错误v3:increase、v3:decrease、v3:collect不存在的 token-id 可能会报告“amount required”，而非“position not found”操作前通过 position list 确认 token-id 存在
AGENT_WALLET_PASSWORD 需要钱包存储目录wallet address如果未初始化 ~/.agent-wallet 目录，则会失败改用 TRON_PRIVATE_KEY 或 TRON_MNEMONIC，或先初始化钱包存储目录
测试网交易需要带宽/能量nile/shasta 上的所有写入命令即使 dry-run 成功，实际执行也可能因资源错误而失败确保测试钱包质押了足够的 TRX，以获取带宽和能量

故障排除

“sun: command not found”
npm install -g @sun-protocol/[email protected]
实际写入时出现“Wallet not configured”

设置以下任一变量：TRON_PRIVATE_KEY、TRON_MNEMONIC 或 AGENT_WALLET_PASSWORD。 在 @sun-protocol/[email protected] 中，--dry-run 应在没有钱包凭据的情况下返回预览。

关于 AGENT_WALLET_PASSWORD 的说明： 此模式要求在 ~/.agent-wallet 中 已初始化钱包存储目录。如果该目录不存在，CLI 将报错： Secrets directory not found。如需更简单的设置，请使用 TRON_PRIVATE_KEY 或 TRON_MNEMONIC。一次只设置一种钱包来源。

“Network error”或“Timeout”
  • 检查互联网连接
  • 对于主网，设置 TRONGRID_API_KEY
  • 重试（网络可能拥堵）
交易失败
  • 确保有足够的 TRX 支付 gas（建议 100+ TRX）
  • 提高滑点：--slippage 0.01
  • 使用 sun --json wallet balances 验证代币余额
测试网交易因带宽/能量错误而失败
  • Nile 和 Shasta 测试网需要质押 TRX 才能获得带宽和能量
  • Dry-run 可能成功，但如果钱包缺少资源，实际执行会失败
  • 测试前，先为测试钱包充值测试网 TRX 并质押以获取资源
  • 即使资源不足，也可以使用 --dry-run 验证交易结构
  • 技能版本：2.0.0
  • 运行时依赖：@sun-protocol/[email protected] 最后更新：2026-07-09 维护者：Bank of AI 团队

评论

支持 Markdown