feat: add napi bindings

.github/workflows/CI.yml

@@ -14,6 +14,7 @@ concurrency:
 
 env:
   ZIG_VERSION: "0.14.1"
+  NODE_VERSION: "24"
 
 jobs:
   zbuild:
@@ -223,3 +224,42 @@ jobs:
       - name: Run spec tests - mainnet
         run: |
           zig build test:spec_tests -Dpreset=mainnet
+
+  bindings-test:
+    name: bindings - test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+      - name: Install dependencies
+        run: |
+          pnpm install
+      - name: Run bindings formatter
+        run: |
+          pnpm biome ci
+      - name: Install Zig
+        uses: mlugg/setup-zig@v2
+        with:
+          version: ${{ env.ZIG_VERSION }}
+          cache-key: ubuntu-latest-${{ env.ZIG_VERSION }}
+      - name: Build bindings
+        run: |
+          zig build build-lib:bindings
+      - name: Restore era files cache
+        uses: actions/cache@v4
+        with:
+          path: fixtures/era
+          key: era-files-${{ hashFiles('build.zig') }} # downloaded era files defined in build.zig
+      - name: Download era files
+        run: |
+          zig build run:download_era_files
+      - name: Test bindings
+        run: |
+          pnpm test

.github/workflows/publish-bindings.yml

@@ -0,0 +1,39 @@
+name: Publish NAPI Bindings
+on:
+  workflow_dispatch:
+
+env:
+  ZIG_VERSION: "0.14.1"
+  NODE_VERSION: "24"
+
+jobs:
+  publish-bindings:
+    name: publish bindings
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: pnpm
+      - name: Install dependencies
+        run: |
+          pnpm install
+      - name: Run bindings formatter
+        run: |
+          pnpm biome ci
+      - name: Install Zig
+        uses: mlugg/setup-zig@v2
+        with:
+          version: ${{ env.ZIG_VERSION }}
+          cache-key: ubuntu-latest-${{ env.ZIG_VERSION }}
+      - name: Build and publish to npm
+        run: |
+          pnpm zapi build-artifacts --optimize ReleaseSafe
+          pnpm zapi prepublish
+          pnpm zapi publish --access public
+

.gitignore

@@ -6,8 +6,12 @@ test/spec/test_case/
 test/spec/ssz/generic_tests.zig
 test/spec/ssz/static_tests.zig
 *.era
+*.pkix
 
 # perf
 flamegraph.html
 perf.data
 perf.data.old
+
+# js
+node_modules/

bench/state_transition/process_block.zig

@@ -19,7 +19,6 @@ const BeaconBlock = fork_types.BeaconBlock;
 const BeaconBlockBody = fork_types.BeaconBlockBody;
 const AnyBeaconState = fork_types.AnyBeaconState;
 const ValidatorIndex = types.primitive.ValidatorIndex.Type;
-const PubkeyIndexMap = state_transition.PubkeyIndexMap(ValidatorIndex);
 const Withdrawals = types.capella.Withdrawals.Type;
 const WithdrawalsResult = state_transition.WithdrawalsResult;
 const BlockExternalData = state_transition.BlockExternalData;
@@ -513,7 +512,7 @@ fn runBenchmark(
 
     const beacon_config = config.BeaconConfig.init(chain_config, (try beacon_state.?.genesisValidatorsRoot()).*);
 
-    const pubkey_index_map = try PubkeyIndexMap.init(allocator);
+    var pubkey_index_map = state_transition.PubkeyIndexMap.init(allocator);
     defer pubkey_index_map.deinit();
 
     const index_pubkey_cache = try allocator.create(state_transition.Index2PubkeyCache);
@@ -526,12 +525,12 @@ fn runBenchmark(
     const validators = try beacon_state.?.validatorsSlice(allocator);
     defer allocator.free(validators);
 
-    try state_transition.syncPubkeys(validators, pubkey_index_map, index_pubkey_cache);
+    try state_transition.syncPubkeys(validators, &pubkey_index_map, &index_pubkey_cache);
 
     const cached_state = try CachedBeaconState.createCachedBeaconState(allocator, beacon_state.?, .{
         .config = &beacon_config,
-        .index_to_pubkey = index_pubkey_cache,
-        .pubkey_to_index = pubkey_index_map,
+        .index_to_pubkey = &index_pubkey_cache,
+        .pubkey_to_index = &pubkey_index_map,
     }, .{ .skip_sync_committee_cache = !comptime fork.gte(.altair), .skip_sync_pubkeys = false });
     beacon_state = null;
     defer {

bench/state_transition/process_epoch.zig

@@ -16,7 +16,6 @@ const ForkSeq = config.ForkSeq;
 const CachedBeaconState = state_transition.CachedBeaconState;
 const EpochTransitionCache = state_transition.EpochTransitionCache;
 const ValidatorIndex = types.primitive.ValidatorIndex.Type;
-const PubkeyIndexMap = state_transition.PubkeyIndexMap(ValidatorIndex);
 const slotFromStateBytes = @import("utils.zig").slotFromStateBytes;
 const loadState = @import("utils.zig").loadState;
 
@@ -686,7 +685,7 @@ fn runBenchmark(
 
     const beacon_config = config.BeaconConfig.init(chain_config, (try beacon_state.?.genesisValidatorsRoot()).*);
 
-    const pubkey_index_map = try PubkeyIndexMap.init(allocator);
+    var pubkey_index_map = state_transition.PubkeyIndexMap.init(allocator);
     defer pubkey_index_map.deinit();
 
     const index_pubkey_cache = try allocator.create(state_transition.Index2PubkeyCache);
@@ -699,12 +698,12 @@ fn runBenchmark(
     const validators = try beacon_state.?.validatorsSlice(allocator);
     defer allocator.free(validators);
 
-    try state_transition.syncPubkeys(validators, pubkey_index_map, index_pubkey_cache);
+    try state_transition.syncPubkeys(validators, &pubkey_index_map, &index_pubkey_cache);
 
     const immutable_data = state_transition.EpochCacheImmutableData{
         .config = &beacon_config,
-        .index_to_pubkey = index_pubkey_cache,
-        .pubkey_to_index = pubkey_index_map,
+        .index_to_pubkey = &index_pubkey_cache,
+        .pubkey_to_index = &pubkey_index_map,
     };
 
     const cached_state = try CachedBeaconState.createCachedBeaconState(allocator, beacon_state.?, immutable_data, .{