envoy-pay 0.1.0

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

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedWallet = void 0;
+const balance_aggregator_1 = require("./balance-aggregator");
+const chain_router_1 = require("./chain-router");
+const intent_resolver_1 = require("./intent-resolver");
+const session_manager_1 = require("./session-manager");
+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 balance_aggregator_1.BalanceAggregator(this.adapters);
+        this.chainRouter = new chain_router_1.ChainRouter(this.adapters);
+        this.intentResolver = new intent_resolver_1.IntentResolver();
+        this.sessionManager = new session_manager_1.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);
+    }
+}
+exports.UnifiedWallet = UnifiedWallet;
+//# sourceMappingURL=unified-wallet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unified-wallet.js","sourceRoot":"","sources":["../../../src/wallet/unified-wallet.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;AAGH,6DAAyD;AACzD,iDAA6C;AAC7C,uDAAmD;AACnD,uDAAmD;AAYnD,MAAa,aAAa;IAChB,QAAQ,CAAmB;IAC3B,QAAQ,CAAkB;IAC1B,GAAG,CAAwB;IAC3B,aAAa,CAAS;IAErB,iBAAiB,CAAoB;IACrC,WAAW,CAAc;IACzB,cAAc,CAAiB;IAC/B,cAAc,CAAiB;IAExC,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC;QAC/C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QAEhD,IAAI,CAAC,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,EAAE,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,EAAE,CAAC;IAC7C,CAAC;IAED,qEAAqE;IAErE;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,MAAiB;QACzB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,MAAM,eAAe,QAAQ,GAAG,CAAC,CAAC;QAE9E,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,IAAI;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM,CAAC,MAAM;gBACxB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;aACpC,CAAC;QACJ,CAAC;QAED,sBAAsB;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAE5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,IAAI;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM,CAAC,MAAM;gBACxB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,+BAA+B;aACvC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,YAAY,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QAEjG,kBAAkB;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CAAC,YAAoB;QAClC,IAAI,CAAC,GAAG,CAAC,kCAAkC,YAAY,GAAG,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB;QACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,CAAC;QACjE,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,SAAiB;QAC/B,OAAO,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACH,aAAa,CAAC,MAAiB;QAC7B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAClD,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAyB;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACH,aAAa,CAAC,WAA+B;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,CAAC,gCAAgC,OAAO,CAAC,EAAE,WAAW,WAAW,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvF,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,SAAiB;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,KAAK,EAAE,CAAC,CAAC,SAAS;YAClB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,qEAAqE;IAErE;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,IAAiB,EAAE,MAAiB;QAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEpE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CACnC,WAAW,EACX,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,OAAO,CACb,CAAC;YAEF,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;gBACnE,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,MAAM;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,SAAS,EAAE,MAAM,CAAC,MAAM;oBACxB,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;iBACxC,CAAC;YACJ,CAAC;YAED,sCAAsC;YACtC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,KAAK,YAAa,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,MAAiB,EAAE,YAAoB;QAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC;QAE9E,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,IAAI;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,MAAM,CAAC,MAAM;gBACxB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,2BAA2B;aACnC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,+BAA+B,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;CACF;AA9PD,sCA8PC"}

package/dist/esm/adapters/base.js

