v22.0.0: Protocol 22

This release introduces a number of breaking changes and also deprecates fields that will be removed in the future. In order to facilitate a smooth transition, so that clients connecting with a v2N SDK to a v2(N+1) RPC are not interrupted, deprecated fields are phased out over the course of a major version.

Deprecated

• getVersionInfo now prefers camelCase over snake_case. For one major version, the endpoint will return both variants: please migrate your code to prefer camelCase, e.g., commitHash over commit_hash.
• getEvents now returns cursor on each event alongside the now-deprecated pagingToken field. Please migrate your code to prefer cursor.

Breaking Changes

• getLedgerEntry has been removed; please use getLedgerEntries, instead.
• simulateTransaction's cost response field has been removed. The costs can still be retrieved from the transactionData field. Specifically, cpuInsns is the same thing as the instructions, and memBytes is the same as the readBytes + writeBytes.
• --history-retention-window is the only way to set retention windows now.

Added

• Support for Protocol 22.
• getTransaction will now return the txHash field just like getTransactions.

Full list of Changes

• Use TransactionInfo within GetTransactionResponse by @Shaptic in #251
• Cleanup old retention window and upgrade history-retention-window by @psheth9 in #277
• Remove deprecated getLedgerEntry endpoint by @aditya1702 in #276
• Add build-stellar-rpc in makefile by @psheth9 in #296
• simulate-transaction: remove confusing Cost field in response by @2opremio in #295
• Add cursor in GetEventResponse by @psheth9 in #287
• Add hash to getTransactions response by @aditya1702 in #299
• Update docker file to build 2 images based on BINARY_NAME by @psheth9 in #300
• Remove pagingToken from getEvents by @psheth9 in #297
• Support two sorobans for preflight by @graydon in #264
• Protocol 22 Breaking changes by @2opremio in #280
• Use docker build TAG if supplied by @2opremio in #309
• Add test creating a contract with constructor by @2opremio in #311
• Bump Core version to 22rc2 by @2opremio in #312
• protocol22: Bump Rust dependencies by @2opremio in #316
• Add back in Protocol 22 non-breaking changes for a transition period by @Shaptic in #317
• Add txHash field to getTransaction after upstream merge by @Shaptic in #314
• protocol22: Bump rs-soroban-env to rc3 by @2opremio in #318
• Bump integration test references to Core's RC3 image by @Shaptic in #322
• protocol22: Bump dependencies to stable 22.0.0 by @2opremio in #324
• Protocol 22 support: XDR, deprecated API changes, new fields by @2opremio in #308

Contributors

• @aditya1702 @Shaptic @2opremio @psheth9
• @graydon made their first contribution in #264

Full Changelog: v21.5.1...v22.0.0