@lawrenceliang-btc/atel-sdk 1.1.28 → 1.1.30

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 1.1.29 - 2026-04-06
+
+### Improved
+- Clarified TokenHub CLI help so API key creation and account commands are easier to discover.
+- Tightened English terminology across README, quick-start guides, and SKILL references.
+- Standardized the distinction between DID-signed platform requests and TokenHub API-key requests.
+- Updated swap guidance to describe `pending_verification` precisely.
+
+### Fixed
+- `atel key create` now falls back to DID-signed bootstrap when a saved hub API key is invalid or revoked.
+- `atel hub swap` now reports `pending_verification` as a submitted settlement state instead of implying final success.

package/README.md

@@ -51,10 +51,18 @@ ATEL provides the cryptographic primitives and protocol building blocks that ena
 
 ### Installation
 
+Install the CLI globally if you want the `atel` command:
+
 ```bash
 npm install -g @lawrenceliang-btc/atel-sdk
 ```
 
+Install the package locally if you want to embed the SDK in your own runtime or app:
+
+```bash
+npm install @lawrenceliang-btc/atel-sdk
+```
+
 ### Initialize Your Agent
 
 ```bash
@@ -63,6 +71,16 @@ atel register "My Agent" "assistant,research"
 atel start 3100
 ```
 
+### Bootstrap TokenHub Access
+
+```bash
+atel key create --name my-agent-key
+atel key list
+atel key use
+```
+
+`atel key use` prints the OpenAI-compatible environment exports for the currently selected TokenHub API key. The grouped alias `atel hub key ...` is still supported, but `atel key ...` is the recommended first-run path.
+
 If you want to support paid Platform orders on EVM chains, configure at least one paid-order chain key before or after registering:
 
 ```bash
@@ -90,6 +108,39 @@ For custom runtimes, point `ATEL_EXECUTOR_URL` at your own service.
 
 For paid orders, do not hardcode Base as the only chain. Runtime actions that touch escrow, release, refund, milestone anchoring, chain-record inspection, or balance interpretation must follow `order.chain`.
 
+
+## TokenHub and AI Gateway
+
+ATEL currently exposes two related but distinct integration surfaces:
+
+- **DID-signed platform requests** under `/account/v1/...`
+  These are used by the CLI for account actions such as balance lookup, swaps, transfers, and account history.
+- **TokenHub API-key requests** under `/tokenhub/v1/...`
+  These are used for external model access, OpenAI-compatible chat calls, and direct gateway integrations.
+
+Canonical first-run flow:
+
+```bash
+atel key create --name my-agent-key
+atel key use
+atel hub balance
+atel hub models --search gpt
+atel hub chat openai/gpt-4o-mini "Hello"
+atel swap usdc 0.01 --chain bsc
+atel swap token 100 --chain bsc
+atel transfer did:atel:ed25519:TARGET_DID 250 --memo "settlement"
+```
+
+Important terminology:
+
+- **TokenHub API key**: a gateway credential stored in `~/.atel/hub.json`
+- **Platform DID**: the DID-backed account identity used for signed `/account/v1/...` requests
+- **OpenAI-compatible gateway**: the `/tokenhub/v1/chat/completions` surface
+- **`pending_verification`**: the on-chain settlement transaction was sent, but accounting is waiting for verification before balances are finalized
+
+If a swap returns `pending_verification`, inspect `atel hub swap-history` or `atel hub ledger` before retrying the settlement path.
+Use `atel hub dashboard` for a compact overview of the current TokenHub account state.
+
 ## Architecture
 
 ATEL is organized into protocol and runtime layers:
@@ -130,6 +181,37 @@ atel status                   # Check system health
 atel start [port]             # Start agent endpoint
 ```
 
