@pimlico/alto 0.0.0-main.20250916T162729 → 0.0.0-main.20250930T125129

package/esm/store/outstanding/redis.js

@@ -0,0 +1,201 @@
+import { userOpInfoSchema } from "../../types/index.js";
+import { getNonceKeyAndSequence, isDeployment } from "../../utils/index.js";
+import { Redis } from "ioredis";
+import { toHex } from "viem/utils";
+const serialize = (userOpInfo) => {
+    return JSON.stringify(userOpInfo, (_, value) => typeof value === "bigint" ? toHex(value) : value);
+};
+const deserialize = (data) => {
+    const parsed = JSON.parse(data);
+    return userOpInfoSchema.parse(parsed);
+};
+class RedisOutstandingQueue {
+    redis;
+    senderNonceKeyPrefix; // sender + nonceKey -> userOpHash
+    readyQueue; // Queue of userOpHashes (sorted by composite of userOp.nonceSeq + userOp.maxFeePerGas)
+    userOpHashMap; // userOpHash -> boolean
+    deploymentHashMap; // sender -> deployment userOpHash
+    senderNonceQueueTtl; // TTL for sender nonce queues in seconds
+    constructor({ config, entryPoint, redisEndpoint, logger }) {
+        this.redis = new Redis(redisEndpoint, {});
+        // Initialize Redis key names
+        const redisPrefix = `${config.redisKeyPrefix}:${config.chainId}:${entryPoint}:outstanding`;
+        this.readyQueue = `${redisPrefix}:ready-queue`;
+        this.senderNonceKeyPrefix = `${redisPrefix}:sender`;
+        this.userOpHashMap = `${redisPrefix}:userop-hash`;
+        this.deploymentHashMap = `${redisPrefix}:deployment-senders`;
+        // Calculate TTL for sender nonce queues (10 blocks worth of time)
+        this.senderNonceQueueTtl = config.blockTime * 10;
+        logger.info({
+            readyQueueKey: this.readyQueue
+        }, "Using redis for outstanding mempool.");
+    }
+    // Returns queue index for this sender + nonceKey.
+    getSenderNonceQueue(userOp) {
+        const [nonceKey] = getNonceKeyAndSequence(userOp.nonce);
+        return `${this.senderNonceKeyPrefix}:${userOp.sender}:${nonceKey}`;
+    }
+    // OutstandingStore methods
+    async contains(userOpHash) {
+        const exists = await this.redis.hexists(this.userOpHashMap, userOpHash);
+        return exists === 1;
+    }
+    async popConflicting(userOp) {
+        const { sender, nonce } = userOp;
+        const [nonceSeq] = getNonceKeyAndSequence(nonce);
+        // Check for conflicting nonce.
+        const senderNonceQueue = this.getSenderNonceQueue(userOp);
+        const conflictingHashes = await this.redis.zrangebyscore(senderNonceQueue, Number(nonceSeq), Number(nonceSeq));
+        if (conflictingHashes.length > 0) {
+            const conflictingHash = conflictingHashes[0];
+            const removedUserOps = await this.remove([conflictingHash]);
+            if (removedUserOps.length > 0) {
+                return {
+                    reason: "conflicting_nonce",
+                    userOpInfo: removedUserOps[0]
+                };
+            }
+        }
+        // Check for conflicting deployment.
+        if (isDeployment(userOp)) {
+            const existingDeploymentHash = (await this.redis.hget(this.deploymentHashMap, sender));
+            if (existingDeploymentHash) {
+                const removedUserOps = await this.remove([
+                    existingDeploymentHash
+                ]);
+                if (removedUserOps.length > 0) {
+                    return {
+                        reason: "conflicting_deployment",
+                        userOpInfo: removedUserOps[0]
+                    };
+                }
+            }
+        }
+        return undefined;
+    }
+    async add(userOpInfos) {
+        if (userOpInfos.length === 0)
+            return;
+        // Use pipeline for atomic operations
+        const pipeline = this.redis.pipeline();
+        for (const userOpInfo of userOpInfos) {
+            const { userOp } = userOpInfo;
+            const [, nonceSequence] = getNonceKeyAndSequence(userOp.nonce);
+            const userOpHash = userOpInfo.userOpHash;
+            // Create composite score: nonceSequence in upper 32 bits, maxFeePerGas in lower 32 bits.
+            const score = (nonceSequence << 32n) | (userOp.maxFeePerGas & 0xffffffffn);
+            // Serialize userOpInfo for storage.
+            const serializedUserOp = serialize(userOpInfo);
+            // Add to main ready queue.
+            pipeline.zadd(this.readyQueue, Number(score), userOpHash);
+            // Add to sender+nonceKey index for fast lookup.
+            const senderNonceQueue = this.getSenderNonceQueue(userOp);
+            pipeline.zadd(senderNonceQueue, Number(nonceSequence), userOpHash);
+            pipeline.expire(senderNonceQueue, this.senderNonceQueueTtl);
+            // Add to userOpHash map.
+            pipeline.hset(this.userOpHashMap, userOpHash, serializedUserOp);
+            // Add sender to deployment hash if this is a deployment.
+            if (isDeployment(userOp)) {
+                pipeline.hset(this.deploymentHashMap, userOp.sender, userOpHash);
+            }
+        }
+        await pipeline.exec();
+    }
+    // Removes userOps given their hashes and returns the userOpInfo objects.
+    async remove(userOpHashes) {
+        if (userOpHashes.length === 0)
+            return [];
+        // Get all serialized data in parallel.
+        const pipeline = this.redis.pipeline();
+        for (const hash of userOpHashes) {
+            pipeline.hget(this.userOpHashMap, hash);
+        }
+        const serializedResults = await pipeline.exec();
+        const removedUserOps = [];
+        const removalPipeline = this.redis.pipeline();
+        // Process each userOp that exists.
+        for (let i = 0; i < userOpHashes.length; i++) {
+            const serialized = serializedResults?.[i]?.[1];
+            if (!serialized)
+                continue;
+            const userOpHash = userOpHashes[i];
+            const userOpInfo = deserialize(serialized);
+            const { userOp } = userOpInfo;
+            const [, nonceSequence] = getNonceKeyAndSequence(userOp.nonce);
+            const senderNonceQueue = this.getSenderNonceQueue(userOp);
+            const isDeploymentOp = isDeployment(userOp);
+            // Remove from ready queue.
+            removalPipeline.zrem(this.readyQueue, userOpHash);
+            // Remove from sender nonceKey queue.
+            removalPipeline.zremrangebyscore(senderNonceQueue, Number(nonceSequence), Number(nonceSequence));
+            // Remove from hash lookup.
+            removalPipeline.hdel(this.userOpHashMap, userOpHash);
+            // Remove sender from deployment hash if this was a deployment.
+            if (isDeploymentOp) {
+                removalPipeline.hdel(this.deploymentHashMap, userOp.sender);
+            }
+            removedUserOps.push(userOpInfo);
+        }
+        // Execute all removals.
+        await removalPipeline.exec();
+        return removedUserOps;
+    }
+    async pop(count) {
+        // Pop from ready queue
+        const results = await this.redis.zpopmax(this.readyQueue, count);
+        if (!results || results.length === 0) {
+            return [];
+        }
+        // Extract hashes from results (zpopmax returns [member, score, member, score, ...])
+        const userOpHashes = [];
+        for (let i = 0; i < results.length; i += 2) {
+            userOpHashes.push(results[i]);
+        }
+        // Remove all userOps in batch
+        return await this.remove(userOpHashes);
+    }
+    async getQueuedUserOps(userOp) {
+        const [, nonceSequence] = getNonceKeyAndSequence(userOp.nonce);
+        const senderNonceQueue = this.getSenderNonceQueue(userOp);
+        // Get all userOpHashes with nonce sequence lower than the input
+        // ZRANGEBYSCORE returns elements with scores between min and max
+        // We want scores from 0 to (nonceSequence - 1)
+        const userOpHashes = await this.redis.zrangebyscore(senderNonceQueue, 0, Number(nonceSequence) - 1);
+        if (userOpHashes.length === 0)
+            return [];
+        // Fetch serialized data for each hash
+        const pipeline = this.redis.pipeline();
+        for (const hash of userOpHashes) {
+            pipeline.hget(this.userOpHashMap, hash);
+        }
+        const results = await pipeline.exec();
+        // Deserialize and extract userOps
+        return (results || [])
+            .map((result) => result?.[1])
+            .filter((serialized) => serialized !== null)
+            .map((serialized) => deserialize(serialized).userOp);
+    }
+    // These methods aren't implemented
+    dumpLocal() {
+        return Promise.resolve([]); // We can't dump from redis as the latency is too high
+    }
+    clear() {
+        throw new Error("Not implemented: clear");
+    }
+    // Skip limit checks when using Redis
+    validateQueuedLimit() {
+        return true;
+    }
+    validateParallelLimit() {
+        return true;
+    }
+}
+export const createRedisOutstandingQueue = ({ config, entryPoint, redisEndpoint, logger }) => {
+    return new RedisOutstandingQueue({
+        config,
+        entryPoint,
+        redisEndpoint,
+        logger
+    });
+};
+//# sourceMappingURL=redis.js.map

