@kibibot/cli 1.0.15 → 1.0.17

package/README.md

@@ -1,6 +1,6 @@
 # @kibibot/cli
 
-The official KibiBot command-line interface. Deploy tokens on-chain, check balances, manage Kibi Credits, and control your AI agent from the terminal.
+The official KibiBot command-line interface. Deploy tokens on-chain, check balances, check fee earnings, manage Kibi Credits, and control your AI agent from the terminal.
 
 ## Installation
 
@@ -55,13 +55,14 @@ kibi logout          # clear stored credentials
 ### Token Creation
 
 ```bash
-# Interactive (prompts for name, symbol, chain)
+# Interactive (prompts for name, symbol, chain, source, image)
 kibi token create
 
 # Headless
 kibi token create --name "MyToken" --symbol MTK --chain base
 kibi token create --name "Moon" --symbol MOON --chain solana --description "To the moon"
 kibi token create --name "Moon" --symbol MOON --chain base --image-url https://example.com/moon.png
+kibi token create --name "Moon" --symbol MOON --chain base --source https://x.com/user/status/123
 kibi token create --name "Test" --symbol TST --chain base --no-wait  # return job ID immediately
 
 # Check deployment status
@@ -85,6 +86,25 @@ kibi balances        # on-chain wallet balances across all chains
 kibi quota           # daily token creation quota per chain
 ```
 
