solana-privacy-scanner-core 0.1.0 → 0.1.2

package/dist/index.cjs

@@ -50,15 +50,14 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/rpc/client.js
+// src/rpc/client.ts
 var import_web3 = require("@solana/web3.js");
 var RateLimiter = class {
-  maxConcurrency;
-  activeRequests = 0;
-  queue = [];
   constructor(maxConcurrency) {
     this.maxConcurrency = maxConcurrency;
   }
+  activeRequests = 0;
+  queue = [];
   async acquire() {
     if (this.activeRequests < this.maxConcurrency) {
       this.activeRequests++;
@@ -92,14 +91,16 @@ var RPCClient = class {
   connection;
   config;
   rateLimiter;
-  constructor(config) {
+  constructor(configOrUrl) {
+    const config = typeof configOrUrl === "string" ? { rpcUrl: configOrUrl } : configOrUrl;
+    const rpcUrl = config.rpcUrl.trim();
     this.config = {
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
       timeout: config.timeout ?? 3e4,
       maxConcurrency: config.maxConcurrency ?? 10,
       debug: config.debug ?? false,
-      rpcUrl: config.rpcUrl
+      rpcUrl
     };
     const connectionConfig = {
       commitment: "confirmed",
@@ -130,7 +131,10 @@ var RPCClient = class {
       } catch (error) {
         lastError = error;
         if (this.config.debug) {
-          console.error(`[RPCClient] Error in ${operationName} (attempt ${attempt + 1}/${this.config.maxRetries + 1}):`, error);
+          console.error(
+            `[RPCClient] Error in ${operationName} (attempt ${attempt + 1}/${this.config.maxRetries + 1}):`,
+            error
+          );
         }
         if (attempt < this.config.maxRetries) {
           const delay = this.config.retryDelay * Math.pow(2, attempt);
@@ -139,7 +143,9 @@ var RPCClient = class {
       }
     }
     this.rateLimiter.release();
-    throw new Error(`RPC operation ${operationName} failed after ${this.config.maxRetries + 1} attempts: ${lastError?.message}`);
+    throw new Error(
+      `RPC operation ${operationName} failed after ${this.config.maxRetries + 1} attempts: ${lastError?.message}`
+    );
   }
   /**
    * Get the underlying Solana Connection
@@ -161,20 +167,29 @@ var RPCClient = class {
    * Get signatures for an address with retry and rate limiting
    */
   async getSignaturesForAddress(address, options) {
-    return this.executeWithRetry(async () => {
-      const { PublicKey } = await import("@solana/web3.js");
-      return this.connection.getSignaturesForAddress(new PublicKey(address), options);
-    }, `getSignaturesForAddress(${address})`);
+    return this.executeWithRetry(
+      async () => {
+        const { PublicKey } = await import("@solana/web3.js");
+        return this.connection.getSignaturesForAddress(
+          new PublicKey(address),
+          options
+        );
+      },
+      `getSignaturesForAddress(${address})`
+    );
   }
   /**
    * Get transaction details with retry and rate limiting
    */
   async getTransaction(signature, options) {
-    return this.executeWithRetry(async () => {
-      return this.connection.getTransaction(signature, {
-        maxSupportedTransactionVersion: options?.maxSupportedTransactionVersion ?? 0
-      });
-    }, `getTransaction(${signature})`);
+    return this.executeWithRetry(
+      async () => {
+        return this.connection.getTransaction(signature, {
+          maxSupportedTransactionVersion: options?.maxSupportedTransactionVersion ?? 0
+        });
+      },
+      `getTransaction(${signature})`
+    );
   }
   /**
    * Get multiple transactions in parallel (respects rate limiting)
@@ -187,54 +202,69 @@ var RPCClient = class {
    * Get token accounts by owner with retry and rate limiting
    */
   async getTokenAccountsByOwner(ownerAddress, mintAddress) {
-    return this.executeWithRetry(async () => {
-      const { PublicKey } = await import("@solana/web3.js");
-      const owner = new PublicKey(ownerAddress);
-      const TOKEN_PROGRAM_ID = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
-      if (mintAddress) {
-        const mint = new PublicKey(mintAddress);
-        return this.connection.getTokenAccountsByOwner(owner, { mint });
-      } else {
-        return this.connection.getTokenAccountsByOwner(owner, {
-          programId: TOKEN_PROGRAM_ID
-        });
-      }
-    }, `getTokenAccountsByOwner(${ownerAddress})`);
+    return this.executeWithRetry(
+      async () => {
+        const { PublicKey } = await import("@solana/web3.js");
+        const owner = new PublicKey(ownerAddress);
+        const TOKEN_PROGRAM_ID = new PublicKey("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA");
+        if (mintAddress) {
+          const mint = new PublicKey(mintAddress);
+          return this.connection.getTokenAccountsByOwner(owner, { mint });
+        } else {
+          return this.connection.getTokenAccountsByOwner(owner, {
+            programId: TOKEN_PROGRAM_ID
+          });
+        }
+      },
+      `getTokenAccountsByOwner(${ownerAddress})`
+    );
   }
   /**
    * Get program accounts with retry and rate limiting
    */
   async getProgramAccounts(programId, config) {
-    return this.executeWithRetry(async () => {
-      const { PublicKey } = await import("@solana/web3.js");
-      return this.connection.getProgramAccounts(new PublicKey(programId), config);
-    }, `getProgramAccounts(${programId})`);
+    return this.executeWithRetry(
+      async () => {
+        const { PublicKey } = await import("@solana/web3.js");
+        return this.connection.getProgramAccounts(new PublicKey(programId), config);
+      },
+      `getProgramAccounts(${programId})`
+    );
   }
   /**
    * Get account info with retry and rate limiting
    */
   async getAccountInfo(address) {
-    return this.executeWithRetry(async () => {
-      const { PublicKey } = await import("@solana/web3.js");
-      return this.connection.getAccountInfo(new PublicKey(address));
-    }, `getAccountInfo(${address})`);
+    return this.executeWithRetry(
+      async () => {
+        const { PublicKey } = await import("@solana/web3.js");
+        return this.connection.getAccountInfo(new PublicKey(address));
+      },
+      `getAccountInfo(${address})`
+    );
   }
   /**
    * Get multiple account infos in parallel (respects rate limiting)
    */
   async getMultipleAccountsInfo(addresses) {
-    return this.executeWithRetry(async () => {
-      const { PublicKey } = await import("@solana/web3.js");
-      const pubkeys = addresses.map((addr) => new PublicKey(addr));
-      return this.connection.getMultipleAccountsInfo(pubkeys);
-    }, `getMultipleAccountsInfo(${addresses.length} addresses)`);
+    return this.executeWithRetry(
+      async () => {
+        const { PublicKey } = await import("@solana/web3.js");
+        const pubkeys = addresses.map((addr) => new PublicKey(addr));
+        return this.connection.getMultipleAccountsInfo(pubkeys);
+      },
+      `getMultipleAccountsInfo(${addresses.length} addresses)`
+    );
   }
   /**
    * Check if the RPC connection is healthy
    */
   async healthCheck() {
     try {
-      const version = await this.executeWithRetry(() => this.connection.getVersion(), "healthCheck");
+      const version = await this.executeWithRetry(
+        () => this.connection.getVersion(),
+        "healthCheck"
+      );
       return !!version;
     } catch {
       return false;
@@ -242,7 +272,7 @@ var RPCClient = class {
   }
 };
 
-// src/collectors/index.js
+// src/collectors/index.ts
 async function collectWalletData(client, address, options = {}) {
   const maxSignatures = options.maxSignatures ?? 100;
   const includeTokenAccounts = options.includeTokenAccounts ?? true;
@@ -343,7 +373,7 @@ async function collectProgramData(client, programId, options = {}) {
   };
 }
 
-// src/normalizer/index.js
+// src/normalizer/index.ts
 var PROGRAM_IDS = {
   SYSTEM: "11111111111111111111111111111111",
   TOKEN: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
@@ -374,14 +404,11 @@ function extractSOLTransfers(tx, signature) {
       continue;
     }
     const diff = post - pre;
-    if (diff === 0)
-      continue;
+    if (diff === 0) continue;
     const account = accountKeys[i];
-    if (!account)
-      continue;
+    if (!account) continue;
     const address = typeof account === "string" ? account : account.pubkey?.toString();
-    if (!address)
-      continue;
+    if (!address) continue;
     if (diff > 0) {
       for (let j = 0; j < accountKeys.length; j++) {
         const preSender = preBalances[j];
@@ -391,11 +418,9 @@ function extractSOLTransfers(tx, signature) {
         }
         if (postSender < preSender) {
           const sender = accountKeys[j];
-          if (!sender)
-            continue;
+          if (!sender) continue;
           const senderAddress = typeof sender === "string" ? sender : sender.pubkey?.toString();
-          if (!senderAddress)
-            continue;
+          if (!senderAddress) continue;
           transfers.push({
             from: senderAddress,
             to: address,
@@ -421,7 +446,9 @@ function extractSPLTransfers(tx, signature) {
   const postTokenBalances = tx.meta.postTokenBalances;
   const balanceChanges = /* @__PURE__ */ new Map();
   for (const post of postTokenBalances) {
-    const pre = preTokenBalances.find((p) => p.accountIndex === post.accountIndex && p.mint === post.mint);
+    const pre = preTokenBalances.find(
+      (p) => p.accountIndex === post.accountIndex && p.mint === post.mint
+    );
     const preAmount = pre?.uiTokenAmount.uiAmount ?? 0;
     const postAmount = post.uiTokenAmount.uiAmount ?? 0;
     const change = postAmount - preAmount;
@@ -442,20 +469,16 @@ function extractSPLTransfers(tx, signature) {
       return;
     }
     const account = accountKeys[accountIndex];
-    if (!account)
-      return;
+    if (!account) return;
     const address = typeof account === "string" ? account : account.pubkey?.toString();
-    if (!address)
-      return;
+    if (!address) return;
     if (info.change > 0) {
       balanceChanges.forEach((senderInfo, senderIndex) => {
         if (senderInfo.mint === info.mint && senderInfo.change < 0 && senderIndex !== accountIndex && senderIndex < accountKeys.length) {
           const sender = accountKeys[senderIndex];
-          if (!sender)
-            return;
+          if (!sender) return;
           const senderAddress = typeof sender === "string" ? sender : sender.pubkey?.toString();
-          if (!senderAddress)
-            return;
+          if (!senderAddress) return;
           transfers.push({
             from: senderAddress,
             to: address,
@@ -563,8 +586,7 @@ function normalizeWalletData(rawData, labelProvider) {
   const allTransfers = [];
   const allInstructions = [];
   for (const rawTx of rawData.transactions) {
-    if (!rawTx.transaction)
-      continue;
+    if (!rawTx.transaction) continue;
     try {
       const solTransfers = extractSOLTransfers(rawTx.transaction, rawTx.signature);
       const splTransfers = extractSPLTransfers(rawTx.transaction, rawTx.signature);
@@ -644,8 +666,7 @@ function normalizeProgramData(rawData, labelProvider) {
   const allInstructions = [];
   const counterparties = /* @__PURE__ */ new Set();
   for (const rawTx of rawData.relatedTransactions) {
-    if (!rawTx.transaction)
-      continue;
+    if (!rawTx.transaction) continue;
     try {
       const solTransfers = extractSOLTransfers(rawTx.transaction, rawTx.signature);
       const splTransfers = extractSPLTransfers(rawTx.transaction, rawTx.signature);
@@ -679,7 +700,7 @@ function normalizeProgramData(rawData, labelProvider) {
   };
 }
 
-// src/heuristics/counterparty-reuse.js
+// src/heuristics/counterparty-reuse.ts
 function detectCounterpartyReuse(context) {
   if (context.targetType !== "wallet") {
     return null;
@@ -690,8 +711,7 @@ function detectCounterpartyReuse(context) {
   const interactionCounts = /* @__PURE__ */ new Map();
   for (const transfer of context.transfers) {
     const counterparty = transfer.from === context.target ? transfer.to : transfer.from;
-    if (counterparty === context.target)
-      continue;
+    if (counterparty === context.target) continue;
     interactionCounts.set(counterparty, (interactionCounts.get(counterparty) || 0) + 1);
   }
   const reusedCounterparties = Array.from(interactionCounts.entries()).filter(([_, count]) => count >= 3).sort((a, b) => b[1] - a[1]);
@@ -724,7 +744,7 @@ function detectCounterpartyReuse(context) {
   };
 }
 
-// src/heuristics/amount-reuse.js
+// src/heuristics/amount-reuse.ts
 function detectAmountReuse(context) {
   if (context.transfers.length < 3) {
     return null;
@@ -781,7 +801,7 @@ function detectAmountReuse(context) {
   };
 }
 
-// src/heuristics/timing-patterns.js
+// src/heuristics/timing-patterns.ts
 function detectTimingPatterns(context) {
   if (!context.timeRange.earliest || !context.timeRange.latest) {
     return null;
@@ -833,7 +853,7 @@ function detectTimingPatterns(context) {
   };
 }
 
-// src/heuristics/known-entity.js
+// src/heuristics/known-entity.ts
 function detectKnownEntityInteraction(context) {
   if (context.labels.size === 0) {
     return null;
@@ -887,7 +907,7 @@ function detectKnownEntityInteraction(context) {
   };
 }
 
-// src/heuristics/balance-traceability.js
+// src/heuristics/balance-traceability.ts
 function detectBalanceTraceability(context) {
   if (context.targetType !== "wallet" || context.transfers.length < 2) {
     return null;
@@ -948,7 +968,7 @@ function detectBalanceTraceability(context) {
   };
 }
 
-// src/scanner/index.js
+// src/scanner/index.ts
 var REPORT_VERSION = "1.0.0";
 var HEURISTICS = [
   detectCounterpartyReuse,
@@ -1039,7 +1059,7 @@ function generateReport(context) {
   };
 }
 
-// src/labels/provider.js
+// src/labels/provider.ts
 var import_fs = require("fs");
 var import_url = require("url");
 var import_path = require("path");