@miden-sdk/miden-sdk 0.14.0-alpha.2 → 0.14.1

package/dist/crates/miden_client_web.d.ts

@@ -129,8 +129,12 @@ export class AccountBuilder {
     [Symbol.dispose](): void;
     /**
      * Sets the account type (regular, faucet, etc.).
+     *
+     * Accepts either a numeric WASM enum value (0–3) or a string name
+     * (`"FungibleFaucet"`, `"NonFungibleFaucet"`,
+     * `"RegularAccountImmutableCode"`, `"RegularAccountUpdatableCode"`).
      */
-    accountType(account_type: AccountType): AccountBuilder;
+    accountType(account_type: any): AccountBuilder;
     /**
      * Builds the account and returns it together with the derived seed.
      */
@@ -218,6 +222,10 @@ export class AccountComponent {
     static fromPackage(_package: Package, storage_slots: StorageSlotArray): AccountComponent;
     /**
      * Returns the hex-encoded MAST root for a procedure by name.
+     *
+     * Matches by full path, relative path, or local name (after the last `::`).
+     * When matching by local name, if multiple procedures share the same local
+     * name across modules, the first match is returned.
      */
     getProcedureHash(procedure_name: string): string;
     /**
@@ -372,6 +380,15 @@ export class AccountId {
      * Returns an error if the provided string is not a valid hex-encoded account ID.
      */
     static fromHex(hex: string): AccountId;
+    /**
+     * Builds an account ID from its prefix and suffix field elements.
+     *
+     * This is useful when the account ID components are stored separately (e.g., in storage
+     * maps) and need to be recombined into an `AccountId`.
+     *
+     * Returns an error if the provided felts do not form a valid account ID.
+     */
+    static fromPrefixSuffix(prefix: Felt, suffix: Felt): AccountId;
     /**
      * Returns true if the ID refers to a faucet.
      */
@@ -441,7 +458,8 @@ export enum AccountInterface {
 /**
  * Proof of existence of an account's state at a specific block number, as returned by the node.
  *
- * For public accounts, this includes the account header, storage slot values and account code.
+ * For public accounts, this includes the account header, storage slot values, account code,
+ * and optionally storage map entries for the requested storage maps.
  * For private accounts, only the account commitment and merkle proof are available.
  */
 export class AccountProof {
@@ -468,6 +486,22 @@ export class AccountProof {
      * Returns the block number at which this proof was retrieved.
      */
     blockNum(): number;
+    /**
+     * Returns storage map entries for a given slot name, if available.
+     *
+     * Returns `undefined` if the account is private, the slot was not requested in the
+     * storage requirements, or the slot is not a map.
+     *
+     * Each entry contains a `key` and `value` as `Word` objects.
+     */
+    getStorageMapEntries(slot_name: string): StorageMapEntry[] | undefined;
+    /**
+     * Returns the names of all storage slots that have map details available.
+     *
+     * This can be used to discover which storage maps were included in the proof response.
+     * Returns `undefined` if the account is private.
+     */
+    getStorageMapSlotNames(): string[] | undefined;
     /**
      * Returns the value of a storage slot by name, if available.
      *
@@ -477,6 +511,15 @@ export class AccountProof {
      * Returns `undefined` if the account is private or the slot name is not found.
      */
     getStorageSlotValue(slot_name: string): Word | undefined;
+    /**
+     * Returns whether a storage map slot had too many entries to return inline.
+     *
+     * When this returns `true`, use `RpcClient.syncStorageMaps()` to fetch the full
+     * storage map data.
+     *
+     * Returns `undefined` if the slot was not found or the account is private.
+     */
+    hasStorageMapTooManyEntries(slot_name: string): boolean | undefined;
     /**
      * Returns the number of storage slots, if available (public accounts only).
      */
@@ -788,13 +831,17 @@ export class Address {
  * Advice inputs provided to a transaction or note script.
  */
 export class AdviceInputs {
-    private constructor();
     free(): void;
     [Symbol.dispose](): void;
     /**
      * Returns mapped values for a given key if present.
      */
     mappedValues(key: Word): Felt[] | undefined;
+    /**
+     * `wasm_bindgen` requires an explicit constructor; `#[derive(Default)]` alone
+     * is not callable from JS.
+     */
+    constructor();
     /**
      * Returns the stack inputs as a vector of felts.
      */
@@ -1059,18 +1106,29 @@ export class CodeBuilder {
 }
 
 /**
- * Represents a note committed on chain, as returned by `syncNotes`.
+ * Represents a note committed on chain.
  */
 export class CommittedNote {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Returns the inclusion path for the note.
+     * Returns the full note metadata when the attachment payload is available.
+     */
+    fullMetadata(): NoteMetadata | undefined;
+    /**
+     * Returns the inclusion path for the note in the block's note tree.
      */
     inclusionPath(): SparseMerklePath;
+    /**
+     * Returns the inclusion proof for this note.
+     */
+    inclusionProof(): NoteInclusionProof;
     /**
      * Returns the note metadata.
+     *
+     * If only metadata headers are available, the returned metadata contains
+     * the sender, note type, and tag without attachment payload.
      */
     metadata(): NoteMetadata;
     /**
@@ -1081,6 +1139,18 @@ export class CommittedNote {
      * Returns the note index in the block's note tree.
      */
     noteIndex(): number;
+    /**
+     * Returns the note type (public, private, etc.).
+     */
+    noteType(): NoteType;
+    /**
+     * Returns the note sender, even when only header metadata is available.
+     */
+    sender(): AccountId;
+    /**
+     * Returns the note tag.
+     */
+    tag(): number;
 }
 
 /**
@@ -1869,10 +1939,6 @@ export class JsVaultAsset {
      * Word representing the asset.
      */
     asset: string;
-    /**
-     * Asset's faucet ID prefix.
-     */
-    faucetIdPrefix: string;
     /**
      * The vault key associated with the asset.
      */
@@ -2040,6 +2106,27 @@ export class NoteAndArgsArray {
     replaceAt(index: number, elem: NoteAndArgs): void;
 }
 
+export class NoteArray {
+    /**
+     ** Return copy of self without private attributes.
+     */
+    toJSON(): Object;
+    /**
+     * Return stringified version of self.
+     */
+    toString(): string;
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Get element at index, will always return a clone to avoid aliasing issues.
+     */
+    get(index: number): Note;
+    length(): number;
+    constructor(elements?: Note[] | null);
+    push(element: Note): void;
+    replaceAt(index: number, elem: Note): void;
+}
+
 /**
  * An asset container for a note.
  *
@@ -2424,10 +2511,6 @@ export class NoteHeader {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
-    /**
-     * Returns a commitment to the note ID and metadata.
-     */
-    commitment(): Word;
     /**
      * Returns the unique identifier for the note.
      */
@@ -2436,6 +2519,10 @@ export class NoteHeader {
      * Returns the public metadata attached to the note.
      */
     metadata(): NoteMetadata;
+    /**
+     * Returns a commitment to the note ID and metadata.
+     */
+    toCommitment(): Word;
 }
 
 /**
@@ -2529,13 +2616,13 @@ export class NoteLocation {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Returns the block height containing the note.
+     * Returns the index of the note leaf within the block's note tree.
      */
-    blockNum(): number;
+    blockNoteTreeIndex(): number;
     /**
-     * Returns the index of the note leaf within the block's note tree.
+     * Returns the block height containing the note.
      */
-    nodeIndexInBlock(): number;
+    blockNum(): number;
 }
 
 /**
@@ -2654,7 +2741,8 @@ export class NoteScript {
     static deserialize(bytes: Uint8Array): NoteScript;
     /**
      * Creates a `NoteScript` from the given `Package`.
-     * Throws if the package is invalid.
+     * The package must contain a library with exactly one procedure annotated with
+     * `@note_script`.
      */
     static fromPackage(_package: Package): NoteScript;
     /**
@@ -2705,6 +2793,27 @@ export class NoteStorage {
     constructor(felt_array: FeltArray);
 }
 
+/**
+ * Represents a single block's worth of note sync data.
+ */
+export class NoteSyncBlock {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the block header for this block.
+     */
+    blockHeader(): BlockHeader;
+    /**
+     * Returns the MMR path for the block header.
+     */
+    mmrPath(): MerklePath;
+    /**
+     * Returns the committed notes in this block.
+     */
+    notes(): CommittedNote[];
+}
+
 /**
  * Represents the response data from `syncNotes`.
  */
@@ -2713,19 +2822,27 @@ export class NoteSyncInfo {
     free(): void;
     [Symbol.dispose](): void;
     /**
-     * Returns the block header associated with the matching notes.
+     * Returns the first block header associated with matching notes, if any.
      */
-    blockHeader(): BlockHeader;
+    blockHeader(): BlockHeader | undefined;
+    /**
+     * Returns the last block checked by the node. Used as a cursor for pagination.
+     */
+    blockTo(): number;
+    /**
+     * Returns the blocks containing matching notes.
+     */
+    blocks(): NoteSyncBlock[];
     /**
      * Returns the latest block number in the chain.
      */
     chainTip(): number;
     /**
-     * Returns the MMR path for the block header.
+     * Returns the first block MMR path associated with matching notes, if any.
      */
-    mmrPath(): MerklePath;
+    mmrPath(): MerklePath | undefined;
     /**
-     * Returns the committed notes returned by the node.
+     * Returns the committed notes across all matching blocks.
      */
     notes(): CommittedNote[];
 }
@@ -2772,7 +2889,7 @@ export enum NoteType {
 }
 
 /**
- * Representation of a note produced by a transaction (full, partial, or header-only).
+ * Representation of a note produced by a transaction (full or partial).
  */
 export class OutputNote {
     private constructor();
@@ -2786,10 +2903,6 @@ export class OutputNote {
      * Wraps a full note output.
      */
     static full(note: Note): OutputNote;
-    /**
-     * Wraps only the header of a note.
-     */
-    static header(note_header: NoteHeader): OutputNote;
     /**
      * Returns the note ID for this output.
      */
@@ -2807,13 +2920,9 @@ export class OutputNote {
      */
     static partial(partial_note: PartialNote): OutputNote;
     /**
-     * Returns the recipient digest if the recipient is known.
-     */
-    recipientDigest(): Word | undefined;
-    /**
-     * Returns a more compact representation if possible (e.g. dropping details).
+     * Returns the recipient digest.
      */
-    shrink(): OutputNote;
+    recipientDigest(): Word;
 }
 
 export class OutputNoteArray {
@@ -2928,27 +3037,6 @@ export class OutputNotes {
     numNotes(): number;
 }
 
-export class OutputNotesArray {
-    /**
-     ** Return copy of self without private attributes.
-     */
-    toJSON(): Object;
-    /**
-     * Return stringified version of self.
-     */
-    toString(): string;
-    free(): void;
-    [Symbol.dispose](): void;
-    /**
-     * Get element at index, will always return a clone to avoid aliasing issues.
-     */
-    get(index: number): OutputNotes;
-    length(): number;
-    constructor(elements?: OutputNotes[] | null);
-    push(element: OutputNotes): void;
-    replaceAt(index: number, elem: OutputNotes): void;
-}
-
 /**
  * Compiled VM package containing libraries and metadata.
  */
@@ -3007,6 +3095,19 @@ export class PartialNote {
     recipientDigest(): Word;
 }
 
+/**
+ * Poseidon2 hashing helpers exposed to JavaScript.
+ */
+export class Poseidon2 {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Computes a Poseidon2 digest from the provided field elements.
+     */
+    static hashElements(felt_array: FeltArray): Word;
+}
+
 export class ProcedureThreshold {
     free(): void;
     [Symbol.dispose](): void;
@@ -3049,10 +3150,6 @@ export class ProvenTransaction {
      * Returns the nullifiers of the consumed input notes.
      */
     nullifiers(): Word[];
-    /**
-     * Returns notes created by this transaction.
-     */
-    outputNotes(): OutputNotes;
     /**
      * Returns the commitment of the reference block.
      */
@@ -3111,16 +3208,27 @@ export class RpcClient {
      * Fetches an account proof from the node.
      *
      * This is a lighter-weight alternative to `getAccountDetails` that makes a single RPC call
-     * and returns the account proof and, for public accounts, the account header, storage slot
-     * values, and account code without reconstructing the full account state.
+     * and returns the account proof alongside the account header, storage slot values, and
+     * account code without reconstructing the full account state.
      *
      * For private accounts, the proof is returned but account details will not be available
      * since they are not stored on-chain.
      *
-     * Useful for reading storage slot values (e.g., faucet metadata) without the overhead of
-     * fetching the complete account with all vault assets and storage map entries.
-     */
-    getAccountProof(account_id: AccountId): Promise<AccountProof>;
+     * Useful for reading storage slot values (e.g., faucet metadata) or specific storage map
+     * entries without the overhead of fetching the complete account with all vault assets and
+     * storage map entries.
+     *
+     * @param `account_id` - The account to fetch the proof for.
+     * @param `storage_requirements` - Optional storage requirements specifying which storage
+     *   maps and keys to include. When `undefined`, no storage map data is requested.
+     * @param `block_num` - Optional block number to fetch the account state at. When `undefined`,
+     *   fetches the latest state (chain tip).
+     * @param `known_vault_commitment` - Optional known vault commitment. When provided,
+     *   vault data is returned only if the account's current vault root differs from this
+     *   value. Use `Word.new([0, 0, 0, 0])` to always fetch. When `undefined`, vault data
+     *   is not requested.
+     */
+    getAccountProof(account_id: AccountId, storage_requirements?: AccountStorageRequirements | null, block_num?: number | null, known_vault_commitment?: Word | null): Promise<AccountProof>;
     /**
      * Fetches a block header by number. When `block_num` is undefined, returns the latest header.
      */
@@ -3156,6 +3264,18 @@ export class RpcClient {
      * Fetches notes matching the provided tags from the node.
      */
     syncNotes(block_num: number, block_to: number | null | undefined, note_tags: NoteTag[]): Promise<NoteSyncInfo>;
+    /**
+     * Syncs storage map updates for an account within a block range.
+     *
+     * This is used when `AccountProof.hasStorageMapTooManyEntries()` returns `true` for a
+     * slot, indicating the storage map was too large to return inline. This endpoint fetches
+     * the full storage map data with pagination support.
+     *
+     * @param `block_from` - The starting block number.
+     * @param `block_to` - Optional ending block number. When `undefined`, syncs to chain tip.
+     * @param `account_id` - The account to sync storage maps for.
+     */
+    syncStorageMaps(block_from: number, block_to: number | null | undefined, account_id: AccountId): Promise<StorageMapInfo>;
 }
 
 /**
@@ -3175,6 +3295,12 @@ export class SerializedInputNoteData {
     private constructor();
     free(): void;
     [Symbol.dispose](): void;
+    get consumedBlockHeight(): number | undefined;
+    set consumedBlockHeight(value: number | null | undefined);
+    get consumedTxOrder(): number | undefined;
+    set consumedTxOrder(value: number | null | undefined);
+    get consumerAccountId(): string | undefined;
+    set consumerAccountId(value: string | null | undefined);
     createdAt: string;
     inputs: Uint8Array;
     noteAssets: Uint8Array;
@@ -3376,6 +3502,74 @@ export class StorageMap {
     constructor();
 }
 
+/**
+ * A key-value entry from a storage map.
+ */
+export class StorageMapEntry {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the storage map key.
+     */
+    key(): Word;
+    /**
+     * Returns the storage map value.
+     */
+    value(): Word;
+}
+
+/**
+ * Information about storage map updates for an account, as returned by the
+ * `syncStorageMaps` RPC endpoint.
+ *
+ * Contains the list of storage map updates within the requested block range,
+ * along with the chain tip and last processed block number.
+ */
+export class StorageMapInfo {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the block number of the last check included in this response.
+     */
+    blockNumber(): number;
+    /**
+     * Returns the current chain tip block number.
+     */
+    chainTip(): number;
+    /**
+     * Returns the list of storage map updates.
+     */
+    updates(): StorageMapUpdate[];
+}
+
+/**
+ * A single storage map update entry, containing the block number, slot name,
+ * key, and new value.
+ */
+export class StorageMapUpdate {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Returns the block number in which this update occurred.
+     */
+    blockNum(): number;
+    /**
+     * Returns the storage map key that was updated.
+     */
+    key(): Word;
+    /**
+     * Returns the name of the storage slot that was updated.
+     */
+    slotName(): string;
+    /**
+     * Returns the new value for this storage map key.
+     */
+    value(): Word;
+}
+
 /**
  * A single storage slot value or map for an account component.
  */
@@ -3746,6 +3940,10 @@ export class TransactionRequestBuilder {
      * Declares expected output recipients (used for verification).
      */
     withExpectedOutputRecipients(recipients: NoteRecipientArray): TransactionRequestBuilder;
+    /**
+     * Sets the maximum number of blocks until the transaction request expires.
+     */
+    withExpirationDelta(expiration_delta: number): TransactionRequestBuilder;
     /**
      * Registers foreign accounts referenced by the transaction.
      */
@@ -3755,9 +3953,9 @@ export class TransactionRequestBuilder {
      */
     withInputNotes(notes: NoteAndArgsArray): TransactionRequestBuilder;
     /**
-     * Adds notes created by the sender that should be emitted by the transaction.
+     * Adds output notes created by the sender that should be emitted by the transaction.
      */
-    withOwnOutputNotes(notes: OutputNoteArray): TransactionRequestBuilder;
+    withOwnOutputNotes(notes: NoteArray): TransactionRequestBuilder;
     /**
      * Adds a transaction script argument.
      */
@@ -3915,7 +4113,7 @@ export class TransactionStoreUpdate {
      */
     accountDelta(): AccountDelta;
     /**
-     * Returns the notes created by the transaction.
+     * Returns the output notes created by the transaction.
      */
     createdNotes(): OutputNotes;
     /**
@@ -3997,7 +4195,6 @@ export class WebClient {
      * ```
      */
     accountReader(account_id: AccountId): AccountReader;
-    addAccountSecretKeyToWebStore(account_id: AccountId, secret_key: AuthSecretKey): Promise<void>;
     addTag(tag: string): Promise<void>;
     applyTransaction(transaction_result: TransactionResult, submission_height: number): Promise<TransactionStoreUpdate>;
     static buildSwapTag(note_type: NoteType, offered_asset_faucet_id: AccountId, offered_asset_amount: bigint, requested_asset_faucet_id: AccountId, requested_asset_amount: bigint): NoteTag;
@@ -4012,7 +4209,7 @@ export class WebClient {
      *   `MidenClientDB_{network_id}`, where `network_id` is derived from the `node_url`.
      *   Explicitly setting this allows for creating multiple isolated clients.
      */
-    createClient(node_url?: string | null, node_note_transport_url?: string | null, seed?: Uint8Array | null, store_name?: string | null): Promise<any>;
+    createClient(node_url?: string | null, node_note_transport_url?: string | null, seed?: Uint8Array | null, store_name?: string | null, debug_mode?: boolean | null): Promise<any>;
     /**
      * Creates a new `WebClient` instance with external keystore callbacks.
      *
@@ -4027,7 +4224,7 @@ export class WebClient {
      * * `insert_key_cb`: Callback to persist a secret key.
      * * `sign_cb`: Callback to produce serialized signature bytes for the provided inputs.
      */
-    createClientWithExternalKeystore(node_url?: string | null, node_note_transport_url?: string | null, seed?: Uint8Array | null, store_name?: string | null, get_key_cb?: Function | null, insert_key_cb?: Function | null, sign_cb?: Function | null): Promise<any>;
+    createClientWithExternalKeystore(node_url?: string | null, node_note_transport_url?: string | null, seed?: Uint8Array | null, store_name?: string | null, get_key_cb?: Function | null, insert_key_cb?: Function | null, sign_cb?: Function | null, debug_mode?: boolean | null): Promise<any>;
     createCodeBuilder(): CodeBuilder;
     /**
      * Creates a new client with a mock RPC API. Useful for testing purposes and proof-of-concept
@@ -4046,6 +4243,12 @@ export class WebClient {
      * - If there is an internal failure during execution.
      */
     executeForSummary(account_id: AccountId, transaction_request: TransactionRequest): Promise<TransactionSummary>;
+    /**
+     * Executes the provided transaction script against the specified account
+     * and returns the resulting stack output. This is a local-only "view call"
+     * that does not submit anything to the network.
+     */
+    executeProgram(account_id: AccountId, tx_script: TransactionScript, advice_inputs: AdviceInputs, foreign_accounts: ForeignAccountArray): Promise<FeltArray>;
     /**
      * Executes a transaction specified by the request against the specified account but does not
      * submit it to the network nor update the local database. The returned [`TransactionResult`]
@@ -4058,12 +4261,6 @@ export class WebClient {
     executeTransaction(account_id: AccountId, transaction_request: TransactionRequest): Promise<TransactionResult>;
     exportAccountFile(account_id: AccountId): Promise<AccountFile>;
     exportNoteFile(note_id: string, export_format: NoteExportFormat): Promise<NoteFile>;
-    /**
-     * Retrieves the entire underlying web store and returns it as a `JsValue`
-     *
-     * Meant to be used in conjunction with the `force_import_store` method
-     */
-    exportStore(): Promise<any>;
     /**
      * Fetch all private notes from the note transport layer
      *
@@ -4078,25 +4275,12 @@ export class WebClient {
      * Uses an internal pagination mechanism to avoid fetching duplicate notes.
      */
     fetchPrivateNotes(): Promise<void>;
-    forceImportStore(store_dump: any, _store_name: string): Promise<any>;
     /**
      * Retrieves the full account data for the given account ID, returning `null` if not found.
      *
      * This method loads the complete account state including vault, storage, and code.
      */
     getAccount(account_id: AccountId): Promise<Account | undefined>;
-    /**
-     * Retrieves an authentication secret key from the keystore given a public key commitment.
-     *
-     * The public key commitment should correspond to one of the keys tracked by the keystore.
-     * Returns the associated [`AuthSecretKey`] if found, or an error if not found.
-     */
-    getAccountAuthByPubKeyCommitment(pub_key_commitment: Word): Promise<AuthSecretKey>;
-    /**
-     * Retrieves the full account data for the account associated with the given public key
-     * commitment, returning `null` if no account is found.
-     */
-    getAccountByKeyCommitment(pub_key_commitment: Word): Promise<Account | undefined>;
     /**
      * Retrieves the account code for a specific account.
      *
@@ -4121,13 +4305,6 @@ export class WebClient {
     getInputNotes(filter: NoteFilter): Promise<InputNoteRecord[]>;
     getOutputNote(note_id: string): Promise<OutputNoteRecord>;
     getOutputNotes(filter: NoteFilter): Promise<OutputNoteRecord[]>;
-    /**
-     * Returns all public key commitments associated with the given account ID.
-     *
-     * These commitments can be used with [`getAccountAuthByPubKeyCommitment`]
-     * to retrieve the corresponding secret keys from the keystore.
-     */
-    getPublicKeyCommitmentsOfAccount(account_id: AccountId): Promise<Word[]>;
     /**
      * Retrieves the setting value for `key`, or `None` if it hasn’t been set.
      */
@@ -4146,6 +4323,13 @@ export class WebClient {
     listTags(): Promise<any>;
     constructor();
     newAccount(account: Account, overwrite: boolean): Promise<void>;
+    /**
+     * Inserts an account and its secret key in one call, matching how
+     * `newWallet` / `newFaucet` already work internally.  If the key
+     * insertion fails the account is still persisted (same as wallet/faucet),
+     * but callers only need a single await instead of two.
+     */
+    newAccountWithSecretKey(account: Account, secret_key: AuthSecretKey): Promise<void>;
     newConsumeTransactionRequest(list_of_notes: Note[]): TransactionRequest;
     newFaucet(storage_mode: AccountStorageMode, non_fungible: boolean, token_symbol: string, decimals: number, max_supply: bigint, auth_scheme: AuthScheme): Promise<Account>;
     newMintTransactionRequest(target_account_id: AccountId, faucet_id: AccountId, note_type: NoteType, amount: bigint): TransactionRequest;
@@ -4158,6 +4342,16 @@ export class WebClient {
      * prover if none is supplied.
      */
     proveTransaction(transaction_result: TransactionResult, prover?: TransactionProver | null): Promise<ProvenTransaction>;
+    /**
+     * Prunes historical account states for the specified account up to the given nonce.
+     *
+     * Deletes all historical entries with `replaced_at_nonce <= up_to_nonce` and any
+     * orphaned account code.
+     *
+     * Returns the total number of rows deleted, including historical entries and orphaned
+     * account code.
+     */
+    pruneAccountHistory(account_id: AccountId, up_to_nonce: Felt): Promise<number>;
     removeAccountAddress(account_id: AccountId, address: Address): Promise<void>;
     /**
      * Deletes a setting key-value from the store.
@@ -4176,20 +4370,14 @@ export class WebClient {
      * Returns the inner serialized mock note transport node if it exists.
      */
     serializeMockNoteTransportNode(): Uint8Array;
-    /**
-     * Sets the debug mode for transaction execution.
-     *
-     * When enabled, the transaction executor will record additional information useful for
-     * debugging (the values on the VM stack and the state of the advice provider). This is
-     * disabled by default since it adds overhead.
-     *
-     * Must be called before `createClient`.
-     */
-    setDebugMode(enabled: boolean): void;
     /**
      * Sets a setting key-value in the store. It can then be retrieved using `get_setting`.
      */
     setSetting(key: string, value: any): Promise<void>;
+    /**
+     * Returns the identifier of the underlying store (e.g. `IndexedDB` database name, file path).
+     */
+    storeIdentifier(): string;
     /**
      * Executes a transaction specified by the request against the specified account,
      * proves it, submits it to the network, and updates the local database.
@@ -4222,6 +4410,47 @@ export class WebClient {
      */
     syncStateImpl(): Promise<SyncSummary>;
     usesMockChain(): boolean;
+    /**
+     * Returns a `WebKeystoreApi` handle for managing secret keys.
+     *
+     * The returned object can be used from JavaScript as `client.keystore`.
+     */
+    readonly keystore: WebKeystoreApi;
+}
+
+/**
+ * JavaScript API for the client's keystore.
+ *
+ * Manages the association between accounts and their authentication secret keys,
+ * indexed by public key commitment.
+ */
+export class WebKeystoreApi {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Retrieves a secret key from the keystore given a public key commitment.
+     *
+     * Returns the associated `AuthSecretKey` if found, or `null` if not found.
+     */
+    get(pub_key_commitment: Word): Promise<AuthSecretKey | undefined>;
+    /**
+     * Returns the account ID associated with a given public key commitment,
+     * or `null` if no account is found.
+     */
+    getAccountId(pub_key_commitment: Word): Promise<AccountId | undefined>;
+    /**
+     * Returns all public key commitments associated with the given account ID.
+     */
+    getCommitments(account_id: AccountId): Promise<Word[]>;
+    /**
+     * Inserts a secret key into the keystore, associating it with the given account ID.
+     */
+    insert(account_id: AccountId, secret_key: AuthSecretKey): Promise<void>;
+    /**
+     * Removes a key from the keystore by its public key commitment.
+     */
+    remove(pub_key_commitment: Word): Promise<void>;
 }
 
 export class Word {
@@ -4267,6 +4496,21 @@ export class Word {
  */
 export function createAuthFalcon512RpoMultisig(config: AuthFalcon512RpoMultisigConfig): AccountComponent;
 
+/**
+ * Exports the entire contents of an `IndexedDB` store as a JSON string.
+ *
+ * Use together with [`import_store`].
+ */
+declare function exportStore2(store_name: string): Promise<any>;
+export { exportStore2 as exportStore }
+
+/**
+ * Imports store contents from a JSON string, replacing all existing data.
+ *
+ * Use together with [`export_store`].
+ */
+export function importStore(store_name: string, store_dump: string): Promise<void>;
+
 /**
  * Initializes the `tracing` subscriber that routes Rust log output to the
  * browser console via `console.log` / `console.warn` / `console.error`.