用途:面向 EVM(DeBank 支持的链)与 Solana 的多链钱包操作,涵盖余额查询、转账、签名与策略管理。属于脚本技能,无注册钱包工具,通过 bash 调用 core.skill_tools.wallet 中的 Python 函数并读取 JSON 结果。
主要能力与调用:wallet_info 获取代理钱包地址;get_user_wallets 读取用户自己的登录/次钱包(只读,来自环境变量);wallet_balance 查 EVM 余额(chain 必填,DeBank);wallet_sol_balance 查 Solana 余额(Birdeye);wallet_get_all_balances 一次查全部链;wallet_transfer 广播 EVM 交易(默认赞助 gas);wallet_sign_transaction 签名不广播;wallet_sign 做 EIP-191 签名;wallet_sign_typed_data 做 EIP-712 签名;wallet_transactions 查 EVM 历史;wallet_sol_transfer / wallet_sol_sign_transaction / wallet_sol_sign / wallet_sol_transactions 处理 Solana;wallet_get_policy、validate_and_clean_rules 处理策略。示例:python3 -c "from core.skill_tools import wallet; import json; print(json.dumps(wallet.wallet_balance(chain='base')))"。
用户钱包:代理钱包不是用户钱包。平台在容器启动及用户钱包操作时注入 USER_LOGIN_WALLET_ADDRESS/TYPE、USER_SECONDARY_WALLET_ADDRESS/TYPE。被问“我的钱包/我的余额”时读取这些,不要用代理钱包回答。为空表示未绑定,引导去 Web 应用绑定。这些钱包只读,代理不持私钥;查余额需传入地址。用户钱包交易不走脚本函数,走前端动作 user_wallet_tx,由用户在 UI 签名。
使用注意:EVM 金额单位为 wei(0.01 ETH = 10000000000000000);ERC-20 转账 amount 为 0、把调用数据编码进 data。EVM 默认赞助 gas,可用 sponsor=False 改为自付。策略默认关闭(允许全部),启用后交易需 UI 确认。支持 DeBank 支持的链,常见名自动映射。
策略:检查策略用脚本函数;提案策略必须用原生 frontend_action(action_type="update_wallet_policy"),需活动 SSE 会话,不能在后台任务执行,用户需在 UI 确认并签名,EVM 与 Solana 需分别调用两次。Privy 规则中 DENY 优于 ALLOW,切勿混用;enabled=true 时未显式允许即默认拒绝;exportPrivateKey 与通配符 * 可用空条件,交易类方法至少需一个条件;字段来源与操作符有固定集合。
限制:wallet_balance 必须传 chain,可用 wallet_get_all_balances 发现。其余细节暂未提供。