@adelos/sdk 0.1.10 → 0.1.12

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: {
@@ -101,17 +115,17 @@ declare function generateStealthAddress(recipientMetaPk: Uint8Array): {
     sharedSecret: Uint8Array<ArrayBufferLike>;
     memo: string;
 };
+/**
+ * Sign a message using a raw private SCALAR (not seed).
+ * Required because derived stealth keys are scalars, not seeds.
+ * Uses a random nonce for R, valid for Ed25519.
+ */
+declare function signWithScalar(message: Uint8Array, scalarBytes: Uint8Array): Promise<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 +138,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 +166,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, signWithScalar };

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: {
@@ -101,17 +115,17 @@ declare function generateStealthAddress(recipientMetaPk: Uint8Array): {
     sharedSecret: Uint8Array<ArrayBufferLike>;
     memo: string;
 };
+/**
+ * Sign a message using a raw private SCALAR (not seed).
+ * Required because derived stealth keys are scalars, not seeds.
+ * Uses a random nonce for R, valid for Ed25519.
+ */
+declare function signWithScalar(message: Uint8Array, scalarBytes: Uint8Array): Promise<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 +138,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 +166,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, signWithScalar };

package/dist/index.js

@@ -53,7 +53,8 @@ __export(index_exports, {
   hexToBytes: () => hexToBytes,
   isValidMetaPubkey: () => isValidMetaPubkey,
   parseStealthMemo: () => parseStealthMemo,
-  recoverStealthSecretKey: () => recoverStealthSecretKey
+  recoverStealthSecretKey: () => recoverStealthSecretKey,
+  signWithScalar: () => signWithScalar
 });
 module.exports = __toCommonJS(index_exports);
 var import_web33 = require("@solana/web3.js");
@@ -186,6 +187,27 @@ function generateStealthAddress(recipientMetaPk) {
   const memo = generateStealthMemo(ephemeralKeypair.publicKey);
   return { stealthPubkey, ephemeralKeypair, sharedSecret, memo };
 }
+async function signWithScalar(message, scalarBytes) {
+  const scalar = toScalar(scalarBytes);
+  const pubPoint = ed.ExtendedPoint.BASE.multiply(scalar);
+  const pubBytes = pubPoint.toRawBytes();
+  const rBytes = ed.utils.randomPrivateKey();
+  const rScalar = toScalar(rBytes);
+  const R = ed.ExtendedPoint.BASE.multiply(rScalar);
+  const RBytes = R.toRawBytes();
+  const content = new Uint8Array(RBytes.length + pubBytes.length + message.length);
+  content.set(RBytes);
+  content.set(pubBytes, RBytes.length);
+  content.set(message, RBytes.length + pubBytes.length);
+  const hram = (0, import_sha512.sha512)(content);
+  const k = ed.etc.mod(BigInt("0x" + bytesToHex(hram)), ed.CURVE.n);
+  const S = ed.etc.mod(rScalar + k * scalar, ed.CURVE.n);
+  const SBytes = hexToBytes(S.toString(16).padStart(64, "0"));
+  const signature = new Uint8Array(64);
+  signature.set(RBytes);
+  signature.set(SBytes, 32);
+  return signature;
+}
 
 // src/logger.ts
 var debugMode = false;
@@ -240,7 +262,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 +294,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 +406,38 @@ 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 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);
+    const serializedMessage = message.serialize();
+    const signature = await signWithScalar(serializedMessage, stealthSecretKey);
+    tx.addSignature(stealthAddress, Buffer.from(signature));
+    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();
@@ -420,5 +487,6 @@ var AdelosSDK = class {
   hexToBytes,
   isValidMetaPubkey,
   parseStealthMemo,
-  recoverStealthSecretKey
+  recoverStealthSecretKey,
+  signWithScalar
 });

package/dist/index.mjs

@@ -137,6 +137,27 @@ function generateStealthAddress(recipientMetaPk) {
   const memo = generateStealthMemo(ephemeralKeypair.publicKey);
   return { stealthPubkey, ephemeralKeypair, sharedSecret, memo };
 }
+async function signWithScalar(message, scalarBytes) {
+  const scalar = toScalar(scalarBytes);
+  const pubPoint = ed.ExtendedPoint.BASE.multiply(scalar);
+  const pubBytes = pubPoint.toRawBytes();
+  const rBytes = ed.utils.randomPrivateKey();
+  const rScalar = toScalar(rBytes);
+  const R = ed.ExtendedPoint.BASE.multiply(rScalar);
+  const RBytes = R.toRawBytes();
+  const content = new Uint8Array(RBytes.length + pubBytes.length + message.length);
+  content.set(RBytes);
+  content.set(pubBytes, RBytes.length);
+  content.set(message, RBytes.length + pubBytes.length);
+  const hram = sha512(content);
+  const k = ed.etc.mod(BigInt("0x" + bytesToHex(hram)), ed.CURVE.n);
+  const S = ed.etc.mod(rScalar + k * scalar, ed.CURVE.n);
+  const SBytes = hexToBytes(S.toString(16).padStart(64, "0"));
+  const signature = new Uint8Array(64);
+  signature.set(RBytes);
+  signature.set(SBytes, 32);
+  return signature;
+}
 
 // src/logger.ts
 var debugMode = false;
@@ -191,7 +212,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 +244,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 +356,38 @@ 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 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);
+    const serializedMessage = message.serialize();
+    const signature = await signWithScalar(serializedMessage, stealthSecretKey);
+    tx.addSignature(stealthAddress, Buffer.from(signature));
+    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();
@@ -370,5 +436,6 @@ export {
   hexToBytes,
   isValidMetaPubkey,
   parseStealthMemo,
-  recoverStealthSecretKey
+  recoverStealthSecretKey,
+  signWithScalar
 };

package/package.json

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