@aztec/validator-client 0.0.0-test.0

package/dest/config.d.ts

@@ -0,0 +1,22 @@
+import { type ConfigMappingsType } from '@aztec/foundation/config';
+/**
+ * The Validator Configuration
+ */
+export interface ValidatorClientConfig {
+    /** The private key of the validator participating in attestation duties */
+    validatorPrivateKey?: string;
+    /** Do not run the validator */
+    disableValidator: boolean;
+    /** Interval between polling for new attestations from peers */
+    attestationPollingIntervalMs: number;
+    /** Re-execute transactions before attesting */
+    validatorReexecute: boolean;
+}
+export declare const validatorClientConfigMappings: ConfigMappingsType<ValidatorClientConfig>;
+/**
+ * Returns the prover configuration from the environment variables.
+ * Note: If an environment variable is not set, the default value is used.
+ * @returns The validator configuration.
+ */
+export declare function getProverEnvVars(): ValidatorClientConfig;
+//# sourceMappingURL=config.d.ts.map

package/dest/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,0BAA0B,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,+BAA+B;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAE1B,+DAA+D;IAC/D,4BAA4B,EAAE,MAAM,CAAC;IAErC,+CAA+C;IAC/C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,6BAA6B,EAAE,kBAAkB,CAAC,qBAAqB,CAqBnF,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,qBAAqB,CAExD"}

package/dest/config.js

@@ -0,0 +1,31 @@
+import { NULL_KEY } from '@aztec/ethereum';
+import { booleanConfigHelper, getConfigFromMappings, numberConfigHelper } from '@aztec/foundation/config';
+export const validatorClientConfigMappings = {
+    validatorPrivateKey: {
+        env: 'VALIDATOR_PRIVATE_KEY',
+        parseEnv: (val)=>val ? `0x${val.replace('0x', '')}` : NULL_KEY,
+        description: 'The private key of the validator participating in attestation duties'
+    },
+    disableValidator: {
+        env: 'VALIDATOR_DISABLED',
+        description: 'Do not run the validator',
+        ...booleanConfigHelper()
+    },
+    attestationPollingIntervalMs: {
+        env: 'VALIDATOR_ATTESTATIONS_POLLING_INTERVAL_MS',
+        description: 'Interval between polling for new attestations',
+        ...numberConfigHelper(200)
+    },
+    validatorReexecute: {
+        env: 'VALIDATOR_REEXECUTE',
+        description: 'Re-execute transactions before attesting',
+        ...booleanConfigHelper(true)
+    }
+};
+/**
+ * Returns the prover configuration from the environment variables.
+ * Note: If an environment variable is not set, the default value is used.
+ * @returns The validator configuration.
+ */ export function getProverEnvVars() {
+    return getConfigFromMappings(validatorClientConfigMappings);
+}

package/dest/duties/validation_service.d.ts

@@ -0,0 +1,29 @@
+import type { Fr } from '@aztec/foundation/fields';
+import { BlockAttestation, BlockProposal } from '@aztec/stdlib/p2p';
+import type { BlockHeader, TxHash } from '@aztec/stdlib/tx';
+import type { ValidatorKeyStore } from '../key_store/interface.js';
+export declare class ValidationService {
+    private keyStore;
+    constructor(keyStore: ValidatorKeyStore);
+    /**
+     * Create a block proposal with the given header, archive, and transactions
+     *
+     * @param header - The block header
+     * @param archive - The archive of the current block
+     * @param txs - TxHash[] ordered list of transactions
+     *
+     * @returns A block proposal signing the above information (not the current implementation!!!)
+     */
+    createBlockProposal(header: BlockHeader, archive: Fr, txs: TxHash[]): Promise<BlockProposal>;
+    /**
+     * Attest to the given block proposal constructed by the current sequencer
+     *
+     * NOTE: This is just a blind signing.
+     *       We assume that the proposal is valid and DA guarantees have been checked previously.
+     *
+     * @param proposal - The proposal to attest to
+     * @returns attestation
+     */
+    attestToProposal(proposal: BlockProposal): Promise<BlockAttestation>;
+}
+//# sourceMappingURL=validation_service.d.ts.map

package/dest/duties/validation_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation_service.d.ts","sourceRoot":"","sources":["../../src/duties/validation_service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAA8C,MAAM,mBAAmB,CAAC;AAChH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,iBAAiB;IAE/C;;;;;;;;OAQG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAM5F;;;;;;;;OAQG;IACG,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAS3E"}

