@aztec/node-lib 0.0.1-commit.001888fc

package/dest/factories/l1_tx_utils.js

@@ -0,0 +1,94 @@
+import { createDelayer, createL1TxUtils as createL1TxUtilsBase } from '@aztec/ethereum/l1-tx-utils';
+import { createForwarderL1TxUtils as createForwarderL1TxUtilsBase } from '@aztec/ethereum/l1-tx-utils-with-blobs';
+import { omit } from '@aztec/foundation/collection';
+import { createLogger } from '@aztec/foundation/log';
+import { createStore } from '@aztec/kv-store/lmdb-v2';
+import { L1TxMetrics } from '../metrics/l1_tx_metrics.js';
+import { L1TxStore } from '../stores/l1_tx_store.js';
+const L1_TX_STORE_NAME = 'l1-tx-utils';
+/**
+ * Creates shared dependencies (logger, store, metrics, delayer) for L1TxUtils instances.
+ * When enableDelayer is set in config, a single shared delayer is created and passed to all instances.
+ */ async function createSharedDeps(config, deps) {
+    const logger = deps.logger ?? createLogger('l1-tx-utils');
+    // Note that we do NOT bind them to the rollup address, since we still need to
+    // monitor and cancel txs for previous rollups to free up our nonces.
+    const noRollupConfig = omit(config, 'l1Contracts');
+    const kvStore = await createStore(L1_TX_STORE_NAME, L1TxStore.SCHEMA_VERSION, noRollupConfig, logger.getBindings());
+    const store = new L1TxStore(kvStore, logger);
+    const meter = deps.telemetry.getMeter('L1TxUtils');
+    const metrics = new L1TxMetrics(meter, config.scope ?? 'other', logger);
+    // Create a single shared delayer for all L1TxUtils instances in this group
+    const delayer = config.enableDelayer && config.ethereumSlotDuration !== undefined ? createDelayer(deps.dateProvider, {
+        ethereumSlotDuration: config.ethereumSlotDuration
+    }, logger.getBindings()) : undefined;
+    return {
+        logger,
+        store,
+        metrics,
+        dateProvider: deps.dateProvider,
+        delayer
+    };
+}
+/**
+ * Creates L1TxUtils from multiple Viem wallet clients, sharing store, metrics, and delayer.
+ * When kzg is provided in deps, blob support is enabled.
+ */ export async function createL1TxUtilsFromWallets(clients, config, deps) {
+    const sharedDeps = await createSharedDeps(config, deps);
+    return clients.map((client)=>createL1TxUtilsBase(client, {
+            ...sharedDeps,
+            kzg: deps.kzg
+        }, config));
+}
+/**
+ * Creates L1TxUtils from multiple EthSigners, sharing store, metrics, and delayer.
+ * When kzg is provided in deps, blob support is enabled.
+ * Deduplicates signers by address to avoid creating multiple instances for the same publisher.
+ */ export async function createL1TxUtilsFromSigners(client, signers, config, deps) {
+    const sharedDeps = await createSharedDeps(config, deps);
+    // Deduplicate signers by address to avoid creating multiple L1TxUtils instances
+    // for the same publisher address (e.g., when multiple attesters share the same publisher key)
+    const signersByAddress = new Map();
+    for (const signer of signers){
+        const addressKey = signer.address.toString().toLowerCase();
+        if (!signersByAddress.has(addressKey)) {
+            signersByAddress.set(addressKey, signer);
+        }
+    }
+    const uniqueSigners = Array.from(signersByAddress.values());
+    if (uniqueSigners.length < signers.length) {
+        sharedDeps.logger.info(`Deduplicated ${signers.length} signers to ${uniqueSigners.length} unique publisher addresses`);
+    }
+    return uniqueSigners.map((signer)=>createL1TxUtilsBase({
+            client,
+            signer
+        }, {
+            ...sharedDeps,
+            kzg: deps.kzg
+        }, config));
+}
+/**
+ * Creates ForwarderL1TxUtils from multiple Viem wallet clients, sharing store, metrics, and delayer.
+ * Wraps all transactions through a forwarder contract for testing purposes.
+ * When kzg is provided in deps, blob support is enabled.
+ */ export async function createForwarderL1TxUtilsFromWallets(clients, forwarderAddress, config, deps) {
+    const sharedDeps = await createSharedDeps(config, deps);
+    return clients.map((client)=>createForwarderL1TxUtilsBase(client, forwarderAddress, {
+            ...sharedDeps,
+            kzg: deps.kzg
+        }, config));
+}
+/**
+ * Creates ForwarderL1TxUtils from multiple EthSigners, sharing store, metrics, and delayer.
+ * Wraps all transactions through a forwarder contract for testing purposes.
+ * When kzg is provided in deps, blob support is enabled.
+ */ export async function createForwarderL1TxUtilsFromSigners(client, signers, forwarderAddress, config, deps) {
+    const sharedDeps = await createSharedDeps(config, deps);
+    return signers.map((signer)=>createForwarderL1TxUtilsBase({
+            client,
+            signer
+        }, forwarderAddress, {
+            ...sharedDeps,
+            kzg: deps.kzg
+        }, config));
+}

