@permissionless-technologies/upp-sdk 0.2.1 → 0.3.1

package/dist/{index-C-jSNw6j.d.cts → index-o-Ds3YAq.d.cts}

@@ -1,8 +1,9 @@
 import { PublicClient, WalletClient, Address, Hex } from 'viem';
-import { r as ShieldParams, h as Note, O as TransferParams, M as MergeParams, Y as WithdrawParams, E as EncryptedNote } from './transfer-DKZuJnRM.cjs';
+import { q as ShieldParams, h as Note, L as TransferParams, M as MergeParams, X as WithdrawParams, E as EncryptedNote } from './transfer-BzyernBd.cjs';
 import { M as MasterKeys, O as OneTimeKeys, b as StarkMasterKeys } from './types-CJSbxv4q.cjs';
 import { a as M31Digest } from './keccak-m31-B_AqBbRF.cjs';
 import { P as Point } from './merkle-mteVOlDf.cjs';
+import './stark-BcTD1OaJ.cjs';
 
 /**
  * Main UPP Client
@@ -274,100 +275,6 @@ declare function generateStarkStealthAddress(keys: StarkMasterKeys, chainId?: nu
  */
 declare function detectAddressType(address: string): 'snark' | 'stark' | 'unknown';
 
-/**
- * Account Adapter — Pluggable account creation
- *
- * Abstracts how master keys are derived/loaded.
- * The SDK doesn't care if keys come from a wallet signature,
- * seed phrase, hardware wallet, or external KMS.
- */
-
-/**
- * Account adapter interface — pluggable key source.
- *
- * Implement this to bring your own key derivation:
- * - SignatureAccountAdapter: EIP-712 wallet signature (built-in)
- * - DirectAccountAdapter: pre-derived keys (built-in, for testing/KMS)
- * - SeedPhraseAccountAdapter: BIP-39 seed phrase (custom)
- * - HardwareWalletAccountAdapter: Ledger/Trezor (custom)
- */
-interface IAccountAdapter {
-    /** Derive or load SNARK master keys */
-    getKeys(): Promise<MasterKeys>;
-    /** Derive or load STARK master keys (optional) */
-    getStarkKeys?(): Promise<StarkMasterKeys>;
-    /** Persist keys (adapter decides where/how) */
-    save?(): Promise<void>;
-    /** Clear persisted keys */
-    clear?(): Promise<void>;
-}
-/**
- * Direct account adapter — accepts pre-derived keys.
- *
- * Use for testing, external KMS, or when keys are derived
- * outside the SDK (e.g., from a seed phrase).
- *
- * @example
- * ```ts
- * const adapter = new DirectAccountAdapter({
- *   spendingSecret: 12345n,
- *   ownerHash: await poseidon([12345n]),
- *   viewingSecret: 67890n,
- *   viewingHash: await poseidon([67890n]),
- * })
- * const keys = await adapter.getKeys()
- * ```
- */
-declare class DirectAccountAdapter implements IAccountAdapter {
-    private keys;
-    private starkKeys?;
-    constructor(keys: MasterKeys, starkKeys?: StarkMasterKeys | undefined);
-    getKeys(): Promise<MasterKeys>;
-    getStarkKeys(): Promise<StarkMasterKeys>;
-}
-
-/**
- * ASP Provider — Pluggable compliance layer
- *
- * Abstracts where ASP membership proofs come from.
- * The pool protocol doesn't care which ASP you use —
- * it's the operator who makes the rules.
- *
- * Built-in: none (ASP is optional, ragequit always available)
- * Implementations:
- * - RestASPProvider: fetch from ASP service API (e.g., asp-whitelist.upd.io)
- * - LocalASPProvider: generate from local tree (via upc-sdk)
- * - Custom: any source that can provide Merkle proofs
- */
-
-interface ASPMembershipProof {
-    /** Merkle root of the ASP tree */
-    root: bigint;
-    /** Path elements (siblings) */
-    pathElements: bigint[];
-    /** Path indices (0 = left, 1 = right) */
-    pathIndices: number[];
-}
-/**
- * ASP provider interface — pluggable compliance.
- *
- * Implement this to bring your own ASP:
- * - Each operator runs their own ASP service
- * - Users are whitelisted by the operator's rules
- * - Proofs are fetched from the operator's service
- *
- * If no ASP is configured, users can always ragequit
- * (withdraw their own deposits without ASP approval).
- */
-interface IASPProvider {
-    /** ASP ID registered on-chain */
-    getASPId(): bigint;
-    /** Fetch a membership proof for an address */
-    getProof(address: Address): Promise<ASPMembershipProof | null>;
-    /** Check if an address is whitelisted (without fetching full proof) */
-    isWhitelisted(address: Address): Promise<boolean>;
-}
-
 /**
  * Indexer Types
  *
@@ -672,6 +579,125 @@ interface NullifiedArgs {
     nullifier: Hex;
 }
 
+/**
+ * Account Adapter — Pluggable account creation and persistence
+ *
+ * Abstracts how master keys are derived/loaded/stored.
+ * The SDK doesn't care if keys come from a wallet signature,
+ * seed phrase, hardware wallet, or external KMS.
+ *
+ * Persistence is handled via StorageAdapter (IndexedDB, localStorage, etc.)
+ */
+
+/**
+ * Account adapter interface — pluggable key source.
+ *
+ * Implement this to bring your own key derivation:
+ * - StorableAccountAdapter: persists keys via StorageAdapter (built-in)
+ * - DirectAccountAdapter: pre-derived keys, no persistence (built-in, for testing)
+ * - Custom: seed phrase, hardware wallet, external KMS
+ */
+interface IAccountAdapter {
+    /** Load persisted keys (returns null if no saved account) */
+    load(): Promise<{
+        keys: MasterKeys;
+        starkKeys?: StarkMasterKeys;
+    } | null>;
+    /** Save keys to storage */
+    save(keys: MasterKeys, starkKeys?: StarkMasterKeys): Promise<void>;
+    /** Clear persisted keys */
+    clear(): Promise<void>;
+}
+/**
+ * Account adapter that persists keys via a pluggable StorageAdapter.
+ *
+ * Works with IndexedDB, localStorage, memory, Redis, Postgres — anything
+ * that implements StorageAdapter.
+ *
+ * @example
+ * ```ts
+ * const storage = createAutoAdapter('upp_account')
+ * const adapter = new StorableAccountAdapter(storage, ethAddress)
+ * const saved = await adapter.load()
+ * if (!saved) {
+ *   const keys = await deriveKeysFromSignature(sig)
+ *   await adapter.save(keys, starkKeys)
+ * }
+ * ```
+ */
+declare class StorableAccountAdapter implements IAccountAdapter {
+    private storage;
+    private storageKey;
+    constructor(storage: StorageAdapter, ethAddress: string);
+    load(): Promise<{
+        keys: MasterKeys;
+        starkKeys?: StarkMasterKeys;
+    } | null>;
+    save(keys: MasterKeys, starkKeys?: StarkMasterKeys): Promise<void>;
+    clear(): Promise<void>;
+}
+/**
+ * Direct account adapter — accepts pre-derived keys, no persistence.
+ *
+ * @example
+ * ```ts
+ * const adapter = new DirectAccountAdapter(masterKeys, starkKeys)
+ * ```
+ */
+declare class DirectAccountAdapter implements IAccountAdapter {
+    private keys;
+    private starkKeys?;
+    constructor(keys: MasterKeys, starkKeys?: StarkMasterKeys | undefined);
+    load(): Promise<{
+        keys: MasterKeys;
+        starkKeys: StarkMasterKeys | undefined;
+    }>;
+    save(): Promise<void>;
+    clear(): Promise<void>;
+}
+
+/**
+ * ASP Provider — Pluggable compliance layer
+ *
+ * Abstracts where ASP membership proofs come from.
+ * The pool protocol doesn't care which ASP you use —
+ * it's the operator who makes the rules.
+ *
+ * Built-in: none (ASP is optional, ragequit always available)
+ * Implementations:
+ * - RestASPProvider: fetch from ASP service API (e.g., asp-whitelist.upd.io)
+ * - LocalASPProvider: generate from local tree (via upc-sdk)
+ * - Custom: any source that can provide Merkle proofs
+ */
+
+interface ASPMembershipProof {
+    /** Merkle root of the ASP tree */
+    root: bigint;
+    /** Path elements (siblings) */
+    pathElements: bigint[];
+    /** Path indices (0 = left, 1 = right) */
+    pathIndices: number[];
+}
+/**
+ * ASP provider interface — pluggable compliance.
+ *
+ * Implement this to bring your own ASP:
+ * - Each operator runs their own ASP service
+ * - Users are whitelisted by the operator's rules
+ * - Proofs are fetched from the operator's service
+ *
+ * If no ASP is configured, users can always ragequit
+ * (withdraw their own deposits without ASP approval).
+ */
+interface IASPProvider {
+    /** ASP ID registered on-chain */
+    getASPId(): bigint;
+    /** Fetch a membership proof for an address */
+    getProof(address: Address): Promise<ASPMembershipProof | null>;
+    /** Check if an address is whitelisted (without fetching full proof) */
+    isWhitelisted(address: Address): Promise<boolean>;
+}
+
 /**
  * NoteStore — Single source of truth for note state
  *
@@ -754,4 +780,4 @@ declare class NoteStore implements INoteStore {
     private notify;
 }
 
-export { ADDRESS_VERSION as A, decryptNote as B, type CommitmentInsertedArgs as C, DirectAccountAdapter as D, detectAddressType as E, encodeStarkStealthAddress as F, encodeStealthAddress as G, encryptNote as H, type Indexer as I, generateStarkStealthAddress as J, generateStealthAddress as K, type LiveSyncConfig as L, isValidStarkStealthAddress as M, type NoteStatus$1 as N, isValidStealthAddress as O, type ProofSystem as P, verifyOwnership as Q, type RpcIndexerConfig as R, type StorageAdapter as S, type NoteStatus as T, type UPPClient as U, type IndexedNote as a, type NoteFilters as b, type SyncResult as c, type SyncProgress as d, type SyncConfig as e, type IndexerState as f, type SyncState as g, type SerializedNote as h, type StealthTransactArgs as i, type NullifiedArgs as j, type ASPMembershipProof as k, type IASPProvider as l, type IAccountAdapter as m, type INoteStore as n, NoteStore as o, STARK_ADDRESS_VERSION as p, STARK_STEALTH_ADDRESS_PREFIX as q, STEALTH_ADDRESS_PREFIX as r, type ShieldedNote as s, type UPPClientConfig as t, computeNoteEncryptionKey as u, createNote as v, createOneTimeKeys as w, createUPPClient as x, decodeStarkStealthAddress as y, decodeStealthAddress as z };
+export { ADDRESS_VERSION as A, decodeStealthAddress as B, type CommitmentInsertedArgs as C, DirectAccountAdapter as D, decryptNote as E, detectAddressType as F, encodeStarkStealthAddress as G, encodeStealthAddress as H, type Indexer as I, encryptNote as J, generateStarkStealthAddress as K, type LiveSyncConfig as L, generateStealthAddress as M, type NoteStatus$1 as N, isValidStarkStealthAddress as O, type ProofSystem as P, isValidStealthAddress as Q, type RpcIndexerConfig as R, type StorageAdapter as S, verifyOwnership as T, type UPPClient as U, type NoteStatus as V, type IndexedNote as a, type NoteFilters as b, type SyncResult as c, type SyncProgress as d, type SyncConfig as e, type IndexerState as f, type SyncState as g, type SerializedNote as h, type StealthTransactArgs as i, type NullifiedArgs as j, type ASPMembershipProof as k, type IASPProvider as l, type IAccountAdapter as m, type INoteStore as n, NoteStore as o, STARK_ADDRESS_VERSION as p, STARK_STEALTH_ADDRESS_PREFIX as q, STEALTH_ADDRESS_PREFIX as r, type ShieldedNote as s, StorableAccountAdapter as t, type UPPClientConfig as u, computeNoteEncryptionKey as v, createNote as w, createOneTimeKeys as x, createUPPClient as y, decodeStarkStealthAddress as z };