@heyamiko/amiko-cli 0.2.2 → 0.3.0

package/README.md

@@ -1,222 +1,187 @@
 # Amiko CLI
 
-Command-line interface for the Amiko AI Agent Marketplace. Browse, call, and pay for AI agent services directly from your terminal.
+Manage agents, wallets, credits, and the MPP marketplace from your terminal. Works for both human users and AI agents running on OpenClaw.
 
 ## Install
 
 ```bash
 npm install -g @heyamiko/amiko-cli
+# or
+bun install -g @heyamiko/amiko-cli
 ```
 
-Or run from source:
+Update to latest:
 
 ```bash
-git clone <repo> && cd amiko-cli
-npm install
-npm run build
-npm link          # makes `amiko` available globally
+amiko update
 ```
 
 ## Quick Start
 
 ```bash
-# Sign in
-amiko login
+# Connect your account
+amiko connect <CODE>              # paste code from Amiko settings
+amiko connect amk_<key>           # or use your API key directly
+amiko connect                     # or open browser to sign in
 
-# Browse the marketplace
-amiko browse
+# Check your balance
+amiko credits balance
 
-# Call an agent (auto-pays via Tempo or API key)
-amiko call titan-research "Summarize the latest news on AI agents"
+# Top up credits from your agent's wallet
+amiko credits topup 10000 --token AMIKO --yes
 
-# Check your balance
-amiko wallet balance
+# Browse and call marketplace agents
+amiko browse
+amiko call titan-research "Summarize the latest AI news"
 ```
 
-## Payment
+## Connect
 
