@h402/cli 0.1.1 → 0.1.2

package/README.md

@@ -37,6 +37,8 @@ Browsing, quoting, and free-route calls do not require a local wallet. Wallet cr
 
 Calls hit the production backend (`https://h402.hunt.town`) by default — override with `--api-url` or `H402_API_URL` (e.g. `http://localhost:3000` for local dev).
 
+To select a default local signing wallet, add `"defaultWallet": "agent"` to your existing `~/.h402/config.json`, preserving its other fields. This applies to wallet creation, address, balance, funding instructions, authentication, and paid calls. Explicit `--name` or `--wallet` takes precedence; without this setting, the default remains `h402`. If the selected wallet is missing, the CLI reports an error instead of using another wallet. Existing bonus-credit sessions remain associated with the wallet that authenticated them; changing `defaultWallet` does not switch those sessions.
+
 ## Commands
 
 | Command | Description |
@@ -60,7 +62,7 @@ Run `h402 --help`, `h402 <command> --help`, or `h402 wallet <subcommand> --help`
 
 | Flag | Applies to | Description |
 | --- | --- | --- |
-| `--name <wallet>` | wallet create/address/balance/fund; auth; call | Wallet to use (default `h402`) |
+| `--name <wallet>` | wallet create/address/balance/fund; auth; call | Wallet to use (default: `defaultWallet` in config, otherwise `h402`) |
 | `--wallet 0x...` | wallet address/balance/fund; auth; call | Sign with the local wallet that owns this address (must exist locally; must agree with `--name` if both are passed) |
 | `--api-url <url>` | auth, credits, search, show, quote, call | Backend base URL override (or `H402_API_URL`; default `https://h402.hunt.town`) |
 | `--json '{...}'` | quote, call | Request body (sets method to POST) |
@@ -148,7 +150,7 @@ Signing needs no flags for the default passphrase-less wallets. Only when a wall
 | `H402_API_URL` | Backend base URL override (or `--api-url`; default `https://h402.hunt.town`) |
 | `H402_WALLET_PASSPHRASE` | Passphrase for passphrase-protected wallets (only needed when the wallet was created with one) |
 
-Passphrases are never stored. Wallets are passphrase-less by default; opt in at create time (`--passphrase <s>`, or bare `--passphrase` to be prompted) when a wallet guards meaningful funds. The CLI persists only the backend URL, session tokens, and known wallet addresses in `~/.h402/config.json`.
+Passphrases are never stored. Wallets are passphrase-less by default; opt in at create time (`--passphrase <s>`, or bare `--passphrase` to be prompted) when a wallet guards meaningful funds. The CLI persists the backend URL, session tokens, known wallet addresses, and optional `defaultWallet` and `maxUsd` settings in `~/.h402/config.json`.
 
 ## Contributing
 

package/dist/commands.js

@@ -9,8 +9,8 @@ import { promptPassphrase } from "./prompt.js";
 import { assertConcreteProvider, buildProxyPath, encodeRouteId, flagBoolean, flagString, isRecord, mergeH402, parseJsonFlag, parseQueryFlag, printJson, requireValue, resolveMethod } from "./utils.js";
 import { createPaymentSignatureHeader, paymentRequiredFromResponse, selectBaseUsdcRequirement, X402_HEADERS } from "./x402.js";
 const DEFAULT_WALLET_NAME = "h402";
