@0xbow/privacy-pools-core-sdk 1.0.4 → 1.1.0

package/dist/esm/index.mjs

@@ -1,4 +1,4 @@
-export { n as AccountError, A as AccountService, B as BlockchainProvider, o as CircuitName, j as Circuits, C as CommitmentService, m as ContractError, k as ContractInteractionsService, D as DataService, E as ErrorCode, I as InvalidRpcUrl, P as PrivacyPoolSDK, l as ProofError, S as SDKError, W as WithdrawalService, e as bigintToHash, f as bigintToHex, i as calculateContext, a as generateDepositSecrets, g as generateMasterKeys, d as generateMerkleProof, b as generateWithdrawalSecrets, c as getCommitment, h as hashPrecommitment } from './index-BxzIe_IR.js';
+export { o as AccountError, A as AccountService, B as BlockchainProvider, p as CircuitName, k as Circuits, C as CommitmentService, n as ContractError, l as ContractInteractionsService, a as DEFAULT_LOG_FETCH_CONFIG, D as DataService, E as ErrorCode, I as InvalidRpcUrl, P as PrivacyPoolSDK, m as ProofError, S as SDKError, W as WithdrawalService, f as bigintToHash, i as bigintToHex, j as calculateContext, b as generateDepositSecrets, g as generateMasterKeys, e as generateMerkleProof, c as generateWithdrawalSecrets, d as getCommitment, h as hashPrecommitment } from './index-CRtEyHEf.js';
 import 'viem/accounts';
 import 'buffer';
 import 'assert';

package/dist/index.d.mts

@@ -84,6 +84,58 @@ interface MasterKeys {
     masterSecret: Secret;
 }
 
+/**
+ * Configuration options for rate-limited log fetching
+ */
+interface LogFetchConfig {
+    /**
+     * Maximum number of blocks to fetch in a single RPC call.
+     * Default: 10000 (typical limit for most RPC providers)
+     */
+    blockChunkSize: number;
+    /**
+     * Maximum number of concurrent log fetch operations.
+     * Default: 3
+     */
+    concurrency: number;
+    /**
+     * Delay in milliseconds between chunk requests (for additional throttling).
+     * Default: 0 (no delay)
+     */
+    chunkDelayMs: number;
+    /**
+     * Whether to retry failed chunk fetches.
+     * Default: true
+     */
+    retryOnFailure: boolean;
+    /**
+     * Maximum number of retries for a failed chunk.
+     * Default: 3
+     */
+    maxRetries: number;
+    /**
+     * Base delay for exponential backoff on retries (ms).
+     * Default: 1000
+     */
+    retryBaseDelayMs: number;
+}
+/**
+ * Default log fetch configuration
+ */
+declare const DEFAULT_LOG_FETCH_CONFIG: LogFetchConfig;
+/**
+ * Per-chain log fetch configuration map
+ * Maps chainId to its specific LogFetchConfig
+ */
+type ChainLogFetchConfig = Map<number, Partial<LogFetchConfig>>;
+/**
+ * Block range for chunked fetching
+ */
+interface BlockRange {
+    fromBlock: bigint;
+    toBlock: bigint;
+}
+
 /**
  * Generates two master keys based on some provided seed or a random value.
  *
@@ -841,18 +893,20 @@ declare class DataService {
     private readonly chainConfigs;
     private readonly clients;
     private readonly logger;
+    private readonly logFetchConfigs;
     /**
      * Initialize the data service with chain configurations
      *
      * @param chainConfigs - Array of chain configurations containing chainId, RPC URL, and API key
+     * @param logFetchConfig - Per-chain configuration for rate-limited log fetching as a Map<chainId, config>.
+     *                         Each chain can have its own specific settings (e.g., different block chunk sizes).
      * @throws {DataError} If client initialization fails for any chain
      */
