@aztec-labs/prover-node 6.0.0-nightly.20260829

package/dest/checkpoint-store.js

@@ -0,0 +1,178 @@
+import { createLogger } from '@aztec-labs/foundation/log';
+import { getEpochAtSlot, getSlotRangeForEpoch } from '@aztec-labs/stdlib/epoch-helpers';
+import { CheckpointProver } from './job/checkpoint-prover.js';
+/**
+ * Prover-node-wide registry of `CheckpointProver` instances, content-addressed by
+ * `(checkpoint number, slot, checkpoint archive root)`.
+ *
+ * The store survives every epoch / session boundary. A prover lives from its first
+ * `addOrUpdate` call until either:
+ *  - its checkpoint is pruned by an L1 reorg (`cancelAndRemoveAboveBlock`), or
+ *  - its epoch's proof-submission window has closed (`reapExpired`), so the proof could no
+ *    longer be accepted on L1 even if produced.
+ *
+ * A prover's sub-tree work forks world-state per block and does not survive a prune of a base
+ * block, so there is nothing to preserve across a reorg: a pruned prover is cancelled and
+ * dropped, and a re-add (even of identical content) constructs a fresh prover.
+ */ export class CheckpointStore {
+    l2BlockSource;
+    proverDeps;
+    proverFactoryFn;
+    provers;
+    /**
+   * Teardowns of provers already removed from `provers` (by prune or reap), awaited on `stop()`.
+   * Keyed by a monotonic id rather than the prover's content id: a prune-then-re-add can leave two
+   * teardowns for the same content id in flight at once, which a content-id key would clobber.
+   */ pendingTeardowns;
+    nextTeardownId;
+    /** Test-only hooks injected into every prover this store constructs. */ testHooks;
+    log;
+    constructor(l2BlockSource, proverDeps, bindings, proverFactoryFn = (args, deps)=>new CheckpointProver(args, deps)){
+        this.l2BlockSource = l2BlockSource;
+        this.proverDeps = proverDeps;
+        this.proverFactoryFn = proverFactoryFn;
+        this.provers = new Map();
+        this.pendingTeardowns = new Map();
+        this.nextTeardownId = 0;
+        this.testHooks = {};
+        this.log = createLogger('prover-node:checkpoint-store', bindings);
+    }
+    start() {
+        return Promise.resolve();
+    }
+    async stop() {
+        // Cancel every live prover, then await both their teardown and any still in flight for provers
+        // already removed by a prune or reap.
+        const provers = Array.from(this.provers.values());
+        this.provers.clear();
+        for (const prover of provers){
+            prover.cancel();
+        }
+        await Promise.allSettled([
+            ...provers.map((p)=>p.whenDone()),
+            ...this.pendingTeardowns.values()
+        ]);
+    }
+    /**
+   * Tracks the teardown of a prover just removed from the store so `stop()` can await it. The entry
+   * removes itself once teardown settles, so the map stays bounded by the number in flight.
+   */ trackTeardown(prover) {
+        const id = this.nextTeardownId++;
+        const done = prover.whenDone();
+        this.pendingTeardowns.set(id, done);
+        void done.finally(()=>this.pendingTeardowns.delete(id));
+    }
+    /**
+   * Registers a checkpoint with the store. If a prover already exists for the
+   * `(number, slot, archive root)` content key it is reused (an at-least-once re-registration of
+   * still-canonical content); otherwise a new prover is constructed.
+   */ async addOrUpdate(checkpoint, data) {
+        const l1Constants = await this.l2BlockSource.getL1Constants();
+        const epochNumber = getEpochAtSlot(checkpoint.header.slotNumber, l1Constants);
+        const id = CheckpointProver.idFor(checkpoint);
+        const existing = this.provers.get(id);
+        if (existing) {
+            return existing;
+        }
+        // At most one canonical checkpoint per slot. A different checkpoint at the same slot means the
+        // caller forgot to prune the old chain before adding the replacement — surface it rather than
+        // silently creating a parallel canonical chain. A pruned checkpoint has already been removed,
+        // so every prover still in the store is canonical.
+        for (const prover of this.provers.values()){
+            if (prover.slotNumber === checkpoint.header.slotNumber) {
+                throw new Error(`Cannot add checkpoint ${checkpoint.number} (archive ${checkpoint.archive.root}) at slot ${checkpoint.header.slotNumber}: ` + `a different checkpoint already occupies this slot. Prune it first.`);
+            }
+        }
+        const prover = this.proverFactoryFn({
+            ...data,
+            checkpoint,
+            epochNumber
+        }, {
+            ...this.proverDeps,
+            checkpointProveOverride: this.testHooks.checkpointProveOverride,
+            log: this.log
+        });
+        this.provers.set(id, prover);
+        return prover;
+    }
+    /**
+   * Installs test-only hooks applied to every prover constructed from now on. Used by the e2e harness to
+   * force a checkpoint sub-tree failure without monkey-patching the prover factory.
+   */ setTestHooks(hooks) {
+        this.testHooks = hooks;
+    }
+    /**
+   * Cancels and removes every prover that holds a block above the prune target. A checkpoint is orphaned by a prune to
+   * block `targetBlockNumber` iff its last block sits above the target — including a checkpoint whose range straddles
+   * the target (partially orphaned), which block-range marking catches without boundary ambiguity. Keying off the
+   * surviving block number (rather than a checkpoint number) is correct even when the source has already
+   * re-checkpointed past the divergence: the prune event reports the highest surviving block, which by construction
+   * survives on the source, whereas the source's current checkpointed tip can sit above the prune target.
+   *
+   * The prover's in-flight sub-tree work forks world-state per block and faults once its base block is pruned, so it
+   * cannot be reused; it is cancelled (aborting the fork reads) and dropped. A subsequent re-add constructs a fresh
+   * prover. Returns the removed provers.
+   */ cancelAndRemoveAboveBlock(targetBlockNumber) {
+        const affected = [];
+        for (const [id, prover] of Array.from(this.provers.entries())){
+            const lastBlockNumber = prover.checkpoint.blocks.at(-1).number;
+            if (lastBlockNumber > targetBlockNumber) {
+                prover.cancel();
+                this.trackTeardown(prover);
+                this.provers.delete(id);
+                affected.push(prover);
+            }
+        }
+        return affected;
+    }
+    /**
+   * Drops provers whose epoch is at or below the supplied expired epoch. Once an epoch's
+   * proof-submission window has closed, its proof can no longer be accepted on L1, so the
+   * prover is no longer needed.
+   */ reapExpired(expiredEpoch) {
+        const reaped = [];
+        for (const [id, prover] of Array.from(this.provers.entries())){
+            if (prover.epochNumber <= expiredEpoch) {
+                reaped.push({
+                    id,
+                    checkpointNumber: prover.checkpoint.number,
+                    epochNumber: prover.epochNumber
+                });
+                prover.cancel({
+                    routine: true
+                });
+                this.trackTeardown(prover);
+                this.provers.delete(id);
+            }
+        }
+        if (reaped.length > 0) {
+            this.log.info(`Reaped ${reaped.length} expired CheckpointProver(s) for expiredEpoch ${expiredEpoch}`, {
+                expiredEpoch,
+                reapedCount: reaped.length,
+                reaped
+            });
+        }
+    }
+    /** Returns the prover with the supplied id, or undefined. */ get(id) {
+        return this.provers.get(id);
+    }
+    /** Returns the prover for the supplied checkpoint (by its content-addressed id), or undefined. */ getByCheckpoint(checkpoint) {
+        return this.provers.get(CheckpointProver.idFor(checkpoint));
+    }
+    /** Every prover currently in the store, in insertion order. */ listAll() {
+        return Array.from(this.provers.values());
+    }
+    /** Provers in the store, sorted by checkpoint number. */ list() {
+        return Array.from(this.provers.values()).sort((a, b)=>a.checkpoint.number - b.checkpoint.number);
+    }
+    /**
+   * Provers whose slot is in the supplied epoch's slot range, sorted by checkpoint number.
+   */ async listForEpoch(epoch) {
+        const l1Constants = await this.l2BlockSource.getL1Constants();
+        const [fromSlot, toSlot] = getSlotRangeForEpoch(epoch, l1Constants);
+        return this.listInSlotRange(fromSlot, toSlot);
+    }
+    /** Provers whose slot falls within `[fromSlot, toSlot]`, sorted by checkpoint number. */ listInSlotRange(fromSlot, toSlot) {
+        return this.list().filter((p)=>p.slotNumber >= fromSlot && p.slotNumber <= toSlot);
+    }
+}

