Fix Set version to remove leading v

So far if no optimization level was specified, optimizations for
execution time were applied. However, we currently are a bit limited on
code size. Add to that, this setting is not available in solc and people
generally ignore the docs, generating a lot of support requests.

Signed-off-by: Cyrill Leutwiler <bigcyrill@hotmail.com>

.cargo/config.toml

@@ -10,8 +10,8 @@ rustflags = [
     "-Clink-arg=-sWASM_ASYNC_COMPILATION=0",
     "-Clink-arg=-sDYNAMIC_EXECUTION=0",
     "-Clink-arg=-sALLOW_TABLE_GROWTH=1",
-    "-Clink-arg=--js-library=js/embed/soljson_interface.js",
+    "-Clink-arg=--js-library=js/emscripten/embed/soljson_interface.js",
-    "-Clink-arg=--pre-js=js/embed/pre.js",
+    "-Clink-arg=--pre-js=js/emscripten/embed/pre.js",
     "-Clink-arg=-sSTACK_SIZE=128kb",
     "-Clink-arg=-sNODEJS_CATCH_EXIT=0"
 ]

.github/workflows/release-llvm.yml

@@ -87,6 +87,11 @@ jobs:
         run: |
           brew install ninja
 
+      - name: Install Dependencies
+        if: ${{ matrix.host == 'windows' }}
+        run: |
+          choco install ninja
+
       - name: Install LLVM Builder
         run: |
           cargo install --path crates/llvm-builder

.github/workflows/release.yml

@@ -286,3 +286,49 @@ jobs:
             resolc.wasm
             resolc_web.js
             checksums.txt
+
+  npm-release:
+    needs: [create-release]
+    runs-on: macos-14
+    environment: tags
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          merge-multiple: true
+
+      - name: Set Up Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: "20"
+
+      - run: npm ci -w js/resolc
+
+      - name: Build
+        run: |
+          cp -f resolc.{wasm,js} js/resolc/src/resolc
+          npm -w js/resolc run build
+
+      - name: Set version
+        run: |
+          VERSION="${{ github.event.release.tag_name }}"
+          STRIPPED_VERSION="${VERSION#v}"
+          npm -w js/resolc version --no-git-tag-version "$STRIPPED_VERSION"
+
+      - name: npm pack
+        run: npm -w js/resolc pack
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: npm_package
+          path: "parity-resolc-*.tgz"
+
+      - uses: octokit/request-action@bbedc70b1981e610d89f1f8de88311a1fc02fb83
+        with:
+          route: POST /repos/paritytech/npm_publish_automation/actions/workflows/publish.yml/dispatches
+          ref: main
+          inputs: '${{ format(''{{ "artifact_name": "npm_package", "repo": "{0}", "run_id": "{1}" }}'', github.repository, github.run_id) }}'
+        env:
+          GITHUB_TOKEN: ${{ secrets.NPM_PUBLISH_AUTOMATION_TOKEN }}

.github/workflows/test-wasm.yml

@@ -86,13 +86,18 @@ jobs:
       - name: Install Node Packages
         run: npm install
 
-      - name: Run Playwright tests
+      - name: Test emscripten
-        run: |
-          cd js
-          npx playwright install --with-deps
-          npx playwright test
-
-      - name: Test revive
         run: |
           echo "Running tests for ${{ matrix.os }}"
           npm run test:wasm
+
+      - name: Test @parity/resolc
+        run: |
+          echo "Running tests for ${{ matrix.os }}"
+          npm run -w js/resolc test
+
+      - name: Run Playwright tests
+        run: |
+          cd js/emscripten
+          npx playwright install --with-deps
+          npx playwright test

.gitignore

@@ -1,4 +1,5 @@
 /target
+/js/resolc/dist
 target-llvm
 *.dot
 .vscode/
@@ -11,7 +12,6 @@ target-llvm
 node_modules
 artifacts
 tmp
