@bankr/cli 0.1.0-beta.6 → 0.1.0

package/README.md

@@ -26,9 +26,17 @@ bankr "what is the price of ETH?"
 ### Authentication
 
 ```bash
-# Log in (interactive — opens https://bankr.bot/api to generate an API key)
+# Log in (interactive menu)
 bankr login
 
+# Log in with email (interactive — prompts for OTP and key options)
+bankr login email
+
+# Log in with email (headless two-step, for scripts and agents):
+bankr login email user@example.com                  # Step 1: send OTP
+bankr login email user@example.com --code 123456 \  # Step 2: verify + complete
+  --accept-terms --key-name "My Key" --read-write --llm
+
 # Log in directly with an API key (non-interactive)
 bankr login --api-key bk_YOUR_KEY
 
@@ -65,6 +73,24 @@ bankr prompt -c "compare them"
 bankr prompt --thread thr_ABC123 "tell me more"
 ```
 
+### Token Launch
+
+```bash
+# Interactive wizard — guides you through name, image, tweet, and fee recipient
+bankr launch
+
+# Non-interactive with all options
+bankr launch --name "TESTCOIN" --image "https://example.com/img.png" \
+  --tweet "https://x.com/user/status/123" --fee "@vitalik" --fee-type x -y
+
+# Quick launch (name only, skip confirmation)
+bankr launch --name "TESTCOIN" -y
+
+# Fee recipient types: x, farcaster, ens, wallet
+bankr launch --name "TESTCOIN" --fee "vitalik.eth" --fee-type ens -y
+bankr launch --name "TESTCOIN" --fee "0x1234..." --fee-type wallet -y
+```
+
 ### Job Management
 
 ```bash

package/dist/cli.js

@@ -2,18 +2,23 @@
 import { readFileSync } from "node:fs";
 import { Command } from "commander";
 import { input } from "@inquirer/prompts";
+import { balancesCommand } from "./commands/balances.js";
 import { skillsCommand } from "./commands/capabilities.js";
 import { cancelCommand } from "./commands/cancel.js";
 import { configGetCommand, configSetCommand } from "./commands/config.js";
 import { setConfigPath } from "./lib/config.js";
-import { claudeCommand, creditsCommand, modelsCommand, opencodeCommand, setupClaudeCodeCommand, setupCursorCommand, setupOpenclawCommand, setupOpenCodeCommand, } from "./commands/llm.js";
+import { claudeCommand, creditsCommand, creditsAddCommand, creditsAutoCommand, modelsCommand, opencodeCommand, setupClaudeCodeCommand, setupCursorCommand, setupOpenclawCommand, setupOpenCodeCommand, } from "./commands/llm.js";
+import { feesCommand, feesClaimCommand, feesClaimWalletCommand, } from "./commands/fees.js";
+import { launchCommand } from "./commands/launch.js";
 import { loginCommand } from "./commands/login.js";
 import { logoutCommand } from "./commands/logout.js";
 import { promptCommand } from "./commands/prompt.js";
 import { signCommand } from "./commands/sign.js";
+import { soundsDisableCommand, soundsEnableCommand, soundsInstallCommand, soundsListCommand, soundsMuteCommand, soundsSearchCommand, soundsStatusCommand, soundsTestCommand, soundsUnmuteCommand, soundsUseCommand, soundsVolumeCommand, } from "./commands/sounds.js";
 import { statusCommand } from "./commands/status.js";
 import { submitCommand, submitJsonCommand } from "./commands/submit.js";
 import { whoamiCommand } from "./commands/whoami.js";
+import { profileViewCommand, profileCreateCommand, profileUpdateCommand, profileDeleteCommand, profileAddUpdateCommand, } from "./commands/profile.js";
 import * as output from "./lib/output.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
 /**
@@ -84,7 +89,7 @@ program
         setConfigPath(configPath);
     }
 });
-program
+const loginCmd = program
     .command("login")
     .description("Authenticate with the Bankr API")
     .option("--api-url <url>", "Custom Bankr API URL (default: https://api.bankr.bot)")
@@ -99,6 +104,45 @@ program
         url: opts.url,
     });
 });
+loginCmd
+    .command("email [address]")
+    .description("Sign in with email (sends verification code)")
+    .option("--code <otp>", "OTP code (step 2 of headless login)")
+    .option("--accept-terms", "Accept Terms of Service (skips prompt)")
+    .option("--key-name <name>", "API key name (default: CLI)")
+    .option("--read-write", "Enable write operations on the API key")
+    .option("--llm", "Enable LLM gateway on the API key")
+    .action(async (address, opts, cmd) => {
+    const parentOpts = cmd.parent.opts();
+    await loginCommand({
+        apiUrl: parentOpts.apiUrl,
+        llmKey: parentOpts.llmKey,
+        email: address ?? "",
+        code: opts.code,
+        acceptTerms: opts.acceptTerms,
+        keyName: opts.keyName,
+        readWrite: opts.readWrite,
+        llm: opts.llm,
+    });
+});
+loginCmd
+    .command("siwe")
+    .description("Sign in with Ethereum wallet (SIWE, for headless agents)")
+    .requiredOption("--private-key <key>", "Ethereum private key (0x...)")
+    .option("--partner-key <key>", "Partner API key for fee attribution")
+    .option("--key-name <name>", "API key name (default: SIWE-<date>)")
+    .option("--read-write", "Enable write operations on the API key")
+    .action(async (opts, cmd) => {
+    const parentOpts = cmd.parent.opts();
+    await loginCommand({
+        apiUrl: parentOpts.apiUrl,
+        siwe: true,
+        privateKey: opts.privateKey,
+        partnerKey: opts.partnerKey,
+        keyName: opts.keyName,
+        readWrite: opts.readWrite,
+    });
+});
 program
     .command("logout")
     .description("Clear stored credentials")
@@ -107,6 +151,14 @@ program
     .command("whoami")
     .description("Show current authentication info")
     .action(whoamiCommand);
+program
+    .command("balances")
+    .description("Show wallet token balances across chains")
+    .option("--chain <chains>", "Chain(s) to fetch: base, polygon, mainnet, unichain, solana (comma-separated)")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    await balancesCommand({ chain: opts.chain, json: opts.json });
+});
 program
     .command("prompt [text...]")
     .description("Send a prompt to the Bankr AI agent")
@@ -139,6 +191,157 @@ program
     .command("skills")
     .description("Show all Bankr AI agent skills with examples")
     .action(skillsCommand);
+const soundsCmd = program
+    .command("sounds")
+    .description("Manage CESP sound packs")
+    .action(soundsStatusCommand);
+soundsCmd
+    .command("enable")
+    .description("Enable sounds")
+    .action(soundsEnableCommand);
+soundsCmd
+    .command("disable")
+    .description("Disable sounds")
+    .action(soundsDisableCommand);
+soundsCmd
+    .command("install <pack>")
+    .description("Install a sound pack from the CESP registry")
+    .action(soundsInstallCommand);
+soundsCmd
+    .command("search [query]")
+    .description("Search available packs in the CESP registry")
+    .action(soundsSearchCommand);
+soundsCmd
+    .command("list")
+    .description("List installed sound packs")
+    .action(soundsListCommand);
+soundsCmd
+    .command("use <pack>")
+    .description("Set active sound pack")
+    .action(soundsUseCommand);
+soundsCmd
+    .command("volume [level]")
+    .description("Get or set volume (0.0-1.0)")
+    .action(soundsVolumeCommand);
+soundsCmd
+    .command("mute")
+    .description("Mute all sounds")
+    .action(soundsMuteCommand);
+soundsCmd
+    .command("unmute")
+    .description("Unmute sounds")
+    .action(soundsUnmuteCommand);
+soundsCmd
+    .command("test [category]")
+    .description("Play a test sound")
+    .action(soundsTestCommand);
+program
+    .command("launch")
+    .description("Launch a token on Base (interactive wizard)")
+    .option("--name <name>", "Token name")
+    .option("--symbol <symbol>", "Token symbol (default: auto-generated from name)")
+    .option("--image <url>", "Token image URL")
+    .option("--tweet <url>", "Associated tweet URL")
+    .option("--website <url>", "Project website URL")
+    .option("--fee <recipient>", "Fee recipient (username, ENS, or address)")
+    .option("--fee-type <type>", "Fee recipient type: x, farcaster, ens, wallet (default: x)")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("--simulate", "Simulate the deploy without broadcasting a transaction")
+    .action(async (opts) => {
+    await launchCommand({
+        name: opts.name,
+        symbol: opts.symbol,
+        image: opts.image,
+        tweet: opts.tweet,
+        website: opts.website,
+        fee: opts.fee,
+        feeType: opts.feeType,
+        yes: opts.yes,
+        simulate: opts.simulate,
+    });
+});
+const feesCmd = program
+    .command("fees [address]")
+    .description("View and claim creator token fee earnings")
+    .option("--days <n>", "Lookback period for daily chart (1-90, default: 30)")
+    .option("--token <address>", "Look up fees by token contract address")
+    .option("--json", "Output raw JSON")
+    .action(feesCommand);
+feesCmd
+    .command("claim <tokenAddress>")
+    .description("Claim earned fees for a token")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .action(feesClaimCommand);
+feesCmd
+    .command("claim-wallet [address]")
+    .description("Claim earned fees using your own private key (no Bankr account needed). Reads .env from current directory automatically.")
+    .option("--private-key <key>", "Private key (0x...). Also reads BANKR_PRIVATE_KEY from .env or environment. If neither set, prompted interactively. Address is derived from the key when not provided.")
+    .option("--rpc <url>", "Custom RPC URL (default: https://mainnet.base.org)")
+    .option("--all", "Claim all tokens without selection prompt")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .action(feesClaimWalletCommand);
+const profileCmd = program
+    .command("profile")
+    .description("Manage your agent profile page")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    await profileViewCommand({ json: opts.json });
+});
+profileCmd
+    .command("create")
+    .description("Create a new agent profile")
+    .option("--name <name>", "Project name")
+    .option("--description <text>", "Project description")
+    .option("--token <address>", "Token contract address")
+    .option("--image <url>", "Profile image URL")
+    .option("--website <url>", "Project website URL")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    await profileCreateCommand({
+        name: opts.name,
+        description: opts.description,
+        token: opts.token,
+        image: opts.image,
+        website: opts.website,
+        json: opts.json,
+    });
+});
+profileCmd
+    .command("update")
+    .description("Update your agent profile")
+    .option("--name <name>", "Project name")
+    .option("--description <text>", "Project description")
+    .option("--token <address>", "Token contract address")
+    .option("--image <url>", "Profile image URL")
+    .option("--website <url>", "Project website URL")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    await profileUpdateCommand({
+        name: opts.name,
+        description: opts.description,
+        token: opts.token,
+        image: opts.image,
+        website: opts.website,
+        json: opts.json,
+    });
+});
+profileCmd
+    .command("delete")
+    .description("Delete your agent profile")
+    .action(profileDeleteCommand);
+profileCmd
+    .command("add-update")
+    .description("Add a project update to your profile")
+    .option("--title <title>", "Update title")
+    .option("--content <text>", "Update content")
+    .option("--json", "Output raw JSON")
+    .action(async (opts) => {
+    await profileAddUpdateCommand({
+        title: opts.title,
+        content: opts.content,
+        json: opts.json,
+    });
+});
 program
     .command("sign")
     .description("Sign messages, typed data, or transactions")
@@ -207,10 +410,25 @@ llmCmd
     .command("models")
     .description("List available models")
     .action(modelsCommand);
-llmCmd
+const llmCreditsCmd = llmCmd
     .command("credits")
-    .description("Show LLM gateway credit balance")
+    .description("LLM credit management")
     .action(creditsCommand);
+llmCreditsCmd
+    .command("add <amount>")
+    .description("Add LLM credits from your wallet")
+    .option("--token <address>", "Source token address (default: USDC)")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .action(creditsAddCommand);
+llmCreditsCmd
+    .command("auto")
+    .description("View or configure auto top-up")
+    .option("--enable", "Enable auto top-up")
+    .option("--disable", "Disable auto top-up")
+    .option("--amount <usd>", "Top-up amount in USD")
+    .option("--threshold <usd>", "Trigger when balance drops below this USD amount")
+    .option("--tokens <symbols>", "Comma-separated token symbols (e.g. USDC,DAI)")
+    .action(creditsAutoCommand);
 const llmSetupCmd = llmCmd
     .command("setup")
     .description("Generate agent config (openclaw, claude, opencode, cursor)");

package/dist/commands/balances.d.ts

@@ -0,0 +1,5 @@
+export declare function balancesCommand(opts: {
+    chain?: string;
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=balances.d.ts.map

package/dist/commands/balances.js

@@ -0,0 +1,113 @@
+import chalk from "chalk";
+import { getBalances, } from "../lib/api.js";
+import * as output from "../lib/output.js";
+const BRAND = chalk.hex("#FF613D");
+const DIM = chalk.dim;
+const BOLD = chalk.bold;
+const GREEN = chalk.greenBright;
+const WHITE = chalk.whiteBright;
+const CHAIN_LABELS = {
+    base: "Base",
+    polygon: "Polygon",
+    mainnet: "Ethereum",
+    unichain: "Unichain",
+    solana: "Solana",
+};
+const VALID_CHAINS = new Set([
+    "base",
+    "polygon",
+    "mainnet",
+    "unichain",
+    "solana",
+]);
+function formatUsd(value) {
+    const num = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(num) || num === 0)
+        return DIM("$0.00");
+    return `$${num.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+}
+function formatBalance(value, decimals = 6) {
+    const num = typeof value === "string" ? parseFloat(value) : value;
+    if (isNaN(num) || num === 0)
+        return "0";
+    if (num < 0.000001)
+        return "<0.000001";
+    return num.toLocaleString("en-US", {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: decimals,
+    });
+}
+function printChainBalances(chain, data) {
+    const label = CHAIN_LABELS[chain] || chain;
+    const total = parseFloat(data.total);
+    const totalStr = total > 0 ? GREEN(formatUsd(total)) : DIM(formatUsd(total));
+    console.log();
+    console.log();
+    console.log(`  ${BRAND.bold(label)}  ${totalStr}`);
+    console.log(`  ${DIM("─".repeat(58))}`);
+    // Native balance
+    const nativeUsd = parseFloat(data.nativeUsd);
+    if (nativeUsd > 0 || parseFloat(data.nativeBalance) > 0) {
+        const nativeSymbol = chain === "solana" ? "SOL" : chain === "polygon" ? "POL" : "ETH";
+        console.log(`    ${BOLD(WHITE(nativeSymbol.padEnd(12)))} ${formatBalance(data.nativeBalance).padStart(18)}  ${DIM(formatUsd(nativeUsd))}`);
+    }
+    // Token balances sorted by USD value descending
+    const sorted = [...data.tokenBalances].sort((a, b) => b.token.balanceUSD - a.token.balanceUSD);
+    for (const tb of sorted) {
+        const symbol = tb.token.baseToken.symbol || "???";
+        const bal = formatBalance(tb.token.balance);
+        const usd = formatUsd(tb.token.balanceUSD);
+        console.log(`    ${WHITE(symbol.padEnd(12))} ${bal.padStart(18)}  ${DIM(usd)}`);
+    }
+    if (sorted.length === 0 && (nativeUsd === 0 || isNaN(nativeUsd))) {
+        console.log(DIM("    No token balances"));
+    }
+}
+export async function balancesCommand(opts) {
+    // Validate chain option
+    const chains = opts.chain
+        ? opts.chain.split(",").map((c) => c.trim().toLowerCase())
+        : undefined;
+    if (chains) {
+        const invalid = chains.filter((c) => !VALID_CHAINS.has(c));
+        if (invalid.length > 0) {
+            output.error(`Invalid chain${invalid.length > 1 ? "s" : ""}: ${invalid.join(", ")}. Valid chains: ${[...VALID_CHAINS].join(", ")}`);
+            process.exit(1);
+        }
+    }
+    const spin = output.spinner("Fetching balances...");
+    let data;
+    try {
+        data = await getBalances(chains);
+        spin.succeed("Balances loaded");
+    }
+    catch (err) {
+        spin.fail(`Failed to fetch balances: ${err.message}`);
+        process.exit(1);
+    }
+    // JSON output mode
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    // Calculate grand total
+    let grandTotal = 0;
+    const chainEntries = Object.entries(data.balances);
+    for (const [, chainData] of chainEntries) {
+        grandTotal += parseFloat(chainData.total) || 0;
+    }
+    console.log();
+    output.label("Wallet", "");
+    console.log(`  ${"EVM".padEnd(8)} ${data.evmAddress}`);
+    if (data.solAddress) {
+        console.log(`  ${"SOLANA".padEnd(8)} ${data.solAddress}`);
+    }
+    console.log();
+    output.label("Total", GREEN(formatUsd(grandTotal)));
+    // Print each chain
+    for (const [chain, chainData] of chainEntries) {
+        printChainBalances(chain, chainData);
+    }
+    console.log();
+}
+//# sourceMappingURL=balances.js.map

package/dist/commands/fees.d.ts

@@ -0,0 +1,18 @@
+export interface FeesOptions {
+    days?: string;
+    json?: boolean;
+    token?: string;
+}
+export declare function feesCommand(address: string | undefined, opts: FeesOptions): Promise<void>;
+export interface FeesClaimOptions {
+    yes?: boolean;
+}
+export declare function feesClaimCommand(tokenAddress: string, opts: FeesClaimOptions): Promise<void>;
+export interface FeesClaimWalletOptions {
+    privateKey?: string;
+    rpc?: string;
+    yes?: boolean;
+    all?: boolean;
+}
+export declare function feesClaimWalletCommand(address: string | undefined, opts: FeesClaimWalletOptions): Promise<void>;
+//# sourceMappingURL=fees.d.ts.map