Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
支持 EVM 多链的原生代币和 ERC20 转账,自动构造交易、本地签名并通过 OKX API 广播上链
支持 EVM 多链的原生代币和 ERC20 转账,自动构造交易、本地签名并通过 OKX API 广播上链
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
这个 Skill 实现了完整的 EVM 链转账流程: 用户输入(私钥/地址/金额) ↓ 构造交易(自动获取 nonce、gas) ↓ 本地签名(私钥不离开本机) ↓ 通过 OKX API 广播到链上 ↓ 返回 tx_hash 和区块浏览器链接 支持两种转账类型: 原生代币转账:ETH、BNB、MATIC 等 ERC20 Token 转账:USDT、USDC 等任意 ERC20
满足以下条件时使用: 用户想发起一笔链上转账 用户提供了接收方地址和转账金额 私钥已通过环境变量配置好 不适用的情况: 用户想做 Swap(代币兑换)→ 使用 Swap Skill 用户只想查询余额或交易状态 → 使用查询工具 用户没有配置私钥环境变量 → 先引导配置环境变量
Step 1: 检查输入参数 ├── chain_index 是否在支持列表? ├── to_address 是否以 0x 开头? └── amount 是否大于 0? Step 2: 获取链上数据 ├── 获取当前 nonce └── 获取当前 gas price(Legacy 或 EIP-1559) Step 3: 构造交易 ├── 原生代币:直接构造 tx,gas 固定 21000 └── ERC20:调用 transfer(),动态估算 gas × 1.2 安全系数 Step 4: 本地签名 └── 使用私钥对交易签名,私钥不离开本机 Step 5: 广播到链上 └── 调用 OKX Broadcast API 发送签名交易 Step 6: 返回结果 ├── 成功 → 返回 tx_hash 和 explorer_url └── 失败 → 返回具体错误原因
类型:字符串 string 说明:区块链链 ID 当前支持: chain_index链名Gas 类型支持 MEV"56"BSCLegacy✅ 示例:"56" 注意:必须是字符串,56 ❌ "56" ✅
类型:字符串 string 说明:接收方钱包地址 格式:0x 开头,42 位十六进制字符 示例:"0xaF3e6407073b2793271dA3d45A393397517ee3d9"
类型:浮点数 float 说明:转账金额,人类可读单位 示例:0.01(表示 0.01 BNB),100.0(表示 100 USDT) 注意:脚本内部自动转换为链上精度(wei / raw units)
类型:字符串 string 说明:ERC20 Token 的合约地址 格式:0x 开头 示例:"0x55d398326f99059fF775485246999027B3197955"(BSC 上的 USDT)
类型:布尔值 boolean 默认值:false 说明:是否开启 MEV 保护,防止三明治攻击 注意:仅支持 MEV 的链才能开启,否则报错
字段类型说明order_idstringOKX 平台订单 IDtx_hashstring链上交易哈希explorer_urlstring区块浏览器链接 成功输出示例: ✅ BSC 广播成功 Order ID: 1234567890 Tx Hash: 0xabc123... 浏览器: https://bscscan.com/tx/0xabc123...
返回具体错误原因,见下方错误处理章节。
变量名说明WALLET_PRIVATE_KEY钱包私钥(0x 开头)OKX_ACCESS_KEYOKX Web3 API KeyOKX_SECRET_KEYOKX Secret KeyOKX_PASSPHRASEOKX Passphrase ⚠️ 必须使用 OKX Web3 API Key,普通交易 API Key 会返回 401 错误。 配置方式(写入 ~/.zshrc 永久生效): export WALLET_PRIVATE_KEY="0x你的私钥" export OKX_ACCESS_KEY="你的Key" export OKX_SECRET_KEY="你的Secret" export OKX_PASSPHRASE="你的Passphrase" source ~/.zshrc
from scripts.broadcast_sign_transfer import BroadcastTransaction bt = BroadcastTransaction(chain_index="56") # 原生代币转账 result = bt.transfer_native( to_address="0xRecipient...", amount=0.01, enable_mev_protection=False, ) print(result.summary()) # ERC20 转账 result = bt.transfer_token( token_address="0x55d398326f99059fF775485246999027B3197955", # BSC USDT to_address="0xRecipient...", amount=100.0, enable_mev_protection=False, ) print(result.summary())
# 原生代币转账 python3 scripts/broadcast_sign_transfer.py --chain 56 native \ --to 0xRecipient... \ --amount 0.01 # ERC20 转账 python3 scripts/broadcast_sign_transfer.py --chain 56 token \ --token 0x55d398326f99059fF775485246999027B3197955 \ --to 0xRecipient... \ --amount 100 # 开启 MEV 保护 python3 scripts/broadcast_sign_transfer.py --chain 56 native \ --to 0xRecipient... \ --amount 0.01 \ --mev
转账类型Gas 处理方式原生代币固定 21000(EVM 协议层常量)ERC20 Tokeneth_estimateGas 动态估算 × 1.2 安全系数 Gas 价格根据链类型自动切换: Legacy(BSC):使用 gasPrice EIP-1559(ETH/Polygon 等):使用 maxFeePerGas + maxPriorityFeePerGas
错误信息原因解决方法暂不支持链 {chain_index}链未在支持列表中检查 chain_index 是否正确to_address 格式错误地址不以 0x 开头检查地址格式amount 必须大于 0金额为负数或 0输入正确金额余额不足ERC20 余额不够检查钱包余额链 {chain_index} 不支持 MEV 保护该链不支持 MEV关闭 enable_mev_protection401 Unauthorized使用了普通 API Key确认使用 OKX Web3 API Key广播失败(code=xxx)OKX API 返回错误检查 API 凭证和交易数据缺少 OKX API 凭证环境变量未配置配置四个环境变量后重试缺少钱包私钥WALLET_PRIVATE_KEY 未配置配置私钥环境变量
⚠️ 私钥通过环境变量传入,不要硬编码在代码里 ⚠️ 广播成功不代表交易成功,需通过 explorer_url 确认链上状态 ⚠️ 广播后的交易无法撤销,请在调用前确认地址和金额正确 ⚠️ ~/.zshrc 是明文存储,确保只有自己能访问该文件
pip3 install requests web3
broadcast-sign-transfer/ ├── broadcast_sign_transfer.md ← 当前文件,AI 技能说明书 └── scripts/ └── broadcast_sign_transfer.py ← 可执行的 Python 客户端
chain_index链名Gas 类型MEV 保护浏览器56BSCLegacy✅bscscan.com v1.0.0 仅支持 BSC,更多链将在后续版本中陆续支持。
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.