pay-lobster 1.0.0

package/dist/x402-server.js

@@ -0,0 +1,330 @@
+"use strict";
+/**
+ * x402 Payment Server Middleware
+ *
+ * Express middleware for HTTP 402 Payment Required.
+ * Generates payment challenges and verifies payments via Coinbase facilitator.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRICING = exports.PricingTier = void 0;
+exports.configureX402Server = configureX402Server;
+exports.createPaymentChallenge = createPaymentChallenge;
+exports.paywall = paywall;
+exports.dynamicPaywall = dynamicPaywall;
+exports.mockVerification = mockVerification;
+exports.simpleVerification = simpleVerification;
+exports.usagePaywall = usagePaywall;
+exports.subscriptionPaywall = subscriptionPaywall;
+exports.rateLimitedPaywall = rateLimitedPaywall;
+exports.createX402Router = createX402Router;
+const crypto_1 = __importDefault(require("crypto"));
+// Global config (can be set once for all middleware)
+let globalConfig = null;
+/**
+ * Configure x402 server globally
+ */
+function configureX402Server(config) {
+    globalConfig = {
+        facilitatorUrl: config.facilitatorUrl || 'https://x402.coinbase.com',
+        acceptedAssets: config.acceptedAssets || ['USDC'],
+        challengeExpiry: config.challengeExpiry || 300,
+        ...config,
+    };
+}
+/**
+ * Get effective config (merge global + local)
+ */
+function getConfig(localConfig) {
+    if (!globalConfig && !localConfig) {
+        throw new Error('x402 server not configured. Call configureX402Server() first.');
+    }
+    return {
+        facilitatorUrl: localConfig?.facilitatorUrl || globalConfig?.facilitatorUrl || 'https://x402.coinbase.com',
+        network: localConfig?.network || globalConfig?.network || 'ETH-SEPOLIA',
+        receiverAddress: localConfig?.receiverAddress || globalConfig?.receiverAddress || '',
+        acceptedAssets: localConfig?.acceptedAssets || globalConfig?.acceptedAssets || ['USDC'],
+        challengeExpiry: localConfig?.challengeExpiry || globalConfig?.challengeExpiry || 300,
+        verifyPayment: localConfig?.verifyPayment || globalConfig?.verifyPayment,
+    };
+}
+/**
+ * Create payment challenge
+ */
+function createPaymentChallenge(amount, description, config) {
+    const effectiveConfig = getConfig(config);
+    return {
+        'x-payment-required': {
+            version: '1',
+            network: effectiveConfig.network,
+            receiver: effectiveConfig.receiverAddress,
+            asset: 'USDC',
+            amount,
+            description,
+            expires: Math.floor(Date.now() / 1000) + (effectiveConfig.challengeExpiry || 300),
+            nonce: crypto_1.default.randomUUID(),
+        },
+    };
+}
+/**
+ * Paywall middleware - require payment to access endpoint
+ */
+function paywall(price, description, config) {
+    return async (req, res, next) => {
+        const paymentSignature = req.headers['x-payment-signature'];
+        if (!paymentSignature) {
+            // No payment provided - return 402 with challenge
+            const challenge = createPaymentChallenge(price, description, config);
+            res.status(402).json({
+                error: 'Payment Required',
+                message: `This endpoint requires ${price} USDC`,
+                ...challenge,
+            });
+            return;
+        }
+        // Verify payment
+        try {
+            const effectiveConfig = getConfig(config);
+            const verified = await verifyPayment(paymentSignature, price, effectiveConfig);
+            if (verified) {
+                // Payment verified - proceed
+                req.paymentVerified = true;
+                req.paymentAmount = price;
+                req.paymentSignature = paymentSignature;
+                next();
+            }
+            else {
+                res.status(402).json({
+                    error: 'Payment Invalid',
+                    message: 'Payment signature could not be verified',
+                });
+            }
+        }
+        catch (error) {
+            console.error('Payment verification error:', error);
+            res.status(500).json({
+                error: 'Payment Verification Failed',
+                message: error.message,
+            });
+        }
+    };
+}
+/**
+ * Dynamic paywall - determine price at runtime
+ */
+function dynamicPaywall(priceFn, descriptionFn, config) {
+    return async (req, res, next) => {
+        try {
+            // Determine price and description
+            const price = await Promise.resolve(priceFn(req));
+            const description = await Promise.resolve(descriptionFn(req));
+            // Use standard paywall
+            const middleware = paywall(price, description, config);
+            await middleware(req, res, next);
+        }
+        catch (error) {
+            res.status(500).json({
+                error: 'Paywall Configuration Error',
+                message: error.message,
+            });
+        }
+    };
+}
+/**
+ * Verify payment with Coinbase x402 facilitator
+ */
+async function verifyPayment(signature, expectedAmount, config) {
+    // Use custom verification if provided
+    if (config.verifyPayment) {
+        return config.verifyPayment(signature, expectedAmount);
+    }
+    // Default: verify with Coinbase facilitator
+    try {
+        const response = await fetch(`${config.facilitatorUrl}/verify`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                signature,
+                expectedAmount,
+                network: config.network,
+                receiver: config.receiverAddress,
+            }),
+        });
+        if (!response.ok) {
+            return false;
+        }
+        const result = await response.json();
+        return result.valid === true;
+    }
+    catch (error) {
+        console.error('Facilitator verification error:', error);
+        return false;
+    }
+}
+/**
+ * Mock verification for testing (accepts any signature)
+ */
+function mockVerification() {
+    return async (signature, amount) => {
+        // In testing, accept any non-empty signature
+        return signature.length > 0;
+    };
+}
+/**
+ * Simple signature verification (hash-based)
+ * Use only for testing - NOT secure for production
+ */
+function simpleVerification(secret) {
+    return async (signature, amount) => {
+        // Verify signature matches hash of secret + amount
+        const expectedSig = crypto_1.default.createHash('sha256')
+            .update(secret + amount)
+            .digest('hex');
+        return signature === expectedSig;
+    };
+}
+/**
+ * Pricing helper - combine multiple tiers
+ */
+class PricingTier {
+    constructor() {
+        this.tiers = new Map();
+    }
+    add(key, price) {
+        this.tiers.set(key, price);
+        return this;
+    }
+    get(key) {
+        return this.tiers.get(key);
+    }
+    middleware(keyFn, descriptionFn, config) {
+        return dynamicPaywall((req) => {
+            const key = keyFn(req);
+            const price = this.tiers.get(key);
+            if (!price) {
+                throw new Error(`No price configured for tier: ${key}`);
+            }
+            return price;
+        }, descriptionFn, config);
+    }
+}
+exports.PricingTier = PricingTier;
+function usagePaywall(usage, config) {
+    return dynamicPaywall(async (req) => {
+        const units = await Promise.resolve(usage.calculate(req));
+        const base = parseFloat(usage.basePrice);
+        const perUnit = parseFloat(usage.perUnit);
+        const total = base + (units * perUnit);
+        return total.toFixed(2);
+    }, (req) => `Usage-based pricing: base + ${usage.perUnit} per ${usage.unit}`, config);
+}
+function subscriptionPaywall(subscription, config) {
+    return async (req, res, next) => {
+        // Check for active subscription
+        const sub = await subscription.getSubscription(req);
+        if (sub && sub.active && new Date(sub.expiresAt) > new Date()) {
+            // Active subscription - allow access
+            req.subscription = sub;
+            next();
+            return;
+        }
+        // No active subscription - require payment
+        const description = `${subscription.period} subscription - ${subscription.price} USDC`;
+        const challenge = createPaymentChallenge(subscription.price, description, config);
+        res.status(402).json({
+            error: 'Subscription Required',
+            message: `This endpoint requires an active ${subscription.period} subscription`,
+            subscription: {
+                price: subscription.price,
+                period: subscription.period,
+                renewalUrl: subscription.renewalUrl,
+            },
+            ...challenge,
+        });
+    };
+}
+// Simple in-memory rate limiter
+const rateLimitStore = new Map();
+function rateLimitedPaywall(rateLimitConfig, config) {
+    return async (req, res, next) => {
+        const userId = rateLimitConfig.getUserId(req);
+        const now = Date.now();
+        // Get or create usage record
+        let usage = rateLimitStore.get(userId);
+        if (!usage || usage.resetAt < now) {
+            // New window
+            usage = {
+                count: 0,
+                resetAt: now + rateLimitConfig.free.windowMs,
+            };
+            rateLimitStore.set(userId, usage);
+        }
+        // Check if within free tier
+        if (usage.count < rateLimitConfig.free.limit) {
+            usage.count++;
+            next();
+            return;
+        }
+        // Exceeded free tier - require payment
+        const paymentSignature = req.headers['x-payment-signature'];
+        if (!paymentSignature) {
+            const challenge = createPaymentChallenge(rateLimitConfig.paid.price, rateLimitConfig.paid.description, config);
+            res.status(402).json({
+                error: 'Rate Limit Exceeded',
+                message: `Free tier limit reached (${rateLimitConfig.free.limit} requests per window)`,
+                rateTier: 'paid',
+                ...challenge,
+            });
+            return;
+        }
+        // Verify payment for additional request
+        const effectiveConfig = getConfig(config);
+        const verified = await verifyPayment(paymentSignature, rateLimitConfig.paid.price, effectiveConfig);
+        if (verified) {
+            req.paymentVerified = true;
+            req.paidRequest = true;
+            next();
+        }
+        else {
+            res.status(402).json({
+                error: 'Payment Invalid',
+                message: 'Payment signature could not be verified',
+            });
+        }
+    };
+}
+/**
+ * Express router with common x402 endpoints
+ */
+function createX402Router() {
+    // This would return an Express router with health/pricing endpoints
+    // Implemented in the specific application
+    return null;
+}
+// Export pricing helpers
+exports.PRICING = {
+    micro: '0.01',
+    small: '0.05',
+    medium: '0.10',
+    large: '0.25',
+    premium: '0.50',
+    enterprise: '1.00',
+};
+exports.default = {
+    configureX402Server,
+    createPaymentChallenge,
+    paywall,
+    dynamicPaywall,
+    usagePaywall,
+    subscriptionPaywall,
+    rateLimitedPaywall,
+    mockVerification,
+    simpleVerification,
+    PricingTier,
+    PRICING: exports.PRICING,
+};
+//# sourceMappingURL=x402-server.js.map

