@waaskey/sdk 0.1.0 → 0.2.1

package/dist/index.d.cts

@@ -559,12 +559,12 @@ declare class WasmMpcCore implements MpcCore {
  * lockstep with the `@waaskey/client-wasm` entry in `package.json` and with
  * {@link CLIENT_WASM_SHA384}.
  *
- * **`0.2.0` adds the ed25519 (FROST) exports** (`keygenEddsa` / `signEddsa`, waas-core #110) the SDK's
- * ed25519 wallet path drives. It is **published on npm** (`client-wasm-v0.2.0`) and pinned as the SDK's
+ * **`0.2.x` adds the ed25519 (FROST) exports** (`keygenEddsa` / `signEddsa`, waas-core #110) the SDK's
+ * ed25519 wallet path drives. It is **published on npm** (`client-wasm-v0.2.1`) and pinned as the SDK's
  * exact, optional peer dependency in `package.json` — so an app that installs `@waaskey/client-wasm`
  * alongside the SDK runs the real ed25519 create/send path end to end.
  */
-declare const CLIENT_WASM_VERSION = "0.2.0";
+declare const CLIENT_WASM_VERSION = "0.2.1";
 /**
  * Verify the integrity of raw wasm bytes against an expected **SHA-384** hash, in
  * Subresource-Integrity (`sha384-<base64>`) form (issue #40).
@@ -658,11 +658,21 @@ interface PrimePoolOptions {
     targetSize?: number;
     /** Persistence for the pool. Defaults to an in-memory store. */
     store?: PrimePoolStore;
+    /**
+     * Kick off a refill automatically after every {@link PrimePool.take}. Default `false`:
+     * unless the core generates primes in a Web Worker, wasm prime generation is a
+     * synchronous CPU burn on the calling thread — a "background" refill starves the event
+     * loop and stalls the very keygen ceremony the take() was for (it also freezes a
+     * browser UI). Refill explicitly via {@link PrimePool.ensure} (`wallets.prewarm`) at
+     * boot/idle, or set `true` only when the core is worker-backed.
+     */
+    autoRefill?: boolean;
 }
 declare class PrimePool {
     private readonly core;
     private readonly store;
     private readonly targetSize;
+    private readonly autoRefill;
     /** Per-curve in-flight refill, so concurrent calls don't over-generate. */
     private readonly refilling;
     constructor(core: PrimeGenerator, options?: PrimePoolOptions);
@@ -674,8 +684,9 @@ declare class PrimePool {
     private refill;
     /**
      * Claim a prime for a keygen. Returns a cached one instantly when the pool is warm; otherwise
-     * generates one inline (the slow fallback) so keygen never fails on an empty pool. Either way it
-     * kicks off a background refill so the next wallet is instant.
+     * generates one inline (the slow fallback) so keygen never fails on an empty pool. Refill the
+     * pool for the next wallet via {@link ensure} at idle (or opt into `autoRefill` when the core
+     * is worker-backed).
      */
     take(curve: MpcCurve): Promise<string>;
 }
@@ -880,6 +891,12 @@ interface WaaskeyOptions {
      * `EncryptedShareStore.browser(secret)`). Required to create a wallet.
      */
     shareStore?: ShareStore;
+    /**
+     * Optional pool of pre-generated Paillier primes (`new PrimePool(mpc)`). When set,
+     * `wallets.prewarm(chain)` fills it off the hot path and `wallets.create` claims from
+     * it instead of generating inline — turning minutes of keygen into seconds.
+     */
+    primePool?: PrimePool;
     /**
      * Per-chain provider config for client-side balance reads (RPC URL or a custom
      * provider). EVM chains have built-in public-RPC defaults; override them here.
@@ -2193,6 +2210,13 @@ declare class Wallets {
      * No-op when no prime pool is configured.
      */
     prewarm(chain: CreateWalletParams['chain']): Promise<void>;
+    /**
+     * List the tenant's wallets, newest first (paginated). Returns plain {@link WalletData}
+     * rows — pass an `id` to {@link get} to obtain a signing-capable {@link Wallet}.
+     */
+    list(query?: PageQuery, options?: {
+        signal?: AbortSignal;
+    }): Promise<Page<WalletData>>;
     /** Load an existing wallet by id. */
     get(id: string, options?: {
         signal?: AbortSignal;

package/dist/index.d.ts

@@ -559,12 +559,12 @@ declare class WasmMpcCore implements MpcCore {
  * lockstep with the `@waaskey/client-wasm` entry in `package.json` and with
  * {@link CLIENT_WASM_SHA384}.
  *
- * **`0.2.0` adds the ed25519 (FROST) exports** (`keygenEddsa` / `signEddsa`, waas-core #110) the SDK's
- * ed25519 wallet path drives. It is **published on npm** (`client-wasm-v0.2.0`) and pinned as the SDK's
+ * **`0.2.x` adds the ed25519 (FROST) exports** (`keygenEddsa` / `signEddsa`, waas-core #110) the SDK's
+ * ed25519 wallet path drives. It is **published on npm** (`client-wasm-v0.2.1`) and pinned as the SDK's
  * exact, optional peer dependency in `package.json` — so an app that installs `@waaskey/client-wasm`
  * alongside the SDK runs the real ed25519 create/send path end to end.
  */
-declare const CLIENT_WASM_VERSION = "0.2.0";
+declare const CLIENT_WASM_VERSION = "0.2.1";
 /**
  * Verify the integrity of raw wasm bytes against an expected **SHA-384** hash, in
  * Subresource-Integrity (`sha384-<base64>`) form (issue #40).
@@ -658,11 +658,21 @@ interface PrimePoolOptions {
     targetSize?: number;
     /** Persistence for the pool. Defaults to an in-memory store. */
     store?: PrimePoolStore;
+    /**
+     * Kick off a refill automatically after every {@link PrimePool.take}. Default `false`:
+     * unless the core generates primes in a Web Worker, wasm prime generation is a
+     * synchronous CPU burn on the calling thread — a "background" refill starves the event
+     * loop and stalls the very keygen ceremony the take() was for (it also freezes a
+     * browser UI). Refill explicitly via {@link PrimePool.ensure} (`wallets.prewarm`) at
+     * boot/idle, or set `true` only when the core is worker-backed.
+     */
+    autoRefill?: boolean;
 }
 declare class PrimePool {
     private readonly core;
     private readonly store;
     private readonly targetSize;
+    private readonly autoRefill;
     /** Per-curve in-flight refill, so concurrent calls don't over-generate. */
     private readonly refilling;
     constructor(core: PrimeGenerator, options?: PrimePoolOptions);
@@ -674,8 +684,9 @@ declare class PrimePool {
     private refill;
     /**
      * Claim a prime for a keygen. Returns a cached one instantly when the pool is warm; otherwise
-     * generates one inline (the slow fallback) so keygen never fails on an empty pool. Either way it
-     * kicks off a background refill so the next wallet is instant.
+     * generates one inline (the slow fallback) so keygen never fails on an empty pool. Refill the
+     * pool for the next wallet via {@link ensure} at idle (or opt into `autoRefill` when the core
+     * is worker-backed).
      */
     take(curve: MpcCurve): Promise<string>;
 }
@@ -880,6 +891,12 @@ interface WaaskeyOptions {
      * `EncryptedShareStore.browser(secret)`). Required to create a wallet.
      */
     shareStore?: ShareStore;
+    /**
+     * Optional pool of pre-generated Paillier primes (`new PrimePool(mpc)`). When set,
+     * `wallets.prewarm(chain)` fills it off the hot path and `wallets.create` claims from
+     * it instead of generating inline — turning minutes of keygen into seconds.
+     */
+    primePool?: PrimePool;
     /**
      * Per-chain provider config for client-side balance reads (RPC URL or a custom
      * provider). EVM chains have built-in public-RPC defaults; override them here.
@@ -2193,6 +2210,13 @@ declare class Wallets {
      * No-op when no prime pool is configured.
      */
     prewarm(chain: CreateWalletParams['chain']): Promise<void>;
+    /**
+     * List the tenant's wallets, newest first (paginated). Returns plain {@link WalletData}
+     * rows — pass an `id` to {@link get} to obtain a signing-capable {@link Wallet}.
+     */
+    list(query?: PageQuery, options?: {
+        signal?: AbortSignal;
+    }): Promise<Page<WalletData>>;
     /** Load an existing wallet by id. */
     get(id: string, options?: {
         signal?: AbortSignal;

package/dist/index.js

@@ -1284,6 +1284,17 @@ var Wallets = class {
     if (curve === "ed25519") return;
     await this.deps.primePool?.ensure(curve);
   }
+  /**
+   * List the tenant's wallets, newest first (paginated). Returns plain {@link WalletData}
+   * rows — pass an `id` to {@link get} to obtain a signing-capable {@link Wallet}.
+   */
+  async list(query = {}, options = {}) {
+    const qs = new URLSearchParams();
+    if (query.page !== void 0) qs.set("page", String(query.page));
+    if (query.limit !== void 0) qs.set("limit", String(query.limit));
+    const suffix = qs.toString() ? `?${qs}` : "";
+    return this.http.request("GET", `/v1/wallets${suffix}`, void 0, options.signal);
+  }
   /** Load an existing wallet by id. */
   async get(id, options = {}) {
     const data = await this.http.request("GET", `/v1/wallets/${id}`, void 0, options.signal);
@@ -1866,7 +1877,7 @@ var Waaskey = class {
     this.auth = new Auth(http);
     this.members = new Members(http);
     http.useMemberAccessToken(() => this.members.accessToken);
-    this.wallets = new Wallets(http, { mpc: options.mpc, shareStore: options.shareStore, analytics });
+    this.wallets = new Wallets(http, { mpc: options.mpc, shareStore: options.shareStore, primePool: options.primePool, analytics });
     this.recovery = new Recovery(http, { shareStore: options.shareStore, analytics });
     this.reshare = new Reshare(http, { mpc: options.mpc, shareStore: options.shareStore, analytics });
     this.balances = new Balances(options.chains, options.fetch);
@@ -2204,7 +2215,7 @@ function decodePublicKey(sharedPublicKeyJson) {
 
 // src/mpc/load-wasm.ts
 var CLIENT_WASM_PACKAGE = "@waaskey/client-wasm";
-var CLIENT_WASM_VERSION = "0.2.0";
+var CLIENT_WASM_VERSION = "0.2.1";
 async function verifyWasmIntegrity(bytes, expectedSha384) {
   if (!expectedSha384 || !expectedSha384.startsWith("sha384-")) {
     throw new Error("Waaskey: an expected SHA-384 integrity hash (sha384-<base64>) is required to load the wasm MPC core.");
@@ -2287,10 +2298,12 @@ var PrimePool = class {
     this.core = core;
     this.store = options.store ?? new MemoryPrimeStore();
     this.targetSize = Math.max(1, options.targetSize ?? 2);
+    this.autoRefill = options.autoRefill ?? false;
   }
   core;
   store;
   targetSize;
+  autoRefill;
   /** Per-curve in-flight refill, so concurrent calls don't over-generate. */
   refilling = /* @__PURE__ */ new Map();
   /**
@@ -2311,13 +2324,14 @@ var PrimePool = class {
   }
   /**
    * Claim a prime for a keygen. Returns a cached one instantly when the pool is warm; otherwise
-   * generates one inline (the slow fallback) so keygen never fails on an empty pool. Either way it
-   * kicks off a background refill so the next wallet is instant.
+   * generates one inline (the slow fallback) so keygen never fails on an empty pool. Refill the
+   * pool for the next wallet via {@link ensure} at idle (or opt into `autoRefill` when the core
+   * is worker-backed).
    */
   async take(curve) {
     const cached = await this.store.take(curve);
     const primes = cached ?? await this.core.pregeneratePrimes(curve);
-    void this.ensure(curve).catch(() => void 0);
+    if (this.autoRefill) void this.ensure(curve).catch(() => void 0);
     return primes;
   }
 };