@fairblock/stabletrust 1.0.3 → 1.0.7

package/examples/complete-flow.js

@@ -11,18 +11,19 @@ dotenv.config();
  * https://docs.fairblock.network/docs/confidential_transfers/technical_overview
  */
 
-// Currently configured for Arbitrum Sepolia confidential mirror contract.
+// Currently configured for Ethereum Sepolia confidential mirror contract.
 // You can deploy your own confidential contract on any EVM network and use that.
 const CONTRACT_ADDRESS =
-  process.env.CONTRACT_ADDRESS || "0x5acE788EF0C9f7f902642001d639AD155fF29A6C";
+  process.env.CONTRACT_ADDRESS || "0xD765Dff7D734ABE09f88991A46BAb73ACa8910EF";
 // Standard ERC20 token contract. Any ERC20 on this chain ID can be used.
 const TOKEN_ADDRESS =
-  process.env.TOKEN_ADDRESS || "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+  process.env.TOKEN_ADDRESS || "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238";
 const RPC_URL =
-  process.env.ARBITRUM_RPC_URL || "https://sepolia-rollup.arbitrum.io/rpc";
+  process.env.ETHEREUM_RPC_URL || "https://ethereum-sepolia-rpc.publicnode.com";
 const EXPLORER_URL =
-  process.env.EXPLORER_URL || "https://sepolia.arbiscan.io/tx/";
-const CHAIN_ID = process.env.CHAIN_ID || 421614;
+  process.env.EXPLORER_URL || "https://sepolia.etherscan.io/tx/";
+const CHAIN_ID = process.env.CHAIN_ID || 11155111;
+1;
 
 /**
  * Performance Utility: Tracks execution time and provides timestamps

package/examples/simple-snippets.js

@@ -3,14 +3,14 @@ import dotenv from "dotenv";
 import { ConfidentialTransferClient } from "@fairblock/stabletrust";
 dotenv.config();
 const RPC_URL =
-  process.env.ARBITRUM_RPC_URL || "https://sepolia-rollup.arbitrum.io/rpc";
+  process.env.RPC_URL || "https://ethereum-sepolia-rpc.publicnode.com";
 const EXPLORER_URL =
-  process.env.EXPLORER_URL || "https://sepolia.arbiscan.io/tx/";
+  process.env.EXPLORER_URL || "https://sepolia.etherscan.io/tx/";
 async function minimalFlow() {
   // 1. Setup Client & Wallets
   const client = new ConfidentialTransferClient(
     RPC_URL,
-    "0xDC7Df05C2ce67881CDbF9A1af0F4C5d8C94c8A03",
+    "0xD765Dff7D734ABE09f88991A46BAb73ACa8910EF",
     421614,
   );
 
@@ -25,7 +25,7 @@ async function minimalFlow() {
   await client.ensureAccount(sender);
   await client.ensureAccount(recipient);
 
-  const TOKEN = "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d";
+  const TOKEN = "0xD765Dff7D734ABE09f88991A46BAb73ACa8910EF";
   const amount = ethers.parseUnits("0.001", 6);
   let res;
   // 3. DEPOSIT: Move public ERC20 into the confidential contract

package/package.json

@@ -1,16 +1,21 @@
 {
   "name": "@fairblock/stabletrust",
-  "version": "1.0.3",
+  "version": "1.0.7",
   "description": "SDK for confidential transfers using homomorphic encryption and zero-knowledge proofs",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "type": "module",
+  "sideEffects": [
+    "**/*.wasm"
+  ],
   "exports": {
     ".": {
       "types": "./src/index.d.ts",
-      "import": "./src/index.js"
+      "import": "./src/index.js",
+      "default": "./src/index.js"
     },
-    "./wasm": "./pkg/confidential_transfer_proof_generation.js"
+    "./wasm": "./pkg/confidential_transfer_proof_generation.js",
+    "./pkg/*.wasm": "./pkg/*.wasm"
   },
   "files": [
     "src/",

package/src/client.js

@@ -311,10 +311,6 @@ export class ConfidentialTransferClient {
    * @param {string} recipientAddress - Recipient's address
    * @param {string} tokenAddress - Token address to transfer
    * @param {number} amount - Amount to transfer
-   * @param {Object} senderKeys - Sender's encryption keys
-   * @param {string} recipientPublicKey - Recipient's public key
-   * @param {string} currentBalanceCiphertext - Current balance ciphertext
-   * @param {number} currentBalance - Current balance (decrypted)
    * @param {Object} [options] - Options
    * @param {boolean} [options.useOffchainVerify=false] - Use offchain verification
    * @param {boolean} [options.waitForFinalization=true] - Wait for transfer finalization
@@ -658,9 +654,6 @@ export class ConfidentialTransferClient {
    * @param {ethers.Wallet|ethers.Signer} wallet - The wallet to withdraw from
    * @param {string} tokenAddress - Token address to withdraw
    * @param {number} amount - Amount to withdraw
-   * @param {Object} keys - Encryption keys
-   * @param {string} currentBalanceCiphertext - Current balance ciphertext
-   * @param {number} currentBalance - Current balance (decrypted)
    * @param {Object} [options] - Options
    * @param {boolean} [options.useOffchainVerify=false] - Use offchain verification
    * @param {boolean} [options.waitForFinalization=true] - Wait for withdrawal finalization

package/src/index.d.ts

@@ -90,7 +90,7 @@ declare module "@fairblock/stabletrust" {
      * @param contractAddress Confidential transfer contract address
      * @param chainId Chain ID
      */
-    constructor(rpcUrl: string, contractAddress: string, chainId?: number);
+    constructor(rpcUrl: string, contractAddress: string, chainId: number);
 
     /**
      * Derive encryption keys for a wallet
@@ -168,18 +168,12 @@ declare module "@fairblock/stabletrust" {
      * @param wallet Wallet to withdraw to
      * @param tokenAddress Token contract address to withdraw
      * @param amount Amount to withdraw
-     * @param keys Encryption keys
-     * @param currentBalanceCiphertext Current balance ciphertext
-     * @param currentBalance Current balance (decrypted)
      * @param options Withdrawal options
      */
     withdraw(
       wallet: ethers.Wallet | ethers.Signer,
       tokenAddress: string,
       amount: number,
-      keys: Keys,
-      currentBalanceCiphertext: string,
-      currentBalance: number,
       options?: WithdrawOptions,
     ): Promise<ethers.ContractTransactionReceipt>;
 

package/src/wasm-loader.js

@@ -1,6 +1,3 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
 import init, {
   generate_deterministic_keypair,
   generate_transfer_proof,
@@ -8,19 +5,31 @@ import init, {
   decrypt_ciphertext,
 } from "../pkg/confidential_transfer_proof_generation.js";
 
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
 let isInitialized = false;
+let initPromise = null;
 
 /**
  * Initialize the WASM module
  * This must be called before using the SDK
  *
- * @param {Buffer|Uint8Array|string} [wasmPath] - Optional custom WASM file path or buffer
+ * In browsers, the WASM file is automatically loaded using bundler's asset handling.
+ * In Node.js, the WASM file is loaded from the filesystem.
+ *
+ * @param {Buffer|Uint8Array|string|URL} [input] - Optional custom WASM file path, URL, or buffer
  * @returns {Promise<Object>} WASM module functions
  */
-export async function initializeWasm(wasmPath) {
+export async function initializeWasm(input) {
+  // Return existing initialization if already in progress or complete
+  if (initPromise) {
+    await initPromise;
+    return {
+      generate_deterministic_keypair,
+      generate_transfer_proof,
+      generate_withdraw_proof,
+      decrypt_ciphertext,
+    };
+  }
+
   if (isInitialized) {
     return {
       generate_deterministic_keypair,
@@ -30,40 +39,57 @@ export async function initializeWasm(wasmPath) {
     };
   }
 
-  try {
-    let wasmBuffer;
+  // Create initialization promise
+  initPromise = (async () => {
+    try {
+      // Detect Node.js environment
+      const isNode =
+        typeof process !== "undefined" &&
+        process.versions != null &&
+        process.versions.node != null;
 
-    if (wasmPath) {
-      // If a custom path or buffer is provided
-      if (typeof wasmPath === "string") {
-        wasmBuffer = fs.readFileSync(wasmPath);
+      if (input) {
+        // User provided custom input
+        await init(input);
+      } else if (isNode) {
+        // Node.js: Load from filesystem
+        const fs = await import("fs");
+        const path = await import("path");
+        const { fileURLToPath } = await import("url");
+
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const wasmPath = path.resolve(
+          __dirname,
+          "../pkg/confidential_transfer_proof_generation_bg.wasm",
+        );
+        const wasmBuffer = fs.readFileSync(wasmPath);
+
+        await init(wasmBuffer);
       } else {
-        wasmBuffer = wasmPath;
+        // Browser: Let the generated code handle it automatically
+        // It will use new URL(..., import.meta.url) which bundlers handle correctly
+        await init();
       }
-    } else {
-      // Use the bundled WASM file
-      const defaultWasmPath = path.resolve(
-        __dirname,
-        "../pkg/confidential_transfer_proof_generation_bg.wasm",
+
+      isInitialized = true;
+    } catch (error) {
+      initPromise = null; // Reset on failure so it can be retried
+      throw new Error(
+        `Failed to initialize WASM module: ${error.message}. ` +
+          `Make sure the WASM file exists at the expected location.`,
       );
-      wasmBuffer = fs.readFileSync(defaultWasmPath);
     }
+  })();
 
-    await init(wasmBuffer);
-    isInitialized = true;
+  await initPromise;
 
-    return {
-      generate_deterministic_keypair,
-      generate_transfer_proof,
-      generate_withdraw_proof,
-      decrypt_ciphertext,
-    };
-  } catch (error) {
-    throw new Error(
-      `Failed to initialize WASM module: ${error.message}. ` +
-        `Make sure the WASM file exists at the expected location.`,
-    );
-  }
+  return {
+    generate_deterministic_keypair,
+    generate_transfer_proof,
+    generate_withdraw_proof,
+    decrypt_ciphertext,
+  };
 }
 
 /**