tx-indexer 0.5.3 → 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

@@ -1101,21 +1101,38 @@ function determineTokenRole(change, tx, feePayer) {
 }
 
 // ../classification/src/classifiers/transfer-classifier.ts
+function findBestTransferPair(legs) {
+  const senderLegs = legs.filter(
+    (l) => l.accountId.startsWith("external:") && l.side === "debit" && l.role === "sent"
+  );
+  if (senderLegs.length === 0) return null;
+  let bestPair = null;
+  let bestAmount = 0;
+  for (const senderLeg of senderLegs) {
+    const receiverLeg = legs.find(
+      (l) => l.accountId.startsWith("external:") && l.side === "credit" && l.role === "received" && l.amount.token.mint === senderLeg.amount.token.mint && l.accountId !== senderLeg.accountId
+      // Must be different account
+    );
+    if (receiverLeg) {
+      const amount = senderLeg.amount.amountUi;
+      if (amount > bestAmount) {
+        bestAmount = amount;
+        bestPair = { senderLeg, receiverLeg };
+      }
+    }
+  }
+  return bestPair;
+}
 var TransferClassifier = class {
   name = "transfer";
   priority = 20;
   classify(context) {
     const { legs, tx } = context;
     const facilitator = tx.accountKeys ? detectFacilitator(tx.accountKeys) : null;
-    const senderLeg = legs.find(
-      (l) => l.accountId.startsWith("external:") && l.side === "debit" && l.role === "sent"
-    );
-    if (!senderLeg) return null;
+    const pair = findBestTransferPair(legs);
+    if (!pair) return null;
+    const { senderLeg, receiverLeg } = pair;
     const sender = senderLeg.accountId.replace("external:", "");
-    const receiverLeg = legs.find(
-      (l) => l.accountId.startsWith("external:") && l.side === "credit" && l.role === "received" && l.amount.token.mint === senderLeg.amount.token.mint
-    );
-    if (!receiverLeg) return null;
     const receiver = receiverLeg.accountId.replace("external:", "");
     return {
       primaryType: "transfer",
@@ -1594,6 +1611,27 @@ var FeeOnlyClassifier = class {
 };
 
 // ../classification/src/classifiers/solana-pay-classifier.ts
+function findBestTransferPair2(legs) {
+  const senderLegs = legs.filter(
+    (l) => l.accountId.startsWith("external:") && l.side === "debit" && l.role === "sent"
+  );
+  if (senderLegs.length === 0) return null;
+  let bestPair = null;
+  let bestAmount = 0;
+  for (const senderLeg of senderLegs) {
+    const receiverLeg = legs.find(
+      (l) => l.accountId.startsWith("external:") && l.side === "credit" && l.role === "received" && l.amount.token.mint === senderLeg.amount.token.mint && l.accountId !== senderLeg.accountId
+    );
+    if (receiverLeg) {
+      const amount = senderLeg.amount.amountUi;
+      if (amount > bestAmount) {
+        bestAmount = amount;
+        bestPair = { senderLeg, receiverLeg };
+      }
+    }
+  }
+  return bestPair;
+}
 var SolanaPayClassifier = class {
   name = "solana-pay";
   priority = 95;
@@ -1603,12 +1641,9 @@ var SolanaPayClassifier = class {
       return null;
     }
     const memo = parseSolanaPayMemo(tx.memo);
-    const senderLeg = legs.find(
-      (leg) => leg.accountId.startsWith("external:") && leg.side === "debit" && leg.role === "sent"
-    );
-    const receiverLeg = legs.find(
-      (leg) => leg.accountId.startsWith("external:") && leg.side === "credit" && leg.role === "received"
-    );
+    const pair = findBestTransferPair2(legs);
+    const senderLeg = pair?.senderLeg ?? null;
+    const receiverLeg = pair?.receiverLeg ?? null;
     const sender = senderLeg?.accountId.replace("external:", "") ?? null;
     const receiver = receiverLeg?.accountId.replace("external:", "") ?? null;
     const primaryAmount = senderLeg?.amount ?? receiverLeg?.amount ?? null;
@@ -1862,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;
@@ -1876,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) {
@@ -1892,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)
   );
 }
 
@@ -2310,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) {