feat: add blst bindings

bench/blst.bench.ts

@@ -0,0 +1,107 @@
+import {describe, bench} from "@chainsafe/benchmark";
+
+import * as blst from "../src/blst.ts";
+import * as other from "@chainsafe/blst";
+
+describe("blst", () => {
+  const ikm = new Uint8Array(32);
+  bench("blst - keygen", () => {
+    blst.SecretKey.fromKeygen(ikm);
+  });
+  bench("other - keygen", () => {
+    other.SecretKey.fromKeygen(ikm);
+  });
+
+  bench({
+    id: "blst - sign",
+    beforeEach: () => {
+      const sk = blst.SecretKey.fromKeygen(ikm);
+      return {sk, msg: new Uint8Array(32)};
+    },
+    fn: ({sk, msg}) => {
+      sk.sign(msg);
+    },
+  });
+  bench({
+    id: "other - sign",
+    beforeEach: () => {
+      const sk = other.SecretKey.fromKeygen(ikm);
+      return {sk, msg: new Uint8Array(32)};
+    },
+    fn: ({sk, msg}) => {
+      sk.sign(msg);
+    },
+  });
+
+  bench({
+    id: "blst - verify",
+    beforeEach: () => {
+      const sk = blst.SecretKey.fromKeygen(ikm);
+      const pk = sk.toPublicKey();
+      const msg = new Uint8Array(32);
+      const sig = sk.sign(msg);
+      return {pk, msg, sig};
+    },
+    fn: ({pk, msg, sig}) => {
+      sig.verify(msg, pk, true, true);
+    },
+  });
+  bench({
+    id: "other - verify",
+    beforeEach: () => {
+      const sk = other.SecretKey.fromKeygen(ikm);
+      const pk = sk.toPublicKey();
+      const msg = new Uint8Array(32);
+      const sig = sk.sign(msg);
+      return {pk, msg, sig};
+    },
+    fn: ({pk, msg, sig}) => {
+      other.verify(msg, pk, sig, true, true);
+    },
+  });
+
+  bench({
+    id: "blst - aggregateVerify 16",
+    beforeEach: () => {
+      const sks = [];
+      const pks = [];
+      const sigs = [];
+      const msgs = [];
+      for (let i = 0; i < 16; i++) {
+        const sk = blst.SecretKey.fromKeygen(ikm);
+        sks.push(sk);
+        pks.push(sk.toPublicKey());
+        const msg = new Uint8Array(32);
+        msgs.push(msg);
+        sigs.push(sk.sign(msg));
+      }
+      const aggSig = blst.aggregateSignatures(sigs, true);
+      return {pks, msgs, aggSig};
+    },
+    fn: ({pks, msgs, aggSig}) => {
+      aggSig.aggregateVerify(msgs, pks, true, true);
+    },
+  });
+  bench({
+    id: "other - aggregateVerify 16",
+    beforeEach: () => {
+      const sks = [];
+      const pks = [];
+      const sigs = [];
+      const msgs = [];
+      for (let i = 0; i < 16; i++) {
+        const sk = other.SecretKey.fromKeygen(ikm);
+        sks.push(sk);
+        pks.push(sk.toPublicKey());
+        const msg = new Uint8Array(32);
+        msgs.push(msg);
+        sigs.push(sk.sign(msg));
+      }
+      const aggSig = other.aggregateSignatures(sigs, true);
+      return {pks, msgs, aggSig};
+    },
+    fn: ({pks, msgs, aggSig}) => {
+      other.aggregateVerify(msgs, pks, aggSig, true, true);
+    },
+  });
+});

build.zig

