@aztec/txe 0.0.1-commit.d431d1c → 0.0.1-commit.d58ff9d0

package/dest/utils/txe_public_contract_data_source.js

@@ -0,0 +1,51 @@
+export class TXEPublicContractDataSource {
+    blockNumber;
+    contractStore;
+    constructor(blockNumber, contractStore){
+        this.blockNumber = blockNumber;
+        this.contractStore = contractStore;
+    }
+    getBlockNumber() {
+        return Promise.resolve(this.blockNumber);
+    }
+    async getContractClass(id) {
+        const contractClass = await this.contractStore.getContractClassWithPreimage(id);
+        if (!contractClass) {
+            return;
+        }
+        return {
+            id: contractClass.id,
+            artifactHash: contractClass.artifactHash,
+            packedBytecode: contractClass.packedBytecode,
+            privateFunctionsRoot: contractClass.privateFunctionsRoot,
+            version: contractClass.version
+        };
+    }
+    async getBytecodeCommitment(id) {
+        const contractClass = await this.contractStore.getContractClassWithPreimage(id);
+        return contractClass?.publicBytecodeCommitment;
+    }
+    async getContract(address) {
+        const instance = await this.contractStore.getContractInstance(address);
+        // TXE has no contract updates, so the current class always equals the original.
+        return instance && {
+            ...instance,
+            address,
+            currentContractClassId: instance.originalContractClassId
+        };
+    }
+    getContractClassIds() {
+        throw new Error('Method not implemented.');
+    }
+    async getContractArtifact(address) {
+        const instance = await this.getContract(address);
+        return instance && this.contractStore.getContractArtifact(instance.originalContractClassId);
+    }
+    async getDebugFunctionName(address, selector) {
+        const instance = await this.getContract(address);
+        return instance && this.contractStore.getDebugFunctionName(instance.originalContractClassId, selector);
+    }
+    registerContractFunctionSignatures(_signatures) {
+        return Promise.resolve();
+    }
+}

package/dest/worker.bundle.js

@@ -0,0 +1,3 @@
+import { createRequire as __txeCreateRequire } from 'node:module';
+const require = __txeCreateRequire(import.meta.url);
+import{TXEDispatcher,activeSessionCount,createLogger}from"./chunk-GSUKUCKV.js";import{__name}from"./chunk-32UHX7YY.js";import{BackendType,Barretenberg,BarretenbergSync}from"@aztec/bb.js";import{parentPort,workerData}from"node:worker_threads";Barretenberg.initSingleton({backend:BackendType.Wasm,skipSrsInit:!0,threads:1});BarretenbergSync.initSingleton({backend:BackendType.Wasm});if(!parentPort)throw new Error("worker.ts must be loaded as a worker_thread");var port=parentPort,logger=createLogger("txe:worker"),dispatcherOpts={contractStoreSourceDir:workerData.contractStoreSourceDir,schnorrClassId:workerData.schnorrClassId},dispatcher=new TXEDispatcher(logger,dispatcherOpts);function serializeError(err){return err instanceof Error?{message:err.message,name:err.name,stack:err.stack}:{message:String(err)}}__name(serializeError,"serializeError");process.env.TXE_WORKER_MEMSTAT==="1"&&setInterval(()=>{let m=process.memoryUsage();port.postMessage({type:"memstat",sessions:activeSessionCount(),rss:m.rss,heapTotal:m.heapTotal,heapUsed:m.heapUsed,external:m.external,arrayBuffers:m.arrayBuffers})},2e3).unref();port.on("message",msg=>{switch(msg.type){case"foreign-call":(async()=>{try{let value=await dispatcher.resolve_foreign_call(msg.callData);port.postMessage({type:"result",requestId:msg.requestId,ok:!0,value})}catch(err){port.postMessage({type:"result",requestId:msg.requestId,ok:!1,error:serializeError(err)})}})();return;case"dispose-session":dispatcher.disposeSession(msg.sessionId).catch(err=>logger.warn("disposeSession failed",err));return}});

