emblemcompany/emblem-token-swap

emblem-token-swap 是做什么的？

通过 EmblemAI 在 6 条区块链上执行代币交换。自动路由优化和跨链桥接，基于 ChangeNow。当用户想要交换代币、兑换加密货币、转换货币或跨链桥接资产时使用。

主要功能

• 代币交换：在 6 条支持的区块链之间交换代币（ERC-20、BEP-20 等）。
• 自动路由优化：自动选择最佳路由和 DEX 聚合器，以获取最优汇率。
• 跨链桥接：通过 ChangeNow 支持不同区块链之间的资产桥接。
• 汇率查询：在交易前获取实时报价和滑点信息。
• 交易执行：接收用户地址和代币详情后自动执行交换。

支持的区块链

1. 比特币
2. 以太坊（包括 ERC-20 代币）
3. 币安智能链（包括 BEP-20 代币）
4. Polygon
5. Avalanche C-Chain
6. Solana

API 端点

端点	描述
GET /quotes	获取最佳交换报价
POST /swap	执行代币交换
GET /status	检查交易状态
GET /supported-chains	列出支持的所有区块链

使用条件

• 需要有效的 EmblemAI API 密钥（通过 EMBLEM_API_KEY 环境变量设置）。
• 用户必须提供有效的钱包地址（接收地址）。
• 输入的源代币和目标代币必须在该技能支持的网络和代币列表中。

如何使用

1. 获取报价：发送请求以获取交换汇率。
2. 确认交换：如果报价符合用户预期，则发起交换。
3. 跟踪状态：使用交易哈希检查交换状态。

示例 CLI 用法

# 获取 ETH 到 MATIC 的报价
curl -X GET "https://api.emblemai.com/v1/quotes?from=ETH&to=MATIC&amount=0.1" \
  -H "Authorization: Bearer $EMBLEM_API_KEY"

# 执行交换
curl -X POST "https://api.emblemai.com/v1/swap" \
  -H "Authorization: Bearer $EMBLEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "ETH",
    "to": "USDC",
    "amount": 0.5,
    "fromChain": "ethereum",
    "toChain": "polygon",
    "recipient": "0x..."
  }'

# 检查交换状态
curl -X GET "https://api.emblemai.com/v1/status?txHash=0x..." \
  -H "Authorization: Bearer $EMBLEM_API_KEY"

最佳实践

• 始终先调用 /quotes 以获取实时汇率和估计滑点。
• 在执行交换前验证用户地址是否正确。
• 如果汇率波动过大（例如超过 2%），考虑拒绝交易或通知用户。
• 记录所有交换以便审计。

错误处理

错误码	含义
400	请求参数缺失或无效
401	API 密钥无效
429	请求速率限制达到
500	内部服务器错误
503	链上服务暂不可用

安全注意事项

• 切勿在日志中暴露私钥或 API 密钥。
• 只接受来自受信用户或经过身份验证的请求的交换指令。
• 建议在交易前通过用户确认来防止误操作。
• 注意链上 gas 费用；如果费用过高，建议提示用户。