Bitget Wallet Skill

Bitget Wallet Skill

概述

一项 AI Agent 技能，封装了 Bitget Wallet API，支持通过自然语言查询链上数据和执行 Swap 操作。

设计原则

原则	描述
领域知识 + 工具	不只是 API 封装，还包括 Swap 流程（参见 docs/swap.md）、签名指南、安全模型和已知问题，帮助 Agent 做出明智决策
零外部依赖	所有代码均自包含。Solana 签名使用纯 Python 实现（内置 Ed25519 + base58）。EVM 签名使用 eth_account（标准实现）。API 调用仅依赖 requests。Solana 无需 pip install
API 基础设施，而非重新实现	功能来自 Bitget Wallet 的生产 API。该技能提供知识和工具层，而非平行实现
默认采用人在回路模式	Swap 操作会生成交易数据，但绝不会自主签名。所有资金转移操作都需要用户确认

市场工具架构

市场侧仅负责代币发现与分析——不涉及交易、钱包或签名。技能层负责计算评分和规则；后端提供原始数据。

Atomic Tools (Agent orchestrates)
├── bgw_token_find      Find tokens (chain scan / search / rankings / sectors)
├── bgw_token_check     Check tokens (security / dev / anti-manipulation / signals / market)
├── bgw_token_analyze   Analyze tokens (deep: timeline / trades / holdings / smart money)
├── bgw_alpha           Alpha intelligence (gems / signals)
├── bgw_address_find    Find addresses (by pool / role / criteria)
└── bgw_address_analyze Analyze addresses (scoring / PnL / style / operations / comparison)

Smart Tools (We orchestrate)
├── bgw_combo    Smart combos (token + address permutation recipes)
└── bgw_monitor  Continuous monitoring (token signals / address activity / price alerts)

核心能力

能力	描述	示例
Launchpad 扫描器	扫描新池子（pump.fun、four.meme 等），支持 15 种以上筛选条件	“扫描 pump.fun 上 MC >$10K 的待发行代币”
代币搜索（v3）	按关键词/合约搜索，支持按 market_cap 排序和 risk_level 筛选	“查找 ETH 上的 PEPE，并按市值排序”
代币市场信息	价格、MC、FDV、流动性、57 个交易池交易对、叙事、价格变动	“显示 Lobstar 的完整市场信息”
开发者分析	开发者地址、Rug 历史、LP 锁定、持仓、迁移历史	“查看此代币的开发者历史”
安全审计	Honeypot/mint/proxy、买入/卖出税及风险检查（EVM 和 Solana）	“这个合约安全吗？”
K 线 + 智能信号	K 线图，标记 KOL/聪明钱交易，并显示热度等级	“显示此代币上的聪明钱活动”
交易动态	多时间窗口买入/卖出压力、地址质量及刷量检测	“交易活动情况如何？”
交易分析	带标签的交易（聪明钱/KOL/开发者），支持筛选	“显示此代币上的 KOL 交易”
持有者分析	Top100 分布 + PnL + 标签分类（CEX/聪明钱/KOL）	“谁在持有这个代币？”
聪明钱分析	盈利地址统计 + 顶级盈利者列表	“聪明钱地址是否盈利？”
代币对比	并排对比两个代币的 K 线	“对比 BONK 与 WIF 的价格走势”
地址发现	按角色查找 KOL / 聪明钱地址，并按表现筛选	“查找 Solana 上胜率 >80% 的顶级聪明钱地址”
社交登录钱包	通过 Bitget Wallet TEE 签署交易/消息——无需本地私钥	“用我的 Bitget Wallet 签署此交易”
余额查询	按链/地址/代币查询链上余额（原生代币 + ERC-20/SPL）	“我的 BNB 余额是多少？”
余额 + 价格	单次调用批量查询余额及其 USD 价格	“我的投资组合价值多少？”
代币信息	价格、市值、持有者、社交链接	“SOL 的价格是多少？”
K 线数据	1m/5m/1h/4h/1d 蜡烛图数据，含买入/卖出明细	趋势分析、买入压力
交易统计	5m/1h/4h/24h 买入/卖出交易量和交易者数量	活跃度检测、巨鲸监控
排行榜	涨幅榜 / 跌幅榜 / Hotpicks（精选热门代币）	市场扫描、发掘 Alpha
流动性池	LP 池信息	滑点估算、深度分析
历史代币	按时间戳发现新代币（分页）	“今天发行了哪些代币？”
代币风险检查	兑换前检查源/目标代币的安全性（检测是否禁止买入）	“这个代币买入安全吗？”
兑换报价	为同链/跨链兑换提供多个市场的报价	“1 SOL 可以兑换多少 USDC？”
兑换确认	获取所选市场的最终报价和 orderId	锁定价格和路由
兑换创建订单	生成待签名的未签名交易数据	通过钱包签名执行交易
兑换发送	提交已签名的交易	在 MEV 保护下广播交易
订单详情	跟踪订单生命周期（处理中→成功/失败）	“查看我的兑换状态”
代币转账	直接进行链上代币转账（EVM + Solana），由服务端广播	“向 0xDeF... 发送 100 USDT”
免 Gas 转账	无需原生 Gas 即可转账——Gas 费用从 USDT/USDC 余额中扣除	“在 Base 上发送 USDC，无需 ETH 支付 Gas”
x402 付款	使用 Base 上的 USDC 为支持 x402 的 API 付款	“访问此付费 API 端点”

