tx-indexer 0.4.1 → 0.5.1

package/README.md

@@ -37,10 +37,22 @@ 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
-- `swap` - Token exchanges (Jupiter, Raydium, Orca)
+- `swap` - Token exchanges (pattern-based detection works with any DEX, higher confidence for known protocols like Jupiter, Raydium, Orca)
 - `nft_mint` - NFT minting (Metaplex, Candy Machine, Bubblegum)
 - `stake_deposit` - SOL staking deposits
 - `stake_withdraw` - SOL staking withdrawals

package/dist/client.js

@@ -706,7 +706,7 @@ var TransferClassifier = class {
       sender,
       receiver,
       counterparty: {
-        type: "wallet",
+        type: "unknown",
         address: receiver,
         name: `${receiver.slice(0, 8)}...`
       },
@@ -876,37 +876,56 @@ var SwapClassifier = class {
   name = "swap";
   priority = 80;
   classify(context) {
-    const { legs, tx } = context;
-    const hasDexProtocol = isDexProtocolById(tx.protocol?.id);
-    if (!hasDexProtocol) {
-      return null;
-    }
+    const { legs, tx, walletAddress } = context;
     const feeLeg = legs.find(
       (leg) => leg.role === "fee" && leg.side === "debit"
     );
     const initiator = feeLeg?.accountId.replace("external:", "") ?? null;
-    const tokensOut = legs.filter(
-      (leg) => leg.accountId.startsWith("external:") && leg.side === "debit" && (leg.role === "sent" || leg.role === "protocol_deposit")
+    if (!initiator) {
+      return null;
+    }
+    const initiatorAccountId = `external:${initiator}`;
+    const initiatorTokensOut = legs.filter(
+      (leg) => leg.accountId === initiatorAccountId && leg.side === "debit" && (leg.role === "sent" || leg.role === "protocol_deposit")
     );
-    const tokensIn = legs.filter(
-      (leg) => leg.accountId.startsWith("external:") && leg.side === "credit" && (leg.role === "received" || leg.role === "protocol_withdraw")
+    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: 0.9,
+      confidence,
       isRelevant: true,
       metadata: {
         swap_type: "token_to_token",
@@ -1038,7 +1057,7 @@ var SolanaPayClassifier = class {
       counterparty: receiver ? {
         address: receiver,
         name: memo.merchant ?? void 0,
-        type: memo.merchant ? "merchant" : "wallet"
+        type: memo.merchant ? "merchant" : "unknown"
       } : null,
       confidence: 0.98,
       isRelevant: true,
@@ -1246,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) {
@@ -1268,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
@@ -1446,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);
@@ -1458,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;
@@ -1479,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);