facinet 1.0.0 → 2.0.1

package/src/commands/facilitator.ts

@@ -1,256 +0,0 @@
-/**
- * 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

@@ -1,179 +0,0 @@
-/**
- * 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

@@ -1,108 +0,0 @@
-#!/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();
-}

package/src/utils/api.ts

@@ -1,164 +0,0 @@
-/**
- * API Client
- *
- * Interact with x402 backend APIs
- */
-
-import axios from 'axios';
-
-interface FacilitatorCreatePayload {
-  name: string;
-  facilitatorWallet: string;
-  facilitatorPrivateKey: string;
-  paymentRecipient: string;
-  createdBy: string;
-}
-
-/**
- * Get all active facilitators
- */
-export async function listFacilitators(apiUrl: string): Promise<any[]> {
-  try {
-    const response = await axios.get(`${apiUrl}/api/facilitator/list`);
-
-    if (response.data.success) {
-      // Filter only active facilitators
-      return response.data.facilitators.filter((f: any) => f.status === 'active');
-    }
-
-    return [];
-  } catch (error: any) {
-    throw new Error(`Failed to fetch facilitators: ${error.message}`);
-  }
-}
-
-/**
- * Select a random active facilitator
- */
-export async function selectRandomFacilitator(apiUrl: string): Promise<any> {
-  const facilitators = await listFacilitators(apiUrl);
-
-  if (facilitators.length === 0) {
-    throw new Error('No active facilitators available');
-  }
-
-  const randomIndex = Math.floor(Math.random() * facilitators.length);
-  return facilitators[randomIndex];
-}
-
-/**
- * Get facilitator by ID
- */
-export async function getFacilitatorById(apiUrl: string, id: string): Promise<any> {
-  try {
-    const response = await axios.get(`${apiUrl}/api/facilitator/list`);
-
-    if (response.data.success) {
-      const facilitator = response.data.facilitators.find((f: any) => f.id === id);
-      if (!facilitator) {
-        throw new Error('Facilitator not found');
-      }
-      return facilitator;
-    }
-
-    throw new Error('Failed to fetch facilitator');
-  } catch (error: any) {
-    throw new Error(`Failed to get facilitator: ${error.message}`);
-  }
-}
-
-/**
- * Get facilitator status
- */
-export async function getFacilitatorStatus(apiUrl: string, id: string): Promise<any> {
-  return getFacilitatorById(apiUrl, id);
-}
-
-/**
- * Get facilitator balance
- */
-export async function getFacilitatorBalance(apiUrl: string, id: string): Promise<any> {
-  try {
-    const response = await axios.post(`${apiUrl}/api/facilitator/balance`, {
-      facilitatorId: id,
-    });
-
-    if (response.data.success) {
-      return {
-        name: response.data.name,
-        wallet: response.data.wallet,
-        balance: response.data.balance,
-        status: response.data.status,
-      };
-    }
-
-    throw new Error('Failed to fetch balance');
-  } catch (error: any) {
-    throw new Error(`Failed to get balance: ${error.message}`);
-  }
-}
-
-/**
- * Create a new facilitator
- */
-export async function createFacilitator(
-  apiUrl: string,
-  payload: FacilitatorCreatePayload
-): Promise<any> {
-  try {
-    // Note: In real implementation, this would:
-    // 1. Encrypt private key with user password
-    // 2. Call payment API to pay registration fee
-    // 3. Submit facilitator creation request
-
-    // For CLI demo, we'll just show what would happen
-    throw new Error(
-      'Facilitator creation requires payment flow. Please use the web interface at ' + apiUrl
-    );
-
-    // Actual implementation would be:
-    /*
-    const response = await axios.post(`${apiUrl}/api/facilitator/create`, {
-      name: payload.name,
-      encryptedPrivateKey: 'encrypted_key',
-      systemEncryptedKey: 'system_encrypted_key',
-      facilitatorWallet: payload.facilitatorWallet,
-      paymentRecipient: payload.paymentRecipient,
-      createdBy: payload.createdBy,
-      registrationTxHash: 'tx_hash_from_payment',
-    });
-
-    return response.data;
-    */
-  } catch (error: any) {
-    throw new Error(`Failed to create facilitator: ${error.message}`);
-  }
-}
-
-/**
- * Submit payment to facilitator
- */
-export async function submitPayment(
-  apiUrl: string,
-  facilitatorId: string,
-  paymentPayload: any
-): Promise<any> {
-  try {
-    const response = await axios.post(`${apiUrl}/api/x402/settle-custom`, {
-      facilitatorId,
-      paymentPayload,
-    });
-
-    if (response.data.success) {
-      return {
-        txHash: response.data.txHash,
-        facilitatorWallet: response.data.facilitatorWallet,
-        facilitatorName: response.data.facilitatorName,
-      };
-    }
-
-    throw new Error('Payment submission failed');
-  } catch (error: any) {
-    throw new Error(`Failed to submit payment: ${error.message}`);
-  }
-}