@imtbl/sdk 0.1.9-alpha → 0.1.9-alpha.2

package/dist/checkout_sdk.d.ts

@@ -1,4 +1,6 @@
 /// <reference types="node" />
+import { ExchangeContracts } from 'config';
+
 declare type Bytes = ArrayLike<number>;
 declare type BytesLike = Bytes | string;
 interface Hexable {
@@ -572,6 +574,20 @@ type Address = string;
  */
 type FungibleToken = Address | 'NATIVE';
 
+type TokenInfo$1 = {
+    chainId: number;
+    address: string;
+    decimals: number;
+    symbol?: string;
+    name?: string;
+};
+interface ExchangeOverrides {
+    rpcURL: string;
+    exchangeContracts: ExchangeContracts;
+    commonRoutingTokens: TokenInfo$1[];
+    nativeToken: TokenInfo$1;
+}
+
 /**
  * Enum representing the supported chains with their corresponding IDs.
  */
@@ -651,12 +667,6 @@ interface NetworkInfo {
     nativeCurrency: TokenInfo;
     isSupported: boolean;
 }
-/**
- * Enum representing the list of default supported providers.
- */
-declare enum ConnectionProviders {
-    METAMASK = "metamask"
-}
 interface ConnectParams {
     provider: Web3Provider;
 }
@@ -741,6 +751,10 @@ interface TokenAmountEstimate {
     estimatedAmount?: BigNumber;
     token?: TokenInfo;
 }
+declare const CHECKOUT_API_BASE_URL: {
+    sandbox: string;
+    production: string;
+};
 /**
  * Object mapping the list of supported networks with the corresponding RPC urls.
  */
@@ -885,10 +899,10 @@ type CreateProviderResult = {
 };
 /**
  * Interface representing a wallet filter to be used in {@link GetWalletAllowListParams}.
- * @property {ConnectionProviders} connectionProvider - The connection provider to filter wallets by.
+ * @property {WalletProviderName} connectionProvider - The connection provider to filter wallets by.
  */
 interface WalletFilter {
-    providerName: WalletProviderName;
+    walletProvider: WalletProviderName;
 }
 /**
  * Interface representing the parameters for {@link Checkout.getWalletAllowList}.
@@ -901,13 +915,13 @@ interface GetWalletAllowListParams {
 }
 /**
  * Interface representing information about a wallet used in {@link GetWalletAllowListResult}.
- * @property {ConnectionProviders} connectionProvider - The connection provider for the wallet.
+ * @property {WalletProviderName} connectionProvider - The connection provider for the wallet.
  * @property {string} name - The name of the wallet.
  * @property {string} description - A description of the wallet.
  * @property {string} icon - The URL/data:image of an icon for the wallet.
  */
 interface WalletInfo {
-    providerName: WalletProviderName;
+    walletProvider: WalletProviderName;
     name: string;
     description: string;
     icon: string;
@@ -959,9 +973,42 @@ type ErrorType = {
         [key: string]: string;
     };
 };
+type AllowedNetworkConfig = {
+    chainId: number;
+};
+type GasEstimateBridgeToL2TokenConfig = {
+    gasTokenAddress: string | 'NATIVE';
+    fromAddress: string;
+};
+type GasEstimateSwapTokenConfig = {
+    inAddress: string;
+    outAddress: string;
+};
+type GasEstimateTokenConfig = {
+    [key: string]: {
+        bridgeToL2Addresses?: GasEstimateBridgeToL2TokenConfig;
+        swapAddresses?: GasEstimateSwapTokenConfig;
+    };
+};
+type DexConfig = {
+    overrides?: ExchangeOverrides;
+};
+type RemoteConfiguration = {
+    dex: DexConfig;
+    allowedNetworks: AllowedNetworkConfig[];
+    gasEstimateTokens?: GasEstimateTokenConfig;
+};
+type RemoteConfigParams = {
+    environment: Environment;
+};
+declare class RemoteConfigFetcher {
+    constructor(params: RemoteConfigParams);
+    get(key?: keyof RemoteConfiguration): Promise<RemoteConfiguration | RemoteConfiguration[keyof RemoteConfiguration] | undefined>;
+}
 declare class CheckoutConfiguration {
     readonly environment: Environment;
     readonly networkMap: NetworkMap;
+    readonly remoteConfigFetcher: RemoteConfigFetcher;
     constructor(config: CheckoutModuleConfiguration);
 }
 declare class Checkout {
@@ -1059,4 +1106,4 @@ declare class Checkout {
     gasEstimate(params: GasEstimateParams): Promise<GasEstimateSwapResult | GasEstimateBridgeToL2Result>;
 }
 
-export { ChainId, CheckConnectionParams, CheckConnectionResult, Checkout, CheckoutErrorType, CheckoutModuleConfiguration, ConnectParams, ConnectResult, ConnectionProviders, ErrorType, GasEstimateBridgeToL2Result, GasEstimateParams, GasEstimateSwapResult, GasEstimateType, GetAllBalancesParams, GetAllBalancesResult, GetBalanceParams, GetBalanceResult, GetNetworkAllowListParams, GetNetworkAllowListResult, GetNetworkParams, GetTokenAllowListParams, GetTokenAllowListResult, GetWalletAllowListParams, GetWalletAllowListResult, NetworkFilter, NetworkFilterTypes, NetworkInfo, RPC_URL_MAP, SendTransactionParams, SendTransactionResult, SwitchNetworkParams, SwitchNetworkResult, TokenFilter, TokenFilterTypes, TokenInfo, WalletFilter, WalletFilterTypes, WalletInfo, WalletProviderName };
+export { CHECKOUT_API_BASE_URL, ChainId, CheckConnectionParams, CheckConnectionResult, Checkout, CheckoutErrorType, CheckoutModuleConfiguration, ConnectParams, ConnectResult, ErrorType, GasEstimateBridgeToL2Result, GasEstimateParams, GasEstimateSwapResult, GasEstimateType, GetAllBalancesParams, GetAllBalancesResult, GetBalanceParams, GetBalanceResult, GetNetworkAllowListParams, GetNetworkAllowListResult, GetNetworkParams, GetTokenAllowListParams, GetTokenAllowListResult, GetWalletAllowListParams, GetWalletAllowListResult, NetworkFilter, NetworkFilterTypes, NetworkInfo, RPC_URL_MAP, SendTransactionParams, SendTransactionResult, SwitchNetworkParams, SwitchNetworkResult, TokenFilter, TokenFilterTypes, TokenInfo, WalletFilter, WalletFilterTypes, WalletInfo, WalletProviderName };

package/dist/checkout_sdk.js

@@ -4,6 +4,7 @@ import $7v2Z6$metamaskdetectprovider from '@metamask/detect-provider';
 import { BigNumber, utils as utils$1 } from 'ethers/lib/ethers';
 import { BridgeConfiguration, ETH_MAINNET_TO_ZKEVM_MAINNET, ETH_SEPOLIA_TO_ZKEVM_DEVNET, TokenBridge } from '@imtbl/bridge-sdk';
 import { Exchange, ExchangeConfiguration } from '@imtbl/dex-sdk';
+import $7v2Z6$axios from 'axios';
 
 var Environment;
 (function (Environment) {
@@ -103,10 +104,6 @@ const $bc2bfebf768286d3$export$6a2ba3c3bd042990 = {
 };
 
 
-var $d176a05e966364ba$export$3bfad4d03ada24c4;
-(function(ConnectionProviders) {
-    ConnectionProviders["METAMASK"] = "metamask";
-})($d176a05e966364ba$export$3bfad4d03ada24c4 || ($d176a05e966364ba$export$3bfad4d03ada24c4 = {}));
 
 
 var $de275b98d2b651c3$export$788b1fd17f3dad84;
@@ -117,10 +114,23 @@ var $de275b98d2b651c3$export$788b1fd17f3dad84;
 
 
 
+
+
+
+const $d85ad1457a3f1a83$export$161d4a74df65fc08 = {
+    [(Environment).SANDBOX]: "https://checkout-api.dev.immutable.com",
+    [(Environment).PRODUCTION]: "https://checkout-api.sandbox.immutable.com"
+};
+const $d85ad1457a3f1a83$export$720c0def10d6df2d = {
+    [($baec09ddc3013323$export$c06e1e7429de6283).ETHEREUM]: "/v1/rpc/eth-mainnet",
+    [($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA]: "/v1/rpc/eth-sepolia"
+};
+
+
 const $a47e48dd2c04791b$export$345c852d0dc8f1df = new Map([
     [
         ($baec09ddc3013323$export$c06e1e7429de6283).ETHEREUM,
-        "https://checkout-api.dev.immutable.com/v1/rpc/eth-mainnet"
+        `${($d85ad1457a3f1a83$export$161d4a74df65fc08)[(Environment).PRODUCTION]}${($d85ad1457a3f1a83$export$720c0def10d6df2d)[($baec09ddc3013323$export$c06e1e7429de6283).ETHEREUM]}`
     ],
     [
         ($baec09ddc3013323$export$c06e1e7429de6283).IMTBL_ZKEVM_TESTNET,
@@ -128,7 +138,7 @@ const $a47e48dd2c04791b$export$345c852d0dc8f1df = new Map([
     ],
     [
         ($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA,
-        "https://checkout-api.dev.immutable.com/v1/rpc/eth-sepolia"
+        `${($d85ad1457a3f1a83$export$161d4a74df65fc08)[(Environment).PRODUCTION]}${($d85ad1457a3f1a83$export$720c0def10d6df2d)[($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA]}`
     ],
     [
         ($baec09ddc3013323$export$c06e1e7429de6283).IMTBL_ZKEVM_DEVNET,
@@ -260,6 +270,7 @@ const $e768639828688ca3$export$44dde05038008549 = {
 
 
 
+
 /**
  * The different types of errors that can be returned by the checkout process.
  */ var $a8bc256d81a5e2c1$export$e3dc0620abde7f5a;
@@ -319,10 +330,6 @@ const $a8bc256d81a5e2c1$export$bacc563de539c6c3 = async (fn, customError)=>{
 /* eslint-disable @typescript-eslint/no-explicit-any */ 
 
 
-var $497c134ecbc8a50f$exports = {};
-$497c134ecbc8a50f$exports = JSON.parse('[{"chainId":1},{"chainId":11155111},{"chainId":13372},{"chainId":13383}]');
-
-
 // this function needs to be in a separate file to prevent circular dependencies with ./network
 
 
@@ -372,7 +379,8 @@ async function $de192de6ef100f9f$var$addNetworkToWallet(networkMap, web3Provider
 }
 async function $de192de6ef100f9f$export$3043f6442a9ef563(config, { type: type = ($a47e48dd2c04791b$export$1f05a55fe0680cc7).ALL , exclude: exclude  }) {
     const { networkMap: networkMap  } = config;
-    const list = ((/*@__PURE__*/$parcel$interopDefault($497c134ecbc8a50f$exports))).filter((network)=>{
+    const allowedNetworkConfig = await config.remoteConfigFetcher.get("allowedNetworks");
+    const list = allowedNetworkConfig.filter((network)=>{
         const allowAllTokens = type === ($a47e48dd2c04791b$export$1f05a55fe0680cc7).ALL;
         const networkNotExcluded = !(exclude || []).map((exc)=>exc.chainId).includes(network.chainId);
         return allowAllTokens && networkNotExcluded;
@@ -650,13 +658,13 @@ async function $bb88265fe45a0393$export$9e1fd9cc88c637a0(config, web3Provider, v
 
 
 var $6f3c55a615003cbf$exports = {};
-$6f3c55a615003cbf$exports = JSON.parse('[{"providerName":"metamask","icon":"some-icon-url","name":"MetaMask","description":"complete web3 wallet solution","platform":["desktop"]},{"providerName":"passport","icon":"pp-icon","name":"Passport","description":"Web3 with your email!","platform":["mobile","desktop"]},{"providerName":"gamestop","icon":"gme-icon","name":"GameStop","description":"Never stopping the game!","platform":["mobile"]}]');
+$6f3c55a615003cbf$exports = JSON.parse('[{"walletProvider":"metamask","icon":"some-icon-url","name":"MetaMask","description":"complete web3 wallet solution","platform":["desktop"]},{"walletProvider":"passport","icon":"pp-icon","name":"Passport","description":"Web3 with your email!","platform":["mobile","desktop"]},{"walletProvider":"gamestop","icon":"gme-icon","name":"GameStop","description":"Never stopping the game!","platform":["mobile"]}]');
 
 
 async function $5cdde2ffe6360fec$export$a822caa90d7eef09({ type: type = ($4f91c5f280efe242$export$a75605c67ea83a5a).ALL , exclude: exclude  }) {
     // todo:For async API call, use the CheckoutError with errorType:API_CALL_ERROR?? or any other
     const filteredWalletsList = ((/*@__PURE__*/$parcel$interopDefault($6f3c55a615003cbf$exports))).filter((wallet)=>{
-        const walletNotExcluded = !exclude?.map((excludeWallet)=>excludeWallet.providerName).includes(wallet.providerName);
+        const walletNotExcluded = !exclude?.map((excludeWallet)=>excludeWallet.walletProvider).includes(wallet.walletProvider);
         const allowAllWallets = type === ($4f91c5f280efe242$export$a75605c67ea83a5a).ALL;
         const walletsAllowedForType = wallet.platform.includes(type);
         return walletNotExcluded && (allowAllWallets || walletsAllowedForType);
@@ -749,53 +757,6 @@ async function $570856c68db0bd36$export$9e73e22953cebcfc(tokenBridge, tokenAddre
 
 
 
-const $be6f32539b5e2cc9$var$chainId = 13383;
-const $be6f32539b5e2cc9$var$commonRoutingTokens = [
-    {
-        chainId: $be6f32539b5e2cc9$var$chainId,
-        address: "0xFEa9FF93DC0C6DC73F8Be009Fe7a22Bb9dcE8A2d",
-        decimals: 18,
-        symbol: "FUN",
-        name: "The Fungibles Token"
-    },
-    {
-        chainId: $be6f32539b5e2cc9$var$chainId,
-        address: "0x12739A8f1A8035F439092D016DAE19A2874F30d2",
-        decimals: 18,
-        symbol: "USDC",
-        name: "US Dollar Coin"
-    },
-    {
-        chainId: $be6f32539b5e2cc9$var$chainId,
-        address: "0x8AC26EfCbf5D700b37A27aA00E6934e6904e7B8e",
-        decimals: 18,
-        symbol: "DEX",
-        name: "Dex"
-    }
-];
-const $be6f32539b5e2cc9$var$contractOverrides = {
-    multicall: "0x7b19942581c9462D54155801fCA4a17edf3fD135",
-    coreFactory: "0xD17c98b38bA28c7eA1080317EB9AB2b9663BEd92",
-    quoterV2: "0x786ec643F231960D4C1A4E336990F8E7bF8f1277",
-    peripheryRouter: "0x0d44bB14Cc1dD999255aBB1576b4964D0439C63D",
-    migrator: "0x0Afe6F5f4DC34461A801420634239FFaD50A2e44",
-    nonfungiblePositionManager: "0xF674847fBcca5C80315e3AE37043Dce99F6CC529",
-    tickLens: "0x38034F18D38b74bdE496bdF60CCdBcb25B879e8d"
-};
-const $be6f32539b5e2cc9$export$3e9a43ac784794d5 = ()=>({
-        rpcURL: "https://zkevm-rpc.dev.x.immutable.com",
-        exchangeContracts: $be6f32539b5e2cc9$var$contractOverrides,
-        commonRoutingTokens: $be6f32539b5e2cc9$var$commonRoutingTokens,
-        nativeToken: {
-            chainId: $be6f32539b5e2cc9$var$chainId,
-            address: "",
-            decimals: 18,
-            symbol: "IMX",
-            name: "Immutable X Token"
-        }
-    });
-
-
 async function $67fc622a2b913d5f$export$989eefe1274a439c(fromChainId, toChainId, readOnlyProviders, environment) {
     const rootChainProvider = readOnlyProviders.get(fromChainId);
     const childChainProvider = readOnlyProviders.get(toChainId);
@@ -811,24 +772,20 @@ async function $67fc622a2b913d5f$export$989eefe1274a439c(fromChainId, toChainId,
     });
     return new (TokenBridge)(bridgeConfig);
 }
-async function $67fc622a2b913d5f$export$7cf6178417769841(chainId, environment) {
-    const exchange = new (Exchange)(new (ExchangeConfiguration)({
+async function $67fc622a2b913d5f$export$7cf6178417769841(chainId, config) {
+    const dexConfig = await config.remoteConfigFetcher.get("dex");
+    return new (Exchange)(new (ExchangeConfiguration)({
         chainId: chainId,
         baseConfig: new (ImmutableConfiguration)({
-            environment: environment
+            environment: config.environment
         }),
-        overrides: ($be6f32539b5e2cc9$export$3e9a43ac784794d5)()
+        overrides: dexConfig?.overrides
     }));
-    return exchange;
 }
 
 
 
 
-var $d7b15ec974df6f92$exports = {};
-$d7b15ec974df6f92$exports = JSON.parse('{"11155111":{"bridgeToL2Addresses":{"gasTokenAddress":"NATIVE","fromAddress":"0xd1da7e9b2Ce1a4024DaD52b3D37F4c5c91a525C1"},"swapAddresses":{"inAddress":"0xFEa9FF93DC0C6DC73F8Be009Fe7a22Bb9dcE8A2d","outAddress":"0x8AC26EfCbf5D700b37A27aA00E6934e6904e7B8e"}}}');
-
-
 const $2e7bf45a7c9a9570$var$DUMMY_WALLET_ADDRESS = "0x0000000000000000000000000000000000000000";
 const $2e7bf45a7c9a9570$var$DEFAULT_TOKEN_DECIMALS = 18;
 const $2e7bf45a7c9a9570$var$getL1ChainId = (environment)=>{
@@ -839,15 +796,15 @@ const $2e7bf45a7c9a9570$var$getL2ChainId = (environment)=>{
     if (environment === (Environment).PRODUCTION) return ($baec09ddc3013323$export$c06e1e7429de6283).IMTBL_ZKEVM_TESTNET;
     return ($baec09ddc3013323$export$c06e1e7429de6283).IMTBL_ZKEVM_DEVNET;
 };
-async function $2e7bf45a7c9a9570$var$bridgeToL2GasEstimator(readOnlyProviders, environment, isSpendingCapApprovalRequired, tokenAddress) {
-    const fromChainId = $2e7bf45a7c9a9570$var$getL1ChainId(environment);
-    const toChainId = $2e7bf45a7c9a9570$var$getL2ChainId(environment);
-    const tokenAddresses = environment === (Environment).PRODUCTION ? ((/*@__PURE__*/$parcel$interopDefault($d7b15ec974df6f92$exports)))[($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA] : ((/*@__PURE__*/$parcel$interopDefault($d7b15ec974df6f92$exports)))[($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA];
-    const { gasTokenAddress: gasTokenAddress , fromAddress: fromAddress  } = tokenAddresses.bridgeToL2Addresses;
+async function $2e7bf45a7c9a9570$var$bridgeToL2GasEstimator(readOnlyProviders, config, isSpendingCapApprovalRequired, tokenAddress) {
+    const fromChainId = $2e7bf45a7c9a9570$var$getL1ChainId(config.environment);
+    const toChainId = $2e7bf45a7c9a9570$var$getL2ChainId(config.environment);
+    const gasEstimateTokensConfig = await config.remoteConfigFetcher.get("gasEstimateTokens");
+    const { gasTokenAddress: gasTokenAddress , fromAddress: fromAddress  } = gasEstimateTokensConfig[fromChainId.toString()].bridgeToL2Addresses;
     const provider = readOnlyProviders.get(fromChainId);
     try {
         const { estimatedAmount: estimatedAmount , token: token  } = await (0, $570856c68db0bd36$export$51010590edbe56a6)(provider, fromChainId, isSpendingCapApprovalRequired, tokenAddress ?? gasTokenAddress);
-        const tokenBridge = await $67fc622a2b913d5f$export$989eefe1274a439c(fromChainId, toChainId, readOnlyProviders, environment);
+        const tokenBridge = await $67fc622a2b913d5f$export$989eefe1274a439c(fromChainId, toChainId, readOnlyProviders, config.environment);
         const { bridgeFee: bridgeFee , bridgeable: bridgeable  } = await (0, $570856c68db0bd36$export$9e73e22953cebcfc)(tokenBridge, fromAddress, toChainId);
         return {
             gasEstimateType: (0, $de275b98d2b651c3$export$788b1fd17f3dad84).BRIDGE_TO_L2,
@@ -871,12 +828,12 @@ async function $2e7bf45a7c9a9570$var$bridgeToL2GasEstimator(readOnlyProviders, e
         };
     }
 }
-async function $2e7bf45a7c9a9570$var$swapGasEstimator(environment) {
-    const tokenAddresses = environment === (Environment).PRODUCTION ? ((/*@__PURE__*/$parcel$interopDefault($d7b15ec974df6f92$exports)))[($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA] : ((/*@__PURE__*/$parcel$interopDefault($d7b15ec974df6f92$exports)))[($baec09ddc3013323$export$c06e1e7429de6283).SEPOLIA];
-    const { inAddress: inAddress , outAddress: outAddress  } = tokenAddresses.swapAddresses;
-    const chainId = $2e7bf45a7c9a9570$var$getL2ChainId(environment);
+async function $2e7bf45a7c9a9570$var$swapGasEstimator(config) {
+    const chainId = $2e7bf45a7c9a9570$var$getL2ChainId(config.environment);
+    const gasEstimateTokensConfig = await config.remoteConfigFetcher.get("gasEstimateTokens");
+    const { inAddress: inAddress , outAddress: outAddress  } = gasEstimateTokensConfig[chainId].swapAddresses;
     try {
-        const exchange = await $67fc622a2b913d5f$export$7cf6178417769841(chainId, environment);
+        const exchange = await $67fc622a2b913d5f$export$7cf6178417769841(chainId, config);
         // Create a fake transaction to get the gas from the quote
         const { info: info  } = await exchange.getUnsignedSwapTxFromAmountIn($2e7bf45a7c9a9570$var$DUMMY_WALLET_ADDRESS, inAddress, outAddress, (0, BigNumber).from((0, utils$1).parseUnits("1", $2e7bf45a7c9a9570$var$DEFAULT_TOKEN_DECIMALS)));
         if (info.gasFeeEstimate === null) return {
@@ -905,12 +862,12 @@ async function $2e7bf45a7c9a9570$var$swapGasEstimator(environment) {
         };
     }
 }
-async function $2e7bf45a7c9a9570$export$942c8de7174809fc(params, readOnlyProviders, environment) {
+async function $2e7bf45a7c9a9570$export$942c8de7174809fc(params, readOnlyProviders, config) {
     switch(params.gasEstimateType){
         case ($de275b98d2b651c3$export$788b1fd17f3dad84).BRIDGE_TO_L2:
-            return await $2e7bf45a7c9a9570$var$bridgeToL2GasEstimator(readOnlyProviders, environment, params.isSpendingCapApprovalRequired, params.tokenAddress);
+            return await $2e7bf45a7c9a9570$var$bridgeToL2GasEstimator(readOnlyProviders, config, params.isSpendingCapApprovalRequired, params.tokenAddress);
         case ($de275b98d2b651c3$export$788b1fd17f3dad84).SWAP:
-            return await $2e7bf45a7c9a9570$var$swapGasEstimator(environment);
+            return await $2e7bf45a7c9a9570$var$swapGasEstimator(config);
         default:
             throw new ($a8bc256d81a5e2c1$export$b722478a3cbfa3bc)("Invalid type provided for gasEstimateType", ($a8bc256d81a5e2c1$export$e3dc0620abde7f5a).INVALID_GAS_ESTIMATE_TYPE);
     }
@@ -923,7 +880,35 @@ async function $2e7bf45a7c9a9570$export$942c8de7174809fc(params, readOnlyProvide
 
 
 
-class $4013c5c91bb535f6$export$47a4ed4a38b9eecf extends Error {
+
+
+class $a492ee374ae7b613$export$d902b56530cd5f87 {
+    cache;
+    environment;
+    constructor(params){
+        this.environment = params.environment;
+    }
+    async load() {
+        if (this.cache) return this.cache;
+        let response;
+        try {
+            response = await (0, $7v2Z6$axios).get(`${(0, $d85ad1457a3f1a83$export$161d4a74df65fc08)[this.environment]}/v1/config`);
+        } catch (error) {
+            throw new Error(`Error fetching config: ${error.message}`);
+        }
+        if (response.status !== 200) throw new Error(`Error fetching config: ${response.status} ${response.statusText}`);
+        this.cache = response.data;
+        return this.cache;
+    }
+    async get(key) {
+        const config = await this.load();
+        if (config && key) return config[key];
+        return config;
+    }
+}
+
+
+class $4013c5c91bb535f6$export$6ad73ea7e1b6f37f extends Error {
     message;
     constructor(message){
         super(message);
@@ -933,11 +918,15 @@ class $4013c5c91bb535f6$export$47a4ed4a38b9eecf extends Error {
 class $4013c5c91bb535f6$export$4823433c4a67bbc6 {
     environment;
     networkMap;
+    remoteConfigFetcher;
     constructor(config){
         // validate input
-        if (!Object.values((Environment)).includes(config.baseConfig.environment)) throw new $4013c5c91bb535f6$export$47a4ed4a38b9eecf("Invalid checkout configuration of environment");
+        if (!Object.values((Environment)).includes(config.baseConfig.environment)) throw new $4013c5c91bb535f6$export$6ad73ea7e1b6f37f("Invalid checkout configuration of environment");
         this.environment = config.baseConfig.environment;
         this.networkMap = config.baseConfig.environment === (Environment).PRODUCTION ? ($a47e48dd2c04791b$export$6f24f3cef7d501c4) : ($a47e48dd2c04791b$export$3e81fc0987227f10);
+        this.remoteConfigFetcher = new ($a492ee374ae7b613$export$d902b56530cd5f87)({
+            environment: config.baseConfig.environment
+        });
     }
 }
 
@@ -1100,8 +1089,8 @@ class $a8cb37a3fc8eb863$export$1f60ba4ec72508a0 {
    * @returns The gas estimate for the given action.
    */ async gasEstimate(params) {
         this.readOnlyProviders = await ($0e0060cb42e136d2$export$339cb2be73677b30)(this.config, this.readOnlyProviders);
-        return await $2e7bf45a7c9a9570$export$942c8de7174809fc(params, this.readOnlyProviders, this.config.environment);
+        return await $2e7bf45a7c9a9570$export$942c8de7174809fc(params, this.readOnlyProviders, this.config);
     }
 }
 
-export { $baec09ddc3013323$export$c06e1e7429de6283 as ChainId, $a8cb37a3fc8eb863$export$1f60ba4ec72508a0 as Checkout, $a8bc256d81a5e2c1$export$e3dc0620abde7f5a as CheckoutErrorType, $d176a05e966364ba$export$3bfad4d03ada24c4 as ConnectionProviders, $de275b98d2b651c3$export$788b1fd17f3dad84 as GasEstimateType, $a47e48dd2c04791b$export$1f05a55fe0680cc7 as NetworkFilterTypes, $a47e48dd2c04791b$export$345c852d0dc8f1df as RPC_URL_MAP, $08d5ddc39acd6833$export$fd9b17d87f4121d2 as TokenFilterTypes, $4f91c5f280efe242$export$a75605c67ea83a5a as WalletFilterTypes, $e768639828688ca3$export$2d7a51a18d87e21d as WalletProviderName };
+export { $d85ad1457a3f1a83$export$161d4a74df65fc08 as CHECKOUT_API_BASE_URL, $baec09ddc3013323$export$c06e1e7429de6283 as ChainId, $a8cb37a3fc8eb863$export$1f60ba4ec72508a0 as Checkout, $a8bc256d81a5e2c1$export$e3dc0620abde7f5a as CheckoutErrorType, $de275b98d2b651c3$export$788b1fd17f3dad84 as GasEstimateType, $a47e48dd2c04791b$export$1f05a55fe0680cc7 as NetworkFilterTypes, $a47e48dd2c04791b$export$345c852d0dc8f1df as RPC_URL_MAP, $08d5ddc39acd6833$export$fd9b17d87f4121d2 as TokenFilterTypes, $4f91c5f280efe242$export$a75605c67ea83a5a as WalletFilterTypes, $e768639828688ca3$export$2d7a51a18d87e21d as WalletProviderName };

package/dist/checkout_widgets.d.ts

@@ -15026,11 +15026,11 @@ declare enum ConnectEventType {
 }
 /**
  * Type representing a Connect Widget event with type SUCCESS.
- * @property {ConnectionProviders} providerPreference - The user's preferred connection provider.
+ * @property {WalletProviderName} walletProvider - The user's preferred connection provider.
  */
 type ConnectionSuccess = {
     provider: Web3Provider;
-    providerName: WalletProviderName | undefined;
+    walletProvider: WalletProviderName | undefined;
 };
 /**
  * Type representing a Connect Widget event with type FAILURE.
@@ -15047,10 +15047,10 @@ declare enum OrchestrationEventType {
     REQUEST_ONRAMP = "request-onramp"
 }
 type RequestConnectEvent = {
-    providerPreference: string;
+    walletProvider: string;
 };
 type RequestWalletEvent = {
-    providerPreference: string;
+    walletProvider: string;
 };
 type RequestSwapEvent = {
     fromTokenAddress: string;
@@ -15155,17 +15155,15 @@ declare global {
 }
 /**
  * Props for the Connect Widget component
- * @property {string} providerPreference - The preferred wallet provider to connect to.
  * @property {string} theme - The theme to use.
  * @property {string} environment - The environment configuration
  */
 interface ImtblConnectProps extends React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> {
-    walletProvider?: string;
     widgetConfig?: string;
 }
 /**
  * Props for the Wallet Widget component
- * @property {string} providerPreference - The preferred wallet provider to connect to.
+ * @property {string} walletProvider - The preferred wallet provider to connect to.
  * @property {string} theme - The theme to use.
  * @property {string} environment - The environment configuration
  */
@@ -15175,7 +15173,7 @@ interface ImtblWalletProps extends React.DetailedHTMLProps<React.HTMLAttributes<
 }
 /**
  * Props for the Swap Widget component
- * @property {string} providerPreference - The preferred wallet provider to connect to.
+ * @property {string} walletProvider - The preferred wallet provider to connect to.
  * @property {string} theme - The theme to use.
  * @property {string} environment - The environment configuration
  * @property {string} amount - The amount to swap.
@@ -15191,18 +15189,16 @@ interface ImtblSwapProps extends React.DetailedHTMLProps<React.HTMLAttributes<HT
 }
 /**
  * Props for the Bridge Widget component
- * @property {string} providerPreference - The preferred wallet provider to connect to.
+ * @property {string} walletProvider - The preferred wallet provider to connect to.
  * @property {string} theme - The theme to use.
  * @property {string} environment - The environment configuration
  * @property {string} fromContractAddress - The contract address of the source token.
- * @property {string} fromNetwork - The network of the source token.
  * @property {string} amount - The amount to bridge.
  */
 interface ImtblBridgeProps extends React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement> {
     walletProvider?: string;
     widgetConfig?: string;
     fromContractAddress: string;
-    fromNetwork: string;
     amount: string;
 }
 /**
@@ -15212,9 +15208,7 @@ declare enum Network {
     ETHEREUM = "Ethereum",
     SEPOLIA = "Sepolia",
     IMTBL_ZKEVM_TESTNET = "Immutable zkEVM Testnet",
-    IMTBL_ZKEVM_DEVNET = "Immutable zkEVM Devnet",
-    POLYGON_ZKEVM_TESTNET = "Polygon zkEVM Testnet",
-    POLYGON_ZKEVM = "Polygon zkEVM"
+    IMTBL_ZKEVM_DEVNET = "Immutable zkEVM Devnet"
 }
 /**
  * Enum representing the themes for the Checkout widgets.
@@ -15233,10 +15227,35 @@ declare enum CheckoutWidgetTagNames {
     SWAP = "imtbl-swap",
     BRIDGE = "imtbl-bridge"
 }
+/**
+ * Represents the version of the Checkout Widgets to use defaults to (0.1.9-alpha)
+ * @property {number} major - The major version of the widgets, must specify a major version even if it is 0, otherwise version defaults to (0.1.9-alpha)
+ * @property {number} minor - The minor version of the widgets, leaving this blank will pickup all new minor versions released
+ * @property {number} patch - The patch version of the widgets, leaving this blank will pickup all new patch versions released
+ * @property {string} prerelease - The prerelease version of the widgets, can only be 'alpha' or 'beta', will be used in preference of build if it is also specified. Do not use in production.
+ * @property {number} build - The build version of the widgets, this should not be used in production and will only be used for rare cases when a specific testing is required
+ *
+ * @example
+ * { major: 0 } - use default version 0.1.9-alpha
+ *
+ * { major: 1 } - use version 1.x.x, pickup all new minor and patch versions released
+ *
+ * { major: 1, minor: 1 } - use version 1.1.x, pickup all new patch versions released
+ *
+ * { major: 1, minor: 2, patch: 3 } - use version 1.2.3 specifically
+ */
+type SemanticVersion = {
+    major: number;
+    minor?: number;
+    patch?: number;
+    prerelease?: 'alpha' | 'beta';
+    build?: number;
+};
 /**
  * Represents the configuration options for the Checkout Widgets.
  * @property {WidgetTheme} theme - The theme of the Checkout Widget (default: "DARK")
  * @property {Environment} environment - The environment configuration (default: "SANDBOX")
+ * @property {SemanticVersion} version - The version of the checkout widgets js file to use (default: "0.1.0")
  * @property {boolean} isOnRampEnabled - Enable on-ramp top-up method (default: "true")
  * @property {boolean} isSwapEnabled - Enable swap top-up method (default: "true")
  * @property {boolean} isBridgeEnabled - Enable bridge top-up method (default: "true")
@@ -15244,6 +15263,7 @@ declare enum CheckoutWidgetTagNames {
 type CheckoutWidgetsConfig = {
     theme?: WidgetTheme;
     environment?: Environment;
+    version?: SemanticVersion;
     isOnRampEnabled?: boolean;
     isSwapEnabled?: boolean;
     isBridgeEnabled?: boolean;
@@ -15254,13 +15274,12 @@ type CheckoutWidgetsConfig = {
  * (default: "metamask").
  * @property {string} fromContractAddress - The contract address to send tokens from.
  * @property {string} amount - The amount of tokens to send.
- * @property {Network} fromNetwork - The network to send tokens from.
  */
 interface BridgeReactProps {
     walletProvider?: WalletProviderName;
+    provider?: Web3Provider;
     fromContractAddress?: string;
     amount?: string;
-    fromNetwork?: Network;
 }
 /**
  * A React functional component that renders the Checkout Bridge Widget.
@@ -15268,20 +15287,11 @@ interface BridgeReactProps {
  * @returns {JSX.Element} - The rendered Bridge Widget component.
  */
 declare function BridgeReact(props: BridgeReactProps): JSX.Element;
-/**
- * Interface representing the props for the Connect Widget component.
- * @property {string} providerPreference - The preferred provider for the Connect Widget
- * (default: "metamask").
- */
-interface ConnectReactProps {
-    walletProvider?: string;
-}
 /**
  * A React functional component that renders the Checkout Connect Widget.
- * @param {ConnectReactProps} props - The props for the Connect Widget component.
  * @returns {JSX.Element} - The rendered Connect Widget component.
  */
-declare function ConnectReact(props: ConnectReactProps): JSX.Element;
+declare function ConnectReact(): JSX.Element;
 /**
  * Interface representing the props for the Swap Widget component.
  * @property {string} walletProvider - The preferred provider for the Swap Widget (default: "metamask"}).
@@ -15291,6 +15301,7 @@ declare function ConnectReact(props: ConnectReactProps): JSX.Element;
  */
 interface SwapReactProps {
     walletProvider?: WalletProviderName;
+    provider?: Web3Provider;
     fromContractAddress?: string;
     amount?: string;
     toContractAddress?: string;
@@ -15303,11 +15314,12 @@ interface SwapReactProps {
 declare function SwapReact(props: SwapReactProps): JSX.Element;
 /**
  * Interface representing the props for the Wallet Widget component.
- * @property {string} providerPreference - The preferred provider for the Wallet Widget
+ * @property {string} walletProvider - The preferred provider for the Wallet Widget
  * (default: "metamask").
  */
 interface WalletReactProps {
     walletProvider?: WalletProviderName;
+    provider?: Web3Provider;
 }
 /**
  * A React functional component that renders the Checkout Wallet Widget.
@@ -15315,6 +15327,15 @@ interface WalletReactProps {
  * @returns {JSX.Element} - The rendered Wallet Widget component.
  */
 declare function WalletReact(props: WalletReactProps): JSX$1.Element;
+declare const DEFAULT_CHECKOUT_VERSION = "0.1.9-alpha";
+/**
+ * Checking for valid version numbers input.
+ * 0 is a valid value for major, minor and/or patch
+ * The current release process only includes the checkout script in 'alpha' builds
+ * so we must append '-alpha' to valid versions in order to load the script properly.
+ * This may change in the future depending on the relase process.
+ */
+declare function validateAndBuildVersion(version: SemanticVersion | undefined): string;
 /**
  * CheckoutWidgets allows to inject the Checkout Widgets into your application.
  * @param {CheckoutWidgetsConfig|undefined} config - Checkout Widget global configurations.
@@ -15325,11 +15346,5 @@ declare function CheckoutWidgets(config?: CheckoutWidgetsConfig): void;
  * @param {CheckoutWidgetsConfig} config - new Checkout Widget global configurations.
  */
 declare function UpdateConfig(config: CheckoutWidgetsConfig): void;
-/**
- * SetProvider allows to set the provider for an existing Checkout Widgets instance.
- * @param {CheckoutWidgetTagNames} tagName - target Checkout Widget widget.
- * @param {Web3Provider} provider - the provider to connect to the blockchain network.
- */
-declare function SetProvider(tagName: CheckoutWidgetTagNames, provider: Web3Provider | null): void;
 
-export { BridgeEventType, BridgeFailed, BridgeReact, BridgeReactProps, BridgeSuccess, CheckoutWidgetTagNames, CheckoutWidgets, CheckoutWidgetsConfig, ConnectEventType, ConnectReact, ConnectReactProps, ConnectionFailed, ConnectionSuccess, IMTBLWidgetEvents, ImtblBridgeProps, ImtblConnectProps, ImtblSwapProps, ImtblWalletProps, Network, OrchestrationEventType, RequestBridgeEvent, RequestConnectEvent, RequestOnrampEvent, RequestSwapEvent, RequestWalletEvent, SetProvider, SwapEventType, SwapFailed, SwapReact, SwapReactProps, SwapRejected, SwapSuccess, UpdateConfig, WalletDisconnectWalletEvent, WalletEventType, WalletNetworkSwitchEvent, WalletReact, WalletReactProps, WidgetEvent, WidgetTheme };
+export { BridgeEventType, BridgeFailed, BridgeReact, BridgeReactProps, BridgeSuccess, CheckoutWidgetTagNames, CheckoutWidgets, CheckoutWidgetsConfig, ConnectEventType, ConnectReact, ConnectionFailed, ConnectionSuccess, DEFAULT_CHECKOUT_VERSION, IMTBLWidgetEvents, ImtblBridgeProps, ImtblConnectProps, ImtblSwapProps, ImtblWalletProps, Network, OrchestrationEventType, RequestBridgeEvent, RequestConnectEvent, RequestOnrampEvent, RequestSwapEvent, RequestWalletEvent, SemanticVersion, SwapEventType, SwapFailed, SwapReact, SwapReactProps, SwapRejected, SwapSuccess, UpdateConfig, WalletDisconnectWalletEvent, WalletEventType, WalletNetworkSwitchEvent, WalletReact, WalletReactProps, WidgetEvent, WidgetTheme, validateAndBuildVersion };