-The CLI supports two payment methods, checked in this order:
-
-1. **Tempo wallet** (preferred) — on-chain payments handled automatically via the [Tempo CLI](https://tempo.xyz)
-2. **API key** — pre-funded account balance, topped up via Stripe
+Three ways to authenticate:
 
 ```bash
-# Option 1: Tempo
-curl -fsSL https://tempo.xyz/install | bash
-tempo wallet login
-
-# Option 2: API key
-amiko config set apiKey amk_<your-key>
-amiko wallet topup 10
+amiko connect <CODE>              # 7-char code from platform settings (recommended)
+amiko connect amk_<key>           # API key (shown once at creation)
+amiko connect                     # browser sign-in flow
 ```
 
-## Commands
-
-### Marketplace
-
-| Command | Description |
-|---------|-------------|
-| `amiko browse` | Browse marketplace agents |
-| `amiko info <agent>` | Show agent details, pricing, and stats |
-| `amiko popular` | Trending agents by period |
-| `amiko activity` | Recent payment activity |
-| `amiko leaderboard` | Top creators by revenue/usage |
-
-**Browse options:**
+The connect code is the simplest — generate one from your Amiko settings page, paste it to the agent or terminal.
 
 ```bash
-amiko browse -c research              # filter by category
-amiko browse -s newest -l 10          # sort by newest, limit 10
-amiko browse -q "image generation"    # search by keyword
+amiko whoami                      # show current auth status
+amiko logout                      # clear stored credentials
 ```
 
-**Popular options:**
+## Credits
 
 ```bash
-amiko popular -p day                  # trending today
-amiko popular -p month -l 20         # top 20 this month
+amiko credits balance             # credit balance + wallet balances across all chains
+amiko credits topup <amount>      # top up credits (amount in credits, e.g. 10000)
 ```
 
-### Calling Agents
+**Top-up options:**
 
 ```bash
-# Single message
-amiko call titan-research "What is quantum computing?"
-
-# Pipe input
-echo "Explain transformer architecture" | amiko call titan-research
-
-# Interactive REPL
-amiko call titan-research -i
+amiko credits topup 10000                             # auto-select best wallet + token
+amiko credits topup 10000 --token AMIKO               # use AMIKO (Solana)
+amiko credits topup 10000 --token USDC --chain base   # use USDC on Base
+amiko credits topup 5000 --method mpp                 # use MPP 402 payment
+amiko credits topup 10000 --wallet Gu2b...QVya        # specific wallet address
+amiko credits topup 10000 --yes                       # skip confirmation
+```
 
-# Use task endpoint instead of chat
-amiko call titan-research "Generate a report" --task
+**How it works:**
+1. CLI fetches live token price from Jupiter
+2. Transfers tokens from your Crossmint agent wallet to the treasury via billing API
+3. Verifies the on-chain transfer and credits your account
+4. All calls go through `billing.heyamiko.com` — no other dependencies
 
-# Preview cost without executing (Tempo only)
-amiko call titan-research "hello" --dry-run
+**Supported tokens:** AMIKO, SOL, USDC, USDT, ETH
+**Supported chains:** Solana, Base, Ethereum, Tempo
 
-# Raw JSON output
-amiko call titan-research "hello" --raw
+## Wallet
 
-# Force API key payment (skip Tempo)
-amiko call titan-research "hello" --no-tempo
+```bash
+amiko wallet create               # create MPP wallet on Tempo
+amiko wallet balance [address]    # check USDC.e balance
+amiko wallet balance --watch      # poll every 5s
+amiko wallet topup <amount>       # Stripe checkout ($1-$100)
+amiko wallet deposit [address]    # USDC.e deposit instructions
+amiko wallet login                # Tempo wallet login
+amiko wallet whoami               # Tempo wallet identity
+amiko wallet fund                 # fund via Tempo dashboard
 ```
 
-### Wallet Management
-
-| Command | Description |
-|---------|-------------|
-| `amiko wallet create` | Create a new MPP wallet on Tempo |
-| `amiko wallet balance [address]` | Check USDC.e balance |
-| `amiko wallet login` | Log in to Tempo wallet |
-| `amiko wallet whoami` | Show Tempo wallet identity |
-| `amiko wallet fund` | Fund wallet via Tempo dashboard |
-| `amiko wallet topup <amount>` | Top up via Stripe ($1-$100) |
-| `amiko wallet deposit [address]` | Show USDC.e deposit instructions |
+## Marketplace
 
 ```bash
-# Watch balance in real time
-amiko wallet balance --watch
-amiko wallet balance --watch --interval 10
-
-# Create wallet and save to config
-amiko wallet create --save
-
-# Top up and open Stripe in browser
-amiko wallet topup 25 --open
+amiko browse                      # browse agents
+amiko browse -c research -l 10   # filter by category
+amiko info <agent>                # agent details + pricing
+amiko popular                     # trending agents
+amiko activity                    # recent payments
+amiko leaderboard                 # top creators
 ```
 
-### Authentication
+## Calling Agents
 
 ```bash
-amiko login                # Sign in via browser (Privy)
-amiko login --no-browser   # Print login URL instead
-amiko logout               # Clear stored credentials
-amiko whoami               # Show current auth status
+amiko call <agent> "message"      # single message
+amiko call <agent> -i             # interactive REPL
+echo "input" | amiko call <agent> # pipe input
+amiko call <agent> "msg" --task   # task endpoint
+amiko call <agent> "msg" --dry-run # preview cost
 ```
 
-### Creator Dashboard
-
-Requires authentication (`amiko login`).
+## Creator Dashboard
 
 ```bash
-amiko creator summary      # Earnings, listings, and payout status
-amiko creator listings     # List all your agent listings
-amiko creator publish <id> # Publish a draft listing
-amiko creator payout       # Request payout of available earnings
+amiko creator summary             # earnings + listings
+amiko creator listings            # your agent listings
+amiko creator publish <id>        # publish a draft
+amiko creator payout              # request payout
 ```
 
-### Reputation
+## Other Commands
 
 ```bash
-amiko reputation                    # Look up your TARS score
-amiko reputation 0xabc...def       # Look up any address
-amiko rep 0xabc...def              # Short alias
+amiko reputation [address]        # TARS score
+amiko discover                    # MPP service info
+amiko ping                        # health check
+amiko bridge quote 5              # cross-chain bridge quote
+amiko config show                 # view config
+amiko config set <key> <value>    # set config value
+amiko update                      # update CLI to latest
 ```
 
-Displays a 1-5 star rating with total jobs, volume, feedback count, confidence, and on-chain verification status.
+## Agent Integration (OpenClaw)
 
-### Service Discovery
+Agents install the CLI and connect with a code from the user:
 
 ```bash
-amiko discover             # MPP service info, endpoints, and pricing
-amiko status               # Alias for discover
-amiko ping                 # Health check with latency
+npm install -g @heyamiko/amiko-cli
+amiko connect <CODE>
+amiko credits balance
+amiko credits topup 10000 --token AMIKO --yes
 ```
 
-### Configuration
+The CLI auto-detects `.amiko.json` (synced by the platform) when running on an agent.
 
-Config is stored at `~/.amiko/config.json`.
+## Configuration
 
-```bash
-amiko config show          # Display current configuration
-amiko config set <key> <v> # Set a value
-amiko config reset         # Reset to defaults
-amiko config path          # Print config file path
-```
-
-**Default endpoints:**
+Config: `~/.amiko/config.json`
 
 | Key | Default |
 |-----|---------|
-| `apiBase` | `https://mpp.heyamiko.com` |
 | `billingBase` | `https://billing.heyamiko.com` |
-| `siteBase` | `https://amikomarkets.com` |
-
-**Configurable keys:** `apiBase`, `billingBase`, `siteBase`, `wallet`, `apiKey`, `privyToken`, `userId`, `connectedKeyId`, `connectedKeyName`, `connectedKeyPreview`
-
-## Development
-
-```bash
-npm run dev -- browse              # Run commands without building
-npm run build                      # Compile to dist/
-npm run typecheck                  # Type-check without emitting
-npm test                           # Run tests
-```
+| `apiBase` | `https://mpp.amikomarkets.com` |
+| `siteBase` | `https://platform.heyamiko.com` |
 
 ## Architecture
 
 ```
 src/
-├── index.ts              # Entry point — registers all commands
+├── index.ts              # entry point
+├── onboarding.ts         # first-run setup
 ├── commands/
-│   ├── browse.ts         # browse, info
-│   ├── call.ts           # call (Tempo + API key + interactive)
-│   ├── wallet.ts         # wallet subcommands
+│   ├── connect.ts        # connect (code, API key, browser)
+│   ├── credits.ts        # credits balance + topup
+│   ├── browse.ts         # marketplace browsing
+│   ├── call.ts           # call agents
+│   ├── wallet.ts         # MPP wallet management
 │   ├── creator.ts        # creator dashboard
-│   ├── reputation.ts     # TARS reputation lookup
-│   ├── config.ts         # config management
-│   ├── discovery.ts      # discover, ping
-│   ├── marketplace.ts    # activity, leaderboard, popular
-│   └── login.ts          # login, logout, whoami
+│   ├── login.ts          # Privy browser login
+│   ├── update.ts         # self-update
+│   └── ...
 └── lib/
-    ├── api.ts            # HTTP client (MPP + billing services)
-    ├── config.ts         # ~/.amiko/config.json I/O
-    ├── format.ts         # Terminal formatting (tables, colors)
-    └── tempo.ts          # Tempo CLI detection and invocation
+    ├── config.ts          # ~/.amiko/config.json
+    ├── agent-config.ts    # .amiko.json reader
+    ├── api.ts             # HTTP client
+    ├── mpp-topup.ts       # MPP SDK helper
+    └── ...
 ```
 
-Built with [Commander](https://github.com/tj/commander.js), [chalk](https://github.com/chalk/chalk), and [ora](https://github.com/sindresorhus/ora). Bundled with [tsup](https://github.com/egoist/tsup).
+Built with [Commander](https://github.com/tj/commander.js), [chalk](https://github.com/chalk/chalk), [ora](https://github.com/sindresorhus/ora), and [@solana/mpp](https://github.com/solana-foundation/mpp-sdk). Bundled with [Bun](https://bun.sh).
 
 ## License
 

package/dist/index.js

@@ -23311,7 +23311,7 @@ var CONFIG_FILE = join(CONFIG_DIR, "config.json");
 var DEFAULTS = {
   apiBase: "https://mpp.amikomarkets.com",
   billingBase: "https://billing.heyamiko.com",
-  siteBase: "https://amikomarkets.com"
+  siteBase: "https://platform.heyamiko.com"
 };
 var LEGACY_SITE_BASES = new Set([
   "https://amiko-markets.vercel.app",
@@ -23418,6 +23418,7 @@ var SKIP_COMMANDS = new Set([
   "config",
   "login",
   "logout",
+  "whoami",
   "connect",
   "credits",
   "update"
@@ -23436,7 +23437,7 @@ async function runOnboarding(argv) {
   if (cmd && SKIP_COMMANDS.has(cmd))
     return false;
   const config = loadConfig();
-  if (config.wallet || config.privyToken || config.apiKey)
+  if (config.wallet || config.privyToken || config.apiKey || config.twinToken || config.agentWallets?.length)
     return false;
   console.log("");
   console.log(heading("Welcome to Amiko CLI"));
@@ -25336,11 +25337,14 @@ var VALID_KEYS = [
   "apiBase",
   "billingBase",
   "siteBase",
+  "platformUrl",
   "wallet",
   "apiKey",
   "privyToken",
   "creatorToken",
   "userId",
+  "twinId",
+  "twinToken",
   "connectedKeyId",
   "connectedKeyName",
   "connectedKeyPreview"
@@ -25657,6 +25661,18 @@ function registerLoginCommand(program2) {
     console.log(heading("Amiko Login"));
     console.log(dim(`Authenticate your CLI with your Amiko account.
 `));
+    const isHeadless = !process.stdout.isTTY || !process.env.DISPLAY && process.platform === "linux";
+    if (isHeadless) {
+      console.log(source_default.yellow("⚠ No browser available in this environment."));
+      console.log("");
+      console.log(dim("For agents and headless environments, use connect instead:"));
+      console.log("");
+      console.log(source_default.cyan("  amiko connect <CODE>"));
+      console.log("");
+      console.log(dim("Generate a connect code from your Amiko settings page,"));
+      console.log(dim("then run the command above with the code."));
+      process.exit(0);
+    }
     if (existingToken) {
       console.log(dim("Already signed in."));
       if (config.userId)
@@ -26386,26 +26402,91 @@ function printSuccess(data) {
   console.log(success("Account connected. You can now run: amiko credits topup <amount>"));
 }
 function saveCredentials(data) {
-  saveConfig({
-    userId: data.userId,
-    platformUrl: data.platformUrl,
-    billingBase: data.billingBase,
-    agentWallets: data.wallets
-  });
+  const update = {};
+  if (data.userId)
+    update.userId = data.userId;
+  if (data.platformUrl)
+    update.platformUrl = data.platformUrl;
+  if (data.billingBase)
+    update.billingBase = data.billingBase;
+  if (data.twinId)
+    update.twinId = data.twinId;
+  if (data.twinToken)
+    update.twinToken = data.twinToken;
+  if (data.privyToken)
+    update.privyToken = data.privyToken;
+  if (data.connectedKeyId)
+    update.connectedKeyId = data.connectedKeyId;
+  if (data.connectedKeyPreview)
+    update.connectedKeyPreview = data.connectedKeyPreview;
+  if (data.connectedKeyName)
+    update.connectedKeyName = data.connectedKeyName;
+  if (data.wallets)
+    update.agentWallets = data.wallets;
+  saveConfig(update);
 }
 function registerConnectCommand(program2) {
   program2.command("connect").description("Connect to an Amiko account (opens browser, or pass a connect URL)").argument("[url]", "Connect URL from Amiko settings (optional — opens browser if omitted)").option("--no-browser", "Print the connect URL instead of opening a browser").action(async (urlStr, opts) => {
     if (urlStr) {
+      const input = urlStr.trim();
+      if (input.startsWith("amk_")) {
+        const spinner3 = ora("Connecting with API key...").start();
+        try {
+          const config2 = loadConfig();
+          const billingBase2 = config2.billingBase || "https://billing.heyamiko.com";
+          const res = await fetch(`${billingBase2}/api/auth/bootstrap`, {
+            headers: { Authorization: `Bearer ${input}` }
+          });
+          if (!res.ok) {
+            spinner3.stop();
+            const err = await res.json().catch(() => ({ error: "Invalid API key" }));
+            console.error(error(err.error || `Authentication failed: ${res.status}`));
+            process.exit(1);
+          }
+          const data = await res.json();
+          spinner3.stop();
+          saveConfig({
+            apiKey: input,
+            userId: data.userId,
+            connectedKeyId: data.connectedKey?.id,
+            connectedKeyName: data.connectedKey?.name,
+            connectedKeyPreview: data.connectedKey?.keyPreview
+          });
+          console.log(heading("Connected"));
+          console.log("");
+          console.log(label("User", data.userId));
+          if (data.connectedKey) {
+            console.log(label("Key", `${data.connectedKey.name} (${data.connectedKey.keyPreview})`));
+          }
+          console.log(label("Credits", Number(data.credits?.balance || 0).toLocaleString()));
+          console.log("");
+          console.log(success("Account connected via API key."));
+        } catch (err) {
+          spinner3.stop();
+          console.error(error(err instanceof Error ? err.message : "Failed to connect"));
+          process.exit(1);
+        }
+        return;
+      }
       const spinner2 = ora("Connecting...").start();
       try {
-        const url = new URL(urlStr);
-        const code = url.searchParams.get("code");
+        let code;
+        let redeemOrigin;
+        try {
+          const url = new URL(input);
+          code = url.searchParams.get("code") || input;
+          redeemOrigin = url.origin;
+        } catch {
+          code = input;
+          const config2 = loadConfig();
+          redeemOrigin = config2.billingBase || "https://billing.heyamiko.com";
+        }
         if (!code) {
           spinner2.stop();
-          console.error(error("Invalid connect URL — missing code parameter."));
+          console.error(error("Invalid code or URL."));
           process.exit(1);
         }
-        const redeemUrl = `${url.origin}/api/cli/connect/redeem`;
+        const redeemUrl = `${redeemOrigin}/api/cli/connect/redeem`;
         const res = await fetch(redeemUrl, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
@@ -26430,7 +26511,7 @@ function registerConnectCommand(program2) {
     }
     const config = loadConfig();
     const state = randomBytes2(16).toString("hex");
-    const platformUrl = config.platformUrl || process.env.AMIKO_PLATFORM_URL || "https://app.heyamiko.com";
+    const platformUrl = config.platformUrl || process.env.AMIKO_PLATFORM_URL || "https://platform.heyamiko.com";
     console.log(heading("Amiko Connect"));
     console.log(dim(`Connect your CLI to your Amiko account.
 `));
@@ -26499,7 +26580,7 @@ function loadAgentConfig() {
   return null;
 }
 function resolveAuth(cliConfig) {
-  if (cliConfig.platformUrl && cliConfig.agentWallets?.length) {
+  if (cliConfig.agentWallets?.length) {
     return {
       mode: "connected",
       platformUrl: cliConfig.platformUrl,
@@ -26507,6 +26588,7 @@ function resolveAuth(cliConfig) {
       twinId: cliConfig.twinId,
       twinToken: cliConfig.twinToken,
       platformKey: cliConfig.apiKey,
+      privyToken: cliConfig.privyToken,
       connectedKeyId: cliConfig.connectedKeyId,
       userId: cliConfig.userId,
       agentWallets: cliConfig.agentWallets
@@ -26517,6 +26599,7 @@ function resolveAuth(cliConfig) {
       mode: "connected",
       billingBase: cliConfig.billingBase,
       platformKey: cliConfig.privyToken,
+      privyToken: cliConfig.privyToken,
       connectedKeyId: cliConfig.connectedKeyId,
       userId: cliConfig.userId
     };
@@ -26612,23 +26695,32 @@ function registerCreditsCommand(program2) {
       spinner.stop();
       console.log(heading("Credits"));
       console.log("");
-      if (auth.billingBase && auth.platformKey) {
+      {
         const spinner2 = ora("Fetching credit balance...").start();
         try {
-          const res = await fetch(`${auth.billingBase}/api/credits`, {
-            headers: { Authorization: `Bearer ${auth.platformKey}` }
-          });
-          if (!res.ok) {
-            spinner2.stop();
-            const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
-            console.error(error(err.error || `Failed to fetch credit balance: ${res.status}`));
-          } else {
-            const data = await res.json();
-            spinner2.stop();
-            console.log(label("Balance", `${data.balance ?? 0} credits`));
-            if (data.spent !== undefined) {
-              console.log(label("Spent", `${data.spent} credits`));
+          let creditsData = null;
+          if (auth.billingBase && auth.platformKey) {
+            const res = await fetch(`${auth.billingBase}/api/credits`, {
+              headers: { Authorization: `Bearer ${auth.platformKey}` }
+            });
+            if (res.ok)
+              creditsData = await res.json();
+          }
+          if (!creditsData && auth.platformUrl && auth.twinId && auth.twinToken) {
+            const res = await fetch(`${auth.platformUrl}/api/agents/${auth.twinId}/credits/balance`, {
+              headers: { Authorization: `Bearer ${auth.twinToken}` }
+            });
+            if (res.ok) {
+              const data = await res.json();
+              creditsData = { balance: data.balance };
             }
+          }
+          spinner2.stop();
+          if (creditsData) {
+            console.log(label("Balance", source_default.bold(Number(creditsData.balance || 0).toLocaleString())));
+            console.log("");
+          } else {
+            console.log(dim("  Could not fetch credit balance"));
             console.log("");
           }
         } catch (err) {
@@ -26655,10 +26747,44 @@ function registerCreditsCommand(program2) {
             } else {
               console.log(label("Agent Wallets", ""));
               for (const w of wallets) {
-                const chain = w.chain ?? "?";
-                const token = w.token ?? "";
-                const balance = w.balance ?? 0;
-                console.log(dim(`  ${chain}${token ? ` (${token})` : ""}: ${balance}`));
+                const rawChain = w.chain ?? "?";
+                const isEvm = ["base", "ethereum", "tempo"].includes(rawChain);
+                const chainLabel = isEvm ? "EVM (Ethereum · Base · Tempo)" : rawChain.charAt(0).toUpperCase() + rawChain.slice(1);
+                const addr = w.wallet_address || "";
+                const shortAddr = addr ? `${addr.slice(0, 6)}...${addr.slice(-4)}` : "";
+                console.log(`  ${source_default.bold(chainLabel)} ${dim(shortAddr)}`);
+                let bals = w.balance && typeof w.balance === "object" ? w.balance : null;
+                if (!bals) {
+                  try {
+                    const balRes = await fetch(`${auth.platformUrl}/api/agents/${auth.twinId}/wallets/${addr}/balance`, { headers: { Authorization: `Bearer ${auth.twinToken}` } });
+                    if (balRes.ok) {
+                      const balData = await balRes.json();
+                      if (balData.chains) {
+                        for (const [chainName, chainBals] of Object.entries(balData.chains)) {
+                          const chainLabel2 = chainName.charAt(0).toUpperCase() + chainName.slice(1);
+                          console.log(dim(`    ${chainLabel2}:`));
+                          for (const [token, tData] of Object.entries(chainBals)) {
+                            const human = parseFloat(tData.amount) / Math.pow(10, tData.decimals);
+                            console.log(dim(`      ${token.padEnd(8)} ${human.toFixed(6)}`));
+                          }
+                        }
+                        continue;
+                      }
+                      bals = balData.balances || {};
+                    }
+                  } catch {
+                    console.log(dim("    (balance unavailable)"));
+                    continue;
+                  }
+                }
+                if (bals) {
+                  for (const [token, data2] of Object.entries(bals)) {
+                    const human = parseFloat(data2.amount) / Math.pow(10, data2.decimals);
+                    if (human > 0 || ["sol", "eth", "usdc", "amiko"].includes(token.toLowerCase())) {
+                      console.log(dim(`    ${token.padEnd(10)} ${human.toFixed(6)}`));
+                    }
+                  }
+                }
               }
             }
             console.log("");
@@ -26688,11 +26814,18 @@ function registerCreditsCommand(program2) {
         console.error(error("Not connected"));
         process.exit(1);
       }
-      if (!auth.platformUrl || !auth.twinId) {
+      if (!auth.billingBase) {
+        spinner.stop();
+        console.error(error("Billing service not configured. Run: amiko connect"));
+        process.exit(1);
+      }
+      const authToken = auth.platformKey || auth.privyToken;
+      if (!authToken) {
         spinner.stop();
-        console.error(error("Platform URL and twin ID required for top-up. Run: amiko connect <url>"));
+        console.error(error("No API key or auth token. Run: amiko connect"));
         process.exit(1);
       }
+      const authHeaders2 = { Authorization: `Bearer ${authToken}`, "Content-Type": "application/json" };
       spinner.stop();
       if (!options2.yes) {
         console.log(warn(`About to top up ${credits2} credits.`));
@@ -26700,74 +26833,132 @@ function registerCreditsCommand(program2) {
         console.log("");
       }
       if (options2.method === "mpp" && auth.userId && auth.connectedKeyId) {
-        const spinner22 = ora("Topping up credits via MPP...").start();
+        const spinner2 = ora("Topping up credits via MPP...").start();
         const mppResult = await mppCreditsTopup({
           userId: auth.userId,
           keyId: auth.connectedKeyId,
           amount: credits2 / 1e4
         });
-        spinner22.stop();
+        spinner2.stop();
         if (!mppResult.success) {
           console.error(error(mppResult.error || "MPP top-up failed"));
           process.exit(1);
         }
-        console.log(heading("Top-up Complete"));
+        console.log(heading("Top-up Complete (MPP)"));
         console.log("");
-        if (mppResult.credits?.added !== undefined) {
-          console.log(label("Credits Added", `${mppResult.credits.added}`));
-        }
-        if (mppResult.credits?.balance !== undefined) {
-          console.log(label("New Balance", `${mppResult.credits.balance} credits`));
-        }
-        console.log("");
-        console.log(success("Credits topped up successfully via MPP."));
+        if (mppResult.credits?.balance)
+          console.log(label("Balance", mppResult.credits.balance));
+        console.log(success("Credits topped up via MPP."));
         return;
       }
-      const spinner2 = ora("Topping up credits...").start();
-      const body = { credits: credits2 };
-      if (options2.token)
-        body.token = options2.token;
-      if (options2.chain)
-        body.chain = options2.chain;
-      if (options2.wallet)
-        body.walletAddress = options2.wallet;
-      if (auth.platformKey && auth.connectedKeyId) {
-        body.platformKey = { key: auth.platformKey, keyId: auth.connectedKeyId };
-      }
-      const res = await fetch(`${auth.platformUrl}/api/agents/${auth.twinId}/credits/topup`, {
+      const agentWallet = auth.agentWallets?.find((w) => w.source === "agent");
+      const walletAddr = options2.wallet || agentWallet?.address || auth.agentWallets?.[0]?.address;
+      const walletChain = options2.chain || auth.agentWallets?.find((w) => w.address === walletAddr)?.chain || "solana";
+      const token = options2.token || "AMIKO";
+      if (!walletAddr) {
+        console.error(error("No wallet found. Specify --wallet <address>"));
+        process.exit(1);
+      }
+      const usdAmount = credits2 / 1e4;
+      let tokenAmount;
+      const stablecoins = ["usdc", "usdt", "usdc.e", "usdt0"];
+      if (stablecoins.includes(token.toLowerCase())) {
+        tokenAmount = usdAmount;
+      } else {
+        const spinner2 = ora(`Fetching ${token} price...`).start();
+        try {
+          const MINTS = {
+            AMIKO: "AY1Ww6MxwC3cCiyrandHqLrp4FXvzgcwQTZpJ2FEpump",
+            SOL: "So11111111111111111111111111111111111111112"
+          };
+          const USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+          const mint = MINTS[token.toUpperCase()];
+          if (!mint) {
+            spinner2.stop();
+            console.error(error(`Unknown token: ${token}`));
+            process.exit(1);
+          }
+          const decimals = token.toUpperCase() === "SOL" ? 9 : 6;
+          const oneToken = Math.pow(10, decimals).toString();
+          const jupRes = await fetch(`https://lite-api.jup.ag/swap/v1/quote?inputMint=${mint}&outputMint=${USDC_MINT}&amount=${oneToken}&slippageBps=100`);
+          if (!jupRes.ok) {
+            spinner2.stop();
+            console.error(error("Failed to fetch token price"));
+            process.exit(1);
+          }
+          const jupData = await jupRes.json();
+          const pricePerToken = parseFloat(jupData.outAmount) / 1e6;
+          tokenAmount = usdAmount / pricePerToken;
+          spinner2.stop();
+          console.log(label("Price", `1 ${token} = $${pricePerToken.toFixed(4)}`));
+          console.log(label("Cost", `${tokenAmount.toFixed(6)} ${token} (~$${usdAmount.toFixed(2)})`));
+          console.log("");
+        } catch {
+          spinner2.stop();
+          console.error(error("Failed to fetch token price"));
+          process.exit(1);
+        }
+      }
+      const TREASURY = "FPiZAf3jEnNfCwfvbv46jdPfHbmSepD4Q6iHiLJDQXvb";
+      const spinner3 = ora("Transferring tokens to treasury...").start();
+      const transferRes = await fetch(`${auth.billingBase}/api/crossmint/wallets/${encodeURIComponent(walletAddr)}/transfer`, {
         method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...auth.twinToken ? { Authorization: `Bearer ${auth.twinToken}` } : {}
-        },
-        body: JSON.stringify(body)
+        headers: authHeaders2,
+        body: JSON.stringify({
+          to: TREASURY,
+          amount: tokenAmount.toFixed(6),
+          token,
+          chain: walletChain
+        })
       });
-      spinner2.stop();
-      if (!res.ok) {
-        const err = await res.json().catch(() => ({ error: `HTTP ${res.status}` }));
-        console.error(error(err.error || `Top-up failed: ${res.status}`));
+      if (!transferRes.ok) {
+        spinner3.stop();
+        const err = await transferRes.json().catch(() => ({ error: "Transfer failed" }));
+        console.error(error(err.error || `Transfer failed: ${transferRes.status}`));
         process.exit(1);
       }
-      const data = await res.json();
-      console.log(heading("Top-up Complete"));
-      console.log("");
-      if (data.creditsAdded !== undefined) {
-        console.log(label("Credits Added", `${data.creditsAdded}`));
-      }
-      if (data.tokenAmount !== undefined) {
-        console.log(label("Token Amount", `${data.tokenAmount}${data.token ? ` ${data.token}` : ""}`));
+      const transferData = await transferRes.json();
+      const txHash = transferData.txHash;
+      spinner3.stop();
+      if (!txHash) {
+        console.error(error("Transfer sent but no transaction hash returned."));
+        process.exit(1);
       }
-      if (data.usdValue !== undefined) {
-        console.log(label("USD Value", usd(data.usdValue)));
+      console.log(label("Tx Hash", dim(txHash.slice(0, 16) + "...")));
+      const keyId = auth.connectedKeyId;
+      if (!keyId) {
+        console.log(warn("No connected API key — transfer sent but credits not verified."));
+        console.log(dim(`Tx: ${txHash}`));
+        process.exit(0);
       }
-      if (data.txHash) {
-        console.log(label("Tx Hash", dim(data.txHash)));
+      const spinner4 = ora("Verifying and crediting...").start();
+      const verifyRes = await fetch(`${auth.billingBase}/api/user/keys/${keyId}/topup/wallet`, {
+        method: "POST",
+        headers: authHeaders2,
+        body: JSON.stringify({
+          txSignature: txHash,
+          amount: tokenAmount,
+          token: token.toUpperCase()
+        })
+      });
+      spinner4.stop();
+      if (!verifyRes.ok) {
+        const err = await verifyRes.json().catch(() => ({ error: "Verify failed" }));
+        console.error(error(err.error || "Transfer sent but credit verification failed."));
+        console.log(dim(`Tx: ${txHash}`));
+        process.exit(1);
       }
-      if (data.newBalance !== undefined) {
-        console.log(label("New Balance", `${data.newBalance} credits`));
+      const verifyData = await verifyRes.json();
+      console.log(heading("Top-up Complete"));
+      console.log("");
+      console.log(label("Credits", source_default.bold(credits2.toLocaleString())));
+      console.log(label("Token", `${tokenAmount.toFixed(6)} ${token}`));
+      console.log(label("USD", `$${usdAmount.toFixed(2)}`));
+      if (verifyData.credits?.balance) {
+        console.log(label("Balance", source_default.bold(Number(verifyData.credits.balance).toLocaleString())));
       }
       console.log("");
-      console.log(success("Credits topped up successfully."));
+      console.log(success("Credits topped up."));
     } catch (err) {
       spinner.stop();
       console.error(error(err instanceof Error ? err.message : "Failed to top up credits"));
@@ -26828,7 +27019,7 @@ var didOnboard = await runOnboarding(process.argv);
 if (didOnboard)
   process.exit(0);
 var program2 = new Command;
-program2.name("amiko").description("Amiko CLI — manage agents, wallets, credits, and marketplace on the MPP payment rail").version("0.2.2");
+program2.name("amiko").description("Amiko CLI — manage agents, wallets, credits, and the MPP marketplace").version("0.3.0");
 registerBrowseCommand(program2);
 registerCallCommand(program2);
 registerWalletCommand(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Amiko CLI — manage agents, wallets, credits, and marketplace on the MPP payment rail",
   "type": "module",
   "bin": {