@aztec-labs/stdlib 6.0.0-nightly.20260829

package/dest/interfaces/aztec-node-admin.d.ts

@@ -0,0 +1,211 @@
+import type { L1ContractAddresses } from '@aztec-labs/ethereum/l1-contract-addresses';
+import { defaultFetch } from '@aztec-labs/foundation/json-rpc/client';
+import { z } from 'zod';
+import type { ApiSchemaFor } from '../schemas/schemas.js';
+import { type Offense } from '../slashing/index.js';
+import { type ComponentsVersions } from '../versioning/index.js';
+import { type ArchiverSpecificConfig } from './archiver.js';
+import { type SequencerConfig } from './configs.js';
+import { type ProverConfig } from './prover-client.js';
+import { type SlasherConfig } from './slasher.js';
+import { type ValidatorClientFullConfig } from './validator.js';
+/**
+ * Aztec node admin API.
+ */
+export interface AztecNodeAdmin {
+    /**
+     * Retrieves the configuration of this node.
+     */
+    getConfig(): Promise<AztecNodeAdminConfig>;
+    /**
+     * Updates the configuration of this node.
+     * @param config - Updated configuration to be merged with the current one.
+     */
+    setConfig(config: Partial<AztecNodeAdminConfig>): Promise<void>;
+    /**
+     * Pauses syncing, creates a backup of archiver and world-state databases, and uploads them. Returns immediately.
+     * @param location - The location to upload the snapshot to.
+     */
+    startSnapshotUpload(location: string): Promise<void>;
+    /**
+     * Pauses syncing and rolls back the database to the target L2 block number.
+     * @param targetBlockNumber - The block number to roll back to.
+     * @param force - If true, clears the world state db and p2p dbs if rolling back to behind the finalized block.
+     * @param resumeSync - If true (default), resumes archiver and world state sync after rollback.
+     */
+    rollbackTo(targetBlockNumber: number, force?: boolean, resumeSync?: boolean): Promise<void>;
+    /** Pauses archiver and world state syncing. */
+    pauseSync(): Promise<void>;
+    /** Resumes archiver and world state syncing. */
+    resumeSync(): Promise<void>;
+    /**
+     * Pauses block production. Pending txs remain in the mempool; no new blocks will be
+     * produced until {@link resumeSequencer} is called. Throws if no sequencer is running.
+     */
+    pauseSequencer(): Promise<void>;
+    /** Resumes block production previously paused via {@link pauseSequencer}. */
+    resumeSequencer(): Promise<void>;
+    /** Returns all offenses applicable for the given round. */
+    getSlashOffenses(round: bigint | 'all' | 'current'): Promise<Offense[]>;
+    /**
+     * Reloads keystore configuration from disk.
+     *
+     * What is updated:
+     * - Validator attester keys
+     * - Coinbase address per validator
+     * - Fee recipient address per validator
+     *
+     * What is NOT updated (requires node restart):
+     * - L1 publisher signers (the funded accounts that send L1 transactions)
+     * - Prover keys
+     * - HA signer PostgreSQL connections
+     *
+     * Notes:
+     * - New validators must use a publisher key that was already configured at node
+     *   startup (or omit the publisher field to fall back to the attester key).
+     *   A validator with an unknown publisher key will cause the reload to be rejected.
+     */
+    reloadKeystore(): Promise<void>;
+}
+export type AztecNodeAdminConfig = Omit<ValidatorClientFullConfig, keyof L1ContractAddresses> & SequencerConfig & ProverConfig & SlasherConfig & Pick<ArchiverSpecificConfig, 'archiverPollingIntervalMS' | 'archiverBatchSize' | 'skipValidateCheckpointAttestations'> & {
+    maxPendingTxCount: number;
+    skipIncomingProposals?: boolean;
+};
+export declare const AztecNodeAdminConfigSchema: z.ZodObject<{
+    nodeId: z.ZodString;
+    pollingIntervalMs: z.ZodNumber;
+    peerSigningTimeoutMs: z.ZodNumber;
+    signerCallTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    maxStuckDutiesAgeMs: z.ZodOptional<z.ZodNumber>;
+    cleanupOldDutiesAfterHours: z.ZodOptional<z.ZodNumber>;
+    haSigningEnabled: z.ZodBoolean;
+    databaseUrl: z.ZodOptional<z.ZodType<import("@aztec-labs/foundation/config").SecretValue<string>, any, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/config").SecretValue<string>, any>>>;
+    poolMaxCount: z.ZodOptional<z.ZodNumber>;
+    poolMinCount: z.ZodOptional<z.ZodNumber>;
+    poolIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    poolConnectionTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    dataDirectory: z.ZodOptional<z.ZodString>;
+    dataStoreMapSizeKb: z.ZodNumber;
+    signingProtectionMapSizeKb: z.ZodOptional<z.ZodNumber>;
+    allowEphemeralSigningProtection: z.ZodOptional<z.ZodBoolean>;
+    sequencerPollingIntervalMS: z.ZodOptional<z.ZodNumber>;
+    maxTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    maxTxsPerCheckpoint: z.ZodOptional<z.ZodNumber>;
+    minValidTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    minTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    maxL2BlockGas: z.ZodOptional<z.ZodNumber>;
+    publishTxsWithProposals: z.ZodOptional<z.ZodBoolean>;
+    maxDABlockGas: z.ZodOptional<z.ZodNumber>;
+    perBlockAllocationMultiplier: z.ZodOptional<z.ZodNumber>;
+    perBlockDAAllocationMultiplier: z.ZodOptional<z.ZodNumber>;
+    redistributeCheckpointBudget: z.ZodOptional<z.ZodBoolean>;
+    coinbase: z.ZodOptional<import("../schemas/schemas.js").ZodFor<import("@aztec-labs/foundation/eth-address").EthAddress>>;
+    feeRecipient: z.ZodOptional<import("../schemas/schemas.js").ZodFor<import("../aztec-address/index.js").AztecAddress>>;
+    acvmWorkingDirectory: z.ZodOptional<z.ZodString>;
+    acvmBinaryPath: z.ZodOptional<z.ZodString>;
+    governanceProposerPayload: z.ZodOptional<import("../schemas/schemas.js").ZodFor<import("@aztec-labs/foundation/eth-address").EthAddress>>;
+    governanceProposerForcePayloadVote: z.ZodOptional<z.ZodBoolean>;
+    minBlockDuration: z.ZodOptional<z.ZodNumber>;
+    checkpointProposalPrepareTime: z.ZodOptional<z.ZodNumber>;
+    l1PublishingTime: z.ZodOptional<z.ZodNumber>;
+    fakeProcessingDelayPerTxMs: z.ZodOptional<z.ZodNumber>;
+    fakeThrowAfterProcessingTxCount: z.ZodOptional<z.ZodNumber>;
+    attestationPropagationTime: z.ZodOptional<z.ZodNumber>;
+    skipCollectingAttestations: z.ZodOptional<z.ZodBoolean>;
+    skipInvalidateBlockAsProposer: z.ZodOptional<z.ZodBoolean>;
+    skipWaitForValidParentCheckpointOnL1: z.ZodOptional<z.ZodBoolean>;
+    secondsBeforeInvalidatingBlockAsCommitteeMember: z.ZodNumber;
+    secondsBeforeInvalidatingBlockAsNonCommitteeMember: z.ZodNumber;
+    invalidBlockProposalIndexWithinCheckpoint: z.ZodOptional<z.ZodNumber>;
+    broadcastInvalidCheckpointProposalOnly: z.ZodOptional<z.ZodBoolean>;
+    injectFakeAttestation: z.ZodOptional<z.ZodBoolean>;
+    injectHighSValueAttestation: z.ZodOptional<z.ZodBoolean>;
+    injectUnrecoverableSignatureAttestation: z.ZodOptional<z.ZodBoolean>;
+    injectYParityAttestation: z.ZodOptional<z.ZodBoolean>;
+    shuffleAttestationOrdering: z.ZodOptional<z.ZodBoolean>;
+    checkpointProposalSyncGraceSeconds: z.ZodOptional<z.ZodNumber>;
+    expectedBlockProposalsPerSlot: z.ZodOptional<z.ZodNumber>;
+    buildCheckpointIfEmpty: z.ZodOptional<z.ZodBoolean>;
+    minBlocksForCheckpoint: z.ZodOptional<z.ZodNumber>;
+    skipPublishingCheckpointsPercent: z.ZodOptional<z.ZodNumber>;
+    skipBroadcastProposals: z.ZodOptional<z.ZodBoolean>;
+    skipBroadcastCheckpointProposal: z.ZodOptional<z.ZodBoolean>;
+    pauseProposingForSlots: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodBigInt, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>, z.ZodTransform<import("@aztec-labs/foundation/schemas").SlotNumber, number>>>>;
+    minPeersToPropose: z.ZodOptional<z.ZodNumber>;
+    archiverPollingIntervalMS: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>>;
+    archiverBatchSize: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedNumber<string | number | bigint>>>;
+    skipValidateCheckpointAttestations: z.ZodOptional<z.ZodBoolean>;
+    slashOverridePayload: z.ZodOptional<z.ZodType<import("@aztec-labs/foundation/eth-address").EthAddress, string, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/eth-address").EthAddress, string>>>;
+    slashValidatorsAlways: z.ZodArray<z.ZodType<import("@aztec-labs/foundation/eth-address").EthAddress, string, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/eth-address").EthAddress, string>>>;
+    slashValidatorsNever: z.ZodArray<z.ZodType<import("@aztec-labs/foundation/eth-address").EthAddress, string, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/eth-address").EthAddress, string>>>;
+    slashDataWithholdingPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashDataWithholdingToleranceSlots: z.ZodDefault<z.ZodNumber>;
+    slashInactivityTargetPercentage: z.ZodNumber;
+    slashInactivityConsecutiveEpochThreshold: z.ZodNumber;
+    slashInactivityPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashProposeInvalidAttestationsPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashProposeDescendantOfCheckpointWithInvalidAttestationsPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashUnknownPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashOffenseExpirationRounds: z.ZodNumber;
+    slashMaxPayloadSize: z.ZodNumber;
+    slashGracePeriodL2Slots: z.ZodNumber;
+    slashExecuteRoundsLookBack: z.ZodNumber;
+    slashSelfAllowed: z.ZodOptional<z.ZodBoolean>;
+    nodeUrl: z.ZodOptional<z.ZodString>;
+    realProofs: z.ZodBoolean;
+    proverId: z.ZodOptional<import("../schemas/schemas.js").ZodFor<import("@aztec-labs/foundation/eth-address").EthAddress>>;
+    proverTestDelayType: z.ZodEnum<{
+        fixed: "fixed";
+        realistic: "realistic";
+    }>;
+    proverTestDelayMs: z.ZodNumber;
+    proverTestDelayFactor: z.ZodNumber;
+    proverAgentCount: z.ZodNumber;
+    proofStore: z.ZodOptional<z.ZodString>;
+    failedProofStore: z.ZodOptional<z.ZodString>;
+    cancelJobsOnStop: z.ZodBoolean;
+    enqueueConcurrency: z.ZodNumber;
+    l1ChainId: z.ZodNumber;
+    validatorAddresses: z.ZodOptional<z.ZodArray<z.ZodType<import("@aztec-labs/foundation/eth-address").EthAddress, string, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/eth-address").EthAddress, string>>>>;
+    disableValidator: z.ZodBoolean;
+    disabledValidators: z.ZodArray<z.ZodType<import("@aztec-labs/foundation/eth-address").EthAddress, string, z.core.$ZodTypeInternals<import("@aztec-labs/foundation/eth-address").EthAddress, string>>>;
+    attestationPollingIntervalMs: z.ZodNumber;
+    alwaysReexecuteBlockProposals: z.ZodOptional<z.ZodBoolean>;
+    fishermanMode: z.ZodOptional<z.ZodBoolean>;
+    skipCheckpointProposalValidation: z.ZodOptional<z.ZodBoolean>;
+    skipPushProposedBlocksToArchiver: z.ZodOptional<z.ZodBoolean>;
+    attestToEquivocatedProposals: z.ZodOptional<z.ZodBoolean>;
+    skipProposalSlotValidation: z.ZodOptional<z.ZodBoolean>;
+    validateMaxL2BlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxDABlockGas: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerBlock: z.ZodOptional<z.ZodNumber>;
+    validateMaxTxsPerCheckpoint: z.ZodOptional<z.ZodNumber>;
+    txPublicSetupAllowListExtend: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        address: import("../schemas/schemas.js").ZodFor<import("../aztec-address/index.js").AztecAddress>;
+        selector: import("../schemas/schemas.js").ZodFor<import("../abi/function_selector.js").FunctionSelector>;
+        onlySelf: z.ZodOptional<z.ZodBoolean>;
+        rejectNullMsgSender: z.ZodOptional<z.ZodBoolean>;
+        calldataLength: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        classId: import("../schemas/schemas.js").ZodFor<import("@aztec-labs/foundation/schemas").Fr>;
+        selector: import("../schemas/schemas.js").ZodFor<import("../abi/function_selector.js").FunctionSelector>;
+        onlySelf: z.ZodOptional<z.ZodBoolean>;
+        rejectNullMsgSender: z.ZodOptional<z.ZodBoolean>;
+        calldataLength: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>;
+    broadcastInvalidBlockProposal: z.ZodOptional<z.ZodBoolean>;
+    blockDurationMs: z.ZodNumber;
+    maxBlocksPerCheckpoint: z.ZodOptional<z.ZodNumber>;
+    slashBroadcastedInvalidBlockPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashBroadcastedInvalidCheckpointProposalPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashDuplicateProposalPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashDuplicateAttestationPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    slashAttestInvalidCheckpointProposalPenalty: z.ZodPipe<z.ZodUnion<readonly [z.ZodBigInt, z.ZodNumber, z.ZodString]>, z.ZodCoercedBigInt<string | number | bigint>>;
+    disableTransactions: z.ZodOptional<z.ZodBoolean>;
+    maxGossipClockDisparityMs: z.ZodOptional<z.ZodNumber>;
+    maxPendingTxCount: z.ZodNumber;
+    skipIncomingProposals: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const AztecNodeAdminApiSchema: ApiSchemaFor<AztecNodeAdmin>;
+export declare function createAztecNodeAdminClient(url: string, versions?: Partial<ComponentsVersions>, fetch?: typeof defaultFetch, apiKey?: string): AztecNodeAdmin;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWMtbm9kZS1hZG1pbi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYXp0ZWMtbm9kZS1hZG1pbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDRDQUE0QyxDQUFDO0FBQ3RGLE9BQU8sRUFBMkIsWUFBWSxFQUFFLE1BQU0sd0NBQXdDLENBQUM7QUFDL0YsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUUxRCxPQUFPLEVBQUUsS0FBSyxPQUFPLEVBQWlCLE1BQU0sc0JBQXNCLENBQUM7QUFDbkUsT0FBTyxFQUFFLEtBQUssa0JBQWtCLEVBQWdDLE1BQU0sd0JBQXdCLENBQUM7QUFDL0YsT0FBTyxFQUFFLEtBQUssc0JBQXNCLEVBQWdDLE1BQU0sZUFBZSxDQUFDO0FBQzFGLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBeUIsTUFBTSxjQUFjLENBQUM7QUFDM0UsT0FBTyxFQUFFLEtBQUssWUFBWSxFQUFzQixNQUFNLG9CQUFvQixDQUFDO0FBQzNFLE9BQU8sRUFBRSxLQUFLLGFBQWEsRUFBdUIsTUFBTSxjQUFjLENBQUM7QUFDdkUsT0FBTyxFQUFFLEtBQUsseUJBQXlCLEVBQW1DLE1BQU0sZ0JBQWdCLENBQUM7QUFFakc7O0dBRUc7QUFDSCxNQUFNLFdBQVcsY0FBYztJQUM3Qjs7T0FFRztJQUNILFNBQVMsSUFBSSxPQUFPLENBQUMsb0JBQW9CLENBQUMsQ0FBQztJQUUzQzs7O09BR0c7SUFDSCxTQUFTLENBQUMsTUFBTSxFQUFFLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVoRTs7O09BR0c7SUFDSCxtQkFBbUIsQ0FBQyxRQUFRLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVyRDs7Ozs7T0FLRztJQUNILFVBQVUsQ0FBQyxpQkFBaUIsRUFBRSxNQUFNLEVBQUUsS0FBSyxDQUFDLEVBQUUsT0FBTyxFQUFFLFVBQVUsQ0FBQyxFQUFFLE9BQU8sR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFNUYsK0NBQStDO0lBQy9DLFNBQVMsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFM0IsZ0RBQWdEO0lBQ2hELFVBQVUsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7SUFFNUI7OztPQUdHO0lBQ0gsY0FBYyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVoQyw2RUFBNkU7SUFDN0UsZUFBZSxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVqQywyREFBMkQ7SUFDM0QsZ0JBQWdCLENBQUMsS0FBSyxFQUFFLE1BQU0sR0FBRyxLQUFLLEdBQUcsU0FBUyxHQUFHLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDO0lBRXhFOzs7Ozs7Ozs7Ozs7Ozs7OztPQWlCRztJQUNILGNBQWMsSUFBSSxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDakM7QUFHRCxNQUFNLE1BQU0sb0JBQW9CLEdBQUcsSUFBSSxDQUFDLHlCQUF5QixFQUFFLE1BQU0sbUJBQW1CLENBQUMsR0FDM0YsZUFBZSxHQUNmLFlBQVksR0FDWixhQUFhLEdBQ2IsSUFBSSxDQUNGLHNCQUFzQixFQUN0QiwyQkFBMkIsR0FBRyxtQkFBbUIsR0FBRyxvQ0FBb0MsQ0FDekYsR0FBRztJQUNGLGlCQUFpQixFQUFFLE1BQU0sQ0FBQztJQUUxQixxQkFBcUIsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUNqQyxDQUFDO0FBRUosZUFBTyxNQUFNLDBCQUEwQjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7aUJBVTZELENBQUM7QUFFckcsZUFBTyxNQUFNLHVCQUF1QixFQUFFLFlBQVksQ0FBQyxjQUFjLENBaUJoRSxDQUFDO0FBRUYsd0JBQWdCLDBCQUEwQixDQUN4QyxHQUFHLEVBQUUsTUFBTSxFQUNYLFFBQVEsR0FBRSxPQUFPLENBQUMsa0JBQWtCLENBQU0sRUFDMUMsS0FBSyxzQkFBZSxFQUNwQixNQUFNLENBQUMsRUFBRSxNQUFNLEdBQ2QsY0FBYyxDQU9oQiJ9

package/dest/interfaces/aztec-node-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aztec-node-admin.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAA2B,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC/F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,KAAK,sBAAsB,EAAgC,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,KAAK,eAAe,EAAyB,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,KAAK,aAAa,EAAuB,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,KAAK,yBAAyB,EAAmC,MAAM,gBAAgB,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE3C;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,UAAU,CAAC,iBAAiB,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5F,+CAA+C;IAC/C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B,gDAAgD;IAChD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,6EAA6E;IAC7E,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC,2DAA2D;IAC3D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAExE;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAGD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,yBAAyB,EAAE,MAAM,mBAAmB,CAAC,GAC3F,eAAe,GACf,YAAY,GACZ,aAAa,GACb,IAAI,CACF,sBAAsB,EACtB,2BAA2B,GAAG,mBAAmB,GAAG,oCAAoC,CACzF,GAAG;IACF,iBAAiB,EAAE,MAAM,CAAC;IAE1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEJ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU6D,CAAC;AAErG,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAiBhE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAOhB"}

package/dest/interfaces/aztec-node-admin.js

@@ -0,0 +1,88 @@
+import { createSafeJsonRpcClient, defaultFetch } from '@aztec-labs/foundation/json-rpc/client';
+import { z } from 'zod';
+import { optional } from '../schemas/schemas.js';
+import { OffenseSchema } from '../slashing/index.js';
+import { getVersioningResponseHandler } from '../versioning/index.js';
+import { ArchiverSpecificConfigSchema } from './archiver.js';
+import { SequencerConfigSchema } from './configs.js';
+import { ProverConfigSchema } from './prover-client.js';
+import { SlasherConfigSchema } from './slasher.js';
+import { ValidatorClientFullConfigSchema } from './validator.js';
+export const AztecNodeAdminConfigSchema = SequencerConfigSchema.merge(ProverConfigSchema).merge(SlasherConfigSchema).merge(ValidatorClientFullConfigSchema.omit({
+    rollupAddress: true
+})).merge(ArchiverSpecificConfigSchema.pick({
+    archiverPollingIntervalMS: true,
+    archiverBatchSize: true,
+    skipValidateCheckpointAttestations: true
+})).merge(z.object({
+    maxPendingTxCount: z.number(),
+    skipIncomingProposals: z.boolean().optional()
+}));
+export const AztecNodeAdminApiSchema = {
+    getConfig: z.function({
+        input: z.tuple([]),
+        output: AztecNodeAdminConfigSchema
+    }),
+    setConfig: z.function({
+        input: z.tuple([
+            AztecNodeAdminConfigSchema.partial()
+        ]),
+        output: z.void()
+    }),
+    startSnapshotUpload: z.function({
+        input: z.tuple([
+            z.string()
+        ]),
+        output: z.void()
+    }),
+    rollbackTo: z.function({
+        input: z.tuple([
+            z.number(),
+            optional(z.boolean()),
+            optional(z.boolean())
+        ]),
+        output: z.void()
+    }),
+    pauseSync: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    resumeSync: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    pauseSequencer: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    resumeSequencer: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    getSlashOffenses: z.function({
+        input: z.tuple([
+            z.union([
+                z.bigint(),
+                z.literal('all'),
+                z.literal('current')
+            ])
+        ]),
+        output: z.array(OffenseSchema)
+    }),
+    reloadKeystore: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    })
+};
+export function createAztecNodeAdminClient(url, versions = {}, fetch = defaultFetch, apiKey) {
+    return createSafeJsonRpcClient(url, AztecNodeAdminApiSchema, {
+        namespaceMethods: 'aztecAdmin',
+        fetch,
+        onResponse: getVersioningResponseHandler(versions),
+        ...apiKey ? {
+            extraHeaders: {
+                'x-api-key': apiKey
+            }
+        } : {}
+    });
+}