+### Key Management
+```bash
+atel key create [--name "my-key"]  # Create and save a TokenHub API key
+atel key list                        # List TokenHub API keys
+atel key revoke <id>                 # Revoke a TokenHub API key
+atel key use                         # Print OpenAI-compatible env exports
+```
+
+### TokenHub & Account
+```bash
+atel balance                                # Show platform account balance
+atel deposit <amount> [channel]             # Add funds to the platform account
+atel withdraw <amount> [channel] [address]  # Withdraw funds
+atel transactions                           # List platform payment history
+
+atel hub balance                            # Show USDC and ATELToken balances
+atel hub dashboard                          # Show a compact TokenHub account summary
+atel hub usage [--model <id>] [--days 7]    # Show model usage history
+atel hub ledger [--page 1] [--limit 20]     # Show account transaction records
+atel hub swap-history [--page 1] [--limit 20] # Show swap records
+atel hub stats                              # Show public TokenHub stats
+atel hub models [--search gpt]              # List available models
+atel hub chat <model> "<prompt>" [--stream] # Send a quick chat request
+
+atel swap usdc <amount> [--chain bsc|base]  # Swap USDC to ATELToken
+atel swap token <amount> [--chain bsc|base] # Swap ATELToken to USDC
+atel transfer <to_did> <amount> [--memo "settlement"] # Transfer ATELToken
+```
+
+The grouped `atel hub key <...>` path remains available, but `atel key <...>` is the preferred entry point for new setups.
+
 ### Friend System
 ```bash
 # Friend Management
@@ -314,12 +396,15 @@ Friend system data is stored in `.atel/`:
 
 ## Documentation
 
-- [docs/START-HERE.md](docs/START-HERE.md) — One-page onboarding
-- [docs/QUICKSTART-5MIN.md](docs/QUICKSTART-5MIN.md) — 5-minute quickstart
-- [docs/API.md](docs/API.md) — Detailed API guide
-- [docs/AUDIT_SERVICE.md](docs/AUDIT_SERVICE.md) — Audit system guide
-- [docs/builtin-executor-guide.md](docs/builtin-executor-guide.md) — Built-in executor guide
-- [docs/protocol-specification.md](docs/protocol-specification.md) — Protocol specification
+- [START-HERE.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/START-HERE.md) — One-page onboarding
+- [QUICKSTART-5MIN.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/QUICKSTART-5MIN.md) — 5-minute quickstart
+- [quick-start.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/quick-start.md) — TokenHub quick-start flow
+- [API.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/API.md) — Detailed API guide
+- [AUDIT_SERVICE.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/AUDIT_SERVICE.md) — Audit system guide
+- [builtin-executor-guide.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/builtin-executor-guide.md) — Built-in executor guide
+- [protocol-specification.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/docs/protocol-specification.md) — Protocol specification
+- [skill/SKILL.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/skill/SKILL.md) — OpenClaw runtime and setup conventions
+- [CHANGELOG.md](https://github.com/LawrenceLiang-BTC/atel-sdk/blob/main/CHANGELOG.md) — Release notes
 
 ## Environment Variables
 
@@ -334,10 +419,10 @@ Friend system data is stored in `.atel/`:
 ## Current Status
 
 - [x] **Phase 0 MVP complete** — 13 modules implemented, core trust workflow end-to-end
-- [x] **241 tests in suite** — Unit/integration coverage across modules
+- [x] **Release verification** — `npm run build` and `npm test` are part of the publish flow
 - [x] **P2P friend system** — Relationship-based access control with temporary sessions
 - [x] **Audit system** — CoT reasoning verification with local LLM
-- [x] **Production deployment** — Platform + SDK deployed and tested
+- [x] **Production deployment** — Platform + SDK deployed and smoke-tested
 
 ## Roadmap
 

package/bin/atel.mjs

@@ -53,7 +53,7 @@
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync, appendFileSync, copyFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { cmdHub } from './hub-helpers.mjs';
+import { cmdHub, cmdSwap, cmdTransfer } from './hub-helpers.mjs';
 import { resolve, join, dirname } from 'node:path';
 import crypto from 'node:crypto';
 import {
@@ -74,8 +74,8 @@ import { parseAttachmentFlags, processAttachments } from './atel-attachment-help
 
 const ATEL_DIR = resolve(process.env.ATEL_DIR || '.atel');
 const IDENTITY_FILE = resolve(ATEL_DIR, 'identity.json');
-const REGISTRY_URL = process.env.ATEL_REGISTRY || 'https://api.atelai.org';
-const ATEL_PLATFORM = process.env.ATEL_PLATFORM || 'https://api.atelai.org';
+const ATEL_PLATFORM = process.env.ATEL_PLATFORM || process.env.ATEL_API || process.env.ATEL_REGISTRY || 'https://api.atelai.org';
+const REGISTRY_URL = process.env.ATEL_REGISTRY || ATEL_PLATFORM || 'https://api.atelai.org';
 const ATEL_RELAY = process.env.ATEL_RELAY || 'https://api.atelai.org';
 const ATEL_NOTIFY_GATEWAY = process.env.ATEL_NOTIFY_GATEWAY || process.env.OPENCLAW_GATEWAY_URL || '';
 const ATEL_NOTIFY_TARGET = process.env.ATEL_NOTIFY_TARGET || '';
@@ -158,7 +158,7 @@ function shouldAllowRepoAccess(context = {}) {
   const resultSummary = String(context?.resultSummary || '').toLowerCase();
   const previousApprovedOutputs = String(context?.previousApprovedOutputs || '').toLowerCase();
   const combined = `${description}\n${objective}\n${resultSummary}\n${previousApprovedOutputs}`;
-  return /(repo|repository|codebase|仓库|代码库|项目代码|source code|read files|analyze code|修改代码|修复代码|实现功能)/i.test(combined);
+  return /(repo|repository|codebase|\u4ed3\u5e93|\u4ee3\u7801\u5e93|\u9879\u76ee\u4ee3\u7801|source code|read files|analyze code|\u4fee\u6539\u4ee3\u7801|\u4fee\u590d\u4ee3\u7801|\u5b9e\u73b0\u529f\u80fd)/i.test(combined);
 }
 
 function summarizeApprovedMilestones(milestones = [], beforeIndex = Number.MAX_SAFE_INTEGER) {
@@ -312,26 +312,26 @@ async function pushTradeNotification(eventType, payload, body) {
   if (enabled.length === 0) return;
 
   const templates = {
-    'order_created': (p) => `📥 收到新订单\n订单: ${p.orderId || body?.orderId || '?'}\n金额: $${p.priceAmount ?? '?'} USDC\n来自: ${p.requesterDid || '未知请求方'}\n请审核后决定是否接单`,
-    'order_accepted': (p) => `📋 订单已被接单\n订单: ${p.orderId || body?.orderId || '?'}\n执行方已开始处理，进入里程碑阶段`,
+    'order_created': (p) => `📥 New order received\nOrder: ${p.orderId || body?.orderId || '?'}\nAmount: $${p.priceAmount ?? '?'} USDC\nFrom: ${p.requesterDid || 'unknown requester'}\nReview and decide whether to accept`,
+    'order_accepted': (p) => `📋 Order accepted\nOrder: ${p.orderId || body?.orderId || '?'}\nThe executor has started work. The order is now in the milestone phase`,
     'milestone_submitted': (p) => {
-      const desc = p.milestoneDescription ? `\n目标: ${p.milestoneDescription}` : '';
-      const content = p.resultSummary ? `\n提交内容: ${String(p.resultSummary).substring(0, 200)}` : '';
-      return `📝 里程碑 M${p.milestoneIndex ?? '?'} 已提交\n订单: ${p.orderId || body?.orderId || '?'}${desc}${content}\n等待审核`;
+      const desc = p.milestoneDescription ? `\nGoal: ${p.milestoneDescription}` : '';
+      const content = p.resultSummary ? `\nSubmission: ${String(p.resultSummary).substring(0, 200)}` : '';
+      return `📝 Milestone M${p.milestoneIndex ?? '?'} submitted\nOrder: ${p.orderId || body?.orderId || '?'}${desc}${content}\nAwaiting review`;
     },
     'milestone_verified': (p) => {
-      const desc = p.milestoneDescription ? `\n目标: ${p.milestoneDescription}` : '';
-      const content = p.resultSummary ? `\n提交内容: ${String(p.resultSummary).substring(0, 200)}` : '';
-      const progress = p.totalMilestones ? `\n进度: ${(p.milestoneIndex ?? 0) + 1}/${p.totalMilestones}` : '';
-      return `✅ 里程碑 M${p.milestoneIndex ?? '?'} 审核通过\n订单: ${p.orderId || body?.orderId || '?'}${desc}${content}${progress}`;
+      const desc = p.milestoneDescription ? `\nGoal: ${p.milestoneDescription}` : '';
+      const content = p.resultSummary ? `\nSubmission: ${String(p.resultSummary).substring(0, 200)}` : '';
+      const progress = p.totalMilestones ? `\nProgress: ${(p.milestoneIndex ?? 0) + 1}/${p.totalMilestones}` : '';
+      return `✅ Milestone M${p.milestoneIndex ?? '?'} approved\nOrder: ${p.orderId || body?.orderId || '?'}${desc}${content}${progress}`;
     },
     'milestone_rejected': (p) => {
-      const desc = p.milestoneDescription ? `\n目标: ${p.milestoneDescription}` : '';
-      return `❌ 里程碑 M${p.milestoneIndex ?? '?'} 被拒绝\n订单: ${p.orderId || body?.orderId || '?'}${desc}\n原因: ${p.rejectReason || '未说明'}`;
+      const desc = p.milestoneDescription ? `\nGoal: ${p.milestoneDescription}` : '';
+      return `❌ Milestone M${p.milestoneIndex ?? '?'} rejected\nOrder: ${p.orderId || body?.orderId || '?'}${desc}\nReason: ${p.rejectReason || 'not provided'}`;
     },
     'order_settled': (p) => {
-      const amount = p.priceAmount ? `\n金额: $${p.priceAmount} USDC` : '';
-      return `💰 订单已结算完成\n订单: ${p.orderId || body?.orderId || '?'}${amount}\nUSDC 已支付`;
+      const amount = p.priceAmount ? `\nAmount: $${p.priceAmount} USDC` : '';
+      return `💰 Order settled\nOrder: ${p.orderId || body?.orderId || '?'}${amount}\nUSDC has been paid`;
     },
   };
   const tmpl = templates[eventType];
@@ -342,10 +342,14 @@ async function pushTradeNotification(eventType, payload, body) {
     try {
       if (target.channel === 'telegram' && target.botToken) {
         // Direct TG Bot API — no gateway needed
+        // Note: parse_mode is intentionally omitted. Templates render plain
+        // text (no HTML markup), and milestone payloads frequently contain
+        // raw `<` characters (e.g. "<5秒", "<30秒") that would otherwise
+        // trip Telegram's HTML parser and cause silent 400 drops.
         await fetch(`https://api.telegram.org/bot${target.botToken}/sendMessage`, {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ chat_id: target.target, text: message, parse_mode: 'HTML' }),
