@123456btc/123456btc-cli 1.0.2 → 1.0.3

package/README.md

@@ -1,14 +1,15 @@
 # 123456btc-cli
 
-CLI toolbox for 123456btc.com - Strategy dispatch & gas settlement for AI agents and LLMs.
+> Official CLI for 123456btc.com — Strategy subscription, signal streaming, and Provider management.
 
 ## Features
 
-- **API Key Authentication** - OpenAI-style `sk_live_...` authentication to `api.123456btc.com`
-- **Strategy Dispatch** - Send strategies for local execution
-- **Gas Settlement** - Track and settle gas fees via Solana
-- **Identity Tier Verification** - Solana token-based tier system
-- **OpenClaw Package Installer** - Install AI/LLM compatible packages
+- **Strategy Plaza** — Browse, filter, and subscribe to strategies (tiered by BBT holdings)
+- **Real-time Signals** — WebSocket streaming with auto-ACK and automatic reconnection
+- **Signal Management** — History lookup, manual ACK, and execution detail reporting
+- **Provider Tools** — Apply as a Provider, create strategies, submit for review, push signals, and withdraw earnings
+- **API Key Auth** — Long-lived `sk-bbt-xxx` keys with short-lived `at-bbt-xxx` access tokens
+- **Wallet Login** — Solana wallet QR-code scan with automatic API Key generation
 
 ## Installation
 
@@ -21,63 +22,205 @@ npm install -g @123456btc/123456btc-cli
 ### 1. Authenticate
 
 ```bash
-123456btc-cli auth login
-# Or with API key directly:
-123456btc-cli auth login -k sk_live_your_key
+# Option 1: Wallet QR-code scan (recommended)
+123456btc-cli auth wallet-login
+
+# Option 2: Enter API Key directly
+123456btc-cli auth login -k sk-bbt-your_key
 ```
 
-### 2. Check Status
+### 2. Browse & Subscribe to Strategies
 
 ```bash
-123456btc-cli auth status
-123456btc-cli gas balance
+# List available strategies (filtered by your BBT balance)
+123456btc-cli strategy list
+
+# Subscribe with daily billing (default)
+123456btc-cli strategy subscribe strat-xxx
+
+# Subscribe with per-signal billing
+123456btc-cli strategy subscribe strat-xxx --billing-model per_signal_bbt
+
+# View my subscriptions
+123456btc-cli strategy my
 ```
 
-### 3. Run Strategy
+### 3. Stream Signals in Real-time
 
 ```bash
-# List available strategies
-123456btc-cli strategy list
+# WebSocket stream with auto-ACK (default)
+123456btc-cli strategy stream strat-xxx
 
-# Dispatch a strategy
-123456btc-cli strategy dispatch <strategy-id> --param key=value
+# Disable auto-ACK (manual confirmation)
+123456btc-cli strategy stream strat-xxx --no-ack
+```
 
-# Check status
-123456btc-cli strategy status <dispatch-id>
+### 4. Acknowledge Signals
+
+```bash
+# Simple ACK
+123456btc-cli signals ack sig-xxx
+
+# ACK with execution details
+123456btc-cli signals ack sig-xxx --action execute --quantity 0.5
 ```
 
-### 4. Install Package
+## Provider (Strategy Developer)
+
+### Apply as a Provider
 
 ```bash
-123456btc-cli install package https://example.com/package
+123456btc-cli provider apply \
+  --name "My Quant Studio" \
+  --description "BTC trend-following strategies" \
+  --email "contact@example.com"
 ```
 
