@bankr/cli 0.3.1 → 0.3.8

package/dist/commands/transfer.js

@@ -1,28 +1,38 @@
-import { transfer, searchTokens } from "../lib/api.js";
+import { transfer, resolveRecipient } from "../lib/api.js";
 import * as output from "../lib/output.js";
-import { NATIVE_SYMBOLS, CHAIN_IDS } from "../lib/chains.js";
+import { NATIVE_SYMBOLS } from "../lib/chains.js";
 import { isAddress } from "viem";
-/**
- * Resolve a token symbol or address to a contract address.
- * If it's already a valid address, return as-is. Otherwise search by symbol.
- */
-async function resolveToken(tokenInput, chain) {
-    if (isAddress(tokenInput)) {
-        return { address: tokenInput, symbol: tokenInput };
+import { ZERO_ADDRESS, resolveTokenSymbol } from "../lib/tokens.js";
+function looksLikeEnsName(value) {
+    const v = value.trim().toLowerCase();
+    return v.endsWith(".eth") || v.endsWith(".cb.id");
+}
+async function resolveTransferRecipient(raw) {
+    const value = raw.trim();
+    if (isAddress(value)) {
+        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);
     }
-    const chainId = CHAIN_IDS[chain];
-    const res = await searchTokens(tokenInput, chainId);
-    // Exact symbol match (case-insensitive) to avoid resolving to wrong token
-    const inputUpper = tokenInput.toUpperCase();
-    const exactMatch = res.tokens.find((t) => t.symbol.toUpperCase() === inputUpper);
-    if (!exactMatch) {
-        const available = res.tokens
-            .slice(0, 5)
-            .map((t) => `${t.symbol} (${t.address})`)
-            .join(", ");
-        throw new Error(`No exact match for "${tokenInput}" on ${chain}. Did you mean: ${available || "no results"}`);
+    const spin = output.spinner(`Resolving ENS name "${value}"...`);
+    try {
+        const resolved = await resolveRecipient(value, "ens");
+        if (!resolved.resolved || !resolved.address) {
+            spin.fail(`Could not resolve "${value}": ${resolved.error ?? "unknown error"}`);
+            process.exit(1);
+        }
+        spin.succeed(`Resolved ${value} → ${resolved.address}`);
+        return {
+            address: resolved.address,
+            label: `${value} (${resolved.address})`,
+        };
+    }
+    catch (err) {
+        spin.fail(`ENS resolution failed for "${value}": ${err.message}`);
+        process.exit(1);
     }
-    return { address: exactMatch.address, symbol: exactMatch.symbol };
 }
 export async function transferCommand(opts) {
     const isNative = opts.native ?? false;
@@ -31,16 +41,19 @@ export async function transferCommand(opts) {
         output.error("Token required for ERC20 transfers. Use --token <symbol or address> or --native.");
         process.exit(1);
     }
+    const recipient = await resolveTransferRecipient(opts.to);
+    const recipientAddress = recipient.address;
+    const recipientLabel = recipient.label;
     let tokenAddress;
     let tokenLabel;
     if (isNative) {
-        tokenAddress = "0x0000000000000000000000000000000000000000";
+        tokenAddress = ZERO_ADDRESS;
         tokenLabel = NATIVE_SYMBOLS[chain] ?? "ETH";
     }
     else {
         const spin = output.spinner(`Resolving token "${opts.token}"...`);
         try {
-            const resolved = await resolveToken(opts.token, chain);
+            const resolved = await resolveTokenSymbol(opts.token, chain);
             tokenAddress = resolved.address;
             tokenLabel = resolved.symbol;
             if (tokenAddress !== opts.token) {
@@ -56,11 +69,11 @@ export async function transferCommand(opts) {
         }
     }
     const chainLabel = chain !== "base" ? ` on ${chain}` : "";
-    const spin = output.spinner(`Transferring ${opts.amount} ${tokenLabel} to ${opts.to}${chainLabel}...`);
+    const spin = output.spinner(`Transferring ${opts.amount} ${tokenLabel} to ${recipientLabel}${chainLabel}...`);
     try {
         const result = await transfer({
             tokenAddress,
-            recipientAddress: opts.to,
+            recipientAddress,
             amount: opts.amount,
             isNativeToken: isNative,
             chain,

package/dist/commands/webhooks.js

@@ -17,7 +17,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { confirm } from "@inquirer/prompts";
 import * as output from "../lib/output.js";
-import { getApiUrl, requireApiKey, readConfig, CLI_USER_AGENT, } from "../lib/config.js";
+import { getApiUrl, requireApiKey, CLI_USER_AGENT } from "../lib/config.js";
 // ── Config file ─────────────────────────────────────────────────────────
 const CONFIG_FILENAME = "bankr.webhooks.json";
 const WEBHOOKS_DIR = "webhooks";
@@ -46,16 +46,11 @@ function saveConfigFile(projectRoot, config) {
     writeFileSync(join(projectRoot, CONFIG_FILENAME), JSON.stringify(config, null, 2) + "\n");
 }
 function authHeaders() {
-    const headers = {
+    return {
         "X-API-Key": requireApiKey(),
         "Content-Type": "application/json",
         "User-Agent": CLI_USER_AGENT,
     };
-    const config = readConfig();
-    if (config.partnerKey) {
-        headers["X-Partner-Key"] = config.partnerKey;
-    }
-    return headers;
 }
 async function handleResponse(res) {
     if (!res.ok) {

package/dist/commands/x402.js

@@ -20,7 +20,7 @@ import { join } from "node:path";
 import chalk from "chalk";
 import { input, select, confirm } from "@inquirer/prompts";
 import * as output from "../lib/output.js";
-import { getApiUrl, requireApiKey, readConfig, CLI_USER_AGENT, } from "../lib/config.js";
+import { getApiUrl, requireApiKey, CLI_USER_AGENT } from "../lib/config.js";
 // ── Config file helpers ─────────────────────────────────────────────────
 const CONFIG_FILENAME = "bankr.x402.json";
 function findProjectRoot() {
@@ -50,16 +50,11 @@ function saveConfigFile(projectRoot, config) {
 }
 // ── API helpers ─────────────────────────────────────────────────────────
 function authHeaders() {
-    const headers = {
+    return {
         "X-API-Key": requireApiKey(),
         "Content-Type": "application/json",
         "User-Agent": CLI_USER_AGENT,
     };
-    const config = readConfig();
-    if (config.partnerKey) {
-        headers["X-Partner-Key"] = config.partnerKey;
-    }
-    return headers;
 }
 async function handleResponse(res) {
     if (!res.ok) {
@@ -279,10 +274,7 @@ export async function x402ConfigureCommand(name) {
     const currency = "USDC";
     const network = await select({
         message: "Network:",
-        choices: [
-            { name: "Base", value: "base" },
-            { name: "Base Sepolia (testnet)", value: "base-sepolia" },
-        ],
+        choices: [{ name: "Base", value: "base" }],
         default: existing.network ?? "base",
         theme: output.bankrTheme,
     });
@@ -697,62 +689,78 @@ function resolveSchemas(schema) {
     const outputSchema = schema.output;
     return { input: inputSchema, output: outputSchema };
 }
-function printServiceFormatted(svc) {
+/**
+ * Builds the verbose multi-line card for a service. Returns the rendered
+ * string. Pass `rank` and `total` to render a `#N of M` badge in the header
+ * (used by the search command so reading top-to-bottom shows ascending rank
+ * with the top match at the bottom).
+ */
+function formatServiceCard(svc, rank, total) {
     const route = svc.routes[0];
     const methods = route?.methods?.filter((m) => m !== "*").join(", ") || "ANY";
     const url = svc.url ?? `https://x402.bankr.bot/${svc.slug}`;
     const isGet = methods === "GET";
-    // ── Header ──
-    console.log(`  ${output.fmt.brandBold(svc.name)}`);
-    if (svc.description) {
-        console.log(`  ${chalk.dim(svc.description)}`);
-    }
-    console.log("");
+    const lines = [];
+    // ── Header (with rank badge) ──
+    const rankBadge = rank !== undefined
+        ? `${chalk.bold(`#${rank}${total ? ` of ${total}` : ""}`)}  `
+        : "";
+    const scoreBadge = svc.score !== undefined
+        ? `  ${chalk.dim(`(score ${svc.score.toFixed(2)})`)}`
+        : "";
+    lines.push(`  ${rankBadge}${output.fmt.brandBold(svc.name)}${scoreBadge}`);
+    if (svc.description)
+        lines.push(`  ${chalk.dim(svc.description)}`);
+    lines.push("");
     // ── Metadata ──
-    console.log(`    ${chalk.dim("URL")}       ${url}`);
-    console.log(`    ${chalk.dim("Method")}    ${chalk.bold(methods)}`);
-    console.log(`    ${chalk.dim("Price")}     ${chalk.green(`$${route?.price ?? "?"} ${route?.currency ?? "USDC"}`)}`);
-    console.log(`    ${chalk.dim("Network")}   ${route?.network ?? "base"}`);
+    lines.push(`    ${chalk.dim("URL")}       ${url}`);
+    lines.push(`    ${chalk.dim("Method")}    ${chalk.bold(methods)}`);
+    lines.push(`    ${chalk.dim("Price")}     ${chalk.green(`$${route?.price ?? "?"} ${route?.currency ?? "USDC"}`)}`);
+    lines.push(`    ${chalk.dim("Network")}   ${route?.network ?? "base"}`);
     // ── Schema ──
     const { input: inputSchema, output: outputSchema } = resolveSchemas(route?.schema);
     if (inputSchema || outputSchema) {
-        console.log("");
+        lines.push("");
         if (inputSchema) {
             const label = isGet ? "Input (query params)" : "Input (JSON body)";
-            console.log(`    ${chalk.bold(label)}`);
+            lines.push(`    ${chalk.bold(label)}`);
             if (isJsonSchema(inputSchema)) {
                 for (const line of renderJsonSchemaProps(inputSchema)) {
-                    console.log(line);
+                    lines.push(line);
                 }
             }
             else if (typeof inputSchema === "object" && inputSchema !== null) {
                 for (const line of renderLegacySchema(inputSchema)) {
-                    console.log(line);
+                    lines.push(line);
                 }
             }
         }
         if (outputSchema) {
-            console.log("");
-            console.log(`    ${chalk.bold("Output")}`);
+            lines.push("");
+            lines.push(`    ${chalk.bold("Output")}`);
             if (isJsonSchema(outputSchema)) {
                 for (const line of renderJsonSchemaProps(outputSchema)) {
-                    console.log(line);
+                    lines.push(line);
                 }
             }
             else if (typeof outputSchema === "object" && outputSchema !== null) {
                 for (const line of renderLegacySchema(outputSchema)) {
-                    console.log(line);
+                    lines.push(line);
                 }
             }
         }
     }
     // ── Tags ──
     if (svc.tags?.length) {
-        console.log("");
-        console.log(`    ${svc.tags.map((t) => chalk.dim(`#${t}`)).join("  ")}`);
+        lines.push("");
+        lines.push(`    ${svc.tags.map((t) => chalk.dim(`#${t}`)).join("  ")}`);
     }
-    console.log(`  ${chalk.dim("─".repeat(60))}`);
-    console.log("");
+    lines.push(`  ${chalk.dim("─".repeat(60))}`);
+    lines.push("");
+    return lines.join("\n");
+}
+function printServiceFormatted(svc, rank, total) {
+    console.log(formatServiceCard(svc, rank, total));
 }
 // ── Schema ────────────────────────────────────────────────────────────
 export async function x402SchemaCommand(url, opts = {}) {
@@ -1144,8 +1152,7 @@ export async function x402CallCommand(url, opts = {}) {
             resolvedPrice = parseFloat(schema.price);
         }
     }
-    // Confirm payment unless --yes
-    if (!opts.yes && !opts.interactive) {
+    if (!opts.yes && !opts.interactive && !output.isNonInteractive()) {
         const priceDisplay = resolvedPrice !== null
             ? chalk.green(`$${resolvedPrice} USDC`)
             : chalk.green(`up to $${maxPaymentUsd} USDC`);
@@ -1235,7 +1242,7 @@ export async function x402SearchCommand(queryParts, opts = {}) {
     }
     const spin = output.spinner("Searching services...");
     try {
-        const params = new URLSearchParams({ q: query, limit: "10" });
+        const params = new URLSearchParams({ q: query, limit: "50" });
         const res = await fetch(`${getApiUrl()}/x402/endpoints/discover?${params}`);
         const result = await handleResponse(res);
         spin.stop();
@@ -1246,16 +1253,25 @@ export async function x402SearchCommand(queryParts, opts = {}) {
             output.info(`No services found for "${query}"`);
             return;
         }
-        // Raw mode: dump JSON and exit
+        // Raw mode: dump JSON and exit (preserves natural rank order for AI
+        // agents and pipelines — most relevant first).
         if (opts.raw) {
             console.log(JSON.stringify(services, null, 2));
             return;
         }
+        // Print results in REVERSE rank order so the cursor parks on the most
+        // relevant result (rank #1) at the bottom of the buffer. Each card has
+        // a `#N of M` badge so the rank is always visible regardless of which
+        // direction you read.
         console.log();
-        console.log(`  ${chalk.dim(`Found ${services.length} service(s) for`)} "${query}"`);
+        console.log(`  ${chalk.dim(`Found ${services.length} service(s) for`)} "${query}"  ${chalk.dim("(scrolling order: lowest rank first, top match at the bottom)")}`);
         console.log(`  ${chalk.dim("─".repeat(60))}`);
-        for (const svc of services) {
-            printServiceFormatted(svc);
+        console.log();
+        const total = services.length;
+        // Iterate in reverse: start with the lowest-ranked result, end on rank #1.
+        for (let i = total - 1; i >= 0; i--) {
+            const svc = services[i];
+            printServiceFormatted(svc, i + 1, total);
         }
     }
     catch (err) {

package/dist/lib/api.d.ts

@@ -422,6 +422,49 @@ export interface TransferResponse {
     error?: string;
 }
 export declare function transfer(request: TransferRequest): Promise<TransferResponse>;
+export interface SwapQuoteRequest {
+    fromChain: string;
+    fromToken: string;
+    toChain: string;
+    toToken: string;
+    amount: string;
+}
+export interface SwapQuoteSide {
+    chain: string;
+    token: string;
+    amount: string;
+    formattedAmount: string;
+    symbol: string;
+    decimals: number;
+    usdValue: string;
+}
+export interface SwapQuoteResponse {
+    from: SwapQuoteSide;
+    to: SwapQuoteSide;
+    minBuyAmount: string;
+}
+export interface SwapExecuteRequest extends SwapQuoteRequest {
+    minBuyAmount: string;
+}
+export interface SwapExecuteResponse {
+    success: boolean;
+    hash?: string;
+    error?: string;
+    amountReceived?: number;
+    amountReceivedRaw?: string;
+    amountSold?: number;
+    amountSoldRaw?: string;
+}
+export declare function getSwapQuote(request: SwapQuoteRequest): Promise<SwapQuoteResponse>;
+export declare function executeSwap(request: SwapExecuteRequest): Promise<SwapExecuteResponse>;
+export type RecipientType = "address" | "ens" | "twitter" | "farcaster";
+export interface ResolveRecipientResponse {
+    resolved: boolean;
+    address?: string;
+    displayName?: string;
+    error?: string;
+}
+export declare function resolveRecipient(value: string, type: RecipientType): Promise<ResolveRecipientResponse>;
 export interface X402PayRequest {
     url: string;
     method?: string;

package/dist/lib/api.js

@@ -1,4 +1,4 @@
-import { CLI_USER_AGENT, getApiUrl, readConfig, requireApiKey, } from "./config.js";
+import { CLI_USER_AGENT, getApiUrl, requireApiKey } from "./config.js";
 const TERMINAL_STATUSES = [
     "completed",
     "failed",
@@ -8,16 +8,11 @@ function isTerminalStatus(status) {
     return TERMINAL_STATUSES.includes(status);
 }
 function authHeaders() {
-    const headers = {
+    return {
         "X-API-Key": requireApiKey(),
         "Content-Type": "application/json",
         "User-Agent": CLI_USER_AGENT,
     };
-    const config = readConfig();
-    if (config.partnerKey) {
-        headers["X-Partner-Key"] = config.partnerKey;
-    }
-    return headers;
 }
 async function handleResponse(res) {
     if (!res.ok) {
@@ -321,6 +316,31 @@ export async function transfer(request) {
     });
     return handleResponse(res);
 }
+export async function getSwapQuote(request) {
+    const res = await fetch(`${getApiUrl()}/wallet/swap-quote`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify(request),
+    });
+    return handleResponse(res);
+}
+export async function executeSwap(request) {
+    const res = await fetch(`${getApiUrl()}/wallet/swap`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify(request),
+    });
+    return handleResponse(res);
+}
+export async function resolveRecipient(value, type) {
+    const params = new URLSearchParams({ value, type });
+    const res = await fetch(`${getApiUrl()}/addresses/resolve?${params}`, {
+        headers: {
+            "User-Agent": CLI_USER_AGENT,
+        },
+    });
+    return handleResponse(res);
+}
 export async function x402Pay(request) {
     const res = await fetch(`${getApiUrl()}/wallet/x402-pay`, {
         method: "POST",

package/dist/lib/config.d.ts

@@ -5,7 +5,6 @@ export interface BankrConfig {
     llmKey?: string;
     llmUrl?: string;
     lastThreadId?: string;
-    partnerKey?: string;
     sound?: SoundConfig;
 }
 export declare function setConfigPath(path: string): void;

package/dist/lib/output.d.ts

@@ -44,5 +44,6 @@ export interface RemediationStep {
  * Used when the API returns a `remediation` array in error responses.
  */
 export declare function remediation(steps: RemediationStep[]): void;
+export declare function isNonInteractive(): boolean;
 export declare function formatStatus(status: string): string;
 //# sourceMappingURL=output.d.ts.map

package/dist/lib/output.js

@@ -105,6 +105,9 @@ export function remediation(steps) {
     }
     console.log();
 }
+export function isNonInteractive() {
+    return process.env.BANKR_NOT_INTERACTIVE === "1";
+}
 export function formatStatus(status) {
     switch (status) {
         case "completed":

package/dist/lib/tokens.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Native-token sentinel (zero address). The API detects + sanitizes native
+ * tokens from this, so callers send it instead of a real contract address.
+ */
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** Shorten an address for display, e.g. `0x8335…2913`. */
+export declare function shortenAddress(address: string): string;
+/**
+ * Resolve a token symbol or 0x address to `{ address, symbol }` on a chain:
+ * - a valid 0x address is used as-is (symbol shown shortened for display),
+ * - otherwise an exact, case-insensitive symbol match is looked up via
+ *   `/tokens/search`, throwing a "Did you mean" suggestion list on no match.
+ *
+ * Native-token handling is caller-specific (a `--native` flag for transfer, a
+ * native-ticker/zero-address short-circuit for swap), so it lives in the command.
+ */
+export declare function resolveTokenSymbol(tokenInput: string, chain: string): Promise<{
+    address: string;
+    symbol: string;
+}>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/lib/tokens.js

@@ -0,0 +1,40 @@
+import { isAddress } from "viem";
+import { searchTokens } from "./api.js";
+import { CHAIN_IDS } from "./chains.js";
+/**
+ * Native-token sentinel (zero address). The API detects + sanitizes native
+ * tokens from this, so callers send it instead of a real contract address.
+ */
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+/** Shorten an address for display, e.g. `0x8335…2913`. */
+export function shortenAddress(address) {
+    return `${address.slice(0, 6)}…${address.slice(-4)}`;
+}
+/**
+ * Resolve a token symbol or 0x address to `{ address, symbol }` on a chain:
+ * - a valid 0x address is used as-is (symbol shown shortened for display),
+ * - otherwise an exact, case-insensitive symbol match is looked up via
+ *   `/tokens/search`, throwing a "Did you mean" suggestion list on no match.
+ *
+ * Native-token handling is caller-specific (a `--native` flag for transfer, a
+ * native-ticker/zero-address short-circuit for swap), so it lives in the command.
+ */
+export async function resolveTokenSymbol(tokenInput, chain) {
+    const input = tokenInput.trim();
+    if (isAddress(input)) {
+        return { address: input, symbol: shortenAddress(input) };
+    }
+    const chainId = CHAIN_IDS[chain];
+    const res = await searchTokens(input, chainId);
+    const inputUpper = input.toUpperCase();
+    const exactMatch = res.tokens.find((t) => t.symbol.toUpperCase() === inputUpper);
+    if (!exactMatch) {
+        const available = res.tokens
+            .slice(0, 5)
+            .map((t) => `${t.symbol} (${t.address})`)
+            .join(", ");
+        throw new Error(`No exact match for "${input}" on ${chain}. Did you mean: ${available || "no results"}`);
+    }
+    return { address: exactMatch.address, symbol: exactMatch.symbol };
+}
+//# sourceMappingURL=tokens.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bankr/cli",
-  "version": "0.3.1",
+  "version": "0.3.8",
   "description": "Official CLI for the Bankr AI agent platform",
   "type": "module",
   "bin": {
@@ -40,11 +40,11 @@
     "url": "https://discord.gg/bankr"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.2.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "open": "^10.1.0",
-    "ora": "^8.1.0",
+    "@inquirer/prompts": "^8.4.2",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "open": "^11.0.0",
+    "ora": "^9.4.0",
     "viem": "^2.37.2"
   }
 }