chore: release v8.16.0

## [8.16.0]

### Added

- added experimental networks

### Changed

- updated `iexec app init --tee` template to Scone v5.9

Author: PierreJeanjacquot

.github/workflows/conventional-commits-check.yaml

@@ -0,0 +1,13 @@
+name: Conventional Commits Check
+
+on: [pull_request]
+
+jobs:
+  check-conventional-commits:
+    name: Conventional Commits
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check Commit Conventions
+        uses: webiny/[email protected]

CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [8.16.0] 2025-06-19
+
+### Added
+
+- added experimental networks
+
+### Changed
+
+- updated `iexec app init --tee` template to Scone v5.9
+
 ## [8.15.0] 2025-04-10
 
 ### Added

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 |

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`

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 |

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "iexec",
-  "version": "8.15.0",
+  "version": "8.16.0",
   "description": "iExec SDK",
   "bin": {
     "iexec": "./dist/esm/cli/cmd/iexec.js"

package.json

@@ -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'));

src/cli/cmd/iexec.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;

src/cli/utils/chains.js

@@ -51,6 +51,7 @@ const chainConfSchema = () =>
 const chainsConfSchema = () =>
   object({
     default: string(),
+    allowExperimentalNetworks: boolean().default(false),
     chains: object()
       .test(async (chainsOjb) => {
         await Promise.all(