@@ -6,6 +6,8 @@ pub fn build(b: *std.Build) void {
     const target = b.standardTargetOptions(.{});
     const optimize = b.standardOptimizeOption(.{});
 
+    const dep_blst = b.dependency("blst", .{});
+
     const dep_hashtree = b.dependency("hashtree", .{});
 
     const dep_leveldb = b.dependency("leveldb", .{});
@@ -53,5 +55,6 @@ pub fn build(b: *std.Build) void {
     module_lodestar_z_bun.addImport("hashtree", dep_hashtree.module("hashtree"));
     module_lodestar_z_bun.addImport("lmdb", dep_lmdb.module("lmdb"));
     module_lodestar_z_bun.addImport("leveldb", dep_leveldb.module("leveldb"));
+    module_lodestar_z_bun.addImport("blst", dep_blst.module("blst"));
     module_lodestar_z_bun.addImport("ssz:persistent_merkle_tree", dep_ssz.module("persistent_merkle_tree"));
 }

build.zig.zon

@@ -6,6 +6,10 @@
     .fingerprint = 0xed854bdae2354180,
     .minimum_zig_version = "0.14.1",
     .dependencies = .{
+        .blst = .{
+            .url = "git+https://github.com/Chainsafe/blst-z#ea0ae943083ba24b6a3d60051f971d28d7ed560f",
+            .hash = "blst_z-0.0.0-td3FNAHEAACXKlQ_b8Dw6-4-_2zN1sxo5PcDIuZgnaMw",
+        },
         .hashtree = .{
             .url = "git+https://github.com/chainsafe/hashtree-z#43a58b0fd4813515cda3d0ffc622125243a01c54",
             .hash = "hashtree-0.1.0-sBOovrYSAAArAQVa-a6BhOPWPTrgKrJtufxWjQYMNNAN",

bun.lock

@@ -9,6 +9,7 @@
       "devDependencies": {
         "@chainsafe/as-sha256": "^1.2.0",
         "@chainsafe/benchmark": "^2.0.1",
+        "@chainsafe/blst": "^2.2.0",
         "@chainsafe/hashtree": "^1.0.2",
         "@types/bun": "latest",
         "bigint-buffer": "^1.1.5",
@@ -65,6 +66,22 @@
 
     "@chainsafe/benchmark": ["@chainsafe/[email protected]", "", { "dependencies": { "@actions/cache": "^4.0.0", "@actions/github": "^6.0.0", "@vitest/runner": "^2.1.8", "ajv": "^8.17.1", "aws-sdk": "^2.932.0", "cli-table3": "^0.6.5", "csv-parse": "^5.6.0", "csv-stringify": "^6.5.2", "debug": "^4.4.0", "glob": "^10.4.5", "log-symbols": "^7.0.0", "yaml": "^2.7.0", "yargs": "^17.7.2" }, "bin": { "benchmark": "bin/index.js" } }, "sha512-Noecu9z6kjXWdKl9ZL/PckJxfi+Ax4/8/i4F862jo3FZcViK8LWR5Byc8pKeNC5vcDMSP73/ME3vgUovYGqwUw=="],
 
+    "@chainsafe/blst": ["@chainsafe/[email protected]", "", { "optionalDependencies": { "@chainsafe/blst-darwin-arm64": "2.2.0", "@chainsafe/blst-darwin-x64": "2.2.0", "@chainsafe/blst-linux-arm64-gnu": "2.2.0", "@chainsafe/blst-linux-arm64-musl": "2.2.0", "@chainsafe/blst-linux-x64-gnu": "2.2.0", "@chainsafe/blst-linux-x64-musl": "2.2.0", "@chainsafe/blst-win32-x64-msvc": "2.2.0" } }, "sha512-VBaQoNE2a9d9+skAjQKv3Suk0yGKqp3mZM0YWYJNPj/Ae/f6lAyeVSgKqo2LrsNQBzD/LqrJLKUY8rJT3vDKLA=="],
+
+    "@chainsafe/blst-darwin-arm64": ["@chainsafe/[email protected]", "", { "os": "darwin", "cpu": "arm64" }, "sha512-BOOy2KHbV028cioPWaAMqHdLRKd6/3XyEmUEcQC2E/SpyYLdNcaKiBUYIU4pT9CrWBbJJxX68UI+3vZVg0M8/w=="],
+
+    "@chainsafe/blst-darwin-x64": ["@chainsafe/[email protected]", "", { "os": "darwin", "cpu": "x64" }, "sha512-jG64cwIdPT7u/haRrW26tWCpfMfHBQCfGY169mFQifCwO4VEwvaiVBPOh5olFis6LjpcmD+O0jpM8GqrnsmUHQ=="],
+
+    "@chainsafe/blst-linux-arm64-gnu": ["@chainsafe/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-L8xV2uuLn8we76vdzfryS9ePdheuZrmY6yArGUFaF1Uzcwml6V1/VvyPl9/uooo/YfVRIrvF/D+lQfI2GFAnhw=="],
+
+    "@chainsafe/blst-linux-arm64-musl": ["@chainsafe/[email protected]", "", { "os": "linux", "cpu": "arm64" }, "sha512-0Vn0luxLYVgC3lvWT1MapFHSAoz99PldqjhilXTGv0AcAk/X5LXPH2RC9Dp2KJGqthyUkpbk1j47jUBfBI+BIg=="],
+
+    "@chainsafe/blst-linux-x64-gnu": ["@chainsafe/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-gEY/z2SDBA7kXtFEI9VNhWTJAIjx16jdeAyCaS2k4ACGurWZaWk+Ee4KniTsr4WieSqeuNTUr7Pdja0Sr4EKNQ=="],
+
+    "@chainsafe/blst-linux-x64-musl": ["@chainsafe/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-58GKtiUmtVSuerRzPEcMNQZpICPboBKFnL7+1Wo+PSuajkvbae7tEFrFTtWeMoKIPgOEsPMnk96LF+0yNgavUg=="],
+
+    "@chainsafe/blst-win32-x64-msvc": ["@chainsafe/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-UFrZshl4dfX5Uh2zeKXAZtrkQ+otczHMON2tsrapQNICWmfHZrzE6pKuBL+9QeGAbgflwpbz7+D5nQRDpiuHxQ=="],
+
     "@chainsafe/bun-ffi-z": ["@chainsafe/[email protected]", "", { "peerDependencies": { "typescript": "^5" }, "bin": { "bun-ffi-z": "src/cli.ts" } }, "sha512-yegYWjcj9pMwrf554iuFGoUc+Kq8EWDrVpeGiPl/nmXu/lm5EaUzxsiLG6WR1J9tpTQk012213y9RA5PwDrUTQ=="],
 
     "@chainsafe/hashtree": ["@chainsafe/[email protected]", "", { "optionalDependencies": { "@chainsafe/hashtree-darwin-arm64": "1.0.2", "@chainsafe/hashtree-linux-arm64-gnu": "1.0.2", "@chainsafe/hashtree-linux-arm64-musl": "1.0.2", "@chainsafe/hashtree-linux-x64-gnu": "1.0.2", "@chainsafe/hashtree-linux-x64-musl": "1.0.2", "@chainsafe/hashtree-win32-x64-msvc": "1.0.2" } }, "sha512-OaWjsZ6S/GaT2RvaqdpsF5Mux8qQOE2KbitX2yHmQJZNUZkdh7C3N4PA5LsvewqX+z8Nkv8mr1uSe0LSrHGiQw=="],

package.json

@@ -15,6 +15,7 @@
   "devDependencies": {
     "@chainsafe/as-sha256": "^1.2.0",
     "@chainsafe/benchmark": "^2.0.1",
+    "@chainsafe/blst": "^2.2.0",
     "@chainsafe/hashtree": "^1.0.2",
     "@types/bun": "latest",
     "bigint-buffer": "^1.1.5"

src/binding.ts

@@ -397,6 +397,213 @@ const fns = {
     ],
     "returns": "i32"
   },
+  "secretKeyFromBytes": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyToBytes": {
+    "args": [
+      "ptr",
+      "ptr"
+    ],
+    "returns": "void"
+  },
+  "secretKeyKeyGen": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyKeyGenV3": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyKeyGenV45": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyDeriveMasterEip2333": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyDeriveChildEip2333": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "secretKeyToPublicKey": {
+    "args": [
+      "ptr",
+      "ptr"
+    ],
+    "returns": "void"
+  },
+  "secretKeySign": {
+    "args": [
+      "ptr",
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "publicKeyFromBytes": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "publicKeyToBytes": {
+    "args": [
+      "ptr",
+      "ptr"
+    ],
+    "returns": "void"
+  },
+  "publicKeyValidate": {
+    "args": [
+      "ptr"
+    ],
+    "returns": "i32"
+  },
+  "aggregateWithRandomness": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "ptr",
+      "ptr",
+      "bool",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "publicKeyAggregateWithRandomness": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "publicKeyAggregate": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureFromBytes": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "signatureToBytes": {
+    "args": [
+      "ptr",
+      "ptr"
+    ],
+    "returns": "void"
+  },
+  "signatureValidate": {
+    "args": [
+      "ptr",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureVerify": {
+    "args": [
+      "ptr",
+      "bool",
+      "ptr",
+      "u32",
+      "ptr",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureAggregateVerify": {
+    "args": [
+      "ptr",
+      "bool",
+      "ptr",
+      "ptr",
+      "u32",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureFastAggregateVerify": {
+    "args": [
+      "ptr",
+      "bool",
+      "ptr",
+      "ptr",
+      "u32"
+    ],
+    "returns": "i32"
+  },
+  "signatureVerifyMultipleAggregateSignatures": {
+    "args": [
+      "u32",
+      "ptr",
+      "ptr",
+      "bool",
+      "ptr",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureAggregateWithRandomness": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "bool"
+    ],
+    "returns": "i32"
+  },
+  "signatureAggregate": {
+    "args": [
+      "ptr",
+      "ptr",
+      "u32",
+      "bool"
+    ],
+    "returns": "i32"
+  },
   "err_name": {
     "args": [
       "u16"

src/blst.ts

@@ -0,0 +1,7 @@
+export * from "./blst/publicKey.ts";
+export * from "./blst/secretKey.ts";
+export * from "./blst/signature.ts";
+export * from "./blst/aggregateWithRandomness.ts";
+export * from "./blst/verifyMultipleAggregateSignatures.ts";
+export * from "./blst/aggregate.ts";
+export * from "./blst/const.ts";