@bfun-bot/cli 1.0.7 → 1.0.9

package/README.md

@@ -17,7 +17,7 @@ bfunbot login
 # Create a token
 bfunbot token create --name "My Token" --symbol MYT
 
-# Check balances
+# Check balances (with live USD values)
 bfunbot balances
 
 # Check fee earnings
@@ -35,15 +35,15 @@ bfunbot fees
 | `bfunbot token info <address>` | Get token details |
 | `bfunbot tokens created` | List tokens you've created |
 | `bfunbot status <jobId>` | Check job status |
-| `bfunbot balances` | Show wallet balances (BSC) |
-| `bfunbot quota` | Show daily API quota |
-| `bfunbot fees` | Check fee earnings summary |
-| `bfunbot fees --platform flap` | Per-platform fee breakdown |
+| `bfunbot balances` | Show wallet balances (BSC) with live USD values |
+| `bfunbot quota` | Show daily token creation quota |
+| `bfunbot fees` | Check total fee earnings summary (with live USD) |
+| `bfunbot fees breakdown` | Per-platform fee breakdown (flap + fourmeme) |
+| `bfunbot fees --platform <p> --token <addr>` | Per-token fee detail |
 | `bfunbot llm models` | List available LLM models |
 | `bfunbot llm credits` | Check BFun.bot Credits balance |
 | `bfunbot llm reload` | Reload credits from trading wallet |
 | `bfunbot llm setup openclaw` | Configure OpenClaw integration |
-| `bfunbot skills` | List agent capabilities |
 | `bfunbot config get` | Show current config |
 | `bfunbot config set` | Set a config value |
 | `bfunbot about` | About BFunBot CLI |

package/dist/commands/balances.js

@@ -1,24 +1,23 @@
 import chalk from 'chalk';
 import { agent, handleApiError } from '../lib/api.js';