package/dest/worker.bundle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/worker.ts"],
+  "sourcesContent": ["import { BackendType, Barretenberg, BarretenbergSync } from '@aztec/bb.js';\nimport { type Logger, createLogger } from '@aztec/foundation/log';\n\nimport { parentPort, workerData } from 'node:worker_threads';\n\n// Importing `./index.js` registers the msgpackr Fr extension transitively (via\n// ./msgpackr_fr_extension.js); this must happen before any `sendMessage` call.\nimport { TXEDispatcher, type TXEDispatcherOptions, type TXEForeignCallInput, activeSessionCount } from './index.js';\n\n// Seed both bb.js singletons with the WASM backend before any crypto call. `initSingleton`\n// binds the singleton to whichever backend the first call requests, so this pre-empts the\n// implicit `Barretenberg.initSingleton()` inside `poseidon2Hash` from `@aztec/foundation/crypto`.\n// TXE only needs hashing (no proving, no verification), so WASM is sufficient and\n// `skipSrsInit: true` skips the CRS load. `threads: 1` keeps the WASM backend on a single\n// thread \u2014 additional threads would each spawn a nested worker_thread, multiplying memory cost\n// per pool worker.\nvoid Barretenberg.initSingleton({ backend: BackendType.Wasm, skipSrsInit: true, threads: 1 });\nvoid BarretenbergSync.initSingleton({ backend: BackendType.Wasm });\n\nif (!parentPort) {\n  throw new Error('worker.ts must be loaded as a worker_thread');\n}\n\nconst port = parentPort;\nconst logger: Logger = createLogger('txe:worker');\n\n// The pool builds a template LMDB containing the protocol contracts + the SchnorrAccount\n// artifact on the main thread and passes its data dir via `workerData`. The dispatcher clones\n// that LMDB into a per-worker store on first use, so this worker gets a writable copy already\n// populated.\nconst dispatcherOpts: TXEDispatcherOptions = {\n  contractStoreSourceDir: workerData.contractStoreSourceDir,\n  schnorrClassId: workerData.schnorrClassId,\n};\nconst dispatcher = new TXEDispatcher(logger, dispatcherOpts);\n\ninterface ForeignCallRequest {\n  type: 'foreign-call';\n  requestId: number;\n  callData: TXEForeignCallInput;\n}\n\ninterface DisposeSessionMessage {\n  type: 'dispose-session';\n  sessionId: number;\n}\n\ntype IncomingMessage = ForeignCallRequest | DisposeSessionMessage;\n\ninterface SerializedError {\n  message: string;\n  name?: string;\n  stack?: string;\n}\n\nfunction serializeError(err: unknown): SerializedError {\n  if (err instanceof Error) {\n    return { message: err.message, name: err.name, stack: err.stack };\n  }\n  return { message: String(err) };\n}\n\n// Periodic memstat for diagnostic builds \u2014 set TXE_WORKER_MEMSTAT=1 to enable. Posts JS-heap\n// breakdown + active-session count back to the dispatcher so we can attribute RSS growth\n// between V8 heap (would show in heapUsed) and native (LMDB / world-state / WASM).\nif (process.env.TXE_WORKER_MEMSTAT === '1') {\n  setInterval(() => {\n    const m = process.memoryUsage();\n    port.postMessage({\n      type: 'memstat',\n      sessions: activeSessionCount(),\n      rss: m.rss,\n      heapTotal: m.heapTotal,\n      heapUsed: m.heapUsed,\n      external: m.external,\n      arrayBuffers: m.arrayBuffers,\n    });\n  }, 2000).unref();\n}\n\nport.on('message', (msg: IncomingMessage) => {\n  switch (msg.type) {\n    case 'foreign-call':\n      void (async () => {\n        try {\n          const value = await dispatcher.resolve_foreign_call(msg.callData);\n          port.postMessage({ type: 'result', requestId: msg.requestId, ok: true, value });\n        } catch (err) {\n          port.postMessage({ type: 'result', requestId: msg.requestId, ok: false, error: serializeError(err) });\n        }\n      })();\n      return;\n    case 'dispose-session':\n      // Fire-and-forget; the main thread does not wait for confirmation.\n      void dispatcher.disposeSession(msg.sessionId).catch(err => logger.warn(`disposeSession failed`, err));\n      return;\n  }\n});\n"],
+  "mappings": ";;uHAAA,OAAS,YAAa,aAAc,qBAAwB,eAG5D,OAAS,WAAY,eAAkB,sBAalC,aAAa,cAAc,CAAE,QAAS,YAAY,KAAM,YAAa,GAAM,QAAS,CAAE,CAAC,EACvF,iBAAiB,cAAc,CAAE,QAAS,YAAY,IAAK,CAAC,EAEjE,GAAI,CAAC,WACH,MAAM,IAAI,MAAM,6CAA6C,EAG/D,IAAM,KAAO,WACP,OAAiB,aAAa,YAAY,EAM1C,eAAuC,CAC3C,uBAAwB,WAAW,uBACnC,eAAgB,WAAW,cAC7B,EACM,WAAa,IAAI,cAAc,OAAQ,cAAc,EAqB3D,SAAS,eAAe,IAA+B,CACrD,OAAI,eAAe,MACV,CAAE,QAAS,IAAI,QAAS,KAAM,IAAI,KAAM,MAAO,IAAI,KAAM,EAE3D,CAAE,QAAS,OAAO,GAAG,CAAE,CAChC,CALS,wCAUL,QAAQ,IAAI,qBAAuB,KACrC,YAAY,IAAM,CAChB,IAAM,EAAI,QAAQ,YAAY,EAC9B,KAAK,YAAY,CACf,KAAM,UACN,SAAU,mBAAmB,EAC7B,IAAK,EAAE,IACP,UAAW,EAAE,UACb,SAAU,EAAE,SACZ,SAAU,EAAE,SACZ,aAAc,EAAE,YAClB,CAAC,CACH,EAAG,GAAI,EAAE,MAAM,EAGjB,KAAK,GAAG,UAAY,KAAyB,CAC3C,OAAQ,IAAI,KAAM,CAChB,IAAK,gBACG,SAAY,CAChB,GAAI,CACF,IAAM,MAAQ,MAAM,WAAW,qBAAqB,IAAI,QAAQ,EAChE,KAAK,YAAY,CAAE,KAAM,SAAU,UAAW,IAAI,UAAW,GAAI,GAAM,KAAM,CAAC,CAChF,OAAS,IAAK,CACZ,KAAK,YAAY,CAAE,KAAM,SAAU,UAAW,IAAI,UAAW,GAAI,GAAO,MAAO,eAAe,GAAG,CAAE,CAAC,CACtG,CACF,GAAG,EACH,OACF,IAAK,kBAEE,WAAW,eAAe,IAAI,SAAS,EAAE,MAAM,KAAO,OAAO,KAAK,wBAAyB,GAAG,CAAC,EACpG,MACJ,CACF,CAAC",
+  "names": []
+}

