Skip to main content

Releases

The following Soroban releases are preview releases.

We’re releasing early versions of Soroban because we believe it’s important to share the development process, and we want Stellar ecosystem developers and smart contract developers from other ecosystems to have a chance to experiment and provide feedback.

caution

Preview releases are software releases that are also released to the Futurenet test network. Software releases may occur between Futurenet releases. If you're interacting with Futurenet the recommended software versions to use in development are below. Releases to Futurenet may include network resets and network passphrase changes.

Preview 7 (February 16th, 2023)

Software

SoftwareVersion
XDRdf18148747e807618acf4639db41c4fd6f0be9fc
Soroban Environmentv0.0.14
Soroban Interface Version29
Stellar Core19.7.1-1204.871accefc.focal~soroban
Soroban Rust SDKv0.6.0
Soroban CLIv0.6.0
Soroban RPC0.6.1-13
Stellar Horizonstellar-horizon:2.24.61~soroban-335
Stellar Friendbotsoroban-v0.0.2-alpha
Stellar Quickstartstellar/quickstart:[email protected]:81c23da078c90d0ba220f8fc93414d0ea44608adc616988930529c58df278739
Stellar JS Stellar Base8.2.2-soroban.11
Stellar JS Soroban Clientv0.4.0
Freighterv2.10.0
Laboratoryv2.7.0
Futurenet Network PassphraseTest SDF Future Network ; October 2022

Breaking changes note

This release comes with a revamp of authorization approach that is breaking for most of the contracts that did any sort of auth logic or used tokens. See the migration guide, example and authorization overview for more details.

Changelog

XDR

  • Update Rust XDR for Auth Next.

See https://github.com/stellar/rs-stellar-xdr/releases v0.0.13 and v0.0.14 for more details.

Soroban Environment

  • Allow for a custom budget outside tests
  • Restructure Event to be cheap to clone and allow it to be rolled back
  • Add auth_required support for non-account balances
  • Reform TryFromVal to reduce number of impls
  • Fix override of panic hook during cross-contract testing
  • Add EnvBase::Error, remove CheckedEnv, make Env methods return Error
  • Initial Auth Next implementation in Soroban Host
  • Add 13-tuple conversions
  • Do not include Status as the first arg of a DebugEvent
  • Add a simpler version of require_auth
  • Use auth specific errors
  • Emulate classic account authentication in recording auth mode.
  • Change the interface for the auth testing utility.

See https://github.com/stellar/rs-soroban-env/releases v0.0.13 and v0.0.14 for more details.

Soroban Rust SDK

  • Support variants with multiple fields in UDTs
  • Error on UDT enums with 0-element tuple variants
  • Allow xlm balance updates
  • Fix vec insert
  • Adapt SDK to changes to {Try,}{From,Into}Val in env crates
  • Fix vec pop_front
  • Use better storage error in tests
  • Adapt to introduction of Env::Error
  • Improve compiler errors for UDTs
  • Allow same named types and functions
  • Make soroban_token_spec::spec_xdr easier to keep updated
  • Remove build-optimized makefile target
  • Auth Next changes in SDK
  • Add docs to contract spec entries
  • SDK support for simplified require_auth

See https://github.com/stellar/rs-soroban-sdk/releases v0.5.0 and v0.6.0 for more details.

Soroban RPC

  • Configure default limit, update cursor / startLedger validation, and include latest ledger for getEvents
  • Add support for AuthNext
  • Fix rollback error in logs
  • Add getNetwork command
  • Implement event storage
  • Implement ledger entry storage
  • Refactor db and ingestion packages, add ingestion of LedgerCloseMeta
  • Implement simulateTransaction using rust instead of preflight
  • Simplify topic matching for events search

See https://github.com/stellar/soroban-tools/releases v0.5.0 v0.6.0 for more details.

Soroban CLI

  • Add option for running contract with unlimited budget
  • Add support for AuthNext
  • Add config command
  • Add getNetwork support
  • Reorganize CLI commands

See https://github.com/stellar/soroban-tools/releases v0.5.0 v0.6.0 for more details.

Preview 6 (January 9th, 2023)

Software