package/dest/config.d.ts

@@ -0,0 +1,31 @@
+import type { ACVMConfig, BBConfig } from '@aztec-labs/bb-prover/config';
+import { type ConfigMappingsType } from '@aztec-labs/foundation/config';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { type KeyStoreConfig } from '@aztec-labs/node-keystore/config';
+import type { KeyStore } from '@aztec-labs/node-keystore/types';
+import { type SharedNodeConfig } from '@aztec-labs/node-lib/config';
+import { type ProverAgentConfig, type ProverBrokerConfig } from '@aztec-labs/prover-client/broker/config';
+import { type ProverClientUserConfig } from '@aztec-labs/prover-client/config';
+import { type ProverPublisherConfig, type ProverTxSenderConfig } from '@aztec-labs/sequencer-client/config';
+import { type DataStoreConfig } from '@aztec-labs/stdlib/kv-store';
+export type ProverNodeConfig = ProverClientUserConfig & ProverPublisherConfig & ProverTxSenderConfig & DataStoreConfig & KeyStoreConfig & SpecificProverNodeConfig & Pick<SharedNodeConfig, 'web3SignerUrl'>;
+export type SpecificProverNodeConfig = {
+    proverNodeMaxPendingJobs: number;
+    proverNodePollingIntervalMs: number;
+    proverNodeMaxParallelBlocksPerEpoch: number;
+    proverNodeFailedEpochStore: string | undefined;
+    proverNodeEpochProvingDelayMs: number | undefined;
+    proverNodeDisableProofPublish?: boolean;
+    txGatheringTimeoutMs: number;
+    txGatheringIntervalMs: number;
+    txGatheringBatchSize: number;
+    txGatheringMaxParallelRequestsPerNode: number;
+    proofSubmissionTargetAddress?: EthAddress;
+};
+export declare const specificProverNodeConfigMappings: ConfigMappingsType<SpecificProverNodeConfig>;
+export declare const proverNodeConfigMappings: ConfigMappingsType<ProverNodeConfig>;
+export declare function getProverNodeConfigFromEnv(): ProverNodeConfig;
+export declare function getProverNodeBrokerConfigFromEnv(): ProverBrokerConfig;
+export declare function getProverNodeAgentConfigFromEnv(): ProverAgentConfig & BBConfig & ACVMConfig;
+export declare function createKeyStoreForProver(config: ProverNodeConfig): KeyStore | undefined;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvY29uZmlnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFVBQVUsRUFBRSxRQUFRLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUN6RSxPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFLeEIsTUFBTSwrQkFBK0IsQ0FBQztBQUN2QyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sb0NBQW9DLENBQUM7QUFDaEUsT0FBTyxFQUFFLEtBQUssY0FBYyxFQUEwQixNQUFNLGtDQUFrQyxDQUFDO0FBRS9GLE9BQU8sS0FBSyxFQUFFLFFBQVEsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ2hFLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUE0QixNQUFNLDZCQUE2QixDQUFDO0FBQzlGLE9BQU8sRUFDTCxLQUFLLGlCQUFpQixFQUN0QixLQUFLLGtCQUFrQixFQUd4QixNQUFNLHlDQUF5QyxDQUFDO0FBQ2pELE9BQU8sRUFDTCxLQUFLLHNCQUFzQixFQUc1QixNQUFNLGtDQUFrQyxDQUFDO0FBQzFDLE9BQU8sRUFDTCxLQUFLLHFCQUFxQixFQUMxQixLQUFLLG9CQUFvQixFQUcxQixNQUFNLHFDQUFxQyxDQUFDO0FBQzdDLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBc0IsTUFBTSw2QkFBNkIsQ0FBQztBQUV2RixNQUFNLE1BQU0sZ0JBQWdCLEdBQUcsc0JBQXNCLEdBQ25ELHFCQUFxQixHQUNyQixvQkFBb0IsR0FDcEIsZUFBZSxHQUNmLGNBQWMsR0FDZCx3QkFBd0IsR0FDeEIsSUFBSSxDQUFDLGdCQUFnQixFQUFFLGVBQWUsQ0FBQyxDQUFDO0FBRTFDLE1BQU0sTUFBTSx3QkFBd0IsR0FBRztJQUNyQyx3QkFBd0IsRUFBRSxNQUFNLENBQUM7SUFDakMsMkJBQTJCLEVBQUUsTUFBTSxDQUFDO0lBQ3BDLG1DQUFtQyxFQUFFLE1BQU0sQ0FBQztJQUM1QywwQkFBMEIsRUFBRSxNQUFNLEdBQUcsU0FBUyxDQUFDO0lBQy9DLDZCQUE2QixFQUFFLE1BQU0sR0FBRyxTQUFTLENBQUM7SUFDbEQsNkJBQTZCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDeEMsb0JBQW9CLEVBQUUsTUFBTSxDQUFDO0lBQzdCLHFCQUFxQixFQUFFLE1BQU0sQ0FBQztJQUM5QixvQkFBb0IsRUFBRSxNQUFNLENBQUM7SUFDN0IscUNBQXFDLEVBQUUsTUFBTSxDQUFDO0lBQzlDLDRCQUE0QixDQUFDLEVBQUUsVUFBVSxDQUFDO0NBQzNDLENBQUM7QUFFRixlQUFPLE1BQU0sZ0NBQWdDLEVBQUUsa0JBQWtCLENBQUMsd0JBQXdCLENBMkR6RixDQUFDO0FBRUYsZUFBTyxNQUFNLHdCQUF3QixFQUFFLGtCQUFrQixDQUFDLGdCQUFnQixDQVF6RSxDQUFDO0FBRUYsd0JBQWdCLDBCQUEwQixJQUFJLGdCQUFnQixDQUU3RDtBQUVELHdCQUFnQixnQ0FBZ0MsSUFBSSxrQkFBa0IsQ0FJckU7QUFFRCx3QkFBZ0IsK0JBQStCLElBQUksaUJBQWlCLEdBQUcsUUFBUSxHQUFHLFVBQVUsQ0FLM0Y7QUEwREQsd0JBQWdCLHVCQUF1QixDQUFDLE1BQU0sRUFBRSxnQkFBZ0IsR0FBRyxRQUFRLEdBQUcsU0FBUyxDQVN0RiJ9

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,KAAK,kBAAkB,EAKxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,kCAAkC,CAAC;AAE/F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,KAAK,gBAAgB,EAA4B,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAGxB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,KAAK,sBAAsB,EAG5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAG1B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,6BAA6B,CAAC;AAEvF,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GACnD,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,cAAc,GACd,wBAAwB,GACxB,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AAE1C,MAAM,MAAM,wBAAwB,GAAG;IACrC,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;IACpC,mCAAmC,EAAE,MAAM,CAAC;IAC5C,0BAA0B,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,6BAA6B,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qCAAqC,EAAE,MAAM,CAAC;IAC9C,4BAA4B,CAAC,EAAE,UAAU,CAAC;CAC3C,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,kBAAkB,CAAC,wBAAwB,CA2DzF,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,kBAAkB,CAAC,gBAAgB,CAQzE,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,gBAAgB,CAE7D;AAED,wBAAgB,gCAAgC,IAAI,kBAAkB,CAIrE;AAED,wBAAgB,+BAA+B,IAAI,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAK3F;AA0DD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAStF"}

