pay-lobster 1.0.0

package/dist/circle-client.js

@@ -0,0 +1,266 @@
+"use strict";
+/**
+ * Circle Programmable Wallets Client
+ *
+ * Wrapper around Circle's Developer-Controlled Wallets API
+ * for USDC operations on testnet.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircleClient = exports.CHAIN_NAMES = exports.USDC_TOKENS = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+// Testnet USDC Token IDs (from Circle's registry)
+exports.USDC_TOKENS = {
+    'ETH-SEPOLIA': 'eth-sepolia-usdc',
+    'MATIC-AMOY': 'matic-amoy-usdc',
+    'AVAX-FUJI': 'avax-fuji-usdc',
+    'ARB-SEPOLIA': 'arb-sepolia-usdc',
+};
+exports.CHAIN_NAMES = {
+    'ETH-SEPOLIA': 'Ethereum Sepolia',
+    'MATIC-AMOY': 'Polygon Amoy',
+    'AVAX-FUJI': 'Avalanche Fuji',
+    'ARB-SEPOLIA': 'Arbitrum Sepolia',
+};
+/**
+ * Circle Programmable Wallets Client
+ */
+class CircleClient {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.entitySecret = config.entitySecret;
+        this.baseUrl = config.baseUrl || 'https://api.circle.com/v1/w3s';
+    }
+    /**
+     * Generate entity secret ciphertext for API calls
+     */
+    generateEntitySecretCiphertext() {
+        // Entity secret should be hex-encoded 32 bytes
+        const entitySecretBuffer = Buffer.from(this.entitySecret, 'hex');
+        // Generate random IV
+        const iv = crypto_1.default.randomBytes(12);
+        // For demo purposes, return base64 encoded secret
+        // In production, this would use Circle's public key for encryption
+        return Buffer.concat([iv, entitySecretBuffer]).toString('base64');
+    }
+    /**
+     * Make authenticated API request
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        const options = {
+            method,
+            headers,
+        };
+        if (body) {
+            // Add idempotency key for mutations
+            if (method !== 'GET') {
+                body.idempotencyKey = crypto_1.default.randomUUID();
+            }
+            // Add entity secret ciphertext for transaction operations
+            if (path.includes('/transactions') || path.includes('/wallets')) {
+                body.entitySecretCiphertext = this.generateEntitySecretCiphertext();
+            }
+            options.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Circle API error (${response.status}): ${error}`);
+        }
+        const data = await response.json();
+        return data.data || data;
+    }
+    // ============ Wallet Set Operations ============
+    /**
+     * Create a new wallet set
+     */
+    async createWalletSet(name) {
+        return this.request('POST', '/developer/walletSets', { name });
+    }
+    /**
+     * List all wallet sets
+     */
+    async listWalletSets() {
+        const result = await this.request('GET', '/developer/walletSets');
+        return result.walletSets || [];
+    }
+    // ============ Wallet Operations ============
+    /**
+     * Create wallets in a wallet set
+     */
+    async createWallets(walletSetId, blockchains, count = 1) {
+        const result = await this.request('POST', '/developer/wallets', {
+            walletSetId,
+            blockchains,
+            count,
+        });
+        return result.wallets || [];
+    }
+    /**
+     * Get wallet by ID
+     */
+    async getWallet(walletId) {
+        return this.request('GET', `/wallets/${walletId}`);
+    }
+    /**
+     * List all wallets
+     */
+    async listWallets() {
+        const result = await this.request('GET', '/wallets');
+        return result.wallets || [];
+    }
+    // ============ Balance Operations ============
+    /**
+     * Get token balances for a wallet
+     */
+    async getBalances(walletId) {
+        const result = await this.request('GET', `/wallets/${walletId}/balances`);
+        return result.tokenBalances || [];
+    }
+    /**
+     * Get USDC balance across all wallets
+     */
+    async getAllUSDCBalances() {
+        const wallets = await this.listWallets();
+        const results = [];
+        for (const wallet of wallets) {
+            try {
+                const balances = await this.getBalances(wallet.id);
+                const usdcBalance = balances.find(b => b.token.symbol === 'USDC');
+                results.push({
+                    wallet,
+                    balance: usdcBalance?.amount || '0',
+                    chain: wallet.blockchain,
+                });
+            }
+            catch (err) {
+                console.error(`Failed to get balance for wallet ${wallet.id}:`, err);
+            }
+        }
+        return results;
+    }
+    // ============ Transaction Operations ============
+    /**
+     * Send USDC to an address
+     */
+    async sendUSDC(options) {
+        const wallet = await this.getWallet(options.fromWalletId);
+        const tokenId = options.tokenId || exports.USDC_TOKENS[wallet.blockchain];
+        if (!tokenId) {
+            throw new Error(`No USDC token ID found for chain ${wallet.blockchain}`);
+        }
+        return this.request('POST', '/developer/transactions/transfer', {
+            walletId: options.fromWalletId,
+            tokenId,
+            destinationAddress: options.toAddress,
+            amounts: [options.amount],
+            fee: {
+                type: 'level',
+                config: {
+                    feeLevel: options.feeLevel || 'MEDIUM',
+                },
+            },
+        });
+    }
+    /**
+     * Get transaction by ID
+     */
+    async getTransaction(transactionId) {
+        return this.request('GET', `/transactions/${transactionId}`);
+    }
+    /**
+     * List recent transactions
+     */
+    async listTransactions(walletId) {
+        const path = walletId
+            ? `/wallets/${walletId}/transactions`
+            : '/transactions';
+        const result = await this.request('GET', path);
+        return result.transactions || [];
+    }
+    // ============ CCTP Bridge Operations ============
+    /**
+     * Bridge USDC across chains via CCTP
+     */
+    async bridgeUSDC(options) {
+        // CCTP bridge is done through contract interactions
+        // This is a simplified version - full implementation would use
+        // Circle's CCTP contracts directly
+        return this.request('POST', '/developer/transactions/contractExecution', {
+            walletId: options.fromWalletId,
+            contractAddress: this.getCCTPContractAddress(options.fromChain),
+            abiFunctionSignature: 'depositForBurn(uint256,uint32,bytes32,address)',
+            abiParameters: [
+                options.amount,
+                this.getChainDomain(options.toChain),
+                this.addressToBytes32(options.toAddress),
+                exports.USDC_TOKENS[options.fromChain],
+            ],
+            fee: {
+                type: 'level',
+                config: { feeLevel: 'HIGH' },
+            },
+        });
+    }
+    /**
+     * Get CCTP TokenMessenger contract address for chain
+     */
+    getCCTPContractAddress(chain) {
+        const contracts = {
+            'ETH-SEPOLIA': '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
+            'AVAX-FUJI': '0xeb08f243E5d3FCFF26A9E38Ae5520A669f4019d0',
+            'ARB-SEPOLIA': '0x9f3B8679c73C2Fef8b59B4f3444d4e156fb70AA5',
+        };
+        return contracts[chain] || '';
+    }
+    /**
+     * Get CCTP domain ID for chain
+     */
+    getChainDomain(chain) {
+        const domains = {
+            'ETH-SEPOLIA': 0,
+            'AVAX-FUJI': 1,
+            'ARB-SEPOLIA': 3,
+            'MATIC-AMOY': 7,
+        };
+        return domains[chain] || 0;
+    }
+    /**
+     * Convert address to bytes32 format
+     */
+    addressToBytes32(address) {
+        return '0x' + address.slice(2).padStart(64, '0');
+    }
+    // ============ Utility Methods ============
+    /**
+     * Format USDC amount for display
+     */
+    static formatUSDC(amount) {
+        const num = parseFloat(amount);
+        return `${num.toFixed(2)} USDC`;
+    }
+    /**
+     * Parse human-readable amount to wei
+     */
+    static parseAmount(amount) {
+        // USDC has 6 decimals
+        const num = parseFloat(amount);
+        return (num * 1000000).toString();
+    }
+    /**
+     * Validate Ethereum address
+     */
+    static isValidAddress(address) {
+        return /^0x[a-fA-F0-9]{40}$/.test(address);
+    }
+}
+exports.CircleClient = CircleClient;
+exports.default = CircleClient;
+//# sourceMappingURL=circle-client.js.map

