facinet 1.0.0 → 2.0.0

package/README.md

@@ -1,25 +1,193 @@
-# Facinet CLI
+# Facinet
 
-> Command-line tool for the x402 Facilitator Network
+> JavaScript SDK and CLI tool for the x402 Facilitator Network
 
-Make payments and manage facilitators on the x402 decentralized payment network powered by Avalanche.
+Make gasless USDC payments and manage facilitators on the x402 decentralized payment network powered by Avalanche.
 
 ## Features
 
-- 💳 **Make Payments** - Pay via x402 using gasless USDC transfers
+- 💳 **Make Payments** - Gasless USDC transfers via ERC-3009
 - 🎲 **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
+- 🌐 **Multi-Platform** - Works in browser (MetaMask) and Node.js
+- 🚀 **Easy Integration** - Simple SDK for developers
+- 📊 **CLI Tool** - Command-line interface for payments and management
+- 🔐 **Secure** - Wallet management with encryption
 - ⚡ **Fast** - Built on Avalanche for sub-second finality
 
 ## Installation
 
+### As a Library (SDK)
+
+```bash
+npm install facinet
+```
+
+### As a CLI Tool
+
 ```bash
 npm install -g facinet
 ```
 
-## Quick Start
+## SDK Usage
+
+### Browser (with MetaMask)
+
+```typescript
+import { Facinet } from 'facinet';
+
+// Initialize SDK
+const facinet = new Facinet({
+  network: 'avalanche', // or 'ethereum', 'polygon'
+});
+
+// Make a payment (MetaMask will prompt for signature)
+const result = await facinet.pay({
+  amount: '1',                              // Amount in USDC
+  recipient: '0xYourMerchantAddress',       // Where you want to receive payment
+});
+
+console.log('Payment successful!', result.txHash);
+console.log('Processed by:', result.facilitator.name);
+```
+
+### Node.js (with Private Key)
+
+```typescript
+import { Facinet } from 'facinet';
+
+// Initialize with private key
+const facinet = new Facinet({
+  privateKey: process.env.PRIVATE_KEY,
+  network: 'avalanche',
+});
+
+// Make a payment
+const result = await facinet.pay({
+  amount: '5',
+  recipient: '0xYourMerchantAddress',
+});
+
+console.log('Transaction:', result.txHash);
+```
+
+### Quick One-Liner
+
+```typescript
+import { Facinet } from 'facinet';
+
+// Quick payment without creating instance
+await Facinet.quickPay({
+  amount: '1',
+  recipient: '0xMerchantAddress',
+  privateKey: process.env.PRIVATE_KEY,
+});
+```
+
+### Get Available Facilitators
+
+```typescript
+const facinet = new Facinet();
+
+// Get all active facilitators
+const facilitators = await facinet.getFacilitators();
+console.log(`${facilitators.length} active facilitators`);
+
+// Get a random facilitator
+const randomFacilitator = await facinet.selectRandomFacilitator();
+console.log('Selected:', randomFacilitator.name);
+```
+
+### SDK Configuration Options
+
+```typescript
+interface FacinetConfig {
+  apiUrl?: string;       // Default: 'https://x402-avalanche-chi.vercel.app'
+  privateKey?: string;   // For Node.js (not needed in browser)
+  network?: 'avalanche' | 'ethereum' | 'polygon';  // Default: 'avalanche'
+  rpcUrl?: string;       // Custom RPC URL (optional)
+}
+```
+
+### TypeScript Support
+
+Facinet is written in TypeScript and includes full type definitions:
+
+```typescript
+import type {
+  FacinetConfig,
+  PaymentParams,
+  PaymentResult,
+  Facilitator
+} from 'facinet';
+
+const config: FacinetConfig = {
+  network: 'avalanche',
+};
+
+const params: PaymentParams = {
+  amount: '1',
+  recipient: '0x...',
+};
+```
+
+### React Example
+
+```tsx
+import { useState } from 'react';
+import { Facinet } from 'facinet';
+
+function PaymentButton() {
+  const [loading, setLoading] = useState(false);
+  const [txHash, setTxHash] = useState('');
+
+  const handlePayment = async () => {
+    setLoading(true);
+    try {
+      const facinet = new Facinet({ network: 'avalanche' });
+
+      const result = await facinet.pay({
+        amount: '1',
+        recipient: '0xYourMerchantAddress',
+      });
+
+      setTxHash(result.txHash);
+      alert('Payment successful!');
+    } catch (error) {
+      console.error('Payment failed:', error);
+      alert('Payment failed');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div>
+      <button onClick={handlePayment} disabled={loading}>
+        {loading ? 'Processing...' : 'Pay 1 USDC'}
+      </button>
+      {txHash && (
+        <p>Transaction: <a href={`https://testnet.snowtrace.io/tx/${txHash}`} target="_blank">
+          {txHash.slice(0, 10)}...
+        </a></p>
+      )}
+    </div>
+  );
+}
+```
+
+### How SDK Payments Work
+
+1. **Initialize SDK** - Create Facinet instance with your config
+2. **Random Facilitator** - SDK automatically picks random active facilitator
+3. **Sign Authorization** - User signs ERC-3009 authorization (gasless!)
+4. **Facilitator Executes** - Facilitator submits transaction and pays gas
+5. **Payment Complete** - USDC transferred to YOUR merchant address
+
+**Key Point:** The `recipient` you specify in `pay()` is where YOU receive payment. The SDK automatically handles facilitator selection and gas payment.
+
+## CLI Usage
+
+### Quick Start
 
 ### 1. Connect Your Wallet
 
@@ -219,6 +387,9 @@ facinet --help
 ```
 facinet/
 ├── src/
