starknet 8.5.2 → 8.5.4

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.5.4](https://github.com/starknet-io/starknet.js/compare/v8.5.3...v8.5.4) (2025-09-17)
+
+### Bug Fixes
+
+- fix waitfortransaction for rotating nodes services with lifeCycleRetries default 3 ([7296850](https://github.com/starknet-io/starknet.js/commit/72968500c9b0f4b889e9e388b3a98a0ea0de3b43))
+
+## [8.5.3](https://github.com/starknet-io/starknet.js/compare/v8.5.2...v8.5.3) (2025-09-05)
+
+### Bug Fixes
+
+- enforce fixed size for cairo bytes ([6a56166](https://github.com/starknet-io/starknet.js/commit/6a56166e65c79d68e012083cefff3fb532e150ac))
+
 ## [8.5.2](https://github.com/starknet-io/starknet.js/compare/v8.5.1...v8.5.2) (2025-08-27)
 
 ### Bug Fixes

package/README.md

@@ -82,6 +82,6 @@ This library would not be possible without these rockstars.
 
 ## 📜 License
 
-Copyright (c) 2024 StarkWare
+Copyright (c) 2025 StarkWare
 
 Licensed under the [MIT license](https://github.com/starknet-io/starknet.js/blob/main/LICENSE).

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as RPC from '@starknet-io/starknet-types-09';
-import { CONTRACT, ETransactionType, EDataAvailabilityMode as EDataAvailabilityMode$1, SUBSCRIPTION_BLOCK_ID, IsSucceeded, TransactionReceipt as TransactionReceipt$1, IsReverted, BLOCK_WITH_TX_HASHES, IsType, OutsideExecutionTypedData, TypedData, CONTRACT_STORAGE_KEYS, StorageProof, CASM_COMPILED_CONTRACT_CLASS, ETransactionVersion3 as ETransactionVersion3$1, BlockHash, TransactionHash, FAILED_TO_RECEIVE_TXN, NO_TRACE_AVAILABLE, CONTRACT_NOT_FOUND, ENTRYPOINT_NOT_FOUND, BLOCK_NOT_FOUND, INVALID_TXN_INDEX, CLASS_HASH_NOT_FOUND, TXN_HASH_NOT_FOUND, PAGE_SIZE_TOO_BIG, NO_BLOCKS, INVALID_CONTINUATION_TOKEN, TOO_MANY_KEYS_IN_FILTER, CONTRACT_ERROR, TRANSACTION_EXECUTION_ERROR, STORAGE_PROOF_NOT_SUPPORTED, CLASS_ALREADY_DECLARED, INVALID_TRANSACTION_NONCE, INSUFFICIENT_RESOURCES_FOR_VALIDATE, INSUFFICIENT_ACCOUNT_BALANCE, VALIDATION_FAILURE, COMPILATION_FAILED, CONTRACT_CLASS_SIZE_IS_TOO_LARGE, NON_ACCOUNT, DUPLICATE_TX, COMPILED_CLASS_HASH_MISMATCH, UNSUPPORTED_TX_VERSION, UNSUPPORTED_CONTRACT_CLASS_VERSION, UNEXPECTED_ERROR, INVALID_SUBSCRIPTION_ID, TOO_MANY_ADDRESSES_IN_FILTER, TOO_MANY_BLOCKS_BACK, COMPILATION_ERROR, ETransactionVersion as ETransactionVersion$1, SUBSCRIPTION_ID, TXN_FINALITY_STATUS, STATUS_ACCEPTED_ON_L1, TXN_STATUS_WITHOUT_L1, StarknetEventsEvent, TransactionsStatusEvent, NewTransactionReceiptsEvent, NewTransactionEvent, NewHeadsEvent, BLOCK_STATUS, BLOCK_HEADER, BLOCK_BODY_WITH_TX_HASHES, PRE_CONFIRMED_BLOCK_HEADER, BLOCK_BODY_WITH_TXS, BLOCK_BODY_WITH_RECEIPTS, BlockTransactionsTraces, TXN_STATUS_RESULT, StarknetWindowObject, AccountChangeEventHandler, NetworkChangeEventHandler, WatchAssetParameters, AddStarknetChainParameters, Signature as Signature$1, EDAMode as EDAMode$1, StarknetType, StarknetMerkleType, TypedDataRevision, OutsideCallV1, OutsideCallV2, EmittedEvent as EmittedEvent$1, Address, Permission, ChainId, AccountDeploymentData, AddInvokeTransactionParameters, AddInvokeTransactionResult, AddDeclareTransactionParameters, AddDeclareTransactionResult, SpecVersion } from '@starknet-io/starknet-types-09';
+import { CONTRACT, ETransactionType, EDataAvailabilityMode as EDataAvailabilityMode$1, SUBSCRIPTION_BLOCK_ID, IsSucceeded, TransactionReceipt as TransactionReceipt$1, IsReverted, BLOCK_WITH_TX_HASHES, IsType, OutsideExecutionTypedData, TypedData, CONTRACT_STORAGE_KEYS, StorageProof, CASM_COMPILED_CONTRACT_CLASS, ETransactionVersion3 as ETransactionVersion3$1, BlockHash, TransactionHash, FAILED_TO_RECEIVE_TXN, NO_TRACE_AVAILABLE, CONTRACT_NOT_FOUND, ENTRYPOINT_NOT_FOUND, BLOCK_NOT_FOUND, INVALID_TXN_INDEX, CLASS_HASH_NOT_FOUND, TXN_HASH_NOT_FOUND, PAGE_SIZE_TOO_BIG, NO_BLOCKS, INVALID_CONTINUATION_TOKEN, TOO_MANY_KEYS_IN_FILTER, CONTRACT_ERROR, TRANSACTION_EXECUTION_ERROR, STORAGE_PROOF_NOT_SUPPORTED, CLASS_ALREADY_DECLARED, INVALID_TRANSACTION_NONCE, INSUFFICIENT_RESOURCES_FOR_VALIDATE, INSUFFICIENT_ACCOUNT_BALANCE, VALIDATION_FAILURE, COMPILATION_FAILED, CONTRACT_CLASS_SIZE_IS_TOO_LARGE, NON_ACCOUNT, DUPLICATE_TX, COMPILED_CLASS_HASH_MISMATCH, UNSUPPORTED_TX_VERSION, UNSUPPORTED_CONTRACT_CLASS_VERSION, UNEXPECTED_ERROR, REPLACEMENT_TRANSACTION_UNDERPRICED, FEE_BELOW_MINIMUM, INVALID_SUBSCRIPTION_ID, TOO_MANY_ADDRESSES_IN_FILTER, TOO_MANY_BLOCKS_BACK, COMPILATION_ERROR, ETransactionVersion as ETransactionVersion$1, SUBSCRIPTION_ID, TXN_FINALITY_STATUS, STATUS_ACCEPTED_ON_L1, TXN_STATUS_WITHOUT_L1, StarknetEventsEvent, TransactionsStatusEvent, NewTransactionReceiptsEvent, NewTransactionEvent, NewHeadsEvent, BLOCK_STATUS, BLOCK_HEADER, BLOCK_BODY_WITH_TX_HASHES, PRE_CONFIRMED_BLOCK_HEADER, BLOCK_BODY_WITH_TXS, BLOCK_BODY_WITH_RECEIPTS, BlockTransactionsTraces, TXN_STATUS_RESULT, StarknetWindowObject, AccountChangeEventHandler, NetworkChangeEventHandler, WatchAssetParameters, AddStarknetChainParameters, Signature as Signature$1, EDAMode as EDAMode$1, StarknetType, StarknetMerkleType, TypedDataRevision, OutsideCallV1, OutsideCallV2, EmittedEvent as EmittedEvent$1, Address, Permission, ChainId, AccountDeploymentData, AddInvokeTransactionParameters, AddInvokeTransactionResult, AddDeclareTransactionParameters, AddDeclareTransactionResult, SpecVersion } from '@starknet-io/starknet-types-09';
 export { StarknetDomain, StarknetEnumType, StarknetMerkleType, StarknetType, TypedData, TypedDataRevision } from '@starknet-io/starknet-types-09';
 import * as RPCSPEC08 from '@starknet-io/starknet-types-08';
 import { PAYMASTER_API } from '@starknet-io/starknet-types-08';
@@ -829,8 +829,26 @@ type ParsedStruct = {
     [key: string]: BigNumberish | BigNumberish[] | ParsedStruct | Uint256;
 };
 type waitForTransactionOptions = {
+    /**
+     * Define the number of retries before throwing an error for the transaction life cycle when the transaction is not found after it had a valid status.
+     * This is useful for nodes that are not fully synced yet when connecting to service that rotate nodes.
+     */
+    lifeCycleRetries?: number;
+    /**
+     * Define the number of retries before throwing an error
+     */
+    retries?: number;
+    /**
+     * Define the time interval between retries in milliseconds
+     */
     retryInterval?: number;
+    /**
+     * Define which states are considered as successful
+     */
     successStates?: Array<TransactionFinalityStatus | TransactionExecutionStatus>;
+    /**
+     * Define which states are considered as errors
+     */
     errorStates?: Array<TransactionFinalityStatus | TransactionExecutionStatus>;
 };
 type fastWaitForTransactionOptions = {
@@ -865,8 +883,17 @@ interface ProviderOptions extends RpcProviderOptions {
 }
 type RpcProviderOptions = {
     nodeUrl?: string | _NetworkName;
-    retries?: number;
+    /**
+     * Define the number of retries for waitForTransaction
+     */
+    retries?: waitForTransactionOptions['retries'];
+    /**
+     * Define the time interval between retries in milliseconds
+     */
     transactionRetryIntervalFallback?: number;
+    /**
+     * Define the headers
+     */
     headers?: object;
     blockIdentifier?: BlockIdentifier;
     chainId?: _StarknetChainId;
@@ -3309,6 +3336,8 @@ type RPC_ERROR_SET = {
     UNSUPPORTED_TX_VERSION: UNSUPPORTED_TX_VERSION;
     UNSUPPORTED_CONTRACT_CLASS_VERSION: UNSUPPORTED_CONTRACT_CLASS_VERSION;
     UNEXPECTED_ERROR: UNEXPECTED_ERROR;
+    REPLACEMENT_TRANSACTION_UNDERPRICED: REPLACEMENT_TRANSACTION_UNDERPRICED;
+    FEE_BELOW_MINIMUM: FEE_BELOW_MINIMUM;
     INVALID_SUBSCRIPTION_ID: INVALID_SUBSCRIPTION_ID;
     TOO_MANY_ADDRESSES_IN_FILTER: TOO_MANY_ADDRESSES_IN_FILTER;
     TOO_MANY_BLOCKS_BACK: TOO_MANY_BLOCKS_BACK;
@@ -3965,7 +3994,7 @@ declare class RpcChannel$1 {
     getChainId(): Promise<"0x534e5f4d41494e" | "0x534e5f5345504f4c4941">;
     /**
      * fetch rpc node specVersion
-     * @example this.specVersion = "0.7.1"
+     * @example this.specVersion = "0.8.1"
      */
     getSpecVersion(): Promise<string>;
     /**
@@ -4108,12 +4137,12 @@ declare class RpcChannel {
     getChainId(): Promise<"0x534e5f4d41494e" | "0x534e5f5345504f4c4941">;
     /**
      * fetch rpc node specVersion
-     * @example this.specVersion = "0.7.1"
+     * @example this.specVersion = "0.9.0"
      */
     getSpecVersion(): Promise<string>;
     /**
      * fetch if undefined else just return this.specVersion
-     * @example this.specVersion = "0.8.1"
+     * @example this.specVersion = "0.9.0"
      */
     setUpSpecVersion(): Promise<"0.8.1" | "0.9.0">;
     /**
@@ -4620,7 +4649,7 @@ declare class RpcError<BaseErrorT extends RPC_ERROR = RPC_ERROR> extends Library
         params: any;
     };
     constructor(baseError: BaseErrorT, method: string, params: any);
-    get code(): 1 | 66 | 10 | 31 | 20 | 21 | 24 | 27 | 28 | 29 | 32 | 33 | 34 | 40 | 41 | 42 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 67 | 68 | 100 | 150 | 151 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 163;
+    get code(): 1 | 64 | 66 | 10 | 31 | 20 | 21 | 24 | 27 | 28 | 29 | 32 | 33 | 34 | 40 | 41 | 42 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 65 | 67 | 68 | 100 | 150 | 151 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 163;
     /**
      * Verifies the underlying RPC error, also serves as a type guard for the _baseError_ property
      * @example
@@ -7625,7 +7654,7 @@ declare function extractAbi(contract: ContractClass): Abi;
  * ```typescript
  * const result= provider.getDefaultNodeUrl(constants.NetworkName.SN_MAIN,false);
  * // console : "Using default public node url, please provide nodeUrl in provider options!"
- * // result = "https://starknet-mainnet.public.blastapi.io/rpc/v0_7"
+ * // result = "https://starknet-mainnet.public.blastapi.io/rpc/v0_9"
  * ```
  */
 declare const getDefaultNodeUrl: (networkName?: _NetworkName, mute?: boolean, rpcVersion?: _SupportedRpcVersion) => string;
@@ -7958,7 +7987,7 @@ declare function isV3Tx(details: InvocationsDetailsWithNonce): details is V3Tran
  * @returns {boolean} True if the response matches the version, false otherwise.
  * @example
  * ``` typescript
- * const result = provider.isVersion("0.7","0.7.1");
+ * const result = provider.isVersion("0.9","0.9.0");
  * // result = true
  * ```
  */
@@ -8513,7 +8542,10 @@ declare class CairoBytes31 {
     toApiRequest(): string[];
     toBigInt(): bigint;
     decodeUtf8(): string;
-    toHexString(): string;
+    /**
+     * @param padded flag for including leading zeros
+     */
+    toHexString(padded?: 'padded'): string;
     static validate(data: Uint8Array | string | Buffer | unknown): void;
     static is(data: Uint8Array | string | Buffer): boolean;
     /**
@@ -8600,6 +8632,15 @@ declare class CairoByteArray {
     toBigInt(): bigint;
     toHexString(): string;
     toBuffer(): any;
+    /**
+     * returns an array of all the data chunks and the pending word
+     * when concatenated, represents the original bytes sequence
+     */
+    toElements(): Uint8Array[];
+    /**
+     * Private helper to check if the CairoByteArray is properly initialized
+     */
+    private assertInitialized;
     static validate(data: Uint8Array | Buffer | BigNumberish | unknown): void;
     /**
      * Check if the provided data is a valid CairoByteArray
@@ -8612,14 +8653,6 @@ declare class CairoByteArray {
      * Check if provided abi type is this data type
      */
     static isAbiType(abiType: string): boolean;
-    /**
-     * Private helper to check if the CairoByteArray is properly initialized
-     */
-    private assertInitialized;
-    /**
-     * Private helper to reconstruct the full byte sequence from chunks and pending word
-     */
-    private reconstructBytes;
     static factoryFromApiResponse(responseIterator: Iterator<string>): CairoByteArray;
 }