@aztec/aztec-node 5.0.0-private.20260319 → 5.0.0-rc.2

package/dest/bin/index.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env -S node --no-warnings
+import { createNamespacedSafeJsonRpcServer, startHttpRpcServer } from '@aztec/foundation/json-rpc/server';
 import { createLogger } from '@aztec/foundation/log';
-import { AztecNodeApiSchema } from '@aztec/stdlib/interfaces/client';
-import { createTracedJsonRpcServer } from '@aztec/telemetry-client';
-import http from 'http';
-import { AztecNodeService, getConfigEnvVars } from '../index.js';
+import { getOtelJsonRpcPropagationMiddleware } from '@aztec/telemetry-client';
+import { createAztecNodeService, getConfigEnvVars, registerAztecNodeRpcHandlers } from '../index.js';
 const { AZTEC_NODE_PORT = 8081, API_PREFIX = '' } = process.env;
 const logger = createLogger('node');
 /**
@@ -12,7 +11,7 @@ const logger = createLogger('node');
     const aztecNodeConfig = {
         ...getConfigEnvVars()
     };
-    return await AztecNodeService.createAndSync(aztecNodeConfig);
+    return await createAztecNodeService(aztecNodeConfig);
 }
 /**
  * Create and start a new Aztec Node HTTP Server
@@ -28,11 +27,17 @@ const logger = createLogger('node');
     process.once('SIGINT', shutdown);
     // eslint-disable-next-line @typescript-eslint/no-misused-promises
     process.once('SIGTERM', shutdown);
-    const rpcServer = createTracedJsonRpcServer(aztecNode, AztecNodeApiSchema);
-    const app = rpcServer.getApp(API_PREFIX);
-    // eslint-disable-next-line @typescript-eslint/no-misused-promises
-    const httpServer = http.createServer(app.callback());
-    httpServer.listen(+AZTEC_NODE_PORT);
+    const services = {};
+    registerAztecNodeRpcHandlers(aztecNode, services);
+    const rpcServer = createNamespacedSafeJsonRpcServer(services, {
+        middlewares: [
+            getOtelJsonRpcPropagationMiddleware()
+        ]
+    });
+    await startHttpRpcServer(rpcServer, {
+        port: +AZTEC_NODE_PORT,
+        apiPrefix: API_PREFIX
+    });
     logger.info(`Aztec Node JSON-RPC Server listening on port ${AZTEC_NODE_PORT}`);
 }
 main().catch((err)=>{

package/dest/factory.d.ts

@@ -0,0 +1,33 @@
+import { type Logger } from '@aztec/foundation/log';
+import { DateProvider } from '@aztec/foundation/timer';
+import { type P2PClientDeps } from '@aztec/p2p';
+import { type ProverNodeDeps } from '@aztec/prover-node';
+import { type SequencerPublisher } from '@aztec/sequencer-client';
+import type { GenesisData } from '@aztec/stdlib/world-state';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+import type { SlashingProtectionDatabase } from '@aztec/validator-ha-signer/types';
+import { type AztecNodeConfig } from './aztec-node/config.js';
+import { AztecNodeService } from './aztec-node/server.js';
+/** Dependencies that can be injected when creating a node, mostly to override defaults in tests. */
+export interface CreateAztecNodeDeps {
+    telemetry?: TelemetryClient;
+    logger?: Logger;
+    publisher?: SequencerPublisher;
+    dateProvider?: DateProvider;
+    p2pClientDeps?: P2PClientDeps;
+    proverNodeDeps?: Partial<ProverNodeDeps>;
+    slashingProtectionDb?: SlashingProtectionDatabase;
+}
+/** Options controlling which subsystems are started when creating a node. */
+export interface CreateAztecNodeOptions {
+    genesis?: GenesisData;
+    dontStartSequencer?: boolean;
+    dontStartProverNode?: boolean;
+}
+/**
+ * Initializes the Aztec Node, waiting for its components to sync.
+ * @param inputConfig - The configuration to be used by the aztec node.
+ * @returns A fully synced Aztec Node for use in development/testing.
+ */
+export declare function createAztecNodeService(inputConfig: AztecNodeConfig, deps?: CreateAztecNodeDeps, options?: CreateAztecNodeOptions): Promise<AztecNodeService>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBWUEsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFnQixNQUFNLHVCQUF1QixDQUFDO0FBQ2xFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUl2RCxPQUFPLEVBQUUsS0FBSyxhQUFhLEVBQW1CLE1BQU0sWUFBWSxDQUFDO0FBQ2pFLE9BQU8sRUFBbUIsS0FBSyxjQUFjLEVBQW9CLE1BQU0sb0JBQW9CLENBQUM7QUFFNUYsT0FBTyxFQUlMLEtBQUssa0JBQWtCLEVBQ3hCLE1BQU0seUJBQXlCLENBQUM7QUFnQmpDLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBQzdELE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBc0IsTUFBTSx5QkFBeUIsQ0FBQztBQVVuRixPQUFPLEtBQUssRUFBRSwwQkFBMEIsRUFBRSxNQUFNLGtDQUFrQyxDQUFDO0FBS25GLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBOEIsTUFBTSx3QkFBd0IsQ0FBQztBQUMxRixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUcxRCxvR0FBb0c7QUFDcEcsTUFBTSxXQUFXLG1CQUFtQjtJQUNsQyxTQUFTLENBQUMsRUFBRSxlQUFlLENBQUM7SUFDNUIsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2hCLFNBQVMsQ0FBQyxFQUFFLGtCQUFrQixDQUFDO0lBQy9CLFlBQVksQ0FBQyxFQUFFLFlBQVksQ0FBQztJQUM1QixhQUFhLENBQUMsRUFBRSxhQUFhLENBQUM7SUFDOUIsY0FBYyxDQUFDLEVBQUUsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQUFDO0lBQ3pDLG9CQUFvQixDQUFDLEVBQUUsMEJBQTBCLENBQUM7Q0FDbkQ7QUFFRCw2RUFBNkU7QUFDN0UsTUFBTSxXQUFXLHNCQUFzQjtJQUNyQyxPQUFPLENBQUMsRUFBRSxXQUFXLENBQUM7SUFDdEIsa0JBQWtCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDN0IsbUJBQW1CLENBQUMsRUFBRSxPQUFPLENBQUM7Q0FDL0I7QUFFRDs7OztHQUlHO0FBQ0gsd0JBQXNCLHNCQUFzQixDQUMxQyxXQUFXLEVBQUUsZUFBZSxFQUM1QixJQUFJLEdBQUUsbUJBQXdCLEVBQzlCLE9BQU8sR0FBRSxzQkFBMkIsR0FDbkMsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBNmhCM0IifQ==