package/dest/duties/validation_service.js

@@ -0,0 +1,35 @@
+import { Buffer32 } from '@aztec/foundation/buffer';
+import { keccak256 } from '@aztec/foundation/crypto';
+import { BlockAttestation, BlockProposal, ConsensusPayload, SignatureDomainSeparator } from '@aztec/stdlib/p2p';
+export class ValidationService {
+    keyStore;
+    constructor(keyStore){
+        this.keyStore = keyStore;
+    }
+    /**
+   * Create a block proposal with the given header, archive, and transactions
+   *
+   * @param header - The block header
+   * @param archive - The archive of the current block
+   * @param txs - TxHash[] ordered list of transactions
+   *
+   * @returns A block proposal signing the above information (not the current implementation!!!)
+   */ createBlockProposal(header, archive, txs) {
+        const payloadSigner = (payload)=>this.keyStore.signMessage(payload);
+        return BlockProposal.createProposalFromSigner(new ConsensusPayload(header, archive, txs), payloadSigner);
+    }
+    /**
+   * Attest to the given block proposal constructed by the current sequencer
+   *
+   * NOTE: This is just a blind signing.
+   *       We assume that the proposal is valid and DA guarantees have been checked previously.
+   *
+   * @param proposal - The proposal to attest to
+   * @returns attestation
+   */ async attestToProposal(proposal) {
+        // TODO(https://github.com/AztecProtocol/aztec-packages/issues/7961): check that the current validator is correct
+        const buf = Buffer32.fromBuffer(keccak256(await proposal.payload.getPayloadToSign(SignatureDomainSeparator.blockAttestation)));
+        const sig = await this.keyStore.signMessage(buf);
+        return new BlockAttestation(proposal.payload, sig);
+    }
+}

package/dest/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validator.error.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dest/errors/index.js

@@ -0,0 +1 @@
+export * from './validator.error.js';

package/dest/errors/validator.error.d.ts

@@ -0,0 +1,29 @@
+import type { TxHash } from '@aztec/stdlib/tx';
+export declare class ValidatorError extends Error {
+    constructor(message: string);
+}
+export declare class InvalidValidatorPrivateKeyError extends ValidatorError {
+    constructor();
+}
+export declare class AttestationTimeoutError extends ValidatorError {
+    constructor(numberOfRequiredAttestations: number, slot: bigint);
+}
+export declare class TransactionsNotAvailableError extends ValidatorError {
+    constructor(txHashes: TxHash[]);
+}
+export declare class FailedToReExecuteTransactionsError extends ValidatorError {
+    constructor(txHashes: TxHash[]);
+}
+export declare class ReExStateMismatchError extends ValidatorError {
+    constructor();
+}
+export declare class ReExFailedTxsError extends ValidatorError {
+    constructor(numFailedTxs: number);
+}
+export declare class ReExTimeoutError extends ValidatorError {
+    constructor();
+}
+export declare class BlockBuilderNotProvidedError extends ValidatorError {
+    constructor();
+}
+//# sourceMappingURL=validator.error.d.ts.map

package/dest/errors/validator.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.error.d.ts","sourceRoot":"","sources":["../../src/errors/validator.error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,+BAAgC,SAAQ,cAAc;;CAIlE;AAED,qBAAa,uBAAwB,SAAQ,cAAc;gBAC7C,4BAA4B,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAG/D;AAED,qBAAa,6BAA8B,SAAQ,cAAc;gBACnD,QAAQ,EAAE,MAAM,EAAE;CAG/B;AAED,qBAAa,kCAAmC,SAAQ,cAAc;gBACxD,QAAQ,EAAE,MAAM,EAAE;CAG/B;AAED,qBAAa,sBAAuB,SAAQ,cAAc;;CAIzD;AAED,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,YAAY,EAAE,MAAM;CAGjC;AAED,qBAAa,gBAAiB,SAAQ,cAAc;;CAInD;AAED,qBAAa,4BAA6B,SAAQ,cAAc;;CAI/D"}

package/dest/errors/validator.error.js

