tx-indexer 0.5.2 → 0.5.3

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { C as ClassifiedTransaction, k as FetchBatchOptions, l as FetchTransactionOptions, F as FetchTransactionsConfig, b as GetTransactionOptions, G as GetTransactionsOptions, I as IndexerRpcApi, N as NftMetadata, R as RetryConfig, S as SolanaClient, o as SpamFilterConfig, g as TokenAccountBalance, T as TxIndexer, a as TxIndexerOptions, W as WalletBalance, c as createIndexer, d as createSolanaClient, q as fetchNftMetadata, r as fetchNftMetadataBatch, i as fetchTransaction, j as fetchTransactionsBatch, f as fetchWalletBalance, h as fetchWalletSignatures, n as filterSpamTransactions, m as isSpamTransaction, p as parseAddress, e as parseSignature, t as transactionToLegs } from './client-DdzTiKZ4.js';
-import { T as TxLeg, R as RawTransaction, a as TransactionClassification } from './classification.types-Cn9IGtEC.js';
-export { f as RawTransactionSchema, k as TokenBalance, e as TokenBalanceSchema, n as TransactionClassificationSchema, j as TxCategory, d as TxCategorySchema, h as TxDirection, b as TxDirectionSchema, m as TxLegRole, g as TxLegSchema, l as TxLegSide, i as TxPrimaryType, c as TxPrimaryTypeSchema } from './classification.types-Cn9IGtEC.js';
+export { C as ClassifiedTransaction, k as FetchBatchOptions, l as FetchTransactionOptions, F as FetchTransactionsConfig, b as GetTransactionOptions, G as GetTransactionsOptions, I as IndexerRpcApi, N as NftMetadata, R as RetryConfig, S as SolanaClient, o as SpamFilterConfig, g as TokenAccountBalance, T as TxIndexer, a as TxIndexerOptions, W as WalletBalance, c as createIndexer, d as createSolanaClient, q as fetchNftMetadata, r as fetchNftMetadataBatch, i as fetchTransaction, j as fetchTransactionsBatch, f as fetchWalletBalance, h as fetchWalletSignatures, n as filterSpamTransactions, m as isSpamTransaction, p as parseAddress, e as parseSignature, t as transactionToLegs } from './client-xmDVjOy4.js';
+import { T as TxLeg, R as RawTransaction, a as TransactionClassification } from './classification.types-h046WjuF.js';
+export { f as RawTransactionSchema, k as TokenBalance, e as TokenBalanceSchema, n as TransactionClassificationSchema, j as TxCategory, d as TxCategorySchema, h as TxDirection, b as TxDirectionSchema, m as TxLegRole, g as TxLegSchema, l as TxLegSide, i as TxPrimaryType, c as TxPrimaryTypeSchema } from './classification.types-h046WjuF.js';
 import { ProtocolInfo, TokenInfo } from './types.js';
 export { Categorization, CategorizationSchema, Counterparty, CounterpartySchema, FiatValue, MoneyAmount, ProtocolInfoSchema } from './types.js';
 import { z } from 'zod';
@@ -191,14 +191,118 @@ declare function parseSolanaPayMemo(memo: string): SolanaPayMemo;
  */
 declare function isSolanaPayTransaction(programIds: string[], memo: string | null | undefined): boolean;
 
+/**
+ * Well-known token mint addresses on Solana mainnet.
+ * These are used as constants throughout the codebase.
+ */
 declare const KNOWN_TOKENS: {
     readonly SOL: "So11111111111111111111111111111111111111112";
     readonly USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
-    readonly USDC_BRIDGED: "A9mUU4qviSctJVPJdBJWkb28deg915LYJKrzQ19ji3FM";
+    readonly USDT: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
+    readonly PYUSD: "2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo";
     readonly USDG: "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH";
+    readonly USDC_BRIDGED: "A9mUU4qviSctJVPJdBJWkb28deg915LYJKrzQ19ji3FM";
+    readonly DAI: "EjmyN6qEC1Tf1JxiG1ae7UTJhUxSwk1TCCi3Z4dPuFhh";
+    readonly JUP: "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN";
+    readonly JTO: "jtojtomepa8beP8AuQc6eXt5FriJwfFMwQx2v2f9mCL";
+    readonly PYTH: "HZ1JovNiVvGrGNiiYvEozEVgZ58xaU3RKwX8eACQBCt3";
+    readonly BONK: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263";
+    readonly WIF: "EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm";
+    readonly RENDER: "rndrizKT3MK1iimdxRdWabcF7Zg7AR5T4nud4EkHBof";
+    readonly HNT: "hntyVP6YFm1Hg25TN9WGLqM12b8TQmcknKrdu1oxWux";
+    readonly RAY: "4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R";
+    readonly ORCA: "orcaEKTdK7LKz57vaAYr9QeNsVEPfiu6QeMU1kektZE";
+    readonly MNGO: "MangoCzJ36AjZyKwVj3VnYU4GTonjfVEnJmvvWaxLac";
+    readonly MSOL: "mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So";
+    readonly JITOSOL: "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn";
+    readonly BSOL: "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1";
+    readonly POPCAT: "7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr";
+    readonly MEW: "MEW1gQWJ3nEXg2qgERiKu7FAFj79PHvQVREQUzScPP5";
+    readonly PNUT: "2qEHjDLDLbuBgRYvsxhc5D6uDWAivNFZGan56P1tpump";
+    readonly FARTCOIN: "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump";
+    readonly AI16Z: "HeLp6NuQkmYB4pYWo2zYs22mESHXPQYzXbB8n4V98jwC";
+    readonly WBTC: "3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh";
+    readonly WETH: "7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs";
+    readonly WSOL: "So11111111111111111111111111111111111111112";
 };