package/dest/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvD,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,YAAY,CAAC;AACjE,OAAO,EAAmB,KAAK,cAAc,EAAoB,MAAM,oBAAoB,CAAC;AAE5F,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,yBAAyB,CAAC;AAUnF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAKnF,OAAO,EAAE,KAAK,eAAe,EAA8B,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,oGAAoG;AACpG,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;CACnD;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,eAAe,EAC5B,IAAI,GAAE,mBAAwB,EAC9B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gBAAgB,CAAC,CA6hB3B"}

package/dest/factory.js

@@ -0,0 +1,496 @@
+import { createArchiver } from '@aztec/archiver';
+import { BBCircuitVerifier, BatchChonkVerifier, QueuedIVCVerifier } from '@aztec/bb-prover';
+import { TestCircuitVerifier } from '@aztec/bb-prover/test';
+import { createBlobClientWithFileStores } from '@aztec/blob-client/client';
+import { Blob } from '@aztec/blob-lib';
+import { EpochCache } from '@aztec/epoch-cache';
+import { createEthereumChain } from '@aztec/ethereum/chain';
+import { getPublicClient, makeL1HttpTransport } from '@aztec/ethereum/client';
+import { RegistryContract, RollupContract } from '@aztec/ethereum/contracts';
+import { pickL1ContractAddresses } from '@aztec/ethereum/l1-contract-addresses';
+import { compactArray } from '@aztec/foundation/collection';
+import { createLogger } from '@aztec/foundation/log';
+import { DateProvider } from '@aztec/foundation/timer';
+import { KeystoreManager, loadKeystores, mergeKeystores } from '@aztec/node-keystore';
+import { trySnapshotSync } from '@aztec/node-lib/actions';
+import { createForwarderL1TxUtilsFromSigners, createL1TxUtilsFromSigners } from '@aztec/node-lib/factories';
+import { createP2PClient } from '@aztec/p2p';
+import { createProverNode } from '@aztec/prover-node';
+import { createKeyStoreForProver } from '@aztec/prover-node/config';
+import { FeeProviderImpl, GlobalVariableBuilder, SequencerClient } from '@aztec/sequencer-client';
+import { createAutomineSequencer } from '@aztec/sequencer-client/automine';
+import { AttestationsBlockWatcher, AttestedInvalidProposalWatcher, BroadcastedInvalidCheckpointProposalWatcher, CheckpointEquivocationWatcher, DataWithholdingWatcher, createSlasher } from '@aztec/slasher';
+import { CheckpointReexecutionTracker } from '@aztec/stdlib/checkpoint';
+import { tryStop } from '@aztec/stdlib/interfaces/server';
+import { InMemoryDebugLogStore, NullDebugLogStore } from '@aztec/stdlib/logs';
+import { getPackageVersion } from '@aztec/stdlib/update-checker';
+import { getTelemetryClient } from '@aztec/telemetry-client';
+import { FullNodeCheckpointsBuilder as CheckpointsBuilder, FullNodeCheckpointsBuilder, NodeKeystoreAdapter, ValidatorClient, createProposalHandler, createValidatorClient } from '@aztec/validator-client';
+import { createWorldState, createWorldStateSynchronizer } from '@aztec/world-state';
+import { createPublicClient } from 'viem';
+import { createKeyStoreForValidator } from './aztec-node/config.js';
+import { AztecNodeService } from './aztec-node/server.js';
+import { createSentinel } from './sentinel/factory.js';
+/**
+ * Initializes the Aztec Node, waiting for its components to sync.
+ * @param inputConfig - The configuration to be used by the aztec node.
+ * @returns A fully synced Aztec Node for use in development/testing.
+ */ export async function createAztecNodeService(inputConfig, deps = {}, options = {}) {
+    const config = {
+        ...inputConfig
+    }; // Copy the config so we dont mutate the input object
+    const log = deps.logger ?? createLogger('node');
+    // Initialise the bb.js sync WASM singleton here, before any subsystem runs.
+    const { BarretenbergSync } = await import('@aztec/bb.js');
+    await BarretenbergSync.initSingleton();
+    const packageVersion = getPackageVersion();
+    const telemetry = deps.telemetry ?? getTelemetryClient();
+    const dateProvider = deps.dateProvider ?? new DateProvider();
+    const ethereumChain = createEthereumChain(config.l1RpcUrls, config.l1ChainId);
+    // Build a key store from file if given or from environment otherwise.
+    // We keep the raw KeyStore available so we can merge with prover keys if enableProverNode is set.
+    let keyStoreManager;
+    const keyStoreProvided = config.keyStoreDirectory !== undefined && config.keyStoreDirectory.length > 0;
+    if (keyStoreProvided) {
+        const keyStores = loadKeystores(config.keyStoreDirectory);
+        keyStoreManager = new KeystoreManager(mergeKeystores(keyStores));
+    } else {
+        const rawKeyStores = [];
+        const validatorKeyStore = createKeyStoreForValidator(config);
+        if (validatorKeyStore) {
+            rawKeyStores.push(validatorKeyStore);
+        }
+        if (config.enableProverNode) {
+            const proverKeyStore = createKeyStoreForProver(config);
+            if (proverKeyStore) {
+                rawKeyStores.push(proverKeyStore);
+            }
+        }
+        if (rawKeyStores.length > 0) {
+            keyStoreManager = new KeystoreManager(rawKeyStores.length === 1 ? rawKeyStores[0] : mergeKeystores(rawKeyStores));
+        }
+    }
+    await keyStoreManager?.validateSigners();
+    // If we are a validator, verify our configuration before doing too much more.
+    if (!config.disableValidator) {
+        if (keyStoreManager === undefined) {
+            throw new Error('Failed to create key store, a requirement for running a validator');
+        }
+        if (!keyStoreProvided && process.env.NODE_ENV !== 'test') {
+            log.warn("Keystore created from env: it's recommended to use a file-based key store for production");
+        }
+        ValidatorClient.validateKeyStoreConfiguration(keyStoreManager, log);
+    }
+    // validate that the actual chain id matches that specified in configuration
+    if (config.l1ChainId !== ethereumChain.chainInfo.id) {
+        throw new Error(`RPC URL configured for chain id ${ethereumChain.chainInfo.id} but expected id ${config.l1ChainId}`);
+    }
+    const publicClient = createPublicClient({
+        chain: ethereumChain.chainInfo,
+        transport: makeL1HttpTransport(config.l1RpcUrls, {
+            timeout: config.l1HttpTimeoutMS
+        }),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+    const l1ContractsAddresses = await RegistryContract.collectAddresses(publicClient, config.registryAddress, config.rollupVersion ?? 'canonical');
+    Object.assign(config, l1ContractsAddresses);
+    const rollupContract = new RollupContract(publicClient, config.rollupAddress.toString());
+    const [l1GenesisTime, slotDuration, epochDuration, rollupVersionFromRollup, rollupManaLimit] = await Promise.all([
+        rollupContract.getL1GenesisTime(),
+        rollupContract.getSlotDuration(),
+        rollupContract.getEpochDuration(),
+        rollupContract.getVersion(),
+        rollupContract.getManaLimit().then(Number)
+    ]);
+    config.rollupVersion ??= Number(rollupVersionFromRollup);
+    if (config.rollupVersion !== Number(rollupVersionFromRollup)) {
+        log.warn(`Registry looked up and returned a rollup with version (${config.rollupVersion}), but this does not match with version detected from the rollup directly: (${rollupVersionFromRollup}).`);
+    }
+    const blobClient = await createBlobClientWithFileStores(config, log.createChild('blob-client'));
+    // attempt snapshot sync if possible
+    await trySnapshotSync(config, log);
+    const epochCache = await EpochCache.create(config.rollupAddress, config, {
+        dateProvider
+    });
+    // Track started resources so we can clean up on partial failure during node creation.
+    const started = [];
+    try {
+        config.skipOrphanProposedBlockPruning ||= !!config.useAutomineSequencer;
+        checkConfigMatchesRollup(config, {
+            slotDuration: Number(slotDuration),
+            epochDuration: Number(epochDuration)
+        });
+        // Create world-state first so we can retrieve the initial header before constructing the archiver.
+        const nativeWs = await createWorldState(config, options.genesis);
+        const initialHeader = nativeWs.getInitialHeader();
+        const initialBlockHash = await initialHeader.hash();
+        const archiver = await createArchiver(config, {
+            blobClient,
+            epochCache,
+            telemetry,
+            dateProvider
+        }, {
+            blockUntilSync: !config.skipArchiverInitialSync
+        }, initialHeader, initialBlockHash);
+        started.push(archiver);
+        // The synchronizer takes ownership of the native world-state from here
+        const worldStateSynchronizer = await createWorldStateSynchronizer(config, archiver, nativeWs, telemetry);
+        started.push(worldStateSynchronizer);
+        const useRealVerifiers = config.realProofs || config.debugForceTxProofVerification;
+        let peerProofVerifier;
+        let rpcProofVerifier;
+        if (useRealVerifiers) {
+            peerProofVerifier = await BatchChonkVerifier.new(config, config.bbChonkVerifyMaxBatch, 'peer');
+            const rpcVerifier = await BBCircuitVerifier.new(config);
+            rpcProofVerifier = new QueuedIVCVerifier(rpcVerifier, config.numConcurrentIVCVerifiers);
+        } else {
+            peerProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
+            rpcProofVerifier = new TestCircuitVerifier(config.proverTestVerificationDelayMs);
+        }
+        started.push(peerProofVerifier, rpcProofVerifier);
+        let debugLogStore;
+        if (!config.realProofs) {
+            log.warn(`Aztec node is accepting fake proofs`);
+            debugLogStore = new InMemoryDebugLogStore();
+            log.info('Aztec node started in test mode (realProofs set to false) hence debug logs from public functions will be collected and served');
+        } else {
+            debugLogStore = new NullDebugLogStore();
+        }
+        const globalVariableBuilderConfig = {
+            rollupAddress: config.rollupAddress,
+            ethereumSlotDuration: config.ethereumSlotDuration,
+            rollupVersion: BigInt(config.rollupVersion),
+            l1GenesisTime,
+            slotDuration: Number(slotDuration)
+        };
+        const globalVariableBuilder = new GlobalVariableBuilder(publicClient, globalVariableBuilderConfig);
+        const feeProvider = new FeeProviderImpl(dateProvider, publicClient, globalVariableBuilderConfig);
+        const collectOffenses = !config.disableValidator || config.enableOffenseCollection;
+        // create the tx pool and the p2p client, which will need the l2 block source
+        const p2pClient = await createP2PClient(config, archiver, peerProofVerifier, worldStateSynchronizer, epochCache, feeProvider, packageVersion, dateProvider, telemetry, deps.p2pClientDeps, initialBlockHash);
+        started.push(p2pClient);
+        archiver.setCheckpointProposalPresence(p2pClient);
+        // We'll accumulate sentinel watchers here
+        const watchers = [];
+        // Create FullNodeCheckpointsBuilder for block proposal handling and tx validation.
+        // Override maxTxsPerCheckpoint with the validator-specific limit if set.
+        const validatorCheckpointsBuilder = new FullNodeCheckpointsBuilder({
+            ...config,
+            l1GenesisTime,
+            slotDuration: Number(slotDuration),
+            rollupManaLimit,
+            maxTxsPerCheckpoint: config.validateMaxTxsPerCheckpoint
+        }, worldStateSynchronizer, archiver, dateProvider, telemetry);
+        let validatorClient;
+        // The proposal handler (validator-owned or standalone) tracks invalid-proposal/equivocation slots and
+        // feeds the attested-invalid-proposal watcher, so the watcher works on non-validator nodes too.
+        let proposalHandler;
+        // Tracks successful checkpoint re-execution by a checkpoint proposal handler.
+        const reexecutionTracker = new CheckpointReexecutionTracker();
+        if (!config.disableValidator) {
+            // Create validator client if required
+            validatorClient = await createValidatorClient(config, {
+                checkpointsBuilder: validatorCheckpointsBuilder,
+                worldState: worldStateSynchronizer,
+                p2pClient,
+                telemetry,
+                dateProvider,
+                epochCache,
+                blockSource: archiver,
+                l1ToL2MessageSource: archiver,
+                keyStoreManager,
+                blobClient,
+                reexecutionTracker,
+                slashingProtectionDb: deps.slashingProtectionDb
+            });
+            // If we have a validator client, register it as a source of offenses for the slasher,
+            // and have it register callbacks on the p2p client *before* we start it, otherwise messages
+            // like attestations or auths will fail.
+            if (validatorClient) {
+                watchers.push(validatorClient);
+                const vc = validatorClient;
+                const getValidatorAddresses = ()=>vc.getValidatorAddresses().map((a)=>a.toString());
+                proposalHandler = validatorClient.getProposalHandler();
+                proposalHandler.register(p2pClient, true, archiver, getValidatorAddresses);
+                if (!options.dontStartSequencer) {
+                    await validatorClient.registerHandlers();
+                }
+            }
+        }
+        // If there's no validator client, create a ProposalHandler to handle block and checkpoint proposals
+        // for monitoring or reexecution. Reexecution (default) allows us to follow the pending chain,
+        // while non-reexecution is used for validating the proposals and collecting their txs.
+        // Checkpoint proposals rebuild blobs if the blob client can upload blobs.
+        if (!validatorClient) {
+            const reexecute = !!config.alwaysReexecuteBlockProposals;
+            log.info(`Setting up proposal handler` + (reexecute ? ' with reexecution of proposals' : ''));
+            proposalHandler = createProposalHandler(config, {
+                checkpointsBuilder: validatorCheckpointsBuilder,
+                worldState: worldStateSynchronizer,
+                epochCache,
+                blockSource: archiver,
+                l1ToL2MessageSource: archiver,
+                p2pClient,
+                blobClient,
+                dateProvider,
+                telemetry,
+                reexecutionTracker
+            });
+            proposalHandler.register(p2pClient, reexecute, archiver);
+        }
+        // Start world state and wait for it to sync to the archiver.
+        await worldStateSynchronizer.start();
+        // Start p2p. Note that it depends on world state to be running.
+        await p2pClient.start();
+        let dataWithholdingWatcher;
+        let attestationsBlockWatcher;
+        let attestedInvalidProposalWatcher;
+        let broadcastedInvalidCheckpointProposalWatcher;
+        let checkpointEquivocationWatcher;
+        const validatorsSentinel = await createSentinel(epochCache, archiver, p2pClient, reexecutionTracker, config);
+        if (validatorsSentinel) {
+            watchers.push(validatorsSentinel);
+        }
+        if (collectOffenses) {
+            dataWithholdingWatcher = new DataWithholdingWatcher(epochCache, archiver, p2pClient.getTxProvider(), p2pClient, reexecutionTracker, {
+                chainId: config.l1ChainId,
+                rollupAddress: config.rollupAddress
+            }, config);
+            watchers.push(dataWithholdingWatcher);
+            broadcastedInvalidCheckpointProposalWatcher = new BroadcastedInvalidCheckpointProposalWatcher(p2pClient, archiver, epochCache, config);
+            watchers.push(broadcastedInvalidCheckpointProposalWatcher);
+            // The proposal handler (validator-owned or standalone) is the source of invalid-proposal/equivocation
+            // slots, so the watcher runs on non-validator offense collectors too.
+            if (proposalHandler) {
+                attestedInvalidProposalWatcher = new AttestedInvalidProposalWatcher(p2pClient, proposalHandler, archiver, epochCache, config, {
+                    log: log.createChild('attested-invalid-proposal-watcher')
+                });
+                watchers.push(attestedInvalidProposalWatcher);
+            }
+            checkpointEquivocationWatcher = new CheckpointEquivocationWatcher(archiver, epochCache, config);
+            watchers.push(checkpointEquivocationWatcher);
+            attestationsBlockWatcher = new AttestationsBlockWatcher(archiver, epochCache, config, log.getBindings());
+            watchers.push(attestationsBlockWatcher);
+        }
+        const watchersToStart = compactArray([
+            validatorsSentinel,
+            dataWithholdingWatcher,
+            attestationsBlockWatcher,
+            broadcastedInvalidCheckpointProposalWatcher,
+            attestedInvalidProposalWatcher,
+            checkpointEquivocationWatcher
+        ]);
+        const startedWatchers = [];
+        const stopStartedWatchers = async ()=>{
+            for (const watcher of startedWatchers){
+                await tryStop(watcher);
+            }
+        };
+        // Start p2p-related services once the archiver has completed sync
+        void archiver.waitForInitialSync().then(async ()=>{
+            for (const watcher of watchersToStart){
+                await watcher.start();
+                startedWatchers.push(watcher);
+            }
+            log.info(`All p2p services started`);
+        }).catch((err)=>log.error('Failed to start p2p services after archiver sync', err));
+        started.push({
+            stop: stopStartedWatchers
+        });
+        // Validator enabled, create/start relevant service
+        let sequencer;
+        let automineSequencer;
+        let slasherClient;
+        // The slasher can run standalone to collect offenses for non-validators; it only writes to L1 when a
+        // proposer is elected (which requires a sequencer), so running it read-only on a non-validator is safe.
+        if (collectOffenses) {
+            const validatorAddresses = keyStoreManager ? NodeKeystoreAdapter.fromKeyStoreManager(keyStoreManager).getAddresses() : [];
+            slasherClient = await createSlasher(config, pickL1ContractAddresses(config), getPublicClient(config), watchers, dateProvider, epochCache, validatorAddresses, undefined);
+            await slasherClient.start();
+            started.push(slasherClient);
+        }
+        if (!config.disableValidator && validatorClient) {
+            const l1TxUtils = config.sequencerPublisherForwarderAddress ? await createForwarderL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), config.sequencerPublisherForwarderAddress, {
+                ...config,
+                scope: 'sequencer'
+            }, {
+                telemetry,
+                logger: log.createChild('l1-tx-utils'),
+                dateProvider,
+                kzg: Blob.getViemKzgInstance()
+            }) : await createL1TxUtilsFromSigners(publicClient, keyStoreManager.createAllValidatorPublisherSigners(), {
+                ...config,
+                scope: 'sequencer'
+            }, {
+                telemetry,
+                logger: log.createChild('l1-tx-utils'),
+                dateProvider,
+                kzg: Blob.getViemKzgInstance()
+            });
+            // Create a funder L1TxUtils from the keystore funding account (if configured)
+            const fundingSigner = keyStoreManager?.createFundingSigner();
+            let funderL1TxUtils;
+            if (fundingSigner) {
+                const [funder] = await createL1TxUtilsFromSigners(publicClient, [
+                    fundingSigner
+                ], {
+                    ...config,
+                    scope: 'sequencer'
+                }, {
+                    telemetry,
+                    logger: log.createChild('l1-tx-utils:funder'),
+                    dateProvider
+                });
+                funderL1TxUtils = funder;
+            }
+            // Create and start the sequencer client
+            const checkpointsBuilder = new CheckpointsBuilder({
+                ...config,
+                l1GenesisTime,
+                slotDuration: Number(slotDuration),
+                rollupManaLimit
+            }, worldStateSynchronizer, archiver, dateProvider, telemetry, debugLogStore);
+            if (config.useAutomineSequencer) {
+                // Test-only path: deterministic, queue-driven sequencer for non-block-building e2e tests.
+                // See `AUTOMINE_E2E_OPTS` in `end-to-end/src/fixtures/fixtures.ts`.
+                automineSequencer = await createAutomineSequencer({
+                    config,
+                    l1TxUtils,
+                    funderL1TxUtils,
+                    publicClient,
+                    rollupContract,
+                    epochCache,
+                    blobClient,
+                    telemetry,
+                    dateProvider,
+                    keyStoreManager: keyStoreManager,
+                    validatorClient,
+                    checkpointsBuilder,
+                    globalVariableBuilder,
+                    worldStateSynchronizer,
+                    archiver,
+                    p2pClient,
+                    l1Constants: {
+                        l1GenesisTime,
+                        slotDuration: Number(slotDuration),
+                        ethereumSlotDuration: config.ethereumSlotDuration,
+                        rollupManaLimit
+                    },
+                    autoSettle: config.automineEnableProveEpoch,
+                    log
+                });
+            } else {
+                sequencer = await SequencerClient.new(config, {
+                    ...deps,
+                    epochCache,
+                    l1TxUtils,
+                    funderL1TxUtils,
+                    validatorClient,
+                    p2pClient,
+                    worldStateSynchronizer,
+                    slasherClient,
+                    checkpointsBuilder,
+                    l2BlockSource: archiver,
+                    l1ToL2MessageSource: archiver,
+                    telemetry,
+                    dateProvider,
+                    blobClient,
+                    nodeKeyStore: keyStoreManager,
+                    globalVariableBuilder
+                });
+            }
+        }
+        if (!options.dontStartSequencer && sequencer) {
+            await sequencer.start();
+            started.push(sequencer);
+            log.verbose(`Sequencer started`);
+        } else if (sequencer) {
+            log.warn(`Sequencer created but not started`);
+        }
+        if (!options.dontStartSequencer && automineSequencer) {
+            await automineSequencer.start();
+            started.push({
+                stop: ()=>automineSequencer.stop()
+            });
+            log.verbose(`AutomineSequencer started`);
+        } else if (automineSequencer) {
+            log.warn(`AutomineSequencer created but not started`);
+        }
+        // Create prover node subsystem if enabled
+        let proverNode;
+        if (config.enableProverNode) {
+            proverNode = await createProverNode(config, {
+                ...deps.proverNodeDeps,
+                telemetry,
+                dateProvider,
+                archiver,
+                worldStateSynchronizer,
+                p2pClient,
+                epochCache,
+                blobClient,
+                keyStoreManager
+            });
+            if (!options.dontStartProverNode) {
+                await proverNode.start();
+                started.push(proverNode);
+                log.info(`Prover node subsystem started`);
+            } else {
+                log.info(`Prover node subsystem created but not started`);
+            }
+        }
+        const node = new AztecNodeService({
+            config,
+            p2pClient,
+            blockSource: archiver,
+            logsSource: archiver,
+            contractDataSource: archiver,
+            l1ToL2MessageSource: archiver,
+            worldStateSynchronizer,
+            sequencer,
+            proverNode,
+            slasherClient,
+            validatorsSentinel,
+            stopStartedWatchers,
+            l1ChainId: ethereumChain.chainInfo.id,
+            version: config.rollupVersion,
+            globalVariableBuilder,
+            rollupContract,
+            feeProvider,
+            epochCache,
+            packageVersion,
+            peerProofVerifier,
+            rpcProofVerifier,
+            telemetry,
+            log,
+            blobClient,
+            validatorClient,
+            keyStoreManager,
+            debugLogStore,
+            automineSequencer
+        });
+        return node;
+    } catch (err) {
+        log.error('Failed during node creation, stopping started resources', err);
+        for (const resource of started.reverse()){
+            await tryStop(resource);
+        }
+        throw err;
+    }
+}
+/**
+ * Verifies the node's configured L1 timing matches the rollup contract it is pointed at, for the fields the
+ * node's own config carries. Each comparison is guarded against an undefined config value, so a config that
+ * does not carry a field is not checked. Throws a single error listing every mismatch. Runs in the shared
+ * startup path for every node role.
+ */ function checkConfigMatchesRollup(config, rollup) {
+    const mismatches = [];
+    if (config.aztecSlotDuration !== undefined && config.aztecSlotDuration !== rollup.slotDuration) {
+        mismatches.push(`aztecSlotDuration is ${config.aztecSlotDuration} but the rollup reports ${rollup.slotDuration}`);
+    }
+    if (config.aztecEpochDuration !== undefined && config.aztecEpochDuration !== rollup.epochDuration) {
+        mismatches.push(`aztecEpochDuration is ${config.aztecEpochDuration} but the rollup reports ${rollup.epochDuration}`);
+    }
+    if (mismatches.length > 0) {
+        throw new Error(`The node's configured L1 timing does not match the rollup contract it is pointed at: ${mismatches.join('; ')}`);
+    }
+}

