@t2000/cli 0.2.5 → 0.2.6

package/README.md

@@ -43,11 +43,13 @@ npm install -g @t2000/cli
   npm install -g @t2000/cli
 
   t2000 balance            check for funds
-  t2000 save all USDC      start earning yield
+  t2000 save all           start earning yield
   t2000 address            show address again
 
 ❯ t2000 send 10 USDC to 0x8b3e...d412
   ✓ Sent $10.00 USDC → 0x8b3e...d412
+  Gas:  0.0042 SUI (self-funded)
+  Balance:  $90.00 USDC
   Tx:  https://suiscan.xyz/mainnet/tx/0xa1b2...
 
 ❯ t2000 save 80 USDC
@@ -62,8 +64,8 @@ npm install -g @t2000/cli
   Health Factor:  3.39
   Tx:  https://suiscan.xyz/mainnet/tx/0xb3c4...
 
-❯ t2000 swap 5 USDC to SUI
-  ✓ Swapped 5 USDC → 5.83 SUI
+❯ t2000 swap 5 USDC SUI
+  ✓ Swapped 5 USDC → 5.8300 SUI
   Tx:  https://suiscan.xyz/mainnet/tx/0xd5e6...
 
 ❯ t2000 pay https://data.api.com/prices
@@ -100,6 +102,7 @@ npm install -g @t2000/cli
 | `t2000 init` | Create a new agent bank account (Ed25519 keypair, AES-256-GCM encrypted) |
 | `t2000 lock` | Clear saved session (require PIN on next command) |
 | `t2000 balance` | Show available USDC + savings + gas reserve |
+| `t2000 balance --show-limits` | Include maxWithdraw, maxBorrow, and health factor |
 | `t2000 address` | Show wallet address |
 | `t2000 deposit` | Show funding instructions |
 | `t2000 import` | Import an existing bank account from private key |
@@ -110,16 +113,17 @@ npm install -g @t2000/cli
 
 | Command | Description |
 |---------|-------------|
-| `t2000 send <amount> USDC to <address>` | Send USDC to any Sui address |
+| `t2000 send <amount> USDC to <address>` | Send USDC to any Sui address (the `to` keyword is optional) |
 
 ### Savings & DeFi
 
 | Command | Description |
 |---------|-------------|
-| `t2000 save <amount> USDC` | Deposit USDC to NAVI Protocol (earn ~4–8% APY) |
-| `t2000 withdraw <amount> USDC` | Withdraw USDC from savings |
-| `t2000 borrow <amount> USDC` | Borrow USDC against savings collateral |
-| `t2000 repay <amount> USDC` | Repay outstanding borrows |
+| `t2000 save <amount> [asset]` | Deposit to NAVI Protocol (earn ~4–8% APY). Asset defaults to USDC. |
+| `t2000 save all` | Deposit all available USDC |
+| `t2000 withdraw <amount> [asset]` | Withdraw from savings |
+| `t2000 borrow <amount> [asset]` | Borrow against savings collateral |
+| `t2000 repay <amount> [asset]` | Repay outstanding borrows. Use `repay all` for full repayment. |
 | `t2000 swap <amount> <from> <to>` | Swap via Cetus DEX (e.g. `swap 5 USDC SUI`) |
 | `t2000 health` | Check savings health factor |
 | `t2000 rates` | Current NAVI save/borrow APYs |
@@ -134,12 +138,15 @@ npm install -g @t2000/cli
 | `t2000 pay <url>` | Pay for an x402-protected API resource |
 | `t2000 pay <url> --max-price 0.10` | Set max USDC per request (default: $1.00) |
 | `t2000 pay <url> --method POST --data '{...}'` | POST with JSON body |
+| `t2000 pay <url> --header 'key=value'` | Add custom HTTP headers (repeatable) |
+| `t2000 pay <url> --timeout 60` | Request timeout in seconds (default: 30) |
+| `t2000 pay <url> --dry-run` | Show what would be paid without paying |
 
 ### Configuration
 
 | Command | Description |
 |---------|-------------|