-function walletName(args) {
-    return flagString(args.flags, "name", DEFAULT_WALLET_NAME);
+function walletName(args, config) {
+    return flagString(args.flags, "name", config.defaultWallet ?? DEFAULT_WALLET_NAME);
 }
 // Explicit passphrase from flags/env. Wallets are passphrase-less by default
 // (the onboarding default), so this is usually undefined and signing simply
@@ -158,24 +158,7 @@ export async function resolveSigningWallet(args, config) {
     config ??= await loadConfig();
     const explicitAddress = flagString(args.flags, "wallet")?.toLowerCase();
     const explicitName = flagString(args.flags, "name");
-    if (explicitName) {
-        const address = config.wallets[explicitName]?.address?.toLowerCase();
-        if (!address) {
-            const adopted = await adoptOwsWalletByName(explicitName, config);
-            if (adopted) {
-                if (explicitAddress && explicitAddress !== adopted.address) {
-                    throw new Error(`--wallet ${explicitAddress} does not match wallet "${explicitName}" (${adopted.address}). Omit --wallet or pass the wallet that owns this address.`);
-                }
-                return adopted;
-            }
-            throw new Error(`No address known for wallet "${explicitName}". Run: h402 wallet create --name ${explicitName}, or h402 wallet restore to re-adopt existing OWS wallets.`);
-        }
-        if (explicitAddress && explicitAddress !== address) {
-            throw new Error(`--wallet ${explicitAddress} does not match wallet "${explicitName}" (${address}). Omit --wallet or pass the wallet that owns this address.`);
-        }
-        return { name: explicitName, address };
-    }
-    if (explicitAddress) {
+    if (explicitAddress && !explicitName) {
         const owner = Object.entries(config.wallets).find(([, wallet]) => wallet.address?.toLowerCase() === explicitAddress);
         if (!owner) {
             const adopted = await adoptOwsWalletByAddress(explicitAddress, config);
@@ -185,21 +168,23 @@ export async function resolveSigningWallet(args, config) {
         }
         return { name: owner[0], address: explicitAddress };
     }
-    const address = config.wallets[DEFAULT_WALLET_NAME]?.address?.toLowerCase();
-    if (!address) {
-        const adopted = await adoptOwsWalletByName(DEFAULT_WALLET_NAME, config);
-        if (adopted)
-            return adopted;
-        throw new Error(`No address known for wallet "${DEFAULT_WALLET_NAME}". Run: h402 wallet create --name ${DEFAULT_WALLET_NAME} (or pass --name/--wallet), or h402 wallet restore to re-adopt existing OWS wallets.`);
+    const name = walletName(args, config);
+    const address = config.wallets[name]?.address?.toLowerCase();
+    const resolved = address ? { name, address } : await adoptOwsWalletByName(name, config);
+    if (!resolved) {
+        throw new Error(`No address known for wallet "${name}". Run: h402 wallet create --name ${name}, or h402 wallet restore to re-adopt existing OWS wallets.`);
+    }
+    if (explicitAddress && explicitAddress !== resolved.address) {
+        throw new Error(`--wallet ${explicitAddress} does not match wallet "${name}" (${resolved.address}). Omit --wallet or pass the wallet that owns this address.`);
     }
-    return { name: DEFAULT_WALLET_NAME, address };
+    return resolved;
 }
 export async function walletCommand(args) {
     const subcommand = requireValue(args.positional[1], "wallet subcommand is required");
     rejectExtraPositionals(args, 2, `wallet ${subcommand}`);
-    const name = walletName(args);
     const config = await loadConfig();
     if (subcommand === "create") {
+        const name = walletName(args, config);
         let wallet;
         try {
             wallet = await createOwsWallet(name, await createPassphrase(args));

package/dist/config.js

@@ -23,6 +23,12 @@ function normalizeConfig(parsed) {
     if (typeof parsed.maxUsd === "string") {
         normalized.maxUsd = parsed.maxUsd;
     }
+    if (parsed.defaultWallet !== undefined) {
+        if (typeof parsed.defaultWallet !== "string" || !parsed.defaultWallet.trim()) {
+            throw new Error("h402 config defaultWallet must be a non-empty wallet name");
+        }
+        normalized.defaultWallet = parsed.defaultWallet;
+    }
     return normalized;
 }
 async function tightenConfigPermissions(file) {
@@ -69,6 +75,9 @@ function cloneConfig(config) {
     if (config.maxUsd !== undefined) {
         cloned.maxUsd = config.maxUsd;
     }
+    if (config.defaultWallet !== undefined) {
+        cloned.defaultWallet = config.defaultWallet;
+    }
     return cloned;
 }
 async function atomicWritePrivateJson(file, config) {

package/dist/help.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from "node:url";
 // Reusable flag definitions (DRY: declared once, referenced by each command that
 // accepts them — mirrors the README flags table).
 const FLAGS = {
-    name: { name: "name", value: "<wallet>", desc: "Wallet to use (default h402)" },
+    name: { name: "name", value: "<wallet>", desc: "Wallet to use (default: config.defaultWallet, otherwise h402)" },
     wallet: { name: "wallet", value: "0x...", desc: "Local wallet that owns this address (must agree with --name)" },
     apiUrl: { name: "api-url", value: "<url>", desc: "Backend base URL (or H402_API_URL; default https://h402.hunt.town)" },
     json: { name: "json", value: "'{...}'", desc: "Request body (sets method to POST)" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h402/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Local, non-custodial CLI for h402 — browse the catalog and pay per call in Base USDC over x402 from a local wallet.",
   "license": "MIT",
   "type": "module",