-## Environment Variables
+> Requirement: on-chain BBT balance ≥ 1,000,000
+
+### Save Your Provider Key
 
 ```bash
-API_BASE_URL=https://api.123456btc.com
-API_KEY=sk_live_your_key
-SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
-SOLANA_CLUSTER=mainnet-beta
+export PROVIDER_API_KEY=pk-bbt-your_provider_key
+```
+
+### Create & Launch a Strategy
+
+```bash
+# Create a strategy (draft status)
+123456btc-cli provider create-strategy \
+  --name "EMA Trend V1" \
+  --symbol "BTC,ETH" \
+  --market crypto \
+  --pricing daily_bbt \
+  --price-day 50 \
+  --min-bbt 500000
+
+# Submit for platform review
+123456btc-cli provider submit strat-xxx
+# → Waits for super_admin approval to go live
+```
+
+### Push Signals
+
+```bash
+123456btc-cli provider push-signal \
+  --strategy-id strat-xxx \
+  --symbol BTCUSDT \
+  --decision long \
+  --price 65000 \
+  --confidence 0.92 \
+  --stop-loss 62000 \
+  --take-profit 72000 \
+  --reasoning "EMA14 golden cross, volume surge"
+```
+
+### Earnings & Withdrawals
+
+```bash
+# View earnings summary
+123456btc-cli provider earnings
+
+# Request withdrawal
+123456btc-cli provider withdraw \
+  --amount 100 \
+  --sol-address "YourSolanaAddress..."
+
+# View withdrawal history
+123456btc-cli provider withdrawals
 ```
 
-## Commands
+## Command Reference
+
+### Authentication
+| Command | Description |
+|---------|-------------|
+| `auth login` | Authenticate with API Key |
+| `auth wallet-login` | Solana wallet QR-code login |
+| `auth status` | Check login status |
+| `auth verify` | Verify API Key and show permissions |
+| `auth logout` | Log out |
 
+### Strategy (Subscriber)
 | Command | Description |
 |---------|-------------|
-| `auth login` | Authenticate with API |
-| `auth status` | Check auth status |
-| `auth logout` | Clear auth |
 | `strategy list` | List available strategies |