package/dest/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2VyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvd29ya2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dest/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":""}

package/dest/worker.js

@@ -0,0 +1,92 @@
+import { BackendType, Barretenberg, BarretenbergSync } from '@aztec/bb.js';
+import { createLogger } from '@aztec/foundation/log';
+import { parentPort, workerData } from 'node:worker_threads';
+// Importing `./index.js` registers the msgpackr Fr extension transitively (via
+// ./msgpackr_fr_extension.js); this must happen before any `sendMessage` call.
+import { TXEDispatcher, activeSessionCount } from './index.js';
+// Seed both bb.js singletons with the WASM backend before any crypto call. `initSingleton`
+// binds the singleton to whichever backend the first call requests, so this pre-empts the
+// implicit `Barretenberg.initSingleton()` inside `poseidon2Hash` from `@aztec/foundation/crypto`.
+// TXE only needs hashing (no proving, no verification), so WASM is sufficient and
+// `skipSrsInit: true` skips the CRS load. `threads: 1` keeps the WASM backend on a single
+// thread — additional threads would each spawn a nested worker_thread, multiplying memory cost
+// per pool worker.
+void Barretenberg.initSingleton({
+    backend: BackendType.Wasm,
+    skipSrsInit: true,
+    threads: 1
+});
+void BarretenbergSync.initSingleton({
+    backend: BackendType.Wasm
+});
+if (!parentPort) {
+    throw new Error('worker.ts must be loaded as a worker_thread');
+}
+const port = parentPort;
+const logger = createLogger('txe:worker');
+// The pool builds a template LMDB containing the protocol contracts + the SchnorrAccount
+// artifact on the main thread and passes its data dir via `workerData`. The dispatcher clones
+// that LMDB into a per-worker store on first use, so this worker gets a writable copy already
+// populated.
+const dispatcherOpts = {
+    contractStoreSourceDir: workerData.contractStoreSourceDir,
+    schnorrClassId: workerData.schnorrClassId
+};
+const dispatcher = new TXEDispatcher(logger, dispatcherOpts);
+function serializeError(err) {
+    if (err instanceof Error) {
+        return {
+            message: err.message,
+            name: err.name,
+            stack: err.stack
+        };
+    }
+    return {
+        message: String(err)
+    };
+}
+// Periodic memstat for diagnostic builds — set TXE_WORKER_MEMSTAT=1 to enable. Posts JS-heap
+// breakdown + active-session count back to the dispatcher so we can attribute RSS growth
+// between V8 heap (would show in heapUsed) and native (LMDB / world-state / WASM).
+if (process.env.TXE_WORKER_MEMSTAT === '1') {
+    setInterval(()=>{
+        const m = process.memoryUsage();
+        port.postMessage({
+            type: 'memstat',
+            sessions: activeSessionCount(),
+            rss: m.rss,
+            heapTotal: m.heapTotal,
+            heapUsed: m.heapUsed,
+            external: m.external,
+            arrayBuffers: m.arrayBuffers
+        });
+    }, 2000).unref();
+}
+port.on('message', (msg)=>{
+    switch(msg.type){
+        case 'foreign-call':
+            void (async ()=>{
+                try {
+                    const value = await dispatcher.resolve_foreign_call(msg.callData);
+                    port.postMessage({
+                        type: 'result',
+                        requestId: msg.requestId,
+                        ok: true,
+                        value
+                    });
+                } catch (err) {
+                    port.postMessage({
+                        type: 'result',
+                        requestId: msg.requestId,
+                        ok: false,
+                        error: serializeError(err)
+                    });
+                }
+            })();
+            return;
+        case 'dispose-session':
+            // Fire-and-forget; the main thread does not wait for confirmation.
+            void dispatcher.disposeSession(msg.sessionId).catch((err)=>logger.warn(`disposeSession failed`, err));
+            return;
+    }
+});

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@aztec/txe",
-  "version": "0.0.1-commit.d431d1c",
+  "version": "0.0.1-commit.d58ff9d0",
   "type": "module",
