Merge pull request #1513 from starknet-io/develop

release

Author: tabaktoni

CHANGELOG.md

@@ -1,3 +1,13 @@
+# [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

__tests__/defaultNodes.test.ts

@@ -3,7 +3,7 @@ import { SupportedRpcVersion } from '../src/global/constants';
 import { getDefaultNodes, getSupportedRpcVersions } from '../src/utils/provider';
 
 describe('unit tests', () => {
-  describe('getDefaultNodes', () => {
+  xdescribe('getDefaultNodes', () => {
     it('constructs correct URLs for all supported RPC versions', () => {
       const supportedVersions = getSupportedRpcVersions();
       supportedVersions.forEach((version) => {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "starknet",
-  "version": "8.6.0",
+  "version": "8.7.0",
   "description": "JavaScript library for Starknet",
   "license": "MIT",
   "repository": {

package.json

@@ -72,10 +72,14 @@ export 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;
 };
 
 /**
@@ -218,6 +222,7 @@ export class WebSocketChannel {
     this.reconnectOptions = {
       retries: options.reconnectOptions?.retries ?? 5,
       delay: options.reconnectOptions?.delay ?? 2000,
+      exponential: options.reconnectOptions?.exponential ?? true,
     };
     this.requestTimeout = options.requestTimeout ?? 60000;
 
@@ -527,7 +532,9 @@ export class WebSocketChannel {
       };
 
       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);
       };

src/channel/ws/ws_0_9.ts

@@ -158,8 +158,8 @@ export const DEFAULT_GLOBAL_CONFIG: {
 };
 
 export const 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/`],
 } as const;
 
 export const PAYMASTER_RPC_NODES = {

src/global/constants.ts

@@ -149,6 +149,12 @@ export function getDefaultNodes(rpcVersion: SupportedRpcVersion) {
 
   Object.keys(nodes).forEach(function (key, _) {
     nodes[key] = nodes[key].map((it: any) => {
+      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)}`;
     });
   });

src/utils/provider.ts

@@ -11,9 +11,8 @@ const generateSourceLinkTemplate = (gitRevision) =>
     gitRevision || '{gitRevision}'
   }/{path}#L{line}`;
 
-// TODO: restore after v7 full release
-// const migrationGuideLink = `${generateBaseUrl(process.env.DOCS_BASE_URL)}docs/guides/migrate`;
-const migrationGuideLink = `${generateBaseUrl(process.env.DOCS_BASE_URL)}docs/next/guides/migrate`;
+const migrationGuideLink = `${generateBaseUrl(process.env.DOCS_BASE_URL)}docs/guides/migrate`;
+// const migrationGuideLink = `${generateBaseUrl(process.env.DOCS_BASE_URL)}docs/next/guides/migrate`;
 
 /** @type {import('@docusaurus/types').Config} */
 const config = {
@@ -75,7 +74,7 @@ const config = {
         //... other Algolia param
       },
       announcementBar: {
-        content: `<a href="${migrationGuideLink}">Migrate to v7</a>`,
+        content: `<a href="${migrationGuideLink}">Migrate to v8</a>`,
         backgroundColor: 'rgb(230 231 232)',
       },
       navbar: {
@@ -125,7 +124,7 @@ const config = {
                 to: '/docs/guides/intro',
               },
               {
-                label: 'Migrate to v7',
+                label: 'Migrate to v8',
                 to: migrationGuideLink,
               },
             ],