starknet 8.8.0 → 8.9.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# [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: {
@@ -5355,7 +5357,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 +5485,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

@@ -1179,7 +1179,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 = {
@@ -21694,7 +21694,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 +21710,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 +21734,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 +21743,8 @@ ${indent}}` : "}";
           signature
         },
         {
-          ...RestInvokeOptions,
-          nonce: RestInvokeOptions.nonce
+          ...restInvokeOptions,
+          nonce: restInvokeOptions.nonce
         }
       );
     }
@@ -21743,6 +21755,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");