【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载本指南是 OKX Agentic Wallet 技能 中onchainos wallet命令组的权威 CLI 参考覆盖账户登录与切换、余额查询、代币发送、交易历史、合约调用与消息签名等全部子命令的精确语法、参数语义与关键返回字段。读完本文你将能够在 Agent 工作流中正确构造钱包操作命令、解析返回 JSON 中的资金与交易字段并掌握 Confirming 二次确认、Gas StationSolana 稳定币付 gas、MEV 保护等高级用法避免资金丢失类误操作。1. 认识onchainos wallet统一钱包入口在 OKX Onchain OS 技能体系中onchainos是统一 CLIwallet是其最重要的命令组之一。钱包生命周期内的所有操作——登录认证、余额查看、转账、历史查询、合约调用和消息签名——都由wallet下的子命令承载。根据 SKILL.md 的 Intent Routing 规则当用户表达“登录/连接/验证 OTP/API-Key 登录/退出”“我的钱包地址/二维码”“发送原生或 ERC-20/SPL 代币”“调用合约approve/deposit/withdraw”“查询交易历史”“签名消息”等意图时均路由到本文档对应的命令。使用原则有三条务必先记住CLI 是唯一事实来源当不确定某个子命令的 flag、默认值或返回字段结构时先运行onchainos wallet subcommand --help或查阅对应领域的-cli-reference.md任何改变状态的命令前必须确认展示将要执行的命令获得用户明确同意后才执行--chain同时接受数字链 ID 与人名如1/501/196与ethereum/solana/xlayer解析规则与支持矩阵见 _shared/chain-support.md若对链名没有 100% 把握先运行onchainos wallet chains查询。会话开始前还应按 _shared/preflight.md 运行一次onchainos preflight --skill-version 版本号它会自动更新二进制与技能文件、校验完整性并读取data.action决定是否提示用户处理更新。2. Account认证与账户生命周期Account 组覆盖从 OTP 登录到账户切换、地址查询、退出登录的全流程是后续所有需要认证命令balance、send、contract-call、history、sign-message的前置条件。2.1wallet login [email]—— 启动登录onchainos wallet login [email] [--locale locale] [--force]参数必填说明email否接收 OTP 的邮箱省略则进行静默 API-Key 登录--locale否OTP 邮件语言下划线形式zh_CN、en_US、ja_JP无法识别的值回退到en_US语言不确定时省略--force否重新登录跳过账户切换确认仅在一次 Confirming 响应之后使用带 email向邮箱发送一次性验证码OTP随后用wallet verify otp完成登录不带 email静默 API-Key 登录CLI 从环境变量OKX_API_KEY/OKX_SECRET_KEY/OKX_PASSPHRASE读取凭证成功返回email-OTP 方式返回{}静默 AK 登录返回accountId/accountName。需要注意wallet login可能返回 Confirming 响应详见第 9 节其message若包含 “not the account you used last time” 英文判别短语则需按 Confirming Response 规则处理用户确认后加--force重跑。2.2wallet verify otp—— 校验验证码校验邮件收到的 OTP 以完成登录。返回accountId、accountName以及isNewtrue表示新用户需触发 Policy 与 Wallet Export 模板见 wallet-portal-actions.mdfalse则跳过。2.3wallet add—— 添加新账户在当前登录用户下新增一个账户并自动切换到它无需手动switch。返回accountId、accountName。注意首次登录会自动创建第一个账户绝不要为它调用wallet add只有已登录且用户明确要另一个账户时才用。2.4wallet switch account_id—— 切换活动账户将当前活动账户切换到指定account_id。2.5wallet status—— 登录状态与策略显示登录状态与当前活动账户。返回字段包括email、loggedIn、currentAccountId、currentAccountName、accountCountpolicy未设置时为null包含singleTxLimit/singleTxFlag单笔交易限额dailyTransferTxLimit/dailyTransferTxFlag/dailyTransferTxUsed每日转账限额及已用额度dailyTradeTxLimit/dailyTradeTxFlag/dailyTradeTxUsed每日交易限额及已用额度loginTypeemail或ak。策略Policy规则是有限的固定集合——单笔限额、每日转账限额、每日交易限额、转账白名单——不要虚构或提及列表之外的规则。策略配置与钱包导出必须在 Web 门户完成Agent 只负责检测触发场景并输出 wallet-portal-actions.md 中的 verbatim 模板且永远不得在对话中展示助记词、私钥或种子短语。2.6wallet addresses—— 查询钱包地址onchainos wallet addresses [--chain chain]按链类别XLayer / EVM / Solana展示钱包地址。地址完整性是资金丢失风险的关键防线任何展示给用户的链上标识钱包地址、txHash、签名、合约地址必须逐字逐字符复制自最近一次 CLI 标准输出绝不凭记忆复述。需要精确地址时重新调用本命令或wallet status并原样复制。2.7wallet qrcode --address addr—— 生成收款二维码用 Unicode 方块渲染--address内容的二维码不加任何 URI scheme。输出是 stdout 上的纯文本图案必须在等宽monospace代码块中原样渲染。2.8wallet logout—— 退出并清除凭证登出并清除本地存储的凭据。2.9wallet chains—— 支持的链列表列出支持的链。展示时用showName作为显示名用realChainIndex作为--chain的值。虽然 chain-support.md 明确 7 条链支持钱包地址创建XLayer196、XLayer Testnet1952、Solana501、Ethereum1、Base8453、BSC56、Arbitrum42161但交互支持的链超过 17 条如 Polygon、Avalanche、Optimism完整清单以wallet chains为准。3. Balance余额与持仓3.1wallet balanceonchainos wallet balance [--all] [--chain chain] [--token-address addr] [--force]参数默认说明--allfalse批量查询所有账户资产仅当用户明确要求查看全部账户时使用--chainall链名或链 ID与--token-address同时使用时必填--token-address—单个代币合约地址要求同时提供--chain--forcefalse绕过缓存重新拉取账户与余额关键返回字段totalValueUsd总价值USDevmAddress、solAddress对应链上的地址accountCount账户数量details[]代币余额分组。使用--all时details变为accountId → cache entry的映射每条包含totalValueUsd、updatedAt、data。3.2 代币资产的固定 9 字段结构无论details[].tokenAssets[]、assets[]还是--all模式下的details.accountId.data[].tokenAssets[]每个代币条目都恰好包含以下 9 个字段这是解析余额时必须依赖的稳定 schema字段类型说明symbolString代币符号如ETHtokenNameString代币全名如EthereumchainIndexString链标识如1tokenAddressString代币合约地址原生代币为balanceStringUI 单位余额rawBalanceString最小单位余额decimalString代币精度decimalstokenPriceString代币 USD 价格usdValueString|Number代币 USD 价值表示形式按返回原样保留展示规则来自 SKILL.md Amount Display Rules代币数量用UI 单位如1.5 ETHUSD 价值保留2 位小数小于0.01时显示全精度大额用缩写$1.2M、$340K持仓按 USD 价值降序排列代币地址展示为缩写形式0x1234...abcd原生代币空tokenAddress标为(native)。若发现疑似 wrapped/bridged 变体wETH、stETH、wBTC、xOKB等与基础代币价差超过 50%应加price unverified标记并建议用onchainos token price-info交叉核对。4. Send发送原生与合约代币4.1wallet sendonchainos wallet send --readable-amount amount --recipient address --chain chain \ [--from address] [--contract-token address] [--force] \ [--gas-token-address address] [--relayer-id id] [--enable-gas-station]参数必填说明--readable-amount二选一人类可读金额CLI 自动换算为最小单位。优先使用--amt二选一原始最小单位金额与--readable-amount互斥--recipient是收款地址EVM 为0x开头Solana 为 Base58--chain是链名或链 ID--from否发送方默认为所选账户在该链上的地址--contract-token否ERC-20 / SPL 代币合约省略则为原生代币--force否在一次确认过的 Confirming 响应后重跑--gas-token-address、--relayer-id、--enable-gas-station否Gas Station仅 Solana来自 Confirming 响应的第二阶段值绝不能出现在首次调用返回txHash正常路径。Gas Station 场景返回gasStationUsed、orderId及 Confirming 场景字段处理细节见 gas-station.md。模拟失败时CLI 会给出executeErrorMsg且不会广播——此时向用户展示错误信息绝不要强制广播。4.2 意图判别Send vs Contract Call这是资金安全的关键决策点wallet.md 给出了明确判别表用户意图命令示例发送原生代币ETH、SOL、BNB…wallet send --chain chain“Send 0.1 ETH to 0xAbc”发送 ERC-20 / SPL 代币USDC、USDT…wallet send --chain chain --contract-token“Transfer 100 USDC to 0xAbc”与合约交互approve、deposit、withdraw、自定义调用wallet contract-call --chain chain“Approve USDC for spender”意图模糊时必须询问用户绝不猜测。contract-call只用于非 swap 交互DEX 兑换必须走swap execute绝不能用contract-call广播。任何contract-call之前应运行onchainos security tx-scan做安全检查。5. History交易历史与订单状态5.1 列表模式与详情模式提供--order-id/--tx-hash/--uop-hash任一标识符 →详情模式单条记录否则 →列表模式分页。# 列表 onchainos wallet history [--account-id id] [--chain chain] [--begin ms] [--end ms] [--page-num cursor] [--limit n] # 详情任选其一标识符 onchainos wallet history --chain chain --order-id id onchainos wallet history --chain chain --tx-hash hash [--address addr] onchainos wallet history --chain chain --uop-hash hash关键规则详情模式必填--chain缺失时询问用户属于哪条链见 wallet-troubleshooting.mdGas Station 广播刚结束时优先用--order-id轮询txHash 可能是异步返回的列表模式始终传--limit页大小默认 20与--page-num页码进行分页详情模式返回单条记录不要传--limit空cursor表示没有更多页查无记录时展示 “No transactions found”这不是错误。5.2 返回字段与状态码列表字段cursor、orderList[]其中每条包含txHash、txStatus、txTime、directionsend/receive、chainSymbol、coinSymbol、coinAmount、serviceCharge、confirmedCount、assetChange[]coinSymbol/coinAmount/directionin/out。详情模式额外增加failReason、explorerUrl、input[]、output[]。交易状态码0Pending待处理1Success成功2Failed失败3Pending confirmation待确认txTime是Unix 毫秒时间戳展示时必须转换为人类可读格式。6. Contract Call合约交互approve / deposit / withdraw / 自定义6.1wallet contract-callonchainos wallet contract-call --to contract --chain chain \ [--amt minimal_units] [--input-data hex] [--unsigned-tx base58] \ [--gas-limit n] [--from address] [--mev-protection] [--jito-unsigned-tx base58] \ [--biz-type type] [--strategy name] [--aa-dex-token-addr addr] [--aa-dex-token-amount amt] \ [--gas-token-address addr] [--relayer-id id] [--enable-gas-station] [--force]参数必填说明--to是合约地址--chain是链名或链 ID--amt否payable 函数的原生最小单位金额默认0--input-dataEVM十六进制 calldataEVM 必填--unsigned-txSolanaBase58 未签名交易Solana 必填--gas-limit否EVM gas 覆盖值省略时自动估算--mev-protection否MEV 保护Ethereum / BSC / Base / Solana详见下文--jito-unsigned-tx否Jito bundle 的 base58 交易Solana 启用 MEV 保护时必填绝不能替代--unsigned-tx--biz-type否transfer/dex/defi/dapp--gas-token-address、--relayer-id、--enable-gas-station否Gas Station仅 Solana仅第二阶段使用--force否一次确认过的 Confirming 响应后重跑--input-dataEVM与--unsigned-txSolana必须二选一且只能选其一否则命令失败。返回txHash。调用前建议先运行onchainos security tx-scan。金额规则来自 wallet.mdcontract-call的--amt是最小单位的原生金额默认0EVM 18 位、SOL 9 位精度绝不手工计算最小单位wallet send则优先用--readable-amount交给 CLI 换算。6.2 Approve 安全红线执行授权approve时必须遵守 wallet.md 的硬性规则绝不执行无限授权不得将 approve 金额设为type(uint256).max/2^256-1或任何 “infinite” 值也不得调用setApprovalForAll(operator, true)若用户明确要求无限授权警告其不可逆、会让被授权方转走全部代币并要求第二次明确确认即便如此也要把金额限制在所需范围内如 swap 金额 10%用户仍坚持则拒绝并建议其通过区块浏览器手动执行。6.3 MEV 保护仅 contract-call--mev-protection是contract-call专属 flagwallet send不支持。启用后广播 API 会在extraData中传isMEV: true将交易路由到 MEV 保护通道防止 front-running、sandwich 攻击等 MEV 剥削见 wallet-mev-protection.md。支持链矩阵链MEV 保护额外要求Ethereum支持—BSC支持—Base支持—Solana支持必须同时传--jito-unsigned-tx否则命令失败其他链不支持—# EVM 合约调用 MEV 保护Ethereum/BSC/Base onchainos wallet contract-call --to 0xDef... --chain 1 --input-data 0x... --mev-protection # Solana 合约调用 MEV 保护必须带 --jito-unsigned-tx onchainos wallet contract-call --to program_id --chain 501 --unsigned-tx base58_tx --mev-protection --jito-unsigned-tx jito_base58_tx绝不要把--unsigned-tx当作--jito-unsigned-tx使用——两者是完全不同的参数。Jito bundle 数据不可用时停止并询问用户不带 MEV 保护继续还是取消。建议在高价值转账/swap、通过contract-call执行的 DEX 交易、或用户明确要求时启用 MEV 保护。7. Sign Message消息签名7.1wallet sign-message支持 personalSignEIP-191EVM Solana或 EIP-712 结构化数据仅 EVM。onchainos wallet sign-message --chain chain --from address --message message [--type type] [--force]参数必填说明--chain是链名或链 ID--from是签名者地址--message是personal任意字符串eip712JSON 类型化数据字符串--type否personal默认EVM Solana或eip712仅 EVM——Solana 会返回错误--force否一次确认过的 Confirming 响应后重跑返回signatureEVM 上为 hexSolana 上为 base58并附带publicKey。8. Gas Station 集成要点Solana虽然 Gas Station 的完整流程在 gas-station.md但wallet send/contract-call的参数与返回字段直接与之耦合这里提炼与 wallet 命令直接相关的要点机制用户在缺少原生 SOL 时用稳定币USDT / USDC / USDG付 gasRelayer 作为 Solana 上的费用支付方稳定币费用通过同一笔交易内的 SPL Token Transfer 收取——无账户升级、无逐链配置、无 7702仅限 Solana。后端分派Agent 响应不要自己判断 SOL 余额是否不足正常调用wallet send/contract-call读取 CLI 返回的scene判别字段与gasStationUsed后按 Outcome→render 映射处理。首次使用 / 切换代币场景走 Confirming 模式exit code 2Scene A/C已固定默认代币时静默执行Scene B/D。参数纪律--gas-token-address/--relayer-id/--enable-gas-station绝不能出现在首次调用它们是用户在 Confirming 响应中选定稳定币后的第二阶段值且绝不虚构代币地址或 relayer ID必须使用 Confirming 响应next字段中的精确值。管理命令均带--chain solanaonchainos wallet gas-station update-default-token --chain solana --gas-token-address spl_mint onchainos wallet gas-station enable --chain solana onchainos wallet gas-station disable --chain solana onchainos wallet gas-station status --chain solana [--from solana_address] onchainos wallet gas-station setup --chain solana --gas-token-address spl_mint --relayer-id id [--from solana_address]status是只读探测返回recommendationREADY/ENABLE_GAS_STATION/INSUFFICIENT_ALL/HAS_PENDING_TX与tokenList[]symbol、feeTokenAddress、relayerId、balance、serviceCharge、sufficient也被第三方 Solana DeFi 插件如kamino-plugin、raydium-plugin的写操作预检使用流程见 wallet-plugin-preflight.md。成功回复四要素任何经 Gas Station 支付的交易回复必须包含——①明确说明 gas 由稳定币支付绝不暗示“免费”②服务费金额与符号{serviceCharge} {serviceChargeSymbol}及 USD 等值③orderId逐字复制不省略不截断④后续提示You can tell me: **check order {orderId}** to check the status.。当txHash为空Relayer 异步返回时说明交易已提交、链上哈希稍后返回绝不虚构 txHash。9. Confirming 响应与安全执行规则9.1 Confirming Responseexit code 2部分改变状态的命令在后端需要用户确认时返回confirming响应exit code 2携带message要向用户展示的提示和next确认后要执行的操作。处理流程来自 SKILL.md展示message并请求确认用户确认→ 按next执行通常是追加--force重跑同一命令用户拒绝→ 不执行告知已取消。绝不在状态改变命令的首次调用中传--force。只有同时满足以下条件才加--force(1) 已无--force运行过一次(2) CLI 返回了 Confirming 响应exit code 2confirming: true(3) 已展示message且用户明确确认。常见故障点见 wallet-troubleshooting.md收到错误码 50125/80001地区限制时不展示原始码提示“服务在当前地区不可用”not logged in表示会话过期提示执行wallet loginwallet verifycontract-call缺参数、calldata 畸形、模拟失败executeErrorMsg等均有对应的处理指引。9.2 全命令安全基线凭证保护绝不记录、展示或索要会话 token、clientId、API key、私钥、助记词与口令不暴露accessToken、refreshToken、apiKey、secretKey、passphrase、sessionKey、sessionCert、teeId、encryptedSessionSk、signingKey等字段向用户展示accountName而非原始accountId。地址完整性任何链上标识必须逐字复制自最新 CLI stdout绝不凭记忆复现、绝不全角/大小写归一化、不在标识中间插空格或换行始终展示完整txHash。不虚构地址绝不编造合约地址恶意代币会克隆合法名称只用代币查询结果或用户明确输入。收款地址校验EVM 为0x前缀、42 字符Solana 为 Base58、32–44 字符发送前校验。交易模拟CLI 会做执行前模拟若executeResult为 false → 展示executeErrorMsg不广播。时间戳交易时间戳单位是毫秒展示前转换。X Layer 零 gasX LayerchainIndex196不收取 gas当用户询问 gas、为转账选链、添加钱包或索要充值地址时主动提示。10. 相邻能力速览wallet命令组与 Onchain OS 的其余命令组协同工作常用衔接如下gas 查询 / 模拟 / 广播onchainos gateway gas --chain chainEIP-1559 的suggestBaseFee、proposePriorityFee等、gateway gas-limit、gateway simulate、gateway broadcast广播已签名交易返回orderIdtxHash详见 gateway-cli-reference.mdDEX 兑换swap execute绝不用contract-call广播 swap跨链桥bridge限价单strategy安全检查security tx-scantoken / 蜜罐 / 貔貅 / DApp 钓鱼 / 授权检查与security系列命令审计日志本地文件~/.onchainos/audit.jsonl或设置了$ONCHAINOS_HOME时为其下的audit.jsonlJSON Lines 格式首行为设备头最多 10,000 行、自动保留设备头与最近 5,000 条仅提供路径用于离线排障不在对话中读取或展示内容见 audit-log.md。结语onchainos wallet是 OKX Agentic Wallet 技能的实操核心Account 组负责认证与账户生命周期Balance 组提供稳定的 9 字段代币 schemaSend / Contract Call 组承载原生与代币转账及合约交互History 组统一列表/详情两种查询模式Sign Message 组覆盖 personalSign 与 EIP-712。使用时的三条铁律——CLI 是事实来源、状态改变先确认Confirming →--force、链上标识逐字复制——贯穿所有子命令是保障资金安全与返回字段解析正确的基石。任何命令细节不确定时onchainos wallet subcommand --help永远是最权威的答案。赞分享【免费下载链接】internet-court-skillThe trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.项目地址https://gitcode.com/gh_mirrors/in/internet-court-skill点击查看免费下载相关推荐LeetCode-Book 刷题方法论面向算法初学者的高效刷题指南LeetCode Book 刷题方法论面向算法初学者的高效刷题指南 导读 本文以 LeetCode Book 仓库中《图解算法数据结构》的「刷题建议」章节为主OKX Agentic Wallet 链支持矩阵解析onchainos CLI 的链名解析、钱包地址创建与 Solana Gas Station 兼容性指南OKX Agentic Wallet 链支持矩阵解析 onchainos CLI 的链名解析、钱包地址创建与 Solana Gas Station 兼容性指南上一篇ChartGPU源码级揭秘WGSL着色器、Pipeline Cache与submitBatcher如何实现单帧提交下一篇OpenRig S6 效果验收数据库路径、插件版本与 Recap 供给的权威性守卫RED-first → GREEN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考