+### Fee Earnings
+
+```bash
+# Summary across all chains
+kibi fees
+
+# Per-platform breakdown for a specific chain
+kibi fees --chain bsc
+kibi fees --chain base
+kibi fees --chain solana
+
+# Fee earnings for a specific token
+kibi fees --chain bsc --platform flap --token 0x1234...
+kibi fees --chain bsc --platform fourmeme --token 0x1234...
+kibi fees --chain solana --platform pumpfun --token 5Yz8K...
+```
+
+Supported platforms: `flap` · `fourmeme` (BSC) · `basememe` · `clanker` (Base) · `pumpfun` (Solana)
+
 ### Kibi Credits & Kibi LLM Gateway
 
 ```bash

package/dist/commands/about.js

@@ -28,10 +28,10 @@ export function registerAbout(program) {
         }
         const lines = [
             '',
-            '   K I B I B O T',
+            '   K I B I . B O T',
             '',
             '   Deploy tokens. Earn fees.',
-            '   Power your AI agent.',
+            '   Self-fund your AI agent.',
             '',
             `   Version    ${version}`,
             '   Website    kibi.bot',

package/dist/commands/fees.d.ts

@@ -0,0 +1,7 @@
+/**
+ * kibi fees              — summary across all chains
+ * kibi fees --chain      — per-platform breakdown for a chain
+ * kibi fees --token      — single token fee detail
+ */
+import { Command } from 'commander';
+export declare function registerFees(program: Command): void;

package/dist/commands/fees.js

@@ -0,0 +1,136 @@
+import chalk from 'chalk';
+import { agent, handleApiError } from '../lib/api.js';
+import { fmtBalance, printTable } from '../lib/display.js';
+// ─── Display Helpers ─────────────────────────────────────
+function printSummary(res) {
+    console.log();
+    console.log(chalk.bold.cyan('Fee Earnings Summary'));
+    console.log(chalk.dim('─'.repeat(44)));
+    console.log();
+    // BSC
+    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();
+    // Base
+    console.log(`  ${chalk.bold('Base')}  ${chalk.dim(res.base.token_count + ' tokens')}`);
+    console.log(`    ${'Basememe Earned'.padEnd(22)} ${fmtBalance(res.base.basememe_total_earned_eth, 'ETH')}`);
+    console.log(`    ${'Basememe Claimable'.padEnd(22)} ${fmtBalance(res.base.basememe_claimable_eth, 'ETH')}`);
+    console.log(`    ${'Clanker Claimable'.padEnd(22)} ${fmtBalance(res.base.clanker_claimable_weth_eth, 'WETH')}`);
+    console.log();
+    // Solana
+    console.log(`  ${chalk.bold('Solana')}  ${chalk.dim(res.solana.token_count + ' tokens')}`);
+    console.log(`    ${'Total Earned'.padEnd(22)} ${fmtBalance(res.solana.total_earnings_sol.toString(), 'SOL')}`);
+    console.log(`    ${'Claimable'.padEnd(22)} ${fmtBalance(res.solana.total_claimable_sol.toString(), 'SOL')}`);
+    console.log();
+}
+function printEarnings(res) {
+    console.log();
+    console.log(chalk.bold.cyan(`Fee Earnings · ${res.chain.toUpperCase()}`));
+    console.log(chalk.dim('─'.repeat(44)));
+    console.log();
+    if (res.chain === 'bsc') {
+        const bsc = res;
+        printTable(['Platform', 'Earned', 'Tokens'], [
+            ['flap', fmtBalance(bsc.flap.total_earned_bnb.toString(), 'BNB'), bsc.flap.earning_token_count.toString()],
+            ['fourmeme', fmtBalance(bsc.fourmeme.total_earned_bnb.toString(), 'BNB'), bsc.fourmeme.earning_token_count.toString()],
+        ]);
+    }
+    else if (res.chain === 'base') {
+        const base = res;
+        // Split earned/claimable into separate columns to avoid chalk width issues
+        printTable(['Platform', 'Total Earned', 'Claimable', 'Tokens'], [
+            ['basememe', fmtBalance(base.basememe.total_earned_eth, 'ETH'), fmtBalance(base.basememe.claimable_eth, 'ETH'), base.basememe.token_count.toString()],
+            ['clanker', chalk.dim('—'), fmtBalance(base.clanker.claimable_weth_eth, 'WETH'), base.clanker.token_count.toString()],
+        ]);
+    }
+    else {
+        const sol = res;
+        printTable(['Platform', 'Earned', 'Claimable', 'Tokens'], [
+            ['pumpfun', fmtBalance(sol.pumpfun.total_earnings_sol.toString(), 'SOL'), fmtBalance(sol.pumpfun.total_claimable_sol.toString(), 'SOL'), sol.pumpfun.earning_token_count.toString()],
+        ]);
+    }
+}
+function printToken(res) {
+    // Unsupported platform
+    if ('supported' in res && res.supported === false) {
+        console.log();
+        console.log(chalk.yellow('⚠') + '  ' + res.message);
+        console.log();
+        return;
+    }
+    console.log();
+    console.log(chalk.bold.cyan('Token Fee Earnings'));
+    console.log(chalk.dim('─'.repeat(44)));
+    console.log();
+    if ('earned_bnb' in res) {
+        const bsc = 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} · ${bsc.chain.toUpperCase()}`);
+        console.log(`  ${'Earned'.padEnd(14)} ${fmtBalance(bsc.earned_bnb.toString(), 'BNB')}`);
+    }
+    else {
+        const sol = res;
+        console.log(`  ${'Token'.padEnd(14)} ${sol.token_name} (${sol.token_symbol})`);
+        console.log(`  ${'Mint'.padEnd(14)} ${chalk.dim(sol.mint)}`);
+        console.log(`  ${'Platform'.padEnd(14)} ${sol.platform} · ${sol.chain.toUpperCase()}`);
+        console.log(`  ${'Earned'.padEnd(14)} ${fmtBalance(sol.actual_sol.toString(), 'SOL')}`);
+        console.log(`  ${'Claimable'.padEnd(14)} ${fmtBalance(sol.distributable_sol.toString(), 'SOL')}`);
+        console.log(`  ${'Total'.padEnd(14)} ${fmtBalance(sol.total_sol.toString(), 'SOL')}`);
+        console.log(`  ${'Graduated'.padEnd(14)} ${sol.is_graduated ? chalk.green('Yes') : chalk.dim('No')}`);
+    }
+    console.log();
+}
+// ─── Command Registration ─────────────────────────────────
+export function registerFees(program) {
+    program
+        .command('fees')
+        .description('Check fee earnings (summary, by chain, or per token)')
+        .option('--chain <chain>', 'Chain to query: bsc, base, or solana')
+        .option('--platform <platform>', 'Platform: flap, fourmeme, pumpfun, basememe, clanker')
+        .option('--token <address>', 'Token contract address or mint')
+        .action(async (opts, cmd) => {
+        const isJson = cmd.optsWithGlobals().json;
+        try {
+            // Per-token: requires --chain, --platform, --token
+            if (opts.token) {
+                if (!opts.chain || !opts.platform) {
+                    console.error(chalk.red('Error:') + ' --chain and --platform are required with --token');
+                    process.exit(1);
+                }
+                const res = await agent.feesToken(opts.chain, opts.platform, opts.token);
+                if (isJson) {
+                    console.log(JSON.stringify(res, null, 2));
+                    return;
+                }
+                printToken(res);
+                return;
+            }
+            // --platform without --token: warn and exit
+            if (opts.platform && !opts.token) {
+                console.error(chalk.red('Error:') + ' --platform requires --token. Use: kibi fees --chain <chain> --platform <platform> --token <address>');
+                process.exit(1);
+            }
+            // By chain: requires --chain only
+            if (opts.chain) {
+                const res = await agent.feesEarnings(opts.chain);
+                if (isJson) {
+                    console.log(JSON.stringify(res, null, 2));
+                    return;
+                }
+                printEarnings(res);
+                return;
+            }
+            // Default: summary across all chains
+            const res = await agent.feesSummary();
+            if (isJson) {
+                console.log(JSON.stringify(res, null, 2));
+                return;
+            }
+            printSummary(res);
+        }
+        catch (err) {
+            handleApiError(err);
+        }
+    });
+}