@@ -0,0 +1,170 @@
+import { createWalletClient, createPublicClient, http, formatEther, formatUnits, } from 'viem';
+import { privateKeyToAccount, generatePrivateKey } from 'viem/accounts';
+import { baseSepolia, base } from 'viem/chains';
+import { noopLogger } from '../logger.js';
+/** ERC-20 transfer ABI — minimal, only what we need. */
+const ERC20_TRANSFER_ABI = [
+    {
+        name: 'transfer',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'to', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        name: 'balanceOf',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'account', type: 'address' }],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+];
+/** Known USDC contract addresses on Base networks. */
+const USDC_ADDRESSES = {
+    // Base Mainnet
+    8453: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    // Base Sepolia (Circle testnet USDC)
+    84532: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+};
+/**
+ * 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 class BasePaymentAdapter {
+    chainName = 'Base';
+    caip2Id;
+    wallet;
+    publicClient;
+    account;
+    chain;
+    asset;
+    log;
+    constructor(options = {}) {
+        const key = options.privateKey ?? generatePrivateKey();
+        this.account = privateKeyToAccount(key);
+        this.chain = options.network === 'mainnet' ? base : baseSepolia;
+        this.caip2Id = `eip155:${this.chain.id}`;
+        this.asset = options.asset ?? 'ETH';
+        this.log = options.logger ?? noopLogger;
+        const transport = options.rpcUrl ? http(options.rpcUrl) : http();
+        this.wallet = createWalletClient({
+            account: this.account,
+            chain: this.chain,
+            transport,
+        });
+        this.publicClient = createPublicClient({
+            chain: this.chain,
+            transport,
+        });
+    }
+    getAddress() {
+        return this.account.address;
+    }
+    /** Get native ETH balance (formatted). */
+    async getBalance() {
+        const balance = await this.publicClient.getBalance({
+            address: this.account.address,
+        });
+        return formatEther(balance);
+    }
+    /** Get USDC balance (formatted, 6 decimals). */
+    async getUsdcBalance() {
+        const usdcAddress = USDC_ADDRESSES[this.chain.id];
+        if (!usdcAddress) {
+            return '0.00';
+        }
+        const balance = await this.publicClient.readContract({
+            address: usdcAddress,
+            abi: ERC20_TRANSFER_ABI,
+            functionName: 'balanceOf',
+            args: [this.account.address],
+        });
+        return formatUnits(balance, 6);
+    }
+    async pay(destination, amount, network) {
+        if (this.asset === 'USDC') {
+            return this.payUsdc(destination, amount);
+        }
+        return this.payEth(destination, amount);
+    }
+    /** Execute a native ETH transfer. */
+    async payEth(destination, amount) {
+        try {
+            const amountWei = BigInt(amount);
+            const ethAmount = formatEther(amountWei);
+            this.log(`[Base/ETH] 🚀 ${ethAmount} ETH → ${destination.slice(0, 8)}…${destination.slice(-6)}`);
+            // Check balance
+            const balance = await this.publicClient.getBalance({
+                address: this.account.address,
+            });
+            if (balance < amountWei) {
+                this.log(`[Base/ETH] ❌ Insufficient: ${formatEther(balance)} < ${ethAmount} ETH`);
+                return null;
+            }
+            const hash = await this.wallet.sendTransaction({
+                account: this.account,
+                to: destination,
+                value: amountWei,
+                chain: this.chain,
+            });
+            this.log(`[Base/ETH] ✅ ${hash}`);
+            return hash;
+        }
+        catch (error) {
+            this.log(`[Base/ETH] ❌ ${error.message}`);
+            return null;
+        }
+    }
+    /** Execute a USDC ERC-20 transfer. */
+    async payUsdc(destination, amount) {
+        try {
+            const usdcAddress = USDC_ADDRESSES[this.chain.id];
+            if (!usdcAddress) {
+                this.log(`[Base/USDC] ❌ No USDC contract for chain ${this.chain.id}`);
+                return null;
+            }
+            const amountAtomic = BigInt(amount);
+            const usdcFormatted = formatUnits(amountAtomic, 6);
+            this.log(`[Base/USDC] 🚀 ${usdcFormatted} USDC → ${destination.slice(0, 8)}…${destination.slice(-6)}`);
+            // Check USDC balance
+            const balance = await this.publicClient.readContract({
+                address: usdcAddress,
+                abi: ERC20_TRANSFER_ABI,
+                functionName: 'balanceOf',
+                args: [this.account.address],
+            });
+            if (balance < amountAtomic) {
+                this.log(`[Base/USDC] ❌ Insufficient: ${formatUnits(balance, 6)} < ${usdcFormatted} USDC`);
+                return null;
+            }
+            // Execute ERC-20 transfer
+            const hash = await this.wallet.writeContract({
+                address: usdcAddress,
+                abi: ERC20_TRANSFER_ABI,
+                functionName: 'transfer',
+                args: [destination, amountAtomic],
+                chain: this.chain,
+                account: this.account,
+            });
+            this.log(`[Base/USDC] ✅ ${hash}`);
+            return hash;
+        }
+        catch (error) {
+            this.log(`[Base/USDC] ❌ ${error.message}`);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,IAAI,EACJ,WAAW,EACX,WAAW,GAIZ,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAU,UAAU,EAAE,MAAM,WAAW,CAAC;AAE/C,wDAAwD;AACxD,MAAM,kBAAkB,GAAG;IACzB;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAmB;QACzB,eAAe,EAAE,YAAqB;QACtC,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAkB,EAAE;YACxC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAkB,EAAE;SAC7C;QACD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;KAC/C;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,UAAmB;QACzB,eAAe,EAAE,MAAe;QAChC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC;QACvD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC;KAClD;CACO,CAAC;AAEX,sDAAsD;AACtD,MAAM,cAAc,GAAkC;IACpD,eAAe;IACf,IAAI,EAAE,4CAA4C;IAClD,qCAAqC;IACrC,KAAK,EAAE,4CAA4C;CACpD,CAAC;AAmBF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAkB;IACb,SAAS,GAAG,MAAM,CAAC;IACnB,OAAO,CAAS;IAExB,MAAM,CAAe;IACrB,YAAY,CAAe;IAC3B,OAAO,CAAyC;IAChD,KAAK,CAAQ;IACb,KAAK,CAAiB;IACtB,GAAG,CAAS;IAEpB,YAAY,UAA8B,EAAE;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QAChE,IAAI,CAAC,OAAO,GAAG,UAAU,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC;QAExC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjE,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS;SACV,CAAiB,CAAC;IACrB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,0CAA0C;IAC1C,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;YACjD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;SAC9B,CAAC,CAAC;QACH,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,cAAc;QAClB,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YACnD,OAAO,EAAE,WAAW;YACpB,GAAG,EAAE,kBAAkB;YACvB,YAAY,EAAE,WAAW;YACzB,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SAC7B,CAAC,CAAC;QAEH,OAAO,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAG,CACP,WAAmB,EACnB,MAAc,EACd,OAAe;QAEf,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,qCAAqC;IAC7B,KAAK,CAAC,MAAM,CAClB,WAAmB,EACnB,MAAc;QAEd,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAEzC,IAAI,CAAC,GAAG,CACN,iBAAiB,SAAS,UAAU,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CACvF,CAAC;YAEF,gBAAgB;YAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;gBACjD,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;aAC9B,CAAC,CAAC;YAEH,IAAI,OAAO,GAAG,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CACN,8BAA8B,WAAW,CAAC,OAAO,CAAC,MAAM,SAAS,MAAM,CACxE,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;gBAC7C,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,EAAE,EAAE,WAA4B;gBAChC,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,sCAAsC;IAC9B,KAAK,CAAC,OAAO,CACnB,WAAmB,EACnB,MAAc;QAEd,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,GAAG,CAAC,4CAA4C,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,aAAa,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;YAEnD,IAAI,CAAC,GAAG,CACN,kBAAkB,aAAa,WAAW,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAC7F,CAAC;YAEF,qBAAqB;YACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;gBACnD,OAAO,EAAE,WAAW;gBACpB,GAAG,EAAE,kBAAkB;gBACvB,YAAY,EAAE,WAAW;gBACzB,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;aAC7B,CAAC,CAAC;YAEH,IAAI,OAAO,GAAG,YAAY,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CACN,+BAA+B,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,aAAa,OAAO,CACjF,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;YAED,0BAA0B;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;gBAC3C,OAAO,EAAE,WAAW;gBACpB,GAAG,EAAE,kBAAkB;gBACvB,YAAY,EAAE,UAAU;gBACxB,IAAI,EAAE,CAAC,WAA4B,EAAE,YAAY,CAAC;gBAClD,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}