Blog Article
Protocol 22 Upgrade Guide
Author
Stellar Development Foundation
Publishing date
Protocol upgrade
Soroban
This guide is designed to help businesses and developers prepare for Protocol 22 with key dates, release information, a changelog, and more.
You can read all about what's included in Protocol 22 in the announcement blog and stay up to date on any and all Protocol 22-related announcements on the Stellar Developer Discord, where the ecosystem coordinates and shares information about the upgrade.
Key dates
- November 12: Testnet upgrade.
- November 19: Stable builds of all software available
- December 5: Mainnet upgrade vote.
What do you need to do to prepare?
TL;DR: Before the upgrade, make sure to install up-to-date versions of any and all Stellar-related software you use!
If you use a Stellar SDK
For your Testnet integration, upgrade to the latest version of the relevant Stellar SDK before November 12.
For your Mainnet integration, upgrade to the latest version of relevant Stellar SDKs before December 5.
Note that some SDK maintainers publish release candidate (i.e., RC) versions of the SDK when Stellar Core, Horizon, and RPC release RC versions rather than immediately releasing stable versions. In this case, remember to upgrade to stable versions of the SDK when they are available.
We will update the releases section below to indicate when an SDK release with Protocol 22 support is available, so check back if an SDK you use isn’t listed yet.
If you run Stellar infrastructure
If you use Docker images, pull the latest from the Docker registry. If you build from source or our Debian packages, make sure to also update your stellar-core binary used by your Horizon or RPC instance to the latest.
If you don’t run your own infrastructure but still need access to a Horizon or RPC instance, you can use an infrastructure provider. Here are lists for Horizon and RPC.
If you run a validator
The Protocol 22 upgrade vote is scheduled for December 5 at 1700 UTC. Here’s the command to arm your nodes for the upgrade:
upgrades?mode=set&upgradetime=2024-12-05T17:00:00Z&protocolversion=22
To view current network settings, see a history of protocol upgrades, and see pending proposals for future upgrades, take a look at https://stellar.expert/explorer/public/protocol-history
In the future, there will be more votes to adjust network settings based on network usage as well as subsequent protocol upgrades, so please make sure to stay up to date on the #validators channel on the Stellar Dev Discord. It’s crucial for validators to stay informed and participate in network governance!
The Latest
Protocol 22 Releases
Below are up-to-date links to all available releases relevant to Protocol 22. In general, please make sure to check release notes for specific instructions and requirements, and unless otherwise indicated, opt for the “Latest Release.”
Stellar infrastructure
SDKs
Next steps
More for you to explore
Article
• Simon Chow
Hubble: Now Faster than Light
Data
Hubble
Learn how Stellar ETL, which has been refactored to use the full suite of benefits from the Composable Data Platform (CDP), the next generation…
Article
• Garand Tyson
Introducing State Archival: The Solution to State Bloat on Stellar
This article is part of a deep-dive series on the industry’s state bloat problem, which must be solved for blockchains to remain inexpensive, deliver…
Article
• Molly Karcher
Composable Data Platform: A New Way to Access Data on Stellar
Developer Tool
Data
This article is the first in an expansive series on the Composable Data Platform, the next generation data-access platform on Stellar. The Composable…