-| `strategy dispatch` | Dispatch strategy |
-| `strategy status` | Check status |
-| `strategy history` | View history |
-| `gas balance` | Check gas balance |
-| `gas settle` | Settle fees |
-| `gas transactions` | View transactions |
-| `gas topup` | Top up balance |
-| `install package` | Install package |
-| `install list` | List installed packages |
+| `strategy show <id>` | Show strategy details |
+| `strategy subscribe <id>` | Subscribe to a strategy |
+| `strategy unsubscribe <id>` | Cancel subscription |
+| `strategy my` | My active subscriptions |
+| `strategy stream <id>` | WebSocket real-time signals |
+
+### Signals (Subscriber)
+| Command | Description |
+|---------|-------------|
+| `signals latest` | Get latest signals |
+| `signals history` | Signal history |
+| `signals ack <id>` | Acknowledge a signal |
+
+### Provider (Strategy Developer)
+| Command | Description |
+|---------|-------------|
+| `provider apply` | Apply to become a Provider |
+| `provider me` | Provider info & stats |
+| `provider earnings` | Earnings summary |
+| `provider withdraw` | Request withdrawal |
+| `provider withdrawals` | Withdrawal history |
+| `provider strategies` | My strategies |
+| `provider create-strategy` | Create a strategy |
+| `provider submit <id>` | Submit for review |
+| `provider pause/resume/delete <id>` | Strategy lifecycle |
+| `provider push-signal` | Push a trading signal |
+| `provider stats` | Provider statistics |
+
+## Environment Variables
+
+```bash
+# Required
+export API_KEY=sk-bbt-your_key
+
+# Required for signal pushing
+export PROVIDER_API_KEY=pk-bbt-your_provider_key
+
+# Optional
+export API_BASE_URL=https://platform.123456btc.com/ext-api
+export SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
+```
+
+## Signal Decisions
+
+| Decision | Meaning |
+|----------|---------|
+| `long` | Open long position |
+| `short` | Open short position |
+| `close_long` | Close long position |
+| `close_short` | Close short position |
+| `tp` | Take-profit close |
+| `sl` | Stop-loss close |
+| `partial_close` | Partial position close |
+| `cancel` | Cancel signal |
+
+## Billing Models
+
+| Model | Charge Timing | Revenue Split |
+|-------|--------------|---------------|
+| `daily_bbt` | First charge on subscribe + every 24h renewal | 70% platform burn / 30% Provider |
+| `per_signal_bbt` | On user ACK | 70% platform burn / 30% Provider |
+| `free` | No charge | — |
+
+## Architecture
+
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│  Provider   │────▶│  Platform   │────▶│ Subscriber  │
+│  (CLI push) │     │ (Broadcast) │     │ (CLI stream)│
+└─────────────┘     └─────────────┘     └─────────────┘
+```
+
+1. **Provider** pushes signals via `POST /provider/provider-api/signals` (`pk-bbt` auth)
+2. **Platform** persists to DB and broadcasts via WebSocket Durable Object
+3. **Subscriber** receives via WebSocket (`strategy stream`) or REST polling (`signals latest`)
+4. **Subscriber** ACKs via `POST /ext-api/signals/ack` (`sk-bbt` auth), triggering per-signal billing
 
 ## Development
 

package/README.zh-CN.md

@@ -0,0 +1,78 @@
+# 123456btc-cli
+
+> 123456btc 平台官方 CLI — 策略订阅、信号接收、Provider 管理一站式工具
+
+完整中文文档请参见 [README.zh-CN.md](./README.zh-CN.md)
+
+## 功能特性
+
+- **策略广场** — 浏览、筛选、订阅平台策略（按 BBT 持仓分级）
+- **实时信号** — WebSocket 接收交易信号，支持自动 ACK + 断线重连
+- **信号管理** — 历史查询、手动 ACK、执行详情上报
+- **Provider 管理** — 申请入驻、创建策略、提交审核、推送信号、收益提现
+- **API Key 认证** — `sk-bbt-xxx` 长期密钥 + `at-bbt-xxx` 短期访问令牌
+- **钱包扫码登录** — Solana 钱包扫码，自动生成 API Key
+
+## 安装
+
+```bash
+npm install -g @123456btc/123456btc-cli
+```
+
+## 快速开始
+
+### 1. 登录
+
+```bash
+# 方式一: 钱包扫码（推荐）
+123456btc-cli auth wallet-login
+
+# 方式二: 直接输入 API Key
+123456btc-cli auth login -k sk-bbt-your_key
+```
+
+### 2. 浏览并订阅策略
+
+```bash
+123456btc-cli strategy list
+123456btc-cli strategy subscribe strat-xxx
+123456btc-cli strategy my
+```
+
+### 3. 实时接收信号
+
+```bash
+123456btc-cli strategy stream strat-xxx
+```
+
+### 4. Provider 推送信号
+
+```bash
+export PROVIDER_API_KEY=pk-bbt-your_provider_key
+123456btc-cli provider push-signal \
+  --strategy-id strat-xxx \
+  --symbol BTCUSDT \
+  --decision long \
+  --price 65000
+```
+
+## 命令速查
+
+| 分类 | 命令 |
+|------|------|
+| 认证 | `auth login` / `auth wallet-login` / `auth status` / `auth verify` / `auth logout` |
+| 策略 | `strategy list` / `strategy show` / `strategy subscribe` / `strategy unsubscribe` / `strategy my` / `strategy stream` |
+| 信号 | `signals latest` / `signals history` / `signals ack` |
+| Provider | `provider apply` / `provider me` / `provider earnings` / `provider withdraw` / `provider strategies` / `provider create-strategy` / `provider submit` / `provider push-signal` / `provider stats` |
+
+## 计费模式
+
+| 模式 | 扣费时机 | 分账比例 |
+|------|----------|----------|
+| `daily_bbt` | 订阅首扣 + 每24h续费 | 70% 平台销毁 / 30% Provider |
+| `per_signal_bbt` | 用户 ACK 信号时 | 70% 平台销毁 / 30% Provider |
+| `free` | 不扣费 | — |
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@123456btc/123456btc-cli",
-  "version": "1.0.2",
-  "description": "123456btc CLI - Strategy dispatch & gas settlement for AI agents",
+  "version": "1.0.3",
+  "description": "123456btc CLI - 策略订阅、信号接收、Provider 管理一站式工具",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -22,6 +22,7 @@
     "dist",
     "bin",
     "README.md",
+    "README.zh-CN.md",
     "LICENSE"
   ],
   "keywords": [