fuego-cli 0.1.0

package/dist/lib/wallet.js

@@ -0,0 +1,118 @@
+import { Keypair, Connection, PublicKey, Transaction, SystemProgram, LAMPORTS_PER_SOL } from '@solana/web3.js';
+import fs from 'fs-extra';
+import path from 'path';
+import { getWalletPath, getWalletConfigPath, saveWalletConfig } from './config.js';
+export class FuegoWallet {
+    walletPath;
+    keypair;
+    constructor(walletPath) {
+        this.walletPath = walletPath || getWalletPath();
+    }
+    exists() {
+        return fs.existsSync(this.walletPath);
+    }
+    async create(name) {
+        // Ensure directory exists
+        await fs.ensureDir(path.dirname(this.walletPath));
+        // Generate new keypair
+        this.keypair = Keypair.generate();
+        const publicKey = this.keypair.publicKey.toBase58();
+        // Save wallet.json with ONLY the keypair (minimal, secure)
+        const walletData = {
+            secretKey: Array.from(this.keypair.secretKey)
+        };
+        await fs.writeJson(this.walletPath, walletData);
+        // Set restrictive permissions (owner read/write only)
+        await fs.chmod(this.walletPath, 0o600);
+        // Save wallet-config.json with metadata (safe to modify)
+        saveWalletConfig({
+            publicKey,
+            name: name || 'default',
+            createdAt: new Date().toISOString(),
+            version: '0.1.0'
+        });
+        return {
+            publicKey,
+            mnemonic: undefined
+        };
+    }
+    load() {
+        if (this.keypair)
+            return this.keypair;
+        if (!this.exists()) {
+            throw new Error('Wallet not found. Run "fuego init" first.');
+        }
+        const walletData = fs.readJsonSync(this.walletPath);
+        this.keypair = Keypair.fromSecretKey(Uint8Array.from(walletData.secretKey));
+        return this.keypair;
+    }
+    getPublicKey() {
+        if (this.keypair) {
+            return this.keypair.publicKey.toBase58();
+        }
+        if (!this.exists()) {
+            throw new Error('Wallet not found. Run "fuego init" first.');
+        }
+        // Read from wallet-config.json if available, otherwise from wallet.json
+        const configPath = getWalletConfigPath();
+        if (fs.existsSync(configPath)) {
+            const config = fs.readJsonSync(configPath);
+            return config.publicKey;
+        }
+        // Fallback: derive from wallet.json
+        const walletData = fs.readJsonSync(this.walletPath);
+        const kp = Keypair.fromSecretKey(Uint8Array.from(walletData.secretKey));
+        return kp.publicKey.toBase58();
+    }
+    async getBalance() {
+        const keypair = this.load();
+        const connection = this.getConnection();
+        const lamports = await connection.getBalance(keypair.publicKey);
+        // TODO: Fetch SPL token balances
+        return {
+            sol: lamports / LAMPORTS_PER_SOL,
+            tokens: []
+        };
+    }
+    async send(params) {
+        const keypair = this.load();
+        const connection = this.getConnection(params.network);
+        const recipient = new PublicKey(params.to);
+        if (params.token === 'SOL') {
+            const lamports = params.amount * LAMPORTS_PER_SOL;
+            const transaction = new Transaction().add(SystemProgram.transfer({
+                fromPubkey: keypair.publicKey,
+                toPubkey: recipient,
+                lamports
+            }));
+            const signature = await connection.sendTransaction(transaction, [keypair]);
+            // Wait for confirmation
+            await connection.confirmTransaction(signature, 'confirmed');
+            return {
+                signature,
+                confirmation: 'confirmed'
+            };
+        }
+        else {
+            // TODO: SPL token transfers
+            throw new Error('SPL token transfers coming in v0.2');
+        }
+    }
+    async getHistory(limit) {
+        const keypair = this.load();
+        const connection = this.getConnection();
+        const signatures = await connection.getSignaturesForAddress(keypair.publicKey, { limit });
+        return signatures.map(sig => ({
+            signature: sig.signature,
+            type: sig.err ? 'outgoing' : 'incoming', // Simplified - actual logic needs transaction parsing
+            amount: '0', // TODO: Parse actual amount
+            token: 'SOL',
+            timestamp: sig.blockTime ? sig.blockTime * 1000 : Date.now(),
+        }));
+    }
+    getConnection(rpcUrl) {
+        const endpoint = rpcUrl || process.env.FUEGO_RPC_URL || 'https://api.mainnet-beta.solana.com';
+        return new Connection(endpoint, 'confirmed');
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/lib/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../src/lib/wallet.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "fuego-cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for Fuego - the sovereign Solana wallet for AI agents",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "fuego": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "npx tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node --test dist/**/*.test.js",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "solana",
+    "wallet",
+    "cli",
+    "ai-agent",
+    "cryptocurrency",
+    "blockchain",
+    "fuego"
+  ],
+  "author": "Will McDeezy <will@yatori.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/willmcdeezy/fuego-cli.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "conf": "^13.1.0",
+    "figlet": "^1.8.0",
+    "fs-extra": "^11.3.0",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^12.4.2",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.13.5",
+    "@typescript-eslint/eslint-plugin": "^8.25.0",
+    "@typescript-eslint/parser": "^8.25.0",
+    "eslint": "^10.0.1",
+    "prettier": "^3.5.2",
+    "typescript": "^5.7.3"
+  }
+}