@@ -0,0 +1,45 @@
+export class ValidatorError extends Error {
+    constructor(message){
+        super(`Validator Error: ${message}`);
+    }
+}
+export class InvalidValidatorPrivateKeyError extends ValidatorError {
+    constructor(){
+        super('Invalid validator private key provided');
+    }
+}
+export class AttestationTimeoutError extends ValidatorError {
+    constructor(numberOfRequiredAttestations, slot){
+        super(`Timeout waiting for ${numberOfRequiredAttestations} attestations for slot, ${slot}`);
+    }
+}
+export class TransactionsNotAvailableError extends ValidatorError {
+    constructor(txHashes){
+        super(`Transactions not available: ${txHashes.join(', ')}`);
+    }
+}
+export class FailedToReExecuteTransactionsError extends ValidatorError {
+    constructor(txHashes){
+        super(`Failed to re-execute transactions: ${txHashes.join(', ')}`);
+    }
+}
+export class ReExStateMismatchError extends ValidatorError {
+    constructor(){
+        super('Re-execution state mismatch');
+    }
+}
+export class ReExFailedTxsError extends ValidatorError {
+    constructor(numFailedTxs){
+        super(`Re-execution failed to process ${numFailedTxs} txs`);
+    }
+}
+export class ReExTimeoutError extends ValidatorError {
+    constructor(){
+        super('Re-execution timed out or failed to process all txs in the proposal');
+    }
+}
+export class BlockBuilderNotProvidedError extends ValidatorError {
+    constructor(){
+        super('Block builder not provided');
+    }
+}

package/dest/factory.d.ts

@@ -0,0 +1,13 @@
+import type { EpochCache } from '@aztec/epoch-cache';
+import type { DateProvider } from '@aztec/foundation/timer';
+import type { P2P } from '@aztec/p2p';
+import type { TelemetryClient } from '@aztec/telemetry-client';
+import type { ValidatorClientConfig } from './config.js';
+import { ValidatorClient } from './validator.js';
+export declare function createValidatorClient(config: ValidatorClientConfig, deps: {
+    p2pClient: P2P;
+    telemetry: TelemetryClient;
+    dateProvider: DateProvider;
+    epochCache: EpochCache;
+}): ValidatorClient | undefined;
+//# sourceMappingURL=factory.d.ts.map

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,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE;IACJ,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,eAAe,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,UAAU,CAAC;CACxB,+BAUF"}

package/dest/factory.js

@@ -0,0 +1,11 @@
+import { generatePrivateKey } from 'viem/accounts';
+import { ValidatorClient } from './validator.js';
+export function createValidatorClient(config, deps) {
+    if (config.disableValidator) {
+        return undefined;
+    }
+    if (config.validatorPrivateKey === undefined || config.validatorPrivateKey === '') {
+        config.validatorPrivateKey = generatePrivateKey();
+    }
+    return ValidatorClient.new(config, deps.epochCache, deps.p2pClient, deps.dateProvider, deps.telemetry);
+}

package/dest/index.d.ts

@@ -0,0 +1,4 @@
+export * from './config.js';
+export * from './validator.js';
+export * from './factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dest/index.js

@@ -0,0 +1,3 @@
+export * from './config.js';
+export * from './validator.js';
+export * from './factory.js';

package/dest/key_store/index.d.ts

@@ -0,0 +1,3 @@
+export * from './interface.js';
+export * from './local_key_store.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/key_store/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dest/key_store/index.js

@@ -0,0 +1,2 @@
+export * from './interface.js';
+export * from './local_key_store.js';

package/dest/key_store/interface.d.ts