SoftwareVersion
XDR026c9cd074bdb28ddde8ee52f2a4502d9e518a09
Soroban Environmentv0.0.12
Soroban Interface Version27
Stellar Core19.6.1-1158.c0ad35aa1.focal~soroban
Soroban Rust SDKv0.4.2
Soroban CLIv0.5.0
Soroban RPC0.4.0-10
Stellar Horizonstellar-horizon:2.22.0~soroban-323
Stellar Friendbotsoroban-v0.0.2-alpha
Stellar Quickstart (amd64)stellar/quickstart:[email protected]:c4429def497ed78ca99ae40c8e2522ec932081b4428df992900b5bc8d53bd642
Stellar Quickstart (arm64)stellar/quickstart:[email protected]:37205510329845f5fe533bb7c4c182d8f35b3a3515f0a6729889067663e1ec97
Stellar JS Stellar Base8.0.1-soroban.6
Stellar JS Soroban Clientv0.3.0
Futurenet Network PassphraseTest SDF Future Network ; October 2022

Changelog

Soroban Environment

  • Wasm instruction level calibration
  • Replace im containers with Vec
  • Remove EnvVal
  • Fix first/last_index_of functions to use deep object comparison
  • Export type aliases for Storage and Footprint
  • Add env.json
  • Remove built-in soroban token
  • Update rust-version
  • Use single balances in the Stellar Asset Contract
  • Remove unnecessary i128 clone

See https://github.com/stellar/rs-soroban-env/releases v0.0.12 for more details.

Soroban Rust SDK

  • Fix contractimpl for empty impl blocks
  • bump env and fix token interface
  • Remove init from the token interface
  • Update rust-version
  • Require only a borrow of Host when updating ledger snapshot
  • Fix doc comments and clippy warnings on ledger snapshot
  • Add LedgerSnapshot::update(Host)
  • undo token deploy revert
  • Revert deploy and update env
  • Remove token deploy in anticipation of removal of the soroban only built-in token
  • Make ledger snapshot write file create dir path
  • Make errors explicit in ledger snapshot functions
  • Update env to include delete-im, remove-EnvVal changes

See https://github.com/stellar/rs-soroban-sdk/releases v0.4.0, v0.4.1, v0.4.2 for more details.

Soroban RPC

  • Add GitHub linting for GO code

See https://github.com/stellar/soroban-tools/releases v0.4.0 for more details.

Soroban CLI

  • Update rust version
  • StrValError --> Error and implemented using thiserror
  • Use soroban-ledger-snapshot for managing ledger.json
  • Use LedgerSnapshot::update to update snapshot instead of unpacking the host and updating ledger info and entries separately.
  • Add events subcommand for local and remote event viewing
  • Deprecate token create command

See https://github.com/stellar/soroban-tools/releases v0.4.0 for more details.

Preview 5 (December 8th, 2022)

Software

SoftwareVersion
XDR026c9cd074bdb28ddde8ee52f2a4502d9e518a09
Soroban Environmentv0.0.11
Soroban Interface Version26
Stellar Corestellar-core_19.5.1-1137.b3a6bc281.focal~soroban
Soroban Rust SDKv0.3.2
Soroban CLIv0.3.3
Soroban RPC0.3.1-32
Stellar Horizonstellar-horizon:2.22.0~soroban-318
Stellar Friendbotsoroban-v0.0.2-alpha
Stellar Quickstartstellar/quickstart:[email protected]:8046391718f8e58b2b88b9c379abda3587bb874689fa09b2ed4871a764ebda27
Stellar JS Stellar Base8.0.1-soroban.5
Stellar JS Soroban Clientv0.2.0
Futurenet Network PassphraseTest SDF Future Network ; October 2022

Changelog

XDR

  • Remove BigInt from ScVal
  • Add u128 and i128 to ScVal
  • Change the structure of events in meta
  • Change transaction operation structure for Soroban contract deployments and invocations

See https://github.com/stellar/stellar-xdr/compare/48d5e17ae63bba0aa9725cd9d18d7438f44c07b1...026c9cd074bdb28ddde8ee52f2a4502d9e518a09 for more details.

Soroban Environment

  • Upgrade crate-git-revision to 0.0.4 (contribution by @brson)
  • Add Host::with_artificial_test_contract_frame
  • Restructure benchmark framework, add calibration code for all CostTypes
  • Disable budget costs for object cmp
  • Env changes to decouple contract instance from source
  • Remove BigInt, switch everything to u128 and i128

See https://github.com/stellar/rs-soroban-env/releases v0.0.10, v0.0.11 for more details.

Soroban Rust SDK

  • Rename data to storage by @leighmcculloch in #786
  • Add ability to get current Budget from env in tests by @leighmcculloch in #789
  • Add Env::as_contract for testutils by @leighmcculloch in #761
  • Update contract deployment to match the Env changes by @dmkozh in #766
  • Make contract_id public in contract clients. by @dmkozh in #768
  • Remove BigInt by @sisuresh in #770
  • Add soroban-ledger-snapshot
  • Change gen JSON output from stream to array (contribution by @vinamogit)
  • Contributions from @vinamogit