package/dest/interfaces/aztec-node-debug.d.ts

@@ -0,0 +1,59 @@
+import { type CheckpointNumber } from '@aztec-labs/foundation/branded-types';
+import { defaultFetch } from '@aztec-labs/foundation/json-rpc/client';
+import { type ApiSchemaFor } from '../schemas/schemas.js';
+import { type ComponentsVersions } from '../versioning/index.js';
+/**
+ * Debug interface for Aztec node available in sandbox/local-network mode.
+ */
+export interface AztecNodeDebug {
+    /**
+     * Triggers the sequencer to produce an L2 block and waits for it to appear.
+     *
+     * **Precondition**: The current L2 slot must not already contain a block. Callers must ensure L1 time has been
+     * advanced to a slot with no existing block before calling this method (e.g. via `EthCheatCodes.warp()`).
+     * If the slot is already taken, the sequencer will fail to propose and this call will time out.
+     *
+     * @throws If no sequencer is running.
+     */
+    mineBlock(): Promise<void>;
+    /**
+     * Synthetically proves the L2 chain up to the given checkpoint (default: the latest checkpointed
+     * checkpoint), writing epoch out hashes into the L1 Outbox so L2-to-L1 messages become consumable
+     * and advancing the rollup's proven tip. There is no real proof — this is the local-network
+     * equivalent of an epoch proof landing on L1. The target is clamped to the latest checkpointed
+     * checkpoint and the call no-ops when it is already proven.
+     *
+     * @param upToCheckpoint - Checkpoint to prove up to; defaults to the latest checkpointed checkpoint.
+     * @returns The proven checkpoint number after the call.
+     * @throws If no automine sequencer is running (only the automine sequencer supports synthetic proving).
+     */
+    prove(upToCheckpoint?: CheckpointNumber): Promise<CheckpointNumber>;
+    /**
+     * Warps L1 time forward to at least `targetTimestamp` and builds an empty L2 checkpoint at the next slot boundary,
+     * advancing the L2 timestamp to at least the target. The warp is serialized with block building, so it never
+     * interleaves with an in-flight build. A no-op when `targetTimestamp` is already at or behind the current L1 time.
+     *
+     * @param targetTimestamp - Target L1 timestamp, in seconds.
+     * @throws If no automine sequencer is running (only the automine sequencer supports time warps).
+     */
+    warpL2TimeAtLeastTo(targetTimestamp: number): Promise<void>;
+    /**
+     * Warps L1 time forward by at least `duration` seconds from the current L1 time and builds an empty L2 checkpoint
+     * at the next slot boundary. The warp is serialized with block building, so it never interleaves with an in-flight
+     * build.
+     *
+     * @param duration - Number of seconds to advance; must be positive.
+     * @throws If no automine sequencer is running, or if `duration` is not positive.
+     */
+    warpL2TimeAtLeastBy(duration: number): Promise<void>;
+    /**
+     * Registers public function signatures so the node can resolve selectors to names in public-execution stack
+     * traces. The mapping lives only in unpersisted node memory, is not gossiped, and is exposed here (rather than on
+     * the main node API) because it is a debug-only, unauthenticated write that should not be reachable on prod nodes.
+     * @param functionSignatures - Decoded `name(paramTypes)` signatures to register by selector.
+     */
+    registerContractFunctionSignatures(functionSignatures: string[]): Promise<void>;
+}
+export declare const AztecNodeDebugApiSchema: ApiSchemaFor<AztecNodeDebug>;
+export declare function createAztecNodeDebugClient(url: string, versions?: Partial<ComponentsVersions>, fetch?: typeof defaultFetch, apiKey?: string): AztecNodeDebug;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWMtbm9kZS1kZWJ1Zy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2ludGVyZmFjZXMvYXp0ZWMtbm9kZS1kZWJ1Zy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsS0FBSyxnQkFBZ0IsRUFBMEIsTUFBTSxzQ0FBc0MsQ0FBQztBQUNyRyxPQUFPLEVBQTJCLFlBQVksRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBRy9GLE9BQU8sRUFBRSxLQUFLLFlBQVksRUFBWSxNQUFNLHVCQUF1QixDQUFDO0FBQ3BFLE9BQU8sRUFBRSxLQUFLLGtCQUFrQixFQUFnQyxNQUFNLHdCQUF3QixDQUFDO0FBSy9GOztHQUVHO0FBQ0gsTUFBTSxXQUFXLGNBQWM7SUFDN0I7Ozs7Ozs7O09BUUc7SUFDSCxTQUFTLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTNCOzs7Ozs7Ozs7O09BVUc7SUFDSCxLQUFLLENBQUMsY0FBYyxDQUFDLEVBQUUsZ0JBQWdCLEdBQUcsT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBQUM7SUFFcEU7Ozs7Ozs7T0FPRztJQUNILG1CQUFtQixDQUFDLGVBQWUsRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBRTVEOzs7Ozs7O09BT0c7SUFDSCxtQkFBbUIsQ0FBQyxRQUFRLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVyRDs7Ozs7T0FLRztJQUNILGtDQUFrQyxDQUFDLGtCQUFrQixFQUFFLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUNqRjtBQUVELGVBQU8sTUFBTSx1QkFBdUIsRUFBRSxZQUFZLENBQUMsY0FBYyxDQVNoRSxDQUFDO0FBRUYsd0JBQWdCLDBCQUEwQixDQUN4QyxHQUFHLEVBQUUsTUFBTSxFQUNYLFFBQVEsR0FBRSxPQUFPLENBQUMsa0JBQWtCLENBQU0sRUFDMUMsS0FBSyxzQkFBZSxFQUNwQixNQUFNLENBQUMsRUFBRSxNQUFNLEdBQ2QsY0FBYyxDQU9oQiJ9

