@dynamic-labs-wallet/aleo 0.0.0 → 0.0.331

package/src/client/walletStateStorage.d.ts

@@ -0,0 +1,85 @@
+/**
+ * IndexedDB-backed persistence for Aleo per-wallet record-scanner state.
+ *
+ * We cache the scanner's UUID, the owned-records list, and the spent-record
+ * nonces per accountAddress so subsequent queries resume from the last known
+ * state instead of re-registering with Provable's scanner on every page load.
+ *
+ * Storage shape (object store "state", keyed by `${accountAddress}:${network}`):
+ *   { accountAddress, network, scannerUuid, records, spentNonces, lastScannedBlock,
+ *     sealanceProofs, updatedAt }
+ *
+ * The keyPath value is the composite `${accountAddress}:${network}` so testnet
+ * and mainnet entries for the same wallet don't collide. Pre-network-aware
+ * entries (raw `accountAddress` keys) are functionally orphaned by the new
+ * composite lookups and will simply be re-registered on first call. Acceptable
+ * one-time cost; avoids a DB schema migration / version bump.
+ *
+ * `records` is a JSON-stringified array of `OwnedRecord` — keeping it as a
+ * string lets us cache decrypted plaintexts without imposing a Provable SDK
+ * type dependency on this persistence module.
+ *
+ * Security: blobs are stored plaintext, matching Dynamic's existing policy
+ * for locally-cached key material. Protection comes from the iframe's origin
+ * isolation, not at-rest encryption. Cloned from Midnight's
+ * walletStateStorage.ts; a future refactor may extract a generic kv store.
+ */
+/** A cached Sealance Merkle exclusion proof for one stablecoin's freezelist.
+ *  Recomputing the proof requires walking the freeze-list tree (16-deep
+ *  Poseidon4 BHP256), so we cache by `root` and reuse until the freezelist
+ *  changes on chain. */
+export type SealanceProofCacheEntry = {
+    /** Last element of the BigInt-converted freeze-list tree, decimal string. */
+    root: string;
+    /** Output of `SealanceMerkleTree.formatMerkleProof([proofLeft, proofRight])`
+     *  — ready to pass directly as a `[MerkleProof; 2u32].private` input. */
+    formattedProof: string;
+    computedAt: number;
+};
+export type AleoNetwork = 'mainnet' | 'testnet';
+/** Composes the IndexedDB key from a wallet address + network. Exported so
+ *  callers can build the same string when they need to look up a record
+ *  outside the standard `getWalletState` path. */
+export declare const buildStorageKey: (accountAddress: string, network: AleoNetwork) => string;
+export type PersistedWalletState = {
+    /** Composite `${accountAddress}:${network}` — the IndexedDB keyPath value.
+     *  We keep the field name `accountAddress` for keyPath compatibility with
+     *  the existing object store; the actual wallet address lives in
+     *  `walletAddress` below. */
+    accountAddress: string;
+    /** Real `aleo1...` address (sans network suffix). Useful for diagnostics. */
+    walletAddress?: string;
+    /** Network this entry's scanner UUID + records belong to. Pre-network-aware
+     *  entries don't have this field; we treat absence as "stale, re-register". */
+    network?: AleoNetwork;
+    /** UUID returned by Provable's scanner /register flow. Required to query
+     *  that wallet's records on subsequent calls. */
+    scannerUuid?: string;
+    /** JSON-stringified OwnedRecord[] — decrypted plaintexts cached between
+     *  sessions. Stored as string to avoid a Provable type dep here. */
+    records: string;
+    /** Record nonces we've consumed as inputs in our own proveTransaction
+     *  calls. Used to filter out spent records when the server-side spent-
+     *  check isn't authoritative (e.g., between a broadcast and the scanner
+     *  re-indexing the chain). */
+    spentNonces: string[];
+    /** Height through which `records` is known complete. Next scan picks up
+     *  from `lastScannedBlock + 1`. */
+    lastScannedBlock: number;
+    /** Cached Sealance exclusion proofs keyed by freezelist program id
+     *  (e.g. `test_usad_freezelist.aleo`). Re-validated against the current
+     *  on-chain root before each spend; rebuilt only when the root changes. */
+    sealanceProofs?: Record<string, SealanceProofCacheEntry>;
+    updatedAt: number;
+};
+export declare function toError(err: unknown, fallbackMessage: string): Error;
+export declare function getWalletState(accountAddress: string, network: AleoNetwork): Promise<PersistedWalletState | null>;
+export declare function putWalletState(accountAddress: string, network: AleoNetwork, state: {
+    scannerUuid?: string;
+    records: string;
+    spentNonces: string[];
+    lastScannedBlock: number;
+    sealanceProofs?: Record<string, SealanceProofCacheEntry>;
+}): Promise<void>;
+export declare function deleteWalletState(accountAddress: string, network: AleoNetwork): Promise<void>;
+//# sourceMappingURL=walletStateStorage.d.ts.map

package/src/client/walletStateStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletStateStorage.d.ts","sourceRoot":"","sources":["../../src/client/walletStateStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH;;;wBAGwB;AACxB,MAAM,MAAM,uBAAuB,GAAG;IACpC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb;6EACyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEhD;;kDAEkD;AAClD,eAAO,MAAM,eAAe,mBAAoB,MAAM,WAAW,WAAW,KAAG,MAAwC,CAAC;AAExH,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;iCAG6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;mFAC+E;IAC/E,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;qDACiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;wEACoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB;;;kCAG8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;uCACmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB;;+EAE2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAOF,wBAAgB,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,GAAG,KAAK,CAcpE;AAqCD,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAStC;AAED,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE;IACL,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CAC1D,GACA,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAOnG"}

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './client/index.js';
+export { ALEO_NETWORKS, type AleoNetwork } from './client/constants.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC"}