package/dist/x402-server.js.map

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

package/lib/agent.ts

@@ -0,0 +1,273 @@
+/**
+ * LobsterAgent - Main class for Pay Lobster SDK
+ */
+
+import type {
+  LobsterConfig,
+  Wallet,
+  Transfer,
+  Escrow,
+  TrustScore,
+  Agent,
+  TransferOptions,
+  EscrowOptions,
+  DiscoverOptions,
+  AutonomousConfig
+} from './types';
+
+const BASE_RPC = 'https://mainnet.base.org';
+const USDC_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+
+export class LobsterAgent {
+  private config: LobsterConfig;
+  private wallet?: Wallet;
+  private autonomousConfig?: AutonomousConfig;
+
+  constructor(config: LobsterConfig = {}) {
+    this.config = {
+      network: 'base',
+      enableTrust: true,
+      ...config
+    };
+  }
+
+  /**
+   * Initialize the agent and connect to wallet
+   */
+  async initialize(): Promise<void> {
+    if (this.config.walletId) {
+      this.wallet = await this.getWallet();
+    }
+  }
+
+  /**
+   * Create a new Circle-managed wallet
+   */
+  async createWallet(): Promise<Wallet> {
+    // Implementation would use Circle API
+    throw new Error('Circle wallet creation requires entity secret. Use external wallet or Circle Console.');
+  }
+
+  /**
+   * Get wallet details and balance
+   */
+  async getWallet(): Promise<Wallet> {
+    if (!this.wallet?.address && !this.config.walletId) {
+      throw new Error('No wallet configured');
+    }
+    
+    const address = this.wallet?.address || this.config.walletId!;
+    const balance = await this.getBalance();
+    
+    return {
+      id: this.config.walletId || 'external',
+      address,
+      network: this.config.network || 'base',
+      balance
+    };
+  }
+
+  /**
+   * Get current USDC balance
+   */
+  async getBalance(): Promise<string> {
+    const address = this.wallet?.address || this.config.walletId;
+    if (!address) throw new Error('No wallet address');
+
+    const rpc = this.config.rpcUrl || BASE_RPC;
+    const data = '0x70a08231' + address.slice(2).padStart(64, '0');
+    
+    const response = await fetch(rpc, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        id: 1,
+        method: 'eth_call',
+        params: [{ to: USDC_BASE, data }, 'latest']
+      })
+    });
+    
+    const result: any = await response.json();
+    const balance = parseInt(result.result || '0', 16) / 1e6;
+    return balance.toFixed(2);
+  }
+
+  /**
+   * Get deposit address
+   */
+  async getDepositAddress(): Promise<string> {
+    return this.wallet?.address || this.config.walletId || '';
+  }
+
+  /**
+   * Transfer USDC to another address
+   */
+  async transfer(options: TransferOptions): Promise<Transfer> {
+    // Implementation requires private key or Circle wallet
+    console.log(`Transfer: ${options.amount} USDC to ${options.to}`);
+    
+    return {
+      id: `tx_${Date.now()}`,
+      status: 'pending',
+      amount: options.amount,
+      to: options.to,
+      from: this.wallet?.address || '',
+      memo: options.memo,
+      createdAt: new Date().toISOString()
+    };
+  }
+
+  /**
+   * Alias for transfer
+   */
+  async send(to: string, amount: number | string): Promise<Transfer> {
+    return this.transfer({ to, amount: amount.toString() });
+  }
+
+  /**
+   * Create an escrow
+   */
+  async createEscrow(options: EscrowOptions): Promise<Escrow> {
+    return {
+      id: `esc_${Date.now()}`,
+      amount: options.amount,
+      buyer: this.wallet?.address || '',
+      seller: options.recipient,
+      status: 'funded',
+      conditions: options.conditions,
+      createdAt: new Date().toISOString()
+    };
+  }
+
+  /**
+   * Release escrow funds
+   */
+  async releaseEscrow(escrowId: string, options?: { amount?: string }): Promise<void> {
+    console.log(`Releasing escrow ${escrowId}`, options);
+  }
+
+  /**
+   * Refund escrow
+   */
+  async refundEscrow(escrowId: string): Promise<void> {
+    console.log(`Refunding escrow ${escrowId}`);
+  }
+
+  /**
+   * Dispute escrow
+   */
+  async disputeEscrow(escrowId: string, options: { reason: string }): Promise<void> {
+    console.log(`Disputing escrow ${escrowId}: ${options.reason}`);
+  }
+
+  /**
+   * Get trust score for an address
+   */
+  async getTrustScore(address: string): Promise<TrustScore> {
+    // Would query ERC-8004 registry
+    return {
+      score: 100,
+      level: 'new',
+      totalTransactions: 0,
+      successRate: 100
+    };
+  }
+
+  /**
+   * Rate an agent
+   */
+  async rateAgent(options: { agent: string; rating: number; comment?: string; transactionId?: string }): Promise<void> {
+    console.log(`Rating agent ${options.agent}: ${options.rating}/5`);
+  }
+
+  /**
+   * Get agent ratings
+   */
+  async getAgentRatings(address: string): Promise<any[]> {
+    return [];
+  }
+
+  /**
+   * Register agent in on-chain registry
+   */
+  async registerAgent(options: {
+    name: string;
+    capabilities: string[];
+    pricing?: Record<string, string>;
+    metadata?: Record<string, any>;
+  }): Promise<void> {
+    console.log(`Registering agent: ${options.name}`);
+  }
+
+  /**
+   * Discover agents by capability
+   */
+  async discoverAgents(options: DiscoverOptions): Promise<Agent[]> {
+    // Would query on-chain registry
+    return [{
+      address: '0xf775f0224A680E2915a066e53A389d0335318b7B',
+      name: 'paylobster',
+      capabilities: ['payments', 'escrow'],
+      trustScore: { score: 100, level: 'verified', totalTransactions: 0, successRate: 100 }
+    }];
+  }
+
+  /**
+   * Get agent details
+   */
+  async getAgent(address: string): Promise<Agent | null> {
+    const agents = await this.discoverAgents({});
+    return agents.find(a => a.address.toLowerCase() === address.toLowerCase()) || null;
+  }
+
+  /**
+   * Configure autonomous mode
+   */
+  setAutonomousMode(config: AutonomousConfig): void {
+    this.autonomousConfig = config;
+  }
+
+  /**
+   * Hire an agent autonomously
+   */
+  async hireAgent(options: { agent: string; task: string; maxPrice: string }): Promise<any> {
+    console.log(`Hiring agent ${options.agent} for: ${options.task}`);
+    return { taskId: `task_${Date.now()}`, agent: options.agent, price: options.maxPrice };
+  }
+
+  /**
+   * Set webhook for notifications
+   */
+  setWebhook(options: { url: string; secret: string; events: string[] }): void {
+    console.log(`Webhook configured: ${options.url}`);
+  }
+
+  /**
+   * Fetch with x402 auto-payment
+   */
+  async fetch(url: string, options?: { x402?: boolean; maxPayment?: string }): Promise<Response> {
+    const response = await fetch(url);
+    
+    if (response.status === 402 && options?.x402) {
+      // Would handle payment automatically
+      console.log('402 Payment Required - auto-paying...');
+    }
+    
+    return response;
+  }
+
+  /**
+   * Get transfer by ID
+   */
+  async getTransfer(id: string): Promise<Transfer | null> {
+    return null;
+  }
+
+  /**
+   * List transfer history
+   */
+  async listTransfers(options?: { limit?: number; direction?: string; since?: string }): Promise<Transfer[]> {
+    return [];
+  }
+}