@aztec/txe 0.0.1-commit.2448fdb → 0.0.1-commit.2606882

package/dest/bin/check_txe_oracle_version.d.ts

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

package/dest/bin/check_txe_oracle_version.d.ts.map

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

package/dest/bin/check_txe_oracle_version.js

@@ -0,0 +1,61 @@
+import { keccak256String } from '@aztec/foundation/crypto/keccak';
+import { getOracleInterfaceSignature, readNumericGlobal } from '@aztec/pxe/bin';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+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 oracle interfaces 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() {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = dirname(dirname(currentDir));
+    const interfacesSourcePath = join(packageRoot, 'src/oracle/interfaces.ts');
+    const targets = [
+        'IAvmExecutionOracle',
+        'ITxeExecutionOracle'
+    ];
+    // Not an oracle foreign call handler (see TODO(F-335) in interfaces.ts).
+    const excludedMembers = [
+        'syncContractNonOracleMethod'
+    ];
+    const txeOracleInterfaceSignature = getOracleInterfaceSignature(interfacesSourcePath, targets, excludedMembers);
+    const txeOracleInterfaceHash = keccak256String(txeOracleInterfaceSignature);
+    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() {
+    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/dest/bin/index.js

@@ -1,31 +1,4 @@
 #!/usr/bin/env -S node --no-warnings
-import { createLogger } from '@aztec/aztec.js/log';
-import { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
-import { createTXERpcServer } from '../index.js';
-/**
- * Create and start a new TXE HTTP Server
- */ async function main() {
-    const { TXE_PORT = 8080 } = process.env;
-    process.on('SIGTERM', ()=>{
-        logger.info('Received SIGTERM.');
-        process.exit(0);
-    });
-    process.on('SIGINT', ()=>{
-        logger.info('Received SIGTERM.');
-        process.exit(0);
-    });
-    const logger = createLogger('txe:rpc');
-    logger.info(`Setting up TXE...`);
-    const txeServer = createTXERpcServer(logger);
-    const { port } = await startHttpRpcServer(txeServer, {
-        host: '127.0.0.1',
-        port: TXE_PORT,
-        timeoutMs: 1e3 * 60 * 5
-    });
-    logger.info(`TXE listening on port ${port}`);
-}
-main().catch((err)=>{
-    // eslint-disable-next-line no-console
-    console.error(err);
-    process.exit(1);
-});
+import { createRequire as __txeCreateRequire } from 'node:module';
+const require = __txeCreateRequire(import.meta.url);
+import{createTXERpcServer,startHttpRpcServer}from"../chunk-FU3LBVE4.js";import{createLogger}from"../chunk-3VX4QA7B.js";import{__name}from"../chunk-BJVAAXNA.js";process.env.HARDWARE_CONCURRENCY??="2";async function main(){let{TXE_PORT=8080}=process.env;process.on("SIGTERM",()=>{logger.info("Received SIGTERM."),process.exit(0)}),process.on("SIGINT",()=>{logger.info("Received SIGTERM."),process.exit(0)});let logger=createLogger("txe:rpc");logger.info("Setting up TXE...");let txeServer=await createTXERpcServer(logger),{port}=await startHttpRpcServer(txeServer,{host:"127.0.0.1",port:TXE_PORT,timeoutMs:1e3*60*5});logger.info(`TXE listening on port ${port}`)}__name(main,"main");main().catch(err=>{console.error(err),process.exit(1)});

package/dest/bin/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/bin/index.ts"],
+  "sourcesContent": ["#!/usr/bin/env -S node --no-warnings\nimport { createLogger } from '@aztec/aztec.js/log';\nimport { startHttpRpcServer } from '@aztec/foundation/json-rpc/server';\n\nimport { createTXERpcServer } from '../rpc_server.js';\n\n// Cap the native world-state thread pool before any import touches @aztec/world-state.\n// `MAX_WORLD_STATE_THREADS` reads HARDWARE_CONCURRENCY at module load and defaults to 16; the\n// pool's worker threads inherit `process.env`, so setting the cap here covers every worker.\n//\n// CAVEAT: HARDWARE_CONCURRENCY is process-global \u2014 bb prove/verify, the LMDB reader pool, and\n// the world-state native thread pool all read it. Safe at 2 today because TXE never proves or\n// verifies and only performs light tree updates; raise it if that ever changes.\nprocess.env.HARDWARE_CONCURRENCY ??= '2';\n\n/**\n * Create and start a new TXE HTTP Server\n */\nasync function main() {\n  const { TXE_PORT = 8080 } = process.env;\n\n  process.on('SIGTERM', () => {\n    logger.info('Received SIGTERM.');\n    process.exit(0);\n  });\n\n  process.on('SIGINT', () => {\n    logger.info('Received SIGTERM.');\n    process.exit(0);\n  });\n\n  const logger = createLogger('txe:rpc');\n  logger.info(`Setting up TXE...`);\n\n  const txeServer = await createTXERpcServer(logger);\n  const { port } = await startHttpRpcServer(txeServer, {\n    host: '127.0.0.1',\n    port: TXE_PORT,\n    timeoutMs: 1e3 * 60 * 5,\n  });\n\n  logger.info(`TXE listening on port ${port}`);\n}\n\nmain().catch(err => {\n  // eslint-disable-next-line no-console\n  console.error(err);\n  process.exit(1);\n});\n"],
+  "mappings": ";;;gKAaA,QAAQ,IAAI,uBAAyB,IAKrC,eAAe,MAAO,CACpB,GAAM,CAAE,SAAW,IAAK,EAAI,QAAQ,IAEpC,QAAQ,GAAG,UAAW,IAAM,CAC1B,OAAO,KAAK,mBAAmB,EAC/B,QAAQ,KAAK,CAAC,CAChB,CAAC,EAED,QAAQ,GAAG,SAAU,IAAM,CACzB,OAAO,KAAK,mBAAmB,EAC/B,QAAQ,KAAK,CAAC,CAChB,CAAC,EAED,IAAM,OAAS,aAAa,SAAS,EACrC,OAAO,KAAK,mBAAmB,EAE/B,IAAM,UAAY,MAAM,mBAAmB,MAAM,EAC3C,CAAE,IAAK,EAAI,MAAM,mBAAmB,UAAW,CACnD,KAAM,YACN,KAAM,SACN,UAAW,IAAM,GAAK,CACxB,CAAC,EAED,OAAO,KAAK,yBAAyB,IAAI,EAAE,CAC7C,CAxBe,oBA0Bf,KAAK,EAAE,MAAM,KAAO,CAElB,QAAQ,MAAM,GAAG,EACjB,QAAQ,KAAK,CAAC,CAChB,CAAC",
+  "names": []
+}

package/dest/bin/oracle_test_server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env -S node --no-warnings
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JhY2xlX3Rlc3Rfc2VydmVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYmluL29yYWNsZV90ZXN0X3NlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dest/bin/oracle_test_server.d.ts.map

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

package/dest/bin/oracle_test_server.js

@@ -0,0 +1,41 @@
+#!/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 hardcoded fixture scenarios.
+ * Used by `nargo test --oracle-resolver` to run `#[oracle_test]` roundtrip tests with a dedicated oracle 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);
+});