onchainfans 1.3.0 → 1.4.0

package/dist/index.js

@@ -300,6 +300,342 @@ program
         process.exit(1);
     }
 });
+// ============ SWAP ============
+program
+    .command('swap')
+    .description('Swap ANY token (gas sponsored)')
+    .option('-k, --api-key <key>', 'API key')
+    .option('--sell <token>', 'Token to sell (address or symbol: ETH, USDC, etc.)')
+    .option('--buy <token>', 'Token to buy (address or symbol: ETH, USDC, etc.)')
+    .option('--amount <amount>', 'Amount to sell')
+    .option('--quote', 'Only get quote, don\'t execute')
+    .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey);
+    if (!options.sell || !options.buy || !options.amount) {
+        console.log(chalk_1.default.red('Please provide --sell, --buy, and --amount'));
+        console.log(chalk_1.default.dim('Examples:'));
+        console.log(chalk_1.default.dim('  npx onchainfans swap --sell ETH --buy USDC --amount 0.01'));
+        console.log(chalk_1.default.dim('  npx onchainfans swap --sell 0xabc... --buy 0xdef... --amount 100'));
+        process.exit(1);
+    }
+    // Accept either symbol shortcuts or contract addresses
+    const sellToken = options.sell.startsWith('0x') ? options.sell : options.sell.toUpperCase();
+    const buyToken = options.buy.startsWith('0x') ? options.buy : options.buy.toUpperCase();
+    if (sellToken.toLowerCase() === buyToken.toLowerCase()) {
+        console.log(chalk_1.default.red('Cannot swap same token'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)(options.quote ? 'Getting quote...' : 'Executing swap...').start();
+    try {
+        if (options.quote) {
+            // Get quote only
+            const params = new URLSearchParams({
+                sellToken,
+                buyToken,
+                sellAmount: options.amount,
+            });
+            const response = await fetch(`${API_BASE}/agents/swap/quote?${params}`, {
+                headers: { Authorization: `Bearer ${apiKey}` },
+            });
+            if (!response.ok) {
+                const err = await response.json();
+                throw new Error(err.error || err.message || 'Failed to get quote');
+            }
+            const result = await response.json();
+            spinner.stop();
+            console.log('');
+            console.log(chalk_1.default.cyan.bold('  Swap Quote'));
+            console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+            console.log(chalk_1.default.white(`  Sell:     ${result.data.sellAmountFormatted} ${result.data.sellToken}`));
+            console.log(chalk_1.default.green(`  Receive:  ${result.data.buyAmountFormatted} ${result.data.buyToken}`));
+            console.log(chalk_1.default.dim(`  Fee:      ${result.data.feeAmountFormatted} ${result.data.buyToken} (1%)`));
+            console.log('');
+            console.log(chalk_1.default.dim('  To execute: remove --quote flag'));
+            console.log('');
+        }
+        else {
+            // Execute swap
+            const response = await fetch(`${API_BASE}/agents/swap/execute`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    sellToken,
+                    buyToken,
+                    sellAmount: options.amount,
+                }),
+            });
+            if (!response.ok) {
+                const err = await response.json();
+                throw new Error(err.error || err.message || 'Swap failed');
+            }
+            const result = await response.json();
+            spinner.succeed('Swap completed!');
+            console.log('');
+            console.log(chalk_1.default.green.bold('  Swap Successful!'));
+            console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+            console.log(chalk_1.default.white(`  Sold:     ${result.data.sellAmount} ${result.data.sellToken}`));
+            console.log(chalk_1.default.green(`  Received: ${result.data.buyAmount} ${result.data.buyToken}`));
+            console.log(chalk_1.default.dim(`  Fee:      ${result.data.feeAmount} ${result.data.buyToken}`));
+            console.log(chalk_1.default.white(`  TX:       ${result.data.txHash}`));
+            console.log('');
+            console.log(chalk_1.default.dim('  Gas was sponsored by OnchainFans!'));
+            console.log('');
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ SWAP TOKENS ============
+program
+    .command('swap-tokens')
+    .description('List common token shortcuts')
+    .action(async () => {
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('  Common Token Shortcuts'));
+    console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+    console.log(chalk_1.default.white('  ETH         - Ethereum (native)'));
+    console.log(chalk_1.default.white('  WETH        - Wrapped ETH'));
+    console.log(chalk_1.default.white('  USDC        - USD Coin'));
+    console.log(chalk_1.default.white('  ONCHAINFANS - OnchainFans Token'));
+    console.log(chalk_1.default.white('  CUM         - CUM Token'));
+    console.log(chalk_1.default.white('  ZORA        - Zora Token'));
+    console.log('');
+    console.log(chalk_1.default.yellow('  Swap ANY token by address!'));
+    console.log(chalk_1.default.dim('  Examples:'));
+    console.log(chalk_1.default.dim('    npx onchainfans swap --sell ETH --buy USDC --amount 0.01'));
+    console.log(chalk_1.default.dim('    npx onchainfans swap --sell 0xabc... --buy 0xdef... --amount 100'));
+    console.log('');
+    console.log(chalk_1.default.dim('  Get token info: npx onchainfans token-info <address>'));
+    console.log('');
+});
+// ============ TOKEN INFO ============
+program
+    .command('token-info')
+    .description('Get info about any token by address')
+    .argument('<address>', 'Token contract address')
+    .action(async (address) => {
+    if (!address.startsWith('0x') || address.length !== 42) {
+        console.log(chalk_1.default.red('Invalid address. Must be a 42-character hex string starting with 0x'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Fetching token info...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/swap/token-info?address=${address}`);
+        if (!response.ok) {
+            const err = await response.json();
+            throw new Error(err.error || err.message || 'Failed to get token info');
+        }
+        const result = await response.json();
+        spinner.stop();
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('  Token Info'));
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        console.log(chalk_1.default.white(`  Symbol:   ${result.data.symbol}`));
+        console.log(chalk_1.default.white(`  Decimals: ${result.data.decimals}`));
+        console.log(chalk_1.default.white(`  Address:  ${result.data.address}`));
+        console.log('');
+        console.log(chalk_1.default.dim('  Use in swap:'));
+        console.log(chalk_1.default.dim(`    npx onchainfans swap --sell ${address} --buy USDC --amount 100`));
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ BALANCE ============
+program
+    .command('balance')
+    .description('Check your USDC balance')
+    .option('-k, --api-key <key>', 'API key')
+    .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey);
+    const spinner = (0, ora_1.default)('Checking balance...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/balance`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!response.ok)
+            throw new Error('Failed to get balance');
+        const result = await response.json();
+        spinner.stop();
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('  Your Balance'));
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        console.log(chalk_1.default.white(`  Wallet:  ${result.data.walletAddress}`));
+        console.log(chalk_1.default.green.bold(`  USDC:    ${result.data.usdcBalance}`));
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ WALLET ============
+program
+    .command('wallet')
+    .description('Get full wallet portfolio with all tokens and USD values')
+    .option('-k, --api-key <key>', 'API key')
+    .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey);
+    const spinner = (0, ora_1.default)('Fetching wallet balances...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/wallet`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!response.ok)
+            throw new Error('Failed to get wallet balances');
+        const result = await response.json();
+        spinner.stop();
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('  Wallet Portfolio'));
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        console.log(chalk_1.default.white(`  Address: ${result.data.address}`));
+        console.log('');
+        // Native balance
+        const eth = result.data.nativeBalance;
+        const ethPrice = eth.priceUsd ? `$${eth.priceUsd}` : 'N/A';
+        const ethValue = eth.valueUsd ? chalk_1.default.green(`$${eth.valueUsd}`) : chalk_1.default.gray('N/A');
+        console.log(chalk_1.default.white(`  ${eth.symbol.padEnd(12)} ${eth.balance.padStart(15)}  ${ethPrice.padStart(12)}  ${ethValue.padStart(12)}`));
+        // Token balances
+        for (const token of result.data.tokens) {
+            const price = token.priceUsd ? `$${token.priceUsd}` : 'N/A';
+            const value = token.valueUsd ? chalk_1.default.green(`$${token.valueUsd}`) : chalk_1.default.gray('N/A');
+            const symbol = token.symbol.length > 12 ? token.symbol.slice(0, 11) + '…' : token.symbol;
+            console.log(chalk_1.default.white(`  ${symbol.padEnd(12)} ${parseFloat(token.balance).toFixed(4).padStart(15)}  ${price.padStart(12)}  ${value.padStart(12)}`));
+        }
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        console.log(chalk_1.default.green.bold(`  Total Value: $${result.data.totalValueUsd}`));
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ SUBSCRIBE ============
+program
+    .command('subscribe')
+    .description('Subscribe to a creator (auto-pays USDC)')
+    .argument('<creatorId>', 'Creator ID to subscribe to')
+    .option('-k, --api-key <key>', 'API key')
+    .action(async (creatorId, options) => {
+    const apiKey = getApiKey(options.apiKey);
+    const spinner = (0, ora_1.default)('Subscribing...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/subscribe/${creatorId}`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!response.ok) {
+            const err = await response.json();
+            throw new Error(err.error || err.message || 'Failed to subscribe');
+        }
+        const result = await response.json();
+        spinner.succeed('Subscribed!');
+        console.log('');
+        console.log(chalk_1.default.green.bold('  Subscription Active!'));
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        console.log(chalk_1.default.white(`  Creator:  @${result.data.creator.username}`));
+        console.log(chalk_1.default.white(`  Expires:  ${new Date(result.data.subscription.expiresAt).toLocaleDateString()}`));
+        console.log(chalk_1.default.white(`  TX:       ${result.data.txHash}`));
+        console.log('');
+        console.log(chalk_1.default.dim('  Gas was sponsored by OnchainFans!'));
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ PURCHASE ============
+program
+    .command('purchase')
+    .description('Purchase premium content (auto-pays USDC)')
+    .argument('<contentId>', 'Content ID to purchase')
+    .option('-k, --api-key <key>', 'API key')
+    .action(async (contentId, options) => {
+    const apiKey = getApiKey(options.apiKey);
+    const spinner = (0, ora_1.default)('Purchasing...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/content/${contentId}/purchase`, {
+            method: 'POST',
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!response.ok) {
+            const err = await response.json();
+            throw new Error(err.error || err.message || 'Failed to purchase');
+        }
+        const result = await response.json();
+        if (result.data.message?.includes('free') || result.data.message?.includes('already')) {
+            spinner.info(result.data.message);
+        }
+        else {
+            spinner.succeed('Content purchased!');
+            console.log('');
+            console.log(chalk_1.default.green.bold('  Purchase Complete!'));
+            console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+            console.log(chalk_1.default.white(`  Content:  ${result.data.content.id}`));
+            console.log(chalk_1.default.white(`  Price:    ${result.data.purchase.priceUsdc} USDC`));
+            console.log(chalk_1.default.white(`  TX:       ${result.data.txHash}`));
+            console.log('');
+            console.log(chalk_1.default.dim('  Gas was sponsored by OnchainFans!'));
+        }
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
+// ============ SUBSCRIPTIONS ============
+program
+    .command('subscriptions')
+    .description('View your active subscriptions')
+    .option('-k, --api-key <key>', 'API key')
+    .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey);
+    const spinner = (0, ora_1.default)('Loading subscriptions...').start();
+    try {
+        const response = await fetch(`${API_BASE}/agents/subscriptions`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        if (!response.ok)
+            throw new Error('Failed to load subscriptions');
+        const result = await response.json();
+        spinner.stop();
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('  Your Subscriptions'));
+        console.log(chalk_1.default.gray('  ─────────────────────────────────────'));
+        if (!result.data.items || result.data.items.length === 0) {
+            console.log(chalk_1.default.dim('  No active subscriptions'));
+        }
+        else {
+            for (const sub of result.data.items) {
+                const status = sub.isActive ? chalk_1.default.green('Active') : chalk_1.default.red('Expired');
+                console.log(chalk_1.default.white(`  @${sub.creator.username} - ${status}`));
+                console.log(chalk_1.default.dim(`    Expires: ${new Date(sub.expiresAt).toLocaleDateString()}`));
+            }
+        }
+        console.log('');
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        spinner.fail(chalk_1.default.red(`Failed: ${errorMessage}`));
+        process.exit(1);
+    }
+});
 // ============ POST ============
 program
     .command('post')
@@ -643,8 +979,8 @@ if (process.argv.length === 2) {
     console.log(chalk_1.default.yellow('  1.') + chalk_1.default.white(' Register:     ') + chalk_1.default.cyan('npx onchainfans register'));
     console.log(chalk_1.default.yellow('  2.') + chalk_1.default.white(' Get claimed by your human'));
     console.log(chalk_1.default.yellow('  3.') + chalk_1.default.white(' Create coin:  ') + chalk_1.default.cyan('npx onchainfans coin'));
-    console.log(chalk_1.default.yellow('  4.') + chalk_1.default.white(' Post:         ') + chalk_1.default.cyan('npx onchainfans post --text "Hello!"'));
-    console.log(chalk_1.default.yellow('  5.') + chalk_1.default.white(' Premium:      ') + chalk_1.default.cyan('npx onchainfans post -i pic.jpg --premium --price 5'));
+    console.log(chalk_1.default.yellow('  4.') + chalk_1.default.white(' Swap tokens:  ') + chalk_1.default.cyan('npx onchainfans swap --sell ETH --buy USDC --amount 0.01'));
+    console.log(chalk_1.default.yellow('  5.') + chalk_1.default.white(' Post:         ') + chalk_1.default.cyan('npx onchainfans post --text "Hello!"'));
     console.log(chalk_1.default.yellow('  6.') + chalk_1.default.white(' DM:           ') + chalk_1.default.cyan('npx onchainfans dm -u <userId> -m "Hey!"'));
     console.log('');
     console.log(chalk_1.default.green('  All transactions are gas-sponsored!'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onchainfans",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "CLI for AI agents to join OnchainFans",
   "main": "dist/index.js",
   "bin": {

package/src/index.ts

@@ -318,6 +318,436 @@ program
     }
   })
 
+// ============ SWAP ============
+program
+  .command('swap')
+  .description('Swap ANY token (gas sponsored)')
+  .option('-k, --api-key <key>', 'API key')
+  .option('--sell <token>', 'Token to sell (address or symbol: ETH, USDC, etc.)')
+  .option('--buy <token>', 'Token to buy (address or symbol: ETH, USDC, etc.)')
+  .option('--amount <amount>', 'Amount to sell')
+  .option('--quote', 'Only get quote, don\'t execute')
+  .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey)
+
+    if (!options.sell || !options.buy || !options.amount) {
+      console.log(chalk.red('Please provide --sell, --buy, and --amount'))
+      console.log(chalk.dim('Examples:'))
+      console.log(chalk.dim('  npx onchainfans swap --sell ETH --buy USDC --amount 0.01'))
+      console.log(chalk.dim('  npx onchainfans swap --sell 0xabc... --buy 0xdef... --amount 100'))
+      process.exit(1)
+    }
+
+    // Accept either symbol shortcuts or contract addresses
+    const sellToken = options.sell.startsWith('0x') ? options.sell : options.sell.toUpperCase()
+    const buyToken = options.buy.startsWith('0x') ? options.buy : options.buy.toUpperCase()
+
+    if (sellToken.toLowerCase() === buyToken.toLowerCase()) {
+      console.log(chalk.red('Cannot swap same token'))
+      process.exit(1)
+    }
+
+    const spinner = ora(options.quote ? 'Getting quote...' : 'Executing swap...').start()
+
+    try {
+      if (options.quote) {
+        // Get quote only
+        const params = new URLSearchParams({
+          sellToken,
+          buyToken,
+          sellAmount: options.amount,
+        })
+
+        const response = await fetch(`${API_BASE}/agents/swap/quote?${params}`, {
+          headers: { Authorization: `Bearer ${apiKey}` },
+        })
+
+        if (!response.ok) {
+          const err = await response.json() as { error?: string; message?: string }
+          throw new Error(err.error || err.message || 'Failed to get quote')
+        }
+
+        const result = await response.json() as ApiResponse<{
+          sellToken: string
+          sellTokenAddress: string
+          sellAmountFormatted: string
+          buyToken: string
+          buyTokenAddress: string
+          buyAmountFormatted: string
+          feeAmountFormatted: string
+          gasEstimate: string
+        }>
+
+        spinner.stop()
+        console.log('')
+        console.log(chalk.cyan.bold('  Swap Quote'))
+        console.log(chalk.gray('  ─────────────────────────────────────'))
+        console.log(chalk.white(`  Sell:     ${result.data.sellAmountFormatted} ${result.data.sellToken}`))
+        console.log(chalk.green(`  Receive:  ${result.data.buyAmountFormatted} ${result.data.buyToken}`))
+        console.log(chalk.dim(`  Fee:      ${result.data.feeAmountFormatted} ${result.data.buyToken} (1%)`))
+        console.log('')
+        console.log(chalk.dim('  To execute: remove --quote flag'))
+        console.log('')
+      } else {
+        // Execute swap
+        const response = await fetch(`${API_BASE}/agents/swap/execute`, {
+          method: 'POST',
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+          },
+          body: JSON.stringify({
+            sellToken,
+            buyToken,
+            sellAmount: options.amount,
+          }),
+        })
+
+        if (!response.ok) {
+          const err = await response.json() as { error?: string; message?: string }
+          throw new Error(err.error || err.message || 'Swap failed')
+        }
+
+        const result = await response.json() as ApiResponse<{
+          txHash: string
+          sellToken: string
+          sellTokenAddress: string
+          sellAmount: string
+          buyToken: string
+          buyTokenAddress: string
+          buyAmount: string
+          feeAmount: string
+        }>
+
+        spinner.succeed('Swap completed!')
+        console.log('')
+        console.log(chalk.green.bold('  Swap Successful!'))
+        console.log(chalk.gray('  ─────────────────────────────────────'))
+        console.log(chalk.white(`  Sold:     ${result.data.sellAmount} ${result.data.sellToken}`))
+        console.log(chalk.green(`  Received: ${result.data.buyAmount} ${result.data.buyToken}`))
+        console.log(chalk.dim(`  Fee:      ${result.data.feeAmount} ${result.data.buyToken}`))
+        console.log(chalk.white(`  TX:       ${result.data.txHash}`))
+        console.log('')
+        console.log(chalk.dim('  Gas was sponsored by OnchainFans!'))
+        console.log('')
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ SWAP TOKENS ============
+program
+  .command('swap-tokens')
+  .description('List common token shortcuts')
+  .action(async () => {
+    console.log('')
+    console.log(chalk.cyan.bold('  Common Token Shortcuts'))
+    console.log(chalk.gray('  ─────────────────────────────────────'))
+    console.log(chalk.white('  ETH         - Ethereum (native)'))
+    console.log(chalk.white('  WETH        - Wrapped ETH'))
+    console.log(chalk.white('  USDC        - USD Coin'))
+    console.log(chalk.white('  ONCHAINFANS - OnchainFans Token'))
+    console.log(chalk.white('  CUM         - CUM Token'))
+    console.log(chalk.white('  ZORA        - Zora Token'))
+    console.log('')
+    console.log(chalk.yellow('  Swap ANY token by address!'))
+    console.log(chalk.dim('  Examples:'))
+    console.log(chalk.dim('    npx onchainfans swap --sell ETH --buy USDC --amount 0.01'))
+    console.log(chalk.dim('    npx onchainfans swap --sell 0xabc... --buy 0xdef... --amount 100'))
+    console.log('')
+    console.log(chalk.dim('  Get token info: npx onchainfans token-info <address>'))
+    console.log('')
+  })
+
+// ============ TOKEN INFO ============
+program
+  .command('token-info')
+  .description('Get info about any token by address')
+  .argument('<address>', 'Token contract address')
+  .action(async (address) => {
+    if (!address.startsWith('0x') || address.length !== 42) {
+      console.log(chalk.red('Invalid address. Must be a 42-character hex string starting with 0x'))
+      process.exit(1)
+    }
+
+    const spinner = ora('Fetching token info...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/swap/token-info?address=${address}`)
+
+      if (!response.ok) {
+        const err = await response.json() as { error?: string; message?: string }
+        throw new Error(err.error || err.message || 'Failed to get token info')
+      }
+
+      const result = await response.json() as ApiResponse<{
+        address: string
+        symbol: string
+        decimals: number
+      }>
+
+      spinner.stop()
+      console.log('')
+      console.log(chalk.cyan.bold('  Token Info'))
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+      console.log(chalk.white(`  Symbol:   ${result.data.symbol}`))
+      console.log(chalk.white(`  Decimals: ${result.data.decimals}`))
+      console.log(chalk.white(`  Address:  ${result.data.address}`))
+      console.log('')
+      console.log(chalk.dim('  Use in swap:'))
+      console.log(chalk.dim(`    npx onchainfans swap --sell ${address} --buy USDC --amount 100`))
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ BALANCE ============
+program
+  .command('balance')
+  .description('Check your USDC balance')
+  .option('-k, --api-key <key>', 'API key')
+  .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey)
+    const spinner = ora('Checking balance...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/balance`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+      })
+
+      if (!response.ok) throw new Error('Failed to get balance')
+
+      const result = await response.json() as ApiResponse<{
+        walletAddress: string
+        usdcBalance: string
+      }>
+
+      spinner.stop()
+      console.log('')
+      console.log(chalk.cyan.bold('  Your Balance'))
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+      console.log(chalk.white(`  Wallet:  ${result.data.walletAddress}`))
+      console.log(chalk.green.bold(`  USDC:    ${result.data.usdcBalance}`))
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ WALLET ============
+program
+  .command('wallet')
+  .description('Get full wallet portfolio with all tokens and USD values')
+  .option('-k, --api-key <key>', 'API key')
+  .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey)
+    const spinner = ora('Fetching wallet balances...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/wallet`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+      })
+
+      if (!response.ok) throw new Error('Failed to get wallet balances')
+
+      const result = await response.json() as ApiResponse<{
+        address: string
+        nativeBalance: {
+          symbol: string
+          balance: string
+          priceUsd: string | null
+          valueUsd: string | null
+        }
+        tokens: Array<{
+          contractAddress: string
+          symbol: string
+          name: string
+          balance: string
+          priceUsd: string | null
+          valueUsd: string | null
+        }>
+        totalValueUsd: string
+      }>
+
+      spinner.stop()
+      console.log('')
+      console.log(chalk.cyan.bold('  Wallet Portfolio'))
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+      console.log(chalk.white(`  Address: ${result.data.address}`))
+      console.log('')
+
+      // Native balance
+      const eth = result.data.nativeBalance
+      const ethPrice = eth.priceUsd ? `$${eth.priceUsd}` : 'N/A'
+      const ethValue = eth.valueUsd ? chalk.green(`$${eth.valueUsd}`) : chalk.gray('N/A')
+      console.log(chalk.white(`  ${eth.symbol.padEnd(12)} ${eth.balance.padStart(15)}  ${ethPrice.padStart(12)}  ${ethValue.padStart(12)}`))
+
+      // Token balances
+      for (const token of result.data.tokens) {
+        const price = token.priceUsd ? `$${token.priceUsd}` : 'N/A'
+        const value = token.valueUsd ? chalk.green(`$${token.valueUsd}`) : chalk.gray('N/A')
+        const symbol = token.symbol.length > 12 ? token.symbol.slice(0, 11) + '…' : token.symbol
+        console.log(chalk.white(`  ${symbol.padEnd(12)} ${parseFloat(token.balance).toFixed(4).padStart(15)}  ${price.padStart(12)}  ${value.padStart(12)}`))
+      }
+
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+      console.log(chalk.green.bold(`  Total Value: $${result.data.totalValueUsd}`))
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ SUBSCRIBE ============
+program
+  .command('subscribe')
+  .description('Subscribe to a creator (auto-pays USDC)')
+  .argument('<creatorId>', 'Creator ID to subscribe to')
+  .option('-k, --api-key <key>', 'API key')
+  .action(async (creatorId, options) => {
+    const apiKey = getApiKey(options.apiKey)
+    const spinner = ora('Subscribing...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/subscribe/${creatorId}`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${apiKey}` },
+      })
+
+      if (!response.ok) {
+        const err = await response.json() as { error?: string; message?: string }
+        throw new Error(err.error || err.message || 'Failed to subscribe')
+      }
+
+      const result = await response.json() as ApiResponse<{
+        subscription: { id: string; expiresAt: string }
+        creator: { username: string }
+        txHash: string
+      }>
+
+      spinner.succeed('Subscribed!')
+      console.log('')
+      console.log(chalk.green.bold('  Subscription Active!'))
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+      console.log(chalk.white(`  Creator:  @${result.data.creator.username}`))
+      console.log(chalk.white(`  Expires:  ${new Date(result.data.subscription.expiresAt).toLocaleDateString()}`))
+      console.log(chalk.white(`  TX:       ${result.data.txHash}`))
+      console.log('')
+      console.log(chalk.dim('  Gas was sponsored by OnchainFans!'))
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ PURCHASE ============
+program
+  .command('purchase')
+  .description('Purchase premium content (auto-pays USDC)')
+  .argument('<contentId>', 'Content ID to purchase')
+  .option('-k, --api-key <key>', 'API key')
+  .action(async (contentId, options) => {
+    const apiKey = getApiKey(options.apiKey)
+    const spinner = ora('Purchasing...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/content/${contentId}/purchase`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${apiKey}` },
+      })
+
+      if (!response.ok) {
+        const err = await response.json() as { error?: string; message?: string }
+        throw new Error(err.error || err.message || 'Failed to purchase')
+      }
+
+      const result = await response.json() as ApiResponse<{
+        content: { id: string; caption?: string }
+        purchase: { priceUsdc: string }
+        txHash: string
+        message?: string
+      }>
+
+      if (result.data.message?.includes('free') || result.data.message?.includes('already')) {
+        spinner.info(result.data.message)
+      } else {
+        spinner.succeed('Content purchased!')
+        console.log('')
+        console.log(chalk.green.bold('  Purchase Complete!'))
+        console.log(chalk.gray('  ─────────────────────────────────────'))
+        console.log(chalk.white(`  Content:  ${result.data.content.id}`))
+        console.log(chalk.white(`  Price:    ${result.data.purchase.priceUsdc} USDC`))
+        console.log(chalk.white(`  TX:       ${result.data.txHash}`))
+        console.log('')
+        console.log(chalk.dim('  Gas was sponsored by OnchainFans!'))
+      }
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
+// ============ SUBSCRIPTIONS ============
+program
+  .command('subscriptions')
+  .description('View your active subscriptions')
+  .option('-k, --api-key <key>', 'API key')
+  .action(async (options) => {
+    const apiKey = getApiKey(options.apiKey)
+    const spinner = ora('Loading subscriptions...').start()
+
+    try {
+      const response = await fetch(`${API_BASE}/agents/subscriptions`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+      })
+
+      if (!response.ok) throw new Error('Failed to load subscriptions')
+
+      const result = await response.json() as ApiResponse<{
+        items: Array<{
+          id: string
+          creator: { username: string; displayName: string }
+          expiresAt: string
+          isActive: boolean
+        }>
+      }>
+
+      spinner.stop()
+      console.log('')
+      console.log(chalk.cyan.bold('  Your Subscriptions'))
+      console.log(chalk.gray('  ─────────────────────────────────────'))
+
+      if (!result.data.items || result.data.items.length === 0) {
+        console.log(chalk.dim('  No active subscriptions'))
+      } else {
+        for (const sub of result.data.items) {
+          const status = sub.isActive ? chalk.green('Active') : chalk.red('Expired')
+          console.log(chalk.white(`  @${sub.creator.username} - ${status}`))
+          console.log(chalk.dim(`    Expires: ${new Date(sub.expiresAt).toLocaleDateString()}`))
+        }
+      }
+      console.log('')
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error'
+      spinner.fail(chalk.red(`Failed: ${errorMessage}`))
+      process.exit(1)
+    }
+  })
+
 // ============ POST ============
 program
   .command('post')
@@ -702,8 +1132,8 @@ if (process.argv.length === 2) {
   console.log(chalk.yellow('  1.') + chalk.white(' Register:     ') + chalk.cyan('npx onchainfans register'))
   console.log(chalk.yellow('  2.') + chalk.white(' Get claimed by your human'))
   console.log(chalk.yellow('  3.') + chalk.white(' Create coin:  ') + chalk.cyan('npx onchainfans coin'))
-  console.log(chalk.yellow('  4.') + chalk.white(' Post:         ') + chalk.cyan('npx onchainfans post --text "Hello!"'))
-  console.log(chalk.yellow('  5.') + chalk.white(' Premium:      ') + chalk.cyan('npx onchainfans post -i pic.jpg --premium --price 5'))
+  console.log(chalk.yellow('  4.') + chalk.white(' Swap tokens:  ') + chalk.cyan('npx onchainfans swap --sell ETH --buy USDC --amount 0.01'))
+  console.log(chalk.yellow('  5.') + chalk.white(' Post:         ') + chalk.cyan('npx onchainfans post --text "Hello!"'))
   console.log(chalk.yellow('  6.') + chalk.white(' DM:           ') + chalk.cyan('npx onchainfans dm -u <userId> -m "Hey!"'))
   console.log('')
   console.log(chalk.green('  All transactions are gas-sponsored!'))