+          body: JSON.stringify({ chat_id: target.target, text: message }),
           signal: AbortSignal.timeout(5000),
         }).catch(() => {});
       } else if (target.channel === 'gateway') {
@@ -382,12 +386,12 @@ async function pushP2PNotification(eventType, payload = {}) {
   if (enabled.length === 0) return;
 
   const templates = {
-    'p2p_task_sent': (p) => `📤 P2P任务已发送\n任务: ${p.taskId || '?'}\n目标: ${p.peerDid || '?'}`,
-    'p2p_task_received': (p) => `📩 收到新的P2P任务\n任务: ${p.taskId || '?'}\n来自: ${p.peerDid || '?'}`,
-    'p2p_task_started': (p) => `▶️ P2P任务开始处理\n任务: ${p.taskId || '?'}\n来自: ${p.peerDid || '?'}`,
-    'p2p_result_submitted': (p) => `📨 P2P结果已发回对方\n任务: ${p.taskId || '?'}\n目标: ${p.peerDid || '?'}`,
-    'p2p_result_received': (p) => `✅ P2P任务已完成\n任务: ${p.taskId || '?'}\n结果: ${String(p.result || '').slice(0, 80) || '已返回'}`,
-    'p2p_task_failed': (p) => `❌ P2P任务失败\n任务: ${p.taskId || '?'}\n原因: ${p.reason || '未知错误'}`,
+    'p2p_task_sent': (p) => `📤 P2P task sent\nTask: ${p.taskId || '?'}\nTarget: ${p.peerDid || '?'}`,
+    'p2p_task_received': (p) => `📩 New P2P task received\nTask: ${p.taskId || '?'}\nFrom: ${p.peerDid || '?'}`,
+    'p2p_task_started': (p) => `▶️ P2P task started\nTask: ${p.taskId || '?'}\nFrom: ${p.peerDid || '?'}`,
+    'p2p_result_submitted': (p) => `📨 P2P result sent back\nTask: ${p.taskId || '?'}\nTarget: ${p.peerDid || '?'}`,
+    'p2p_result_received': (p) => `✅ P2P task completed\nTask: ${p.taskId || '?'}\nResult: ${String(p.result || '').slice(0, 80) || 'returned'}`,
+    'p2p_task_failed': (p) => `❌ P2P task failed\nTask: ${p.taskId || '?'}\nReason: ${p.reason || 'unknown error'}`,
   };
   const tmpl = templates[eventType];
   if (!tmpl) return;
@@ -396,10 +400,11 @@ async function pushP2PNotification(eventType, payload = {}) {
   for (const target of enabled) {
     try {
       if (target.channel === 'telegram' && target.botToken) {
+        // parse_mode intentionally omitted — see pushTradeNotification for rationale
         await fetch(`https://api.telegram.org/bot${target.botToken}/sendMessage`, {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ chat_id: target.target, text: message, parse_mode: 'HTML' }),
+          body: JSON.stringify({ chat_id: target.target, text: message }),
           signal: AbortSignal.timeout(5000),
         }).catch(() => {});
       } else if (target.channel === 'gateway') {
@@ -2950,18 +2955,18 @@ async function cmdStart(port) {
   function buildGatewayCallbackPrompt(eventType, promptText, callbackUrl, dedupeKey, cwd, payload = {}) {
     const callbackExamples = {
       milestone_submitted: [
-        '通过时执行：',
+        'Run on approval:',
         "python3 - <<'PY'",
         'import json, urllib.request',
-        `body = {"dedupeKey": "${dedupeKey}", "status": "done", "eventType": "${eventType}", "decision": "pass", "summary": "审核通过的简短原因"}`,
+        `body = {"dedupeKey": "${dedupeKey}", "status": "done", "eventType": "${eventType}", "decision": "pass", "summary": "brief reason for approval"}`,
         `req = urllib.request.Request("${callbackUrl}", data=json.dumps(body).encode(), headers={"Content-Type": "application/json"})`,
         'urllib.request.urlopen(req, timeout=10).read()',
         'PY',
         '',
-        '拒绝时执行：',
+        'Run on rejection:',
         "python3 - <<'PY'",
         'import json, urllib.request',
-        `body = {"dedupeKey": "${dedupeKey}", "status": "done", "eventType": "${eventType}", "decision": "reject", "reason": "具体拒绝原因", "summary": "简短审核结论"}`,
+        `body = {"dedupeKey": "${dedupeKey}", "status": "done", "eventType": "${eventType}", "decision": "reject", "reason": "specific rejection reason", "summary": "brief review conclusion"}`,
         `req = urllib.request.Request("${callbackUrl}", data=json.dumps(body).encode(), headers={"Content-Type": "application/json"})`,
         'urllib.request.urlopen(req, timeout=10).read()',
         'PY',
@@ -2969,7 +2974,7 @@ async function cmdStart(port) {
       default: [
         "python3 - <<'PY'",
         'import json, urllib.request',
-        `result = """在这里写最终交付内容"""`,
+        `result = """Write the final deliverable here"""`,
         `body = {"dedupeKey": "${dedupeKey}", "status": "done", "eventType": "${eventType}", "result": result, "summary": result[:120]}`,
         `req = urllib.request.Request("${callbackUrl}", data=json.dumps(body).encode(), headers={"Content-Type": "application/json"})`,
         'urllib.request.urlopen(req, timeout=10).read()',
@@ -2980,7 +2985,7 @@ async function cmdStart(port) {
     const callbackFailed = [
       "python3 - <<'PY'",
       'import json, urllib.request',
-      `body = {"dedupeKey": "${dedupeKey}", "status": "failed", "eventType": "${eventType}", "error": "在这里写失败原因"}`,
+      `body = {"dedupeKey": "${dedupeKey}", "status": "failed", "eventType": "${eventType}", "error": "Write the failure reason here"}`,
       `req = urllib.request.Request("${callbackUrl}", data=json.dumps(body).encode(), headers={"Content-Type": "application/json"})`,
       'urllib.request.urlopen(req, timeout=10).read()',
       'PY',
@@ -2990,27 +2995,27 @@ async function cmdStart(port) {
     const contextFile = join(cwd, 'ORDER_CONTEXT.md');
     const allowRepoAccess = shouldAllowRepoAccess(payload);
     const fileAccessRule = allowRepoAccess
-      ? `3. 仅允许使用目录 ${cwd} 下与当前订单直接相关的内容；如果订单明确要求读仓库，也只能读取该订单工作区中明确提供的路径。`
-      : `3. 本单禁止读取任何本地文件、共享草稿、仓库或其他项目。不要使用文件搜索、目录浏览、读文件等方式扩展上下文；只允许依据本条消息中的订单描述、里程碑目标、提交内容来工作。`;
+      ? `3. Only use content directly related to the current order under ${cwd}. If the order explicitly requires repository analysis, only read the paths explicitly provided inside this order workspace.`
+      : `3. This order forbids reading any local files, shared drafts, repositories, or other projects. Do not expand context through file search, directory browsing, or file reads. Work only from the order description, milestone goal, and submission content in this message.`;
     const contextRule = allowRepoAccess
-      ? `4. 优先读取 ${contextFile}，严格以其中的订单描述、里程碑目标、提交内容为准。`
-      : `4. 不要扫描本机其他目录，不要读取 /root/atel-workspace 下的共享文件，不要根据历史项目或 stray files 推断任务。`;
+      ? `4. Read ${contextFile} first and treat its order description, milestone goal, and submission content as the authoritative source.`
+      : `4. Do not scan other directories on the machine, do not read shared files under /root/atel-workspace, and do not infer the task from historical projects or stray files.`;
     const repoRule = allowRepoAccess
-      ? `5. 只有当订单明确要求分析仓库/代码时，才允许读取订单工作区里显式提供的代码路径；禁止顺带读取其他目录。`
-      : `5. 本单不是 repo/code 任务。禁止把任务扩展成代码分析、工程改造或共享草稿筛选。`;
+      ? `5. Only when the order explicitly requires repository or code analysis may you read code paths explicitly provided in the order workspace. Do not read other directories opportunistically.`
+      : `5. This order is not a repo/code task. Do not expand it into code analysis, engineering changes, or shared-draft review.`;
     if (eventType === 'p2p_task') {
       return `${promptText}
 
-重要要求：
-1. 这是一个 P2P 任务。不要调用 atel result；本地 SDK 会在你回调后自动提交结果。
-2. 你的任务是认真完成 AI 工作，并把最终结论通过回调发回本地 SDK。
+Important requirements:
+1. This is a P2P task. Do not call atel result; the local SDK will submit the result automatically after your callback.
+2. Your job is to complete the AI work carefully and send the final conclusion back to the local SDK through the callback.
 ${fileAccessRule}
 ${contextRule}
-5. 完成后，必须立刻执行下面这个成功回调命令模板，并把其中内容替换成你的真实结果：
+5. After finishing, you must immediately run the success callback command template below and replace its content with your real result:
 
 ${callbackDone}
 
-6. 如果重试后仍然失败，也必须执行下面这个失败回调命令：
+6. If it still fails after retries, you must also run the failure callback command below:
 
 ${callbackFailed}
 `;
@@ -3018,17 +3023,17 @@ ${callbackFailed}
 
     return `${promptText}
 
-重要要求：
-1. 不要执行 atel milestone-submit / milestone-verify / milestone-feedback 命令；这些命令会由本地 SDK 在你回调后代为执行。
-2. 你的任务是认真完成 AI 工作，并把最终结论通过回调发回本地 SDK。
+Important requirements:
+1. Do not run atel milestone-submit / milestone-verify / milestone-feedback. The local SDK will execute those commands on your behalf after the callback.
+2. Your job is to complete the AI work carefully and send the final conclusion back to the local SDK through the callback.
 ${fileAccessRule}
 ${contextRule}
 ${repoRule}
-6. 完成后，必须立刻执行下面这个成功回调命令模板，并把其中内容替换成你的真实结果：
+6. After finishing, you must immediately run the success callback command template below and replace its content with your real result:
 
 ${callbackDone}
 
-7. 如果重试后仍然失败，也必须执行下面这个失败回调命令：
+7. If it still fails after retries, you must also run the failure callback command below:
 
 ${callbackFailed}
 `;
@@ -3038,26 +3043,26 @@ ${callbackFailed}
     if (eventType === 'milestone_submitted') {
       return `${promptText}
 
-重要：你不是在和用户聊天。
-不要输出 markdown、代码块、解释、分析过程。
-你必须只输出一行 JSON。
+Important: you are not chatting with the user.
+Do not output markdown, code blocks, explanations, or your reasoning.
+You must output exactly one line of JSON.
 
-通过时：
-{"decision":"pass","summary":"简短通过原因"}
+For approval:
+{"decision":"pass","summary":"brief approval reason"}
 
-拒绝时：
-{"decision":"reject","reason":"具体拒绝原因","summary":"简短审核结论"}`;
+For rejection:
+{"decision":"reject","reason":"specific rejection reason","summary":"brief review conclusion"}`;
     }
 
     if (['milestone_plan_confirmed', 'milestone_verified', 'milestone_rejected'].includes(eventType)) {
       return `${promptText}
 
-重要：你不是在和用户聊天。
-不要输出 markdown、标题、项目符号、解释、分析过程。
-你必须只输出一行 JSON。
+Important: you are not chatting with the user.
+Do not output markdown, headings, bullet points, explanations, or your reasoning.
+You must output exactly one line of JSON.
 
-格式：
-{"result":"当前里程碑的真实交付内容"}`;
+Format:
+{"result":"the actual deliverable for the current milestone"}`;
     }
 
     return promptText;
@@ -3168,10 +3173,10 @@ ${callbackFailed}
         return buildAgentCallbackAction(eventType, payload, parsed);
       } catch {
         const lowered = cleaned.toLowerCase();
-        if (lowered.startsWith('pass') || cleaned.includes('通过')) {
+        if (lowered.startsWith('pass') || cleaned.includes('\u901a\u8fc7')) {
           return buildAgentCallbackAction(eventType, payload, { decision: 'pass', summary: cleaned });
         }
-        if (lowered.startsWith('reject') || cleaned.includes('拒绝')) {
+        if (lowered.startsWith('reject') || cleaned.includes('\u62d2\u7edd')) {
           return buildAgentCallbackAction(eventType, payload, { decision: 'reject', reason: cleaned, summary: cleaned });
         }
         return { ok: false, error: 'invalid_local_review_stdout' };
@@ -3375,8 +3380,8 @@ ${callbackFailed}
             previousApprovedOutputs,
           };
       const promptText = currentIndex === 0
-        ? `你是ATEL接单方Agent。双方已确认方案，开始执行。\n订单原始要求：${orderDescription || '未提供'}\n当前里程碑 M0：${currentMilestone.title || ''}\n请只围绕这个订单要求完成当前里程碑，并通过回调返回最终交付内容。`
-        : `你是ATEL接单方Agent。M${currentIndex - 1} 已通过审核。\n订单原始要求：${orderDescription || '未提供'}\n下一个里程碑 M${currentIndex}：${currentMilestone.title || ''}\n前面已通过的阶段结果如下：\n${previousApprovedOutputs || '无'}\n\n请严格基于这些已通过结果推进当前里程碑，不要自行假设缺失材料，也不要读取本地共享文件来补上下文。完成后通过回调返回最终交付内容。`;
+        ? `You are the ATEL executor agent. The plan has been confirmed and execution begins.\nOriginal order requirements: ${orderDescription || 'not provided'}\nCurrent milestone M0: ${currentMilestone.title || ''}\nComplete only this milestone for the current order and return the final deliverable via the callback.`
+        : `You are the ATEL executor agent. M${currentIndex - 1} has been approved.\nOriginal order requirements: ${orderDescription || 'not provided'}\nNext milestone M${currentIndex}: ${currentMilestone.title || ''}\nPreviously approved outputs:\n${previousApprovedOutputs || 'none'}\n\nAdvance the current milestone strictly based on these approved results. Do not invent missing materials or read local shared files to fill missing context. After completion, return the final deliverable via the callback.`;
       const recoveryKey = buildMilestoneHookRecoveryKey(eventType, payload);
       log({ event: 'trade_reconcile_executor', orderId, currentMilestone: currentIndex, recoveryKey });
       const queued = queueAgentHook(eventType, recoveryKey, promptText, workspace.dir, payload, { recoveryKey });
@@ -3409,7 +3414,7 @@ ${callbackFailed}
         orderDescription,
         previousApprovedOutputs,
       };
-      const promptText = `你是ATEL发单方Agent，需要审核执行方提交的工作。\n订单原始要求：${orderDescription || '未提供'}\n里程碑目标：${submittedMilestone.title || ''}\n前面已通过的阶段结果如下：\n${previousApprovedOutputs || '无'}\n提交内容：${submittedMilestone.resultSummary || ''}\n请只按该订单要求和前序已通过结果审慎决定通过还是拒绝，并通过回调返回 decision=pass 或 decision=reject。`;
+      const promptText = `You are the ATEL requester agent. You need to review the work submitted by the executor.\nOriginal order requirements: ${orderDescription || 'not provided'}\nMilestone goal: ${submittedMilestone.title || ''}\nPreviously approved outputs:\n${previousApprovedOutputs || 'none'}\nSubmission: ${submittedMilestone.resultSummary || ''}\nDecide carefully whether to pass or reject based only on the order requirements and the previously approved outputs, then return decision=pass or decision=reject via the callback.`;
       const recoveryKey = buildMilestoneHookRecoveryKey('milestone_submitted', payload);
       const queued = queueAgentHook('milestone_submitted', recoveryKey, promptText, workspace.dir, payload, { recoveryKey });
       if (queued) log({ event: 'trade_reconcile_requester', orderId, milestoneIndex: submittedMilestone.index, recoveryKey });
@@ -3615,7 +3620,7 @@ ${callbackFailed}
         return;
       }
       // Add working directory context so agent runs atel commands in the right place
-      const cwdNote = `\n\n重要：OpenClaw 的分析工作目录是 ${hookCwd}。所有 atel 命令必须在目录 ${atelCwd} 下执行（cd ${atelCwd} && atel ...）。`;
+      const cwdNote = `\n\nImportant: OpenClaw's analysis working directory is ${hookCwd}. All atel commands must be run in ${atelCwd} (cd ${atelCwd} && atel ...).`;
       const enrichedPrompt = sanitizeAgentPrompt(prompt + cwdNote, { eventType: event, dedupeKey });
       if (!enrichedPrompt) {
         res.json({ status: 'received', eventId, eventType: event, skipped: true });
@@ -4542,7 +4547,7 @@ ${callbackFailed}
       fetch(EXECUTOR_URL, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ taskId, from: message.from, action, payload, encrypted: !!session?.encrypted, toolProxy: `http://127.0.0.1:${toolProxyPort}` }) }).catch(e => log({ event: 'executor_forward_failed', taskId, error: e.message }));
       return { status: 'accepted', taskId, message: 'Task accepted. Result will be pushed when ready.' };
     } else {
-      const p2pPrompt = `你是 ATEL 接单方 Agent，收到一个 P2P 任务。\n任务类型：${action}\n任务内容：${JSON.stringify(payload?.payload || payload || {}, null, 2)}\n请认真完成任务，并通过回调返回最终结果。`;
+      const p2pPrompt = `You are the ATEL executor agent and received a P2P task.\nTask type: ${action}\nTask payload: ${JSON.stringify(payload?.payload || payload || {}, null, 2)}\nComplete the task carefully and return the final result via the callback.`;
       appendP2PTaskStatus({ taskId, role: 'executor', peerDid: message.from, status: 'task_started' });
       pushP2PNotification('p2p_task_received', { taskId, peerDid: message.from }).catch(() => {});
       pushP2PNotification('p2p_task_started', { taskId, peerDid: message.from }).catch(() => {});
@@ -4934,6 +4939,17 @@ async function cmdRegister(name, capabilities, endpointUrl) {
   if (preferredChain) registerPayload.metadata = { preferredChain };
 
   const entry = await client.register(registerPayload, id);
+  let actualWallets = wallets || null;
+  for (let i = 0; i < 8; i++) {
+    try {
+      const resp = await fetch(`${REGISTRY_URL}/registry/v1/agent/${encodeURIComponent(id.did)}`, { signal: AbortSignal.timeout(5000) });
+      if (resp.ok) {
+        const fresh = await resp.json();
+        if (fresh?.wallets) { actualWallets = fresh.wallets; break; }
+      }
+    } catch {}
+    await new Promise(r => setTimeout(r, 750));
+  }
   if (!wallets || !preferredChain) {
     console.error('[register] INFO: registered without published chain readiness. Yellow page registration still works. Free tasks can run normally. Paid orders require an anchoring key at execution time; re-register or restart later if you want wallets/preferredChain shown in the registry.');
   }
@@ -4953,7 +4969,7 @@ async function cmdRegister(name, capabilities, endpointUrl) {
     capabilities: capDisplay,
     endpoint: ep,
     discoverable,
-    wallets: wallets || null,
+    wallets: actualWallets || null,
     preferredChain: preferredChain || null,
     registry: REGISTRY_URL,
   }, null, 2));
@@ -5885,6 +5901,7 @@ async function cmdOrder(executorDid, capType, price) {
     try { executorDid = resolveDID(executorDid); } catch (e) { console.error(e.message); process.exit(1); }
   }
   const description = rawArgs.find((a, i) => rawArgs[i-1] === '--desc') || '';
+  const chainArg = rawArgs.find((a, i) => rawArgs[i-1] === '--chain') || '';
   const id = requireIdentity();
   
   try {
@@ -5944,7 +5961,7 @@ async function cmdOrder(executorDid, capType, price) {
     };
 
     // Send to Platform
-    const data = await signedFetch('POST', '/trade/v1/order', {
+    const orderBody = {
       executorDid,
       capabilityType: capType,
       priceAmount: parseFloat(price),
@@ -5955,7 +5972,9 @@ async function cmdOrder(executorDid, capType, price) {
       taskRequest: taskRequest,
       taskSignature: taskSignature,
       intent: intentData,  // AVIP intent
-    });
+    };
+    if (chainArg) { orderBody.chain = chainArg; }
+    const data = await signedFetch('POST', '/trade/v1/order', orderBody);
     
     // For paid orders: show escrow info (chain escrow creation handled by Platform backend)
     if (data.orderId && parseFloat(price) > 0 && data.escrow?.escrowContract) {
@@ -6582,7 +6601,7 @@ async function cmdMilestoneFeedback(orderId) {
 
   if (!approve && !feedback) {
     console.error('Usage: atel milestone-feedback <orderId> --approve');
-    console.error('       atel milestone-feedback <orderId> --feedback "修改意见"');
+    console.error('       atel milestone-feedback <orderId> --feedback "feedback text"');
     process.exit(1);
   }
 
@@ -6593,7 +6612,7 @@ async function cmdMilestoneFeedback(orderId) {
 
 async function cmdMilestoneSubmit(orderId, indexStr) {
   if (!orderId || indexStr === undefined) {
-    console.error('Usage: atel milestone-submit <orderId> <index> --result "结果描述" [--file <path>]');
+    console.error('Usage: atel milestone-submit <orderId> <index> --result "result summary" [--file <path>]');
     console.error('       atel milestone-submit <orderId> <index> --result ./file.pdf [--hash 0x...] [--file <path>]');
     process.exit(1);
   }
@@ -6665,7 +6684,7 @@ async function cmdMilestoneSubmit(orderId, indexStr) {
 async function cmdMilestoneVerify(orderId, indexStr) {
   if (!orderId || indexStr === undefined) {
     console.error('Usage: atel milestone-verify <orderId> <index> --pass');
-    console.error('       atel milestone-verify <orderId> <index> --reject "原因"');
+    console.error('       atel milestone-verify <orderId> <index> --reject "reason"');
     process.exit(1);
   }
   const pass = rawArgs.includes('--pass');
@@ -8298,6 +8317,10 @@ const commands = {
   auth: () => cmdAuth(args[0]),
   // Send (Rich Media P2P Message)
   hub: () => cmdHub(args[0], args.slice(1), rawArgs),
+  key: () => cmdHub('key', args, rawArgs),
+  // Platform account operations
+  swap: () => cmdSwap(args[0], args[1], rawArgs),
+  transfer: () => cmdTransfer(args[0], args[1], rawArgs),
   send: () => {
     if (rawArgs.includes('--help') || rawArgs.includes('-h') || args.length === 0) {
       showSendHelp();
@@ -8419,7 +8442,7 @@ const commands = {
             const resp = await fetch(`https://api.telegram.org/bot${target.botToken}/sendMessage`, {
               method: 'POST',
               headers: { 'Content-Type': 'application/json' },
-              body: JSON.stringify({ chat_id: target.target, text: '🔔 ATEL 通知测试\n如果你看到这条消息，说明通知已正确配置！' }),
+              body: JSON.stringify({ chat_id: target.target, text: '🔔 ATEL notification test\nIf you can see this message, notifications are configured correctly!' }),
               signal: AbortSignal.timeout(10000),
             });
             const data = await resp.json();
@@ -8504,13 +8527,24 @@ Account Commands:
   transactions                         List payment history
 
 Hub Commands:
-  hub balance                          Show ATELToken balance
-  hub usage [--model <id>] [--days 7]  Usage history
-  hub topup                            Top-up instructions
-  hub swap <usdc> [--chain bsc|base]   Swap USDC → ATELToken
-  hub models [--search <kw>]           List available models
-  hub chat <model> "<prompt>" [--stream] Quick chat
-  hub key <create|list|revoke|use>     Manage TokenHub API keys
+  swap usdc <amount> [--chain bsc|base]      Swap USDC → ATELToken
+  swap token <amount> [--chain bsc|base]     Swap ATELToken → USDC
+  transfer <to_did> <amount> [--memo]        Transfer ATELToken to another DID
+
+  key create [--name <name>]                 Create and save a TokenHub API key
+  key list                                   List TokenHub API keys
+  key revoke <id>                            Revoke a TokenHub API key
+  key use                                    Print OpenAI-compatible env exports
+
+  hub balance                                Show USDC and ATELToken balances
+  hub dashboard                              Show a compact TokenHub account summary
+  hub usage [--model <id>] [--days 7]        Show model usage history
+  hub ledger [--page N] [--limit N]          Show account transaction records
+  hub swap-history [--page N] [--limit N]    Show swap records
+  hub stats                                  Show public TokenHub stats
+  hub models [--search <kw>]                 List available models
+  hub chat <model> "<prompt>" [--stream]    Send a quick chat request
+  hub key <create|list|revoke|use>           Manage TokenHub API keys
 
 Trade Commands:
   trade-task <cap> <desc> [--budget N]   One-shot: search → order → wait → confirm (requester)