package/dist/commands/token.js

@@ -21,7 +21,8 @@ export function registerToken(program) {
         .option('--symbol <symbol>', 'Token symbol')
         .option('--chain <chain>', 'Chain: base, bsc, or solana')
         .option('--description <desc>', 'Token description')
-        .option('--image-url <url>', 'Image URL (HTTPS or IPFS)')
+        .option('--source <url>', 'Twitter/X post URL (insight source). Tweet image used as token image if --image-url not provided')
+        .option('--image-url <url>', 'Image URL (HTTPS or IPFS) — overrides source tweet image')
         .option('--platform <platform>', 'Platform override')
         .option('--no-wait', 'Return job ID without waiting for deployment')
         .action(async (opts, cmd) => {
@@ -42,8 +43,14 @@ export function registerToken(program) {
                     symbol = await ask('Symbol: ');
                 if (!chain)
                     chain = await ask('Chain (base/bsc/solana): ');
+                if (!opts.source) {
+                    const srcAnswer = await ask('Source tweet URL (optional, press Enter to skip): ');
+                    if (srcAnswer)
+                        opts.source = srcAnswer;
+                }
                 if (!opts.imageUrl) {
-                    const imgAnswer = await ask('Token image URL (optional, press Enter to skip): ');
+                    const imgHint = opts.source ? ' (overrides source tweet image)' : '';
+                    const imgAnswer = await ask(`Token image URL${imgHint} (optional, press Enter to skip): `);
                     if (imgAnswer)
                         opts.imageUrl = imgAnswer;
                 }
@@ -56,12 +63,21 @@ export function registerToken(program) {
                 console.error(`Error: Chain must be one of: ${VALID_CHAINS.join(', ')}`);
                 process.exit(1);
             }
+            // Validate source URL if provided
+            if (opts.source) {
+                const twitterPattern = /^https?:\/\/(?:(?:www\.)?twitter\.com|x\.com)\/[A-Za-z0-9_]+\/status\/\d+/;
+                if (!twitterPattern.test(opts.source)) {
+                    console.error(chalk.red('Error:') + ' --source must be a valid Twitter/X post URL (e.g. https://x.com/user/status/123)');
+                    process.exit(1);
+                }
+            }
             const spinner = ora('Creating token...').start();
             const result = await agent.tokenCreate({
                 name,
                 symbol: symbol.toUpperCase(),
                 chain,
                 description: opts.description,
+                source_url: opts.source,
                 image_url: opts.imageUrl,
                 platform: opts.platform,
             });
@@ -108,6 +124,7 @@ export function registerToken(program) {
             console.log(`  Check status with: ${chalk.cyan(`kibi status ${result.job_id}`)}`);
         }
         catch (err) {
+            ora().fail('Token creation failed');
             handleApiError(err);
         }
     });

package/dist/index.js

@@ -21,6 +21,7 @@ import { registerSkills } from './commands/skills.js';
 import { registerLlm } from './commands/llm.js';
 import { registerConfig } from './commands/config.js';
 import { registerAbout } from './commands/about.js';
+import { registerFees } from './commands/fees.js';
 // Read version from package.json
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -81,4 +82,5 @@ registerSkills(program);
 registerLlm(program);
 registerConfig(program);
 registerAbout(program);
+registerFees(program);
 program.parse();

package/dist/lib/api.d.ts

@@ -22,6 +22,9 @@ export declare const agent: {
     disableReload: () => Promise<void>;
     quota: () => Promise<import("../types.js").QuotaResponse>;
     skills: () => Promise<import("../types.js").SkillsResponse>;
+    feesSummary: () => Promise<import("../types.js").FeeSummaryResponse>;
+    feesEarnings: (chain: string) => Promise<import("../types.js").FeeEarningsResponse>;
+    feesToken: (chain: string, platform: string, tokenAddress: string) => Promise<import("../types.js").FeeTokenResponse>;
 };
 export declare const llm: {
     models: () => Promise<import("../types.js").LlmModelsResponse>;

package/dist/lib/api.js

@@ -40,11 +40,19 @@ function friendlyError(err) {
                 return detail;
             return 'Rate limited. Try again later.';
         }
-        default:
+        default: {
             if (err.statusCode >= 500) {
                 return 'Server error. Try again later.';
             }
-            return err.body?.detail || err.message || `HTTP ${err.statusCode}`;
+            const detail = err.body?.detail;
+            if (typeof detail === 'string')
+                return detail;
+            if (typeof detail === 'object' && detail !== null) {
+                const d = detail;
+                return d.message || d.error || JSON.stringify(detail);
+            }
+            return err.message || `HTTP ${err.statusCode}`;
+        }
     }
 }
 /**
@@ -148,6 +156,9 @@ export const agent = {
     }),
     quota: () => request('/agent/v1/quota'),
     skills: () => request('/agent/v1/skills', { auth: false }),
+    feesSummary: () => request('/agent/v1/fees/summary'),
+    feesEarnings: (chain) => request(`/agent/v1/fees/earnings?chain=${chain}`),
+    feesToken: (chain, platform, tokenAddress) => request(`/agent/v1/fees/token?chain=${chain}&platform=${platform}&token_address=${encodeURIComponent(tokenAddress)}`),
 };
 // LLM Gateway (base: /llm/v1)
 export const llm = {

package/dist/types.d.ts

@@ -34,6 +34,7 @@ export interface TokenCreateRequest {
     symbol: string;
     chain: string;
     description?: string;
+    source_url?: string;
     image_url?: string;
     platform?: string;
 }
@@ -150,6 +151,89 @@ export interface OpenclawConfigResponse {
     api: string;
     models: OpenclawModelEntry[];
 }
+export interface FeeSummaryBsc {
+    chain_id: number;
+    token_count: number;
+    total_earned_bnb: number;
+}
+export interface FeeSummaryBase {
+    chain_id: number;
+    token_count: number;
+    basememe_total_earned_eth: string;
+    basememe_claimable_eth: string;
+    clanker_claimable_weth_eth: string;
+}
+export interface FeeSummarySolana {
+    chain_id: number;
+    token_count: number;
+    total_earnings_sol: number;
+    total_claimable_sol: number;
+}
+export interface FeeSummaryResponse {
+    bsc: FeeSummaryBsc;
+    base: FeeSummaryBase;
+    solana: FeeSummarySolana;
+}
+export interface FeeEarningsBsc {
+    chain: string;
+    chain_id: number;
+    flap: {
+        total_earned_bnb: number;
+        earning_token_count: number;
+    };
+    fourmeme: {
+        total_earned_bnb: number;
+        earning_token_count: number;
+    };
+}
+export interface FeeEarningsBase {
+    chain: string;
+    chain_id: number;
+    basememe: {
+        total_earned_eth: string;
+        claimable_eth: string;
+        token_count: number;
+    };
+    clanker: {
+        claimable_weth_eth: string;
+        token_count: number;
+    };
+}
+export interface FeeEarningsSolana {
+    chain: string;
+    chain_id: number;
+    pumpfun: {
+        total_earnings_sol: number;
+        total_claimable_sol: number;
+        earning_token_count: number;
+    };
+}
+export type FeeEarningsResponse = FeeEarningsBsc | FeeEarningsBase | FeeEarningsSolana;
+export interface FeeTokenBsc {
+    token_address: string;
+    token_name: string;
+    token_symbol: string;
+    platform: string;
+    chain: string;
+    earned_bnb: number;
+}
+export interface FeeTokenSolana {
+    mint: string;
+    token_name: string;
+    token_symbol: string;
+    platform: string;
+    chain: string;
+    actual_sol: number;
+    distributable_sol: number;
+    total_sol: number;
+    is_graduated: boolean;
+}
+export interface FeeTokenUnsupported {
+    platform: string;
+    supported: false;
+    message: string;
+}
+export type FeeTokenResponse = FeeTokenBsc | FeeTokenSolana | FeeTokenUnsupported;
 export interface ApiErrorResponse {
     detail?: string;
     message?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kibibot/cli",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "KibiBot CLI — deploy tokens, check balances, and manage your AI agent from the terminal",
   "type": "module",
   "bin": {