fuego-cli 1.3.1 → 1.4.0

package/README.md

@@ -69,11 +69,13 @@ fuego dashboard
 |---------|-------------|
 | `fuego create` | Create a new Solana wallet |
 | `fuego address` | Show your wallet address |
-| `fuego balance` | Check SOL, USDC, USDT balances |
+| `fuego balance` | Check all token balances (SOL + SPL tokens) |
 | `fuego rpc` | Show or configure your Solana RPC endpoint |
 | `fuego contacts` | Manage your contacts |
 | `fuego fund` | Show funding options: MoonPay link + QR code |
 | `fuego send` | Send SOL, USDC, or USDT to an address or contact |
+| `fuego jupiter quote` | Get swap quotes from Jupiter |
+| `fuego jupiter swap` | Execute token swaps via Jupiter |
 | `fuego purch` | Purchase products via x402 (Amazon, Shopify, etc.) |
 
 ### Project Management
@@ -115,7 +117,7 @@ fuego create --name prod-wallet
 
 ### `fuego balance`
 
-Check balances via the Fuego server.
+Check all token balances via the Fuego server. Shows SOL plus all SPL tokens in your wallet.
 
 ```bash
 fuego balance
@@ -129,9 +131,9 @@ fuego bal
 
 Address: DmFy...eUZF
 
-- SOL:     1.234567890
-- USDC:   $0.00
-- USDT:   $0.00
+- SOL:     0.105113976
+- USDC:   28.85
+- BONK:    712,687.68
 ```
 
 ---
@@ -306,6 +308,55 @@ fuego send melanie 5 --token USDT --yes
 
 ---
 
+### `fuego jupiter quote <amount>`
+
+Get a swap quote from Jupiter for any supported token pair.
+
+```bash
+# Quote SOL to USDC
+fuego jupiter quote 0.5 --input SOL --output USDC
+
+# Quote USDC to BONK
+fuego jupiter quote 100 --input USDC --output BONK
+
+# Quote using full mint addresses
+fuego jupiter quote 1.0 --input SOL --output DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
+```
+
+**Options:**
+- `-i, --input <token>` — **Required.** Input token symbol (SOL, USDC, USDT, BONK, JUP) or full mint address
+- `-o, --output <token>` — **Required.** Output token symbol or full mint address
+
+**Output:** Shows expected output amount, price impact, and routing information.
+
+---
+
+### `fuego jupiter swap <amount>`
+
+Execute a token swap via Jupiter.
+
+```bash
+# Swap SOL to USDC (preview only)
+fuego jupiter swap 0.5 --input SOL --output USDC
+
+# Swap SOL to BONK (with confirmation)
+fuego jupiter swap 0.05 --input SOL --output BONK --yes
+
+# Swap USDC to random token by mint address
+fuego jupiter swap 10 --input USDC --output <mint-address> --yes
+```
+
+**Options:**
+- `-i, --input <token>` — **Required.** Input token symbol or full mint address
+- `-o, --output <token>` — **Required.** Output token symbol or full mint address
+- `-y, --yes` — Skip confirmation and execute immediately
+
+**Supported Tokens:** SOL, USDC, USDT, BONK, JUP (or any token by full mint address)
+
+**Note:** For unknown tokens, provide the full 44-character mint address. The dashboard caches the top 100 tokens for symbol lookups.
+
+---
+
 ### `fuego purch <product-url>`
 
 Purchase products via x402/Purch.xyz (Amazon, Shopify, etc.) using USDC on Solana.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fuego-cli",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Command-line interface for Fuego - the sovereign Solana wallet for AI agents",
   "main": "dist/index.js",
   "type": "module",

package/src/commands/balance.ts

@@ -5,17 +5,24 @@ import ora from 'ora';
 
 const FUEGO_SERVER_URL = 'http://127.0.0.1:8080';
 