⚠️ 兑换金额使用人类可读格式——0.1 USDT 请传入 0.1，而非 100000000000000000。响应中的 toAmount 也使用人类可读格式。这与大多数链上 API 不同。

✨ 订单模式 — 免 Gas 和跨链兑换

兑换流程提供了其他 AI Agent 兑换技能都不具备的两项功能：

⛽ 免 Gas 交易（EIP-7702）

• 即使原生代币余额为零，也能兑换代币——无需 ETH、BNB 或 MATIC
• Gas 费用会自动从输入代币中扣除
• Agent 只需签名；后端中继器负责支付 Gas 并广播交易
• 支持所有 EVM 链（Ethereum、Base、BNB Chain、Arbitrum、Polygon、Morph）

🌉 一步式跨链兑换

• 在单笔订单中兑换不同链上的代币——无需手动跨链桥接
• 示例：Base 上的 USDC → BNB Chain 上的 USDT，一次 API 调用，一次签名
• 与免 Gas 结合：在源链上无需 Gas 即可进行跨链兑换

工作原理：

1. quote          → Get multi-market quotes
2. confirm        → Final quote from chosen market, get orderId
3. makeOrder      → Create unsigned transaction data
4. Sign           → Agent signs with wallet key
5. send           → Submit signed data
6. getOrderDetails → Track until success

示例 — 同链兑换：

# Quote: BNB USDT → USDC
python3 scripts/bitget-wallet-agent-api.py quote \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress

# Confirm with chosen market
python3 scripts/bitget-wallet-agent-api.py confirm \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress \
  --market bgwevmaggregator --protocol bgwevmaggregator_v000 \
  --slippage 0.01 --feature user_gas

💳 x402 付款 — 按请求付费的 API 访问

x402 是一项适用于 HTTP 原生付款的开放标准。当 Agent 遇到付费 API（HTTP 402）时，会签署 USDC 授权并重试——无需账户，也无需 API 密钥。

工作原理：

1. Agent requests a resource → gets HTTP 402 + payment requirements
2. Agent signs EIP-3009 TransferWithAuthorization (gasless, off-chain)
3. Agent retries with PAYMENT-SIGNATURE header
4. Service's facilitator settles on-chain → agent gets the resource

主要功能：

• 真正免 Gas — Agent 只需支付 USDC，付款服务商会赞助 Gas
• 无需账户 — 钱包地址就是你的身份
• 适用于任何 x402 服务 — Pinata IPFS、DiamondClaws DeFi 数据，以及另外 100 多项服务

# Example: pay $0.001 for Pinata IPFS upload
python3 scripts/x402_pay.py pay \
  --url "https://402.pinata.cloud/v1/pin/private?fileSize=100" \
  --private-key <key> --method POST --data '{"fileSize": 100}' --auto

有关领域知识、签名详情和测试指南，请参阅 docs/x402-payments.md。

💸 免 Gas 代币转账

直接进行链上代币转账，由服务器负责构建、广播和跟踪交易。支持免 Gas 模式——Gas 费用从稳定币余额（USDT/USDC）中支付，而非原生代币。

工作原理：

transfer_make_sign_send.py / social_transfer_make_sign_send.py
  → makeTransferOrder + sign + submitTransferOrder (one shot)
  → poll getTransferOrder until SUCCESS or FAILED