package/dest/config.js

@@ -0,0 +1,143 @@
+import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper, pickConfigMappings } from '@aztec-labs/foundation/config';
+import { EthAddress } from '@aztec-labs/foundation/eth-address';
+import { keyStoreConfigMappings } from '@aztec-labs/node-keystore/config';
+import { ethPrivateKeySchema } from '@aztec-labs/node-keystore/schemas';
+import { sharedNodeConfigMappings } from '@aztec-labs/node-lib/config';
+import { proverAgentConfigMappings, proverBrokerConfigMappings } from '@aztec-labs/prover-client/broker/config';
+import { bbConfigMappings, proverClientConfigMappings } from '@aztec-labs/prover-client/config';
+import { proverPublisherConfigMappings, proverTxSenderConfigMappings } from '@aztec-labs/sequencer-client/config';
+import { dataConfigMappings } from '@aztec-labs/stdlib/kv-store';
+export const specificProverNodeConfigMappings = {
+    proverNodeMaxPendingJobs: {
+        env: 'PROVER_NODE_MAX_PENDING_JOBS',
+        description: 'The maximum number of pending jobs for the prover node',
+        ...numberConfigHelper(10)
+    },
+    proverNodePollingIntervalMs: {
+        env: 'PROVER_NODE_POLLING_INTERVAL_MS',
+        description: 'The interval in milliseconds to poll for new jobs',
+        ...numberConfigHelper(1000)
+    },
+    proverNodeMaxParallelBlocksPerEpoch: {
+        env: 'PROVER_NODE_MAX_PARALLEL_BLOCKS_PER_EPOCH',
+        description: 'The Maximum number of blocks to process in parallel while proving an epoch',
+        ...numberConfigHelper(0)
+    },
+    proverNodeFailedEpochStore: {
+        env: 'PROVER_NODE_FAILED_EPOCH_STORE',
+        description: 'File store where to upload node state when an epoch fails to be proven',
+        defaultValue: undefined
+    },
+    proverNodeEpochProvingDelayMs: {
+        description: 'Optional delay in milliseconds to wait for late-arriving events (e.g. reorgs) to settle before starting top-tree proving for an epoch',
+        defaultValue: undefined
+    },
+    txGatheringIntervalMs: {
+        env: 'PROVER_NODE_TX_GATHERING_INTERVAL_MS',
+        description: 'How often to check that tx data is available',
+        ...numberConfigHelper(1_000)
+    },
+    txGatheringBatchSize: {
+        env: 'PROVER_NODE_TX_GATHERING_BATCH_SIZE',
+        description: 'How many transactions to gather from a node in a single request',
+        ...numberConfigHelper(10)
+    },
+    txGatheringMaxParallelRequestsPerNode: {
+        env: 'PROVER_NODE_TX_GATHERING_MAX_PARALLEL_REQUESTS_PER_NODE',
+        description: 'How many tx requests to make in parallel to each node',
+        ...numberConfigHelper(100)
+    },
+    txGatheringTimeoutMs: {
+        env: 'PROVER_NODE_TX_GATHERING_TIMEOUT_MS',
+        description: 'How long to wait for tx data to be available before giving up',
+        ...numberConfigHelper(120_000)
+    },
+    proverNodeDisableProofPublish: {
+        env: 'PROVER_NODE_DISABLE_PROOF_PUBLISH',
+        description: 'Whether the prover node skips publishing proofs to L1',
+        ...booleanConfigHelper(false)
+    },
+    proofSubmissionTargetAddress: {
+        env: 'PROVER_NODE_PROOF_SUBMISSION_TARGET_ADDRESS',
+        description: 'Optional L1 address the submitEpochRootProof tx is sent to. Must expose the identical submitEpochRootProof ABI ' + 'and forward to the rollup. Defaults to the rollup address.',
+        parseEnv: (val)=>EthAddress.fromString(val),
+        defaultValue: undefined
+    }
+};
+export const proverNodeConfigMappings = {
+    ...dataConfigMappings,
+    ...keyStoreConfigMappings,
+    ...proverClientConfigMappings,
+    ...proverPublisherConfigMappings,
+    ...proverTxSenderConfigMappings,
+    ...specificProverNodeConfigMappings,
+    ...pickConfigMappings(sharedNodeConfigMappings, [
+        'web3SignerUrl'
+    ])
+};
+export function getProverNodeConfigFromEnv() {
+    return getConfigFromMappings(proverNodeConfigMappings);
+}
+export function getProverNodeBrokerConfigFromEnv() {
+    return {
+        ...getConfigFromMappings(proverBrokerConfigMappings)
+    };
+}
+export function getProverNodeAgentConfigFromEnv() {
+    return {
+        ...getConfigFromMappings(proverAgentConfigMappings),
+        ...getConfigFromMappings(bbConfigMappings)
+    };
+}
+function createKeyStoreFromWeb3Signer(config) {
+    // If we don't have a valid prover Id then we can't build a valid key store with remote signers
+    if (config.proverId === undefined) {
+        return undefined;
+    }
+    // Also, we need at least one publisher address.
+    const publishers = config.proverPublisherAddresses ?? [];
+    if (publishers.length === 0) {
+        return undefined;
+    }
+    const keyStore = {
+        schemaVersion: 1,
+        slasher: undefined,
+        prover: {
+            id: config.proverId,
+            publisher: publishers
+        },
+        remoteSigner: config.web3SignerUrl,
+        validators: undefined
+    };
+    return keyStore;
+}
+function createKeyStoreFromPublisherKeys(config) {
+    // Extract the publisher keys from the provided config.
+    const publisherKeys = config.proverPublisherPrivateKeys ? config.proverPublisherPrivateKeys.map((k)=>ethPrivateKeySchema.parse(k.getValue())) : [];
+    // There must be at least 1.
+    if (publisherKeys.length === 0) {
+        return undefined;
+    }
+    // If we have a valid proverId then create a prover key store of the form { id, publisher: [publisherKeys] }
+    // Otherwise create one of the form ("0x12345678....." as EthAccount).
+    const keyStore = {
+        schemaVersion: 1,
+        slasher: undefined,
+        prover: config.proverId === undefined ? publisherKeys[0] : {
+            id: config.proverId,
+            publisher: publisherKeys
+        },
+        remoteSigner: undefined,
+        validators: undefined
+    };
+    return keyStore;
+}
+export function createKeyStoreForProver(config) {
+    if (config.web3SignerUrl !== undefined && config.web3SignerUrl.length > 0) {
+        const keyStore = createKeyStoreFromWeb3Signer(config);
+        if (keyStore) {
+            return keyStore;
+        }
+    }
+    return createKeyStoreFromPublisherKeys(config);
+}

