@heyamiko/amiko-cli 0.9.0 → 0.9.2

package/dist/index.js

@@ -21788,6 +21788,66 @@ function registerWalletsCreateCommand(program2) {
     }
   });
 }
+function registerWalletsTransferCommand(program2) {
+  program2.command("transfer").description("Transfer tokens from a twin wallet to another address").requiredOption("--to <address>", "Recipient address").requiredOption("--amount <amount>", "Amount to send (e.g., 0.5)").requiredOption("--token <symbol>", "Token symbol (sol, usdc, usdt, amiko, eth) or mint/contract address").option("--wallet <address>", "Source wallet (defaults to your Solana wallet)").option("--chain <chain>", "Preferred chain when resolving default wallet (solana | base)", "solana").option("--yes", "Skip confirmation").option("--json", "Output raw JSON").action(async (opts) => {
+    let auth;
+    try {
+      auth = requireAuth();
+    } catch (e) {
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      process.exit(1);
+    }
+    const chain = opts.chain.toLowerCase();
+    if (chain !== "solana" && chain !== "base") {
+      console.error(error(`Unsupported chain '${opts.chain}'. Use solana or base.`));
+      process.exit(1);
+    }
+    let wallet;
+    try {
+      wallet = await resolveWalletAddress(auth, opts.wallet, chain);
+    } catch (e) {
+      console.error(error(e instanceof Error ? e.message : String(e)));
+      process.exit(1);
+    }
+    if (!opts.json) {
+      console.log(heading("Transfer"));
+      console.log("");
+      console.log(label("From", wallet));
+      console.log(label("To", opts.to));
+      console.log(label("Amount", `${opts.amount} ${opts.token.toUpperCase()}`));
+      console.log("");
+    }
+    await requireApproval({
+      cost: `${chain} gas`,
+      summary: `transfer ${opts.amount} ${opts.token.toUpperCase()} from ${truncAddr(wallet)} to ${truncAddr(opts.to)}`,
+      yes: opts.yes,
+      commandExample: `amiko wallets transfer --to ${opts.to} --amount ${opts.amount} --token ${opts.token}`
+    });
+    const spinner = opts.json ? null : ora("Sending transfer...").start();
+    try {
+      const data = await amikoWebFetch(auth, `/api/agents/${encodeURIComponent(auth.twinId)}/wallets/${encodeURIComponent(wallet)}/transfer`, {
+        method: "POST",
+        body: { to: opts.to, amount: opts.amount, token: opts.token }
+      });
+      spinner?.stop();
+      if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+      console.log(success("Transfer submitted"));
+      console.log("");
+      console.log(label("Status", data.crossmint.status));
+      if (data.txHash)
+        console.log(label("Tx", data.txHash));
+      if (data.transaction?.id)
+        console.log(label("Transaction", data.transaction.id));
+    } catch (e) {
+      spinner?.stop();
+      console.error(error(e instanceof Error ? e.message : "Failed to transfer"));
+      process.exit(1);
+    }
+  });
+}
 function registerWalletsListCommand(program2) {
   program2.command("list").alias("ls").description("List wallets for the authenticated twin").option("--json", "Output raw JSON").action(async (opts) => {
     let auth;
@@ -21859,6 +21919,7 @@ registerAmazonCommand(markets);
 registerWalletsCreateCommand(wallets);
 registerWalletsListCommand(wallets);
 registerWalletsBalanceCommand(wallets);
+registerWalletsTransferCommand(wallets);
 registerSwapCommand(wallets);
 registerBridgeCommand(wallets);
 registerConfigCommand(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyamiko/amiko-cli",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Amiko CLI — swap tokens, manage credits, bridge cross-chain, and call marketplace agents",
   "type": "module",
   "bin": {

package/skills/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: amiko-cli
-description: The Amiko CLI lets an agent act on the Amiko platform end-to-end — manage Solana/Base wallets (create, swap via Jupiter, bridge USDC via Across), top up and spend credits, call paid MPP marketplace services (X/Twitter search, image generation, Amazon product search, TTS/STT, AI chat, SFX/music), manage the twin's identity and RAG documents, voice and avatar, social graph (friends, posts, comments, feed), and Composio OAuth connections. Auth is automatic when run from the agent's workspace folder; payments are platform-custodied (no keys on disk). Use this skill whenever the user asks to do anything that would show up in their Amiko account or cost AMIKO/credits.
+description: The Amiko CLI lets an agent act on the Amiko platform end-to-end — manage Solana/Base wallets (create, swap via Jupiter, bridge USDC via Across, transfer tokens to external addresses), top up and spend credits, call paid MPP marketplace services (X/Twitter search, image generation, Amazon product search, TTS/STT, AI chat, SFX/music), manage the twin's identity and RAG documents, voice and avatar, social graph (friends, posts, comments, feed), and Composio OAuth connections. Auth is automatic when run from the agent's workspace folder; payments are platform-custodied (no keys on disk). Use this skill whenever the user asks to do anything that would show up in their Amiko account or cost AMIKO/credits.
 homepage: https://platform.heyamiko.com
 metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["node"]}}}
 ---
@@ -20,7 +20,7 @@ Each row is a first-level command group or command. Start here when the user ask
 | Command | What it does |
 |---------|--------------|
 | `amiko markets <cmd>` | Paid MPP services: X search, image gen, Amazon, TTS/STT/chat, generic service call, discover |
-| `amiko wallets <cmd>` | Wallet ops: create, list, sync balance, swap on Solana (Jupiter), bridge USDC cross-chain (Across) |
+| `amiko wallets <cmd>` | Wallet ops: create, list, sync balance, transfer tokens out, swap on Solana (Jupiter), bridge USDC cross-chain (Across) |
 | `amiko credits <cmd>` | Show credit balance, top up with AMIKO/SOL/USDC/USDT (10,000 credits = $1) |
 | `amiko twin <cmd>` | Update the twin's identity — name, description, public visibility |
 | `amiko docs <cmd>` | Manage twin RAG documents — list, upload (path/URL/stdin), delete, presign |
@@ -40,7 +40,7 @@ All twin-scoped commands accept `--twin <id>` to target a non-default twin.
 
 ## The `--wallet` default (read this before any paid command)
 
-Every paid command (`markets search`, `markets image`, `markets amazon search`, `markets service *`, `wallets swap send`) spends tokens from an on-chain wallet. As of v0.9.0-beta.9 you almost never need to pass `--wallet` explicitly:
+Every paid / value-moving command (`markets search`, `markets image`, `markets amazon search`, `markets service *`, `wallets swap send`, `wallets bridge send`, `wallets transfer`) spends tokens from an on-chain wallet. As of v0.9.0-beta.9 you almost never need to pass `--wallet` explicitly:
 
 - **Default**: the CLI auto-selects the twin's first active **Solana** wallet from `GET /api/agents/{id}/wallets`.
 - **Override**: pass `--wallet <address>` only if you want a different wallet than the default.
@@ -51,7 +51,7 @@ Every paid command (`markets search`, `markets image`, `markets amazon search`,
 
 ## Critical Rules
 
-1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI *refuses* to run `markets image`, `markets search`, `markets amazon search`, `markets service call`, `markets service tts`, `markets service stt`, `markets service chat`, `credits topup`, `wallets swap send`, or `wallets bridge send` unless `--yes` is passed. The refusal is loud: it prints the cost and the command you should re-run. **Quote the cost to the user, get explicit approval, THEN append `--yes`**. Same for destructive non-paid commands (`twin update --public`, `docs delete`, `friends remove`, `friends reports request`, `avatar update`, `voice reset`, `composio disconnect`).
+1. **Every paid / value-moving command is hard-gated on `--yes` in a non-interactive shell.** The CLI *refuses* to run `markets image`, `markets search`, `markets amazon search`, `markets service call`, `markets service tts`, `markets service stt`, `markets service chat`, `credits topup`, `wallets swap send`, `wallets bridge send`, or `wallets transfer` unless `--yes` is passed. The refusal is loud: it prints the cost and the command you should re-run. **Quote the cost to the user, get explicit approval, THEN append `--yes`**. Same for destructive non-paid commands (`twin update --public`, `docs delete`, `friends remove`, `friends reports request`, `avatar update`, `voice reset`, `composio disconnect`).
 2. **After every paid command, report the remaining balance.** The CLI prints a `Balance: N credits` line at the end of every paid command — include that figure in your reply.
 3. **Never retry a failed command.** Report the error and stop. Every paid call costs tokens even on failure.
 4. **Never suggest `amiko login` or `amiko connect`.** These don't exist. Auth is automatic when you run from your workspace folder.
@@ -72,6 +72,7 @@ Every paid command (`markets search`, `markets image`, `markets amazon search`,
 | `amiko markets service call POST /v1/music/plan ...` | $0.02 |
 | `amiko wallets swap quote ...` | Free |
 | `amiko wallets swap send ...` | Solana gas + 10bps |
+| `amiko wallets transfer ...` | Chain gas only |
 | `amiko credits topup ...` | Whatever amount you top up |
 
 ## Credits
@@ -107,6 +108,7 @@ Supported tokens: AMIKO, SOL, USDC, USDT. The CLI fetches the live price, the pl
 amiko wallets list                                   # all twin wallets + cached balances
 amiko wallets create --chain solana                  # create a wallet (solana | base)
 amiko wallets balance <address>                      # force-sync one wallet; returns fresh balances
+amiko wallets transfer --to <addr> --amount 100 --token amiko --yes  # send tokens out of a twin wallet
 amiko wallets swap quote 1.0 SOL USDC                # Jupiter quote (free)
 amiko wallets swap send 1.0 SOL USDC --yes           # --wallet defaults to your Solana wallet
 amiko wallets swap tokens                            # supported tokens list
@@ -119,6 +121,7 @@ amiko wallets bridge limits
 
 - `wallets list` returns **cached** balances (platform doesn't auto-sync). If they look stale, run `wallets balance <address>` to force a sync for that wallet.
 - `wallets create` is one-shot per `chain+custodian` pair (409 if one already exists) — run once for the twin and reuse.
+- `wallets transfer` sends tokens from a twin wallet to an external address. Only Crossmint-custodied wallets are supported (agent-signed on the server). `--wallet` defaults to your Solana wallet; pass `--chain base` + `--wallet` to send from a Base wallet. `--token` accepts symbols (`sol`, `usdc`, `usdt`, `amiko` on Solana; `eth` on Base) or a raw mint/contract address. Returns a tx hash once the transaction lands on-chain. Paid/destructive — requires `--yes` in non-interactive shells.
 - Swaps run via Jupiter on Solana. Supported: SOL, USDC, USDT, AMIKO, PYUSD, BONK, JUP, RAY, JitoSOL — or any mint address.
 - Bridging goes through Across Protocol. Solana ↔ EVM requires `--recipient` (different address formats).