tx-indexer 0.5.0 → 0.5.1

package/README.md

@@ -37,6 +37,18 @@ console.log(tx.classification.sender);      // sender address
 console.log(tx.classification.receiver);    // receiver address
 ```
 
+## RPC Compatibility
+
+The SDK works with any Solana RPC for core features (transactions, balances, classification).
+
+NFT metadata enrichment requires a DAS-compatible RPC (Helius, Triton, etc.). If using a standard RPC, disable it:
+
+```typescript
+const txs = await indexer.getTransactions(address, {
+  enrichNftMetadata: false
+});
+```
+
 ## Transaction Types
 
 - `transfer` - Wallet-to-wallet transfers

package/dist/client.js

@@ -876,7 +876,7 @@ var SwapClassifier = class {
   name = "swap";
   priority = 80;
   classify(context) {
-    const { legs, tx } = context;
+    const { legs, tx, walletAddress } = context;
     const feeLeg = legs.find(
       (leg) => leg.role === "fee" && leg.side === "debit"
     );
@@ -885,28 +885,45 @@ var SwapClassifier = class {
       return null;
     }
     const initiatorAccountId = `external:${initiator}`;
-    const tokensOut = legs.filter(
+    const initiatorTokensOut = legs.filter(
       (leg) => leg.accountId === initiatorAccountId && leg.side === "debit" && (leg.role === "sent" || leg.role === "protocol_deposit")
     );
-    const tokensIn = legs.filter(
+    const initiatorTokensIn = legs.filter(
       (leg) => leg.accountId === initiatorAccountId && leg.side === "credit" && (leg.role === "received" || leg.role === "protocol_withdraw")
     );
-    if (tokensOut.length === 0 || tokensIn.length === 0) {
+    if (initiatorTokensOut.length === 0 || initiatorTokensIn.length === 0) {
       return null;
     }
-    const tokenOut = tokensOut[0];
-    const tokenIn = tokensIn[0];
-    if (tokenOut.amount.token.symbol === tokenIn.amount.token.symbol) {
+    const initiatorOut = initiatorTokensOut[0];
+    const initiatorIn = initiatorTokensIn[0];
+    if (initiatorOut.amount.token.symbol === initiatorIn.amount.token.symbol) {
       return null;
     }
+    let tokenOut = initiatorOut;
+    let tokenIn = initiatorIn;
+    let perspectiveWallet = initiator;
+    if (walletAddress) {
+      const walletAccountId = `external:${walletAddress}`;
+      const walletOut = legs.find(
+        (leg) => leg.accountId === walletAccountId && leg.side === "debit" && (leg.role === "sent" || leg.role === "protocol_deposit")
+      );
+      const walletIn = legs.find(
+        (leg) => leg.accountId === walletAccountId && leg.side === "credit" && (leg.role === "received" || leg.role === "protocol_withdraw")
+      );
+      if (walletOut && walletIn && walletOut.amount.token.symbol !== walletIn.amount.token.symbol) {
+        tokenOut = walletOut;
+        tokenIn = walletIn;
+        perspectiveWallet = walletAddress;
+      }
+    }
     const hasDexProtocol = isDexProtocolById(tx.protocol?.id);
     const confidence = hasDexProtocol ? 0.95 : 0.75;
     return {
       primaryType: "swap",
       primaryAmount: tokenOut.amount,
       secondaryAmount: tokenIn.amount,
-      sender: initiator,
-      receiver: initiator,
+      sender: perspectiveWallet,
+      receiver: perspectiveWallet,
       counterparty: null,
       confidence,
       isRelevant: true,
@@ -1248,8 +1265,8 @@ var ClassificationService = class {
     this.classifiers.push(classifier);
     this.classifiers.sort((a, b) => b.priority - a.priority);
   }
-  classify(legs, tx) {
-    const context = { legs, tx };
+  classify(legs, tx, walletAddress) {
+    const context = { legs, tx, walletAddress };
     for (const classifier of this.classifiers) {
       const result = classifier.classify(context);
       if (result && result.isRelevant) {
@@ -1270,8 +1287,8 @@ var ClassificationService = class {
   }
 };
 var classificationService = new ClassificationService();
-function classifyTransaction(legs, tx) {
-  return classificationService.classify(legs, tx);
+function classifyTransaction(legs, tx, walletAddress) {
+  return classificationService.classify(legs, tx, walletAddress);
 }
 
 // ../domain/src/tx/spam-filter.ts
@@ -1448,10 +1465,11 @@ function createIndexer(options) {
           client.rpc,
           signatureObjects
         );
+        const walletAddressStr2 = walletAddress.toString();
         const classified = transactions.map((tx) => {
           tx.protocol = detectProtocol(tx.programIds);
           const legs = transactionToLegs(tx);
-          const classification = classifyTransaction(legs, tx);
+          const classification = classifyTransaction(legs, tx, walletAddressStr2);
           return { tx, classification, legs };
         });
         return enrichBatch(classified);
@@ -1460,6 +1478,7 @@ function createIndexer(options) {
       let currentBefore = before;
       const MAX_ITERATIONS = 10;
       let iteration = 0;
+      const walletAddressStr = walletAddress.toString();
       while (accumulated.length < limit && iteration < MAX_ITERATIONS) {
         iteration++;
         const batchSize = iteration === 1 ? limit : limit * 2;
@@ -1481,7 +1500,7 @@ function createIndexer(options) {
         const classified = transactions.map((tx) => {
           tx.protocol = detectProtocol(tx.programIds);
           const legs = transactionToLegs(tx);
-          const classification = classifyTransaction(legs, tx);
+          const classification = classifyTransaction(legs, tx, walletAddressStr);
           return { tx, classification, legs };
         });
         const nonSpam = filterSpamTransactions(classified, spamConfig);