feat: use esm

BREAKING CHANGE:
Only esm is exported, no commonjs
Named exports (excluding `bls`) are no longer exported from the root.
`browser` and `node` exports are removed in favor of
implementation-specific naming.

.eslintrc.cjs

@@ -13,13 +13,15 @@ module.exports = {
   },
   parser: "@typescript-eslint/parser",
   parserOptions: {
-    ecmaVersion: 10,
-    project: "./tsconfig.json"
+    ecmaVersion: "latest",
+    project: "./tsconfig.json",
+    sourceType: "module",
   },
   plugins: [
     "@typescript-eslint",
     "eslint-plugin-import",
-    "prettier"
+    "prettier",
+    "@chainsafe/eslint-plugin-node"
   ],
   extends: [
     "eslint:recommended",
@@ -33,13 +35,13 @@ module.exports = {
     "prettier/prettier": "error",
     //doesnt work, it reports false errors
     "constructor-super": "off",
-    "@typescript-eslint/class-name-casing": "error",
+    //"@typescript-eslint/class-name-casing": "error",
     "@typescript-eslint/explicit-function-return-type": ["error", {
       "allowExpressions": true
     }],
     "@typescript-eslint/func-call-spacing": "error",
     "@typescript-eslint/indent": ["error", 2],
-    "@typescript-eslint/interface-name-prefix": ["error", "always"],
+    //"@typescript-eslint/interface-name-prefix": ["error", "always"],
     "@typescript-eslint/member-ordering": "error",
     "@typescript-eslint/no-explicit-any": "error",
     "@typescript-eslint/no-require-imports": "error",
@@ -47,7 +49,7 @@ module.exports = {
       "varsIgnorePattern": "^_",
       "argsIgnorePattern": "^_",
     }],
-    "@typescript-eslint/ban-ts-ignore": "warn",
+    "@typescript-eslint/ban-ts-comment": "warn",
     "@typescript-eslint/no-use-before-define": "off",
     "@typescript-eslint/semi": "error",
     "@typescript-eslint/type-annotation-spacing": "error",
@@ -76,7 +78,15 @@ module.exports = {
     "no-prototype-builtins": 0,
     "prefer-const": "error",
     "quotes": ["error", "double"],
-    "semi": "off"
+    "semi": "off",
+    "@chainsafe/node/file-extension-in-import": [
+      "error",
+      "always",
+      {
+        "esm": true
+      }
+    ],
+    "import/no-unresolved": "off",
   },
   "overrides": [
     {

.mocharc.yml

@@ -1,2 +1,6 @@
+extension: ["ts"]
 colors: true
-require: ts-node/register
+node-option:
+  - "experimental-specifier-resolution=node"
+  - "loader=ts-node/esm"
+

README.md

@@ -45,22 +45,22 @@ import {init, SecretKey, secretKeyToPublicKey, sign, verify} from "@chainsafe/bl
 
 ### Browser
 
-If you are in the browser, import from `/browser` to import directly the WASM version
+If you are in the browser, import from `/herumi` to import directly the WASM version
 
 ```ts
-import bls from "@chainsafe/bls/browser";
+import bls from "@chainsafe/bls/herumi";
 ```
 
 ### Native bindings only
 
-If you are in NodeJS, import from `/node` to skip browser specific code. Also install peer dependency `@chainsafe/blst` which has the native bindings
+If you are in NodeJS, import from `/blst-native` to skip browser specific code. Also install peer dependency `@chainsafe/blst` which has the native bindings
 
 ```bash
 yarn add @chainsafe/bls @chainsafe/blst
 ```
 
 ```ts
-import bls from "@chainsafe/bls/node";
+import bls from "@chainsafe/bls/blst-native";
 ```
 
 ### Native bindings + WASM fallback
@@ -86,7 +86,7 @@ The API is identical for all implementations.
 
 ## Benchmarks
 
-- `blst`: [src/blst](src/blst) (node.js-only, bindings to C via node-gyp)
+- `blst`: [src/blst-native](src/blst-native) (node.js-only, bindings to C via node-gyp)
 - `herumi`: [src/herumi](src/herumi) (node.js & browser, wasm)
 - `noble`: [noble-bls12-381](https://github.com/paulmillr/noble-bls12-381) (node.js & browser, pure JS)
 

benchmark/index.ts

@@ -1,7 +1,7 @@
-import {runBenchmark} from "./runner";
-import {runForAllImplementations} from "../test/switch";
-import {PublicKey, Signature} from "../src/interface";
-import {aggCount} from "./params";
+import {runBenchmark} from "./runner.js";
+import {runForAllImplementations} from "../test/switch.js";
+import {PublicKey, Signature} from "../src/interface.js";
+import {aggCount} from "./params.js";
 
 (async function () {
   await runForAllImplementations(async (bls, implementation) => {

benchmark/noble.ts

@@ -1,8 +1,8 @@
-import {runBenchmark} from "./runner";
-import {range, randomMessage} from "../test/util";
+import {runBenchmark} from "./runner.js";
+import {range, randomMessage} from "../test/util.js";
 import {generateRandomSecretKey} from "@chainsafe/bls-keygen";
 import * as noble from "noble-bls12-381";
-import {aggCount, runsNoble} from "./params";
+import {aggCount, runsNoble} from "./params.js";
 
 (async function () {
   {

benchmark/package.json

@@ -1,11 +1,12 @@
 {
   "name": "bls-libs-benchmark",
   "version": "1.0.0",
-  "main": "index.js",
+  "type": "module",
+  "exports": "./index.js",
   "license": "MIT",
   "scripts": {
-    "benchmark": "ts-node index",
-    "benchmark:all": "ts-node index && ts-node noble && ts-node verifyMultipleSignaturesSavings"
+    "benchmark": "ts-node-esm index",
+    "benchmark:all": "ts-node-esm index && ts-node-esm noble && ts-node-esm verifyMultipleSignaturesSavings"
   },
   "dependencies": {
     "noble-bls12-381": "^0.7.2"

benchmark/verifyMultipleSignaturesSavings.ts

@@ -1,5 +1,5 @@
-import {runForAllImplementations} from "../test/switch";
-import {range, randomMessage} from "../test/util";
+import {runForAllImplementations} from "../test/switch.js";
+import {range, randomMessage} from "../test/util.js";
 
 (async function () {
   console.log("verifyMultipleSignatures savings");

blst-native.d.ts

@@ -1 +0,0 @@
-export * from "./lib/blst";

blst-native.js

@@ -1 +0,0 @@
-module.exports = require("./lib/blst");

browser.d.ts

@@ -1 +0,0 @@
-export * from "./lib/herumi";

browser.js

@@ -1 +0,0 @@
-export * from "./lib/herumi";

herumi.d.ts

@@ -1 +0,0 @@
-export * from "./lib/herumi";

herumi.js

@@ -1 +0,0 @@
-module.exports = require("./lib/herumi");

karma.conf.cjs

@@ -1,5 +1,5 @@
 // eslint-disable-next-line @typescript-eslint/no-require-imports
-const webpackConfig = require("./webpack.config");
+const webpackConfig = require("./webpack.config.cjs");
 
 module.exports = function (config) {
   config.set({

node.d.ts

@@ -1 +0,0 @@
-export * from "./lib/blst";

node.js

@@ -1 +0,0 @@
-module.exports = require("./lib/blst");

package.json

@@ -2,8 +2,34 @@
   "name": "@chainsafe/bls",
   "version": "6.0.3",
   "description": "Implementation of bls signature verification for ethereum 2.0",
-  "main": "lib/index.js",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./lib/index.js"
+    },
+    "./register": {
+      "import": "./register.js"
+    },
+    "./types": {
+      "import": "./lib/types.js"
+    },
+    "./blst-native": {
+      "import": "./lib/blst-native/index.js"
+    },
+    "./herumi": {
+      "import": "./lib/herumi/index.js"
+    }
+  },
   "types": "lib/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "*",
+        "lib/*",
+        "lib/*/index"
+      ]
+    }
+  },
   "module": "./browser",
   "browser": "./browser",
   "homepage": "https://github.com/chainsafe/bls",
@@ -24,18 +50,19 @@
   ],
   "scripts": {
     "clean": "rm -rf lib && rm -rf dist && rm -f tsconfig.tsbuildinfo",
+    "check-build": "node -e \"(async function() { await import('./lib/index.js') })()\"",
     "build": "tsc --incremental --project tsconfig.build.json",
     "lint": "eslint --color --ext .ts src/ test/",
     "lint:fix": "yarn run lint --fix",
     "prepublishOnly": "yarn build",
-    "test:web": "karma start",
+    "test:web": "karma start karma.conf.cjs",
     "test:unit": "mocha 'test/unit/**/*.test.ts'",
     "test:coverage": "nyc --cache-dir .nyc_output/.cache -r lcov -e .ts mocha 'test/unit/**/*.test.ts' && nyc report",
     "test:spec": "mocha 'test/spec/**/*.test.ts'",
     "test": "yarn run test:unit && yarn run test:spec",
-    "download-test-cases": "ts-node test/downloadSpecTests.ts",
+    "download-test-cases": "ts-node-esm test/downloadSpecTests.ts",
     "coverage": "codecov -F bls",
-    "benchmark": "ts-node benchmark",
+    "benchmark": "ts-node-esm benchmark",
     "benchmark:all": "cd benchmark && yarn install && yarn benchmark:all"
   },
   "dependencies": {
@@ -45,14 +72,15 @@
   },
   "devDependencies": {
     "@chainsafe/blst": "^0.2.0",
+    "@chainsafe/eslint-plugin-node": "^11.2.3",
     "@chainsafe/lodestar-spec-test-util": "^0.18.0",
     "@types/chai": "^4.2.9",
     "@types/mocha": "^8.0.4",
     "@types/randombytes": "^2.0.0",
-    "@typescript-eslint/eslint-plugin": "^2.20.0",
-    "@typescript-eslint/parser": "^2.20.0",
-    "chai": "^4.2.0",
-    "eslint": "^6.8.0",
+    "@typescript-eslint/eslint-plugin": "^4.31.1",
+    "@typescript-eslint/parser": "^4.31.1",
+    "chai": "^4.3.6",
+    "eslint": "^7.14.0",
     "eslint-plugin-import": "^2.20.1",
     "eslint-plugin-prettier": "^3.1.4",
     "karma": "^4.4.1",
@@ -62,18 +90,19 @@
     "karma-mocha": "^1.3.0",
     "karma-spec-reporter": "^0.0.32",
     "karma-webpack": "^4.0.2",
-    "mocha": "^8.2.1",
+    "mocha": "^9.2.2",
     "nyc": "^15.0.0",
     "prettier": "^2.1.2",
-    "threads": "^1.6.3",
-    "ts-loader": "^6.2.1",
-    "ts-node": "^8.6.2",
-    "typescript": "^3.7.5",
+    "resolve-typescript-plugin": "^1.1.5",
+    "threads": "^1.7.0",
+    "ts-loader": "^8.3.0",
+    "ts-node": "^10.7.0",
+    "typescript": "^4.6.3",
     "webpack": "^4.30.0",
     "webpack-cli": "^3.3.2"
   },
   "resolutions": {
-    "mocha": "^8.2.1",
+    "mocha": "^9.2.2",
     "v8-profiler-next": "1.3.0"
   },
   "peerDependencies": {

register.js

@@ -1,5 +1,3 @@
-const {init} = require("./lib");
-
 // -----------------------------------------
 // To be used in NodeJS testing environments
 // node -r @chainsafe/bls/register
@@ -7,7 +5,7 @@ const {init} = require("./lib");
 
 // blst-native initialization is syncronous
 // Initialize bls here instead of in before() so it's available inside describe() blocks
-init("blst-native").catch((e) => {
+import("./lib/index.js").then(({init}) => init("blst-native")).catch((e) => {
   // eslint-disable-next-line no-console
   console.error(e);
   process.exit(1);

src/blst-native/index.ts

@@ -1,9 +1,9 @@
-import {SecretKey} from "./secretKey";
-import {PublicKey} from "./publicKey";
-import {Signature} from "./signature";
-import {IBls} from "../interface";
-import {functionalInterfaceFactory} from "../functional";
-export * from "../constants";
+import {SecretKey} from "./secretKey.js";
+import {PublicKey} from "./publicKey.js";
+import {Signature} from "./signature.js";
+import {IBls} from "../interface.js";
+import {functionalInterfaceFactory} from "../functional.js";
+export * from "../constants.js";
 
 export {SecretKey, PublicKey, Signature};
 

src/blst-native/publicKey.ts

@@ -1,7 +1,7 @@
 import * as blst from "@chainsafe/blst";
-import {EmptyAggregateError} from "../errors";
-import {bytesToHex, hexToBytes} from "../helpers";
-import {PointFormat, PublicKey as IPublicKey} from "../interface";
+import {EmptyAggregateError} from "../errors.js";
+import {bytesToHex, hexToBytes} from "../helpers/index.js";
+import {PointFormat, PublicKey as IPublicKey} from "../interface.js";
 
 export class PublicKey extends blst.PublicKey implements IPublicKey {
   constructor(value: ConstructorParameters<typeof blst.PublicKey>[0]) {

src/blst-native/secretKey.ts

@@ -1,10 +1,10 @@
 import * as blst from "@chainsafe/blst";
-import {bytesToHex, hexToBytes, isZeroUint8Array, randomBytes} from "../helpers";
-import {SECRET_KEY_LENGTH} from "../constants";
-import {SecretKey as ISecretKey} from "../interface";
-import {PublicKey} from "./publicKey";
-import {Signature} from "./signature";
-import {ZeroSecretKeyError} from "../errors";
+import {bytesToHex, hexToBytes, isZeroUint8Array, randomBytes} from "../helpers/index.js";
+import {SECRET_KEY_LENGTH} from "../constants.js";
+import {SecretKey as ISecretKey} from "../interface.js";
+import {PublicKey} from "./publicKey.js";
+import {Signature} from "./signature.js";
+import {ZeroSecretKeyError} from "../errors.js";
 
 export class SecretKey implements ISecretKey {
   readonly value: blst.SecretKey;

src/blst-native/signature.ts

@@ -1,8 +1,8 @@
 import * as blst from "@chainsafe/blst";
-import {bytesToHex, hexToBytes} from "../helpers";
-import {PointFormat, Signature as ISignature} from "../interface";
-import {PublicKey} from "./publicKey";
-import {EmptyAggregateError, ZeroSignatureError} from "../errors";
+import {bytesToHex, hexToBytes} from "../helpers/index.js";
+import {PointFormat, Signature as ISignature} from "../interface.js";
+import {PublicKey} from "./publicKey.js";
+import {EmptyAggregateError, ZeroSignatureError} from "../errors.js";
 
 export class Signature extends blst.Signature implements ISignature {
   constructor(value: ConstructorParameters<typeof blst.Signature>[0]) {

src/functional.ts

@@ -1,9 +1,10 @@
-import {IBls} from "./interface";
-import {validateBytes} from "./helpers";
-import {NotInitializedError} from "./errors";
+import {IBls} from "./interface.js";
+import {validateBytes} from "./helpers/index.js";
+import {NotInitializedError} from "./errors.js";
 
 // Returned type is enforced at each implementation's index
-// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+// eslint-disable-next-line max-len
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type,@typescript-eslint/explicit-module-boundary-types
 export function functionalInterfaceFactory({
   SecretKey,
   PublicKey,

src/helpers/index.ts

@@ -1,2 +1,2 @@
-export * from "./hex";
-export * from "./utils";
+export * from "./hex.js";
+export * from "./utils.js";

src/herumi/context.ts

@@ -1,6 +1,6 @@
 /* eslint-disable require-atomic-updates */
 import bls from "bls-eth-wasm";
-import {NotInitializedError} from "../errors";
+import {NotInitializedError} from "../errors.js";
 
 type Bls = typeof bls;
 let blsGlobal: Bls | null = null;
@@ -8,7 +8,6 @@ let blsGlobalPromise: Promise<void> | null = null;
 
 // Patch to fix multiVerify() calls on a browser with polyfilled NodeJS crypto
 declare global {
-  // eslint-disable-next-line @typescript-eslint/interface-name-prefix
   interface Window {
     msCrypto: typeof window["crypto"];
   }

src/herumi/index.ts

@@ -1,10 +1,10 @@
-import {SecretKey} from "./secretKey";
-import {PublicKey} from "./publicKey";
-import {Signature} from "./signature";
-import {init, destroy} from "./context";
-import {IBls} from "../interface";
-import {functionalInterfaceFactory} from "../functional";
-export * from "../constants";
+import {SecretKey} from "./secretKey.js";
+import {PublicKey} from "./publicKey.js";
+import {Signature} from "./signature.js";
+import {init, destroy} from "./context.js";
+import {IBls} from "../interface.js";
+import {functionalInterfaceFactory} from "../functional.js";
+export * from "../constants.js";
 
 export {SecretKey, PublicKey, Signature, init, destroy};
 

src/herumi/publicKey.ts

@@ -1,9 +1,9 @@
-import {PublicKeyType} from "bls-eth-wasm";
-import {getContext} from "./context";
-import {bytesToHex, hexToBytes, isZeroUint8Array} from "../helpers";
-import {PointFormat, PublicKey as IPublicKey} from "../interface";
-import {EmptyAggregateError, InvalidLengthError, ZeroPublicKeyError} from "../errors";
-import {PUBLIC_KEY_LENGTH_COMPRESSED, PUBLIC_KEY_LENGTH_UNCOMPRESSED} from "../constants";
+import type {PublicKeyType} from "bls-eth-wasm";
+import {getContext} from "./context.js";
+import {bytesToHex, hexToBytes, isZeroUint8Array} from "../helpers/index.js";
+import {PointFormat, PublicKey as IPublicKey} from "../interface.js";
+import {EmptyAggregateError, InvalidLengthError, ZeroPublicKeyError} from "../errors.js";
+import {PUBLIC_KEY_LENGTH_COMPRESSED, PUBLIC_KEY_LENGTH_UNCOMPRESSED} from "../constants.js";
 
 export class PublicKey implements IPublicKey {
   readonly value: PublicKeyType;

src/herumi/secretKey.ts

@@ -1,12 +1,12 @@
-import {SecretKeyType} from "bls-eth-wasm";
+import type {SecretKeyType} from "bls-eth-wasm";
 import {generateRandomSecretKey} from "@chainsafe/bls-keygen";
-import {SECRET_KEY_LENGTH} from "../constants";
-import {getContext} from "./context";
-import {PublicKey} from "./publicKey";
-import {Signature} from "./signature";
-import {bytesToHex, hexToBytes} from "../helpers";
-import {SecretKey as ISecretKey} from "../interface";
-import {InvalidLengthError, ZeroSecretKeyError} from "../errors";
+import {SECRET_KEY_LENGTH} from "../constants.js";
+import {getContext} from "./context.js";
+import {PublicKey} from "./publicKey.js";
+import {Signature} from "./signature.js";
+import {bytesToHex, hexToBytes} from "../helpers/index.js";
+import {SecretKey as ISecretKey} from "../interface.js";
+import {InvalidLengthError, ZeroSecretKeyError} from "../errors.js";
 
 export class SecretKey implements ISecretKey {
   readonly value: SecretKeyType;

src/herumi/signature.ts

@@ -1,10 +1,10 @@
-import {SignatureType, multiVerify} from "bls-eth-wasm";
-import {getContext} from "./context";
-import {PublicKey} from "./publicKey";
-import {bytesToHex, concatUint8Arrays, hexToBytes, isZeroUint8Array} from "../helpers";
-import {PointFormat, Signature as ISignature, CoordType} from "../interface";
-import {EmptyAggregateError, InvalidLengthError, InvalidOrderError} from "../errors";
-import {SIGNATURE_LENGTH_COMPRESSED, SIGNATURE_LENGTH_UNCOMPRESSED} from "../constants";
+import type {SignatureType} from "bls-eth-wasm";
+import {getContext} from "./context.js";
+import {PublicKey} from "./publicKey.js";
+import {bytesToHex, concatUint8Arrays, hexToBytes, isZeroUint8Array} from "../helpers/index.js";
+import {PointFormat, Signature as ISignature, CoordType} from "../interface.js";
+import {EmptyAggregateError, InvalidLengthError, InvalidOrderError} from "../errors.js";
+import {SIGNATURE_LENGTH_COMPRESSED, SIGNATURE_LENGTH_UNCOMPRESSED} from "../constants.js";
 
 export class Signature implements ISignature {
   readonly value: SignatureType;
@@ -53,7 +53,8 @@ export class Signature implements ISignature {
   }
 
   static verifyMultipleSignatures(sets: {publicKey: PublicKey; message: Uint8Array; signature: Signature}[]): boolean {
-    return multiVerify(
+    const context = getContext();
+    return context.multiVerify(
       sets.map((s) => s.publicKey.value),
       sets.map((s) => s.signature.value),
       sets.map((s) => s.message)

src/herumi/web.ts

@@ -1,4 +1,4 @@
-import {bls} from "./index";
+import {bls} from "./index.js";
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 (function (window: any) {

src/index.ts

@@ -1,27 +1,28 @@
-import {IBls} from "./interface";
-import {bls as blsHerumi} from "./herumi";
+import {IBls, Implementation} from "./interface.js";
 
-export type Implementation = "herumi" | "blst-native";
-
-export * from "./interface";
+export {IBls, Implementation, CoordType, PointFormat} from "./interface.js";
 
 // TODO: Use a Proxy for example to throw an error if it's not initialized yet
 export const bls: IBls = {} as IBls;
 export default bls;
 
+// Thanks https://github.com/iliakan/detect-node/blob/master/index.esm.js
+const isNode = Object.prototype.toString.call(typeof process !== "undefined" ? process : 0) === "[object process]";
+
 async function getImplementation(impl: Implementation = "herumi"): Promise<IBls> {
   switch (impl) {
-    case "herumi":
+    case "herumi": {
+      const blsHerumi = (await import("./herumi/index.js")).bls;
       await blsHerumi.init();
       return blsHerumi;
+    }
 
     case "blst-native":
       // Lazy import native bindings to prevent automatically importing binding.node files
-      if (typeof require !== "function") {
+      if (!isNode) {
         throw Error("blst-native is only supported in NodeJS");
       }
-      // eslint-disable-next-line @typescript-eslint/no-require-imports
-      return require("./blst").bls;
+      return (await import("./blst-native/index.js")).bls;
 
     default:
       throw new Error(`Unsupported implementation - ${impl}`);
@@ -34,14 +35,4 @@ export async function init(impl: Implementation): Promise<void> {
   // and the imported object is still undefined after calling init()
   const blsImpl = await getImplementation(impl);
   Object.assign(bls, blsImpl);
-  Object.assign(exports, blsImpl);
 }
-
-// Proxy named exports, will get set by `Object.assign(exports, blsImpl)`
-export declare let sign: IBls["sign"];
-export declare let aggregateSignatures: IBls["aggregateSignatures"];
-export declare let aggregatePublicKeys: IBls["aggregatePublicKeys"];
-export declare let verify: IBls["verify"];
-export declare let verifyAggregate: IBls["verifyAggregate"];
-export declare let verifyMultiple: IBls["verifyMultiple"];
-export declare let secretKeyToPublicKey: IBls["secretKeyToPublicKey"];

src/interface.ts

@@ -1,8 +1,8 @@
 export interface IBls {
   implementation: Implementation;
-  SecretKey: Omit<typeof SecretKey, "prototype">;
-  PublicKey: Omit<typeof PublicKey, "prototype">;
-  Signature: Omit<typeof Signature, "prototype">;
+  SecretKey: typeof SecretKey;
+  PublicKey: typeof PublicKey;
+  Signature: typeof Signature;
 
   sign(secretKey: Uint8Array, message: Uint8Array): Uint8Array;
   aggregatePublicKeys(publicKeys: Uint8Array[]): Uint8Array;
@@ -18,6 +18,8 @@ export interface IBls {
 }
 
 export declare class SecretKey {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private constructor(...value: any);
   static fromBytes(bytes: Uint8Array): SecretKey;
   static fromHex(hex: string): SecretKey;
   static fromKeygen(entropy?: Uint8Array): SecretKey;
@@ -28,6 +30,8 @@ export declare class SecretKey {
 }
 
 export declare class PublicKey {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private constructor(...value: any);
   /** @param type Only for impl `blst-native`. Defaults to `CoordType.jacobian` */
   static fromBytes(bytes: Uint8Array, type?: CoordType, validate?: boolean): PublicKey;
   static fromHex(hex: string): PublicKey;
@@ -38,6 +42,8 @@ export declare class PublicKey {
 }
 
 export declare class Signature {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private constructor(...value: any);
   /** @param type Only for impl `blst-native`. Defaults to `CoordType.affine`
    *  @param validate When using `herumi` implementation, signature validation is always on regardless of this flag. */
   static fromBytes(bytes: Uint8Array, type?: CoordType, validate?: boolean): Signature;

src/types.ts

@@ -0,0 +1 @@
+export type {PublicKey, SecretKey, Signature} from "./interface.js";

test/downloadSpecTests.ts

@@ -1,5 +1,5 @@
 import {downloadTests} from "@chainsafe/lodestar-spec-test-util";
-import {SPEC_TEST_VERSION, SPEC_TESTS_DIR, SPEC_TEST_TO_DOWNLOAD} from "./params";
+import {SPEC_TEST_VERSION, SPEC_TESTS_DIR, SPEC_TEST_TO_DOWNLOAD} from "./params.js";
 
 /* eslint-disable no-console */
 

test/params.ts

@@ -1,5 +1,8 @@
 import path from "path";
+import {fileURLToPath} from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 export const SPEC_TEST_VERSION = "v1.0.0";
-export const SPEC_TEST_TO_DOWNLOAD = ["general" as "general"];
+export const SPEC_TEST_TO_DOWNLOAD = ["general" as const];
 export const SPEC_TESTS_DIR = path.join(__dirname, "spec-tests");

test/spec/aggregate.test.ts

@@ -1,9 +1,9 @@
 import path from "path";
 import {describeDirectorySpecTest, InputType} from "@chainsafe/lodestar-spec-test-util";
-import {bytesToHex, hexToBytes} from "../../src/helpers";
-import {SPEC_TESTS_DIR} from "../params";
-import {describeForAllImplementations} from "../switch";
-import {EmptyAggregateError} from "../../src/errors";
+import {bytesToHex, hexToBytes} from "../../src/helpers/index.js";
+import {SPEC_TESTS_DIR} from "../params.js";
+import {describeForAllImplementations} from "../switch.js";
+import {EmptyAggregateError} from "../../src/errors.js";
 
 interface IAggregateSigsTestCase {
   data: {

test/spec/aggregate_verify.test.ts

@@ -1,8 +1,8 @@
 import path from "path";
 import {describeDirectorySpecTest, InputType} from "@chainsafe/lodestar-spec-test-util";
-import {hexToBytes} from "../../src/helpers";
-import {SPEC_TESTS_DIR} from "../params";
-import {describeForAllImplementations} from "../switch";
+import {hexToBytes} from "../../src/helpers/index.js";
+import {SPEC_TESTS_DIR} from "../params.js";
+import {describeForAllImplementations} from "../switch.js";
 
 interface IAggregateSigsVerifyTestCase {
   data: {

test/spec/fast_aggregate_verify.test.ts

@@ -1,8 +1,8 @@
 import path from "path";
 import {describeDirectorySpecTest, InputType} from "@chainsafe/lodestar-spec-test-util";
-import {hexToBytes} from "../../src/helpers";
-import {SPEC_TESTS_DIR} from "../params";
-import {describeForAllImplementations} from "../switch";
+import {hexToBytes} from "../../src/helpers/index.js";
+import {SPEC_TESTS_DIR} from "../params.js";
+import {describeForAllImplementations} from "../switch.js";
 import {CoordType} from "@chainsafe/blst";
 
 interface IAggregateSigsVerifyTestCase {

test/spec/sign.test.ts

@@ -1,9 +1,9 @@
 import path from "path";
 import {describeDirectorySpecTest, InputType} from "@chainsafe/lodestar-spec-test-util";
-import {bytesToHex, hexToBytes} from "../../src/helpers";
-import {SPEC_TESTS_DIR} from "../params";
-import {describeForAllImplementations} from "../switch";
-import {ZeroSecretKeyError} from "../../src/errors";
+import {bytesToHex, hexToBytes} from "../../src/helpers/index.js";
+import {SPEC_TESTS_DIR} from "../params.js";
+import {describeForAllImplementations} from "../switch.js";
+import {ZeroSecretKeyError} from "../../src/errors.js";
 
 interface ISignMessageTestCase {
   data: {

test/spec/verify.test.ts

@@ -1,8 +1,8 @@
 import path from "path";
 import {describeDirectorySpecTest, InputType} from "@chainsafe/lodestar-spec-test-util";
-import {hexToBytes} from "../../src/helpers";
-import {SPEC_TESTS_DIR} from "../params";
-import {describeForAllImplementations} from "../switch";
+import {hexToBytes} from "../../src/helpers/index.js";
+import {SPEC_TESTS_DIR} from "../params.js";
+import {describeForAllImplementations} from "../switch.js";
 
 interface IVerifyTestCase {
   data: {

test/switch.ts

@@ -1,6 +1,6 @@
-import blst from "../src/blst";
-import herumi from "../src/herumi";
-import {IBls} from "../src/interface";
+import blst from "../src/blst-native/index.js";
+import herumi from "../src/herumi/index.js";
+import {IBls} from "../src/interface.js";
 
 export type Implementation = "blst" | "herumi";
 

test/unit-web/run-web-implementation.test.ts

@@ -1,4 +1,4 @@
-import herumi from "../../src/herumi";
+import herumi from "../../src/herumi/index.js";
 import {runSecretKeyTests} from "../unit/secretKey.test";
 import {runPublicKeyTests} from "../unit/publicKey.test";
 import {runIndexTests} from "../unit/index.test";

test/unit/helpers/bytes.test.ts

@@ -1,6 +1,6 @@
 import {expect} from "chai";
-import {concatUint8Arrays, isZeroUint8Array} from "../../../src/helpers/utils";
-import {hexToBytesNode} from "../../util";
+import {concatUint8Arrays, isZeroUint8Array} from "../../../src/helpers/utils.js";
+import {hexToBytesNode} from "../../util.js";
 
 describe("helpers / bytes", () => {
   describe("isZeroUint8Array", () => {

test/unit/helpers/hex.test.ts

@@ -1,6 +1,6 @@
 import {expect} from "chai";
-import {hexToBytes, bytesToHex} from "../../../src/helpers/hex";
-import {hexToBytesNode} from "../../util";
+import {hexToBytes, bytesToHex} from "../../../src/helpers/hex.js";
+import {hexToBytesNode} from "../../util.js";
 
 describe("helpers / hex", () => {
   const testCases: {id: string; hex: string}[] = [

test/unit/index-named-exports.test.ts

@@ -1,7 +1,8 @@
 import {expect} from "chai";
-import {SecretKey, PublicKey, Signature, init, bls} from "../../src";
+import {init, bls} from "../../src/index.js";
+import type {SecretKey, PublicKey, Signature} from "../../src/types.js";
 
-describe("index named exports", () => {
+describe("types named exports", () => {
   it("Classes and methods should be defined", async () => {
     await init("herumi");
 
@@ -12,7 +13,7 @@ describe("index named exports", () => {
       return sig.verify(pk, msg);
     }
 
-    const sk = SecretKey.fromKeygen();
+    const sk = bls.SecretKey.fromKeygen();
     const msg = new Uint8Array(32);
     const sig = sk.sign(msg);
     const pk = sk.toPublicKey();

test/unit/index.test.ts

@@ -1,8 +1,8 @@
 import {expect} from "chai";
-import {IBls, PointFormat} from "../../src/interface";
-import {getN, randomMessage, hexToBytesNode} from "../util";
-import {hexToBytes} from "../../src/helpers";
-import {maliciousVerifyMultipleSignaturesData} from "../data/malicious-signature-test-data";
+import {IBls, PointFormat} from "../../src/interface.js";
+import {getN, randomMessage, hexToBytesNode} from "../util.js";
+import {hexToBytes} from "../../src/helpers/index.js";
+import {maliciousVerifyMultipleSignaturesData} from "../data/malicious-signature-test-data.js";
 
 export function runIndexTests(bls: IBls): void {
   // eslint-disable-next-line @typescript-eslint/explicit-function-return-type

test/unit/multithread/naive/chunkify.test.ts

@@ -1,5 +1,5 @@
 import {expect} from "chai";
-import {chunkify} from "./utils";
+import {chunkify} from "./utils.js";
 
 describe("chunkify", () => {
   const arr = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 13, 14, 15];

test/unit/multithread/naive/index.ts

@@ -1,6 +1,7 @@
 import {spawn, Pool, Worker, Thread} from "threads";
-import {Implementation, PointFormat, PublicKey, Signature} from "../../../../src";
-import {WorkerApi} from "./worker";
+import {Implementation, PointFormat} from "../../../../src/index.js";
+import {PublicKey, Signature} from "../../../../src/types.js";
+import {WorkerApi} from "./worker.js";
 
 type ThreadType = {
   [K in keyof WorkerApi]: (...args: Parameters<WorkerApi[K]>) => Promise<ReturnType<WorkerApi[K]>>;

test/unit/multithread/naive/naive.test.ts

@@ -1,6 +1,7 @@
 import {expect} from "chai";
-import {IBls, PublicKey, Signature} from "../../../../src";
-import {BlsMultiThreadNaive} from "./index";
+import {IBls} from "../../../../src/index.js";
+import type {PublicKey, Signature} from "../../../../src/types.js";
+import {BlsMultiThreadNaive} from "./index.js";
 
 export function runMultithreadTests(bls: IBls): void {
   describe("bls pool naive", function () {

test/unit/multithread/naive/worker.ts

@@ -1,5 +1,5 @@
 import {expose} from "threads/worker";
-import {bls, init, CoordType, Implementation} from "../../../../src";
+import {bls, init, CoordType, Implementation} from "../../../../src/index.js";
 
 export type WorkerApi = typeof workerApi;
 

test/unit/publicKey.test.ts

@@ -1,5 +1,5 @@
 import {expect} from "chai";
-import {IBls} from "../../src/interface";
+import {IBls} from "../../src/interface.js";
 
 export function runPublicKeyTests(bls: IBls): void {
   describe("PublicKey", () => {

test/unit/run-all-implementations.test.ts

@@ -2,7 +2,7 @@ import {runSecretKeyTests} from "./secretKey.test";
 import {runPublicKeyTests} from "./publicKey.test";
 import {runIndexTests} from "./index.test";
 import {runMultithreadTests} from "./multithread/naive/naive.test";
-import {describeForAllImplementations} from "../switch";
+import {describeForAllImplementations} from "../switch.js";
 
 // Import test's bls lib lazily to prevent breaking test with Karma
 describeForAllImplementations((bls) => {

test/unit/secretKey.test.ts

@@ -1,5 +1,5 @@
 import {expect} from "chai";
-import {IBls} from "../../src/interface";
+import {IBls} from "../../src/interface.js";
 
 export function runSecretKeyTests(bls: IBls): void {
   describe("SecretKey", () => {

test/util.ts

@@ -1,4 +1,4 @@
-import {randomBytes} from "../src/helpers";
+import {randomBytes} from "../src/helpers/index.js";
 
 export function randomMessage(): Uint8Array {
   return randomBytes(32);

tsconfig.json

@@ -3,7 +3,8 @@
   "compilerOptions": {
     "outDir": "lib",
     "target": "es2019",
-    "module": "commonjs",
+    "module": "ES2020",
+    "moduleResolution": "Node",
     "pretty": true,
     "lib": ["esnext.bigint", "DOM"],
     "typeRoots": ["./node_modules/@types"],

webpack.config.cjs

@@ -1,3 +1,5 @@
+const ResolveTypeScriptPlugin = require("resolve-typescript-plugin");
+
 module.exports = {
   entry: "./src/index.ts",
   mode: "production",
@@ -9,9 +11,10 @@ module.exports = {
   },
   resolve: {
     extensions: [".ts", ".js"],
+    plugins: [new ResolveTypeScriptPlugin()]
   },
   module: {
-    rules: [{test: /\.ts$/, use: {loader: "ts-loader", options: {transpileOnly: true}}}],
+    rules: [{test: /\.(ts|js)$/, use: {loader: "ts-loader", options: {transpileOnly: true}}}],
   },
   optimization: {
     // Disable minification for better debugging on Karma tests