pay-lobster 1.0.0

package/dist/approvals.js

@@ -0,0 +1,406 @@
+"use strict";
+/**
+ * Transaction Approval System
+ *
+ * Multi-step approval workflow for large or sensitive transactions.
+ * Integrates with Clawdbot for conversational approvals.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApprovalManager = 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';
+/**
+ * Approval Manager
+ */
+class ApprovalManager {
+    constructor(dataDir = DATA_DIR) {
+        this.policiesPath = path_1.default.join(dataDir, 'approval-policies.json');
+        this.pendingPath = path_1.default.join(dataDir, 'pending-transactions.json');
+        this.spendingPath = path_1.default.join(dataDir, 'daily-spending.json');
+    }
+    async loadPolicies() {
+        try {
+            const data = await promises_1.default.readFile(this.policiesPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async savePolicies(policies) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.policiesPath), { recursive: true });
+        await promises_1.default.writeFile(this.policiesPath, JSON.stringify(policies, null, 2));
+    }
+    async loadPending() {
+        try {
+            const data = await promises_1.default.readFile(this.pendingPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async savePending(pending) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.pendingPath), { recursive: true });
+        await promises_1.default.writeFile(this.pendingPath, JSON.stringify(pending, null, 2));
+    }
+    async loadSpending() {
+        try {
+            const data = await promises_1.default.readFile(this.spendingPath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch {
+            return [];
+        }
+    }
+    async saveSpending(spending) {
+        await promises_1.default.mkdir(path_1.default.dirname(this.spendingPath), { recursive: true });
+        await promises_1.default.writeFile(this.spendingPath, JSON.stringify(spending, null, 2));
+    }
+    // ============ Policy Management ============
+    /**
+     * Create approval policy
+     */
+    async createPolicy(params) {
+        const policies = await this.loadPolicies();
+        const policy = {
+            id: crypto_1.default.randomUUID(),
+            name: params.name,
+            enabled: true,
+            conditions: params.conditions,
+            approvers: params.approvers,
+            requiredApprovals: params.requiredApprovals || 1,
+            timeout: params.timeout || 86400, // 24 hours default
+            timeoutAction: params.timeoutAction || 'cancel',
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        policies.push(policy);
+        await this.savePolicies(policies);
+        return policy;
+    }
+    /**
+     * Get active policies for a transaction
+     */
+    async getMatchingPolicies(tx) {
+        const policies = await this.loadPolicies();
+        const spending = await this.getDailySpending(tx.walletId);
+        const matchingPolicies = [];
+        for (const policy of policies) {
+            if (!policy.enabled)
+                continue;
+            const { conditions } = policy;
+            let matches = false;
+            // Check amount threshold
+            if (conditions.minAmount && parseFloat(tx.amount) >= parseFloat(conditions.minAmount)) {
+                matches = true;
+            }
+            // Check daily limit
+            if (conditions.maxDailyLimit) {
+                const todayTotal = parseFloat(spending?.total || '0') + parseFloat(tx.amount);
+                if (todayTotal > parseFloat(conditions.maxDailyLimit)) {
+                    matches = true;
+                }
+            }
+            // Check specific addresses
+            if (conditions.addresses && conditions.addresses.length > 0) {
+                if (conditions.addresses.some(a => a.toLowerCase() === tx.toAddress.toLowerCase())) {
+                    matches = true;
+                }
+            }
+            // Check chains
+            if (conditions.chains && conditions.chains.length > 0) {
+                if (conditions.chains.includes(tx.chain)) {
+                    matches = true;
+                }
+            }
+            // Always require approval
+            if (conditions.always) {
+                matches = true;
+            }
+            if (matches) {
+                matchingPolicies.push(policy);
+            }
+        }
+        return matchingPolicies;
+    }
+    /**
+     * List all policies
+     */
+    async listPolicies() {
+        return this.loadPolicies();
+    }
+    /**
+     * Toggle policy enabled state
+     */
+    async togglePolicy(id, enabled) {
+        const policies = await this.loadPolicies();
+        const policy = policies.find(p => p.id === id);
+        if (policy) {
+            policy.enabled = enabled;
+            policy.updatedAt = new Date().toISOString();
+            await this.savePolicies(policies);
+        }
+        return policy || null;
+    }
+    /**
+     * Delete policy
+     */
+    async deletePolicy(id) {
+        const policies = await this.loadPolicies();
+        const index = policies.findIndex(p => p.id === id);
+        if (index >= 0) {
+            policies.splice(index, 1);
+            await this.savePolicies(policies);
+            return true;
+        }
+        return false;
+    }
+    // ============ Pending Transactions ============
+    /**
+     * Submit transaction for approval
+     */
+    async submitForApproval(tx) {
+        // Check if approval is required
+        const policies = await this.getMatchingPolicies({
+            amount: tx.amount,
+            toAddress: tx.toAddress,
+            chain: tx.chain,
+            walletId: tx.fromWalletId,
+        });
+        // No policies match - auto-approve
+        if (policies.length === 0) {
+            return { approved: true };
+        }
+        // Use the strictest policy (most approvals required)
+        const policy = policies.reduce((strictest, p) => p.requiredApprovals > strictest.requiredApprovals ? p : strictest);
+        const pending = await this.loadPending();
+        const transaction = {
+            id: crypto_1.default.randomUUID(),
+            policyId: policy.id,
+            type: tx.type,
+            fromWalletId: tx.fromWalletId,
+            toAddress: tx.toAddress,
+            toName: tx.toName,
+            amount: tx.amount,
+            chain: tx.chain,
+            targetChain: tx.targetChain,
+            memo: tx.memo,
+            status: 'pending',
+            approvals: [],
+            requestedBy: tx.requestedBy,
+            createdAt: new Date().toISOString(),
+            expiresAt: new Date(Date.now() + policy.timeout * 1000).toISOString(),
+        };
+        pending.push(transaction);
+        await this.savePending(pending);
+        return transaction;
+    }
+    /**
+     * Approve or reject a pending transaction
+     */
+    async decide(txId, approverId, decision, note) {
+        const pending = await this.loadPending();
+        const tx = pending.find(t => t.id === txId);
+        if (!tx || tx.status !== 'pending') {
+            return null;
+        }
+        // Check if already decided by this approver
+        if (tx.approvals.some(a => a.approverId === approverId)) {
+            throw new Error('Already submitted decision');
+        }
+        // Check if approver is authorized
+        const policies = await this.loadPolicies();
+        const policy = policies.find(p => p.id === tx.policyId);
+        if (!policy || !policy.approvers.includes(approverId)) {
+            throw new Error('Not authorized to approve this transaction');
+        }
+        // Record decision
+        tx.approvals.push({
+            approverId,
+            decision,
+            timestamp: new Date().toISOString(),
+            note,
+        });
+        // Check if rejected
+        if (decision === 'reject') {
+            tx.status = 'rejected';
+            tx.rejectionReason = note || 'Rejected by approver';
+        }
+        // Check if enough approvals
+        else {
+            const approvalCount = tx.approvals.filter(a => a.decision === 'approve').length;
+            if (approvalCount >= policy.requiredApprovals) {
+                tx.status = 'approved';
+            }
+        }
+        await this.savePending(pending);
+        return tx;
+    }
+    /**
+     * Mark transaction as executed
+     */
+    async markExecuted(txId, txHash) {
+        const pending = await this.loadPending();
+        const tx = pending.find(t => t.id === txId);
+        if (tx && tx.status === 'approved') {
+            tx.status = 'executed';
+            tx.txHash = txHash;
+            tx.executedAt = new Date().toISOString();
+            // Record spending
+            await this.recordSpending(tx.fromWalletId, tx.amount, txHash);
+            await this.savePending(pending);
+        }
+        return tx || null;
+    }
+    /**
+     * Cancel a pending transaction
+     */
+    async cancel(txId, requesterId) {
+        const pending = await this.loadPending();
+        const tx = pending.find(t => t.id === txId);
+        if (tx && tx.status === 'pending' && tx.requestedBy === requesterId) {
+            tx.status = 'cancelled';
+            await this.savePending(pending);
+        }
+        return tx || null;
+    }
+    /**
+     * Get pending transactions
+     */
+    async getPending(options) {
+        let pending = await this.loadPending();
+        if (options?.status) {
+            pending = pending.filter(t => t.status === options.status);
+        }
+        if (options?.approverId) {
+            const policies = await this.loadPolicies();
+            const approverPolicies = policies.filter(p => p.approvers.includes(options.approverId)).map(p => p.id);
+            pending = pending.filter(t => approverPolicies.includes(t.policyId));
+        }
+        return pending.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+    }
+    /**
+     * Check and expire old transactions
+     */
+    async processExpired() {
+        const pending = await this.loadPending();
+        const policies = await this.loadPolicies();
+        const now = new Date();
+        const expired = [];
+        for (const tx of pending) {
+            if (tx.status !== 'pending')
+                continue;
+            if (new Date(tx.expiresAt) > now)
+                continue;
+            const policy = policies.find(p => p.id === tx.policyId);
+            if (policy?.timeoutAction === 'auto-approve') {
+                tx.status = 'approved';
+            }
+            else {
+                tx.status = 'expired';
+            }
+            expired.push(tx);
+        }
+        if (expired.length > 0) {
+            await this.savePending(pending);
+        }
+        return expired;
+    }
+    // ============ Daily Spending Tracking ============
+    /**
+     * Get daily spending for a wallet
+     */
+    async getDailySpending(walletId) {
+        const spending = await this.loadSpending();
+        const today = new Date().toISOString().split('T')[0];
+        return spending.find(s => s.date === today && s.walletId === walletId) || null;
+    }
+    /**
+     * Record spending
+     */
+    async recordSpending(walletId, amount, txHash) {
+        const spending = await this.loadSpending();
+        const today = new Date().toISOString().split('T')[0];
+        let todaySpending = spending.find(s => s.date === today && s.walletId === walletId);
+        if (!todaySpending) {
+            todaySpending = {
+                date: today,
+                walletId,
+                total: '0',
+                transactions: [],
+            };
+            spending.push(todaySpending);
+        }
+        todaySpending.total = (parseFloat(todaySpending.total) + parseFloat(amount)).toString();
+        todaySpending.transactions.push({
+            amount,
+            txHash,
+            timestamp: new Date().toISOString(),
+        });
+        // Keep only last 30 days
+        const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
+        const filtered = spending.filter(s => s.date >= thirtyDaysAgo);
+        await this.saveSpending(filtered);
+    }
+    /**
+     * Get spending history
+     */
+    async getSpendingHistory(walletId, days = 30) {
+        const spending = await this.loadSpending();
+        const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString().split('T')[0];
+        return spending
+            .filter(s => s.walletId === walletId && s.date >= cutoff)
+            .sort((a, b) => b.date.localeCompare(a.date));
+    }
+    // ============ Helpers ============
+    /**
+     * Format pending transaction for display
+     */
+    formatPendingTx(tx) {
+        const typeEmoji = tx.type === 'send' ? '📤' : tx.type === 'bridge' ? '🌉' : '🔄';
+        const statusEmoji = {
+            pending: '⏳',
+            approved: '✅',
+            rejected: '❌',
+            cancelled: '🚫',
+            expired: '⌛',
+            executed: '✓',
+        }[tx.status];
+        let text = `${typeEmoji} **${tx.amount} USDC** → ${tx.toName || this.shortAddress(tx.toAddress)}\n`;
+        text += `Status: ${statusEmoji} ${tx.status.toUpperCase()}\n`;
+        text += `Chain: ${tx.chain}${tx.targetChain ? ` → ${tx.targetChain}` : ''}\n`;
+        if (tx.approvals.length > 0) {
+            text += `Approvals: ${tx.approvals.filter(a => a.decision === 'approve').length}/${tx.approvals.length}\n`;
+        }
+        text += `Expires: ${new Date(tx.expiresAt).toLocaleString()}\n`;
+        if (tx.memo) {
+            text += `Memo: ${tx.memo}\n`;
+        }
+        return text;
+    }
+    shortAddress(address) {
+        return `${address.slice(0, 6)}...${address.slice(-4)}`;
+    }
+    /**
+     * Create default approval policy for new users
+     */
+    async createDefaultPolicy(approverIds) {
+        return this.createPolicy({
+            name: 'Large Transactions (>500 USDC)',
+            conditions: { minAmount: '500' },
+            approvers: approverIds,
+            requiredApprovals: 1,
+            timeout: 86400, // 24 hours
+            timeoutAction: 'cancel',
+        });
+    }
+}
+exports.ApprovalManager = ApprovalManager;
+exports.default = ApprovalManager;
+//# sourceMappingURL=approvals.js.map

package/dist/approvals.js.map

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

package/dist/circle-client.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Circle Programmable Wallets Client
+ *
+ * Wrapper around Circle's Developer-Controlled Wallets API
+ * for USDC operations on testnet.
+ */
+export interface CircleConfig {
+    apiKey: string;
+    entitySecret: string;
+    baseUrl?: string;
+}
+export interface Wallet {
+    id: string;
+    address: string;
+    blockchain: string;
+    state: string;
+    walletSetId: string;
+    createDate: string;
+}
+export interface WalletSet {
+    id: string;
+    name: string;
+    custodyType: string;
+    createDate: string;
+}
+export interface Balance {
+    token: {
+        id: string;
+        name: string;
+        symbol: string;
+        decimals: number;
+        blockchain: string;
+    };
+    amount: string;
+}
+export interface Transaction {
+    id: string;
+    state: string;
+    txHash?: string;
+    amounts: string[];
+    sourceAddress: string;
+    destinationAddress: string;
+    blockchain: string;
+    createDate: string;
+}
+export interface SendOptions {
+    fromWalletId: string;
+    toAddress: string;
+    amount: string;
+    tokenId?: string;
+    feeLevel?: 'LOW' | 'MEDIUM' | 'HIGH';
+}
+export interface BridgeOptions {
+    fromWalletId: string;
+    toAddress: string;
+    fromChain: string;
+    toChain: string;
+    amount: string;
+}
+export declare const USDC_TOKENS: Record<string, string>;
+export declare const CHAIN_NAMES: Record<string, string>;
+/**
+ * Circle Programmable Wallets Client
+ */
+export declare class CircleClient {
+    private apiKey;
+    private entitySecret;
+    private baseUrl;
+    constructor(config: CircleConfig);
+    /**
+     * Generate entity secret ciphertext for API calls
+     */
+    private generateEntitySecretCiphertext;
+    /**
+     * Make authenticated API request
+     */
+    private request;
+    /**
+     * Create a new wallet set
+     */
+    createWalletSet(name: string): Promise<WalletSet>;
+    /**
+     * List all wallet sets
+     */
+    listWalletSets(): Promise<WalletSet[]>;
+    /**
+     * Create wallets in a wallet set
+     */
+    createWallets(walletSetId: string, blockchains: string[], count?: number): Promise<Wallet[]>;
+    /**
+     * Get wallet by ID
+     */
+    getWallet(walletId: string): Promise<Wallet>;
+    /**
+     * List all wallets
+     */
+    listWallets(): Promise<Wallet[]>;
+    /**
+     * Get token balances for a wallet
+     */
+    getBalances(walletId: string): Promise<Balance[]>;
+    /**
+     * Get USDC balance across all wallets
+     */
+    getAllUSDCBalances(): Promise<{
+        wallet: Wallet;
+        balance: string;
+        chain: string;
+    }[]>;
+    /**
+     * Send USDC to an address
+     */
+    sendUSDC(options: SendOptions): Promise<Transaction>;
+    /**
+     * Get transaction by ID
+     */
+    getTransaction(transactionId: string): Promise<Transaction>;
+    /**
+     * List recent transactions
+     */
+    listTransactions(walletId?: string): Promise<Transaction[]>;
+    /**
+     * Bridge USDC across chains via CCTP
+     */
+    bridgeUSDC(options: BridgeOptions): Promise<Transaction>;
+    /**
+     * Get CCTP TokenMessenger contract address for chain
+     */
+    private getCCTPContractAddress;
+    /**
+     * Get CCTP domain ID for chain
+     */
+    private getChainDomain;
+    /**
+     * Convert address to bytes32 format
+     */
+    private addressToBytes32;
+    /**
+     * Format USDC amount for display
+     */
+    static formatUSDC(amount: string): string;
+    /**
+     * Parse human-readable amount to wei
+     */
+    static parseAmount(amount: string): string;
+    /**
+     * Validate Ethereum address
+     */
+    static isValidAddress(address: string): boolean;
+}
+export default CircleClient;
+//# sourceMappingURL=circle-client.d.ts.map

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

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