@1llet.xyz/erc4337-gasless-sdk 0.4.70 → 0.4.72

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import { Chain, Address, Hash, Hex, WalletClient } from 'viem';
-import * as StellarSdk from 'stellar-sdk';
+import { Chain, Address, Hex, Hash, PublicClient, WalletClient } from 'viem';
 import { Address as Address$1 } from 'abitype';
 import z from 'zod';
+import * as StellarSdk from 'stellar-sdk';
+import * as _defuse_protocol_one_click_sdk_typescript from '@defuse-protocol/one-click-sdk-typescript';
 
 interface Token {
     symbol: string;
@@ -69,6 +70,24 @@ interface ApprovalSupportResult {
     fundedAmount?: string;
 }
 
+declare class BundlerClient {
+    private bundlerUrl;
+    private entryPointAddress;
+    constructor(config: EvmChainConfig, entryPointAddress: Address);
+    private call;
+    estimateGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
+    sendUserOperation(userOp: UserOperation): Promise<Hash>;
+    waitForUserOperation(userOpHash: Hash, timeout?: number): Promise<UserOpReceipt>;
+    requestApprovalSupport(token: Address, owner: Address, spender: Address, amount: bigint): Promise<ApprovalSupportResult>;
+    scheduleUserOp(userOp: UserOperation, condition: {
+        token: string;
+        minAmount: string;
+    }): Promise<{
+        status: string;
+        taskId: string;
+    }>;
+}
+
 /**
  * ERC-4337 Account Abstraction Client
  */
@@ -84,6 +103,19 @@ declare class AccountAbstraction {
     private entryPointAddress;
     private factoryAddress;
     constructor(chainConfig: EvmChainConfig);
+    getBundlerClient(): BundlerClient;
+    getChainId(): number;
+    getPublicClient(): PublicClient;
+    buildUserOperation(transaction: {
+        target: Address;
+        value: bigint;
+        data: Hex;
+    }): Promise<UserOperation>;
+    buildBatchUserOperation(transactions: {
+        target: Address;
+        value: bigint;
+        data: Hex;
+    }[]): Promise<UserOperation>;
     connect(signer?: Hex | WalletClient): Promise<{
         owner: Address;
         smartAccount: Address;
@@ -159,21 +191,93 @@ declare global {
     }
 }
 
-declare class BundlerClient {
-    private bundlerUrl;
-    private entryPointAddress;
-    constructor(config: EvmChainConfig, entryPointAddress: Address);
-    private call;
-    estimateGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
-    sendUserOperation(userOp: UserOperation): Promise<Hash>;
-    waitForUserOperation(userOpHash: Hash, timeout?: number): Promise<UserOpReceipt>;
-    requestApprovalSupport(token: Address, owner: Address, spender: Address, amount: bigint): Promise<ApprovalSupportResult>;
+declare const ChainKeyEnum: z.ZodEnum<{
+    Optimism: "Optimism";
+    Arbitrum: "Arbitrum";
+    Base: "Base";
+    Unichain: "Unichain";
+    Polygon: "Polygon";
+    Avalanche: "Avalanche";
+    WorldChain: "WorldChain";
+    Stellar: "Stellar";
+    Monad: "Monad";
+    BNB: "BNB";
+    GNOSIS: "GNOSIS";
+    Ethereum: "Ethereum";
+    Stacks: "Stacks";
+}>;
+type ChainKey = z.infer<typeof ChainKeyEnum>;
+interface NearIntentAsset {
+    assetId: string;
+    name: string;
+    decimals: number;
+}
+interface NearIntentInformation {
+    support: boolean;
+    assetsId: NearIntentAsset[];
+    needMemo: boolean;
+}
+interface CCTPInformation {
+    supportCCTP: boolean;
+    domain: number;
+}
+interface CircleInformation {
+    supportCirclePaymaster: boolean;
+    cCTPInformation?: CCTPInformation;
+    aproxFromFee: number;
+}
+interface StargateInformation {
+    support: boolean;
+}
+interface CrossChainInformation {
+    circleInformation?: CircleInformation;
+    nearIntentInformation: NearIntentInformation | null;
+    stargateInformation?: StargateInformation;
+}
+interface EvmInformation {
+    chain: any;
+    rpcUrl: string | null;
+    supports7702: boolean;
+    erc4337: boolean;
+    bundlerUrl?: string;
+    entryPointAddress?: Address$1;
+    factoryAddress?: Address$1;
+    paymasterAddress?: Address$1;
+}
+interface NonEvmInformation {
+    networkPassphrase?: string;
+    serverURL?: string;
+}
+interface Asset {
+    name: string;
+    decimals: number;
+    address?: Address$1 | string;
+    coingeckoId?: string;
+    supportsStargate?: boolean;
+}
+interface ChainConfig {
+    assets: Asset[];
+    evm?: EvmInformation;
+    nonEvm?: NonEvmInformation;
+    crossChainInformation: CrossChainInformation;
 }
 
+declare const BASE: ChainConfig;
+
+declare const AVALANCHE: ChainConfig;
+
+declare const OPTIMISM: ChainConfig;
+
 declare const BASE_MAINNET: ChainConfig$1;
 declare const OPTIMISM_MAINNET: ChainConfig$1;
 declare const GNOSIS_MAINNET: ChainConfig$1;
 declare const BASE_SEPOLIA: ChainConfig$1;
+declare const AVALANCHE_MAINNET: ChainConfig$1;
+declare const BSC_MAINNET: ChainConfig$1;
+declare const POLYGON_MAINNET: ChainConfig$1;
+declare const ARBITRUM_MAINNET: ChainConfig$1;
+declare const UNICHAIN_MAINNET: ChainConfig$1;
+declare const MONAD_MAINNET: ChainConfig$1;
 declare const STELLAR_MAINNET: ChainConfig$1;
 declare const CHAIN_CONFIGS: Record<number, ChainConfig$1>;
 
@@ -333,75 +437,6 @@ declare class StellarService {
     getKeypair(pk: string): StellarSdk.Keypair;
 }
 
-declare const ChainKeyEnum: z.ZodEnum<{
-    Optimism: "Optimism";
-    Arbitrum: "Arbitrum";
-    Base: "Base";
-    Unichain: "Unichain";
-    Polygon: "Polygon";
-    Avalanche: "Avalanche";
-    WorldChain: "WorldChain";
-    Stellar: "Stellar";
-    Monad: "Monad";
-    BNB: "BNB";
-    GNOSIS: "GNOSIS";
-}>;
-type ChainKey = z.infer<typeof ChainKeyEnum>;
-interface NearIntentAsset {
-    assetId: string;
-    name: string;
-    decimals: number;
-}
-interface NearIntentInformation {
-    support: boolean;
-    assetsId: NearIntentAsset[];
-    needMemo: boolean;
-}
-interface CCTPInformation {
-    supportCCTP: boolean;
-    domain: number;
-}
-interface CircleInformation {
-    supportCirclePaymaster: boolean;
-    cCTPInformation?: CCTPInformation;
-    aproxFromFee: number;
-}
-interface StargateInformation {
-    support: boolean;
-}
-interface CrossChainInformation {
-    circleInformation?: CircleInformation;
-    nearIntentInformation: NearIntentInformation | null;
-    stargateInformation?: StargateInformation;
-}
-interface EvmInformation {
-    chain: any;
-    rpcUrl: string | null;
-    supports7702: boolean;
-    erc4337: boolean;
-    bundlerUrl?: string;
-    entryPointAddress?: Address$1;
-    factoryAddress?: Address$1;
-    paymasterAddress?: Address$1;
-}
-interface NonEvmInformation {
-    networkPassphrase?: string;
-    serverURL?: string;
-}
-interface Asset {
-    name: string;
-    decimals: number;
-    address?: Address$1 | string;
-    coingeckoId?: string;
-    supportsStargate?: boolean;
-}
-interface ChainConfig {
-    assets: Asset[];
-    evm?: EvmInformation;
-    nonEvm?: NonEvmInformation;
-    crossChainInformation: CrossChainInformation;
-}
-
 declare const STELLAR: ChainConfig;
 
 interface FacilitatorPaymentPayload {
@@ -430,6 +465,8 @@ interface SettleResponse {
         attestation: string;
     };
     data?: any;
+    estimatedReceived?: string;
+    minAmount?: string;
 }
 interface BridgeContext {
     paymentPayload?: FacilitatorPaymentPayload;
@@ -452,8 +489,24 @@ interface BridgeStrategy {
 
 declare class TransferManager {
     private strategies;
+    private router;
     constructor();
-    execute(context: BridgeContext): Promise<SettleResponse>;
+    execute(context: BridgeContext, logCallback?: (msg: string) => void): Promise<SettleResponse>;
+    /**
+     * Special method to orchestrate the Base -> Optimism -> Base demo flow
+     * entirely within the SDK.
+     */
+    executeMultiHopDemo(context: BridgeContext, sourceAA: AccountAbstraction, // We need the actual AA instance to sign
+    logCallback?: (msg: string) => void, overrides?: {
+        bundlerUrl?: string;
+    }): Promise<boolean>;
+    /**
+     * Specialized method for Unichain -> Stacks flow.
+     * 1. Unichain -> Ethereum (CCTP)
+     * 2. Ethereum -> Stacks (Stacks Bridge)
+     */
+    executeUnichainToStacks(context: BridgeContext, sourceAA: AccountAbstraction, ethPrivateKey: string, // Needed for Stacks Bridge execution on Ethereum (Facilitator/Intermediary EOA)
+    logCallback?: (msg: string) => void): Promise<SettleResponse>;
 }
 
 declare class NearStrategy implements BridgeStrategy {
@@ -461,6 +514,14 @@ declare class NearStrategy implements BridgeStrategy {
     canHandle(context: BridgeContext): boolean;
     execute(context: BridgeContext): Promise<SettleResponse>;
 }
+declare function getNearQuote(sourceChain: ChainKey, destChain: ChainKey, amount: string, destToken?: string, sourceToken?: string, recipient?: string, senderAddress?: string, options?: {
+    dry?: boolean;
+}): Promise<{
+    quote: _defuse_protocol_one_click_sdk_typescript.QuoteResponse;
+    depositAddress: string;
+    amountAtomicTotal: bigint;
+    amountAtomicNet: string;
+}>;
 declare function getNearSimulation(sourceChain: ChainKey, destChain: ChainKey, amount: string, destToken?: string, sourceToken?: string): Promise<{
     success: boolean;
     amountSent: number;
@@ -510,18 +571,38 @@ declare function getStargateSimulation(sourceChain: string, destChain: string, a
 
 declare class UniswapService {
     private publicClient;
-    constructor(rpcUrl: string);
+    constructor();
     /**
-     * Quote USDC needed for exact ETH output using Uniswap V3
+     * Get amount of USDC needed to buy exact amount of ETH
+     * @param amountETHWei Amount of ETH (Wei) needed
      */
-    quoteUSDCForETH(amountOutETH: bigint): Promise<bigint>;
+    quoteUSDCForETH(amountETHWei: bigint): Promise<bigint>;
     /**
-     * Build tx data for swapping USDC -> ETH using Uniswap V3 SwapRouter02
+     * Build tx data for swapping USDC -> ETH
+     * Uses SwapRouter02.exactOutputSingle + unwrapWETH9
      */
-    buildSwapData(recipient: Address, amountInMax: bigint, amountOutETH: bigint): Hex;
+    buildSwapData(recipient: Address, amountOutETH: bigint, maxAmountInUSDC: bigint): Hex;
     getRouterAddress(): Address;
     getUSDCAddress(): Address;
 }
 declare const uniswapService: UniswapService;
 
-export { AccountAbstraction, type ApprovalSupportResult, BASE_MAINNET, BASE_SEPOLIA, BundlerClient, CCTPStrategy, CHAIN_CONFIGS, CHAIN_ID_TO_KEY, type ChainConfig$1 as ChainConfig, GNOSIS_MAINNET, type GasEstimate, NearStrategy, OPTIMISM_MAINNET, STELLAR, STELLAR_MAINNET, StargateStrategy, StellarService, type Token, TransferManager, UniswapService, type UserOpReceipt, type UserOperation, entryPointAbi, erc20Abi, getNearSimulation, getStargateSimulation, smartAccountAbi, uniswapService };
+interface MultiHopStep {
+    aa: AccountAbstraction;
+    buildUserOp: () => Promise<UserOperation>;
+    waitCondition?: () => Promise<boolean>;
+    description: string;
+}
+declare class RouterService {
+    /**
+     * Orchestrates a Multi-Hop transfer by signing ALL UserOps upfront (Reverse Order),
+     * and then executing them sequentially (Forward Order) with polling support.
+     *
+     * @param steps Array of MultiHopStep ordered by execution (Source -> Intermediate -> Dest)
+     * @param onLog Optional callback for logging progress
+     */
+    executeMultiHop(steps: MultiHopStep[], onLog?: (msg: string) => void): Promise<boolean>;
+    private pollCondition;
+}
+
+export { ARBITRUM_MAINNET, AVALANCHE, AVALANCHE_MAINNET, AccountAbstraction, type ApprovalSupportResult, BASE, BASE_MAINNET, BASE_SEPOLIA, BSC_MAINNET, BundlerClient, CCTPStrategy, CHAIN_CONFIGS, CHAIN_ID_TO_KEY, type ChainConfig$1 as ChainConfig, GNOSIS_MAINNET, type GasEstimate, MONAD_MAINNET, NearStrategy, OPTIMISM, OPTIMISM_MAINNET, POLYGON_MAINNET, RouterService, STELLAR, STELLAR_MAINNET, StargateStrategy, StellarService, type Token, TransferManager, UNICHAIN_MAINNET, UniswapService, type UserOpReceipt, type UserOperation, entryPointAbi, erc20Abi, getNearQuote, getNearSimulation, getStargateSimulation, smartAccountAbi, uniswapService };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { Chain, Address, Hash, Hex, WalletClient } from 'viem';
-import * as StellarSdk from 'stellar-sdk';
+import { Chain, Address, Hex, Hash, PublicClient, WalletClient } from 'viem';
 import { Address as Address$1 } from 'abitype';
 import z from 'zod';
+import * as StellarSdk from 'stellar-sdk';
+import * as _defuse_protocol_one_click_sdk_typescript from '@defuse-protocol/one-click-sdk-typescript';
 
 interface Token {
     symbol: string;
@@ -69,6 +70,24 @@ interface ApprovalSupportResult {
     fundedAmount?: string;
 }
 
+declare class BundlerClient {
+    private bundlerUrl;
+    private entryPointAddress;
+    constructor(config: EvmChainConfig, entryPointAddress: Address);
+    private call;
+    estimateGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
+    sendUserOperation(userOp: UserOperation): Promise<Hash>;
+    waitForUserOperation(userOpHash: Hash, timeout?: number): Promise<UserOpReceipt>;
+    requestApprovalSupport(token: Address, owner: Address, spender: Address, amount: bigint): Promise<ApprovalSupportResult>;
+    scheduleUserOp(userOp: UserOperation, condition: {
+        token: string;
+        minAmount: string;
+    }): Promise<{
+        status: string;
+        taskId: string;
+    }>;
+}
+
 /**
  * ERC-4337 Account Abstraction Client
  */
@@ -84,6 +103,19 @@ declare class AccountAbstraction {
     private entryPointAddress;
     private factoryAddress;
     constructor(chainConfig: EvmChainConfig);
+    getBundlerClient(): BundlerClient;
+    getChainId(): number;
+    getPublicClient(): PublicClient;
+    buildUserOperation(transaction: {
+        target: Address;
+        value: bigint;
+        data: Hex;
+    }): Promise<UserOperation>;
+    buildBatchUserOperation(transactions: {
+        target: Address;
+        value: bigint;
+        data: Hex;
+    }[]): Promise<UserOperation>;
     connect(signer?: Hex | WalletClient): Promise<{
         owner: Address;
         smartAccount: Address;
@@ -159,21 +191,93 @@ declare global {
     }
 }
 
-declare class BundlerClient {
-    private bundlerUrl;
-    private entryPointAddress;
-    constructor(config: EvmChainConfig, entryPointAddress: Address);
-    private call;
-    estimateGas(userOp: Partial<UserOperation>): Promise<GasEstimate>;
-    sendUserOperation(userOp: UserOperation): Promise<Hash>;
-    waitForUserOperation(userOpHash: Hash, timeout?: number): Promise<UserOpReceipt>;
-    requestApprovalSupport(token: Address, owner: Address, spender: Address, amount: bigint): Promise<ApprovalSupportResult>;
+declare const ChainKeyEnum: z.ZodEnum<{
+    Optimism: "Optimism";
+    Arbitrum: "Arbitrum";
+    Base: "Base";
+    Unichain: "Unichain";
+    Polygon: "Polygon";
+    Avalanche: "Avalanche";
+    WorldChain: "WorldChain";
+    Stellar: "Stellar";
+    Monad: "Monad";
+    BNB: "BNB";
+    GNOSIS: "GNOSIS";
+    Ethereum: "Ethereum";
+    Stacks: "Stacks";
+}>;
+type ChainKey = z.infer<typeof ChainKeyEnum>;
+interface NearIntentAsset {
+    assetId: string;
+    name: string;
+    decimals: number;
+}
+interface NearIntentInformation {
+    support: boolean;
+    assetsId: NearIntentAsset[];
+    needMemo: boolean;
+}
+interface CCTPInformation {
+    supportCCTP: boolean;
+    domain: number;
+}
+interface CircleInformation {
+    supportCirclePaymaster: boolean;
+    cCTPInformation?: CCTPInformation;
+    aproxFromFee: number;
+}
+interface StargateInformation {
+    support: boolean;
+}
+interface CrossChainInformation {
+    circleInformation?: CircleInformation;
+    nearIntentInformation: NearIntentInformation | null;
+    stargateInformation?: StargateInformation;
+}
+interface EvmInformation {
+    chain: any;
+    rpcUrl: string | null;
+    supports7702: boolean;
+    erc4337: boolean;
+    bundlerUrl?: string;
+    entryPointAddress?: Address$1;
+    factoryAddress?: Address$1;
+    paymasterAddress?: Address$1;
+}
+interface NonEvmInformation {
+    networkPassphrase?: string;
+    serverURL?: string;
+}
+interface Asset {
+    name: string;
+    decimals: number;
+    address?: Address$1 | string;
+    coingeckoId?: string;
+    supportsStargate?: boolean;
+}
+interface ChainConfig {
+    assets: Asset[];
+    evm?: EvmInformation;
+    nonEvm?: NonEvmInformation;
+    crossChainInformation: CrossChainInformation;
 }
 
+declare const BASE: ChainConfig;
+
+declare const AVALANCHE: ChainConfig;
+
+declare const OPTIMISM: ChainConfig;
+
 declare const BASE_MAINNET: ChainConfig$1;
 declare const OPTIMISM_MAINNET: ChainConfig$1;
 declare const GNOSIS_MAINNET: ChainConfig$1;
 declare const BASE_SEPOLIA: ChainConfig$1;
+declare const AVALANCHE_MAINNET: ChainConfig$1;
+declare const BSC_MAINNET: ChainConfig$1;
+declare const POLYGON_MAINNET: ChainConfig$1;
+declare const ARBITRUM_MAINNET: ChainConfig$1;
+declare const UNICHAIN_MAINNET: ChainConfig$1;
+declare const MONAD_MAINNET: ChainConfig$1;
 declare const STELLAR_MAINNET: ChainConfig$1;
 declare const CHAIN_CONFIGS: Record<number, ChainConfig$1>;
 
@@ -333,75 +437,6 @@ declare class StellarService {
     getKeypair(pk: string): StellarSdk.Keypair;
 }
 
-declare const ChainKeyEnum: z.ZodEnum<{
-    Optimism: "Optimism";
-    Arbitrum: "Arbitrum";
-    Base: "Base";
-    Unichain: "Unichain";
-    Polygon: "Polygon";
-    Avalanche: "Avalanche";
-    WorldChain: "WorldChain";
-    Stellar: "Stellar";
-    Monad: "Monad";
-    BNB: "BNB";
-    GNOSIS: "GNOSIS";
-}>;
-type ChainKey = z.infer<typeof ChainKeyEnum>;
-interface NearIntentAsset {
-    assetId: string;
-    name: string;
-    decimals: number;
-}
-interface NearIntentInformation {
-    support: boolean;
-    assetsId: NearIntentAsset[];
-    needMemo: boolean;
-}
-interface CCTPInformation {
-    supportCCTP: boolean;
-    domain: number;
-}
-interface CircleInformation {
-    supportCirclePaymaster: boolean;
-    cCTPInformation?: CCTPInformation;
-    aproxFromFee: number;
-}
-interface StargateInformation {
-    support: boolean;
-}
-interface CrossChainInformation {
-    circleInformation?: CircleInformation;
-    nearIntentInformation: NearIntentInformation | null;
-    stargateInformation?: StargateInformation;
-}
-interface EvmInformation {
-    chain: any;
-    rpcUrl: string | null;
-    supports7702: boolean;
-    erc4337: boolean;
-    bundlerUrl?: string;
-    entryPointAddress?: Address$1;
-    factoryAddress?: Address$1;
-    paymasterAddress?: Address$1;
-}
-interface NonEvmInformation {
-    networkPassphrase?: string;
-    serverURL?: string;
-}
-interface Asset {
-    name: string;
-    decimals: number;
-    address?: Address$1 | string;
-    coingeckoId?: string;
-    supportsStargate?: boolean;
-}
-interface ChainConfig {
-    assets: Asset[];
-    evm?: EvmInformation;
-    nonEvm?: NonEvmInformation;
-    crossChainInformation: CrossChainInformation;
-}
-
 declare const STELLAR: ChainConfig;
 
 interface FacilitatorPaymentPayload {
@@ -430,6 +465,8 @@ interface SettleResponse {
         attestation: string;
     };
     data?: any;
+    estimatedReceived?: string;
+    minAmount?: string;
 }
 interface BridgeContext {
     paymentPayload?: FacilitatorPaymentPayload;
@@ -452,8 +489,24 @@ interface BridgeStrategy {
 
 declare class TransferManager {
     private strategies;
+    private router;
     constructor();
-    execute(context: BridgeContext): Promise<SettleResponse>;
+    execute(context: BridgeContext, logCallback?: (msg: string) => void): Promise<SettleResponse>;
+    /**
+     * Special method to orchestrate the Base -> Optimism -> Base demo flow
+     * entirely within the SDK.
+     */
+    executeMultiHopDemo(context: BridgeContext, sourceAA: AccountAbstraction, // We need the actual AA instance to sign
+    logCallback?: (msg: string) => void, overrides?: {
+        bundlerUrl?: string;
+    }): Promise<boolean>;
+    /**
+     * Specialized method for Unichain -> Stacks flow.
+     * 1. Unichain -> Ethereum (CCTP)
+     * 2. Ethereum -> Stacks (Stacks Bridge)
+     */
+    executeUnichainToStacks(context: BridgeContext, sourceAA: AccountAbstraction, ethPrivateKey: string, // Needed for Stacks Bridge execution on Ethereum (Facilitator/Intermediary EOA)
+    logCallback?: (msg: string) => void): Promise<SettleResponse>;
 }
 
 declare class NearStrategy implements BridgeStrategy {
@@ -461,6 +514,14 @@ declare class NearStrategy implements BridgeStrategy {
     canHandle(context: BridgeContext): boolean;
     execute(context: BridgeContext): Promise<SettleResponse>;
 }
+declare function getNearQuote(sourceChain: ChainKey, destChain: ChainKey, amount: string, destToken?: string, sourceToken?: string, recipient?: string, senderAddress?: string, options?: {
+    dry?: boolean;
+}): Promise<{
+    quote: _defuse_protocol_one_click_sdk_typescript.QuoteResponse;
+    depositAddress: string;
+    amountAtomicTotal: bigint;
+    amountAtomicNet: string;
+}>;
 declare function getNearSimulation(sourceChain: ChainKey, destChain: ChainKey, amount: string, destToken?: string, sourceToken?: string): Promise<{
     success: boolean;
     amountSent: number;
@@ -510,18 +571,38 @@ declare function getStargateSimulation(sourceChain: string, destChain: string, a
 
 declare class UniswapService {
     private publicClient;
-    constructor(rpcUrl: string);
+    constructor();
     /**
-     * Quote USDC needed for exact ETH output using Uniswap V3
+     * Get amount of USDC needed to buy exact amount of ETH
+     * @param amountETHWei Amount of ETH (Wei) needed
      */
-    quoteUSDCForETH(amountOutETH: bigint): Promise<bigint>;
+    quoteUSDCForETH(amountETHWei: bigint): Promise<bigint>;
     /**
-     * Build tx data for swapping USDC -> ETH using Uniswap V3 SwapRouter02
+     * Build tx data for swapping USDC -> ETH
+     * Uses SwapRouter02.exactOutputSingle + unwrapWETH9
      */
-    buildSwapData(recipient: Address, amountInMax: bigint, amountOutETH: bigint): Hex;
+    buildSwapData(recipient: Address, amountOutETH: bigint, maxAmountInUSDC: bigint): Hex;
     getRouterAddress(): Address;
     getUSDCAddress(): Address;
 }
 declare const uniswapService: UniswapService;
 
-export { AccountAbstraction, type ApprovalSupportResult, BASE_MAINNET, BASE_SEPOLIA, BundlerClient, CCTPStrategy, CHAIN_CONFIGS, CHAIN_ID_TO_KEY, type ChainConfig$1 as ChainConfig, GNOSIS_MAINNET, type GasEstimate, NearStrategy, OPTIMISM_MAINNET, STELLAR, STELLAR_MAINNET, StargateStrategy, StellarService, type Token, TransferManager, UniswapService, type UserOpReceipt, type UserOperation, entryPointAbi, erc20Abi, getNearSimulation, getStargateSimulation, smartAccountAbi, uniswapService };
+interface MultiHopStep {
+    aa: AccountAbstraction;
+    buildUserOp: () => Promise<UserOperation>;
+    waitCondition?: () => Promise<boolean>;
+    description: string;
+}
+declare class RouterService {
+    /**
+     * Orchestrates a Multi-Hop transfer by signing ALL UserOps upfront (Reverse Order),
+     * and then executing them sequentially (Forward Order) with polling support.
+     *
+     * @param steps Array of MultiHopStep ordered by execution (Source -> Intermediate -> Dest)
+     * @param onLog Optional callback for logging progress
+     */
+    executeMultiHop(steps: MultiHopStep[], onLog?: (msg: string) => void): Promise<boolean>;
+    private pollCondition;
+}
+
+export { ARBITRUM_MAINNET, AVALANCHE, AVALANCHE_MAINNET, AccountAbstraction, type ApprovalSupportResult, BASE, BASE_MAINNET, BASE_SEPOLIA, BSC_MAINNET, BundlerClient, CCTPStrategy, CHAIN_CONFIGS, CHAIN_ID_TO_KEY, type ChainConfig$1 as ChainConfig, GNOSIS_MAINNET, type GasEstimate, MONAD_MAINNET, NearStrategy, OPTIMISM, OPTIMISM_MAINNET, POLYGON_MAINNET, RouterService, STELLAR, STELLAR_MAINNET, StargateStrategy, StellarService, type Token, TransferManager, UNICHAIN_MAINNET, UniswapService, type UserOpReceipt, type UserOperation, entryPointAbi, erc20Abi, getNearQuote, getNearSimulation, getStargateSimulation, smartAccountAbi, uniswapService };