-import { fmtBalance, shortAddr } from '../lib/display.js';
-function printWallet(label, slot) {
+import { fmtBalance, fmtBnbWithUsd, shortAddr } from '../lib/display.js';
+function printWallet(label, slot, bnbPriceUsd) {
     if (!slot.address) {
         console.log(`  ${chalk.dim(label + ':')}  ${chalk.dim('Not configured')}`);
         return;
     }
     console.log(`  ${chalk.bold(label)}  ${chalk.dim(shortAddr(slot.address))}`);
-    const balances = [
-        ['BNB (BSC)', slot.balance_bnb, slot.bnb_error],
-        ['USDT (BSC)', slot.balance_usdt_bsc, slot.usdt_bsc_error],
-    ];
-    for (const [name, value, error] of balances) {
-        if (error) {
-            console.log(`    ${name.padEnd(14)} ${chalk.red('error')}`);
-        }
-        else if (name === 'BNB (BSC)' || (value && parseFloat(value) > 0)) {
-            const symbol = name.split(' ')[0];
-            console.log(`    ${name.padEnd(14)} ${fmtBalance(value, symbol)}`);
-        }
+    if (slot.bnb_error) {
+        console.log(`    ${'BNB (BSC)'.padEnd(14)} ${chalk.red('error')}`);
+    }
+    else {
+        console.log(`    ${'BNB (BSC)'.padEnd(14)} ${fmtBnbWithUsd(slot.balance_bnb, bnbPriceUsd)}`);
+    }
+    if (slot.usdt_bsc_error) {
+        console.log(`    ${'USDT (BSC)'.padEnd(14)} ${chalk.red('error')}`);
+    }
+    else if (slot.balance_usdt_bsc && parseFloat(slot.balance_usdt_bsc) > 0) {
+        console.log(`    ${'USDT (BSC)'.padEnd(14)} ${fmtBalance(slot.balance_usdt_bsc, 'USDT')}`);
     }
     console.log();
 }
@@ -38,8 +37,9 @@ export function registerBalances(program) {
             console.log(chalk.bold.cyan('Wallet Balances'));
             console.log(chalk.dim('─'.repeat(40)));
             console.log();
-            printWallet('EVM Main', res.evm_main);
-            printWallet('EVM Trading', res.evm_trading);
+            const bnbPrice = res.bnb_price_usd ?? 0;
+            printWallet('EVM Main', res.evm_main, bnbPrice);
+            printWallet('EVM Trading', res.evm_trading, bnbPrice);
         }
         catch (err) {
             handleApiError(err);

package/dist/commands/fees.d.ts

@@ -1,7 +1,7 @@
 /**
- * bfunbot fees                          — summary
- * bfunbot fees --platform flap          — per-platform breakdown
- * bfunbot fees --token <addr>           — single token fee detail
+ * bfunbot fees                                  — summary (total earned)
+ * bfunbot fees breakdown                        — per-platform table
+ * bfunbot fees --token <addr> --platform <plat> — per-token detail
  */
 import { Command } from 'commander';
 export declare function registerFees(program: Command): void;

package/dist/commands/fees.js

@@ -1,28 +1,40 @@
 import chalk from 'chalk';
 import { agent, handleApiError } from '../lib/api.js';
-import { fmtBalance, printTable } from '../lib/display.js';
+import { fmtBalance, fmtBnbWithUsd, printTable } from '../lib/display.js';
 const VALID_PLATFORMS = ['flap', 'fourmeme'];
 // ─── Display Helpers ─────────────────────────────────────
 function printSummary(res) {
+    const bnbPrice = res.bnb_price_usd ?? 0;
     console.log();
     console.log(chalk.bold.cyan('Fee Earnings Summary'));
     console.log(chalk.dim('─'.repeat(44)));
     console.log();
-    console.log(`  ${chalk.bold('BSC (BNB Chain)')}  ${chalk.dim(res.bsc.token_count + ' tokens')}`);
-    console.log(`    ${'Total Earned'.padEnd(22)} ${fmtBalance(res.bsc.total_earned_bnb.toString(), 'BNB')}`);
+    console.log(`  ${chalk.bold('BSC (BNB Chain)')}`);
+    console.log(`    ${'Total Earned'.padEnd(22)} ${fmtBnbWithUsd(res.bsc.total_earned_bnb.toString(), bnbPrice)}`);
+    console.log();
+    console.log(chalk.dim(`  For per-platform breakdown: bfunbot fees breakdown`));
     console.log();
 }
-function printEarnings(res) {
+function printBreakdown(res, bnbPriceUsd) {
     console.log();
-    console.log(chalk.bold.cyan(`Fee Earnings · BSC`));
+    console.log(chalk.bold.cyan('Fee Earnings · Platform Breakdown'));
     console.log(chalk.dim('─'.repeat(44)));
-    console.log();
-    printTable(['Platform', 'Earned', 'Tokens'], [
-        ['flap', fmtBalance(res.flap.total_earned_bnb.toString(), 'BNB'), res.flap.earning_token_count.toString()],
-        ['fourmeme', fmtBalance(res.fourmeme.total_earned_bnb.toString(), 'BNB'), res.fourmeme.earning_token_count.toString()],
+    printTable(['Platform', 'Earned', 'USD Value', 'Tokens'], [
+        [
+            'flap',
+            fmtBalance(res.flap.total_earned_bnb.toString(), 'BNB'),
+            bnbPriceUsd ? chalk.dim(`~$${(res.flap.total_earned_bnb * bnbPriceUsd).toFixed(2)}`) : chalk.dim('—'),
+            res.flap.earning_token_count.toString(),
+        ],
+        [
+            'fourmeme',
+            fmtBalance(res.fourmeme.total_earned_bnb.toString(), 'BNB'),
+            bnbPriceUsd ? chalk.dim(`~$${(res.fourmeme.total_earned_bnb * bnbPriceUsd).toFixed(2)}`) : chalk.dim('—'),
+            res.fourmeme.earning_token_count.toString(),
+        ],
     ]);
 }
-function printToken(res) {
+function printToken(res, bnbPriceUsd) {
     if ('supported' in res && res.supported === false) {
         console.log();
         console.log(chalk.yellow('⚠') + '  ' + res.message);
@@ -37,16 +49,16 @@ function printToken(res) {
     console.log(`  ${'Token'.padEnd(14)} ${bsc.token_name} (${bsc.token_symbol})`);
     console.log(`  ${'Address'.padEnd(14)} ${chalk.dim(bsc.token_address)}`);
     console.log(`  ${'Platform'.padEnd(14)} ${bsc.platform}`);
-    console.log(`  ${'Earned'.padEnd(14)} ${fmtBalance(bsc.earned_bnb.toString(), 'BNB')}`);
+    console.log(`  ${'Earned'.padEnd(14)} ${fmtBnbWithUsd(bsc.earned_bnb.toString(), bnbPriceUsd)}`);
     console.log();
 }
 // ─── Command Registration ─────────────────────────────────
 export function registerFees(program) {
-    program
+    const feesCmd = program
         .command('fees')
-        .description('Check fee earnings (summary, per-platform, or per-token)')
-        .option('--platform <platform>', 'Platform: flap or fourmeme')
-        .option('--token <address>', 'Token contract address')
+        .description('Check fee earnings (summary, breakdown, or per-token)')
+        .option('--platform <platform>', 'Platform for per-token lookup: flap or fourmeme')
+        .option('--token <address>', 'Token contract address (requires --platform)')
         .action(async (opts, cmd) => {
         const isJson = cmd.optsWithGlobals().json;
         try {
@@ -61,27 +73,35 @@ export function registerFees(program) {
                     console.error(chalk.red('Error:') + ` Platform must be one of: ${VALID_PLATFORMS.join(', ')}`);
                     process.exit(1);
                 }
-                const res = await agent.feesToken('bsc', platform, opts.token);
+                const tokenRes = await agent.feesToken('bsc', platform, opts.token);
                 if (isJson) {
-                    console.log(JSON.stringify(res, null, 2));
+                    console.log(JSON.stringify(tokenRes, null, 2));
                     return;
                 }
-                printToken(res);
+                // Fetch price separately — graceful fallback if summary is unavailable
+                let bnbPrice = 0;
+                try {
+                    bnbPrice = (await agent.feesSummary()).bnb_price_usd ?? 0;
+                }
+                catch { /* non-fatal */ }
+                printToken(tokenRes, bnbPrice);
                 return;
             }
-            // Per-platform breakdown
+            // --platform alone (legacy): route to breakdown with deprecation hint
             if (opts.platform) {
-                if (!VALID_PLATFORMS.includes(opts.platform)) {
-                    console.error(chalk.red('Error:') + ` Platform must be one of: ${VALID_PLATFORMS.join(', ')}`);
-                    process.exit(1);
-                }
-                // Show full breakdown (both platforms) — the platform flag is for future filtering
-                const res = await agent.feesEarnings('bsc');
+                if (!isJson)
+                    console.log(chalk.dim('  Tip: use `bfunbot fees breakdown` for per-platform earnings'));
+                const earningsRes = await agent.feesEarnings('bsc');
                 if (isJson) {
-                    console.log(JSON.stringify(res, null, 2));
+                    console.log(JSON.stringify(earningsRes, null, 2));
                     return;
                 }
-                printEarnings(res);
+                let bnbPrice = 0;
+                try {
+                    bnbPrice = (await agent.feesSummary()).bnb_price_usd ?? 0;
+                }
+                catch { /* non-fatal */ }
+                printBreakdown(earningsRes, bnbPrice);
                 return;
             }
             // Default: summary
@@ -96,4 +116,28 @@ export function registerFees(program) {
             handleApiError(err);
         }
     });
+    // ── fees breakdown ────────────────────────────────────
+    feesCmd
+        .command('breakdown')
+        .description('Per-platform fee earnings (flap + fourmeme)')
+        .action(async (_, cmd) => {
+        const isJson = cmd.optsWithGlobals().json;
+        try {
+            const earningsRes = await agent.feesEarnings('bsc');
+            if (isJson) {
+                console.log(JSON.stringify(earningsRes, null, 2));
+                return;
+            }
+            // Price fetch is non-fatal — breakdown still works without USD values
+            let bnbPrice = 0;
+            try {
+                bnbPrice = (await agent.feesSummary()).bnb_price_usd ?? 0;
+            }
+            catch { /* non-fatal */ }
+            printBreakdown(earningsRes, bnbPrice);
+        }
+        catch (err) {
+            handleApiError(err);
+        }
+    });
 }

package/dist/commands/llm.js

@@ -49,12 +49,11 @@ export function registerLlm(program) {
                 return;
             }
             printCard('BFun.bot Credits', [
-                ['Balance', `$${res.balance_usd}`],
+                ['Balance', chalk.bold.white(`$${res.balance_usd}`)],
             ]);
             // Show agent reload config
             if (res.agent_reload) {
                 const r = res.agent_reload;
-                console.log();
                 if (r.enabled) {
                     console.log(`  ${chalk.dim('Agent Reload:')}  ${chalk.green('ON')}`);
                     console.log(`  ${chalk.dim('Amount:')}        $${r.amount_usd.toFixed(2)}`);

package/dist/commands/quota.js

@@ -13,13 +13,16 @@ export function registerQuota(program) {
                 console.log(JSON.stringify(res, null, 2));
                 return;
             }
-            printTable(['Chain', 'Free Used', 'Free Limit', 'Sponsored', 'Can Create'], res.chains.map((c) => [
-                chalk.bold(c.chain.charAt(0).toUpperCase() + c.chain.slice(1)),
-                `${c.free_used_today}`,
-                `${c.free_limit}`,
-                `${c.sponsored_remaining}`,
-                c.can_create_paid ? chalk.green('Yes') : chalk.dim('No'),
-            ]));
+            printTable(['Chain', 'Used Today', 'Daily Limit', 'Remaining', 'Can Create'], res.chains.map((c) => {
+                const canCreate = c.sponsored_remaining > 0 || c.can_create_paid;
+                return [
+                    chalk.bold(c.chain.charAt(0).toUpperCase() + c.chain.slice(1)),
+                    `${c.free_used_today}`,
+                    `${c.free_limit}`,
+                    `${c.sponsored_remaining}`,
+                    canCreate ? chalk.green('Yes') : chalk.dim('No'),
+                ];
+            }));
         }
         catch (err) {
             handleApiError(err);

package/dist/commands/token.js

@@ -4,8 +4,8 @@ import { agent, handleApiError } from '../lib/api.js';
 import { printCard, fmtUsd, fmtDate } from '../lib/display.js';
 const POLL_INTERVAL_MS = 2000;
 const POLL_TIMEOUT_MS = 120_000;
-const EXPLORER_URLS = {
-    bsc: 'https://bscscan.com/token/',
+const TOKEN_VIEW_URLS = {
+    bsc: 'https://bfun.bot/tokens/',
 };
 export function registerToken(program) {
     const tokenCmd = program
@@ -97,7 +97,7 @@ export function registerToken(program) {
                     printCard('Token Deployed', [
                         ['Address', job.token_address],
                         ['Chain', 'BSC'],
-                        ['View', `${EXPLORER_URLS.bsc}${job.token_address}`],
+                        ['View', `${TOKEN_VIEW_URLS.bsc}${job.token_address}`],
                     ]);
                     return;
                 }
@@ -129,7 +129,7 @@ export function registerToken(program) {
                 console.log(JSON.stringify(res, null, 2));
                 return;
             }
-            const explorerBase = EXPLORER_URLS[res.chain] || '';
+            const viewBase = TOKEN_VIEW_URLS[res.chain] || '';
             printCard(`${res.symbol} — ${res.name}`, [
                 ['Address', res.token_address],
                 ['Chain', res.chain],
@@ -140,7 +140,7 @@ export function registerToken(program) {
                 ['24h Volume', fmtUsd(res.volume_24h_usd)],
                 ['Creator Reward', fmtUsd(res.creator_reward_usd)],
                 ['Created', fmtDate(res.created_at)],
-                ['Explorer', explorerBase ? `${explorerBase}${res.token_address}` : undefined],
+                ['View', viewBase ? `${viewBase}${res.token_address}` : undefined],
             ]);
         }
         catch (err) {

package/dist/index.js

@@ -17,7 +17,6 @@ import { registerToken } from './commands/token.js';
 import { registerStatus } from './commands/status.js';
 import { registerBalances } from './commands/balances.js';
 import { registerQuota } from './commands/quota.js';
-import { registerSkills } from './commands/skills.js';
 import { registerLlm } from './commands/llm.js';
 import { registerConfig } from './commands/config.js';
 import { registerAbout } from './commands/about.js';
@@ -78,7 +77,6 @@ registerToken(program);
 registerStatus(program);
 registerBalances(program);
 registerQuota(program);
-registerSkills(program);
 registerLlm(program);
 registerConfig(program);
 registerAbout(program);

package/dist/lib/display.d.ts

@@ -4,6 +4,7 @@
 export declare function printCard(title: string, fields: [string, string | undefined][]): void;
 /**
  * Print a simple table with headers.
+ * Uses ANSI-stripped lengths for column width calculation so chalk colors don't break alignment.
  */
 export declare function printTable(headers: string[], rows: string[][]): void;
 /**
@@ -14,6 +15,11 @@ export declare function shortAddr(addr: string | undefined | null, chars?: numbe
  * Format a balance value.
  */
 export declare function fmtBalance(value: string | undefined | null, symbol: string): string;
+/**
+ * Format a BNB value with USD equivalent in parentheses.
+ * e.g. "0.00412 BNB (~$2.47)"
+ */
+export declare function fmtBnbWithUsd(value: string | undefined | null, bnbPriceUsd: number): string;
 /**
  * Format a USD value.
  */

package/dist/lib/display.js

@@ -2,6 +2,7 @@
  * Terminal display helpers — tables, cards, formatting.
  */
 import chalk from 'chalk';
+import stringWidth from 'string-width';
 /**
  * Print a key-value card.
  */
@@ -16,23 +17,38 @@ export function printCard(title, fields) {
     }
     console.log();
 }
+/**
+ * Get the visible terminal width of a string.
+ * Uses string-width which correctly handles ANSI codes, CJK wide chars,
+ * ZWJ emoji sequences, variation selectors, and all Unicode edge cases.
+ */
+function visibleWidth(str) {
+    return stringWidth(str);
+}
 /**
  * Print a simple table with headers.
+ * Uses ANSI-stripped lengths for column width calculation so chalk colors don't break alignment.
  */
 export function printTable(headers, rows) {
-    // Calculate column widths
+    // Calculate column widths using visible terminal width (handles ANSI + CJK wide chars)
     const widths = headers.map((h, i) => {
-        const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] || '').length), 0);
-        return Math.max(h.length, maxRow);
+        const maxRow = rows.reduce((max, row) => Math.max(max, visibleWidth(row[i] || '')), 0);
+        return Math.max(visibleWidth(h), maxRow);
     });
     // Header
-    const headerLine = headers.map((h, i) => h.padEnd(widths[i])).join('  ');
+    const headerLine = headers.map((h, i) => {
+        const padding = widths[i] - visibleWidth(h);
+        return h + ' '.repeat(Math.max(0, padding));
+    }).join('  ');
     console.log();
     console.log(chalk.bold(headerLine));
     console.log(chalk.dim(widths.map(w => '─'.repeat(w)).join('  ')));
-    // Rows
+    // Rows — pad by visible terminal width, not raw string length
     for (const row of rows) {
-        const line = row.map((cell, i) => (cell || '').padEnd(widths[i])).join('  ');
+        const line = row.map((cell, i) => {
+            const padding = widths[i] - visibleWidth(cell || '');
+            return (cell || '') + ' '.repeat(Math.max(0, padding));
+        }).join('  ');
         console.log(line);
     }
     console.log();
@@ -59,9 +75,45 @@ export function fmtBalance(value, symbol) {
         return chalk.dim(`0 ${symbol}`);
     if (num === 0)
         return chalk.dim(`0 ${symbol}`);
-    const formatted = num < 0.0001 ? num.toExponential(2) : num.toFixed(6).replace(/0+$/, '').replace(/\.$/, '');
+    // Use enough decimal places to always show significant digits for very small values.
+    // toFixed(10) rounds below 5e-11 to zero, so fall back to toPrecision for anything smaller.
+    let formatted;
+    if (num >= 0.0001) {
+        formatted = num.toFixed(6).replace(/0+$/, '').replace(/\.$/, '');
+    }
+    else if (num >= 5e-11) {
+        formatted = num.toFixed(10).replace(/0+$/, '').replace(/\.$/, '');
+    }
+    else {
+        // Extremely small: toPrecision gives enough sig figs, then convert from sci notation
+        formatted = parseFloat(num.toPrecision(4)).toFixed(20).replace(/0+$/, '').replace(/\.$/, '');
+    }
     return `${formatted} ${symbol}`;
 }
+/**
+ * Format a BNB value with USD equivalent in parentheses.
+ * e.g. "0.00412 BNB (~$2.47)"
+ */
+export function fmtBnbWithUsd(value, bnbPriceUsd) {
+    const bnbStr = fmtBalance(value, 'BNB');
+    if (!value || value === '0' || value === '0.0' || !bnbPriceUsd)
+        return bnbStr;
+    const num = parseFloat(value);
+    if (isNaN(num) || num === 0)
+        return bnbStr;
+    const usd = num * bnbPriceUsd;
+    return `${bnbStr} ${chalk.dim('(~' + fmtUsdInline(usd) + ')')}`;
+}
+function fmtUsdInline(usd) {
+    if (usd >= 1)
+        return `$${usd.toFixed(2)}`;
+    if (usd === 0)
+        return '$0';
+    const str = usd.toFixed(10);
+    const match = str.match(/^0\.(0*)/);
+    const leadingZeros = match ? match[1].length : 0;
+    return `$${usd.toFixed(leadingZeros + 4)}`;
+}
 /**
  * Format a USD value.
  */

package/dist/types.d.ts

@@ -85,6 +85,7 @@ export interface WalletSlot {
 export interface WalletBalanceResponse {
     evm_main: WalletSlot;
     evm_trading: WalletSlot;
+    bnb_price_usd?: number;
 }
 export interface CreditBalanceResponse {
     balance_usd: string;
@@ -144,6 +145,7 @@ export interface FeeSummaryBsc {
 }
 export interface FeeSummaryResponse {
     bsc: FeeSummaryBsc;
+    bnb_price_usd?: number;
 }
 export interface FeeEarningsBsc {
     chain: 'bsc';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bfun-bot/cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "BFunBot CLI — deploy tokens, check balances, and manage your AI agent from the terminal",
   "type": "module",
   "bin": {
@@ -10,12 +10,16 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "!dist/__tests__",
     "bin",
     "scripts"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build"
   },
   "engines": {
@@ -35,10 +39,13 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
-    "ora": "^8.1.1"
+    "ora": "^8.1.1",
+    "string-width": "^8.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.5.4"
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "^5.5.4",
+    "vitest": "^4.1.2"
   }
 }