Main Release

.github/workflows/_test.yml

@@ -35,7 +35,7 @@ jobs:
     # TODO - periodically check if conditional services are supported; https://github.com/actions/runner/issues/822
     services:
       devnet:
-        image: ${{ (inputs.use-devnet) && 'shardlabs/starknet-devnet-rs:0.4.2' || '' }}
+        image: ${{ (inputs.use-devnet) && 'shardlabs/starknet-devnet-rs:0.6.0' || '' }}
         ports:
           - 5050:5050
 

.github/workflows/manual-tests-testnet.yml

@@ -32,14 +32,14 @@ on:
         description: 'Protocol: WS'
         type: boolean
         default: true
-      matrix-version-v0_7:
-        description: 'RPC version: 0.7'
-        type: boolean
-        default: true
       matrix-version-v0_8:
         description: 'RPC version: 0.8'
         type: boolean
         default: true
+      matrix-version-v0_9:
+        description: 'RPC version: 0.9'
+        type: boolean
+        default: true
 
 jobs:
   prepare-matrix:
@@ -78,9 +78,6 @@ jobs:
         node: ${{ fromJson(needs.prepare-matrix.outputs.matrix).node }}
         protocol: ${{ fromJson(needs.prepare-matrix.outputs.matrix).protocol }}
         version: ${{ fromJson(needs.prepare-matrix.outputs.matrix).version }}
-        exclude:
-          - version: v0_7
-            protocol: WS
 
     uses: ./.github/workflows/_test.yml
     with:

.github/workflows/pr-push-main.yml

@@ -43,10 +43,7 @@ jobs:
       matrix:
         protocol: [RPC, WS]
         node: [Juno, Pathfinder]
-        version: [v0_7, v0_8]
-        exclude:
-          - version: v0_7
-            protocol: WS
+        version: [v0_8, v0_9]
 
     uses: ./.github/workflows/_test.yml
     with:

.gitignore

@@ -5,6 +5,7 @@
 .eslintcache
 .vscode
 .idea
+.claude
 coverage
 coverage-ts
 dist

CHANGELOG.md

