@adelos/sdk 0.1.10 → 0.1.11

package/dist/index.d.mts

@@ -22,6 +22,20 @@ interface RegistryInfo {
     account: RegistryAccount;
     exists: boolean;
 }
+/** Stealth transaction detected during scanning */
+interface StealthTransaction {
+    signature: string;
+    blockTime: number | null;
+    stealthAddress: PublicKey;
+    amount: bigint;
+    /** Ephemeral public key from memo - needed for withdraw */
+    ephemeralPk: Uint8Array;
+}
+/** Stealth transaction ready for withdrawal */
+interface WithdrawableTransaction extends StealthTransaction {
+    /** Recovered stealth secret key - used to sign withdraw tx */
+    stealthSecretKey: Uint8Array;
+}
 
 type SolanaCluster = "devnet";
 declare const ADELOS_CONFIG: {
@@ -106,12 +120,6 @@ declare function generateStealthAddress(recipientMetaPk: Uint8Array): {
  * Adelos Indexer - Privacy-Preserving Transaction Scanner
  */
 
-interface StealthTransaction {
-    signature: string;
-    blockTime: number | null;
-    stealthAddress: PublicKey;
-    amount: bigint;
-}
 declare class AdelosIndexer {
     private connection;
     constructor(connection: Connection);
@@ -124,7 +132,12 @@ declare class AdelosIndexer {
     attemptDecryption(tx: ParsedTransactionWithMeta, metaSk: Uint8Array, metaPk: Uint8Array): {
         stealthAddress: PublicKey;
         amount: bigint;
+        ephemeralPk: Uint8Array;
     } | null;
+    /**
+     * Prepare a stealth transaction for withdrawal by recovering the secret key.
+     */
+    prepareWithdraw(stealthTx: StealthTransaction, metaSk: Uint8Array, metaPk: Uint8Array): WithdrawableTransaction;
     private extractMemo;
 }
 /** Helper for quick initialization */
@@ -147,9 +160,24 @@ declare class AdelosSDK {
     createRegisterTransaction(owner: PublicKey, metaPubkey: Uint8Array, version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
     /** Membuat transaksi pembaruan identitas (jika sudah terdaftar) */
     createUpdateTransaction(owner: PublicKey, metaPubkey: Uint8Array, version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Create a withdraw transaction from stealth address to any destination.
+     * This enables both:
+     * - Withdraw to self (destination = user's main wallet)
+     * - Withdraw to any address (for enhanced privacy - no link to main wallet!)
+     *
+     * @param stealthSecretKey - The recovered stealth private key (from prepareWithdraw)
+     * @param stealthAddress - The stealth address holding the funds
+     * @param destination - Where to send the funds (can be ANY address)
+     * @param amountLamports - Amount to withdraw in lamports (use BigInt)
+     */
+    createWithdrawTransaction(stealthSecretKey: Uint8Array, stealthAddress: PublicKey, destination: PublicKey, amountLamports: bigint): Promise<{
+        transaction: VersionedTransaction;
+        signature: string;
+    }>;
     buildTransaction(payer: PublicKey, instructions: TransactionInstruction[], version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
     /** Satu fungsi kirim untuk semua jenis transaksi (Legacy/V0) */
     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, derivePublicKey, 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, type WithdrawableTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, derivePublicKey, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };

package/dist/index.d.ts

@@ -22,6 +22,20 @@ interface RegistryInfo {
     account: RegistryAccount;
     exists: boolean;
 }
+/** Stealth transaction detected during scanning */
+interface StealthTransaction {
+    signature: string;
+    blockTime: number | null;
+    stealthAddress: PublicKey;
+    amount: bigint;
+    /** Ephemeral public key from memo - needed for withdraw */
+    ephemeralPk: Uint8Array;
+}
+/** Stealth transaction ready for withdrawal */
+interface WithdrawableTransaction extends StealthTransaction {
+    /** Recovered stealth secret key - used to sign withdraw tx */
+    stealthSecretKey: Uint8Array;
+}
 
 type SolanaCluster = "devnet";
 declare const ADELOS_CONFIG: {
@@ -106,12 +120,6 @@ declare function generateStealthAddress(recipientMetaPk: Uint8Array): {
  * Adelos Indexer - Privacy-Preserving Transaction Scanner
  */
 
-interface StealthTransaction {
-    signature: string;
-    blockTime: number | null;
-    stealthAddress: PublicKey;
-    amount: bigint;
-}
 declare class AdelosIndexer {
     private connection;
     constructor(connection: Connection);
@@ -124,7 +132,12 @@ declare class AdelosIndexer {
     attemptDecryption(tx: ParsedTransactionWithMeta, metaSk: Uint8Array, metaPk: Uint8Array): {
         stealthAddress: PublicKey;
         amount: bigint;
+        ephemeralPk: Uint8Array;
     } | null;
+    /**
+     * Prepare a stealth transaction for withdrawal by recovering the secret key.
+     */
+    prepareWithdraw(stealthTx: StealthTransaction, metaSk: Uint8Array, metaPk: Uint8Array): WithdrawableTransaction;
     private extractMemo;
 }
 /** Helper for quick initialization */
@@ -147,9 +160,24 @@ declare class AdelosSDK {
     createRegisterTransaction(owner: PublicKey, metaPubkey: Uint8Array, version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
     /** Membuat transaksi pembaruan identitas (jika sudah terdaftar) */
     createUpdateTransaction(owner: PublicKey, metaPubkey: Uint8Array, version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
+    /**
+     * Create a withdraw transaction from stealth address to any destination.
+     * This enables both:
+     * - Withdraw to self (destination = user's main wallet)
+     * - Withdraw to any address (for enhanced privacy - no link to main wallet!)
+     *
+     * @param stealthSecretKey - The recovered stealth private key (from prepareWithdraw)
+     * @param stealthAddress - The stealth address holding the funds
+     * @param destination - Where to send the funds (can be ANY address)
+     * @param amountLamports - Amount to withdraw in lamports (use BigInt)
+     */
+    createWithdrawTransaction(stealthSecretKey: Uint8Array, stealthAddress: PublicKey, destination: PublicKey, amountLamports: bigint): Promise<{
+        transaction: VersionedTransaction;
+        signature: string;
+    }>;
     buildTransaction(payer: PublicKey, instructions: TransactionInstruction[], version?: "legacy" | "v0"): Promise<Transaction | VersionedTransaction>;
     /** Satu fungsi kirim untuk semua jenis transaksi (Legacy/V0) */
     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, derivePublicKey, 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, type WithdrawableTransaction, bytesToHex, computeSharedSecret, computeSharedSecretAsRecipient, createIndexer, derivePublicKey, deriveRegistryPda, deriveStealthPubkey, generateEphemeralKeypair, generateStealthAddress, generateStealthMemo, getDiscriminator, hexToBytes, isValidMetaPubkey, parseStealthMemo, recoverStealthSecretKey };

package/dist/index.js

@@ -240,7 +240,8 @@ var AdelosIndexer = class {
           signature: s.signature,
           blockTime: tx.blockTime ?? null,
           stealthAddress: detected.stealthAddress,
-          amount: detected.amount
+          amount: detected.amount,
+          ephemeralPk: detected.ephemeralPk
         });
       } else {
         log(`  \u21B3 Not for this recipient`);
@@ -271,7 +272,19 @@ var AdelosIndexer = class {
     const change = BigInt(postBalances[idx] || 0) - BigInt(preBalances[idx] || 0);
     return {
       stealthAddress: accounts[idx].pubkey,
-      amount: change > 0n ? change : 0n
+      amount: change > 0n ? change : 0n,
+      ephemeralPk
+    };
+  }
+  /**
+   * Prepare a stealth transaction for withdrawal by recovering the secret key.
+   */
+  prepareWithdraw(stealthTx, metaSk, metaPk) {
+    const sharedSecret = computeSharedSecretAsRecipient(metaSk, stealthTx.ephemeralPk);
+    const stealthSecretKey = recoverStealthSecretKey(metaSk, sharedSecret);
+    return {
+      ...stealthTx,
+      stealthSecretKey
     };
   }
   extractMemo(tx) {
@@ -371,6 +384,41 @@ var AdelosSDK = class {
     });
     return this.buildTransaction(owner, [ix], version);
   }
+  /**
+   * Create a withdraw transaction from stealth address to any destination.
+   * This enables both:
+   * - Withdraw to self (destination = user's main wallet)
+   * - Withdraw to any address (for enhanced privacy - no link to main wallet!)
+   * 
+   * @param stealthSecretKey - The recovered stealth private key (from prepareWithdraw)
+   * @param stealthAddress - The stealth address holding the funds
+   * @param destination - Where to send the funds (can be ANY address)
+   * @param amountLamports - Amount to withdraw in lamports (use BigInt)
+   */
+  async createWithdrawTransaction(stealthSecretKey, stealthAddress, destination, amountLamports) {
+    const { Keypair } = await import("@solana/web3.js");
+    const stealthKeypair = Keypair.fromSeed(stealthSecretKey);
+    if (!stealthKeypair.publicKey.equals(stealthAddress)) {
+      throw new Error("Stealth secret key does not match stealth address");
+    }
+    const ix = import_web33.SystemProgram.transfer({
+      fromPubkey: stealthAddress,
+      toPubkey: destination,
+      lamports: amountLamports
+    });
+    const { blockhash } = await this.connection.getLatestBlockhash();
+    const message = new import_web33.TransactionMessage({
+      payerKey: stealthAddress,
+      // Stealth pays the fee
+      recentBlockhash: blockhash,
+      instructions: [ix]
+    }).compileToV0Message();
+    const tx = new import_web33.VersionedTransaction(message);
+    tx.sign([stealthKeypair]);
+    const sig = await this.connection.sendRawTransaction(tx.serialize());
+    await this.connection.confirmTransaction(sig, "confirmed");
+    return { transaction: tx, signature: sig };
+  }
   // --- 3. Core Engine (Internal Helpers) ---
   async buildTransaction(payer, instructions, version = "v0") {
     const { blockhash } = await this.connection.getLatestBlockhash();

package/dist/index.mjs

@@ -191,7 +191,8 @@ var AdelosIndexer = class {
           signature: s.signature,
           blockTime: tx.blockTime ?? null,
           stealthAddress: detected.stealthAddress,
-          amount: detected.amount
+          amount: detected.amount,
+          ephemeralPk: detected.ephemeralPk
         });
       } else {
         log(`  \u21B3 Not for this recipient`);
@@ -222,7 +223,19 @@ var AdelosIndexer = class {
     const change = BigInt(postBalances[idx] || 0) - BigInt(preBalances[idx] || 0);
     return {
       stealthAddress: accounts[idx].pubkey,
-      amount: change > 0n ? change : 0n
+      amount: change > 0n ? change : 0n,
+      ephemeralPk
+    };
+  }
+  /**
+   * Prepare a stealth transaction for withdrawal by recovering the secret key.
+   */
+  prepareWithdraw(stealthTx, metaSk, metaPk) {
+    const sharedSecret = computeSharedSecretAsRecipient(metaSk, stealthTx.ephemeralPk);
+    const stealthSecretKey = recoverStealthSecretKey(metaSk, sharedSecret);
+    return {
+      ...stealthTx,
+      stealthSecretKey
     };
   }
   extractMemo(tx) {
@@ -322,6 +335,41 @@ var AdelosSDK = class {
     });
     return this.buildTransaction(owner, [ix], version);
   }
+  /**
+   * Create a withdraw transaction from stealth address to any destination.
+   * This enables both:
+   * - Withdraw to self (destination = user's main wallet)
+   * - Withdraw to any address (for enhanced privacy - no link to main wallet!)
+   * 
+   * @param stealthSecretKey - The recovered stealth private key (from prepareWithdraw)
+   * @param stealthAddress - The stealth address holding the funds
+   * @param destination - Where to send the funds (can be ANY address)
+   * @param amountLamports - Amount to withdraw in lamports (use BigInt)
+   */
+  async createWithdrawTransaction(stealthSecretKey, stealthAddress, destination, amountLamports) {
+    const { Keypair } = await import("@solana/web3.js");
+    const stealthKeypair = Keypair.fromSeed(stealthSecretKey);
+    if (!stealthKeypair.publicKey.equals(stealthAddress)) {
+      throw new Error("Stealth secret key does not match stealth address");
+    }
+    const ix = SystemProgram.transfer({
+      fromPubkey: stealthAddress,
+      toPubkey: destination,
+      lamports: amountLamports
+    });
+    const { blockhash } = await this.connection.getLatestBlockhash();
+    const message = new TransactionMessage({
+      payerKey: stealthAddress,
+      // Stealth pays the fee
+      recentBlockhash: blockhash,
+      instructions: [ix]
+    }).compileToV0Message();
+    const tx = new VersionedTransaction(message);
+    tx.sign([stealthKeypair]);
+    const sig = await this.connection.sendRawTransaction(tx.serialize());
+    await this.connection.confirmTransaction(sig, "confirmed");
+    return { transaction: tx, signature: sig };
+  }
   // --- 3. Core Engine (Internal Helpers) ---
   async buildTransaction(payer, instructions, version = "v0") {
     const { blockhash } = await this.connection.getLatestBlockhash();

package/package.json

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