@aztec/blob-client 0.0.1-commit.e558bd1c → 0.0.1-commit.e5a3663dd

package/src/client/interface.ts

@@ -6,11 +6,20 @@ import type { Blob } from '@aztec/blob-lib';
 export interface GetBlobSidecarOptions {
   /**
    * True if the archiver is catching up (historical sync), false if near tip.
-   * This affects source ordering:
-   * - Historical: FileStore first (data should exist), then L1 consensus, then archive (eg. blobscan)
-   * - Near tip: FileStore first with no retries (data should exist), L1 consensus second (freshest data), then FileStore with retries, then archive (eg. blobscan)
+   * Historical sync uses a shorter retry backoff since blobs should already exist.
    */
   isHistoricalSync?: boolean;
+  /**
+   * The parent beacon block root for the L1 block containing the blobs.
+   * If provided, skips the eth_getBlockByHash execution RPC call inside getSlotNumber.
+   */
+  parentBeaconBlockRoot?: string;
+  /**
+   * The timestamp of the L1 execution block containing the blobs.
+   * When provided alongside a cached beacon genesis config (fetched at startup), allows computing
+   * the beacon slot directly via timestamp math, skipping the beacon headers network call entirely.
+   */
+  l1BlockTimestamp?: bigint;
 }
 
 export interface BlobClientInterface {

package/src/client/tests.ts

@@ -28,7 +28,7 @@ export function runBlobClientTests(
   });
 
   it('should send and retrieve blobs by hash', async () => {
-    const blob = makeRandomBlob(5);
+    const blob = await makeRandomBlob(5);
     const blobHash = blob.getEthVersionedBlobHash();
 
     await client.sendBlobsToFilestore([blob]);
@@ -39,7 +39,7 @@ export function runBlobClientTests(
   });
 
   it('should handle multiple blobs', async () => {
-    const blobs = Array.from({ length: 3 }, () => makeRandomBlob(7));
+    const blobs = await Promise.all(Array.from({ length: 3 }, () => makeRandomBlob(7)));
     const blobHashes = blobs.map(blob => blob.getEthVersionedBlobHash());
 
     await client.sendBlobsToFilestore(blobs);

package/src/filestore/factory.ts

@@ -1,6 +1,7 @@
 import { type Logger, createLogger } from '@aztec/foundation/log';
 import {
   type FileStore,
+  type HttpFileStoreOptions,
   type ReadOnlyFileStore,
   createFileStore,
   createReadOnlyFileStore,
@@ -44,16 +45,19 @@ export async function createReadOnlyFileStoreBlobClient(
   storeUrl: string,
   metadata: BlobFileStoreMetadata,
   logger?: Logger,
+  httpOptions?: HttpFileStoreOptions,
 ): Promise<FileStoreBlobClient>;
 export async function createReadOnlyFileStoreBlobClient(
   storeUrl: string | undefined,
   metadata: BlobFileStoreMetadata,
   logger?: Logger,
+  httpOptions?: HttpFileStoreOptions,
 ): Promise<FileStoreBlobClient | undefined>;
 export async function createReadOnlyFileStoreBlobClient(
   storeUrl: string | undefined,
   metadata: BlobFileStoreMetadata,
   logger?: Logger,
+  httpOptions?: HttpFileStoreOptions,
 ): Promise<FileStoreBlobClient | undefined> {
   if (!storeUrl) {
     return undefined;
@@ -64,7 +68,7 @@ export async function createReadOnlyFileStoreBlobClient(
 
   log.debug(`Creating read-only filestore blob client`, { storeUrl, basePath });
 
-  const store: ReadOnlyFileStore = await createReadOnlyFileStore(storeUrl, log);
+  const store: ReadOnlyFileStore = await createReadOnlyFileStore(storeUrl, log, httpOptions);
   return new FileStoreBlobClient(store, basePath, log);
 }
 
@@ -80,6 +84,7 @@ export async function createReadOnlyFileStoreBlobClients(
   storeUrls: string[] | undefined,
   metadata: BlobFileStoreMetadata,
   logger?: Logger,
+  httpOptions?: HttpFileStoreOptions,
 ): Promise<FileStoreBlobClient[]> {
   if (!storeUrls || storeUrls.length === 0) {
     return [];
@@ -90,7 +95,7 @@ export async function createReadOnlyFileStoreBlobClients(
 
   for (const storeUrl of storeUrls) {
     try {
-      const client = await createReadOnlyFileStoreBlobClient(storeUrl, metadata, log);
+      const client = await createReadOnlyFileStoreBlobClient(storeUrl, metadata, log, httpOptions);
       if (client) {
         clients.push(client);
       }