@agether/sdk 2.17.3 → 2.18.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Signer, ethers } from 'ethers';
+import { Signer, ethers, Contract } from 'ethers';
 import { WalletClient } from 'viem';
 
 /**
@@ -407,6 +407,72 @@ declare class AgetherClient {
     private _exec;
 }
 
+/**
+ * AgentAccountClient — Base class for protocol integrations that operate
+ * through an Agent's Safe account via ERC-4337 UserOperations.
+ *
+ * Provides:
+ * - Signer/provider setup (privateKey or external signer)
+ * - Safe account address resolution
+ * - UserOp submission through EntryPoint
+ * - executeSingle() / executeBatch() for Safe7579 execution
+ * - Auto-funding Safe with ETH for gas
+ *
+ * Subclass this for each protocol (Morpho, Aave, etc.)
+ */
+
+interface AgentAccountBaseConfig {
+    rpcUrl: string;
+    agentId: string;
+    chainId?: ChainId;
+    contracts?: Partial<{
+        agether4337Factory: string;
+        entryPoint: string;
+    }>;
+}
+type AgentAccountConfig = AgentAccountBaseConfig & ({
+    privateKey: string;
+    signer?: never;
+} | {
+    signer: ethers.AbstractSigner;
+    privateKey?: never;
+});
+declare class AgentAccountClient {
+    protected _signer: ethers.AbstractSigner;
+    protected provider: ethers.JsonRpcProvider;
+    protected config: AgetherConfig;
+    protected agentId: string;
+    protected _rpcUrl: string;
+    protected _privateKey?: string;
+    protected _useExternalSigner: boolean;
+    protected _eoaAddress?: string;
+    protected agether4337Factory: Contract;
+    protected entryPoint: Contract;
+    protected _accountAddress?: string;
+    constructor(config: AgentAccountConfig);
+    /** Resolve the AgentAccount (Safe) address. Cached after first call. */
+    getAccountAddress(): Promise<string>;
+    getAgentId(): string;
+    /** Get the EOA wallet address (synchronous). */
+    getWalletAddress(): string;
+    /** Get EOA wallet address (async, works for all signer types). */
+    getSignerAddress(): Promise<string>;
+    /** Pack two uint128 values into a single bytes32. */
+    private _packUint128;
+    /**
+     * Build, sign and submit a PackedUserOperation through EntryPoint.handleOps.
+     */
+    private _submitUserOp;
+    /**
+     * Execute a single call via Safe7579 account through ERC-4337 UserOp.
+     */
+    executeSingle(target: string, data: string, value?: bigint): Promise<ethers.TransactionReceipt>;
+    /**
+     * Execute multiple calls via Safe7579 account in one atomic batch.
+     */
+    executeBatch(targets: string[], values: bigint[], datas: string[]): Promise<ethers.TransactionReceipt>;
+}
+
 /**
  * MorphoClient — Morpho Blue lending only (supply, borrow, repay, withdraw collateral)
  *
@@ -429,6 +495,7 @@ declare class AgetherClient {
  *   - `signer`: external signer (Bankr, Privy, Turnkey, MetaMask, etc.)
  */
 
+/** Single call: callType=0x00, execType=0x00, rest zero-padded to 32 bytes */
 /**
  * Convenience type alias for any ethers-compatible signer.
  * Use this when declaring variables or parameters that accept
@@ -585,19 +652,8 @@ interface YieldSpreadResult {
     utilization: number;
     marketId: string;
 }
-declare class MorphoClient {
-    private _signer;
-    private provider;
-    private config;
-    private agentId;
-    private _rpcUrl;
-    private _privateKey?;
-    private _useExternalSigner;
-    private _eoaAddress?;
-    private agether4337Factory;
+declare class MorphoClient extends AgentAccountClient {
     private morphoBlue;
-    private entryPoint;
-    private _accountAddress?;
     /** Market params cache: keyed by market uniqueKey (bytes32 hash) */
     private _marketCache;
     /** Dynamic token registry: symbol (uppercase) or address (lowercase) → { address, symbol, decimals } */