-interface BalanceResponse {
-  success: boolean;
-  data?: {
-    sol: number;
-  };
+interface Token {
+  symbol: string;
+  ui_amount: number;
+  decimals: number;
+  mint: string;
+  token_account: string;
+  amount: string;
 }
 
-interface TokenBalanceResponse {
+interface TokensResponse {
   success: boolean;
   data?: {
-    ui_amount: string;
+    wallet: string;
+    network: string;
+    sol_balance: number;
+    sol_lamports: number;
+    token_count: number;
+    tokens: Token[];
   };
 }
 
@@ -35,48 +42,58 @@ export async function balanceCommand(): Promise<void> {
     const publicKey = config.publicKey;
     const network = 'mainnet-beta';
 
-    // Query SOL balance
-    const solResponse = await fetch(`${FUEGO_SERVER_URL}/sol-balance`, {
+    // Query all tokens via /tokens endpoint
+    const tokensResponse = await fetch(`${FUEGO_SERVER_URL}/tokens`, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ network, address: publicKey })
     });
-    const solData = await solResponse.json() as BalanceResponse;
-    const solBalance = solData.success ? solData.data!.sol : 0;
+    const tokensData = await tokensResponse.json() as TokensResponse;
 
-    // Query USDC balance
-    const usdcResponse = await fetch(`${FUEGO_SERVER_URL}/usdc-balance`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ network, address: publicKey })
-    });
-    const usdcData = await usdcResponse.json() as TokenBalanceResponse;
-    const usdcBalance = usdcData.success ? parseFloat(usdcData.data!.ui_amount) : 0;
+    spinner.stop();
 
-    // Query USDT balance
-    const usdtResponse = await fetch(`${FUEGO_SERVER_URL}/usdt-balance`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ network, address: publicKey })
-    });
-    const usdtData = await usdtResponse.json() as TokenBalanceResponse;
-    const usdtBalance = usdtData.success ? parseFloat(usdtData.data!.ui_amount) : 0;
+    if (!tokensData.success || !tokensData.data) {
+      console.log(chalk.red('❌ Failed to fetch balances from server'));
+      process.exit(1);
+    }
 
-    spinner.stop();
+    const { sol_balance, tokens } = tokensData.data;
 
-    showInfo('💰 Your Balances', [
+    // Build balance lines
+    const balanceLines: string[] = [
       `Address: ${formatPublicKey(publicKey)}`,
       '',
-      `${chalk.yellow('- SOL:')}     ${chalk.white(solBalance.toFixed(9))}`,
-      `${chalk.green('- USDC:')}   ${chalk.white('$' + usdcBalance.toFixed(2))}`,
-      `${chalk.cyan('- USDT:')}   ${chalk.white('$' + usdtBalance.toFixed(2))}`,
-    ]);
+      `${chalk.yellow('- SOL:')}     ${chalk.white(sol_balance.toFixed(9))}`,
+    ];
+
+    // Add each token balance
+    for (const token of tokens) {
+      const formattedAmount = token.ui_amount.toLocaleString('en-US', {
+        minimumFractionDigits: 2,
+        maximumFractionDigits: token.decimals > 6 ? 6 : token.decimals
+      });
+      
+      // Color-code common tokens
+      let tokenColor = chalk.white;
+      if (token.symbol === 'USDC') tokenColor = chalk.green;
+      else if (token.symbol === 'USDT') tokenColor = chalk.cyan;
+      else if (token.symbol === 'BONK') tokenColor = chalk.magenta;
+      
+      balanceLines.push(`${tokenColor(`- ${token.symbol}:`)}   ${chalk.white(formattedAmount)}`);
+    }
+
+    // If no tokens found, note that
+    if (tokens.length === 0) {
+      balanceLines.push(chalk.gray('(No SPL tokens found)'));
+    }
+
+    showInfo('💰 Your Balances', balanceLines);
 
     flameDivider();
   } catch (error) {
     spinner.stop();
     console.log(chalk.red(`\n❌ Failed to fetch balances: ${error instanceof Error ? error.message : 'Unknown error'}`));
-    console.log(chalk.gray('\nMake sure the Fuego server is running: cd fuego/server && cargo run'));
+    console.log(chalk.gray('\nMake sure the Fuego server is running: fuego serve'));
     process.exit(1);
   }
 }