package/dest/interfaces/aztec-node-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aztec-node-debug.d.ts","sourceRoot":"","sources":["../../src/interfaces/aztec-node-debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAA0B,MAAM,sCAAsC,CAAC;AACrG,OAAO,EAA2B,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAG/F,OAAO,EAAE,KAAK,YAAY,EAAY,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,KAAK,kBAAkB,EAAgC,MAAM,wBAAwB,CAAC;AAK/F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3B;;;;;;;;;;OAUG;IACH,KAAK,CAAC,cAAc,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEpE;;;;;;;OAOG;IACH,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,kCAAkC,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,eAAO,MAAM,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAShE,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,OAAO,CAAC,kBAAkB,CAAM,EAC1C,KAAK,sBAAe,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,cAAc,CAOhB"}

package/dest/interfaces/aztec-node-debug.js

@@ -0,0 +1,49 @@
+import { CheckpointNumberSchema } from '@aztec-labs/foundation/branded-types';
+import { createSafeJsonRpcClient, defaultFetch } from '@aztec-labs/foundation/json-rpc/client';
+import { z } from 'zod';
+import { optional } from '../schemas/schemas.js';
+import { getVersioningResponseHandler } from '../versioning/index.js';
+const MAX_SIGNATURES_PER_REGISTER_CALL = 100;
+const MAX_SIGNATURE_LEN = 10000;
+export const AztecNodeDebugApiSchema = {
+    mineBlock: z.function({
+        input: z.tuple([]),
+        output: z.void()
+    }),
+    prove: z.function({
+        input: z.tuple([
+            optional(CheckpointNumberSchema)
+        ]),
+        output: CheckpointNumberSchema
+    }),
+    warpL2TimeAtLeastTo: z.function({
+        input: z.tuple([
+            z.number()
+        ]),
+        output: z.void()
+    }),
+    warpL2TimeAtLeastBy: z.function({
+        input: z.tuple([
+            z.number()
+        ]),
+        output: z.void()
+    }),
+    registerContractFunctionSignatures: z.function({
+        input: z.tuple([
+            z.array(z.string().max(MAX_SIGNATURE_LEN)).max(MAX_SIGNATURES_PER_REGISTER_CALL)
+        ]),
+        output: z.void()
+    })
+};
+export function createAztecNodeDebugClient(url, versions = {}, fetch = defaultFetch, apiKey) {
+    return createSafeJsonRpcClient(url, AztecNodeDebugApiSchema, {
+        namespaceMethods: 'aztecDebug',
+        fetch,
+        onResponse: getVersioningResponseHandler(versions),
+        ...apiKey ? {
+            extraHeaders: {
+                'x-api-key': apiKey
+            }
+        } : {}
+    });
+}