@waku/rln 0.1.5-053bb95.0 → 0.1.5-197ba46.0

package/dist/contract/rln_base_contract.d.ts

@@ -1,10 +1,19 @@
 import { ethers } from "ethers";
 import { IdentityCredential } from "../identity.js";
 import { DecryptedCredentials } from "../keystore/types.js";
-import { Member, MembershipInfo, RLNContractInitOptions } from "./types.js";
+import { CustomQueryOptions, FetchMembersOptions, Member, MembershipInfo, RLNContractInitOptions } from "./types.js";
 export declare class RLNBaseContract {
     contract: ethers.Contract;
+    private deployBlock;
     private rateLimit;
+    protected _members: Map<number, Member>;
+    private _membersFilter;
+    private _membershipErasedFilter;
+    private _membersExpiredFilter;
+    /**
+     * Constructor for RLNBaseContract.
+     * Allows injecting a mocked contract for testing purposes.
+     */
     constructor(options: RLNContractInitOptions);
     /**
      * Gets the current rate limit for this contract instance
@@ -48,26 +57,19 @@ export declare class RLNBaseContract {
      * @param newRateLimit The new rate limit to use
      */
     setRateLimit(newRateLimit: number): Promise<void>;
-    /**
-     * Gets all members in the given range
-     * @param startIndex Start index (inclusive)
-     * @param endIndex End index (exclusive)
-     */
-    getMembersInRange(startIndex: number, endIndex: number): Promise<Member[]>;
-    /**
-     * Gets all current members
-     */
-    getAllMembers(): Promise<Member[]>;
-    /**
-     * Gets the member index if it exists, or null if it doesn't
-     * Throws only on actual errors (invalid input, network issues, etc)
-     */
-    private getMemberIndex;
-    getMembershipInfo(idCommitment: string): Promise<MembershipInfo>;
-    extendMembership(idCommitment: string): Promise<void>;
-    eraseMembership(idCommitment: string, eraseFromMembershipSet?: boolean): Promise<void>;
-    registerMembership(idCommitment: string, rateLimit?: number): Promise<void>;
-    withdraw(token: string, holder: string): Promise<void>;
+    get members(): Member[];
+    fetchMembers(options?: FetchMembersOptions): Promise<void>;
+    static queryFilter(contract: ethers.Contract, options: CustomQueryOptions): Promise<ethers.Event[]>;
+    processEvents(events: ethers.Event[]): void;
+    static splitToChunks(from: number, to: number, step: number): Array<[number, number]>;
+    static takeN<T>(array: T[], size: number): Iterable<T[]>;
+    static ignoreErrors<T>(promise: Promise<T>, defaultValue: T): Promise<T>;
+    subscribeToMembers(): void;
+    getMembershipInfo(idCommitmentBigInt: bigint): Promise<MembershipInfo | undefined>;
+    extendMembership(idCommitmentBigInt: bigint): Promise<ethers.ContractTransaction>;
+    eraseMembership(idCommitmentBigInt: bigint, eraseFromMembershipSet?: boolean): Promise<ethers.ContractTransaction>;
+    registerMembership(idCommitmentBigInt: bigint, rateLimit?: number): Promise<ethers.ContractTransaction>;
+    withdraw(token: string, from: string): Promise<void>;
     registerWithIdentity(identity: IdentityCredential): Promise<DecryptedCredentials | undefined>;
     registerWithPermitAndErase(identity: IdentityCredential, permit: {
         owner: string;
@@ -81,8 +83,8 @@ export declare class RLNBaseContract {
      * @throws Error if the rate limit is outside the allowed range
      */
     private validateRateLimit;
-    /**
-     * Helper to confirm a transaction and extract event data
-     */
-    private confirmTransaction;
+    private get membersFilter();
+    private get membershipErasedFilter();
+    private get membersExpiredFilter();
+    private getMemberIndex;
 }

package/dist/contract/rln_base_contract.js

@@ -2,17 +2,49 @@ import { Logger } from "@waku/utils";
 import { ethers } from "ethers";
 import { RLN_ABI } from "./abi.js";
 import { DEFAULT_RATE_LIMIT, RATE_LIMIT_PARAMS } from "./constants.js";
-import { InvalidMembershipError, InvalidRateLimitError, MembershipExistsError, MembershipNotFoundError, RateLimitExceededError, RLNContractError, TransactionError } from "./errors.js";
 import { MembershipState } from "./types.js";
 const log = new Logger("waku:rln:contract:base");
 export class RLNBaseContract {
     contract;
+    deployBlock;
     rateLimit;
+    _members = new Map();
+    _membersFilter;
+    _membershipErasedFilter;
+    _membersExpiredFilter;
+    /**
+     * Constructor for RLNBaseContract.
+     * Allows injecting a mocked contract for testing purposes.
+     */
     constructor(options) {
         const { address, signer, rateLimit = DEFAULT_RATE_LIMIT, contract } = options;
-        this.validateRateLimit(rateLimit);
+        log.info("Initializing RLNBaseContract", { address, rateLimit });
         this.contract = contract || new ethers.Contract(address, RLN_ABI, signer);
         this.rateLimit = rateLimit;
+        try {
+            log.info("Setting up event filters");
+            // Initialize event filters
+            this._membersFilter = this.contract.filters.MembershipRegistered();
+            this._membershipErasedFilter = this.contract.filters.MembershipErased();
+            this._membersExpiredFilter = this.contract.filters.MembershipExpired();
+            log.info("Event filters initialized successfully");
+        }
+        catch (error) {
+            log.error("Failed to initialize event filters", { error });
+            throw new Error("Failed to initialize event filters: " + error.message);
+        }
+        // Initialize members and subscriptions
+        this.fetchMembers()
+            .then(() => {
+            this.subscribeToMembers();
+        })
+            .catch((error) => {
+            log.error("Failed to initialize members", { error });
+        });
+        // Validate rate limit asynchronously
+        this.validateRateLimit(rateLimit).catch((error) => {
+            log.error("Failed to validate initial rate limit", { error });
+        });
     }
     /**
      * Gets the current rate limit for this contract instance
@@ -80,221 +112,297 @@ export class RLNBaseContract {
      * @param newRateLimit The new rate limit to use
      */
     async setRateLimit(newRateLimit) {
-        this.validateRateLimit(newRateLimit);
+        await this.validateRateLimit(newRateLimit);
         this.rateLimit = newRateLimit;
     }
-    /**
-     * Gets all members in the given range
-     * @param startIndex Start index (inclusive)
-     * @param endIndex End index (exclusive)
-     */
-    async getMembersInRange(startIndex, endIndex) {
-        try {
-            // Get all commitments in one call
-            const idCommitments = await this.contract.getRateCommitmentsInRangeBoundsInclusive(startIndex, endIndex - 1 // -1 because getRateCommitmentsInRangeBoundsInclusive is inclusive
-            );
-            // Get membership info for each commitment in a single batch
-            const membershipPromises = idCommitments.map((idCommitment) => this.contract
-                .memberships(idCommitment)
-                .then((info) => ({
-                idCommitment: idCommitment.toString(),
-                index: ethers.BigNumber.from(info.index)
-            }))
-                .catch(() => null) // Skip invalid members
-            );
-            // Wait for all promises to resolve
-            const members = (await Promise.all(membershipPromises)).filter((m) => m !== null);
-            return members;
+    get members() {
+        const sortedMembers = Array.from(this._members.values()).sort((left, right) => left.index.toNumber() - right.index.toNumber());
+        return sortedMembers;
+    }
+    async fetchMembers(options = {}) {
+        const registeredMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
+            fromBlock: this.deployBlock,
+            ...options,
+            membersFilter: this.membersFilter
+        });
+        const removedMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
+            fromBlock: this.deployBlock,
+            ...options,
+            membersFilter: this.membershipErasedFilter
+        });
+        const expiredMemberEvents = await RLNBaseContract.queryFilter(this.contract, {
+            fromBlock: this.deployBlock,
+            ...options,
+            membersFilter: this.membersExpiredFilter
+        });
+        const events = [
+            ...registeredMemberEvents,
+            ...removedMemberEvents,
+            ...expiredMemberEvents
+        ];
+        this.processEvents(events);
+    }
+    static async queryFilter(contract, options) {
+        const FETCH_CHUNK = 5;
+        const BLOCK_RANGE = 3000;
+        const { fromBlock, membersFilter, fetchRange = BLOCK_RANGE, fetchChunks = FETCH_CHUNK } = options;
+        if (fromBlock === undefined) {
+            return contract.queryFilter(membersFilter);
         }
-        catch (error) {
-            if (error instanceof Error &&
-                error.message.includes("InvalidPaginationQuery")) {
-                throw new RLNContractError(`Invalid pagination range: start=${startIndex}, end=${endIndex}`);
+        if (!contract.provider) {
+            throw Error("No provider found on the contract.");
+        }
+        const toBlock = await contract.provider.getBlockNumber();
+        if (toBlock - fromBlock < fetchRange) {
+            return contract.queryFilter(membersFilter, fromBlock, toBlock);
+        }
+        const events = [];
+        const chunks = RLNBaseContract.splitToChunks(fromBlock, toBlock, fetchRange);
+        for (const portion of RLNBaseContract.takeN(chunks, fetchChunks)) {
+            const promises = portion.map(([left, right]) => RLNBaseContract.ignoreErrors(contract.queryFilter(membersFilter, left, right), []));
+            const fetchedEvents = await Promise.all(promises);
+            events.push(fetchedEvents.flatMap((v) => v));
+        }
+        return events.flatMap((v) => v);
+    }
+    processEvents(events) {
+        const toRemoveTable = new Map();
+        const toInsertTable = new Map();
+        events.forEach((evt) => {
+            if (!evt.args) {
+                return;
+            }
+            if (evt.event === "MembershipErased" ||
+                evt.event === "MembershipExpired") {
+                let index = evt.args.index;
+                if (!index) {
+                    return;
+                }
+                if (typeof index === "number" || typeof index === "string") {
+                    index = ethers.BigNumber.from(index);
+                }
+                const toRemoveVal = toRemoveTable.get(evt.blockNumber);
+                if (toRemoveVal != undefined) {
+                    toRemoveVal.push(index.toNumber());
+                    toRemoveTable.set(evt.blockNumber, toRemoveVal);
+                }
+                else {
+                    toRemoveTable.set(evt.blockNumber, [index.toNumber()]);
+                }
+            }
+            else if (evt.event === "MembershipRegistered") {
+                let eventsPerBlock = toInsertTable.get(evt.blockNumber);
+                if (eventsPerBlock == undefined) {
+                    eventsPerBlock = [];
+                }
+                eventsPerBlock.push(evt);
+                toInsertTable.set(evt.blockNumber, eventsPerBlock);
             }
-            throw error;
+        });
+    }
+    static splitToChunks(from, to, step) {
+        const chunks = [];
+        let left = from;
+        while (left < to) {
+            const right = left + step < to ? left + step : to;
+            chunks.push([left, right]);
+            left = right;
         }
+        return chunks;
     }
-    /**
-     * Gets all current members
-     */
-    async getAllMembers() {
-        const nextIndex = (await this.contract.nextFreeIndex()).toNumber();
-        return this.getMembersInRange(0, nextIndex);
+    static *takeN(array, size) {
+        let start = 0;
+        while (start < array.length) {
+            const portion = array.slice(start, start + size);
+            yield portion;
+            start += size;
+        }
     }
-    /**
-     * Gets the member index if it exists, or null if it doesn't
-     * Throws only on actual errors (invalid input, network issues, etc)
-     */
-    async getMemberIndex(idCommitment) {
+    static async ignoreErrors(promise, defaultValue) {
         try {
-            const isValid = await this.contract.isInMembershipSet(idCommitment);
-            if (!isValid) {
-                return null;
-            }
-            const membershipInfo = await this.contract.memberships(idCommitment);
-            return ethers.BigNumber.from(membershipInfo.index);
+            return await promise;
         }
-        catch (error) {
-            log.error(`Error getting member index: ${error.message}`);
-            throw new InvalidMembershipError(idCommitment);
+        catch (err) {
+            if (err instanceof Error) {
+                log.info(`Ignoring an error during query: ${err.message}`);
+            }
+            else {
+                log.info(`Ignoring an unknown error during query`);
+            }
+            return defaultValue;
         }
     }
-    async getMembershipInfo(idCommitment) {
+    subscribeToMembers() {
+        this.contract.on(this.membersFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
+            this.processEvents([event]);
+        });
+        this.contract.on(this.membershipErasedFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
+            this.processEvents([event]);
+        });
+        this.contract.on(this.membersExpiredFilter, (_idCommitment, _membershipRateLimit, _index, event) => {
+            this.processEvents([event]);
+        });
+    }
+    async getMembershipInfo(idCommitmentBigInt) {
         try {
-            const [startBlock, endBlock, rateLimit] = await this.contract.getMembershipInfo(idCommitment);
+            const membershipData = await this.contract.memberships(idCommitmentBigInt);
             const currentBlock = await this.contract.provider.getBlockNumber();
+            const [depositAmount, activeDuration, gracePeriodStartTimestamp, gracePeriodDuration, rateLimit, index, holder, token] = membershipData;
+            const gracePeriodEnd = gracePeriodStartTimestamp.add(gracePeriodDuration);
             let state;
-            if (currentBlock < startBlock) {
+            if (currentBlock < gracePeriodStartTimestamp.toNumber()) {
                 state = MembershipState.Active;
             }
-            else if (currentBlock < endBlock) {
+            else if (currentBlock < gracePeriodEnd.toNumber()) {
                 state = MembershipState.GracePeriod;
             }
             else {
                 state = MembershipState.Expired;
             }
-            const index = await this.getMemberIndex(idCommitment);
-            if (index === null) {
-                throw new MembershipNotFoundError(idCommitment);
-            }
             return {
                 index,
-                idCommitment,
-                rateLimit: rateLimit.toNumber(),
-                startBlock: startBlock.toNumber(),
-                endBlock: endBlock.toNumber(),
-                state
+                idCommitment: idCommitmentBigInt.toString(),
+                rateLimit: Number(rateLimit),
+                startBlock: gracePeriodStartTimestamp.toNumber(),
+                endBlock: gracePeriodEnd.toNumber(),
+                state,
+                depositAmount,
+                activeDuration,
+                gracePeriodDuration,
+                holder,
+                token
             };
         }
         catch (error) {
-            if (error instanceof RLNContractError) {
-                throw error;
-            }
-            log.error(`Error getting membership info: ${error.message}`);
-            throw new InvalidMembershipError(idCommitment);
+            log.error("Error in getMembershipInfo:", error);
+            return undefined;
         }
     }
-    async extendMembership(idCommitment) {
-        const tx = await this.contract.extendMemberships([idCommitment]);
-        await this.confirmTransaction(tx, "MembershipExtended", (event) => ({
-            idCommitment: event.args.idCommitment,
-            endBlock: event.args.endBlock
-        }));
+    async extendMembership(idCommitmentBigInt) {
+        const tx = await this.contract.extendMemberships([idCommitmentBigInt]);
+        await tx.wait();
+        return tx;
     }
-    async eraseMembership(idCommitment, eraseFromMembershipSet = true) {
-        const tx = await this.contract.eraseMemberships([idCommitment], eraseFromMembershipSet);
-        await this.confirmTransaction(tx, "MembershipErased", (event) => ({
-            idCommitment: event.args.idCommitment,
-            index: event.args.index
-        }));
+    async eraseMembership(idCommitmentBigInt, eraseFromMembershipSet = true) {
+        const tx = await this.contract.functions.eraseMemberships([idCommitmentBigInt], eraseFromMembershipSet);
+        await tx.wait();
+        return tx;
     }
-    async registerMembership(idCommitment, rateLimit = DEFAULT_RATE_LIMIT) {
+    async registerMembership(idCommitmentBigInt, rateLimit = DEFAULT_RATE_LIMIT) {
         if (rateLimit < RATE_LIMIT_PARAMS.MIN_RATE ||
             rateLimit > RATE_LIMIT_PARAMS.MAX_RATE) {
             throw new Error(`Rate limit must be between ${RATE_LIMIT_PARAMS.MIN_RATE} and ${RATE_LIMIT_PARAMS.MAX_RATE}`);
         }
-        const tx = await this.contract.register(idCommitment, rateLimit, []);
-        await this.confirmTransaction(tx, "MembershipRegistered", (event) => ({
-            idCommitment: event.args.idCommitment,
-            membershipRateLimit: event.args.membershipRateLimit,
-            index: event.args.index
-        }));
+        return this.contract.register(idCommitmentBigInt, rateLimit, []);
     }
-    async withdraw(token, holder) {
+    async withdraw(token, from) {
         try {
-            const tx = await this.contract.withdraw(token, { from: holder });
-            await this.confirmTransaction(tx, "TokenWithdrawn", (event) => ({
-                token: event.args.token,
-                holder: event.args.holder,
-                amount: event.args.amount
-            }));
+            const tx = await this.contract.withdraw(token, from);
+            await tx.wait();
         }
         catch (error) {
             log.error(`Error in withdraw: ${error.message}`);
-            throw error;
         }
     }
     async registerWithIdentity(identity) {
         try {
             log.info(`Registering identity with rate limit: ${this.rateLimit} messages/epoch`);
             // Check if the ID commitment is already registered
-            const existingIndex = await this.getMemberIndex(identity.IDCommitmentBigInt.toString());
-            if (existingIndex !== null) {
-                throw new MembershipExistsError(identity.IDCommitmentBigInt.toString(), existingIndex.toString());
+            const existingIndex = await this.getMemberIndex(identity.IDCommitmentBigInt);
+            if (existingIndex) {
+                throw new Error(`ID commitment is already registered with index ${existingIndex}`);
             }
             // Check if there's enough remaining rate limit
             const remainingRateLimit = await this.getRemainingTotalRateLimit();
             if (remainingRateLimit < this.rateLimit) {
-                throw new RateLimitExceededError(this.rateLimit, remainingRateLimit);
+                throw new Error(`Not enough remaining rate limit. Requested: ${this.rateLimit}, Available: ${remainingRateLimit}`);
             }
             const estimatedGas = await this.contract.estimateGas.register(identity.IDCommitmentBigInt, this.rateLimit, []);
             const gasLimit = estimatedGas.add(10000);
-            const tx = await this.contract.register(identity.IDCommitmentBigInt, this.rateLimit, [], { gasLimit });
-            const decodedData = await this.confirmTransaction(tx, "MembershipRegistered", (event) => ({
-                idCommitment: event.args.idCommitment,
-                membershipRateLimit: event.args.membershipRateLimit,
-                index: event.args.index
-            }));
+            const txRegisterResponse = await this.contract.register(identity.IDCommitmentBigInt, this.rateLimit, [], { gasLimit });
+            const txRegisterReceipt = await txRegisterResponse.wait();
+            if (txRegisterReceipt.status === 0) {
+                throw new Error("Transaction failed on-chain");
+            }
+            const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
+            if (!memberRegistered || !memberRegistered.args) {
+                log.error("Failed to register membership: No MembershipRegistered event found");
+                return undefined;
+            }
+            const decodedData = {
+                idCommitment: memberRegistered.args.idCommitment,
+                membershipRateLimit: memberRegistered.args.membershipRateLimit,
+                index: memberRegistered.args.index
+            };
             log.info(`Successfully registered membership with index ${decodedData.index} ` +
                 `and rate limit ${decodedData.membershipRateLimit}`);
             const network = await this.contract.provider.getNetwork();
             const address = this.contract.address;
-            const membershipId = decodedData.index.toString();
+            const membershipId = Number(decodedData.index);
             return {
                 identity,
                 membership: {
                     address,
-                    treeIndex: parseInt(membershipId),
+                    treeIndex: membershipId,
                     chainId: network.chainId.toString(),
                     rateLimit: decodedData.membershipRateLimit.toNumber()
                 }
             };
         }
         catch (error) {
-            if (error instanceof RLNContractError) {
-                throw error;
-            }
             if (error instanceof Error) {
                 const errorMessage = error.message;
                 log.error("registerWithIdentity - error message:", errorMessage);
                 log.error("registerWithIdentity - error stack:", error.stack);
-                // Map contract errors to our custom errors
+                // Try to extract more specific error information
                 if (errorMessage.includes("CannotExceedMaxTotalRateLimit")) {
-                    throw new RateLimitExceededError(this.rateLimit, await this.getRemainingTotalRateLimit());
+                    throw new Error("Registration failed: Cannot exceed maximum total rate limit");
                 }
                 else if (errorMessage.includes("InvalidIdCommitment")) {
-                    throw new InvalidMembershipError(identity.IDCommitmentBigInt.toString());
+                    throw new Error("Registration failed: Invalid ID commitment");
                 }
                 else if (errorMessage.includes("InvalidMembershipRateLimit")) {
-                    throw new InvalidRateLimitError(this.rateLimit, RATE_LIMIT_PARAMS.MIN_RATE, RATE_LIMIT_PARAMS.MAX_RATE);
+                    throw new Error("Registration failed: Invalid membership rate limit");
                 }
                 else if (errorMessage.includes("execution reverted")) {
-                    throw new TransactionError("Contract execution reverted. Check contract requirements.");
+                    throw new Error("Contract execution reverted. Check contract requirements.");
+                }
+                else {
+                    throw new Error(`Error in registerWithIdentity: ${errorMessage}`);
                 }
-                throw new RLNContractError(`Error in registerWithIdentity: ${errorMessage}`);
             }
-            throw new RLNContractError("Unknown error in registerWithIdentity");
+            else {
+                throw new Error("Unknown error in registerWithIdentity", {
+                    cause: error
+                });
+            }
         }
     }
     async registerWithPermitAndErase(identity, permit, idCommitmentsToErase) {
         try {
             log.info(`Registering identity with permit and rate limit: ${this.rateLimit} messages/epoch`);
-            const tx = await this.contract.registerWithPermit(permit.owner, permit.deadline, permit.v, permit.r, permit.s, identity.IDCommitmentBigInt, this.rateLimit, idCommitmentsToErase.map((id) => ethers.BigNumber.from(id)));
-            const decodedData = await this.confirmTransaction(tx, "MembershipRegistered", (event) => ({
-                idCommitment: event.args.idCommitment,
-                membershipRateLimit: event.args.membershipRateLimit,
-                index: event.args.index
-            }));
+            const txRegisterResponse = await this.contract.registerWithPermit(permit.owner, permit.deadline, permit.v, permit.r, permit.s, identity.IDCommitmentBigInt, this.rateLimit, idCommitmentsToErase.map((id) => ethers.BigNumber.from(id)));
+            const txRegisterReceipt = await txRegisterResponse.wait();
+            const memberRegistered = txRegisterReceipt.events?.find((event) => event.event === "MembershipRegistered");
+            if (!memberRegistered || !memberRegistered.args) {
+                log.error("Failed to register membership with permit: No MembershipRegistered event found");
+                return undefined;
+            }
+            const decodedData = {
+                idCommitment: memberRegistered.args.idCommitment,
+                membershipRateLimit: memberRegistered.args.membershipRateLimit,
+                index: memberRegistered.args.index
+            };
             log.info(`Successfully registered membership with permit. Index: ${decodedData.index}, ` +
                 `Rate limit: ${decodedData.membershipRateLimit}, Erased ${idCommitmentsToErase.length} commitments`);
             const network = await this.contract.provider.getNetwork();
             const address = this.contract.address;
-            const membershipId = decodedData.index.toString();
+            const membershipId = Number(decodedData.index);
             return {
                 identity,
                 membership: {
                     address,
-                    treeIndex: parseInt(membershipId),
+                    treeIndex: membershipId,
                     chainId: network.chainId.toString(),
                     rateLimit: decodedData.membershipRateLimit.toNumber()
                 }
@@ -302,29 +410,54 @@ export class RLNBaseContract {
         }
         catch (error) {
             log.error(`Error in registerWithPermitAndErase: ${error.message}`);
-            throw error;
+            return undefined;
         }
     }
     /**
      * Validates that the rate limit is within the allowed range
      * @throws Error if the rate limit is outside the allowed range
      */
-    validateRateLimit(rateLimit) {
-        if (rateLimit < RATE_LIMIT_PARAMS.MIN_RATE ||
-            rateLimit > RATE_LIMIT_PARAMS.MAX_RATE) {
-            throw new InvalidRateLimitError(rateLimit, RATE_LIMIT_PARAMS.MIN_RATE, RATE_LIMIT_PARAMS.MAX_RATE);
+    async validateRateLimit(rateLimit) {
+        const [minRate, maxRate] = await Promise.all([
+            this.contract.minMembershipRateLimit(),
+            this.contract.maxMembershipRateLimit()
+        ]);
+        const minRateNum = ethers.BigNumber.from(minRate).toNumber();
+        const maxRateNum = ethers.BigNumber.from(maxRate).toNumber();
+        if (rateLimit < minRateNum || rateLimit > maxRateNum) {
+            throw new Error(`Rate limit must be between ${minRateNum} and ${maxRateNum} messages per epoch`);
         }
     }
-    /**
-     * Helper to confirm a transaction and extract event data
-     */
-    async confirmTransaction(tx, expectedEvent, transform) {
-        const receipt = await tx.wait();
-        const event = receipt.events?.find((e) => e.event === expectedEvent);
-        if (!event || !event.args) {
-            throw new TransactionError(`Expected event ${expectedEvent} not found`);
+    get membersFilter() {
+        if (!this._membersFilter) {
+            throw Error("Members filter was not initialized.");
+        }
+        return this._membersFilter;
+    }
+    get membershipErasedFilter() {
+        if (!this._membershipErasedFilter) {
+            throw Error("MembershipErased filter was not initialized.");
+        }
+        return this._membershipErasedFilter;
+    }
+    get membersExpiredFilter() {
+        if (!this._membersExpiredFilter) {
+            throw Error("MembersExpired filter was not initialized.");
+        }
+        return this._membersExpiredFilter;
+    }
+    async getMemberIndex(idCommitmentBigInt) {
+        try {
+            const events = await this.contract.queryFilter(this.contract.filters.MembershipRegistered(idCommitmentBigInt));
+            if (events.length === 0)
+                return undefined;
+            // Get the most recent registration event
+            const event = events[events.length - 1];
+            return event.args?.index;
+        }
+        catch (error) {
+            return undefined;
         }
-        return transform(event);
     }
 }
 //# sourceMappingURL=rln_base_contract.js.map