See https://github.com/stellar/rs-soroban-sdk/releases v0.3.0, v0.3.1, v0.3.2 for more details.

Soroban RPC

  • Add soroban-rpc version subcommand
  • Add a new getLedgerEntry jsonrpc method, deprecating and replacing getContractData allowing an application to fetch any ledger entry
  • Added new getEvents method currently backed by horizon

See https://github.com/stellar/soroban-tools/releases v0.3.0, v0.3.1 for more details.

Soroban CLI

  • Fix apt-get install in publish workflow
  • Added type description to errors when using --arg (contribution by @waldmatias)
  • Additional CLI support for the contract deployment changes
  • Adds support for soroban contract deploy --wasm-hash, as well as soroban contract install --wasm
  • Add xdr and env version to version subcommand output
  • Fix that the footpoint was not set correctly when deploying the wrapped token contract (contribution by @overcat)
  • Contributions from @waldmatias, @willemneal, @overcat, @brson

See https://github.com/stellar/soroban-tools/releases v0.3.0, v0.3.1, 0.3.3 for more details.

Preview 4 (November 15th, 2022)

Software

SoftwareVersion
XDRhttps://github.com/stellar/stellar-xdr-next/tree/48d5e17ae63bba0aa9725cd9d18d7438f44c07b1
Soroban Environmentv0.0.9
Soroban Interface Version23
Stellar Core19.5.1-1111.eba1d3de9.focal~soroban
Soroban Rust SDKv0.2.1
Soroban CLIv0.2.1
Soroban RPC0.3.1-32
Stellar Horizon2.22.0~soroban-304
Stellar Quickstartstellar/quickstart:[email protected]:0993d3350148af6ffeab5dc8f0b835236b28dade6dcae77ff8a09317162f768d
Futurenet Network PassphraseTest SDF Future Network ; October 2022

Changelog

XDR

  • Trivial whitespace changes

Soroban Environment

  • Vm tuning
  • Add token events
  • Catch panics from native contracts in try_call
  • Improved built-in token error reporting
  • Add missing conversion from Status->ScStatus for the ContractError variant
  • Capture user panic-strings in native builds, avoid spurious NoContractRunning error
  • Few small fixes to error debug events

See https://github.com/stellar/rs-soroban-env/releases v0.0.7, v0.0.8, v0.0.9 for more details.

Soroban Rust SDK

  • Add Logger::print in testutils
  • Add conversion from Address to Identifier
  • Remove deprecated functions
  • Remove panic-catching and fix tests that use newly-working native try_call
  • Reintroduce an optimized aborting unwrap
  • Add assert_with_error! macro
  • Rename panic_error! to panic_with_error!

See https://github.com/stellar/rs-soroban-sdk/releases v0.2.0, v0.2.1 for more details.

Soroban RPC

  • Initial Release

Soroban CLI

  • Strings and symbols are rendered as text in JSON output
  • Bytes are rendered as hex in JSON output
  • Accounts in invocations are created in sandbox
  • Add optimize sub-command that optimizes contracts
  • Fix the bin name in the completion command
  • Fix jsonrpc compliance issue

See https://github.com/stellar/soroban-cli/releases v0.2.0, v0.2.1 for more details.

Preview 3 (October 11th, 2022)

Software

SoftwareVersion
XDRhttps://github.com/stellar/stellar-xdr-next/tree/161e2e5b64425a49f9ccfef7f732ae742ed5eec4
Soroban Environmentv0.0.6
Soroban Interface Version23
Stellar Core19.4.1-1097.4e813f20e.focal~soroban
Soroban Rust SDKv0.1.1
Soroban CLIv0.1.2
Soroban RPC???
Stellar Horizon2.22.0~soroban-304
Stellar Quickstartstellar/quickstart:[email protected]:e58d83f92a61f43406087f488dd1cba110a92646dca85f14b3a416163609e853
Futurenet Network PassphraseTest SDF Future Network ; October 2022

Changelog

See https://www.stellar.org/blog/soroban-a-new-smart-contract-standard.

Preview 2 (September 13th, 2022)

See https://www.stellar.org/developers-blog/soroban-preview-release-2.

Preview 1 (August 1st, 2022)

See https://www.stellar.org/blog/project-jump-cannon-soroban-preview-release.