iExecBlockchainComputing · PierreJeanjacquot · Jun 19, 2025 · Jun 9, 2025 · Jun 10, 2025 · Jun 10, 2025
diff --git a/docs/classes/internal_.IExecContractsClient.md b/docs/classes/internal_.IExecContractsClient.md
@@ -44,9 +44,9 @@ Create a client for IExec contracts
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `args` | `Object` | - |
-| `args.chainId` | `string` \| `number` | id of the chain to use (used to resolve IExec contract address) |
+| `args.chainId` | `string` \| `number` | id of the chain |
 | `args.confirms?` | `number` | number of block to wait for transactions confirmation (default 1) |
-| `args.hubAddress?` | `string` | override the IExec contract address to target a custom instance |
+| `args.hubAddress` | `string` | IExec contract address |
 | `args.isNative?` | `boolean` | true if IExec contract use the chain native token |
 | `args.provider` | `Provider` | ethers Provider |
 | `args.signer?` | `Signer` | ethers Signer, required to sign transactions and messages |

diff --git a/docs/interfaces/IExecConfigOptions.md b/docs/interfaces/IExecConfigOptions.md
@@ -6,6 +6,7 @@
 
 ### Properties
 
+- [allowExperimentalNetworks](IExecConfigOptions.md#allowexperimentalnetworks)
 - [bridgeAddress](IExecConfigOptions.md#bridgeaddress)
 - [bridgedNetworkConf](IExecConfigOptions.md#bridgednetworkconf)
 - [confirms](IExecConfigOptions.md#confirms)
@@ -25,6 +26,16 @@
 
 ## Properties
 
+### allowExperimentalNetworks
+
+• `Optional` **allowExperimentalNetworks**: `boolean`
+
+if true allows using a provider connected to an experimental networks (default false)
+
+⚠️ experimental networks are networks on which the iExec's stack is partially deployed, experimental networks can be subject to instabilities or discontinuity. Access is provided without warranties.
+
+___
+
 ### bridgeAddress
 
 • `Optional` **bridgeAddress**: `string`

diff --git a/docs/modules/utils.md b/docs/modules/utils.md
@@ -183,6 +183,7 @@ const iexec = new IExec({ ethProvider });
 | `host` | `string` | node RPC url |
 | `privateKey` | `string` | wallet private key |
 | `options?` | `Object` | - |
+| `options.allowExperimentalNetworks?` | `boolean` | if true allows using a provider connected to an experimental networks (default false) ⚠️ experimental networks are networks on which the iExec's stack is partially deployed, experimental networks can be subject to instabilities or discontinuity. Access is provided without warranties. |
 | `options.gasPrice?` | `string` \| `number` \| `bigint` | gas price override |
 | `options.getTransactionCount?` | (`blockTag?`: `BlockTag`) => `Promise`<`number`\> | nonce override |
 | `options.providers` | [`ProviderOptions`](../interfaces/ProviderOptions.md) | providers options |

diff --git a/src/cli/cmd/iexec.js b/src/cli/cmd/iexec.js
@@ -123,9 +123,7 @@ infoCmd
       const chain = await loadChain(opts.chain, { spinner });
 
       const host =
-        chain.host === getChainDefaults({ id: chain.id }).host
-          ? 'default'
-          : chain.host;
+        chain.host === getChainDefaults(chain.id).host ? 'default' : chain.host;
       spinner.info(`Ethereum host: ${host}`);
 
       spinner.start(info.checking('iExec contracts info'));

diff --git a/src/cli/utils/chains.js b/src/cli/utils/chains.js
@@ -1,5 +1,5 @@
 import Debug from 'debug';
-import { getChainDefaults } from '../../common/utils/config.js';
+import { getId, getChainDefaults } from '../../common/utils/config.js';
 import IExecContractsClient from '../../common/utils/IExecContractsClient.js';
 import { EnhancedWallet } from '../../common/utils/signers.js';
 import { loadChainConf } from './fs.js';
@@ -8,27 +8,21 @@ import { getReadOnlyProvider } from '../../common/utils/providers.js';
 
 const debug = Debug('iexec:chains');
 
-const CHAIN_ALIASES_MAP = {
-  1: 'mainnet',
-  134: 'bellecour',
-};
-
-const CHAIN_NAME_MAP = {
-  1: { id: '1' },
-  mainnet: { id: '1' },
-  134: { id: '134' },
-  bellecour: { id: '134' },
-};
-
 const createChainFromConf = (
   chainName,
   chainConf,
-  { bridgeConf, providerOptions, txOptions = {} } = {},
+  {
+    bridgeConf,
+    providerOptions,
+    txOptions = {},
+    allowExperimentalNetworks = false,
+  } = {},
 ) => {
   try {
     const chain = { ...chainConf };
     const provider = getReadOnlyProvider(chainConf.host, {
       providers: providerOptions,
+      allowExperimentalNetworks,
     });
 
     chain.name = chainName;
@@ -45,6 +39,7 @@ const createChainFromConf = (
       chain.bridgedNetwork = { ...bridgeConf };
       const bridgeProvider = getReadOnlyProvider(bridgeConf.host, {
         providers: providerOptions,
+        allowExperimentalNetworks,
       });
       chain.bridgedNetwork.contracts = new IExecContractsClient({
         provider: bridgeProvider,
@@ -63,26 +58,34 @@ const createChainFromConf = (
 };
 
 export const loadChain = async (
-  chainName,
+  chainNameOrId,
   { txOptions, spinner = Spinner() } = {},
 ) => {
   try {
     const chainsConf = await loadChainConf();
-    debug('chainsConf', chainsConf);
+    const { allowExperimentalNetworks } = chainsConf;
     const providerOptions = chainsConf.providers;
     let name;
     let loadedConf;
-    if (chainName) {
-      if (chainsConf.chains[chainName]) {
-        loadedConf = chainsConf.chains[chainName];
-        name = chainName;
+    if (chainNameOrId) {
+      if (chainsConf.chains[chainNameOrId]) {
+        loadedConf = chainsConf.chains[chainNameOrId];
+        name = chainNameOrId;
       } else {
-        const alias = CHAIN_ALIASES_MAP[chainName];
+        const { name: alias } = getChainDefaults(
+          getId(chainNameOrId, {
+            allowExperimentalNetworks,
+          }),
+          {
+            allowExperimentalNetworks,
+          },
+        );
         if (alias && chainsConf.chains[alias]) {
           loadedConf = chainsConf.chains[alias];
           name = alias;
         }
-        if (!name) throw Error(`Missing "${chainName}" chain in "chain.json"`);
+        if (!name)
+          throw Error(`Missing "${chainNameOrId}" chain in "chain.json"`);
       }
     } else if (chainsConf.default) {
       if (chainsConf.chains[chainsConf.default]) {
@@ -96,11 +99,16 @@ export const loadChain = async (
       throw Error('Missing chain parameter. Check your "chain.json" file');
 
     const idConf = {
-      ...CHAIN_NAME_MAP[name],
-      ...(loadedConf.id && { id: loadedConf.id }),
+      id:
+        loadedConf.id ||
+        getId(name, {
+          allowExperimentalNetworks,
+        }),
     };
 
-    const defaultConf = getChainDefaults(idConf);
+    const defaultConf = getChainDefaults(idConf.id, {
+      allowExperimentalNetworks,
+    });
 
     debug('loading chain', name);
     debug('loadedConf', loadedConf);
@@ -120,18 +128,30 @@ export const loadChain = async (
       if (chainsConf.chains[bridgedChainNameOrId]) {
         bridgeLoadedConf = chainsConf.chains[bridgedChainNameOrId];
       } else {
-        const alias = CHAIN_ALIASES_MAP[bridgedChainNameOrId];
+        const { name: alias } = getChainDefaults(
+          getId(bridgedChainNameOrId, {
+            allowExperimentalNetworks,
+          }),
+          {
+            allowExperimentalNetworks,
+          },
+        );
         if (alias && chainsConf.chains[alias]) {
           bridgeLoadedConf = chainsConf.chains[alias];
         }
         if (!bridgeLoadedConf)
           throw Error(`Missing "${name}" chain in "chain.json"`);
       }
       const bridgeIdConf = {
-        ...CHAIN_NAME_MAP[bridgedChainNameOrId],
-        ...(bridgeLoadedConf.id && { id: bridgeLoadedConf.id }),
+        id:
+          bridgeLoadedConf.id ||
+          getId(bridgedChainNameOrId, {
+            allowExperimentalNetworks,
+          }),
       };
-      const bridgeDefaultConf = getChainDefaults(bridgeIdConf);
+      const bridgeDefaultConf = getChainDefaults(bridgeIdConf.id, {
+        allowExperimentalNetworks,
+      });
       debug('bridgeLoadedConf', bridgeLoadedConf);
       debug('bridgeDefaultConf', defaultConf);
       bridgeConf = {
@@ -150,6 +170,7 @@ export const loadChain = async (
       bridgeConf,
       providerOptions,
       txOptions,
+      allowExperimentalNetworks,
     });
     spinner.info(`Using chain ${name} [chainId: ${chain.id}]`);
     return chain;

diff --git a/src/cli/utils/fs.js b/src/cli/utils/fs.js
@@ -51,6 +51,7 @@ const chainConfSchema = () =>
 const chainsConfSchema = () =>
   object({
     default: string(),
+    allowExperimentalNetworks: boolean().default(false),
     chains: object()
       .test(async (chainsOjb) => {
         await Promise.all(

diff --git a/src/common/market/order.js b/src/common/market/order.js
@@ -783,7 +783,7 @@ const getMatchableVolume = async (
 
 export const estimateMatchOrders = async ({
   contracts = throwIfMissing(),
-  voucherHubAddress = throwIfMissing(),
+  voucherHubAddress,
   apporder,
   datasetorder = NULL_DATASETORDER,
   workerpoolorder,

diff --git a/src/common/utils/IExecContractsClient.d.ts b/src/common/utils/IExecContractsClient.d.ts
@@ -14,13 +14,13 @@ export default class IExecContractsClient {
      */
     signer?: Signer;
     /**
-     * id of the chain to use (used to resolve IExec contract address)
+     * id of the chain
      */
     chainId: number | string;
     /**
-     * override the IExec contract address to target a custom instance
+     * IExec contract address
      */
-    hubAddress?: string;
+    hubAddress: string;
     /**
      * if false set the gasPrice to 0 (default true)
      */

diff --git a/src/common/utils/IExecContractsClient.js b/src/common/utils/IExecContractsClient.js
@@ -1,7 +1,6 @@
 import Debug from 'debug';
 import { Contract } from 'ethers';
 import { version as pocoVersion } from '../generated/@iexec/poco/package.js';
-import { networks as iexecProxyNetworks } from '../generated/@iexec/poco/ERC1538Proxy.js';
 import iexecTokenDesc from '../generated/@iexec/poco/IexecInterfaceToken.js';
 import iexecNativeDesc from '../generated/@iexec/poco/IexecInterfaceNative.js';
 import appRegistryDesc from '../generated/@iexec/poco/AppRegistry.js';
@@ -20,17 +19,6 @@ const gasPriceByNetwork = {
   134: 0n,
 };
 
-const getHubAddress = (chainId) => {
-  if (
-    iexecProxyNetworks &&
-    iexecProxyNetworks[chainId] &&
-    iexecProxyNetworks[chainId].address
-  ) {
-    return iexecProxyNetworks[chainId].address;
-  }
-  throw Error(`Missing iExec contract default address for chain ${chainId}`);
-};
-
 const getIsNative = (chainId) => nativeNetworks.includes(chainId);
 
 const getGasPriceOverride = (chainId) => gasPriceByNetwork[chainId];
@@ -76,19 +64,12 @@ const getContractsDescMap = (isNative) => ({
   },
 });
 
-const createClient = ({
-  ethSigner,
-  ethProvider,
-  chainId,
-  globalHubAddress,
-  isNative,
-}) => {
+const createClient = ({ ethSigner, ethProvider, hubAddress, isNative }) => {
   const cachedAddresses = {};
+  if (!hubAddress) throw Error('Missing iExec contract address');
 
   const contractsDescMap = getContractsDescMap(isNative);
 
-  const hubAddress = globalHubAddress || getHubAddress(chainId);
-
   const getContract = (objName, address) => {
     try {
       const { contractDesc } = contractsDescMap[objName];
@@ -184,6 +165,7 @@ class IExecContractsClient {
   } = {}) {
     const stringChainId = `${chainId}`;
     if (!provider) throw Error('missing provider key');
+    if (!hubAddress) throw Error('missing hubAddress key');
     if (!stringChainId) throw Error('missing chainId key');
     if (!Number.isInteger(confirms) || confirms <= 0)
       throw Error('invalid confirms');
@@ -206,8 +188,7 @@ class IExecContractsClient {
     const client = createClient({
       ethSigner: signer,
       ethProvider: provider,
-      chainId: stringChainId,
-      globalHubAddress: hubAddress,
+      hubAddress,
       isNative: native,
     });