package/src/commands/address.ts

@@ -0,0 +1,25 @@
+import chalk from 'chalk';
+import { loadWalletConfig } from '../lib/config.js';
+import { showInfo, formatPublicKey, flameDivider } from '../lib/ascii.js';
+
+export async function addressCommand(): Promise<void> {
+  console.log(); // spacer
+  
+  const config = loadWalletConfig();
+  
+  if (!config) {
+    console.log(chalk.red('❌ No wallet found. Run "fuego create" first.'));
+    process.exit(1);
+  }
+  
+  showInfo('📍 Your Fuego Address', [
+    `Name: ${chalk.cyan(config.name || 'default')}`,
+    `Public Key: ${formatPublicKey(config.publicKey)}`
+  ]);
+  
+  // Also show plain for easy copying
+  console.log(chalk.gray('\nPlain text (for copying):'));
+  console.log(chalk.white(config.publicKey));
+  
+  flameDivider();
+}

package/src/commands/create.ts

@@ -0,0 +1,81 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { FuegoWallet } from '../lib/wallet.js';
+import { getWalletPath, getConfigPath } from '../lib/config.js';
+import { showSuccess, showWarning, showInfo, formatPublicKey, flameDivider } from '../lib/ascii.js';
+import fs from 'fs-extra';
+
+interface CreateOptions {
+  force?: boolean;
+  directory?: string;
+  name?: string;
+}
+
+export async function createCommand(options: CreateOptions): Promise<void> {
+  console.log(); // spacer
+  
+  const spinner = ora({
+    text: 'Checking for existing wallet...',
+    color: 'yellow'
+  }).start();
+  
+  try {
+    const walletPath = options.directory 
+      ? `${options.directory}/wallet.json` 
+      : getWalletPath();
+    
+    const wallet = new FuegoWallet(walletPath);
+    
+    if (wallet.exists() && !options.force) {
+      spinner.stop();
+      showWarning('Wallet already exists.\n\nUse --force to overwrite.\n⚠️  Warning: Overwriting will destroy your current wallet!');
+      return;
+    }
+    
+    spinner.text = 'Generating new Solana keypair...';
+    spinner.color = 'red';
+    
+    const { publicKey, mnemonic } = await wallet.create(options.name);
+    
+    // Create config.json with defaults
+    const configPath = options.directory 
+      ? `${options.directory}/config.json` 
+      : getConfigPath();
+    
+    if (!fs.existsSync(configPath)) {
+      fs.writeJsonSync(configPath, {
+        network: 'mainnet',
+        rpcUrl: 'https://api.mainnet-beta.solana.com',
+        version: '0.1.0'
+      }, { spaces: 2 });
+    }
+    
+    spinner.stop();
+    
+    // Success display
+    showSuccess(
+      '🔥 Wallet Created Successfully!',
+      `Name: ${chalk.cyan(options.name || 'default')}\nPublic Key: ${formatPublicKey(publicKey)}`
+    );
+    
+    if (mnemonic) {
+      showWarning(
+        'IMPORTANT: Save this recovery phrase!\n' + 
+        chalk.white(mnemonic) + 
+        '\n\n' + chalk.red('Never share this phrase with anyone!')
+      );
+    }
+    
+    // File locations
+    showInfo('📁 Wallet Files', [
+      'Keypair: ~/.fuego/wallet.json',
+      'Config: ~/.fuego/wallet-config.json'
+    ]);
+    
+    flameDivider();
+    
+  } catch (error: any) {
+    spinner.fail(chalk.red(`Failed to create wallet: ${error.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/install.ts

@@ -0,0 +1,82 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { execSync } from 'child_process';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { showSuccess, showWarning, showInfo, flameDivider } from '../lib/ascii.js';
+
+interface InstallOptions {
+  path?: string;
+}
+
+export async function installCommand(options: InstallOptions): Promise<void> {
+  console.log(); // spacer
+  
+  // Determine default path: use openclaw workspace if it exists, otherwise current directory
+  const openclawWorkspace = path.join(os.homedir(), '.openclaw', 'workspace');
+  const hasOpenclaw = fs.existsSync(openclawWorkspace);
+  
+  const defaultPath = hasOpenclaw 
+    ? path.join(openclawWorkspace, 'fuego')
+    : path.join(process.cwd(), 'fuego');
+  
+  const installPath = options.path || defaultPath;
+  
+  const spinner = ora({
+    text: 'Checking installation path...',
+    color: 'yellow'
+  }).start();
+  
+  try {
+    // Check if already exists
+    if (fs.existsSync(installPath)) {
+      spinner.stop();
+      showWarning(
+        `Fuego already installed at:\n${chalk.cyan(installPath)}\n\nUse --path to install elsewhere, or delete the existing installation.`
+      );
+      return;
+    }
+    
+    spinner.text = 'Creating directory...';
+    spinner.color = 'cyan';
+    await fs.ensureDir(path.dirname(installPath));
+    
+    spinner.text = 'Cloning Fuego repository...';
+    spinner.color = 'red';
+    
+    // Clone the main Fuego repo
+    const repoUrl = 'https://github.com/willmcdeezy/fuego.git';
+    execSync(`git clone ${repoUrl} "${installPath}"`, { stdio: 'pipe' });
+    
+    spinner.stop();
+    
+    // Show contextual next steps
+    const relativePath = path.relative(process.cwd(), installPath);
+    const cdPath = relativePath.startsWith('..') ? installPath : relativePath;
+    const safeCdPath = cdPath.includes(' ') ? `"${cdPath}"` : cdPath;
+    
+    showSuccess(
+      '🔥 Fuego Installed Successfully!',
+      `Location: ${chalk.cyan(installPath)}`
+    );
+    
+    showInfo('🚀 Next Steps', [
+      `cd ${safeCdPath}`,
+      'npm install',
+      'npm run start'
+    ]);
+    
+    flameDivider();
+    
+  } catch (error: any) {
+    spinner.fail(chalk.red(`Installation failed: ${error.message}`));
+    
+    // Cleanup on failure
+    if (fs.existsSync(installPath)) {
+      fs.removeSync(installPath);
+    }
+    
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createCommand } from './commands/create.js';
+import { installCommand } from './commands/install.js';
+import { addressCommand } from './commands/address.js';
+import { showBanner } from './lib/ascii.js';
+
+async function main() {
+  // Show banner for help and when no args provided
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+    showBanner();
+  }
+
+  const program = new Command();
+
+  program
+    .name('fuego')
+    .description('🔥 Fuego CLI - Sovereign Solana wallet for AI agents')
+    .version('0.1.0')
+    .configureOutput({
+      outputError: (str, write) => write(chalk.red(str))
+    });
+
+  program
+    .command('create')
+    .description('Create a new Fuego wallet')
+    .option('-f, --force', 'Overwrite existing wallet')
+    .option('-d, --directory <path>', 'Custom config directory')
+    .option('-n, --name <name>', 'Wallet name', 'default')
+    .action(createCommand);
+
+  program
+    .command('install')
+    .description('Install the main Fuego project (for agents)')
+    .option('-p, --path <path>', 'Installation path (default: ~/.openclaw/workspace/fuego if exists, else ./fuego)')
+    .action(installCommand);
+
+  program
+    .command('address')
+    .alias('addr')
+    .description('Show your wallet address')
+    .action(addressCommand);
+
+  await program.parseAsync(process.argv);
+}
+
+main().catch((error) => {
+  console.error(chalk.red(`\n❌ Error: ${error.message}`));
+  process.exit(1);
+});

package/src/lib/ascii.ts

@@ -0,0 +1,94 @@
+import figlet from 'figlet';
+import gradient from 'gradient-string';
+import boxen from 'boxen';
+import chalk from 'chalk';
+
+// Fire gradient for Fuego branding
+const fireGradient = gradient(['#ff6b35', '#f7931e', '#ffd23f']);
+
+/**
+ * Display the Fuego ASCII banner
+ */
+export function showBanner(): void {
+  const banner = figlet.textSync('FUEGO', {
+    font: 'Big',
+    horizontalLayout: 'default',
+    verticalLayout: 'default'
+  });
+  
+  console.log(fireGradient.multiline(banner));
+  console.log(chalk.gray('  Sovereign Solana wallet for AI agents\n'));
+}
+
+/**
+ * Display a success message in a box
+ */
+export function showSuccess(title: string, message: string): void {
+  const content = `${chalk.bold.green(title)}\n\n${message}`;
+  console.log(
+    boxen(content, {
+      padding: 1,
+      margin: { top: 1, bottom: 1 },
+      borderStyle: 'round',
+      borderColor: 'green',
+      backgroundColor: '#0a0a0a'
+    })
+  );
+}
+
+/**
+ * Display an error message in a box
+ */
+export function showError(message: string): void {
+  console.log(
+    boxen(chalk.red(message), {
+      padding: 1,
+      margin: { top: 1, bottom: 1 },
+      borderStyle: 'bold',
+      borderColor: 'red'
+    })
+  );
+}
+
+/**
+ * Display a warning message in a box
+ */
+export function showWarning(message: string): void {
+  console.log(
+    boxen(chalk.yellow(message), {
+      padding: 1,
+      margin: { top: 0, bottom: 1 },
+      borderStyle: 'round',
+      borderColor: 'yellow'
+    })
+  );
+}
+
+/**
+ * Display info in a subtle box
+ */
+export function showInfo(title: string, lines: string[]): void {
+  const content = chalk.bold.cyan(title) + '\n\n' + lines.map(l => chalk.white(l)).join('\n');
+  console.log(
+    boxen(content, {
+      padding: 1,
+      margin: { top: 0, bottom: 1 },
+      borderStyle: 'single',
+      borderColor: 'cyan'
+    })
+  );
+}
+
+/**
+ * Format a public key with fire styling
+ */
+export function formatPublicKey(key: string): string {
+  return fireGradient(key);
+}
+
+/**
+ * Show a flame divider
+ */
+export function flameDivider(): void {
+  console.log(fireGradient('━'.repeat(50)));
+}

package/src/lib/config.ts

@@ -0,0 +1,74 @@
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.fuego');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const WALLET_FILE = path.join(CONFIG_DIR, 'wallet.json');
+const WALLET_CONFIG_FILE = path.join(CONFIG_DIR, 'wallet-config.json');
+
+interface Config {
+  rpcUrl?: string;
+  network?: 'mainnet' | 'devnet' | 'testnet';
+  defaultToken?: string;
+  [key: string]: string | undefined;
+}
+
+interface WalletConfig {
+  publicKey: string;
+  name?: string;
+  label?: string;
+  createdAt: string;
+  version: string;
+}
+
+export function getWalletPath(): string {
+  return WALLET_FILE;
+}
+
+export function getWalletConfigPath(): string {
+  return WALLET_CONFIG_FILE;
+}
+
+export function getConfigPath(): string {
+  return CONFIG_FILE;
+}
+
+export function loadWalletConfig(): WalletConfig | null {
+  if (!fs.existsSync(WALLET_CONFIG_FILE)) {
+    return null;
+  }
+  return fs.readJsonSync(WALLET_CONFIG_FILE);
+}
+
+export function saveWalletConfig(config: WalletConfig): void {
+  fs.ensureDirSync(CONFIG_DIR);
+  fs.writeJsonSync(WALLET_CONFIG_FILE, config, { spaces: 2 });
+}
+
+function loadConfig(): Config {
+  if (!fs.existsSync(CONFIG_FILE)) {
+    return {};
+  }
+  return fs.readJsonSync(CONFIG_FILE);
+}
+
+function saveConfig(config: Config): void {
+  fs.ensureDirSync(CONFIG_DIR);
+  fs.writeJsonSync(CONFIG_FILE, config, { spaces: 2 });
+}
+
+export function getConfig(key: string): string | undefined {
+  const config = loadConfig();
+  return config[key];
+}
+
+export function setConfig(key: string, value: string): void {
+  const config = loadConfig();
+  config[key] = value;
+  saveConfig(config);
+}
+
+export function listConfig(): Config {
+  return loadConfig();
+}