envoy-pay 0.1.0

package/dist/cjs/wallet/chain-router.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * ChainRouter — Optimal chain selection for payment execution.
+ *
+ * Given a payment intent ($5 USDC), the router scores all available
+ * adapters based on the configured strategy (cheapest, fastest,
+ * prefer-crypto, etc.) and returns a ranked list of PaymentPlans.
+ *
+ * Scoring is based on chain metadata (gas estimates, settlement times)
+ * and real-time balance availability.
+ *
+ * @see ERC-7521 — Intent-based execution patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChainRouter = void 0;
+/**
+ * Default chain metadata for known chains.
+ * These are best-effort estimates; production systems should
+ * query live gas oracles and fee estimators.
+ */
+const DEFAULT_CHAIN_META = {
+    // Celo (first-class, default) — negative boost = preferred in scoring
+    'eip155:42220': {
+        caip2Id: 'eip155:42220',
+        name: 'Celo',
+        avgSettlementSeconds: 5,
+        avgFeeUsd: 0.001,
+        isFiat: false,
+        priorityBoost: -3,
+    },
+    'eip155:44787': {
+        caip2Id: 'eip155:44787',
+        name: 'Celo Alfajores',
+        avgSettlementSeconds: 5,
+        avgFeeUsd: 0,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    // EVM L2s
+    'eip155:8453': {
+        caip2Id: 'eip155:8453',
+        name: 'Base',
+        avgSettlementSeconds: 2,
+        avgFeeUsd: 0.001,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    'eip155:84532': {
+        caip2Id: 'eip155:84532',
+        name: 'Base Sepolia',
+        avgSettlementSeconds: 2,
+        avgFeeUsd: 0.0001,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    'eip155:42161': {
+        caip2Id: 'eip155:42161',
+        name: 'Arbitrum',
+        avgSettlementSeconds: 2,
+        avgFeeUsd: 0.002,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    'eip155:1': {
+        caip2Id: 'eip155:1',
+        name: 'Ethereum',
+        avgSettlementSeconds: 15,
+        avgFeeUsd: 2.5,
+        isFiat: false,
+        priorityBoost: 5, // penalise due to high gas
+    },
+    'eip155:10': {
+        caip2Id: 'eip155:10',
+        name: 'Optimism',
+        avgSettlementSeconds: 2,
+        avgFeeUsd: 0.001,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    // Stellar
+    'stellar:pubnet': {
+        caip2Id: 'stellar:pubnet',
+        name: 'Stellar',
+        avgSettlementSeconds: 5,
+        avgFeeUsd: 0.00001,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    'stellar:testnet': {
+        caip2Id: 'stellar:testnet',
+        name: 'Stellar Testnet',
+        avgSettlementSeconds: 5,
+        avgFeeUsd: 0,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    // Solana
+    'solana:mainnet': {
+        caip2Id: 'solana:mainnet',
+        name: 'Solana',
+        avgSettlementSeconds: 1,
+        avgFeeUsd: 0.0005,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    'solana:devnet': {
+        caip2Id: 'solana:devnet',
+        name: 'Solana Devnet',
+        avgSettlementSeconds: 1,
+        avgFeeUsd: 0,
+        isFiat: false,
+        priorityBoost: 0,
+    },
+    // Fiat
+    'fiat:stripe': {
+        caip2Id: 'fiat:stripe',
+        name: 'Stripe MPP',
+        avgSettlementSeconds: 3,
+        avgFeeUsd: 0.30, // Stripe minimum fee
+        isFiat: true,
+        priorityBoost: 0,
+    },
+};
+/**
+ * USDC decimals per chain for atomic unit conversion.
+ */
+const USDC_DECIMALS = {
+    'eip155:8453': 6,
+    'eip155:84532': 6,
+    'eip155:42161': 6,
+    'eip155:1': 6,
+    'eip155:10': 6,
+    'stellar:pubnet': 7,
+    'stellar:testnet': 7,
+    'solana:mainnet': 6,
+    'solana:devnet': 6,
+    'fiat:stripe': 2,
+};
+class ChainRouter {
+    adapters;
+    chainMeta;
+    roundRobinIndex = 0;
+    constructor(adapters, customMeta) {
+        this.adapters = adapters;
+        this.chainMeta = new Map();
+        // Load defaults
+        for (const [key, meta] of Object.entries(DEFAULT_CHAIN_META)) {
+            this.chainMeta.set(key, meta);
+        }
+        // Override with custom metadata
+        if (customMeta) {
+            for (const [key, meta] of Object.entries(customMeta)) {
+                this.chainMeta.set(key, meta);
+            }
+        }
+    }
+    /**
+     * Score and rank all adapters for a given payment intent.
+     * Returns plans sorted by score (lower = better).
+     */
+    route(intent, strategy) {
+        const amountUsd = parseFloat(intent.amount);
+        if (isNaN(amountUsd) || amountUsd <= 0) {
+            return [];
+        }
+        const plans = this.adapters.map((adapter, index) => {
+            const meta = this.getChainMeta(adapter.caip2Id);
+            const atomicAmount = this.toAtomicUnits(amountUsd, adapter.caip2Id);
+            return {
+                adapter,
+                adapterIndex: index,
+                chain: adapter.chainName,
+                caip2Id: adapter.caip2Id,
+                atomicAmount,
+                estimatedFeeUsd: meta.avgFeeUsd,
+                totalCostUsd: amountUsd + meta.avgFeeUsd,
+                estimatedSettlementSeconds: meta.avgSettlementSeconds,
+                score: this.calculateScore(meta, strategy, index),
+            };
+        });
+        // Apply max fee filter
+        const maxFee = intent.maxFeeUsd;
+        const filtered = maxFee !== undefined
+            ? plans.filter((p) => p.estimatedFeeUsd <= maxFee)
+            : plans;
+        // Sort by score (lower is better)
+        return filtered.sort((a, b) => a.score - b.score);
+    }
+    /**
+     * Get the single best adapter for a payment intent.
+     */
+    getBestPlan(intent, strategy) {
+        const plans = this.route(intent, strategy);
+        return plans.length > 0 ? plans[0] : null;
+    }
+    /**
+     * Get chain metadata for a CAIP-2 ID.
+     * Falls back to sensible defaults for unknown chains.
+     */
+    getChainMeta(caip2Id) {
+        return this.chainMeta.get(caip2Id) ?? {
+            caip2Id,
+            name: 'Unknown',
+            avgSettlementSeconds: 30,
+            avgFeeUsd: 0.01,
+            isFiat: false,
+            priorityBoost: 10,
+        };
+    }
+    // ─── Internal ──────────────────────────────────────────────────────
+    /**
+     * Calculate a composite score for an adapter/chain based on the strategy.
+     * Lower score = better.
+     */
+    calculateScore(meta, strategy, adapterIndex) {
+        let score = meta.priorityBoost;
+        switch (strategy) {
+            case 'cheapest':
+                // Weight: 80% fee, 20% speed
+                score += meta.avgFeeUsd * 1000 + meta.avgSettlementSeconds * 0.1;
+                break;
+            case 'fastest':
+                // Weight: 80% speed, 20% fee
+                score += meta.avgSettlementSeconds * 10 + meta.avgFeeUsd * 100;
+                break;
+            case 'prefer-crypto':
+                // Penalise fiat rails
+                score += meta.isFiat ? 1000 : 0;
+                score += meta.avgFeeUsd * 500 + meta.avgSettlementSeconds * 0.5;
+                break;
+            case 'prefer-fiat':
+                // Penalise crypto rails
+                score += meta.isFiat ? 0 : 1000;
+                score += meta.avgFeeUsd * 500 + meta.avgSettlementSeconds * 0.5;
+                break;
+            case 'round-robin':
+                // Cycle through adapters
+                score = adapterIndex === this.roundRobinIndex ? 0 : adapterIndex + 1;
+                this.roundRobinIndex = (this.roundRobinIndex + 1) % this.adapters.length;
+                break;
+        }
+        return score;
+    }
+    /**
+     * Convert a USD amount to atomic units for a specific chain.
+     */
+    toAtomicUnits(amountUsd, caip2Id) {
+        const decimals = USDC_DECIMALS[caip2Id] ?? 6;
+        const atomic = Math.round(amountUsd * Math.pow(10, decimals));
+        return atomic.toString();
+    }
+}
+exports.ChainRouter = ChainRouter;
+//# sourceMappingURL=chain-router.js.map

package/dist/cjs/wallet/chain-router.js.map

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

package/dist/cjs/wallet/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = exports.IntentResolver = exports.ChainRouter = exports.BalanceAggregator = exports.UnifiedWallet = void 0;
+// Wallet Abstraction — Barrel exports
+var unified_wallet_1 = require("./unified-wallet");
+Object.defineProperty(exports, "UnifiedWallet", { enumerable: true, get: function () { return unified_wallet_1.UnifiedWallet; } });
+var balance_aggregator_1 = require("./balance-aggregator");
+Object.defineProperty(exports, "BalanceAggregator", { enumerable: true, get: function () { return balance_aggregator_1.BalanceAggregator; } });
+var chain_router_1 = require("./chain-router");
+Object.defineProperty(exports, "ChainRouter", { enumerable: true, get: function () { return chain_router_1.ChainRouter; } });
+var intent_resolver_1 = require("./intent-resolver");
+Object.defineProperty(exports, "IntentResolver", { enumerable: true, get: function () { return intent_resolver_1.IntentResolver; } });
+var session_manager_1 = require("./session-manager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_manager_1.SessionManager; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/wallet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/wallet/index.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AACtC,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

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

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntentResolver = void 0;
+/**
+ * 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,
+};
+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);
+    }
+}
+exports.IntentResolver = IntentResolver;
+//# sourceMappingURL=intent-resolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent-resolver.js","sourceRoot":"","sources":["../../../src/wallet/intent-resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAIH;;GAEG;AACH,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAE9C;;GAEG;AACH,MAAM,eAAe,GAAG,wDAAwD,CAAC;AAEjF;;GAEG;AACH,MAAM,cAAc,GAAG,yBAAyB,CAAC;AAEjD;;GAEG;AACH,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAEjD;;GAEG;AACH,MAAM,iBAAiB,GAAG,mCAAmC,CAAC;AAE9D;;GAEG;AACH,MAAM,OAAO,GAAG,oBAAoB,CAAC;AAErC;;GAEG;AACH,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,MAAa,cAAc;IACzB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAa;QACnB,MAAM,MAAM,GAAc;YACxB,MAAM,EAAE,GAAG;SACZ,CAAC;QAEF,mEAAmE;QACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC;QACxB,CAAC;QAED,mEAAmE;QACnE,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAChD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;YAErB,sCAAsC;YACtC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,mEAAmE;QACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACrD,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACnD,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,mEAAmE;QACnE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,MAAiB;QACxB,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB,EAAE,KAAa;QACzC,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAE3B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;CACF;AAzFD,wCAyFC"}

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

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+/**
+ * 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}`;
+}
+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;
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session-manager.js.map

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

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

package/dist/cjs/wallet/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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