-    constructor(chainConfigs: ChainConfig[]);
+    constructor(chainConfigs: ChainConfig[], logFetchConfig?: ChainLogFetchConfig);
     /**
      * Get deposit events for a specific chain
      *
-     * @param chainId - Chain ID to fetch events from
-     * @param options - Event filter options including fromBlock, toBlock, and other filters
+     * @param pool - Pool info containing chainId, address, and deployment block
      * @returns Array of deposit events with properly typed fields (bigint for numbers, Hash for commitments)
      * @throws {DataError} If client is not configured, network error occurs, or event data is invalid
      */
@@ -860,8 +914,8 @@ declare class DataService {
     /**
      * Get withdrawal events for a specific chain
      *
-     * @param chainId - Chain ID to fetch events from
-     * @param options - Event filter options including fromBlock, toBlock, and other filters
+     * @param pool - Pool info containing chainId, address, and deployment block
+     * @param fromBlock - Optional starting block (defaults to pool deployment block)
      * @returns Array of withdrawal events with properly typed fields (bigint for numbers, Hash for commitments)
      * @throws {DataError} If client is not configured, network error occurs, or event data is invalid
      */
@@ -869,20 +923,39 @@ declare class DataService {
     /**
      * Get ragequit events for a specific chain
      *
-     * @param chainId - Chain ID to fetch events from
-     * @param options - Event filter options including fromBlock, toBlock, and other filters
+     * @param pool - Pool info containing chainId, address, and deployment block
+     * @param fromBlock - Optional starting block (defaults to pool deployment block)
      * @returns Array of ragequit events with properly typed fields (bigint for numbers, Hash for commitments)
      * @throws {DataError} If client is not configured, network error occurs, or event data is invalid
      */
     getRagequits(pool: PoolInfo, fromBlock?: bigint): Promise<RagequitEvent[]>;
+    /**
+     * Gets the current block number for a chain
+     */
+    private getCurrentBlock;
+    /**
+     * Generates block ranges for chunked fetching
+     */
+    private generateBlockRanges;
+    /**
+     * Fetches logs for a single block range with retry logic
+     */
+    private fetchLogsWithRetry;
+    /**
+     * Helper to add delay between requests
+     */
+    private sleep;
     private getClientForChain;
     private getConfigForChain;
+    private getLogFetchConfigForChain;
 }
 
 type AccountServiceConfig = {
     mnemonic: string;
+    poolConcurrency?: number;
 } | {
     account: PrivacyPoolAccount;
+    poolConcurrency?: number;
 };
 /**
  * Service responsible for managing privacy pool accounts and their associated commitments.
@@ -896,6 +969,7 @@ declare class AccountService {
     private readonly dataService;
     account: PrivacyPoolAccount;
     private readonly logger;
+    private readonly poolConcurrency;
     /**
      * Creates a new AccountService instance.
      *
@@ -903,6 +977,7 @@ declare class AccountService {
      * @param config - Configuration for the account service (either mnemonic or existing account)
      * @param config.mnemonic - Optional mnemonic for deterministic key generation
      * @param config.account - Optional existing account to initialize with
+     * @param config.poolConcurrency - Optional maximum number of pools to fetch events for concurrently (default: 2)
      *
      * @throws {AccountError} If account initialization fails
      */
@@ -1099,14 +1174,13 @@ declare class AccountService {
      */
     getRagequitEvents(pool: PoolInfo): Promise<Map<Hash, RagequitEvent>>;
     /**
-     * Fetches events for a given set of pools with concurrency control
+     * Fetches events for a given set of pools
      *
      * @param pools - The pools to fetch events for
-     * @param maxConcurrency - Maximum number of concurrent pool fetches (default: 5)
      *
      * @returns A map of pool scopes to their events
      */
-    getEvents(pools: PoolInfo[], maxConcurrency?: number): Promise<PoolEventsResult>;
+    getEvents(pools: PoolInfo[]): Promise<PoolEventsResult>;
     /**
      * Processes deposit events for a given scope and adds them to the account
      * Deterministically generate deposit secrets and check if they match on-chain deposits
@@ -1156,11 +1230,10 @@ declare class AccountService {
      * @param dataService - The data service to use for fetching events
      * @param source - The source to use for initializing the account. Either a mnemonic or an existing account service instance
      * @param pools - The pools to fetch events for
-     * @param maxConcurrency - Maximum number of concurrent pool fetches (default: 5)
      *
      * @remarks
      * This method performs the following steps for each pool:
-     * 1. Fetches deposit, withdrawal, and ragequit events for each pool (with concurrency control)
+     * 1. Fetches deposit, withdrawal, and ragequit events for each pool
      * 2. Processes deposit events and creates pool accounts
      * 3. Processes withdrawal events and adds commitments to pool accounts
      * 4. Processes ragequit events and adds ragequit to pool accounts
@@ -1176,7 +1249,7 @@ declare class AccountService {
         mnemonic: string;
     } | {
         service: AccountService;
-    }, pools: PoolInfo[], maxConcurrency?: number): Promise<{
+    }, pools: PoolInfo[]): Promise<{
         account: AccountService;
         errors: PoolEventsError[];
     }>;
@@ -1221,4 +1294,4 @@ declare class AccountService {
     private _processWithdrawalsAndRagequits;
 }
 
-export { type AccountCommitment, AccountError, AccountService, BlockchainProvider, type ChainConfig, CircuitName, type CircuitSignals, Circuits, type CircuitsInterface, type Commitment, type CommitmentPreimage, type CommitmentProof, CommitmentService, ContractError, ContractInteractionsService, DataService, type DepositEvent, ErrorCode, type EventFilterOptions, type Hash, type IBlockchainProvider, InvalidRpcUrl, type MasterKeys, type PoolAccount, type PoolEvents, type PoolEventsError, type PoolEventsResult, type PoolEventsSuccess, type PoolInfo, type Precommitment, type PrivacyPoolAccount, PrivacyPoolSDK, type ProcessedDepositEventsResult, ProofError, type RagequitEvent, SDKError, type Secret, type Withdrawal, type WithdrawalEvent, type WithdrawalProof, type WithdrawalProofInput, WithdrawalService, bigintToHash, bigintToHex, calculateContext, generateDepositSecrets, generateMasterKeys, generateMerkleProof, generateWithdrawalSecrets, getCommitment, hashPrecommitment };
+export { type AccountCommitment, AccountError, AccountService, type BlockRange, BlockchainProvider, type ChainConfig, type ChainLogFetchConfig, CircuitName, type CircuitSignals, Circuits, type CircuitsInterface, type Commitment, type CommitmentPreimage, type CommitmentProof, CommitmentService, ContractError, ContractInteractionsService, DEFAULT_LOG_FETCH_CONFIG, DataService, type DepositEvent, ErrorCode, type EventFilterOptions, type Hash, type IBlockchainProvider, InvalidRpcUrl, type LogFetchConfig, type MasterKeys, type PoolAccount, type PoolEvents, type PoolEventsError, type PoolEventsResult, type PoolEventsSuccess, type PoolInfo, type Precommitment, type PrivacyPoolAccount, PrivacyPoolSDK, type ProcessedDepositEventsResult, ProofError, type RagequitEvent, SDKError, type Secret, type Withdrawal, type WithdrawalEvent, type WithdrawalProof, type WithdrawalProofInput, WithdrawalService, bigintToHash, bigintToHex, calculateContext, generateDepositSecrets, generateMasterKeys, generateMerkleProof, generateWithdrawalSecrets, getCommitment, hashPrecommitment };

package/dist/node/{fetchArtifacts.esm-l-EDo53-.js → fetchArtifacts.esm-z-KXbilc.js}

@@ -1,4 +1,4 @@
-import { F as FetchArtifact } from './index-DGsIfUGw.js';
+import { F as FetchArtifact } from './index-BsmEKESv.js';
 import 'viem/accounts';
 import 'buffer';
 import 'http';
@@ -32,4 +32,4 @@ async function fetchVersionedArtifact(artifactUrl) {
 }
 
 export { fetchVersionedArtifact };
-//# sourceMappingURL=fetchArtifacts.esm-l-EDo53-.js.map
+//# sourceMappingURL=fetchArtifacts.esm-z-KXbilc.js.map

package/dist/node/{fetchArtifacts.esm-l-EDo53-.js.map → fetchArtifacts.esm-z-KXbilc.js.map}

@@ -1 +1 @@
-{"version":3,"file":"fetchArtifacts.esm-l-EDo53-.js","sources":["../../src/circuits/fetchArtifacts.esm.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAEO,eAAe,sBAAsB,CAC1C,WAAgB,EAAA;AAEhB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;AACpC,IAAA,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;AACtB,QAAA,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC;;AAEtC,IAAA,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE;AACpC,IAAA,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC;AAC7B;;;;"}
+{"version":3,"file":"fetchArtifacts.esm-z-KXbilc.js","sources":["../../src/circuits/fetchArtifacts.esm.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAEO,eAAe,sBAAsB,CAC1C,WAAgB,EAAA;AAEhB,IAAA,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;AACpC,IAAA,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE;AACtB,QAAA,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC;;AAEtC,IAAA,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE;AACpC,IAAA,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC;AAC7B;;;;"}

package/dist/node/{fetchArtifacts.node-DYwQHSF4.js → fetchArtifacts.node-DvqhqpW9.js}

@@ -1,4 +1,4 @@
-import { F as FetchArtifact } from './index-DGsIfUGw.js';
+import { F as FetchArtifact } from './index-BsmEKESv.js';
 import 'viem/accounts';
 import 'buffer';
 import 'http';
@@ -45,4 +45,4 @@ async function fetchVersionedArtifact(artifactUrl) {
 }
 
 export { fetchVersionedArtifact };
-//# sourceMappingURL=fetchArtifacts.node-DYwQHSF4.js.map
+//# sourceMappingURL=fetchArtifacts.node-DvqhqpW9.js.map

package/dist/node/{fetchArtifacts.node-DYwQHSF4.js.map → fetchArtifacts.node-DvqhqpW9.js.map}

@@ -1 +1 @@
-{"version":3,"file":"fetchArtifacts.node-DYwQHSF4.js","sources":["../../src/circuits/fetchArtifacts.node.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAEO,eAAe,sBAAsB,CAC1C,WAAgB,EAAA;AAEhB,IAAA,IAAI;QACF,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,EAAE,OAAO;QACvC,MAAM,WAAW,GAAoB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACnE,YAAA,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,KAAI;gBAC9C,IAAI,GAAG,EAAE;oBACP,MAAM,CAAC,GAAG,CAAC;;qBACN;oBACL,OAAO,CAAC,IAAI,CAAC;;AAEjB,aAAC,CAAC;AACJ,SAAC,CAAC;AACF,QAAA,MAAM,GAAG,GAAG,MAAM,WAAW;AAC7B,QAAA,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC;;IAC1B,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AACpB,QAAA,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC;;AAExC;;;;"}
+{"version":3,"file":"fetchArtifacts.node-DvqhqpW9.js","sources":["../../src/circuits/fetchArtifacts.node.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAEO,eAAe,sBAAsB,CAC1C,WAAgB,EAAA;AAEhB,IAAA,IAAI;QACF,MAAM,EAAE,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,EAAE,OAAO;QACvC,MAAM,WAAW,GAAoB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;AACnE,YAAA,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,KAAI;gBAC9C,IAAI,GAAG,EAAE;oBACP,MAAM,CAAC,GAAG,CAAC;;qBACN;oBACL,OAAO,CAAC,IAAI,CAAC;;AAEjB,aAAC,CAAC;AACJ,SAAC,CAAC;AACF,QAAA,MAAM,GAAG,GAAG,MAAM,WAAW;AAC7B,QAAA,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC;;IAC1B,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;AACpB,QAAA,MAAM,IAAI,aAAa,CAAC,WAAW,CAAC;;AAExC;;;;"}