package/dest/factory.d.ts

@@ -0,0 +1,36 @@
+import type { Archiver } from '@aztec-labs/archiver';
+import type { BlobClientInterface } from '@aztec-labs/blob-client/client';
+import type { EpochCacheInterface } from '@aztec-labs/epoch-cache';
+import { L1TxUtils } from '@aztec-labs/ethereum/l1-tx-utils';
+import { type Logger } from '@aztec-labs/foundation/log';
+import { DateProvider } from '@aztec-labs/foundation/timer';
+import { KeystoreManager } from '@aztec-labs/node-keystore';
+import { type ProverClientUserConfig } from '@aztec-labs/prover-client';
+import { type ProverPublisherConfig, type ProverTxSenderConfig } from '@aztec-labs/sequencer-client';
+import type { AvmSimulator } from '@aztec-labs/simulator/server';
+import type { ITxProvider, ProverConfig, ProvingJobBroker, Service, WorldStateSynchronizer } from '@aztec-labs/stdlib/interfaces/server';
+import { type TelemetryClient } from '@aztec-labs/telemetry-client';
+import type { SpecificProverNodeConfig } from './config.js';
+import { ProverNode } from './prover-node.js';
+import { ProverPublisherFactory } from './prover-publisher-factory.js';
+export type ProverNodeDeps = {
+    telemetry?: TelemetryClient;
+    log?: Logger;
+    archiver: Archiver;
+    publisherFactory?: ProverPublisherFactory;
+    broker?: ProvingJobBroker;
+    l1TxUtils?: L1TxUtils;
+    dateProvider?: DateProvider;
+    worldStateSynchronizer: WorldStateSynchronizer;
+    p2pClient: {
+        getTxProvider(): ITxProvider;
+    } & Partial<Service>;
+    epochCache: EpochCacheInterface;
+    blobClient: BlobClientInterface;
+    keyStoreManager?: KeystoreManager;
+    /** AVM execution backend (simulator pool + CDB server) for public simulation. */
+    avmSimulator: AvmSimulator;
+};
+/** Creates a new prover node subsystem given a config and dependencies */
+export declare function createProverNode(userConfig: SpecificProverNodeConfig & ProverConfig & ProverClientUserConfig & ProverPublisherConfig & ProverTxSenderConfig, deps: ProverNodeDeps): Promise<ProverNode>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2ZhY3RvcnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDckQsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUUxRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBSW5FLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUc3RCxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQWdCLE1BQU0sNEJBQTRCLENBQUM7QUFDdkUsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQzVELE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU1RCxPQUFPLEVBQTJCLEtBQUssc0JBQXNCLEVBQXNCLE1BQU0sMkJBQTJCLENBQUM7QUFFckgsT0FBTyxFQUNMLEtBQUsscUJBQXFCLEVBQzFCLEtBQUssb0JBQW9CLEVBRTFCLE1BQU0sOEJBQThCLENBQUM7QUFDdEMsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQ1YsV0FBVyxFQUNYLFlBQVksRUFDWixnQkFBZ0IsRUFDaEIsT0FBTyxFQUNQLHNCQUFzQixFQUN2QixNQUFNLHNDQUFzQyxDQUFDO0FBQzlDLE9BQU8sRUFBYSxLQUFLLGVBQWUsRUFBc0IsTUFBTSw4QkFBOEIsQ0FBQztBQUduRyxPQUFPLEtBQUssRUFBRSx3QkFBd0IsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUM1RCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDOUMsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFdkUsTUFBTSxNQUFNLGNBQWMsR0FBRztJQUMzQixTQUFTLENBQUMsRUFBRSxlQUFlLENBQUM7SUFDNUIsR0FBRyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2IsUUFBUSxFQUFFLFFBQVEsQ0FBQztJQUNuQixnQkFBZ0IsQ0FBQyxFQUFFLHNCQUFzQixDQUFDO0lBQzFDLE1BQU0sQ0FBQyxFQUFFLGdCQUFnQixDQUFDO0lBQzFCLFNBQVMsQ0FBQyxFQUFFLFNBQVMsQ0FBQztJQUN0QixZQUFZLENBQUMsRUFBRSxZQUFZLENBQUM7SUFDNUIsc0JBQXNCLEVBQUUsc0JBQXNCLENBQUM7SUFDL0MsU0FBUyxFQUFFO1FBQUUsYUFBYSxJQUFJLFdBQVcsQ0FBQTtLQUFFLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQy9ELFVBQVUsRUFBRSxtQkFBbUIsQ0FBQztJQUNoQyxVQUFVLEVBQUUsbUJBQW1CLENBQUM7SUFDaEMsZUFBZSxDQUFDLEVBQUUsZUFBZSxDQUFDO0lBQ2xDLGlGQUFpRjtJQUNqRixZQUFZLEVBQUUsWUFBWSxDQUFDO0NBQzVCLENBQUM7QUFFRiwwRUFBMEU7QUFDMUUsd0JBQXNCLGdCQUFnQixDQUNwQyxVQUFVLEVBQUUsd0JBQXdCLEdBQ2xDLFlBQVksR0FDWixzQkFBc0IsR0FDdEIscUJBQXFCLEdBQ3JCLG9CQUFvQixFQUN0QixJQUFJLEVBQUUsY0FBYyx1QkFrSXJCIn0=

