facinet 1.0.0

package/README.md

@@ -0,0 +1,318 @@
+# Facinet CLI
+
+> Command-line tool for the x402 Facilitator Network
+
+Make payments and manage facilitators on the x402 decentralized payment network powered by Avalanche.
+
+## Features
+
+- 💳 **Make Payments** - Pay via x402 using gasless USDC transfers
+- 🎲 **Random Facilitator Selection** - Fair distribution across network
+- 🚀 **Create Facilitators** - Set up your own payment facilitator
+- 📊 **Manage & Monitor** - Check status, balance, and activity
+- 🔐 **Secure** - Local wallet management with encryption
+- ⚡ **Fast** - Built on Avalanche for sub-second finality
+
+## Installation
+
+```bash
+npm install -g facinet
+```
+
+## Quick Start
+
+### 1. Connect Your Wallet
+
+```bash
+facinet connect
+```
+
+Choose to either:
+- Enter your private key (for testing)
+- Generate a new wallet
+
+### 2. Make a Payment
+
+```bash
+facinet pay --amount 1 --to 0xRecipientAddress
+```
+
+The CLI will automatically:
+- Select a random active facilitator
+- Sign the payment authorization
+- Submit to the facilitator network
+- Show transaction details
+
+### 3. List Active Facilitators
+
+```bash
+facinet facilitator list
+```
+
+See all active facilitators in the network with their stats.
+
+### 4. Check Facilitator Status
+
+```bash
+facinet facilitator status fac_xyz123
+```
+
+View detailed information about a specific facilitator.
+
+## Commands
+
+### Connection
+
+#### `facinet connect`
+
+Connect your wallet to Facinet. Options:
+- Enter existing private key
+- Generate new wallet
+
+Config is saved to `~/.facinet/config.json`
+
+---
+
+### Payment Commands
+
+#### `facinet pay`
+
+Make a payment via the x402 facilitator network.
+
+**Options:**
+- `-a, --amount <amount>` - Payment amount in USDC (default: 1)
+- `-t, --to <address>` - Recipient Ethereum address
+- `-c, --chain <chain>` - Blockchain network (default: avalanche)
+- `-n, --network <url>` - Custom API URL
+
+**Examples:**
+
+```bash
+# Pay 1 USDC to recipient
+facinet pay --to 0x123...
+
+# Pay custom amount
+facinet pay --amount 5 --to 0x456...
+
+# Use custom API endpoint
+facinet pay --to 0x789... --network https://my-api.com
+```
+
+---
+
+### Facilitator Commands
+
+#### `facinet facilitator create`
+
+Create a new facilitator (requires 1 USDC registration fee).
+
+**Options:**
+- `-n, --name <name>` - Facilitator name
+- `-r, --recipient <address>` - Payment recipient address
+- `-u, --url <url>` - API URL (default: http://localhost:3000)
+
+**Example:**
+
+```bash
+facinet facilitator create --name "MyNode" --recipient 0xABC...
+```
+
+**Important:** Save the facilitator wallet private key shown after creation!
+
+#### `facinet facilitator list`
+
+List all active facilitators in the network.
+
+**Options:**
+- `-u, --url <url>` - API URL (default: http://localhost:3000)
+
+**Example:**
+
+```bash
+facinet facilitator list
+```
+
+#### `facinet facilitator status <id>`
+
+Check the status of a specific facilitator.
+
+**Arguments:**
+- `<id>` - Facilitator ID (e.g., fac_xyz123)
+
+**Options:**
+- `-u, --url <url>` - API URL
+
+**Example:**
+
+```bash
+facinet facilitator status fac_NdIk4EytdaIYHRK1
+```
+
+#### `facinet facilitator balance <id>`
+
+Check the AVAX gas balance of a facilitator.
+
+**Arguments:**
+- `<id>` - Facilitator ID
+
+**Options:**
+- `-u, --url <url>` - API URL
+
+**Example:**
+
+```bash
+facinet facilitator balance fac_NdIk4EytdaIYHRK1
+```
+
+---
+
+## Configuration
+
+Facinet stores configuration in `~/.facinet/config.json`:
+
+```json
+{
+  "privateKey": "0x...",
+  "address": "0x...",
+  "network": "avalanche-fuji",
+  "apiUrl": "http://localhost:3000"
+}
+```
+
+## Supported Networks
+
+- **Avalanche** (Fuji Testnet) - Default
+- **Ethereum** (Sepolia Testnet)
+- More chains coming soon
+
+## How It Works
+
+1. **Random Selection** - CLI picks a random active facilitator from the network
+2. **Sign Authorization** - You sign an ERC-3009 payment authorization (gasless for you!)
+3. **Facilitator Executes** - The facilitator submits the transaction and pays gas
+4. **Payment Complete** - USDC transferred on-chain, access granted
+
+## Development
+
+### Build from Source
+
+```bash
+# Clone repository
+git clone https://github.com/your-repo/x402.git
+cd x402/packages/facinet
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link for local testing
+npm link
+
+# Test commands
+facinet --help
+```
+
+### Project Structure
+
+```
+facinet/
+├── src/
+│   ├── commands/
+│   │   ├── connect.ts    # Wallet connection
+│   │   ├── pay.ts        # Payment processing
+│   │   └── facilitator.ts # Facilitator management
+│   ├── utils/
+│   │   ├── config.ts     # Configuration management
+│   │   └── api.ts        # API client
+│   └── index.ts          # CLI entry point
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## Security
+
+- **Private keys** are stored encrypted in `~/.facinet/config.json`
+- **Never share** your private key or config file
+- **Use test wallets** for testnet development
+- **Backup** your private keys securely
+
+## Troubleshooting
+
+### "No wallet connected"
+
+Run `facinet connect` first to set up your wallet.
+
+### "No active facilitators available"
+
+The network has no active facilitators. Create one with:
+```bash
+facinet facilitator create
+```
+
+### "Insufficient USDC"
+
+You need USDC in your wallet. On testnet:
+1. Get AVAX from faucet
+2. Swap AVAX → USDC
+
+### API connection errors
+
+Check that your API URL is correct:
+```bash
+facinet pay --network https://your-api-url.com
+```
+
+## Examples
+
+### Complete Payment Flow
+
+```bash
+# 1. Connect wallet
+facinet connect
+
+# 2. List available facilitators
+facinet facilitator list
+
+# 3. Make payment
+facinet pay --amount 1 --to 0x1234567890123456789012345678901234567890
+
+# Output:
+# ✅ Payment processed successfully!
+# Facilitator: Xavier
+# Amount: 1 USDC
+# Recipient: 0x123...
+```
+
+### Create and Monitor Facilitator
+
+```bash
+# 1. Create facilitator
+facinet facilitator create --name "MyNode"
+
+# 2. Fund with AVAX (send to facilitator wallet address)
+# ...
+
+# 3. Check status
+facinet facilitator status fac_abc123
+
+# 4. Monitor balance
+facinet facilitator balance fac_abc123
+```
+
+## Resources
+
+- [x402 Protocol](https://github.com/x402-rs/x402-rs)
+- [Documentation](https://docs.x402.network)
+- [Avalanche Docs](https://docs.avax.network/)
+- [Report Issues](https://github.com/your-repo/x402/issues)
+
+## License
+
+MIT © x402 Team
+
+---
+
+**Built with x402 on Avalanche** ⚡

package/dist/commands/connect.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Connect Command
+ *
+ * Connect wallet to Facinet CLI
+ */
+export declare function connectCommand(): Promise<void>;
+//# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,wBAAsB,cAAc,kBAuEnC"}

package/dist/commands/connect.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Connect Command
+ *
+ * Connect wallet to Facinet CLI
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connectCommand = connectCommand;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ethers_1 = require("ethers");
+const config_1 = require("../utils/config");
+const ora_1 = __importDefault(require("ora"));
+async function connectCommand() {
+    console.log(chalk_1.default.cyan('\n🔗 Connect Wallet to Facinet\n'));
+    const { method } = await inquirer_1.default.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_1.default.prompt([
+            {
+                type: 'password',
+                name: 'privateKey',
+                message: 'Enter your private key:',
+                mask: '*',
+            },
+        ]);
+        try {
+            const wallet = new ethers_1.Wallet(privateKey);
+            (0, config_1.saveConfig)({ privateKey, address: wallet.address });
+            console.log(chalk_1.default.green('\n✅ Wallet connected successfully!'));
+            console.log(chalk_1.default.gray(`Address: ${wallet.address}`));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red('\n❌ Invalid private key'));
+            process.exit(1);
+        }
+    }
+    else {
+        const spinner = (0, ora_1.default)('Generating new wallet...').start();
+        const wallet = ethers_1.Wallet.createRandom();
+        spinner.succeed('Wallet generated!');
+        console.log(chalk_1.default.green('\n✅ New wallet created!'));
+        console.log(chalk_1.default.yellow('\n⚠️  IMPORTANT: Save your private key securely!'));
+        console.log(chalk_1.default.gray(`\nAddress: ${wallet.address}`));
+        console.log(chalk_1.default.gray(`Private Key: ${wallet.privateKey}`));
+        console.log(chalk_1.default.gray(`Mnemonic: ${wallet.mnemonic?.phrase}\n`));
+        const { confirm } = await inquirer_1.default.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: 'Have you saved your private key?',
+                default: false,
+            },
+        ]);
+        if (!confirm) {
+            console.log(chalk_1.default.red('\nPlease save your private key before continuing.'));
+            process.exit(0);
+        }
+        (0, config_1.saveConfig)({ privateKey: wallet.privateKey, address: wallet.address });
+        console.log(chalk_1.default.green('✅ Configuration saved!'));
+    }
+    // Check network
+    const config = (0, config_1.getConfig)();
+    console.log(chalk_1.default.cyan('\n📡 Network Configuration:'));
+    console.log(chalk_1.default.gray(`Network: ${config.network || 'avalanche-fuji'}`));
+    console.log(chalk_1.default.gray(`API URL: ${config.apiUrl || 'http://localhost:3000'}\n`));
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

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

package/dist/commands/facilitator.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Facilitator Commands
+ *
+ * Create and manage facilitators
+ */
+interface CreateOptions {
+    name?: string;
+    recipient?: string;
+    url: string;
+}
+interface ListOptions {
+    url: string;
+}
+interface StatusOptions {
+    url: string;
+}
+/**
+ * Create a new facilitator
+ */
+declare function create(options: CreateOptions): Promise<void>;
+/**
+ * List all facilitators
+ */
+declare function list(options: ListOptions): Promise<void>;
+/**
+ * Check facilitator status
+ */
+declare function status(id: string, options: StatusOptions): Promise<void>;
+/**
+ * Check facilitator balance
+ */
+declare function balance(id: string, options: StatusOptions): Promise<void>;
+export declare const facilitatorCommand: {
+    create: typeof create;
+    list: typeof list;
+    status: typeof status;
+    balance: typeof balance;
+};
+export {};
+//# sourceMappingURL=facilitator.d.ts.map

package/dist/commands/facilitator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facilitator.d.ts","sourceRoot":"","sources":["../../src/commands/facilitator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,WAAW;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,aAAa;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,iBAAe,MAAM,CAAC,OAAO,EAAE,aAAa,iBAoG3C;AAED;;GAEG;AACH,iBAAe,IAAI,CAAC,OAAO,EAAE,WAAW,iBA+BvC;AAED;;GAEG;AACH,iBAAe,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,iBA6BvD;AAED;;GAEG;AACH,iBAAe,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,iBAyBxD;AAeD,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC"}

package/dist/commands/facilitator.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * Facilitator Commands
+ *
+ * Create and manage facilitators
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.facilitatorCommand = void 0;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const ethers_1 = require("ethers");
+const config_1 = require("../utils/config");
+const api_1 = require("../utils/api");
+/**
+ * Create a new facilitator
+ */
+async function create(options) {
+    console.log(chalk_1.default.cyan('\n🚀 Create New Facilitator\n'));
+    // Check if wallet is connected
+    const config = (0, config_1.getConfig)();
+    if (!config.privateKey) {
+        console.log(chalk_1.default.red('❌ No wallet connected. Run `facinet connect` first.'));
+        process.exit(1);
+    }
+    // Get facilitator details
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'name',
+            message: 'Facilitator name:',
+            when: !options.name,
+            validate: (input) => {
+                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) => {
+                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_1.default.gray(`\n📋 Facilitator Details:`));
+    console.log(chalk_1.default.gray(`  Name: ${name}`));
+    console.log(chalk_1.default.gray(`  Recipient: ${recipient}`));
+    console.log(chalk_1.default.gray(`  Creator: ${config.address}\n`));
+    const { confirm } = await inquirer_1.default.prompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: 'Create facilitator? (Requires 1 USDC registration fee)',
+            default: true,
+        },
+    ]);
+    if (!confirm) {
+        console.log(chalk_1.default.yellow('Cancelled.'));
+        process.exit(0);
+    }
+    const spinner = (0, ora_1.default)('Creating facilitator...').start();
+    try {
+        const wallet = new ethers_1.Wallet(config.privateKey);
+        // Generate facilitator wallet
+        const facilitatorWallet = ethers_1.Wallet.createRandom();
+        spinner.text = 'Registering facilitator...';
+        const result = await (0, api_1.createFacilitator)(options.url, {
+            name,
+            facilitatorWallet: facilitatorWallet.address,
+            facilitatorPrivateKey: facilitatorWallet.privateKey,
+            paymentRecipient: recipient,
+            createdBy: wallet.address,
+        });
+        spinner.succeed('Facilitator created!');
+        console.log(chalk_1.default.green('\n✅ Facilitator created successfully!'));
+        console.log(chalk_1.default.gray(`\n📄 Details:`));
+        console.log(chalk_1.default.gray(`  ID: ${result.id}`));
+        console.log(chalk_1.default.gray(`  Name: ${name}`));
+        console.log(chalk_1.default.gray(`  Wallet: ${facilitatorWallet.address}`));
+        console.log(chalk_1.default.gray(`  Status: ${result.status}`));
+        console.log(chalk_1.default.yellow(`\n⚠️  IMPORTANT: Save facilitator wallet private key!`));
+        console.log(chalk_1.default.gray(`  Private Key: ${facilitatorWallet.privateKey}\n`));
+        console.log(chalk_1.default.cyan('💡 Next steps:'));
+        console.log(chalk_1.default.gray(`  1. Fund facilitator wallet with AVAX for gas`));
+        console.log(chalk_1.default.gray(`  2. Check status: facinet facilitator status ${result.id}`));
+        console.log(chalk_1.default.gray(`  3. Monitor balance: facinet facilitator balance ${result.id}\n`));
+    }
+    catch (error) {
+        spinner.fail('Failed to create facilitator');
+        console.log(chalk_1.default.red(`\n❌ Error: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * List all facilitators
+ */
+async function list(options) {
+    console.log(chalk_1.default.cyan('\n📋 Active Facilitators\n'));
+    const spinner = (0, ora_1.default)('Loading facilitators...').start();
+    try {
+        const facilitators = await (0, api_1.listFacilitators)(options.url);
+        spinner.stop();
+        if (facilitators.length === 0) {
+            console.log(chalk_1.default.yellow('No active facilitators found.\n'));
+            return;
+        }
+        console.log(chalk_1.default.gray(`Found ${facilitators.length} active facilitator(s):\n`));
+        facilitators.forEach((fac, index) => {
+            console.log(chalk_1.default.cyan(`${index + 1}. ${fac.name}`));
+            console.log(chalk_1.default.gray(`   ID: ${fac.id}`));
+            console.log(chalk_1.default.gray(`   Wallet: ${fac.facilitatorWallet}`));
+            console.log(chalk_1.default.gray(`   Status: ${getStatusEmoji(fac.status)} ${fac.status.toUpperCase()}`));
+            console.log(chalk_1.default.gray(`   Payments: ${fac.totalPayments}`));
+            console.log(chalk_1.default.gray(`   Created by: ${fac.createdBy}`));
+            console.log('');
+        });
+    }
+    catch (error) {
+        spinner.fail('Failed to load facilitators');
+        console.log(chalk_1.default.red(`\n❌ Error: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Check facilitator status
+ */
+async function status(id, options) {
+    console.log(chalk_1.default.cyan(`\n📊 Facilitator Status\n`));
+    const spinner = (0, ora_1.default)('Checking status...').start();
+    try {
+        const fac = await (0, api_1.getFacilitatorStatus)(options.url, id);
+        spinner.stop();
+        console.log(chalk_1.default.cyan(`${fac.name}`));
+        console.log(chalk_1.default.gray(`ID: ${fac.id}\n`));
+        console.log(chalk_1.default.gray(`Status: ${getStatusEmoji(fac.status)} ${chalk_1.default.bold(fac.status.toUpperCase())}`));
+        console.log(chalk_1.default.gray(`Wallet: ${fac.facilitatorWallet}`));
+        console.log(chalk_1.default.gray(`Recipient: ${fac.paymentRecipient}`));
+        console.log(chalk_1.default.gray(`Total Payments: ${fac.totalPayments}`));
+        console.log(chalk_1.default.gray(`Gas Balance: ${fac.gasBalance || 'Unknown'} AVAX`));
+        console.log(chalk_1.default.gray(`Created: ${new Date(fac.lastUsed).toLocaleString()}\n`));
+        if (fac.status === 'needs_funding') {
+            console.log(chalk_1.default.yellow('⚠️  Facilitator needs AVAX for gas fees'));
+            console.log(chalk_1.default.gray(`   Send at least 0.1 AVAX to: ${fac.facilitatorWallet}\n`));
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to get status');
+        console.log(chalk_1.default.red(`\n❌ Error: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+/**
+ * Check facilitator balance
+ */
+async function balance(id, options) {
+    console.log(chalk_1.default.cyan(`\n💰 Facilitator Balance\n`));
+    const spinner = (0, ora_1.default)('Checking balance...').start();
+    try {
+        const result = await (0, api_1.getFacilitatorBalance)(options.url, id);
+        spinner.stop();
+        console.log(chalk_1.default.gray(`Facilitator: ${result.name}`));
+        console.log(chalk_1.default.gray(`Wallet: ${result.wallet}\n`));
+        console.log(chalk_1.default.cyan(`AVAX Balance: ${chalk_1.default.bold(result.balance + ' AVAX')}`));
+        console.log(chalk_1.default.gray(`Status: ${getStatusEmoji(result.status)} ${result.status.toUpperCase()}\n`));
+        if (parseFloat(result.balance) < 0.1) {
+            console.log(chalk_1.default.yellow('⚠️  Low balance! Facilitator may become inactive.'));
+            console.log(chalk_1.default.gray(`   Recommended: At least 0.1 AVAX\n`));
+        }
+    }
+    catch (error) {
+        spinner.fail('Failed to check balance');
+        console.log(chalk_1.default.red(`\n❌ Error: ${error.message}\n`));
+        process.exit(1);
+    }
+}
+function getStatusEmoji(status) {
+    switch (status) {
+        case 'active':
+            return '✅';
+        case 'needs_funding':
+            return '⚠️';
+        case 'inactive':
+            return '❌';
+        default:
+            return '❓';
+    }
+}
+exports.facilitatorCommand = {
+    create,
+    list,
+    status,
+    balance,
+};
+//# sourceMappingURL=facilitator.js.map

package/dist/commands/facilitator.js.map

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