-package-lock.json
 /*.html
 /build
 soljson.js

.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "semi": false,
+  "singleQuote": true
+}

CHANGELOG.md

@@ -6,9 +6,16 @@ This is a development pre-release.
 
 Supported `polkadot-sdk` rev:`c29e72a8628835e34deb6aa7db9a78a2e4eabcee`
 
+## v0.1.0
+
+This is a development pre-release.
+
+Supported `polkadot-sdk` rev:`c29e72a8628835e34deb6aa7db9a78a2e4eabcee`
+
 ### Added
 
 ### Changed
+- By default, heavy size optimizations are applied.
 
 ### Fixed
 

Makefile

@@ -92,7 +92,4 @@ clean:
 	rm -rf node_modules ; \
 	rm -rf crates/solidity/src/tests/cli-tests/artifacts ; \
 	cargo uninstall revive-solidity ; \
-	cargo uninstall revive-llvm-builder ; \
+	cargo uninstall revive-llvm-builder ;
-	rm -f package-lock.json ; \
-	rm -rf js/dist ; \
-	rm -f js/src/resolc.{wasm,js}

crates/llvm-builder/src/builtins.rs

@@ -117,13 +117,7 @@ pub fn build(
     log::info!("building compiler-rt for rv64emac");
 
     crate::utils::check_presence("cmake")?;
-
+    crate::utils::check_presence("ninja")?;
-    let generator = if cfg!(target_os = "windows") {
-        "Visual Studio 17 2022"
-    } else {
-        crate::utils::check_presence("ninja")?;
-        "Ninja"
-    };
 
     let llvm_module_compiler_rt = crate::LLVMPath::llvm_module_compiler_rt()?;
     let llvm_compiler_rt_build = crate::LLVMPath::llvm_build_compiler_rt()?;
@@ -136,7 +130,7 @@ pub fn build(
                 "-B",
                 llvm_compiler_rt_build.to_string_lossy().as_ref(),
                 "-G",
-                generator,
+                "Ninja",
             ])
             .args(CMAKE_STATIC_ARGS)
             .args(cmake_dynamic_args(build_type, target_env)?)

crates/llvm-context/src/optimizer/settings/mod.rs

@@ -234,7 +234,7 @@ impl TryFrom<&SolcStandardJsonInputSettingsOptimizer> for Settings {
     fn try_from(value: &SolcStandardJsonInputSettingsOptimizer) -> Result<Self, Self::Error> {
         let mut result = match value.mode {
             Some(mode) => Self::try_from_cli(mode)?,
-            None => Self::cycles(),
+            None => Self::size(),
         };
         if value.fallback_to_optimizing_for_size.unwrap_or_default() {
             result.enable_fallback_to_size();

crates/solidity/src/resolc/main.rs

@@ -129,7 +129,7 @@ fn main_inner() -> anyhow::Result<()> {
 
     let mut optimizer_settings = match arguments.optimization {
         Some(mode) => revive_llvm_context::OptimizerSettings::try_from_cli(mode)?,
-        None => revive_llvm_context::OptimizerSettings::cycles(),
+        None => revive_llvm_context::OptimizerSettings::size(),
     };
     if arguments.fallback_to_optimizing_for_size {
         optimizer_settings.enable_fallback_to_size();

crates/solidity/src/tests/cli-tests/src/entities.ts

@@ -1,19 +1,33 @@
-import * as path from 'path';
+import * as path from 'path'
 
-const outputDir = 'artifacts';
+const outputDir = 'artifacts'
-const binExtension = ':C.pvm';
+const binExtension = ':C.pvm'
-const asmExtension = ':C.pvmasm';
+const asmExtension = ':C.pvmasm'
-const llvmExtension = '.ll';
+const llvmExtension = '.ll'
-const contractSolFilename = 'contract.sol';
+const contractSolFilename = 'contract.sol'
-const contractYulFilename = 'contract.yul';
+const contractYulFilename = 'contract.yul'
-const contractOptimizedLLVMFilename = contractSolFilename + '.C.optimized';
+const contractOptimizedLLVMFilename = contractSolFilename + '.C.optimized'
-const contractUnoptimizedLLVMFilename = contractSolFilename + '.C.unoptimized';
+const contractUnoptimizedLLVMFilename = contractSolFilename + '.C.unoptimized'
-const pathToOutputDir = path.join(__dirname, '..', outputDir);
+const pathToOutputDir = path.join(__dirname, '..', outputDir)
-const pathToContracts = path.join(__dirname, '..', 'src', 'contracts');
+const pathToContracts = path.join(__dirname, '..', 'src', 'contracts')
-const pathToBasicYulContract = path.join(pathToContracts, 'yul', contractYulFilename);
+const pathToBasicYulContract = path.join(
-const pathToBasicSolContract = path.join(pathToContracts, 'solidity', contractSolFilename);
+  pathToContracts,
-const pathToSolBinOutputFile = path.join(pathToOutputDir, contractSolFilename + binExtension);
+  'yul',
-const pathToSolAsmOutputFile = path.join(pathToOutputDir, contractSolFilename + asmExtension);
+  contractYulFilename
+)
+const pathToBasicSolContract = path.join(
+  pathToContracts,
+  'solidity',
+  contractSolFilename
+)
+const pathToSolBinOutputFile = path.join(
+  pathToOutputDir,
+  contractSolFilename + binExtension
+)
+const pathToSolAsmOutputFile = path.join(
+  pathToOutputDir,
+  contractSolFilename + asmExtension
+)
 
 export const paths = {
   outputDir: outputDir,
@@ -30,4 +44,4 @@ export const paths = {
   pathToBasicYulContract: pathToBasicYulContract,
   pathToSolBinOutputFile: pathToSolBinOutputFile,
   pathToSolAsmOutputFile: pathToSolAsmOutputFile,
-};
+}

crates/solidity/src/tests/cli-tests/src/helper.ts

@@ -1,44 +1,51 @@
-import * as shell from 'shelljs';
+import * as shell from 'shelljs'
-import * as fs from 'fs';
+import * as fs from 'fs'
-import { spawnSync } from 'child_process';
+import { spawnSync } from 'child_process'
 
 interface CommandResult {
-    output: string;
+  output: string
-    exitCode: number;
+  exitCode: number
 }
 
-export const executeCommand = (command: string, stdin?: string): CommandResult => {
+export const executeCommand = (
-    if (stdin) {
+  command: string,
-        const process = spawnSync(command, [], {
+  stdin?: string
-            input: stdin,
+): CommandResult => {
-            shell: true,
+  if (stdin) {
-            encoding: 'utf8',
+    const process = spawnSync(command, [], {
-            maxBuffer: 30 * 1024 * 1024
+      input: stdin,
-        });
+      shell: true,
+      encoding: 'utf8',
+      maxBuffer: 30 * 1024 * 1024,
+    })
 
-        return {
-            exitCode: process.status || 0,
-            output: (process.stdout || process.stderr || '').toString()
-        };
-    }
-
-    const result = shell.exec(command, { silent: true, async: false });
     return {
-        exitCode: result.code,
+      exitCode: process.status || 0,
-        output: result.stdout || result.stderr || ''
+      output: (process.stdout || process.stderr || '').toString(),
-    };
+    }
-};
+  }
+
+  const result = shell.exec(command, { silent: true, async: false })
+  return {
+    exitCode: result.code,
+    output: result.stdout || result.stderr || '',
+  }
+}
 
 export const isFolderExist = (folder: string): boolean => {
-    return shell.test('-d', folder);
+  return shell.test('-d', folder)
-};
+}
 
-export const isFileExist = (pathToFileDir: string, fileName: string, fileExtension: string): boolean => {
+export const isFileExist = (
-    return shell.ls(pathToFileDir).stdout.includes(fileName + fileExtension);
+  pathToFileDir: string,
-};
+  fileName: string,
+  fileExtension: string
+): boolean => {
+  return shell.ls(pathToFileDir).stdout.includes(fileName + fileExtension)
+}
 
 export const isFileEmpty = (file: string): boolean => {
-    if (fs.existsSync(file)) {
+  if (fs.existsSync(file)) {
-        return (fs.readFileSync(file).length === 0);
+    return fs.readFileSync(file).length === 0
-    }
+  }
-};
+}

crates/solidity/src/tests/cli-tests/tests/asm.test.ts

@@ -1,43 +1,44 @@
-import {executeCommand} from "../src/helper";
+import { executeCommand } from '../src/helper'
-import { paths } from '../src/entities';
+import { paths } from '../src/entities'
-
 
 //id1746
-describe("Run with --asm by default", () => {
+describe('Run with --asm by default', () => {
-  const command = `resolc ${paths.pathToBasicSolContract} --asm`;
+  const command = `resolc ${paths.pathToBasicSolContract} --asm`
-  const result = executeCommand(command);
+  const result = executeCommand(command)
-  const commandInvalid = 'resolc --asm';
+  const commandInvalid = 'resolc --asm'
-  const resultInvalid = executeCommand(commandInvalid);
+  const resultInvalid = executeCommand(commandInvalid)
 
-  it("Valid command exit code = 0", () => {
+  it('Valid command exit code = 0', () => {
-    expect(result.exitCode).toBe(0);
+    expect(result.exitCode).toBe(0)
-  });
+  })
 
-  it("--asm output is presented", () => {
+  it('--asm output is presented', () => {
-    const expectedPatterns = [/(deploy)/i, /(call)/i, /(seal_return)/i];
+    const expectedPatterns = [/(deploy)/i, /(call)/i, /(seal_return)/i]
 
     for (const pattern of expectedPatterns) {
-      expect(result.output).toMatch(pattern);
+      expect(result.output).toMatch(pattern)
     }
-  });
+  })
 
-  it("solc exit code == resolc exit code", () => {
+  it('solc exit code == resolc exit code', () => {
-    const command = `solc ${paths.pathToBasicSolContract} --asm`;
+    const command = `solc ${paths.pathToBasicSolContract} --asm`
-    const solcResult = executeCommand(command);
+    const solcResult = executeCommand(command)
-    expect(solcResult.exitCode).toBe(result.exitCode);
+    expect(solcResult.exitCode).toBe(result.exitCode)
-  });
+  })
 
-  it("run invalid: resolc --asm", () => {
+  it('run invalid: resolc --asm', () => {
-    expect(resultInvalid.output).toMatch(/(No input sources specified|Compilation aborted)/i);
+    expect(resultInvalid.output).toMatch(
-  });
+      /(No input sources specified|Compilation aborted)/i
+    )
+  })
 
-  it("Invalid command exit code = 1", () => {
+  it('Invalid command exit code = 1', () => {
-    expect(resultInvalid.exitCode).toBe(1);
+    expect(resultInvalid.exitCode).toBe(1)
-  });
+  })
 
-  it("Invalid solc exit code == Invalid resolc exit code", () => {
+  it('Invalid solc exit code == Invalid resolc exit code', () => {
-    const command = 'solc --asm';
+    const command = 'solc --asm'
-    const solcResult = executeCommand(command);
+    const solcResult = executeCommand(command)
-    expect(solcResult.exitCode).toBe(resultInvalid.exitCode);
+    expect(solcResult.exitCode).toBe(resultInvalid.exitCode)
-  });
+  })
-});
+})

crates/solidity/src/tests/cli-tests/tests/common.test.ts

@@ -1,191 +1,241 @@
-import { executeCommand, isFolderExist, isFileExist, isFileEmpty } from "../src/helper";
+import {
-import { paths } from '../src/entities';
+  executeCommand,
-import * as shell from 'shelljs';
+  isFolderExist,
-import * as path from 'path';
+  isFileExist,
-
+  isFileEmpty,
+} from '../src/helper'
+import { paths } from '../src/entities'
+import * as shell from 'shelljs'
+import * as path from 'path'
 
 //id1762
-describe("Run resolc without any options", () => {
+describe('Run resolc without any options', () => {
-    const command = 'resolc';
+  const command = 'resolc'
-    const result = executeCommand(command);
+  const result = executeCommand(command)
 
-    it("Info with help is presented", () => {
+  it('Info with help is presented', () => {
-        expect(result.output).toMatch(/(Usage: resolc)/i);
+    expect(result.output).toMatch(/(Usage: resolc)/i)
-    });
+  })
 
-    it("Exit code = 1", () => {
+  it('Exit code = 1', () => {
-        expect(result.exitCode).toBe(1);
+    expect(result.exitCode).toBe(1)
-    });
+  })
-
-    it("solc exit code == resolc exit code", () => {
-        const command = 'solc';
-        const solcResult = executeCommand(command);
-        expect(solcResult.exitCode).toBe(result.exitCode);
-    });
-});
 
+  it('solc exit code == resolc exit code', () => {
+    const command = 'solc'
+    const solcResult = executeCommand(command)
+    expect(solcResult.exitCode).toBe(result.exitCode)
+  })
+})
 
 //#1713
-describe("Default run a command from the help", () => {
+describe('Default run a command from the help', () => {
+  const command = `resolc ${paths.pathToBasicSolContract} --overwrite -O3 --bin --output-dir "${paths.pathToOutputDir}"` // potential issue on resolc with full path on Windows cmd
+  const result = executeCommand(command)
 
-    const command = `resolc ${paths.pathToBasicSolContract} --overwrite -O3 --bin --output-dir "${paths.pathToOutputDir}"`; // potential issue on resolc with full path on Windows cmd
+  it('Compiler run successful', () => {
-    const result = executeCommand(command);
+    expect(result.output).toMatch(/(Compiler run successful.)/i)
-
+  })
-    it("Compiler run successful", () => {
+  it('Exit code = 0', () => {
-        expect(result.output).toMatch(/(Compiler run successful.)/i);
+    expect(result.exitCode).toBe(0)
-    });
+  })
-    it("Exit code = 0", () => {
+  it('Output dir is created', () => {
-        expect(result.exitCode).toBe(0);
+    expect(isFolderExist(paths.pathToOutputDir)).toBe(true)
-    });
+  })
-    it("Output dir is created", () => {
+  xit('Output file is created', () => {
-        expect(isFolderExist(paths.pathToOutputDir)).toBe(true);
+    // a bug on windows
-    });
+    expect(
-    xit("Output file is created", () => { // a bug on windows
+      isFileExist(
-        expect(isFileExist(paths.pathToOutputDir, paths.contractSolFilename, paths.binExtension)).toBe(true);
+        paths.pathToOutputDir,
-    });
+        paths.contractSolFilename,
-    it("the output file is not empty", () => {
+        paths.binExtension
-        expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false);
+      )
-    });
+    ).toBe(true)
-    it("No 'Error'/'Warning'/'Fail' in the output", () => {
+  })
-        expect(result.output).not.toMatch(/([Ee]rror|[Ww]arning|[Ff]ail)/i);
+  it('the output file is not empty', () => {
-    });
+    expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false)
-});
+  })
+  it("No 'Error'/'Warning'/'Fail' in the output", () => {
+    expect(result.output).not.toMatch(/([Ee]rror|[Ww]arning|[Ff]ail)/i)
+  })
+})
 
 //#1818
-describe("Default run a command from the help", () => {
+describe('Default run a command from the help', () => {
+  const command = `resolc ${paths.pathToBasicSolContract} --overwrite -O3 --bin --asm --output-dir "${paths.pathToOutputDir}"` // potential issue on resolc with full path on Windows cmd
+  const result = executeCommand(command)
 
-    const command = `resolc ${paths.pathToBasicSolContract} --overwrite -O3 --bin --asm --output-dir "${paths.pathToOutputDir}"`; // potential issue on resolc with full path on Windows cmd
+  it('Compiler run successful', () => {
-    const result = executeCommand(command);
+    expect(result.output).toMatch(/(Compiler run successful.)/i)
+  })
+  it('Exit code = 0', () => {
+    expect(result.exitCode).toBe(0)
+  })
+  it('Output dir is created', () => {
+    expect(isFolderExist(paths.pathToOutputDir)).toBe(true)
+  })
+  xit('Output files are created', () => {
+    // a bug on windows
+    expect(
+      isFileExist(
+        paths.pathToOutputDir,
+        paths.contractSolFilename,
+        paths.binExtension
+      )
+    ).toBe(true)
+    expect(
+      isFileExist(
+        paths.pathToOutputDir,
+        paths.contractSolFilename,
+        paths.asmExtension
+      )
+    ).toBe(true)
+  })
+  it('the output files are not empty', () => {
+    expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false)
+    expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false)
+  })
+  it("No 'Error'/'Warning'/'Fail' in the output", () => {
+    expect(result.output).not.toMatch(/([Ee]rror|[Ww]arning|[Ff]ail)/i)
+  })
+})
 
-    it("Compiler run successful", () => {
+describe('Run resolc with source debug information', () => {
-        expect(result.output).toMatch(/(Compiler run successful.)/i);
+  const commands = [
-    });
+    `resolc -g ${paths.pathToBasicSolContract} --overwrite --bin --asm --output-dir "${paths.pathToOutputDir}"`,
-    it("Exit code = 0", () => {
+    `resolc --disable-solc-optimizer -g ${paths.pathToBasicSolContract} --overwrite --bin --asm --output-dir "${paths.pathToOutputDir}"`,
-        expect(result.exitCode).toBe(0);
+  ] // potential issue on resolc with full path on Windows cmd`;
-    });
-    it("Output dir is created", () => {
-        expect(isFolderExist(paths.pathToOutputDir)).toBe(true);
-    });
-    xit("Output files are created", () => { // a bug on windows
-        expect(isFileExist(paths.pathToOutputDir, paths.contractSolFilename, paths.binExtension)).toBe(true);
-        expect(isFileExist(paths.pathToOutputDir, paths.contractSolFilename, paths.asmExtension)).toBe(true);
-    });
-    it("the output files are not empty", () => {
-        expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false);
-        expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false);
-    });
-    it("No 'Error'/'Warning'/'Fail' in the output", () => {
-        expect(result.output).not.toMatch(/([Ee]rror|[Ww]arning|[Ff]ail)/i);
-    });
-});
 
-describe("Run resolc with source debug information", () => {
+  for (var idx in commands) {
-    const commands = [
+    const command = commands[idx]
-        `resolc -g ${paths.pathToBasicSolContract} --overwrite --bin --asm --output-dir "${paths.pathToOutputDir}"`,
+    const result = executeCommand(command)
-        `resolc --disable-solc-optimizer -g ${paths.pathToBasicSolContract} --overwrite --bin --asm --output-dir "${paths.pathToOutputDir}"`
-    ]; // potential issue on resolc with full path on Windows cmd`;
 
-    for (var idx in commands) {
+    it('Compiler run successful', () => {
-        const command = commands[idx];
+      expect(result.output).toMatch(/(Compiler run successful.)/i)
-        const result = executeCommand(command);
+    })
+    it('Exit code = 0', () => {
+      expect(result.exitCode).toBe(0)
+    })
+    it('Output dir is created', () => {
+      expect(isFolderExist(paths.pathToOutputDir)).toBe(true)
+    })
+    it('Output files are created', () => {
+      // a bug on windows
+      expect(
+        isFileExist(
+          paths.pathToOutputDir,
+          paths.contractSolFilename,
+          paths.binExtension
+        )
+      ).toBe(true)
+      expect(
+        isFileExist(
+          paths.pathToOutputDir,
+          paths.contractSolFilename,
+          paths.asmExtension
+        )
+      ).toBe(true)
+    })
+    it('the output files are not empty', () => {
+      expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false)
+      expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false)
+    })
+    it("No 'Error'/'Fail' in the output", () => {
+      expect(result.output).not.toMatch(/([Ee]rror|[Ff]ail)/i)
+    })
+  }
+})
 
-        it("Compiler run successful", () => {
+describe('Run resolc with source debug information, check LLVM debug-info', () => {
-            expect(result.output).toMatch(/(Compiler run successful.)/i);
+  const commands = [
-        });
+    `resolc -g ${paths.pathToBasicSolContract} --overwrite --debug-output-dir="${paths.pathToOutputDir}"`,
-        it("Exit code = 0", () => {
+    `resolc -g --disable-solc-optimizer ${paths.pathToBasicSolContract} --overwrite --debug-output-dir="${paths.pathToOutputDir}"`,
-            expect(result.exitCode).toBe(0);
+  ] // potential issue on resolc with full path on Windows cmd`;
-        });
-        it("Output dir is created", () => {
-            expect(isFolderExist(paths.pathToOutputDir)).toBe(true);
-        });
-        it("Output files are created", () => { // a bug on windows
-            expect(isFileExist(paths.pathToOutputDir, paths.contractSolFilename, paths.binExtension)).toBe(true);
-            expect(isFileExist(paths.pathToOutputDir, paths.contractSolFilename, paths.asmExtension)).toBe(true);
-        });
-        it("the output files are not empty", () => {
-            expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false);
-            expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false);
-        });
-        it("No 'Error'/'Fail' in the output", () => {
-            expect(result.output).not.toMatch(/([Ee]rror|[Ff]ail)/i);
-        });
-    }
-});
 
-describe("Run resolc with source debug information, check LLVM debug-info", () => {
+  for (var idx in commands) {
-    const commands = [
+    const command = commands[idx]
-        `resolc -g ${paths.pathToBasicSolContract} --overwrite --debug-output-dir="${paths.pathToOutputDir}"`,
+    const result = executeCommand(command)
-        `resolc -g --disable-solc-optimizer ${paths.pathToBasicSolContract} --overwrite --debug-output-dir="${paths.pathToOutputDir}"`
-    ]; // potential issue on resolc with full path on Windows cmd`;
 
-    for (var idx in commands) {
+    it('Compiler run successful', () => {
-        const command = commands[idx];
+      expect(result.output).toMatch(/(Compiler run successful.)/i)
-        const result = executeCommand(command);
+    })
+    it('Exit code = 0', () => {
+      expect(result.exitCode).toBe(0)
+    })
+    it('Output dir is created', () => {
+      expect(isFolderExist(paths.pathToOutputDir)).toBe(true)
+    })
+    it('Output files are created', () => {
+      // a bug on windows
+      expect(
+        isFileExist(
+          paths.pathToOutputDir,
+          paths.contractOptimizedLLVMFilename,
+          paths.llvmExtension
+        )
+      ).toBe(true)
+      expect(
+        isFileExist(
+          paths.pathToOutputDir,
+          paths.contractUnoptimizedLLVMFilename,
+          paths.llvmExtension
+        )
+      ).toBe(true)
+    })
+    it('the output files are not empty', () => {
+      expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false)
+      expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false)
+    })
+    it("No 'Error'/'Fail' in the output", () => {
+      expect(result.output).not.toMatch(/([Ee]rror|[Ff]ail)/i)
+    })
+  }
+})
 
-        it("Compiler run successful", () => {
+describe('Standard JSON compilation with path options', () => {
-            expect(result.output).toMatch(/(Compiler run successful.)/i);
+  const contractsDir = path.join(shell.tempdir(), 'contracts-test')
-        });
+  const inputFile = path.join(__dirname, '..', 'src/contracts/compiled/1.json')
-        it("Exit code = 0", () => {
-            expect(result.exitCode).toBe(0);
-        });
-        it("Output dir is created", () => {
-            expect(isFolderExist(paths.pathToOutputDir)).toBe(true);
-        });
-        it("Output files are created", () => { // a bug on windows
-            expect(isFileExist(paths.pathToOutputDir, paths.contractOptimizedLLVMFilename, paths.llvmExtension)).toBe(true);
-            expect(isFileExist(paths.pathToOutputDir, paths.contractUnoptimizedLLVMFilename, paths.llvmExtension)).toBe(true);
-        });
-        it("the output files are not empty", () => {
-            expect(isFileEmpty(paths.pathToSolBinOutputFile)).toBe(false);
-            expect(isFileEmpty(paths.pathToSolAsmOutputFile)).toBe(false);
-        });
-        it("No 'Error'/'Fail' in the output", () => {
-            expect(result.output).not.toMatch(/([Ee]rror|[Ff]ail)/i);
-        });
-    }
-});
 
+  beforeAll(() => {
+    shell.mkdir('-p', contractsDir)
 
+    const input = JSON.parse(shell.cat(inputFile).toString())
 
-describe("Standard JSON compilation with path options", () => {
+    Object.entries(input.sources).forEach(
-    const contractsDir = path.join(shell.tempdir(), 'contracts-test');
+      ([sourcePath, source]: [string, any]) => {
-    const inputFile = path.join(__dirname, '..', 'src/contracts/compiled/1.json');
+        const filePath = path.join(contractsDir, sourcePath)
+        shell.mkdir('-p', path.dirname(filePath))
+        shell.ShellString(source.content).to(filePath)
+      }
+    )
+  })
+
+  afterAll(() => {
+    shell.rm('-rf', contractsDir)
+  })
+
+  describe('Output with all path options', () => {
+    let result: { exitCode: number; output: string }
 
     beforeAll(() => {
-        shell.mkdir('-p', contractsDir);
+      const tempInputFile = path.join(contractsDir, 'temp-input.json')
+      shell.cp(inputFile, tempInputFile)
+      const inputContent = shell.cat(inputFile).toString()
 
-        const input = JSON.parse(shell.cat(inputFile).toString());
+      const command = `resolc --standard-json --base-path "${contractsDir}" --include-path "${contractsDir}" --allow-paths "${contractsDir}"`
 
-        Object.entries(input.sources).forEach(([sourcePath, source]: [string, any]) => {
+      result = executeCommand(command, inputContent)
-            const filePath = path.join(contractsDir, sourcePath);
-            shell.mkdir('-p', path.dirname(filePath));
-            shell.ShellString(source.content).to(filePath);
-        });
-    });
 
-    afterAll(() => {
+      shell.rm(tempInputFile)
-        shell.rm('-rf', contractsDir);
+    })
-    });
 
-    describe("Output with all path options", () => {
+    it('Compiler run successful without emiting warnings', () => {
-        let result: { exitCode: number; output: string };
+      const parsedResults = JSON.parse(result.output)
-
+      expect(
-        beforeAll(() => {
+        parsedResults.errors.filter(
-            const tempInputFile = path.join(contractsDir, 'temp-input.json');
+          (error: { type: string }) => error.type != 'Warning'
-            shell.cp(inputFile, tempInputFile);
+        )
-            const inputContent = shell.cat(inputFile).toString();
+      ).toEqual([])
-
+    })
-            const command = `resolc --standard-json --base-path "${contractsDir}" --include-path "${contractsDir}" --allow-paths "${contractsDir}"`;
+  })
-
+})
-            result = executeCommand(command, inputContent);
-
-            shell.rm(tempInputFile);
-
-        });
-
-        it("Compiler run successful without emiting warnings", () => {
-            const parsedResults = JSON.parse(result.output)
-            expect(parsedResults.errors.filter((error: { type: string; }) => error.type != 'Warning')).toEqual([]);
-        });
-    });
-});

crates/solidity/src/tests/cli-tests/tests/yul.test.ts

@@ -1,40 +1,39 @@
-import {executeCommand} from "../src/helper";
+import { executeCommand } from '../src/helper'
-import { paths } from '../src/entities';
+import { paths } from '../src/entities'
-
 
 //id1743
-describe("Run with --yul by default", () => {
+describe('Run with --yul by default', () => {
-  const command = `resolc ${paths.pathToBasicYulContract} --yul`;
+  const command = `resolc ${paths.pathToBasicYulContract} --yul`
-  const result = executeCommand(command);
+  const result = executeCommand(command)
-  const commandInvalid = 'resolc --yul';
+  const commandInvalid = 'resolc --yul'
-  const resultInvalid = executeCommand(commandInvalid);
+  const resultInvalid = executeCommand(commandInvalid)
 
-  it("Valid command exit code = 0", () => {
+  it('Valid command exit code = 0', () => {
-    expect(result.exitCode).toBe(0);
+    expect(result.exitCode).toBe(0)
-  });
+  })
 
-  it("--yul output is presented", () => {
+  it('--yul output is presented', () => {
-    expect(result.output).toMatch(/(Compiler run successful)/i);
+    expect(result.output).toMatch(/(Compiler run successful)/i)
-    expect(result.output).toMatch(/(No output requested)/i);
+    expect(result.output).toMatch(/(No output requested)/i)
-  });
+  })
 
+  xit('solc exit code == resolc exit code', () => {
+    // unknown solc issue for datatype of the contract
+    const command = `solc ${paths.pathToBasicSolContract} --yul`
+    const solcResult = executeCommand(command)
+    expect(solcResult.exitCode).toBe(result.exitCode)
+  })
 
-  xit("solc exit code == resolc exit code", () => { // unknown solc issue for datatype of the contract
+  it('run invalid: resolc --yul', () => {
-      const command = `solc ${paths.pathToBasicSolContract} --yul`;
+    expect(resultInvalid.output).toMatch(/(The input file is missing)/i)
-      const solcResult = executeCommand(command);
+  })
-      expect(solcResult.exitCode).toBe(result.exitCode);
+  it('Invalid command exit code = 1', () => {
-  });
+    expect(resultInvalid.exitCode).toBe(1)
+  })
 
-  it("run invalid: resolc --yul", () => {
+  it('Invalid solc exit code == Invalid resolc exit code', () => {
-    expect(resultInvalid.output).toMatch(/(The input file is missing)/i);
+    const command = 'solc --yul'
-  });
+    const solcResult = executeCommand(command)
-  it("Invalid command exit code = 1", () => {
+    expect(solcResult.exitCode).toBe(resultInvalid.exitCode)
-    expect(resultInvalid.exitCode).toBe(1);
+  })
-  });
+})
-
-  it("Invalid solc exit code == Invalid resolc exit code", () => {
-    const command = 'solc --yul';
-    const solcResult = executeCommand(command);
-    expect(solcResult.exitCode).toBe(resultInvalid.exitCode);
-  });
-});

crates/solidity/src/tests/combined-json.tests.ts

@@ -1,153 +1,188 @@
-import { executeCommand } from "../src/helper";
+import { executeCommand } from '../src/helper'
-import { paths } from '../src/entities';
+import { paths } from '../src/entities'
 
+describe('Set of --combined-json tests', () => {
+  const zksolcCommand = 'zksolc'
+  const solcCommand = 'solc'
+  const json_args: string[] = [
+    `abi`,
+    `hashes`,
+    `metadata`,
+    `devdoc`,
+    `userdoc`,
+    `storage-layout`,
+    `ast`,
+    `asm`,
+    `bin`,
+    `bin-runtime`,
+  ]
 
-describe("Set of --combined-json tests", () => {
+  //id1742:I
-    const zksolcCommand = 'zksolc';
+  describe(`Run ${zksolcCommand} with just --combined-json`, () => {
-    const solcCommand = 'solc';
+    const args = [`--combined-json`]
-    const json_args: string[] = [`abi`, `hashes`, `metadata`, `devdoc`, `userdoc`, `storage-layout`, `ast`, `asm`, `bin`, `bin-runtime`];
+    const result = executeCommand(zksolcCommand, args)
 
-    //id1742:I
+    it('Valid command exit code = 1', () => {
-    describe(`Run ${zksolcCommand} with just --combined-json`, () => {
+      expect(result.exitCode).toBe(1)
-        const args = [`--combined-json`];
+    })
-        const result = executeCommand(zksolcCommand, args);
 
-        it("Valid command exit code = 1", () => {
+    it('--combined-json error is presented', () => {
-            expect(result.exitCode).toBe(1);
+      expect(result.output).toMatch(/(requires a value but none was supplied)/i)
-        });
+    })
 
-        it("--combined-json error is presented", () => {
+    it('solc exit code == zksolc exit code', () => {
-            expect(result.output).toMatch(/(requires a value but none was supplied)/i);
+      const solcResult = executeCommand(solcCommand, args)
-        });
+      expect(solcResult.exitCode).toBe(result.exitCode)
+    })
+  })
 
-        it("solc exit code == zksolc exit code", () => {
+  //id1742:II
-            const solcResult = executeCommand(solcCommand, args);
+  describe(`Run ${zksolcCommand} with Sol contract and --combined-json`, () => {
-            expect(solcResult.exitCode).toBe(result.exitCode);
+    const args = [`${paths.pathToBasicSolContract}`, `--combined-json`]
-        });
+    const result = executeCommand(zksolcCommand, args)
-    });
 
-    //id1742:II
+    it('Valid command exit code = 1', () => {
-    describe(`Run ${zksolcCommand} with Sol contract and --combined-json`, () => {
+      expect(result.exitCode).toBe(1)
-        const args = [`${paths.pathToBasicSolContract}`, `--combined-json`];
+    })
-        const result = executeCommand(zksolcCommand, args);
 
-        it("Valid command exit code = 1", () => {
+    it('--combined-json error is presented', () => {
-            expect(result.exitCode).toBe(1);
+      expect(result.output).toMatch(/(requires a value but none was supplied)/i)
-        });
+    })
 
-        it("--combined-json error is presented", () => {
+    it('solc exit code == zksolc exit code', () => {
-            expect(result.output).toMatch(/(requires a value but none was supplied)/i);
+      const solcResult = executeCommand(solcCommand, args)
-        });
+      expect(solcResult.exitCode).toBe(result.exitCode)
+    })
+  })
 
-        it("solc exit code == zksolc exit code", () => {
+  //id1742:III
-            const solcResult = executeCommand(solcCommand, args);
+  for (let i = 0; i < json_args.length; i++) {
-            expect(solcResult.exitCode).toBe(result.exitCode);
+    describe(`Run ${zksolcCommand} with Sol, --combined-json and ARG: ${json_args[i]}`, () => {
-        });
+      const args = [
-    });
+        `${paths.pathToBasicSolContract}`,
+        `--combined-json`,
+        `${json_args[i]}`,
+      ]
+      const result = executeCommand(zksolcCommand, args)
 
-    //id1742:III
+      it('Valid command exit code = 0', () => {
-    for (let i = 0; i < json_args.length; i++) {
+        expect(result.exitCode).toBe(0)
-        describe(`Run ${zksolcCommand} with Sol, --combined-json and ARG: ${json_args[i]}`, () => {
+      })
-            const args = [`${paths.pathToBasicSolContract}`, `--combined-json`, `${json_args[i]}`];
-            const result = executeCommand(zksolcCommand, args);
 
-            it("Valid command exit code = 0", () => {
+      it('--combined-json error is presented', () => {
-                expect(result.exitCode).toBe(0);
+        expect(result.output).toMatch(/(contracts)/i)
-            });
+      })
 
-            it("--combined-json error is presented", () => {
+      it('solc exit code == zksolc exit code', () => {
-                expect(result.output).toMatch(/(contracts)/i);
+        const solcResult = executeCommand(solcCommand, args)
-            });
+        expect(solcResult.exitCode).toBe(result.exitCode)
+      })
+    })
+  }
 
-            it("solc exit code == zksolc exit code", () => {
+  //id1829:I
-                const solcResult = executeCommand(solcCommand, args);
+  for (let i = 0; i < json_args.length; i++) {
-                expect(solcResult.exitCode).toBe(result.exitCode);
+    describe(`Run ${zksolcCommand} with Sol, --combined-json and wrong ARG: --${json_args[i]}`, () => {
-            });
+      const args = [
-        });
+        `${paths.pathToBasicSolContract}`,
-    }
+        `--combined-json`,
+        `--${json_args[i]}`,
+      ]
+      const result = executeCommand(zksolcCommand, args)
 
-    //id1829:I
+      it('Valid command exit code = 1', () => {
-    for (let i = 0; i < json_args.length; i++) {
+        expect(result.exitCode).toBe(1)
-        describe(`Run ${zksolcCommand} with Sol, --combined-json and wrong ARG: --${json_args[i]}`, () => {
+      })
-            const args = [`${paths.pathToBasicSolContract}`, `--combined-json`, `--${json_args[i]}`];
-            const result = executeCommand(zksolcCommand, args);
 
-            it("Valid command exit code = 1", () => {
+      it('--combined-json error is presented', () => {
-                expect(result.exitCode).toBe(1);
+        expect(result.output).toMatch(/(Invalid option|error)/i)
-            });
+      })
 
-            it("--combined-json error is presented", () => {
+      it('solc exit code == zksolc exit code', () => {
-                expect(result.output).toMatch(/(Invalid option|error)/i);
+        const solcResult = executeCommand(solcCommand, args)
-            });
+        expect(solcResult.exitCode).toBe(result.exitCode)
+      })
+    })
+  }
 
-            it("solc exit code == zksolc exit code", () => {
+  //id1829:II
-                const solcResult = executeCommand(solcCommand, args);
+  for (let i = 0; i < json_args.length; i++) {
-                expect(solcResult.exitCode).toBe(result.exitCode);
+    describe(`Run ${zksolcCommand} with Sol, --combined-json and multiple ARG: ${json_args[i]} ${json_args[i]}`, () => {
-            });
+      const args = [
-        });
+        `${paths.pathToBasicSolContract}`,
-    }
+        `--combined-json`,
+        `${json_args[i]}`,
+        `${json_args[i]}`,
+      ]
+      const result = executeCommand(zksolcCommand, args)
 
-    //id1829:II
+      xit('Valid command exit code = 1', () => {
-    for (let i = 0; i < json_args.length; i++) {
+        expect(result.exitCode).toBe(1)
-        describe(`Run ${zksolcCommand} with Sol, --combined-json and multiple ARG: ${json_args[i]} ${json_args[i]}`, () => {
+      })
-            const args = [`${paths.pathToBasicSolContract}`, `--combined-json`, `${json_args[i]}`, `${json_args[i]}`];
-            const result = executeCommand(zksolcCommand, args);
 
-            xit("Valid command exit code = 1", () => {
+      it('--combined-json error is presented', () => {
-                expect(result.exitCode).toBe(1);
+        expect(result.output).toMatch(
-            });
+          /(No such file or directory|cannot find the file specified)/i
+        ) // Hopefully we should have more precise message here!
+      })
 
-            it("--combined-json error is presented", () => {
+      xit('solc exit code == zksolc exit code', () => {
-                expect(result.output).toMatch(/(No such file or directory|cannot find the file specified)/i); // Hopefully we should have more precise message here!
+        const solcResult = executeCommand(solcCommand, args)
-            });
+        expect(solcResult.exitCode).toBe(result.exitCode)
+      })
+    })
+  }
 
-            xit("solc exit code == zksolc exit code", () => {
+  //id1829:III
-                const solcResult = executeCommand(solcCommand, args);
+  for (let i = 0; i < json_args.length; i++) {
-                expect(solcResult.exitCode).toBe(result.exitCode);
+    describe(`Run ${zksolcCommand} with Sol, and multiple (--combined-json ${json_args[i]})`, () => {
-            });
+      const args = [
-        });
+        `${paths.pathToBasicSolContract}`,
-    }
+        `--combined-json`,
+        `${json_args[i]}`,
+        `--combined-json`,
+        `${json_args[i]}`,
+      ]
+      const result = executeCommand(zksolcCommand, args)
 
-    //id1829:III
+      it('Valid command exit code = 1', () => {
-    for (let i = 0; i < json_args.length; i++) {
+        expect(result.exitCode).toBe(1)
-        describe(`Run ${zksolcCommand} with Sol, and multiple (--combined-json ${json_args[i]})`, () => {
+      })
-            const args = [`${paths.pathToBasicSolContract}`, `--combined-json`, `${json_args[i]}`, `--combined-json`, `${json_args[i]}`];
-            const result = executeCommand(zksolcCommand, args);
 
-            it("Valid command exit code = 1", () => {
+      it('--combined-json error is presented', () => {
-                expect(result.exitCode).toBe(1);
+        expect(result.output).toMatch(/(cannot be used multiple times)/i)
-            });
+      })
 
-            it("--combined-json error is presented", () => {
+      it('solc exit code == zksolc exit code', () => {
-                expect(result.output).toMatch(/(cannot be used multiple times)/i);
+        const solcResult = executeCommand(solcCommand, args)
-            });
+        expect(solcResult.exitCode).toBe(result.exitCode)
+      })
+    })
+  }
 
-            it("solc exit code == zksolc exit code", () => {
+  //id1830
-                const solcResult = executeCommand(solcCommand, args);
+  for (let i = 0; i < json_args.length; i++) {
-                expect(solcResult.exitCode).toBe(result.exitCode);
+    describe(`Run ${zksolcCommand} with Yul, and --combined-json ${json_args[i]}`, () => {
-            });
+      const args = [
-        });
+        `${paths.pathToBasicYulContract}`,
-    }
+        `--combined-json`,
+        `${json_args[i]}`,
+      ]
+      const result = executeCommand(zksolcCommand, args)
 
-    //id1830
+      it('Valid command exit code = 1', () => {
-    for (let i = 0; i < json_args.length; i++) {
+        expect(result.exitCode).toBe(1)
-        describe(`Run ${zksolcCommand} with Yul, and --combined-json ${json_args[i]}`, () => {
+      })
-            const args = [`${paths.pathToBasicYulContract}`, `--combined-json`, `${json_args[i]}`];
-            const result = executeCommand(zksolcCommand, args);
 
-            it("Valid command exit code = 1", () => {
+      it('--combined-json error is presented', () => {
-                expect(result.exitCode).toBe(1);
+        expect(result.output).toMatch(/(ParserError: Expected identifier)/i)
-            });
+      })
+      asd
 
-            it("--combined-json error is presented", () => {
+      it('solc exit code == zksolc exit code', () => {
-                expect(result.output).toMatch(/(ParserError: Expected identifier)/i);
+        const solcResult = executeCommand(solcCommand, args)
-            });
+        expect(solcResult.exitCode).toBe(result.exitCode)
-            asd
+      })
-
+    })
-            it("solc exit code == zksolc exit code", () => {
+  }
-                const solcResult = executeCommand(solcCommand, args);
+})
-                expect(solcResult.exitCode).toBe(result.exitCode);
-            });
-        });
-    }
-});

eslint.config.mjs

@@ -0,0 +1,11 @@
+import globals from 'globals'
+import pluginJs from '@eslint/js'
+import tseslint from 'typescript-eslint'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  { files: ['**/*.{mjs,ts}'] },
+  { languageOptions: { globals: globals.browser } },
+  pluginJs.configs.recommended,
+  ...tseslint.configs.recommended,
+]

