starknet 8.6.0 → 8.8.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [8.8.0](https://github.com/starknet-io/starknet.js/compare/v8.7.0...v8.8.0) (2025-11-12)
+
+### Bug Fixes
+
+- both sepolia and mainet on alchemy ([f119081](https://github.com/starknet-io/starknet.js/commit/f1190815ba032a0b4094e6c16c3b6cd4cca216e1))
+- public node hotfix ([d35e39e](https://github.com/starknet-io/starknet.js/commit/d35e39eb600a30b46146630ec0bbc916db65d976))
+
+### Features
+
+- starknet version, use starknt version to determin declare hash instead of spec version ([70a23ee](https://github.com/starknet-io/starknet.js/commit/70a23ee4f14d5f7a0d754bfcfc3312cd5585b951))
+
+# [8.7.0](https://github.com/starknet-io/starknet.js/compare/v8.6.0...v8.7.0) (2025-11-07)
+
+### Bug Fixes
+
+- public node hotfix ([#1510](https://github.com/starknet-io/starknet.js/issues/1510)) ([4165a3c](https://github.com/starknet-io/starknet.js/commit/4165a3c74c94053b60ed2aca12d8bebab5b72f68))
+
+### Features
+
+- configurable websocket exponential backoff ([#1503](https://github.com/starknet-io/starknet.js/issues/1503)) ([6d0593f](https://github.com/starknet-io/starknet.js/commit/6d0593f2fcdf6da79fb0aaccef42071a8c0e8126))
+
 # [8.6.0](https://github.com/starknet-io/starknet.js/compare/v8.5.5...v8.6.0) (2025-10-17)
 
 ### Features

package/dist/index.d.ts

@@ -3917,8 +3917,8 @@ declare const DEFAULT_GLOBAL_CONFIG: {
     blake: ((uint8Array: Uint8Array) => Uint8Array) | undefined;
 };
 declare const RPC_DEFAULT_NODES: {
-    readonly SN_MAIN: readonly ["https://starknet-mainnet.public.blastapi.io/rpc/"];
-    readonly SN_SEPOLIA: readonly ["https://starknet-sepolia.public.blastapi.io/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: {
     readonly SN_MAIN: readonly ["https://starknet.paymaster.avnu.fi"];
@@ -4022,6 +4022,11 @@ declare class RpcChannel$1 {
     blockIdentifier?: BlockIdentifier): Promise<RPCSPEC08.StorageProof>;
     getCompiledCasm(classHash: BigNumberish): Promise<RPCSPEC08.CASM_COMPILED_CONTRACT_CLASS>;
     getNonceForAddress(contractAddress: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<string>;
+    /**
+     * Helper method to get the starknet version from the block, default latest block
+     * @returns Starknet version
+     */
+    getStarknetVersion(blockIdentifier?: BlockIdentifier): Promise<string>;
     /**
      * Get the most recent accepted block hash and number
      */
@@ -4165,6 +4170,11 @@ declare class RpcChannel {
     blockIdentifier?: BlockIdentifier): Promise<RPC.StorageProof>;
     getCompiledCasm(classHash: BigNumberish): Promise<RPC.CASM_COMPILED_CONTRACT_CLASS>;
     getNonceForAddress(contractAddress: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<string>;
+    /**
+     * Helper method to get the starknet version from the block, default latest block
+     * @returns Starknet version
+     */
+    getStarknetVersion(blockIdentifier?: BlockIdentifier): Promise<string>;
     /**
      * Get the most recent accepted block hash and number
      */
@@ -4406,10 +4416,14 @@ type ReconnectOptions = {
     retries?: number;
     /**
      * The initial delay in milliseconds before the first retry.
-     * This delay will be doubled for each subsequent retry (exponential backoff).
      * @default 2000
      */
     delay?: number;
+    /**
+     * Whether to use the exponential backoff (delay being doubled for each subsequent retry).
+     * @default true
+     */
+    exponential?: number | boolean;
 };
 /**
  * The type of the WebSocket implementation.
@@ -4704,6 +4718,7 @@ declare class RpcProvider$1 implements ProviderInterface {
     readSpecVersion(): "0.8.1" | "0.9.0" | undefined;
     getSpecVersion(): Promise<string>;
     setUpSpecVersion(): Promise<"0.8.1" | "0.9.0">;
+    getStarknetVersion(blockIdentifier?: BlockIdentifier): Promise<string>;
     getNonceForAddress(contractAddress: BigNumberish, blockIdentifier?: BlockIdentifier): Promise<string>;
     getBlock(): Promise<PendingBlock>;
     getBlock(blockIdentifier: 'pre_confirmed'): Promise<PendingBlock>;
@@ -5979,7 +5994,7 @@ declare function computeCompiledClassHash(casm: CompiledSierraCasm,
 /**
  * Used to determine which hashing algorithm to use
  */
-specVersion?: _SupportedRpcVersion): string;
+starknetVersion?: string): string;
 
 /**
  * Hashes Exports
@@ -9281,7 +9296,7 @@ declare function isSierra(contract: CairoContract | string): contract is SierraC
  * // }
  * ```
  */
-declare function extractContractHashes(payload: DeclareContractPayload, specVersion?: _SupportedRpcVersion): CompleteDeclareContractPayload;
+declare function extractContractHashes(payload: DeclareContractPayload, starknetVersion?: string): CompleteDeclareContractPayload;
 /**
  * Helper to redeclare response Cairo0 contract
  */

package/dist/index.global.js

@@ -1179,8 +1179,8 @@ var starknet = (() => {
     blake: void 0
   };
   var RPC_DEFAULT_NODES = {
-    SN_MAIN: [`https://starknet-mainnet.public.blastapi.io/rpc/`],
-    SN_SEPOLIA: [`https://starknet-sepolia.public.blastapi.io/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 = {
     SN_MAIN: [`https://starknet.paymaster.avnu.fi`],
@@ -9938,8 +9938,8 @@ ${indent}}` : "}";
     }
     return computeLegacyContractClassHash(compiledContract);
   }
-  function computeCompiledClassHash(casm, specVersion) {
-    if (specVersion && compareVersions(specVersion, "0.10.0") >= 0) {
+  function computeCompiledClassHash(casm, starknetVersion) {
+    if (starknetVersion && compareVersions(starknetVersion, "0.14.1") >= 0) {
       return computeCompiledClassHashBlake(casm);
     }
     return computeCompiledClassHashPoseidon(casm);
@@ -14324,11 +14324,11 @@ ${indent}}` : "}";
     const compiledContract = isString(contract) ? parse2(contract) : contract;
     return "sierra_program" in compiledContract;
   }
-  function extractContractHashes(payload, specVersion) {
+  function extractContractHashes(payload, starknetVersion) {
     const response = { ...payload };
     if (isSierra(payload.contract)) {
       if (!payload.compiledClassHash && payload.casm) {
-        response.compiledClassHash = computeCompiledClassHash(payload.casm, specVersion);
+        response.compiledClassHash = computeCompiledClassHash(payload.casm, starknetVersion);
       }
       if (!response.compiledClassHash)
         throw new Error(
@@ -14757,6 +14757,12 @@ ${indent}}` : "}";
     const nodes = { ...RPC_DEFAULT_NODES };
     Object.keys(nodes).forEach(function(key, _) {
       nodes[key] = nodes[key].map((it) => {
+        if (it === "https://starknet-sepolia.g.alchemy.com/starknet/version/rpc/") {
+          return `${it}${toApiVersion(rpcVersion)}/uYLxCteYbHTFJpKSoKdVm`;
+        }
+        if (it === "https://starknet-mainnet.g.alchemy.com/starknet/version/rpc/") {
+          return `${it}${toApiVersion(rpcVersion)}/uYLxCteYbHTFJpKSoKdVm`;
+        }
         return `${it}${toApiVersion(rpcVersion)}`;
       });
     });
@@ -15127,6 +15133,14 @@ ${indent}}` : "}";
         block_id
       });
     }
+    /**
+     * Helper method to get the starknet version from the block, default latest block
+     * @returns Starknet version
+     */
+    async getStarknetVersion(blockIdentifier = this.blockIdentifier) {
+      const block = await this.getBlockWithTxHashes(blockIdentifier);
+      return block.starknet_version;
+    }
     /**
      * Get the most recent accepted block hash and number
      */
@@ -15716,6 +15730,14 @@ ${indent}}` : "}";
         block_id
       });
     }
+    /**
+     * Helper method to get the starknet version from the block, default latest block
+     * @returns Starknet version
+     */
+    async getStarknetVersion(blockIdentifier = this.blockIdentifier) {
+      const block = await this.getBlockWithTxHashes(blockIdentifier);
+      return block.starknet_version;
+    }
     /**
      * Get the most recent accepted block hash and number
      */
@@ -16283,7 +16305,8 @@ ${indent}}` : "}";
       this.autoReconnect = options.autoReconnect ?? true;
       this.reconnectOptions = {
         retries: options.reconnectOptions?.retries ?? 5,
-        delay: options.reconnectOptions?.delay ?? 2e3
+        delay: options.reconnectOptions?.delay ?? 2e3,
+        exponential: options.reconnectOptions?.exponential ?? true
       };
       this.requestTimeout = options.requestTimeout ?? 6e4;
       this.WsImplementation = options.websocket || config.get("websocket") || ws_default;
@@ -16544,7 +16567,7 @@ ${indent}}` : "}";
           this.events.emit("open", new Event("open"));
         };
         this.websocket.onerror = () => {
-          const delay = this.reconnectOptions.delay * 2 ** (this.reconnectAttempts - 1);
+          const delay = this.reconnectOptions.exponential ? this.reconnectOptions.delay * 2 ** (this.reconnectAttempts - 1) : this.reconnectOptions.delay;
           logger.info(`WebSocket: Reconnect attempt failed. Retrying in ${delay}ms.`);
           this.reconnectTimeoutId = setTimeout(tryReconnect, delay);
         };
@@ -17654,6 +17677,9 @@ ${indent}}` : "}";
     setUpSpecVersion() {
       return this.channel.setUpSpecVersion();
     }
+    async getStarknetVersion(blockIdentifier) {
+      return this.channel.getStarknetVersion(blockIdentifier);
+    }
     async getNonceForAddress(contractAddress, blockIdentifier) {
       return this.channel.getNonceForAddress(contractAddress, blockIdentifier);
     }
@@ -17893,7 +17919,7 @@ ${indent}}` : "}";
       if (!contractClassIdentifier.classHash && "contract" in contractClassIdentifier) {
         const hashes = extractContractHashes(
           contractClassIdentifier,
-          await this.channel.setUpSpecVersion()
+          await this.channel.getStarknetVersion()
         );
         classHash = hashes.classHash;
       } else if (contractClassIdentifier.classHash) {
@@ -20484,7 +20510,7 @@ ${indent}}` : "}";
       const invocations = [
         {
           type: ETransactionType2.DECLARE,
-          payload: extractContractHashes(payload, await this.channel.setUpSpecVersion())
+          payload: extractContractHashes(payload, await this.channel.getStarknetVersion())
         }
       ];
       const estimateBulk = await this.estimateFeeBulk(invocations, details);
@@ -20650,7 +20676,7 @@ ${indent}}` : "}";
     async declareIfNot(payload, transactionsDetail = {}) {
       const declareContractPayload = extractContractHashes(
         payload,
-        await this.channel.setUpSpecVersion()
+        await this.channel.getStarknetVersion()
       );
       try {
         await this.getClassByHash(declareContractPayload.classHash);
@@ -20666,7 +20692,7 @@ ${indent}}` : "}";
       assert(isSierra(payload.contract), SYSTEM_MESSAGES.declareNonSierra);
       const declareContractPayload = extractContractHashes(
         payload,
-        await this.channel.setUpSpecVersion()
+        await this.channel.getStarknetVersion()
       );
       const detailsWithTip = await this.resolveDetailsWithTip(details);
       const { resourceBounds: providedResourceBounds } = details;
@@ -20976,7 +21002,7 @@ ${indent}}` : "}";
     async buildDeclarePayload(payload, details) {
       const { classHash, contract, compiledClassHash } = extractContractHashes(
         payload,
-        await this.channel.setUpSpecVersion()
+        await this.channel.getStarknetVersion()
       );
       const compressedCompiledContract = parseContract(contract);
       assert(
@@ -21326,7 +21352,7 @@ ${indent}}` : "}";
     async declare(payload) {
       const declareContractPayload = extractContractHashes(
         payload,
-        await this.channel.setUpSpecVersion()
+        await this.channel.getStarknetVersion()
       );
       const pContract = payload.contract;
       const cairo1Contract = {