package/esm/store/outstanding/redis.js.map

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

package/esm/store/outstanding/types.d.ts

@@ -0,0 +1,18 @@
+import type { HexData32, UserOpInfo, UserOperation } from "../../types/index.js";
+export type ConflictingOutstandingType = {
+    reason: "conflicting_nonce" | "conflicting_deployment";
+    userOpInfo: UserOpInfo;
+} | undefined;
+export interface OutstandingStore {
+    contains(userOpHash: HexData32): Promise<boolean>;
+    pop(count: number): Promise<UserOpInfo[]>;
+    popConflicting(userOp: UserOperation): Promise<ConflictingOutstandingType>;
+    add(userOpInfos: UserOpInfo[]): Promise<void>;
+    remove(userOpHash: HexData32[]): Promise<UserOpInfo[]>;
+    getQueuedUserOps(userOp: UserOperation): Promise<UserOperation[]>;
+    dumpLocal(): Promise<UserOpInfo[]>;
+    clear(): Promise<void>;
+    validateQueuedLimit(userOp: UserOperation): boolean;
+    validateParallelLimit(userOp: UserOperation): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/store/outstanding/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/store/outstanding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../store/outstanding/types.ts"],"names":[],"mappings":""}

package/esm/store/processing/index.d.ts

@@ -0,0 +1,11 @@
+import type { Address } from "viem";
+import type { AltoConfig } from "../../createConfig.js";
+import { type ProcessingStore } from "../index.js";
+export declare function createProcessingStore({ config, entryPoint }: {
+    config: AltoConfig;
+    entryPoint: Address;
+}): ProcessingStore;
+export * from "./types.js";
+export * from "./memory.js";
+export * from "./redis.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/store/processing/index.js

@@ -0,0 +1,17 @@
+import { InMemoryProcessingStore, RedisProcessingStore } from "../index.js";
+// Holds all userOps that have been removed from outstanding pool and are being processed.
+// UserOps are are removed from this store when they have successfully landed onchain or when they are cancelled.
+export function createProcessingStore({ config, entryPoint }) {
+    if (config.enableHorizontalScaling && config.redisEndpoint) {
+        return new RedisProcessingStore({
+            config,
+            entryPoint,
+            redisEndpoint: config.redisEndpoint
+        });
+    }
+    return new InMemoryProcessingStore();
+}
+export * from "./types.js";
+export * from "./memory.js";
+export * from "./redis.js";
+//# sourceMappingURL=index.js.map

package/esm/store/processing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../store/processing/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACH,uBAAuB,EAEvB,oBAAoB,EACvB,MAAM,aAAa,CAAA;AAEpB,0FAA0F;AAC1F,iHAAiH;AACjH,MAAM,UAAU,qBAAqB,CAAC,EAClC,MAAM,EACN,UAAU,EAIb;IACG,IAAI,MAAM,CAAC,uBAAuB,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzD,OAAO,IAAI,oBAAoB,CAAC;YAC5B,MAAM;YACN,UAAU;YACV,aAAa,EAAE,MAAM,CAAC,aAAa;SACtC,CAAC,CAAA;IACN,CAAC;IACD,OAAO,IAAI,uBAAuB,EAAE,CAAA;AACxC,CAAC;AAED,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}