+/**
+ * Static token metadata registry.
+ * This serves as a fallback when external APIs (like Jupiter) are unavailable.
+ *
+ * Logo URLs are from:
+ * - Solana Labs token list (legacy but still hosted)
+ * - Jupiter token list CDN
+ */
 declare const TOKEN_INFO: Record<string, TokenInfo>;
 declare function getTokenInfo(mint: string): TokenInfo | undefined;
+/**
+ * Creates an "unknown token" placeholder for tokens not in the registry.
+ * Uses the first 8 characters of the mint address as a symbol.
+ */
+declare function createUnknownToken(mint: string, decimals: number): TokenInfo;
+declare const SUPPORTED_STABLECOINS: readonly ["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB", "2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo", "2u1tszSeqZ3qBWF3uNGPFc8TzMk2tdiwknnRMWGWjGWH", "A9mUU4qviSctJVPJdBJWkb28deg915LYJKrzQ19ji3FM", "EjmyN6qEC1Tf1JxiG1ae7UTJhUxSwk1TCCi3Z4dPuFhh"];
+/**
+ * Liquid staking tokens that represent staked SOL
+ */
+declare const LIQUID_STAKING_TOKENS: readonly ["mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So", "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn", "bSo13r4TkiE4KumL71LsHTPpL2euBYLFx6h9HP3piy1"];
+
+/**
+ * Options for the token fetcher
+ */
+interface TokenFetcherOptions {
+    /**
+     * Jupiter API endpoint. Defaults to the strict list (verified tokens).
+     * Use "https://tokens.jup.ag/tokens?tags=verified" for verified tokens
+     * Use "https://tokens.jup.ag/tokens" for all tokens
+     */
+    jupiterApiUrl?: string;
+    /**
+     * Time-to-live for cached tokens in milliseconds.
+     * Defaults to 5 minutes.
+     */
+    cacheTtlMs?: number;
+    /**
+     * Whether to fetch all tokens on initialization.
+     * If false, tokens will be fetched on-demand.
+     * Defaults to false.
+     */
+    prefetch?: boolean;
+}
+/**
+ * Fetches and caches token metadata from Jupiter's token API.
+ *
+ * Usage:
+ * ```ts
+ * const fetcher = createTokenFetcher();
+ * const token = await fetcher.getToken("JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN");
+ * ```
+ */
+interface TokenFetcher {
+    /**
+     * Get token info for a single mint address.
+     * Returns from cache if available, otherwise fetches from Jupiter.
+     * Falls back to static registry, then creates unknown token placeholder.
+     */
+    getToken(mint: string, decimals?: number): Promise<TokenInfo>;
+    /**
+     * Get token info for multiple mint addresses.
+     * More efficient than calling getToken multiple times.
+     */
+    getTokens(mints: string[], defaultDecimals?: number): Promise<Map<string, TokenInfo>>;
+    /**
+     * Force refresh the token cache from Jupiter API.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Get the number of tokens currently cached.
+     */
+    getCacheSize(): number;
+}
+/**
+ * Creates a new token fetcher instance.
+ */
+declare function createTokenFetcher(options?: TokenFetcherOptions): TokenFetcher;
+declare function getDefaultTokenFetcher(): TokenFetcher;
 
 /**
  * Solana Program IDs
@@ -213,4 +317,4 @@ declare const JUPITER_V6_PROGRAM_ID = "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTa
 declare const JUPITER_V4_PROGRAM_ID = "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB";
 declare function detectFacilitator(accountKeys: string[]): string | null;
 
-export { type AccountIdType, type BuildAccountIdParams, ClassificationService, JUPITER_V4_PROGRAM_ID, JUPITER_V6_PROGRAM_ID, KNOWN_TOKENS, type LegBalanceResult, type LegTokenBalance, type ParsedAccountId, ProtocolInfo, RawTransaction, SPL_MEMO_PROGRAM_ID, SYSTEM_PROGRAM_ID, type SolanaPayMemo, TOKEN_INFO, TOKEN_PROGRAM_ID, TokenInfo, TransactionClassification, TxLeg, buildAccountId, classifyTransaction, detectFacilitator, detectProtocol, extractMemo, getTokenInfo, groupLegsByAccount, groupLegsByToken, isSolanaPayTransaction, parseAccountId, parseSolanaPayMemo, validateLegsBalance };
+export { type AccountIdType, type BuildAccountIdParams, ClassificationService, JUPITER_V4_PROGRAM_ID, JUPITER_V6_PROGRAM_ID, KNOWN_TOKENS, LIQUID_STAKING_TOKENS, type LegBalanceResult, type LegTokenBalance, type ParsedAccountId, ProtocolInfo, RawTransaction, SPL_MEMO_PROGRAM_ID, SUPPORTED_STABLECOINS, SYSTEM_PROGRAM_ID, type SolanaPayMemo, TOKEN_INFO, TOKEN_PROGRAM_ID, type TokenFetcher, type TokenFetcherOptions, TokenInfo, TransactionClassification, TxLeg, buildAccountId, classifyTransaction, createTokenFetcher, createUnknownToken, detectFacilitator, detectProtocol, extractMemo, getDefaultTokenFetcher, getTokenInfo, groupLegsByAccount, groupLegsByToken, isSolanaPayTransaction, parseAccountId, parseSolanaPayMemo, validateLegsBalance };