js/emscripten/build.js

@@ -8,7 +8,7 @@ const RESOLC_WASM_URI =
   process.env.RELEASE_RESOLC_WASM_URI || "http://127.0.0.1:8080/resolc.wasm";
 const RESOLC_WASM_TARGET_DIR = path.join(
   __dirname,
-  "../target/wasm32-unknown-emscripten/release",
+  "../../target/wasm32-unknown-emscripten/release",
 );
 const RESOLC_JS = path.join(RESOLC_WASM_TARGET_DIR, "resolc.js");
 const RESOLC_WEB_JS = path.join(RESOLC_WASM_TARGET_DIR, "resolc_web.js");

js/emscripten/examples/node/resolc.js

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc.js

js/emscripten/examples/node/resolc.wasm

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc.wasm

js/emscripten/examples/web/resolc.wasm

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc.wasm

js/emscripten/examples/web/resolc_web.js

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc_web.js

js/emscripten/fixtures/instantiate.json

@@ -0,0 +1,19 @@
+{
+  "language": "Solidity",
+  "sources": {
+    "fixtures/instantiate.sol": {
+      "content": "// SPDX-License-Identifier: GPL-3.0\npragma solidity >=0.8.2 <0.9.0;\ncontract ChildContract {\n    constructor() {\n    }\n}\ncontract MainContract {\n    constructor() {\n       ChildContract newContract = new ChildContract();\n    }\n}"
+    }
+  },
+  "settings": {
+    "optimizer": {
+      "enabled": true,
+      "runs": 200
+    },
+    "outputSelection": {
+      "*": {
+        "*": ["abi"]
+      }
+    }
+  }
+}