package/esm/store/processing/memory.d.ts

@@ -0,0 +1,14 @@
+import type { UserOpInfo, UserOperation } from "../../types/index.js";
+import type { Hex } from "viem";
+import type { ProcessingStore } from "./types.js";
+export declare class InMemoryProcessingStore implements ProcessingStore {
+    private processingUserOpsSet;
+    private processingSenderNonceSet;
+    private processingDeploymentSet;
+    private encodeSenderNonceId;
+    addProcessing(userOpInfo: UserOpInfo): Promise<void>;
+    removeProcessing(userOpInfo: UserOpInfo): Promise<void>;
+    isProcessing(userOpHash: Hex): Promise<boolean>;
+    wouldConflict(userOp: UserOperation): Promise<"nonce_conflict" | "deployment_conflict" | undefined>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/esm/store/processing/memory.js

@@ -0,0 +1,46 @@
+import { isDeployment } from "../../utils/index.js";
+export class InMemoryProcessingStore {
+    // Use Sets for boolean membership tracking (matching Redis store)
+    processingUserOpsSet = new Set();
+    processingSenderNonceSet = new Set();
+    processingDeploymentSet = new Set();
+    encodeSenderNonceId(sender, nonce) {
+        return `${sender}:${nonce}`;
+    }
+    async addProcessing(userOpInfo) {
+        const { userOpHash, userOp } = userOpInfo;
+        const isDeploymentOp = isDeployment(userOp);
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Add to processing sets
+        this.processingUserOpsSet.add(userOpHash);
+        this.processingSenderNonceSet.add(senderNonceId);
+        if (isDeploymentOp) {
+            this.processingDeploymentSet.add(userOp.sender);
+        }
+    }
+    async removeProcessing(userOpInfo) {
+        const { userOpHash, userOp } = userOpInfo;
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Remove from all sets
+        this.processingUserOpsSet.delete(userOpHash);
+        this.processingSenderNonceSet.delete(senderNonceId);
+        this.processingDeploymentSet.delete(userOp.sender);
+    }
+    async isProcessing(userOpHash) {
+        return this.processingUserOpsSet.has(userOpHash);
+    }
+    async wouldConflict(userOp) {
+        const isDeploymentOp = isDeployment(userOp);
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Check deployment conflict first
+        if (isDeploymentOp && this.processingDeploymentSet.has(userOp.sender)) {
+            return "deployment_conflict";
+        }
+        // Check nonce conflict
+        if (this.processingSenderNonceSet.has(senderNonceId)) {
+            return "nonce_conflict";
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=memory.js.map

package/esm/store/processing/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../store/processing/memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C,MAAM,OAAO,uBAAuB;IAChC,kEAAkE;IAC1D,oBAAoB,GAAG,IAAI,GAAG,EAAO,CAAA;IACrC,wBAAwB,GAAG,IAAI,GAAG,EAAU,CAAA;IAC5C,uBAAuB,GAAG,IAAI,GAAG,EAAW,CAAA;IAE5C,mBAAmB,CAAC,MAAe,EAAE,KAAa;QACtD,OAAO,GAAG,MAAM,IAAI,KAAK,EAAE,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,UAAsB;QACtC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;QACzC,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAC1C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CACf,CAAA;QAED,yBAAyB;QACzB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACzC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAEhD,IAAI,cAAc,EAAE,CAAC;YACjB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACnD,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAsB;QACzC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAC1C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CACf,CAAA;QAED,uBAAuB;QACvB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAC5C,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;QACnD,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACtD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAe;QAC9B,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IACpD,CAAC;IAED,KAAK,CAAC,aAAa,CACf,MAAqB;QAErB,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,CAAA;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,CAC1C,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CACf,CAAA;QAED,kCAAkC;QAClC,IAAI,cAAc,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACpE,OAAO,qBAAqB,CAAA;QAChC,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACnD,OAAO,gBAAgB,CAAA;QAC3B,CAAC;QAED,OAAO,SAAS,CAAA;IACpB,CAAC;CACJ"}

package/esm/store/processing/redis.d.ts

@@ -0,0 +1,21 @@
+import type { ProcessingStore } from "../index.js";
+import type { UserOpInfo, UserOperation } from "../../types/index.js";
+import type { Address, Hex } from "viem";
+import type { AltoConfig } from "../../createConfig.js";
+export declare class RedisProcessingStore implements ProcessingStore {
+    private redis;
+    private processingUserOpsSet;
+    private processingSenderNonceSet;
+    private processingDeploymentSet;
+    private encodeSenderNonceId;
+    constructor({ config, entryPoint, redisEndpoint }: {
+        config: AltoConfig;
+        entryPoint: Address;
+        redisEndpoint: string;
+    });
+    addProcessing(userOpInfo: UserOpInfo): Promise<void>;
+    removeProcessing(userOpInfo: UserOpInfo): Promise<void>;
+    isProcessing(userOpHash: Hex): Promise<boolean>;
+    wouldConflict(userOp: UserOperation): Promise<"nonce_conflict" | "deployment_conflict" | undefined>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/esm/store/processing/redis.js

@@ -0,0 +1,69 @@
+import { isDeployment } from "../../utils/index.js";
+import { Redis } from "ioredis";
+export class RedisProcessingStore {
+    redis;
+    processingUserOpsSet; // set of userOpHashes being processed
+    processingSenderNonceSet; // set of "sender:nonce" being processed
+    processingDeploymentSet; // set of senders with deployments being processed
+    encodeSenderNonceId(sender, nonce) {
+        return `${sender}:${nonce}`;
+    }
+    constructor({ config, entryPoint, redisEndpoint }) {
+        this.redis = new Redis(redisEndpoint);
+        const redisPrefix = `${config.redisKeyPrefix}:${config.chainId}:${entryPoint}:processing`;
+        this.processingUserOpsSet = `${redisPrefix}:userOps`;
+        this.processingSenderNonceSet = `${redisPrefix}:senderNonce`;
+        this.processingDeploymentSet = `${redisPrefix}:deployment`;
+    }
+    async addProcessing(userOpInfo) {
+        const { userOpHash, userOp } = userOpInfo;
+        const isDeploymentOp = isDeployment(userOp);
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Use MULTI for atomic operation in single round trip
+        const multi = this.redis.multi();
+        multi.sadd(this.processingUserOpsSet, userOpHash);
+        multi.sadd(this.processingSenderNonceSet, senderNonceId);
+        if (isDeploymentOp) {
+            multi.sadd(this.processingDeploymentSet, userOp.sender);
+        }
+        await multi.exec();
+    }
+    async removeProcessing(userOpInfo) {
+        const { userOpHash, userOp } = userOpInfo;
+        const isDeploymentOp = isDeployment(userOp);
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Use MULTI for atomic removal in single round trip
+        const multi = this.redis.multi();
+        multi.srem(this.processingUserOpsSet, userOpHash);
+        multi.srem(this.processingSenderNonceSet, senderNonceId);
+        if (isDeploymentOp) {
+            multi.srem(this.processingDeploymentSet, userOp.sender);
+        }
+        await multi.exec();
+    }
+    async isProcessing(userOpHash) {
+        const isMember = await this.redis.sismember(this.processingUserOpsSet, userOpHash);
+        return isMember === 1;
+    }
+    async wouldConflict(userOp) {
+        const senderNonceId = this.encodeSenderNonceId(userOp.sender, userOp.nonce);
+        // Use MULTI for atomic read in single round trip
+        const multi = this.redis.multi();
+        multi.sismember(this.processingDeploymentSet, userOp.sender);
+        multi.sismember(this.processingSenderNonceSet, senderNonceId);
+        const results = await multi.exec();
+        if (!results)
+            return undefined;
+        const [deploymentResult, nonceResult] = results;
+        const hasDeployment = deploymentResult?.[1] === 1;
+        const hasNonce = nonceResult?.[1] === 1;
+        if (hasDeployment) {
+            return "deployment_conflict";
+        }
+        if (hasNonce) {
+            return "nonce_conflict";
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=redis.js.map

package/esm/store/processing/redis.js.map

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

package/esm/store/processing/types.d.ts

@@ -0,0 +1,9 @@
+import type { UserOpInfo, UserOperation } from "../../types/index.js";
+import type { Hex } from "viem";
+export interface ProcessingStore {
+    addProcessing(userOp: UserOpInfo): Promise<void>;
+    removeProcessing(userOp: UserOpInfo): Promise<void>;
+    isProcessing(userOpHash: Hex): Promise<boolean>;
+    wouldConflict(userOp: UserOperation): Promise<"nonce_conflict" | "deployment_conflict" | undefined>;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/store/processing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/store/processing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../store/processing/types.ts"],"names":[],"mappings":""}

package/esm/store/types.d.ts

@@ -0,0 +1,49 @@
+import type { Address } from "abitype";
+import type { HexData32, UserOpInfo, UserOperation } from "../types/schemas.js";
+import type { ConflictingOutstandingType } from "./outstanding/index.js";
+export type StoreType = "outstanding" | "processing";
+export type ValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    reason: string;
+};
+export type EntryPointUserOpInfoParam = {
+    entryPoint: Address;
+    userOpInfo: UserOpInfo;
+};
+export type EntryPointUserOpInfosParam = {
+    entryPoint: Address;
+    userOpInfos: UserOpInfo[];
+};
+export type EntryPointUserOpHashParam = {
+    entryPoint: Address;
+    userOpHash: HexData32;
+};
+export type MempoolStore = {
+    popOutstanding: (entryPoint: Address, count: number) => Promise<UserOpInfo[]>;
+    addOutstanding: (args: EntryPointUserOpInfosParam) => Promise<void>;
+    removeOutstanding: (args: EntryPointUserOpHashParam) => Promise<void>;
+    dumpOutstanding: (entryPoint: Address) => Promise<UserOpInfo[]>;
+    addProcessing: (args: EntryPointUserOpInfoParam) => Promise<void>;
+    removeProcessing: (args: EntryPointUserOpInfoParam) => Promise<void>;
+    checkDuplicatesAndConflicts: (args: {
+        entryPoint: Address;
+        userOp: UserOperation;
+        userOpHash: HexData32;
+    }) => Promise<ValidationResult>;
+    popConflictingOustanding: (args: {
+        entryPoint: Address;
+        userOp: UserOperation;
+    }) => Promise<ConflictingOutstandingType>;
+    validateSenderLimits: (args: {
+        entryPoint: Address;
+        userOp: UserOperation;
+    }) => Promise<ValidationResult>;
+    getQueuedOutstandingUserOps: (args: {
+        userOp: UserOperation;
+        entryPoint: Address;
+    }) => Promise<UserOperation[]>;
+    clearOutstanding: (entryPoint: Address) => Promise<void>;
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/store/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/esm/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../store/types.ts"],"names":[],"mappings":""}

package/esm/utils/minMaxQueue/createRedisMinMaxQueue.d.ts

@@ -1,8 +1,29 @@
+/**
+ * MinMaxQueue implementation in Redis using a single sorted set
+ *
+ * ## Data Structure
+ * - Uses a Redis sorted set where:
+ *   - Score: timestamp when value was added (seconds since epoch)
+ *   - Member: the actual bigint value (stored as string)
+ *
+ * ## Flow
+ * 1. **Adding values**: New values are added/updated with current timestamp as score
+ * 2. **Reading values**: Queries filter out expired entries based on timestamp
+ * 3. **Cleanup**: Background process runs every minute to remove expired entries
+ *
+ * ## Optimization Strategy
+ * - Lazy cleanup: expired entries filtered on read, bulk removed by background process (removing is expensive)
+ *
+ * ## TTL Management
+ * - Entries expire based on `queueValidity` (configured via `gasPriceExpiry`)
+ * - Background cleanup prevents unbounded growth
+ * - Read operations ignore expired entries without removing them
+ */
 import type { MinMaxQueue } from "./index.js";
 import type { AltoConfig } from "../../createConfig.js";
-export declare const createRedisMinMaxQueue: ({ config, keyPrefix, redisEndpoint }: {
+export declare const createRedisMinMaxQueue: ({ config, queueName, redisEndpoint }: {
     config: AltoConfig;
-    keyPrefix: string;
+    queueName: string;
     redisEndpoint: string;
 }) => MinMaxQueue;
 //# sourceMappingURL=createRedisMinMaxQueue.d.ts.map