@aztec/blob-client 3.0.0-nightly.20251223

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

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

package/dest/blobstore/index.js

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

package/dest/blobstore/interface.d.ts

@@ -0,0 +1,12 @@
+import type { BlobWithIndex } from '../types/index.js';
+export interface BlobStore {
+    /**
+     * Get blobs by their hashes
+     */
+    getBlobsByHashes: (blobHashes: Buffer[]) => Promise<BlobWithIndex[]>;
+    /**
+     * Add blobs to the store, indexed by their hashes
+     */
+    addBlobs: (blobs: BlobWithIndex[]) => Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYmxvYnN0b3JlL2ludGVyZmFjZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxhQUFhLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUV2RCxNQUFNLFdBQVcsU0FBUztJQUN4Qjs7T0FFRztJQUNILGdCQUFnQixFQUFFLENBQUMsVUFBVSxFQUFFLE1BQU0sRUFBRSxLQUFLLE9BQU8sQ0FBQyxhQUFhLEVBQUUsQ0FBQyxDQUFDO0lBQ3JFOztPQUVHO0lBQ0gsUUFBUSxFQUFFLENBQUMsS0FBSyxFQUFFLGFBQWEsRUFBRSxLQUFLLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUNyRCJ9

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

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/blobstore/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,gBAAgB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACrE;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD"}

package/dest/blobstore/interface.js

@@ -0,0 +1 @@
+export { };

package/dest/blobstore/memory_blob_store.d.ts

@@ -0,0 +1,8 @@
+import { BlobWithIndex } from '../types/index.js';
+import type { BlobStore } from './interface.js';
+export declare class MemoryBlobStore implements BlobStore {
+    private blobs;
+    getBlobsByHashes(blobHashes: Buffer[]): Promise<BlobWithIndex[]>;
+    addBlobs(blobs: BlobWithIndex[]): Promise<void>;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVtb3J5X2Jsb2Jfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ibG9ic3RvcmUvbWVtb3J5X2Jsb2Jfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2xELE9BQU8sS0FBSyxFQUFFLFNBQVMsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRWhELHFCQUFhLGVBQWdCLFlBQVcsU0FBUztJQUMvQyxPQUFPLENBQUMsS0FBSyxDQUFrQztJQUV4QyxnQkFBZ0IsQ0FBQyxVQUFVLEVBQUUsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLGFBQWEsRUFBRSxDQUFDLENBWXRFO0lBRU0sUUFBUSxDQUFDLEtBQUssRUFBRSxhQUFhLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBT3JEO0NBQ0YifQ==

package/dest/blobstore/memory_blob_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_blob_store.d.ts","sourceRoot":"","sources":["../../src/blobstore/memory_blob_store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,KAAK,CAAkC;IAExC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAYtE;IAEM,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAOrD;CACF"}

package/dest/blobstore/memory_blob_store.js

@@ -0,0 +1,24 @@
+import { bufferToHex } from '@aztec/foundation/string';
+import { BlobWithIndex } from '../types/index.js';
+export class MemoryBlobStore {
+    blobs = new Map();
+    getBlobsByHashes(blobHashes) {
+        const results = [];
+        for (const blobHash of blobHashes){
+            const key = bufferToHex(blobHash);
+            const blobBuffer = this.blobs.get(key);
+            if (blobBuffer) {
+                results.push(BlobWithIndex.fromBuffer(blobBuffer));
+            }
+        }
+        return Promise.resolve(results);
+    }
+    addBlobs(blobs) {
+        for (const blob of blobs){
+            const blobHash = blob.blob.getEthVersionedBlobHash();
+            const key = bufferToHex(blobHash);
+            this.blobs.set(key, blob.toBuffer());
+        }
+        return Promise.resolve();
+    }
+}

package/dest/client/bin/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jbGllbnQvYmluL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dest/client/bin/index.d.ts.map

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

package/dest/client/bin/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */ import { createLogger } from '@aztec/foundation/log';
+import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
+import { getBlobClientConfigFromEnv } from '../config.js';
+import { createBlobClient } from '../factory.js';
+async function main() {
+    const logger = createLogger('blob-client');
+    const blockHash = process.argv[2];
+    if (!blockHash) {
+        logger.error('Please provide a block hash as an argument.');
+        process.exit(1);
+    }
+    const blobHashes = process.argv.slice(3).map(hexToBuffer);
+    logger.info(`Fetching blobs for block hash ${blockHash}`);
+    if (blobHashes.length > 0) {
+        logger.info(`Filtering by blob hashes ${blobHashes.map(bufferToHex).join(', ')}`);
+    }
+    const blobClient = createBlobClient(getBlobClientConfigFromEnv());
+    const blobs = await blobClient.getBlobSidecar(blockHash, blobHashes);
+    logger.info(`Got ${blobs.length} blobs`);
+    for (const blob of blobs){
+        console.log(blob.toJSON());
+    }
+}
+// Example usage:
+// $ L1_CHAIN_ID=11155111 LOG_LEVEL=trace yarn blob-client 0x7d81980a40426c40544f0f729ada953be406730b877b5865d6cdc35cc8f9c84e 0x010657f37554c781402a22917dee2f75def7ab966d7b770905398eba3c444014
+main().catch((err)=>{
+    console.error(err);
+    process.exit(1);
+});

package/dest/client/config.d.ts

@@ -0,0 +1,50 @@
+import { type ConfigMappingsType, SecretValue } from '@aztec/foundation/config';
+import { type BlobArchiveApiConfig } from '../archive/config.js';
+/**
+ * The configuration for the blob client
+ */
+export interface BlobClientConfig extends BlobArchiveApiConfig {
+    /**
+     * List of URLs for L1 RPC Execution clients
+     */
+    l1RpcUrls?: string[];
+    /**
+     * List of URLs of the Ethereum consensus nodes that services will connect to (comma separated)
+     */
+    l1ConsensusHostUrls?: string[];
+    /**
+     * List of API keys for the corresponding L1 consensus client URLs. Added at the end of the URL as "?key=<api-key>" unless a header is defined
+     */
+    l1ConsensusHostApiKeys?: SecretValue<string>[];
+    /**
+     * List of header names for the corresponding L1 consensus client API keys, if needed. Added as "<api-key-header>: <api-key>"
+     */
+    l1ConsensusHostApiKeyHeaders?: string[];
+    /**
+     * The map size to be provided to LMDB for each blob sink DB, optional, will inherit from the general dataStoreMapSizeKb if not specified
+     */
+    blobSinkMapSizeKb?: number;
+    /**
+     * Whether to allow having no blob sources configured during startup
+     */
+    blobAllowEmptySources?: boolean;
+    /**
+     * URLs for reading blobs from filestore (s3://, gs://, file://, https://). Tried in order until blobs are found.
+     */
+    blobFileStoreUrls?: string[];
+    /**
+     * URL for uploading blobs to filestore (s3://, gs://, file://)
+     */
+    blobFileStoreUploadUrl?: string;
+}
+export declare const blobClientConfigMapping: ConfigMappingsType<BlobClientConfig>;
+/**
+ * Returns the blob client configuration from the environment variables.
+ * @returns The blob client configuration.
+ */
+export declare function getBlobClientConfigFromEnv(): BlobClientConfig;
+/**
+ * Returns whether the given blob client config has any remote sources defined.
+ */
+export declare function hasRemoteBlobSources(config?: BlobClientConfig): boolean;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uZmlnLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpZW50L2NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQ0wsS0FBSyxrQkFBa0IsRUFDdkIsV0FBVyxFQUdaLE1BQU0sMEJBQTBCLENBQUM7QUFFbEMsT0FBTyxFQUFFLEtBQUssb0JBQW9CLEVBQWdDLE1BQU0sc0JBQXNCLENBQUM7QUFFL0Y7O0dBRUc7QUFDSCxNQUFNLFdBQVcsZ0JBQWlCLFNBQVEsb0JBQW9CO0lBQzVEOztPQUVHO0lBQ0gsU0FBUyxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUM7SUFFckI7O09BRUc7SUFDSCxtQkFBbUIsQ0FBQyxFQUFFLE1BQU0sRUFBRSxDQUFDO0lBRS9COztPQUVHO0lBQ0gsc0JBQXNCLENBQUMsRUFBRSxXQUFXLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztJQUUvQzs7T0FFRztJQUNILDRCQUE0QixDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUM7SUFFeEM7O09BRUc7SUFDSCxpQkFBaUIsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUUzQjs7T0FFRztJQUNILHFCQUFxQixDQUFDLEVBQUUsT0FBTyxDQUFDO0lBRWhDOztPQUVHO0lBQ0gsaUJBQWlCLENBQUMsRUFBRSxNQUFNLEVBQUUsQ0FBQztJQUU3Qjs7T0FFRztJQUNILHNCQUFzQixDQUFDLEVBQUUsTUFBTSxDQUFDO0NBQ2pDO0FBRUQsZUFBTyxNQUFNLHVCQUF1QixFQUFFLGtCQUFrQixDQUFDLGdCQUFnQixDQStDeEUsQ0FBQztBQUVGOzs7R0FHRztBQUNILHdCQUFnQiwwQkFBMEIsSUFBSSxnQkFBZ0IsQ0FFN0Q7QUFFRDs7R0FFRztBQUNILHdCQUFnQixvQkFBb0IsQ0FBQyxNQUFNLEdBQUUsZ0JBQXFCLEdBQUcsT0FBTyxDQUUzRSJ9

package/dest/client/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,WAAW,EAGZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,KAAK,oBAAoB,EAAgC,MAAM,sBAAsB,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B;;OAEG;IACH,sBAAsB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IAE/C;;OAEG;IACH,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC;IAExC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE7B;;OAEG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,uBAAuB,EAAE,kBAAkB,CAAC,gBAAgB,CA+CxE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,gBAAgB,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,gBAAqB,GAAG,OAAO,CAE3E"}

package/dest/client/config.js

@@ -0,0 +1,55 @@
+import { SecretValue, booleanConfigHelper, getConfigFromMappings } from '@aztec/foundation/config';
+import { blobArchiveApiConfigMappings } from '../archive/config.js';
+export const blobClientConfigMapping = {
+    l1RpcUrls: {
+        env: 'ETHEREUM_HOSTS',
+        description: 'List of URLs for L1 RPC Execution clients',
+        parseEnv: (val)=>val.split(',').map((url)=>url.trim())
+    },
+    l1ConsensusHostUrls: {
+        env: 'L1_CONSENSUS_HOST_URLS',
+        description: 'List of URLs of the Ethereum consensus nodes that services will connect to (comma separated)',
+        parseEnv: (val)=>val.split(',').map((url)=>url.trim().replace(/\/$/, ''))
+    },
+    l1ConsensusHostApiKeys: {
+        env: 'L1_CONSENSUS_HOST_API_KEYS',
+        description: 'List of API keys for the corresponding L1 consensus clients, if needed. Added to the end of the corresponding URL as "?key=<api-key>" unless a header is defined',
+        parseEnv: (val)=>val.split(',').map((key)=>new SecretValue(key.trim()))
+    },
+    l1ConsensusHostApiKeyHeaders: {
+        env: 'L1_CONSENSUS_HOST_API_KEY_HEADERS',
+        description: 'List of header names for the corresponding L1 consensus client API keys, if needed. Added to the corresponding request as "<api-key-header>: <api-key>"',
+        parseEnv: (val)=>val.split(',').map((url)=>url.trim())
+    },
+    blobSinkMapSizeKb: {
+        env: 'BLOB_SINK_MAP_SIZE_KB',
+        description: 'The maximum possible size of the blob sink DB in KB. Overwrites the general dataStoreMapSizeKb.',
+        parseEnv: (val)=>val ? +val : undefined
+    },
+    blobAllowEmptySources: {
+        env: 'BLOB_ALLOW_EMPTY_SOURCES',
+        description: 'Whether to allow having no blob sources configured during startup',
+        ...booleanConfigHelper(false)
+    },
+    blobFileStoreUrls: {
+        env: 'BLOB_FILE_STORE_URLS',
+        description: 'URLs for filestore blob archive, comma-separated. Tried in order until blobs are found.',
+        parseEnv: (val)=>val.split(',').map((url)=>url.trim()).filter((url)=>url.length > 0)
+    },
+    blobFileStoreUploadUrl: {
+        env: 'BLOB_FILE_STORE_UPLOAD_URL',
+        description: 'URL for uploading blobs to filestore (s3://, gs://, file://)'
+    },
+    ...blobArchiveApiConfigMappings
+};
+/**
+ * Returns the blob client configuration from the environment variables.
+ * @returns The blob client configuration.
+ */ export function getBlobClientConfigFromEnv() {
+    return getConfigFromMappings(blobClientConfigMapping);
+}
+/**
+ * Returns whether the given blob client config has any remote sources defined.
+ */ export function hasRemoteBlobSources(config = {}) {
+    return !!(config.l1ConsensusHostUrls?.length || config.archiveApiUrl || config.blobFileStoreUrls?.length);
+}

package/dest/client/factory.d.ts

@@ -0,0 +1,39 @@
+import { type Logger } from '@aztec/foundation/log';
+import type { FileStoreBlobClient } from '../filestore/filestore_blob_client.js';
+import { type BlobClientConfig } from './config.js';
+import type { BlobClientInterface } from './interface.js';
+export interface CreateBlobClientDeps {
+    logger?: Logger;
+    /** FileStore clients for reading blobs */
+    fileStoreClients?: FileStoreBlobClient[];
+    /** FileStore client for uploading blobs */
+    fileStoreUploadClient?: FileStoreBlobClient;
+}
+export declare function createBlobClient(config?: BlobClientConfig, deps?: CreateBlobClientDeps): BlobClientInterface;
+/**
+ * Configuration required for creating a blob client with file stores.
+ * Extends BlobClientConfig with the metadata needed to construct file store paths.
+ */
+export interface BlobClientWithFileStoresConfig extends BlobClientConfig {
+    l1ChainId: number;
+    rollupVersion: number;
+    l1Contracts: {
+        rollupAddress: {
+            toString(): string;
+        };
+    };
+}
+/**
+ * Creates a BlobClient with FileStore clients for reading and uploading blobs.
+ * This is a convenience function that handles the common pattern of:
+ * 1. Building BlobFileStoreMetadata from config
+ * 2. Creating read-only FileStore clients
+ * 3. Creating a writable FileStore client for uploads
+ * 4. Creating the BlobClient with these dependencies
+ *
+ * @param config - Configuration containing blob client settings and chain metadata
+ * @param logger - Optional logger for the blob client
+ * @returns A BlobClientInterface configured with file store support
+ */
+export declare function createBlobClientWithFileStores(config: BlobClientWithFileStoresConfig, logger?: Logger): Promise<BlobClientInterface>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaWVudC9mYWN0b3J5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQVFsRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQ2pGLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUF3QixNQUFNLGFBQWEsQ0FBQztBQUUxRSxPQUFPLEtBQUssRUFBRSxtQkFBbUIsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBRzFELE1BQU0sV0FBVyxvQkFBb0I7SUFDbkMsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ2hCLDBDQUEwQztJQUMxQyxnQkFBZ0IsQ0FBQyxFQUFFLG1CQUFtQixFQUFFLENBQUM7SUFDekMsMkNBQTJDO0lBQzNDLHFCQUFxQixDQUFDLEVBQUUsbUJBQW1CLENBQUM7Q0FDN0M7QUFFRCx3QkFBZ0IsZ0JBQWdCLENBQUMsTUFBTSxDQUFDLEVBQUUsZ0JBQWdCLEVBQUUsSUFBSSxDQUFDLEVBQUUsb0JBQW9CLEdBQUcsbUJBQW1CLENBbUI1RztBQUVEOzs7R0FHRztBQUNILE1BQU0sV0FBVyw4QkFBK0IsU0FBUSxnQkFBZ0I7SUFDdEUsU0FBUyxFQUFFLE1BQU0sQ0FBQztJQUNsQixhQUFhLEVBQUUsTUFBTSxDQUFDO0lBQ3RCLFdBQVcsRUFBRTtRQUFFLGFBQWEsRUFBRTtZQUFFLFFBQVEsSUFBSSxNQUFNLENBQUE7U0FBRSxDQUFBO0tBQUUsQ0FBQztDQUN4RDtBQUVEOzs7Ozs7Ozs7OztHQVdHO0FBQ0gsd0JBQXNCLDhCQUE4QixDQUNsRCxNQUFNLEVBQUUsOEJBQThCLEVBQ3RDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sR0FDZCxPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0FtQjlCIn0=

package/dest/client/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/client/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAQlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,aAAa,CAAC;AAE1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,2CAA2C;IAC3C,qBAAqB,CAAC,EAAE,mBAAmB,CAAC;CAC7C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAmB5G;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA+B,SAAQ,gBAAgB;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE;QAAE,aAAa,EAAE;YAAE,QAAQ,IAAI,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,8BAA8B,EACtC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,mBAAmB,CAAC,CAmB9B"}

package/dest/client/factory.js

@@ -0,0 +1,53 @@
+import { createLogger } from '@aztec/foundation/log';
+import { MemoryBlobStore } from '../blobstore/memory_blob_store.js';
+import { createReadOnlyFileStoreBlobClients, createWritableFileStoreBlobClient } from '../filestore/factory.js';
+import { hasRemoteBlobSources } from './config.js';
+import { HttpBlobClient } from './http.js';
+import { LocalBlobClient } from './local.js';
+export function createBlobClient(config, deps) {
+    const log = deps?.logger ?? createLogger('blob-client');
+    if (!hasRemoteBlobSources(config)) {
+        log.info(`Creating local blob client.`);
+        const blobStore = new MemoryBlobStore();
+        return new LocalBlobClient(blobStore);
+    }
+    log.info(`Creating blob client.`, {
+        l1ConsensusHostUrls: config?.l1ConsensusHostUrls,
+        archiveApiUrl: config?.archiveApiUrl,
+        fileStoreCount: deps?.fileStoreClients?.length ?? 0,
+        hasFileStoreUpload: !!deps?.fileStoreUploadClient
+    });
+    return new HttpBlobClient(config, {
+        logger: log,
+        fileStoreClients: deps?.fileStoreClients,
+        fileStoreUploadClient: deps?.fileStoreUploadClient
+    });
+}
+/**
+ * Creates a BlobClient with FileStore clients for reading and uploading blobs.
+ * This is a convenience function that handles the common pattern of:
+ * 1. Building BlobFileStoreMetadata from config
+ * 2. Creating read-only FileStore clients
+ * 3. Creating a writable FileStore client for uploads
+ * 4. Creating the BlobClient with these dependencies
+ *
+ * @param config - Configuration containing blob client settings and chain metadata
+ * @param logger - Optional logger for the blob client
+ * @returns A BlobClientInterface configured with file store support
+ */ export async function createBlobClientWithFileStores(config, logger) {
+    const log = logger ?? createLogger('blob-client');
+    const fileStoreMetadata = {
+        l1ChainId: config.l1ChainId,
+        rollupVersion: config.rollupVersion,
+        rollupAddress: config.l1Contracts.rollupAddress.toString()
+    };
+    const [fileStoreClients, fileStoreUploadClient] = await Promise.all([
+        createReadOnlyFileStoreBlobClients(config.blobFileStoreUrls, fileStoreMetadata, log),
+        createWritableFileStoreBlobClient(config.blobFileStoreUploadUrl, fileStoreMetadata, log)
+    ]);
+    return createBlobClient(config, {
+        logger: log,
+        fileStoreClients,
+        fileStoreUploadClient
+    });
+}

package/dest/client/http.d.ts

@@ -0,0 +1,63 @@
+import { Blob, type BlobJson } from '@aztec/blob-lib';
+import { type Logger } from '@aztec/foundation/log';
+import type { BlobArchiveClient } from '../archive/interface.js';
+import type { FileStoreBlobClient } from '../filestore/filestore_blob_client.js';
+import { BlobWithIndex } from '../types/blob_with_index.js';
+import { type BlobClientConfig } from './config.js';
+import type { BlobClientInterface, GetBlobSidecarOptions } from './interface.js';
+export declare class HttpBlobClient implements BlobClientInterface {
+    private readonly opts;
+    protected readonly log: Logger;
+    protected readonly config: BlobClientConfig;
+    protected readonly archiveClient: BlobArchiveClient | undefined;
+    protected readonly fetch: typeof fetch;
+    protected readonly fileStoreClients: FileStoreBlobClient[];
+    protected readonly fileStoreUploadClient: FileStoreBlobClient | undefined;
+    private disabled;
+    constructor(config?: BlobClientConfig, opts?: {
+        logger?: Logger;
+        archiveClient?: BlobArchiveClient;
+        fileStoreClients?: FileStoreBlobClient[];
+        fileStoreUploadClient?: FileStoreBlobClient;
+        /** Callback fired when blobs are successfully fetched from any source */
+        onBlobsFetched?: (blobs: BlobWithIndex[]) => void;
+    });
+    /**
+     * Upload fetched blobs to filestore (fire-and-forget).
+     * Called automatically when blobs are fetched from any source.
+     */
+    private uploadBlobsToFileStore;
+    /**
+     * Disables or enables blob storage operations.
+     * When disabled, getBlobSidecar returns empty arrays and sendBlobsToFilestore returns false.
+     * Useful for testing scenarios where blob storage failure needs to be simulated.
+     * @param value - True to disable blob storage, false to enable
+     */
+    setDisabled(value: boolean): void;
+    testSources(): Promise<void>;
+    sendBlobsToFilestore(blobs: Blob[]): Promise<boolean>;
+    /**
+     * Get the blob sidecar
+     *
+     * If requesting from the blob client, we send the blobkHash
+     * If requesting from the beacon node, we send the slot number
+     *
+     * Source ordering depends on sync state:
+     * - Historical sync: blob client → FileStore → L1 consensus → Archive
+     * - Near tip sync: blob client → FileStore → L1 consensus → FileStore (with retries) → Archive (eg blobscan)
+     *
+     * @param blockHash - The block hash
+     * @param blobHashes - The blob hashes to fetch
+     * @param indices - The indices of the blobs to get
+     * @param opts - Options including isHistoricalSync flag
+     * @returns The blobs
+     */
+    getBlobSidecar(blockHash: `0x${string}`, blobHashes: Buffer[], indices?: number[], opts?: GetBlobSidecarOptions): Promise<BlobWithIndex[]>;
+    private tryFileStores;
+    getBlobSidecarFrom(hostUrl: string, blockHashOrSlot: string | number, blobHashes?: Buffer[], indices?: number[], l1ConsensusHostIndex?: number): Promise<BlobWithIndex[]>;
+    getBlobsFromHost(hostUrl: string, blockHashOrSlot: string | number, indices?: number[], l1ConsensusHostIndex?: number): Promise<BlobJson[]>;
+    private fetchBlobSidecars;
+    private getLatestSlotNumber;
+    private getSlotNumber;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHR0cC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaWVudC9odHRwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxJQUFJLEVBQUUsS0FBSyxRQUFRLEVBQStCLE1BQU0saUJBQWlCLENBQUM7QUFFbkYsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFnQixNQUFNLHVCQUF1QixDQUFDO0FBT2xFLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUNqRixPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDNUQsT0FBTyxFQUFFLEtBQUssZ0JBQWdCLEVBQThCLE1BQU0sYUFBYSxDQUFDO0FBQ2hGLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLHFCQUFxQixFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFakYscUJBQWEsY0FBZSxZQUFXLG1CQUFtQjtJQVl0RCxPQUFPLENBQUMsUUFBUSxDQUFDLElBQUk7SUFYdkIsU0FBUyxDQUFDLFFBQVEsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDO0lBQy9CLFNBQVMsQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLGdCQUFnQixDQUFDO0lBQzVDLFNBQVMsQ0FBQyxRQUFRLENBQUMsYUFBYSxFQUFFLGlCQUFpQixHQUFHLFNBQVMsQ0FBQztJQUNoRSxTQUFTLENBQUMsUUFBUSxDQUFDLEtBQUssRUFBRSxPQUFPLEtBQUssQ0FBQztJQUN2QyxTQUFTLENBQUMsUUFBUSxDQUFDLGdCQUFnQixFQUFFLG1CQUFtQixFQUFFLENBQUM7SUFDM0QsU0FBUyxDQUFDLFFBQVEsQ0FBQyxxQkFBcUIsRUFBRSxtQkFBbUIsR0FBRyxTQUFTLENBQUM7SUFFMUUsT0FBTyxDQUFDLFFBQVEsQ0FBUztJQUV6QixZQUNFLE1BQU0sQ0FBQyxFQUFFLGdCQUFnQixFQUNSLElBQUksR0FBRTtRQUNyQixNQUFNLENBQUMsRUFBRSxNQUFNLENBQUM7UUFDaEIsYUFBYSxDQUFDLEVBQUUsaUJBQWlCLENBQUM7UUFDbEMsZ0JBQWdCLENBQUMsRUFBRSxtQkFBbUIsRUFBRSxDQUFDO1FBQ3pDLHFCQUFxQixDQUFDLEVBQUUsbUJBQW1CLENBQUM7UUFDNUMseUVBQXlFO1FBQ3pFLGNBQWMsQ0FBQyxFQUFFLENBQUMsS0FBSyxFQUFFLGFBQWEsRUFBRSxLQUFLLElBQUksQ0FBQztLQUM5QyxFQXdCUDtJQUVEOzs7T0FHRztJQUNILE9BQU8sQ0FBQyxzQkFBc0I7SUFVOUI7Ozs7O09BS0c7SUFDSSxXQUFXLENBQUMsS0FBSyxFQUFFLE9BQU8sR0FBRyxJQUFJLENBR3ZDO0lBRVksV0FBVyxrQkFvRXZCO0lBRVksb0JBQW9CLENBQUMsS0FBSyxFQUFFLElBQUksRUFBRSxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FtQmpFO0lBRUQ7Ozs7Ozs7Ozs7Ozs7OztPQWVHO0lBQ1UsY0FBYyxDQUN6QixTQUFTLEVBQUUsS0FBSyxNQUFNLEVBQUUsRUFDeEIsVUFBVSxFQUFFLE1BQU0sRUFBRSxFQUNwQixPQUFPLENBQUMsRUFBRSxNQUFNLEVBQUUsRUFDbEIsSUFBSSxDQUFDLEVBQUUscUJBQXFCLEdBQzNCLE9BQU8sQ0FBQyxhQUFhLEVBQUUsQ0FBQyxDQTZJMUI7WUFRYSxhQUFhO0lBc0NkLGtCQUFrQixDQUM3QixPQUFPLEVBQUUsTUFBTSxFQUNmLGVBQWUsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUNoQyxVQUFVLEdBQUUsTUFBTSxFQUFPLEVBQ3pCLE9BQU8sR0FBRSxNQUFNLEVBQU8sRUFDdEIsb0JBQW9CLENBQUMsRUFBRSxNQUFNLEdBQzVCLE9BQU8sQ0FBQyxhQUFhLEVBQUUsQ0FBQyxDQUcxQjtJQUVZLGdCQUFnQixDQUMzQixPQUFPLEVBQUUsTUFBTSxFQUNmLGVBQWUsRUFBRSxNQUFNLEdBQUcsTUFBTSxFQUNoQyxPQUFPLEdBQUUsTUFBTSxFQUFPLEVBQ3RCLG9CQUFvQixDQUFDLEVBQUUsTUFBTSxHQUM1QixPQUFPLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FzQ3JCO0lBRUQsT0FBTyxDQUFDLGlCQUFpQjtZQWdCWCxtQkFBbUI7WUFtQ25CLGFBQWE7Q0E0RDVCIn0=

package/dest/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,QAAQ,EAA+B,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAOlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAA8B,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,qBAAa,cAAe,YAAW,mBAAmB;IAYtD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXvB,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAChE,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IAC3D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAE1E,OAAO,CAAC,QAAQ,CAAS;IAEzB,YACE,MAAM,CAAC,EAAE,gBAAgB,EACR,IAAI,GAAE;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,iBAAiB,CAAC;QAClC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;QACzC,qBAAqB,CAAC,EAAE,mBAAmB,CAAC;QAC5C,yEAAyE;QACzE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;KAC9C,EAwBP;IAED;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;OAKG;IACI,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGvC;IAEY,WAAW,kBAoEvB;IAEY,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBjE;IAED;;;;;;;;;;;;;;;OAeG;IACU,cAAc,CACzB,SAAS,EAAE,KAAK,MAAM,EAAE,EACxB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,IAAI,CAAC,EAAE,qBAAqB,GAC3B,OAAO,CAAC,aAAa,EAAE,CAAC,CA6I1B;YAQa,aAAa;IAsCd,kBAAkB,CAC7B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GAAG,MAAM,EAChC,UAAU,GAAE,MAAM,EAAO,EACzB,OAAO,GAAE,MAAM,EAAO,EACtB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,aAAa,EAAE,CAAC,CAG1B;IAEY,gBAAgB,CAC3B,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GAAG,MAAM,EAChC,OAAO,GAAE,MAAM,EAAO,EACtB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsCrB;IAED,OAAO,CAAC,iBAAiB;YAgBX,mBAAmB;YAmCnB,aAAa;CA4D5B"}