starknet 10.6.7 → 10.7.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [10.7.0](https://github.com/starknet-io/starknet.js/compare/v10.6.8...v10.7.0) (2026-08-13)
+
+### Features
+
+- **deps:** bump types-js 0.10.4-beta.2 and get-starknet 6.0.4 ([cf26a77](https://github.com/starknet-io/starknet.js/commit/cf26a77dc706c841a207bc76fb2ff7a5a7955be9))
+
+## [10.6.8](https://github.com/starknet-io/starknet.js/compare/v10.6.7...v10.6.8) (2026-08-07)
+
+### Bug Fixes
+
+- **ws:** close the subscription lifecycle races ([c242c76](https://github.com/starknet-io/starknet.js/commit/c242c76ab73f508ecd454d1d7eb2fde8728c4f9d))
+
 ## [10.6.7](https://github.com/starknet-io/starknet.js/compare/v10.6.6...v10.6.7) (2026-08-06)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -10,7 +10,7 @@ import { Abi as Abi$1, TypedContract } from 'abi-wan-kanabi';
 import { WalletWithStarknetFeatures, StandardEventsChangeProperties } from '@starknet-io/get-starknet-wallet-standard/features';
 import { WalletWithStarknetFeatures as WalletWithStarknetFeatures$1 } from '@starknet-io/get-starknet-wallet-standard-v6/features';
 import * as _starknet_io_starknet_types_0104 from '@starknet-io/starknet-types-0104';
-import { STRK20_DEPOSIT_ACTION, STRK20_WITHDRAW_ACTION, STRK20_TRANSFER_ACTION, STRK20_INVOKE_ACTION, STRK20_SUBACCOUNT_INVOKE_ACTION as STRK20_SUBACCOUNT_INVOKE_ACTION$1, STRK20_CALL_AND_PROOF as STRK20_CALL_AND_PROOF$1, STRK20_PROOF, Address, STRK20_BALANCE_ENTRY, STRK20_DAPP_NAME, FELT as FELT$1, Permission as Permission$2, WatchAssetParameters as WatchAssetParameters$2, AddStarknetChainParameters as AddStarknetChainParameters$2, ChainId as ChainId$2, AccountDeploymentData as AccountDeploymentData$2, AddInvokeTransactionParameters as AddInvokeTransactionParameters$2, AddInvokeTransactionResult as AddInvokeTransactionResult$2, AddDeclareTransactionParameters as AddDeclareTransactionParameters$2, AddDeclareTransactionResult as AddDeclareTransactionResult$2, TypedData as TypedData$2, Signature as Signature$3, SpecVersion as SpecVersion$2, API_VERSION as API_VERSION$3, STRK20_ACTION as STRK20_ACTION$1 } from '@starknet-io/starknet-types-0104';
+import { STRK20_DEPOSIT_ACTION, STRK20_WITHDRAW_ACTION, STRK20_TRANSFER_ACTION, STRK20_INVOKE_ACTION, STRK20_SHADOW_ACCOUNT_INVOKE_ACTION as STRK20_SHADOW_ACCOUNT_INVOKE_ACTION$1, STRK20_CALL_AND_PROOF as STRK20_CALL_AND_PROOF$1, STRK20_PROOF, Address, STRK20_BALANCE_ENTRY, STRK20_DAPP_NAME, FELT as FELT$1, Permission as Permission$2, WatchAssetParameters as WatchAssetParameters$2, AddStarknetChainParameters as AddStarknetChainParameters$2, ChainId as ChainId$2, AccountDeploymentData as AccountDeploymentData$2, AddInvokeTransactionParameters as AddInvokeTransactionParameters$2, AddInvokeTransactionResult as AddInvokeTransactionResult$2, AddDeclareTransactionParameters as AddDeclareTransactionParameters$2, AddDeclareTransactionResult as AddDeclareTransactionResult$2, TypedData as TypedData$2, Signature as Signature$3, SpecVersion as SpecVersion$2, API_VERSION as API_VERSION$3, STRK20_ACTION as STRK20_ACTION$1 } from '@starknet-io/starknet-types-0104';
 export { STRK20_BALANCE_ENTRY, STRK20_CALLDATA_ITEM, STRK20_CALLDATA_PLACEHOLDER, STRK20_COLLECT_POLICY, STRK20_DAPP_NAME, STRK20_DEPOSIT_ACTION, STRK20_INVOKE_ACTION, STRK20_PROOF, STRK20_TRANSFER_ACTION, STRK20_WITHDRAW_ACTION } from '@starknet-io/starknet-types-0104';
 import * as poseidon from '@noble/curves/abstract/poseidon';
 import * as json$1 from 'lossless-json';
@@ -4962,6 +4962,7 @@ declare class Subscription<T = any> {
     private maxBufferSize;
     private handler;
     private _isClosed;
+    private pendingUnsubscribe;
     /**
      * @internal
      * @param options - Subscription configuration options
@@ -4972,6 +4973,15 @@ declare class Subscription<T = any> {
      * @returns {boolean} `true` if unsubscribed, `false` otherwise.
      */
     get isClosed(): boolean;
+    /**
+     * Closes the subscription locally, without contacting the node.
+     *
+     * Used when the channel knows the subscription is gone and cannot be recovered — a
+     * re-subscribe refused after a reconnection, for instance. Without it the object would keep
+     * reporting itself as open while no event could ever reach its handler again.
+     * @internal
+     */
+    _markClosed(): void;
     /**
      * Internal method to handle incoming events from the WebSocket channel.
      * If a handler is attached, it's invoked immediately. Otherwise, the event is buffered.
@@ -5153,6 +5163,15 @@ declare class WebSocketChannel {
     private requestQueue;
     /** Abort handles for the requests currently on the wire, one per pending `sendReceive`. */
     private inFlight;
+    /**
+     * Callers blocked in `waitForUnsubscription`, keyed by subscription id.
+     *
+     * Held here rather than as `unsubscribe` event listeners because that event only ever
+     * announces success: a waiter attached to it cannot learn that the node refused the
+     * unsubscribe or that the connection went away, and would wait forever with no timeout of
+     * its own to fall back on.
+     */
+    private unsubscribeWaiters;
     private events;
     private openListener;
     private closeListener;
@@ -5228,6 +5247,15 @@ declare class WebSocketChannel {
      * @returns {Promise<boolean>} A Promise that resolves with `true` if the unsubscription was successful.
      */
     unsubscribe(subscriptionId: SUBSCRIPTION_ID): Promise<boolean>;
+    /** Settles every caller waiting on one subscription id: resolved, or rejected with `error`. */
+    private _settleUnsubscribeWaiters;
+    /**
+     * Rejects every caller still waiting on any subscription.
+     *
+     * Once the connection is gone, no unsubscribe can be observed on it: a reconnection restores
+     * each subscription under a fresh id, so the id being waited on will never be announced.
+     */
+    private _rejectUnsubscribeWaiters;
     /**
      * Returns a Promise that resolves when a specific subscription is successfully unsubscribed.
      * @param {SUBSCRIPTION_ID} targetId - The ID of the subscription to wait for.
@@ -6201,17 +6229,17 @@ declare class WalletAccountV5 extends Account {
  * The raw spec types remain available through the `RPC` namespace.
  */
 /**
- * Invokes one or more contract calls through the user's STRK20 sub-account for a DAPP,
- * routed via the sub-account anonymizer. The sub-account is selected by (`dapp_name`,
- * `nonce`); each nonce maps to a distinct, deterministic sub-account.
+ * Invokes one or more contract calls through the user's STRK20 shadow account for a DAPP,
+ * routed via the shadow account anonymizer. The shadow account is selected by (`dapp_name`,
+ * `nonce`); each nonce maps to a distinct, deterministic shadow account.
  *
  * The proceeds of the calls are settled into the open notes created by `transfer` actions
  * with `amount: "OPEN"` in the same transaction, so the number of open notes filled by
  * this action must match the number of open notes created in the transaction.
  * @example
  * ```typescript
- * const action: STRK20_SUBACCOUNT_INVOKE_ACTION = {
- *   type: 'subaccount_invoke',
+ * const action: STRK20_SHADOW_ACCOUNT_INVOKE_ACTION = {
+ *   type: 'shadow_account_invoke',
  *   dapp_name: 'myDapp',
  *   nonce: '0x0',
  *   calls: [myContract.populate('stake', { amount: 1000n })],
@@ -6219,8 +6247,8 @@ declare class WalletAccountV5 extends Account {
  * };
  * ```
  */
-type STRK20_SUBACCOUNT_INVOKE_ACTION = Omit<STRK20_SUBACCOUNT_INVOKE_ACTION$1, 'calls'> & {
-    /** The contract calls to execute through the sub-account, in order (min 1). */
+type STRK20_SHADOW_ACCOUNT_INVOKE_ACTION = Omit<STRK20_SHADOW_ACCOUNT_INVOKE_ACTION$1, 'calls'> & {
+    /** The contract calls to execute through the shadow account, in order (min 1). */
     calls: Call[];
 };
 /**
@@ -6229,10 +6257,10 @@ type STRK20_SUBACCOUNT_INVOKE_ACTION = Omit<STRK20_SUBACCOUNT_INVOKE_ACTION$1, '
  * @example
  * ```typescript
  * const actions: STRK20_ACTION[] = [
- *   { type: 'withdraw', token: strkAddress, amount: '0x2386f26fc10000', recipient: subAccountAddr },
+ *   { type: 'withdraw', token: strkAddress, amount: '0x2386f26fc10000', recipient: shadowAccountAddr },
  *   { type: 'transfer', token: strkAddress, amount: 'OPEN', recipient: myAddress },
  *   {
- *     type: 'subaccount_invoke',
+ *     type: 'shadow_account_invoke',
  *     dapp_name: 'myDapp',
  *     nonce: '0x0',
  *     calls: [myContract.populate('stake', { amount: 1000n })],
@@ -6241,7 +6269,7 @@ type STRK20_SUBACCOUNT_INVOKE_ACTION = Omit<STRK20_SUBACCOUNT_INVOKE_ACTION$1, '
  * ];
  * ```
  */
-type STRK20_ACTION = STRK20_DEPOSIT_ACTION | STRK20_WITHDRAW_ACTION | STRK20_TRANSFER_ACTION | STRK20_INVOKE_ACTION | STRK20_SUBACCOUNT_INVOKE_ACTION;
+type STRK20_ACTION = STRK20_DEPOSIT_ACTION | STRK20_WITHDRAW_ACTION | STRK20_TRANSFER_ACTION | STRK20_INVOKE_ACTION | STRK20_SHADOW_ACCOUNT_INVOKE_ACTION;
 /**
  * A Starknet call built by the wallet, together with the SNIP-36 zero-knowledge proof
  * needed to submit it. In simulate mode the proof fields are present but empty, in which
@@ -6333,24 +6361,24 @@ declare class WalletAccountV6 extends WalletAccountV5 {
         transaction_hash: string;
     }>;
     /**
-     * Compute the commitment of a DAPP STRK20 sub-account. The commitment is computed
+     * Compute the commitment of a DAPP STRK20 shadow account. The commitment is computed
      * locally by the wallet from the user private state ; no transaction is sent.
      *
-     * When `nonce` is given, the full commitment of this single sub-account is returned.
+     * When `nonce` is given, the full commitment of this single shadow account is returned.
      * When `nonce` is omitted, the partial (nonce independent) commitment is returned
-     * instead : it is shared by every sub-account the user derives for this DAPP, so it can
-     * be published once to let a DAPP recognize all the sub-accounts of a user without
-     * learning any individual nonce.
-     * @param {STRK20_DAPP_NAME} dappName - The DAPP that scopes the sub-account(s).
-     * @param {FELT} [nonce] - The sub-account nonce ; each nonce selects a distinct sub-account for this user + DAPP. Omit it to get the partial commitment.
-     * @returns {Promise<FELT>} The sub-account commitment.
+     * instead : it is shared by every shadow account the user derives for this DAPP, so it
+     * can be published once to let a DAPP recognize all the shadow accounts of a user
+     * without learning any individual nonce.
+     * @param {STRK20_DAPP_NAME} dappName - The DAPP that scopes the shadow account(s).
+     * @param {FELT} [nonce] - The shadow account nonce ; each nonce selects a distinct shadow account for this user + DAPP. Omit it to get the partial commitment.
+     * @returns {Promise<FELT>} The shadow account commitment.
      * @example
      * ```typescript
-     * const commitment = await myWalletAccount.strk20SubaccountCommitment('myDapp', '0x0');
+     * const commitment = await myWalletAccount.strk20ShadowAccountCommitment('myDapp', '0x0');
      * // commitment = '0x5f2e...'
      * ```
      */
-    strk20SubaccountCommitment(dappName: STRK20_DAPP_NAME, nonce?: FELT$1): Promise<FELT$1>;
+    strk20ShadowAccountCommitment(dappName: STRK20_DAPP_NAME, nonce?: FELT$1): Promise<FELT$1>;
     static connect(provider: ProviderOptions | ProviderInterface, walletProvider: WalletWithStarknetFeatures$1, cairoVersion?: CairoVersion, paymaster?: PaymasterOptions | PaymasterInterface, silentMode?: boolean): Promise<WalletAccountV6>;
     static connectSilent(provider: ProviderOptions | ProviderInterface, walletProvider: WalletWithStarknetFeatures$1, cairoVersion?: CairoVersion, paymaster?: PaymasterOptions | PaymasterInterface): Promise<WalletAccountV6>;
 }
@@ -10672,25 +10700,25 @@ declare function strk20InvokeTransaction(walletWSF: WalletWithStarknetFeatures$1
     transaction_hash: string;
 }>;
 /**
- * Compute the commitment of a DAPP STRK20 sub-account. The commitment is computed locally
- * by the wallet from the user private state ; no transaction is sent.
+ * Compute the commitment of a DAPP STRK20 shadow account. The commitment is computed
+ * locally by the wallet from the user private state ; no transaction is sent.
  *
- * When `nonce` is given, the full commitment of this single sub-account is returned. When
- * `nonce` is omitted, the partial (nonce independent) commitment is returned instead : it
- * is shared by every sub-account the user derives for this DAPP, so it can be published
- * once to let a DAPP recognize all the sub-accounts of a user without learning any
- * individual nonce.
+ * When `nonce` is given, the full commitment of this single shadow account is returned.
+ * When `nonce` is omitted, the partial (nonce independent) commitment is returned instead :
+ * it is shared by every shadow account the user derives for this DAPP, so it can be
+ * published once to let a DAPP recognize all the shadow accounts of a user without learning
+ * any individual nonce.
  * @param {WalletWithStarknetFeaturesV6} walletWSF - The get-starknet V6 wallet object to use.
- * @param {STRK20_DAPP_NAME} dapp_name - The DAPP that scopes the sub-account(s).
- * @param {FELT} [nonce] - The sub-account nonce ; each nonce selects a distinct sub-account for this user + DAPP. Omit it to get the partial commitment.
- * @returns {Promise<FELT>} The sub-account commitment.
+ * @param {STRK20_DAPP_NAME} dapp_name - The DAPP that scopes the shadow account(s).
+ * @param {FELT} [nonce] - The shadow account nonce ; each nonce selects a distinct shadow account for this user + DAPP. Omit it to get the partial commitment.
+ * @returns {Promise<FELT>} The shadow account commitment.
  * @example
  * ```typescript
- * const commitment = await strk20SubaccountCommitment(walletWSF, 'myDapp', '0x0');
+ * const commitment = await strk20ShadowAccountCommitment(walletWSF, 'myDapp', '0x0');
  * // commitment = '0x5f2e...'
  * ```
  */
-declare function strk20SubaccountCommitment(walletWSF: WalletWithStarknetFeatures$1, dapp_name: STRK20_DAPP_NAME, nonce?: FELT$1): Promise<FELT$1>;
+declare function strk20ShadowAccountCommitment(walletWSF: WalletWithStarknetFeatures$1, dapp_name: STRK20_DAPP_NAME, nonce?: FELT$1): Promise<FELT$1>;
 
 declare const connectV6_addDeclareTransaction: typeof addDeclareTransaction;
 declare const connectV6_addInvokeTransaction: typeof addInvokeTransaction;
@@ -10704,14 +10732,14 @@ declare const connectV6_standardConnect: typeof standardConnect;
 declare const connectV6_strk20Balances: typeof strk20Balances;
 declare const connectV6_strk20InvokeTransaction: typeof strk20InvokeTransaction;
 declare const connectV6_strk20PrepareInvoke: typeof strk20PrepareInvoke;
-declare const connectV6_strk20SubaccountCommitment: typeof strk20SubaccountCommitment;
+declare const connectV6_strk20ShadowAccountCommitment: typeof strk20ShadowAccountCommitment;
 declare const connectV6_subscribeWalletEvent: typeof subscribeWalletEvent;
 declare const connectV6_supportedSpecs: typeof supportedSpecs;
 declare const connectV6_supportedWalletApi: typeof supportedWalletApi;
 declare const connectV6_switchStarknetChain: typeof switchStarknetChain;
 declare const connectV6_watchAsset: typeof watchAsset;
 declare namespace connectV6 {
-  export { connectV6_addDeclareTransaction as addDeclareTransaction, connectV6_addInvokeTransaction as addInvokeTransaction, connectV6_addStarknetChain as addStarknetChain, connectV6_deploymentData as deploymentData, connectV6_getPermissions as getPermissions, connectV6_requestAccounts as requestAccounts, connectV6_requestChainId as requestChainId, connectV6_signMessage as signMessage, connectV6_standardConnect as standardConnect, connectV6_strk20Balances as strk20Balances, connectV6_strk20InvokeTransaction as strk20InvokeTransaction, connectV6_strk20PrepareInvoke as strk20PrepareInvoke, connectV6_strk20SubaccountCommitment as strk20SubaccountCommitment, connectV6_subscribeWalletEvent as subscribeWalletEvent, connectV6_supportedSpecs as supportedSpecs, connectV6_supportedWalletApi as supportedWalletApi, connectV6_switchStarknetChain as switchStarknetChain, connectV6_watchAsset as watchAsset };
+  export { connectV6_addDeclareTransaction as addDeclareTransaction, connectV6_addInvokeTransaction as addInvokeTransaction, connectV6_addStarknetChain as addStarknetChain, connectV6_deploymentData as deploymentData, connectV6_getPermissions as getPermissions, connectV6_requestAccounts as requestAccounts, connectV6_requestChainId as requestChainId, connectV6_signMessage as signMessage, connectV6_standardConnect as standardConnect, connectV6_strk20Balances as strk20Balances, connectV6_strk20InvokeTransaction as strk20InvokeTransaction, connectV6_strk20PrepareInvoke as strk20PrepareInvoke, connectV6_strk20ShadowAccountCommitment as strk20ShadowAccountCommitment, connectV6_subscribeWalletEvent as subscribeWalletEvent, connectV6_supportedSpecs as supportedSpecs, connectV6_supportedWalletApi as supportedWalletApi, connectV6_switchStarknetChain as switchStarknetChain, connectV6_watchAsset as watchAsset };
 }
 
 type DefaultConfig = typeof DEFAULT_GLOBAL_CONFIG;
@@ -10815,4 +10843,4 @@ declare class Logger {
  */
 declare const logger: Logger;
 
-export { type Abi, type AbiEntry, type AbiEntryType, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, AbiParser1, AbiParser2, AbiParserInterface, type AbiStruct, type AbiStructs, Account, type AccountHooks, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AccountOptions, type AllowArray, type ApiEstimateFeeResponse, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockTransactionTrace, type BlockTransactionsTracesWithInitialReads, type BlockWithTxHashes, BrotherIdImpl, type BrotherIdProviderMethods, type BrotherProfile, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint128, CairoUint16, CairoUint256, CairoUint32, CairoUint512, CairoUint64, CairoUint8, CairoUint96, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallResult, type Calldata, type CommonContractOptions, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, Deployer, type DeployerCall, DeployerInterface, type Details, EDAMode, EDataAvailabilityMode, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, ETxnResponseFlag, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type ErrorReceiptResponseHelper, type EstimateFeeBulk, type EstimateFeeResponseBulkOverhead, type EstimateFeeResponseOverhead, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecuteOptions, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FactoryParams, type FastExecuteAccountMethods, type FastExecuteProviderMethods, type FastExecuteResponse, type FastWaitForTransactionOptions, type FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, type INITIAL_READS, Int, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LoadedContract, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PRE_CONFIRMED_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type ParsingStrategy, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PluginConfig, PluginManager, type PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, type ProviderHooks, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_10_2 as RPC0102, rpc_0_10_3 as RPC0103, rpc_0_9_0 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type ReconnectOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, type STRK20_ACTION, type STRK20_CALL_AND_PROOF, type STRK20_SUBACCOUNT_INVOKE_ACTION, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionOverhead, type SimulateTransactionOverheadResponse, type SimulateTransactionResponse, type SimulationFlags, type StarkProfile, type StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, type StateUpdate, type StateUpdateResponse, type StorageResponse, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, type SubscriptionStarknetEventsEvent, type SubscriptionTransactionStatusEvent, type SuccessfulTransactionReceiptResponse, type SuccessfulTransactionReceiptResponseHelper, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, TimeoutError, type TipAnalysisOptions, type TipEstimate, type TipType, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, type TransactionTrace, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UserInvoke, type UserTransaction, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, WalletAccountV5, WalletAccountV6, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, type WeierstrassSignatureType, type WithOptions, addAddressPadding, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, eth, index as events, extractContractHashes, fastExecute, fastParsingStrategy, getAbiVersion, type getBlockTransactionsTracesOptions, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getGasPrices, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, getTipStatsFromBlocks, index$3 as hash, hdParsingStrategy, isAccount, isFileSystemAvailable, isNoConstructorValid, isPreConfirmedBlock, isPreConfirmedStateUpdate, isPreConfirmedTransaction, isRPC08Plus_ResourceBounds, isRPC08Plus_ResourceBoundsBN, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, legacyDeployer, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, starknetId$1 as starknetIdPlugin, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5, connectV6 as walletV6 };
+export { type Abi, type AbiEntry, type AbiEntryType, type AbiEnum, type AbiEnums, type AbiEvent, type AbiEvents, type AbiInterfaces, AbiParser1, AbiParser2, AbiParserInterface, type AbiStruct, type AbiStructs, Account, type AccountHooks, AccountInterface, type AccountInvocationItem, type AccountInvocations, type AccountInvocationsFactoryDetails, type AccountOptions, type AllowArray, type ApiEstimateFeeResponse, type Args, type ArgsOrCalldata, type ArgsOrCalldataWithOptions, type ArraySignatureType, type AsyncContractFunction, type BLOCK_HASH, type BLOCK_NUMBER, BatchClient, type BatchClientOptions, type BigNumberish, type Block$1 as Block, type BlockIdentifier, type BlockNumber, BlockStatus, BlockTag, type BlockTransactionTrace, type BlockTransactionsTracesWithInitialReads, type BlockWithTxHashes, BrotherIdImpl, type BrotherIdProviderMethods, type BrotherProfile, type Builtins, type ByteArray, type ByteCode, type CairoAssembly, CairoByteArray, CairoBytes31, type CairoContract, CairoCustomEnum, type CairoEnum, type CairoEnumRaw, type CairoEvent, type CairoEventDefinition, type CairoEventVariant, CairoFelt, CairoFelt252, CairoFixedArray, CairoInt128, CairoInt16, CairoInt32, CairoInt64, CairoInt8, CairoOption, CairoOptionVariant, CairoResult, CairoResultVariant, CairoUint128, CairoUint16, CairoUint256, CairoUint32, CairoUint512, CairoUint64, CairoUint8, CairoUint96, type CairoVersion, type Call, type CallContractResponse, CallData, type CallDetails, type CallOptions, type CallResult, type Calldata, type CommonContractOptions, type CompiledContract, type CompiledSierra, type CompiledSierraCasm, type CompilerVersion, type CompleteDeclareContractPayload, type CompressedProgram, Contract, type ContractClass, type ContractClassIdentifier, type ContractClassPayload, type ContractClassResponse, type ContractEntryPointFields, type ContractFunction, ContractInterface, type ContractOptions, type ContractVersion, type DeclareAndDeployContractPayload, type DeclareContractPayload, type DeclareContractResponse, type DeclareContractTransaction, type DeclareDeployUDCResponse, type DeclareSignerDetails, type DeclareTransactionReceiptResponse, type DeclaredTransaction, type DeployAccountContractPayload, type DeployAccountContractTransaction, type DeployAccountSignerDetails, type DeployAccountTransactionReceiptResponse, type DeployAndInvokeTransaction, type DeployContractResponse, type DeployContractUDCResponse, type DeployTransaction, type DeployTransactionReceiptResponse, type DeployedAccountTransaction, Deployer, type DeployerCall, DeployerInterface, type Details, EDAMode, EDataAvailabilityMode, ESubscriptionTag, ETH_ADDRESS, ETraceFlag, ETransactionExecutionStatus, ETransactionStatus, ETransactionVersion, ETransactionVersion2, ETransactionVersion3, ETxnResponseFlag, type EVENTS_CHUNK, type EmittedEvent, EntryPointType, type EntryPointsByType, type ErrorReceiptResponseHelper, type EstimateFeeBulk, type EstimateFeeResponseBulkOverhead, type EstimateFeeResponseOverhead, EthSigner, type Event$1 as Event, type EventEntry, type EventFilter, type ExecutableDeployAndInvokeTransaction, type ExecutableDeployTransaction, type ExecutableInvokeTransaction, type ExecutableUserInvoke, type ExecutableUserTransaction, type ExecuteOptions, type ExecutionParameters, type FEE_ESTIMATE, type FELT, type FactoryParams, type FastExecuteAccountMethods, type FastExecuteProviderMethods, type FastExecuteResponse, type FastWaitForTransactionOptions, type FeeEstimate, type FeeMode, type FormatResponse, type FunctionAbi, type GasPrices, type GetBlockResponse, type GetTransactionReceiptResponse, type GetTransactionResponse, type GetTxReceiptResponseWithoutHelper, type HexCalldata, type Hint, type INITIAL_READS, Int, type InterfaceAbi, type Invocation, type Invocations, type InvocationsDetails, type InvocationsDetailsWithNonce, type InvocationsSignerDetails, type InvokeFunctionResponse, type InvokeTransaction, type InvokeTransactionReceiptResponse, type InvokedTransaction, type L1HandlerTransactionReceiptResponse, type L1_HANDLER_TXN, type LedgerPathCalculation, LedgerSigner111 as LedgerSigner, LedgerSigner111, LedgerSigner221, LedgerSigner231, type LegacyCompiledContract, type LegacyContractClass, type LegacyEvent, LibraryError, Literal, type LoadedContract, type LogLevel, LogLevelIndex, type Methods, type MultiDeployContractResponse, type MultiType, NON_ZERO_PREFIX, type Nonce, type OptionalPayload, type OutsideCall, type OutsideExecution, type OutsideExecutionOptions, OutsideExecutionTypesV1, OutsideExecutionTypesV2, OutsideExecutionVersion, type OutsideTransaction, type PRE_CONFIRMED_STATE_UPDATE, type PRICE_UNIT, type ParsedEvent, type ParsedEvents, type ParsedStruct, type ParsingStrategy, type PaymasterDetails, type PaymasterFeeEstimate, PaymasterInterface, type PaymasterOptions, PaymasterRpc, type PaymasterRpcOptions, type PaymasterTimeBounds, type PluginConfig, PluginManager, type PreConfirmedBlock, type PreConfirmedStateUpdate, type PreparedDeployAndInvokeTransaction, type PreparedDeployTransaction, type PreparedInvokeTransaction, type PreparedTransaction, type Program, RpcProvider as Provider, type ProviderHooks, ProviderInterface, type ProviderOptions, type ProviderOrAccount, type PythonicHints, type RESOURCE_PRICE, index$4 as RPC, rpc_0_10_2 as RPC0102, rpc_0_10_3 as RPC0103, rpc_0_9_0 as RPC09, RPCResponseParser, type RPC_ERROR, type RPC_ERROR_SET, type RawArgs, type RawArgsArray, type RawArgsObject, type RawCalldata, type Receipt, ReceiptTx, type ReconnectOptions, type RequiredKeysOf, type ResourceBounds, type ResourceBoundsBN, type ResourceBoundsOverhead, ResponseParser, type RevertedTransactionReceiptResponse, type RevertedTransactionReceiptResponseHelper, RpcChannel, RpcError, RpcProvider, type RpcProviderOptions, type SIMULATION_FLAG, type STATE_UPDATE, type STRK20_ACTION, type STRK20_CALL_AND_PROOF, type STRK20_SHADOW_ACCOUNT_INVOKE_ACTION, type SierraContractClass, type SierraContractEntryPointFields, type SierraEntryPointsByType, type SierraProgramDebugInfo, type Signature, Signer, SignerInterface, type Simplify, type SimulateTransaction, type SimulateTransactionDetails, type SimulateTransactionOverhead, type SimulateTransactionOverheadResponse, type SimulateTransactionResponse, type SimulationFlags, type StarkProfile, type StarknetIdAccountMethods, StarknetIdImpl, type StarknetIdProviderMethods, type StarknetPlugin, type StateUpdate, type StateUpdateResponse, type StorageResponse, type SubscribeEventsParams, type SubscribeNewHeadsParams, type SubscribeNewTransactionReceiptsParams, type SubscribeNewTransactionsParams, type SubscribeTransactionStatusParams, Subscription, type SubscriptionBlockIdentifier, type SubscriptionNewHeadsEvent, type SubscriptionNewTransactionEvent, type SubscriptionNewTransactionReceiptsEvent, type SubscriptionOptions, type SubscriptionStarknetEventsEvent, type SubscriptionTransactionStatusEvent, type SuccessfulTransactionReceiptResponse, type SuccessfulTransactionReceiptResponseHelper, type TXN_EXECUTION_STATUS, type TXN_HASH, type TXN_STATUS, TimeoutError, type TipAnalysisOptions, type TipEstimate, type TipType, type TokenData, TransactionExecutionStatus, TransactionFinalityStatus, type TransactionReceipt, type TransactionReceiptCallbacks, type TransactionReceiptCallbacksDefault, type TransactionReceiptCallbacksDefined, type TransactionReceiptStatus, type TransactionReceiptValue, type TransactionStatus, type TransactionStatusReceiptSets, type TransactionTrace, TransactionType, type TransactionWithHash, type Tupled, type TypedContractV2, UINT_128_MAX, UINT_128_MIN, UINT_256_HIGH_MAX, UINT_256_HIGH_MIN, UINT_256_LOW_MAX, UINT_256_LOW_MIN, UINT_256_MAX, UINT_256_MIN, UINT_512_MAX, UINT_512_MIN, Uint, type Uint256, type Uint512, type UniversalDeployerContractPayload, type UniversalDetails, type UserInvoke, type UserTransaction, type V3DeclareSignerDetails, type V3DeployAccountSignerDetails, type V3InvocationsSignerDetails, type V3TransactionDetails, ValidateType, WalletAccount, WalletAccountV5, WalletAccountV6, WebSocketChannel, type WebSocketModule, WebSocketNotConnectedError, type WebSocketOptions, type WeierstrassSignatureType, type WithOptions, addAddressPadding, brotherId, byteArray, cairo, compareVersions, config, constants, contractClassResponseToLegacyCompiledContract, contractLoader, createAbiParser, createTransactionReceipt, defaultDeployer, defaultPlugins, ec, encode, eth, index as events, extractContractHashes, fastExecute, fastParsingStrategy, getAbiVersion, type getBlockTransactionsTracesOptions, getChecksumAddress, type getContractVersionOptions, type getEstimateFeeBulkOptions, getGasPrices, getLedgerPathBuffer111 as getLedgerPathBuffer, getLedgerPathBuffer111, getLedgerPathBuffer221, type getSimulateTransactionOptions, getTipStatsFromBlocks, index$3 as hash, hdParsingStrategy, isAccount, isFileSystemAvailable, isNoConstructorValid, isPreConfirmedBlock, isPreConfirmedStateUpdate, isPreConfirmedTransaction, isRPC08Plus_ResourceBounds, isRPC08Plus_ResourceBoundsBN, isSierra, isSupportedSpecVersion, isV3Tx, isVersion, json, legacyDeployer, logger, merkle, num, outsideExecution, parseCalldataField, paymaster, provider, selector, shortString, src5, index$1 as stark, starknetId, starknetId$1 as starknetIdPlugin, toAnyPatchVersion, toApiVersion, index$2 as transaction, typedData, uint256$1 as uint256, units, v2 as v2hash, v3 as v3hash, validateAndParseAddress, validateChecksumAddress, verifyMessageInStarknet, type waitForTransactionOptions, connect as wallet, connectV5 as walletV5, connectV6 as walletV6 };

package/dist/index.global.js

@@ -12516,6 +12516,8 @@ ${indent}}` : "}";
     maxBufferSize;
     handler = null;
     _isClosed = false;
+    // The unsubscribe request currently on the wire, shared by concurrent callers.
+    pendingUnsubscribe = null;
     /**
      * @internal
      * @param options - Subscription configuration options
@@ -12534,6 +12536,20 @@ ${indent}}` : "}";
     get isClosed() {
       return this._isClosed;
     }
+    /**
+     * Closes the subscription locally, without contacting the node.
+     *
+     * Used when the channel knows the subscription is gone and cannot be recovered — a
+     * re-subscribe refused after a reconnection, for instance. Without it the object would keep
+     * reporting itself as open while no event could ever reach its handler again.
+     * @internal
+     */
+    _markClosed() {
+      if (this._isClosed) return;
+      this._isClosed = true;
+      this.events.emit("unsubscribe", void 0);
+      this.events.clear();
+    }
     /**
      * Internal method to handle incoming events from the WebSocket channel.
      * If a handler is attached, it's invoked immediately. Otherwise, the event is buffered.
@@ -12580,14 +12596,24 @@ ${indent}}` : "}";
       if (this._isClosed) {
         return true;
       }
-      const success = await this.channel.unsubscribe(this.id);
-      if (success) {
-        this._isClosed = true;
-        this.channel.removeSubscription(this.id);
-        this.events.emit("unsubscribe", void 0);
-        this.events.clear();
+      if (this.pendingUnsubscribe) {
+        return this.pendingUnsubscribe;
       }
-      return success;
+      this.pendingUnsubscribe = (async () => {
+        try {
+          const success = await this.channel.unsubscribe(this.id);
+          if (success) {
+            this._isClosed = true;
+            this.channel.removeSubscription(this.id);
+            this.events.emit("unsubscribe", void 0);
+            this.events.clear();
+          }
+          return success;
+        } finally {
+          this.pendingUnsubscribe = null;
+        }
+      })();
+      return this.pendingUnsubscribe;
     }
   };
 
@@ -12620,6 +12646,15 @@ ${indent}}` : "}";
     requestQueue = [];
     /** Abort handles for the requests currently on the wire, one per pending `sendReceive`. */
     inFlight = /* @__PURE__ */ new Set();
+    /**
+     * Callers blocked in `waitForUnsubscription`, keyed by subscription id.
+     *
+     * Held here rather than as `unsubscribe` event listeners because that event only ever
+     * announces success: a waiter attached to it cannot learn that the node refused the
+     * unsubscribe or that the connection went away, and would wait forever with no timeout of
+     * its own to fall back on.
+     */
+    unsubscribeWaiters = /* @__PURE__ */ new Map();
     events = new EventEmitter();
     openListener = (ev) => {
       this.scheduleReconnectAttemptsReset();
@@ -12816,6 +12851,7 @@ ${indent}}` : "}";
       this.isReconnecting = false;
       this._rejectRequestQueue("the connection was closed by the user");
       this._rejectInFlight("the connection was closed by the user");
+      this._rejectUnsubscribeWaiters("the connection was closed by the user");
       this.websocket.close(code, reason);
     }
     /**
@@ -12840,14 +12876,48 @@ ${indent}}` : "}";
      * @returns {Promise<boolean>} A Promise that resolves with `true` if the unsubscription was successful.
      */
     async unsubscribe(subscriptionId) {
-      const status = await this.sendReceive("starknet_unsubscribe", {
-        subscription_id: subscriptionId
-      });
+      let status;
+      try {
+        status = await this.sendReceive("starknet_unsubscribe", {
+          subscription_id: subscriptionId
+        });
+      } catch (error) {
+        this._settleUnsubscribeWaiters(subscriptionId, error);
+        throw error;
+      }
       if (status) {
         this.events.emit("unsubscribe", subscriptionId);
+        this._settleUnsubscribeWaiters(subscriptionId);
+      } else {
+        this._settleUnsubscribeWaiters(
+          subscriptionId,
+          new Error(`Node refused to unsubscribe subscription ${subscriptionId}`)
+        );
       }
       return status;
     }
+    /** Settles every caller waiting on one subscription id: resolved, or rejected with `error`. */
+    _settleUnsubscribeWaiters(subscriptionId, error) {
+      const waiters = this.unsubscribeWaiters.get(subscriptionId);
+      if (!waiters) return;
+      this.unsubscribeWaiters.delete(subscriptionId);
+      waiters.forEach((waiter) => error ? waiter.reject(error) : waiter.resolve());
+    }
+    /**
+     * Rejects every caller still waiting on any subscription.
+     *
+     * Once the connection is gone, no unsubscribe can be observed on it: a reconnection restores
+     * each subscription under a fresh id, so the id being waited on will never be announced.
+     */
+    _rejectUnsubscribeWaiters(reason) {
+      if (this.unsubscribeWaiters.size === 0) return;
+      Array.from(this.unsubscribeWaiters.keys()).forEach(
+        (id) => this._settleUnsubscribeWaiters(
+          id,
+          new WebSocketNotConnectedError(`Subscription ${id} was never unsubscribed: ${reason}`)
+        )
+      );
+    }
     /**
      * Returns a Promise that resolves when a specific subscription is successfully unsubscribed.
      * @param {SUBSCRIPTION_ID} targetId - The ID of the subscription to wait for.
@@ -12859,14 +12929,10 @@ ${indent}}` : "}";
      * ```
      */
     waitForUnsubscription(targetId) {
-      return new Promise((resolve) => {
-        const listener = (unsubId) => {
-          if (unsubId === targetId) {
-            this.events.off("unsubscribe", listener);
-            resolve();
-          }
-        };
-        this.events.on("unsubscribe", listener);
+      return new Promise((resolve, reject) => {
+        const waiters = this.unsubscribeWaiters.get(targetId) ?? /* @__PURE__ */ new Set();
+        waiters.add({ resolve, reject });
+        this.unsubscribeWaiters.set(targetId, waiters);
       });
     }
     /**
@@ -12933,6 +12999,7 @@ ${indent}}` : "}";
           logger.info(`Subscription ${sub.method} restored with new ID: ${newSubId}`);
         } catch (error) {
           logger.error(`Failed to restore subscription ${sub.method}:`, error);
+          sub._markClosed();
         }
       });
       await Promise.all(restorePromises);
@@ -13002,6 +13069,7 @@ ${indent}}` : "}";
       this.websocket.removeEventListener("message", this.messageListener);
       this.websocket.removeEventListener("error", this.errorListener);
       this._rejectInFlight("the connection was closed");
+      this._rejectUnsubscribeWaiters("the connection was closed");
       this.events.emit("close", ev);
       if (!this.userInitiatedClose) {
         this._startReconnect();
@@ -13023,9 +13091,16 @@ ${indent}}` : "}";
         if (subscription) {
           subscription._handleEvent(result);
         } else {
-          logger.warn(
-            `WebSocketChannel: Received event for untracked subscription ID: ${subscription_id}.`
-          );
+          queueMicrotask(() => {
+            const registered = this.activeSubscriptions.get(subscription_id);
+            if (registered) {
+              registered._handleEvent(result);
+            } else {
+              logger.warn(
+                `WebSocketChannel: Received event for untracked subscription ID: ${subscription_id}.`
+              );
+            }
+          });
         }
       }
       logger.debug("onMessageProxy:", event.data);
@@ -18072,7 +18147,7 @@ ${indent}}` : "}";
   }
   function toWalletApiActions(actions) {
     return actions.map(
-      (action) => action.type === "subaccount_invoke" ? { ...action, calls: action.calls.map(toWalletApiCall) } : action
+      (action) => action.type === "shadow_account_invoke" ? { ...action, calls: action.calls.map(toWalletApiCall) } : action
     );
   }
 
@@ -18091,7 +18166,7 @@ ${indent}}` : "}";
     strk20Balances: () => strk20Balances,
     strk20InvokeTransaction: () => strk20InvokeTransaction,
     strk20PrepareInvoke: () => strk20PrepareInvoke,
-    strk20SubaccountCommitment: () => strk20SubaccountCommitment,
+    strk20ShadowAccountCommitment: () => strk20ShadowAccountCommitment,
     subscribeWalletEvent: () => subscribeWalletEvent2,
     supportedSpecs: () => supportedSpecs3,
     supportedWalletApi: () => supportedWalletApi3,
@@ -18179,9 +18254,9 @@ ${indent}}` : "}";
       params: { actions }
     });
   }
-  function strk20SubaccountCommitment(walletWSF, dapp_name, nonce) {
+  function strk20ShadowAccountCommitment(walletWSF, dapp_name, nonce) {
     return walletWSF.features["starknet:walletApi"].request({
-      type: "wallet_strk20SubaccountCommitment",
+      type: "wallet_strk20ShadowAccountCommitment",
       params: { dapp_name, nonce }
     });
   }
@@ -18273,25 +18348,25 @@ ${indent}}` : "}";
       return strk20InvokeTransaction(this.v6Provider, toWalletApiActions(actions));
     }
     /**
-     * Compute the commitment of a DAPP STRK20 sub-account. The commitment is computed
+     * Compute the commitment of a DAPP STRK20 shadow account. The commitment is computed
      * locally by the wallet from the user private state ; no transaction is sent.
      *
-     * When `nonce` is given, the full commitment of this single sub-account is returned.
+     * When `nonce` is given, the full commitment of this single shadow account is returned.
      * When `nonce` is omitted, the partial (nonce independent) commitment is returned
-     * instead : it is shared by every sub-account the user derives for this DAPP, so it can
-     * be published once to let a DAPP recognize all the sub-accounts of a user without
-     * learning any individual nonce.
-     * @param {STRK20_DAPP_NAME} dappName - The DAPP that scopes the sub-account(s).
-     * @param {FELT} [nonce] - The sub-account nonce ; each nonce selects a distinct sub-account for this user + DAPP. Omit it to get the partial commitment.
-     * @returns {Promise<FELT>} The sub-account commitment.
+     * instead : it is shared by every shadow account the user derives for this DAPP, so it
+     * can be published once to let a DAPP recognize all the shadow accounts of a user
+     * without learning any individual nonce.
+     * @param {STRK20_DAPP_NAME} dappName - The DAPP that scopes the shadow account(s).
+     * @param {FELT} [nonce] - The shadow account nonce ; each nonce selects a distinct shadow account for this user + DAPP. Omit it to get the partial commitment.
+     * @returns {Promise<FELT>} The shadow account commitment.
      * @example
      * ```typescript
-     * const commitment = await myWalletAccount.strk20SubaccountCommitment('myDapp', '0x0');
+     * const commitment = await myWalletAccount.strk20ShadowAccountCommitment('myDapp', '0x0');
      * // commitment = '0x5f2e...'
      * ```
      */
-    strk20SubaccountCommitment(dappName, nonce) {
-      return strk20SubaccountCommitment(this.v6Provider, dappName, nonce);
+    strk20ShadowAccountCommitment(dappName, nonce) {
+      return strk20ShadowAccountCommitment(this.v6Provider, dappName, nonce);
     }
     static async connect(provider, walletProvider, cairoVersion, paymaster, silentMode = false) {
       const { accounts } = await standardConnect2(walletProvider, silentMode);