starknet 8.8.0 → 8.9.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.9.1](https://github.com/starknet-io/starknet.js/compare/v8.9.0...v8.9.1) (2025-11-26)
+
+### Bug Fixes
+
+- default value for starknetVersion has to be set ([8f3e675](https://github.com/starknet-io/starknet.js/commit/8f3e67538c981cc6880829e04413502f6973538e))
+
+# [8.9.0](https://github.com/starknet-io/starknet.js/compare/v8.8.0...v8.9.0) (2025-11-13)
+
+### Features
+
+- paymaster snip-29 in Contract class ([#1470](https://github.com/starknet-io/starknet.js/issues/1470)) ([a6b839e](https://github.com/starknet-io/starknet.js/commit/a6b839eec40c2d610e98edba6b838749c7e89053))
+
 # [8.8.0](https://github.com/starknet-io/starknet.js/compare/v8.7.0...v8.8.0) (2025-11-12)
 
 ### Bug Fixes

package/dist/index.d.ts

@@ -3244,6 +3244,8 @@ type ExecuteOptions = Pick<CommonContractOptions, 'parseRequest'> & {
      * Deployer contract salt
      */
     salt?: string;
+    paymasterDetails?: PaymasterDetails;
+    maxFeeInGasToken?: BigNumberish;
     /**
      * Wait for transaction to be included in a block
      * @default false
@@ -3917,7 +3919,7 @@ declare const DEFAULT_GLOBAL_CONFIG: {
     blake: ((uint8Array: Uint8Array) => Uint8Array) | undefined;
 };
 declare const RPC_DEFAULT_NODES: {
-    readonly SN_MAIN: readonly ["https://starknet-mainnet.g.alchemy.com/starknet/version/rpc"];
+    readonly SN_MAIN: readonly ["https://starknet-mainnet.g.alchemy.com/starknet/version/rpc/"];
     readonly SN_SEPOLIA: readonly ["https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/"];
 };
 declare const PAYMASTER_RPC_NODES: {
@@ -3937,6 +3939,7 @@ declare const SYSTEM_MESSAGES: {
     consensusFailed: string;
     txFailsBlockBuildingValidation: string;
 };
+declare const SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS: "0.14.1";
 
 declare const constants_ADDR_BOUND: typeof ADDR_BOUND;
 declare const constants_API_VERSION: typeof API_VERSION;
@@ -3966,6 +3969,7 @@ declare const constants_RANGE_U96: typeof RANGE_U96;
 declare const constants_RPC_DEFAULT_NODES: typeof RPC_DEFAULT_NODES;
 declare const constants_SNIP9_V1_INTERFACE_ID: typeof SNIP9_V1_INTERFACE_ID;
 declare const constants_SNIP9_V2_INTERFACE_ID: typeof SNIP9_V2_INTERFACE_ID;
+declare const constants_SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS: typeof SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS;
 declare const constants_SYSTEM_MESSAGES: typeof SYSTEM_MESSAGES;
 type constants_SupportedCairoVersion = SupportedCairoVersion;
 type constants_SupportedTransactionVersion = SupportedTransactionVersion;
@@ -3973,7 +3977,7 @@ declare const constants_TEXT_TO_FELT_MAX_LEN: typeof TEXT_TO_FELT_MAX_LEN;
 declare const constants_UDC: typeof UDC;
 declare const constants_ZERO: typeof ZERO;
 declare namespace constants {
-  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, _BaseUrl as BaseUrl, constants_DEFAULT_GLOBAL_CONFIG as DEFAULT_GLOBAL_CONFIG, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_LegacyUDC as LegacyUDC, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, _NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PAYMASTER_RPC_NODES as PAYMASTER_RPC_NODES, constants_PRIME as PRIME, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_I16 as RANGE_I16, constants_RANGE_I32 as RANGE_I32, constants_RANGE_I64 as RANGE_I64, constants_RANGE_I8 as RANGE_I8, constants_RANGE_U128 as RANGE_U128, constants_RANGE_U16 as RANGE_U16, constants_RANGE_U32 as RANGE_U32, constants_RANGE_U64 as RANGE_U64, constants_RANGE_U8 as RANGE_U8, constants_RANGE_U96 as RANGE_U96, constants_RPC_DEFAULT_NODES as RPC_DEFAULT_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_SYSTEM_MESSAGES as SYSTEM_MESSAGES, _StarknetChainId as StarknetChainId, type constants_SupportedCairoVersion as SupportedCairoVersion, _SupportedRpcVersion as SupportedRpcVersion, type constants_SupportedTransactionVersion as SupportedTransactionVersion, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, _TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
+  export { constants_ADDR_BOUND as ADDR_BOUND, constants_API_VERSION as API_VERSION, _BaseUrl as BaseUrl, constants_DEFAULT_GLOBAL_CONFIG as DEFAULT_GLOBAL_CONFIG, constants_HARDENING_4BYTES as HARDENING_4BYTES, constants_HARDENING_BYTE as HARDENING_BYTE, constants_IS_BROWSER as IS_BROWSER, constants_LegacyUDC as LegacyUDC, constants_MASK_250 as MASK_250, constants_MASK_31 as MASK_31, constants_MAX_STORAGE_ITEM_SIZE as MAX_STORAGE_ITEM_SIZE, _NetworkName as NetworkName, constants_OutsideExecutionCallerAny as OutsideExecutionCallerAny, constants_PAYMASTER_RPC_NODES as PAYMASTER_RPC_NODES, constants_PRIME as PRIME, constants_RANGE_FELT as RANGE_FELT, constants_RANGE_I128 as RANGE_I128, constants_RANGE_I16 as RANGE_I16, constants_RANGE_I32 as RANGE_I32, constants_RANGE_I64 as RANGE_I64, constants_RANGE_I8 as RANGE_I8, constants_RANGE_U128 as RANGE_U128, constants_RANGE_U16 as RANGE_U16, constants_RANGE_U32 as RANGE_U32, constants_RANGE_U64 as RANGE_U64, constants_RANGE_U8 as RANGE_U8, constants_RANGE_U96 as RANGE_U96, constants_RPC_DEFAULT_NODES as RPC_DEFAULT_NODES, constants_SNIP9_V1_INTERFACE_ID as SNIP9_V1_INTERFACE_ID, constants_SNIP9_V2_INTERFACE_ID as SNIP9_V2_INTERFACE_ID, constants_SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS as SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS, constants_SYSTEM_MESSAGES as SYSTEM_MESSAGES, _StarknetChainId as StarknetChainId, type constants_SupportedCairoVersion as SupportedCairoVersion, _SupportedRpcVersion as SupportedRpcVersion, type constants_SupportedTransactionVersion as SupportedTransactionVersion, constants_TEXT_TO_FELT_MAX_LEN as TEXT_TO_FELT_MAX_LEN, _TransactionHashPrefix as TransactionHashPrefix, constants_UDC as UDC, constants_ZERO as ZERO };
 }
 
 declare class RpcChannel$1 {
@@ -5355,7 +5359,7 @@ declare abstract class ContractInterface {
      */
     abstract estimate(method: string, args?: ArgsOrCalldata, options?: {
         blockIdentifier?: BlockIdentifier;
-    }): Promise<EstimateFeeResponseOverhead>;
+    }): Promise<EstimateFeeResponseOverhead | PaymasterFeeEstimate>;
     /**
      * Populate transaction data for a contract method call
      *
@@ -5483,7 +5487,7 @@ declare class Contract implements ContractInterface {
         waitForTransaction: false;
     }): Promise<InvokeFunctionResponse>;
     invoke(method: string, args?: ArgsOrCalldata, options?: ExecuteOptions): Promise<InvokeFunctionResponse>;
-    estimate(method: string, args?: ArgsOrCalldata, estimateDetails?: UniversalDetails): Promise<EstimateFeeResponseOverhead>;
+    estimate(method: string, args?: ArgsOrCalldata, estimateDetails?: ExecuteOptions): Promise<EstimateFeeResponseOverhead | PaymasterFeeEstimate>;
     populate(method: string, args?: RawArgs): Call;
     parseEvents(receipt: GetTransactionReceiptResponse): ParsedEvents;
     isCairo1(): boolean;

package/dist/index.global.js

@@ -214,6 +214,7 @@ var starknet = (() => {
     RPC_DEFAULT_NODES: () => RPC_DEFAULT_NODES,
     SNIP9_V1_INTERFACE_ID: () => SNIP9_V1_INTERFACE_ID,
     SNIP9_V2_INTERFACE_ID: () => SNIP9_V2_INTERFACE_ID,
+    SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS: () => SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS,
     SYSTEM_MESSAGES: () => SYSTEM_MESSAGES,
     StarknetChainId: () => _StarknetChainId,
     SupportedRpcVersion: () => _SupportedRpcVersion,
@@ -1179,7 +1180,7 @@ var starknet = (() => {
     blake: void 0
   };
   var RPC_DEFAULT_NODES = {
-    SN_MAIN: [`https://starknet-mainnet.g.alchemy.com/starknet/version/rpc`],
+    SN_MAIN: [`https://starknet-mainnet.g.alchemy.com/starknet/version/rpc/`],
     SN_SEPOLIA: [`https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/`]
   };
   var PAYMASTER_RPC_NODES = {
@@ -1199,6 +1200,7 @@ var starknet = (() => {
     consensusFailed: "Consensus failed to finalize the block proposal",
     txFailsBlockBuildingValidation: "Transaction fails block building validation"
   };
+  var SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS = "0.14.1";
 
   // src/global/config.ts
   var Configuration = class _Configuration {
@@ -9938,8 +9940,8 @@ ${indent}}` : "}";
     }
     return computeLegacyContractClassHash(compiledContract);
   }
-  function computeCompiledClassHash(casm, starknetVersion) {
-    if (starknetVersion && compareVersions(starknetVersion, "0.14.1") >= 0) {
+  function computeCompiledClassHash(casm, starknetVersion = SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS) {
+    if (compareVersions(starknetVersion, SN_VERSION_IMPLEMENTING_BLAKE_FOR_COMPILED_CLASS) >= 0) {
       return computeCompiledClassHashBlake(casm);
     }
     return computeCompiledClassHashPoseidon(casm);
@@ -21694,7 +21696,7 @@ ${indent}}` : "}";
       });
     }
     async invoke(method, args = [], options = {}) {
-      const { parseRequest = true, signature, waitForTransaction, ...RestInvokeOptions } = options;
+      const { parseRequest = true, signature, waitForTransaction, ...restInvokeOptions } = options;
       assert(this.address !== null, "contract is not connected to an address");
       const calldata = getCompiledCalldata(args, () => {
         if (parseRequest) {
@@ -21710,8 +21712,20 @@ ${indent}}` : "}";
         entrypoint: method
       };
       if (isAccount(this.providerOrAccount)) {
+        if (restInvokeOptions.paymasterDetails) {
+          const myCall = {
+            contractAddress: this.address,
+            entrypoint: method,
+            calldata: args
+          };
+          return this.providerOrAccount.executePaymasterTransaction(
+            [myCall],
+            restInvokeOptions.paymasterDetails,
+            restInvokeOptions.maxFeeInGasToken
+          );
+        }
         const result = await this.providerOrAccount.execute(invocation, {
-          ...RestInvokeOptions
+          ...restInvokeOptions
         });
         if (waitForTransaction) {
           const result2 = await this.providerOrAccount.waitForTransaction(result.transaction_hash);
@@ -21722,7 +21736,7 @@ ${indent}}` : "}";
         }
         return result;
       }
-      if (!RestInvokeOptions.nonce)
+      if (!restInvokeOptions.nonce)
         throw new Error(`Manual nonce is required when invoking a function without an account`);
       logger.warn(`Invoking ${method} without an account.`);
       return this.providerOrAccount.invokeFunction(
@@ -21731,8 +21745,8 @@ ${indent}}` : "}";
           signature
         },
         {
-          ...RestInvokeOptions,
-          nonce: RestInvokeOptions.nonce
+          ...restInvokeOptions,
+          nonce: restInvokeOptions.nonce
         }
       );
     }
@@ -21743,6 +21757,17 @@ ${indent}}` : "}";
       }
       const invocation = this.populate(method, args);
       if (isAccount(this.providerOrAccount)) {
+        if (estimateDetails.paymasterDetails) {
+          const myCall = {
+            contractAddress: this.address,
+            entrypoint: method,
+            calldata: args
+          };
+          return this.providerOrAccount.estimatePaymasterTransactionFee(
+            [myCall],
+            estimateDetails.paymasterDetails
+          );
+        }
         return this.providerOrAccount.estimateInvokeFee(invocation, estimateDetails);
       }
       throw Error("Contract must be connected to the account contract to estimate");