主要功能：

• 免 Gas（EIP-7702 / FeePayer） — 原生 Gas 为零也能转账。Gas 费用从 USDT/USDC 余额中扣除
• 多链 — ETH、BNB、Base、Arbitrum、Polygon、Morph、Solana
• 服务器端广播 — 客户端只需签名，服务器负责 nonce 管理和链上跟踪
• 明确回退 — 如果无法使用免 Gas 模式，会先提示确认，再回退到标准转账

# Standard EVM token transfer
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain eth --contract 0xdAC17F958D2ee523a2206206994597C13D831ec7 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 100

# Gasless transfer (no ETH needed for gas)
python3 scripts/transfer_make_sign_send.py --private-key-file /tmp/.pk_evm \
  --chain base --contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 \
  --from-address 0xAbC... --to-address 0xDeF... --amount 50 --gasless

# Poll status
python3 scripts/bitget-wallet-agent-api.py get-transfer-order --order-id <orderId>

有关领域知识、签名模式和免 Gas 详情，请参阅 docs/transfer.md。

支持的链

Ethereum · Solana · BNB Chain · Base · Arbitrum · Tron · TON · Sui · Optimism 等。

---

架构

Natural Language Input
    ↓
AI Agent (OpenClaw / Dify / Custom)
    ↓
bitget-wallet-agent-api.py (Python 3.9+)
    ↓  ← Token auth (no API key needed)
Bitget Agent API (copenapi.bgwapi.io)
    ↓
Structured JSON → Agent interprets → Natural language response

安全设计：

• 无需 API 密钥或 HMAC 签名 — 使用基于令牌的身份验证
• 兑换 calldata 用于生成交易数据；签名需要明确访问钱包密钥
• **钱包密钥管理：**助记词存储在安全存储中，私钥按需派生，并在每次签名操作后销毁（从不持久化）

---

Agent 使用场景

1. 个人研究助手

“检查这款 Solana Meme 币是否安全，并为我提供价格报价。”

• 在单次查询中获取代币信息、安全审计和价格
• 适用对象：个人交易者、研究人员
• 平台：Telegram Bot、Discord Bot、OpenClaw

2. 投资组合管理 Agent

“我现在的投资组合总值是多少？”

• 跨链、跨代币批量查询并计算净值
• 定时快照 + K 线数据，用于历史跟踪
• 适用对象：DeFi 用户、基金经理
• 平台：OpenClaw cron + Telegram alerts

3. 市场监控 / 警报 Agent

自动扫描涨幅榜前列的代币，检测异常并推送警报

• 综合排名、交易量和安全审计
• 发现热门代币 → 自动运行安全审计 → 过滤蜜罐代币 → 通知用户
• 适用对象：链上 Alpha 挖掘者
• 平台：Cron jobs、Dify workflows

4. 半自动交易 Agent

“用 1 SOL 买入这款代币”

• 兑换报价 → 显示路由和滑点 → 用户确认 → 生成 calldata → 钱包签名
• 人工参与决策 — Agent 无法独立签名
• 适用对象：希望使用 AI 助手的活跃交易者
• 平台：OpenClaw + Bitget Wallet App / 硬件钱包

5. 套利机器人数据层

监控 DEX 价格差异，发现跨链套利机会

• 比较多链兑换报价，计算价差
• 结合 CEX 数据，监控 DEX-CEX 价差
• 适用对象：量化团队
• 平台：自定义 Python 脚本、OpenClaw 子 Agent

6. 社区服务机器人

有人在群聊中问“XX 币多少钱？”——机器人自动回复

• 轻量查询，快速响应
• 安全审计功能还可兼作反诈骗保护
• 适用对象：Telegram/Discord 社区
• 平台：Telegram Bot + OpenClaw 技能

7. Dify / LangChain 工具节点

集成到 Dify 工作流中作为工具使用，或集成到 LangChain Agent 中

• bitget-wallet-agent-api.py 可直接用作 Dify Code 节点或外部 API 工具
• 也可封装为 MCP Server，供任何兼容 MCP 的 Agent 框架使用
• 适用对象：企业级 Agent 平台集成

---

快速开始

先决条件

1. Python 3.9+
2. requests 库（pip install requests）
3. 如需 EVM 签名：eth-account（pip install eth-account）

无需 API 密钥——Agent API 使用基于令牌的身份验证，并内置请求头。

