pay-lobster 1.0.0

package/dist/x402-client.js

@@ -0,0 +1,350 @@
+"use strict";
+/**
+ * x402 Payment-Enabled HTTP Client
+ *
+ * Wraps fetch() to automatically handle 402 Payment Required responses.
+ * Uses Circle Programmable Wallets to pay and retry with signature.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.X402Client = void 0;
+exports.createX402Fetch = createX402Fetch;
+exports.simpleX402Fetch = simpleX402Fetch;
+const crypto_1 = __importDefault(require("crypto"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Create a payment-enabled fetch wrapper
+ */
+function createX402Fetch(config) {
+    const client = new X402Client(config);
+    return async (url, init) => {
+        return client.fetch(url, init);
+    };
+}
+/**
+ * X402 HTTP Client
+ */
+class X402Client {
+    constructor(config) {
+        // In-memory receipt cache
+        this.receiptCache = new Map();
+        this.wallet = config.wallet;
+        this.walletId = config.walletId;
+        this.maxAutoPayUSDC = config.maxAutoPayUSDC ? parseFloat(config.maxAutoPayUSDC) : undefined;
+        this.requireConfirmation = config.requireConfirmation ?? false;
+        this.cacheReceipts = config.cacheReceipts ?? true;
+        this.cacheDir = config.cacheDir || './data/x402-receipts';
+        this.onPayment = config.onPayment;
+        this.onChallenge = config.onChallenge;
+        this.onVerified = config.onVerified;
+        this.onError = config.onError;
+        // Load cached receipts on init
+        if (this.cacheReceipts) {
+            this.loadReceiptCache().catch(() => {
+                // Ignore cache load errors
+            });
+        }
+    }
+    /**
+     * Main fetch method - handles 402 automatically
+     */
+    async fetch(url, init) {
+        const urlString = this.getUrlString(url);
+        try {
+            // Check for cached receipt
+            const cachedReceipt = this.getCachedReceipt(urlString);
+            if (cachedReceipt) {
+                // Use cached payment signature
+                return this.fetchWithPayment(url, init, cachedReceipt.signature);
+            }
+            // First attempt - no payment
+            const response = await fetch(url, init);
+            // Success or non-402 error - return as-is
+            if (response.status !== 402) {
+                return response;
+            }
+            // 402 Payment Required - handle payment
+            const paymentResponse = await this.handlePaymentRequired(response, urlString, url, init);
+            return paymentResponse;
+        }
+        catch (error) {
+            const err = error;
+            this.onError?.(err, urlString);
+            throw err;
+        }
+    }
+    /**
+     * Handle 402 Payment Required response
+     */
+    async handlePaymentRequired(response, urlString, originalUrl, originalInit) {
+        // Parse payment challenge from response
+        const challenge = await this.parsePaymentChallenge(response);
+        if (!challenge) {
+            throw new Error('Invalid 402 response: missing x-payment-required');
+        }
+        // Trigger challenge hook
+        this.onChallenge?.(challenge);
+        // Check if challenge is expired
+        if (challenge['x-payment-required'].expires < Math.floor(Date.now() / 1000)) {
+            throw new Error('Payment challenge expired');
+        }
+        // Check max auto-pay limit
+        const amount = parseFloat(challenge['x-payment-required'].amount);
+        if (this.maxAutoPayUSDC !== undefined && amount > this.maxAutoPayUSDC) {
+            throw new Error(`Payment amount ${amount} USDC exceeds max auto-pay limit ${this.maxAutoPayUSDC} USDC`);
+        }
+        // Confirm payment if required
+        if (this.requireConfirmation) {
+            const confirmed = await this.confirmPayment(challenge);
+            if (!confirmed) {
+                throw new Error('Payment cancelled by user');
+            }
+        }
+        // Execute payment
+        const txHash = await this.executePayment(challenge);
+        // Trigger payment hook
+        this.onPayment?.(challenge['x-payment-required'].amount, urlString, txHash);
+        // Generate payment signature
+        const signature = this.generatePaymentSignature(challenge, txHash);
+        // Cache receipt
+        const receipt = {
+            url: urlString,
+            challenge: challenge['x-payment-required'],
+            txHash,
+            signature,
+            paidAt: new Date().toISOString(),
+            expiresAt: challenge['x-payment-required'].expires,
+        };
+        await this.cacheReceipt(receipt);
+        this.onVerified?.(receipt);
+        // Retry request with payment signature
+        return this.fetchWithPayment(originalUrl, originalInit, signature);
+    }
+    /**
+     * Execute USDC payment via Circle
+     */
+    async executePayment(challenge) {
+        const { amount, receiver, network } = challenge['x-payment-required'];
+        // Determine wallet to use
+        let walletId = this.walletId;
+        if (!walletId) {
+            // Auto-select wallet for the network
+            const wallets = await this.wallet.listWallets();
+            const wallet = wallets.find(w => w.blockchain === network);
+            if (!wallet) {
+                throw new Error(`No wallet found for network ${network}`);
+            }
+            walletId = wallet.id;
+        }
+        // Send USDC
+        const tx = await this.wallet.sendUSDC({
+            fromWalletId: walletId,
+            toAddress: receiver,
+            amount,
+        });
+        // Wait for transaction to be confirmed
+        // In production, you might want to poll for confirmation
+        // For now, return transaction ID
+        return tx.txHash || tx.id;
+    }
+    /**
+     * Fetch with payment signature header
+     */
+    async fetchWithPayment(url, init, signature) {
+        const headers = new Headers(init?.headers);
+        headers.set('x-payment-signature', signature);
+        return fetch(url, {
+            ...init,
+            headers,
+        });
+    }
+    /**
+     * Parse payment challenge from 402 response
+     */
+    async parsePaymentChallenge(response) {
+        try {
+            const body = await response.json();
+            if (body['x-payment-required']) {
+                return body;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Generate payment signature from challenge and tx hash
+     */
+    generatePaymentSignature(challenge, txHash) {
+        // In production, this would involve the x402 facilitator
+        // For now, create a deterministic signature
+        const data = JSON.stringify({
+            nonce: challenge['x-payment-required'].nonce,
+            amount: challenge['x-payment-required'].amount,
+            receiver: challenge['x-payment-required'].receiver,
+            txHash,
+        });
+        // Simple hash-based signature (production would use proper signing)
+        return crypto_1.default.createHash('sha256').update(data).digest('hex');
+    }
+    /**
+     * Confirm payment with user (if required)
+     */
+    async confirmPayment(challenge) {
+        // In a real implementation, this would prompt the user
+        // For CLI/automated contexts, we can skip confirmation
+        // For UI contexts, show a dialog
+        const { amount, description } = challenge['x-payment-required'];
+        console.log(`\n💳 Payment Required`);
+        console.log(`   Amount: ${amount} USDC`);
+        console.log(`   Description: ${description}`);
+        console.log(`   Confirm? (auto-approved)\n`);
+        // Auto-approve for now
+        return true;
+    }
+    /**
+     * Get cached receipt for URL
+     */
+    getCachedReceipt(url) {
+        if (!this.cacheReceipts)
+            return null;
+        const receipt = this.receiptCache.get(url);
+        // Check if receipt is still valid
+        if (receipt && receipt.expiresAt > Math.floor(Date.now() / 1000)) {
+            return receipt;
+        }
+        // Expired - remove from cache
+        if (receipt) {
+            this.receiptCache.delete(url);
+        }
+        return null;
+    }
+    /**
+     * Cache payment receipt
+     */
+    async cacheReceipt(receipt) {
+        if (!this.cacheReceipts)
+            return;
+        // Add to in-memory cache
+        this.receiptCache.set(receipt.url, receipt);
+        // Persist to disk
+        try {
+            await promises_1.default.mkdir(this.cacheDir, { recursive: true });
+            const filename = crypto_1.default.createHash('md5').update(receipt.url).digest('hex') + '.json';
+            const filepath = path_1.default.join(this.cacheDir, filename);
+            await promises_1.default.writeFile(filepath, JSON.stringify(receipt, null, 2));
+        }
+        catch (error) {
+            // Ignore cache write errors
+            console.error('Failed to cache receipt:', error);
+        }
+    }
+    /**
+     * Load cached receipts from disk
+     */
+    async loadReceiptCache() {
+        try {
+            await promises_1.default.mkdir(this.cacheDir, { recursive: true });
+            const files = await promises_1.default.readdir(this.cacheDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const filepath = path_1.default.join(this.cacheDir, file);
+                    const data = await promises_1.default.readFile(filepath, 'utf-8');
+                    const receipt = JSON.parse(data);
+                    // Only cache if not expired
+                    if (receipt.expiresAt > Math.floor(Date.now() / 1000)) {
+                        this.receiptCache.set(receipt.url, receipt);
+                    }
+                    else {
+                        // Delete expired receipt
+                        await promises_1.default.unlink(filepath);
+                    }
+                }
+                catch {
+                    // Ignore individual file errors
+                }
+            }
+        }
+        catch {
+            // Ignore cache directory errors
+        }
+    }
+    /**
+     * Get receipt history
+     */
+    async getReceiptHistory() {
+        const receipts = [];
+        try {
+            const files = await promises_1.default.readdir(this.cacheDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const filepath = path_1.default.join(this.cacheDir, file);
+                    const data = await promises_1.default.readFile(filepath, 'utf-8');
+                    const receipt = JSON.parse(data);
+                    receipts.push(receipt);
+                }
+                catch {
+                    // Ignore individual file errors
+                }
+            }
+        }
+        catch {
+            // Ignore directory errors
+        }
+        // Sort by payment date (newest first)
+        return receipts.sort((a, b) => new Date(b.paidAt).getTime() - new Date(a.paidAt).getTime());
+    }
+    /**
+     * Clear receipt cache
+     */
+    async clearCache() {
+        this.receiptCache.clear();
+        try {
+            const files = await promises_1.default.readdir(this.cacheDir);
+            for (const file of files) {
+                const filepath = path_1.default.join(this.cacheDir, file);
+                await promises_1.default.unlink(filepath);
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    /**
+     * Extract URL string from various input types
+     */
+    getUrlString(url) {
+        if (typeof url === 'string') {
+            return url;
+        }
+        else if (url instanceof URL) {
+            return url.toString();
+        }
+        else {
+            return url.url;
+        }
+    }
+}
+exports.X402Client = X402Client;
+/**
+ * Helper: Create simple x402 client with minimal config
+ */
+function simpleX402Fetch(wallet, maxAutoPayUSDC) {
+    return createX402Fetch({
+        wallet,
+        maxAutoPayUSDC,
+        onPayment: (amount, url) => {
+            console.log(`💸 Paid ${amount} USDC for ${url}`);
+        },
+    });
+}
+exports.default = { createX402Fetch, simpleX402Fetch, X402Client };
+//# sourceMappingURL=x402-client.js.map

package/dist/x402-client.js.map

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

package/dist/x402-server.d.ts

@@ -0,0 +1,133 @@
+/**
+ * x402 Payment Server Middleware
+ *
+ * Express middleware for HTTP 402 Payment Required.
+ * Generates payment challenges and verifies payments via Coinbase facilitator.
+ */
+import { Request, Response, NextFunction } from 'express';
+export interface X402ServerConfig {
+    facilitatorUrl?: string;
+    network: string;
+    receiverAddress: string;
+    acceptedAssets?: string[];
+    challengeExpiry?: number;
+    verifyPayment?: (signature: string, amount: string) => Promise<boolean>;
+}
+export interface PaymentChallenge {
+    'x-payment-required': {
+        version: '1';
+        network: string;
+        receiver: string;
+        asset: string;
+        amount: string;
+        description: string;
+        expires: number;
+        nonce: string;
+    };
+}
+/**
+ * Configure x402 server globally
+ */
+export declare function configureX402Server(config: X402ServerConfig): void;
+/**
+ * Create payment challenge
+ */
+export declare function createPaymentChallenge(amount: string, description: string, config?: Partial<X402ServerConfig>): PaymentChallenge;
+/**
+ * Paywall middleware - require payment to access endpoint
+ */
+export declare function paywall(price: string, description: string, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Dynamic paywall - determine price at runtime
+ */
+export declare function dynamicPaywall(priceFn: (req: Request) => string | Promise<string>, descriptionFn: (req: Request) => string | Promise<string>, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Mock verification for testing (accepts any signature)
+ */
+export declare function mockVerification(): (signature: string, amount: string) => Promise<boolean>;
+/**
+ * Simple signature verification (hash-based)
+ * Use only for testing - NOT secure for production
+ */
+export declare function simpleVerification(secret: string): (signature: string, amount: string) => Promise<boolean>;
+/**
+ * Pricing helper - combine multiple tiers
+ */
+export declare class PricingTier {
+    private tiers;
+    add(key: string, price: string): this;
+    get(key: string): string | undefined;
+    middleware(keyFn: (req: Request) => string, descriptionFn: (req: Request) => string, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+}
+/**
+ * Usage-based pricing
+ */
+export interface UsageConfig {
+    basePrice: string;
+    perUnit: string;
+    unit: string;
+    calculate: (req: Request) => number | Promise<number>;
+}
+export declare function usagePaywall(usage: UsageConfig, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Subscription paywall (check for valid subscription)
+ */
+export interface SubscriptionConfig {
+    getSubscription: (req: Request) => Promise<{
+        active: boolean;
+        expiresAt: string;
+    } | null>;
+    price: string;
+    period: 'monthly' | 'yearly';
+    renewalUrl?: string;
+}
+export declare function subscriptionPaywall(subscription: SubscriptionConfig, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Rate-limited paywall (free tier + paid tier)
+ */
+export interface RateLimitConfig {
+    free: {
+        limit: number;
+        windowMs: number;
+    };
+    paid: {
+        price: string;
+        description: string;
+    };
+    getUserId: (req: Request) => string;
+}
+export declare function rateLimitedPaywall(rateLimitConfig: RateLimitConfig, config?: Partial<X402ServerConfig>): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+/**
+ * Express router with common x402 endpoints
+ */
+export declare function createX402Router(): null;
+export declare const PRICING: {
+    micro: string;
+    small: string;
+    medium: string;
+    large: string;
+    premium: string;
+    enterprise: string;
+};
+declare const _default: {
+    configureX402Server: typeof configureX402Server;
+    createPaymentChallenge: typeof createPaymentChallenge;
+    paywall: typeof paywall;
+    dynamicPaywall: typeof dynamicPaywall;
+    usagePaywall: typeof usagePaywall;
+    subscriptionPaywall: typeof subscriptionPaywall;
+    rateLimitedPaywall: typeof rateLimitedPaywall;
+    mockVerification: typeof mockVerification;
+    simpleVerification: typeof simpleVerification;
+    PricingTier: typeof PricingTier;
+    PRICING: {
+        micro: string;
+        small: string;
+        medium: string;
+        large: string;
+        premium: string;
+        enterprise: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=x402-server.d.ts.map

package/dist/x402-server.d.ts.map

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