@aztec/epoch-cache 0.77.0-testnet-ignition.28 → 0.77.0-testnet-ignition.29

package/dest/config.d.ts

@@ -0,0 +1,4 @@
+import { type L1ContractsConfig, type L1ReaderConfig } from '@aztec/ethereum';
+export type EpochCacheConfig = Pick<L1ReaderConfig & L1ContractsConfig, 'l1RpcUrls' | 'l1ChainId' | 'viemPollingIntervalMS' | 'aztecSlotDuration' | 'ethereumSlotDuration' | 'aztecEpochDuration'>;
+export declare function getEpochCacheConfigEnvVars(): EpochCacheConfig;
+//# 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":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EAGpB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,cAAc,GAAG,iBAAiB,EAChC,WAAW,GACX,WAAW,GACX,uBAAuB,GACvB,mBAAmB,GACnB,sBAAsB,GACtB,oBAAoB,CACvB,CAAC;AAEF,wBAAgB,0BAA0B,IAAI,gBAAgB,CAE7D"}

package/dest/epoch_cache.d.ts

@@ -0,0 +1,87 @@
+/// <reference types="node" resolution-mode="require"/>
+import { RollupContract } from '@aztec/ethereum';
+import { EthAddress } from '@aztec/foundation/eth-address';
+import { DateProvider } from '@aztec/foundation/timer';
+import { type L1RollupConstants } from '@aztec/stdlib/epoch-helpers';
+import { EventEmitter } from 'node:events';
+import { type EpochCacheConfig } from './config.js';
+type EpochAndSlot = {
+    epoch: bigint;
+    slot: bigint;
+    ts: bigint;
+};
+export interface EpochCacheInterface {
+    getCommittee(nextSlot: boolean): Promise<EthAddress[]>;
+    getEpochAndSlotNow(): EpochAndSlot;
+    getProposerIndexEncoding(epoch: bigint, slot: bigint, seed: bigint): `0x${string}`;
+    computeProposerIndex(slot: bigint, epoch: bigint, seed: bigint, size: bigint): bigint;
+    getProposerInCurrentOrNextSlot(): Promise<{
+        currentProposer: EthAddress;
+        nextProposer: EthAddress;
+        currentSlot: bigint;
+        nextSlot: bigint;
+    }>;
+    isInCommittee(validator: EthAddress): Promise<boolean>;
+}
+/**
+ * Epoch cache
+ *
+ * This class is responsible for managing traffic to the l1 node, by caching the validator set.
+ * It also provides a method to get the current or next proposer, and to check who is in the current slot.
+ *
+ * If the epoch changes, then we update the stored validator set.
+ *
+ * Note: This class is very dependent on the system clock being in sync.
+ */
+export declare class EpochCache extends EventEmitter<{
+    committeeChanged: [EthAddress[], bigint];
+}> implements EpochCacheInterface {
+    private rollup;
+    private readonly l1constants;
+    private readonly dateProvider;
+    private committee;
+    private cachedEpoch;
+    private cachedSampleSeed;
+    private readonly log;
+    constructor(rollup: RollupContract, initialValidators?: EthAddress[], initialSampleSeed?: bigint, l1constants?: L1RollupConstants, dateProvider?: DateProvider);
+    static create(rollupAddress: EthAddress, config?: EpochCacheConfig, deps?: {
+        dateProvider?: DateProvider;
+    }): Promise<EpochCache>;
+    private nowInSeconds;
+    getEpochAndSlotNow(): EpochAndSlot;
+    private getEpochAndSlotInNextSlot;
+    private getEpochAndSlotAtTimestamp;
+    /**
+     * Get the current validator set
+     *
+     * @param nextSlot - If true, get the validator set for the next slot.
+     * @returns The current validator set.
+     */
+    getCommittee(nextSlot?: boolean): Promise<EthAddress[]>;
+    /**
+     * Get the ABI encoding of the proposer index - see ValidatorSelectionLib.sol computeProposerIndex
+     */
+    getProposerIndexEncoding(epoch: bigint, slot: bigint, seed: bigint): `0x${string}`;
+    computeProposerIndex(slot: bigint, epoch: bigint, seed: bigint, size: bigint): bigint;
+    /**
+     * Returns the current and next proposer
+     *
+     * We return the next proposer as the node will check if it is the proposer at the next ethereum block, which
+     * can be the next slot. If this is the case, then it will send proposals early.
+     *
+     * If we are at an epoch boundary, then we can update the cache for the next epoch, this is the last check
+     * we do in the validator client, so we can update the cache here.
+     */
+    getProposerInCurrentOrNextSlot(): Promise<{
+        currentProposer: EthAddress;
+        nextProposer: EthAddress;
+        currentSlot: bigint;
+        nextSlot: bigint;
+    }>;
+    /**
+     * Check if a validator is in the current epoch's committee
+     */
+    isInCommittee(validator: EthAddress): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=epoch_cache.d.ts.map

package/dest/epoch_cache.d.ts.map

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

package/dest/index.d.ts

@@ -0,0 +1,3 @@
+export * from './epoch_cache.js';
+export * from './config.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,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dest/timestamp_provider.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timestamp_provider.d.ts.map

package/dest/timestamp_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp_provider.d.ts","sourceRoot":"","sources":["../src/timestamp_provider.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/epoch-cache",
-  "version": "0.77.0-testnet-ignition.28",
+  "version": "0.77.0-testnet-ignition.29",
   "type": "module",
   "exports": {
     ".": "./dest/index.js",
@@ -28,10 +28,10 @@
     "../package.common.json"
   ],
   "dependencies": {
-    "@aztec/ethereum": "0.77.0-testnet-ignition.28",
-    "@aztec/foundation": "0.77.0-testnet-ignition.28",
-    "@aztec/l1-artifacts": "0.77.0-testnet-ignition.28",
-    "@aztec/stdlib": "0.77.0-testnet-ignition.28",
+    "@aztec/ethereum": "0.77.0-testnet-ignition.29",
+    "@aztec/foundation": "0.77.0-testnet-ignition.29",
+    "@aztec/l1-artifacts": "0.77.0-testnet-ignition.29",
+    "@aztec/stdlib": "0.77.0-testnet-ignition.29",
     "@viem/anvil": "^0.0.10",
     "dotenv": "^16.0.3",
     "get-port": "^7.1.0",