starknet 11.0.0 → 11.0.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [11.0.1](https://github.com/starknet-io/starknet.js/compare/v11.0.0...v11.0.1) (2026-09-18)
+
+### Bug Fixes
+
+- **wallet:** missing RPC 0.10.4 valid_until option on strk20Balances ([c96a31a](https://github.com/starknet-io/starknet.js/commit/c96a31abb05b1c4c5b90ba2f8e320307731a3861))
+
 # [11.0.0](https://github.com/starknet-io/starknet.js/compare/v10.8.0...v11.0.0) (2026-09-14)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -9801,15 +9801,25 @@ declare class WalletAccountV6 extends WalletAccountV5 {
     executeWithProof(calls: AllowArray<Call>, proof?: STRK20_PROOF): Promise<RPCSPEC0104.AddInvokeTransactionResult>;
     /**
      * Get the private balances held by the user inside the STRK20 privacy pool.
+     *
+     * Reading a shielded balance requires the user approval, and this approval is time
+     * limited : `validUntil` requests when it expires. When it is omitted, the wallet applies
+     * its own default window.
      * @param {Address[]} tokens - The tokens to get the private balance of. An empty array returns every shielded token.
+     * @param {number} [validUntil] - Requested expiry of the balance read authorization, as a Unix timestamp in seconds. Omit it to let the wallet apply its default window.
      * @returns {Promise<STRK20_BALANCE_ENTRY[]>} One entry per token.
      * @example
      * ```typescript
      * const balances = await myWalletAccount.strk20Balances([strkAddress]);
-     * // balances = [{ token: '0x4718...', amount: '0x2386f26fc10000' }]
+     * // balances = [{ token: '0x4718...', balance: '0x2386f26fc10000' }]
+     *
+     * // Asking for a 5 minutes authorization window :
+     * const expiry = Math.floor(Date.now() / 1000) + 300;
+     * const fresh = await myWalletAccount.strk20Balances([strkAddress], expiry);
+     * // fresh = [{ token: '0x4718...', balance: '0x2386f26fc10000' }]
      * ```
      */
-    strk20Balances(tokens: Address[]): Promise<STRK20_BALANCE_ENTRY[]>;
+    strk20Balances(tokens: Address[], validUntil?: number): Promise<STRK20_BALANCE_ENTRY[]>;
     /**
      * Build the Starknet call and the SNIP-36 zero-knowledge proof of a STRK20 transaction,
      * without submitting it : the DAPP submits the returned call itself, and therefore pays
@@ -17437,7 +17447,23 @@ declare function signMessage(walletWSF: WalletWithStarknetFeatures$1, typedData:
 declare function supportedSpecs(walletWSF: WalletWithStarknetFeatures$1): Promise<SpecVersion[]>;
 declare function supportedWalletApi(walletWSF: WalletWithStarknetFeatures$1): Promise<API_VERSION$1[]>;
 declare function subscribeWalletEvent(walletWSF: WalletWithStarknetFeatures$1, callback: (change: StandardEventsChangeProperties$1) => void): () => void;
-declare function strk20Balances(walletWSF: WalletWithStarknetFeatures$1, tokens: Address[]): Promise<STRK20_BALANCE_ENTRY[]>;
+/**
+ * Get the private balances held by the user inside the STRK20 privacy pool.
+ *
+ * Reading a shielded balance requires the user approval, and this approval is time limited :
+ * `valid_until` requests when it expires. When it is omitted, the wallet applies its own
+ * default window.
+ * @param {WalletWithStarknetFeaturesV6} walletWSF - The get-starknet V6 wallet object to use.
+ * @param {Address[]} tokens - The tokens to get the private balance of. An empty array returns every shielded token.
+ * @param {number} [valid_until] - Requested expiry of the balance read authorization, as a Unix timestamp in seconds. Omit it to let the wallet apply its default window.
+ * @returns {Promise<STRK20_BALANCE_ENTRY[]>} One entry per token.
+ * @example
+ * ```typescript
+ * const balances = await strk20Balances(walletWSF, [strkAddress]);
+ * // balances = [{ token: '0x4718...', balance: '0x2386f26fc10000' }]
+ * ```
+ */
+declare function strk20Balances(walletWSF: WalletWithStarknetFeatures$1, tokens: Address[], valid_until?: number): Promise<STRK20_BALANCE_ENTRY[]>;
 declare function strk20PrepareInvoke(walletWSF: WalletWithStarknetFeatures$1, actions: STRK20_ACTION$1[], simulate?: boolean): Promise<STRK20_CALL_AND_PROOF$1>;
 declare function strk20InvokeTransaction(walletWSF: WalletWithStarknetFeatures$1, actions: STRK20_ACTION$1[]): Promise<{
     transaction_hash: string;

package/dist/index.global.js

@@ -25823,10 +25823,10 @@ ${indent}}` : "}";
   function subscribeWalletEvent2(walletWSF, callback) {
     return walletWSF.features["standard:events"].on("change", callback);
   }
-  function strk20Balances(walletWSF, tokens) {
+  function strk20Balances(walletWSF, tokens, valid_until) {
     return walletWSF.features["starknet:walletApi"].request({
       type: "wallet_strk20Balances",
-      params: { tokens }
+      params: { tokens, valid_until }
     });
   }
   function strk20PrepareInvoke(walletWSF, actions, simulate) {
@@ -25879,16 +25879,26 @@ ${indent}}` : "}";
     }
     /**
      * Get the private balances held by the user inside the STRK20 privacy pool.
+     *
+     * Reading a shielded balance requires the user approval, and this approval is time
+     * limited : `validUntil` requests when it expires. When it is omitted, the wallet applies
+     * its own default window.
      * @param {Address[]} tokens - The tokens to get the private balance of. An empty array returns every shielded token.
+     * @param {number} [validUntil] - Requested expiry of the balance read authorization, as a Unix timestamp in seconds. Omit it to let the wallet apply its default window.
      * @returns {Promise<STRK20_BALANCE_ENTRY[]>} One entry per token.
      * @example
      * ```typescript
      * const balances = await myWalletAccount.strk20Balances([strkAddress]);
-     * // balances = [{ token: '0x4718...', amount: '0x2386f26fc10000' }]
+     * // balances = [{ token: '0x4718...', balance: '0x2386f26fc10000' }]
+     *
+     * // Asking for a 5 minutes authorization window :
+     * const expiry = Math.floor(Date.now() / 1000) + 300;
+     * const fresh = await myWalletAccount.strk20Balances([strkAddress], expiry);
+     * // fresh = [{ token: '0x4718...', balance: '0x2386f26fc10000' }]
      * ```
      */
-    strk20Balances(tokens) {
-      return strk20Balances(this.v6Provider, tokens);
+    strk20Balances(tokens, validUntil) {
+      return strk20Balances(this.v6Provider, tokens, validUntil);
     }
     /**
      * Build the Starknet call and the SNIP-36 zero-knowledge proof of a STRK20 transaction,