@aztec/aztec-node 0.7.10 → 0.8.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin/index.ts"],"names":[],"mappings":";AAKA,OAAO,MAAM,MAAM,YAAY,CAAC;AAiBhC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,mBAMnD"}

package/dest/bin/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env -S node --no-warnings
+import { createDebugLogger } from '@aztec/foundation/log';
+import http from 'http';
+import Router from 'koa-router';
+import { AztecNodeService, createAztecNodeRpcServer, getConfigEnvVars } from '../index.js';
+const { AZTEC_NODE_PORT = 8081, API_PREFIX = '' } = process.env;
+const logger = createDebugLogger('aztec:node');
+/**
+ * Creates the node from provided config
+ */
+async function createAndDeployAztecNode() {
+    const aztecNodeConfig = { ...getConfigEnvVars() };
+    return await AztecNodeService.createAndSync(aztecNodeConfig);
+}
+/**
+ * Creates a router for helper API endpoints of the Private eXecution Environment (PXE).
+ * @param apiPrefix - The prefix to use for all api requests
+ * @returns - The router for handling status requests.
+ */
+export function createStatusRouter(apiPrefix) {
+    const router = new Router({ prefix: `${apiPrefix}` });
+    router.get('/status', (ctx) => {
+        ctx.status = 200;
+    });
+    return router;
+}
+/**
+ * Create and start a new Aztec Node HTTP Server
+ */
+async function main() {
+    logger.info(`Setting up Aztec Node...`);
+    const aztecNode = await createAndDeployAztecNode();
+    const shutdown = async () => {
+        logger.info('Shutting down...');
+        await aztecNode.stop();
+        process.exit(0);
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    const rpcServer = createAztecNodeRpcServer(aztecNode);
+    const app = rpcServer.getApp(API_PREFIX);
+    const apiRouter = createStatusRouter(API_PREFIX);
+    app.use(apiRouter.routes());
+    app.use(apiRouter.allowedMethods());
+    const httpServer = http.createServer(app.callback());
+    httpServer.listen(+AZTEC_NODE_PORT);
+    logger.info(`Aztec Node JSON-RPC Server listening on port ${AZTEC_NODE_PORT}`);
+}
+main().catch(err => {
+    logger.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYmluL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFDQSxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUUxRCxPQUFPLElBQUksTUFBTSxNQUFNLENBQUM7QUFFeEIsT0FBTyxNQUFNLE1BQU0sWUFBWSxDQUFDO0FBRWhDLE9BQU8sRUFBbUIsZ0JBQWdCLEVBQUUsd0JBQXdCLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFNUcsTUFBTSxFQUFFLGVBQWUsR0FBRyxJQUFJLEVBQUUsVUFBVSxHQUFHLEVBQUUsRUFBRSxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUM7QUFFaEUsTUFBTSxNQUFNLEdBQUcsaUJBQWlCLENBQUMsWUFBWSxDQUFDLENBQUM7QUFFL0M7O0dBRUc7QUFDSCxLQUFLLFVBQVUsd0JBQXdCO0lBQ3JDLE1BQU0sZUFBZSxHQUFvQixFQUFFLEdBQUcsZ0JBQWdCLEVBQUUsRUFBRSxDQUFDO0lBRW5FLE9BQU8sTUFBTSxnQkFBZ0IsQ0FBQyxhQUFhLENBQUMsZUFBZSxDQUFDLENBQUM7QUFDL0QsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsa0JBQWtCLENBQUMsU0FBaUI7SUFDbEQsTUFBTSxNQUFNLEdBQUcsSUFBSSxNQUFNLENBQUMsRUFBRSxNQUFNLEVBQUUsR0FBRyxTQUFTLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDdEQsTUFBTSxDQUFDLEdBQUcsQ0FBQyxTQUFTLEVBQUUsQ0FBQyxHQUFnQixFQUFFLEVBQUU7UUFDekMsR0FBRyxDQUFDLE1BQU0sR0FBRyxHQUFHLENBQUM7SUFDbkIsQ0FBQyxDQUFDLENBQUM7SUFDSCxPQUFPLE1BQU0sQ0FBQztBQUNoQixDQUFDO0FBRUQ7O0dBRUc7QUFDSCxLQUFLLFVBQVUsSUFBSTtJQUNqQixNQUFNLENBQUMsSUFBSSxDQUFDLDBCQUEwQixDQUFDLENBQUM7SUFFeEMsTUFBTSxTQUFTLEdBQUcsTUFBTSx3QkFBd0IsRUFBRSxDQUFDO0lBRW5ELE1BQU0sUUFBUSxHQUFHLEtBQUssSUFBSSxFQUFFO1FBQzFCLE1BQU0sQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsQ0FBQztRQUNoQyxNQUFNLFNBQVMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUN2QixPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ2xCLENBQUMsQ0FBQztJQUVGLE9BQU8sQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLFFBQVEsQ0FBQyxDQUFDO0lBQ2pDLE9BQU8sQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLFFBQVEsQ0FBQyxDQUFDO0lBRWxDLE1BQU0sU0FBUyxHQUFHLHdCQUF3QixDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQ3RELE1BQU0sR0FBRyxHQUFHLFNBQVMsQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDekMsTUFBTSxTQUFTLEdBQUcsa0JBQWtCLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDakQsR0FBRyxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUM1QixHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxjQUFjLEVBQUUsQ0FBQyxDQUFDO0lBRXBDLE1BQU0sVUFBVSxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLFFBQVEsRUFBRSxDQUFDLENBQUM7SUFDckQsVUFBVSxDQUFDLE1BQU0sQ0FBQyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ3BDLE1BQU0sQ0FBQyxJQUFJLENBQUMsZ0RBQWdELGVBQWUsRUFBRSxDQUFDLENBQUM7QUFDakYsQ0FBQztBQUVELElBQUksRUFBRSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsRUFBRTtJQUNqQixNQUFNLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ2xCLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDbEIsQ0FBQyxDQUFDLENBQUMifQ==

package/dest/index.d.ts

@@ -1,4 +1,4 @@
 export * from './aztec-node/config.js';
 export * from './aztec-node/server.js';
-export * from './aztec-node/http-node.js';
+export * from './aztec-node/http_rpc_server.js';
 //# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,iCAAiC,CAAC"}

package/dest/index.js

@@ -1,4 +1,4 @@
 export * from './aztec-node/config.js';
 export * from './aztec-node/server.js';
-export * from './aztec-node/http-node.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsMkJBQTJCLENBQUMifQ==
+export * from './aztec-node/http_rpc_server.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsaUNBQWlDLENBQUMifQ==

package/package.json

@@ -1,19 +1,74 @@
 {
   "name": "@aztec/aztec-node",
-  "version": "0.7.10",
-  "exports": "./dest/index.js",
+  "version": "0.8.7",
   "main": "dest/index.js",
   "type": "module",
+  "exports": "./dest/index.js",
+  "bin": "./dest/bin/index.js",
+  "typedocOptions": {
+    "entryPoints": [
+      "./src/index.ts"
+    ],
+    "name": "Aztec Node",
+    "tsconfig": "./tsconfig.json"
+  },
+  "scripts": {
+    "start": "node --no-warnings ./dest/bin",
+    "build": "yarn clean && tsc -b",
+    "build:dev": "tsc -b --watch",
+    "clean": "rm -rf ./dest .tsbuildinfo",
+    "formatting": "run -T prettier --check ./src && run -T eslint ./src",
+    "formatting:fix": "run -T prettier -w ./src",
+    "test": "NODE_NO_WARNINGS=1 node --experimental-vm-modules $(yarn bin jest) --passWithNoTests"
+  },
+  "inherits": [
+    "../package.common.json"
+  ],
+  "jest": {
+    "preset": "ts-jest/presets/default-esm",
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.m?js$": "$1"
+    },
+    "testRegex": "./src/.*\\.test\\.(js|mjs|ts)$",
+    "rootDir": "./src"
+  },
   "dependencies": {
-    "@aztec/archiver": "0.7.10",
-    "@aztec/circuits.js": "0.7.10",
-    "@aztec/foundation": "0.7.10",
-    "@aztec/l1-artifacts": "0.7.10",
-    "@aztec/merkle-tree": "0.7.10",
-    "@aztec/p2p": "0.7.10",
-    "@aztec/sequencer-client": "0.7.10",
-    "@aztec/types": "0.7.10",
-    "@aztec/world-state": "0.7.10",
+    "@aztec/archiver": "0.8.7",
+    "@aztec/circuits.js": "0.8.7",
+    "@aztec/ethereum": "0.8.7",
+    "@aztec/foundation": "0.8.7",
+    "@aztec/l1-artifacts": "0.8.7",
+    "@aztec/merkle-tree": "0.8.7",
+    "@aztec/p2p": "0.8.7",
+    "@aztec/sequencer-client": "0.8.7",
+    "@aztec/types": "0.8.7",
+    "@aztec/world-state": "0.8.7",
+    "koa": "^2.14.2",
+    "koa-router": "^12.0.0",
+    "levelup": "^5.1.1",
+    "memdown": "^6.1.1",
     "tslib": "^2.4.0"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.5.0",
+    "@rushstack/eslint-patch": "^1.1.4",
+    "@types/jest": "^29.5.0",
+    "@types/leveldown": "^4.0.4",
+    "@types/levelup": "^5.1.2",
+    "@types/memdown": "^3.0.0",
+    "@types/node": "^18.7.23",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.4"
+  },
+  "files": [
+    "dest",
+    "src",
+    "!*.test.*"
+  ],
+  "types": "./dest/index.d.ts",
+  "engines": {
+    "node": ">=18"
   }
 }

package/src/aztec-node/config.ts

@@ -6,18 +6,25 @@ import { getConfigEnvVars as getWorldStateVars } from '@aztec/world-state';
 /**
  * The configuration the aztec node.
  */
-export type AztecNodeConfig = ArchiverConfig & SequencerClientConfig & P2PConfig;
+export type AztecNodeConfig = ArchiverConfig &
+  SequencerClientConfig &
+  P2PConfig & {
+    /** Whether the sequencer is disabled for this node. */
+    disableSequencer: boolean;
+  };
 
 /**
  * Returns the config of the aztec node from environment variables with reasonable defaults.
  * @returns A valid aztec node config.
  */
 export function getConfigEnvVars(): AztecNodeConfig {
+  const { SEQ_DISABLED } = process.env;
   const allEnvVars: AztecNodeConfig = {
     ...getSequencerVars(),
     ...getArchiverVars(),
     ...getP2PConfigEnvVars(),
     ...getWorldStateVars(),
+    disableSequencer: !!SEQ_DISABLED,
   };
 
   return allEnvVars;

package/src/aztec-node/db.ts

@@ -0,0 +1,60 @@
+import { LevelDown, default as leveldown } from 'leveldown';
+import { LevelUp, default as levelup } from 'levelup';
+import { MemDown, default as memdown } from 'memdown';
+import { join } from 'node:path';
+
+import { AztecNodeConfig } from './config.js';
+
+export const createMemDown = () => (memdown as any)() as MemDown<any, any>;
+export const createLevelDown = (path: string) => (leveldown as any)(path) as LevelDown;
+
+const DB_SUBDIR = 'aztec-node';
+const NODE_METADATA_KEY = '@@aztec_node_metadata';
+
+/**
+ * The metadata for an aztec node.
+ */
+type NodeMetadata = {
+  /**
+   * The address of the rollup contract on L1
+   */
+  rollupContractAddress: string;
+};
+
+/**
+ * Opens the database for the aztec node.
+ * @param config - The configuration to be used by the aztec node.
+ * @returns The database for the aztec node.
+ */
+export async function openDb(config: AztecNodeConfig): Promise<LevelUp> {
+  const nodeMetadata: NodeMetadata = {
+    rollupContractAddress: config.l1Contracts.rollupAddress.toString(),
+  };
+
+  const db = levelup(config.dataDirectory ? createLevelDown(join(config.dataDirectory, DB_SUBDIR)) : createMemDown());
+  const prevNodeMetadata = await getNodeMetadata(db);
+
+  // if the rollup addresses are different, wipe the local database and start over
+  if (nodeMetadata.rollupContractAddress !== prevNodeMetadata.rollupContractAddress) {
+    await db.clear();
+  }
+
+  await db.put(NODE_METADATA_KEY, JSON.stringify(nodeMetadata));
+  return db;
+}
+
+/**
+ * Gets the metadata for the aztec node.
+ * @param db - The database for the aztec node.
+ * @returns Node metadata.
+ */
+async function getNodeMetadata(db: LevelUp): Promise<NodeMetadata> {
+  try {
+    const value: Buffer = await db.get(NODE_METADATA_KEY);
+    return JSON.parse(value.toString('utf-8'));
+  } catch {
+    return {
+      rollupContractAddress: '',
+    };
+  }
+}

package/src/aztec-node/http_rpc_server.ts

@@ -0,0 +1,46 @@
+import { HistoricBlockData } from '@aztec/circuits.js';
+import { AztecAddress } from '@aztec/foundation/aztec-address';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { Fr } from '@aztec/foundation/fields';
+import { JsonRpcServer } from '@aztec/foundation/json-rpc/server';
+import {
+  AztecNode,
+  ContractData,
+  ExtendedContractData,
+  L1ToL2MessageAndIndex,
+  L2Block,
+  L2BlockL2Logs,
+  L2Tx,
+  SiblingPath,
+  Tx,
+  TxHash,
+} from '@aztec/types';
+
+/**
+ * Wrap an AztecNode instance with a JSON RPC HTTP server.
+ * @param node - The AztecNode
+ * @returns An JSON-RPC HTTP server
+ */
+export function createAztecNodeRpcServer(node: AztecNode) {
+  const rpc = new JsonRpcServer(
+    node,
+    {
+      AztecAddress,
+      EthAddress,
+      ExtendedContractData,
+      ContractData,
+      Fr,
+      HistoricBlockData,
+      L2Block,
+      L2Tx,
+      TxHash,
+      SiblingPath,
+      L1ToL2MessageAndIndex,
+    },
+    { Tx, L2BlockL2Logs },
+    false,
+    // disable methods not part of the AztecNode interface
+    ['start', 'stop'],
+  );
+  return rpc;
+}

package/src/aztec-node/server.ts

@@ -2,13 +2,13 @@ import { Archiver } from '@aztec/archiver';
 import {
   CONTRACT_TREE_HEIGHT,
   CircuitsWasm,
-  EthAddress,
   Fr,
   GlobalVariables,
   HistoricBlockData,
   L1_TO_L2_MSG_TREE_HEIGHT,
   PRIVATE_DATA_TREE_HEIGHT,
 } from '@aztec/circuits.js';
+import { L1ContractAddresses } from '@aztec/ethereum';
 import { AztecAddress } from '@aztec/foundation/aztec-address';
 import { createDebugLogger } from '@aztec/foundation/log';
 import { InMemoryTxPool, P2P, createP2PClient } from '@aztec/p2p';
@@ -38,42 +38,41 @@ import {
 } from '@aztec/types';
 import {
   MerkleTrees,
-  ServerWorldStateSynchroniser,
+  ServerWorldStateSynchronizer,
   WorldStateConfig,
-  WorldStateSynchroniser,
+  WorldStateSynchronizer,
   computePublicDataTreeLeafIndex,
   getConfigEnvVars as getWorldStateConfig,
 } from '@aztec/world-state';
 
-import { default as levelup } from 'levelup';
-import { MemDown, default as memdown } from 'memdown';
+import levelup from 'levelup';
 
 import { AztecNodeConfig } from './config.js';
-
-export const createMemDown = () => (memdown as any)() as MemDown<any, any>;
+import { openDb } from './db.js';
 
 /**
  * The aztec node.
  */
 export class AztecNodeService implements AztecNode {
   constructor(
-    protected p2pClient: P2P,
-    protected blockSource: L2BlockSource,
-    protected encryptedLogsSource: L2LogsSource,
-    protected unencryptedLogsSource: L2LogsSource,
-    protected contractDataSource: ContractDataSource,
-    protected l1ToL2MessageSource: L1ToL2MessageSource,
-    protected worldStateSynchroniser: WorldStateSynchroniser,
-    protected sequencer: SequencerClient,
-    protected chainId: number,
-    protected version: number,
-    protected globalVariableBuilder: GlobalVariableBuilder,
-    protected merkleTreesDb: levelup.LevelUp,
+    protected readonly config: AztecNodeConfig,
+    protected readonly p2pClient: P2P,
+    protected readonly blockSource: L2BlockSource,
+    protected readonly encryptedLogsSource: L2LogsSource,
+    protected readonly unencryptedLogsSource: L2LogsSource,
+    protected readonly contractDataSource: ContractDataSource,
+    protected readonly l1ToL2MessageSource: L1ToL2MessageSource,
+    protected readonly worldStateSynchronizer: WorldStateSynchronizer,
+    protected readonly sequencer: SequencerClient | undefined,
+    protected readonly chainId: number,
+    protected readonly version: number,
+    protected readonly globalVariableBuilder: GlobalVariableBuilder,
+    protected readonly merkleTreesDb: levelup.LevelUp,
     private log = createDebugLogger('aztec:node'),
   ) {}
 
   /**
-   * Initialises the Aztec Node, wait for component to sync.
+   * initializes the Aztec Node, wait for component to sync.
    * @param config - The configuration to be used by the aztec node.
    * @returns - A fully synced Aztec Node for use in development/testing.
    */
@@ -83,45 +82,58 @@ export class AztecNodeService implements AztecNode {
 
     // we identify the P2P transaction protocol by using the rollup contract address.
     // this may well change in future
-    config.transactionProtocol = `/aztec/tx/${config.rollupContract.toString()}`;
+    config.transactionProtocol = `/aztec/tx/${config.l1Contracts.rollupAddress.toString()}`;
 
     // create the tx pool and the p2p client, which will need the l2 block source
     const p2pClient = await createP2PClient(config, new InMemoryTxPool(), archiver);
 
     // now create the merkle trees and the world state syncher
-    const merkleTreesDb = levelup(createMemDown());
-    const merkleTrees = await MerkleTrees.new(merkleTreesDb, await CircuitsWasm.get());
+    const db = await openDb(config);
+    const merkleTrees = await MerkleTrees.new(db, await CircuitsWasm.get());
     const worldStateConfig: WorldStateConfig = getWorldStateConfig();
-    const worldStateSynchroniser = new ServerWorldStateSynchroniser(merkleTrees, archiver, worldStateConfig);
+    const worldStateSynchronizer = await ServerWorldStateSynchronizer.new(db, merkleTrees, archiver, worldStateConfig);
 
     // start both and wait for them to sync from the block source
-    await Promise.all([p2pClient.start(), worldStateSynchroniser.start()]);
+    await Promise.all([p2pClient.start(), worldStateSynchronizer.start()]);
 
     // now create the sequencer
-    const sequencer = await SequencerClient.new(
-      config,
-      p2pClient,
-      worldStateSynchroniser,
-      archiver,
-      archiver,
-      archiver,
-    );
+    const sequencer = config.disableSequencer
+      ? undefined
+      : await SequencerClient.new(config, p2pClient, worldStateSynchronizer, archiver, archiver, archiver);
+
     return new AztecNodeService(
+      config,
       p2pClient,
       archiver,
       archiver,
       archiver,
       archiver,
       archiver,
-      worldStateSynchroniser,
+      worldStateSynchronizer,
       sequencer,
       config.chainId,
       config.version,
       getGlobalVariableBuilder(config),
-      merkleTreesDb,
+      db,
     );
   }
 
+  /**
+   * Returns the sequencer client instance.
+   * @returns The sequencer client instance.
+   */
+  public getSequencer(): SequencerClient | undefined {
+    return this.sequencer;
+  }
+
+  /**
+   * Method to return the currently deployed L1 contract addresses.
+   * @returns - The currently deployed L1 contract addresses.
+   */
+  public getL1ContractAddresses(): Promise<L1ContractAddresses> {
+    return Promise.resolve(this.config.l1Contracts);
+  }
+
   /**
    * Method to determine if the node is ready to accept transactions.
    * @returns - Flag indicating the readiness for tx submission.
@@ -173,14 +185,6 @@ export class AztecNodeService implements AztecNode {
     return Promise.resolve(this.chainId);
   }
 
-  /**
-   * Method to fetch the rollup contract address at the base-layer.
-   * @returns The rollup address.
-   */
-  public getRollupAddress(): Promise<EthAddress> {
-    return this.blockSource.getRollupAddress();
-  }
-
   /**
    * Get the extended contract data for this contract.
    * @param contractAddress - The contract data address.
@@ -229,9 +233,10 @@ export class AztecNodeService implements AztecNode {
    * Method to stop the aztec node.
    */
   public async stop() {
-    await this.sequencer.stop();
+    this.log.info(`Stopping`);
+    await this.sequencer?.stop();
     await this.p2pClient.stop();
-    await this.worldStateSynchroniser.stop();
+    await this.worldStateSynchronizer.stop();
     await this.blockSource.stop();
     this.log.info(`Stopped`);
   }
@@ -254,13 +259,14 @@ export class AztecNodeService implements AztecNode {
   }
 
   /**
-   * Find the index of the given contract.
-   * @param leafValue - The value to search for.
-   * @returns The index of the given leaf in the contracts tree or undefined if not found.
+   * Find the index of the given leaf in the given tree.
+   * @param treeId - The tree to search in.
+   * @param leafValue - The value to search for
+   * @returns The index of the given leaf in the given tree or undefined if not found.
    */
-  public async findContractIndex(leafValue: Buffer): Promise<bigint | undefined> {
-    const committedDb = await this.getWorldState();
-    return committedDb.findLeafIndex(MerkleTreeId.CONTRACT_TREE, leafValue);
+  public async findLeafIndex(treeId: MerkleTreeId, leafValue: Buffer): Promise<bigint | undefined> {
+    const committedDb = await this.#getWorldState();
+    return committedDb.findLeafIndex(treeId, leafValue);
   }
 
   /**
@@ -269,27 +275,17 @@ export class AztecNodeService implements AztecNode {
    * @returns The sibling path for the leaf index.
    */
   public async getContractPath(leafIndex: bigint): Promise<SiblingPath<typeof CONTRACT_TREE_HEIGHT>> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     return committedDb.getSiblingPath(MerkleTreeId.CONTRACT_TREE, leafIndex);
   }
 
-  /**
-   * Find the index of the given commitment.
-   * @param leafValue - The value to search for.
-   * @returns The index of the given leaf in the private data tree or undefined if not found.
-   */
-  public async findCommitmentIndex(leafValue: Buffer): Promise<bigint | undefined> {
-    const committedDb = await this.getWorldState();
-    return committedDb.findLeafIndex(MerkleTreeId.PRIVATE_DATA_TREE, leafValue);
-  }
-
   /**
    * Returns the sibling path for the given index in the data tree.
    * @param leafIndex - The index of the leaf for which the sibling path is required.
    * @returns The sibling path for the leaf index.
    */
   public async getDataTreePath(leafIndex: bigint): Promise<SiblingPath<typeof PRIVATE_DATA_TREE_HEIGHT>> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     return committedDb.getSiblingPath(MerkleTreeId.PRIVATE_DATA_TREE, leafIndex);
   }
 
@@ -301,10 +297,9 @@ export class AztecNodeService implements AztecNode {
    */
   public async getL1ToL2MessageAndIndex(messageKey: Fr): Promise<L1ToL2MessageAndIndex> {
     // todo: #697 - make this one lookup.
-    const committedDb = await this.getWorldState();
+    const index = (await this.findLeafIndex(MerkleTreeId.L1_TO_L2_MESSAGES_TREE, messageKey.toBuffer()))!;
     const message = await this.l1ToL2MessageSource.getConfirmedL1ToL2Message(messageKey);
-    const index = (await committedDb.findLeafIndex(MerkleTreeId.L1_TO_L2_MESSAGES_TREE, messageKey.toBuffer()))!;
-    return Promise.resolve({ message, index });
+    return Promise.resolve(new L1ToL2MessageAndIndex(index, message));
   }
 
   /**
@@ -313,7 +308,7 @@ export class AztecNodeService implements AztecNode {
    * @returns The sibling path.
    */
   public async getL1ToL2MessagesTreePath(leafIndex: bigint): Promise<SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     return committedDb.getSiblingPath(MerkleTreeId.L1_TO_L2_MESSAGES_TREE, leafIndex);
   }
 
@@ -325,7 +320,7 @@ export class AztecNodeService implements AztecNode {
    * Note: Aztec's version of `eth_getStorageAt`.
    */
   public async getPublicStorageAt(contract: AztecAddress, slot: bigint): Promise<Buffer | undefined> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     const leafIndex = computePublicDataTreeLeafIndex(contract, new Fr(slot), await CircuitsWasm.get());
     return committedDb.getLeafValue(MerkleTreeId.PUBLIC_DATA_TREE, leafIndex);
   }
@@ -335,7 +330,7 @@ export class AztecNodeService implements AztecNode {
    * @returns The current committed roots for the data trees.
    */
   public async getTreeRoots(): Promise<Record<MerkleTreeId, Fr>> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     const getTreeRoot = async (id: MerkleTreeId) => Fr.fromBuffer((await committedDb.getTreeInfo(id)).root);
 
     const [privateDataTree, nullifierTree, contractTree, l1ToL2MessagesTree, blocksTree, publicDataTree] =
@@ -363,7 +358,7 @@ export class AztecNodeService implements AztecNode {
    * @returns The current committed block data.
    */
   public async getHistoricBlockData(): Promise<HistoricBlockData> {
-    const committedDb = await this.getWorldState();
+    const committedDb = await this.#getWorldState();
     const [roots, globalsHash] = await Promise.all([this.getTreeRoots(), committedDb.getLatestGlobalVariablesHash()]);
 
     return new HistoricBlockData(
@@ -413,22 +408,22 @@ export class AztecNodeService implements AztecNode {
    * Returns an instance of MerkleTreeOperations having first ensured the world state is fully synched
    * @returns An instance of a committed MerkleTreeOperations
    */
-  private async getWorldState() {
+  async #getWorldState() {
     try {
       // Attempt to sync the world state if necessary
-      await this.syncWorldState();
+      await this.#syncWorldState();
     } catch (err) {
       this.log.error(`Error getting world state: ${err}`);
     }
-    return this.worldStateSynchroniser.getCommitted();
+    return this.worldStateSynchronizer.getCommitted();
   }
 
   /**
    * Ensure we fully sync the world state
    * @returns A promise that fulfils once the world state is synced
    */
-  private async syncWorldState() {
+  async #syncWorldState() {
     const blockSourceHeight = await this.blockSource.getBlockNumber();
-    await this.worldStateSynchroniser.syncImmediate(blockSourceHeight);
+    await this.worldStateSynchronizer.syncImmediate(blockSourceHeight);
   }
 }

package/src/bin/index.ts

@@ -0,0 +1,67 @@
+#!/usr/bin/env -S node --no-warnings
+import { createDebugLogger } from '@aztec/foundation/log';
+
+import http from 'http';
+import Koa from 'koa';
+import Router from 'koa-router';
+
+import { AztecNodeConfig, AztecNodeService, createAztecNodeRpcServer, getConfigEnvVars } from '../index.js';
+
+const { AZTEC_NODE_PORT = 8081, API_PREFIX = '' } = process.env;
+
+const logger = createDebugLogger('aztec:node');
+
+/**
+ * Creates the node from provided config
+ */
+async function createAndDeployAztecNode() {
+  const aztecNodeConfig: AztecNodeConfig = { ...getConfigEnvVars() };
+
+  return await AztecNodeService.createAndSync(aztecNodeConfig);
+}
+
+/**
+ * Creates a router for helper API endpoints of the Private eXecution Environment (PXE).
+ * @param apiPrefix - The prefix to use for all api requests
+ * @returns - The router for handling status requests.
+ */
+export function createStatusRouter(apiPrefix: string) {
+  const router = new Router({ prefix: `${apiPrefix}` });
+  router.get('/status', (ctx: Koa.Context) => {
+    ctx.status = 200;
+  });
+  return router;
+}
+
+/**
+ * Create and start a new Aztec Node HTTP Server
+ */
+async function main() {
+  logger.info(`Setting up Aztec Node...`);
+
+  const aztecNode = await createAndDeployAztecNode();
+
+  const shutdown = async () => {
+    logger.info('Shutting down...');
+    await aztecNode.stop();
+    process.exit(0);
+  };
+
+  process.once('SIGINT', shutdown);
+  process.once('SIGTERM', shutdown);
+
+  const rpcServer = createAztecNodeRpcServer(aztecNode);
+  const app = rpcServer.getApp(API_PREFIX);
+  const apiRouter = createStatusRouter(API_PREFIX);
+  app.use(apiRouter.routes());
+  app.use(apiRouter.allowedMethods());
+
+  const httpServer = http.createServer(app.callback());
+  httpServer.listen(+AZTEC_NODE_PORT);
+  logger.info(`Aztec Node JSON-RPC Server listening on port ${AZTEC_NODE_PORT}`);
+}
+
+main().catch(err => {
+  logger.error(err);
+  process.exit(1);
+});