facinet 1.0.0

package/src/commands/connect.ts

@@ -0,0 +1,84 @@
+/**
+ * Connect Command
+ *
+ * Connect wallet to Facinet CLI
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { Wallet } from 'ethers';
+import { saveConfig, getConfig } from '../utils/config';
+import ora from 'ora';
+
+export async function connectCommand() {
+  console.log(chalk.cyan('\n🔗 Connect Wallet to Facinet\n'));
+
+  const { method } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'method',
+      message: 'How would you like to connect?',
+      choices: [
+        { name: 'Enter Private Key (for testing)', value: 'privateKey' },
+        { name: 'Generate New Wallet', value: 'generate' },
+      ],
+    },
+  ]);
+
+  if (method === 'privateKey') {
+    const { privateKey } = await inquirer.prompt([
+      {
+        type: 'password',
+        name: 'privateKey',
+        message: 'Enter your private key:',
+        mask: '*',
+      },
+    ]);
+
+    try {
+      const wallet = new Wallet(privateKey);
+      saveConfig({ privateKey, address: wallet.address });
+
+      console.log(chalk.green('\n✅ Wallet connected successfully!'));
+      console.log(chalk.gray(`Address: ${wallet.address}`));
+    } catch (error) {
+      console.log(chalk.red('\n❌ Invalid private key'));
+      process.exit(1);
+    }
+  } else {
+    const spinner = ora('Generating new wallet...').start();
+
+    const wallet = Wallet.createRandom();
+
+    spinner.succeed('Wallet generated!');
+
+    console.log(chalk.green('\n✅ New wallet created!'));
+    console.log(chalk.yellow('\n⚠️  IMPORTANT: Save your private key securely!'));
+    console.log(chalk.gray(`\nAddress: ${wallet.address}`));
+    console.log(chalk.gray(`Private Key: ${wallet.privateKey}`));
+    console.log(chalk.gray(`Mnemonic: ${wallet.mnemonic?.phrase}\n`));
+
+    const { confirm } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'confirm',
+        message: 'Have you saved your private key?',
+        default: false,
+      },
+    ]);
+
+    if (!confirm) {
+      console.log(chalk.red('\nPlease save your private key before continuing.'));
+      process.exit(0);
+    }
+
+    saveConfig({ privateKey: wallet.privateKey, address: wallet.address });
+    console.log(chalk.green('✅ Configuration saved!'));
+  }
+
+  // Check network
+  const config = getConfig();
+  console.log(chalk.cyan('\n📡 Network Configuration:'));
+  console.log(chalk.gray(`Network: ${config.network || 'avalanche-fuji'}`));
+  console.log(chalk.gray(`API URL: ${config.apiUrl || 'http://localhost:3000'}\n`));
+}

package/src/commands/facilitator.ts

@@ -0,0 +1,256 @@
+/**
+ * Facilitator Commands
+ *
+ * Create and manage facilitators
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import { Wallet } from 'ethers';
+import { getConfig } from '../utils/config';
+import {
+  createFacilitator,
+  listFacilitators,
+  getFacilitatorStatus,
+  getFacilitatorBalance,
+} from '../utils/api';
+
+interface CreateOptions {
+  name?: string;
+  recipient?: string;
+  url: string;
+}
+
+interface ListOptions {
+  url: string;
+}
+
+interface StatusOptions {
+  url: string;
+}
+
+/**
+ * Create a new facilitator
+ */
+async function create(options: CreateOptions) {
+  console.log(chalk.cyan('\n🚀 Create New Facilitator\n'));
+
+  // Check if wallet is connected
+  const config = getConfig();
+  if (!config.privateKey) {
+    console.log(chalk.red('❌ No wallet connected. Run `facinet connect` first.'));
+    process.exit(1);
+  }
+
+  // Get facilitator details
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'name',
+      message: 'Facilitator name:',
+      when: !options.name,
+      validate: (input: string) => {
+        if (input.length < 3 || input.length > 50) {
+          return 'Name must be between 3 and 50 characters';
+        }
+        return true;
+      },
+    },
+    {
+      type: 'input',
+      name: 'recipient',
+      message: 'Payment recipient address:',
+      when: !options.recipient,
+      default: config.address,
+      validate: (input: string) => {
+        if (!input.match(/^0x[a-fA-F0-9]{40}$/)) {
+          return 'Invalid Ethereum address';
+        }
+        return true;
+      },
+    },
+  ]);
+
+  const name = options.name || answers.name;
+  const recipient = options.recipient || answers.recipient;
+
+  console.log(chalk.gray(`\n📋 Facilitator Details:`));
+  console.log(chalk.gray(`  Name: ${name}`));
+  console.log(chalk.gray(`  Recipient: ${recipient}`));
+  console.log(chalk.gray(`  Creator: ${config.address}\n`));
+
+  const { confirm } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Create facilitator? (Requires 1 USDC registration fee)',
+      default: true,
+    },
+  ]);
+
+  if (!confirm) {
+    console.log(chalk.yellow('Cancelled.'));
+    process.exit(0);
+  }
+
+  const spinner = ora('Creating facilitator...').start();
+
+  try {
+    const wallet = new Wallet(config.privateKey);
+
+    // Generate facilitator wallet
+    const facilitatorWallet = Wallet.createRandom();
+
+    spinner.text = 'Registering facilitator...';
+
+    const result = await createFacilitator(options.url, {
+      name,
+      facilitatorWallet: facilitatorWallet.address,
+      facilitatorPrivateKey: facilitatorWallet.privateKey,
+      paymentRecipient: recipient,
+      createdBy: wallet.address,
+    });
+
+    spinner.succeed('Facilitator created!');
+
+    console.log(chalk.green('\n✅ Facilitator created successfully!'));
+    console.log(chalk.gray(`\n📄 Details:`));
+    console.log(chalk.gray(`  ID: ${result.id}`));
+    console.log(chalk.gray(`  Name: ${name}`));
+    console.log(chalk.gray(`  Wallet: ${facilitatorWallet.address}`));
+    console.log(chalk.gray(`  Status: ${result.status}`));
+
+    console.log(chalk.yellow(`\n⚠️  IMPORTANT: Save facilitator wallet private key!`));
+    console.log(chalk.gray(`  Private Key: ${facilitatorWallet.privateKey}\n`));
+
+    console.log(chalk.cyan('💡 Next steps:'));
+    console.log(chalk.gray(`  1. Fund facilitator wallet with AVAX for gas`));
+    console.log(chalk.gray(`  2. Check status: facinet facilitator status ${result.id}`));
+    console.log(chalk.gray(`  3. Monitor balance: facinet facilitator balance ${result.id}\n`));
+  } catch (error: any) {
+    spinner.fail('Failed to create facilitator');
+    console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+
+/**
+ * List all facilitators
+ */
+async function list(options: ListOptions) {
+  console.log(chalk.cyan('\n📋 Active Facilitators\n'));
+
+  const spinner = ora('Loading facilitators...').start();
+
+  try {
+    const facilitators = await listFacilitators(options.url);
+
+    spinner.stop();
+
+    if (facilitators.length === 0) {
+      console.log(chalk.yellow('No active facilitators found.\n'));
+      return;
+    }
+
+    console.log(chalk.gray(`Found ${facilitators.length} active facilitator(s):\n`));
+
+    facilitators.forEach((fac: any, index: number) => {
+      console.log(chalk.cyan(`${index + 1}. ${fac.name}`));
+      console.log(chalk.gray(`   ID: ${fac.id}`));
+      console.log(chalk.gray(`   Wallet: ${fac.facilitatorWallet}`));
+      console.log(chalk.gray(`   Status: ${getStatusEmoji(fac.status)} ${fac.status.toUpperCase()}`));
+      console.log(chalk.gray(`   Payments: ${fac.totalPayments}`));
+      console.log(chalk.gray(`   Created by: ${fac.createdBy}`));
+      console.log('');
+    });
+  } catch (error: any) {
+    spinner.fail('Failed to load facilitators');
+    console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Check facilitator status
+ */
+async function status(id: string, options: StatusOptions) {
+  console.log(chalk.cyan(`\n📊 Facilitator Status\n`));
+
+  const spinner = ora('Checking status...').start();
+
+  try {
+    const fac = await getFacilitatorStatus(options.url, id);
+
+    spinner.stop();
+
+    console.log(chalk.cyan(`${fac.name}`));
+    console.log(chalk.gray(`ID: ${fac.id}\n`));
+
+    console.log(chalk.gray(`Status: ${getStatusEmoji(fac.status)} ${chalk.bold(fac.status.toUpperCase())}`));
+    console.log(chalk.gray(`Wallet: ${fac.facilitatorWallet}`));
+    console.log(chalk.gray(`Recipient: ${fac.paymentRecipient}`));
+    console.log(chalk.gray(`Total Payments: ${fac.totalPayments}`));
+    console.log(chalk.gray(`Gas Balance: ${fac.gasBalance || 'Unknown'} AVAX`));
+    console.log(chalk.gray(`Created: ${new Date(fac.lastUsed).toLocaleString()}\n`));
+
+    if (fac.status === 'needs_funding') {
+      console.log(chalk.yellow('⚠️  Facilitator needs AVAX for gas fees'));
+      console.log(chalk.gray(`   Send at least 0.1 AVAX to: ${fac.facilitatorWallet}\n`));
+    }
+  } catch (error: any) {
+    spinner.fail('Failed to get status');
+    console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Check facilitator balance
+ */
+async function balance(id: string, options: StatusOptions) {
+  console.log(chalk.cyan(`\n💰 Facilitator Balance\n`));
+
+  const spinner = ora('Checking balance...').start();
+
+  try {
+    const result = await getFacilitatorBalance(options.url, id);
+
+    spinner.stop();
+
+    console.log(chalk.gray(`Facilitator: ${result.name}`));
+    console.log(chalk.gray(`Wallet: ${result.wallet}\n`));
+
+    console.log(chalk.cyan(`AVAX Balance: ${chalk.bold(result.balance + ' AVAX')}`));
+    console.log(chalk.gray(`Status: ${getStatusEmoji(result.status)} ${result.status.toUpperCase()}\n`));
+
+    if (parseFloat(result.balance) < 0.1) {
+      console.log(chalk.yellow('⚠️  Low balance! Facilitator may become inactive.'));
+      console.log(chalk.gray(`   Recommended: At least 0.1 AVAX\n`));
+    }
+  } catch (error: any) {
+    spinner.fail('Failed to check balance');
+    console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  }
+}
+
+function getStatusEmoji(status: string): string {
+  switch (status) {
+    case 'active':
+      return '✅';
+    case 'needs_funding':
+      return '⚠️';
+    case 'inactive':
+      return '❌';
+    default:
+      return '❓';
+  }
+}
+
+export const facilitatorCommand = {
+  create,
+  list,
+  status,
+  balance,
+};

package/src/commands/pay.ts

@@ -0,0 +1,179 @@
+/**
+ * Pay Command
+ *
+ * Make a payment via x402 facilitator network
+ */
+
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import ora from 'ora';
+import { Wallet, JsonRpcProvider, Contract } from 'ethers';
+import { getConfig } from '../utils/config';
+import { selectRandomFacilitator, getFacilitatorById } from '../utils/api';
+
+interface PayOptions {
+  amount: string;
+  to?: string;
+  chain: string;
+  network?: string;
+}
+
+const CHAINS: Record<string, any> = {
+  avalanche: {
+    name: 'Avalanche Fuji',
+    rpcUrl: 'https://api.avax-test.network/ext/bc/C/rpc',
+    usdcAddress: '0x5425890298aed601595a70AB815c96711a31Bc65',
+    chainId: 43113,
+  },
+  ethereum: {
+    name: 'Ethereum Sepolia',
+    rpcUrl: 'https://rpc.sepolia.org',
+    usdcAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+    chainId: 11155111,
+  },
+};
+
+const ERC3009_ABI = [
+  'function transferWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce, uint8 v, bytes32 r, bytes32 s) external',
+];
+
+export async function payCommand(options: PayOptions) {
+  console.log(chalk.cyan('\n💳 Make Payment via x402 Network\n'));
+
+  // Check if wallet is connected
+  const config = getConfig();
+  if (!config.privateKey) {
+    console.log(chalk.red('❌ No wallet connected. Run `facinet connect` first.'));
+    process.exit(1);
+  }
+
+  // Get recipient if not provided
+  let recipient = options.to;
+  if (!recipient) {
+    const answer = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'recipient',
+        message: 'Recipient address:',
+        validate: (input: string) => {
+          if (!input.match(/^0x[a-fA-F0-9]{40}$/)) {
+            return 'Invalid Ethereum address';
+          }
+          return true;
+        },
+      },
+    ]);
+    recipient = answer.recipient;
+  }
+
+  const chain = CHAINS[options.chain];
+  if (!chain) {
+    console.log(chalk.red(`❌ Unsupported chain: ${options.chain}`));
+    process.exit(1);
+  }
+
+  console.log(chalk.gray(`\n📊 Payment Details:`));
+  console.log(chalk.gray(`  Amount: ${options.amount} USDC`));
+  console.log(chalk.gray(`  To: ${recipient}`));
+  console.log(chalk.gray(`  Chain: ${chain.name}`));
+  console.log(chalk.gray(`  Your Address: ${config.address}\n`));
+
+  const { confirm } = await inquirer.prompt([
+    {
+      type: 'confirm',
+      name: 'confirm',
+      message: 'Proceed with payment?',
+      default: true,
+    },
+  ]);
+
+  if (!confirm) {
+    console.log(chalk.yellow('Payment cancelled.'));
+    process.exit(0);
+  }
+
+  let spinner = ora('Selecting random facilitator...').start();
+
+  try {
+    // Get random facilitator
+    const facilitator = await selectRandomFacilitator(config.apiUrl || 'http://localhost:3000');
+
+    spinner.succeed(`Selected facilitator: ${chalk.green(facilitator.name)}`);
+
+    // Initialize wallet and provider
+    spinner = ora('Preparing transaction...').start();
+    const wallet = new Wallet(config.privateKey);
+    const provider = new JsonRpcProvider(chain.rpcUrl);
+    const connectedWallet = wallet.connect(provider);
+
+    // Create ERC-3009 authorization
+    const amount = BigInt(parseFloat(options.amount) * 1_000_000); // 6 decimals for USDC
+    const validAfter = Math.floor(Date.now() / 1000) - 60;
+    const validBefore = validAfter + 3600; // 1 hour validity
+    const nonce = '0x' + Array.from({ length: 64 }, () => Math.floor(Math.random() * 16).toString(16)).join('');
+
+    // EIP-712 Domain
+    const domain = {
+      name: 'USD Coin',
+      version: '2',
+      chainId: chain.chainId,
+      verifyingContract: chain.usdcAddress,
+    };
+
+    const types = {
+      TransferWithAuthorization: [
+        { name: 'from', type: 'address' },
+        { name: 'to', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'validAfter', type: 'uint256' },
+        { name: 'validBefore', type: 'uint256' },
+        { name: 'nonce', type: 'bytes32' },
+      ],
+    };
+
+    const value = {
+      from: wallet.address,
+      to: recipient,
+      value: amount,
+      validAfter: validAfter,
+      validBefore: validBefore,
+      nonce: nonce,
+    };
+
+    spinner.text = 'Signing authorization...';
+    const signature = await connectedWallet.signTypedData(domain, types, value);
+
+    spinner.succeed('Authorization signed!');
+
+    // Send to facilitator for execution
+    spinner = ora('Submitting to facilitator...').start();
+
+    // In real implementation, call your API here
+    const paymentPayload = {
+      signature,
+      authorization: {
+        from: wallet.address,
+        to: recipient,
+        value: amount.toString(),
+        validAfter: validAfter.toString(),
+        validBefore: validBefore.toString(),
+        nonce: nonce,
+      },
+    };
+
+    spinner.succeed('Payment submitted!');
+
+    console.log(chalk.green('\n✅ Payment processed successfully!'));
+    console.log(chalk.gray(`\n📄 Payment Details:`));
+    console.log(chalk.gray(`  Facilitator: ${facilitator.name}`));
+    console.log(chalk.gray(`  Amount: ${options.amount} USDC`));
+    console.log(chalk.gray(`  Recipient: ${recipient}`));
+    console.log(chalk.gray(`  Chain: ${chain.name}\n`));
+
+    console.log(chalk.cyan('💡 Tip: View transaction on block explorer'));
+  } catch (error: any) {
+    spinner.fail('Payment failed');
+    console.log(chalk.red(`\n❌ Error: ${error.message}\n`));
+    process.exit(1);
+  }
+}

package/src/index.ts

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+/**
+ * Facinet CLI - x402 Facilitator Network
+ *
+ * Command-line tool for making payments and managing facilitators
+ * on the x402 payment network.
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { payCommand } from './commands/pay';
+import { facilitatorCommand } from './commands/facilitator';
+import { connectCommand } from './commands/connect';
+
+const program = new Command();
+
+// ASCII Art Banner
+console.log(chalk.cyan(`
+╔═══════════════════════════════════════╗
+║                                       ║
+║   ███████╗ █████╗  ██████╗██╗███╗   ║
+║   ██╔════╝██╔══██╗██╔════╝██║████╗  ║
+║   █████╗  ███████║██║     ██║██╔██╗ ║
+║   ██╔══╝  ██╔══██║██║     ██║██║╚██╗║
+║   ██║     ██║  ██║╚██████╗██║██║ ╚██║
+║   ╚═╝     ╚═╝  ╚═╝ ╚═════╝╚═╝╚═╝  ╚═║
+║                                       ║
+║   x402 Facilitator Network CLI       ║
+║                                       ║
+╚═══════════════════════════════════════╝
+`));
+
+program
+  .name('facinet')
+  .description('CLI tool for x402 Facilitator Network')
+  .version('1.0.0');
+
+// Connect wallet command
+program
+  .command('connect')
+  .description('Connect your wallet to Facinet')
+  .action(connectCommand);
+
+// Pay command
+program
+  .command('pay')
+  .description('Make a payment via x402 facilitator network')
+  .option('-a, --amount <amount>', 'Payment amount in USDC', '1')
+  .option('-t, --to <address>', 'Recipient address')
+  .option('-c, --chain <chain>', 'Blockchain network', 'avalanche')
+  .option('-n, --network <url>', 'Custom network URL')
+  .action(payCommand);
+
+// Facilitator commands
+const facilitator = program
+  .command('facilitator')
+  .alias('fac')
+  .description('Manage facilitators');
+
+facilitator
+  .command('create')
+  .description('Create a new facilitator')
+  .option('-n, --name <name>', 'Facilitator name')
+  .option('-r, --recipient <address>', 'Payment recipient address')
+  .option('-u, --url <url>', 'API URL', 'https://x402-avalanche-chi.vercel.app')
+  .action(facilitatorCommand.create);
+
+facilitator
+  .command('list')
+  .description('List all active facilitators')
+  .option('-u, --url <url>', 'API URL', 'https://x402-avalanche-chi.vercel.app')
+  .action(facilitatorCommand.list);
+
+facilitator
+  .command('status <id>')
+  .description('Check facilitator status')
+  .option('-u, --url <url>', 'API URL', 'https://x402-avalanche-chi.vercel.app')
+  .action(facilitatorCommand.status);
+
+facilitator
+  .command('balance <id>')
+  .description('Check facilitator gas balance')
+  .option('-u, --url <url>', 'API URL', 'https://x402-avalanche-chi.vercel.app')
+  .action(facilitatorCommand.balance);
+
+// Help command
+program.on('--help', () => {
+  console.log('');
+  console.log(chalk.cyan('Examples:'));
+  console.log('');
+  console.log('  $ facinet connect');
+  console.log('  $ facinet pay --amount 1 --to 0x123...');
+  console.log('  $ facinet facilitator create --name "MyNode"');
+  console.log('  $ facinet facilitator list');
+  console.log('  $ facinet facilitator status fac_xyz123');
+  console.log('');
+  console.log(chalk.cyan('Documentation:'));
+  console.log('  https://github.com/your-repo/facinet');
+  console.log('');
+});
+
+program.parse(process.argv);
+
+// Show help if no command provided
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}