add evmole-go

Author: cdump

.github/workflows/build.yml

@@ -3,26 +3,128 @@ name: build
 on:
   push:
   pull_request:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to release (e.g., 0.9.0)'
+        required: true
+        type: string
 
 env:
   MATURIN_VERSION: 1.10.0
 
 jobs:
+  prepare-release:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate version format
+        run: |
+          if ! echo "${{ inputs.version }}" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+$'; then
+            echo "Error: Invalid version format. Expected semver like 0.9.0"
+            exit 1
+          fi
+
+      - name: Check tags do not exist
+        run: |
+          if git rev-parse "${{ inputs.version }}" >/dev/null 2>&1; then
+            echo "Error: Tag ${{ inputs.version }} already exists"
+            exit 1
+          fi
+          if git rev-parse "go/v${{ inputs.version }}" >/dev/null 2>&1; then
+            echo "Error: Tag go/v${{ inputs.version }} already exists"
+            exit 1
+          fi
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Update version in Cargo.toml
+        run: sed -i 's/^version = ".*"/version = "${{ inputs.version }}"/' Cargo.toml
+
+      - name: Update version in javascript/package.json
+        run: |
+          sed -i 's/"version": ".*"/"version": "${{ inputs.version }}"/' javascript/package.json
+
+      - name: Build WASM
+        run: cargo build --target wasm32-unknown-unknown --release --features wasm
+
+      - name: Compress WASM
+        run: gzip -9 -c target/wasm32-unknown-unknown/release/evmole.wasm > go/wasm/evmole.wasm.gz
+
+      - name: Configure Git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Commit and Tag
+        run: |
+          git add Cargo.toml Cargo.lock javascript/package.json go/wasm/evmole.wasm.gz
+          git commit -m "release ${{ inputs.version }}"
+          git tag "${{ inputs.version }}"
+          git tag "go/v${{ inputs.version }}"
+          git push origin HEAD:${{ github.ref_name }}
+          git push origin "${{ inputs.version }}"
+          git push origin "go/v${{ inputs.version }}"
+
   rust-test:
     runs-on: ubuntu-latest
+    needs: [prepare-release]
+    if: always() && (needs.prepare-release.result == 'success' || needs.prepare-release.result == 'skipped')
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
       - name: Test and Clippy
         run: |
           cargo fmt --check
           cargo test
           cargo clippy --all-features -- -D warnings
 
+  go-test:
+    runs-on: ubuntu-latest
+    needs: rust-test
+    if: always() && needs.rust-test.result == 'success'
+    strategy:
+      matrix:
+        go-version: ['1.25', 'stable']
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+      - name: Build WASM
+        working-directory: go
+        run: make wasm
+      - name: Run tests
+        working-directory: go
+        run: make test
+
   javascript:
     runs-on: ubuntu-latest
     needs: rust-test
+    if: always() && needs.rust-test.result == 'success'
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
       - name: Install Node
         uses: actions/setup-node@v4
         with:
@@ -53,6 +155,7 @@ jobs:
 
   python-wheel:
     needs: rust-test
+    if: always() && needs.rust-test.result == 'success'
     strategy:
       matrix:
         python-version: ['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']
@@ -69,6 +172,8 @@ jobs:
     runs-on: ${{ matrix.platform.runner }}
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
       - name: Install python
         uses: actions/setup-python@v5
         with:
@@ -94,8 +199,11 @@ jobs:
   python-sdist:
     runs-on: ubuntu-latest
     needs: rust-test
+    if: always() && needs.rust-test.result == 'success'
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
       - name: Install python
         uses: actions/setup-python@v5
         with:
@@ -114,11 +222,15 @@ jobs:
           compression-level: 0
 
   python-sdist-test:
-    # ubuntu-latest image (https://github.com/actions/runner-images/blob/main/images/ubuntu/Ubuntu2404-Readme.md) have Rust installed
     runs-on: ubuntu-latest
     needs: python-sdist
+    if: always() && needs.python-sdist.result == 'success'
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.version || '' }}
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
       - name: Install python
         uses: actions/setup-python@v5
         with:
@@ -134,15 +246,19 @@ jobs:
 
   release:
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'refs/tags/') # only on tagged releases
-    needs: [javascript, python-wheel, python-sdist, python-sdist-test]
+    if: github.event_name == 'workflow_dispatch'
+    needs: [javascript, python-wheel, python-sdist, python-sdist-test, go-test]
     permissions:
       contents: write
       id-token: write
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0 # need tags to generate release notes
+          ref: ${{ inputs.version }}
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
 
       - name: Publish rust
         env:
@@ -177,7 +293,8 @@ jobs:
       - name: Github Release
         uses: softprops/action-gh-release@v2
         with:
-          name: Release ${{ github.ref_name }}
+          tag_name: ${{ inputs.version }}
+          name: Release ${{ inputs.version }}
           draft: false
           prerelease: false
           body_path: changelog.md

.gitignore

@@ -12,3 +12,6 @@ dist/
 target/
 .aider*
 .gradle
