@agentgrant.cash/cli 1.0.1 → 1.1.0

package/.env.example

@@ -3,21 +3,21 @@
 # Copy to `.env` in the folder you run the CLI from (the current working
 # directory). The CLI loads it automatically — this is how you point an
 # installed / `npx` CLI at localhost or staging. Already-exported shell env vars
-# take precedence over the file. Every value is optional; the defaults point at
-# production. The active backend is shown by `grant status`.
+# take precedence over the file. Every value is optional; the built-in defaults
+# point at the DEVELOP environment. The active backend is shown by `grant config
+# show` / `grant status`.
 #
 # Example (local dev):
 #   GRANTCASH_API_URL=http://localhost:3001/api
 #   GRANTCASH_AGENT_URL=http://localhost:8080
 
-# ── Money side (Perfolio backend — gold, portfolio, cash) ──
-GRANTCASH_API_URL=https://api.perfolio.ai/api
-GRANTCASH_FIAT_URL=https://api-fiat.perfolio.ai/api
-GRANTCASH_APP_URL=https://app.perfolio.ai
+# ── Money side (Perfolio backend — gold, portfolio, cash) ── [develop defaults]
+GRANTCASH_API_URL=https://api-dev.perfolio.ai/api
+GRANTCASH_FIAT_URL=https://api-dev-fiat.perfolio.ai/api
+GRANTCASH_APP_URL=https://grant-cash-app-production.up.railway.app
 
-# ── Agent side (Agent-mode backend — pay-per-use services, x402) ──
-# Set this to wherever the agent-mode backend lives (placeholder default).
-GRANTCASH_AGENT_URL=https://api-agent.perfolio.ai
+# ── Agent side (Agent-mode backend — pay-per-use services, x402) ── [develop]
+GRANTCASH_AGENT_URL=https://agent-mode-backend-develop.up.railway.app
 
 # ── Misc ──
 # Override the merged credentials file (default ~/.grant-cash/credentials.json).

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/dist/lib/config.js

@@ -2,19 +2,18 @@ import { homedir } from "node:os";
 import { join, dirname } from "node:path";
 import { mkdirSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
 /**
- * Backend base URLs — env-overridable, production defaults.
- *
- * Money side = Perfolio backend; Agent side = Agent-mode backend. Set the env
- * vars (in a `.env` in the directory you run the CLI from, or as exported shell
- * vars) to repoint at dev/staging/localhost without touching code. The active
- * backend is shown in `grant status`.
+ * Backend base URLs — env-overridable. Defaults point at the DEVELOP environment
+ * (this is an internal/testing CLI for now). Set the env vars (in a `.env` in the
+ * directory you run the CLI from, or as exported shell vars) to repoint at
+ * localhost/staging/production without touching code. The active backend is shown
+ * by `grant config show` / `grant status`.
  */
 export function baseUrls(env = process.env) {
     return {
-        api: env.GRANTCASH_API_URL || "https://api.perfolio.ai/api",
-        fiat: env.GRANTCASH_FIAT_URL || "https://api-fiat.perfolio.ai/api",
-        app: env.GRANTCASH_APP_URL || "https://app.perfolio.ai",
-        agent: env.GRANTCASH_AGENT_URL || "https://api-agent.perfolio.ai",
+        api: env.GRANTCASH_API_URL || "https://api-dev.perfolio.ai/api",
+        fiat: env.GRANTCASH_FIAT_URL || "https://api-dev-fiat.perfolio.ai/api",
+        app: env.GRANTCASH_APP_URL || "https://grant-cash-app-production.up.railway.app",
+        agent: env.GRANTCASH_AGENT_URL || "https://agent-mode-backend-develop.up.railway.app",
     };
 }
 export function resolveCredsPath(flag, env = process.env) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentgrant.cash/cli",
-  "version": "1.0.1",
+  "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": {