@aztec/native 0.73.0

package/README.md

@@ -0,0 +1,3 @@
+# Native module
+
+A package containing all the native bindings needed to run Aztec.

package/dest/index.d.ts

@@ -0,0 +1,3 @@
+export * from './native_module.js';
+export { RoundtripDuration, MsgpackChannel } from './msgpack_channel.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dest/index.js

@@ -0,0 +1,3 @@
+export * from './native_module.js';
+export { MsgpackChannel } from './msgpack_channel.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxPQUFPLEVBQXFCLGNBQWMsRUFBRSxNQUFNLHNCQUFzQixDQUFDIn0=

package/dest/msgpack_channel.d.ts

@@ -0,0 +1,27 @@
+/// <reference types="node" resolution-mode="require"/>
+/// <reference types="node" resolution-mode="require"/>
+export interface MessageReceiver {
+    call(msg: Buffer | Uint8Array): Promise<Buffer | Uint8Array>;
+}
+export type RoundtripDuration = {
+    encodingUs: number;
+    callUs: number;
+    decodingUs: number;
+    totalUs: number;
+};
+type MessageBody<T extends number> = {
+    [K in T]: object | void;
+};
+export declare class MsgpackChannel<M extends number = number, Req extends MessageBody<M> = any, Resp extends MessageBody<M> = any> {
+    private dest;
+    /** A long-lived msgpack encoder */
+    private encoder;
+    private msgId;
+    constructor(dest: MessageReceiver);
+    sendMessage<T extends M>(msgType: T, body: Req[T]): Promise<{
+        duration: RoundtripDuration;
+        response: Resp[T];
+    }>;
+}
+export {};
+//# sourceMappingURL=msgpack_channel.d.ts.map

package/dest/msgpack_channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack_channel.d.ts","sourceRoot":"","sources":["../src/msgpack_channel.ts"],"names":[],"mappings":";;AAMA,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;CAC9D;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAYF,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI;KAAG,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI;CAAE,CAAC;AAEjE,qBAAa,cAAc,CACzB,CAAC,SAAS,MAAM,GAAG,MAAM,EACzB,GAAG,SAAS,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,EAChC,IAAI,SAAS,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG;IAYd,OAAO,CAAC,IAAI;IAV/B,mCAAmC;IACnC,OAAO,CAAC,OAAO,CAKZ;IAEH,OAAO,CAAC,KAAK,CAAK;gBAES,IAAI,EAAE,eAAe;IAEnC,WAAW,CAAC,CAAC,SAAS,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,GACX,OAAO,CAAC;QAAE,QAAQ,EAAE,iBAAiB,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;CA2D/D"}

package/dest/msgpack_channel.js

