pay-lobster 1.0.0

package/dist/tips.js

@@ -0,0 +1,390 @@
+"use strict";
+/**
+ * Tip Jar / Creator Economy Module
+ *
+ * Enable Clawdbot operators and agents to receive USDC tips
+ * via simple commands. Built for the creator economy.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TipJarManager = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const DATA_DIR = process.env.USDC_DATA_DIR || './data';
+/**
+ * Tip Jar Manager
+ */
+class TipJarManager {
+    constructor(dataDir = DATA_DIR) {
+        this.jarsPath = path_1.default.join(dataDir, 'tip-jars.json');
+        this.tipsPath = path_1.default.join(dataDir, 'tips.json');
+    }
+    async loadJars() {
+        try {
+            const data = await promises_1.default.readFile(this.jarsPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async saveJars(jars) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.jarsPath), { recursive: true });
+        await promises_1.default.writeFile(this.jarsPath, JSON.stringify(jars, null, 2));
+    }
+    async loadTips() {
+        try {
+            const data = await promises_1.default.readFile(this.tipsPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async saveTips(tips) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.tipsPath), { recursive: true });
+        await promises_1.default.writeFile(this.tipsPath, JSON.stringify(tips, null, 2));
+    }
+    // ============ Tip Jar Management ============
+    /**
+     * Create a new tip jar
+     */
+    async createJar(params) {
+        const jars = await this.loadJars();
+        // Check for duplicate slug
+        if (params.publicSlug) {
+            const existing = jars.find(j => j.publicSlug === params.publicSlug);
+            if (existing) {
+                throw new Error(`Slug "${params.publicSlug}" is already taken`);
+            }
+        }
+        const jar = {
+            id: crypto_1.default.randomUUID(),
+            name: params.name || `${params.ownerName}'s Tip Jar`,
+            description: params.description,
+            ownerId: params.ownerId,
+            ownerName: params.ownerName,
+            addresses: params.addresses.map((a, i) => ({
+                ...a,
+                isDefault: i === 0,
+            })),
+            settings: {
+                minTip: params.settings?.minTip || '1',
+                suggestedAmounts: params.settings?.suggestedAmounts || ['5', '10', '25', '50'],
+                thankYouMessage: params.settings?.thankYouMessage || 'Thanks for the tip! 🙏',
+                allowAnonymous: params.settings?.allowAnonymous ?? true,
+                notifyOnTip: params.settings?.notifyOnTip ?? true,
+            },
+            stats: {
+                totalReceived: '0',
+                tipCount: 0,
+                uniqueTippers: 0,
+                largestTip: '0',
+            },
+            publicSlug: params.publicSlug,
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        jars.push(jar);
+        await this.saveJars(jars);
+        return jar;
+    }
+    /**
+     * Get tip jar by ID, slug, or owner
+     */
+    async getJar(identifier) {
+        const jars = await this.loadJars();
+        return jars.find(j => j.id === identifier ||
+            j.publicSlug === identifier ||
+            j.ownerId === identifier) || null;
+    }
+    /**
+     * Update tip jar settings
+     */
+    async updateJar(id, updates) {
+        const jars = await this.loadJars();
+        const jar = jars.find(j => j.id === id);
+        if (jar) {
+            if (updates.name)
+                jar.name = updates.name;
+            if (updates.description !== undefined)
+                jar.description = updates.description;
+            if (updates.publicSlug !== undefined) {
+                // Check for duplicate
+                if (updates.publicSlug && jars.some(j => j.id !== id && j.publicSlug === updates.publicSlug)) {
+                    throw new Error(`Slug "${updates.publicSlug}" is already taken`);
+                }
+                jar.publicSlug = updates.publicSlug;
+            }
+            if (updates.settings) {
+                jar.settings = { ...jar.settings, ...updates.settings };
+            }
+            jar.updatedAt = new Date().toISOString();
+            await this.saveJars(jars);
+        }
+        return jar || null;
+    }
+    /**
+     * Add address to tip jar
+     */
+    async addAddress(jarId, chain, address) {
+        const jars = await this.loadJars();
+        const jar = jars.find(j => j.id === jarId);
+        if (jar) {
+            if (jar.addresses.some(a => a.chain === chain)) {
+                throw new Error(`Address for ${chain} already exists`);
+            }
+            jar.addresses.push({ chain, address, isDefault: false });
+            jar.updatedAt = new Date().toISOString();
+            await this.saveJars(jars);
+        }
+        return jar || null;
+    }
+    /**
+     * Set default address
+     */
+    async setDefaultAddress(jarId, chain) {
+        const jars = await this.loadJars();
+        const jar = jars.find(j => j.id === jarId);
+        if (jar) {
+            jar.addresses.forEach(a => {
+                a.isDefault = a.chain === chain;
+            });
+            jar.updatedAt = new Date().toISOString();
+            await this.saveJars(jars);
+        }
+        return jar || null;
+    }
+    // ============ Tip Processing ============
+    /**
+     * Record a tip
+     */
+    async recordTip(params) {
+        const jars = await this.loadJars();
+        const jar = jars.find(j => j.id === params.tipJarId);
+        if (!jar) {
+            throw new Error('Tip jar not found');
+        }
+        const tips = await this.loadTips();
+        const tip = {
+            id: crypto_1.default.randomUUID(),
+            tipJarId: params.tipJarId,
+            fromAddress: params.fromAddress,
+            fromName: params.fromName,
+            isAnonymous: params.isAnonymous ?? false,
+            amount: params.amount,
+            chain: params.chain,
+            txHash: params.txHash,
+            message: params.message,
+            status: 'confirmed',
+            confirmedAt: new Date().toISOString(),
+            createdAt: new Date().toISOString(),
+        };
+        tips.push(tip);
+        await this.saveTips(tips);
+        // Update jar stats
+        const amount = parseFloat(params.amount);
+        jar.stats.totalReceived = (parseFloat(jar.stats.totalReceived) + amount).toString();
+        jar.stats.tipCount++;
+        // Check if new unique tipper
+        const previousTips = tips.filter(t => t.tipJarId === jar.id &&
+            t.fromAddress.toLowerCase() === params.fromAddress.toLowerCase() &&
+            t.id !== tip.id);
+        if (previousTips.length === 0) {
+            jar.stats.uniqueTippers++;
+        }
+        // Update largest tip
+        if (amount > parseFloat(jar.stats.largestTip)) {
+            jar.stats.largestTip = params.amount;
+        }
+        jar.stats.lastTipAt = new Date().toISOString();
+        jar.updatedAt = new Date().toISOString();
+        await this.saveJars(jars);
+        return tip;
+    }
+    /**
+     * Get tips for a jar
+     */
+    async getTips(jarId, options) {
+        let tips = await this.loadTips();
+        tips = tips.filter(t => t.tipJarId === jarId);
+        if (options?.includeAnonymous === false) {
+            tips = tips.filter(t => !t.isAnonymous);
+        }
+        tips.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        if (options?.limit) {
+            tips = tips.slice(0, options.limit);
+        }
+        return tips;
+    }
+    /**
+     * Get recent tips across all jars (for activity feed)
+     */
+    async getRecentTips(limit = 10) {
+        const tips = await this.loadTips();
+        const jars = await this.loadJars();
+        const jarMap = new Map(jars.map(j => [j.id, j]));
+        return tips
+            .sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime())
+            .slice(0, limit)
+            .map(tip => ({
+            ...tip,
+            jarName: jarMap.get(tip.tipJarId)?.name || 'Unknown',
+        }));
+    }
+    // ============ Leaderboards ============
+    /**
+     * Generate leaderboard for a tip jar
+     */
+    async getLeaderboard(jarId, period = 'all-time') {
+        let tips = await this.loadTips();
+        tips = tips.filter(t => t.tipJarId === jarId && !t.isAnonymous);
+        // Filter by period
+        const now = new Date();
+        if (period === 'weekly') {
+            const weekAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+            tips = tips.filter(t => new Date(t.createdAt) >= weekAgo);
+        }
+        else if (period === 'monthly') {
+            const monthAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+            tips = tips.filter(t => new Date(t.createdAt) >= monthAgo);
+        }
+        // Aggregate by tipper
+        const tipperMap = new Map();
+        for (const tip of tips) {
+            const key = tip.fromAddress.toLowerCase();
+            const existing = tipperMap.get(key) || {
+                name: tip.fromName || this.shortAddress(tip.fromAddress),
+                total: 0,
+                count: 0
+            };
+            existing.total += parseFloat(tip.amount);
+            existing.count++;
+            if (tip.fromName)
+                existing.name = tip.fromName;
+            tipperMap.set(key, existing);
+        }
+        // Sort and rank
+        const entries = Array.from(tipperMap.entries())
+            .map(([address, data]) => ({
+            address,
+            name: data.name,
+            totalTipped: data.total.toFixed(2),
+            tipCount: data.count,
+        }))
+            .sort((a, b) => parseFloat(b.totalTipped) - parseFloat(a.totalTipped))
+            .map((entry, i) => ({ rank: i + 1, ...entry }));
+        return {
+            tipJarId: jarId,
+            period,
+            entries,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    // ============ Tip Commands (for Clawdbot) ============
+    /**
+     * Parse tip command and return tip info
+     * Supports: "tip @gustav 10", "tip 5 to gustav", etc.
+     */
+    parseTipCommand(command) {
+        // Patterns:
+        // "tip @gustav 10"
+        // "tip 10 to @gustav"
+        // "tip gustav 10 usdc thanks!"
+        const patterns = [
+            // tip @recipient amount [message]
+            /^tip\s+@?(\w+)\s+(\d+(?:\.\d+)?)\s*(?:usdc)?\s*(.*)$/i,
+            // tip amount to @recipient [message]
+            /^tip\s+(\d+(?:\.\d+)?)\s*(?:usdc)?\s+to\s+@?(\w+)\s*(.*)$/i,
+        ];
+        for (const pattern of patterns) {
+            const match = command.match(pattern);
+            if (match) {
+                if (pattern === patterns[0]) {
+                    return {
+                        recipient: match[1],
+                        amount: match[2],
+                        message: match[3]?.trim() || undefined,
+                    };
+                }
+                else {
+                    return {
+                        recipient: match[2],
+                        amount: match[1],
+                        message: match[3]?.trim() || undefined,
+                    };
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Generate tip jar card/embed for display
+     */
+    formatTipJarCard(jar) {
+        const defaultAddr = jar.addresses.find(a => a.isDefault) || jar.addresses[0];
+        let card = `💰 **${jar.name}**\n`;
+        if (jar.description) {
+            card += `${jar.description}\n`;
+        }
+        card += `\n`;
+        card += `Owner: ${jar.ownerName}\n`;
+        card += `Total Received: **$${parseFloat(jar.stats.totalReceived).toFixed(2)} USDC**\n`;
+        card += `Tips: ${jar.stats.tipCount} from ${jar.stats.uniqueTippers} tippers\n`;
+        card += `\n`;
+        card += `**Quick Tip:**\n`;
+        card += jar.settings.suggestedAmounts.map(a => `[$${a}]`).join(' ') + '\n';
+        card += `\n`;
+        card += `Send to: \`${defaultAddr.address}\`\n`;
+        card += `Chain: ${defaultAddr.chain}\n`;
+        if (jar.publicSlug) {
+            card += `\nLink: tip.clawd.bot/${jar.publicSlug}`;
+        }
+        return card;
+    }
+    /**
+     * Format tip notification
+     */
+    formatTipNotification(tip, jar) {
+        const senderName = tip.isAnonymous ? 'Anonymous' : (tip.fromName || this.shortAddress(tip.fromAddress));
+        let notif = `🎉 **New Tip!**\n\n`;
+        notif += `${senderName} tipped **$${tip.amount} USDC**`;
+        if (tip.message) {
+            notif += `\n\n"${tip.message}"`;
+        }
+        notif += `\n\n${jar.settings.thankYouMessage}`;
+        return notif;
+    }
+    shortAddress(address) {
+        return `${address.slice(0, 6)}...${address.slice(-4)}`;
+    }
+    // ============ Agent-to-Agent Tips ============
+    /**
+     * Send tip from one agent to another
+     * Returns the transaction to be executed
+     */
+    async prepareAgentTip(params) {
+        // Find recipient's tip jar
+        const toJar = await this.getJar(params.toAgentId);
+        if (!toJar) {
+            return null;
+        }
+        const defaultAddr = toJar.addresses.find(a => a.isDefault) || toJar.addresses[0];
+        if (!defaultAddr) {
+            return null;
+        }
+        return {
+            toJar,
+            toAddress: defaultAddr.address,
+            chain: defaultAddr.chain,
+            amount: params.amount,
+            message: params.message,
+        };
+    }
+}
+exports.TipJarManager = TipJarManager;
+exports.default = TipJarManager;
+//# sourceMappingURL=tips.js.map

package/dist/tips.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Pay Lobster Type Definitions
+ */
+export interface LobsterConfig {
+    /** Circle API key for wallet operations */
+    circleApiKey?: string;
+    /** Ethereum private key for direct transactions */
+    privateKey?: string;
+    /** Network: 'base' | 'base-sepolia' | 'ethereum' */
+    network?: 'base' | 'base-sepolia' | 'ethereum';
+    /** Existing Circle wallet ID */
+    walletId?: string;
+    /** Custom RPC URL */
+    rpcUrl?: string;
+    /** Enable ERC-8004 trust verification */
+    enableTrust?: boolean;
+}
+export interface Wallet {
+    id: string;
+    address: string;
+    network: string;
+    balance?: string;
+    createdAt?: string;
+}
+export interface Transfer {
+    id: string;
+    hash?: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    amount: string;
+    to: string;
+    from: string;
+    memo?: string;
+    createdAt: string;
+}
+export interface Escrow {
+    id: string;
+    amount: string;
+    buyer: string;
+    seller: string;
+    status: 'funded' | 'released' | 'disputed' | 'refunded';
+    conditions?: EscrowConditions;
+    createdAt: string;
+}
+export interface EscrowConditions {
+    type: 'milestone' | 'time' | 'approval';
+    description: string;
+    deadline?: string;
+}
+export interface TrustScore {
+    score: number;
+    level: 'new' | 'established' | 'trusted' | 'verified';
+    totalTransactions: number;
+    successRate: number;
+    ratings?: Rating[];
+}
+export interface Rating {
+    rating: number;
+    comment?: string;
+    from: string;
+    createdAt: string;
+}
+export interface Agent {
+    address: string;
+    name: string;
+    capabilities: string[];
+    pricing?: Record<string, string>;
+    trustScore?: TrustScore;
+    metadata?: Record<string, any>;
+}
+export interface TransferOptions {
+    to: string;
+    amount: string;
+    memo?: string;
+    idempotencyKey?: string;
+}
+export interface EscrowOptions {
+    amount: string;
+    recipient: string;
+    conditions?: EscrowConditions;
+    template?: 'freelance' | 'marketplace' | 'rental';
+    deadline?: string;
+    milestones?: {
+        name: string;
+        amount: string;
+    }[];
+}
+export interface DiscoverOptions {
+    capability?: string;
+    minTrustScore?: number;
+    maxPrice?: string;
+    limit?: number;
+}
+export interface AutonomousConfig {
+    enabled: boolean;
+    dailyLimit: string;
+    perTransactionLimit: string;
+    autoApproveBelow: string;
+    allowedCapabilities: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/x402-client.d.ts

@@ -0,0 +1,127 @@
+/**
+ * x402 Payment-Enabled HTTP Client
+ *
+ * Wraps fetch() to automatically handle 402 Payment Required responses.
+ * Uses Circle Programmable Wallets to pay and retry with signature.
+ */
+import { CircleClient } from './circle-client';
+export interface PaymentChallenge {
+    'x-payment-required': {
+        version: '1';
+        network: string;
+        receiver: string;
+        asset: string;
+        amount: string;
+        description: string;
+        expires: number;
+        nonce: string;
+    };
+}
+export interface PaymentReceipt {
+    url: string;
+    challenge: PaymentChallenge['x-payment-required'];
+    txHash: string;
+    signature: string;
+    paidAt: string;
+    expiresAt: number;
+}
+export interface X402ClientConfig {
+    wallet: CircleClient;
+    walletId?: string;
+    maxAutoPayUSDC?: string;
+    requireConfirmation?: boolean;
+    cacheReceipts?: boolean;
+    cacheDir?: string;
+    onPayment?: (amount: string, url: string, txHash: string) => void;
+    onChallenge?: (challenge: PaymentChallenge) => void;
+    onVerified?: (receipt: PaymentReceipt) => void;
+    onError?: (error: Error, url: string) => void;
+}
+/**
+ * x402-enabled fetch function
+ */
+export type X402Fetch = (url: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/**
+ * Create a payment-enabled fetch wrapper
+ */
+export declare function createX402Fetch(config: X402ClientConfig): X402Fetch;
+/**
+ * X402 HTTP Client
+ */
+export declare class X402Client {
+    private wallet;
+    private walletId?;
+    private maxAutoPayUSDC?;
+    private requireConfirmation;
+    private cacheReceipts;
+    private cacheDir;
+    private onPayment?;
+    private onChallenge?;
+    private onVerified?;
+    private onError?;
+    private receiptCache;
+    constructor(config: X402ClientConfig);
+    /**
+     * Main fetch method - handles 402 automatically
+     */
+    fetch(url: string | URL | Request, init?: RequestInit): Promise<Response>;
+    /**
+     * Handle 402 Payment Required response
+     */
+    private handlePaymentRequired;
+    /**
+     * Execute USDC payment via Circle
+     */
+    private executePayment;
+    /**
+     * Fetch with payment signature header
+     */
+    private fetchWithPayment;
+    /**
+     * Parse payment challenge from 402 response
+     */
+    private parsePaymentChallenge;
+    /**
+     * Generate payment signature from challenge and tx hash
+     */
+    private generatePaymentSignature;
+    /**
+     * Confirm payment with user (if required)
+     */
+    private confirmPayment;
+    /**
+     * Get cached receipt for URL
+     */
+    private getCachedReceipt;
+    /**
+     * Cache payment receipt
+     */
+    private cacheReceipt;
+    /**
+     * Load cached receipts from disk
+     */
+    private loadReceiptCache;
+    /**
+     * Get receipt history
+     */
+    getReceiptHistory(): Promise<PaymentReceipt[]>;
+    /**
+     * Clear receipt cache
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Extract URL string from various input types
+     */
+    private getUrlString;
+}
+/**
+ * Helper: Create simple x402 client with minimal config
+ */
+export declare function simpleX402Fetch(wallet: CircleClient, maxAutoPayUSDC?: string): X402Fetch;
+declare const _default: {
+    createX402Fetch: typeof createX402Fetch;
+    simpleX402Fetch: typeof simpleX402Fetch;
+    X402Client: typeof X402Client;
+};
+export default _default;
+//# sourceMappingURL=x402-client.d.ts.map

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

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