package/src/commands/create.ts

@@ -53,7 +53,8 @@ export async function createCommand(options: CreateOptions): Promise<void> {
     fs.writeJsonSync(configPath, {
       ...existingConfig,
       network: existingConfig.network || 'mainnet',
-      rpcUrl: existingConfig.rpcUrl || 'https://api.mainnet-beta.solana.com'
+      rpcUrl: existingConfig.rpcUrl || 'https://api.mainnet-beta.solana.com',
+      jupiterKey: existingConfig.jupiterKey || ''
     }, { spaces: 2 });
     
     // Create address book directory and empty file

package/src/commands/jupiter-quote.ts

@@ -0,0 +1,122 @@
+import chalk from 'chalk';
+import { spawn } from 'child_process';
+import path from 'path';
+import { loadWalletConfig, findFuegoPath } from '../lib/config.js';
+import { showSuccess, showInfo, showError, flameDivider } from '../lib/ascii.js';
+
+interface QuoteOptions {
+  input?: string;
+  output?: string;
+}
+
+const TOKEN_MINTS: { [key: string]: string } = {
+  'SOL': 'So11111111111111111111111111111111111111112',
+  'USDC': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  'USDT': 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+  'BONK': 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263',
+  'JUP': 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
+};
+
+function resolveToken(token: string): string {
+  const upper = token.toUpperCase();
+  if (TOKEN_MINTS[upper]) {
+    return TOKEN_MINTS[upper];
+  }
+  // If it's a full mint address, use it directly
+  if (token.length === 44) {
+    return token;
+  }
+  return '';
+}
+
+export async function jupiterQuoteCommand(amount: string, options: QuoteOptions): Promise<void> {
+  console.log();
+
+  // Validate amount
+  if (!amount) {
+    console.log(chalk.red('❌ Usage: fuego jupiter quote <amount> --input SOL --output USDC'));
+    console.log(chalk.gray('\nExamples:'));
+    console.log(chalk.gray('  fuego jupiter quote 0.5 --input SOL --output USDC'));
+    console.log(chalk.gray('  fuego jupiter quote 10 --input USDC --output BONK'));
+    console.log(chalk.gray('\nSupported tokens: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  const amountNum = parseFloat(amount);
+  if (isNaN(amountNum) || amountNum <= 0) {
+    console.log(chalk.red('❌ Invalid amount. Please provide a positive number.'));
+    process.exit(1);
+  }
+
+  // Validate tokens
+  if (!options.input || !options.output) {
+    console.log(chalk.red('❌ Both --input and --output tokens are required.'));
+    console.log(chalk.gray('Example: --input SOL --output USDC'));
+    process.exit(1);
+  }
+
+  const inputMint = resolveToken(options.input);
+  const outputMint = resolveToken(options.output);
+
+  if (!inputMint) {
+    console.log(chalk.red(`❌ Unknown input token: ${options.input}`));
+    console.log(chalk.gray('Supported: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  if (!outputMint) {
+    console.log(chalk.red(`❌ Unknown output token: ${options.output}`));
+    console.log(chalk.gray('Supported: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  // Load wallet
+  const walletConfig = loadWalletConfig();
+  if (!walletConfig) {
+    console.log(chalk.red('❌ No wallet found. Run "fuego create" first.'));
+    process.exit(1);
+  }
+
+  showInfo('🪐 Jupiter Quote', [
+    `From: ${chalk.cyan(options.input.toUpperCase())}`,
+    `To: ${chalk.cyan(options.output.toUpperCase())}`,
+    `Amount: ${chalk.yellow(amount)}`,
+    `Network: ${chalk.gray('mainnet-beta')}`
+  ]);
+
+  console.log();
+  console.log(chalk.blue('⏳ Fetching quote from Jupiter...'));
+
+  // Find fuego path and call script
+  const fuegoPath = findFuegoPath();
+  if (!fuegoPath) {
+    showError('Fuego installation not found. Run "fuego install" first.');
+    process.exit(1);
+  }
+
+  const scriptPath = path.join(fuegoPath, 'scripts', 'jupiter', 'jupiter_price.mjs');
+
+  const nodeProcess = spawn('node', [
+    scriptPath,
+    '--input', options.input,
+    '--output', options.output,
+    '--amount', amount
+  ]);
+
+  nodeProcess.stdout.on('data', (data) => {
+    process.stdout.write(data);
+  });
+
+  nodeProcess.stderr.on('data', (data) => {
+    process.stderr.write(data);
+  });
+
+  nodeProcess.on('close', (code) => {
+    if (code === 0) {
+      flameDivider();
+    } else {
+      showError('Failed to fetch quote');
+      process.exit(1);
+    }
+  });
+}

package/src/commands/jupiter-swap.ts

@@ -0,0 +1,146 @@
+import chalk from 'chalk';
+import { spawn } from 'child_process';
+import path from 'path';
+import { loadWalletConfig, findFuegoPath } from '../lib/config.js';
+import { showSuccess, showInfo, showError, flameDivider } from '../lib/ascii.js';
+
+interface SwapOptions {
+  input?: string;
+  output?: string;
+  yes?: boolean;
+}
+
+const TOKEN_MINTS: { [key: string]: string } = {
+  'SOL': 'So11111111111111111111111111111111111111112',
+  'USDC': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+  'USDT': 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+  'BONK': 'DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263',
+  'JUP': 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
+};
+
+function resolveToken(token: string): string {
+  const upper = token.toUpperCase();
+  if (TOKEN_MINTS[upper]) {
+    return TOKEN_MINTS[upper];
+  }
+  if (token.length === 44) {
+    return token;
+  }
+  return '';
+}
+
+export async function jupiterSwapCommand(amount: string, options: SwapOptions): Promise<void> {
+  console.log();
+
+  // Validate amount
+  if (!amount) {
+    console.log(chalk.red('❌ Usage: fuego jupiter swap <amount> --input SOL --output USDC [--yes]'));
+    console.log(chalk.gray('\nExamples:'));
+    console.log(chalk.gray('  fuego jupiter swap 0.5 --input SOL --output USDC'));
+    console.log(chalk.gray('  fuego jupiter swap 10 --input USDC --output BONK --yes'));
+    console.log(chalk.gray('\nSupported tokens: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  const amountNum = parseFloat(amount);
+  if (isNaN(amountNum) || amountNum <= 0) {
+    console.log(chalk.red('❌ Invalid amount. Please provide a positive number.'));
+    process.exit(1);
+  }
+
+  // Validate tokens
+  if (!options.input || !options.output) {
+    console.log(chalk.red('❌ Both --input and --output tokens are required.'));
+    console.log(chalk.gray('Example: --input SOL --output USDC'));
+    process.exit(1);
+  }
+
+  const inputMint = resolveToken(options.input);
+  const outputMint = resolveToken(options.output);
+
+  if (!inputMint) {
+    console.log(chalk.red(`❌ Unknown input token: ${options.input}`));
+    console.log(chalk.gray('Supported: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  if (!outputMint) {
+    console.log(chalk.red(`❌ Unknown output token: ${options.output}`));
+    console.log(chalk.gray('Supported: SOL, USDC, USDT, BONK, JUP'));
+    process.exit(1);
+  }
+
+  // Load wallet
+  const walletConfig = loadWalletConfig();
+  if (!walletConfig) {
+    console.log(chalk.red('❌ No wallet found. Run "fuego create" first.'));
+    process.exit(1);
+  }
+
+  // Show transaction preview
+  showInfo('🪐 Jupiter Swap Preview', [
+    `From: ${chalk.yellow(amount)} ${chalk.cyan(options.input.toUpperCase())}`,
+    `To: ${chalk.cyan(options.output.toUpperCase())}`,
+    `Wallet: ${chalk.gray(walletConfig.publicKey.substring(0, 16))}...`,
+    `Network: ${chalk.gray('mainnet-beta')}`
+  ]);
+
+  // Confirm unless --yes
+  if (!options.yes) {
+    console.log();
+    console.log(chalk.yellow('⚠️  Add --yes to confirm and execute swap'));
+    console.log(chalk.gray('Or run first: fuego jupiter quote ' + amount + ' --input ' + options.input + ' --output ' + options.output));
+    flameDivider();
+    return;
+  }
+
+  console.log();
+  console.log(chalk.blue('⏳ Executing Jupiter swap...'));
+  console.log(chalk.gray('This may take a moment...'));
+
+  // Find fuego path and call script
+  const fuegoPath = findFuegoPath();
+  if (!fuegoPath) {
+    showError('Fuego installation not found. Run "fuego install" first.');
+    process.exit(1);
+  }
+
+  const scriptPath = path.join(fuegoPath, 'scripts', 'jupiter', 'jupiter_swap_regular.mjs');
+
+  const nodeProcess = spawn('node', [
+    scriptPath,
+    '--input', options.input,
+    '--output', options.output,
+    '--amount', amount
+  ]);
+
+  let output = '';
+
+  nodeProcess.stdout.on('data', (data) => {
+    output += data.toString();
+    process.stdout.write(data);
+  });
+
+  nodeProcess.stderr.on('data', (data) => {
+    process.stderr.write(data);
+  });
+
+  nodeProcess.on('close', (code) => {
+    if (code === 0) {
+      // Extract signature from output if present
+      const sigMatch = output.match(/Signature: ([A-Za-z0-9]+)/);
+      if (sigMatch) {
+        showSuccess(
+          '✅ Swap Complete!',
+          `${chalk.yellow(amount)} ${chalk.cyan(options.input.toUpperCase())} → ${chalk.cyan(options.output.toUpperCase())}`
+        );
+      } else {
+        showSuccess('✅ Swap Executed!', '');
+      }
+      flameDivider();
+    } else {
+      showError('Swap failed. Check output above for details.');
+      process.exit(1);
+    }
+  });
+}

package/src/index.ts

@@ -14,6 +14,8 @@ import { contactsAddCommand, contactsListCommand, contactsShowCommand, contactsR
 import { sendCommand } from './commands/send.js';
 import { fundCommand } from './commands/fund.js';
 import { purchCommand } from './commands/purch.js';
+import { jupiterQuoteCommand } from './commands/jupiter-quote.js';
+import { jupiterSwapCommand } from './commands/jupiter-swap.js';
 import { showBanner } from './lib/ascii.js';
 import { getFuegoCliVersion } from './lib/config.js';
 
@@ -136,6 +138,25 @@ async function main() {
     .option('--country <code>', 'Country code (default: US)', 'US')
     .action(purchCommand);
 
+  const jupiter = program
+    .command('jupiter')
+    .description('🪐 Jupiter swap commands');
+
+  jupiter
+    .command('quote <amount>')
+    .description('Get a swap quote from Jupiter')
+    .requiredOption('-i, --input <token>', 'Input token (SOL, USDC, USDT, BONK, JUP)')
+    .requiredOption('-o, --output <token>', 'Output token (SOL, USDC, USDT, BONK, JUP)')
+    .action(jupiterQuoteCommand);
+
+  jupiter
+    .command('swap <amount>')
+    .description('Execute a swap via Jupiter')
+    .requiredOption('-i, --input <token>', 'Input token (SOL, USDC, USDT, BONK, JUP)')
+    .requiredOption('-o, --output <token>', 'Output token (SOL, USDC, USDT, BONK, JUP)')
+    .option('-y, --yes', 'Skip confirmation and execute immediately')
+    .action(jupiterSwapCommand);
+
   await program.parseAsync(process.argv);
 }