envoy-pay 0.1.0

package/dist/esm/wallet/intent-resolver.js

@@ -0,0 +1,141 @@
+/**
+ * IntentResolver — Parses natural-language payment intents into PaymentPlans.
+ *
+ * Agents express payment desires as simple strings ("pay $5", "send 10 USDC
+ * to 0x1234..."). The IntentResolver parses these into structured PayIntent
+ * objects, then delegates to ChainRouter for execution planning.
+ *
+ * Supports:
+ * - "$5" / "$5.00" — USD amounts
+ * - "5 USDC" / "10 XLM" — Asset-specific amounts
+ * - "to 0x..." / "to G..." / "to ..." — destination extraction
+ * - "memo: invoice-123" — memo extraction
+ *
+ * @see ERC-7521 — Intent-centric execution pattern
+ */
+/**
+ * Pattern: "$5.00" or "$5"
+ */
+const USD_AMOUNT_RE = /\$(\d+(?:\.\d{1,2})?)/;
+/**
+ * Pattern: "5 USDC" or "10.5 ETH"
+ */
+const ASSET_AMOUNT_RE = /(\d+(?:\.\d+)?)\s+(USDC|ETH|XLM|SOL|USD|USDT|DAI|BTC)/i;
+/**
+ * Pattern: Ethereum-style address "0x..." (42 chars)
+ */
+const ETH_ADDRESS_RE = /\b(0x[a-fA-F0-9]{40})\b/;
+/**
+ * Pattern: Stellar-style address "G..." (56 chars)
+ */
+const STELLAR_ADDRESS_RE = /\b(G[A-Z2-7]{55})\b/;
+/**
+ * Pattern: Solana-style address (base58, 32-44 chars)
+ */
+const SOLANA_ADDRESS_RE = /\b([1-9A-HJ-NP-Za-km-z]{32,44})\b/;
+/**
+ * Pattern: "memo: <text>" or "memo:<text>"
+ */
+const MEMO_RE = /memo:\s*([^\s,]+)/i;
+/**
+ * Rough USD rates for intent parsing (same as BalanceAggregator).
+ */
+const INTENT_RATES = {
+    USDC: 1,
+    USDT: 1,
+    DAI: 1,
+    USD: 1,
+    cUSD: 1,
+    CUSD: 1,
+    cEUR: 1.08,
+    CEUR: 1.08,
+    cREAL: 0.2,
+    CREAL: 0.2,
+    CELO: 0.7,
+    ETH: 3200,
+    XLM: 0.12,
+    SOL: 170,
+    BTC: 95000,
+};
+export class IntentResolver {
+    /**
+     * Parse a natural-language payment intent string into a structured PayIntent.
+     *
+     * @example
+     * resolve('pay $5 to 0x1234...');           // { amount: '5.00', destination: '0x1234...' }
+     * resolve('send 100 USDC memo: inv-42');    // { amount: '100', asset: 'USDC', memo: 'inv-42' }
+     * resolve('$0.50');                          // { amount: '0.50' }
+     */
+    resolve(input) {
+        const intent = {
+            amount: '0',
+        };
+        // ── Extract USD amount ──────────────────────────────────────────
+        const usdMatch = input.match(USD_AMOUNT_RE);
+        if (usdMatch) {
+            intent.amount = usdMatch[1];
+            intent.asset = 'USDC';
+        }
+        // ── Extract asset-denominated amount ────────────────────────────
+        const assetMatch = input.match(ASSET_AMOUNT_RE);
+        if (assetMatch) {
+            const rawAmount = parseFloat(assetMatch[1]);
+            const asset = assetMatch[2].toUpperCase();
+            intent.asset = asset;
+            // Convert to USD for the amount field
+            const rate = INTENT_RATES[asset] ?? 1;
+            intent.amount = (rawAmount * rate).toFixed(2);
+        }
+        // ── Extract destination ─────────────────────────────────────────
+        const ethMatch = input.match(ETH_ADDRESS_RE);
+        if (ethMatch) {
+            intent.destination = ethMatch[1];
+        }
+        else {
+            const stellarMatch = input.match(STELLAR_ADDRESS_RE);
+            if (stellarMatch) {
+                intent.destination = stellarMatch[1];
+            }
+            else {
+                const solanaMatch = input.match(SOLANA_ADDRESS_RE);
+                if (solanaMatch) {
+                    intent.destination = solanaMatch[1];
+                }
+            }
+        }
+        // ── Extract memo ────────────────────────────────────────────────
+        const memoMatch = input.match(MEMO_RE);
+        if (memoMatch) {
+            intent.memo = memoMatch[1];
+        }
+        return intent;
+    }
+    /**
+     * Validate that a PayIntent has the minimum required fields.
+     */
+    validate(intent) {
+        const errors = [];
+        const amount = parseFloat(intent.amount);
+        if (isNaN(amount) || amount <= 0) {
+            errors.push('Amount must be a positive number');
+        }
+        if (amount > 1_000_000) {
+            errors.push('Amount exceeds maximum ($1,000,000)');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Convert a raw USD amount string to a specific asset amount.
+     */
+    usdToAsset(usdAmount, asset) {
+        const usd = parseFloat(usdAmount);
+        if (isNaN(usd))
+            return '0';
+        const rate = INTENT_RATES[asset.toUpperCase()] ?? 1;
+        return (usd / rate).toFixed(asset.toUpperCase() === 'XLM' ? 7 : 6);
+    }
+}
+//# sourceMappingURL=intent-resolver.js.map

package/dist/esm/wallet/intent-resolver.js.map

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

package/dist/esm/wallet/session-manager.js

@@ -0,0 +1,166 @@
+/**
+ * SessionManager — Scoped, time-limited permission management.
+ *
+ * Implements session-key patterns inspired by EIP-7702, allowing
+ * agent owners to grant agents time-limited, capped permissions
+ * without exposing master private keys.
+ *
+ * Sessions enforce:
+ * - Per-transaction caps
+ * - Total session budget
+ * - Destination whitelists
+ * - Chain restrictions
+ * - Time-based expiry
+ *
+ * @see EIP-7702 — EOA → Smart Account delegation
+ * @see ERC-4337 — Account Abstraction session keys
+ */
+/**
+ * Generate a unique session ID.
+ */
+function generateSessionId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 10);
+    return `sess_${timestamp}_${random}`;
+}
+export class SessionManager {
+    sessions = new Map();
+    /**
+     * Create a new session with scoped permissions.
+     */
+    createSession(permissions) {
+        // Validate permissions
+        if (permissions.maxPerTransaction <= 0) {
+            throw new Error('maxPerTransaction must be positive');
+        }
+        if (permissions.maxTotal <= 0) {
+            throw new Error('maxTotal must be positive');
+        }
+        if (permissions.maxPerTransaction > permissions.maxTotal) {
+            throw new Error('maxPerTransaction cannot exceed maxTotal');
+        }
+        if (permissions.expiresAt.getTime() <= Date.now()) {
+            throw new Error('Session expiry must be in the future');
+        }
+        const session = {
+            id: generateSessionId(),
+            permissions,
+            spent: 0,
+            txCount: 0,
+            createdAt: new Date(),
+            isActive: true,
+        };
+        this.sessions.set(session.id, session);
+        return session;
+    }
+    /**
+     * Revoke (deactivate) a session by ID.
+     */
+    revokeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return false;
+        session.isActive = false;
+        return true;
+    }
+    /**
+     * Check if a proposed spend is allowed within a session's permissions.
+     */
+    checkSession(sessionId, amountUsd, destination, chain) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return { allowed: false, reason: 'Session not found' };
+        }
+        if (!session.isActive) {
+            return { allowed: false, reason: 'Session revoked' };
+        }
+        // Check expiry
+        if (Date.now() > session.permissions.expiresAt.getTime()) {
+            session.isActive = false;
+            return { allowed: false, reason: 'Session expired' };
+        }
+        // Check per-transaction limit
+        if (amountUsd > session.permissions.maxPerTransaction) {
+            return {
+                allowed: false,
+                reason: `Amount $${amountUsd} exceeds per-tx limit of $${session.permissions.maxPerTransaction}`,
+            };
+        }
+        // Check total session budget
+        if (session.spent + amountUsd > session.permissions.maxTotal) {
+            return {
+                allowed: false,
+                reason: `Amount $${amountUsd} would exceed session budget of $${session.permissions.maxTotal} (spent: $${session.spent})`,
+            };
+        }
+        // Check destination whitelist
+        const allowedDest = session.permissions.allowedDestinations;
+        if (allowedDest && allowedDest.length > 0 && destination) {
+            if (!allowedDest.includes(destination)) {
+                return {
+                    allowed: false,
+                    reason: `Destination ${destination} not in session whitelist`,
+                };
+            }
+        }
+        // Check chain whitelist
+        const allowedChains = session.permissions.allowedChains;
+        if (allowedChains && allowedChains.length > 0 && chain) {
+            if (!allowedChains.includes(chain)) {
+                return {
+                    allowed: false,
+                    reason: `Chain ${chain} not allowed in this session`,
+                };
+            }
+        }
+        return { allowed: true };
+    }
+    /**
+     * Record a successful spend against a session.
+     */
+    recordSpend(sessionId, amountUsd) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session ${sessionId} not found`);
+        session.spent += amountUsd;
+        session.txCount += 1;
+    }
+    /**
+     * Get a session by ID.
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * List all active sessions.
+     */
+    getActiveSessions() {
+        const now = Date.now();
+        return Array.from(this.sessions.values()).filter((s) => s.isActive && now <= s.permissions.expiresAt.getTime());
+    }
+    /**
+     * Get the remaining budget for a session.
+     */
+    getRemainingBudget(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return 0;
+        return Math.max(0, session.permissions.maxTotal - session.spent);
+    }
+    /**
+     * Prune expired sessions from memory.
+     */
+    pruneExpired() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [id, session] of this.sessions) {
+            if (now > session.permissions.expiresAt.getTime()) {
+                session.isActive = false;
+                this.sessions.delete(id);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/esm/wallet/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/wallet/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,SAAS,iBAAiB;IACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,OAAO,cAAc;IACjB,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEnD;;OAEG;IACH,aAAa,CAAC,WAA+B;QAC3C,uBAAuB;QACvB,IAAI,WAAW,CAAC,iBAAiB,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,WAAW,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,WAAW,CAAC,iBAAiB,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,OAAO,GAAY;YACvB,EAAE,EAAE,iBAAiB,EAAE;YACvB,WAAW;YACX,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,IAAI;SACf,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAE3B,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CACV,SAAiB,EACjB,SAAiB,EACjB,WAAoB,EACpB,KAAc;QAEd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACvD,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACvD,CAAC;QAED,8BAA8B;QAC9B,IAAI,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,WAAW,SAAS,6BAA6B,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE;aACjG,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,WAAW,SAAS,oCAAoC,OAAO,CAAC,WAAW,CAAC,QAAQ,aAAa,OAAO,CAAC,KAAK,GAAG;aAC1H,CAAC;QACJ,CAAC;QAED,8BAA8B;QAC9B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC;QAC5D,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;YACzD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,eAAe,WAAW,2BAA2B;iBAC9D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC;QACxD,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;YACvD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,SAAS,KAAK,8BAA8B;iBACrD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB,EAAE,SAAiB;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,YAAY,CAAC,CAAC;QAEhE,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;QAC3B,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,SAAiB;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;gBAClD,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACzB,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/esm/wallet/types.js

@@ -0,0 +1,13 @@
+/**
+ * Wallet Abstraction Types — Unified multi-chain balance & routing.
+ *
+ * These types power the UnifiedWallet, which abstracts away chain selection
+ * so that AI agents can simply say "pay $5" without knowing which chain,
+ * token, or gas mechanics are involved.
+ *
+ * @see EIP-7702 — Session keys & smart account delegation
+ * @see ERC-7521 — Intent-based execution
+ * @see ERC-4337 — Account abstraction (paymasters)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/wallet/types.js.map

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

package/dist/esm/wallet/unified-wallet.js

@@ -0,0 +1,249 @@
+/**
+ * UnifiedWallet — Single entry point for multi-chain payments.
+ *
+ * Wraps multiple PaymentAdapters behind a unified interface so that
+ * AI agents can simply call `wallet.pay('$5')` without knowing about
+ * chains, tokens, gas, or atomic units.
+ *
+ * Architecture:
+ * ```
+ * Agent → UnifiedWallet → ChainRouter → best PaymentAdapter → settlement
+ *                       → BalanceAggregator → unified balance
+ *                       → IntentResolver → structured payment intent
+ *                       → SessionManager → scoped permissions
+ * ```
+ *
+ * @example
+ * ```ts
+ * const wallet = new UnifiedWallet({
+ *   adapters: [evmAdapter, stellarAdapter, solanaAdapter],
+ *   strategy: 'cheapest',
+ * });
+ *
+ * // Agent just pays — no chain knowledge needed
+ * const result = await wallet.pay({ amount: '5.00' });
+ * ```
+ *
+ * @see EIP-7702 — Smart account delegation
+ * @see ERC-7521 — Intent-based execution
+ */
+import { BalanceAggregator } from './balance-aggregator.js';
+import { ChainRouter } from './chain-router.js';
+import { IntentResolver } from './intent-resolver.js';
+import { SessionManager } from './session-manager.js';
+export class UnifiedWallet {
+    adapters;
+    strategy;
+    log;
+    fallbackIndex;
+    balanceAggregator;
+    chainRouter;
+    intentResolver;
+    sessionManager;
+    constructor(options) {
+        if (!options.adapters || options.adapters.length === 0) {
+            throw new Error('UnifiedWallet requires at least one adapter');
+        }
+        this.adapters = options.adapters;
+        this.strategy = options.strategy ?? 'cheapest';
+        this.log = options.logger ?? (() => { });
+        this.fallbackIndex = options.fallbackIndex ?? 0;
+        this.balanceAggregator = new BalanceAggregator(this.adapters);
+        this.chainRouter = new ChainRouter(this.adapters);
+        this.intentResolver = new IntentResolver();
+        this.sessionManager = new SessionManager();
+    }
+    // ═══ Core API ═════════════════════════════════════════════════════
+    /**
+     * Execute a payment using the optimal chain route.
+     * The agent simply provides an amount — everything else is automatic.
+     */
+    async pay(intent) {
+        const strategy = intent.strategy ?? this.strategy;
+        this.log(`[Wallet] 💳 Pay intent: $${intent.amount} (strategy: ${strategy})`);
+        // Validate intent
+        const validation = this.intentResolver.validate(intent);
+        if (!validation.valid) {
+            return {
+                success: false,
+                transactionHash: null,
+                chain: 'none',
+                caip2Id: 'none',
+                amountUsd: intent.amount,
+                feeUsd: '0',
+                error: validation.errors.join('; '),
+            };
+        }
+        // Route to best chain
+        const plan = this.chainRouter.getBestPlan(intent, strategy);
+        if (!plan) {
+            this.log('[Wallet] ❌ No viable route found');
+            return {
+                success: false,
+                transactionHash: null,
+                chain: 'none',
+                caip2Id: 'none',
+                amountUsd: intent.amount,
+                feeUsd: '0',
+                error: 'No viable payment route found',
+            };
+        }
+        this.log(`[Wallet] 🔀 Routed to ${plan.chain} (${plan.caip2Id}), fee: $${plan.estimatedFeeUsd}`);
+        // Execute payment
+        return this.executePlan(plan, intent);
+    }
+    /**
+     * Pay using a natural-language string.
+     * @example wallet.payIntent('pay $5 to 0x1234...')
+     */
+    async payIntent(intentString) {
+        this.log(`[Wallet] 🧠 Resolving intent: "${intentString}"`);
+        const intent = this.intentResolver.resolve(intentString);
+        return this.pay(intent);
+    }
+    // ═══ Balance API ══════════════════════════════════════════════════
+    /**
+     * Get the unified balance across all chains.
+     */
+    async getBalance() {
+        return this.balanceAggregator.getUnifiedBalance();
+    }
+    /**
+     * Get the total USD balance as a simple number.
+     */
+    async getTotalBalanceUsd() {
+        const balance = await this.balanceAggregator.getUnifiedBalance();
+        return balance.totalUsd;
+    }
+    /**
+     * Check if the wallet has enough funds for a payment.
+     */
+    async canAfford(amountUsd) {
+        return this.balanceAggregator.hasSufficientFunds(amountUsd);
+    }
+    // ═══ Routing API ══════════════════════════════════════════════════
+    /**
+     * Preview all routing options for a payment without executing.
+     */
+    previewRoutes(intent) {
+        const strategy = intent.strategy ?? this.strategy;
+        return this.chainRouter.route(intent, strategy);
+    }
+    /**
+     * Get the default routing strategy.
+     */
+    getStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Change the default routing strategy.
+     */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+        this.log(`[Wallet] ⚙️ Strategy changed to: ${strategy}`);
+    }
+    // ═══ Session API (EIP-7702 compatible) ════════════════════════════
+    /**
+     * Create a scoped session for this wallet.
+     */
+    createSession(permissions) {
+        const session = this.sessionManager.createSession(permissions);
+        this.log(`[Wallet] 🔑 Session created: ${session.id} (max: $${permissions.maxTotal})`);
+        return session;
+    }
+    /**
+     * Revoke a session.
+     */
+    revokeSession(sessionId) {
+        const revoked = this.sessionManager.revokeSession(sessionId);
+        if (revoked) {
+            this.log(`[Wallet] 🚫 Session revoked: ${sessionId}`);
+        }
+        return revoked;
+    }
+    // ═══ Adapter Access ═══════════════════════════════════════════════
+    /**
+     * Get the primary address (first adapter's address).
+     */
+    getAddress() {
+        return this.adapters[0].getAddress();
+    }
+    /**
+     * Get all adapter addresses.
+     */
+    getAddresses() {
+        return this.adapters.map((a) => ({
+            chain: a.chainName,
+            caip2Id: a.caip2Id,
+            address: a.getAddress(),
+        }));
+    }
+    /**
+     * Get the number of registered adapters.
+     */
+    getAdapterCount() {
+        return this.adapters.length;
+    }
+    /**
+     * Get a specific adapter by CAIP-2 ID.
+     */
+    getAdapter(caip2Id) {
+        return this.adapters.find((a) => a.caip2Id === caip2Id);
+    }
+    /**
+     * Expose the underlying adapter for EnvoyClient backward compatibility.
+     * Returns the first (default) adapter.
+     */
+    getDefaultAdapter() {
+        return this.adapters[this.fallbackIndex] ?? this.adapters[0];
+    }
+    // ═══ Internal ═════════════════════════════════════════════════════
+    /**
+     * Execute a resolved payment plan.
+     */
+    async executePlan(plan, intent) {
+        const destination = intent.destination ?? plan.adapter.getAddress();
+        try {
+            const txHash = await plan.adapter.pay(destination, plan.atomicAmount, plan.caip2Id);
+            if (txHash) {
+                this.log(`[Wallet] ✅ Payment settled on ${plan.chain}: ${txHash}`);
+                return {
+                    success: true,
+                    transactionHash: txHash,
+                    chain: plan.chain,
+                    caip2Id: plan.caip2Id,
+                    amountUsd: intent.amount,
+                    feeUsd: plan.estimatedFeeUsd.toFixed(4),
+                };
+            }
+            // Primary route failed — try fallback
+            return this.tryFallback(intent, plan.adapterIndex);
+        }
+        catch (error) {
+            this.log(`[Wallet] ⚠️ ${plan.chain} failed: ${error.message}`);
+            return this.tryFallback(intent, plan.adapterIndex);
+        }
+    }
+    /**
+     * Fallback: try next-best adapter if primary fails.
+     */
+    async tryFallback(intent, excludeIndex) {
+        const strategy = intent.strategy ?? this.strategy;
+        const allPlans = this.chainRouter.route(intent, strategy);
+        const fallbackPlans = allPlans.filter((p) => p.adapterIndex !== excludeIndex);
+        if (fallbackPlans.length === 0) {
+            return {
+                success: false,
+                transactionHash: null,
+                chain: 'none',
+                caip2Id: 'none',
+                amountUsd: intent.amount,
+                feeUsd: '0',
+                error: 'All payment routes failed',
+            };
+        }
+        this.log(`[Wallet] 🔄 Falling back to ${fallbackPlans[0].chain}`);
+        return this.executePlan(fallbackPlans[0], intent);
+    }
+}
+//# sourceMappingURL=unified-wallet.js.map

package/dist/esm/wallet/unified-wallet.js.map

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

package/dist/types/adapters/base.d.ts

@@ -0,0 +1,53 @@
+import { PaymentAdapter } from './types';
+import { Logger } from '../logger';
+export interface BaseAdapterOptions {
+    /** Hex private key (0x-prefixed). If omitted, a random key is generated. */
+    privateKey?: `0x${string}`;
+    /** 'mainnet' or 'testnet' (default: 'testnet') */
+    network?: 'mainnet' | 'testnet';
+    /** Optional custom RPC URL */
+    rpcUrl?: string;
+    /**
+     * Asset to settle with.
+     * - 'ETH' — native ETH transfer (default)
+     * - 'USDC' — ERC-20 USDC transfer via Circle's official contract
+     */
+    asset?: 'ETH' | 'USDC';
+    /** Optional logger. */
+    logger?: Logger;
+}
+/**
+ * BasePaymentAdapter — On-chain settlement on Base (Coinbase L2).
+ *
+ * Supports both native ETH transfers and USDC (ERC-20) transfers.
+ * Uses viem for lightweight, type-safe EVM interactions.
+ *
+ * Networks:
+ * - Base Mainnet (eip155:8453) — production
+ * - Base Sepolia (eip155:84532) — testnet
+ *
+ * @see https://base.org
+ * @see https://x402.org
+ */
+export declare class BasePaymentAdapter implements PaymentAdapter {
+    readonly chainName = "Base";
+    readonly caip2Id: string;
+    private wallet;
+    private publicClient;
+    private account;
+    private chain;
+    private asset;
+    private log;
+    constructor(options?: BaseAdapterOptions);
+    getAddress(): string;
+    /** Get native ETH balance (formatted). */
+    getBalance(): Promise<string>;
+    /** Get USDC balance (formatted, 6 decimals). */
+    getUsdcBalance(): Promise<string>;
+    pay(destination: string, amount: string, network: string): Promise<string | null>;
+    /** Execute a native ETH transfer. */
+    private payEth;
+    /** Execute a USDC ERC-20 transfer. */
+    private payUsdc;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAc,MAAM,WAAW,CAAC;AA+B/C,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,SAAgB,SAAS,UAAU;IACnC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,GAAG,CAAS;gBAER,OAAO,GAAE,kBAAuB;IAsB5C,UAAU,IAAI,MAAM;IAIpB,0CAA0C;IACpC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAOnC,gDAAgD;IAC1C,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBjC,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOzB,qCAAqC;YACvB,MAAM;IAuCpB,sCAAsC;YACxB,OAAO;CAkDtB"}