Skip to content

docs: migration guide v7-v8 #1456

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 13 commits into from
Jul 28, 2025
Merged

docs: migration guide v7-v8 #1456

merged 13 commits into from
Jul 28, 2025

Conversation

tabaktoni
Copy link
Member

@tabaktoni tabaktoni commented Jul 25, 2025

Motivation and Resolution

  • small fix and structural cleanup
  • migration guide

Checklist:

  • Performed a self-review of the code
  • Rebased to the last commit of the target branch (or merged it into my branch)
  • Linked the issues which this PR resolves
  • Documented the changes in code (API docs will be generated automatically)
  • Updated the tests
  • All tests are passing

@tabaktoni tabaktoni marked this pull request as draft July 25, 2025 09:59
@tabaktoni tabaktoni marked this pull request as ready for review July 25, 2025 13:27
@@ -41,8 +41,9 @@ The Starknet.js version must align with the RPC version supported by the chosen
| v0.5.0 | Starknet.js v5.23.0 |
| v0.5.1 | Starknet.js v5.29.0 or v6.1.0 |
| v0.6.0 | Starknet.js v6.24.1 |
| v0.7.1 | Starknet.js v6.24.1 or v7.0.1 |
| v0.8.0 | Starknet.js v7.0.1 |
| v0.7.1 | Starknet.js v6.24.1 or v7.x.x |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v7.6.4 in L44-45

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left it in as v7.x.x and truncated the old Starknet versions and the patch element from the new ones so the list a bit more general and concise.

| Lava | v0_6, v0_7, v0_8 | v0_8 |
| Local Pathfinder v0.16.2 | v0_6, v0_7, v0_8 | N/A |
| Local Juno v0.14.2 | v0_6, v0_7, v0_8 | N/A |
| Node | with public url | with API key |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mainnet is not yet handling v9.

| Local Juno v0.14.2 | v0_6, v0_7, v0_8 | N/A |
| Node | with public url | with API key |
| -----------------------: | :-------------: | :----------: |
| Alchemy | No | v0_8, v0_9 |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Have you checked that they have all performed upgrades?
If not, I can run my tests scripts to check.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Entire part of Docs should be removed as it is, and replaced with link to some test or script that can be run to confirm actual status. As this way of defining it in docs is hard to maintain.
If you like/already have some script for this, please just remove this and add link.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I walked back these node provider changes with v0_6 removed. I'll leave it to Phil to update or replace them in a new PR.


**Local Starknet Devnet network:**

| Node | with public url | with API key |
| ---------------------: | :-------------: | :----------: |
| starknet-devnet v0.2.4 | v0_7 | N/A |
| starknet-devnet v0.3.0 | v0_8 | N/A |
| starknet-devnet v0.4.x | v0_8 | N/A |
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

v0.4.3

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice.
More than 500 lines for a migration guide is a bit long, but more is better than less.

@tabaktoni tabaktoni merged commit d121085 into beta Jul 28, 2025
3 checks passed
Copy link
Contributor

🎉 This PR is included in version 8.0.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants