Migrate script/ JS files to TS (#184)

Author: gfournieriExec

.github/workflows/main.yml

@@ -36,6 +36,8 @@ jobs:
         # Basic deployment to make sure everything is ok.
         # Could be removed in the future if not relevant.
         run: npm run deploy
+      - name: Test Timelock Deployment
+        run: npm run deploy:timelock
       - name: Run coverage
         run: npm run coverage
       - name: Upload coverage reports to Codecov

CHANGELOG.md

@@ -6,6 +6,8 @@
 - [x] `IexecPoco2Delegate.sol`
 
 ### Features
+- Migrate scripts to TypeScript: (#184)
+    - `getFunctionSignatures.js`, `common-test-snapshot.js`, `test-storage.js`, `timelock.js`
 - Migrated utility files to TypeScript : (#183)
   - `FactoryDeployer.js`, `constants.js`, `odb-tools.js`
   - Removed deprecated `scripts/ens/sidechain.js`

migrations/utils/getFunctionSignatures.d.ts

@@ -0,0 +1,28 @@
+// SPDX-FileCopyrightText: 2023-2025 IEXEC BLOCKCHAIN TECH <contact@iex.ec>
+// SPDX-License-Identifier: Apache-2.0
+
+interface AbiParameter {
+    type: string;
+    components?: AbiParameter[];
+}
+
+function getSerializedObject(entry: AbiParameter): string {
+    return entry.type === 'tuple'
+        ? `(${entry.components?.map(getSerializedObject).join(',') ?? ''})`
+        : entry.type;
+}
+
+export function getFunctionSignatures(abi: any[]): string {
+    return [
+        ...abi.filter((entry) => entry.type === 'receive').map(() => 'receive;'),
+        ...abi.filter((entry) => entry.type === 'fallback').map(() => 'fallback;'),
+        ...abi
+            .filter((entry) => entry.type === 'function')
+            .map(
+                (entry) =>
+                    `${entry.name}(${entry.inputs?.map(getSerializedObject).join(',') ?? ''});`,
+            ),
+    ]
+        .filter(Boolean)
+        .join('');
+}

migrations/utils/getFunctionSignatures.js

@@ -10,7 +10,8 @@
     "prepare": "husky",
     "build": "npx hardhat compile",
     "deploy": "npx hardhat deploy",
-    "test-storage-layout": "npx hardhat run scripts/test-storage.js",
+    "deploy:timelock": "hardhat run scripts/deploy-timelock.ts",
+    "test-storage-layout": "npx hardhat run scripts/test-storage.ts",
     "test": "REPORT_GAS=true npx hardhat test",
     "autotest": "./test.sh",
     "coverage": "npx hardhat coverage",

migrations/utils/getFunctionSignatures.ts

@@ -1,13 +1,11 @@
-// SPDX-FileCopyrightText: 2024 IEXEC BLOCKCHAIN TECH <contact@iex.ec>
+// SPDX-FileCopyrightText: 2024-2025 IEXEC BLOCKCHAIN TECH <contact@iex.ec>
 // SPDX-License-Identifier: Apache-2.0
 
-async function resetNetworkToInitialState() {
+import hre from 'hardhat';
+
+export async function resetNetworkToInitialState(): Promise<void> {
     console.log(
         'Reset network to a fresh state to ensure same initial snapshot state between tests',
     );
     await hre.network.provider.send('hardhat_reset');
 }
-
-module.exports = {
-    resetNetworkToInitialState,
-};

package.json

@@ -0,0 +1,50 @@
+// SPDX-FileCopyrightText: 2020-2025 IEXEC BLOCKCHAIN TECH <contact@iex.ec>
+// SPDX-License-Identifier: Apache-2.0
+
+import { duration } from '@nomicfoundation/hardhat-network-helpers/dist/src/helpers/time';
+import hre, { ethers } from 'hardhat';
+import { TimelockController__factory } from '../typechain';
+import { FactoryDeployerHelper } from '../utils/FactoryDeployerHelper';
+const CONFIG = require('../config/config.json');
+
+/**
+ * Deploy TimelockController contract using the generic factory.
+ */
+
+export const deploy = async () => {
+    console.log('Deploying TimelockController..');
+    const chainId = (await ethers.provider.getNetwork()).chainId;
+    const [owner] = await hre.ethers.getSigners();
+    const deploymentOptions = CONFIG.chains[chainId] || CONFIG.chains.default;
+    const salt = process.env.SALT || deploymentOptions.v5.salt || ethers.constants.HashZero;
+
+    // Initialize factory deployer
+    const factoryDeployer = new FactoryDeployerHelper(owner, salt);
+
+    // Deploy TimelockController
+    const ONE_WEEK_IN_SECONDS = duration.days(7);
+    const ADMINISTRATORS = [
+        '0x9ED07B5DB7dAD3C9a0baA3E320E68Ce779063249',
+        '0x36e19bc6374c9cea5eb86622cf04c6b144b5b59c',
+        '0x56fa2d29a54b5349cd5d88ffa584bffb2986a656',
+        '0x9a78ecd77595ea305c6e5a0daed3669b17801d09',
+        '0xb5ad0c32fc5fcb5e4cba4c81f523e6d47a82ecd7',
+        '0xb906dc99340d0f3162dbc5b2539b0ad075649bcf',
+    ];
+    const PROPOSERS = [
+        '0x0B3a38b0A47aB0c5E8b208A703de366751Df5916', // v5 deployer
+    ];
+    const EXECUTORS = [
+        '0x0B3a38b0A47aB0c5E8b208A703de366751Df5916', // v5 deployer
+    ];
+    const constructorArgs = [ONE_WEEK_IN_SECONDS, ADMINISTRATORS, PROPOSERS, EXECUTORS];
+    const timelockFactory = new TimelockController__factory(owner);
+    await factoryDeployer.deployWithFactory(timelockFactory, constructorArgs);
+};
+
+if (require.main === module) {
+    deploy().catch((error) => {
+        console.error(error);
+        process.exit(1);
+    });
+}

scripts/common-test-snapshot.js renamed to scripts/common-test-snapshot.ts

@@ -6,7 +6,7 @@ import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
 import { deployments, ethers } from 'hardhat';
 import { IexecInterfaceNative__factory } from '../typechain';
 import { getIexecAccounts } from '../utils/poco-tools';
-const { resetNetworkToInitialState } = require('./common-test-snapshot');
+import { resetNetworkToInitialState } from './common-test-snapshot';
 const deploy = require('../deploy/0_deploy');
 const deployEns = require('../deploy/1_deploy-ens');