package/dist/circle-client.js.map

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

package/dist/commission.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Commission Splitter Module
+ *
+ * Auto-distribute USDC commissions between multiple parties:
+ * agents, brokers, referral partners, team members.
+ */
+export interface SplitRecipient {
+    id: string;
+    name: string;
+    role: 'listing_agent' | 'buyer_agent' | 'broker' | 'referral' | 'team_member' | 'company' | 'custom';
+    walletAddress: string;
+    splitType: 'percentage' | 'fixed';
+    splitValue: string;
+    minAmount?: string;
+    maxAmount?: string;
+    tier?: number;
+}
+export interface CommissionSplit {
+    id: string;
+    name: string;
+    description?: string;
+    propertyAddress?: string;
+    mlsNumber?: string;
+    closingDate?: string;
+    salePrice?: string;
+    totalCommission: string;
+    chain: string;
+    sourceWalletId: string;
+    recipients: SplitRecipient[];
+    payouts: {
+        recipientId: string;
+        amount: string;
+        status: 'pending' | 'processing' | 'sent' | 'failed';
+        txHash?: string;
+        sentAt?: string;
+        error?: string;
+    }[];
+    status: 'draft' | 'ready' | 'processing' | 'completed' | 'partial' | 'failed';
+    executeAt?: string;
+    executedAt?: string;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SplitTemplate {
+    id: string;
+    name: string;
+    description?: string;
+    recipients: {
+        role: SplitRecipient['role'];
+        splitType: SplitRecipient['splitType'];
+        splitValue: string;
+        tier?: number;
+    }[];
+    usageCount: number;
+    lastUsedAt?: string;
+    createdAt: string;
+}
+/**
+ * Commission Splitter
+ */
+export declare class CommissionSplitter {
+    private splitsPath;
+    private templatesPath;
+    constructor(dataDir?: string);
+    private loadSplits;
+    private saveSplits;
+    private loadTemplates;
+    private saveTemplates;
+    /**
+     * Create a commission split
+     */
+    createSplit(params: {
+        name: string;
+        totalCommission: string;
+        chain: string;
+        sourceWalletId: string;
+        recipients: Omit<SplitRecipient, 'id'>[];
+        propertyAddress?: string;
+        mlsNumber?: string;
+        closingDate?: string;
+        salePrice?: string;
+        executeAt?: string;
+        notes?: string;
+    }): Promise<CommissionSplit>;
+    /**
+     * Create split from template
+     */
+    createFromTemplate(templateId: string, params: {
+        totalCommission: string;
+        chain: string;
+        sourceWalletId: string;
+        recipientAddresses: {
+            role: string;
+            name: string;
+            address: string;
+        }[];
+        propertyAddress?: string;
+        closingDate?: string;
+        salePrice?: string;
+    }): Promise<CommissionSplit>;
+    /**
+     * Quick split for common scenarios
+     */
+    quickSplit(params: {
+        totalCommission: string;
+        chain: string;
+        sourceWalletId: string;
+        scenario: 'listing_side' | 'buyer_side' | 'both_sides' | 'referral';
+        agent: {
+            name: string;
+            address: string;
+            split?: string;
+        };
+        broker: {
+            name: string;
+            address: string;
+            split?: string;
+        };
+        referral?: {
+            name: string;
+            address: string;
+            split?: string;
+        };
+        propertyAddress?: string;
+    }): Promise<CommissionSplit>;
+    /**
+     * Calculate payouts for all recipients
+     */
+    private calculatePayouts;
+    /**
+     * Validate splits add up correctly
+     */
+    private validateSplits;
+    /**
+     * Execute a split (send all payouts)
+     * Returns the split with updated payout statuses
+     */
+    execute(splitId: string, sendFn: (to: string, amount: string, chain: string) => Promise<{
+        txHash: string;
+    }>): Promise<CommissionSplit | null>;
+    /**
+     * Retry failed payouts
+     */
+    retryFailed(splitId: string, sendFn: (to: string, amount: string, chain: string) => Promise<{
+        txHash: string;
+    }>): Promise<CommissionSplit | null>;
+    /**
+     * Create a split template
+     */
+    createTemplate(params: {
+        name: string;
+        description?: string;
+        recipients: SplitTemplate['recipients'];
+    }): Promise<SplitTemplate>;
+    /**
+     * List templates
+     */
+    listTemplates(): Promise<SplitTemplate[]>;
+    /**
+     * Get common RE templates
+     */
+    getDefaultTemplates(): Promise<SplitTemplate[]>;
+    /**
+     * Get split by ID
+     */
+    get(id: string): Promise<CommissionSplit | null>;
+    /**
+     * List splits with filters
+     */
+    list(filters?: {
+        status?: CommissionSplit['status'];
+        recipientAddress?: string;
+        fromDate?: string;
+        toDate?: string;
+    }): Promise<CommissionSplit[]>;
+    /**
+     * Get pending splits (ready but not executed)
+     */
+    getPending(): Promise<CommissionSplit[]>;
+    /**
+     * Get splits due for execution
+     */
+    getDue(): Promise<CommissionSplit[]>;
+    /**
+     * Format split summary
+     */
+    formatSplitSummary(split: CommissionSplit): string;
+}
+export default CommissionSplitter;
+//# sourceMappingURL=commission.d.ts.map

package/dist/commission.d.ts.map

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