tx-indexer 0.5.4 → 0.5.5

package/dist/{client-xmDVjOy4.d.ts → client-D8iyrH5w.d.ts}

@@ -110,27 +110,32 @@ interface SpamFilterConfig {
  * - Has low classification confidence
  * - Is not relevant to the wallet
  * - Involves dust amounts below configured thresholds
+ * - The wallet only received dust amounts (spam airdrops)
  *
  * @param tx - Raw transaction data
  * @param classification - Transaction classification result
  * @param config - Optional spam filter configuration (uses defaults if omitted)
+ * @param legs - Optional legs to check wallet involvement
+ * @param walletAddress - Optional wallet address to check involvement
  * @returns True if the transaction should be filtered as spam
  */
-declare function isSpamTransaction(tx: RawTransaction, classification: TransactionClassification, config?: SpamFilterConfig): boolean;
+declare function isSpamTransaction(tx: RawTransaction, classification: TransactionClassification, config?: SpamFilterConfig, legs?: TxLeg[], walletAddress?: string): boolean;
 /**
  * Filters an array of transactions to remove spam and dust transactions.
  *
  * Applies spam detection criteria to each transaction while preserving
  * additional properties in the returned array items.
  *
- * @param transactions - Array of transaction objects with tx and classification
+ * @param transactions - Array of transaction objects with tx, classification, and legs
  * @param config - Optional spam filter configuration
+ * @param walletAddress - Optional wallet address to check for dust airdrops
  * @returns Filtered array with spam transactions removed
  */
 declare function filterSpamTransactions<T extends {
     tx: RawTransaction;
     classification: TransactionClassification;
-}>(transactions: T[], config?: SpamFilterConfig): T[];
+    legs?: TxLeg[];
+}>(transactions: T[], config?: SpamFilterConfig, walletAddress?: string): T[];
 
 interface WalletBalance {
     address: string;

package/dist/client.d.ts

@@ -1,4 +1,4 @@
 import '@solana/kit';
-export { C as ClassifiedTransaction, F as FetchTransactionsConfig, b as GetTransactionOptions, G as GetTransactionsOptions, T as TxIndexer, a as TxIndexerOptions, c as createIndexer } from './client-xmDVjOy4.js';
+export { C as ClassifiedTransaction, F as FetchTransactionsConfig, b as GetTransactionOptions, G as GetTransactionsOptions, T as TxIndexer, a as TxIndexerOptions, c as createIndexer } from './client-D8iyrH5w.js';
 import './classification.types-h046WjuF.js';
 import 'zod';

package/dist/client.js

@@ -1897,7 +1897,7 @@ var DEFAULT_CONFIG2 = {
   minConfidence: 0.5,
   allowFailed: false
 };
-function isSpamTransaction(tx, classification, config = {}) {
+function isSpamTransaction(tx, classification, config = {}, legs, walletAddress) {
   const cfg = { ...DEFAULT_CONFIG2, ...config };
   if (!cfg.allowFailed && tx.err) {
     return true;
@@ -1911,6 +1911,11 @@ function isSpamTransaction(tx, classification, config = {}) {
   if (isDustTransaction(classification, cfg)) {
     return true;
   }
+  if (legs && walletAddress) {
+    if (isWalletDustOnly(legs, walletAddress, cfg)) {
+      return true;
+    }
+  }
   return false;
 }
 function isDustTransaction(classification, config) {
@@ -1927,9 +1932,40 @@ function isDustTransaction(classification, config) {
   }
   return Math.abs(amountUi) < config.minTokenAmountUsd;
 }
-function filterSpamTransactions(transactions, config) {
+function isWalletDustOnly(legs, walletAddress, config) {
+  const walletAccountId = `external:${walletAddress}`;
+  const walletLegs = legs.filter((leg) => leg.accountId === walletAccountId);
+  if (walletLegs.length === 0) {
+    return false;
+  }
+  const sentLegs = walletLegs.filter(
+    (leg) => leg.side === "debit" && leg.role === "sent"
+  );
+  for (const leg of sentLegs) {
+    if (!isDustAmount(leg.amount.token.symbol, leg.amount.amountUi, config)) {
+      return false;
+    }
+  }
+  const receivedLegs = walletLegs.filter(
+    (leg) => leg.side === "credit" && leg.role === "received"
+  );
+  for (const leg of receivedLegs) {
+    if (!isDustAmount(leg.amount.token.symbol, leg.amount.amountUi, config)) {
+      return false;
+    }
+  }
+  return receivedLegs.length > 0;
+}
+function isDustAmount(symbol, amountUi, config) {
+  const absAmount = Math.abs(amountUi);
+  if (symbol === "SOL" || symbol === "WSOL") {
+    return absAmount < config.minSolAmount;
+  }
+  return absAmount < config.minTokenAmountUsd;
+}
+function filterSpamTransactions(transactions, config, walletAddress) {
   return transactions.filter(
-    ({ tx, classification }) => !isSpamTransaction(tx, classification, config)
+    ({ tx, classification, legs }) => !isSpamTransaction(tx, classification, config, legs, walletAddress)
   );
 }
 
@@ -2345,7 +2381,11 @@ function createIndexer(options) {
           );
           return { tx, classification, legs };
         });
-        const nonSpam = filterSpamTransactions(classified, spamConfig);
+        const nonSpam = filterSpamTransactions(
+          classified,
+          spamConfig,
+          walletAddressStr
+        );
         accumulated.push(...nonSpam);
         const lastSignature = signatures[signatures.length - 1];
         if (lastSignature) {