starknet 10.7.0 → 10.7.2

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [10.7.2](https://github.com/starknet-io/starknet.js/compare/v10.7.1...v10.7.2) (2026-09-08)
+
+### Bug Fixes
+
+- **paymaster:** accept a raw shortstring for the paymaster typed-data domain chainId ([4abd5ae](https://github.com/starknet-io/starknet.js/commit/4abd5aeec079e8ca14ce098d0ff8790a89aa1c62))
+- **paymaster:** bind paymaster typed-data domain to the account's provider chain ([f194c61](https://github.com/starknet-io/starknet.js/commit/f194c612cd2fa2ecb6515e484f89d6f2bb72892a))
+- **paymaster:** reject paymaster typed data declaring both "calls" and "Calls" ([e618f70](https://github.com/starknet-io/starknet.js/commit/e618f706fe543aa5dbce5b560098ad15d4ca341b))
+- **paymaster:** validate selector and calldata shape of the appended gas-token call ([4b72d35](https://github.com/starknet-io/starknet.js/commit/4b72d35cfe19424fb707dbfdfd4e3877532f86b5))
+- **paymaster:** validate the full u256 gas-token amount unconditionally ([3d1a1ec](https://github.com/starknet-io/starknet.js/commit/3d1a1ec420a769f31bb7fc94b2a68f36ae56630e))
+- **paymaster:** verify calls equality for sponsored paymaster transactions too ([c403643](https://github.com/starknet-io/starknet.js/commit/c403643b580ab5953a2e737d1aa39e083d5f0262))
+
+## [10.7.1](https://github.com/starknet-io/starknet.js/compare/v10.7.0...v10.7.1) (2026-08-21)
+
+### Bug Fixes
+
+- **provider:** accept pre-release RPC spec versions ([436f433](https://github.com/starknet-io/starknet.js/commit/436f433e57039f3ae12c651c937d6b7e21592de1))
+
 # [10.7.0](https://github.com/starknet-io/starknet.js/compare/v10.6.8...v10.7.0) (2026-08-13)
 
 ### Features

package/dist/index.d.ts

@@ -8936,10 +8936,38 @@ declare const getDefaultPaymasterNodeUrl: (networkName?: _NetworkName, mute?: bo
  * Asserts that the given calls are strictly equal, otherwise throws an error.
  * @param {Call[]} originalCalls - The original calls.
  * @param {Call[]} unsafeCalls - The unsafe calls.
+ * @param {boolean} [isSponsored] - Whether the transaction is sponsored. A sponsored
+ * transaction appends no gas-token fee-transfer call; a non-sponsored one appends exactly
+ * one. Defaults to `false` for backward compatibility.
  * @throws {Error} Throws an error if the calls are not strictly equal.
+ * @example
+ * ```typescript
+ * paymaster.assertCallsAreStrictlyEqual(originalCalls, unsafeCalls, true); // sponsored: no fee call
+ * ```
+ */
+declare function assertCallsAreStrictlyEqual(originalCalls: Call[], unsafeCalls: (OutsideCallV1 | OutsideCallV2)[], isSponsored?: boolean): void;
+/**
+ * Asserts that a paymaster-prepared transaction is safe to sign: the typed-data domain is
+ * bound to the account's own chain, and — for non-sponsored transactions — the calls and the
+ * appended gas-token transfer match what the user actually requested.
+ * @param {PreparedTransaction} preparedTransaction - The transaction returned by the paymaster.
+ * @param {Call[]} calls - The calls originally requested by the user.
+ * @param {PaymasterDetails} paymasterDetails - The fee mode and related paymaster details.
+ * @param {StarknetChainId} chainId - The chain id of the account's own provider.
+ * @param {BigNumberish} [maxFeeInGasToken] - Optional user-approved ceiling on the gas-token fee.
+ * @throws {Error} Throws an error if any of the above safety properties do not hold.
+ * @example
+ * ```typescript
+ * assertPaymasterTransactionSafety(
+ *   preparedTransaction,
+ *   calls,
+ *   { feeMode: { mode: 'default', gasToken: strkAddress } },
+ *   constants.StarknetChainId.SN_SEPOLIA
+ * );
+ * // does not throw if preparedTransaction is exactly what was requested
+ * ```
  */
-declare function assertCallsAreStrictlyEqual(originalCalls: Call[], unsafeCalls: (OutsideCallV1 | OutsideCallV2)[]): void;
-declare const assertPaymasterTransactionSafety: (preparedTransaction: PreparedTransaction, calls: Call[], paymasterDetails: PaymasterDetails, maxFeeInGasToken?: BigNumberish) => void;
+declare const assertPaymasterTransactionSafety: (preparedTransaction: PreparedTransaction, calls: Call[], paymasterDetails: PaymasterDetails, chainId: _StarknetChainId, maxFeeInGasToken?: BigNumberish) => void;
 
 declare const paymaster_assertCallsAreStrictlyEqual: typeof assertCallsAreStrictlyEqual;
 declare const paymaster_assertPaymasterTransactionSafety: typeof assertPaymasterTransactionSafety;
@@ -9421,6 +9449,22 @@ declare function isSupportedSpecVersion(version: string, options?: {
  * ex. 0.8.1 -> 0.8.*
  */
 declare function toAnyPatchVersion(version: string): string;
+/**
+ * Strip the semver pre-release and build metadata suffixes from a version.
+ * A node can report a pre-release of a spec version (ex. Pathfinder reporting '0.10.3-rc.0');
+ * the SDK handles it as the release it is a candidate for.
+ * Input that is not a semver version is returned unchanged.
+ * ex. '0.10.3-rc.0' -> '0.10.3', '0.10.3+build.1' -> '0.10.3', '0.10.2' -> '0.10.2'
+ *
+ * @param {string} version
+ * @returns {string} the version without its pre-release and build metadata suffixes
+ * @example
+ * ```typescript
+ * const result = toReleaseVersion('0.10.3-rc.0');
+ * // result = '0.10.3'
+ * ```
+ */
+declare function toReleaseVersion(version: string): string;
 /**
  * Convert version to API format.
  * ex. '0.8.1' -> 'v0_8', '0.8' -> 'v0_8'
@@ -9432,6 +9476,8 @@ declare function toApiVersion(version: string): string;
  * Compare two semantic version strings segment by segment.
  * This function safely compares versions without collision risk between
  * versions like '0.0.1000' and '0.1.0'.
+ * Pre-release and build metadata suffixes are ignored, so a version is compared as
+ * the release it is a candidate for: '0.14.1-rc.0' compares equal to '0.14.1'.
  *
  * @param {string} a First version string (e.g., '0.0.9')
  * @param {string} b Second version string (e.g., '0.0.10')
@@ -10843,4 +10889,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_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 };
+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, toReleaseVersion, 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

@@ -207,6 +207,7 @@ var starknet = (() => {
     starknetIdPlugin: () => starknetId,
     toAnyPatchVersion: () => toAnyPatchVersion,
     toApiVersion: () => toApiVersion,
+    toReleaseVersion: () => toReleaseVersion,
     transaction: () => transaction_exports,
     typedData: () => typedData_exports,
     uint256: () => uint256_exports,
@@ -10134,13 +10135,16 @@ ${indent}}` : "}";
     }
     return `${parts[0]}.${parts[1]}.*`;
   }
+  function toReleaseVersion(version) {
+    return version.split(/[-+]/)[0];
+  }
   function toApiVersion(version) {
     const [major, minor] = version.replace(/^v/, "").split(".");
     return `v${major}_${minor}`;
   }
   function compareVersions(a, b) {
-    const aParts = a.split(".").map(Number);
-    const bParts = b.split(".").map(Number);
+    const aParts = toReleaseVersion(a).split(".").map(Number);
+    const bParts = toReleaseVersion(b).split(".").map(Number);
     const maxLen = Math.max(aParts.length, bParts.length);
     for (let i = 0; i < maxLen; i += 1) {
       const aNum = aParts[i] || 0;
@@ -11230,7 +11234,7 @@ ${indent}}` : "}";
       this.chainId = chainId;
       this.headers = { ...channelDefaults.options.headers, ...headers };
       this.retries = retries ?? channelDefaults.options.retries;
-      this.specVersion = specVersion;
+      this.specVersion = specVersion ? toReleaseVersion(specVersion) : void 0;
       this.transactionRetryIntervalFallback = transactionRetryIntervalFallback ?? channelDefaults.options.transactionRetryIntervalFallback;
       this.waitMode = waitMode ?? false;
       this.requestId = 0;
@@ -11318,18 +11322,19 @@ ${indent}}` : "}";
      */
     async setUpSpecVersion() {
       if (!this.specVersion) {
-        const unknownSpecVersion = await this.fetchEndpoint("starknet_specVersion");
-        if (!isVersion(this.channelSpecVersion, unknownSpecVersion)) {
+        const nodeSpecVersion = await this.fetchEndpoint("starknet_specVersion");
+        const specVersion = toReleaseVersion(nodeSpecVersion);
+        if (!isVersion(this.channelSpecVersion, specVersion)) {
           logger.error(SYSTEM_MESSAGES.channelVersionMismatch, {
             channelId: this.id,
             channelSpecVersion: this.channelSpecVersion,
-            nodeSpecVersion: this.specVersion
+            nodeSpecVersion
           });
         }
-        if (!isSupportedSpecVersion(unknownSpecVersion)) {
+        if (!isSupportedSpecVersion(specVersion)) {
           throw new LibraryError(`${SYSTEM_MESSAGES.unsupportedSpecVersion}, channelId: ${this.id}`);
         }
-        this.specVersion = unknownSpecVersion;
+        this.specVersion = specVersion;
       }
       return this.specVersion;
     }
@@ -11875,7 +11880,7 @@ ${indent}}` : "}";
       this.chainId = chainId;
       this.headers = { ...channelDefaults.options.headers, ...headers };
       this.retries = retries ?? channelDefaults.options.retries;
-      this.specVersion = specVersion;
+      this.specVersion = specVersion ? toReleaseVersion(specVersion) : void 0;
       this.transactionRetryIntervalFallback = transactionRetryIntervalFallback ?? channelDefaults.options.transactionRetryIntervalFallback;
       this.waitMode = waitMode ?? false;
       this.requestId = 0;
@@ -11963,18 +11968,19 @@ ${indent}}` : "}";
      */
     async setUpSpecVersion() {
       if (!this.specVersion) {
-        const unknownSpecVersion = await this.fetchEndpoint("starknet_specVersion");
-        if (!isVersion("0.10", unknownSpecVersion)) {
+        const nodeSpecVersion = await this.fetchEndpoint("starknet_specVersion");
+        const specVersion = toReleaseVersion(nodeSpecVersion);
+        if (!isVersion("0.10", specVersion)) {
           logger.error(SYSTEM_MESSAGES.channelVersionMismatch, {
             channelId: this.id,
             channelSpecVersion: this.channelSpecVersion,
-            nodeSpecVersion: this.specVersion
+            nodeSpecVersion
           });
         }
-        if (!isSupportedSpecVersion(unknownSpecVersion)) {
+        if (!isSupportedSpecVersion(specVersion)) {
           throw new LibraryError(`${SYSTEM_MESSAGES.unsupportedSpecVersion}, channelId: ${this.id}`);
         }
-        this.specVersion = unknownSpecVersion;
+        this.specVersion = specVersion;
       }
       return this.specVersion;
     }
@@ -14928,16 +14934,17 @@ ${indent}}` : "}";
     static async create(optionsOrProvider) {
       const channel = new rpc_0_9_0_exports.RpcChannel({ ...optionsOrProvider });
       const spec = await channel.getSpecVersion();
-      if (!isSupportedSpecVersion(spec)) {
+      const specVersion = toReleaseVersion(spec);
+      if (!isSupportedSpecVersion(specVersion)) {
         logger.warn(`Using incompatible node spec version ${spec}`);
       }
-      if (isVersion("0.9", spec)) {
+      if (isVersion("0.9", specVersion)) {
         return new this({
           ...optionsOrProvider,
           specVersion: _SupportedRpcVersion.v0_9_0
         });
       }
-      if (isVersion("0.10", spec)) {
+      if (isVersion("0.10", specVersion)) {
         return new this({
           ...optionsOrProvider,
           specVersion: _SupportedRpcVersion.v0_10_3
@@ -16546,9 +16553,12 @@ ${indent}}` : "}";
   var assertGasFeeFromUnsafeCalls = (unsafeCalls, fees) => {
     const unsafeCall = toOutsideCallV2(unsafeCalls[unsafeCalls.length - 1]);
     const unsafeGasTokenCalldata = CallData.toCalldata(unsafeCall.Calldata);
-    const unsafeGasTokenValue = unsafeGasTokenCalldata[1];
+    const unsafeGasTokenValue = uint256ToBN({
+      low: unsafeGasTokenCalldata[1],
+      high: unsafeGasTokenCalldata[2]
+    });
     assert(
-      BigInt(unsafeGasTokenValue) === BigInt(fees),
+      unsafeGasTokenValue === BigInt(fees),
       "Gas token value is not equal to the provided gas fees"
     );
   };
@@ -16558,12 +16568,21 @@ ${indent}}` : "}";
       BigInt(unsafeCall.To) === BigInt(gasToken),
       "Gas token address is not equal to the provided gas token"
     );
+    assert(
+      unsafeCall.Selector === getSelectorFromName("transfer"),
+      "Gas token call selector is not a transfer"
+    );
+    assert(
+      CallData.toCalldata(unsafeCall.Calldata).length === 3,
+      "Gas token transfer calldata does not match the expected recipient/amount shape"
+    );
   };
-  function assertCallsAreStrictlyEqual(originalCalls, unsafeCalls) {
+  function assertCallsAreStrictlyEqual(originalCalls, unsafeCalls, isSponsored = false) {
     const baseError = "Provided calls are not strictly equal to the returned calls";
+    const expectedExtraCalls = isSponsored ? 0 : 1;
     assert(
-      unsafeCalls.length - 1 === originalCalls.length,
-      `${baseError}: Expected ${originalCalls.length + 1} calls, got ${unsafeCalls.length}`
+      unsafeCalls.length - expectedExtraCalls === originalCalls.length,
+      `${baseError}: Expected ${originalCalls.length + expectedExtraCalls} calls, got ${unsafeCalls.length}`
     );
     for (let callIndex = 0; callIndex < originalCalls.length; callIndex += 1) {
       const originalCall = originalCalls[callIndex];
@@ -16597,21 +16616,42 @@ ${indent}}` : "}";
       }
     }
   }
-  var assertPaymasterTransactionSafety = (preparedTransaction, calls, paymasterDetails, maxFeeInGasToken) => {
-    if (paymasterDetails.feeMode.mode !== "sponsored") {
-      if (preparedTransaction.type === "invoke" || preparedTransaction.type === "deploy_and_invoke") {
-        const unsafeCalls = "calls" in preparedTransaction.typed_data.message ? preparedTransaction.typed_data.message.calls : preparedTransaction.typed_data.message.Calls;
-        assertCallsAreStrictlyEqual(calls, unsafeCalls);
+  var domainFieldToFelt = (value) => {
+    try {
+      return toBigInt(value);
+    } catch {
+      return toBigInt(encodeShortString(String(value)));
+    }
+  };
+  var assertChainIdFromTypedData = (typedData, chainId) => {
+    assert(
+      typedData.domain.chainId !== void 0 && domainFieldToFelt(typedData.domain.chainId) === BigInt(chainId),
+      "Paymaster typed data domain chainId does not match the account's provider chain"
+    );
+  };
+  var assertPaymasterTransactionSafety = (preparedTransaction, calls, paymasterDetails, chainId, maxFeeInGasToken) => {
+    if (preparedTransaction.type === "invoke" || preparedTransaction.type === "deploy_and_invoke") {
+      assertChainIdFromTypedData(preparedTransaction.typed_data, chainId);
+      const { message } = preparedTransaction.typed_data;
+      const hasV1Calls = "calls" in message;
+      const hasV2Calls = "Calls" in message;
+      assert(
+        hasV1Calls !== hasV2Calls,
+        'Paymaster typed data must declare exactly one of "calls" (SNIP-9 V1) or "Calls" (SNIP-9 V2)'
+      );
+      const unsafeCalls = hasV1Calls ? message.calls : message.Calls;
+      assertCallsAreStrictlyEqual(calls, unsafeCalls, paymasterDetails.feeMode.mode === "sponsored");
+      if (paymasterDetails.feeMode.mode !== "sponsored") {
         assertGasTokenFromUnsafeCalls(unsafeCalls, paymasterDetails.feeMode.gasToken);
+        assertGasFeeFromUnsafeCalls(
+          unsafeCalls,
+          preparedTransaction.fee.suggested_max_fee_in_gas_token
+        );
         if (maxFeeInGasToken) {
           assert(
             preparedTransaction.fee.suggested_max_fee_in_gas_token <= maxFeeInGasToken,
             "Gas token price is too high"
           );
-          assertGasFeeFromUnsafeCalls(
-            unsafeCalls,
-            preparedTransaction.fee.suggested_max_fee_in_gas_token
-          );
         }
       }
     }
@@ -17736,6 +17776,7 @@ ${indent}}` : "}";
         preparedTransaction,
         calls,
         paymasterDetails,
+        await this.provider.getChainId(),
         maxFeeInGasToken
       );
       const transaction = await this.preparePaymasterTransaction(preparedTransaction);