Solana 签名无需额外安装任何软件包——纯 Python Ed25519 和 base58 已内置在 order_sign.py 中。

示例

# Get SOL price
python3 scripts/bitget-wallet-agent-api.py token-price --chain sol --contract ""

# Security audit for a token
python3 scripts/bitget-wallet-agent-api.py security --chain sol --contract <contract_address>

# Swap quote (5 USDT → USDC on BNB Chain)
python3 scripts/bitget-wallet-agent-api.py quote \
  --from-chain bnb --from-contract 0x55d398326f99059fF775485246999027B3197955 \
  --from-symbol USDT --from-amount 5 \
  --to-chain bnb --to-contract 0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d \
  --to-symbol USDC \
  --from-address 0xYourAddress --to-address 0xYourAddress

---

支持的链（兑换）

链	同链	跨链	免 Gas
Ethereum	✅	✅	✅
BNB Chain	✅	✅	✅
Base	✅	✅	✅
Arbitrum	✅	✅	✅
Polygon	✅	✅	✅
Morph	✅	✅	✅
Solana	✅	✅	✅
Tron	✅	✅	✅

行情数据命令支持 32+ 条链。完整列表请参阅 docs/market-data.md。

未来方向

方向	描述
Solana 高级兑换	现已全面支持 Solana 免 Gas ✅ 和跨链兑换 ✅（同链 + Sol↔EVM）
链上事件订阅	通过 WebSocket 监听大额交易和新建流动性池
历史数据缓存	将 K 线和价格数据存储在本地 SQLite 中，以减少 API 调用
多钱包管理	支持多地址余额查询和批量报价
风险规则引擎	将安全审计结果与自定义规则（黑名单、最低流动性阈值）结合

---

兼容平台

✅ 已测试并验证

平台	状态	备注
OpenClaw	✅ 通过	原生技能支持
Manus	✅ 通过	自动安装并执行
Bolt.new	✅ 通过	自动克隆仓库并运行所有命令
Devin	✅ 通过	读取 SKILL.md，安装依赖，并返回正确数据
Replit Agent	✅ 通过	完整项目设置，包含 Web 前端

🔧 应该可用（文件系统 + Python + 网络访问）

平台	类型	使用方法
Claude Code	命令行 Agent	克隆仓库，将 SKILL.md 添加到项目上下文中
Codex CLI	命令行 Agent	克隆仓库，在 AGENTS.md 中引用
Cursor	IDE Agent	克隆到项目中，或使用 MCP 版本
Windsurf	IDE Agent	克隆到项目中，或使用 MCP 版本
Cline	VS Code Agent	克隆到项目工作区中
Aider	命令行 Agent	将脚本添加到项目中
OpenHands	编码 Agent	使用具有完整文件系统的 Docker 沙箱
SWE-agent	编码 Agent	在沙箱中访问 Shell
Dify	工作流平台	用作 Code 节点或外部 API 工具
Coze	Agent 平台	导入为插件或 API 工具
LangChain / CrewAI	框架	将 bitget-wallet-agent-api.py 封装为工具

💡 兼容性规则

任何能够读取文件 + 运行 Python + 访问互联网的 AI Agent 都应该可以使用此技能。

---

相关项目

• bitget-wallet-mcp — 面向 Claude Desktop / Cursor / Windsurf 的 MCP 服务
• bitget-wallet-cli — 面向终端用户的命令行工具

---

安全说明

• 无需 API 密钥 — 使用基于令牌的身份验证（无需管理密钥）
• Swap 函数会生成报价和交易数据 — 签名需要明确授权访问钱包
• 钱包助记词是唯一的持久密钥；私钥按操作派生，用后即弃
• 执行大型操作需要用户明确确认（人工介入）
• 与任何代币交互前，务必运行安全审计（security 命令）

安全

• Solana 无外部依赖 — order_sign.py 内置纯 Python Ed25519（RFC 8032）和 base58。EVM 使用 eth_account。没有晦涩难用的软件包，也没有供应链风险。
• 仅与 https://copenapi.bgwapi.io（Agent API）和 x402 资源服务通信 — 不连接其他外部端点
• 不使用 eval() / exec() 或动态代码执行
• 不访问技能目录之外的文件系统
• 不收集数据、遥测信息或分析数据
• 不访问敏感文件（SSH 密钥、凭据、钱包文件等）
• 建议在安装前自行审计源代码

许可证

MIT