-| `t2000 config get <key>` | Show a config value |
+| `t2000 config get [key]` | Show a config value (omit key for all) |
 | `t2000 config set <key> <value>` | Set a config value |
 
 ### HTTP API Server
@@ -155,14 +162,27 @@ curl -X POST -H "Authorization: Bearer t2k_..." \
   http://localhost:3001/v1/send
 ```
 
-## Flags
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--port <port>` | Port number | `3001` |
+| `--rate-limit <rps>` | Max requests per second | `10` |
+
+## Global Flags
 
 | Flag | Description |
 |------|-------------|
 | `--json` | Structured JSON output (for automation) |
 | `--yes` | Skip confirmation prompts |
-| `--key <path>` | Custom key file path |
-| `--network <net>` | `mainnet` or `testnet` |
+
+## Per-Command Options
+
+| Command | Option | Description | Default |
+|---------|--------|-------------|---------|
+| `init` | `--name <name>` | Agent name | — |
+| `init` | `--no-sponsor` | Skip gas sponsorship | — |
+| `swap` | `--slippage <percent>` | Max slippage % | `3` |
+| `history` | `--limit <n>` | Number of transactions | `20` |
+| Most commands | `--key <path>` | Custom key file path | `~/.t2000/wallet.key` |
 
 ## Configuration
 
@@ -178,19 +198,30 @@ Config is stored at `~/.t2000/config.json`.
 | Variable | Description |
 |----------|-------------|
 | `T2000_PIN` | Bank account PIN (skip interactive prompt) |
-| `T2000_NETWORK` | Override network (`mainnet` / `testnet`) |
-| `T2000_KEY_PATH` | Custom key file path |
+| `T2000_PRIVATE_KEY` | Private key for `t2000 import` (skip interactive prompt) |
 
 ## Gas Handling
 
 Gas is fully automated:
 
-1. **Sponsored** — early transactions are free via the t2000 Gas Station
-2. **Self-funded** — uses SUI balance after bootstrap
-3. **Auto-topup** — swaps $1 USDC → SUI when gas reserve is low
+1. **Self-funded** — uses SUI balance when reserve ≥ 0.05 SUI
+2. **Auto-topup** — swaps $1 USDC → SUI when gas reserve is low
+3. **Sponsored** — Gas Station sponsors the transaction as a fallback
 
 You never need to manually acquire SUI for gas.
 
+## Protocol Fees
+
+| Operation | Fee |
+|-----------|-----|
+| Save | 0.1% |
+| Borrow | 0.05% |
+| Swap | **Free** |
+| Withdraw | Free |
+| Repay | Free |
+| Send | Free |
+| Pay (x402) | Free |
+
 ## File Locations
 
 | File | Path | Description |
@@ -203,13 +234,13 @@ You never need to manually acquire SUI for gas.
 ```bash
 # Full DeFi cycle
 t2000 save all USDC         # Deposit all available USDC
-t2000 borrow 40 USDC       # Borrow against it
-t2000 repay 40 USDC        # Pay it back
-t2000 withdraw all USDC    # Get everything out
+t2000 borrow 40 USDC        # Borrow against it
+t2000 repay 40 USDC         # Pay it back
+t2000 withdraw all USDC     # Get everything out
 
 # Automation-friendly (no prompts, JSON output)
 t2000 balance --json
-t2000 send 10 USDC to 0x... --yes --json
+t2000 save 10 USDC --yes --json
 
 # Use with AI coding agents
 export T2000_PIN="agent-secret"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t2000/cli",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "CLI bank account for AI agents on Sui — send, save, swap, borrow from your terminal",
   "type": "module",
   "bin": {
@@ -37,8 +37,8 @@
     "commander": "^13",
     "hono": "^4",
     "picocolors": "^1",
-    "@t2000/sdk": "0.2.5",
-    "@t2000/x402": "0.2.4"
+    "@t2000/sdk": "0.2.6",
+    "@t2000/x402": "0.2.6"
   },
   "devDependencies": {
     "@types/node": "^22",