agentwallet-sdk 5.0.2 → 5.0.4

package/dist/flash/scanner.js

@@ -1,212 +0,0 @@
-/**
- * Flash Loan Opportunity Scanner
- *
- * Scans for profitable flash loan opportunities across DEXs and lending protocols.
- *
- * ⚠️ PRODUCTION NOTICE:
- * Real arbitrage scanning requires live DEX price quotes (SmartSwapRouter integration)
- * and Aave borrower tracking (subgraph or event indexing). The methods below implement
- * the full interface and calculation logic — wire in the SmartSwapRouter for live quotes.
- */
-/** Aave V3 flash loan fee in basis points (0.09%) */
-const AAVE_FLASH_FEE_BPS = 9;
-/** Default estimated gas cost as a percentage of trade size (bps) */
-const DEFAULT_GAS_ESTIMATE_BPS = 10;
-/** Default minimum net profit threshold (bps) */
-const DEFAULT_MIN_NET_PROFIT_BPS = 5;
-/** Default trade size in USD for scanning */
-const DEFAULT_SCAN_AMOUNT_USD = 10000;
-/** Default minimum liquidation profit in USD */
-const DEFAULT_MIN_LIQUIDATION_PROFIT_USD = 50;
-/**
- * Aave V3 Pool Data Provider addresses by chain.
- * Used to query borrower health factors on-chain.
- */
-const AAVE_DATA_PROVIDER = {
-    ethereum: '0x7B4EB56E7CD4b454BA8ff71E4518426369a138a3',
-    base: '0x2d8A3C5677189723C4cB8873CfC9C8976ddf54D8',
-    arbitrum: '0x69FA688f1Dc47d4B5d8029D5a35FB7a548310654',
-    optimism: '0x69FA688f1Dc47d4B5d8029D5a35FB7a548310654',
-};
-/**
- * Minimal ABI for Aave V3 Pool getUserAccountData.
- * Returns (totalCollateralBase, totalDebtBase, availableBorrowsBase,
- *          currentLiquidationThreshold, ltv, healthFactor)
- */
-const AAVE_POOL_DATA_ABI = [
-    'function getUserAccountData(address user) view returns (uint256 totalCollateralBase, uint256 totalDebtBase, uint256 availableBorrowsBase, uint256 currentLiquidationThreshold, uint256 ltv, uint256 healthFactor)',
-];
-/**
- * Scans for flash loan opportunities: DEX arbitrage and protocol liquidations.
- *
- * **DEX Arbitrage**: Compares buy/sell prices across DEX aggregators.
- * A spread exceeding the Aave flash loan fee (0.09%) + gas becomes a
- * profitable arbitrage opportunity.
- *
- * **Liquidations**: Checks known borrowers' health factors on Aave V3.
- * Positions with healthFactor < 1.0 are liquidatable; the liquidator
- * receives a bonus (typically 5–10%) on the seized collateral.
- *
- * ⚠️ PRODUCTION NOTICE:
- * Requires a deployed `FlashLoanExecutor.sol` to actually execute opportunities.
- * See `src/flash/contracts/FlashLoanExecutor.sol`.
- */
-export class FlashOpportunityScanner {
-    /**
-     * Scan for DEX arbitrage opportunities across a token list.
-     *
-     * Algorithm:
-     * 1. For each token, simulate buying $amountUsd on each available DEX aggregator
-     * 2. Simulate selling the same amount on each DEX aggregator
-     * 3. Compute the spread: (bestSell - bestBuy) / bestBuy * 10000 (bps)
-     * 4. Subtract Aave flash loan fee (9 bps) and estimated gas cost
-     * 5. Return opportunities where netProfitBps > minNetProfitBps, sorted desc
-     *
-     * In production, wire `SmartSwapRouter.getQuote()` to fetch real DEX prices.
-     * Without live quotes, returns an empty array (no false positives).
-     *
-     * @param params - Scan configuration
-     * @returns Viable arbitrage opportunities sorted by netProfitBps descending
-     */
-    async scanArbitrage(params) {
-        const { tokens, chain, amountUsd = DEFAULT_SCAN_AMOUNT_USD, minNetProfitBps = DEFAULT_MIN_NET_PROFIT_BPS, } = params;
-        if (!tokens || tokens.length === 0) {
-            return [];
-        }
-        // In production: for each token, call SmartSwapRouter.getQuote() against
-        // multiple DEX providers, compare best buy vs best sell price.
-        // Without wired providers, we return an empty array to avoid false signals.
-        //
-        // Example production flow:
-        //   const router = new SmartSwapRouter(routerConfig);
-        //   for (const token of tokens) {
-        //     const quotes = await router.getQuotesFromAllProviders({ token, amountUsd, chain });
-        //     const bestBuy  = quotes.reduce((min, q) => q.price < min.price ? q : min);
-        //     const bestSell = quotes.reduce((max, q) => q.price > max.price ? q : max);
-        //     const grossBps = Number((bestSell.price - bestBuy.price) * 10000n / bestBuy.price);
-        //     const netBps   = grossBps - AAVE_FLASH_FEE_BPS - DEFAULT_GAS_ESTIMATE_BPS;
-        //     if (netBps > minNetProfitBps) opportunities.push({ ... });
-        //   }
-        // Suppress unused-var warnings in strict mode
-        void amountUsd;
-        const opportunities = [];
-        // Filter to only viable, sorted descending by netProfitBps
-        return opportunities
-            .filter((o) => o.netProfitBps > minNetProfitBps)
-            .sort((a, b) => b.netProfitBps - a.netProfitBps);
-    }
-    /**
-     * Check for liquidation opportunities on Aave V3.
-     *
-     * Algorithm:
-     * 1. For each known borrower address, call getUserAccountData() on Aave Pool
-     * 2. If healthFactor < 1e18 (i.e., < 1.0 in 18-decimal representation) → liquidatable
-     * 3. Estimate profit: debtToRepay × liquidationBonus%
-     * 4. Return opportunities where estimatedProfitUsd > minProfitUsd
-     *
-     * ⚠️ PRODUCTION NOTICE:
-     * This requires tracking active Aave borrowers via:
-     *   - Aave subgraph (https://thegraph.com/explorer/subgraphs/...)
-     *   - Indexing Borrow events from the Aave Pool contract
-     * Without a borrower list, returns empty array.
-     *
-     * @param params - Scan configuration
-     * @returns Liquidatable positions sorted by estimatedProfitUsd descending
-     */
-    async scanLiquidations(params) {
-        const { borrowers = [], minProfitUsd = DEFAULT_MIN_LIQUIDATION_PROFIT_USD, } = params;
-        if (borrowers.length === 0) {
-            // No borrower list — cannot scan without on-chain tracking infrastructure
-            return [];
-        }
-        const opportunities = [];
-        for (const borrower of borrowers) {
-            // In production with a provider wired in:
-            //   const pool = new ethers.Contract(AAVE_POOL_ADDRESS, AAVE_POOL_DATA_ABI, provider);
-            //   const [,,,,, healthFactorRaw] = await pool.getUserAccountData(borrower);
-            //   const healthFactor = Number(healthFactorRaw) / 1e18;
-            //   if (healthFactor >= 1.0) continue;
-            //   // Fetch collateral + debt positions, compute bonus, push to opportunities
-            void borrower;
-        }
-        return opportunities
-            .filter((o) => o.estimatedProfitUsd > minProfitUsd)
-            .sort((a, b) => b.estimatedProfitUsd - a.estimatedProfitUsd);
-    }
-    /**
-     * Run a full scan: both DEX arbitrage and liquidations.
-     * Returns a FlashScanResult with the best opportunity highlighted.
-     */
-    async scan(arbitrageParams, liquidationParams) {
-        const start = Date.now();
-        const [arbOpps, liqOpps] = await Promise.all([
-            this.scanArbitrage(arbitrageParams),
-            liquidationParams ? this.scanLiquidations(liquidationParams) : Promise.resolve([]),
-        ]);
-        const opportunities = [...arbOpps, ...liqOpps];
-        // Find the best opportunity by estimated profit
-        let bestOpportunity = null;
-        for (const opp of opportunities) {
-            if (!opp.viable)
-                continue;
-            if (bestOpportunity === null) {
-                bestOpportunity = opp;
-                continue;
-            }
-            const currentProfit = opp.type === 'dex-arbitrage' ? opp.estimatedNetProfitUsd : opp.estimatedProfitUsd;
-            const bestProfit = bestOpportunity.type === 'dex-arbitrage'
-                ? bestOpportunity.estimatedNetProfitUsd
-                : bestOpportunity.estimatedProfitUsd;
-            if (currentProfit > bestProfit)
-                bestOpportunity = opp;
-        }
-        return {
-            scannedAt: Date.now(),
-            chain: arbitrageParams.chain,
-            opportunities,
-            bestOpportunity,
-            scanDurationMs: Date.now() - start,
-        };
-    }
-    /**
-     * Calculate net profit in basis points for an arbitrage opportunity.
-     * Public helper used by tests and external callers.
-     *
-     * @param grossProfitBps - Raw spread between buy and sell price
-     * @param flashLoanFeeBps - Flash loan fee (default: 9 for Aave V3)
-     * @param gasBps - Estimated gas as % of trade size (default: 10 bps)
-     */
-    static calcNetProfitBps(grossProfitBps, flashLoanFeeBps = AAVE_FLASH_FEE_BPS, gasBps = DEFAULT_GAS_ESTIMATE_BPS) {
-        return grossProfitBps - flashLoanFeeBps - gasBps;
-    }
-    /**
-     * Build an ArbitrageOpportunity object from raw price data.
-     * Useful for testing the scanner logic without live DEX quotes.
-     */
-    static buildArbitrageOpportunity(params) {
-        const { token, tokenAddress, amount, buyDex, buyPrice, sellDex, sellPrice, chain, amountUsd = 0, gasBps = DEFAULT_GAS_ESTIMATE_BPS, } = params;
-        const grossProfitBps = buyPrice > 0n
-            ? Number(((sellPrice - buyPrice) * 10000n) / buyPrice)
-            : 0;
-        const netProfitBps = grossProfitBps - AAVE_FLASH_FEE_BPS - gasBps;
-        // estimatedNetProfitUsd = amountUsd * (netProfitBps / 10000)
-        const estimatedNetProfitUsd = amountUsd * (netProfitBps / 10000);
-        return {
-            type: 'dex-arbitrage',
-            token,
-            tokenAddress,
-            amount,
-            buyDex,
-            buyPrice,
-            sellDex,
-            sellPrice,
-            grossProfitBps,
-            flashLoanFeeBps: AAVE_FLASH_FEE_BPS,
-            netProfitBps,
-            estimatedNetProfitUsd,
-            chain,
-            viable: netProfitBps > 0,
-        };
-    }
-}
-//# sourceMappingURL=scanner.js.map

package/dist/flash/scanner.js.map

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

package/dist/flash/types.d.ts

@@ -1,136 +0,0 @@
-/**
- * Flash Loan Module — Types
- *
- * ⚠️ PRODUCTION NOTICE:
- * Executing flash loans requires a deployed `FlashLoanExecutor.sol` contract on-chain.
- * The contract receives funds from Aave, performs arbitrage/liquidation, then repays.
- * See `src/flash/contracts/FlashLoanExecutor.sol` for the Solidity scaffold.
- *
- * This SDK module generates the calldata for flash loan transactions.
- * The agent signs and sends the transaction — no private keys are held server-side.
- *
- * Supported use cases (atomic, same-block execution only):
- * 1. DEX Arbitrage — exploit price differences across DEXs in a single tx
- * 2. Liquidation — liquidate underwater borrowers, collect bonus collateral
- * 3. Collateral Swap — swap collateral token without closing position
- * 4. Self-Liquidation — repay your own loan to avoid protocol penalty
- *
- * NOT supported (wrong time scale):
- * - Yield arbitrage between lending protocols (APY differences take days/weeks to profit)
- * - Any strategy that requires holding funds between blocks
- */
-/** Supported flash loan providers */
-export type FlashLoanProvider = 'aave-v3' | 'balancer' | 'uniswap-v3';
-/** Configuration for the flash loan module */
-export interface FlashLoanConfig {
-    /** Primary flash loan provider (default: 'aave-v3') */
-    provider?: FlashLoanProvider;
-    /**
-     * Aave V3 Pool address override.
-     * If not set, the executor uses the canonical address for the given chain.
-     */
-    aavePoolAddress?: string;
-    /** Chain to operate on (e.g. 'ethereum', 'base', 'arbitrum') */
-    chain: string;
-    /** RPC URL for on-chain queries */
-    rpcUrl?: string;
-}
-/**
- * Opportunity types that flash loans can profitably exploit.
- * All strategies must be atomic (open and close in the same transaction).
- */
-export type FlashOpportunityType = 'dex-arbitrage' | 'liquidation' | 'collateral-swap' | 'self-liquidation';
-/** A DEX arbitrage opportunity identified by the scanner */
-export interface ArbitrageOpportunity {
-    type: 'dex-arbitrage';
-    /** Token symbol (e.g. 'WETH') */
-    token: string;
-    /** Token contract address */
-    tokenAddress: string;
-    /** Flash loan amount (in token's native decimals) */
-    amount: bigint;
-    /** DEX with the lower (buy) price */
-    buyDex: string;
-    /** Price on the buy DEX (in quote token units, 18-decimal normalized) */
-    buyPrice: bigint;
-    /** DEX with the higher (sell) price */
-    sellDex: string;
-    /** Price on the sell DEX (in quote token units, 18-decimal normalized) */
-    sellPrice: bigint;
-    /** Gross profit in basis points: (sellPrice - buyPrice) / buyPrice * 10000 */
-    grossProfitBps: number;
-    /** Flash loan fee in bps (Aave V3 = 9 bps = 0.09%) */
-    flashLoanFeeBps: number;
-    /** Net profit after flash loan fee and estimated gas: grossProfitBps - flashLoanFeeBps - gasBps */
-    netProfitBps: number;
-    /** Estimated net profit in USD */
-    estimatedNetProfitUsd: number;
-    /** Chain this opportunity exists on */
-    chain: string;
-    /** true if netProfitBps > 0 (viable to execute) */
-    viable: boolean;
-}
-/** A liquidation opportunity on a lending protocol */
-export interface LiquidationOpportunity {
-    type: 'liquidation';
-    /** Address of the underwater borrower */
-    borrower: string;
-    /** Symbol of the collateral token to receive */
-    collateralToken: string;
-    /** Address of the collateral token */
-    collateralAddress: string;
-    /** Symbol of the debt token to repay */
-    debtToken: string;
-    /** Address of the debt token */
-    debtAddress: string;
-    /** Amount of debt to repay (used as flash loan amount) */
-    debtAmount: bigint;
-    /**
-     * Liquidation bonus as a percentage (e.g. 5 = 5%).
-     * Aave V3 typically offers 5–10% bonus on collateral seized.
-     */
-    collateralBonus: number;
-    /** Estimated profit in USD after repaying debt + flash loan fee */
-    estimatedProfitUsd: number;
-    /**
-     * Borrower's current health factor.
-     * Values < 1.0 indicate the position is liquidatable.
-     */
-    healthFactor: number;
-    /** Lending protocol holding this position */
-    protocol: 'aave-v3' | 'compound-v3' | 'morpho';
-    /** true if the liquidation is profitable after fees */
-    viable: boolean;
-}
-/** Union type for all flash loan opportunity types */
-export type FlashOpportunity = ArbitrageOpportunity | LiquidationOpportunity;
-/** Result of a flash loan execution attempt */
-export interface FlashLoanResult {
-    success: boolean;
-    txHash?: string;
-    opportunityType: FlashOpportunityType;
-    /** Amount borrowed in the flash loan */
-    loanAmount: bigint;
-    /** Address of the borrowed token */
-    loanToken: string;
-    /** Flash loan fee paid (e.g. 0.09% of loanAmount for Aave V3) */
-    feePaid: bigint;
-    /** Net profit in USD after fee and gas costs */
-    netProfitUsd: number;
-    gasUsed?: bigint;
-    blockNumber?: number;
-    error?: string;
-}
-/** Result of an opportunity scan */
-export interface FlashScanResult {
-    /** Unix timestamp (ms) when the scan ran */
-    scannedAt: number;
-    chain: string;
-    /** All opportunities found (viable and non-viable) */
-    opportunities: FlashOpportunity[];
-    /** Highest-profit viable opportunity, or null if none found */
-    bestOpportunity: FlashOpportunity | null;
-    /** How long the scan took in milliseconds */
-    scanDurationMs: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/flash/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/flash/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtE,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,aAAa,GACb,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,aAAa,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/C,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAE7E,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,oBAAoB,CAAC;IACtC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,+DAA+D;IAC/D,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;CACxB"}

package/dist/flash/types.js

@@ -1,23 +0,0 @@
-/**
- * Flash Loan Module — Types
- *
- * ⚠️ PRODUCTION NOTICE:
- * Executing flash loans requires a deployed `FlashLoanExecutor.sol` contract on-chain.
- * The contract receives funds from Aave, performs arbitrage/liquidation, then repays.
- * See `src/flash/contracts/FlashLoanExecutor.sol` for the Solidity scaffold.
- *
- * This SDK module generates the calldata for flash loan transactions.
- * The agent signs and sends the transaction — no private keys are held server-side.
- *
- * Supported use cases (atomic, same-block execution only):
- * 1. DEX Arbitrage — exploit price differences across DEXs in a single tx
- * 2. Liquidation — liquidate underwater borrowers, collect bonus collateral
- * 3. Collateral Swap — swap collateral token without closing position
- * 4. Self-Liquidation — repay your own loan to avoid protocol penalty
- *
- * NOT supported (wrong time scale):
- * - Yield arbitrage between lending protocols (APY differences take days/weeks to profit)
- * - Any strategy that requires holding funds between blocks
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/flash/types.js.map

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

package/dist/gas/index.d.ts

@@ -1,4 +0,0 @@
-export { GasSponsor } from './sponsor.js';
-export type { GasSponsorConfig, GasSupportedChain, UserOperation, SponsoredTx, SponsorTxParams, SponsorBridgeParams, } from './types.js';
-export { ALCHEMY_NETWORK_SLUGS } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/gas/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/gas/index.js

@@ -1,3 +0,0 @@
-export { GasSponsor } from './sponsor.js';
-export { ALCHEMY_NETWORK_SLUGS } from './types.js';
-//# sourceMappingURL=index.js.map

package/dist/gas/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/gas/sponsor.d.ts

@@ -1,70 +0,0 @@
-import type { GasSponsorConfig, GasSupportedChain, SponsoredTx, SponsorTxParams, SponsorBridgeParams } from './types.js';
-/**
- * GasSponsor — wraps transactions as ERC-4337 UserOperations with Alchemy paymaster data.
- *
- * Agents don't need to hold ETH/MATIC/etc. to pay gas. The Alchemy Gas Manager
- * sponsors gas on their behalf, billed to your Alchemy account.
- *
- * Requires:
- *   - An Alchemy API key with Gas Manager enabled
- *   - A Gas Manager policy ID (create at https://dashboard.alchemy.com/gas-manager)
- *   - A smart account (ERC-4337 compatible) for the agent
- *
- * @example
- * const sponsor = new GasSponsor({ alchemyApiKey: 'your-key', policyId: 'your-policy-id' });
- * const sponsored = await sponsor.sponsorTransaction({
- *   chain: 'base',
- *   from: agentSmartAccountAddress,
- *   to: usdcContract,
- *   data: transferCalldata,
- * });
- * // Now submit sponsored.userOperation to an ERC-4337 bundler
- */
-export declare class GasSponsor {
-    private readonly config;
-    constructor(config: GasSponsorConfig);
-    /** Get the Solana gas policy ID */
-    getSolanaPolicyId(): string;
-    /** Get the EVM gas policy ID */
-    getEvmPolicyId(): string;
-    /**
-     * Check if gas sponsorship is available for a given chain.
-     */
-    isSupported(chain: string): chain is GasSupportedChain;
-    /**
-     * Returns the list of chains where Alchemy Gas Manager is available.
-     * Of the SDK's 17 CCTP chains, 6 are supported by Alchemy's Gas Manager.
-     */
-    getSupportedChains(): GasSupportedChain[];
-    /**
-     * Get the Alchemy RPC URL for a given chain.
-     */
-    getAlchemyRpcUrl(chain: GasSupportedChain): string;
-    /**
-     * Sponsor a transaction — wraps it as a UserOperation with Alchemy paymaster data.
-     *
-     * The resulting UserOperation must be submitted to an ERC-4337 bundler
-     * (e.g. Alchemy's bundler via `eth_sendUserOperation`).
-     *
-     * Note: `from` must be an ERC-4337 smart account, not a plain EOA.
-     * Plain EOA transactions cannot be sponsored via ERC-4337 paymasters.
-     */
-    sponsorTransaction(params: SponsorTxParams): Promise<SponsoredTx>;
-    /**
-     * Sponsor a bridge transaction (e.g., from BridgeModule or UnifiedBridge).
-     *
-     * Bridge transactions tend to require significant gas on some chains.
-     * Sponsoring allows agents to bridge USDC without holding native gas tokens.
-     */
-    sponsorBridge(params: SponsorBridgeParams): Promise<SponsoredTx>;
-    /**
-     * Encode the `execute(address,uint256,bytes)` call for ERC-4337 account contracts.
-     * This is the standard call format used by SimpleAccount and many ERC-4337 wallets.
-     *
-     * Selector: keccak256("execute(address,uint256,bytes)")[0:4] = 0xb61d27f6
-     */
-    private _encodeExecuteCall;
-    /** Make a JSON-RPC request to Alchemy */
-    private _alchemyRpc;
-}
-//# sourceMappingURL=sponsor.d.ts.map

package/dist/gas/sponsor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sponsor.d.ts","sourceRoot":"","sources":["../../src/gas/sponsor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,eAAe,EACf,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;gBAExC,MAAM,EAAE,gBAAgB;IASpC,mCAAmC;IACnC,iBAAiB,IAAI,MAAM;IAI3B,gCAAgC;IAChC,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB;IAItD;;;OAGG;IACH,kBAAkB,IAAI,iBAAiB,EAAE;IAIzC;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM;IAKlD;;;;;;;;OAQG;IACG,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAyEvE;;;;;OAKG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAUtE;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAqB1B,yCAAyC;YAC3B,WAAW;CAiC1B"}