@adelos/sdk 0.1.7 → 0.1.8

package/dist/index.d.mts

@@ -13,6 +13,8 @@ interface AdelosOptions {
     rpcUrl?: string;
     /** Helius API key for indexer webhooks (optional) */
     heliusApiKey?: string;
+    /** Enable debug logging (optional - defaults to false) */
+    debug?: boolean;
 }
 /** Result of a registry lookup */
 interface RegistryInfo {
@@ -115,8 +117,9 @@ declare class AdelosIndexer {
     constructor(connection: Connection);
     /** Scan for stealth transfers to this recipient */
     scanForStealthTransfers(metaSk: Uint8Array, metaPk: Uint8Array, limit?: number): Promise<StealthTransaction[]>;
-    /** * Trial Decryption: Mengecek apakah transaksi ini milik user.
-     * Dibuat 'public' agar bisa dites di file testing.
+    /**
+     * Trial Decryption: Check if this transaction belongs to the user.
+     * Made 'public' for testing purposes.
      */
     attemptDecryption(tx: ParsedTransactionWithMeta, metaSk: Uint8Array, metaPk: Uint8Array): {
         stealthAddress: PublicKey;
@@ -124,7 +127,7 @@ declare class AdelosIndexer {
     } | null;
     private extractMemo;
 }
-/** Helper untuk inisialisasi cepat */
+/** Helper for quick initialization */
 declare function createIndexer(connection: Connection): AdelosIndexer;
 
 declare class AdelosSDK {

package/dist/index.d.ts

@@ -13,6 +13,8 @@ interface AdelosOptions {
     rpcUrl?: string;
     /** Helius API key for indexer webhooks (optional) */
     heliusApiKey?: string;
+    /** Enable debug logging (optional - defaults to false) */
+    debug?: boolean;
 }
 /** Result of a registry lookup */
 interface RegistryInfo {
@@ -115,8 +117,9 @@ declare class AdelosIndexer {
     constructor(connection: Connection);
     /** Scan for stealth transfers to this recipient */
     scanForStealthTransfers(metaSk: Uint8Array, metaPk: Uint8Array, limit?: number): Promise<StealthTransaction[]>;
-    /** * Trial Decryption: Mengecek apakah transaksi ini milik user.
-     * Dibuat 'public' agar bisa dites di file testing.
+    /**
+     * Trial Decryption: Check if this transaction belongs to the user.
+     * Made 'public' for testing purposes.
      */
     attemptDecryption(tx: ParsedTransactionWithMeta, metaSk: Uint8Array, metaPk: Uint8Array): {
         stealthAddress: PublicKey;
@@ -124,7 +127,7 @@ declare class AdelosIndexer {
     } | null;
     private extractMemo;
 }
-/** Helper untuk inisialisasi cepat */
+/** Helper for quick initialization */
 declare function createIndexer(connection: Connection): AdelosIndexer;
 
 declare class AdelosSDK {

package/dist/index.js

@@ -187,40 +187,73 @@ function generateStealthAddress(recipientMetaPk) {
   return { stealthPubkey, ephemeralKeypair, sharedSecret, memo };
 }
 
+// src/logger.ts
+var debugMode = false;
+function setDebugMode(enabled) {
+  debugMode = enabled;
+}
+function log(...args) {
+  if (debugMode) {
+    console.log(...args);
+  }
+}
+
 // src/indexer.ts
 var AdelosIndexer = class {
-  // Sekarang langsung menerima objek Connection yang sudah jadi
+  // Directly accepts Connection object
   constructor(connection) {
     this.connection = connection;
   }
   /** Scan for stealth transfers to this recipient */
   async scanForStealthTransfers(metaSk, metaPk, limit = 100) {
+    log(`[Indexer] Starting scan for stealth transfers (limit: ${limit})`);
+    const startTime = Date.now();
     const sigs = await this.connection.getSignaturesForAddress(
       ADELOS_CONFIG.MEMO_PROGRAM_ID,
       { limit }
     );
+    log(`[Indexer] Found ${sigs.length} memo program transactions to check`);
     const results = [];
+    let processed = 0;
+    let adelosMemos = 0;
     for (const s of sigs) {
+      processed++;
+      log(`[Indexer] Processing tx ${processed}/${sigs.length}: ${s.signature.substring(0, 10)}...`);
       const tx = await this.connection.getParsedTransaction(s.signature, {
         maxSupportedTransactionVersion: 0
       });
-      if (!tx) continue;
+      if (!tx) {
+        log(`  \u21B3 Skipped (tx not found)`);
+        continue;
+      }
       const memo = this.extractMemo(tx);
-      if (!memo?.startsWith(ADELOS_CONFIG.MEMO_PREFIX)) continue;
+      if (!memo?.startsWith(ADELOS_CONFIG.MEMO_PREFIX)) {
+        log(`  \u21B3 Skipped (not Adelos memo)`);
+        continue;
+      }
+      adelosMemos++;
+      log(`  \u21B3 Found Adelos memo! Attempting trial decryption...`);
       const detected = this.attemptDecryption(tx, metaSk, metaPk);
       if (detected) {
+        log(`  \u21B3 \u2705 MATCH! Stealth transfer detected: ${Number(detected.amount) / 1e9} SOL`);
         results.push({
           signature: s.signature,
           blockTime: tx.blockTime ?? null,
           stealthAddress: detected.stealthAddress,
           amount: detected.amount
         });
+      } else {
+        log(`  \u21B3 Not for this recipient`);
       }
     }
+    const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+    log(`[Indexer] Scan complete in ${elapsed}s`);
+    log(`[Indexer] Summary: ${processed} total, ${adelosMemos} Adelos memos, ${results.length} matches`);
     return results;
   }
-  /** * Trial Decryption: Mengecek apakah transaksi ini milik user.
-   * Dibuat 'public' agar bisa dites di file testing.
+  /**
+   * Trial Decryption: Check if this transaction belongs to the user.
+   * Made 'public' for testing purposes.
    */
   attemptDecryption(tx, metaSk, metaPk) {
     const memo = this.extractMemo(tx);
@@ -257,6 +290,9 @@ var AdelosSDK = class {
   constructor(options = {}) {
     this.connection = new import_web33.Connection(options.rpcUrl ?? ADELOS_CONFIG.RPC_URL, "confirmed");
     this.programId = ADELOS_CONFIG.PROGRAM_ID;
+    if (options.debug !== void 0) {
+      setDebugMode(options.debug);
+    }
   }
   // --- 1. Identity & Registry ---
   async getRegistry(owner) {

package/dist/index.mjs

@@ -138,40 +138,73 @@ function generateStealthAddress(recipientMetaPk) {
   return { stealthPubkey, ephemeralKeypair, sharedSecret, memo };
 }
 
+// src/logger.ts
+var debugMode = false;
+function setDebugMode(enabled) {
+  debugMode = enabled;
+}
+function log(...args) {
+  if (debugMode) {
+    console.log(...args);
+  }
+}
+
 // src/indexer.ts
 var AdelosIndexer = class {
-  // Sekarang langsung menerima objek Connection yang sudah jadi
+  // Directly accepts Connection object
   constructor(connection) {
     this.connection = connection;
   }
   /** Scan for stealth transfers to this recipient */
   async scanForStealthTransfers(metaSk, metaPk, limit = 100) {
+    log(`[Indexer] Starting scan for stealth transfers (limit: ${limit})`);
+    const startTime = Date.now();
     const sigs = await this.connection.getSignaturesForAddress(
       ADELOS_CONFIG.MEMO_PROGRAM_ID,
       { limit }
     );
+    log(`[Indexer] Found ${sigs.length} memo program transactions to check`);
     const results = [];
+    let processed = 0;
+    let adelosMemos = 0;
     for (const s of sigs) {
+      processed++;
+      log(`[Indexer] Processing tx ${processed}/${sigs.length}: ${s.signature.substring(0, 10)}...`);
       const tx = await this.connection.getParsedTransaction(s.signature, {
         maxSupportedTransactionVersion: 0
       });
-      if (!tx) continue;
+      if (!tx) {
+        log(`  \u21B3 Skipped (tx not found)`);
+        continue;
+      }
       const memo = this.extractMemo(tx);
-      if (!memo?.startsWith(ADELOS_CONFIG.MEMO_PREFIX)) continue;
+      if (!memo?.startsWith(ADELOS_CONFIG.MEMO_PREFIX)) {
+        log(`  \u21B3 Skipped (not Adelos memo)`);
+        continue;
+      }
+      adelosMemos++;
+      log(`  \u21B3 Found Adelos memo! Attempting trial decryption...`);
       const detected = this.attemptDecryption(tx, metaSk, metaPk);
       if (detected) {
+        log(`  \u21B3 \u2705 MATCH! Stealth transfer detected: ${Number(detected.amount) / 1e9} SOL`);
         results.push({
           signature: s.signature,
           blockTime: tx.blockTime ?? null,
           stealthAddress: detected.stealthAddress,
           amount: detected.amount
         });
+      } else {
+        log(`  \u21B3 Not for this recipient`);
       }
     }
+    const elapsed = ((Date.now() - startTime) / 1e3).toFixed(2);
+    log(`[Indexer] Scan complete in ${elapsed}s`);
+    log(`[Indexer] Summary: ${processed} total, ${adelosMemos} Adelos memos, ${results.length} matches`);
     return results;
   }
-  /** * Trial Decryption: Mengecek apakah transaksi ini milik user.
-   * Dibuat 'public' agar bisa dites di file testing.
+  /**
+   * Trial Decryption: Check if this transaction belongs to the user.
+   * Made 'public' for testing purposes.
    */
   attemptDecryption(tx, metaSk, metaPk) {
     const memo = this.extractMemo(tx);
@@ -208,6 +241,9 @@ var AdelosSDK = class {
   constructor(options = {}) {
     this.connection = new Connection(options.rpcUrl ?? ADELOS_CONFIG.RPC_URL, "confirmed");
     this.programId = ADELOS_CONFIG.PROGRAM_ID;
+    if (options.debug !== void 0) {
+      setDebugMode(options.debug);
+    }
   }
   // --- 1. Identity & Registry ---
   async getRegistry(owner) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adelos/sdk",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Adelos Protocol SDK - Privacy Stealth Transfers on Solana",
   "main": "dist/index.js",
   "module": "dist/index.mjs",