+
+# Go WASM - use compressed version only
+go/wasm/evmole.wasm

Cargo.lock

@@ -21,11 +21,13 @@ pyo3 = { version = "0.27", features = ["extension-module"], optional = true }
 wasm-bindgen = { version = "0.2", optional = true }
 serde-wasm-bindgen = { version = "0.6", optional = true }
 serde = { version = "1.0", features = ["derive"], optional = true }
+serde_json = { version = "1.0", optional = true }
 
 [features]
 serde = ["dep:serde"]
 python = ["dep:pyo3"]
 javascript = ["dep:wasm-bindgen", "dep:serde-wasm-bindgen", "serde"]
+wasm = ["serde", "dep:serde_json"]
 
 # for dev
 trace_selectors = []

Cargo.toml

@@ -4,13 +4,14 @@
 [![npm](https://img.shields.io/npm/v/evmole)](https://www.npmjs.com/package/evmole)
 [![Crates.io](https://img.shields.io/crates/v/evmole?color=e9b44f)](https://crates.io/crates/evmole)
 [![PyPI](https://img.shields.io/pypi/v/evmole?color=006dad)](https://pypi.org/project/evmole)
+[![Go](https://img.shields.io/badge/go-pkg-00ADD8)](https://pkg.go.dev/github.com/cdump/evmole/go)
 
 EVMole is a powerful library that extracts information from Ethereum Virtual Machine (EVM) bytecode, including [function selectors](https://docs.soliditylang.org/en/latest/abi-spec.html#function-selector), arguments, [state mutability](https://docs.soliditylang.org/en/latest/contracts.html#state-mutability), and storage layout, even for unverified contracts.
 
 
 ## Key Features
 
-- Multi-language support: Available as [JavaScript](#javascript), [Rust](#rust), and [Python](#python) libraries.
+- Multi-language support: Available as [JavaScript](#javascript), [Rust](#rust), [Python](#python), and [Go](#go) libraries.
 - High accuracy and performance: [Outperforms](#benchmark) existing tools.
 - Broad compatibility: Tested with both Solidity and Vyper compiled contracts.
 - Lightweight: Clean codebase with minimal external dependencies.
@@ -84,6 +85,39 @@ print( contract_info(code, selectors=True, arguments=True, state_mutability=True
 #     ...
 ```
 
+### Go
+[API documentation](./go/#api-reference)
+```sh
+$ go get github.com/cdump/evmole/go
+```
+```go
+package main
+
+import (
+    "context"
+    "encoding/hex"
+    "fmt"
+
+    "github.com/cdump/evmole/go"
+)
+
+func main() {
+    code, _ := hex.DecodeString("6080604052348015600e575f80fd5b50600436106030575f3560e01c80632125b65b146034578063b69ef8a8146044575b5f80fd5b6044603f3660046046565b505050565b005b5f805f606084860312156057575f80fd5b833563ffffffff811681146069575f80fd5b925060208401356001600160a01b03811681146083575f80fd5b915060408401356001600160e01b0381168114609d575f80fd5b80915050925092509256")
+
+    info, _ := evmole.ContractInfo(context.Background(), code, evmole.Options{
+        Selectors:       true,
+        Arguments:       true,
+        StateMutability: true,
+    })
+
+    for _, fn := range info.Functions {
+        fmt.Printf("%s: %s @ %d\n", fn.Selector, *fn.Arguments, fn.BytecodeOffset)
+    }
+    // 2125b65b: uint32,address,uint224 @ 52
+    // b69ef8a8:  @ 68
+}
+```
+
 ### Foundry
 <a href="https://getfoundry.sh/">Foundy's cast</a> uses the Rust implementation of EVMole
 ```sh

README.md

@@ -83,6 +83,7 @@ Run evmole benchmarks on Hetzner Cloud dedicated vCPU servers.
 
 Required:
   -b, --benchmark <name>   Benchmark to run: selectors|arguments|mutability|storage|flow|all
+                           Can be specified multiple times: -b selectors -b arguments
 
 Server (one of):
   -k, --ssh-key <name>     SSH key name - creates new server (must exist in Hetzner account)

benchmark/hetzner-bench.sh

@@ -0,0 +1,26 @@
+.PHONY: build test bench clean wasm
+
+# Build WASM module and copy to go/wasm/
+wasm:
+	cargo build --target wasm32-unknown-unknown --release --features wasm --manifest-path ../Cargo.toml
+	gzip -9 -c ../target/wasm32-unknown-unknown/release/evmole.wasm > wasm/evmole.wasm.gz
+
+# Run tests
+test:
+	go test -v ./...
+
+# Run benchmarks
+bench:
+	go test -bench=. -benchmem ./...
+
+# Build Go package (verify compilation)
+build:
+	go build ./...
+
+# Clean build artifacts
+clean:
+	rm -f wasm/evmole.wasm.gz
+	go clean ./...
+
+# Full rebuild: build WASM and run tests
+all: wasm test