js/emscripten/fixtures/instantiate_tokens.json

@@ -72,9 +72,7 @@
     },
     "outputSelection": {
       "*": {
-        "*": [
+        "*": ["abi"]
-          "abi"
-        ]
       }
     }
   }

js/emscripten/tests/node.test.mjs

@@ -0,0 +1,138 @@
+import { expect } from 'chai'
+import { compile } from '../examples/node/revive.js'
+import { fileURLToPath } from 'url'
+import path from 'path'
+import fs from 'fs'
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+function loadFixture(fixture) {
+  const fixturePath = path.resolve(__dirname, `../fixtures/${fixture}`)
+  return JSON.parse(fs.readFileSync(fixturePath, 'utf-8'))
+}
+
+describe('Compile Function Tests', function () {
+  it('should successfully compile valid Solidity code', async function () {
+    const standardInput = loadFixture('storage.json')
+
+    const result = await compile(standardInput)
+    expect(result).to.be.a('string')
+    const output = JSON.parse(result)
+    expect(output).to.have.property('contracts')
+    expect(output.contracts['fixtures/storage.sol']).to.have.property('Storage')
+    expect(output.contracts['fixtures/storage.sol'].Storage).to.have.property(
+      'abi'
+    )
+    expect(output.contracts['fixtures/storage.sol'].Storage).to.have.property(
+      'evm'
+    )
+    expect(
+      output.contracts['fixtures/storage.sol'].Storage.evm
+    ).to.have.property('bytecode')
+  })
+
+  if (typeof globalThis.Bun == 'undefined') {
+    // Running this test with Bun on a Linux host causes:
+    // RuntimeError: Out of bounds memory access (evaluating 'getWasmTableEntry(index)(a1, a2, a3, a4, a5)')
+    // Once this issue is resolved, the test will be re-enabled.
+    it('should successfully compile large Solidity code', async function () {
+      const standardInput = loadFixture('token.json')
+
+      const result = await compile(standardInput)
+      expect(result).to.be.a('string')
+      const output = JSON.parse(result)
+      expect(output).to.have.property('contracts')
+      expect(output.contracts['fixtures/token.sol']).to.have.property('MyToken')
+      expect(output.contracts['fixtures/token.sol'].MyToken).to.have.property(
+        'abi'
+      )
+      expect(output.contracts['fixtures/token.sol'].MyToken).to.have.property(
+        'evm'
+      )
+      expect(
+        output.contracts['fixtures/token.sol'].MyToken.evm
+      ).to.have.property('bytecode')
+    })
+
+    it('should successfully compile a valid Solidity contract that instantiates the token contracts', async function () {
+      const standardInput = loadFixture('instantiate_tokens.json')
+
+      const result = await compile(standardInput)
+      expect(result).to.be.a('string')
+      const output = JSON.parse(result)
+      expect(output).to.have.property('contracts')
+      expect(
+        output.contracts['fixtures/instantiate_tokens.sol']
+      ).to.have.property('TokensFactory')
+      expect(
+        output.contracts['fixtures/instantiate_tokens.sol'].TokensFactory
+      ).to.have.property('abi')
+      expect(
+        output.contracts['fixtures/instantiate_tokens.sol'].TokensFactory
+      ).to.have.property('evm')
+      expect(
+        output.contracts['fixtures/instantiate_tokens.sol'].TokensFactory.evm
+      ).to.have.property('bytecode')
+    })
+  }
+
+  it('should throw an error for invalid Solidity code', async function () {
+    const standardInput = loadFixture('invalid_contract_content.json')
+
+    const result = await compile(standardInput)
+    expect(result).to.be.a('string')
+    const output = JSON.parse(result)
+    expect(output).to.have.property('errors')
+    expect(output.errors).to.be.an('array')
+    expect(output.errors.length).to.be.greaterThan(0)
+    expect(output.errors[0].type).to.exist
+    expect(output.errors[0].type).to.contain('ParserError')
+  })
+
+  it('should return not found error for missing imports', async function () {
+    const standardInput = loadFixture('missing_import.json')
+
+    const result = await compile(standardInput)
+    const output = JSON.parse(result)
+    expect(output).to.have.property('errors')
+    expect(output.errors).to.be.an('array')
+    expect(output.errors.length).to.be.greaterThan(0)
+    expect(output.errors[0].message).to.exist
+    expect(output.errors[0].message).to.include(
+      'Source "nonexistent/console.sol" not found'
+    )
+  })
+
+  it('should successfully compile a valid Solidity contract that instantiates another contract', async function () {
+    const standardInput = loadFixture('instantiate.json')
+
+    const result = await compile(standardInput)
+    expect(result).to.be.a('string')
+    const output = JSON.parse(result)
+    expect(output).to.have.property('contracts')
+    expect(output.contracts['fixtures/instantiate.sol']).to.have.property(
+      'ChildContract'
+    )
+    expect(
+      output.contracts['fixtures/instantiate.sol'].ChildContract
+    ).to.have.property('abi')
+    expect(
+      output.contracts['fixtures/instantiate.sol'].ChildContract
+    ).to.have.property('evm')
+    expect(
+      output.contracts['fixtures/instantiate.sol'].ChildContract.evm
+    ).to.have.property('bytecode')
+    expect(output.contracts['fixtures/instantiate.sol']).to.have.property(
+      'MainContract'
+    )
+    expect(
+      output.contracts['fixtures/instantiate.sol'].MainContract
+    ).to.have.property('abi')
+    expect(
+      output.contracts['fixtures/instantiate.sol'].MainContract
+    ).to.have.property('evm')
+    expect(
+      output.contracts['fixtures/instantiate.sol'].MainContract.evm
+    ).to.have.property('bytecode')
+  })
+})

