import type { Idl, Program } from "@coral-xyz/anchor";
import type { PublicKey } from "@solana/web3.js";
import type { CommitmentEvent, NullifierSpentEvent } from "./types.js";
export type EventScanPage<T> = {
    events: T[];
    /** Oldest signature examined, even when it emitted no matching event. */
    nextBefore?: string;
    scannedSignatures: number;
};
export type EventScanParams<T extends Idl> = {
    program: Program<T>;
    mintAddress?: PublicKey;
    before?: string;
    until?: string;
    /** Number of program signatures to inspect. Maximum 1,000. */
    limit?: number;
};
/** Scan one RPC page and retain a correct pagination cursor. */
export declare function scanCommitmentEventPage<T extends Idl>(params: EventScanParams<T>): Promise<EventScanPage<CommitmentEvent>>;
/**
 * Scan a single page of CommitmentEvents.
 *
 * Use `scanAllCommitmentEvents` when reconstructing a complete historical tree.
 */
export declare function scanCommitmentEvents<T extends Idl>(params: EventScanParams<T>): Promise<CommitmentEvent[]>;
/** Scan all historical pages without using event count as the RPC cursor. */
export declare function scanAllCommitmentEvents<T extends Idl>(params: {
    program: Program<T>;
    mintAddress?: PublicKey;
    before?: string;
    until?: string;
    pageSize?: number;
}): Promise<CommitmentEvent[]>;
/** Scan one RPC page of NullifierSpent events using all historical IDLs. */
export declare function scanNullifierEvents<T extends Idl>(params: EventScanParams<T>): Promise<NullifierSpentEvent[]>;