bitget-wallet-skill:把智能合约调用装进可确认的流程
AI 助手能替你查余额、读行情,但让它真正发起一笔链上兑换,你放心吗?bitget-wallet-skill 是 Bitget Wallet AI Lab 给出的一个答案:把钱包的生产 API 封装成一组工具,让模型负责理解意图、编排流程,而把智能合约调用前的签名权留给用户。下面以一个人工设定的假设场景为主线,拆开它的机制与取舍。
一次 5 USDT 兑换,AI 助手要跨过哪几道坎
假设一位用户对助手说:把 BNB Chain 上的 5 USDT 换成 USDC,顺便看看目标代币的智能合约安不安全。README 的兑换示例是把 5 USDT 换成 USDC。示例只走到报价,不会替用户签名。也就是说,模型可以替你把信息准备好,却不能替你把钱花出去。
这句话背后藏着六件事:找到代币合约地址、拿到多市场报价、确认路由与滑点、判断合约风险、准备 gas、签名并广播。难点不在调用接口,而在于每一步都不可撤销:报价会过期,滑点会变化,签错一笔就无法回滚。所以一个能用的助手,需要明确的流程编排与权限边界,而不是更强的模型。
它不重写链上逻辑,而是把生产 API 包成工具层
bitget-wallet-skill 是 Bitget Wallet AI Lab 维护的公开项目。先说身份:该项目是一个封装 Bitget Wallet API 的 AI Agent 技能包,支持自然语言驱动的链上数据查询与兑换。skill 可以理解为交给 agent 的一份操作规程加一套可执行脚本。
README 列出四条设计原则。一是领域知识加工具,除接口封装外还附兑换流程、签名指南、安全模型与已知坑。二是零外部依赖:Solana 签名用内置的 Ed25519 与 base58 纯 Python 实现,不需要额外安装包。EVM 签名用 eth_account,HTTP 只用 requests。三是能力来自 Bitget Wallet 的生产 API,而不是另写一套并行实现。四是默认人在环路:兑换操作只生成交易数据,从不自主签名,所有动钱动作都要用户确认。
无 gas 与一步跨链,靠订单模式而不是本地拼交易
Order Mode 是这个项目最值得注意的部分,它带来两种能力。第一种是无 gas 兑换:账户里可以没有任何原生代币,不需要 ETH、BNB 或 MATIC。无 gas 兑换时,gas 从输入的代币里自动扣除。此时 agent 只负责签名,由后端中继服务付 gas 并广播。README 标注这依赖 EIP-7702,一个与以太坊账户能力相关的提案,资料只给了编号,没有展开原理。
第二种是一步跨链。跨链兑换被装进同一张订单,不需要手动过桥。例如 Base 上的 USDC 换成 BNB Chain 上的 USDT,一次接口调用、一次签名即可完成;再叠加无 gas,源链上可以零 gas 跨链。README 没有给出跨链订单失败后的回滚细节,这一点尚待确认。
从报价到订单详情:六步里每一步由谁负责
兑换被拆成报价、确认、生成未签名交易、签名、提交、追踪订单六步。quote 拿多市场报价;confirm 选定市场,得到最终报价和 orderId;makeOrder 产出未签名的交易数据;随后由钱包签名;send 提交已签名数据;getOrderDetails 一直追踪到成功或失败。
有一个容易踩的坑。金额是人类可读的,传 0.1 表示 0.1 USDT,而不是 100000000000000000。响应里的 toAmount 同样是人类可读数值,这与多数链上接口的习惯相反。另外,兑换前可对 from 与 to 两个代币做禁买检测,属于下单前的风险检查,而不是事后补救。
私钥只在签名那一刻存在:编排权与签名权分开
安全设计上,README 强调几件事。助记词是唯一长期保存的秘密,私钥按需派生、签名后丢弃,不落盘。调用不需要 API key 或 HMAC 签名,用的是 token 认证。代码只与 copenapi.bgwapi.io 和 x402 资源服务器通信。它没有 eval 或 exec 这类动态执行,也没有数据采集与遥测。README 还建议在与任何代币交互前,先跑一次 security 命令。
我把它理解为:agent 拥有编排权,可以查、可以算、可以组装交易,但不拥有签名权。市场侧的工具也被限定在代币发现与分析范围内,不做交易、钱包和签名。
谁适合用:研究员、社群机器人到半自动交易
README 给出七类用法。个人研究助手,一次问清代币安全性、行情和报价;组合管理,批量查余额并带上美元价格算净值;行情监控,把涨幅榜、成交量与安全审计串起来,先筛掉蜜罐再推送;半自动交易,报价、展示路由与滑点、用户确认、生成 calldata、钱包签名;套利数据层,多链报价对比算价差;社群问答机器人,用轻量查询加快响应;它也可以被包装成 MCP Server,供兼容 MCP 的 agent 框架调用。
平台方面,README 把 OpenClaw、Manus、Bolt.new、Devin、Replit Agent 列为已测试通过,其余环境按「能读文件、能跑 Python、能联网」推断应当可用。这些都是作者描述,本文未做验证。
资料没说的部分:审计、实测与链支持的口径差异
先说清楚:本文没有独立实测,没有跑脚本、没有验证接口返回,也没有审计代码。README 建议安装前自行审计源码。这句话应当被认真对待,因为签名相关代码一旦出错,代价不可逆。
其次是口径差异。项目简介说支持 7 条 EVM 链加 Solana,而 README 的兑换表列出 Ethereum、BNB Chain、Base、Arbitrum、Polygon、Morph、Solana、Tron,并标注同链、跨链、无 gas 均支持;支持链一节还列出 TON、Sui、Optimism 等。无 gas 转账没有开关,由服务端根据原生币余额自动选择。要确认是否走了无 gas,需要看返回里的 gasAccount 字段。哪些链实际可用,尚待确认。
装之前,先确认环境、密钥与权限边界
第一,环境。运行环境需要 Python 3.9 以上,EVM 签名还要安装 eth-account,HTTP 调用依赖 requests。Solana 签名不需要额外包。第二,秘密放哪。示例用 --private-key-file 指向本地文件,助记词则应进安全存储,不要写进对话或代码仓库。
第三,钱怎么动。先跑只读命令,比如查价、查余额、安全审计,确认链路通畅再考虑 quote 与签名;只读这一步没有捷径,大额操作务必保留人工确认。第四,边界在哪。它依赖 Bitget Wallet 的后端服务,服务端策略、费率与可用链都可能变化,项目不承诺收益,也不替你承担滑点与合约风险。
README 标注为 MIT 许可,属于公开项目;仓库同时说明无需 API key,并建议使用者自行审计源码。把它当成查询与分析工具先跑通,再决定是否放开签名环节,是更稳妥的顺序。本文仅依据README资料整理,未独立实测。
参考来源
本文仅据固定版本 README 整理,未独立实测;仅作技术介绍,不构成安全审计或投资建议。
采集时间:2026-10-31T08:09:30.248Z;257 Star 快照。相对 2026-10-30T07:08:51.774Z,实际间隔 25.01 小时净变化 2 Star;不是自然日新增。
bitget-wallet-ai-lab/bitget-wallet-skill README · 9175a19d9a71db24de97ef7e4b2f060af5e8fe8b
本文基于公开媒体报道整理,仅作信息参考,不构成任何投资依据,内容以原文为准。