js/examples/node/resolc.js

@@ -1 +0,0 @@
-../../../target/wasm32-unknown-emscripten/release/resolc.js

js/examples/node/resolc.wasm

@@ -1 +0,0 @@
-../../../target/wasm32-unknown-emscripten/release/resolc.wasm

js/examples/web/resolc.wasm

@@ -1 +0,0 @@
-../../../target/wasm32-unknown-emscripten/release/resolc.wasm

js/examples/web/resolc_web.js

@@ -1 +0,0 @@
-../../../target/wasm32-unknown-emscripten/release/resolc_web.js

js/fixtures/instantiate.json

@@ -1,20 +0,0 @@
-{
-    "language": "Solidity",
-    "sources": {
-      "fixtures/instantiate.sol": {
-        "content": "// SPDX-License-Identifier: GPL-3.0\npragma solidity >=0.8.2 <0.9.0;\ncontract ChildContract {\n    constructor() {\n    }\n}\ncontract MainContract {\n    constructor() {\n       ChildContract newContract = new ChildContract();\n    }\n}"
-      }
-    },
-    "settings": {
-      "optimizer": {
-        "enabled": true,
-        "runs": 200
-      },
-      "outputSelection": {
-        "*": {
-          "*": ["abi"]
-        }
-      }
-    }
-  }
-  