package/dest/metrics/index.d.ts

@@ -0,0 +1,2 @@
+export * from './l1_tx_metrics.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9tZXRyaWNzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsb0JBQW9CLENBQUMifQ==

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

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

package/dest/metrics/index.js

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

package/dest/metrics/l1_tx_metrics.d.ts

@@ -0,0 +1,29 @@
+import type { IL1TxMetrics, L1TxState } from '@aztec/ethereum/l1-tx-utils';
+import { type Meter } from '@aztec/telemetry-client';
+export type L1TxScope = 'sequencer' | 'prover' | 'other';
+/**
+ * Metrics for L1 transaction utils tracking tx lifecycle and gas costs.
+ */
+export declare class L1TxMetrics implements IL1TxMetrics {
+    private meter;
+    private scope;
+    private logger;
+    private txMinedDuration;
+    private txAttemptsUntilMined;
+    private txMinedCount;
+    private txRevertedCount;
+    private txCancelledCount;
+    private txNotMinedCount;
+    private maxPriorityFeeHistogram;
+    private maxFeeHistogram;
+    private blobFeeHistogram;
+    constructor(meter: Meter, scope?: L1TxScope, logger?: import("@aztec/foundation/log").Logger);
+    /**
+     * Records metrics when a transaction is mined.
+     * @param state - The L1 transaction state
+     * @param l1Timestamp - The current L1 timestamp
+     */
+    recordMinedTx(state: L1TxState, l1Timestamp: Date): void;
+    recordDroppedTx(state: L1TxState): void;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfdHhfbWV0cmljcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL21ldHJpY3MvbDFfdHhfbWV0cmljcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFHM0UsT0FBTyxFQUdMLEtBQUssS0FBSyxFQUlYLE1BQU0seUJBQXlCLENBQUM7QUFFakMsTUFBTSxNQUFNLFNBQVMsR0FBRyxXQUFXLEdBQUcsUUFBUSxHQUFHLE9BQU8sQ0FBQztBQUV6RDs7R0FFRztBQUNILHFCQUFhLFdBQVksWUFBVyxZQUFZO0lBbUI1QyxPQUFPLENBQUMsS0FBSztJQUNiLE9BQU8sQ0FBQyxLQUFLO0lBQ2IsT0FBTyxDQUFDLE1BQU07SUFuQmhCLE9BQU8sQ0FBQyxlQUFlLENBQVk7SUFHbkMsT0FBTyxDQUFDLG9CQUFvQixDQUFZO0lBR3hDLE9BQU8sQ0FBQyxZQUFZLENBQWdCO0lBQ3BDLE9BQU8sQ0FBQyxlQUFlLENBQWdCO0lBQ3ZDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBZ0I7SUFDeEMsT0FBTyxDQUFDLGVBQWUsQ0FBZ0I7SUFHdkMsT0FBTyxDQUFDLHVCQUF1QixDQUFZO0lBQzNDLE9BQU8sQ0FBQyxlQUFlLENBQVk7SUFDbkMsT0FBTyxDQUFDLGdCQUFnQixDQUFZO0lBRXBDLFlBQ1UsS0FBSyxFQUFFLEtBQUssRUFDWixLQUFLLEdBQUUsU0FBbUIsRUFDMUIsTUFBTSx5Q0FBc0MsRUFvQnJEO0lBRUQ7Ozs7T0FJRztJQUNJLGFBQWEsQ0FBQyxLQUFLLEVBQUUsU0FBUyxFQUFFLFdBQVcsRUFBRSxJQUFJLEdBQUcsSUFBSSxDQW9EOUQ7SUFFTSxlQUFlLENBQUMsS0FBSyxFQUFFLFNBQVMsR0FBRyxJQUFJLENBaUI3QztDQUNGIn0=

package/dest/metrics/l1_tx_metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_tx_metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/l1_tx_metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG3E,OAAO,EAGL,KAAK,KAAK,EAIX,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD;;GAEG;AACH,qBAAa,WAAY,YAAW,YAAY;IAmB5C,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IAnBhB,OAAO,CAAC,eAAe,CAAY;IAGnC,OAAO,CAAC,oBAAoB,CAAY;IAGxC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAgB;IAGvC,OAAO,CAAC,uBAAuB,CAAY;IAC3C,OAAO,CAAC,eAAe,CAAY;IACnC,OAAO,CAAC,gBAAgB,CAAY;IAEpC,YACU,KAAK,EAAE,KAAK,EACZ,KAAK,GAAE,SAAmB,EAC1B,MAAM,yCAAsC,EAoBrD;IAED;;;;OAIG;IACI,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,GAAG,IAAI,CAoD9D;IAEM,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAiB7C;CACF"}

package/dest/metrics/l1_tx_metrics.js

@@ -0,0 +1,111 @@
+import { TxUtilsState } from '@aztec/ethereum/l1-tx-utils';
+import { createLogger } from '@aztec/foundation/log';
+import { Attributes, Metrics, createUpDownCounterWithDefault } from '@aztec/telemetry-client';
+/**
+ * Metrics for L1 transaction utils tracking tx lifecycle and gas costs.
+ */ export class L1TxMetrics {
+    meter;
+    scope;
+    logger;
+    // Time until tx is mined
+    txMinedDuration;
+    // Number of attempts until mined
+    txAttemptsUntilMined;
+    // Counters for end states
+    txMinedCount;
+    txRevertedCount;
+    txCancelledCount;
+    txNotMinedCount;
+    // Gas price histograms (at end state, in wei)
+    maxPriorityFeeHistogram;
+    maxFeeHistogram;
+    blobFeeHistogram;
+    constructor(meter, scope = 'other', logger = createLogger('l1-tx-utils:metrics')){
+        this.meter = meter;
+        this.scope = scope;
+        this.logger = logger;
+        this.txMinedDuration = this.meter.createHistogram(Metrics.L1_TX_MINED_DURATION);
+        this.txAttemptsUntilMined = this.meter.createHistogram(Metrics.L1_TX_ATTEMPTS_UNTIL_MINED);
+        const scopeAttributes = [
+            {
+                [Attributes.L1_TX_SCOPE]: this.scope
+            }
+        ];
+        this.txMinedCount = createUpDownCounterWithDefault(this.meter, Metrics.L1_TX_MINED_COUNT, scopeAttributes);
+        this.txRevertedCount = createUpDownCounterWithDefault(this.meter, Metrics.L1_TX_REVERTED_COUNT, scopeAttributes);
+        this.txCancelledCount = createUpDownCounterWithDefault(this.meter, Metrics.L1_TX_CANCELLED_COUNT, scopeAttributes);
+        this.txNotMinedCount = createUpDownCounterWithDefault(this.meter, Metrics.L1_TX_NOT_MINED_COUNT, scopeAttributes);
+        this.maxPriorityFeeHistogram = this.meter.createHistogram(Metrics.L1_TX_MAX_PRIORITY_FEE);
+        this.maxFeeHistogram = this.meter.createHistogram(Metrics.L1_TX_MAX_FEE);
+        this.blobFeeHistogram = this.meter.createHistogram(Metrics.L1_TX_BLOB_FEE);
+    }
+    /**
+   * Records metrics when a transaction is mined.
+   * @param state - The L1 transaction state
+   * @param l1Timestamp - The current L1 timestamp
+   */ recordMinedTx(state, l1Timestamp) {
+        if (state.status !== TxUtilsState.MINED) {
+            this.logger.warn(`Attempted to record mined tx metrics for a tx not in MINED state (state: ${TxUtilsState[state.status]})`, {
+                scope: this.scope,
+                nonce: state.nonce
+            });
+            return;
+        }
+        const attributes = {
+            [Attributes.L1_TX_SCOPE]: this.scope
+        };
+        const isCancelTx = state.cancelTxHashes.length > 0;
+        const isReverted = state.receipt?.status === 'reverted';
+        if (isCancelTx) {
+            this.txCancelledCount.add(1, attributes);
+        } else if (isReverted) {
+            this.txRevertedCount.add(1, attributes);
+        } else {
+            this.txMinedCount.add(1, attributes);
+        }
+        // Record time to mine using provided L1 timestamp
+        const duration = Math.floor((l1Timestamp.getTime() - state.sentAtL1Ts.getTime()) / 1000);
+        this.txMinedDuration.record(duration, attributes);
+        // Record number of attempts until mined
+        const attempts = isCancelTx ? state.cancelTxHashes.length : state.txHashes.length;
+        this.txAttemptsUntilMined.record(attempts, attributes);
+        // Record gas prices at end state (in wei as integers)
+        const maxPriorityFeeWei = Number(state.gasPrice.maxPriorityFeePerGas);
+        const maxFeeWei = Number(state.gasPrice.maxFeePerGas);
+        const blobFeeWei = state.gasPrice.maxFeePerBlobGas ? Number(state.gasPrice.maxFeePerBlobGas) : undefined;
+        this.maxPriorityFeeHistogram.record(maxPriorityFeeWei, attributes);
+        this.maxFeeHistogram.record(maxFeeWei, attributes);
+        // Record blob fee if present (in wei as integer)
+        if (blobFeeWei !== undefined) {
+            this.blobFeeHistogram.record(blobFeeWei, attributes);
+        }
+        this.logger.debug(`Recorded tx end state metrics`, {
+            status: TxUtilsState[state.status],
+            nonce: state.nonce,
+            isCancelTx,
+            isReverted,
+            scope: this.scope,
+            maxPriorityFeeWei,
+            maxFeeWei,
+            blobFeeWei
+        });
+    }
+    recordDroppedTx(state) {
+        if (state.status !== TxUtilsState.NOT_MINED) {
+            this.logger.warn(`Attempted to record dropped tx metrics for a tx not in NOT_MINED state (state: ${TxUtilsState[state.status]})`, {
+                scope: this.scope,
+                nonce: state.nonce
+            });
+            return;
+        }
+        const attributes = {
+            [Attributes.L1_TX_SCOPE]: this.scope
+        };
+        this.txNotMinedCount.add(1, attributes);
+        this.logger.debug(`Recorded tx dropped metrics`, {
+            status: TxUtilsState[state.status],
+            nonce: state.nonce,
+            scope: this.scope
+        });
+    }
+}

package/dest/stores/index.d.ts

@@ -0,0 +1,2 @@
+export * from './l1_tx_store.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxrQkFBa0IsQ0FBQyJ9

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

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

package/dest/stores/index.js

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

package/dest/stores/l1_tx_store.d.ts

@@ -0,0 +1,89 @@
+import type { IL1TxStore, L1BlobInputs, L1TxState } from '@aztec/ethereum/l1-tx-utils';
+import type { Logger } from '@aztec/foundation/log';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+/**
+ * Store for persisting L1 transaction states across all L1TxUtils instances.
+ * Each state is stored individually with a unique ID, and blobs are stored separately.
+ * @remarks This class lives in this package instead of `ethereum` because it depends on `kv-store`.
+ */
+export declare class L1TxStore implements IL1TxStore {
+    private readonly store;
+    private readonly log;
+    static readonly SCHEMA_VERSION = 2;
+    private readonly states;
+    private readonly blobs;
+    private readonly stateIdCounter;
+    constructor(store: AztecAsyncKVStore, log?: Logger);
+    /**
+     * Gets the next available state ID for an account.
+     */
+    consumeNextStateId(account: string): Promise<number>;
+    /**
+     * Creates a storage key for state/blob data.
+     */
+    private makeKey;
+    /**
+     * Saves a single transaction state for a specific account.
+     * Blobs are not stored here, use saveBlobs instead.
+     * @param account - The sender account address
+     * @param state - Transaction state to save
+     */
+    saveState(account: string, state: L1TxState): Promise<L1TxState>;
+    /**
+     * Saves blobs for a given state.
+     * @param account - The sender account address
+     * @param stateId - The state ID
+     * @param blobInputs - Blob inputs to save
+     */
+    saveBlobs(account: string, stateId: number, blobInputs: L1BlobInputs | undefined): Promise<void>;
+    /**
+     * Loads all transaction states for a specific account.
+     * @param account - The sender account address
+     * @returns Array of transaction states with their IDs
+     */
+    loadStates(account: string): Promise<L1TxState[]>;
+    /**
+     * Loads a single state by ID.
+     * @param account - The sender account address
+     * @param stateId - The state ID
+     * @returns The transaction state or undefined if not found
+     */
+    loadState(account: string, stateId: number): Promise<L1TxState | undefined>;
+    /**
+     * Deletes a specific state and its associated blobs.
+     * @param account - The sender account address
+     * @param stateId - The state ID to delete
+     */
+    deleteState(account: string, ...stateIds: number[]): Promise<void>;
+    /**
+     * Clears all transaction states for a specific account.
+     * @param account - The sender account address
+     */
+    clearStates(account: string): Promise<void>;
+    /**
+     * Gets all accounts that have stored states.
+     * @returns Array of account addresses
+     */
+    getAllAccounts(): Promise<string[]>;
+    /**
+     * Closes the store.
+     */
+    close(): Promise<void>;
+    /**
+     * Serializes an L1TxState for storage.
+     */
+    private serializeState;
+    /**
+     * Deserializes a stored state back to L1TxState.
+     */
+    private deserializeState;
+    /**
+     * Serializes blob inputs for separate storage.
+     */
+    private serializeBlobInputs;
+    /**
+     * Deserializes blob inputs from storage, combining blob data with metadata.
+     */
+    private deserializeBlobInputs;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDFfdHhfc3RvcmUuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdG9yZXMvbDFfdHhfc3RvcmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLFlBQVksRUFBYyxTQUFTLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVuRyxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVwRCxPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBaUIsTUFBTSxpQkFBaUIsQ0FBQztBQTJFeEU7Ozs7R0FJRztBQUNILHFCQUFhLFNBQVUsWUFBVyxVQUFVO0lBUXhDLE9BQU8sQ0FBQyxRQUFRLENBQUMsS0FBSztJQUN0QixPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUc7SUFSdEIsZ0JBQXVCLGNBQWMsS0FBSztJQUUxQyxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBZ0M7SUFDdkQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQWdDO0lBQ3RELE9BQU8sQ0FBQyxRQUFRLENBQUMsY0FBYyxDQUFnQztJQUUvRCxZQUNtQixLQUFLLEVBQUUsaUJBQWlCLEVBQ3hCLEdBQUcsR0FBRSxNQUEwQyxFQUtqRTtJQUVEOztPQUVHO0lBQ0ksa0JBQWtCLENBQUMsT0FBTyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxDQUFDLENBTzFEO0lBRUQ7O09BRUc7SUFDSCxPQUFPLENBQUMsT0FBTztJQUlmOzs7OztPQUtHO0lBQ1UsU0FBUyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsS0FBSyxFQUFFLFNBQVMsR0FBRyxPQUFPLENBQUMsU0FBUyxDQUFDLENBUTVFO0lBRUQ7Ozs7O09BS0c7SUFDVSxTQUFTLENBQUMsT0FBTyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLFVBQVUsRUFBRSxZQUFZLEdBQUcsU0FBUyxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FRNUc7SUFFRDs7OztPQUlHO0lBQ1UsVUFBVSxDQUFDLE9BQU8sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLFNBQVMsRUFBRSxDQUFDLENBb0M3RDtJQUVEOzs7OztPQUtHO0lBQ1UsU0FBUyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLE1BQU0sR0FBRyxPQUFPLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQyxDQTBCdkY7SUFFRDs7OztPQUlHO0lBQ1UsV0FBVyxDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsR0FBRyxRQUFRLEVBQUUsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQyxDQVk5RTtJQUVEOzs7T0FHRztJQUNVLFdBQVcsQ0FBQyxPQUFPLEVBQUUsTUFBTSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FXdkQ7SUFFRDs7O09BR0c7SUFDVSxjQUFjLElBQUksT0FBTyxDQUFDLE1BQU0sRUFBRSxDQUFDLENBUy9DO0lBRUQ7O09BRUc7SUFDVSxLQUFLLElBQUksT0FBTyxDQUFDLElBQUksQ0FBQyxDQUdsQztJQUVEOztPQUVHO0lBQ0gsT0FBTyxDQUFDLGNBQWM7SUFrQ3RCOztPQUVHO0lBQ0gsT0FBTyxDQUFDLGdCQUFnQjtJQTJDeEI7O09BRUc7SUFDSCxPQUFPLENBQUMsbUJBQW1CO0lBTzNCOztPQUVHO0lBQ0gsT0FBTyxDQUFDLHFCQUFxQjtDQVk5QiJ9

package/dest/stores/l1_tx_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l1_tx_store.d.ts","sourceRoot":"","sources":["../../src/stores/l1_tx_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEnG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,iBAAiB,CAAC;AA2ExE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,UAAU;IAQxC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IARtB,gBAAuB,cAAc,KAAK;IAE1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAE/D,YACmB,KAAK,EAAE,iBAAiB,EACxB,GAAG,GAAE,MAA0C,EAKjE;IAED;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1D;IAED;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;;;;OAKG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAQ5E;IAED;;;;;OAKG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5G;IAED;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAoC7D;IAED;;;;;OAKG;IACU,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CA0BvF;IAED;;;;OAIG;IACU,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9E;IAED;;;OAGG;IACU,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvD;IAED;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAS/C;IAED;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAGlC;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAkCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAY9B"}

package/dest/stores/l1_tx_store.js

@@ -0,0 +1,272 @@
+import { jsonStringify } from '@aztec/foundation/json-rpc';
+import { createLogger } from '@aztec/foundation/log';
+/**
+ * Store for persisting L1 transaction states across all L1TxUtils instances.
+ * Each state is stored individually with a unique ID, and blobs are stored separately.
+ * @remarks This class lives in this package instead of `ethereum` because it depends on `kv-store`.
+ */ export class L1TxStore {
+    store;
+    log;
+    static SCHEMA_VERSION = 2;
+    states;
+    blobs;
+    stateIdCounter;
+    constructor(store, log = createLogger('l1-tx-utils:store')){
+        this.store = store;
+        this.log = log;
+        this.states = store.openMap('l1_tx_states');
+        this.blobs = store.openMap('l1_tx_blobs');
+        this.stateIdCounter = store.openMap('l1_tx_state_id_counter');
+    }
+    /**
+   * Gets the next available state ID for an account.
+   */ consumeNextStateId(account) {
+        return this.store.transactionAsync(async ()=>{
+            const currentId = await this.stateIdCounter.getAsync(account) ?? 0;
+            const nextId = currentId + 1;
+            await this.stateIdCounter.set(account, nextId);
+            return nextId;
+        });
+    }
+    /**
+   * Creates a storage key for state/blob data.
+   */ makeKey(account, stateId) {
+        return `${account}-${stateId.toString().padStart(10, '0')}`;
+    }
+    /**
+   * Saves a single transaction state for a specific account.
+   * Blobs are not stored here, use saveBlobs instead.
+   * @param account - The sender account address
+   * @param state - Transaction state to save
+   */ async saveState(account, state) {
+        const key = this.makeKey(account, state.id);
+        const serializable = this.serializeState(state);
+        await this.states.set(key, jsonStringify(serializable));
+        this.log.debug(`Saved tx state ${state.id} for account ${account} with nonce ${state.nonce}`);
+        return state;
+    }
+    /**
+   * Saves blobs for a given state.
+   * @param account - The sender account address
+   * @param stateId - The state ID
+   * @param blobInputs - Blob inputs to save
+   */ async saveBlobs(account, stateId, blobInputs) {
+        if (!blobInputs) {
+            return;
+        }
+        const key = this.makeKey(account, stateId);
+        const blobData = this.serializeBlobInputs(blobInputs);
+        await this.blobs.set(key, jsonStringify(blobData));
+        this.log.debug(`Saved blobs for state ${stateId} of account ${account}`);
+    }
+    /**
+   * Loads all transaction states for a specific account.
+   * @param account - The sender account address
+   * @returns Array of transaction states with their IDs
+   */ async loadStates(account) {
+        const states = [];
+        const prefix = `${account}-`;
+        for await (const [key, stateJson] of this.states.entriesAsync({
+            start: prefix,
+            end: `${prefix}Z`
+        })){
+            const [keyAccount, stateIdStr] = key.split('-');
+            if (keyAccount !== account) {
+                throw new Error(`Mismatched account in key: expected ${account} but got ${keyAccount}`);
+            }
+            const stateId = parseInt(stateIdStr, 10);
+            try {
+                const serialized = JSON.parse(stateJson);
+                // Load blobs if they exist
+                let blobInputs;
+                if (serialized.hasBlobInputs) {
+                    const blobJson = await this.blobs.getAsync(key);
+                    if (blobJson) {
+                        blobInputs = this.deserializeBlobInputs(JSON.parse(blobJson), serialized.blobMetadata);
+                    }
+                }
+                const state = this.deserializeState(serialized, blobInputs);
+                states.push({
+                    ...state,
+                    id: stateId
+                });
+            } catch (err) {
+                this.log.error(`Failed to deserialize state ${key}`, err);
+            }
+        }
+        // Sort by ID
+        states.sort((a, b)=>a.id - b.id);
+        this.log.debug(`Loaded ${states.length} tx states for account ${account}`);
+        return states;
+    }
+    /**
+   * Loads a single state by ID.
+   * @param account - The sender account address
+   * @param stateId - The state ID
+   * @returns The transaction state or undefined if not found
+   */ async loadState(account, stateId) {
+        const key = this.makeKey(account, stateId);
+        const stateJson = await this.states.getAsync(key);
+        if (!stateJson) {
+            return undefined;
+        }
+        try {
+            const serialized = JSON.parse(stateJson);
+            // Load blobs if they exist
+            let blobInputs;
+            if (serialized.hasBlobInputs) {
+                const blobJson = await this.blobs.getAsync(key);
+                if (blobJson) {
+                    blobInputs = this.deserializeBlobInputs(JSON.parse(blobJson), serialized.blobMetadata);
+                }
+            }
+            const state = this.deserializeState(serialized, blobInputs);
+            return {
+                ...state,
+                id: stateId
+            };
+        } catch (err) {
+            this.log.error(`Failed to deserialize state ${key}`, err);
+            return undefined;
+        }
+    }
+    /**
+   * Deletes a specific state and its associated blobs.
+   * @param account - The sender account address
+   * @param stateId - The state ID to delete
+   */ async deleteState(account, ...stateIds) {
+        if (stateIds.length === 0) {
+            return;
+        }
+        await this.store.transactionAsync(async ()=>{
+            for (const stateId of stateIds){
+                const key = this.makeKey(account, stateId);
+                await this.states.delete(key);
+                await this.blobs.delete(key);
+            }
+        });
+    }
+    /**
+   * Clears all transaction states for a specific account.
+   * @param account - The sender account address
+   */ async clearStates(account) {
+        await this.store.transactionAsync(async ()=>{
+            const states = await this.loadStates(account);
+            for (const state of states){
+                await this.deleteState(account, state.id);
+            }
+            await this.stateIdCounter.delete(account);
+            this.log.info(`Cleared all tx states for account ${account}`);
+        });
+    }
+    /**
+   * Gets all accounts that have stored states.
+   * @returns Array of account addresses
+   */ async getAllAccounts() {
+        const accounts = new Set();
+        for await (const [key] of this.states.entriesAsync()){
+            const account = key.substring(0, key.lastIndexOf('-'));
+            accounts.add(account);
+        }
+        return Array.from(accounts);
+    }
+    /**
+   * Closes the store.
+   */ async close() {
+        await this.store.close();
+        this.log.info('Closed L1 tx state store');
+    }
+    /**
+   * Serializes an L1TxState for storage.
+   */ serializeState(state) {
+        const txConfigOverrides = {
+            ...state.txConfigOverrides,
+            gasLimit: state.txConfigOverrides.gasLimit?.toString(),
+            txTimeoutAt: state.txConfigOverrides.txTimeoutAt?.getTime()
+        };
+        return {
+            id: state.id,
+            txHashes: state.txHashes,
+            cancelTxHashes: state.cancelTxHashes,
+            gasLimit: state.gasLimit.toString(),
+            gasPrice: {
+                maxFeePerGas: state.gasPrice.maxFeePerGas.toString(),
+                maxPriorityFeePerGas: state.gasPrice.maxPriorityFeePerGas.toString(),
+                maxFeePerBlobGas: state.gasPrice.maxFeePerBlobGas?.toString()
+            },
+            txConfigOverrides,
+            request: {
+                ...state.request,
+                value: state.request.value?.toString()
+            },
+            status: state.status,
+            nonce: state.nonce,
+            sentAt: state.sentAtL1Ts.getTime(),
+            lastSentAt: state.lastSentAtL1Ts.getTime(),
+            receipt: state.receipt,
+            hasBlobInputs: state.blobInputs !== undefined,
+            blobMetadata: state.blobInputs?.maxFeePerBlobGas ? {
+                maxFeePerBlobGas: state.blobInputs.maxFeePerBlobGas.toString()
+            } : undefined
+        };
+    }
+    /**
+   * Deserializes a stored state back to L1TxState.
+   */ deserializeState(stored, blobInputs) {
+        const txConfigOverrides = {
+            ...stored.txConfigOverrides,
+            gasLimit: stored.txConfigOverrides.gasLimit !== undefined ? BigInt(stored.txConfigOverrides.gasLimit) : undefined,
+            txTimeoutAt: stored.txConfigOverrides.txTimeoutAt !== undefined ? new Date(stored.txConfigOverrides.txTimeoutAt) : undefined
+        };
+        const receipt = stored.receipt ? {
+            ...stored.receipt,
+            blockNumber: BigInt(stored.receipt.blockNumber),
+            cumulativeGasUsed: BigInt(stored.receipt.cumulativeGasUsed),
+            effectiveGasPrice: BigInt(stored.receipt.effectiveGasPrice),
+            gasUsed: BigInt(stored.receipt.gasUsed)
+        } : undefined;
+        return {
+            id: stored.id,
+            txHashes: stored.txHashes,
+            cancelTxHashes: stored.cancelTxHashes,
+            gasLimit: BigInt(stored.gasLimit),
+            gasPrice: {
+                maxFeePerGas: BigInt(stored.gasPrice.maxFeePerGas),
+                maxPriorityFeePerGas: BigInt(stored.gasPrice.maxPriorityFeePerGas),
+                maxFeePerBlobGas: stored.gasPrice.maxFeePerBlobGas ? BigInt(stored.gasPrice.maxFeePerBlobGas) : undefined
+            },
+            txConfigOverrides,
+            request: {
+                to: stored.request.to,
+                data: stored.request.data,
+                value: stored.request.value ? BigInt(stored.request.value) : undefined
+            },
+            status: stored.status,
+            nonce: stored.nonce,
+            sentAtL1Ts: new Date(stored.sentAt),
+            lastSentAtL1Ts: new Date(stored.lastSentAt),
+            receipt,
+            blobInputs
+        };
+    }
+    /**
+   * Serializes blob inputs for separate storage.
+   */ serializeBlobInputs(blobInputs) {
+        return {
+            blobs: blobInputs.blobs.map((b)=>Buffer.from(b).toString('base64')),
+            kzg: jsonStringify(blobInputs.kzg)
+        };
+    }
+    /**
+   * Deserializes blob inputs from storage, combining blob data with metadata.
+   */ deserializeBlobInputs(stored, metadata) {
+        const blobInputs = {
+            blobs: stored.blobs.map((b)=>new Uint8Array(Buffer.from(b, 'base64'))),
+            kzg: JSON.parse(stored.kzg)
+        };
+        if (metadata?.maxFeePerBlobGas) {
+            blobInputs.maxFeePerBlobGas = BigInt(metadata.maxFeePerBlobGas);
+        }
+        return blobInputs;
+    }
+}