+│   ├── sdk/
+│   │   ├── Facinet.ts    # Main SDK class
+│   │   └── types.ts      # TypeScript types
 │   ├── commands/
 │   │   ├── connect.ts    # Wallet connection
 │   │   ├── pay.ts        # Payment processing
@@ -226,7 +397,9 @@ facinet/
 │   ├── utils/
 │   │   ├── config.ts     # Configuration management
 │   │   └── api.ts        # API client
+│   ├── sdk.ts            # SDK exports
 │   └── index.ts          # CLI entry point
+├── dist/                 # Compiled JavaScript
 ├── package.json
 ├── tsconfig.json
 └── README.md

package/dist/commands/pay.js

@@ -83,7 +83,7 @@ async function payCommand(options) {
     let spinner = (0, ora_1.default)('Selecting random facilitator...').start();
     try {
         // Get random facilitator
-        const facilitator = await (0, api_1.selectRandomFacilitator)(config.apiUrl || 'http://localhost:3000');
+        const facilitator = await (0, api_1.selectRandomFacilitator)(config.apiUrl || options.network || 'https://x402-avalanche-chi.vercel.app');
         spinner.succeed(`Selected facilitator: ${chalk_1.default.green(facilitator.name)}`);
         // Initialize wallet and provider
         spinner = (0, ora_1.default)('Preparing transaction...').start();

package/dist/commands/pay.js.map

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

package/dist/sdk/Facinet.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Facinet SDK - Main Class
+ *
+ * JavaScript/TypeScript SDK for integrating x402 payments
+ */
+import type { FacinetConfig, PaymentParams, PaymentResult, Facilitator } from './types';
+export declare class Facinet {
+    private config;
+    private chain;
+    private wallet?;
+    constructor(config?: FacinetConfig);
+    /**
+     * Make a payment via x402 facilitator network
+     *
+     * @example
+     * ```typescript
+     * const facinet = new Facinet();
+     * const result = await facinet.pay({
+     *   amount: '1',
+     *   recipient: '0xMerchantAddress',
+     *   payerAddress: '0xCustomerAddress'
+     * });
+     * console.log('Payment successful!', result.txHash);
+     * ```
+     */
+    pay(params: PaymentParams): Promise<PaymentResult>;
+    /**
+     * Get all active facilitators
+     */
+    getFacilitators(): Promise<Facilitator[]>;
+    /**
+     * Select a random active facilitator
+     */
+    selectRandomFacilitator(): Promise<Facilitator>;
+    /**
+     * Quick payment helper (static method)
+     *
+     * @example
+     * ```typescript
+     * await Facinet.quickPay({
+     *   amount: '1',
+     *   recipient: '0xMerchantAddress',
+     *   privateKey: process.env.PRIVATE_KEY
+     * });
+     * ```
+     */
+    static quickPay(params: PaymentParams & {
+        privateKey?: string;
+    }): Promise<PaymentResult>;
+}
+//# sourceMappingURL=Facinet.d.ts.map

package/dist/sdk/Facinet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Facinet.d.ts","sourceRoot":"","sources":["../../src/sdk/Facinet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EAEZ,MAAM,SAAS,CAAC;AAiCjB,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,GAAE,aAAkB;IAsBtC;;;;;;;;;;;;;OAaG;IACG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAyIxD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAc/C;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IAWrD;;;;;;;;;;;OAWG;WACU,QAAQ,CACnB,MAAM,EAAE,aAAa,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,aAAa,CAAC;CAW1B"}

package/dist/sdk/Facinet.js

@@ -0,0 +1,239 @@
+"use strict";
+/**
+ * Facinet SDK - Main Class
+ *
+ * JavaScript/TypeScript SDK for integrating x402 payments
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Facinet = void 0;
+const axios_1 = __importDefault(require("axios"));
+const ethers_1 = require("ethers");
+const CHAINS = {
+    avalanche: {
+        name: 'Avalanche Fuji',
+        chainId: 43113,
+        rpcUrl: 'https://api.avax-test.network/ext/bc/C/rpc',
+        usdcAddress: '0x5425890298aed601595a70AB815c96711a31Bc65',
+        gasToken: 'AVAX',
+        blockExplorer: 'https://testnet.snowtrace.io',
+    },
+    ethereum: {
+        name: 'Ethereum Sepolia',
+        chainId: 11155111,
+        rpcUrl: 'https://rpc.sepolia.org',
+        usdcAddress: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+        gasToken: 'ETH',
+        blockExplorer: 'https://sepolia.etherscan.io',
+    },
+    polygon: {
+        name: 'Polygon Mumbai',
+        chainId: 80001,
+        rpcUrl: 'https://rpc-mumbai.maticvigil.com',
+        usdcAddress: '0x9999f7Fea5938fD3b1E26A12c3f2fb024e194f97',
+        gasToken: 'MATIC',
+        blockExplorer: 'https://mumbai.polygonscan.com',
+    },
+};
+const ERC3009_ABI = [
+    'function transferWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce, uint8 v, bytes32 r, bytes32 s) external',
+];
+class Facinet {
+    constructor(config = {}) {
+        this.config = {
+            apiUrl: config.apiUrl || 'https://x402-avalanche-chi.vercel.app',
+            privateKey: config.privateKey || '',
+            network: config.network || 'avalanche',
+            rpcUrl: config.rpcUrl || '',
+        };
+        this.chain = CHAINS[this.config.network];
+        if (!this.chain) {
+            throw new Error(`Unsupported network: ${this.config.network}`);
+        }
+        // Initialize wallet if private key provided (Node.js)
+        if (this.config.privateKey) {
+            const provider = new ethers_1.JsonRpcProvider(this.config.rpcUrl || this.chain.rpcUrl);
+            this.wallet = new ethers_1.Wallet(this.config.privateKey, provider);
+        }
+    }
+    /**
+     * Make a payment via x402 facilitator network
+     *
+     * @example
+     * ```typescript
+     * const facinet = new Facinet();
+     * const result = await facinet.pay({
+     *   amount: '1',
+     *   recipient: '0xMerchantAddress',
+     *   payerAddress: '0xCustomerAddress'
+     * });
+     * console.log('Payment successful!', result.txHash);
+     * ```
+     */
+    async pay(params) {
+        // Validate parameters
+        if (!params.amount || parseFloat(params.amount) <= 0) {
+            throw new Error('Invalid amount');
+        }
+        if (!params.recipient.match(/^0x[a-fA-F0-9]{40}$/)) {
+            throw new Error('Invalid recipient address');
+        }
+        // Get payer address
+        let payerAddress = params.payerAddress || '';
+        if (!payerAddress) {
+            if (this.wallet) {
+                payerAddress = this.wallet.address;
+            }
+            else if (typeof window !== 'undefined' && window.ethereum) {
+                // Browser - get from MetaMask
+                const accounts = await window.ethereum.request({
+                    method: 'eth_requestAccounts',
+                });
+                payerAddress = accounts[0];
+            }
+            else {
+                throw new Error('No payer address provided and no wallet available. Provide payerAddress or privateKey in config.');
+            }
+        }
+        // Select random facilitator
+        const facilitator = await this.selectRandomFacilitator();
+        // Create ERC-3009 authorization
+        const amount = BigInt(parseFloat(params.amount) * 1000000); // 6 decimals
+        const validAfter = Math.floor(Date.now() / 1000) - 60;
+        const validBefore = validAfter + 3600; // 1 hour
+        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: this.chain.chainId,
+            verifyingContract: this.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: payerAddress,
+            to: params.recipient, // Payment goes to merchant's address!
+            value: amount,
+            validAfter: validAfter,
+            validBefore: validBefore,
+            nonce: nonce,
+        };
+        // Sign authorization
+        let signature;
+        if (this.wallet) {
+            // Node.js - sign with wallet
+            signature = await this.wallet.signTypedData(domain, types, value);
+        }
+        else if (typeof window !== 'undefined' && window.ethereum) {
+            // Browser - sign with MetaMask
+            signature = await window.ethereum.request({
+                method: 'eth_signTypedData_v4',
+                params: [
+                    payerAddress,
+                    JSON.stringify({
+                        domain,
+                        types,
+                        primaryType: 'TransferWithAuthorization',
+                        message: value,
+                    }),
+                ],
+            });
+        }
+        else {
+            throw new Error('No signing method available');
+        }
+        // Submit to facilitator
+        const paymentPayload = {
+            signature,
+            authorization: {
+                from: payerAddress,
+                to: params.recipient,
+                value: amount.toString(),
+                validAfter: validAfter.toString(),
+                validBefore: validBefore.toString(),
+                nonce: nonce,
+            },
+        };
+        const response = await axios_1.default.post(`${this.config.apiUrl}/api/x402/settle-custom`, {
+            facilitatorId: facilitator.id,
+            paymentPayload: {
+                payload: paymentPayload,
+            },
+        });
+        if (!response.data.success) {
+            throw new Error('Payment failed: ' + (response.data.error || 'Unknown error'));
+        }
+        return {
+            success: true,
+            txHash: response.data.txHash,
+            facilitator: {
+                id: facilitator.id,
+                name: facilitator.name,
+                wallet: facilitator.facilitatorWallet,
+            },
+            payment: {
+                from: payerAddress,
+                to: params.recipient,
+                amount: params.amount,
+                network: this.config.network,
+            },
+        };
+    }
+    /**
+     * Get all active facilitators
+     */
+    async getFacilitators() {
+        const response = await axios_1.default.get(`${this.config.apiUrl}/api/facilitator/list`);
+        if (response.data.success) {
+            return response.data.facilitators.filter((f) => f.status === 'active');
+        }
+        return [];
+    }
+    /**
+     * Select a random active facilitator
+     */
+    async selectRandomFacilitator() {
+        const facilitators = await this.getFacilitators();
+        if (facilitators.length === 0) {
+            throw new Error('No active facilitators available');
+        }
+        const randomIndex = Math.floor(Math.random() * facilitators.length);
+        return facilitators[randomIndex];
+    }
+    /**
+     * Quick payment helper (static method)
+     *
+     * @example
+     * ```typescript
+     * await Facinet.quickPay({
+     *   amount: '1',
+     *   recipient: '0xMerchantAddress',
+     *   privateKey: process.env.PRIVATE_KEY
+     * });
+     * ```
+     */
+    static async quickPay(params) {
+        const facinet = new Facinet({
+            privateKey: params.privateKey,
+        });
+        return facinet.pay({
+            amount: params.amount,
+            recipient: params.recipient,
+            payerAddress: params.payerAddress,
+        });
+    }
+}
+exports.Facinet = Facinet;
+//# sourceMappingURL=Facinet.js.map