js/resolc/README.md

@@ -0,0 +1,17 @@
+# Usage from Node.js
+
+```typescript
+import { compile } from "@parity/resolc";
+const sources = {
+["contracts/1_Storage.sol"]: {
+    content: readFileSync("fixtures/storage.sol", "utf8"),
+}
+
+const out = await compile(sources);
+```
+
+# Usage from shell
+
+```bash
+ npx @parity/resolc@latest --bin contracts/1_Storage.sol
+```

js/resolc/fixtures/bad_pragma.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: GPL-3.0
+pragma solidity ^9999;
+
+/**
+ * @title Storage
+ * @dev Store & retrieve value in a variable
+ * @custom:dev-run-script ./scripts/deploy_with_ethers.ts
+ */
+contract BadPragma {
+}

js/resolc/fixtures/storage.sol

@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: GPL-3.0
+pragma solidity >=0.8.2 <0.9.0;
+
+/**
+ * @title Storage
+ * @dev Store & retrieve value in a variable
+ * @custom:dev-run-script ./scripts/deploy_with_ethers.ts
+ */
+contract Storage {
+
+    uint256 number;
+
+    /**
+     * @dev Store value in variable
+     * @param num value to store
+     */
+    function store(uint256 num) public {
+        number = num;
+    }
+
+    /**
+     * @dev Return value 
+     * @return value of 'number'
+     */
+    function retrieve() public view returns (uint256){
+        return number;
+    }
+}

js/resolc/fixtures/storage_bad.sol

@@ -0,0 +1,26 @@
+// missing license and pragama
+/**
+ * @title Storage
+ * @dev Store & retrieve value in a variable
+ * @custom:dev-run-script ./scripts/deploy_with_ethers.ts
+ */
+contract Storage {
+
+    uint256 number;
+
+    /**
+     * @dev Store value in variable
+     * @param num value to store
+     */
+    function store(uint256 num) public {
+        number = num;
+    }
+
+    /**
+     * @dev Return value 
+     * @return value of 'number'
+     */
+    function retrieve() public view returns (uint256){
+        return number;
+    }
+}

js/resolc/fixtures/token.sol

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: MIT
+// Compatible with OpenZeppelin Contracts ^5.0.0
+pragma solidity ^0.8.22;
+
+import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import "@openzeppelin/contracts/access/Ownable.sol";
+import "@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol";
+
+contract MyToken is ERC20, Ownable, ERC20Permit {
+    constructor(address initialOwner)
+        ERC20("MyToken", "MTK")
+        Ownable(initialOwner)
+        ERC20Permit("MyToken")
+    {
+        _mint(msg.sender, 100 * 10 ** decimals());
+    }
+
+    function mint(address to, uint256 amount) public onlyOwner {
+        _mint(to, amount);
+    }
+}
+

js/resolc/package.json