@@ -1,3 +1,189 @@
+# [8.6.0](https://github.com/starknet-io/starknet.js/compare/v8.5.5...v8.6.0) (2025-10-17)
+
+### Features
+
+- blake2s ([#1502](https://github.com/starknet-io/starknet.js/issues/1502)) ([dd3f8ec](https://github.com/starknet-io/starknet.js/commit/dd3f8eca44091a01d240f03e488a25b1119af524))
+
+## [8.5.5](https://github.com/starknet-io/starknet.js/compare/v8.5.4...v8.5.5) (2025-10-03)
+
+### Bug Fixes
+
+- ensure cleanHex has valid output ([f5123b6](https://github.com/starknet-io/starknet.js/commit/f5123b6f9c7fa49ad104a48fd4a1f62e2520488e))
+
+## [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
+
+- preserve leading zeros for cairo bytes data ([5542a00](https://github.com/starknet-io/starknet.js/commit/5542a0015d0cc3cae186d63fe4258c9942ff07d2))
+
+## [8.5.1](https://github.com/starknet-io/starknet.js/compare/v8.5.0...v8.5.1) (2025-08-27)
+
+### Bug Fixes
+
+- preserve leading zeros for pending word within byte array ([5d7ab04](https://github.com/starknet-io/starknet.js/commit/5d7ab042ce1a81e4f31a5ec4488db758308e872a))
+
+# [8.5.0](https://github.com/starknet-io/starknet.js/compare/v8.4.0...v8.5.0) (2025-08-18)
+
+### Features
+
+- **provider:** Add Brother ID domain resolution support ([#1313](https://github.com/starknet-io/starknet.js/issues/1313)) ([0bea966](https://github.com/starknet-io/starknet.js/commit/0bea966d29b51b026c6ed5d9916d9039d5fd6a17))
+
+# [8.4.0](https://github.com/starknet-io/starknet.js/compare/v8.3.1...v8.4.0) (2025-08-15)
+
+### Features
+
+- fast execute ([#1463](https://github.com/starknet-io/starknet.js/issues/1463)) ([d76fb63](https://github.com/starknet-io/starknet.js/commit/d76fb6321782b87a9bfc18c9ac859d21acb4f47e))
+
+## [8.3.1](https://github.com/starknet-io/starknet.js/compare/v8.3.0...v8.3.1) (2025-08-15)
+
+### Bug Fixes
+
+- ensure a Buffer type is available for all environments ([6e67834](https://github.com/starknet-io/starknet.js/commit/6e678343876504082d3c232a115b1c48a8f6ce96))
+
+# [8.3.0](https://github.com/starknet-io/starknet.js/compare/v8.2.0...v8.3.0) (2025-08-15)
+
+### Features
+
+- implement websocket 0.9 ([#1467](https://github.com/starknet-io/starknet.js/issues/1467)) ([7e988c4](https://github.com/starknet-io/starknet.js/commit/7e988c417ac2b4c862dc438b56a149ba7c20439d))
+
+# [8.2.0](https://github.com/starknet-io/starknet.js/compare/v8.1.2...v8.2.0) (2025-08-15)
+
+### Features
+
+- a CairoByteArray, CairoTypes, updates ([#1469](https://github.com/starknet-io/starknet.js/issues/1469)) ([430fb70](https://github.com/starknet-io/starknet.js/commit/430fb70e5c54d59f9fde9acadd701632170aca25)), closes [#1472](https://github.com/starknet-io/starknet.js/issues/1472)
+
+## [8.1.2](https://github.com/starknet-io/starknet.js/compare/v8.1.1...v8.1.2) (2025-08-04)
+
+### Bug Fixes
+
+- migration docs update and fix overhead method to allow false overhead for no overhead ([3b74e62](https://github.com/starknet-io/starknet.js/commit/3b74e621b69447790a6bd1c4112b60e2b428c946))
+
+## [8.1.1](https://github.com/starknet-io/starknet.js/compare/v8.1.0...v8.1.1) (2025-08-04)
+
+### Bug Fixes
+
+- repair published types ([#1465](https://github.com/starknet-io/starknet.js/issues/1465)) ([6ab9db0](https://github.com/starknet-io/starknet.js/commit/6ab9db0fd41155735f8536d9add046e2c89abb14))
+
+# [8.1.0](https://github.com/starknet-io/starknet.js/compare/v8.0.0...v8.1.0) (2025-07-28)
+
+### Bug Fixes
+
+- improve hex string validation in isHex function with support for 0X prefix ([316c12f](https://github.com/starknet-io/starknet.js/commit/316c12f416f3c49c8c2cd3374d3ef1543c3ff43d))
+- interfaces fixes and optional param fix ([86b41a0](https://github.com/starknet-io/starknet.js/commit/86b41a0460683d57ca85ef3ac44a9703bc2f9f58))
+- missing options Acc.-deployContract,declareAndDeploy; Con.-estimate with options, test: False tests for pre-confirm event and estimate with tip ([2bd9305](https://github.com/starknet-io/starknet.js/commit/2bd93053d5e2dfbf0db6af8da7b88653f17ee749))
+- test event on devnet ([50b98f3](https://github.com/starknet-io/starknet.js/commit/50b98f35f3a85c38a1ff7ee6899d238e2df6addb))
+
+### Features
+
+- contract.Factory can deploy contract with only class hash provided ([fe4cba6](https://github.com/starknet-io/starknet.js/commit/fe4cba6a667ad0e8a7e94eabd89554dc9d26dedb))
+- fees and tip helpers ([200318b](https://github.com/starknet-io/starknet.js/commit/200318bda4341cd7816fb0202d8f2965ccb2147a))
+
+# [8.0.0](https://github.com/starknet-io/starknet.js/compare/v7.6.4...v8.0.0) (2025-07-28)
+
+- feat!: bump version ([0afb3f8](https://github.com/starknet-io/starknet.js/commit/0afb3f8e82b147bcc7084c417826313c1e488053))
+
+### Bug Fixes
+
+- accountInvocationsFactory typing ([a1b1e7f](https://github.com/starknet-io/starknet.js/commit/a1b1e7f60e7abfa43836666a0d801abd33242d7b))
+- change DeclareDeployDCResponse name to DeclareDeployUDCResponse ([6498b8b](https://github.com/starknet-io/starknet.js/commit/6498b8b0bbd137658862422031132073f1c42ac3))
+- devenet ([3b2be9d](https://github.com/starknet-io/starknet.js/commit/3b2be9d46beec4931eb96183c0985e0f607e5713))
+- export Deployer, remove old helper parseUDCEvent, fix some tests imports ([c2d0d55](https://github.com/starknet-io/starknet.js/commit/c2d0d5508239f164ec538707bd19625c70dcb604))
+- factory jsdocs, CompleteDeclareContractPayload type update for Cairo1 ([06920cb](https://github.com/starknet-io/starknet.js/commit/06920cbcb52c70fe01d8161d27d6f0e32be94627))
+- import all types from ./api, remove 07 package ([68ac49c](https://github.com/starknet-io/starknet.js/commit/68ac49ceab4de5738671fd9d05757056a8c980df))
+- improve DeclareContractPayload type ([00835ca](https://github.com/starknet-io/starknet.js/commit/00835caf9406e8a9afd2cde22b43e5d3e2773990))
+- remove helper buildUDCCall ([d299f7b](https://github.com/starknet-io/starknet.js/commit/d299f7b3b175c265b218c2d182762ee38f3aa27a))
+- removed duplicated buildDeployerContractPayload ([e7b728d](https://github.com/starknet-io/starknet.js/commit/e7b728ddc6e5e9e3cffea941f4dcc6e20d8df1ff))
+- sepolia Pathfinder tests PASS ([0c41fc2](https://github.com/starknet-io/starknet.js/commit/0c41fc222c33077c7aad45c79af06852a0db3f69))
+- type problem in tests, due to merge in v8 ([fd49e8a](https://github.com/starknet-io/starknet.js/commit/fd49e8af3051b31f105cc82767248b7832df8130))
+- use new entrypoint on the new UDC ([992ee09](https://github.com/starknet-io/starknet.js/commit/992ee09e08533efb3a12ff91abc0fca2acb552f2))
+
+### Features
+
+- add custom Deployer in Account constructor ([7d62e20](https://github.com/starknet-io/starknet.js/commit/7d62e202c3bab698e383a2128f117675f30f38f7))
+- await Contract.factory() with rawArgs support, del connect(), del contractFactory Class ([c108160](https://github.com/starknet-io/starknet.js/commit/c108160e9b14df7411fa27e8587129d9deaae85e))
+- contract & factory type-sync with Account, fix SierraContractClass abi, buildUDCCall with abi ([20a732a](https://github.com/starknet-io/starknet.js/commit/20a732a47f8312206c1ab946bd99f37c57d92075))
+- customize tip type, cleanup, account interface update, remove types namespace export ([586ffde](https://github.com/starknet-io/starknet.js/commit/586ffdeb9ddcd38da4f93b2f579ad296a349fca5))
+- introduce roc09, made batchClient generic ([c49dd10](https://github.com/starknet-io/starknet.js/commit/c49dd1011ddf1ddec7c1e4403235338ab347b7a0))
+- main modifications without tests ([3407201](https://github.com/starknet-io/starknet.js/commit/34072010ce0a47fe94b80b29288ee129cce2bae1))
+- new channel init ([ffec346](https://github.com/starknet-io/starknet.js/commit/ffec346463f26b3aca8cb77d15d4440a08948e5b))
+- object-base API Account,WalletAccount, backward support methods ([06a3760](https://github.com/starknet-io/starknet.js/commit/06a37606fdde521d862f1608aa4ccf77eebba55c))
+- second swipe update, clean or commented tests ([92185f5](https://github.com/starknet-io/starknet.js/commit/92185f5674f8f1ded18c2aeb3ac273341bb3b117))
+- tip metric, test update ([e665389](https://github.com/starknet-io/starknet.js/commit/e665389c4fe8de6e7b386d6598ecc46b9a3d37c4))
+- tip raw impl in account, tests ([07d4e73](https://github.com/starknet-io/starknet.js/commit/07d4e738ef3e7c6c3c50b9ea3ceb9c3a76310eb4))
+- update packages ([a52db43](https://github.com/starknet-io/starknet.js/commit/a52db430f10dd00e04844933c46e400abb8a2833))
+
+### BREAKING CHANGES
+
+- starknet version 0.14:
+
+# [8.0.0-beta.4](https://github.com/starknet-io/starknet.js/compare/v8.0.0-beta.3...v8.0.0-beta.4) (2025-07-24)
+
+### Bug Fixes
+
+- accountInvocationsFactory typing ([a1b1e7f](https://github.com/starknet-io/starknet.js/commit/a1b1e7f60e7abfa43836666a0d801abd33242d7b))
+
+# [8.0.0-beta.3](https://github.com/starknet-io/starknet.js/compare/v8.0.0-beta.2...v8.0.0-beta.3) (2025-07-24)
+
+### Bug Fixes
+
+- change DeclareDeployDCResponse name to DeclareDeployUDCResponse ([6498b8b](https://github.com/starknet-io/starknet.js/commit/6498b8b0bbd137658862422031132073f1c42ac3))
+- devenet ([3b2be9d](https://github.com/starknet-io/starknet.js/commit/3b2be9d46beec4931eb96183c0985e0f607e5713))
+- export Deployer, remove old helper parseUDCEvent, fix some tests imports ([c2d0d55](https://github.com/starknet-io/starknet.js/commit/c2d0d5508239f164ec538707bd19625c70dcb604))
+- remove helper buildUDCCall ([d299f7b](https://github.com/starknet-io/starknet.js/commit/d299f7b3b175c265b218c2d182762ee38f3aa27a))
+- removed duplicated buildDeployerContractPayload ([e7b728d](https://github.com/starknet-io/starknet.js/commit/e7b728ddc6e5e9e3cffea941f4dcc6e20d8df1ff))
+- type problem in tests, due to merge in v8 ([fd49e8a](https://github.com/starknet-io/starknet.js/commit/fd49e8af3051b31f105cc82767248b7832df8130))
+- use new entrypoint on the new UDC ([992ee09](https://github.com/starknet-io/starknet.js/commit/992ee09e08533efb3a12ff91abc0fca2acb552f2))
+
+### Features
+
+- add custom Deployer in Account constructor ([7d62e20](https://github.com/starknet-io/starknet.js/commit/7d62e202c3bab698e383a2128f117675f30f38f7))
+- update packages ([a52db43](https://github.com/starknet-io/starknet.js/commit/a52db430f10dd00e04844933c46e400abb8a2833))
+
+# [8.0.0-beta.2](https://github.com/starknet-io/starknet.js/compare/v8.0.0-beta.1...v8.0.0-beta.2) (2025-07-21)
+
+### Features
+
+- customize tip type, cleanup, account interface update, remove types namespace export ([586ffde](https://github.com/starknet-io/starknet.js/commit/586ffdeb9ddcd38da4f93b2f579ad296a349fca5))
+- tip metric, test update ([e665389](https://github.com/starknet-io/starknet.js/commit/e665389c4fe8de6e7b386d6598ecc46b9a3d37c4))
+- tip raw impl in account, tests ([07d4e73](https://github.com/starknet-io/starknet.js/commit/07d4e738ef3e7c6c3c50b9ea3ceb9c3a76310eb4))
+
+# [8.0.0-beta.1](https://github.com/starknet-io/starknet.js/compare/v7.6.4...v8.0.0-beta.1) (2025-07-16)
+
+- feat!: bump version ([0afb3f8](https://github.com/starknet-io/starknet.js/commit/0afb3f8e82b147bcc7084c417826313c1e488053))
+
+### Bug Fixes
+
+- factory jsdocs, CompleteDeclareContractPayload type update for Cairo1 ([06920cb](https://github.com/starknet-io/starknet.js/commit/06920cbcb52c70fe01d8161d27d6f0e32be94627))
+- import all types from ./api, remove 07 package ([68ac49c](https://github.com/starknet-io/starknet.js/commit/68ac49ceab4de5738671fd9d05757056a8c980df))
+- improve DeclareContractPayload type ([00835ca](https://github.com/starknet-io/starknet.js/commit/00835caf9406e8a9afd2cde22b43e5d3e2773990))
+- sepolia Pathfinder tests PASS ([0c41fc2](https://github.com/starknet-io/starknet.js/commit/0c41fc222c33077c7aad45c79af06852a0db3f69))
+
+### Features
+
+- await Contract.factory() with rawArgs support, del connect(), del contractFactory Class ([c108160](https://github.com/starknet-io/starknet.js/commit/c108160e9b14df7411fa27e8587129d9deaae85e))
+- contract & factory type-sync with Account, fix SierraContractClass abi, buildUDCCall with abi ([20a732a](https://github.com/starknet-io/starknet.js/commit/20a732a47f8312206c1ab946bd99f37c57d92075))
+- introduce roc09, made batchClient generic ([c49dd10](https://github.com/starknet-io/starknet.js/commit/c49dd1011ddf1ddec7c1e4403235338ab347b7a0))
+- main modifications without tests ([3407201](https://github.com/starknet-io/starknet.js/commit/34072010ce0a47fe94b80b29288ee129cce2bae1))
+- new channel init ([ffec346](https://github.com/starknet-io/starknet.js/commit/ffec346463f26b3aca8cb77d15d4440a08948e5b))
+- object-base API Account,WalletAccount, backward support methods ([06a3760](https://github.com/starknet-io/starknet.js/commit/06a37606fdde521d862f1608aa4ccf77eebba55c))
+- second swipe update, clean or commented tests ([92185f5](https://github.com/starknet-io/starknet.js/commit/92185f5674f8f1ded18c2aeb3ac273341bb3b117))
+
+### BREAKING CHANGES
+
+- starknet version 0.14:
+
 ## [7.6.4](https://github.com/starknet-io/starknet.js/compare/v7.6.3...v7.6.4) (2025-07-10)
 
 ### Bug Fixes

CONTRIBUTING.md

@@ -45,8 +45,8 @@ By default, the tests are executed in your local Devnet, and everything should r
 If you want to use a specific RPC node, you have to set some global variables before executing the tests:
 
 ```bash
-export TEST_RPC_URL=http://192.168.1.44:9545/rpc/v0_7 # example of a Pathfinder node located in your local network
-export TEST_RPC_URL=https://starknet-sepolia.public.blastapi.io/rpc/v0_7 # example of a public Sepolia testnet node
+export TEST_RPC_URL=http://192.168.1.44:9545/rpc/v0_9 # example of a Pathfinder node located in your local network
+export TEST_RPC_URL=https://starknet-sepolia.public.blastapi.io/rpc/v0_9 # example of a public Sepolia testnet node
 export TEST_ACCOUNT_ADDRESS=0x065A822f0000000000000000000000000c26641
 export TEST_ACCOUNT_PRIVATE_KEY=0x02a80000000000000000000000001754438a
 ```

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).

__mocks__/cairo/byteArray/Scarb.lock

@@ -0,0 +1,24 @@
+# Code generated by scarb DO NOT EDIT.
+version = 1
+
+[[package]]
+name = "snforge_scarb_plugin"
+version = "0.45.0"
+source = "registry+https://scarbs.xyz/"
+checksum = "sha256:568482e8c40e7018d9ea729d6df3d5ec22b665cfff1e89181d8ad31bacca11cc"
+
+[[package]]
+name = "snforge_std"
+version = "0.45.0"
+source = "registry+https://scarbs.xyz/"
+checksum = "sha256:c08b359c266e45c4e71b71baa3c4af8dae7fc5416fc8168f0983e5c9a2ac0abe"
+dependencies = [
+ "snforge_scarb_plugin",
+]
+
+[[package]]
+name = "test"
+version = "0.1.0"
+dependencies = [
+ "snforge_std",
+]

__mocks__/cairo/byteArray/Scarb.toml

@@ -0,0 +1,21 @@
+[package]
+name = "test"
+version = "0.1.0"
+edition = "2024_07"
+
+[dependencies]
+starknet = "2.11.4"
+
+[dev-dependencies]
+snforge_std = "0.45.0"
+assert_macros = "2.11.4"
+
+[[target.starknet-contract]]
+sierra = true
+casm = true
+
+[scripts]
+test = "snforge test"
+
+[tool.scarb]
+allow-prebuilt-plugins = ["snforge_std"]

__mocks__/cairo/byteArray/src/lib.cairo

@@ -0,0 +1,62 @@
+// ByteArray Storage Contract Interface
+#[starknet::interface]
+pub trait IByteArrayStorage<TContractState> {
+    fn store_message(ref self: TContractState, message: ByteArray);
+    fn store_message_noevent(ref self: TContractState, message: ByteArray);
+    fn read_message(self: @TContractState) -> ByteArray;
+}
+
+// ByteArray Storage Contract
+#[starknet::contract]
+pub mod ByteArrayStorage {
+    use starknet::get_caller_address;
+    use starknet::storage::*;
+
+    #[storage]
+    struct Storage {
+        stored_message: ByteArray,
+    }
+
+    #[event]
+    #[derive(Drop, starknet::Event)]
+    pub enum Event {
+        MessageStored: MessageStored,
+    }
+
+    #[derive(Drop, starknet::Event)]
+    pub struct MessageStored {
+        pub caller: starknet::ContractAddress,
+        pub message: ByteArray,
+    }
+
+    #[constructor]
+    fn constructor(ref self: ContractState) {
+        // Initialize with empty ByteArray
+        self.stored_message.write("");
+    }
+
+    #[abi(embed_v0)]
+    impl ByteArrayStorageImpl of super::IByteArrayStorage<ContractState> {
+        fn store_message(ref self: ContractState, message: ByteArray) {
+            let caller = get_caller_address();
+
+            // Store the message in storage
+            self.stored_message.write(message.clone());
+
+            // Emit event with the message
+            self.emit(Event::MessageStored(MessageStored { 
+                caller, 
+                message 
+            }));
+        }
+
+        fn store_message_noevent(ref self: ContractState, message: ByteArray) {
+            // Store the message in storage
+            self.stored_message.write(message.clone());
+        }
+
+        fn read_message(self: @ContractState) -> ByteArray {
+            self.stored_message.read()
+        }
+    }
+}

__mocks__/cairo/byteArray/target/CACHEDIR.TAG

@@ -0,0 +1,3 @@
+Signature: 8a477f597d28d172789f06886806bc55
+# This file is a cache directory tag created by scarb.
+# For information about cache directory tags see https://bford.info/cachedir/