-  "exports": "./dest/index.js",
+  "exports": {
+    "./server": {
+      "types": "./dest/rpc_server.d.ts",
+      "import": "./dest/server.bundle.js"
+    }
+  },
   "bin": "./dest/bin/index.js",
   "typedocOptions": {
     "entryPoints": [
@@ -12,15 +17,18 @@
     "tsconfig": "./tsconfig.json"
   },
   "scripts": {
-    "build": "yarn clean && ../scripts/tsc.sh",
+    "build": "yarn clean && ../scripts/tsc.sh && node ./esbuild.config.mjs",
     "build:dev": "../scripts/tsc.sh --watch",
     "clean": "rm -rf ./dest .tsbuildinfo",
     "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules ../node_modules/.bin/jest --passWithNoTests --maxWorkers=${JEST_MAX_WORKERS:-8}",
     "dev": "LOG_LEVEL=\"debug; trace: simulator:state_manager; info: json-rpc:proxy\" node ./dest/bin/index.js",
-    "start": "node --no-warnings ./dest/bin/index.js"
+    "start": "node --no-warnings ./dest/bin/index.js",
+    "start:oracle-test-resolver": "node --no-warnings ./dest/bin/oracle_test_server.js",
+    "check_txe_oracle_version": "node ./dest/bin/check_txe_oracle_version.js"
   },
   "inherits": [
-    "../package.common.json"
+    "../package.common.json",
+    "./package.local.json"
   ],
   "jest": {
     "moduleNameMapper": {
@@ -61,38 +69,47 @@
     ]
   },
   "dependencies": {
-    "@aztec/accounts": "0.0.1-commit.d431d1c",
-    "@aztec/archiver": "0.0.1-commit.d431d1c",
-    "@aztec/aztec-node": "0.0.1-commit.d431d1c",
-    "@aztec/aztec.js": "0.0.1-commit.d431d1c",
-    "@aztec/bb-prover": "0.0.1-commit.d431d1c",
-    "@aztec/constants": "0.0.1-commit.d431d1c",
-    "@aztec/foundation": "0.0.1-commit.d431d1c",
-    "@aztec/key-store": "0.0.1-commit.d431d1c",
-    "@aztec/kv-store": "0.0.1-commit.d431d1c",
-    "@aztec/protocol-contracts": "0.0.1-commit.d431d1c",
-    "@aztec/pxe": "0.0.1-commit.d431d1c",
-    "@aztec/simulator": "0.0.1-commit.d431d1c",
-    "@aztec/stdlib": "0.0.1-commit.d431d1c",
-    "@aztec/world-state": "0.0.1-commit.d431d1c",
-    "zod": "^3.23.8"
+    "@aztec/accounts": "0.0.1-commit.d58ff9d0",
+    "@aztec/archiver": "0.0.1-commit.d58ff9d0",
+    "@aztec/aztec-node": "0.0.1-commit.d58ff9d0",
+    "@aztec/aztec.js": "0.0.1-commit.d58ff9d0",
+    "@aztec/bb-prover": "0.0.1-commit.d58ff9d0",
+    "@aztec/bb.js": "0.0.1-commit.d58ff9d0",
+    "@aztec/constants": "0.0.1-commit.d58ff9d0",
+    "@aztec/foundation": "0.0.1-commit.d58ff9d0",
+    "@aztec/key-store": "0.0.1-commit.d58ff9d0",
+    "@aztec/kv-store": "0.0.1-commit.d58ff9d0",
+    "@aztec/protocol-contracts": "0.0.1-commit.d58ff9d0",
+    "@aztec/pxe": "0.0.1-commit.d58ff9d0",
+    "@aztec/simulator": "0.0.1-commit.d58ff9d0",
+    "@aztec/standard-contracts": "0.0.1-commit.d58ff9d0",
+    "@aztec/stdlib": "0.0.1-commit.d58ff9d0",
+    "@aztec/world-state": "0.0.1-commit.d58ff9d0",
+    "msgpackr": "^1.11.2",
+    "zod": "^4"
   },
   "devDependencies": {
     "@jest/globals": "^30.0.0",
     "@types/jest": "^30.0.0",
     "@types/node": "^22.15.17",
     "@typescript/native-preview": "7.0.0-dev.20260113.1",
+    "esbuild": "^0.27.0",
     "jest": "^30.0.0",
     "jest-mock-extended": "^4.0.0",
     "ts-node": "^10.9.1",
     "typescript": "^5.3.3"
   },
   "files": [
+    "dest/bin/index.js",
+    "dest/worker.bundle.js",
+    "dest/server.bundle.js",
+    "dest/chunk-*.js",
+    "dest/*-*.js",
+    "dest/rpc_server.d.ts",
     "dest",
     "src",
     "!*.test.*"
   ],
-  "types": "./dest/index.d.ts",
   "engines": {
     "node": ">=20.10"
   }

package/src/bin/check_txe_oracle_version.ts

@@ -0,0 +1,67 @@
+import { keccak256String } from '@aztec/foundation/crypto/keccak';
+import { getOracleRegistrySignature, readNumericGlobal } from '@aztec/pxe/bin';
+import { ORACLE_REGISTRY, type OracleRegistryEntry } from '@aztec/pxe/simulator';
+
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+import { TXE_ORACLE_REGISTRY } from '../oracle/txe_oracle_registry.js';
+import { TXE_ORACLE_INTERFACE_HASH, TXE_ORACLE_VERSION_MAJOR } from '../oracle/txe_oracle_version.js';
+
+/**
+ * Verifies that the TXE oracle interfaces match the expected interface hash.
+ *
+ * The TXE oracle interfaces need to be versioned to ensure compatibility between Aztec.nr tests and TXE. This function
+ * computes a hash of the TXE-specific entries in `TXE_ORACLE_REGISTRY` (the shared PXE entries are covered by the PXE
+ * oracle version check) and compares it against a known hash. If they don't match, it means an
+ * interface has changed and the TXE oracle version needs to be bumped:
+ *   - If the change is backward-breaking (e.g. removing/renaming an oracle), bump TXE_ORACLE_VERSION_MAJOR.
+ *   - If the change is an oracle addition (non-breaking), bump TXE_ORACLE_VERSION_MINOR.
+ */
+function assertTxeOracleInterfaceMatches(): void {
+  const txeOnlyEntries: Record<string, OracleRegistryEntry> = Object.fromEntries(
+    Object.entries(TXE_ORACLE_REGISTRY).filter(([name]) => !(name in ORACLE_REGISTRY)),
+  );
+
+  const txeOracleInterfaceHash = keccak256String(getOracleRegistrySignature(txeOnlyEntries));
+  if (txeOracleInterfaceHash !== TXE_ORACLE_INTERFACE_HASH) {
+    throw new Error(
+      `The TXE oracle interface has changed. Update TXE_ORACLE_INTERFACE_HASH to ${txeOracleInterfaceHash} in txe/src/oracle/txe_oracle_version.ts and bump the TXE oracle version (TXE_ORACLE_VERSION_MAJOR for breaking changes, TXE_ORACLE_VERSION_MINOR for oracle additions).`,
+    );
+  }
+}
+
+/**
+ * Verifies that `TXE_ORACLE_VERSION_MAJOR` is identical across its two hand-maintained copies: the TXE TypeScript
+ * constant and the Aztec.nr Noir test helper constant. These layers can't import each other, so the major version is
+ * duplicated by hand and a mismatch otherwise only surfaces at runtime. This is the TXE counterpart of the contract
+ * oracle version check in `pxe/src/bin/check_oracle_version.ts`; the two version families are tracked separately.
+ *
+ * Only the major version is checked: the minor version legitimately diverges under the "environment minor >= contract
+ * minor" tolerance, so asserting minor equality would false-positive.
+ */
+function assertTxeOracleVersionMajorInSync(): void {
+  const currentDir = dirname(fileURLToPath(import.meta.url));
+  // Go up from dest/bin/ or src/bin/ to the package root (txe/), then up two more to the git root.
+  const packageRoot = dirname(dirname(currentDir));
+  const gitRoot = join(packageRoot, '..', '..');
+
+  const copies = [
+    { label: 'txe/src/txe_oracle_version.ts', value: TXE_ORACLE_VERSION_MAJOR },
+    {
+      label: 'aztec-nr/aztec/src/test/helpers/txe_oracles.nr',
+      value: readNumericGlobal(
+        join(gitRoot, 'noir-projects/aztec-nr/aztec/src/test/helpers/txe_oracles.nr'),
+        'TXE_ORACLE_VERSION_MAJOR',
+      ),
+    },
+  ];
+
+  if (new Set(copies.map(copy => copy.value)).size > 1) {
+    const details = copies.map(copy => `${copy.label}=${copy.value}`).join(', ');
+    throw new Error(`TXE_ORACLE_VERSION_MAJOR is out of sync: ${details}. Bump all copies together.`);
+  }
+}
+
+assertTxeOracleInterfaceMatches();
+assertTxeOracleVersionMajorInSync();

package/src/bin/index.ts

@@ -2,7 +2,16 @@
 import { createLogger } from '@aztec/aztec.js/log';
 import { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
 
-import { createTXERpcServer } from '../index.js';
+import { createTXERpcServer } from '../rpc_server.js';
+
+// Cap the native world-state thread pool before any import touches @aztec/world-state.
+// `MAX_WORLD_STATE_THREADS` reads HARDWARE_CONCURRENCY at module load and defaults to 16; the
+// pool's worker threads inherit `process.env`, so setting the cap here covers every worker.
+//
+// CAVEAT: HARDWARE_CONCURRENCY is process-global — bb prove/verify, the LMDB reader pool, and
+// the world-state native thread pool all read it. Safe at 2 today because TXE never proves or
+// verifies and only performs light tree updates; raise it if that ever changes.
+process.env.HARDWARE_CONCURRENCY ??= '2';
 
 /**
  * Create and start a new TXE HTTP Server
@@ -23,7 +32,7 @@ async function main() {
   const logger = createLogger('txe:rpc');
   logger.info(`Setting up TXE...`);
 
-  const txeServer = createTXERpcServer(logger);
+  const txeServer = await createTXERpcServer(logger);
   const { port } = await startHttpRpcServer(txeServer, {
     host: '127.0.0.1',
     port: TXE_PORT,

package/src/bin/oracle_test_server.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env -S node --no-warnings
+import { createLogger } from '@aztec/aztec.js/log';
+import { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
+
+import { createOracleTestRpcServer } from '../oracle/test-resolver/index.js';
+
+/**
+ * Starts an HTTP RPC server that resolves oracle foreign calls using auto-synthesized fixture scenarios. Used by
+ * `nargo test --oracle-resolver` to run `#[generate_oracle_tests]` serialization tests against a dedicated resolver.
+ * Logs fixture coverage on shutdown.
+ */
+async function main() {
+  const { ORACLE_TEST_PORT = 14830 } = process.env;
+
+  const logger = createLogger('txe:oracle-test');
+
+  logger.info('Setting up oracle test resolver...');
+  const { server, resolver } = createOracleTestRpcServer(logger);
+
+  function logCoverageAndExit() {
+    const uncalled = resolver.getUncalledFixtures();
+    const missing = resolver.getMissingFixtures();
+    if (uncalled.length > 0) {
+      logger.warn(`Fixtures never called by any test: ${uncalled.join(', ')}`);
+    }
+    if (missing.length > 0) {
+      logger.debug(`Oracles with no fixture defined: ${missing.join(', ')}`);
+    }
+    if (uncalled.length === 0) {
+      logger.info('All fixture oracles were called.');
+    }
+    process.exit(0);
+  }
+
+  process.on('SIGTERM', logCoverageAndExit);
+  process.on('SIGINT', logCoverageAndExit);
+
+  const { port } = await startHttpRpcServer(server, {
+    host: '127.0.0.1',
+    port: ORACLE_TEST_PORT,
+    timeoutMs: 1e3 * 60 * 5,
+  });
+
+  logger.info(`Oracle test resolver listening on port ${port}`);
+}
+
+main().catch(err => {
+  // eslint-disable-next-line no-console
+  console.error(err);
+  process.exit(1);
+});

package/src/constants.ts

@@ -1,3 +1,13 @@
+import { PRIVATE_LOG_CIPHERTEXT_LEN } from '@aztec/constants';
 import { AztecAddress } from '@aztec/stdlib/aztec-address';
 
-export const DEFAULT_ADDRESS = AztecAddress.fromNumber(42);
+export const DEFAULT_ADDRESS = AztecAddress.fromNumberUnsafe(42);
+
+// This is MAX_MESSAGE_CONTENT_LEN - PRIVATE_EVENT_MSG_PLAINTEXT_RESERVED_FIELDS_LEN
+export const MAX_PRIVATE_EVENT_LEN = 10;
+export const MAX_PRIVATE_EVENTS_PER_TXE_QUERY = 5;
+
+// Arbitrarily set at 64 because we need a bound. Nothing inherent about it.
+export const MAX_OFFCHAIN_EFFECTS_PER_TXE_QUERY = 64;
+// Must match MAX_OFFCHAIN_EFFECT_LEN in noir-projects/aztec-nr/aztec/src/test/helpers/txe_oracles.nr.
+export const MAX_OFFCHAIN_EFFECT_LEN = 2 + PRIVATE_LOG_CIPHERTEXT_LEN;