@@ -0,0 +1,37 @@
+{
+    "name": "@parity/resolc",
+    "license": "Apache-2.0",
+    "version": "0.0.0-updated-via-gh-releases",
+    "author": "Parity <admin@parity.io> (https://parity.io)",
+    "module": "index.ts",
+    "types": "./dist/index.d.ts",
+    "main": "./dist/index.js",
+    "bin": {
+        "resolc": "./dist/bin.js"
+    },
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc && cp src/resolc/** dist/resolc",
+        "test": "npm run build && node ./dist/index.test.js"
+    },
+    "devDependencies": {
+        "@openzeppelin/contracts": "5.1.0",
+        "globals": "^15.12.0",
+        "typescript": "^5.6.3"
+    },
+    "dependencies": {
+        "@types/node": "^22.9.0",
+        "commander": "^13.1.0",
+        "package-json": "^10.0.1",
+        "solc": "^0.8.29"
+    }
+}

js/resolc/src/bin.ts

@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+import * as commander from 'commander'
+import * as fs from 'fs'
+import * as os from 'os'
+import * as path from 'path'
+import * as resolc from '.'
+import { SolcInput } from '.'
+
+async function main() {
+  // hold on to any exception handlers that existed prior to this script running, we'll be adding them back at the end
+  const originalUncaughtExceptionListeners =
+    process.listeners('uncaughtException')
+  // FIXME: remove annoying exception catcher of Emscripten
+  //        see https://github.com/chriseth/browser-solidity/issues/167
+  process.removeAllListeners('uncaughtException')
+
+  const program = new commander.Command()
+
+  program.name('solcjs')
+  program.version(resolc.version())
+  program
+    .option('--bin', 'Binary of the contracts in hex.')
+    .option('--abi', 'ABI of the contracts.')
+    .option(
+      '--base-path <path>',
+      'Root of the project source tree. ' +
+        'The import callback will attempt to interpret all import paths as relative to this directory.'
+    )
+    .option(
+      '--include-path <path...>',
+      'Extra source directories available to the import callback. ' +
+        'When using a package manager to install libraries, use this option to specify directories where packages are installed. ' +
+        'Can be used multiple times to provide multiple locations.'
+    )
+    .option(
+      '-o, --output-dir <output-directory>',
+      'Output directory for the contracts.'
+    )
+    .option('-p, --pretty-json', 'Pretty-print all JSON output.', false)
+    .option('-v, --verbose', 'More detailed console output.', false)
+    .argument('<files...>')
+
+  program.parse(process.argv)
+  const options = program.opts<{
+    verbose: boolean
+    abi: boolean
+    bin: boolean
+    outputDir?: string
+    prettyJson: boolean
+    basePath?: string
+    includePath?: string[]
+  }>()
+  const files: string[] = program.args
+  const destination = options.outputDir ?? '.'
+
+  function abort(msg: string) {
+    console.error(msg || 'Error occurred')
+    process.exit(1)
+  }
+
+  function withUnixPathSeparators(filePath: string) {
+    // On UNIX-like systems forward slashes in paths are just a part of the file name.
+    if (os.platform() !== 'win32') {
+      return filePath
+    }
+
+    return filePath.replace(/\\/g, '/')
+  }
+
+  function makeSourcePathRelativeIfPossible(sourcePath: string) {
+    const absoluteBasePath = options.basePath
+      ? path.resolve(options.basePath)
+      : path.resolve('.')
+    const absoluteIncludePaths = options.includePath
+      ? options.includePath.map((prefix: string) => {
+          return path.resolve(prefix)
+        })
+      : []
+
+    // Compared to base path stripping logic in solc this is much simpler because path.resolve()
+    // handles symlinks correctly (does not resolve them except in work dir) and strips .. segments
+    // from paths going beyond root (e.g. `/../../a/b/c` -> `/a/b/c/`). It's simpler also because it
+    // ignores less important corner cases: drive letters are not stripped from absolute paths on
+    // Windows and UNC paths are not handled in a special way (at least on Linux). Finally, it has
+    // very little test coverage so there might be more differences that we are just not aware of.
+    const absoluteSourcePath = path.resolve(sourcePath)
+
+    for (const absolutePrefix of [absoluteBasePath].concat(
+      absoluteIncludePaths
+    )) {
+      const relativeSourcePath = path.relative(
+        absolutePrefix,
+        absoluteSourcePath
+      )
+
+      if (!relativeSourcePath.startsWith('../')) {
+        return withUnixPathSeparators(relativeSourcePath)
+      }
+    }
+
+    // File is not located inside base path or include paths so use its absolute path.
+    return withUnixPathSeparators(absoluteSourcePath)
+  }
+
+  function toFormattedJson<T>(input: T) {
+    return JSON.stringify(input, null, options.prettyJson ? 4 : 0)
+  }
+
+  if (files.length === 0) {
+    console.error('Must provide a file')
+    process.exit(1)
+  }
+
+  if (!(options.bin || options.abi)) {
+    abort('Invalid option selected, must specify either --bin or --abi')
+  }
+
+  const sources: SolcInput = {}
+
+  for (let i = 0; i < files.length; i++) {
+    try {
+      sources[makeSourcePathRelativeIfPossible(files[i])] = {
+        content: fs.readFileSync(files[i]).toString(),
+      }
+    } catch (e) {
+      abort('Error reading ' + files[i] + ': ' + e)
+    }
+  }
+
+  if (options.verbose) {
+    console.log('>>> Compiling:\n' + toFormattedJson(sources) + '\n')
+  }
+
+  const output = await resolc.compile(sources)
+  let hasError = false
+
+  if (!output) {
+    abort('No output from compiler')
+  } else if (output.errors) {
+    for (const error in output.errors) {
+      const message = output.errors[error]
+      if (message.severity === 'warning') {
+        console.log(message.formattedMessage)
+      } else {
+        console.error(message.formattedMessage)
+        hasError = true
+      }
+    }
+  }
+
+  fs.mkdirSync(destination, { recursive: true })
+
+  function writeFile(file: string, content: Buffer | string) {
+    file = path.join(destination, file)
+    fs.writeFile(file, content, function (err) {
+      if (err) {
+        console.error('Failed to write ' + file + ': ' + err)
+      }
+    })
+  }
+
+  for (const fileName in output.contracts) {
+    for (const contractName in output.contracts[fileName]) {
+      let contractFileName = fileName + ':' + contractName
+      contractFileName = contractFileName.replace(/[:./\\]/g, '_')
+
+      if (options.bin) {
+        writeFile(
+          contractFileName + '.polkavm',
+          Buffer.from(
+            output.contracts[fileName][contractName].evm.bytecode.object,
+            'hex'
+          )
+        )
+      }
+
+      if (options.abi) {
+        writeFile(
+          contractFileName + '.abi',
+          toFormattedJson(output.contracts[fileName][contractName].abi)
+        )
+      }
+    }
+  }
+
+  // Put back original exception handlers.
+  originalUncaughtExceptionListeners.forEach(function (listener) {
+    process.addListener('uncaughtException', listener)
+  })
+
+  if (hasError) {
+    process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error('Error:', err)
+  process.exit(1)
+})

js/resolc/src/index.test.ts

@@ -0,0 +1,116 @@
+import { test } from 'node:test'
+import { readFileSync, existsSync } from 'node:fs'
+import assert from 'node:assert'
+import { compile, tryResolveImport } from '.'
+import { resolve } from 'node:path'
+
+const compileOptions = [{}]
+if (existsSync('../../target/release/resolc')) {
+  compileOptions.push({ bin: '../../target/release/resolc' })
+}
+
+for (const options of compileOptions) {
+  test(`check Ok output with option ${JSON.stringify(options)}`, async () => {
+    const contract = 'fixtures/token.sol'
+    const sources = {
+      [contract]: {
+        content: readFileSync('fixtures/storage.sol', 'utf8'),
+      },
+    }
+
+    const out = await compile(sources, options)
+    assert(out.contracts[contract].Storage.abi != null)
+    assert(out.contracts[contract].Storage.evm.bytecode != null)
+  })
+}
+
+test('check Err output', async () => {
+  const sources = {
+    bad: {
+      content: readFileSync('fixtures/storage_bad.sol', 'utf8'),
+    },
+  }
+
+  const out = await compile(sources)
+  assert(
+    out?.errors?.[0].message.includes(
+      'SPDX license identifier not provided in source file'
+    )
+  )
+  assert(
+    out?.errors?.[1].message.includes(
+      'Source file does not specify required compiler version'
+    )
+  )
+})
+
+test('check Err from stderr', async () => {
+  const sources = {
+    bad: {
+      content: readFileSync('fixtures/bad_pragma.sol', 'utf8'),
+    },
+  }
+
+  try {
+    await compile(sources)
+    assert(false, 'Expected error')
+  } catch (error) {
+    assert(
+      String(error).includes('Source file requires different compiler version')
+    )
+  }
+})
+
+test('resolve import', () => {
+  const cases = [
+    // local
+    {
+      file: './fixtures/storage.sol',
+      expected: resolve('fixtures/storage.sol'),
+    },
+    // scopped module with version
+    {
+      file: '@openzeppelin/contracts@5.1.0/token/ERC20/ERC20.sol',
+      expected: require.resolve(
+        '@openzeppelin/contracts/token/ERC20/ERC20.sol'
+      ),
+    },
+    // scopped module without version
+    {
+      file: '@openzeppelin/contracts/token/ERC20/ERC20.sol',
+      expected: require.resolve(
+        '@openzeppelin/contracts/token/ERC20/ERC20.sol'
+      ),
+    },
+    // scopped module with wrong version
+    {
+      file: '@openzeppelin/contracts@4.8.3/token/ERC20/ERC20.sol',
+      expected: `Error: Version mismatch: Specified @openzeppelin/contracts@4.8.3, but installed version is 5.1.0`,
+    },
+    // module without version
+    {
+      file: '@openzeppelin/contracts/package.json',
+      expected: require.resolve('@openzeppelin/contracts/package.json'),
+    },
+    // scopped module with version
+    {
+      file: '@openzeppelin/contracts@5.1.0/package.json',
+      expected: require.resolve('@openzeppelin/contracts/package.json'),
+    },
+  ]
+
+  for (const { file, expected } of cases) {
+    try {
+      const resolved = tryResolveImport(file)
+      assert(
+        resolved === expected,
+        `\nGot:\n${resolved}\nExpected:\n${expected}`
+      )
+    } catch (error) {
+      assert(
+        String(error) == expected,
+        `\nGot:\n${String(error)}\nExpected:\n${expected}`
+      )
+    }
+  }
+})

js/resolc/src/index.ts

@@ -0,0 +1,213 @@
+import solc from 'solc'
+import { spawn } from 'child_process'
+import { resolc, version as resolcVersion } from './resolc'
+import path from 'path'
+import { existsSync, readFileSync } from 'fs'
+
+export type SolcInput = {
+  [contractName: string]: {
+    content: string
+  }
+}
+
+export type SolcError = {
+  component: string
+  errorCode: string
+  formattedMessage: string
+  message: string
+  severity: string
+  sourceLocation?: {
+    file: string
+    start: number
+    end: number
+  }
+  type: string
+}
+
+export type SolcOutput = {
+  contracts: {
+    [contractPath: string]: {
+      [contractName: string]: {
+        abi: Array<{
+          name: string
+          inputs: Array<{ name: string; type: string }>
+          outputs: Array<{ name: string; type: string }>
+          stateMutability: string
+          type: string
+        }>
+        evm: {
+          bytecode: { object: string }
+        }
+      }
+    }
+  }
+  errors?: Array<SolcError>
+}
+
+export function resolveInputs(sources: SolcInput): SolcInput {
+  const input = {
+    language: 'Solidity',
+    sources,
+    settings: {
+      outputSelection: {
+        '*': {
+          '*': ['evm.bytecode.object'],
+        },
+      },
+    },
+  }
+
+  const out = solc.compile(JSON.stringify(input), {
+    import: (path: string) => {
+      return {
+        contents: readFileSync(tryResolveImport(path), 'utf8'),
+      }
+    },
+  })
+
+  const output = JSON.parse(out) as {
+    sources: { [fileName: string]: { id: number } }
+    errors: Array<SolcError>
+  }
+
+  if (output.errors && Object.keys(output.sources).length === 0) {
+    throw new Error(output.errors[0].formattedMessage)
+  }
+
+  return Object.fromEntries(
+    Object.keys(output.sources).map((fileName) => {
+      return [
+        fileName,
+        sources[fileName] ?? {
+          content: readFileSync(tryResolveImport(fileName), 'utf8'),
+        },
+      ]
+    })
+  )
+}
+
+export function version(): string {
+  const v = resolcVersion()
+  return v.split(' ').pop() ?? v
+}
+
+export async function compile(
+  sources: SolcInput,
+  option: {
+    optimizer?: Record<string, unknown>
+    bin?: string
+  } = {}
+): Promise<SolcOutput> {
+  const {
+    optimizer = {
+      mode: 'z',
+      fallback_to_optimizing_for_size: true,
+      enabled: true,
+      runs: 200,
+    },
+    bin,
+  } = option
+
+  const input = JSON.stringify({
+    language: 'Solidity',
+    sources: resolveInputs(sources),
+    settings: {
+      optimizer,
+      outputSelection: {
+        '*': {
+          '*': ['abi'],
+        },
+      },
+    },
+  })
+
+  if (bin) {
+    return compileWithBin(input, bin)
+  }
+
+  return resolc(input)
+}
+
+/**
+ * Resolve an import path to a file path.
+ * @param importPath - The import path to resolve.
+ */
+export function tryResolveImport(importPath: string) {
+  // resolve local path
+  if (existsSync(importPath)) {
+    return path.resolve(importPath)
+  }
+
+  const importRegex = /^(@?[^@/]+(?:\/[^@/]+)?)(?:@([^/]+))?(\/.+)$/
+  const match = importPath.match(importRegex)
+
+  if (!match) {
+    throw new Error('Invalid import path format.')
+  }
+
+  const basePackage = match[1] // "foo", "@scope/foo"
+  const specifiedVersion = match[2] // "1.2.3" (optional)
+  const relativePath = match[3] // "/path/to/file.sol"
+
+  let packageJsonPath
+  try {
+    packageJsonPath = require.resolve(path.join(basePackage, 'package.json'))
+  } catch {
+    throw new Error(`Could not resolve package ${basePackage}`)
+  }
+
+  // Check if a version was specified and compare with the installed version
+  if (specifiedVersion) {
+    const installedVersion = JSON.parse(
+      readFileSync(packageJsonPath, 'utf-8')
+    ).version
+
+    if (installedVersion !== specifiedVersion) {
+      throw new Error(
+        `Version mismatch: Specified ${basePackage}@${specifiedVersion}, but installed version is ${installedVersion}`
+      )
+    }
+  }
+
+  const packageRoot = path.dirname(packageJsonPath)
+
+  // Construct full path to the requested file
+  const resolvedPath = path.join(packageRoot, relativePath)
+  if (existsSync(resolvedPath)) {
+    return resolvedPath
+  } else {
+    throw new Error(`Resolved path ${resolvedPath} does not exist.`)
+  }
+}
+function compileWithBin(input: string, bin: string): PromiseLike<SolcOutput> {
+  return new Promise((resolve, reject) => {
+    const process = spawn(bin, ['--standard-json'])
+
+    let output = ''
+    let error = ''
+
+    process.stdin.write(input)
+    process.stdin.end()
+
+    process.stdout.on('data', (data) => {
+      output += data.toString()
+    })
+
+    process.stderr.on('data', (data) => {
+      error += data.toString()
+    })
+
+    process.on('close', (code) => {
+      if (code === 0) {
+        try {
+          const result: SolcOutput = JSON.parse(output)
+          resolve(result)
+        } catch {
+          reject(new Error(`Failed to parse output`))
+        }
+      } else {
+        reject(new Error(`Process exited with code ${code}: ${error}`))
+      }
+    })
+  })
+}

js/resolc/src/resolc.ts

@@ -0,0 +1,30 @@
+import soljson from 'solc/soljson'
+import Resolc from './resolc/resolc'
+import type { SolcOutput } from '.'
+
+export function resolc(input: string): SolcOutput {
+  const m = Resolc() as any // eslint-disable-line @typescript-eslint/no-explicit-any
+  m.soljson = soljson
+  m.writeToStdin(input)
+  m.callMain(['--standard-json'])
+  const err = m.readFromStderr()
+
+  if (err) {
+    throw new Error(err)
+  }
+
+  return JSON.parse(m.readFromStdout()) as SolcOutput
+}
+
+export function version(): string {
+  const m = Resolc() as any // eslint-disable-line @typescript-eslint/no-explicit-any
+  m.soljson = soljson
+  m.callMain(['--version'])
+  const err = m.readFromStderr()
+
+  if (err) {
+    throw new Error(err)
+  }
+
+  return m.readFromStdout()
+}

js/resolc/src/resolc/resolc.js

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc.js

js/resolc/src/resolc/resolc.wasm

@@ -0,0 +1 @@
+../../../../target/wasm32-unknown-emscripten/release/resolc.wasm

js/resolc/src/solc.d.ts

@@ -0,0 +1,95 @@
+declare module 'solc/soljson' {}
+
+declare module 'solc' {
+  // Basic types for input/output handling
+  export interface CompileInput {
+    language: string
+    sources: {
+      [fileName: string]: {
+        content: string
+      }
+    }
+    settings?: {
+      optimizer?: {
+        enabled: boolean
+        runs: number
+      }
+      outputSelection: {
+        [fileName: string]: {
+          [contractName: string]: string[]
+        }
+      }
+    }
+  }
+
+  export interface CompileOutput {
+    errors?: Array<{
+      component: string
+      errorCode: string
+      formattedMessage: string
+      message: string
+      severity: string
+      sourceLocation?: {
+        file: string
+        start: number
+        end: number
+      }
+      type: string
+    }>
+    sources?: {
+      [fileName: string]: {
+        id: number
+        ast: object
+      }
+    }
+    contracts?: {
+      [fileName: string]: {
+        [contractName: string]: {
+          abi: object[]
+          evm: {
+            bytecode: {
+              object: string
+              sourceMap: string
+              linkReferences: {
+                [fileName: string]: {
+                  [libraryName: string]: Array<{
+                    start: number
+                    length: number
+                  }>
+                }
+              }
+            }
+            deployedBytecode: {
+              object: string
+              sourceMap: string
+              linkReferences: {
+                [fileName: string]: {
+                  [libraryName: string]: Array<{
+                    start: number
+                    length: number
+                  }>
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+
+  // Main exported functions
+  export function compile(
+    input: string | CompileInput,
+    options?: {
+      import: (path: string) =>
+        | {
+            contents: string
+            error?: undefined
+          }
+        | {
+            error: string
+            contents?: undefined
+          }
+    }
+  ): string
+}

js/resolc/tsconfig.json

@@ -0,0 +1,27 @@
+{
+    "compilerOptions": {
+        "baseUrl": ".",
+        "outDir": "dist",
+        "sourceMap": true,
+        "declaration": true,
+        "noFallthroughCasesInSwitch": true,
+        "allowJs": true,
+        "moduleResolution": "node",
+        "module": "commonjs",
+        "target": "ES2022",
+        "lib": ["ES2022"],
+        "strict": true,
+        "noImplicitAny": true,
+        "skipLibCheck": true,
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "useUnknownInCatchVariables": true,
+        "types": ["node"],
+        "typeRoots": ["../../node_modules/@types", "./src"],
+        "paths": {
+            "#src/*": ["./src/*"]
+        },
+        "plugins": []
+    },
+    "include": ["src/**/*"]
+}

js/tests/node.test.mjs

@@ -1,143 +0,0 @@
-import { expect } from "chai";
-import { compile } from "../examples/node/revive.js";
-import { fileURLToPath } from "url";
-import path from "path";
-import fs from "fs";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-function loadFixture(fixture) {
-  const fixturePath = path.resolve(__dirname, `../fixtures/${fixture}`);
-  return JSON.parse(fs.readFileSync(fixturePath, "utf-8"));
-}
-
-describe("Compile Function Tests", function () {
-  it("should successfully compile valid Solidity code", async function () {
-    const standardInput = loadFixture("storage.json");
-
-    const result = await compile(standardInput);
-    expect(result).to.be.a("string");
-    const output = JSON.parse(result);
-    expect(output).to.have.property("contracts");
-    expect(output.contracts["fixtures/storage.sol"]).to.have.property(
-      "Storage",
-    );
-    expect(output.contracts["fixtures/storage.sol"].Storage).to.have.property(
-      "abi",
-    );
-    expect(output.contracts["fixtures/storage.sol"].Storage).to.have.property(
-      "evm",
-    );
-    expect(
-      output.contracts["fixtures/storage.sol"].Storage.evm,
-    ).to.have.property("bytecode");
-  });
-
-  if (typeof globalThis.Bun == "undefined") {
-    // Running this test with Bun on a Linux host causes:
-    // RuntimeError: Out of bounds memory access (evaluating 'getWasmTableEntry(index)(a1, a2, a3, a4, a5)')
-    // Once this issue is resolved, the test will be re-enabled.
-    it("should successfully compile large Solidity code", async function () {
-      const standardInput = loadFixture("token.json");
-
-      const result = await compile(standardInput);
-      expect(result).to.be.a("string");
-      const output = JSON.parse(result);
-      expect(output).to.have.property("contracts");
-      expect(output.contracts["fixtures/token.sol"]).to.have.property(
-        "MyToken",
-      );
-      expect(output.contracts["fixtures/token.sol"].MyToken).to.have.property(
-        "abi",
-      );
-      expect(output.contracts["fixtures/token.sol"].MyToken).to.have.property(
-        "evm",
-      );
-      expect(
-        output.contracts["fixtures/token.sol"].MyToken.evm,
-      ).to.have.property("bytecode");
-    });
-
-    it("should successfully compile a valid Solidity contract that instantiates the token contracts", async function () {
-      const standardInput = loadFixture("instantiate_tokens.json");
-
-      const result = await compile(standardInput);
-      expect(result).to.be.a("string");
-      const output = JSON.parse(result);
-      expect(output).to.have.property("contracts");
-      expect(output.contracts["fixtures/instantiate_tokens.sol"]).to.have.property(
-        "TokensFactory",
-      );
-      expect(output.contracts["fixtures/instantiate_tokens.sol"].TokensFactory).to.have.property(
-        "abi",
-      );
-      expect(output.contracts["fixtures/instantiate_tokens.sol"].TokensFactory).to.have.property(
-        "evm",
-      );
-      expect(
-        output.contracts["fixtures/instantiate_tokens.sol"].TokensFactory.evm,
-      ).to.have.property("bytecode");
-    });
-  }
-
-  it("should throw an error for invalid Solidity code", async function () {
-    const standardInput = loadFixture("invalid_contract_content.json");
-
-    const result = await compile(standardInput);
-    expect(result).to.be.a("string");
-    const output = JSON.parse(result);
-    expect(output).to.have.property("errors");
-    expect(output.errors).to.be.an("array");
-    expect(output.errors.length).to.be.greaterThan(0);
-    expect(output.errors[0].type).to.exist;
-    expect(output.errors[0].type).to.contain("ParserError");
-  });
-
-  it("should return not found error for missing imports", async function () {
-    const standardInput = loadFixture("missing_import.json");
-
-    const result = await compile(standardInput);
-    const output = JSON.parse(result);
-    expect(output).to.have.property("errors");
-    expect(output.errors).to.be.an("array");
-    expect(output.errors.length).to.be.greaterThan(0);
-    expect(output.errors[0].message).to.exist;
-    expect(output.errors[0].message).to.include(
-      'Source "nonexistent/console.sol" not found',
-    );
-  });
-
-  it("should successfully compile a valid Solidity contract that instantiates another contract", async function () {
-    const standardInput = loadFixture("instantiate.json");
-
-    const result = await compile(standardInput);
-    expect(result).to.be.a("string");
-    const output = JSON.parse(result);
-    expect(output).to.have.property("contracts");
-    expect(output.contracts["fixtures/instantiate.sol"]).to.have.property(
-      "ChildContract",
-    );
-    expect(output.contracts["fixtures/instantiate.sol"].ChildContract).to.have.property(
-      "abi",
-    );
-    expect(output.contracts["fixtures/instantiate.sol"].ChildContract).to.have.property(
-      "evm",
-    );
-    expect(
-      output.contracts["fixtures/instantiate.sol"].ChildContract.evm,
-    ).to.have.property("bytecode");
-    expect(output.contracts["fixtures/instantiate.sol"]).to.have.property(
-      "MainContract",
-    );
-    expect(output.contracts["fixtures/instantiate.sol"].MainContract).to.have.property(
-      "abi",
-    );
-    expect(output.contracts["fixtures/instantiate.sol"].MainContract).to.have.property(
-      "evm",
-    );
-    expect(
-      output.contracts["fixtures/instantiate.sol"].MainContract.evm,
-    ).to.have.property("bytecode");
-  });
-
-});

package.json

@@ -1,13 +1,21 @@
 {
-    "name": "root",
+  "name": "root",
-    "private": true,
+  "private": true,
-    "scripts": {
+  "scripts": {
-        "test:cli": "npm run test -w crates/solidity/src/tests/cli-tests",
+    "test:cli": "npm run test -w crates/solidity/src/tests/cli-tests",
-        "test:wasm": "npm run test:node -w js",
+    "test:wasm": "npm run test:node -w js/emscripten",
-        "build:package": "npm run build:package -w js"
+    "build:package": "npm run build:package -w js/emscripten",
-    },
+    "lint": "npx eslint 'js/**/*.{cjs,mjs,ts}' && npx prettier --check '**/*.{mjs,cjs,ts}'",
-    "workspaces": [
+    "lint:fix": "npx prettier --write '**/*.{mjs,cjs,ts}'"
-        "crates/solidity/src/tests/cli-tests",
+  },
-        "js"
+  "workspaces": [
-    ]
+    "crates/solidity/src/tests/cli-tests",
+    "js/emscripten",
+    "js/resolc"
+  ],
+  "dependencies": {
+    "@eslint/js": "^9.14.0",
+    "eslint": "^9.14.0",
+    "typescript-eslint": "^8.13.0"
+  }
 }