@@ -605,17 +661,6 @@ declare class MorphoClient {
     private _discoveredMarkets?;
     private _discoveredAt;
     constructor(config: MorphoClientConfig);
-    /** Resolve the AgentAccount address (cached, with retry for flaky RPCs). */
-    getAccountAddress(): Promise<string>;
-    getAgentId(): string;
-    /**
-     * Get the EOA wallet address (synchronous, best-effort).
-     *
-     * For the `privateKey` path this always works. For the `signer` path
-     * it works if the signer exposes `.address` synchronously (e.g. ethers.Wallet).
-     * If the address has not been resolved yet, throws — call `getSignerAddress()` first.
-     */
-    getWalletAddress(): string;
     /**
      * Resolve the EOA signer address (async, works with all signer types).
      * Result is cached after the first call.
@@ -958,28 +1003,16 @@ declare class MorphoClient {
      */
     private _refreshSigner;
     /**
-     * Pack two uint128 values into a single bytes32:
-     *   bytes32 = (hi << 128) | lo
-     */
-    private _packUint128;
-    /**
-     * Build, sign and submit a PackedUserOperation through EntryPoint.handleOps.
-     *
-     * @param callData – the ABI-encoded calldata for the Safe7579 account
-     *   (e.g. `execute(mode, executionCalldata)`)
-     * @returns the transaction receipt of the handleOps call
-     */
-    private _submitUserOp;
-    /**
-     * Execute a single call via Safe7579 account (ERC-7579 single mode)
-     * through an ERC-4337 UserOperation.
-     */
-    private exec;
-    /**
-     * Execute multiple calls via Safe7579 account (ERC-7579 batch mode)
-     * through an ERC-4337 UserOperation.
+     * Repay all debt and withdraw all collateral in one atomic batch.
+     * Full position exit: approve + repay(shares) + withdrawCollateral → 1 UserOp.
      */
-    private batch;
+    repayAndWithdraw(tokenSymbol?: string, loanTokenSymbol?: string, toEoa?: boolean): Promise<{
+        tx: string;
+        repaid: string;
+        withdrawn: string;
+        collateralToken: string;
+        loanToken: string;
+    }>;
     /** Convert MorphoMarketParams to Solidity tuple. */
     private _toTuple;
     /** Find the first market where the agent has collateral deposited. */
@@ -1018,6 +1051,158 @@ declare class MorphoClient {
     private _computeNetDepositedAll;
 }
 
+interface AaveReserveInfo {
+    symbol: string;
+    address: string;
+    decimals: number;
+    supplyApy: number;
+    borrowApy: number;
+    totalSupply: number;
+    totalBorrow: number;
+    ltv: number;
+    liquidationThreshold: number;
+    borrowingEnabled: boolean;
+    isActive: boolean;
+    priceUsd: number;
+}
+interface AavePosition {
+    asset: string;
+    address: string;
+    supplied: number;
+    suppliedUsd: number;
+    borrowed: number;
+    borrowedUsd: number;
+    usedAsCollateral: boolean;
+    supplyApy: number;
+    borrowApy: number;
+}
+interface AaveAccountData {
+    totalCollateralUsd: number;
+    totalDebtUsd: number;
+    availableBorrowUsd: number;
+    currentLtv: number;
+    liquidationThreshold: number;
+    healthFactor: number;
+    positions: AavePosition[];
+}
+/**
+ * AaveClient — Aave V3 lending operations through the Agent's Safe account.
+ *
+ * All write operations (supply, borrow, repay, withdraw) are executed through
+ * the Safe7579 account via ERC-4337 UserOperations, just like MorphoClient.
+ * This reuses MorphoClient's exec/batch infrastructure for Safe account execution.
+ */
+declare class AaveClient extends AgentAccountClient {
+    private _aaveChainId;
+    private _pool;
+    private _oracle;
+    private _dataProvider;
+    private _poolIface;
+    private _erc20Iface;
+    private _reserveCache;
+    private _reserveCacheTs;
+    private static readonly CACHE_TTL;
+    /**
+     * Create an AaveClient. Takes the same config as MorphoClient — the agent's
+     * Safe account is used for all Aave operations.
+     */
+    constructor(config: AgentAccountConfig);
+    /** Get the Agent's Safe account address. */
+    getAccountAddress(): Promise<string>;
+    /** Get chainId. */
+    get aaveChainId(): ChainId;
+    getReserves(forceRefresh?: boolean): Promise<AaveReserveInfo[]>;
+    getAccountData(): Promise<AaveAccountData>;
+    /**
+     * Supply an asset to Aave V3 from the Agent's Safe account.
+     * Batch: approve + supply in one UserOp.
+     */
+    supply(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Withdraw a supplied asset from Aave V3 to the Safe account.
+     */
+    withdraw(asset: string, amount: string, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Borrow an asset from Aave V3 (variable rate) to the Safe account.
+     */
+    borrow(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Repay borrowed asset on Aave V3 from the Safe account.
+     * Batch: approve + repay in one UserOp.
+     */
+    repay(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Enable or disable a supplied asset as collateral.
+     */
+    setCollateral(asset: string, useAsCollateral: boolean): Promise<ethers.TransactionReceipt>;
+    /**
+     * Supply an asset and borrow in one atomic batch operation.
+     */
+    supplyAndBorrow(supplyAsset: string, supplyAmount: string, borrowAsset: string, borrowAmount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Repay all debt and withdraw all collateral in one atomic batch.
+     * Full position exit: approve + repay + withdraw → 1 UserOp.
+     */
+    repayAndWithdraw(repayAsset: string, withdrawAsset: string, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Search reserves by token symbol (case-insensitive partial match).
+     */
+    searchReserves(query: string): Promise<AaveReserveInfo[]>;
+    /**
+     * Get borrowing options: which tokens can be borrowed, with what collateral.
+     * If collateral symbol given, shows what you can borrow using that as collateral.
+     */
+    getBorrowingOptions(collateral?: string): Promise<Array<{
+        collateral: string;
+        borrowable: AaveReserveInfo[];
+        collateralBalance: number;
+        collateralValueUsd: number;
+        maxBorrowUsd: number;
+    }>>;
+    /**
+     * Calculate max additional borrowable in USD given current positions.
+     */
+    getMaxBorrowable(): Promise<{
+        availableBorrowUsd: number;
+        currentLtv: number;
+        liquidationThreshold: number;
+        totalCollateralUsd: number;
+        totalDebtUsd: number;
+    }>;
+    /**
+     * Scan wallet for tokens that exist as Aave reserves.
+     */
+    getWalletTokens(): Promise<Array<{
+        symbol: string;
+        address: string;
+        eoaBalance: number;
+        safeBalance: number;
+        priceUsd: number;
+        valueUsd: number;
+        canSupply: boolean;
+        canBorrow: boolean;
+    }>>;
+    /**
+     * Get yield spread for LST carry trades on Aave.
+     * Compares LST native yield vs Aave borrow rates.
+     */
+    getYieldSpread(_minLiquidity?: number): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        collateralYield: number;
+        borrowRate: number;
+        netSpread: number;
+        profitable: boolean;
+        collateralLtv: number;
+        maxSafeLeverage: number;
+    }>>;
+    private static readonly LST_PROJECT_MAP;
+    private static _lstYieldCache;
+    private static readonly LST_CACHE_TTL;
+    private _getLstYields;
+    private _resolveReserve;
+}
+
 /**
  * x402 HTTP Client — Make paid API calls via the x402 protocol (v2)
  *
@@ -1635,4 +1820,4 @@ interface RetryOptions {
  */
 declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, type MarketFilter, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type RetryOptions, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, type YieldSpreadResult, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps, withRetry };
+export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, type AaveAccountData, AaveClient, type AavePosition, type AaveReserveInfo, AgentAccountClient, type AgentAccountConfig, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, type MarketFilter, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type RetryOptions, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, type YieldSpreadResult, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps, withRetry };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Signer, ethers } from 'ethers';
+import { Signer, ethers, Contract } from 'ethers';
 import { WalletClient } from 'viem';
 
 /**
@@ -407,6 +407,72 @@ declare class AgetherClient {
     private _exec;
 }
 
+/**
+ * AgentAccountClient — Base class for protocol integrations that operate
+ * through an Agent's Safe account via ERC-4337 UserOperations.
+ *
+ * Provides:
+ * - Signer/provider setup (privateKey or external signer)
+ * - Safe account address resolution
+ * - UserOp submission through EntryPoint
+ * - executeSingle() / executeBatch() for Safe7579 execution
+ * - Auto-funding Safe with ETH for gas
+ *
+ * Subclass this for each protocol (Morpho, Aave, etc.)
+ */
+
+interface AgentAccountBaseConfig {
+    rpcUrl: string;
+    agentId: string;
+    chainId?: ChainId;
+    contracts?: Partial<{
+        agether4337Factory: string;
+        entryPoint: string;
+    }>;
+}
+type AgentAccountConfig = AgentAccountBaseConfig & ({
+    privateKey: string;
+    signer?: never;
+} | {
+    signer: ethers.AbstractSigner;
+    privateKey?: never;
+});
+declare class AgentAccountClient {
+    protected _signer: ethers.AbstractSigner;
+    protected provider: ethers.JsonRpcProvider;
+    protected config: AgetherConfig;
+    protected agentId: string;
+    protected _rpcUrl: string;
+    protected _privateKey?: string;
+    protected _useExternalSigner: boolean;
+    protected _eoaAddress?: string;
+    protected agether4337Factory: Contract;
+    protected entryPoint: Contract;
+    protected _accountAddress?: string;
+    constructor(config: AgentAccountConfig);
+    /** Resolve the AgentAccount (Safe) address. Cached after first call. */
+    getAccountAddress(): Promise<string>;
+    getAgentId(): string;
+    /** Get the EOA wallet address (synchronous). */
+    getWalletAddress(): string;
+    /** Get EOA wallet address (async, works for all signer types). */
+    getSignerAddress(): Promise<string>;
+    /** Pack two uint128 values into a single bytes32. */
+    private _packUint128;
+    /**
+     * Build, sign and submit a PackedUserOperation through EntryPoint.handleOps.
+     */
+    private _submitUserOp;
+    /**
+     * Execute a single call via Safe7579 account through ERC-4337 UserOp.
+     */
+    executeSingle(target: string, data: string, value?: bigint): Promise<ethers.TransactionReceipt>;
+    /**
+     * Execute multiple calls via Safe7579 account in one atomic batch.
+     */
+    executeBatch(targets: string[], values: bigint[], datas: string[]): Promise<ethers.TransactionReceipt>;
+}
+
 /**
  * MorphoClient — Morpho Blue lending only (supply, borrow, repay, withdraw collateral)
  *
@@ -429,6 +495,7 @@ declare class AgetherClient {
  *   - `signer`: external signer (Bankr, Privy, Turnkey, MetaMask, etc.)
  */
 
+/** Single call: callType=0x00, execType=0x00, rest zero-padded to 32 bytes */
 /**
  * Convenience type alias for any ethers-compatible signer.
  * Use this when declaring variables or parameters that accept
@@ -585,19 +652,8 @@ interface YieldSpreadResult {
     utilization: number;
     marketId: string;
 }
-declare class MorphoClient {
-    private _signer;
-    private provider;
-    private config;
-    private agentId;
-    private _rpcUrl;
-    private _privateKey?;
-    private _useExternalSigner;
-    private _eoaAddress?;
-    private agether4337Factory;
+declare class MorphoClient extends AgentAccountClient {
     private morphoBlue;
-    private entryPoint;
-    private _accountAddress?;
     /** Market params cache: keyed by market uniqueKey (bytes32 hash) */
     private _marketCache;
     /** Dynamic token registry: symbol (uppercase) or address (lowercase) → { address, symbol, decimals } */
@@ -605,17 +661,6 @@ declare class MorphoClient {
     private _discoveredMarkets?;
     private _discoveredAt;
     constructor(config: MorphoClientConfig);
-    /** Resolve the AgentAccount address (cached, with retry for flaky RPCs). */
-    getAccountAddress(): Promise<string>;
-    getAgentId(): string;
-    /**
-     * Get the EOA wallet address (synchronous, best-effort).
-     *
-     * For the `privateKey` path this always works. For the `signer` path
-     * it works if the signer exposes `.address` synchronously (e.g. ethers.Wallet).
-     * If the address has not been resolved yet, throws — call `getSignerAddress()` first.
-     */
-    getWalletAddress(): string;
     /**
      * Resolve the EOA signer address (async, works with all signer types).
      * Result is cached after the first call.
@@ -958,28 +1003,16 @@ declare class MorphoClient {
      */
     private _refreshSigner;
     /**
-     * Pack two uint128 values into a single bytes32:
-     *   bytes32 = (hi << 128) | lo
-     */
-    private _packUint128;
-    /**
-     * Build, sign and submit a PackedUserOperation through EntryPoint.handleOps.
-     *
-     * @param callData – the ABI-encoded calldata for the Safe7579 account
-     *   (e.g. `execute(mode, executionCalldata)`)
-     * @returns the transaction receipt of the handleOps call
-     */
-    private _submitUserOp;
-    /**
-     * Execute a single call via Safe7579 account (ERC-7579 single mode)
-     * through an ERC-4337 UserOperation.
-     */
-    private exec;
-    /**
-     * Execute multiple calls via Safe7579 account (ERC-7579 batch mode)
-     * through an ERC-4337 UserOperation.
+     * Repay all debt and withdraw all collateral in one atomic batch.
+     * Full position exit: approve + repay(shares) + withdrawCollateral → 1 UserOp.
      */
-    private batch;
+    repayAndWithdraw(tokenSymbol?: string, loanTokenSymbol?: string, toEoa?: boolean): Promise<{
+        tx: string;
+        repaid: string;
+        withdrawn: string;
+        collateralToken: string;
+        loanToken: string;
+    }>;
     /** Convert MorphoMarketParams to Solidity tuple. */
     private _toTuple;
     /** Find the first market where the agent has collateral deposited. */
@@ -1018,6 +1051,158 @@ declare class MorphoClient {
     private _computeNetDepositedAll;
 }
 
+interface AaveReserveInfo {
+    symbol: string;
+    address: string;
+    decimals: number;
+    supplyApy: number;
+    borrowApy: number;
+    totalSupply: number;
+    totalBorrow: number;
+    ltv: number;
+    liquidationThreshold: number;
+    borrowingEnabled: boolean;
+    isActive: boolean;
+    priceUsd: number;
+}
+interface AavePosition {
+    asset: string;
+    address: string;
+    supplied: number;
+    suppliedUsd: number;
+    borrowed: number;
+    borrowedUsd: number;
+    usedAsCollateral: boolean;
+    supplyApy: number;
+    borrowApy: number;
+}
+interface AaveAccountData {
+    totalCollateralUsd: number;
+    totalDebtUsd: number;
+    availableBorrowUsd: number;
+    currentLtv: number;
+    liquidationThreshold: number;
+    healthFactor: number;
+    positions: AavePosition[];
+}
+/**
+ * AaveClient — Aave V3 lending operations through the Agent's Safe account.
+ *
+ * All write operations (supply, borrow, repay, withdraw) are executed through
+ * the Safe7579 account via ERC-4337 UserOperations, just like MorphoClient.
+ * This reuses MorphoClient's exec/batch infrastructure for Safe account execution.
+ */
+declare class AaveClient extends AgentAccountClient {
+    private _aaveChainId;
+    private _pool;
+    private _oracle;
+    private _dataProvider;
+    private _poolIface;
+    private _erc20Iface;
+    private _reserveCache;
+    private _reserveCacheTs;
+    private static readonly CACHE_TTL;
+    /**
+     * Create an AaveClient. Takes the same config as MorphoClient — the agent's
+     * Safe account is used for all Aave operations.
+     */
+    constructor(config: AgentAccountConfig);
+    /** Get the Agent's Safe account address. */
+    getAccountAddress(): Promise<string>;
+    /** Get chainId. */
+    get aaveChainId(): ChainId;
+    getReserves(forceRefresh?: boolean): Promise<AaveReserveInfo[]>;
+    getAccountData(): Promise<AaveAccountData>;
+    /**
+     * Supply an asset to Aave V3 from the Agent's Safe account.
+     * Batch: approve + supply in one UserOp.
+     */
+    supply(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Withdraw a supplied asset from Aave V3 to the Safe account.
+     */
+    withdraw(asset: string, amount: string, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Borrow an asset from Aave V3 (variable rate) to the Safe account.
+     */
+    borrow(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Repay borrowed asset on Aave V3 from the Safe account.
+     * Batch: approve + repay in one UserOp.
+     */
+    repay(asset: string, amount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Enable or disable a supplied asset as collateral.
+     */
+    setCollateral(asset: string, useAsCollateral: boolean): Promise<ethers.TransactionReceipt>;
+    /**
+     * Supply an asset and borrow in one atomic batch operation.
+     */
+    supplyAndBorrow(supplyAsset: string, supplyAmount: string, borrowAsset: string, borrowAmount: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Repay all debt and withdraw all collateral in one atomic batch.
+     * Full position exit: approve + repay + withdraw → 1 UserOp.
+     */
+    repayAndWithdraw(repayAsset: string, withdrawAsset: string, to?: string): Promise<ethers.TransactionReceipt>;
+    /**
+     * Search reserves by token symbol (case-insensitive partial match).
+     */
+    searchReserves(query: string): Promise<AaveReserveInfo[]>;
+    /**
+     * Get borrowing options: which tokens can be borrowed, with what collateral.
+     * If collateral symbol given, shows what you can borrow using that as collateral.
+     */
+    getBorrowingOptions(collateral?: string): Promise<Array<{
+        collateral: string;
+        borrowable: AaveReserveInfo[];
+        collateralBalance: number;
+        collateralValueUsd: number;
+        maxBorrowUsd: number;
+    }>>;
+    /**
+     * Calculate max additional borrowable in USD given current positions.
+     */
+    getMaxBorrowable(): Promise<{
+        availableBorrowUsd: number;
+        currentLtv: number;
+        liquidationThreshold: number;
+        totalCollateralUsd: number;
+        totalDebtUsd: number;
+    }>;
+    /**
+     * Scan wallet for tokens that exist as Aave reserves.
+     */
+    getWalletTokens(): Promise<Array<{
+        symbol: string;
+        address: string;
+        eoaBalance: number;
+        safeBalance: number;
+        priceUsd: number;
+        valueUsd: number;
+        canSupply: boolean;
+        canBorrow: boolean;
+    }>>;
+    /**
+     * Get yield spread for LST carry trades on Aave.
+     * Compares LST native yield vs Aave borrow rates.
+     */
+    getYieldSpread(_minLiquidity?: number): Promise<Array<{
+        collateralToken: string;
+        loanToken: string;
+        collateralYield: number;
+        borrowRate: number;
+        netSpread: number;
+        profitable: boolean;
+        collateralLtv: number;
+        maxSafeLeverage: number;
+    }>>;
+    private static readonly LST_PROJECT_MAP;
+    private static _lstYieldCache;
+    private static readonly LST_CACHE_TTL;
+    private _getLstYields;
+    private _resolveReserve;
+}
+
 /**
  * x402 HTTP Client — Make paid API calls via the x402 protocol (v2)
  *
@@ -1635,4 +1820,4 @@ interface RetryOptions {
  */
 declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
 
-export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, type MarketFilter, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type RetryOptions, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, type YieldSpreadResult, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps, withRetry };
+export { ACCOUNT_FACTORY_ABI, AGENT_REPUTATION_ABI, AGETHER_4337_FACTORY_ABI, AGETHER_8004_SCORER_ABI, AGETHER_8004_VALIDATION_MODULE_ABI, AGETHER_HOOK_MULTIPLEXER_ABI, type AaveAccountData, AaveClient, type AavePosition, type AaveReserveInfo, AgentAccountClient, type AgentAccountConfig, AgentIdentityClient, type AgentIdentityClientOptions, AgentNotApprovedError, AgetherClient, type AgetherClientOptions, type AgetherConfig, AgetherError, type AgetherSigner, type AgetherViemWallet, type BalancesResult, type BorrowResult, ChainId, type ContractAddresses, type DepositAndBorrowResult, type DepositResult, ENTRYPOINT_V07_ABI, ERC20_ABI, ERC8004_VALIDATION_MODULE_ABI, HOOK_MULTIPLEXER_ABI, IDENTITY_REGISTRY_ABI, InsufficientBalanceError, MORPHO_BLUE_ABI, type MarketFilter, MorphoClient, type MorphoClientConfig, type MorphoMarketInfo, type MorphoMarketParams, type MorphoPosition, type PayFromYieldResult, type PaymentRequirements, type PositionResult, type RegisterResult, type RepayResult, type RetryOptions, SAFE7579_ACCOUNT_ABI, SAFE_AGENT_FACTORY_ABI, type ScoreAttestation, type ScoreResult, ScoringClient, type ScoringClientConfig, ScoringRejectedError, type SpendingTracker, type StatusResult, type SupplyAssetResult, type SupplyPositionResult, type TransactionResult, VALIDATION_REGISTRY_ABI, type WithdrawFromAccountResult, type WithdrawResult, type WithdrawSupplyResult, X402Client, type X402Config, type X402PaymentRequest, type X402PaymentResult, type X402Response, type YieldSpreadResult, bpsToRate, createConfig, formatAPR, formatAddress, formatHealthFactor, formatPercent, formatTimestamp, formatUSD, formatUnits, getContractAddresses, getDefaultConfig, getMorphoBlueAddress, getUSDCAddress, parseUnits, rateToBps, withRetry };