Updating the SDKs to the stable Protocol 20 release

[Shaptic]

SDKs need to be updated to adapt to breaking changes that have occurred since Preview 11 (i.e. the current testnet release candidate) coming to Protocol 20.

Summary of Breaking Changes

This is likely irrelevant to SDK maintainers, but do note sandbox mode has been removed from the Soroban CLI (stellar/stellar-cli#983).

XDR

The XDR needs to be updated to stellar/stellar-xdr@6a620d1. This includes a non-trivial list of breaking changes (mostly renames):

• The BumpFootprintExpirationOp is now ExtendFootprintTTLOp and its ledgersToExpire field is now named extendTo, but it serves the same purpose.
• ContractExecutable.contractExecutableToken is now contractExecutableStellarAsset
• SorobanTransactionData.refundableFee is now resourceFee
• This new fee encompasses the entirety of the Soroban-related resource fees. Note that this is distinct from the "network-inclusion" fee that you would set on your transaction
• see Upgrade XDR to the final, stable testnet version. stellar/js-stellar-base#704 for an example migration

RPC

• The getEvents RPC endpoint structure has changed:
  • value: { xdr: string } is now just value: string (Flatten the getEvents response structure stellar/stellar-cli#1015)
  • contractId will always be a contract strkey (C... format) if present (The contract ID returned by getEvents should be a strkey stellar/stellar-cli#1007)
• The getLedgerEntries RPC endpoint now includes expiration info (soroban-rpc: Better state expiration support for getLedgerEntry stellar/stellar-cli#1010):
  • expirationLedgerSeq is a string-ified uint32 present if the requested entries have expiration

[Ifropc]

@EdwinGuayacan FYI, in case you missed this ^
XDR and RPC are stable for protocol version 20, and we expect it to be ready for testnet release! (Unless there is a critical bug found)
It would be great if you could let us know some estimates on when you expect the SDK to be up to date with the protocol changes. Thank you!

[Shaptic]

There is an additional schema change: the getLedgerEntries RPC response will use liveUntilLedgerSeq rather than expirationLedgerSeq in the final build (ref: stellar/stellar-cli#1029)

[miguelnietoa]

The changes have been implemented and will be released once the next Soroban release comes out!

Here are the PRs where the changes have been applied:

• stellar_base: Support stable Protocol 20 release stellar_base#296
• stellar_sdk: Support stable Protocol 20 #343
• soroban.ex: 140 protocol 20 support soroban.ex#141

Thank you @Shaptic @Ifropc

[Ifropc]

Hi @miguelnietoa just a heads-up, new quickstart image has been released couple days ago stellar/quickstart:soroban-dev and is updated to match futurenet and has all the p20 stable versions
So it should be available to test against

[miguelnietoa]

Hi @Ifropc, We are about to start testing again and do release once we confirm everything is working well. 😉
Thank u!