Name	Name	Last commit message	Last commit date
parent directory ..
examples	examples
src	src
tests	tests
.npmignore	.npmignore
Makefile	Makefile
README.md	README.md
package-lock.json	package-lock.json
package.json	package.json

EVMole JavaScript (WASM)

This directory contains API documentation and various examples (web page, nodejs, vite, webpack, parcel, esbuild) demonstrating how to use the EVMole library with its JavaScript (WASM) build in different environments and with various build tools.

The library is built with wasm-pack. To simplify usage, we provide a default entry point with await init(), which should work in all modern browsers and bundlers.

Usage

Web page

You can load evmole directly in a web page using a script module. Here's how to do it:

<div id="info"></div>

<script type="module">
import { contractInfo } from 'https://cdn.jsdelivr.net/npm/[email protected]/dist/evmole.mjs';

const bytecode = '0x6080...'; // Replace with actual bytecode
document.getElementById('info').textContent = contractInfo(bytecode, {selectors: true, arguments: true, stateMutability: true});
</script>

Node.js

You can use EVMole with both import and require syntax:

Vite

Set target: esnext in vite.config.js to support Top Level Await, required for default EVMole import:

build: {
  target: 'esnext'
}

After that, import and use EVMole as usual.

If you can't use esnext, see the No Top Level Await section.

Webpack

Set asyncWebAssembly: true in webpack.config.js:

experiments: {
  asyncWebAssembly: true,
}

After that, import and use EVMole as usual.

Parcel

Parcel can't work with Top Level Await, so you need to manually call init after import. See examples with:

default parcel installation
example with "packageExports": true set in package.json

You can read more about this in parcel resolver documentation

esbuild

Pass --format=esm and --loader:.wasm=file to esbuild. Find the full command in package.json

After that, import and use EVMole as usual.

No Top Level Await

If you can't use Top Level Await, you can import EVMole as:

import init, { contractInfo } from 'evmole/no_tla`
// or: from 'evmole/dist/evmole.js' (supported, but not recommended)

After that, you can use it as:

const bytecode = '0x6080...'; // Replace with actual bytecode
async function main() {
  await init();
  console.log(contractInfo(bytecode, {selectors: true}));
}
main()

const bytecode = '0x6080...'; // Replace with actual bytecode
init().then() => {
  console.log(contractInfo(bytecode, {selectors: true}));
}

See full example without Top Level Await in Parcel example

API

contractInfo(code, args) ⇒ `Contract`

Analyzes contract bytecode and returns contract information based on specified options.

Kind: global function
Returns: Contract - Analyzed contract information

Param	Type	Description
code	`string`	Runtime bytecode as a hex string
args	`Object`	Configuration options for the analysis
[args.selectors]	`boolean`	When true, includes function selectors in the output
[args.arguments]	`boolean`	When true, includes function arguments information
[args.stateMutability]	`boolean`	When true, includes state mutability information for functions
[args.storage]	`boolean`	When true, includes contract storage layout information
[args.disassemble]	`boolean`	When true, includes disassembled bytecode
[args.basicBlocks]	`boolean`	When true, includes basic block analysis
[args.controlFlowGraph]	`boolean`	When true, includes control flow graph analysis