package/dest/index.d.ts

@@ -1,3 +1,5 @@
 export * from './aztec-node/config.js';
+export * from './aztec-node/register_node_rpc_handlers.js';
 export * from './aztec-node/server.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsd0JBQXdCLENBQUMifQ==
+export * from './factory.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMsNENBQTRDLENBQUM7QUFDM0QsY0FBYyx3QkFBd0IsQ0FBQztBQUN2QyxjQUFjLGNBQWMsQ0FBQyJ9

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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dest/index.js

@@ -1,2 +1,4 @@
 export * from './aztec-node/config.js';
+export * from './aztec-node/register_node_rpc_handlers.js';
 export * from './aztec-node/server.js';
+export * from './factory.js';

package/dest/modules/block_parameter.d.ts

@@ -0,0 +1,25 @@
+import type { CheckpointNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import { type BlockParameter, BlockTag, type L2BlockSource, type NormalizedBlockParameter } from '@aztec/stdlib/block';
+import type { CheckpointParameter, CheckpointTag } from '@aztec/stdlib/interfaces/client';
+/** True when `value` is a {@link BlockTag}. */
+export declare function isBlockTag(value: string): value is BlockTag;
+/** True when `value` is a {@link CheckpointTag}. */
+export declare function isCheckpointTag(value: unknown): value is CheckpointTag;
+/**
+ * Normalizes a {@link BlockParameter} (which may be a bare value) into a {@link NormalizedBlockParameter}
+ * object form. Performs no chain-tip resolution — tag lookups are deferred to the underlying block source.
+ */
+export declare function normalizeBlockParameter(param: BlockParameter): NormalizedBlockParameter;
+/**
+ * Resolves a {@link CheckpointParameter} into a concrete `{ number }` or `{ slot }` query.
+ *
+ * Tag-based parameters (`'checkpointed'`, `'proven'`, `'finalized'`) are translated up-front to the
+ * corresponding tip's checkpoint number via {@link L2BlockSource.getL2Tips}. After resolution the unified
+ * `getCheckpoint` flow can perform a single confirmed→proposed lookup against either store.
+ */
+export declare function resolveCheckpointParameter(param: CheckpointParameter, blockSource: L2BlockSource): Promise<{
+    number: CheckpointNumber;
+} | {
+    slot: SlotNumber;
+}>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmxvY2tfcGFyYW1ldGVyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvbW9kdWxlcy9ibG9ja19wYXJhbWV0ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQWUsZ0JBQWdCLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFakcsT0FBTyxFQUVMLEtBQUssY0FBYyxFQUNuQixRQUFRLEVBQ1IsS0FBSyxhQUFhLEVBQ2xCLEtBQUssd0JBQXdCLEVBQzlCLE1BQU0scUJBQXFCLENBQUM7QUFDN0IsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsYUFBYSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFMUYsK0NBQStDO0FBQy9DLHdCQUFnQixVQUFVLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxLQUFLLElBQUksUUFBUSxDQUUzRDtBQUVELG9EQUFvRDtBQUNwRCx3QkFBZ0IsZUFBZSxDQUFDLEtBQUssRUFBRSxPQUFPLEdBQUcsS0FBSyxJQUFJLGFBQWEsQ0FFdEU7QUFFRDs7O0dBR0c7QUFDSCx3QkFBZ0IsdUJBQXVCLENBQUMsS0FBSyxFQUFFLGNBQWMsR0FBRyx3QkFBd0IsQ0ErQnZGO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsd0JBQXNCLDBCQUEwQixDQUM5QyxLQUFLLEVBQUUsbUJBQW1CLEVBQzFCLFdBQVcsRUFBRSxhQUFhLEdBQ3pCLE9BQU8sQ0FBQztJQUFFLE1BQU0sRUFBRSxnQkFBZ0IsQ0FBQTtDQUFFLEdBQUc7SUFBRSxJQUFJLEVBQUUsVUFBVSxDQUFBO0NBQUUsQ0FBQyxDQXdCOUQifQ==

package/dest/modules/block_parameter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block_parameter.d.ts","sourceRoot":"","sources":["../../src/modules/block_parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,gBAAgB,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAEjG,OAAO,EAEL,KAAK,cAAc,EACnB,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAE1F,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,wBAAwB,CA+BvF;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,mBAAmB,EAC1B,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAwB9D"}