package/dist/sdk/Facinet.js.map

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

package/dist/sdk/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * SDK Type Definitions
+ */
+export interface FacinetConfig {
+    /**
+     * API URL for x402 facilitator network
+     * @default 'https://x402-avalanche-chi.vercel.app'
+     */
+    apiUrl?: string;
+    /**
+     * Private key for signing transactions (Node.js only)
+     * Not needed for browser - uses window.ethereum
+     */
+    privateKey?: string;
+    /**
+     * Network to use
+     * @default 'avalanche'
+     */
+    network?: 'avalanche' | 'ethereum' | 'polygon';
+    /**
+     * Custom RPC URL (optional)
+     */
+    rpcUrl?: string;
+}
+export interface PaymentParams {
+    /**
+     * Payment amount in USDC
+     * @example '1'
+     */
+    amount: string;
+    /**
+     * Recipient address (where USDC goes)
+     * This is YOUR merchant address
+     */
+    recipient: `0x${string}`;
+    /**
+     * Payer address (customer wallet)
+     * Optional - if not provided, uses connected wallet or privateKey
+     */
+    payerAddress?: `0x${string}`;
+}
+export interface PaymentResult {
+    /**
+     * Whether payment was successful
+     */
+    success: boolean;
+    /**
+     * Transaction hash
+     */
+    txHash: string;
+    /**
+     * Facilitator that processed the payment
+     */
+    facilitator: {
+        id: string;
+        name: string;
+        wallet: string;
+    };
+    /**
+     * Payment details
+     */
+    payment: {
+        from: string;
+        to: string;
+        amount: string;
+        network: string;
+    };
+}
+export interface Facilitator {
+    id: string;
+    name: string;
+    facilitatorWallet: string;
+    paymentRecipient: string;
+    status: 'active' | 'inactive' | 'needs_funding';
+    totalPayments: number;
+    gasBalance?: string;
+}
+export interface ChainConfig {
+    name: string;
+    chainId: number;
+    rpcUrl: string;
+    usdcAddress: `0x${string}`;
+    gasToken: string;
+    blockExplorer: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAE/C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,eAAe,CAAC;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/sdk/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * SDK Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}