@agentgrant.cash/cli 1.0.2 → 1.1.0

package/dist/cli/index.js

@@ -37,6 +37,7 @@ import { registerAccount } from "./perfolio-commands/account.js";
 import { registerTx } from "./perfolio-commands/tx.js";
 import { registerSession } from "./perfolio-commands/session.js";
 import { registerLoans } from "./perfolio-commands/loans.js";
+import { registerSpending } from "./perfolio-commands/spending.js";
 let version = "0.0.0";
 try {
     version =
@@ -66,6 +67,7 @@ registerEarn(program);
 registerHyperliquid(program);
 registerPolymarket(program);
 registerLoans(program);
+registerSpending(program);
 registerAccount(program);
 registerTx(program);
 registerSession(program);

package/dist/cli/perfolio-commands/spending.js

@@ -0,0 +1,57 @@
+import { buildCtx, requireAuth, out, fail, resolveCash } from '../money-helpers.js';
+import { describeCashResolution } from '../../lib/index.js';
+import { waitForTx } from '../../lib/verify.js';
+/**
+ * Spending account — the agent's pay-per-use balance (USDC on Base). It is
+ * funded by bridging cash out of the main account, mirroring the other
+ * account-to-account transfers already in the CLI:
+ *   - cash ↔ trading      → `hl deposit` / `hl withdraw`
+ *   - cash ↔ predictions  → `polymarket deposit` / `polymarket withdraw`
+ *   - cash → spending      → `spending deposit`   (this file)
+ *
+ * The reverse (spending → cash) has NO backend route — the spending balance is
+ * receive-only, exactly as in the web app (AccountTransferFlow) — so we offer
+ * only the inbound transfer and don't fabricate a withdraw.
+ */
+export function registerSpending(program) {
+    const spending = program
+        .command('spending')
+        .description('Your agent spending account (pay-per-use balance)');
+    spending
+        .command('deposit')
+        .alias('add')
+        .alias('top-up')
+        .description('Move cash from your account into your agent spending balance (autonomous — no browser)')
+        .requiredOption('--amount <amount>', 'cash to move into spending — in your display currency by default; prefix $/₹ to force one, or pass --usd')
+        .option('--usd', 'interpret --amount as US dollars, ignoring your display currency')
+        .option('--no-wait', 'return immediately without waiting for the bridge tx to confirm')
+        .action(async (opts, cmd) => {
+        const ctx = buildCtx(cmd);
+        requireAuth(ctx);
+        // Autonomous: POST /tx/bridge-base builds the USDT-approve + Across bridge
+        // (ETH USDT → Base USDC) and executes them via the Biconomy session grant
+        // (agent-signed) — no browser. Two-stage settlement, same as `hl deposit`:
+        // the bridge tx confirms the Ethereum leg, but Across fills onto Base a few
+        // MINUTES later. So a confirmed tx means the funds are on their way, NOT
+        // yet spendable — we confirm the tx and say so honestly (no false "done").
+        const m = await resolveCash(ctx, opts.amount, 6, { usd: !!opts.usd });
+        const wait = opts.wait !== false;
+        const label = `Move ${describeCashResolution(m)} cash → spending`;
+        const res = await ctx.client.bridgeToBase({ amountUsdt: m.usdString });
+        const txHash = res?.txHash;
+        const tail = txHash ? ` (tx ${txHash})` : '';
+        if (!wait) {
+            out(ctx, `Submitted: ${label}${tail}.\nFunds arrive in your spending balance a few minutes after the bridge tx confirms — check \`grant portfolio\`.`, { submitted: true, confirmed: false, status: res?.status ?? 'submitted', txHash, quote: res?.quote });
+            return;
+        }
+        const txResult = await waitForTx(ctx.client, txHash);
+        if (txResult.status === 'failed')
+            fail(`${label} failed on-chain${tail}.`, ctx.json);
+        if (txResult.status === 'success') {
+            out(ctx, `✓ ${label}: bridge tx confirmed${tail}. Your spending balance updates in a few minutes once the funds land on Base — check \`grant portfolio\`.`, { submitted: true, confirmed: true, settledOnBase: false, status: 'success', txHash, quote: res?.quote });
+        }
+        else {
+            out(ctx, `${label}: submitted${tail} but not yet confirmed. Re-check with \`grant tx status${txHash ? ` ${txHash}` : ''}\`.`, { submitted: true, confirmed: false, settledOnBase: false, status: txResult.status, txHash, quote: res?.quote });
+        }
+    });
+}

package/dist/lib/client.js

@@ -260,6 +260,19 @@ export class PerfolioClient {
      * so its "submitted" was a false positive that moved no funds.)
      */
     hlDeposit(b) { return this.post(this.urls.api, '/tx/bridge-deposit', b); }
+    /**
+     * Autonomous cash → spending bridge. Hits POST /tx/bridge-base, which builds
+     * the USDT-approve + Across bridge (ETH USDT → Base USDC) and executes them via
+     * the Biconomy defi session grant (agent-signed) — no user signature, no
+     * browser. Funds the Grant Cash agent's USDC spending balance on Base. A
+     * returned txHash means the Ethereum leg was SUBMITTED; the spending balance
+     * updates on Base a few minutes later once Across fills. Mirrors hlDeposit
+     * (/tx/bridge-deposit) — same Across Swap API + session execution; only the
+     * destination (Base 8453) and output token (USDC) differ.
+     */
+    bridgeToBase(b) {
+        return this.post(this.urls.api, '/tx/bridge-base', b);
+    }
     /** Autonomous HL → Ethereum withdrawal (server-signs via Privy; no browser). */
     hlWithdraw(b) {
         return this.post(this.urls.api, '/hl/withdraw-to-evm/execute', b);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentgrant.cash/cli",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Grant Cash — one CLI for your money (gold) and your agent (pay-per-use services). Routes to the Perfolio backend and the Agent-mode backend behind a single, plain-language surface.",
   "type": "module",
   "bin": {