package/dest/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAG7D,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAA2B,KAAK,sBAAsB,EAAsB,MAAM,2BAA2B,CAAC;AAErH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAE1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACP,sBAAsB,EACvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAa,KAAK,eAAe,EAAsB,MAAM,8BAA8B,CAAC;AAGnG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,SAAS,EAAE;QAAE,aAAa,IAAI,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,UAAU,EAAE,mBAAmB,CAAC;IAChC,UAAU,EAAE,mBAAmB,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iFAAiF;IACjF,YAAY,EAAE,YAAY,CAAC;CAC5B,CAAC;AAEF,0EAA0E;AAC1E,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,wBAAwB,GAClC,YAAY,GACZ,sBAAsB,GACtB,qBAAqB,GACrB,oBAAoB,EACtB,IAAI,EAAE,cAAc,uBAkIrB"}

package/dest/factory.js

@@ -0,0 +1,105 @@
+import { Blob } from '@aztec-labs/blob-lib';
+import { createEthereumChain } from '@aztec-labs/ethereum/chain';
+import { makeL1HttpTransport } from '@aztec-labs/ethereum/client';
+import { RollupContract } from '@aztec-labs/ethereum/contracts';
+import { PublisherManager } from '@aztec-labs/ethereum/publisher-manager';
+import { pick } from '@aztec-labs/foundation/collection';
+import { createLogger } from '@aztec-labs/foundation/log';
+import { DateProvider } from '@aztec-labs/foundation/timer';
+import { createForwarderL1TxUtilsFromSigners, createL1TxUtilsFromSigners } from '@aztec-labs/node-lib/factories';
+import { createProverClient } from '@aztec-labs/prover-client';
+import { createAndStartProvingBroker } from '@aztec-labs/prover-client/broker';
+import { getPublisherConfigFromProverConfig } from '@aztec-labs/sequencer-client';
+import { L1Metrics, getTelemetryClient } from '@aztec-labs/telemetry-client';
+import { createPublicClient } from 'viem';
+import { ProverNode } from './prover-node.js';
+import { ProverPublisherFactory } from './prover-publisher-factory.js';
+/** Creates a new prover node subsystem given a config and dependencies */ export async function createProverNode(userConfig, deps) {
+    const config = {
+        ...userConfig
+    };
+    const telemetry = deps.telemetry ?? getTelemetryClient();
+    const dateProvider = deps.dateProvider ?? new DateProvider();
+    const log = deps.log ?? createLogger('prover');
+    const { p2pClient, archiver, keyStoreManager, worldStateSynchronizer } = deps;
+    // Extract the prover signers from the key store and verify that we have one.
+    await keyStoreManager?.validateSigners();
+    const proverSigners = keyStoreManager?.createProverSigners();
+    if (proverSigners === undefined) {
+        throw new Error('Failed to create prover key store configuration');
+    } else if (proverSigners.signers.length === 0) {
+        throw new Error('No prover signers found in the key store');
+    }
+    log.info(`Creating prover with publishers ${proverSigners.signers.map((signer)=>signer.address.toString()).join()}`);
+    // Only consider user provided config if it is valid
+    const proverIdInUserConfig = config.proverId === undefined || config.proverId.isZero() ? undefined : config.proverId;
+    // ProverId: Take from key store if provided, otherwise from user config if valid, otherwise address of first signer
+    const proverId = proverSigners.id ?? proverIdInUserConfig ?? proverSigners.signers[0].address;
+    // Now create the prover client configuration from this.
+    const proverClientConfig = {
+        ...config,
+        proverId
+    };
+    const broker = deps.broker ?? await createAndStartProvingBroker(config, telemetry);
+    const prover = await createProverClient(proverClientConfig, worldStateSynchronizer, broker, telemetry);
+    const { l1RpcUrls: rpcUrls, l1ChainId: chainId } = config;
+    const chain = createEthereumChain(rpcUrls, chainId);
+    const publicClient = createPublicClient({
+        chain: chain.chainInfo,
+        transport: makeL1HttpTransport(config.l1RpcUrls, {
+            timeout: config.l1HttpTimeoutMS
+        }),
+        pollingInterval: config.viemPollingIntervalMS
+    });
+    const rollupContract = new RollupContract(publicClient, config.rollupAddress.toString());
+    const l1TxUtils = deps.l1TxUtils ? [
+        deps.l1TxUtils
+    ] : config.proverPublisherForwarderAddress ? await createForwarderL1TxUtilsFromSigners(publicClient, proverSigners.signers, config.proverPublisherForwarderAddress, {
+        ...config,
+        scope: 'prover'
+    }, {
+        telemetry,
+        logger: log.createChild('l1-tx-utils'),
+        dateProvider,
+        kzg: Blob.getViemKzgInstance()
+    }) : await createL1TxUtilsFromSigners(publicClient, proverSigners.signers, {
+        ...config,
+        scope: 'prover'
+    }, {
+        telemetry,
+        logger: log.createChild('l1-tx-utils'),
+        dateProvider
+    });
+    // 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: 'prover'
+        }, {
+            telemetry,
+            logger: log.createChild('l1-tx-utils:funder'),
+            dateProvider
+        });
+        funderL1TxUtils = funder;
+    }
+    const publisherFactory = deps.publisherFactory ?? new ProverPublisherFactory(config, {
+        rollupContract,
+        proofSubmissionTarget: config.proofSubmissionTargetAddress,
+        publisherManager: new PublisherManager(l1TxUtils, getPublisherConfigFromProverConfig(config), {
+            bindings: log.getBindings(),
+            funder: funderL1TxUtils
+        }),
+        telemetry
+    });
+    const proverNodeConfig = {
+        ...pick(config, 'proverNodeMaxPendingJobs', 'proverNodeMaxParallelBlocksPerEpoch', 'proverNodePollingIntervalMs', 'proverNodeEpochProvingDelayMs', 'txGatheringMaxParallelRequests', 'txGatheringIntervalMs', 'txGatheringTimeoutMs', 'proverNodeFailedEpochStore', 'proverNodeDisableProofPublish', 'dataDirectory', 'l1ChainId', 'rollupVersion')
+    };
+    const l1Metrics = new L1Metrics(telemetry.getMeter('ProverNodeL1Metrics'), publicClient, l1TxUtils.map((utils)=>utils.getSenderAddress()));
+    // Extract the shared delayer from the first L1TxUtils instance (all instances share the same delayer)
+    const delayer = l1TxUtils[0]?.delayer;
+    return new ProverNode(prover, publisherFactory, archiver, archiver, archiver, worldStateSynchronizer, p2pClient, rollupContract, l1Metrics, deps.avmSimulator, proverNodeConfig, telemetry, delayer, dateProvider);
+}

package/dest/index.d.ts

@@ -0,0 +1,8 @@
+export * from './actions/index.js';
+export * from './config.js';
+export * from './factory.js';
+export * from './monitors/index.js';
+export * from './proof-publishing-service.js';
+export * from './prover-node-publisher.js';
+export * from './prover-node.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLG9CQUFvQixDQUFDO0FBQ25DLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLDRCQUE0QixDQUFDO0FBQzNDLGNBQWMsa0JBQWtCLENBQUMifQ==

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC"}

package/dest/index.js

@@ -0,0 +1,7 @@
+export * from './actions/index.js';
+export * from './config.js';
+export * from './factory.js';
+export * from './monitors/index.js';
+export * from './proof-publishing-service.js';
+export * from './prover-node-publisher.js';
+export * from './prover-node.js';