@bankr/cli 0.3.13 → 0.3.32

package/dist/commands/status.js

@@ -31,15 +31,13 @@ export async function statusCommand(jobId) {
             console.log();
             output.error(status.error);
         }
-        if (status.transactions && status.transactions.length > 0) {
+        if (status.transactions?.length) {
             console.log();
             output.dim(`${status.transactions.length} transaction(s) attached.`);
         }
     }
     catch (err) {
-        spin.fail("Failed to fetch job status");
-        output.error(err.message);
-        process.exit(1);
+        output.failWith(spin, "Failed to fetch job status", err);
     }
 }
 //# sourceMappingURL=status.js.map

package/dist/commands/submit.js

@@ -1,6 +1,7 @@
 import { submit } from "../lib/api.js";
 import { emitCESP } from "../lib/cesp/engine.js";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 function displayResult(result) {
     if (!result.success) {
         emitCESP("task.error");
@@ -27,24 +28,20 @@ function displayResult(result) {
 export async function submitCommand(opts) {
     // Validate required fields
     if (!opts.to) {
-        output.error("--to is required");
-        process.exit(1);
+        output.fatal("--to is required");
     }
     if (!opts.chainId) {
-        output.error("--chain-id is required");
-        process.exit(1);
+        output.fatal("--chain-id is required");
     }
     const chainId = parseInt(opts.chainId, 10);
     if (isNaN(chainId)) {
-        output.error("--chain-id must be a number");
-        process.exit(1);
+        output.fatal("--chain-id must be a number");
     }
     let nonce;
     if (opts.nonce) {
         nonce = parseInt(opts.nonce, 10);
         if (isNaN(nonce)) {
-            output.error("--nonce must be a number");
-            process.exit(1);
+            output.fatal("--nonce must be a number");
         }
     }
     const request = {
@@ -73,8 +70,7 @@ export async function submitCommand(opts) {
     }
     catch (err) {
         spinner.stop();
-        output.error(err.message);
-        process.exit(1);
+        output.fatal(getErrorMessage(err));
     }
 }
 // Alternative: submit from JSON
@@ -84,32 +80,26 @@ export async function submitJsonCommand(json, opts) {
         transaction = JSON.parse(json);
     }
     catch {
-        output.error("Invalid JSON. Expected: {to, chainId, value?, data?}");
-        process.exit(1);
+        output.fatal("Invalid JSON. Expected: {to, chainId, value?, data?}");
     }
     if (!transaction ||
         typeof transaction !== "object" ||
         Array.isArray(transaction)) {
-        output.error("Invalid JSON. Expected object: {to, chainId, value?, data?}");
-        process.exit(1);
+        output.fatal("Invalid JSON. Expected object: {to, chainId, value?, data?}");
     }
     // Validate required fields
     if (!transaction.to) {
-        output.error("Transaction must have 'to' field");
-        process.exit(1);
+        output.fatal("Transaction must have 'to' field");
     }
     if (transaction.chainId === undefined) {
-        output.error("Transaction must have 'chainId' field");
-        process.exit(1);
+        output.fatal("Transaction must have 'chainId' field");
     }
     if (typeof transaction.chainId !== "number" || isNaN(transaction.chainId)) {
-        output.error("Transaction 'chainId' must be a number");
-        process.exit(1);
+        output.fatal("Transaction 'chainId' must be a number");
     }
     if (transaction.nonce !== undefined &&
         (typeof transaction.nonce !== "number" || isNaN(transaction.nonce))) {
-        output.error("Transaction 'nonce' must be a number");
-        process.exit(1);
+        output.fatal("Transaction 'nonce' must be a number");
     }
     const request = {
         transaction,
@@ -127,8 +117,7 @@ export async function submitJsonCommand(json, opts) {
     }
     catch (err) {
         spinner.stop();
-        output.error(err.message);
-        process.exit(1);
+        output.fatal(getErrorMessage(err));
     }
 }
 //# sourceMappingURL=submit.js.map

package/dist/commands/swap.js

@@ -1,7 +1,9 @@
 import { getSwapQuote, executeSwap } from "../lib/api.js";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 import { NATIVE_SYMBOLS, VALID_CHAINS } from "../lib/chains.js";
-import { ZERO_ADDRESS, resolveTokenSymbol } from "../lib/tokens.js";
+import { zeroAddress } from "viem";
+import { resolveTokenSymbol } from "../lib/tokens.js";
 /**
  * Resolve a token symbol or address to a contract address for swapping.
  * - The chain's native ticker (ETH/POL/BNB) or the zero address → native, sent
@@ -12,26 +14,24 @@ async function resolveSwapToken(tokenInput, chain) {
     const input = tokenInput.trim();
     const nativeSymbol = NATIVE_SYMBOLS[chain] ?? "ETH";
     const upper = input.toUpperCase();
-    const isNative = upper === nativeSymbol.toUpperCase() ||
-        input.toLowerCase() === ZERO_ADDRESS;
+    // viem's zeroAddress is already lowercase, so compare against the lowercased input.
+    const isNative = upper === nativeSymbol.toUpperCase() || input.toLowerCase() === zeroAddress;
     if (isNative) {
-        return { address: ZERO_ADDRESS, symbol: nativeSymbol };
+        return { address: zeroAddress, symbol: nativeSymbol };
     }
     return resolveTokenSymbol(input, chain);
 }
 export async function swapCommand(opts) {
     const chain = opts.chain ?? "base";
     if (!VALID_CHAINS.has(chain) || chain === "solana") {
-        output.error(`Unsupported chain "${chain}". Swaps support EVM chains: base, polygon, mainnet, unichain, worldchain, arbitrum, bnb.`);
-        process.exit(1);
+        output.fatal(`Unsupported chain "${chain}". Swaps support EVM chains: base, polygon, mainnet, unichain, worldchain, arbitrum, bnb.`);
     }
     // Validate amount client-side so a bad value gives a clear error instead of a
     // generic 500 from the API's parseUnits(amount, decimals). Number() alone
     // accepts "1e-3" / "0x10" / "Infinity" that parseUnits rejects, so require a
     // plain decimal string.
     if (!/^\d*\.?\d+$/.test(opts.amount) || Number(opts.amount) <= 0) {
-        output.error(`Invalid amount "${opts.amount}". Provide a positive decimal number, e.g. --amount 0.5.`);
-        process.exit(1);
+        output.fatal(`Invalid amount "${opts.amount}". Provide a positive decimal number, e.g. --amount 0.5.`);
     }
     // Resolve from/to tokens (symbol → address, native → zero address)
     let fromToken;
@@ -45,7 +45,7 @@ export async function swapCommand(opts) {
         resolveSpin.stop();
     }
     catch (err) {
-        resolveSpin.fail(err.message);
+        resolveSpin.fail(getErrorMessage(err));
         process.exit(1);
     }
     // Quote
@@ -62,7 +62,7 @@ export async function swapCommand(opts) {
         quoteSpin.stop();
     }
     catch (err) {
-        quoteSpin.fail(`Quote failed: ${err.message}`);
+        quoteSpin.fail(`Quote failed: ${getErrorMessage(err)}`);
         process.exit(1);
     }
     output.blank();
@@ -100,7 +100,7 @@ export async function swapCommand(opts) {
         }
     }
     catch (err) {
-        swapSpin.fail(`Swap failed: ${err.message}`);
+        swapSpin.fail(`Swap failed: ${getErrorMessage(err)}`);
         process.exit(1);
     }
 }

package/dist/commands/tokens.js

@@ -1,5 +1,6 @@
 import { searchTokens } from "../lib/api.js";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 export async function tokensSearchCommand(query, opts) {
     const spin = output.spinner(`Searching tokens for "${query}"...`);
     try {
@@ -22,7 +23,7 @@ export async function tokensSearchCommand(query, opts) {
         }
     }
     catch (err) {
-        spin.fail(`Search failed: ${err.message}`);
+        spin.fail(`Search failed: ${getErrorMessage(err)}`);
         process.exit(1);
     }
 }
@@ -37,8 +38,7 @@ export async function tokensInfoCommand(address, opts) {
         const token = res.tokens.find((t) => t.address.toLowerCase() === addressLower) ??
             res.tokens[0];
         if (!token) {
-            output.error("Token not found. Check the address and try again.");
-            process.exit(1);
+            output.fatal("Token not found. Check the address and try again.");
         }
         console.log();
         output.label("Name", token.name);
@@ -53,7 +53,7 @@ export async function tokensInfoCommand(address, opts) {
         }
     }
     catch (err) {
-        spin.fail(`Failed to fetch token info: ${err.message}`);
+        spin.fail(`Failed to fetch token info: ${getErrorMessage(err)}`);
         process.exit(1);
     }
 }

package/dist/commands/transfer.js

@@ -1,8 +1,9 @@
 import { transfer, resolveRecipient } from "../lib/api.js";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 import { NATIVE_SYMBOLS } from "../lib/chains.js";
-import { isAddress } from "viem";
-import { ZERO_ADDRESS, resolveTokenSymbol } from "../lib/tokens.js";
+import { isAddress, zeroAddress } from "viem";
+import { resolveTokenSymbol } from "../lib/tokens.js";
 function looksLikeEnsName(value) {
     const v = value.trim().toLowerCase();
     return v.endsWith(".eth") || v.endsWith(".cb.id");
@@ -13,8 +14,7 @@ async function resolveTransferRecipient(raw) {
         return { address: value, label: value };
     }
     if (!looksLikeEnsName(value)) {
-        output.error(`Invalid recipient "${value}". Expected a 0x address or an ENS name (e.g. vitalik.eth, name.base.eth, name.cb.id).`);
-        process.exit(1);
+        output.fatal(`Invalid recipient "${value}". Expected a 0x address or an ENS name (e.g. vitalik.eth, name.base.eth, name.cb.id).`);
     }
     const spin = output.spinner(`Resolving ENS name "${value}"...`);
     try {
@@ -30,7 +30,7 @@ async function resolveTransferRecipient(raw) {
         };
     }
     catch (err) {
-        spin.fail(`ENS resolution failed for "${value}": ${err.message}`);
+        spin.fail(`ENS resolution failed for "${value}": ${getErrorMessage(err)}`);
         process.exit(1);
     }
 }
@@ -38,8 +38,7 @@ export async function transferCommand(opts) {
     const isNative = opts.native ?? false;
     const chain = opts.chain ?? "base";
     if (!isNative && !opts.token) {
-        output.error("Token required for ERC20 transfers. Use --token <symbol or address> or --native.");
-        process.exit(1);
+        output.fatal("Token required for ERC20 transfers. Use --token <symbol or address> or --native.");
     }
     const recipient = await resolveTransferRecipient(opts.to);
     const recipientAddress = recipient.address;
@@ -47,7 +46,8 @@ export async function transferCommand(opts) {
     let tokenAddress;
     let tokenLabel;
     if (isNative) {
-        tokenAddress = ZERO_ADDRESS;
+        // Zero address = native-token sentinel; the API detects + sanitizes it.
+        tokenAddress = zeroAddress;
         tokenLabel = NATIVE_SYMBOLS[chain] ?? "ETH";
     }
     else {
@@ -64,7 +64,7 @@ export async function transferCommand(opts) {
             }
         }
         catch (err) {
-            spin.fail(err.message);
+            spin.fail(getErrorMessage(err));
             process.exit(1);
         }
     }
@@ -86,7 +86,7 @@ export async function transferCommand(opts) {
         output.label("Tx Hash", result.txHash ?? "unknown");
     }
     catch (err) {
-        spin.fail(`Transfer failed: ${err.message}`);
+        spin.fail(`Transfer failed: ${getErrorMessage(err)}`);
         process.exit(1);
     }
 }

package/dist/commands/update.js

@@ -1,6 +1,7 @@
 import { readFileSync } from "node:fs";
 import { execSync } from "node:child_process";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 const PACKAGE_NAME = "@bankr/cli";
 /**
  * Compare two semver version strings.
@@ -79,8 +80,7 @@ export async function updateCommand(opts) {
     }
     catch (err) {
         spin.fail();
-        output.error(err.message);
-        process.exit(1);
+        output.fatal(getErrorMessage(err));
     }
     const cmp = compareSemver(current, latest);
     if (cmp === 0) {

package/dist/commands/webhooks.js

@@ -16,9 +16,9 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { confirm } from "@inquirer/prompts";
+import { authHeaders, handleResponse } from "../lib/api.js";
 import * as output from "../lib/output.js";
-import { getErrorMessage } from "../lib/errors.js";
-import { getApiUrl, requireApiKey, CLI_USER_AGENT } from "../lib/config.js";
+import { getApiUrl } from "../lib/config.js";
 // ── Config file ─────────────────────────────────────────────────────────
 const CONFIG_FILENAME = "bankr.webhooks.json";
 const WEBHOOKS_DIR = "webhooks";
@@ -36,8 +36,7 @@ function loadConfigFile(projectRoot) {
                 return JSON.parse(readFileSync(p, "utf-8"));
             }
             catch {
-                output.error(`Failed to parse ${p}. Check that it is valid JSON.`);
-                process.exit(1);
+                output.fatal(`Failed to parse ${p}. Check that it is valid JSON.`);
             }
         }
     }
@@ -46,23 +45,6 @@ function loadConfigFile(projectRoot) {
 function saveConfigFile(projectRoot, config) {
     writeFileSync(join(projectRoot, CONFIG_FILENAME), JSON.stringify(config, null, 2) + "\n");
 }
-function authHeaders() {
-    return {
-        "X-API-Key": requireApiKey(),
-        "Content-Type": "application/json",
-        "User-Agent": CLI_USER_AGENT,
-    };
-}
-async function handleResponse(res) {
-    if (!res.ok) {
-        const body = (await res
-            .json()
-            .catch(() => ({ message: res.statusText })));
-        const msg = body.message || body.error || res.statusText;
-        throw new Error(`API error (${res.status}): ${msg}`);
-    }
-    return res.json();
-}
 const MAX_WEBHOOK_NAME_LENGTH = 47;
 const WEBHOOK_NAME_PATTERN = /^[a-zA-Z0-9_-]+$/;
 function validateWebhookName(name) {
@@ -326,8 +308,7 @@ export default async function handler(req: Request): Promise<Response> {
 export async function webhooksAddCommand(name, options = {}) {
     const err = validateWebhookName(name);
     if (err) {
-        output.error(err);
-        process.exit(1);
+        output.fatal(err);
     }
     const providerInput = (options.provider ?? "generic").toLowerCase();
     const validProviders = [
@@ -337,20 +318,17 @@ export async function webhooksAddCommand(name, options = {}) {
         "generic",
     ];
     if (!validProviders.includes(providerInput)) {
-        output.error(`Invalid provider "${providerInput}". Valid: ${validProviders.join(", ")}.`);
-        process.exit(1);
+        output.fatal(`Invalid provider "${providerInput}". Valid: ${validProviders.join(", ")}.`);
     }
     const provider = providerInput;
     const root = findProjectRoot();
     const dir = join(root, WEBHOOKS_DIR);
     if (!existsSync(dir)) {
-        output.error(`No ${WEBHOOKS_DIR}/ directory found. Run 'bankr webhooks init' first.`);
-        process.exit(1);
+        output.fatal(`No ${WEBHOOKS_DIR}/ directory found. Run 'bankr webhooks init' first.`);
     }
     const serviceDir = join(dir, name);
     if (existsSync(serviceDir)) {
-        output.error(`Webhook "${name}" already exists at ${WEBHOOKS_DIR}/${name}/`);
-        process.exit(1);
+        output.fatal(`Webhook "${name}" already exists at ${WEBHOOKS_DIR}/${name}/`);
     }
     mkdirSync(serviceDir, { recursive: true });
     const { source, envHint } = handlerTemplate(name, provider);
@@ -397,8 +375,7 @@ export async function webhooksDeployCommand(name) {
     const root = findProjectRoot();
     const dir = join(root, WEBHOOKS_DIR);
     if (!existsSync(dir)) {
-        output.error(`No ${WEBHOOKS_DIR}/ directory found. Run 'bankr webhooks init' first.`);
-        process.exit(1);
+        output.fatal(`No ${WEBHOOKS_DIR}/ directory found. Run 'bankr webhooks init' first.`);
     }
     let config = loadConfigFile(root);
     if (!config)
@@ -413,19 +390,16 @@ export async function webhooksDeployCommand(name) {
         }
     }
     if (discovered.length === 0) {
-        output.error("No webhooks found. Run 'bankr webhooks add <name>' first.");
-        process.exit(1);
+        output.fatal("No webhooks found. Run 'bankr webhooks add <name>' first.");
     }
     const toDeploy = name ? discovered.filter((s) => s === name) : discovered;
     if (name && toDeploy.length === 0) {
-        output.error(`Webhook "${name}" not found in ${WEBHOOKS_DIR}/`);
-        process.exit(1);
+        output.fatal(`Webhook "${name}" not found in ${WEBHOOKS_DIR}/`);
     }
     for (const svc of toDeploy) {
         const nameError = validateWebhookName(svc);
         if (nameError) {
-            output.error(nameError);
-            process.exit(1);
+            output.fatal(nameError);
         }
         if (!config.webhooks[svc]) {
             config.webhooks[svc] = {
@@ -487,9 +461,7 @@ export async function webhooksDeployCommand(name) {
         output.info("Your handler code is responsible for verifying incoming signatures (Slack, GitHub, etc.). Provider-specific scaffolds include the verifier inline — `bankr webhooks add <name> --provider slack|github|stripe` to scaffold one.");
     }
     catch (err) {
-        spin.fail("Deploy failed");
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, "Deploy failed", err);
     }
 }
 export async function webhooksListCommand() {
@@ -508,16 +480,16 @@ export async function webhooksListCommand() {
             const status = w.status === "active"
                 ? output.fmt.success("active")
                 : output.fmt.warn(w.status);
-            const mode = w.readOnly ? output.fmt.dim("read-only") : output.fmt.warn("writes");
+            const mode = w.readOnly
+                ? output.fmt.dim("read-only")
+                : output.fmt.warn("writes");
             console.log(`  ${output.fmt.brand(w.name)} ${status}  v${w.version}  ${mode}  ${w.totalInvocations} invocations`);
             if (w.description)
                 output.dim(`    ${w.description}`);
         }
     }
     catch (err) {
-        spin.fail("Failed to list webhooks");
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, "Failed to list webhooks", err);
     }
 }
 export async function webhooksPauseResumeCommand(name, action) {
@@ -533,9 +505,7 @@ export async function webhooksPauseResumeCommand(name, action) {
         spin.succeed(`${name} ${action === "pause" ? "paused" : "resumed"}`);
     }
     catch (err) {
-        spin.fail(`Failed to ${action} ${name}`);
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, `Failed to ${action} ${name}`, err);
     }
 }
 export async function webhooksDeleteCommand(name) {
@@ -556,15 +526,15 @@ export async function webhooksDeleteCommand(name) {
         spin.succeed(`${name} deleted`);
     }
     catch (err) {
-        spin.fail(`Failed to delete ${name}`);
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, `Failed to delete ${name}`, err);
     }
 }
 export async function webhooksLogsCommand(name) {
     const spin = output.spinner(`Fetching invocations for ${name}...`);
     try {
-        const res = await fetch(`${getApiUrl()}/webhooks/${name}/logs?limit=25`, { headers: authHeaders() });
+        const res = await fetch(`${getApiUrl()}/webhooks/${name}/logs?limit=25`, {
+            headers: authHeaders(),
+        });
         const result = await handleResponse(res);
         spin.stop();
         if (result.logs.length === 0) {
@@ -582,23 +552,19 @@ export async function webhooksLogsCommand(name) {
         }
     }
     catch (err) {
-        spin.fail("Failed to fetch logs");
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, "Failed to fetch logs", err);
     }
 }
 // ── Env vars ────────────────────────────────────────────────────────────
 export async function webhooksEnvSetCommand(keyValue) {
     const eqIdx = keyValue.indexOf("=");
     if (eqIdx === -1) {
-        output.error("Usage: bankr webhooks env set KEY=VALUE");
-        process.exit(1);
+        output.fatal("Usage: bankr webhooks env set KEY=VALUE");
     }
     const key = keyValue.slice(0, eqIdx);
     const value = keyValue.slice(eqIdx + 1);
     if (!key) {
-        output.error("Key cannot be empty");
-        process.exit(1);
+        output.fatal("Key cannot be empty");
     }
     const spin = output.spinner(`Setting ${key}...`);
     try {
@@ -611,9 +577,7 @@ export async function webhooksEnvSetCommand(keyValue) {
         spin.succeed(`Set ${key}`);
     }
     catch (err) {
-        spin.fail(`Failed to set ${key}`);
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, `Failed to set ${key}`, err);
     }
 }
 export async function webhooksEnvListCommand() {
@@ -632,9 +596,7 @@ export async function webhooksEnvListCommand() {
             console.log(`  ${n}`);
     }
     catch (err) {
-        spin.fail("Failed to list env vars");
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, "Failed to list env vars", err);
     }
 }
 export async function webhooksEnvUnsetCommand(key) {
@@ -645,9 +607,7 @@ export async function webhooksEnvUnsetCommand(key) {
         spin.succeed(`Removed ${key}`);
     }
     catch (err) {
-        spin.fail(`Failed to remove ${key}`);
-        output.error(getErrorMessage(err));
-        process.exit(1);
+        output.failWith(spin, `Failed to remove ${key}`, err);
     }
 }
 //# sourceMappingURL=webhooks.js.map

package/dist/commands/whoami.js

@@ -2,13 +2,13 @@ import { existsSync } from "fs";
 import { getApiKey, getApiUrl, getConfigPath, isCustomApiUrl, } from "../lib/config.js";
 import { getUserInfo } from "../lib/api.js";
 import * as output from "../lib/output.js";
+import { getErrorMessage } from "../lib/errors.js";
 export async function whoamiCommand() {
     const apiKey = getApiKey();
     const apiUrl = getApiUrl();
     const configPath = getConfigPath();
     if (!apiKey) {
-        output.error("Not authenticated. Run `bankr login` to set up your Bankr API key.");
-        process.exit(1);
+        output.fatal("Not authenticated. Run `bankr login` to set up your Bankr API key.");
     }
     const source = process.env.BANKR_API_KEY ? "env (BANKR_API_KEY)" : configPath;
     output.label("Bankr API Key", output.maskApiKey(apiKey));
@@ -35,7 +35,7 @@ export async function whoamiCommand() {
         }
     }
     catch (err) {
-        spin.fail(`Could not reach Bankr API: ${err.message}`);
+        spin.fail(`Could not reach Bankr API: ${getErrorMessage(err)}`);
         return;
     }
     // Fetch user profile info
@@ -69,7 +69,7 @@ export async function whoamiCommand() {
         output.label("Score", `${score}${rankStr}`);
     }
     catch (err) {
-        profileSpin.fail(`Could not fetch account info: ${err.message}`);
+        profileSpin.fail(`Could not fetch account info: ${getErrorMessage(err)}`);
     }
 }
 //# sourceMappingURL=whoami.js.map

package/dist/commands/x402.d.ts

@@ -62,6 +62,9 @@ export declare function x402EnvUnsetCommand(key: string): Promise<void>;
 export declare function x402SchemaCommand(url: string, opts?: {
     raw?: boolean;
 }): Promise<void>;
+export declare function checkAdvertisedPrice(advertisedUsd: number | null, callerCapUsd: number): string | null;
+export declare function parseAdvertisedPrice(price: string, currency: string): number | null;
+export declare function outboundMaxPayment(callerCapUsd: number, advertisedUsd: number | null): number;
 export declare function x402CallCommand(url: string, opts?: {
     method?: string;
     body?: string;