tx-indexer 1.0.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,33 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2025-01-09
+
+### Added
+
+- **RPC Request Profiler**: Test utility to measure HTTP requests during SDK operations
+  - Run with: `RPC_URL=<url> PROFILE_WALLET=<addr> bun test rpc-profiler`
+
+- **RPC Optimization Options**: New options for rate-limited RPC environments
+  - `overfetchMultiplier` - Controls signature overfetch (default: 2, use 1 for strict rate limits)
+  - `minPageSize` - Minimum page size for fetching (default: 20)
+  - `maxTokenAccounts` - Limit ATA queries (default: 5)
+
+### Changed
+
+- **Token Account Fetching**: Optimized signature retrieval
+  - Sequential wallet → ATA fetching to avoid rate limit errors
+  - Only fetch ATAs when wallet signatures aren't sufficient
+  - Parallel fetching of wallet and token account signatures where safe
+
+- **Performance Improvements**: Significantly reduced RPC calls for rate-limited environments
+  - Load time improvements from ~105s to ~7s in constrained environments
+  - Disabled JSON-RPC batching (not supported on most free tier RPCs)
+
+### Fixed
+
+- Rate limit handling for Helius free tier (10 req/sec) and similar constrained RPCs
+
 ## [1.0.0] - 2025-01-09
 
 ### Added

package/README.md

@@ -150,6 +150,30 @@ const txs = await indexer.getTransactions(address, {
 });
 ```
 
+## RPC Optimization
+
+For rate-limited RPCs (like Helius free tier at 10 req/sec), the SDK provides optimization options to reduce RPC calls:
+
+```typescript
+const indexer = createIndexer({
+  rpcUrl: "https://api.mainnet-beta.solana.com",
+  // Optimization options for rate-limited environments
+  overfetchMultiplier: 1, // Default: 2, reduces signature overfetch
+  minPageSize: 10, // Default: 20, matches page size to your limit
+  maxTokenAccounts: 3, // Default: 5, limits ATA queries
+});
+```
+
+**Options:**
+
+| Option                | Default | Description                                      |
+| --------------------- | ------- | ------------------------------------------------ |
+| `overfetchMultiplier` | `2`     | Multiplier for signature overfetch (1 = minimal) |
+| `minPageSize`         | `20`    | Minimum page size for RPC calls                  |
+| `maxTokenAccounts`    | `5`     | Maximum token accounts to query for signatures   |
+
+These optimizations can reduce load time from ~105s to ~7s in rate-limited environments.
+
 ## Transaction Schema
 
 A `ClassifiedTransaction` has three parts:

package/STABILITY.md

@@ -23,6 +23,7 @@ APIs in this tier are production-ready and follow semantic versioning strictly:
 - All core types (`ClassifiedTransaction`, `RawTransaction`, `TxLeg`, etc.)
 - JSON serialization helpers (`toJsonClassifiedTransaction`, etc.)
 - Token registry (`getTokenInfo`, `KNOWN_TOKENS`, etc.)
+- RPC optimization options (`overfetchMultiplier`, `minPageSize`, `maxTokenAccounts`)
 
 ### Advanced (`tx-indexer/advanced`)
 
@@ -78,7 +79,8 @@ When we deprecate an API:
 
 ## Version History
 
-| Version | Tier Changes                            |
-| ------- | --------------------------------------- |
-| 1.0.0   | Initial stable release with tier system |
-| 0.x.x   | Pre-release, no stability guarantees    |
+| Version | Tier Changes                                  |
+| ------- | --------------------------------------------- |
+| 1.1.0   | Added RPC optimization options to stable tier |
+| 1.0.0   | Initial stable release with tier system       |
+| 0.x.x   | Pre-release, no stability guarantees          |

package/dist/advanced.d.ts

@@ -1,4 +1,4 @@
-export { j as FetchBatchOptions, k as FetchTransactionOptions, I as IndexerRpcApi, N as NftMetadata, R as RetryConfig, S as SolanaClient, a as SpamFilterConfig, T as TokenAccountBalance, W as WalletBalance, c as createSolanaClient, n as fetchNftMetadata, o as fetchNftMetadataBatch, h as fetchTransaction, i as fetchTransactionsBatch, g as fetchWalletAndTokenSignatures, f as fetchWalletBalance, d as fetchWalletSignatures, e as fetchWalletTokenAccounts, m as filterSpamTransactions, l as isSpamTransaction, t as transactionToLegs } from './nft-CJ3sVLxf.js';
+export { j as FetchBatchOptions, k as FetchTransactionOptions, I as IndexerRpcApi, N as NftMetadata, R as RetryConfig, S as SolanaClient, a as SpamFilterConfig, T as TokenAccountBalance, W as WalletBalance, c as createSolanaClient, n as fetchNftMetadata, o as fetchNftMetadataBatch, h as fetchTransaction, i as fetchTransactionsBatch, g as fetchWalletAndTokenSignatures, f as fetchWalletBalance, d as fetchWalletSignatures, e as fetchWalletTokenAccounts, m as filterSpamTransactions, l as isSpamTransaction, t as transactionToLegs } from './nft-AaDY3qte.js';
 import { TxLeg, RawTransaction, TransactionClassification, ProtocolInfo, TokenInfo } from './types.js';
 import { z } from 'zod';
 import { Address } from '@solana/kit';

package/dist/advanced.js

@@ -923,7 +923,9 @@ async function fetchTransactionsBatch(rpc, signatures, options = {}) {
     commitment = "confirmed",
     concurrency = 5,
     retry,
-    onFetchError
+    onFetchError,
+    rpcUrl,
+    batchSize = 100
   } = options;
   if (signatures.length === 0) {
     return [];