@@ -0,0 +1,25 @@
+import type { Buffer32 } from '@aztec/foundation/buffer';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import type { Signature } from '@aztec/foundation/eth-signature';
+/** Key Store
+ *
+ * A keystore interface that can be replaced with a local keystore / remote signer service
+ */
+export interface ValidatorKeyStore {
+    /**
+     * Get the address of the signer
+     *
+     * @returns the address
+     */
+    getAddress(): EthAddress;
+    sign(message: Buffer32): Promise<Signature>;
+    /**
+     * Flavor of sign message that followed EIP-712 eth signed message prefix
+     * Note: this is only required when we are using ecdsa signatures over secp256k1
+     *
+     * @param message - The message to sign.
+     * @returns The signature.
+     */
+    signMessage(message: Buffer32): Promise<Signature>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dest/key_store/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/key_store/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,UAAU,IAAI,UAAU,CAAC;IAEzB,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACpD"}

package/dest/key_store/interface.js

@@ -0,0 +1,4 @@
+/** Key Store
+ *
+ * A keystore interface that can be replaced with a local keystore / remote signer service
+ */ export { };

package/dest/key_store/local_key_store.d.ts

@@ -0,0 +1,28 @@
+import type { Buffer32 } from '@aztec/foundation/buffer';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import type { Signature } from '@aztec/foundation/eth-signature';
+import type { ValidatorKeyStore } from './interface.js';
+/**
+ * Local Key Store
+ *
+ * An implementation of the Key store using an in memory private key.
+ */
+export declare class LocalKeyStore implements ValidatorKeyStore {
+    private signer;
+    constructor(privateKey: Buffer32);
+    /**
+     * Get the address of the signer
+     *
+     * @returns the address
+     */
+    getAddress(): EthAddress;
+    /**
+     * Sign a message with the keystore private key
+     *
+     * @param messageBuffer - The message buffer to sign
+     * @return signature
+     */
+    sign(digest: Buffer32): Promise<Signature>;
+    signMessage(message: Buffer32): Promise<Signature>;
+}
+//# sourceMappingURL=local_key_store.d.ts.map

package/dest/key_store/local_key_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_key_store.d.ts","sourceRoot":"","sources":["../../src/key_store/local_key_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,OAAO,CAAC,MAAM,CAAkB;gBAEpB,UAAU,EAAE,QAAQ;IAIhC;;;;OAIG;IACI,UAAU,IAAI,UAAU;IAI/B;;;;;OAKG;IACI,IAAI,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAM1C,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;CAK1D"}

package/dest/key_store/local_key_store.js

@@ -0,0 +1,32 @@
+import { Secp256k1Signer } from '@aztec/foundation/crypto';
+/**
+ * Local Key Store
+ *
+ * An implementation of the Key store using an in memory private key.
+ */ export class LocalKeyStore {
+    signer;
+    constructor(privateKey){
+        this.signer = new Secp256k1Signer(privateKey);
+    }
+    /**
+   * Get the address of the signer
+   *
+   * @returns the address
+   */ getAddress() {
+        return this.signer.address;
+    }
+    /**
+   * Sign a message with the keystore private key
+   *
+   * @param messageBuffer - The message buffer to sign
+   * @return signature
+   */ sign(digest) {
+        const signature = this.signer.sign(digest);
+        return Promise.resolve(signature);
+    }
+    signMessage(message) {
+        // Sign message adds eth sign prefix and hashes before signing
+        const signature = this.signer.signMessage(message);
+        return Promise.resolve(signature);
+    }
+}

package/dest/metrics.d.ts

@@ -0,0 +1,11 @@
+import type { BlockProposal } from '@aztec/stdlib/p2p';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+export declare class ValidatorMetrics {
+    private reExecutionTime;
+    private failedReexecutionCounter;
+    constructor(telemetryClient: TelemetryClient);
+    reExecutionTimer(): () => void;
+    recordReExecutionTime(time: number): void;
+    recordFailedReexecution(proposal: BlockProposal): Promise<void>;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dest/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAIL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,wBAAwB,CAAgB;gBAEpC,eAAe,EAAE,eAAe;IAgBrC,gBAAgB,IAAI,MAAM,IAAI;IAQ9B,qBAAqB,CAAC,IAAI,EAAE,MAAM;IAI5B,uBAAuB,CAAC,QAAQ,EAAE,aAAa;CAO7D"}

package/dest/metrics.js

@@ -0,0 +1,35 @@
+import { Attributes, Metrics, ValueType } from '@aztec/telemetry-client';
+export class ValidatorMetrics {
+    reExecutionTime;
+    failedReexecutionCounter;
+    constructor(telemetryClient){
+        const meter = telemetryClient.getMeter('Validator');
+        this.failedReexecutionCounter = meter.createUpDownCounter(Metrics.VALIDATOR_FAILED_REEXECUTION_COUNT, {
+            description: 'The number of failed re-executions',
+            unit: 'count',
+            valueType: ValueType.INT
+        });
+        this.reExecutionTime = meter.createGauge(Metrics.VALIDATOR_RE_EXECUTION_TIME, {
+            description: 'The time taken to re-execute a transaction',
+            unit: 'ms',
+            valueType: ValueType.DOUBLE
+        });
+    }
+    reExecutionTimer() {
+        const start = performance.now();
+        return ()=>{
+            const end = performance.now();
+            this.recordReExecutionTime(end - start);
+        };
+    }
+    recordReExecutionTime(time) {
+        this.reExecutionTime.record(time);
+    }
+    async recordFailedReexecution(proposal) {
+        this.failedReexecutionCounter.add(1, {
+            [Attributes.STATUS]: 'failed',
+            [Attributes.BLOCK_NUMBER]: proposal.payload.header.globalVariables.blockNumber.toString(),
+            [Attributes.BLOCK_PROPOSER]: (await proposal.getSender())?.toString()
+        });
+    }
+}

package/dest/validator.d.ts

@@ -0,0 +1,81 @@
+import type { EpochCache } from '@aztec/epoch-cache';
+import type { Fr } from '@aztec/foundation/fields';
+import { DateProvider, type Timer } from '@aztec/foundation/timer';
+import type { P2P } from '@aztec/p2p';
+import type { L2Block } from '@aztec/stdlib/block';
+import type { BlockAttestation, BlockProposal } from '@aztec/stdlib/p2p';
+import type { BlockHeader, GlobalVariables, Tx, TxHash } from '@aztec/stdlib/tx';
+import { type TelemetryClient, WithTracer } from '@aztec/telemetry-client';
+import type { ValidatorClientConfig } from './config.js';
+import type { ValidatorKeyStore } from './key_store/interface.js';
+/**
+ * Callback function for building a block
+ *
+ * We reuse the sequencer's block building functionality for re-execution
+ */
+type BlockBuilderCallback = (txs: Iterable<Tx> | AsyncIterableIterator<Tx>, globalVariables: GlobalVariables, opts?: {
+    validateOnly?: boolean;
+}) => Promise<{
+    block: L2Block;
+    publicProcessorDuration: number;
+    numTxs: number;
+    numFailedTxs: number;
+    blockBuildingTimer: Timer;
+}>;
+export interface Validator {
+    start(): Promise<void>;
+    registerBlockProposalHandler(): void;
+    registerBlockBuilder(blockBuilder: BlockBuilderCallback): void;
+    createBlockProposal(header: BlockHeader, archive: Fr, txs: TxHash[]): Promise<BlockProposal | undefined>;
+    attestToProposal(proposal: BlockProposal): void;
+    broadcastBlockProposal(proposal: BlockProposal): void;
+    collectAttestations(proposal: BlockProposal, required: number, deadline: Date): Promise<BlockAttestation[]>;
+}
+/**
+ * Validator Client
+ */
+export declare class ValidatorClient extends WithTracer implements Validator {
+    private keyStore;
+    private epochCache;
+    private p2pClient;
+    private config;
+    private dateProvider;
+    private log;
+    private validationService;
+    private metrics;
+    private previousProposal?;
+    private blockBuilder?;
+    private epochCacheUpdateLoop;
+    private blockProposalValidator;
+    constructor(keyStore: ValidatorKeyStore, epochCache: EpochCache, p2pClient: P2P, config: ValidatorClientConfig, dateProvider?: DateProvider, telemetry?: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
+    static new(config: ValidatorClientConfig, epochCache: EpochCache, p2pClient: P2P, dateProvider?: DateProvider, telemetry?: TelemetryClient): ValidatorClient;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    registerBlockProposalHandler(): void;
+    /**
+     * Register a callback function for building a block
+     *
+     * We reuse the sequencer's block building functionality for re-execution
+     */
+    registerBlockBuilder(blockBuilder: BlockBuilderCallback): void;
+    attestToProposal(proposal: BlockProposal): Promise<BlockAttestation | undefined>;
+    /**
+     * Re-execute the transactions in the proposal and check that the state updates match the header state
+     * @param proposal - The proposal to re-execute
+     */
+    reExecuteTransactions(proposal: BlockProposal): Promise<void>;
+    /**
+     * Ensure that all of the transactions in the proposal are available in the tx pool before attesting
+     *
+     * 1. Check if the local tx pool contains all of the transactions in the proposal
+     * 2. If any transactions are not in the local tx pool, request them from the network
+     * 3. If we cannot retrieve them from the network, throw an error
+     * @param proposal - The proposal to attest to
+     */
+    ensureTransactionsAreAvailable(proposal: BlockProposal): Promise<void>;
+    createBlockProposal(header: BlockHeader, archive: Fr, txs: TxHash[]): Promise<BlockProposal | undefined>;
+    broadcastBlockProposal(proposal: BlockProposal): void;
+    collectAttestations(proposal: BlockProposal, required: number, deadline: Date): Promise<BlockAttestation[]>;
+}
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dest/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"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"}