agentwallet-sdk 3.3.0 → 3.4.0

package/dist/yield/types.d.ts

@@ -1,134 +0,0 @@
-/**
- * Yield Vault Module — Types
- *
- * ⚠️ PRODUCTION NOTICE:
- * buildDepositTx / buildWithdrawTx generate calldata ONLY.
- * The agent signs and sends the transaction — no private keys are held server-side.
- *
- * The Yield Vault puts idle agent capital to work across two categories:
- * 1. DeFi Vaults  — Aave V3, Compound V3, Morpho Blue (higher APY, smart contract risk)
- * 2. RWA Tokens   — Tokenized T-bills: BUIDL, OUSG, USDY, USYC, wUSTB
- *
- * ⚠️ BUIDL WARNING: BlackRock BUIDL requires a $1,000,000 minimum deposit AND KYC.
- * Do not use BUIDL for general agent capital deployment. Use USDY or USYC instead
- * (no KYC, accessible minimums, ~5% APY).
- *
- * KYC requirements by protocol:
- * - BUIDL (BlackRock): KYC required, $1M minimum — institutional only
- * - OUSG (Ondo):       KYC required, lower minimum
- * - USDY (Ondo):       NO KYC, most accessible RWA token
- * - USYC (Hashnote):   NO KYC, competitive APY
- * - wUSTB (Superstate): NO KYC, Ethereum-native
- */
-/** Supported yield protocols */
-export type YieldProtocol = 'aave-v3' | 'compound-v3' | 'morpho-blue' | 'buidl' | 'ousg' | 'usdy' | 'usyc' | 'wustb';
-export type YieldCategory = 'defi' | 'rwa';
-/** An active yield position held by the agent */
-export interface YieldPosition {
-    protocol: YieldProtocol;
-    category: YieldCategory;
-    /** Underlying deposited token (USDC, USDT, DAI, etc.) */
-    token: string;
-    chain: string;
-    /** Current deposited amount in underlying token units */
-    depositedAmount: bigint;
-    /** Deposit timestamp (unix ms) */
-    depositedAt: number;
-    /** Current APY as a decimal (e.g., 0.051 = 5.1%) */
-    currentApy: number;
-    /** Accrued yield since deposit (estimated) */
-    accruedYield: bigint;
-    /** Protocol-specific position ID or address */
-    positionId?: string;
-}
-/** Current rate data for a yield protocol on a specific chain */
-export interface YieldRate {
-    protocol: YieldProtocol;
-    category: YieldCategory;
-    chain: string;
-    token: string;
-    /** Current APY as a decimal (e.g., 0.051 = 5.1%) */
-    apy: number;
-    /** Total value locked — signals liquidity depth */
-    tvlUsd: number;
-    /** Risk score 0–100 (lower = safer) */
-    riskScore: number;
-    /**
-     * Minimum deposit in USD.
-     * ⚠️ BUIDL: $1,000,000 minimum — institutional only.
-     * USDY/USYC: much lower minimums, agent-friendly.
-     */
-    minDepositUsd?: number;
-    /**
-     * KYC required to access this protocol?
-     * BUIDL + OUSG = true (skip for autonomous agents).
-     * USDY + USYC + wUSTB = false (use these instead).
-     */
-    kycRequired?: boolean;
-    /** How long withdrawal takes (ms). 0 = instant. */
-    withdrawalDelayMs?: number;
-    /** Unix ms when this rate was fetched */
-    fetchedAt: number;
-}
-/** A yield rotation opportunity (current position vs best available rate) */
-export interface YieldOpportunity {
-    /** Current position (null if no capital deployed) */
-    current: YieldPosition | null;
-    /** Best available rate found in the scan */
-    best: YieldRate;
-    /** APY improvement if rotating (basis points; e.g., 30 = 0.30%) */
-    apyImprovementBps: number;
-    /** Estimated annual gain in USD on the given amount */
-    estimatedAnnualGainUsd: number;
-    /** Cost to rotate (gas + bridge fees if cross-chain) */
-    rotationCostUsd: number;
-    /** Net annual gain after rotation costs */
-    netAnnualGainUsd: number;
-    /** Worth rotating? true when improvement >= threshold AND net gain > 0 */
-    viable: boolean;
-}
-/** Configuration for the Yield Vault */
-export interface YieldVaultConfig {
-    enabled: boolean;
-    /** Chains to scan (default: ['ethereum', 'base', 'arbitrum']) */
-    chains?: string[];
-    /** Tokens to include (default: ['USDC', 'USDT']) */
-    tokens?: string[];
-    /** Include RWA protocols in scan (default: true) */
-    includeRWA?: boolean;
-    /** Minimum APY improvement to trigger rotation in bps (default: 25 = 0.25%) */
-    minRotationImprovementBps?: number;
-    /** Minimum idle time before auto-deposit in ms (default: 86400000 = 24h) */
-    minIdleMs?: number;
-    /** Maximum single deposit in USD */
-    maxDepositUsd?: number;
-    /**
-     * Skip KYC-required protocols (default: true).
-     * When true: BUIDL and OUSG are excluded. USDY, USYC, wUSTB remain.
-     * Recommended for autonomous agents — KYC requires human verification.
-     */
-    skipKYCRequired?: boolean;
-}
-/** Result of a deposit operation */
-export interface DepositResult {
-    success: boolean;
-    protocol: YieldProtocol;
-    chain: string;
-    token: string;
-    amountDeposited: bigint;
-    txHash?: string;
-    estimatedApy: number;
-    error?: string;
-}
-/** Result of a withdrawal operation */
-export interface WithdrawResult {
-    success: boolean;
-    protocol: YieldProtocol;
-    chain: string;
-    token: string;
-    amountWithdrawn: bigint;
-    yieldEarned: bigint;
-    txHash?: string;
-    error?: string;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/yield/types.js

@@ -1,24 +0,0 @@
-/**
- * Yield Vault Module — Types
- *
- * ⚠️ PRODUCTION NOTICE:
- * buildDepositTx / buildWithdrawTx generate calldata ONLY.
- * The agent signs and sends the transaction — no private keys are held server-side.
- *
- * The Yield Vault puts idle agent capital to work across two categories:
- * 1. DeFi Vaults  — Aave V3, Compound V3, Morpho Blue (higher APY, smart contract risk)
- * 2. RWA Tokens   — Tokenized T-bills: BUIDL, OUSG, USDY, USYC, wUSTB
- *
- * ⚠️ BUIDL WARNING: BlackRock BUIDL requires a $1,000,000 minimum deposit AND KYC.
- * Do not use BUIDL for general agent capital deployment. Use USDY or USYC instead
- * (no KYC, accessible minimums, ~5% APY).
- *
- * KYC requirements by protocol:
- * - BUIDL (BlackRock): KYC required, $1M minimum — institutional only
- * - OUSG (Ondo):       KYC required, lower minimum
- * - USDY (Ondo):       NO KYC, most accessible RWA token
- * - USYC (Hashnote):   NO KYC, competitive APY
- * - wUSTB (Superstate): NO KYC, Ethereum-native
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/yield/types.js.map

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

package/dist/yield/vault.d.ts

@@ -1,112 +0,0 @@
-/**
- * Yield Vault Engine
- *
- * Manages agent capital deployment across DeFi vaults and RWA tokens.
- * Scans for the best available yield, tracks positions, and generates
- * calldata for deposit/withdrawal transactions.
- *
- * ⚠️ CALLDATA ONLY: buildDepositTx / buildWithdrawTx return unsigned calldata.
- * The agent signs and sends — no private keys are held by this module.
- *
- * Supported protocols for on-chain tx building:
- *   ✅ Aave V3      — supply() / withdraw()
- *   ✅ Compound V3  — supply() / withdraw()
- *   ❌ RWA tokens   — use their native interfaces (BUIDL/OUSG/USDY/USYC/wUSTB)
- *
- * ⚠️ BUIDL: $1,000,000 minimum deposit. Do not use for general agent capital.
- */
-import type { YieldProtocol, YieldPosition, YieldOpportunity, YieldVaultConfig } from './types.js';
-export declare class YieldVault {
-    private rateFetcher;
-    private positions;
-    readonly config: Required<YieldVaultConfig>;
-    constructor(config: YieldVaultConfig);
-    /**
-     * Scan all protocols and chains for the best available yield.
-     *
-     * Returns opportunities sorted by netAnnualGainUsd descending.
-     * Only includes rates with positive APY improvement vs current position.
-     *
-     * @param params.token - Underlying token to scan for (e.g. 'USDC')
-     * @param params.amountUsd - Amount in USD to use for gain calculations
-     * @param params.currentPosition - Active position (if any) to compare against
-     */
-    scan(params: {
-        token: string;
-        amountUsd: number;
-        currentPosition?: YieldPosition;
-    }): Promise<YieldOpportunity[]>;
-    /**
-     * Build a deposit transaction for a supported protocol.
-     *
-     * Returns unsigned calldata — the agent signs and broadcasts.
-     * ERC20 deposits: value is always 0n (approve first, then supply).
-     *
-     * Supported: aave-v3, compound-v3
-     * Unsupported (use native interface): buidl, ousg, usdy, usyc, wustb
-     *
-     * @throws Error for unsupported protocols
-     */
-    buildDepositTx(params: {
-        protocol: YieldProtocol;
-        token: string;
-        amount: bigint;
-        chain: string;
-        walletAddress: string;
-    }): {
-        to: string;
-        data: string;
-        value: bigint;
-        gasEstimate: bigint;
-    };
-    /**
-     * Build a withdrawal transaction for a supported protocol.
-     *
-     * Returns unsigned calldata — the agent signs and broadcasts.
-     * Pass ethers.MaxUint256 (2^256-1) to withdraw the full position.
-     *
-     * Supported: aave-v3, compound-v3
-     *
-     * @throws Error for unsupported protocols
-     */
-    buildWithdrawTx(params: {
-        protocol: YieldProtocol;
-        token: string;
-        amount: bigint;
-        chain: string;
-        walletAddress: string;
-    }): {
-        to: string;
-        data: string;
-        value: bigint;
-        gasEstimate: bigint;
-    };
-    /**
-     * Estimate USD cost to rotate capital from one position to another.
-     *
-     * Same-chain rotation: ~$3 gas (single approve + supply tx)
-     * Cross-chain rotation: CCTP bridge fee (0.1% of amount) + gas both sides (~$5)
-     *
-     * Note: For small amounts, cross-chain rotation may not be worth it.
-     */
-    estimateRotationCost(fromChain: string | undefined, toChain: string, amountUsd: number): number;
-    /**
-     * Track a position for yield accrual estimation.
-     * Keyed by protocol:chain:token — one position per slot.
-     */
-    trackPosition(position: YieldPosition): void;
-    /** Get all tracked positions */
-    getPositions(): YieldPosition[];
-    /**
-     * Estimate yield accrued since deposit.
-     *
-     * Uses simple linear approximation (accurate for short periods).
-     * For compound interest over long periods, use protocol's native accrual.
-     */
-    estimateAccruedYield(position: YieldPosition): bigint;
-    private buildAaveDepositTx;
-    private buildAaveWithdrawTx;
-    private buildCompoundDepositTx;
-    private buildCompoundWithdrawTx;
-}
-//# sourceMappingURL=vault.d.ts.map

package/dist/yield/vault.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/yield/vault.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EAEb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AA6DpB,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,SAAS,CAAyC;IAC1D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBAEhC,MAAM,EAAE,gBAAgB;IAKpC;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,aAAa,CAAC;KACjC,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAgC/B;;;;;;;;;;OAUG;IACH,cAAc,CAAC,MAAM,EAAE;QACrB,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAepE;;;;;;;;;OASG;IACH,eAAe,CAAC,MAAM,EAAE;QACtB,QAAQ,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAapE;;;;;;;OAOG;IACH,oBAAoB,CAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,MAAM;IAST;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAK5C,gCAAgC;IAChC,YAAY,IAAI,aAAa,EAAE;IAI/B;;;;;OAKG;IACH,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IASrD,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,uBAAuB;CAsBhC"}

package/dist/yield/vault.js

@@ -1,264 +0,0 @@
-/**
- * Yield Vault Engine
- *
- * Manages agent capital deployment across DeFi vaults and RWA tokens.
- * Scans for the best available yield, tracks positions, and generates
- * calldata for deposit/withdrawal transactions.
- *
- * ⚠️ CALLDATA ONLY: buildDepositTx / buildWithdrawTx return unsigned calldata.
- * The agent signs and sends — no private keys are held by this module.
- *
- * Supported protocols for on-chain tx building:
- *   ✅ Aave V3      — supply() / withdraw()
- *   ✅ Compound V3  — supply() / withdraw()
- *   ❌ RWA tokens   — use their native interfaces (BUIDL/OUSG/USDY/USYC/wUSTB)
- *
- * ⚠️ BUIDL: $1,000,000 minimum deposit. Do not use for general agent capital.
- */
-import { ethers } from 'ethers';
-import { YieldRateFetcher } from './rates.js';
-// ─── ABI Fragments ───────────────────────────────────────────────────────────
-const AAVE_POOL_ABI = [
-    'function supply(address asset, uint256 amount, address onBehalfOf, uint16 referralCode) external',
-    'function withdraw(address asset, uint256 amount, address to) external returns (uint256)',
-];
-const COMPOUND_COMET_ABI = [
-    'function supply(address asset, uint256 amount) external',
-    'function withdraw(address asset, uint256 amount) external',
-];
-// Protocol pool addresses (same as rates.ts)
-const AAVE_POOL_ADDRESSES = {
-    ethereum: '0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2',
-    base: '0xA238Dd80C259a72e81d7e4664a9801593F98d1c5',
-    arbitrum: '0x794a61358D6845594F94dc1DB02A252b5b4814aD',
-};
-const COMPOUND_COMET_ADDRESSES = {
-    ethereum: '0xc3d688B66703497DAA19211EEdff47f25384cdc3',
-    base: '0xb125E6687d4313864e53df431d5425969c15Eb2',
-    arbitrum: '0x9c4ec768c28520B50860ea7a15bd7213a9fF58bf',
-};
-// Token addresses
-const USDC_ADDRESSES = {
-    ethereum: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
-    base: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
-    arbitrum: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',
-};
-const USDT_ADDRESSES = {
-    ethereum: '0xdAC17F958D2ee523a2206206994597C13D831ec7',
-    arbitrum: '0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9',
-};
-function getTokenAddress(token, chain) {
-    const upper = token.toUpperCase();
-    if (upper === 'USDC')
-        return USDC_ADDRESSES[chain] ?? '0x';
-    if (upper === 'USDT')
-        return USDT_ADDRESSES[chain] ?? '0x';
-    return '0x';
-}
-// ─── Default Config ───────────────────────────────────────────────────────────
-const DEFAULT_CONFIG = {
-    enabled: true,
-    chains: ['ethereum', 'base', 'arbitrum'],
-    tokens: ['USDC', 'USDT'],
-    includeRWA: true,
-    minRotationImprovementBps: 25,
-    minIdleMs: 24 * 60 * 60 * 1000, // 24 hours
-    maxDepositUsd: Infinity,
-    skipKYCRequired: true,
-};
-// ─── Yield Vault ─────────────────────────────────────────────────────────────
-export class YieldVault {
-    constructor(config) {
-        this.positions = new Map();
-        this.config = { ...DEFAULT_CONFIG, ...config };
-        this.rateFetcher = new YieldRateFetcher();
-    }
-    /**
-     * Scan all protocols and chains for the best available yield.
-     *
-     * Returns opportunities sorted by netAnnualGainUsd descending.
-     * Only includes rates with positive APY improvement vs current position.
-     *
-     * @param params.token - Underlying token to scan for (e.g. 'USDC')
-     * @param params.amountUsd - Amount in USD to use for gain calculations
-     * @param params.currentPosition - Active position (if any) to compare against
-     */
-    async scan(params) {
-        const rates = await this.rateFetcher.fetchAllRates(this.config);
-        const currentApy = params.currentPosition?.currentApy ?? 0;
-        return rates
-            .map((rate) => {
-            const apyImprovementBps = Math.round((rate.apy - currentApy) * 10000);
-            const estimatedAnnualGainUsd = params.amountUsd * (rate.apy - currentApy);
-            const rotationCostUsd = this.estimateRotationCost(params.currentPosition?.chain, rate.chain, params.amountUsd);
-            const netAnnualGainUsd = estimatedAnnualGainUsd - rotationCostUsd;
-            const viable = apyImprovementBps >= this.config.minRotationImprovementBps &&
-                netAnnualGainUsd > 0;
-            return {
-                current: params.currentPosition ?? null,
-                best: rate,
-                apyImprovementBps,
-                estimatedAnnualGainUsd,
-                rotationCostUsd,
-                netAnnualGainUsd,
-                viable,
-            };
-        })
-            .filter(o => o.apyImprovementBps > 0)
-            .sort((a, b) => b.netAnnualGainUsd - a.netAnnualGainUsd);
-    }
-    /**
-     * Build a deposit transaction for a supported protocol.
-     *
-     * Returns unsigned calldata — the agent signs and broadcasts.
-     * ERC20 deposits: value is always 0n (approve first, then supply).
-     *
-     * Supported: aave-v3, compound-v3
-     * Unsupported (use native interface): buidl, ousg, usdy, usyc, wustb
-     *
-     * @throws Error for unsupported protocols
-     */
-    buildDepositTx(params) {
-        switch (params.protocol) {
-            case 'aave-v3':
-                return this.buildAaveDepositTx(params);
-            case 'compound-v3':
-                return this.buildCompoundDepositTx(params);
-            default:
-                throw new Error(`Deposit not supported for '${params.protocol}' via SDK — use their native interface. ` +
-                    `For RWA tokens (buidl, ousg, usdy, usyc, wustb), interact with the token's ` +
-                    `native contract or portal directly.`);
-        }
-    }
-    /**
-     * Build a withdrawal transaction for a supported protocol.
-     *
-     * Returns unsigned calldata — the agent signs and broadcasts.
-     * Pass ethers.MaxUint256 (2^256-1) to withdraw the full position.
-     *
-     * Supported: aave-v3, compound-v3
-     *
-     * @throws Error for unsupported protocols
-     */
-    buildWithdrawTx(params) {
-        switch (params.protocol) {
-            case 'aave-v3':
-                return this.buildAaveWithdrawTx(params);
-            case 'compound-v3':
-                return this.buildCompoundWithdrawTx(params);
-            default:
-                throw new Error(`Withdrawal not supported for '${params.protocol}' via SDK — use their native interface.`);
-        }
-    }
-    /**
-     * Estimate USD cost to rotate capital from one position to another.
-     *
-     * Same-chain rotation: ~$3 gas (single approve + supply tx)
-     * Cross-chain rotation: CCTP bridge fee (0.1% of amount) + gas both sides (~$5)
-     *
-     * Note: For small amounts, cross-chain rotation may not be worth it.
-     */
-    estimateRotationCost(fromChain, toChain, amountUsd) {
-        if (!fromChain || fromChain === toChain) {
-            // Same chain: ~$2-5 gas (approve + supply)
-            return 3.0;
-        }
-        // Cross-chain: CCTP bridge fee (0.1% platform) + gas both sides (~$5 total)
-        return amountUsd * 0.001 + 5.0;
-    }
-    /**
-     * Track a position for yield accrual estimation.
-     * Keyed by protocol:chain:token — one position per slot.
-     */
-    trackPosition(position) {
-        const key = `${position.protocol}:${position.chain}:${position.token}`;
-        this.positions.set(key, position);
-    }
-    /** Get all tracked positions */
-    getPositions() {
-        return Array.from(this.positions.values());
-    }
-    /**
-     * Estimate yield accrued since deposit.
-     *
-     * Uses simple linear approximation (accurate for short periods).
-     * For compound interest over long periods, use protocol's native accrual.
-     */
-    estimateAccruedYield(position) {
-        const elapsedMs = Date.now() - position.depositedAt;
-        const elapsedYears = elapsedMs / (365.25 * 24 * 60 * 60 * 1000);
-        const yieldFraction = position.currentApy * elapsedYears;
-        return BigInt(Math.round(Number(position.depositedAmount) * yieldFraction));
-    }
-    // ─── Private TX Builders ──────────────────────────────────────────────────
-    buildAaveDepositTx(params) {
-        const poolAddress = AAVE_POOL_ADDRESSES[params.chain];
-        if (!poolAddress)
-            throw new Error(`Aave V3 not supported on chain: ${params.chain}`);
-        const tokenAddress = getTokenAddress(params.token, params.chain);
-        const iface = new ethers.Interface(AAVE_POOL_ABI);
-        // supply(asset, amount, onBehalfOf, referralCode=0)
-        const data = iface.encodeFunctionData('supply', [
-            tokenAddress,
-            params.amount,
-            params.walletAddress,
-            0,
-        ]);
-        return {
-            to: poolAddress,
-            data,
-            value: 0n, // ERC20 deposit — no native token required
-            gasEstimate: 250000n,
-        };
-    }
-    buildAaveWithdrawTx(params) {
-        const poolAddress = AAVE_POOL_ADDRESSES[params.chain];
-        if (!poolAddress)
-            throw new Error(`Aave V3 not supported on chain: ${params.chain}`);
-        const tokenAddress = getTokenAddress(params.token, params.chain);
-        const iface = new ethers.Interface(AAVE_POOL_ABI);
-        // withdraw(asset, amount, to) — pass MaxUint256 to withdraw all
-        const data = iface.encodeFunctionData('withdraw', [
-            tokenAddress,
-            params.amount,
-            params.walletAddress,
-        ]);
-        return {
-            to: poolAddress,
-            data,
-            value: 0n,
-            gasEstimate: 200000n,
-        };
-    }
-    buildCompoundDepositTx(params) {
-        const cometAddress = COMPOUND_COMET_ADDRESSES[params.chain];
-        if (!cometAddress)
-            throw new Error(`Compound V3 not supported on chain: ${params.chain}`);
-        const tokenAddress = getTokenAddress(params.token, params.chain);
-        const iface = new ethers.Interface(COMPOUND_COMET_ABI);
-        // supply(asset, amount)
-        const data = iface.encodeFunctionData('supply', [tokenAddress, params.amount]);
-        return {
-            to: cometAddress,
-            data,
-            value: 0n,
-            gasEstimate: 180000n,
-        };
-    }
-    buildCompoundWithdrawTx(params) {
-        const cometAddress = COMPOUND_COMET_ADDRESSES[params.chain];
-        if (!cometAddress)
-            throw new Error(`Compound V3 not supported on chain: ${params.chain}`);
-        const tokenAddress = getTokenAddress(params.token, params.chain);
-        const iface = new ethers.Interface(COMPOUND_COMET_ABI);
-        // withdraw(asset, amount)
-        const data = iface.encodeFunctionData('withdraw', [tokenAddress, params.amount]);
-        return {
-            to: cometAddress,
-            data,
-            value: 0n,
-            gasEstimate: 150000n,
-        };
-    }
-}
-//# sourceMappingURL=vault.js.map

package/dist/yield/vault.js.map

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