@@ -0,0 +1,69 @@
+import { Fr } from '@aztec/foundation/fields';
+import { MessageHeader, TypedMessage } from '@aztec/foundation/message';
+import { Encoder, addExtension } from 'msgpackr';
+import { isAnyArrayBuffer } from 'util/types';
+// small extension to pack an NodeJS Fr instance to a representation that the C++ code can understand
+// this only works for writes. Unpacking from C++ can't create Fr instances because the data is passed
+// as raw, untagged, buffers. On the NodeJS side we don't know what the buffer represents
+// Adding a tag would be a solution, but it would have to be done on both sides and it's unclear where else
+// C++ fr instances are sent/received/stored.
+addExtension({
+    Class: Fr,
+    write: fr => fr.toBuffer(),
+});
+export class MsgpackChannel {
+    constructor(dest) {
+        this.dest = dest;
+        /** A long-lived msgpack encoder */
+        this.encoder = new Encoder({
+            // always encode JS objects as MessagePack maps
+            // this makes it compatible with other MessagePack decoders
+            useRecords: false,
+            int64AsType: 'bigint',
+        });
+        this.msgId = 1;
+    }
+    async sendMessage(msgType, body) {
+        const duration = {
+            callUs: 0,
+            totalUs: 0,
+            decodingUs: 0,
+            encodingUs: 0,
+        };
+        const start = process.hrtime.bigint();
+        const requestId = this.msgId++;
+        const request = new TypedMessage(msgType, new MessageHeader({ requestId }), body);
+        const encodedRequest = this.encoder.encode(request);
+        const encodingEnd = process.hrtime.bigint();
+        duration.encodingUs = Number((encodingEnd - start) / 1000n);
+        const encodedResponse = await this.dest.call(encodedRequest);
+        const callEnd = process.hrtime.bigint();
+        duration.callUs = Number((callEnd - encodingEnd) / 1000n);
+        const buf = Buffer.isBuffer(encodedResponse)
+            ? encodedResponse
+            : isAnyArrayBuffer(encodedResponse)
+                ? Buffer.from(encodedResponse)
+                : encodedResponse;
+        if (!Buffer.isBuffer(buf)) {
+            throw new TypeError('Invalid encoded response: expected Buffer or ArrayBuffer, got ' +
+                (encodedResponse === null ? 'null' : typeof encodedResponse));
+        }
+        const decodedResponse = this.encoder.unpack(buf);
+        if (!TypedMessage.isTypedMessageLike(decodedResponse)) {
+            throw new TypeError('Invalid response: expected TypedMessageLike, got ' +
+                (decodedResponse === null ? 'null' : typeof decodedResponse));
+        }
+        const response = TypedMessage.fromMessagePack(decodedResponse);
+        const decodingEnd = process.hrtime.bigint();
+        duration.decodingUs = Number((decodingEnd - callEnd) / 1000n);
+        if (response.header.requestId !== request.header.messageId) {
+            throw new Error('Response ID does not match request: ' + response.header.requestId + ' != ' + request.header.messageId);
+        }
+        if (response.msgType !== request.msgType) {
+            throw new Error('Invalid response message type: ' + response.msgType + ' != ' + response.msgType);
+        }
+        duration.totalUs = Number((process.hrtime.bigint() - start) / 1000n);
+        return { duration, response: response.value };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXNncGFja19jaGFubmVsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL21zZ3BhY2tfY2hhbm5lbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUMsT0FBTyxFQUFFLGFBQWEsRUFBRSxZQUFZLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUV4RSxPQUFPLEVBQUUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLFVBQVUsQ0FBQztBQUNqRCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxZQUFZLENBQUM7QUFhOUMscUdBQXFHO0FBQ3JHLHNHQUFzRztBQUN0Ryx5RkFBeUY7QUFDekYsMkdBQTJHO0FBQzNHLDZDQUE2QztBQUM3QyxZQUFZLENBQUM7SUFDWCxLQUFLLEVBQUUsRUFBRTtJQUNULEtBQUssRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxRQUFRLEVBQUU7Q0FDM0IsQ0FBQyxDQUFDO0FBSUgsTUFBTSxPQUFPLGNBQWM7SUFlekIsWUFBMkIsSUFBcUI7UUFBckIsU0FBSSxHQUFKLElBQUksQ0FBaUI7UUFWaEQsbUNBQW1DO1FBQzNCLFlBQU8sR0FBRyxJQUFJLE9BQU8sQ0FBQztZQUM1QiwrQ0FBK0M7WUFDL0MsMkRBQTJEO1lBQzNELFVBQVUsRUFBRSxLQUFLO1lBQ2pCLFdBQVcsRUFBRSxRQUFRO1NBQ3RCLENBQUMsQ0FBQztRQUVLLFVBQUssR0FBRyxDQUFDLENBQUM7SUFFaUMsQ0FBQztJQUU3QyxLQUFLLENBQUMsV0FBVyxDQUN0QixPQUFVLEVBQ1YsSUFBWTtRQUVaLE1BQU0sUUFBUSxHQUFzQjtZQUNsQyxNQUFNLEVBQUUsQ0FBQztZQUNULE9BQU8sRUFBRSxDQUFDO1lBQ1YsVUFBVSxFQUFFLENBQUM7WUFDYixVQUFVLEVBQUUsQ0FBQztTQUNkLENBQUM7UUFFRixNQUFNLEtBQUssR0FBRyxPQUFPLENBQUMsTUFBTSxD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

package/dest/native_module.d.ts

@@ -0,0 +1,8 @@
+import { type MessageReceiver } from './msgpack_channel.js';
+interface NativeClassCtor {
+    new (...args: unknown[]): MessageReceiver;
+}
+export declare const NativeWorldState: NativeClassCtor;
+export declare const NativeLMDBStore: NativeClassCtor;
+export {};
+//# sourceMappingURL=native_module.d.ts.map

package/dest/native_module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_module.d.ts","sourceRoot":"","sources":["../src/native_module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,UAAU,eAAe;IACvB,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;CAC3C;AAID,eAAO,MAAM,gBAAgB,EAAE,eAAyC,CAAC;AACzE,eAAO,MAAM,eAAe,EAAE,eAAwC,CAAC"}

package/dest/native_module.js

@@ -0,0 +1,5 @@
+import bindings from 'bindings';
+const nativeModule = bindings('nodejs_module');
+export const NativeWorldState = nativeModule.WorldState;
+export const NativeLMDBStore = nativeModule.LMDBStore;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmF0aXZlX21vZHVsZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9uYXRpdmVfbW9kdWxlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sUUFBUSxNQUFNLFVBQVUsQ0FBQztBQVFoQyxNQUFNLFlBQVksR0FBb0MsUUFBUSxDQUFDLGVBQWUsQ0FBQyxDQUFDO0FBRWhGLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFvQixZQUFZLENBQUMsVUFBVSxDQUFDO0FBQ3pFLE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBb0IsWUFBWSxDQUFDLFNBQVMsQ0FBQyJ9

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@aztec/native",
+  "version": "0.73.0",
+  "type": "module",
+  "exports": {
+    ".": "./dest/index.js"
+  },
+  "scripts": {
+    "build": "yarn clean && yarn generate && tsc -b",
+    "build:dev": "tsc -b --watch",
+    "build:cpp": "PROJECT=$(pwd); cd $(git rev-parse --show-toplevel)/barretenberg/cpp; cmake --preset ${PRESET:-clang16-pic} && cmake --build --preset ${PRESET:-clang16-pic} --target nodejs_module && cd $PROJECT && yarn generate",
+    "clean:cpp": "rm -rf $(git rev-parse --show-toplevel)/barretenberg/cpp/build-pic",
+    "clean": "rm -rf ./dest .tsbuildinfo",
+    "formatting": "run -T prettier --check ./src && run -T eslint ./src",
+    "formatting:fix": "run -T eslint --fix ./src && run -T prettier -w ./src",
+    "test": "HARDWARE_CONCURRENCY=${HARDWARE_CONCURRENCY:-16} RAYON_NUM_THREADS=${RAYON_NUM_THREADS:-4} NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}",
+    "generate": "mkdir -p build && cp -v $(git rev-parse --show-toplevel)/barretenberg/cpp/build-pic/lib/nodejs_module.node build"
+  },
+  "inherits": [
+    "../package.common.json",
+    "./package.local.json"
+  ],
+  "dependencies": {
+    "@aztec/foundation": "0.73.0",
+    "bindings": "^1.5.0",
+    "msgpackr": "^1.11.2"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.5.0",
+    "@types/bindings": "^1.5.5",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^18.7.23",
+    "jest": "^29.5.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.4"
+  },
+  "files": [
+    "dest",
+    "src",
+    "!*.test.*"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "jest": {
+    "extensionsToTreatAsEsm": [
+      ".ts"
+    ],
+    "transform": {
+      "^.+\\.tsx?$": [
+        "@swc/jest",
+        {
+          "jsc": {
+            "parser": {
+              "syntax": "typescript",
+              "decorators": true
+            },
+            "transform": {
+              "decoratorVersion": "2022-03"
+            }
+          }
+        }
+      ]
+    },
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.[cm]?js$": "$1"
+    },
+    "reporters": [
+      "default"
+    ],
+    "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
+    "rootDir": "./src",
+    "testTimeout": 30000,
+    "setupFiles": [
+      "../../foundation/src/jest/setup.mjs"
+    ]
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './native_module.js';
+export { RoundtripDuration, MsgpackChannel } from './msgpack_channel.js';

package/src/msgpack_channel.ts

@@ -0,0 +1,109 @@
+import { Fr } from '@aztec/foundation/fields';
+import { MessageHeader, TypedMessage } from '@aztec/foundation/message';
+
+import { Encoder, addExtension } from 'msgpackr';
+import { isAnyArrayBuffer } from 'util/types';
+
+export interface MessageReceiver {
+  call(msg: Buffer | Uint8Array): Promise<Buffer | Uint8Array>;
+}
+
+export type RoundtripDuration = {
+  encodingUs: number;
+  callUs: number;
+  decodingUs: number;
+  totalUs: number;
+};
+
+// small extension to pack an NodeJS Fr instance to a representation that the C++ code can understand
+// this only works for writes. Unpacking from C++ can't create Fr instances because the data is passed
+// as raw, untagged, buffers. On the NodeJS side we don't know what the buffer represents
+// Adding a tag would be a solution, but it would have to be done on both sides and it's unclear where else
+// C++ fr instances are sent/received/stored.
+addExtension({
+  Class: Fr,
+  write: fr => fr.toBuffer(),
+});
+
+type MessageBody<T extends number> = { [K in T]: object | void };
+
+export class MsgpackChannel<
+  M extends number = number,
+  Req extends MessageBody<M> = any,
+  Resp extends MessageBody<M> = any,
+> {
+  /** A long-lived msgpack encoder */
+  private encoder = new Encoder({
+    // always encode JS objects as MessagePack maps
+    // this makes it compatible with other MessagePack decoders
+    useRecords: false,
+    int64AsType: 'bigint',
+  });
+
+  private msgId = 1;
+
+  public constructor(private dest: MessageReceiver) {}
+
+  public async sendMessage<T extends M>(
+    msgType: T,
+    body: Req[T],
+  ): Promise<{ duration: RoundtripDuration; response: Resp[T] }> {
+    const duration: RoundtripDuration = {
+      callUs: 0,
+      totalUs: 0,
+      decodingUs: 0,
+      encodingUs: 0,
+    };
+
+    const start = process.hrtime.bigint();
+    const requestId = this.msgId++;
+
+    const request = new TypedMessage(msgType, new MessageHeader({ requestId }), body);
+    const encodedRequest = this.encoder.encode(request);
+    const encodingEnd = process.hrtime.bigint();
+    duration.encodingUs = Number((encodingEnd - start) / 1000n);
+
+    const encodedResponse = await this.dest.call(encodedRequest);
+    const callEnd = process.hrtime.bigint();
+    duration.callUs = Number((callEnd - encodingEnd) / 1000n);
+
+    const buf = Buffer.isBuffer(encodedResponse)
+      ? encodedResponse
+      : isAnyArrayBuffer(encodedResponse)
+      ? Buffer.from(encodedResponse)
+      : encodedResponse;
+
+    if (!Buffer.isBuffer(buf)) {
+      throw new TypeError(
+        'Invalid encoded response: expected Buffer or ArrayBuffer, got ' +
+          (encodedResponse === null ? 'null' : typeof encodedResponse),
+      );
+    }
+
+    const decodedResponse = this.encoder.unpack(buf);
+    if (!TypedMessage.isTypedMessageLike(decodedResponse)) {
+      throw new TypeError(
+        'Invalid response: expected TypedMessageLike, got ' +
+          (decodedResponse === null ? 'null' : typeof decodedResponse),
+      );
+    }
+
+    const response = TypedMessage.fromMessagePack<T, Resp[T]>(decodedResponse);
+    const decodingEnd = process.hrtime.bigint();
+    duration.decodingUs = Number((decodingEnd - callEnd) / 1000n);
+
+    if (response.header.requestId !== request.header.messageId) {
+      throw new Error(
+        'Response ID does not match request: ' + response.header.requestId + ' != ' + request.header.messageId,
+      );
+    }
+
+    if (response.msgType !== request.msgType) {
+      throw new Error('Invalid response message type: ' + response.msgType + ' != ' + response.msgType);
+    }
+
+    duration.totalUs = Number((process.hrtime.bigint() - start) / 1000n);
+
+    return { duration, response: response.value };
+  }
+}

package/src/native_module.ts

@@ -0,0 +1,12 @@
+import bindings from 'bindings';
+
+import { type MessageReceiver } from './msgpack_channel.js';
+
+interface NativeClassCtor {
+  new (...args: unknown[]): MessageReceiver;
+}
+
+const nativeModule: Record<string, NativeClassCtor> = bindings('nodejs_module');
+
+export const NativeWorldState: NativeClassCtor = nativeModule.WorldState;
+export const NativeLMDBStore: NativeClassCtor = nativeModule.LMDBStore;