tx-indexer 0.2.0 → 0.4.0

package/dist/{classification.types-w82k4B1F.d.ts → classification.types-DlJe6bDZ.d.ts}

@@ -181,14 +181,10 @@ declare const TransactionClassificationSchema: z.ZodObject<{
         fee_only: "fee_only";
         other: "other";
     }>;
-    direction: z.ZodEnum<{
-        incoming: "incoming";
-        outgoing: "outgoing";
-        self: "self";
-        neutral: "neutral";
-    }>;
     primaryAmount: z.ZodNullable<z.ZodAny>;
     secondaryAmount: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+    sender: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    receiver: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     counterparty: z.ZodNullable<z.ZodObject<{
         type: z.ZodEnum<{
             unknown: "unknown";

package/dist/{client-BS9KUBU7.d.ts → client-yGDWPKKf.d.ts}

@@ -1,5 +1,5 @@
 import { Rpc, GetBalanceApi, GetTokenAccountsByOwnerApi, GetSignaturesForAddressApi, GetTransactionApi, RpcSubscriptions, Address, Signature } from '@solana/kit';
-import { R as RawTransaction, T as TxLeg, a as TransactionClassification } from './classification.types-w82k4B1F.js';
+import { R as RawTransaction, T as TxLeg, a as TransactionClassification } from './classification.types-DlJe6bDZ.js';
 
 /**
  * Union type of all RPC APIs used by the transaction indexer.
@@ -72,12 +72,13 @@ declare function fetchTransactionsBatch(rpc: Rpc<GetTransactionApi>, signatures:
  * detecting and accounting for network fees. Each leg represents a debit or credit
  * for a specific account and token, enabling transaction classification and validation.
  *
+ * All accounts are tagged as "external:" - the classification layer determines
+ * the transaction type and direction from the initiator's (fee payer's) perspective.
+ *
  * @param tx - Raw transaction data with balance changes
- * @param walletAddress - Optional wallet address for perspective. When provided, legs are tagged
- *   as "wallet:" or "external:". When omitted (observer mode), all legs are tagged as "external:".
  * @returns Array of transaction legs representing all balance movements
  */
-declare function transactionToLegs(tx: RawTransaction, walletAddress?: Address): TxLeg[];
+declare function transactionToLegs(tx: RawTransaction): TxLeg[];
 
 interface SpamFilterConfig {
     minSolAmount?: number;
@@ -151,107 +152,31 @@ interface TokenAccountBalance {
  */
 declare function fetchWalletBalance(rpc: Rpc<GetBalanceApi & GetTokenAccountsByOwnerApi>, walletAddress: Address, tokenMints?: readonly string[]): Promise<WalletBalance>;
 
-/**
- * Configuration options for creating a transaction indexer.
- *
- * Use either `rpcUrl` to let the SDK create a client, or provide an existing `client`
- * to share connections across your application.
- */
 type TxIndexerOptions = {
-    /** Solana RPC URL (SDK creates a new client) */
     rpcUrl: string;
-    /** Optional WebSocket URL for subscriptions */
     wsUrl?: string;
 } | {
-    /** Existing Solana client to reuse (shares connections) */
     client: SolanaClient;
 };
-/**
- * Options for fetching and filtering transaction history.
- */
 interface GetTransactionsOptions {
-    /** Maximum number of transactions to return (default: 10) */
     limit?: number;
-    /** Fetch transactions before this signature (for pagination) */
     before?: Signature;
-    /** Fetch transactions until this signature (for pagination) */
     until?: Signature;
-    /** Whether to filter out spam transactions (default: true) */
     filterSpam?: boolean;
-    /** Custom spam filter configuration */
     spamConfig?: SpamFilterConfig;
 }
-/**
- * A fully classified transaction with raw data, classification metadata, and accounting legs.
- */
 interface ClassifiedTransaction {
-    /** Raw transaction data from the blockchain */
     tx: RawTransaction;
-    /** Classification metadata (type, direction, amounts, counterparty) */
     classification: TransactionClassification;
-    /** Accounting legs representing all balance movements */
     legs: ReturnType<typeof transactionToLegs>;
 }
-/**
- * Transaction indexer client for querying and classifying Solana transactions.
- *
- * Provides methods to fetch wallet balances, transaction history, and individual transactions
- * with automatic protocol detection and classification.
- */
 interface TxIndexer {
-    /** Direct access to the underlying Solana RPC client */
     rpc: ReturnType<typeof createSolanaClient>["rpc"];
-    /**
-     * Fetches the SOL and SPL token balances for a wallet.
-     *
-     * @param walletAddress - Wallet address to query balances for
-     * @param tokenMints - Optional array of token mint addresses to filter
-     * @returns Wallet balance data including SOL and token balances
-     */
     getBalance(walletAddress: Address, tokenMints?: readonly string[]): Promise<WalletBalance>;
-    /**
-     * Fetches and classifies transaction history for a wallet.
-     *
-     * @param walletAddress - Wallet address to fetch transaction history for
-     * @param options - Configuration options for fetching and filtering
-     * @returns Array of classified transactions with full metadata
-     */
     getTransactions(walletAddress: Address, options?: GetTransactionsOptions): Promise<ClassifiedTransaction[]>;
-    /**
-     * Fetches and classifies a single transaction by its signature.
-     *
-     * @param signature - Transaction signature to fetch
-     * @param walletAddress - Optional wallet address for classification perspective.
-     *   When omitted, returns classification from observer mode (neutral perspective).
-     * @returns Classified transaction with full metadata, or null if transaction not found
-     */
-    getTransaction(signature: Signature, walletAddress?: Address): Promise<ClassifiedTransaction | null>;
-    /**
-     * Fetches a raw transaction without classification.
-     *
-     * @param signature - Transaction signature to fetch
-     * @returns Raw transaction data from the blockchain, or null if not found
-     */
+    getTransaction(signature: Signature): Promise<ClassifiedTransaction | null>;
     getRawTransaction(signature: Signature): Promise<RawTransaction | null>;
 }
-/**
- * Creates a transaction indexer client for querying and classifying Solana transactions.
- *
- * Accepts either an RPC URL (SDK creates client) or an existing SolanaClient (for sharing
- * connections across your app or with React providers).
- *
- * @param options - Configuration with RPC URL or existing client
- * @returns Transaction indexer client
- *
- * @example
- * // Option 1: SDK creates client
- * const indexer = createIndexer({ rpcUrl: "https://api.mainnet-beta.solana.com" });
- *
- * @example
- * // Option 2: Provide existing client (share connections)
- * const myClient = createSolanaClient("https://...");
- * const indexer = createIndexer({ client: myClient });
- */
 declare function createIndexer(options: TxIndexerOptions): TxIndexer;
 
 export { type ClassifiedTransaction as C, type FetchTransactionsConfig as F, type GetTransactionsOptions as G, type IndexerRpcApi as I, type SolanaClient as S, type TxIndexer as T, type WalletBalance as W, type TxIndexerOptions as a, createSolanaClient as b, createIndexer as c, parseSignature as d, type TokenAccountBalance as e, fetchWalletBalance as f, fetchWalletSignatures as g, fetchTransaction as h, fetchTransactionsBatch as i, isSpamTransaction as j, filterSpamTransactions as k, type SpamFilterConfig as l, parseAddress as p, transactionToLegs as t };

package/dist/client.d.ts

@@ -1,4 +1,4 @@
 import '@solana/kit';
-export { C as ClassifiedTransaction, F as FetchTransactionsConfig, G as GetTransactionsOptions, T as TxIndexer, a as TxIndexerOptions, c as createIndexer } from './client-BS9KUBU7.js';
-import './classification.types-w82k4B1F.js';
+export { C as ClassifiedTransaction, F as FetchTransactionsConfig, G as GetTransactionsOptions, T as TxIndexer, a as TxIndexerOptions, c as createIndexer } from './client-yGDWPKKf.js';
+import './classification.types-DlJe6bDZ.js';
 import 'zod';