@pimlico/alto 0.0.18 → 0.0.20

package/esm/store/processing/memory.js

@@ -0,0 +1,58 @@
+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();
+    processingEip7702AuthSet = 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);
+        }
+        if (userOp.eip7702Auth) {
+            this.processingEip7702AuthSet.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);
+        if (userOp.eip7702Auth) {
+            this.processingEip7702AuthSet.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 "conflicting_deployment";
+        }
+        // Check EIP-7702 auth conflict
+        if (userOp.eip7702Auth &&
+            this.processingEip7702AuthSet.has(userOp.sender)) {
+            return "conflicting_7702_auth";
+        }
+        // Check nonce conflict
+        if (this.processingSenderNonceSet.has(senderNonceId)) {
+            return "conflicting_nonce";
+        }
+        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":"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"}

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

@@ -0,0 +1,23 @@
+import type { UserOpInfo, UserOperation } from "../../types/index.js";
+import type { Address, Hex } from "viem";
+import type { AltoConfig } from "../../createConfig.js";
+import type { ConflictType } from "../types.js";
+import type { ProcessingStore } from "./types.js";
+export declare class RedisProcessingStore implements ProcessingStore {
+    private readonly redis;
+    private readonly processingUserOpsSet;
+    private readonly processingSenderNonceSet;
+    private readonly processingDeploymentSet;
+    private readonly processingEip7702AuthSet;
+    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<ConflictType | undefined>;
+}
+//# sourceMappingURL=redis.d.ts.map

package/esm/store/processing/redis.js

@@ -0,0 +1,85 @@
+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
+    processingEip7702AuthSet; // set of senders with eip7702Auth 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`;
+        this.processingEip7702AuthSet = `${redisPrefix}:eip7702Auth`;
+    }
+    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);
+        }
+        if (userOp.eip7702Auth) {
+            multi.sadd(this.processingEip7702AuthSet, 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);
+        }
+        if (userOp.eip7702Auth) {
+            multi.srem(this.processingEip7702AuthSet, 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.processingEip7702AuthSet, userOp.sender);
+        multi.sismember(this.processingSenderNonceSet, senderNonceId);
+        const results = await multi.exec();
+        if (!results)
+            return undefined;
+        const [deploymentResult, eip7702AuthResult, nonceResult] = results;
+        const hasDeployment = deploymentResult?.[1] === 1;
+        const hasEip7702Auth = eip7702AuthResult?.[1] === 1;
+        const hasNonce = nonceResult?.[1] === 1;
+        // Check deployment conflict
+        if (isDeployment(userOp) && hasDeployment) {
+            return "conflicting_deployment";
+        }
+        // Check EIP-7702 auth conflict
+        if (userOp.eip7702Auth && hasEip7702Auth) {
+            return "conflicting_7702_auth";
+        }
+        // Check nonce conflict
+        if (hasNonce) {
+            return "conflicting_nonce";
+        }
+        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,10 @@
+import type { UserOpInfo, UserOperation } from "../../types/index.js";
+import type { Hex } from "viem";
+import type { ConflictType } from "../types.js";
+export interface ProcessingStore {
+    addProcessing(userOp: UserOpInfo): Promise<void>;
+    removeProcessing(userOp: UserOpInfo): Promise<void>;
+    isProcessing(userOpHash: Hex): Promise<boolean>;
+    wouldConflict(userOp: UserOperation): Promise<ConflictType | 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,50 @@
+import type { Address } from "abitype";
+import type { HexData32, UserOpInfo, UserOperation } from "../types/schemas.js";
+import type { ConflictingOutstandingType } from "./outstanding/index.js";
+export type ConflictType = "conflicting_nonce" | "conflicting_deployment" | "conflicting_7702_auth";
+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":""}