@imtbl/sdk 0.4.1-alpha → 0.4.2-alpha.1

package/dist/checkout_sdk.js

@@ -4,7 +4,7 @@ import $7v2Z6$metamaskdetectprovider from '@metamask/detect-provider';
 import { Token, TradeType, CurrencyAmount, Percent } from '@uniswap/sdk-core';
 import assert from 'assert';
 import { BigNumber as BigNumber$1 } from '@ethersproject/bignumber';
-import { FeeAmount, Route, SwapQuoter, Pool, Trade } from '@uniswap/v3-sdk';
+import { FeeAmount, Route, SwapQuoter, Pool, Trade, toHex as toHex$1, encodeRouteToPath } from '@uniswap/v3-sdk';
 import JSBI from 'jsbi';
 import { keccak256 as keccak256$1 } from '@ethersproject/solidity';
 import { SwapRouter } from '@uniswap/router-sdk';
@@ -6034,6 +6034,13 @@ function arrayifyInteger(value) {
     }
     return result;
 }
+function unarrayifyInteger(data, offset, length) {
+    let result = 0;
+    for (let i = 0; i < length; i++) {
+        result = (result * 256) + data[offset + i];
+    }
+    return result;
+}
 function _encode(object) {
     if (Array.isArray(object)) {
         let payload = [];
@@ -6066,6 +6073,72 @@ function _encode(object) {
 function encode(object) {
     return hexlify(_encode(object));
 }
+function _decodeChildren(data, offset, childOffset, length) {
+    const result = [];
+    while (childOffset < offset + 1 + length) {
+        const decoded = _decode(data, childOffset);
+        result.push(decoded.result);
+        childOffset += decoded.consumed;
+        if (childOffset > offset + 1 + length) {
+            logger$9.throwError("child data too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+    }
+    return { consumed: (1 + length), result: result };
+}
+// returns { consumed: number, result: Object }
+function _decode(data, offset) {
+    if (data.length === 0) {
+        logger$9.throwError("data too short", Logger.errors.BUFFER_OVERRUN, {});
+    }
+    // Array with extra length prefix
+    if (data[offset] >= 0xf8) {
+        const lengthLength = data[offset] - 0xf7;
+        if (offset + 1 + lengthLength > data.length) {
+            logger$9.throwError("data short segment too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        const length = unarrayifyInteger(data, offset + 1, lengthLength);
+        if (offset + 1 + lengthLength + length > data.length) {
+            logger$9.throwError("data long segment too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        return _decodeChildren(data, offset, offset + 1 + lengthLength, lengthLength + length);
+    }
+    else if (data[offset] >= 0xc0) {
+        const length = data[offset] - 0xc0;
+        if (offset + 1 + length > data.length) {
+            logger$9.throwError("data array too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        return _decodeChildren(data, offset, offset + 1, length);
+    }
+    else if (data[offset] >= 0xb8) {
+        const lengthLength = data[offset] - 0xb7;
+        if (offset + 1 + lengthLength > data.length) {
+            logger$9.throwError("data array too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        const length = unarrayifyInteger(data, offset + 1, lengthLength);
+        if (offset + 1 + lengthLength + length > data.length) {
+            logger$9.throwError("data array too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        const result = hexlify(data.slice(offset + 1 + lengthLength, offset + 1 + lengthLength + length));
+        return { consumed: (1 + lengthLength + length), result: result };
+    }
+    else if (data[offset] >= 0x80) {
+        const length = data[offset] - 0x80;
+        if (offset + 1 + length > data.length) {
+            logger$9.throwError("data too short", Logger.errors.BUFFER_OVERRUN, {});
+        }
+        const result = hexlify(data.slice(offset + 1, offset + 1 + length));
+        return { consumed: (1 + length), result: result };
+    }
+    return { consumed: 1, result: hexlify(data[offset]) };
+}
+function decode(data) {
+    const bytes = arrayify(data);
+    const decoded = _decode(bytes, 0);
+    if (decoded.consumed !== bytes.length) {
+        logger$9.throwArgumentError("invalid rlp data", "data", data);
+    }
+    return decoded.result;
+}
 
 const version$5 = "address/5.7.0";
 
@@ -8932,6 +9005,19 @@ const ROOT_ERC20_PREDICATE = [
         stateMutability: 'view',
         type: 'function',
     },
+    {
+        inputs: [],
+        name: 'NATIVE_TOKEN',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
     {
         inputs: [],
         name: 'WITHDRAW_SIG',
@@ -8989,6 +9075,19 @@ const ROOT_ERC20_PREDICATE = [
         stateMutability: 'nonpayable',
         type: 'function',
     },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+        ],
+        name: 'depositNativeTo',
+        outputs: [],
+        stateMutability: 'payable',
+        type: 'function',
+    },
     {
         inputs: [
             {
@@ -9067,7 +9166,13 @@ const ROOT_ERC20_PREDICATE = [
             },
         ],
         name: 'mapToken',
-        outputs: [],
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
         stateMutability: 'nonpayable',
         type: 'function',
     },
@@ -9362,6 +9467,8 @@ var BridgeErrorType;
     BridgeErrorType["INTERNAL_ERROR"] = "INTERNAL_ERROR";
     BridgeErrorType["PROVIDER_ERROR"] = "PROVIDER_ERROR";
     BridgeErrorType["TRANSACTION_REVERTED"] = "TRANSACTION_REVERTED";
+    BridgeErrorType["INVALID_TOKEN"] = "INVALID_TOKEN";
+    BridgeErrorType["INVALID_TRANSACTION"] = "INVALID_TRANSACTION";
 })(BridgeErrorType || (BridgeErrorType = {}));
 /**
  * Represents a custom error for bridge operations.
@@ -9389,14 +9496,18 @@ class BridgeError extends Error {
  * @template T - The type of the value that the Promise resolves to.
  * @param {() => Promise<T>} fn - The function to wrap with error handling.
  * @param {BridgeErrorType} customErrorType - The custom error type to use for the error.
+ * @param {string} [details] - Additional details to add to the error message.
  * @returns {Promise<T>} The result of the wrapped function or a rejected promise with a BridgeError.
  */
-const withBridgeError = async (fn, customErrorType) => {
+const withBridgeError = async (fn, customErrorType, details) => {
     try {
         return await fn();
     }
     catch (error) {
-        const errorMessage = `${customErrorType}: ${error.message}` || 'UnknownError';
+        let errorMessage = `${customErrorType}: ${error.message}` || 'UnknownError';
+        if (details) {
+            errorMessage = `${details}: ${errorMessage}`;
+        }
         throw new BridgeError(errorMessage, customErrorType);
     }
 };
@@ -9911,234 +10022,1872 @@ async function getBlockNumberClosestToTimestamp(provider, targetTimestamp, block
     return lowerBlockNumber;
 }
 
-/**
- * Represents a token bridge, which manages asset transfers between two chains.
- */
-class TokenBridge {
-    /**
-     * @property {BridgeConfiguration} config - The bridge configuration object.
-     */
-    config;
-    /**
-     * Constructs a TokenBridge instance.
-     *
-     * @param {BridgeConfiguration} config - The bridge configuration object.
-     */
-    constructor(config) {
-        this.config = config;
-    }
-    /**
-     * Retrieves the bridge fee for a specific token.
-     *
-     * @param {BridgeFeeRequest} req - The fee request object containing the token address for which the fee is required.
-     * @returns {Promise<BridgeFeeResponse>} - A promise that resolves to an object containing the bridge fee for the specified token and a flag indicating if the token is bridgeable.
-     * @throws {BridgeError} - If an error occurs during the fee retrieval, a BridgeError will be thrown with a specific error type.
-     *
-     * Possible BridgeError types include:
-     * - INVALID_ADDRESS: The token address provided in the request is invalid.
-     *
-     * @example
-     * const feeRequest = {
-     *   token: '0x123456...', // ERC20 token address
-     * };
-     *
-     * bridgeSdk.getFee(feeRequest)
-     *   .then((feeResponse) => {
-     *     console.log('Bridgeable:', feeResponse.bridgeable);
-     *     console.log('Fee Amount:', feeResponse.feeAmount.toString());
-     *   })
-     *   .catch((error) => {
-     *     console.error('Error:', error.message);
-     *   });
-     */
-    async getFee(req) {
-        if (!isAddress(req.token)) {
-            throw new BridgeError(`token address ${req.token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        return {
-            bridgeable: true,
-            feeAmount: await this.getFeeForToken(req.token),
-        };
-    }
-    /**
-     * Generates an unsigned deposit transaction for a user to sign and submit to the bridge.
-     *
-     * @param {BridgeDepositRequest} req - The deposit request object containing the required data for depositing tokens.
-     * @returns {Promise<BridgeDepositResponse>} - A promise that resolves to an object containing the unsigned transaction data.
-     * @throws {BridgeError} - If an error occurs during the generation of the unsigned transaction, a BridgeError will be thrown with a specific error type.
-     *
-     * Possible BridgeError types include:
-     * - UNSUPPORTED_ERROR: The operation is not supported. Currently thrown when attempting to deposit native tokens.
-     * - INVALID_ADDRESS: An Ethereum address provided in the request is invalid. This could be the depositor's, recipient's or the token's address.
-     * - INVALID_AMOUNT: The deposit amount provided in the request is invalid (less than or equal to 0).
-     * - INTERNAL_ERROR: An unexpected error occurred during the execution, likely due to the bridge SDK implementation.
-     *
-     * @example
-     * const depositRequest = {
-     *   token: '0x123456...', // ERC20 token address
-     *   depositorAddress: '0xabcdef...', // User's wallet address
-     *   recipientAddress: '0x987654...', // Destination wallet address on the target chain
-     *   depositAmount: ethers.utils.parseUnits('100', 18), // Deposit amount in wei
-     * };
-     *
-     * bridgeSdk.getUnsignedDepositTx(depositRequest)
-     *   .then((depositResponse) => {
-     *     console.log(depositResponse.unsignedTx);
-     *   })
-     *   .catch((error) => {
-     *     console.error('Error:', error.message);
-     *   });
-     */
-    async getUnsignedDepositTx(req) {
-        if (req.token === 'NATIVE') {
-            throw new BridgeError('native token deposit is not yet supported', BridgeErrorType.UNSUPPORTED_ERROR);
-        }
-        if (!isAddress(req.depositorAddress)) {
-            throw new BridgeError(`depositor address ${req.depositorAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        if (!isAddress(req.recipientAddress)) {
-            throw new BridgeError(`recipient address ${req.recipientAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        // If the token is ERC20, the address must be valid
-        if (req.token !== 'NATIVE' && !isAddress(req.token)) {
-            throw new BridgeError(`token address ${req.token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        // The deposit amount cannot be <= 0
-        if (req.depositAmount.isNegative() || req.depositAmount.isZero()) {
-            throw new BridgeError(`deposit amount ${req.depositAmount.toString()} is invalid`, BridgeErrorType.INVALID_AMOUNT);
-        }
-        // Convert the addresses to correct format addresses (e.g. prepend 0x if not already)
-        const depositor = getAddress(req.depositorAddress);
-        const receipient = getAddress(req.recipientAddress);
-        const token = getAddress(req.token);
-        const rootERC20PredicateContract = await withBridgeError(async () => {
-            const contract = new Contract(this.config.bridgeContracts.rootChainERC20Predicate, ROOT_ERC20_PREDICATE);
-            return contract;
-        }, BridgeErrorType.INTERNAL_ERROR);
-        // Encode the function data into a payload
-        const data = await withBridgeError(async () => rootERC20PredicateContract.interface.encodeFunctionData('depositTo', [token, receipient, req.depositAmount]), BridgeErrorType.INTERNAL_ERROR);
-        return {
-            unsignedTx: {
-                data,
-                to: this.config.bridgeContracts.rootChainERC20Predicate,
-                value: 0,
-                from: depositor,
+const CHILD_ERC20_PREDICATE = [
+    {
+        inputs: [
+            {
+                internalType: 'string',
+                name: 'only',
+                type: 'string',
             },
-        };
-    }
-    /**
-     * Retrieves the unsigned approval transaction for a deposit to the bridge.
-     *
-     * @param {ApproveBridgeRequest} req - The approve bridge request object containing the depositor address, token address, and deposit amount.
-     * @returns {Promise<ApproveBridgeResponse>} - A promise that resolves to an object containing the unsigned approval transaction and a flag indicating if the approval is required.
-     * @throws {BridgeError} - If an error occurs during the transaction creation, a BridgeError will be thrown with a specific error type.
-     *
-     * Possible BridgeError types include:
-     * - UNSUPPORTED_ERROR: The operation is not supported. Currently thrown when attempting to deposit native tokens.
-     * - INVALID_ADDRESS: An Ethereum address provided in the request is invalid.
-     * - INVALID_AMOUNT: The deposit amount provided in the request is invalid (less than or equal to 0).
-     * - INTERNAL_ERROR: An unexpected error occurred during the execution, likely due to the bridge SDK implementation.
-     * - PROVIDER_ERROR: An error occurred while interacting with the Ethereum provider. This includes issues calling the ERC20 smart contract
-     *
-     * @example
-     * const approveRequest = {
-     *   depositorAddress: '0x123456...', // Depositor's Ethereum address
-     *   token: '0xabcdef...', // ERC20 token address
-     *   depositAmount: ethers.utils.parseUnits('100', 18), // Deposit amount in token's smallest unit (e.g., wei for Ether)
-     * };
-     *
-     * bridgeSdk.getUnsignedApproveBridgeTx(approveRequest)
-     *   .then((approveResponse) => {
-     *     console.log('Approval Required:', approveResponse.required);
-     *     console.log('Unsigned Approval Transaction:', approveResponse.unsignedTx);
-     *   })
-     *   .catch((error) => {
-     *     console.error('Error:', error.message);
-     *   });
-     */
-    async getUnsignedApproveBridgeTx(req) {
-        // If the token is NATIVE, no approval is required
-        if (req.token === 'NATIVE') {
-            // When native tokens are supported, change this to return required: false
-            throw new BridgeError('native token deposit is not yet supported', BridgeErrorType.UNSUPPORTED_ERROR);
-        }
-        if (!isAddress(req.depositorAddress)) {
-            throw new BridgeError(`depositor address ${req.depositorAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        // If the token is ERC20, the address must be valid
-        if (req.token !== 'NATIVE' && !isAddress(req.token)) {
-            throw new BridgeError(`token address ${req.token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
-        }
-        // The deposit amount cannot be <= 0
-        if (req.depositAmount.isNegative() || req.depositAmount.isZero()) {
-            throw new BridgeError(`deposit amount ${req.depositAmount.toString()} is invalid`, BridgeErrorType.INVALID_AMOUNT);
-        }
-        const erc20Contract = await withBridgeError(async () => new Contract(req.token, ERC20, this.config.rootProvider), BridgeErrorType.INTERNAL_ERROR);
-        // Get the current approved allowance of the RootERC20Predicate
-        const rootERC20PredicateAllowance = await withBridgeError(() => erc20Contract.allowance(req.depositorAddress, this.config.bridgeContracts.rootChainERC20Predicate), BridgeErrorType.PROVIDER_ERROR);
-        // If the allowance is greater than or equal to the deposit amount, no approval is required
-        if (rootERC20PredicateAllowance.gte(req.depositAmount)) {
-            return {
-                unsignedTx: null,
-                required: false,
-            };
-        }
-        // Calculate the amount of tokens that need to be approved for deposit
-        const approvalAmountRequired = req.depositAmount.sub(rootERC20PredicateAllowance);
-        // Encode the approve function call data for the ERC20 contract
-        const data = await withBridgeError(async () => erc20Contract.interface.encodeFunctionData('approve', [
-            this.config.bridgeContracts.rootChainERC20Predicate,
-            approvalAmountRequired,
-        ]), BridgeErrorType.INTERNAL_ERROR);
-        // Create the unsigned transaction for the approval
-        const unsignedTx = {
-            data,
-            to: req.token,
-            value: 0,
-            from: req.depositorAddress,
-        };
-        return {
-            unsignedTx,
-            required: true,
-        };
-    }
-    /**
-     * Waits for the deposit transaction to be confirmed and synced from the root chain to the child chain.
-     *
-     * @param {WaitForRequest} req - The wait for request object containing the transaction hash.
-     * @returns {Promise<WaitForResponse>} - A promise that resolves to an object containing the status of the deposit transaction.
-     * @throws {BridgeError} - If an error occurs during the transaction confirmation or state sync, a BridgeError will be thrown with a specific error type.
-     *
-     * Possible BridgeError types include:
-     * - PROVIDER_ERROR: An error occurred with the Ethereum provider during transaction confirmation or state synchronization.
-     * - TRANSACTION_REVERTED: The transaction on the root chain was reverted.
-     *
-     * @example
-     * const waitForRequest = {
-     *   transactionHash: '0x123456...', // Deposit transaction hash on the root chain
-     * };
-     *
-     * bridgeSdk.waitForDeposit(waitForRequest)
-     *   .then((waitForResponse) => {
-     *     console.log('Deposit Transaction Status:', waitForResponse.status);
-     *   })
-     *   .catch((error) => {
-     *     console.error('Error:', error.message);
-     *   });
-     */
-    async waitForDeposit(req) {
-        const rootTxReceipt = await withBridgeError(async () => this.config.rootProvider.waitForTransaction(req.transactionHash, this.config.rootChainFinalityBlocks), BridgeErrorType.PROVIDER_ERROR);
-        // Throw an error if the transaction was reverted
-        if (rootTxReceipt.status !== 1) {
-            throw new BridgeError(`${rootTxReceipt.transactionHash} on rootchain was reverted`, BridgeErrorType.TRANSACTION_REVERTED);
-        }
-        // Get the state sync ID from the transaction receipt
-        const stateSyncID = await withBridgeError(async () => this.getRootStateSyncID(rootTxReceipt), BridgeErrorType.PROVIDER_ERROR);
-        // Get the block for the timestamp
-        const rootBlock = await this.config.rootProvider.getBlock(rootTxReceipt.blockNumber);
-        // Get the minimum block on childchain which corresponds with the timestamp on rootchain
-        const minBlockRange = await withBridgeError(async () => getBlockNumberClosestToTimestamp(this.config.childProvider, rootBlock.timestamp, this.config.blockTime, this.config.clockInaccuracy), BridgeErrorType.PROVIDER_ERROR);
-        // Get the upper bound for which we expect the StateSync event to occur
+        ],
+        name: 'Unauthorized',
+        type: 'error',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: 'uint8',
+                name: 'version',
+                type: 'uint8',
+            },
+        ],
+        name: 'Initialized',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'rootToken',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'childToken',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'address',
+                name: 'sender',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'L2ERC20Deposit',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'rootToken',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'childToken',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'address',
+                name: 'sender',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'L2ERC20Withdraw',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'rootToken',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'childToken',
+                type: 'address',
+            },
+        ],
+        name: 'L2TokenMapped',
+        type: 'event',
+    },
+    {
+        inputs: [],
+        name: 'DEPOSIT_SIG',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'MAP_TOKEN_SIG',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'NATIVE_TOKEN_CONTRACT',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'NATIVE_TRANSFER_PRECOMPILE',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'NATIVE_TRANSFER_PRECOMPILE_GAS',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'SYSTEM',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'VALIDATOR_PKCHECK_PRECOMPILE',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'VALIDATOR_PKCHECK_PRECOMPILE_GAS',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'WITHDRAW_SIG',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'childTokenTemplate',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'newL2StateSender',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'newStateReceiver',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'newRootERC20Predicate',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'newChildTokenTemplate',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'newNativeTokenRootAddress',
+                type: 'address',
+            },
+        ],
+        name: 'initialize',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'l2StateSender',
+        outputs: [
+            {
+                internalType: 'contract IStateSender',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+            {
+                internalType: 'address',
+                name: 'sender',
+                type: 'address',
+            },
+            {
+                internalType: 'bytes',
+                name: 'data',
+                type: 'bytes',
+            },
+        ],
+        name: 'onStateReceive',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'rootERC20Predicate',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        name: 'rootTokenToChildToken',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'stateReceiver',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'contract IChildERC20',
+                name: 'childToken',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'withdraw',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'contract IChildERC20',
+                name: 'childToken',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'withdrawTo',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+];
+
+const CHECKPOINT_MANAGER = [
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: 'uint8',
+                name: 'version',
+                type: 'uint8',
+            },
+        ],
+        name: 'Initialized',
+        type: 'event',
+    },
+    {
+        inputs: [],
+        name: 'DOMAIN',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'bls',
+        outputs: [
+            {
+                internalType: 'contract IBLS',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'bn256G2',
+        outputs: [
+            {
+                internalType: 'contract IBN256G2',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'chainId',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        name: 'checkpointBlockNumbers',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        name: 'checkpoints',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: 'epoch',
+                type: 'uint256',
+            },
+            {
+                internalType: 'uint256',
+                name: 'blockNumber',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes32',
+                name: 'eventRoot',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'currentCheckpointBlockNumber',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'currentEpoch',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        name: 'currentValidatorSet',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '_address',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'votingPower',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'currentValidatorSetHash',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'currentValidatorSetLength',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'blockNumber',
+                type: 'uint256',
+            },
+        ],
+        name: 'getCheckpointBlock',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'blockNumber',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes32',
+                name: 'leaf',
+                type: 'bytes32',
+            },
+            {
+                internalType: 'uint256',
+                name: 'leafIndex',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes32[]',
+                name: 'proof',
+                type: 'bytes32[]',
+            },
+        ],
+        name: 'getEventMembershipByBlockNumber',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'epoch',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes32',
+                name: 'leaf',
+                type: 'bytes32',
+            },
+            {
+                internalType: 'uint256',
+                name: 'leafIndex',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes32[]',
+                name: 'proof',
+                type: 'bytes32[]',
+            },
+        ],
+        name: 'getEventMembershipByEpoch',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'blockNumber',
+                type: 'uint256',
+            },
+        ],
+        name: 'getEventRootByBlock',
+        outputs: [
+            {
+                internalType: 'bytes32',
+                name: '',
+                type: 'bytes32',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'contract IBLS',
+                name: 'newBls',
+                type: 'address',
+            },
+            {
+                internalType: 'contract IBN256G2',
+                name: 'newBn256G2',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'chainId_',
+                type: 'uint256',
+            },
+            {
+                components: [
+                    {
+                        internalType: 'address',
+                        name: '_address',
+                        type: 'address',
+                    },
+                    {
+                        internalType: 'uint256[4]',
+                        name: 'blsKey',
+                        type: 'uint256[4]',
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'votingPower',
+                        type: 'uint256',
+                    },
+                ],
+                internalType: 'struct ICheckpointManager.Validator[]',
+                name: 'newValidatorSet',
+                type: 'tuple[]',
+            },
+        ],
+        name: 'initialize',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: 'bytes32',
+                        name: 'blockHash',
+                        type: 'bytes32',
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'blockRound',
+                        type: 'uint256',
+                    },
+                    {
+                        internalType: 'bytes32',
+                        name: 'currentValidatorSetHash',
+                        type: 'bytes32',
+                    },
+                ],
+                internalType: 'struct ICheckpointManager.CheckpointMetadata',
+                name: 'checkpointMetadata',
+                type: 'tuple',
+            },
+            {
+                components: [
+                    {
+                        internalType: 'uint256',
+                        name: 'epoch',
+                        type: 'uint256',
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'blockNumber',
+                        type: 'uint256',
+                    },
+                    {
+                        internalType: 'bytes32',
+                        name: 'eventRoot',
+                        type: 'bytes32',
+                    },
+                ],
+                internalType: 'struct ICheckpointManager.Checkpoint',
+                name: 'checkpoint',
+                type: 'tuple',
+            },
+            {
+                internalType: 'uint256[2]',
+                name: 'signature',
+                type: 'uint256[2]',
+            },
+            {
+                components: [
+                    {
+                        internalType: 'address',
+                        name: '_address',
+                        type: 'address',
+                    },
+                    {
+                        internalType: 'uint256[4]',
+                        name: 'blsKey',
+                        type: 'uint256[4]',
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'votingPower',
+                        type: 'uint256',
+                    },
+                ],
+                internalType: 'struct ICheckpointManager.Validator[]',
+                name: 'newValidatorSet',
+                type: 'tuple[]',
+            },
+            {
+                internalType: 'bytes',
+                name: 'bitmap',
+                type: 'bytes',
+            },
+        ],
+        name: 'submit',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'totalVotingPower',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+
+function decodeExtraData(extraData) {
+    const decoded = decode(`0x${extraData.substring(66)}`);
+    const blockExtraData = {
+        validators: decoded[0],
+        parent: decoded[1],
+        committed: decoded[2],
+        checkpoint: {
+            blockRound: decoded[3][0],
+            epochNumber: parseInt(decoded[3][1], 16),
+            currentValidatorHash: decoded[3][2],
+            nextValidatorHash: decoded[3][3],
+            eventRoot: decoded[3][4],
+        },
+    };
+    return blockExtraData;
+}
+
+/**
+ * @constant {string} ETH_SEPOLIA_CHAIN_ID - The chain ID for the Ethereum Sepolia testnet (EIP-155 compatible format).
+ */
+const ETH_SEPOLIA_CHAIN_ID = '11155111';
+/**
+ * @constant {string} ETH_MAINNET_CHAIN_ID - The chain ID for the Ethereum mainnet (EIP-155 compatible format).
+ */
+const ETH_MAINNET_CHAIN_ID = '1';
+/**
+ * @constant {string} ZKEVM_DEVNET_CHAIN_ID - The chain ID for the zkEVM devnet (EIP-155 compatible format).
+ */
+const ZKEVM_DEVNET_CHAIN_ID = '13433';
+/**
+/**
+ * @constant {string} ZKEVM_TESTNET_CHAIN_ID - The chain ID for the zkEVM testnet (EIP-155 compatible format).
+ */
+const ZKEVM_TESTNET_CHAIN_ID = '13372';
+/**
+ * @constant {string} ZKEVM_MAINNET_CHAIN_ID - The chain ID for the zkEVM mainnet (EIP-155 compatible format).
+ */
+const ZKEVM_MAINNET_CHAIN_ID = '13371';
+/**
+ * @constant {string} L2_STATE_SENDER_ADDRESS - Address of bridge contract to the rootchain
+ */
+const L2_STATE_SENDER_ADDRESS = '0x0000000000000000000000000000000000001002';
+/**
+ * The constant value representing the native token in the token bridge context.
+ * The key is used to indicate the native token of a blockchain network (like Ether in Ethereum) in methods that normally require a token address.
+ * @constant {string}
+ */
+const NATIVE_TOKEN_BRIDGE_KEY = '0x0000000000000000000000000000000000000001';
+/**
+ * @constant {BridgeInstance} ETH_SEPOLIA_TO_ZKEVM_DEVNET - A bridge instance configuration for bridging between the Ethereum Sepolia testnet and the zkEVM devnet.
+ */
+const ETH_SEPOLIA_TO_ZKEVM_DEVNET = {
+    rootChainID: ETH_SEPOLIA_CHAIN_ID,
+    childChainID: ZKEVM_DEVNET_CHAIN_ID,
+};
+/**
+ * @constant {BridgeInstance} ETH_SEPOLIA_TO_ZKEVM_TESTNET - A bridge instance configuration for bridging between the Ethereum Sepolia testnet and the zkEVM testnet.
+ */
+const ETH_SEPOLIA_TO_ZKEVM_TESTNET = {
+    rootChainID: ETH_SEPOLIA_CHAIN_ID,
+    childChainID: ZKEVM_TESTNET_CHAIN_ID,
+};
+/**
+ * @constant {BridgeInstance} ETH_MAINNET_TO_ZKEVM_MAINNET - A bridge instance configuration for bridging between the Ethereum mainnet and the zkEVM mainnet.
+ */
+const ETH_MAINNET_TO_ZKEVM_MAINNET = {
+    rootChainID: ETH_MAINNET_CHAIN_ID,
+    childChainID: ZKEVM_MAINNET_CHAIN_ID,
+};
+
+const L2_STATE_SENDER = [
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'uint256',
+                name: 'id',
+                type: 'uint256',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'sender',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'bytes',
+                name: 'data',
+                type: 'bytes',
+            },
+        ],
+        name: 'L2StateSynced',
+        type: 'event',
+    },
+    {
+        inputs: [],
+        name: 'MAX_LENGTH',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'counter',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'receiver',
+                type: 'address',
+            },
+            {
+                internalType: 'bytes',
+                name: 'data',
+                type: 'bytes',
+            },
+        ],
+        name: 'syncState',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+];
+
+const EXIT_HELPER = [
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'uint256',
+                name: 'id',
+                type: 'uint256',
+            },
+            {
+                indexed: true,
+                internalType: 'bool',
+                name: 'success',
+                type: 'bool',
+            },
+            {
+                indexed: false,
+                internalType: 'bytes',
+                name: 'returnData',
+                type: 'bytes',
+            },
+        ],
+        name: 'ExitProcessed',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: 'uint8',
+                name: 'version',
+                type: 'uint8',
+            },
+        ],
+        name: 'Initialized',
+        type: 'event',
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: 'uint256',
+                        name: 'blockNumber',
+                        type: 'uint256',
+                    },
+                    {
+                        internalType: 'uint256',
+                        name: 'leafIndex',
+                        type: 'uint256',
+                    },
+                    {
+                        internalType: 'bytes',
+                        name: 'unhashedLeaf',
+                        type: 'bytes',
+                    },
+                    {
+                        internalType: 'bytes32[]',
+                        name: 'proof',
+                        type: 'bytes32[]',
+                    },
+                ],
+                internalType: 'struct IExitHelper.BatchExitInput[]',
+                name: 'inputs',
+                type: 'tuple[]',
+            },
+        ],
+        name: 'batchExit',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'checkpointManager',
+        outputs: [
+            {
+                internalType: 'contract ICheckpointManager',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'blockNumber',
+                type: 'uint256',
+            },
+            {
+                internalType: 'uint256',
+                name: 'leafIndex',
+                type: 'uint256',
+            },
+            {
+                internalType: 'bytes',
+                name: 'unhashedLeaf',
+                type: 'bytes',
+            },
+            {
+                internalType: 'bytes32[]',
+                name: 'proof',
+                type: 'bytes32[]',
+            },
+        ],
+        name: 'exit',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'contract ICheckpointManager',
+                name: 'newCheckpointManager',
+                type: 'address',
+            },
+        ],
+        name: 'initialize',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        name: 'processedExits',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+
+const CHILD_ERC20 = [
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'owner',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'spender',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'uint256',
+                name: 'value',
+                type: 'uint256',
+            },
+        ],
+        name: 'Approval',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: 'uint8',
+                name: 'version',
+                type: 'uint8',
+            },
+        ],
+        name: 'Initialized',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: 'address',
+                name: 'userAddress',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'address',
+                name: 'relayerAddress',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'bytes',
+                name: 'functionSignature',
+                type: 'bytes',
+            },
+        ],
+        name: 'MetaTransactionExecuted',
+        type: 'event',
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'from',
+                type: 'address',
+            },
+            {
+                indexed: true,
+                internalType: 'address',
+                name: 'to',
+                type: 'address',
+            },
+            {
+                indexed: false,
+                internalType: 'uint256',
+                name: 'value',
+                type: 'uint256',
+            },
+        ],
+        name: 'Transfer',
+        type: 'event',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'owner',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'spender',
+                type: 'address',
+            },
+        ],
+        name: 'allowance',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'spender',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'approve',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'account',
+                type: 'address',
+            },
+        ],
+        name: 'balanceOf',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'account',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'burn',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'decimals',
+        outputs: [
+            {
+                internalType: 'uint8',
+                name: '',
+                type: 'uint8',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'spender',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'subtractedValue',
+                type: 'uint256',
+            },
+        ],
+        name: 'decreaseAllowance',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'userAddress',
+                type: 'address',
+            },
+            {
+                internalType: 'bytes',
+                name: 'functionSignature',
+                type: 'bytes',
+            },
+            {
+                internalType: 'bytes32',
+                name: 'sigR',
+                type: 'bytes32',
+            },
+            {
+                internalType: 'bytes32',
+                name: 'sigS',
+                type: 'bytes32',
+            },
+            {
+                internalType: 'uint8',
+                name: 'sigV',
+                type: 'uint8',
+            },
+        ],
+        name: 'executeMetaTransaction',
+        outputs: [
+            {
+                internalType: 'bytes',
+                name: '',
+                type: 'bytes',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'user',
+                type: 'address',
+            },
+        ],
+        name: 'getNonce',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: 'nonce',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'spender',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'addedValue',
+                type: 'uint256',
+            },
+        ],
+        name: 'increaseAllowance',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'rootToken_',
+                type: 'address',
+            },
+            {
+                internalType: 'string',
+                name: 'name_',
+                type: 'string',
+            },
+            {
+                internalType: 'string',
+                name: 'symbol_',
+                type: 'string',
+            },
+            {
+                internalType: 'uint8',
+                name: 'decimals_',
+                type: 'uint8',
+            },
+        ],
+        name: 'initialize',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'uint256',
+                name: 'offset',
+                type: 'uint256',
+            },
+        ],
+        name: 'invalidateNext',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'account',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'mint',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'name',
+        outputs: [
+            {
+                internalType: 'string',
+                name: '',
+                type: 'string',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'predicate',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'rootToken',
+        outputs: [
+            {
+                internalType: 'address',
+                name: '',
+                type: 'address',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'symbol',
+        outputs: [
+            {
+                internalType: 'string',
+                name: '',
+                type: 'string',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [],
+        name: 'totalSupply',
+        outputs: [
+            {
+                internalType: 'uint256',
+                name: '',
+                type: 'uint256',
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'to',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'transfer',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    {
+        inputs: [
+            {
+                internalType: 'address',
+                name: 'from',
+                type: 'address',
+            },
+            {
+                internalType: 'address',
+                name: 'to',
+                type: 'address',
+            },
+            {
+                internalType: 'uint256',
+                name: 'amount',
+                type: 'uint256',
+            },
+        ],
+        name: 'transferFrom',
+        outputs: [
+            {
+                internalType: 'bool',
+                name: '',
+                type: 'bool',
+            },
+        ],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+];
+
+/**
+ * Represents a token bridge, which manages asset transfers between two chains.
+ */
+class TokenBridge {
+    /**
+     * @property {BridgeConfiguration} config - The bridge configuration object.
+     */
+    config;
+    /**
+     * Constructs a TokenBridge instance.
+     *
+     * @param {BridgeConfiguration} config - The bridge configuration object.
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Retrieves the bridge fee for depositing a specific token, used to reimburse the bridge-relayer.
+     * It is clipped from the deposit amount.
+     *
+     * @param {BridgeFeeRequest} req - The fee request object containing the token address for which the fee is required.
+     * @returns {Promise<BridgeFeeResponse>} - A promise that resolves to an object containing the bridge fee for the specified token and a flag indicating if the token is bridgeable.
+     * @throws {BridgeError} - If an error occurs during the fee retrieval, a BridgeError will be thrown with a specific error type.
+     *
+     * Possible BridgeError types include:
+     * - INVALID_ADDRESS: The token address provided in the request is invalid.
+     *
+     * @example
+     * const feeRequest = {
+     *   token: '0x123456...', // token
+     * };
+     *
+     * @example
+     * const feeRequest = {
+     *   token: 'NATIVE', // token
+     * };
+     *
+     * bridgeSdk.getFee(feeRequest)
+     *   .then((feeResponse) => {
+     *     console.log('Bridgeable:', feeResponse.bridgeable);
+     *     console.log('Fee Amount:', feeResponse.feeAmount.toString());
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async getFee(req) {
+        this.validateChainConfiguration();
+        if (req.token !== 'NATIVE' && !isAddress(req.token)) {
+            throw new BridgeError(`token address ${req.token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+        return {
+            bridgeable: true,
+            feeAmount: BigNumber.from(0),
+        };
+    }
+    /**
+     * Retrieves the unsigned approval transaction for a deposit to the bridge.
+     * Approval is required before depositing tokens to the bridge using
+     *
+     * @param {ApproveBridgeRequest} req - The approve bridge request object containing the depositor address, token address, and deposit amount.
+     * @returns {Promise<ApproveBridgeResponse>} - A promise that resolves to an object containing the unsigned approval transaction and a flag indicating if the approval is required.
+     * @throws {BridgeError} - If an error occurs during the transaction creation, a BridgeError will be thrown with a specific error type.
+     *
+     * Possible BridgeError types include:
+     * - UNSUPPORTED_ERROR: The operation is not supported. Currently thrown when attempting to deposit native tokens.
+     * - INVALID_ADDRESS: An Ethereum address provided in the request is invalid.
+     * - INVALID_AMOUNT: The deposit amount provided in the request is invalid (less than or equal to 0).
+     * - INTERNAL_ERROR: An unexpected error occurred during the execution, likely due to the bridge SDK implementation.
+     * - PROVIDER_ERROR: An error occurred while interacting with the Ethereum provider. This includes issues calling the ERC20 smart contract
+     *
+     * @example
+     * const approveRequest = {
+     *   depositorAddress: '0x123456...', // Depositor's Ethereum address
+     *   token: '0xabcdef...', // ERC20 token address
+     *   depositAmount: ethers.utils.parseUnits('100', 18), // Deposit amount in token's smallest unit (e.g., wei for Ether)
+     * };
+     *
+     * bridgeSdk.getUnsignedApproveDepositBridgeTx(approveRequest)
+     *   .then((approveResponse) => {
+     *     if (approveResponse.unsignedTx) {
+     *       // Send the unsigned approval transaction to the depositor to sign and send
+     *     } else {
+     *      // No approval is required
+     *     }
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async getUnsignedApproveDepositBridgeTx(req) {
+        this.validateChainConfiguration();
+        TokenBridge.validateDepositArgs(req.depositorAddress, req.depositAmount, req.token);
+        // If the token is NATIVE, no approval is required
+        if (req.token === 'NATIVE') {
+            return {
+                unsignedTx: null,
+            };
+        }
+        const erc20Contract = await withBridgeError(async () => new Contract(req.token, ERC20, this.config.rootProvider), BridgeErrorType.PROVIDER_ERROR);
+        // Get the current approved allowance of the RootERC20Predicate
+        const rootERC20PredicateAllowance = await withBridgeError(() => erc20Contract.allowance(req.depositorAddress, this.config.bridgeContracts.rootChainERC20Predicate), BridgeErrorType.PROVIDER_ERROR);
+        // If the allowance is greater than or equal to the deposit amount, no approval is required
+        if (rootERC20PredicateAllowance.gte(req.depositAmount)) {
+            return {
+                unsignedTx: null,
+            };
+        }
+        // Calculate the amount of tokens that need to be approved for deposit
+        const approvalAmountRequired = req.depositAmount.sub(rootERC20PredicateAllowance);
+        // Encode the approve function call data for the ERC20 contract
+        const data = await withBridgeError(async () => erc20Contract.interface.encodeFunctionData('approve', [
+            this.config.bridgeContracts.rootChainERC20Predicate,
+            approvalAmountRequired,
+        ]), BridgeErrorType.INTERNAL_ERROR);
+        // Create the unsigned transaction for the approval
+        const unsignedTx = {
+            data,
+            to: req.token,
+            value: 0,
+            from: req.depositorAddress,
+        };
+        return {
+            unsignedTx,
+        };
+    }
+    /**
+     * Generates an unsigned deposit transaction for a user to sign and submit to the bridge.
+     * Must be called after bridgeSdk.getUnsignedApproveDepositBridgeTx to ensure user has approved sufficient tokens for deposit.
+     *
+     * @param {BridgeDepositRequest} req - The deposit request object containing the required data for depositing tokens.
+     * @returns {Promise<BridgeDepositResponse>} - A promise that resolves to an object containing the unsigned transaction data.
+     * @throws {BridgeError} - If an error occurs during the generation of the unsigned transaction, a BridgeError will be thrown with a specific error type.
+     *
+     * Possible BridgeError types include:
+     * - UNSUPPORTED_ERROR: The operation is not supported. Currently thrown when attempting to deposit native tokens.
+     * - INVALID_ADDRESS: An Ethereum address provided in the request is invalid. This could be the depositor's, recipient's or the token's address.
+     * - INVALID_AMOUNT: The deposit amount provided in the request is invalid (less than or equal to 0).
+     * - INTERNAL_ERROR: An unexpected error occurred during the execution, likely due to the bridge SDK implementation.
+     *
+     * @example
+     * const depositERC20Request = {
+     *   token: '0x123456...', // ERC20 token address
+     *   depositorAddress: '0xabcdef...', // User's wallet address
+     *   recipientAddress: '0x987654...', // Destination wallet address on the target chain
+     *   depositAmount: ethers.utils.parseUnits('100', 18), // Deposit amount in wei
+     * };
+     *
+     * @example
+     * const depositEtherTokenRequest = {
+     *   token: 'NATIVE',
+     *   depositorAddress: '0xabcdef...', // User's wallet address
+     *   recipientAddress: '0x987654...', // Destination wallet address on the target chain
+     *   depositAmount: ethers.utils.parseUnits('100', 18), // Deposit amount in wei
+     * };
+     *
+     * bridgeSdk.getUnsignedDepositTx(depositRequest)
+     *   .then((depositResponse) => {
+     *     console.log(depositResponse.unsignedTx);
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async getUnsignedDepositTx(req) {
+        this.validateChainConfiguration();
+        TokenBridge.validateDepositArgs(req.recipientAddress, req.depositAmount, req.token);
+        const rootERC20PredicateContract = await withBridgeError(async () => {
+            const contract = new Contract(this.config.bridgeContracts.rootChainERC20Predicate, ROOT_ERC20_PREDICATE);
+            return contract;
+        }, BridgeErrorType.INTERNAL_ERROR);
+        // Convert the addresses to correct format addresses (e.g. prepend 0x if not already)
+        const receipient = getAddress(req.recipientAddress);
+        // Handle return if it is a native token
+        if (req.token === 'NATIVE') {
+            // Encode the function data into a payload
+            const data = await withBridgeError(async () => rootERC20PredicateContract.interface.encodeFunctionData('depositNativeTo', [receipient]), BridgeErrorType.INTERNAL_ERROR);
+            return {
+                unsignedTx: {
+                    data,
+                    to: this.config.bridgeContracts.rootChainERC20Predicate,
+                    value: req.depositAmount,
+                },
+            };
+        }
+        // Handle return for ERC20
+        const token = getAddress(req.token);
+        // Encode the function data into a payload
+        const data = await withBridgeError(async () => rootERC20PredicateContract.interface.encodeFunctionData('depositTo', [token, receipient, req.depositAmount]), BridgeErrorType.INTERNAL_ERROR);
+        return {
+            unsignedTx: {
+                data,
+                to: this.config.bridgeContracts.rootChainERC20Predicate,
+                value: 0,
+            },
+        };
+    }
+    /**
+     * Waits for the deposit transaction to be confirmed and synced from the root chain to the child chain.
+     *
+     * @param {WaitForDepositRequest} req - The wait for request object containing the transaction hash.
+     * @returns {Promise<WaitForDepositResponse>} - A promise that resolves to an object containing the status of the deposit transaction.
+     * @throws {BridgeError} - If an error occurs during the transaction confirmation or state sync, a BridgeError will be thrown with a specific error type.
+     *
+     * Possible BridgeError types include:
+     * - PROVIDER_ERROR: An error occurred with the Ethereum provider during transaction confirmation or state synchronization.
+     * - TRANSACTION_REVERTED: The transaction on the root chain was reverted.
+     *
+     * @example
+     * const waitForRequest = {
+     *   transactionHash: '0x123456...', // Deposit transaction hash on the root chain
+     * };
+     *
+     * bridgeSdk.waitForDeposit(waitForRequest)
+     *   .then((waitForResponse) => {
+     *     console.log('Deposit Transaction Status:', waitForResponse.status);
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async waitForDeposit(req) {
+        this.validateChainConfiguration();
+        const rootTxReceipt = await withBridgeError(async () => this.config.rootProvider.waitForTransaction(req.transactionHash, this.config.rootChainFinalityBlocks), BridgeErrorType.PROVIDER_ERROR);
+        // Throw an error if the transaction was reverted
+        if (rootTxReceipt.status !== 1) {
+            throw new BridgeError(`${rootTxReceipt.transactionHash} on rootchain was reverted`, BridgeErrorType.TRANSACTION_REVERTED);
+        }
+        // Get the state sync ID from the transaction receipt
+        const stateSyncID = await withBridgeError(async () => this.getRootStateSyncID(rootTxReceipt), BridgeErrorType.PROVIDER_ERROR);
+        // Get the block for the timestamp
+        const rootBlock = await withBridgeError(async () => await this.config.rootProvider.getBlock(rootTxReceipt.blockNumber), BridgeErrorType.PROVIDER_ERROR, `failed to query block ${rootTxReceipt.blockNumber} on rootchain`);
+        // Get the minimum block on childchain which corresponds with the timestamp on rootchain
+        const minBlockRange = await withBridgeError(async () => getBlockNumberClosestToTimestamp(this.config.childProvider, rootBlock.timestamp, this.config.blockTime, this.config.clockInaccuracy), BridgeErrorType.PROVIDER_ERROR);
+        // Get the upper bound for which we expect the StateSync event to occur
         const maxBlockRange = minBlockRange + this.config.maxDepositBlockDelay;
         // Poll till event observed
         const result = await withBridgeError(async () => this.waitForChildStateSync(stateSyncID, this.config.pollInterval, minBlockRange, maxBlockRange), BridgeErrorType.PROVIDER_ERROR);
@@ -10146,6 +11895,271 @@ class TokenBridge {
             status: result,
         };
     }
+    /**
+   * Retrieves the corresponding child token address for a given root token address.
+   * This function is used to map a root token to its child token in the context of a bridging system between chains.
+   * If the token is native, a special key is used to represent it.
+   *
+   * @param {RootTokenToChildTokenRequest} req - The request object containing the root token address or the string 'NATIVE'.
+   * @returns {Promise<RootTokenToChildTokenResponse>} - A promise that resolves to an object containing the child token address.
+   * @throws {BridgeError} - If an error occurs during the query, a BridgeError will be thrown with a specific error type.
+   *
+   * Possible BridgeError types include:
+   * - INVALID_ADDRESS: If the Ethereum address provided in the request is invalid.
+   * - PROVIDER_ERROR: If there's an error in querying the rootTokenToChildToken mapping.
+   * - INTERNAL_ERROR: An unexpected error occurred during the execution.
+   *
+   * @example
+   * const request = {
+   *   rootToken: '0x123456...', // Root token address or 'NATIVE'
+   * };
+   *
+   * bridgeSdk.rootTokenToChildToken(request)
+   *   .then((response) => {
+   *     console.log(response.childToken); // Child token address
+   *   })
+   *   .catch((error) => {
+   *     console.error('Error:', error.message);
+   *   });
+   */
+    async rootTokenToChildToken(req) {
+        // Validate the chain configuration to ensure proper setup
+        this.validateChainConfiguration();
+        // If the root token is native, use the native token key; otherwise, use the provided root token address
+        const reqTokenAddress = (req.rootToken === 'NATIVE') ? NATIVE_TOKEN_BRIDGE_KEY : req.rootToken;
+        // Validate the request token address
+        if (!isAddress(reqTokenAddress)) {
+            throw new BridgeError(`recipient address ${reqTokenAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+        // Create an instance of the root ERC20 predicate contract
+        const childTokenAddress = await withBridgeError(async () => {
+            const rootERC20Predicate = new Contract(this.config.bridgeContracts.rootChainERC20Predicate, ROOT_ERC20_PREDICATE, this.config.rootProvider);
+            return await rootERC20Predicate.rootTokenToChildToken(reqTokenAddress);
+        }, BridgeErrorType.PROVIDER_ERROR, 'failed to query rootTokenToChildToken mapping');
+        // Return the child token address
+        return {
+            childToken: childTokenAddress,
+        };
+    }
+    /**
+   * Retrieves the corresponding root token address for a given child token address.
+   * This function is used to map a child token back to its root token in the context of a bridging system between chains.
+   *
+   * If the root token address matches the address designated for the native token, the method will return 'NATIVE'.
+   *
+   * @param {ChildTokenToRootTokenRequest} req - The request object containing the child token address.
+   * @returns {Promise<ChildTokenToRootTokenResponse>} - A promise that resolves to an object containing the root token address.
+   * @throws {BridgeError} - If an error occurs during the query, a BridgeError will be thrown with a specific error type.
+   *
+   * Possible BridgeError types include:
+   * - PROVIDER_ERROR: If there's an error in querying the root token from the child token contract.
+   * - INVALID_TOKEN: If the token being withdrawed is not a valid bridgeable token
+   *
+   * @example
+   * const request = {
+   *   childToken: '0x123456...', // Child token address
+   * };
+   *
+   * bridgeSdk.childTokenToRootToken(request)
+   *   .then((response) => {
+   *     console.log(response.rootToken); // Outputs: 'NATIVE' or Root token address
+   *   })
+   *   .catch((error) => {
+   *     console.error('Error:', error.message);
+   *   });
+   */
+    async childTokenToRootToken(req) {
+        // Validate the chain configuration to ensure proper setup
+        this.validateChainConfiguration();
+        // Query the corresponding root token address using the child token contract
+        const rootToken = await withBridgeError(async () => {
+            // Create an instance of the child token contract using the given child token address
+            const childToken = new Contract(req.childToken, CHILD_ERC20, this.config.childProvider);
+            return await childToken.rootToken();
+        }, BridgeErrorType.PROVIDER_ERROR, 'failed to query the root token from the child token contract');
+        // Check if the rootToken address is the designated native token address. If it is, return 'NATIVE'. Else, return the root token address.
+        return {
+            rootToken: (rootToken === NATIVE_TOKEN_BRIDGE_KEY) ? 'NATIVE' : rootToken,
+        };
+    }
+    /**
+     * Generates an unsigned transaction that a user can use to initiate a token withdrawal from the bridge.
+     * The user must sign and submit this transaction to execute the withdrawal.
+     *
+     * @param {BridgeWithdrawRequest} req - The withdrawal request object containing the necessary data for withdrawing tokens.
+     * @returns {Promise<BridgeWithdrawResponse>} - A promise that resolves to an object containing the unsigned transaction data.
+     *
+     * @throws {BridgeError} - If an error occurs during the generation of the unsigned transaction, a BridgeError will be thrown with a specific error type.
+     * Possible BridgeError types include:
+     * - INVALID_ADDRESS: The Ethereum address provided in the request is invalid. This could be the user's address or the token's address.
+     * - INVALID_AMOUNT: The withdrawal amount provided in the request is invalid (less than or equal to 0).
+     * - PROVIDER_ERROR: An error occurred when interacting with the Ethereum provider, likely due to a network or connectivity issue.
+     * - INTERNAL_ERROR: An unexpected error occurred during the execution, likely due to the bridge SDK implementation.
+     *
+     * @example
+     * const withdrawRequest = {
+     *   token: '0x123456...', // ERC20 token address
+     *   recipientAddress: '0xabcdef...', // Address to receive the withdrawn tokens
+     *   withdrawAmount: ethers.utils.parseUnits('100', 18), // Withdraw amount in wei
+     * };
+     *
+     * bridgeSdk.getUnsignedWithdrawTx(withdrawRequest)
+     *   .then((withdrawalResponse) => {
+     *     console.log(withdrawalResponse.unsignedTx);
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async getUnsignedWithdrawTx(req) {
+        // Ensure the configuration of chains is valid.
+        this.validateChainConfiguration();
+        // Validate the recipient address, withdrawal amount, and token.
+        TokenBridge.validateWithdrawArgs(req.recipientAddress, req.withdrawAmount, req.token);
+        // Create a contract instance for interacting with the ChildERC20Predicate
+        const childERC20PredicateContract = await withBridgeError(async () => {
+            const contract = new Contract(this.config.bridgeContracts.childChainERC20Predicate, CHILD_ERC20_PREDICATE);
+            return contract;
+        }, BridgeErrorType.INTERNAL_ERROR);
+        // Encode the withdrawTo function call data for the ERC20 contract
+        const data = await withBridgeError(async () => childERC20PredicateContract.interface.encodeFunctionData('withdrawTo', [
+            req.token,
+            req.recipientAddress,
+            req.withdrawAmount,
+        ]), BridgeErrorType.INTERNAL_ERROR);
+        // Construct the unsigned transaction for the withdrawal
+        return {
+            unsignedTx: {
+                data,
+                to: this.config.bridgeContracts.childChainERC20Predicate,
+                value: 0,
+            },
+        };
+    }
+    /**
+     * Waits for the withdrawal transaction to be confirmed in the root chain by continuously polling until the transaction is included in a checkpoint.
+     * This function is intended to be used after executing a withdrawal transaction.
+     *
+     * @param {WaitForWithdrawalRequest} req - The request object containing the transaction hash of the withdrawal transaction.
+     * @returns {Promise<WaitForWithdrawalResponse>} - A promise that resolves to an empty object once the withdrawal transaction has been confirmed in the root chain.
+     *
+     * @throws {BridgeError} - If an error occurs during the waiting process, a BridgeError will be thrown with a specific error type.
+     * Possible BridgeError types include:
+     * - PROVIDER_ERROR: An error occurred when interacting with the Ethereum provider, likely due to a network or connectivity issue.
+     *
+     * @example
+     * const waitForWithdrawalRequest = {
+     *   transactionHash: '0x123456...', // Transaction hash of the withdrawal transaction
+     * };
+     *
+     * bridgeSdk.waitForWithdrawal(waitForWithdrawalRequest)
+     *   .then(() => {
+     *     console.log('Withdrawal transaction has been confirmed in the root chain.');
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async waitForWithdrawal(req) {
+        // Ensure the configuration of chains is valid.
+        this.validateChainConfiguration();
+        // Helper function to pause execution for a specified interval
+        const pause = () => new Promise((resolve) => {
+            setTimeout(resolve, this.config.pollInterval);
+        });
+        await withBridgeError(async () => {
+            // Fetch the receipt of the withdrawal transaction
+            const transactionReceipt = await this.config.childProvider.getTransactionReceipt(req.transactionHash);
+            // Fetch the block in which the withdrawal transaction was included
+            const block = await this.config.childProvider.getBlock(transactionReceipt.blockNumber);
+            // Decode the extra data field from the block header
+            const decodedExtraData = decodeExtraData(block.extraData);
+            // Instantiate the checkpoint manager contract
+            const checkpointManager = new Contract(this.config.bridgeContracts.rootChainCheckpointManager, CHECKPOINT_MANAGER, this.config.rootProvider);
+            // Recursive function to keep checking for the child deposit event
+            const waitForRootEpoch = async () => {
+                // Fetch the current checkpoint epoch from the root chain
+                const currentEpoch = await checkpointManager.currentEpoch();
+                // If the current epoch is greater than or equal to the epoch number of the checkpoint in which the withdrawal transaction was included, the withdrawal has been confirmed in the root chain
+                if (currentEpoch >= decodedExtraData.checkpoint.epochNumber) {
+                    return null;
+                }
+                // Pause execution for a specified interval before checking again
+                await pause();
+                // Recursive call
+                return waitForRootEpoch();
+            };
+            // Start waiting for the withdrawal transaction to be confirmed in the root chain
+            await waitForRootEpoch();
+        }, BridgeErrorType.PROVIDER_ERROR);
+        // Return an empty object once the withdrawal transaction has been confirmed in the root chain
+        return {};
+    }
+    /**
+     * Creates an unsigned exit transaction which, when executed, will exit the assets from the child chain to the root chain.
+     * This function should be used after a withdraw transaction has been executed on the child chain.
+     * It should only be executed after `waitForWithdrawal` has completed successfully.
+     *
+     * @param {ExitRequest} req - The request object containing the transaction hash of the withdraw transaction.
+     * @returns {Promise<ExitResponse>} - A promise that resolves to an object containing the unsigned exit transaction.
+     *
+     * @throws {BridgeError} - If an error occurs during the exit transaction creation process, a BridgeError will be thrown with a specific error type.
+     * Possible BridgeError types include:
+     * - PROVIDER_ERROR: An error occurred when interacting with the Ethereum provider, likely due to a network or connectivity issue.
+     * - INVALID_TRANSACTION: The deposit transaction is invalid or the L2StateSynced event log does not match the expected format.
+     * - INTERNAL_ERROR: An internal error occurred during the function call encoding process.
+     *
+     * @example
+     * const exitRequest = {
+     *   transactionHash: '0x123456...', // Transaction hash of the deposit transaction
+     * };
+     *
+     * bridgeSdk.getUnsignedExitTx(exitRequest)
+     *   .then((response) => {
+     *     console.log('Unsigned exit transaction:', response.unsignedTx);
+     *   })
+     *   .catch((error) => {
+     *     console.error('Error:', error.message);
+     *   });
+     */
+    async getUnsignedExitTx(req) {
+        // Ensure the configuration of chains is valid
+        this.validateChainConfiguration();
+        // Fetch the receipt of the deposit transaction
+        const txReceipt = await withBridgeError(async () => await this.config.childProvider.getTransactionReceipt(req.transactionHash), BridgeErrorType.PROVIDER_ERROR);
+        // Filter out the StateSynced event log from the transaction receipt
+        const stateSenderLogs = txReceipt.logs.filter((log) => log.address.toLowerCase() === L2_STATE_SENDER_ADDRESS);
+        if (stateSenderLogs.length !== 1) {
+            throw new BridgeError(`expected 1 log in tx ${txReceipt.transactionHash} from address ${L2_STATE_SENDER_ADDRESS}`, BridgeErrorType.INVALID_TRANSACTION);
+        }
+        // Parse the StateSynced event log
+        const l2StateSyncEvent = await withBridgeError(async () => {
+            const l2StateSenderInterface = new Interface(L2_STATE_SENDER);
+            const event = l2StateSenderInterface.parseLog(stateSenderLogs[0]);
+            // Throw an error if the event log doesn't match the expected format
+            if (event.signature !== 'L2StateSynced(uint256,address,address,bytes)') {
+                throw new Error(`expected L2StateSynced event in tx ${txReceipt.transactionHash}`);
+            }
+            return event;
+        }, BridgeErrorType.INVALID_TRANSACTION);
+        // Instantiate the exit helper contract
+        const exitHelper = await withBridgeError(async () => new Contract(this.config.bridgeContracts.rootChainExitHelper, EXIT_HELPER, this.config.rootProvider), BridgeErrorType.PROVIDER_ERROR);
+        // Generate the exit proof
+        const exitProof = await withBridgeError(async () => this.config.childProvider.send('bridge_generateExitProof', [l2StateSyncEvent.args.id.toHexString()]), BridgeErrorType.PROVIDER_ERROR);
+        // Encode the exit function call data
+        const encodedExitTx = await withBridgeError(async () => {
+            const exitEventEncoded = defaultAbiCoder.encode(['uint256', 'address', 'address', 'bytes'], l2StateSyncEvent.args);
+            return exitHelper.interface.encodeFunctionData('exit', [exitProof.Metadata.CheckpointBlock, exitProof.Metadata.LeafIndex, exitEventEncoded, exitProof.Data]);
+        }, BridgeErrorType.INTERNAL_ERROR);
+        // Create the unsigned exit transaction
+        const unsignedTx = {
+            data: encodedExitTx,
+            to: this.config.bridgeContracts.rootChainExitHelper,
+            value: 0,
+        };
+        // Return the unsigned exit transaction
+        return { unsignedTx };
+    }
     async waitForChildStateSync(stateSyncID, interval, minBlockRange, maxBlockRange) {
         const childStateReceiver = new Contract(this.config.bridgeContracts.childChainStateReceiver, CHILD_STATE_RECEIVER, this.config.childProvider);
         // Set up an event filter for the StateSyncResult event
@@ -10196,57 +12210,47 @@ class TokenBridge {
         const stateSyncID = parseInt(stateSyncEvent.args.id, 10);
         return stateSyncID;
     }
-    // TODO: please fix this
-    // eslint-disable-next-line class-methods-use-this
-    async getFeeForToken(
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    token) {
-        return BigNumber.from(0);
-    }
-}
-
-/**
- * @constant {string} ETH_SEPOLIA_CHAIN_ID - The chain ID for the Ethereum Sepolia testnet (EIP-155 compatible format).
- */
-const ETH_SEPOLIA_CHAIN_ID = 'eip155:11155111';
-/**
- * @constant {string} ETH_MAINNET_CHAIN_ID - The chain ID for the Ethereum mainnet (EIP-155 compatible format).
- */
-const ETH_MAINNET_CHAIN_ID = 'eip155:1';
-/**
- * @constant {string} ZKEVM_DEVNET_CHAIN_ID - The chain ID for the zkEVM devnet (EIP-155 compatible format).
- */
-const ZKEVM_DEVNET_CHAIN_ID = 'eip155:13423';
-/**
-/**
- * @constant {string} ZKEVM_TESTNET_CHAIN_ID - The chain ID for the zkEVM testnet (EIP-155 compatible format).
- */
-const ZKEVM_TESTNET_CHAIN_ID = 'eip155:13372';
-/**
- * @constant {string} ZKEVM_MAINNET_CHAIN_ID - The chain ID for the zkEVM mainnet (EIP-155 compatible format).
- */
-const ZKEVM_MAINNET_CHAIN_ID = 'eip155:13371';
-/**
- * @constant {BridgeInstance} ETH_SEPOLIA_TO_ZKEVM_DEVNET - A bridge instance configuration for bridging between the Ethereum Sepolia testnet and the zkEVM devnet.
- */
-const ETH_SEPOLIA_TO_ZKEVM_DEVNET = {
-    rootChainID: ETH_SEPOLIA_CHAIN_ID,
-    childChainID: ZKEVM_DEVNET_CHAIN_ID,
-};
-/**
- * @constant {BridgeInstance} ETH_SEPOLIA_TO_ZKEVM_TESTNET - A bridge instance configuration for bridging between the Ethereum Sepolia testnet and the zkEVM testnet.
- */
-const ETH_SEPOLIA_TO_ZKEVM_TESTNET = {
-    rootChainID: ETH_SEPOLIA_CHAIN_ID,
-    childChainID: ZKEVM_TESTNET_CHAIN_ID,
-};
-/**
- * @constant {BridgeInstance} ETH_MAINNET_TO_ZKEVM_MAINNET - A bridge instance configuration for bridging between the Ethereum mainnet and the zkEVM mainnet.
- */
-const ETH_MAINNET_TO_ZKEVM_MAINNET = {
-    rootChainID: ETH_MAINNET_CHAIN_ID,
-    childChainID: ZKEVM_MAINNET_CHAIN_ID,
-};
+    static validateDepositArgs(depositorOrRecipientAddress, depositAmount, token) {
+        if (!isAddress(depositorOrRecipientAddress)) {
+            throw new BridgeError(`address ${depositorOrRecipientAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+        // The deposit amount cannot be <= 0
+        if (depositAmount.isNegative() || depositAmount.isZero()) {
+            throw new BridgeError(`deposit amount ${depositAmount.toString()} is invalid`, BridgeErrorType.INVALID_AMOUNT);
+        }
+        // If the token is not native, it must be a valid address
+        if (token !== 'NATIVE' && !isAddress(token)) {
+            throw new BridgeError(`token address ${token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+    }
+    static validateWithdrawArgs(withdrawerOrRecipientAddress, withdrawAmount, token) {
+        // Validate the withdrawer address
+        if (!isAddress(withdrawerOrRecipientAddress)) {
+            throw new BridgeError(`withdrawer address ${withdrawerOrRecipientAddress} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+        // Validate the withdrawal amount. It cannot be zero or negative.
+        if (withdrawAmount.isNegative() || withdrawAmount.isZero()) {
+            throw new BridgeError(`withdraw amount ${withdrawAmount.toString()} is invalid`, BridgeErrorType.INVALID_AMOUNT);
+        }
+        // Check if the ERC20 Token is a valid address
+        if (!isAddress(token)) {
+            throw new BridgeError(`token address ${token} is not a valid address`, BridgeErrorType.INVALID_ADDRESS);
+        }
+    }
+    // Query the rootchain and childchain providers to ensure the chainID is as expected by the SDK.
+    // This is to prevent the SDK from being used on the wrong chain, especially after a chain reset.
+    async validateChainConfiguration() {
+        const errMessage = 'Please upgrade to the latest version of the Bridge SDK or provide valid configuration';
+        const rootNetwork = await withBridgeError(async () => this.config.rootProvider.getNetwork(), BridgeErrorType.PROVIDER_ERROR);
+        if (rootNetwork.chainId.toString() !== this.config.bridgeInstance.rootChainID) {
+            throw new BridgeError(`Rootchain provider chainID ${rootNetwork.chainId} does not match expected chainID ${this.config.bridgeInstance.rootChainID}. ${errMessage}`, BridgeErrorType.UNSUPPORTED_ERROR);
+        }
+        const childNetwork = await this.config.childProvider.getNetwork();
+        if (childNetwork.chainId.toString() !== this.config.bridgeInstance.childChainID) {
+            throw new BridgeError(`Childchain provider chainID ${childNetwork.chainId} does not match expected chainID ${this.config.bridgeInstance.childChainID}. ${errMessage}`, BridgeErrorType.UNSUPPORTED_ERROR);
+        }
+    }
+}
 
 var Environment;
 (function (Environment) {
@@ -10274,20 +12278,26 @@ const SUPPORTED_BRIDGES_FOR_ENVIRONMENT = {
  */
 const CONTRACTS_FOR_BRIDGE = new Map()
     .set(ETH_SEPOLIA_TO_ZKEVM_DEVNET, {
-    rootChainERC20Predicate: '0xf0b3435411A74F1aeCBD0fd6D53a90D5227fEeba',
-    rootChainStateSender: '0x868097dbAcfD431F441d09D0e4D3B5eD3182E597',
+    rootChainERC20Predicate: '0xAC0f2096732D40096B3356AD76ba60a2f02366c8',
+    rootChainStateSender: '0xeA76fcCdD791A9c231CAda787ae7535c8a5E55B5',
+    rootChainCheckpointManager: '0x321A466aa78F5957C6E2375114915EcD14DAdE44',
+    rootChainExitHelper: '0x55cA8C418bbB0aC87414F9ea6FFC6a33860Cf967',
     childChainERC20Predicate: '0x0000000000000000000000000000000000001004',
     childChainStateReceiver: '0x0000000000000000000000000000000000001001',
 })
     .set(ETH_SEPOLIA_TO_ZKEVM_TESTNET, {
     rootChainERC20Predicate: '0x0C15a8359865867CdCC44f98b2F3fd5DF098C7E0',
     rootChainStateSender: '0x4C80001188db53dbc2eaAb32d5ef825feEedECA5',
+    rootChainCheckpointManager: '0x0F3157bc91f66C350f87172bBB28d9417167074F',
+    rootChainExitHelper: '0xB057A6C4e951a315E9f2DAe6d28B83cD0480e873',
     childChainERC20Predicate: '0x0000000000000000000000000000000000001004',
     childChainStateReceiver: '0x0000000000000000000000000000000000001001',
 })
     .set(ETH_MAINNET_TO_ZKEVM_MAINNET, {
     rootChainERC20Predicate: '0x',
     rootChainStateSender: '0x',
+    rootChainCheckpointManager: '0x',
+    rootChainExitHelper: '0x',
     childChainERC20Predicate: '0x',
     childChainStateReceiver: '0x',
 });
@@ -10477,7 +12487,7 @@ const calculateGasFee = (gasPriceInWei, gasUsed) => gasUsed.mul(gasPriceInWei);
 /* Autogenerated file. Do not edit manually. */
 /* tslint:disable */
 /* eslint-disable */
-const _abi$2 = [
+const _abi$3 = [
     {
         constant: true,
         inputs: [],
@@ -10700,12 +12710,12 @@ const _abi$2 = [
     },
 ];
 class ERC20__factory {
-    static abi = _abi$2;
+    static abi = _abi$3;
     static createInterface() {
-        return new utils.Interface(_abi$2);
+        return new utils.Interface(_abi$3);
     }
     static connect(address, signerOrProvider) {
-        return new Contract$1(address, _abi$2, signerOrProvider);
+        return new Contract$1(address, _abi$3, signerOrProvider);
     }
 }
 
@@ -10896,6 +12906,8 @@ const DEFAULT_MAX_HOPS = 2;
 const MAX_MAX_HOPS = 10;
 // a max hop of 1 will require a direct swap with no intermediary pools
 const MIN_MAX_HOPS = 1;
+// 10% maximum secondary fee
+const MAX_SECONDARY_FEE_BASIS_POINTS = 10000;
 
 const quoteReturnMapping = {
     // eslint-disable-next-line @typescript-eslint/naming-convention
@@ -10952,37 +12964,377 @@ const tokenInfoToUniswapToken = (tokenInfo) => new Token(tokenInfo.chainId, toke
 /* Autogenerated file. Do not edit manually. */
 /* tslint:disable */
 /* eslint-disable */
-const _abi$1 = [
+const _abi$2 = [
     {
         inputs: [],
         name: "getCurrentBlockTimestamp",
         outputs: [
             {
                 internalType: "uint256",
-                name: "timestamp",
+                name: "timestamp",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "addr",
+                type: "address",
+            },
+        ],
+        name: "getEthBalance",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "balance",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "target",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "gasLimit",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "callData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct UniswapInterfaceMulticall.Call[]",
+                name: "calls",
+                type: "tuple[]",
+            },
+        ],
+        name: "multicall",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "blockNumber",
+                type: "uint256",
+            },
+            {
+                components: [
+                    {
+                        internalType: "bool",
+                        name: "success",
+                        type: "bool",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "gasUsed",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "bytes",
+                        name: "returnData",
+                        type: "bytes",
+                    },
+                ],
+                internalType: "struct UniswapInterfaceMulticall.Result[]",
+                name: "returnData",
+                type: "tuple[]",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+];
+const _bytecode$2 = "0x608060405234801561001057600080fd5b50610567806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80630f28c97d146100465780631749e1e3146100645780634d2301cc14610085575b600080fd5b61004e610098565b60405161005b919061041f565b60405180910390f35b6100776100723660046102a7565b61009c565b60405161005b929190610428565b61004e610093366004610286565b610220565b4290565b8051439060609067ffffffffffffffff811180156100b957600080fd5b506040519080825280602002602001820160405280156100f357816020015b6100e061023a565b8152602001906001900390816100d85790505b50905060005b835181101561021a57600080600086848151811061011357fe5b60200260200101516000015187858151811061012b57fe5b60200260200101516020015188868151811061014357fe5b60200260200101516040015192509250925060005a90506000808573ffffffffffffffffffffffffffffffffffffffff1685856040516101839190610403565b60006040518083038160008787f1925050503d80600081146101c1576040519150601f19603f3d011682016040523d82523d6000602084013e6101c6565b606091505b509150915060005a8403905060405180606001604052808415158152602001828152602001838152508989815181106101fb57fe5b60200260200101819052505050505050505080806001019150506100f9565b50915091565b73ffffffffffffffffffffffffffffffffffffffff163190565b604051806060016040528060001515815260200160008152602001606081525090565b803573ffffffffffffffffffffffffffffffffffffffff8116811461028157600080fd5b919050565b600060208284031215610297578081fd5b6102a08261025d565b9392505050565b600060208083850312156102b9578182fd5b823567ffffffffffffffff808211156102d0578384fd5b818501915085601f8301126102e3578384fd5b8135818111156102ef57fe5b6102fc8485830201610506565b81815284810190848601875b848110156103f457813587017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0606081838f03011215610346578a8bfd5b60408051606081018181108b8211171561035c57fe5b8252610369848d0161025d565b8152818401358c82015260608401358a811115610384578d8efd5b8085019450508e603f850112610398578c8dfd5b8b8401358a8111156103a657fe5b6103b68d85601f84011601610506565b93508084528f838287010111156103cb578d8efd5b808386018e86013783018c018d9052908101919091528552509287019290870190600101610308565b50909998505050505050505050565b6000825161041581846020870161052a565b9190910192915050565b90815260200190565b600060408083018584526020828186015281865180845260609350838701915083838202880101838901875b838110156104f6578983037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa001855281518051151584528681015187850152880151888401889052805188850181905260806104b582828801858c0161052a565b96880196601f919091017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01694909401909301925090850190600101610454565b50909a9950505050505050505050565b60405181810167ffffffffffffffff8111828210171561052257fe5b604052919050565b60005b8381101561054557818101518382015260200161052d565b83811115610554576000848401525b5050505056fea164736f6c6343000706000a";
+const isSuperArgs$2 = (xs) => xs.length > 1;
+class Multicall__factory extends ContractFactory {
+    constructor(...args) {
+        if (isSuperArgs$2(args)) {
+            super(...args);
+        }
+        else {
+            super(_abi$2, _bytecode$2, args[0]);
+        }
+    }
+    deploy(overrides) {
+        return super.deploy(overrides || {});
+    }
+    getDeployTransaction(overrides) {
+        return super.getDeployTransaction(overrides || {});
+    }
+    attach(address) {
+        return super.attach(address);
+    }
+    connect(signer) {
+        return super.connect(signer);
+    }
+    static bytecode = _bytecode$2;
+    static abi = _abi$2;
+    static createInterface() {
+        return new utils.Interface(_abi$2);
+    }
+    static connect(address, signerOrProvider) {
+        return new Contract$1(address, _abi$2, signerOrProvider);
+    }
+}
+
+/* Autogenerated file. Do not edit manually. */
+/* tslint:disable */
+/* eslint-disable */
+const _abi$1 = [
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "_uniRouter",
+                type: "address",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "constructor",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "feeToken",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "feePayer",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "feeRecipient",
+                type: "address",
+            },
+            {
+                indexed: false,
+                internalType: "uint256",
+                name: "feeAmount",
+                type: "uint256",
+            },
+        ],
+        name: "FeeTaken",
+        type: "event",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: true,
+                internalType: "address",
+                name: "previousOwner",
+                type: "address",
+            },
+            {
+                indexed: true,
+                internalType: "address",
+                name: "newOwner",
+                type: "address",
+            },
+        ],
+        name: "OwnershipTransferred",
+        type: "event",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: "address",
+                name: "account",
+                type: "address",
+            },
+        ],
+        name: "Paused",
+        type: "event",
+    },
+    {
+        anonymous: false,
+        inputs: [
+            {
+                indexed: false,
+                internalType: "address",
+                name: "account",
+                type: "address",
+            },
+        ],
+        name: "Unpaused",
+        type: "event",
+    },
+    {
+        inputs: [],
+        name: "BASIS_POINT_PRECISION",
+        outputs: [
+            {
+                internalType: "uint16",
+                name: "",
+                type: "uint16",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "MAX_SERVICE_FEE",
+        outputs: [
+            {
+                internalType: "uint16",
+                name: "",
+                type: "uint16",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint16",
+                        name: "feePrcntBasisPoints",
+                        type: "uint16",
+                    },
+                ],
+                internalType: "struct ISecondaryFee.ServiceFeeParams[]",
+                name: "serviceFee",
+                type: "tuple[]",
+            },
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "tokenIn",
+                        type: "address",
+                    },
+                    {
+                        internalType: "address",
+                        name: "tokenOut",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint24",
+                        name: "fee",
+                        type: "uint24",
+                    },
+                    {
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountIn",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountOutMinimum",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "uint160",
+                        name: "sqrtPriceLimitX96",
+                        type: "uint160",
+                    },
+                ],
+                internalType: "struct IV3SwapRouter.ExactInputSingleParams",
+                name: "params",
+                type: "tuple",
+            },
+        ],
+        name: "exactInputSingleWithServiceFee",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "amountOut",
                 type: "uint256",
             },
         ],
-        stateMutability: "view",
+        stateMutability: "payable",
         type: "function",
     },
     {
         inputs: [
             {
-                internalType: "address",
-                name: "addr",
-                type: "address",
+                components: [
+                    {
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint16",
+                        name: "feePrcntBasisPoints",
+                        type: "uint16",
+                    },
+                ],
+                internalType: "struct ISecondaryFee.ServiceFeeParams[]",
+                name: "serviceFee",
+                type: "tuple[]",
+            },
+            {
+                components: [
+                    {
+                        internalType: "bytes",
+                        name: "path",
+                        type: "bytes",
+                    },
+                    {
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountIn",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountOutMinimum",
+                        type: "uint256",
+                    },
+                ],
+                internalType: "struct IV3SwapRouter.ExactInputParams",
+                name: "params",
+                type: "tuple",
             },
         ],
-        name: "getEthBalance",
+        name: "exactInputWithServiceFee",
         outputs: [
             {
                 internalType: "uint256",
-                name: "balance",
+                name: "amountOut",
                 type: "uint256",
             },
         ],
-        stateMutability: "view",
+        stateMutability: "payable",
         type: "function",
     },
     {
@@ -10991,62 +13343,251 @@ const _abi$1 = [
                 components: [
                     {
                         internalType: "address",
-                        name: "target",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint16",
+                        name: "feePrcntBasisPoints",
+                        type: "uint16",
+                    },
+                ],
+                internalType: "struct ISecondaryFee.ServiceFeeParams[]",
+                name: "serviceFee",
+                type: "tuple[]",
+            },
+            {
+                components: [
+                    {
+                        internalType: "address",
+                        name: "tokenIn",
+                        type: "address",
+                    },
+                    {
+                        internalType: "address",
+                        name: "tokenOut",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint24",
+                        name: "fee",
+                        type: "uint24",
+                    },
+                    {
+                        internalType: "address",
+                        name: "recipient",
                         type: "address",
                     },
                     {
                         internalType: "uint256",
-                        name: "gasLimit",
+                        name: "amountOut",
                         type: "uint256",
                     },
                     {
-                        internalType: "bytes",
-                        name: "callData",
-                        type: "bytes",
+                        internalType: "uint256",
+                        name: "amountInMaximum",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "uint160",
+                        name: "sqrtPriceLimitX96",
+                        type: "uint160",
                     },
                 ],
-                internalType: "struct UniswapInterfaceMulticall.Call[]",
-                name: "calls",
-                type: "tuple[]",
+                internalType: "struct IV3SwapRouter.ExactOutputSingleParams",
+                name: "params",
+                type: "tuple",
             },
         ],
-        name: "multicall",
+        name: "exactOutputSingleWithServiceFee",
         outputs: [
             {
                 internalType: "uint256",
-                name: "blockNumber",
+                name: "amountIn",
                 type: "uint256",
             },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+    {
+        inputs: [
             {
                 components: [
                     {
-                        internalType: "bool",
-                        name: "success",
-                        type: "bool",
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
                     },
                     {
-                        internalType: "uint256",
-                        name: "gasUsed",
-                        type: "uint256",
+                        internalType: "uint16",
+                        name: "feePrcntBasisPoints",
+                        type: "uint16",
                     },
+                ],
+                internalType: "struct ISecondaryFee.ServiceFeeParams[]",
+                name: "serviceFee",
+                type: "tuple[]",
+            },
+            {
+                components: [
                     {
                         internalType: "bytes",
-                        name: "returnData",
+                        name: "path",
                         type: "bytes",
                     },
+                    {
+                        internalType: "address",
+                        name: "recipient",
+                        type: "address",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountOut",
+                        type: "uint256",
+                    },
+                    {
+                        internalType: "uint256",
+                        name: "amountInMaximum",
+                        type: "uint256",
+                    },
                 ],
-                internalType: "struct UniswapInterfaceMulticall.Result[]",
-                name: "returnData",
-                type: "tuple[]",
+                internalType: "struct IV3SwapRouter.ExactOutputParams",
+                name: "params",
+                type: "tuple",
+            },
+        ],
+        name: "exactOutputWithServiceFee",
+        outputs: [
+            {
+                internalType: "uint256",
+                name: "amountIn",
+                type: "uint256",
+            },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "uint256",
+                name: "deadline",
+                type: "uint256",
+            },
+            {
+                internalType: "bytes[]",
+                name: "data",
+                type: "bytes[]",
+            },
+        ],
+        name: "multicall",
+        outputs: [
+            {
+                internalType: "bytes[]",
+                name: "",
+                type: "bytes[]",
+            },
+        ],
+        stateMutability: "payable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "bytes[]",
+                name: "data",
+                type: "bytes[]",
+            },
+        ],
+        name: "multicall",
+        outputs: [
+            {
+                internalType: "bytes[]",
+                name: "results",
+                type: "bytes[]",
+            },
+        ],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "owner",
+        outputs: [
+            {
+                internalType: "address",
+                name: "",
+                type: "address",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "pause",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "paused",
+        outputs: [
+            {
+                internalType: "bool",
+                name: "",
+                type: "bool",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "renounceOwnership",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [
+            {
+                internalType: "address",
+                name: "newOwner",
+                type: "address",
+            },
+        ],
+        name: "transferOwnership",
+        outputs: [],
+        stateMutability: "nonpayable",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "uniswapRouter",
+        outputs: [
+            {
+                internalType: "contract IV3SwapRouter",
+                name: "",
+                type: "address",
             },
         ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+        inputs: [],
+        name: "unpause",
+        outputs: [],
         stateMutability: "nonpayable",
         type: "function",
     },
 ];
-const _bytecode$1 = "0x608060405234801561001057600080fd5b50610567806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80630f28c97d146100465780631749e1e3146100645780634d2301cc14610085575b600080fd5b61004e610098565b60405161005b919061041f565b60405180910390f35b6100776100723660046102a7565b61009c565b60405161005b929190610428565b61004e610093366004610286565b610220565b4290565b8051439060609067ffffffffffffffff811180156100b957600080fd5b506040519080825280602002602001820160405280156100f357816020015b6100e061023a565b8152602001906001900390816100d85790505b50905060005b835181101561021a57600080600086848151811061011357fe5b60200260200101516000015187858151811061012b57fe5b60200260200101516020015188868151811061014357fe5b60200260200101516040015192509250925060005a90506000808573ffffffffffffffffffffffffffffffffffffffff1685856040516101839190610403565b60006040518083038160008787f1925050503d80600081146101c1576040519150601f19603f3d011682016040523d82523d6000602084013e6101c6565b606091505b509150915060005a8403905060405180606001604052808415158152602001828152602001838152508989815181106101fb57fe5b60200260200101819052505050505050505080806001019150506100f9565b50915091565b73ffffffffffffffffffffffffffffffffffffffff163190565b604051806060016040528060001515815260200160008152602001606081525090565b803573ffffffffffffffffffffffffffffffffffffffff8116811461028157600080fd5b919050565b600060208284031215610297578081fd5b6102a08261025d565b9392505050565b600060208083850312156102b9578182fd5b823567ffffffffffffffff808211156102d0578384fd5b818501915085601f8301126102e3578384fd5b8135818111156102ef57fe5b6102fc8485830201610506565b81815284810190848601875b848110156103f457813587017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0606081838f03011215610346578a8bfd5b60408051606081018181108b8211171561035c57fe5b8252610369848d0161025d565b8152818401358c82015260608401358a811115610384578d8efd5b8085019450508e603f850112610398578c8dfd5b8b8401358a8111156103a657fe5b6103b68d85601f84011601610506565b93508084528f838287010111156103cb578d8efd5b808386018e86013783018c018d9052908101919091528552509287019290870190600101610308565b50909998505050505050505050565b6000825161041581846020870161052a565b9190910192915050565b90815260200190565b600060408083018584526020828186015281865180845260609350838701915083838202880101838901875b838110156104f6578983037fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa001855281518051151584528681015187850152880151888401889052805188850181905260806104b582828801858c0161052a565b96880196601f919091017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01694909401909301925090850190600101610454565b50909a9950505050505050505050565b60405181810167ffffffffffffffff8111828210171561052257fe5b604052919050565b60005b8381101561054557818101518382015260200161052d565b83811115610554576000848401525b5050505056fea164736f6c6343000706000a";
+const _bytecode$1 = "0x60806040523480156200001157600080fd5b5060405162002123380380620021238339810160408190526200003491620000c2565b6200003f3362000072565b6000805460ff60a01b19169055600180546001600160a01b0319166001600160a01b0392909216919091179055620000f4565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b600060208284031215620000d557600080fd5b81516001600160a01b0381168114620000ed57600080fd5b9392505050565b61201f80620001046000396000f3fe6080604052600436106100e85760003560e01c8063735de9f71161008a578063ac9650d811610059578063ac9650d814610243578063d9a6f70514610263578063ed921d3c14610279578063f2fde38b1461028c57600080fd5b8063735de9f7146101c5578063742ac944146101fd5780638456cb59146102105780638da5cb5b1461022557600080fd5b80633f4ba83a116100c65780633f4ba83a1461014f5780635ae401dc146101665780635c975abb14610186578063715018a6146101b057600080fd5b80631411734e146100ed57806314d90e1b146101135780631fd168ff1461013c575b600080fd5b6101006100fb366004611a14565b6102ac565b6040519081526020015b60405180910390f35b34801561011f57600080fd5b506101296103e881565b60405161ffff909116815260200161010a565b61010061014a366004611a14565b61040a565b34801561015b57600080fd5b5061016461057a565b005b610179610174366004611ac0565b61058c565b60405161010a9190611b5b565b34801561019257600080fd5b50600054600160a01b900460ff16604051901515815260200161010a565b3480156101bc57600080fd5b506101646105e2565b3480156101d157600080fd5b506001546101e5906001600160a01b031681565b6040516001600160a01b03909116815260200161010a565b61010061020b366004611c50565b6105f4565b34801561021c57600080fd5b50610164610731565b34801561023157600080fd5b506000546001600160a01b03166101e5565b34801561024f57600080fd5b5061017961025e366004611ca5565b610741565b34801561026f57600080fd5b5061012961271081565b610100610287366004611c50565b610836565b34801561029857600080fd5b506101646102a7366004611ce6565b61095e565b60208101516000906001600160a01b031633148015906102d9575060208201516001600160a01b03163014155b156102ff5760405162461bcd60e51b81526004016102f690611d03565b60405180910390fd5b600061030e83600001516109d7565b905060008061037983866040015187602001518a8a808060200260200160405190810160405280939291908181526020016000905b8282101561036f5761036060408302860136819003810190611d50565b81526020019060010190610343565b50505050506109e3565b60408088018390526001600160a01b0380831660208a0152600154915163b858183f60e01b8152939550919350169063b858183f906103bc908890600401611dfc565b6020604051808303816000875af11580156103db573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103ff9190611e0f565b979650505050505050565b6040810151815160009190829061042090610ac4565b9050600061043185600001516109d7565b90506000806000806104a4868a606001518b604001518c602001518f8f808060200260200160405190810160405280939291908181526020016000905b8282101561049a5761048b60408302860136819003810190611d50565b8152602001906001019061046e565b5050505050610af2565b9350935093509350838960400181815250508289602001906001600160a01b031690816001600160a01b031681525050600160009054906101000a90046001600160a01b03166001600160a01b03166309b813468a6040518263ffffffff1660e01b81526004016105159190611dfc565b6020604051808303816000875af1158015610534573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906105589190611e0f565b975061056c8787878c604001518587610bd3565b505050505050509392505050565b610582610e16565b61058a610e70565b565b6060834211156105d05760405162461bcd60e51b815260206004820152600f60248201526e111958591b1a5b99481c185cdcd959608a1b60448201526064016102f6565b6105da8383610741565b949350505050565b6105ea610e16565b61058a6000610ec5565b60608101516000906001600160a01b03163314801590610621575060608201516001600160a01b03163014155b1561063e5760405162461bcd60e51b81526004016102f690611d03565b6000806106a18460000151856080015186606001518989808060200260200160405190810160405280939291908181526020016000905b8282101561036f5761069260408302860136819003810190611d50565b81526020019060010190610675565b608086018290526001600160a01b0380821660608801526001546040516304e45aaf60e01b815293955091935016906304e45aaf906106e4908790600401611e28565b6020604051808303816000875af1158015610703573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906107279190611e0f565b9695505050505050565b610739610e16565b61058a610f15565b6060816001600160401b0381111561075b5761075b61189c565b60405190808252806020026020018201604052801561078e57816020015b60608152602001906001900390816107795790505b50905060005b8281101561082e576107fe308585848181106107b2576107b2611e87565b90506020028101906107c49190611e9d565b8080601f016020809104026020016040519081016040528093929190818152602001838380828437600092019190915250610f5892505050565b82828151811061081057610810611e87565b6020026020010181905250808061082690611ef9565b915050610794565b505b92915050565b600080826080015190506000806000806108ab87600001518860a0015189608001518a606001518d8d808060200260200160405190810160405280939291908181526020016000905b8282101561049a5761089c60408302860136819003810190611d50565b8152602001906001019061087f565b60808b018490526001600160a01b0380841660608d0152600154604051635023b4df60e01b815295995093975091955093501690635023b4df906108f3908a90600401611e28565b6020604051808303816000875af1158015610912573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906109369190611e0f565b955061095285886000015189602001518a608001518587610bd3565b50505050509392505050565b610966610e16565b6001600160a01b0381166109cb5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b60648201526084016102f6565b6109d481610ec5565b50565b60006108308282610f84565b600080548190600160a01b900460ff16610a2257600080610a048786610fe9565b9092509050610a138288611f12565b9650610a1f88826111c6565b50505b6040516323b872dd60e01b8152336004820152306024820152604481018690526001600160a01b038716906323b872dd906064016020604051808303816000875af1158015610a75573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610a999190611f25565b50610aa48686611341565b306001600160a01b03851603610ab8573393505b50929491935090915050565b60008060148351610ad59190611f12565b90506000610ae584836014611438565b90506105da816000610f84565b6000806060818082610b0e60005460ff600160a01b9091041690565b610b2e57610b1c8988610fe9565b9092509050610b2b828a611f47565b98505b6001600160a01b0388163014610b42573097505b610b4c8b8b611341565b6040516323b872dd60e01b8152336004820152306024820152604481018b90526001600160a01b038c16906323b872dd906064016020604051808303816000875af1158015610b9f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610bc39190611f25565b50979a9699509697505050505050565b600054600160a01b900460ff16610bee57610bee8482611545565b6040516370a0823160e01b81523060048201526000906001600160a01b038616906370a0823190602401602060405180830381865afa158015610c35573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c599190611e0f565b9050610c658385611f12565b811015610cb45760405162461bcd60e51b815260206004820181905260248201527f696e636f72726563742066656520616d6f756e7420646973747269627574656460448201526064016102f6565b60405163a9059cbb60e01b8152336004820152602481018890526001600160a01b0386169063a9059cbb906044016020604051808303816000875af1158015610d01573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d259190611f25565b506040516370a0823160e01b81523060048201526000906001600160a01b038816906370a0823190602401602060405180830381865afa158015610d6d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d919190611e0f565b90508015610e0c5760405163a9059cbb60e01b8152336004820152602481018290526001600160a01b0388169063a9059cbb906044016020604051808303816000875af1158015610de6573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610e0a9190611f25565b505b5050505050505050565b6000546001600160a01b0316331461058a5760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e657260448201526064016102f6565b610e786116b4565b6000805460ff60a01b191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b600080546001600160a01b038381166001600160a01b0319831681178455604051919092169283917f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09190a35050565b610f1d611704565b6000805460ff60a01b1916600160a01b1790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a258610ea83390565b6060610f7d8383604051806060016040528060278152602001611fc360279139611751565b9392505050565b6000610f91826014611f47565b83511015610fd95760405162461bcd60e51b8152602060048201526015602482015274746f416464726573735f6f75744f66426f756e647360581b60448201526064016102f6565b500160200151600160601b900490565b6000606081805b845181101561103a5784818151811061100b5761100b611e87565b60200260200101516020015161ffff16826110269190611f47565b91508061103281611ef9565b915050610ff0565b506103e881111561108d5760405162461bcd60e51b815260206004820152601d60248201527f5365727669636520666565203e204d41585f534552564943455f46454500000060448201526064016102f6565b60008085516001600160401b038111156110a9576110a961189c565b6040519080825280602002602001820160405280156110ee57816020015b60408051808201909152600080825260208201528152602001906001900390816110c75790505b50905060005b86518110156111b757600061271061ffff1688838151811061111857611118611e87565b60200260200101516020015161ffff168a6111339190611f5a565b61113d9190611f71565b9050604051806040016040528089848151811061115c5761115c611e87565b6020026020010151600001516001600160a01b031681526020018281525083838151811061118c5761118c611e87565b60209081029190910101526111a18185611f47565b93505080806111af90611ef9565b9150506110f4565b509093509150505b9250929050565b60005b815181101561133c57826001600160a01b03166323b872dd338484815181106111f4576111f4611e87565b60200260200101516000015185858151811061121257611212611e87565b60209081029190910181015101516040516001600160e01b031960e086901b1681526001600160a01b03938416600482015292909116602483015260448201526064016020604051808303816000875af1158015611274573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906112989190611f25565b508181815181106112ab576112ab611e87565b6020026020010151600001516001600160a01b0316336001600160a01b0316846001600160a01b03167f1f9a9fdac86b6ca3c5300bec0b61555cded1f1a234378602dcca6c27085eac8e85858151811061130757611307611e87565b60200260200101516020015160405161132291815260200190565b60405180910390a48061133481611ef9565b9150506111c9565b505050565b600154604051636eb1769f60e11b81523060048201526001600160a01b039182166024820152829184169063dd62ed3e90604401602060405180830381865afa158015611392573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906113b69190611e0f565b10156114345760015460405163095ea7b360e01b81526001600160a01b03918216600482015260001960248201529083169063095ea7b3906044016020604051808303816000875af1158015611410573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061133c9190611f25565b5050565b60608161144681601f611f47565b10156114855760405162461bcd60e51b815260206004820152600e60248201526d736c6963655f6f766572666c6f7760901b60448201526064016102f6565b61148f8284611f47565b845110156114d35760405162461bcd60e51b8152602060048201526011602482015270736c6963655f6f75744f66426f756e647360781b60448201526064016102f6565b6060821580156114f2576040519150600082526020820160405261153c565b6040519150601f8416801560200281840101858101878315602002848b0101015b8183101561152b578051835260209283019201611513565b5050858452601f01601f1916604052505b50949350505050565b60005b815181101561133c57826001600160a01b031663a9059cbb83838151811061157257611572611e87565b60200260200101516000015184848151811061159057611590611e87565b6020026020010151602001516040518363ffffffff1660e01b81526004016115cd9291906001600160a01b03929092168252602082015260400190565b6020604051808303816000875af11580156115ec573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116109190611f25565b5081818151811061162357611623611e87565b6020026020010151600001516001600160a01b0316336001600160a01b0316846001600160a01b03167f1f9a9fdac86b6ca3c5300bec0b61555cded1f1a234378602dcca6c27085eac8e85858151811061167f5761167f611e87565b60200260200101516020015160405161169a91815260200190565b60405180910390a4806116ac81611ef9565b915050611548565b600054600160a01b900460ff1661058a5760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b60448201526064016102f6565b600054600160a01b900460ff161561058a5760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b60448201526064016102f6565b6060600080856001600160a01b03168560405161176e9190611f93565b600060405180830381855af49150503d80600081146117a9576040519150601f19603f3d011682016040523d82523d6000602084013e6117ae565b606091505b50915091506107278683838760608315611829578251600003611822576001600160a01b0385163b6118225760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e747261637400000060448201526064016102f6565b50816105da565b6105da838381511561183e5781518083602001fd5b8060405162461bcd60e51b81526004016102f69190611faf565b60008083601f84011261186a57600080fd5b5081356001600160401b0381111561188157600080fd5b6020830191508360208260061b85010111156111bf57600080fd5b634e487b7160e01b600052604160045260246000fd5b604051608081016001600160401b03811182821017156118d4576118d461189c565b60405290565b60405160e081016001600160401b03811182821017156118d4576118d461189c565b604051601f8201601f191681016001600160401b03811182821017156119245761192461189c565b604052919050565b6001600160a01b03811681146109d457600080fd5b803561194c8161192c565b919050565b60006080828403121561196357600080fd5b61196b6118b2565b905081356001600160401b038082111561198457600080fd5b818401915084601f83011261199857600080fd5b81356020828211156119ac576119ac61189c565b6119be601f8301601f191682016118fc565b925081835286818386010111156119d457600080fd5b818185018285013760008183850101528285526119f2818701611941565b8186015250505050604082013560408201526060820135606082015292915050565b600080600060408486031215611a2957600080fd5b83356001600160401b0380821115611a4057600080fd5b611a4c87838801611858565b90955093506020860135915080821115611a6557600080fd5b50611a7286828701611951565b9150509250925092565b60008083601f840112611a8e57600080fd5b5081356001600160401b03811115611aa557600080fd5b6020830191508360208260051b85010111156111bf57600080fd5b600080600060408486031215611ad557600080fd5b8335925060208401356001600160401b03811115611af257600080fd5b611afe86828701611a7c565b9497909650939450505050565b60005b83811015611b26578181015183820152602001611b0e565b50506000910152565b60008151808452611b47816020860160208601611b0b565b601f01601f19169290920160200192915050565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b82811015611bb057603f19888603018452611b9e858351611b2f565b94509285019290850190600101611b82565b5092979650505050505050565b600060e08284031215611bcf57600080fd5b611bd76118da565b90508135611be48161192c565b81526020820135611bf48161192c565b6020820152604082013562ffffff81168114611c0f57600080fd5b6040820152611c2060608301611941565b60608201526080820135608082015260a082013560a0820152611c4560c08301611941565b60c082015292915050565b60008060006101008486031215611c6657600080fd5b83356001600160401b03811115611c7c57600080fd5b611c8886828701611858565b9094509250611c9c90508560208601611bbd565b90509250925092565b60008060208385031215611cb857600080fd5b82356001600160401b03811115611cce57600080fd5b611cda85828601611a7c565b90969095509350505050565b600060208284031215611cf857600080fd5b8135610f7d8161192c565b6020808252602d908201527f726563697069656e74206d757374206265206d73672e73656e646572206f722060408201526c1d1a1a5cc818dbdb9d1c9858dd609a1b606082015260800190565b600060408284031215611d6257600080fd5b604051604081018181106001600160401b0382111715611d8457611d8461189c565b6040528235611d928161192c565b8152602083013561ffff81168114611da957600080fd5b60208201529392505050565b6000815160808452611dca6080850182611b2f565b6020848101516001600160a01b0316908601526040808501519086015260609384015193909401929092525090919050565b602081526000610f7d6020830184611db5565b600060208284031215611e2157600080fd5b5051919050565b60e08101610830828480516001600160a01b03908116835260208083015182169084015260408083015162ffffff16908401526060808301518216908401526080808301519084015260a0828101519084015260c09182015116910152565b634e487b7160e01b600052603260045260246000fd5b6000808335601e19843603018112611eb457600080fd5b8301803591506001600160401b03821115611ece57600080fd5b6020019150368190038213156111bf57600080fd5b634e487b7160e01b600052601160045260246000fd5b600060018201611f0b57611f0b611ee3565b5060010190565b8181038181111561083057610830611ee3565b600060208284031215611f3757600080fd5b81518015158114610f7d57600080fd5b8082018082111561083057610830611ee3565b808202811582820484141761083057610830611ee3565b600082611f8e57634e487b7160e01b600052601260045260246000fd5b500490565b60008251611fa5818460208701611b0b565b9190910192915050565b602081526000610f7d6020830184611b2f56fe416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c206661696c6564a26469706673582212203925f97cd63c2e61736a2a442ff1d4bf966f453350e9df354a849229f69092cf64736f6c63430008130033";
 const isSuperArgs$1 = (xs) => xs.length > 1;
-class Multicall__factory extends ContractFactory {
+class SecondaryFee__factory extends ContractFactory {
     constructor(...args) {
         if (isSuperArgs$1(args)) {
             super(...args);
@@ -11055,11 +13596,11 @@ class Multicall__factory extends ContractFactory {
             super(_abi$1, _bytecode$1, args[0]);
         }
     }
-    deploy(overrides) {
-        return super.deploy(overrides || {});
+    deploy(_uniRouter, overrides) {
+        return super.deploy(_uniRouter, overrides || {});
     }
-    getDeployTransaction(overrides) {
-        return super.getDeployTransaction(overrides || {});
+    getDeployTransaction(_uniRouter, overrides) {
+        return super.getDeployTransaction(_uniRouter, overrides || {});
     }
     attach(address) {
         return super.attach(address);
@@ -12455,7 +14996,81 @@ maxHops) => {
     return routes;
 };
 
-function createSwapParameters(trade, fromAddress, slippage, deadline) {
+const zeroNativeCurrencyValue = '0x00';
+const multicallWithDeadlineFunctionSignature = 'multicall(uint256,bytes[])';
+function buildSwapParametersForSinglePoolSwap(fromAddress, trade, route, amountIn, amountOut, secondaryFees, secondaryFeeContract) {
+    const secondaryFeeValues = secondaryFees.map((fee) => ({
+        feePrcntBasisPoints: fee.feeBasisPoints,
+        recipient: fee.feeRecipient,
+    }));
+    if (trade.tradeType === TradeType.EXACT_INPUT) {
+        return secondaryFeeContract.encodeFunctionData('exactInputSingleWithServiceFee', [secondaryFeeValues, {
+                tokenIn: route.tokenPath[0].address,
+                tokenOut: route.tokenPath[1].address,
+                fee: route.pools[0].fee,
+                recipient: fromAddress,
+                amountIn,
+                amountOutMinimum: amountOut,
+                sqrtPriceLimitX96: 0,
+            }]);
+    }
+    return secondaryFeeContract.encodeFunctionData('exactOutputSingleWithServiceFee', [secondaryFeeValues, {
+            tokenIn: route.tokenPath[0].address,
+            tokenOut: route.tokenPath[1].address,
+            fee: route.pools[0].fee,
+            recipient: fromAddress,
+            amountInMaximum: amountIn,
+            amountOut,
+            sqrtPriceLimitX96: 0,
+        }]);
+}
+function buildSwapParametersForMultiPoolSwap(fromAddress, trade, route, amountIn, amountOut, secondaryFees, secondaryFeeContract) {
+    const path = encodeRouteToPath(route, trade.tradeType === TradeType.EXACT_OUTPUT);
+    const secondaryFeeValues = secondaryFees.map((fee) => ({
+        feePrcntBasisPoints: fee.feeBasisPoints,
+        recipient: fee.feeRecipient,
+    }));
+    if (trade.tradeType === TradeType.EXACT_INPUT) {
+        return secondaryFeeContract.encodeFunctionData('exactInputWithServiceFee', [secondaryFeeValues, {
+                path,
+                recipient: fromAddress,
+                amountIn,
+                amountOutMinimum: amountOut,
+            }]);
+    }
+    return secondaryFeeContract.encodeFunctionData('exactOutputWithServiceFee', [secondaryFeeValues, {
+            path,
+            recipient: fromAddress,
+            amountInMaximum: amountIn,
+            amountOut,
+        }]);
+}
+/**
+ * Builds swap parameters
+ * @param fromAddress the msg.sender of the transaction
+ * @param secondaryFeeAddress the secondary fee contract address
+ * @param trade details of the swap, including the route, input/output tokens and amounts
+ * @param options additional swap options
+ * @returns calldata for the swap
+ */
+function buildSwapParameters(fromAddress, trade, options, secondaryFees, secondaryFeeContract) {
+    // @dev we don't support multiple swaps in a single transaction
+    // there will always be only one swap in the trade regardless of the trade type
+    const { route, inputAmount, outputAmount } = trade.swaps[0];
+    const amountIn = toHex$1(trade.maximumAmountIn(options.slippageTolerance, inputAmount).quotient);
+    const amountOut = toHex$1(trade.minimumAmountOut(options.slippageTolerance, outputAmount).quotient);
+    const isSinglePoolSwap = route.pools.length === 1;
+    if (isSinglePoolSwap) {
+        return buildSwapParametersForSinglePoolSwap(fromAddress, trade, route, amountIn, amountOut, secondaryFees, secondaryFeeContract);
+    }
+    return buildSwapParametersForMultiPoolSwap(fromAddress, trade, route, amountIn, amountOut, secondaryFees, secondaryFeeContract);
+}
+function createSwapCallParametersWithFees(trade, fromAddress, swapOptions, secondaryFees) {
+    const secondaryFeeContract = SecondaryFee__factory.createInterface();
+    const swapWithFeesCalldata = buildSwapParameters(fromAddress, trade, swapOptions, secondaryFees, secondaryFeeContract);
+    return secondaryFeeContract.encodeFunctionData(multicallWithDeadlineFunctionSignature, [swapOptions.deadlineOrPreviousBlockhash, [swapWithFeesCalldata]]);
+}
+function createSwapParameters(trade, fromAddress, slippage, deadline, secondaryFees) {
     // Create an unchecked trade to be used in generating swap parameters.
     const uncheckedTrade = Trade.createUncheckedTrade({
         route: trade.route,
@@ -12469,20 +15084,24 @@ function createSwapParameters(trade, fromAddress, slippage, deadline) {
         recipient: fromAddress,
         deadlineOrPreviousBlockhash: deadline,
     };
-    // Generate the parameters.
-    return SwapRouter.swapCallParameters([uncheckedTrade], options);
+    if (secondaryFees.length === 0) {
+        // Generate swap parameters without secondary fee contract details
+        return SwapRouter.swapCallParameters([uncheckedTrade], options).calldata;
+    }
+    return createSwapCallParametersWithFees(uncheckedTrade, fromAddress, options, secondaryFees);
 }
-function getSwap(nativeToken, routeAndQuote, fromAddress, slippage, deadline, peripheryRouterAddress, gasPrice) {
-    const params = createSwapParameters(routeAndQuote.trade, fromAddress, slippage, deadline);
+function getSwap(nativeToken, routeAndQuote, fromAddress, slippage, deadline, peripheryRouterAddress, secondaryFeesAddress, gasPrice, secondaryFees) {
+    const calldata = createSwapParameters(routeAndQuote.trade, fromAddress, slippage, deadline, secondaryFees);
+    // TODO: Add additional gas fee estimates for secondary fees
     const gasFeeEstimate = gasPrice ? {
         token: nativeToken,
         value: calculateGasFee(gasPrice, routeAndQuote.trade.gasEstimate),
     } : null;
     return {
         transaction: {
-            data: params.calldata,
-            to: peripheryRouterAddress,
-            value: params.value,
+            data: calldata,
+            to: secondaryFees.length > 0 ? secondaryFeesAddress : peripheryRouterAddress,
+            value: zeroNativeCurrencyValue,
             from: fromAddress,
         },
         gasFeeEstimate,
@@ -12495,6 +15114,7 @@ const CONTRACTS_FOR_CHAIN_ID = {
         coreFactory: '0x12739A8f1A8035F439092D016DAE19A2874F30d2',
         quoterV2: '0xF674847fBcca5C80315e3AE37043Dce99F6CC529',
         peripheryRouter: '0x0Afe6F5f4DC34461A801420634239FFaD50A2e44',
+        secondaryFee: '0x8dBE1f0900C5e92ad87A54521902a33ba1598C51',
     },
 };
 const SUPPORTED_SANDBOX_CHAINS = {
@@ -12523,29 +15143,36 @@ function validateOverrides(overrides) {
             throw new InvalidConfigurationError(`Invalid exchange contract address for ${key}`);
         }
     });
-    if (!overrides.secondaryFees) {
-        return;
-    }
-    for (const secondaryFee of overrides.secondaryFees) {
+}
+function validateSecondaryFees(secondaryFees) {
+    let totalSecondaryFeeBasisPoints = 0;
+    for (const secondaryFee of secondaryFees) {
         if (!isValidNonZeroAddress(secondaryFee.feeRecipient)) {
             throw new InvalidConfigurationError(`Invalid secondary fee recipient address: ${secondaryFee.feeRecipient}`);
         }
-        if (secondaryFee.feeBasisPoints < 0 || secondaryFee.feeBasisPoints > 10000) {
-            throw new InvalidConfigurationError(`Invalid secondary fee percentage: ${secondaryFee.feeBasisPoints}`);
+        if (secondaryFee.feeBasisPoints < 0 || secondaryFee.feeBasisPoints > MAX_SECONDARY_FEE_BASIS_POINTS) {
+            throw new InvalidConfigurationError(`Invalid secondary fee basis points: ${secondaryFee.feeBasisPoints}`);
         }
+        totalSecondaryFeeBasisPoints += secondaryFee.feeBasisPoints;
+    }
+    if (totalSecondaryFeeBasisPoints > MAX_SECONDARY_FEE_BASIS_POINTS) {
+        throw new InvalidConfigurationError(`Invalid total secondary fee basis points: ${totalSecondaryFeeBasisPoints}`);
     }
 }
 /**
  * {@link ExchangeConfiguration} is used to configure the {@link Exchange} class.
  * @param chainId the ID of the chain to configure. {@link SUPPORTED_CHAIN_IDS_FOR_ENVIRONMENT} contains the supported chains for each environment.
  * @param baseConfig the base {@link ImmutableConfiguration} for the {@link Exchange} class
+ * @param secondaryFees an optional array of {@link SecondaryFee}s to apply to all transactions. Total secondary fees must be less than {@link MAX_SECONDARY_FEE_BASIS_POINTS}.
  */
 class ExchangeConfiguration {
     baseConfig;
     chain;
-    secondaryFees;
-    constructor({ chainId, baseConfig, overrides }) {
+    secondaryFees = [];
+    constructor({ chainId, baseConfig, secondaryFees, overrides, }) {
         this.baseConfig = baseConfig;
+        this.secondaryFees = secondaryFees || [];
+        validateSecondaryFees(this.secondaryFees);
         if (overrides) {
             validateOverrides(overrides);
             this.chain = {
@@ -12555,10 +15182,9 @@ class ExchangeConfiguration {
                 commonRoutingTokens: overrides.commonRoutingTokens,
                 nativeToken: overrides.nativeToken,
             };
-            this.secondaryFees = overrides.secondaryFees ? overrides.secondaryFees : [];
+            this.secondaryFees = secondaryFees || [];
             return;
         }
-        this.secondaryFees = [];
         const chain = SUPPORTED_CHAIN_IDS_FOR_ENVIRONMENT[baseConfig.environment][chainId];
         if (!chain) {
             throw new ChainNotSupportedError(chainId, baseConfig.environment);
@@ -12577,13 +15203,14 @@ class Exchange {
         const config = new ExchangeConfiguration(configuration);
         this.chainId = config.chain.chainId;
         this.nativeToken = config.chain.nativeToken;
-        this.provider = new ethers.providers.JsonRpcProvider(config.chain.rpcUrl);
         this.secondaryFees = config.secondaryFees;
+        this.provider = new ethers.providers.JsonRpcProvider(config.chain.rpcUrl);
         this.router = new Router(this.provider, config.chain.commonRoutingTokens, {
             multicallAddress: config.chain.contracts.multicall,
             factoryAddress: config.chain.contracts.coreFactory,
             quoterAddress: config.chain.contracts.quoterV2,
             peripheryRouterAddress: config.chain.contracts.peripheryRouter,
+            secondaryFeeAddress: config.chain.contracts.secondaryFee,
         });
     }
     static validate(tokenInAddress, tokenOutAddress, maxHops, slippagePercent, fromAddress) {
@@ -12621,7 +15248,7 @@ class Exchange {
         const gasPrice = await fetchGasPrice(this.provider);
         // we always use the tokenIn address because we are always selling the tokenIn
         const approval = await getApproval(this.nativeToken, this.provider, fromAddress, tokenInAddress, ethers.BigNumber.from(amount), this.router.routingContracts.peripheryRouterAddress, gasPrice);
-        const swap = getSwap(this.nativeToken, routeAndQuote, fromAddress, slippagePercent, deadline, this.router.routingContracts.peripheryRouterAddress, gasPrice);
+        const swap = getSwap(this.nativeToken, routeAndQuote, fromAddress, slippagePercent, deadline, this.router.routingContracts.peripheryRouterAddress, this.router.routingContracts.secondaryFeeAddress, gasPrice, this.secondaryFees);
         const quote = getQuote(otherToken, tradeType, routeAndQuote.trade, slippagePercent);
         return {
             approval,
@@ -12661,9 +15288,6 @@ class Exchange {
     async getUnsignedSwapTxFromAmountOut(fromAddress, tokenInAddress, tokenOutAddress, amountOut, slippagePercent = DEFAULT_SLIPPAGE, maxHops = DEFAULT_MAX_HOPS, deadline = DEFAULT_DEADLINE) {
         return await this.getUnsignedSwapTx(fromAddress, tokenInAddress, tokenOutAddress, amountOut, slippagePercent, maxHops, deadline, TradeType.EXACT_OUTPUT);
     }
-    thereAreSecondaryFees() {
-        return this.secondaryFees.length > 0;
-    }
 }
 
 /* eslint-disable class-methods-use-this */