@adelos/sdk 0.1.6 → 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 {
@@ -77,6 +79,8 @@ declare function generateEphemeralKeypair(): {
     secretKey: ed.Bytes;
     publicKey: ed.Bytes;
 };
+/** Derive Public Key from Secret Key */
+declare function derivePublicKey(secretKey: Uint8Array): Uint8Array;
 /** Compute Shared Secret (Sender) */
 declare function computeSharedSecret(ephemeralSk: Uint8Array, recipientMetaPk: Uint8Array): Uint8Array;
 /** Compute Shared Secret (Recipient) */
@@ -113,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;
@@ -122,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 {
@@ -141,4 +146,4 @@ declare class AdelosSDK {
     sendAndConfirm(signedTx: Transaction | VersionedTransaction): Promise<string>;
 }
 
-export { ADELOS_CONFIG, AdelosIndexer, type AdelosOptions, AdelosSDK, MEMO_PREFIX, MEMO_PROGRAM_ID, PROGRAM_ID, REGISTRY_SEED, RPC_URL, type RegistryAccount, type RegistryInfo, STEALTH_DOMAIN, type SolanaCluster, type StealthTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };
+export { ADELOS_CONFIG, AdelosIndexer, type AdelosOptions, AdelosSDK, MEMO_PREFIX, MEMO_PROGRAM_ID, PROGRAM_ID, REGISTRY_SEED, RPC_URL, type RegistryAccount, type RegistryInfo, STEALTH_DOMAIN, type SolanaCluster, type StealthTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, derivePublicKey, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };

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 {
@@ -77,6 +79,8 @@ declare function generateEphemeralKeypair(): {
     secretKey: ed.Bytes;
     publicKey: ed.Bytes;
 };
+/** Derive Public Key from Secret Key */
+declare function derivePublicKey(secretKey: Uint8Array): Uint8Array;
 /** Compute Shared Secret (Sender) */
 declare function computeSharedSecret(ephemeralSk: Uint8Array, recipientMetaPk: Uint8Array): Uint8Array;
 /** Compute Shared Secret (Recipient) */
@@ -113,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;
@@ -122,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 {
@@ -141,4 +146,4 @@ declare class AdelosSDK {
     sendAndConfirm(signedTx: Transaction | VersionedTransaction): Promise<string>;
 }
 
-export { ADELOS_CONFIG, AdelosIndexer, type AdelosOptions, AdelosSDK, MEMO_PREFIX, MEMO_PROGRAM_ID, PROGRAM_ID, REGISTRY_SEED, RPC_URL, type RegistryAccount, type RegistryInfo, STEALTH_DOMAIN, type SolanaCluster, type StealthTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };
+export { ADELOS_CONFIG, AdelosIndexer, type AdelosOptions, AdelosSDK, MEMO_PREFIX, MEMO_PROGRAM_ID, PROGRAM_ID, REGISTRY_SEED, RPC_URL, type RegistryAccount, type RegistryInfo, STEALTH_DOMAIN, type SolanaCluster, type StealthTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, derivePublicKey, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };

package/dist/index.js

@@ -43,6 +43,7 @@ __export(index_exports, {
   computeSharedSecret: () => computeSharedSecret,
   computeSharedSecretAsRecipient: () => computeSharedSecretAsRecipient,
   createIndexer: () => createIndexer,
+  derivePublicKey: () => derivePublicKey,
   deriveRegistryPda: () => deriveRegistryPda,
   deriveStealthPubkey: () => deriveStealthPubkey,
   generateEphemeralKeypair: () => generateEphemeralKeypair,
@@ -134,6 +135,10 @@ function generateEphemeralKeypair() {
   const publicKey = ed.ExtendedPoint.BASE.multiply(scalar).toRawBytes();
   return { secretKey, publicKey };
 }
+function derivePublicKey(secretKey) {
+  const scalar = toScalar(secretKey);
+  return ed.ExtendedPoint.BASE.multiply(scalar).toRawBytes();
+}
 function computeSharedSecret(ephemeralSk, recipientMetaPk) {
   const point = ed.ExtendedPoint.fromHex(bytesToHex(recipientMetaPk));
   const scalar = toScalar(ephemeralSk);
@@ -182,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);
@@ -252,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) {
@@ -349,6 +390,7 @@ var AdelosSDK = class {
   computeSharedSecret,
   computeSharedSecretAsRecipient,
   createIndexer,
+  derivePublicKey,
   deriveRegistryPda,
   deriveStealthPubkey,
   generateEphemeralKeypair,

package/dist/index.mjs

@@ -86,6 +86,10 @@ function generateEphemeralKeypair() {
   const publicKey = ed.ExtendedPoint.BASE.multiply(scalar).toRawBytes();
   return { secretKey, publicKey };
 }
+function derivePublicKey(secretKey) {
+  const scalar = toScalar(secretKey);
+  return ed.ExtendedPoint.BASE.multiply(scalar).toRawBytes();
+}
 function computeSharedSecret(ephemeralSk, recipientMetaPk) {
   const point = ed.ExtendedPoint.fromHex(bytesToHex(recipientMetaPk));
   const scalar = toScalar(ephemeralSk);
@@ -134,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);
@@ -204,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) {
@@ -300,6 +340,7 @@ export {
   computeSharedSecret,
   computeSharedSecretAsRecipient,
   createIndexer,
+  derivePublicKey,
   deriveRegistryPda,
   deriveStealthPubkey,
   generateEphemeralKeypair,

package/package.json

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