Software Versions
Release candidates are software releases that are also released to the Testnet test network. Software releases may occur between Testnet releases. If you're interacting with Testnet, the recommended software versions to use in development are provided below. Releases to Testnet may include network resets and network passphrase changes.
Protocol 22 (Testnet, October , 2024)
Software
Software | Version |
---|---|
XDR | v22.0 |
Rust XDR | v22.0.0-rc.1.1 |
Soroban Environment | v22.0.0-rc.2 |
Stellar Core | v22.0.0rc2 |
Soroban Rust SDK | v22.0.0-rc.2.1 |
Stellar CLI | TBD |
Soroban RPC | TBD |
Stellar Horizon | TBD |
Stellar Quickstart | TBD |
Stellar JS Stellar Base | TBD |
Stellar JS Stellar SDK | TBD |
Freighter | |
Laboratory | |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Release notes
Core
New features in Protocol 22:
- Constructor support in Soroban: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0058.md.
- Soroban host functions for BLS12-381: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0059.md.
Soroban Rust SDK
Key protocol-related changes:
- Support for constructors
- Support for BLS12-381 host functions
Stellar CLI (Previously Soroban CLI)
Protocol 21 (Mainnet, June 18, 2024)
Software
Software | Version |
---|---|
XDR | v21.1 |
Rust XDR | v21.0.1 |
Soroban Environment | v21.0.2 |
Stellar Core | v21.0.0 |
Soroban Rust SDK | 21.0.1-preview.3 |
Stellar CLI | v21.0.0 |
Soroban RPC | v21.3.0 |
Stellar Horizon | v2.30.0 |
Stellar Quickstart | https://hub.docker.com/layers/stellar/quickstart/v426-latest-amd64/images/sha256-274395daab6fa8033b9213f152d56699358917fb01d7c7e95392a37fc00c9d01 |
Stellar JS Stellar Base | v12.0.0-rc1 |
Stellar JS Stellar SDK | v12.1.0 |
Freighter | |
Laboratory | |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Release notes
Core
New features in Protocol 21:
- Secp256r1 support in Soroban host: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0051.md
- Soroban host function for extending TTL of contract instance and code separately: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0053.md
- Use refined cost model for VM instantiation in order to reduce the VM instantiation metered costs: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0054.md
- Intra-transaction VM module caching for the further Soroban cost reduction: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0055.md, https://github.com/stellar/stellar-protocol/blob/master/core/cap-0056.md
Soroban Rust SDK
Key protocol-related changes:
- Support for secp256r1 signature verification
- Support for extending TTL of contract instance and code separate from each other
Stellar CLI (Previously Soroban CLI)
Note: Soroban CLI has been renamed to Stellar CLI.
- Add stellar-cli crate alongside soroban-cli
- Rename to stellar-cli
- Install stellar and soroban CLIs when installing either
- Update completions to use stellar instead of soroban
- Update other references to stellar-cli
- Add support for contract id alias name when deploying and invoking contracts
- Extract alias logic into its own implementation
- Embed examples contract list into source and remove from build script
- Add cache sub commands and allow for proper transaction data logging
- Update TS Bindings stellar-sdk dep to 12rc2
- Add no-build option for fee::Args
- Do not auto add test account to keys
- Output TransactionEnvelope instead of Transaction for --build-only
- Ledger signing
- Use safe unwrapping in option unwrap
- Exclude host only functions from client
- Add container log tailing cmd
- Update network container start command to use updated enable flags
- Add libudev-dev as dep
- Bump versions of dependencies
- Update to newest soroban-rpc and copy over old signing logic
- Remove deprecated lab token command
- Remove deprecated config command
- Remove lab xdr command
- Add xdr command to root
Protocol 21 (Testnet only, May 20, 2024)
Software
Software | Version |
---|---|
XDR | v21.1 |
Rust XDR | v21.0.1 |
Soroban Environment | v21.0.2 |
Stellar Core | v21.0.0 |
Soroban Rust SDK | 21.0.1-preview.3 |
Soroban CLI | v21.0.0-rc.1 |
Soroban RPC | v21.2.0 |
Stellar Horizon | v2.30.0 |
Stellar Quickstart | https://hub.docker.com/layers/stellar/quickstart/v426-latest-amd64/images/sha256-274395daab6fa8033b9213f152d56699358917fb01d7c7e95392a37fc00c9d01 |
Stellar JS Stellar Base | v12.0.0-rc1 |
Stellar JS Stellar SDK | v12.0.0-rc.3 |
Freighter | |
Laboratory | |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Release notes
Core
This is the first stable Core release supporting protocol 21. New features in protocol 21:
- Secp256r1 support in Soroban host: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0051.md
- Soroban host function for extending TTL of contract instance and code separately: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0053.md
- Use refined cost model for VM instantiation in order to reduce the VM instantiation metered costs: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0054.md
- Intra-transaction VM module caching for the further Soroban cost reduction: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0055.md, https://github.com/stellar/stellar-protocol/blob/master/core/cap-0056.md
Soroban Rust SDK
This is the first version of the Soroban SDK that supports protocol 21. It is marked as 'preview' because contracts built with SDK v21 will only be compatible with the networks upgraded to protocol 21. Key protocol-related changes:
- Support for secp256r1 signature verification
- Support for extending TTL of contract instance and code separate from each other
Protocol 21: Preview 1 (Testnet only, April 12, 2024)
Software
Software | Version |
---|---|
XDR | v21.1 |
Rust XDR | v21.0.1 |
Soroban Environment | v21.0.1 |
Stellar Core | v21.0.0rc1 |
Soroban Rust SDK | 21.0.1-preview.1 |
Soroban CLI | v21.0.0-preview.1 |
Soroban RPC | v21.0.1 |
Stellar Horizon | v2.30.0 |
Stellar Quickstart | `` |
Stellar JS Stellar Base | v11.1.0 |
Stellar JS Stellar SDK | v12.0.0-rc.1 |
Freighter | `` |
Laboratory | `` |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Release notes
Core
This is the first Core release supporting protocol 21. New features in protocol 21:
- Secp256r1 support in Soroban host: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0051.md
- Soroban host function for extending TTL of contract instance and code separately: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0053.md
- Use refined cost model for VM instantiation in order to reduce the VM instantiation metered costs: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0054.md
- Intra-transaction VM module caching for the further Soroban cost reduction: https://github.com/stellar/stellar-protocol/blob/master/core/cap-0055.md, https://github.com/stellar/stellar-protocol/blob/master/core/cap-0056.md
Soroban Rust SDK
This is the first version of the Soroban SDK that supports protocol 21. It is marked as 'preview' because contracts built with SDK v21 will only be compatible with the networks upgraded to protocol 21. The API itself may be considered stable. Key changes:
- Support for secp256r1 signature verification
- Support for extending TTL of contract instance and code separate from each other
Protocol 20: Soroban Phase 2 (March 19, 2024)
Software
Software | Version |
---|---|
XDR | 3da6ebcbd8afa01d5c94dbc7f0475f4c00089420 |
Soroban Environment | v20.2.2 |
Soroban Interface Version | 0 |
Soroban Resource Limits | Phase 2 Limits |
Soroban Resource Fees | Phase 2 Fees |
Stellar Core | v20.3.0 |
Soroban Rust SDK | v20.4.0 |
Soroban CLI | v20.3.1 |
Soroban RPC | v20.3.3 |
Stellar Horizon | v2.28.3 |
Stellar Friendbot | TBD |
Stellar Quickstart | docker.io/stellar/quickstart:latest@sha256:1a82b17a4fae853d24189dd25d4e6b774fa7a1b6356a993e618c6e9bd2f3e04c |
Stellar JS Stellar Base | v11.0.0 |
Stellar JS Stellar SDK | v11.2.2 |
Freighter | v5.17.0 |
Laboratory | v4.1.0 |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Changelog
Core
- Remove use of C99 that looks like Cxx20 designated initializers
- Reduce scan size in phase1
- Add simulate subcommand to network survey script
- Continue to capture SCP messages for previous ledger in database
- Rewrite state loading path on startup
- Add support for debug-tx-set in dump-xdr
- Bucket cleanup
- Update phase1 settings
- Fix compile error (Visual C++)
- Update soroban settings files and utils
- Add new throttling metrics
- Adds CLI tool to print BucketList archival stats
- Update denominators
- Set key size to initial value
- Update max_entries_to_archive to be 1000.
- Restrict "prev" test to just the voting path, to allow catchup.
- Strkey update
- Add scripts/extract-wasms.sh
- Bump overlay min version to 32
- Fix noisy eviction scan warnings
- Early initialization of soroban metrics
Soroban Rust SDK
- Display String contents in Debug implementation
- Add Bytes to_buffer and to_alloc_vec
- Move the Env testutil internal types into a single type
- Add option to disable test snapshots on Env
- Bump version to 20.4.0
Protocol 20: Soroban Phase 1 (February 27, 2024)
Software
Software | Version |
---|---|
XDR | 8b9d623ef40423a8462442b86997155f2c04d3a1 |
Soroban Environment | v20.2.2 |
Soroban Interface Version | 0 |
Soroban Resource Limits | Phase 1 Limits |
Soroban Resource Fees | Phase 1 Fees |
Stellar Core | v20.2.0 |
Soroban Rust SDK | v20.3.2 |
Soroban CLI | v20.3.1 |
Soroban RPC | v20.3.3 |
Stellar Horizon | v2.28.3 |
Stellar Friendbot | TBD |
Stellar Quickstart | docker.io/stellar/quickstart:latest@sha256:1a82b17a4fae853d24189dd25d4e6b774fa7a1b6356a993e618c6e9bd2f3e04c |
Stellar JS Stellar Base | v11.0.0 |
Stellar JS Stellar SDK | v11.2.2 |
Freighter | v5.17.0 |
Laboratory | v4.1.0 |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Changelog
Soroban RPC
- (tag: v20.3.3) Bump version to 20.3.3
- Update Dockerfile and Makefile to refer rpc instead of tools
- Fix publish-dry-run failures
- Revert "soroban-rpc: Remove publish-dry-run Workflow"
- Perform fee padding in a larger bit width of integers
- (tag: v20.3.2) Bump version to 20.3.2
- Merge pull request #68 from stellar/add-spec-tools-crate
- Merge branch 'main' into add-spec-tools-crate
- Change module from soroban-tool to rpc in go.mod
- Add hardcoded WASM file and reference it in tests
- Uncomment install_rust
- Add prometheus hook to count different log levels
- Remove build-test-wasms from makefile
Soroban CLI
- (tag: v20.3.1) Bump version to 20.3.1
- Update references in end-to-end tests to point to the latest releases
- Bump version of soroban rpc and spec tools
- Repoint soroban-spec-tools to the moved one in stellar/soroban-rpc
- Rename Cargo.toml in the init template files
- soroban-cli: Remove ALL RPC Related Code and Workflows
- Use soroban-rpc crate from the RPC repo
- fix: embed the init template files in the build
- [Epic] Separating soroban-rpc to prepare for repo change
- Soroban contract init followup
- Merge pull request #1190 from stellar/release/v20.3.0
- Merge branch 'main' into release/v20.3.0
- Revert "[Epic] Separating soroban-rpc to prepare for repo change"
- [Epic] Separating soroban-rpc to prepare for repo change
Protocol 20: Soroban Phase 1 (Mainnet Edition) (February 5, 2024)
Software
Software | Version |
---|---|
XDR | 8b9d623ef40423a8462442b86997155f2c04d3a1 |
Soroban Environment | v20.2.2 |
Soroban Interface Version | 0 |
Soroban Resource Limits | Phase 0 Limits |
Soroban Resource Fees | Phase 0 Fees |
Stellar Core | v20.2.0 |
Soroban Rust SDK | v20.3.2 |
Soroban CLI | v20.3.0 |
Soroban RPC | v20.3.1 |
Stellar Horizon | v2.28.3 |
Stellar Friendbot | TBD |
Stellar Quickstart | docker.io/stellar/quickstart:latest@sha256:8d6f6520ad3842042bfe4e271f8b2324ec2f128564487abedd3876cea83af4f1 |
Stellar JS Stellar Base | v11.0.0 |
Stellar JS Stellar SDK | v11.2.2 |
Freighter | 5.16.0 |
Laboratory | v4.1.0 |
Soroban React Payment dapp | v3.0.0 |
Soroban Mint Token dapp | v3.0.0 |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Mainnet Network Passphrase | Public Global Stellar Network ; September 2015 |
Changelog
XDR
- Run CI for the msrv and latest rust version
- Backfill changes to next for json rendering
- Bump XDR
- Bump version to 20.1.0
Soroban Environment
- Allow small version-range wiggle room on curve25519-dalek to enable docs.rs nightly build
- Bump version to 20.2.2
- Enable publish of soroban-simulation crate
- Add a function to invoke host function 'end-to-end' in recording mode.
- Bug 1283 asset code rendering
- Use strkeys for contract IDs and addresses in diagnostic events.
- Turn off wasm_reference_types in Wasmi
- Prng tests
- Remove ConversionError from ScVal/Val conversions
- Tightening up metering in auth
- Bump XDR to 20.1
- Allow negative fee1 kb low
- Bump version to 20.2.0
- Cover various Symbol conversion code paths with various valid/invalid cases
- Run CI for the msrv and latest rust version
- Add protocol version method to invoke_contract
- Enable VM execution in a WASM environment by guarding time track behind time feature
- Add test for checking VM stack depth.
- Migrate preflight computations from soroban-rpc
- soroban-simulate: Misc fixes
- Add CI job to run cargo-semver-checks
- Tracing
- Add some basic test coverage for e2e_invoke.
- Add test vectors for ed25519 edge cases
- Trace should not emit diagnostic errors
- Bump wasmi to 0.31.1-soroban.20.0.1
- Bump version to 20.1.1
Soroban Rust SDK
- Update soroban-env-*
- Bump version to 20.3.2
- Update extend_ttl docs
- Bug 1076 conversion error flattening
Soroban RPC
- Migrate Soroban Tools to Soroban RPC
- Use soroban-tools Crates
- Pull in Recent Soroban RPC changes from soroban-tools
- Mirror Last Remaining PRs from soroban-tools Repo
- Add Workflow to Publish soroban-rpc Crate
- added user agent config on ha archive pool
- Update getTxn rpc with events data
- Remove publish-dry-run Workflow
- Use external soroban-simulation library for preflight computations
- Store and serve the event transaction ID
- Reduce event memory footprint
- Add diagnostic events to sendTransaction response
- Remove panics from internal codebase
Soroban CLI
- feat: soroban init command
- Bump dependencies for pubnet release
- Upgrade Ubuntu to 22.04 from 20.04
- Bump Go, Rust and Core dependencies
- feat/cli: Move config commands to top level
- bindings-ts: update to latest SDK & TypeScript, add CI test
- TypeScript bindings have been updated to use the latest stellar-sdk
- Support multi-auth workflows in typescript bindings
- Replace cli xdr command with stellar-xdr cli
- Update typescript bindings for latest versions
- Warn about RC versions only when using pubnet
Stable v20.1.0 (January 11, 2024)
Software
Software | Version |
---|---|
XDR | bb54e505f814386a3f45172e0b7e95b7badbe969 |
Soroban Environment | v20.1.0 |
Soroban Interface Version | 0 |
Stellar Core | v20.1.0 |
Soroban Rust SDK | v20.2.0 |
Soroban CLI | v20.2.0 |
Soroban RPC | v20.2.0 |
Stellar Horizon | v2.27.0 |
Stellar Friendbot | TBD |
Stellar Quickstart | docker.io/stellar/quickstart:soroban-dev@sha256:64b2d14b8a531c534560e287768846f538b2f063fc776aa9ca016c788e86c782 |
Stellar JS Stellar Base | v10.0.1 |
Stellar JS Stellar SDK | v11.2.0 |
Freighter | 5.9.0 |
Laboratory | TBD |
Soroban React Payment dapp | TBD |
Soroban Mint Token dapp | TBD |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Changelog
Soroban Rust SDK
- Fix bug with Timepoint/Duration as parameters/returns
- Add storage update fns
- Export functions for creating Timepoint/Duration
- Allow
&Env
in contract fns
Stable v20.0.0 (December 18, 2023)
Software
Software | Version |
---|---|
XDR | bb54e505f814386a3f45172e0b7e95b7badbe969 |
Soroban Environment | v20.0.0 |
Soroban Interface Version | 0 |
Stellar Core | v20.0.1 |
Soroban Rust SDK | v20.0.0 |
Soroban CLI | v20.0.2 |
Soroban RPC | v20.0.2 |
Stellar Horizon | v2.27.0 |
Stellar Friendbot | TBD |
Stellar Quickstart | docker.io/stellar/quickstart:testing@sha256:3c7947f65db493f2ab8ca639753130ba4916c57d000d4a1f01ec530e3423853b |
Stellar JS Stellar Base | v10.0.0 |
Stellar JS Stellar SDK | v11.0.1 |
Stellar JS Soroban Client | v1.0.0 (deprecated, prefer the Stellar SDK) |
Freighter | 5.12.0 |
Laboratory | 4.11.0 |
Soroban React Payment dapp | 3.0.0 |
Soroban Mint Token dapp | 3.0.0 |
Soroban Swap Token dapp | TBD |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
Changelog
XDR
- Update the docs for extendTTL/restore ops to match the threshold change
Soroban Environment
- Make RecordedAuthPayload consistently return None for invoker.
- Expiration-related fixes
- Turn dynamic borrow panics into HostErrors
- Use Ed25519 verify_strict function rather than just verify, fix #857
- Misc int32 issues
- Enforce object handle integrity when inserting into containers, fix #569
- Add testcase for out-of-order scmaps, fix #223.
- Add a function to compute the rent fee.
- Use host.err for auth error
- Add a smoke test for recording auth for create contract host fn.
- Stop treating storage errors as missing entries
- Refactor authorization manager to only maintain mutable borrow on minimal amount of fields
- Bump xdr
- Add rent bumps to the SAC
- Add is_admin function
- Bump xdr
- Add function to compute the write fee based on the ledger size.
- Prohibit using disjoint signatures to cover the auth tree.
- Enforce DepthLimiter in the Host to avoid stack overflow
- Relative objects in wasm
- Adapt to ResourceLimiter, replacing mem_fuel metering
- Make del_contract_data no-op for removing non-existent instance storage key.
- Add "tracy" feature to enable Tracy profiler, with some basic annotations
- Update host to account for the XDR changes.
- Update rust-version
- Adapt to SCError change to be an enum, with ContractError(u32)
- Make some host errors non-recoverable in try_call.
- Fix panic-string-logging code path broken by recent dynamic-borrow fix.
- Add soroban-bench-utils, add benchmark tests to measure metering accuracy
- Bump env xdr and do the fee library changes corresponding to config changes
- Bump env xdr
- Remove event topic limits
- Bump env xdr
- Unify/fix expiration bump logic in host.
- Add new tests for error escalation from contract calls.
- Add a helper that invokes a host function 'end-to-end'
- Add helpers for container bulk init; applies to auth metering
- Switch some auth errors from Internal to InvalidInput.
- Enable post-MVP WASM ops (sign-ext and mutable-globals), fix #968.
- More token tests
- Alloc example
- Mop up some residual uses of format strings in errors (no longer supported)
- Add wasm for upgrade write-bytes contract
- Scale the linear cost model coefficient; improve model fitting
- Error if bumping past max_entry_expiration and host function to retrieve max_entry_expiration
- Make has checks to properly populate the storage map in recording mode
- Clean up budget cost types
- Add debug events to storage error reporting.
- Switch to stable rust-analyzer in CI
- Add some comments and tests to env-common/symbol.rs
- Upgrade dalek crates to new stable versions.
- Add an option to return an error when encountering non-root auth in recording mode.
- Reject env.json if there are duplicate export names, fix #189
- Tighten signature of unchecked_visit_val_obj, fix #595
- Tighten dependencies further
- Fix incorrect argument name
- Bump env xdr
- Tighten up Map and Vector and metering coverage
- Store dummy instance for test contracts.
- Update XDR to take change that removes SCSpecTypeSet
- Fix comparison in Tag::is_object
- Fix calibration due to delak change
- Charge write fees for expiration entry bumps.
- Reduce the expiration entry write size.
- Refactor host to support the new expiration ledger approach.
- Add lifetime threshold
- Enable build workflow for merge groups
- Remove key size from rent change computation.
- Take change from txSOROBAN_RESOURCE_LIMIT_EXCEEDED to txSOROBAN_INVALID
- Add ExpirationEntry support
- Add git rev dep check to ci
- Fix encode contract events metering
- Trim deps
- Reject vals with invalid tags, fix #1029
- Fix EXPIRATION_ENTRY_SIZE constant
- Avoid iloop externalizing diagnostics for invalid references
- Add "coverage" Makefile target for lcov.info, add a test that extends coverage
- Fix asset-code rendering in native contract.
- Fix rent changes extraction bug
- Graydon code review
- Jay code review
- Bump xdr and use curr instead of next
- Trivial xdr bump
- Tighten wasm interface version checks, and do on upload.
- Update wasmi to 0.31.0-soroban
- Bump version to 20.0.0-rc1
- Add "next" feature to crates using xdr directly or indirectly
- Move out-slice len adjustment from symbol_copy_to_slice to its caller.
- Bump interface and regenerate wasms to handle symbol semantics change.
- No-op rename: remove metered from metered_scan_slice_of_slices
- Get rid of an unnecessary vector allocation in map_new_from_slices
- Remove metered map iterator functions.
- Small vec cleanup
- Code cleanup around PRNG
- Factor Tag::is_object to let Val::is_object delegate to it
- Set LedgerEntry extensions on existing entries
- Attach the auth in recording mode to any valid tracker.
- Improve storage error reporting for token contract.
- Env-common cleanups and dead code removal
- More cleanups, comments and fixes from code review.
- Make the 'unknown' wasmi error to be InvalidAction instead of InternalError
- Error improvements
- Small update for the default budget limits.
- Calibration for PRNG and charge budget
- Code review, cleanup, removal of dead/dangerous host functions
- Add redundant "next" dependencies
- Host code review, minor cleanups and code reorganization
- Fix the instance storage update logic.
- Feature: Expose rem_euclid functions on 256 bit numbers
- Replace address bytes conversions with strkey conversions.
- Use Address for call_account_contract_check_auth test helper.
- More code review and cleanup of host.rs module
- Budget fiddling
- Bump env XDR
- State expiration renames
- Cost type cleanup, bug fix, improve calibration
- Code review on fees, crypto, prng, dispatch
- Storage code review
- Setup bench framework to run experiments
- Decorate error for nonce missing from the footprint.
- Remove bad LEs
- Add missing fixed-size metering in comparison.rs, clean up a bit
- Properly dispatch test contracts based on the executable.
- Tighten up metering for linear memory routines
- conversion.rs code review fixes
- Review fixes for declared_size and metered_clone
- Gate recording auth behind the feature.
- Fix test wasms for latest sdk
- Cackle gate
- Remove spendable_balance from SAC.
- Extend upgrade contract from 30 to 60 days
- Bug 1042 internal renames
- Remove panic
- Stop caching authorization tracker verification status.
- Overhaul "free budget" and migrate non-metered code
- Clarify (and add redundant defensive code) in check_val_integrity
- Remove a panic and be more conservative about depth limit
- Add conceptual overview comment to auth module
- Fix fuzz-found panic in Prng::u64_in_inclusive_range
- Fix fuzzer-found frame stack corruption in rollback if instance storage fails
- Arbitrary-compatible expr generation and host fuzzing
- Improve auth test coverage a bit
- Rollback tests
- Add a test that ensures that SAC reentry is not possible.
- Remove vnext test wasms
- Add fn to find out if Host can be finished
- Add tests for more wasmi trap conditions
- Storage tests
- Add tests that try to build a deep host stack.
- More events and diagnostics testing
- Fix #1174 fuzzer-found deserialization of non-representable ScVal bug.
- tighten up handling of debug mode
- Update rust-version
- Adapt to rs-stellar-xdr Limits change
- Add tests that cover fees for each individual resource.
- Cover non-existent Wasm in test for updating Wasm.
- Adds loadgen test WASM
- Add wasm test for excessive initial memory and table size
- Initial cut at bug 872, observe side effects of tests
- Remove unnecessary copy of value
- Test update_contract_wasm with rollbacks.
- Bug 1146 test invalid val bit patterns
- Add @dmkozh as code owner of soroban-env-host
- Hook envbase and vec slices
- Update stellar-xdr
- Don't block merges on rust-analyzer compat check
- Observe most of the remainder of the testsuite
- Update deps, fix #1200
- Test nested extend_ttl
- Fix #1175 error code spoofing
- Do not error if no authorizations
- Add a contract that allows materializing arbitrarily large values.
- Updated loadgen Wasm
- Cap persistent extension to max
- Error on issuer for mint, burn, clawback, and burn_from
- Add a very simple hook for tracking top-level contract invocations.
- Macro for testing host function dispatch with bad inputs
- Check val integrity more
- Adapt to Rust 1.74
- Improve test coverage for crypto functions.
- Pub ContractInvocationEvent
- Pass ref to host to contract invocation hook
- Fix top contract invocation hook and auth interaction
- XDR limits updates
- Run user seeds to PRNGs through HMAC-SHA256 to unbias
- Add size_hint methods to Arbitrary impls
- Add tests for de-serializing deep XDR in deep call stack.
- Generate combinational tests for linear memory functions
- Add tests that grow containers until running out of memory budget.
- Observe more things
- Setting pre_release_version to zero in meta.rs in preparation of Soroban launch
- Add Host::has_frame
- Validated TTLentries
- Budget subsystem code review
- Rename extend host functions
- Fuzz fixes
- Cap number of args to wasm functions
- Cargo version pinning
- Pass --locked to publish as well
- Tighten up saturating_ math checks
- Auth code review
- Remove unused publish scripts/make targets
- Write tests for unrecoverable errors with try_call
- Fix the invoker contract auth rollback logic and cover it in the tests.
- Re-calibration on x86 and update cost parameters
- Add tests for invalid maps, oversized maps/vecs/bytes from various paths
- Frame code review
- Improve XDR conversion coverage
- Add more error tests
- Improve budget tracker
- Validate assets when trying to create SAC instance.
- Conversion tests
- Update stellar-xdr
- Change string_new_from_slice to use &[u8] instead of &str.
- Update stellar-xdr
- Initial SAC review
- Derive debug, eq, ord on CostTracker for SDK
- Noop auth fix
- Test bad WASMs
- Add time tracker
- Bump wasmi and xdr to release versions
- SAC final code review
- Add fuzz target that runs wasmi on wasm-smith output
- Remaining host code review
- Bump version to 20.0.0
Soroban Rust SDK
- Token events
- Update rust-version
- Update SDK to recent env
- Add admin function
- fix: use uppercase const name
- Fix allocator
- Add Arbitrary impl for Duration and Timepoint
- Fix Budget::memory_bytes_cost
- Bump env to c5607a2e9e296b2636b46dc910387aa3446b3e29
- Bump env
- Update dalek, remove non-syn2 exemptions, tighten deps
- Update map iterator to be index based
- Remove ScSpecTypeSet support, which was already mostly dead.
- Provide a way to allow non-root auth in recording mode.
- Update env version in SDK.
- Update SDK to support expiration entry rework.
- Bump env for bump interface changes
- Correct comment on String::copy_into_slice
- Add doc comments about why symbol_short!
- Add test vector for workspace setups where contract types live in a lib
- Update rust-version
- Enable build workflow for merge groups
- re-enable linux arm64 builds
- Fix/criadoperez
- Text corrections
- Update rust-version
- bump env
- Fix name of the Stellar Asset admin client
- Add git rev dep check to ci
- Remove authorized from standard token interface
- Bump env
- Adapt to removal of ConversionError from number type conversions.
- Bump version to 20.0.0-rc1
- Implement deployer functions that return the deployed contract id.
- Add Vec::to_vals
- Expose PRNG functions
- Expose secp256k1 and keccak256 in the SDK
- Upgrade env to v20.0.0-rc2
- Elaborate more in comment on PRNG strengths and weaknesses
- Bump version to 20.0.0-rc2
- More explicit PRNG-explaining comments
- Adapt to minor env changes from code review
- Adapt to recent changes in env
- docs: Fixing a broken link in the SDK's lib.rs file
- Fix typos in arbitrary docs
- Change Storage::get to pub(crate)
- Add fn to expose max expiration available
- Update rust-version
- fix(snapshot): set entry expiration info in set_ledger_info
- Add SDK support for Address/StrKey conversions.
- bump env and xdr for state exp rename
- bump env
- Feature: expose rem_euclid functions and add 128/256 bit conversions
- Fix type of signature in auth
- Add testutils for accessing all storage of a contract
- Remove spendable balance
- Fix nightly lints on unused internal exports
- Generate all types of addresses when fuzzing.
- Use deterministic randomness in arbitrary tests
- Generate arbitrary containers with heterogeneous elements
- Add SorobanArbitrary implementations for tuples.
- Update env version
- Fix docs about prng seed
- Refactor Prng functions
- Add prng generation for slices and arrays
- Make easier to add shuffle to other types
- Make Env::default and Env::from_snapshot configure the environment the same
- Arbitrary testutils
- Remove use of rand from generated addresses, nonces, salts, and issuer pks
- Replace String::from_slice with from_str
- Update soroban-env-* deps
- Encode network id as hex in ledger snapshots
- Autosave a test snapshot file on every test exit
- Allow bumping other instances
- Update env
- Make Option work with contract type
- Rename token::Interface/Client to TokenInterface/Client
- Don't write test snapshot if no thread name
- Minor tidy and organization of test snapshots
- Don't block merges on rust-analyzer compat check
- Expand Env test to check that separate tests are written for multiple Envs
- Do not record test snapshots for doc tests
- Check that no diffs exist after test run due to uncommitted test snapshots
- Add auth to Env snapshot
- Update env and xdr
- Snapshot all auths during a test not just last invokes
- Update rust-version
- Improvements to Arbitrary Options
- Hide EnvBase and other internal types
- Restore previous auth state in client
- Make try_ fns return smaller SDK error type
- Remove nextest from Makefile
- bump env
- Renamed extend host function
- Update env
- Bump version to 20.0.0
Soroban RPC
- increased preflight instruction fee padding to 3 million
- Enforce enabling diagnostics events
- Add getPreflight benchmark and test
- Add write-through cache for config ledger entries
- Cache all ledger entries queried from DB in read transaction
- simulateTransaction automatically detects ledger entries which require restoring
- Add heap profiling endpoints
- Try to return diagnostic events on failure from simulateTransaction
- Add generic panic handling
- Limit request size to 10MB
- getLedgerEntries can query multiple ledger entries at once
- Stream ledgers on initialization
- Set maximum number of keys to query for getLedgerEntries
- Add support for new state expiration ledger entries
- Ingest temp ledger entry evictions
- Lower max http request size
- Set base prng to zero in preflight and invoke
- Exclude temporary expired entries from SnapshotSource in preflight
- Include system events in fee calculation in preflight
- Get expiration ledger sequence at source
- Add a "Building from Source" README.md
- Flatten the getEvents response structure
- Enable debug by default for preflight
- Optimize in-memory transaction store
- Force On-Disk Mode
- Fix datarace in bufferedResponseWriter.WriteOut
- Fix upsert bug in DB cache
- Fix ledger entry visibility bug
- Fix unwrap() errors in libpreflight due to bugs in the Go/Rust interface
- Fix simulation sequence number for bump/restore operations
- Improve missing command line arguments message
- Fix caching of GetLatestLedgerSequence
- Ensure that the sim events are logged; improve format of main logs
- Validate xdr payloads in soroban-rpc requests
- Fix double-counting bug in preflight
- Fix potential overflow
- Fix multi-entry responses for getLedgerEntries method
- Update jrpc2 version to enable application/json; charset=utf-8
- Unify all ledger sequence types to uint32 and stop stringyfying integers < 53-bits wide
- Restore CORS support
Soroban CLI
- Allow fetching contract from network
- Each generated contract method adds -file-path
- Add two new output types for contract inspect
- Add config identity fund to fund accounts on networks
- Add Auth-next signing support
- Add dotenv so directories can now set CLI args
- Add key::Args and FullLedgerEntry/FullLedgerEntries
- Remove sandbox
- Add Assembled Transaction that handle preparing transaction post simulation
- Make aliases visible in help doc
- Fix --cost flag
- Set the exit code to 1 in case of an error
- Return an error once contract read is unable to read any entry
- Wrap token no longer fails with valid inputs in sandbox mode
- fund command now can accept a public strkey
- Warn or Error When Deploying Contracts Compiled with RC Version of Soroban SDK
- Print help if custom CLI is empty & replace unwrap where possible
- Fix various typescript bindings
- Make output consistent for all ways to get version
Preview 11 (September 11, 2023): Testnet and Futurenet Edition
Software
Software | Version |
---|---|
XDR | 9ac02641139e6717924fdad716f6e958d0168491 |
Soroban Environment | v20.0.0-rc2 |
Soroban Interface Version | 57 |
Stellar Core | 20.0.0-1504.rc2.22088c1f2.focal |
Soroban Rust SDK | v20.0.0-rc2 |
Soroban CLI | v20.0.0-rc4 |
Soroban RPC | v20.0.0-rc4 |
Stellar Horizon | 2.27.0~rc2-384 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | docker.io/stellar/quickstart:testing@sha256:0c756150e7b3c53603fe36bb932c4e7d7ceaef691906b2d3d952771ccc195559 |
Stellar JS Stellar Base | v10.0.0-beta.3 |
Stellar JS Stellar SDK | v11.0.0-beta.5 |
Stellar JS Soroban Client | v1.0.0-beta.3 (deprecated, prefer the Stellar SDK) |
Freighter | 5.6.1 |
Laboratory | 2.12.0 |
Soroban React Payment dapp | 2.0.0 |
Soroban Mint Token dapp | 2.0.0 |
Soroban Swap Token dapp | 2.0.0 |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Testnet Network Passphrase | Test SDF Network ; September 2015 |
The Soroban RPC version for Preview 11 is presently in Stellar's unstable and testing apt repositories. Additionally, its Docker image release can be accessed at docker.io/stellar/soroban-rpc:20.0.0-rc3-39.
Changelog
XDR
- Generate for entry expired error
- Bump XDR
- Generate XDR DepthLimiter and depth-limited Read/WriteXdr
- Bump XDR
- Make SCError into a union to allow user errors to be u32
- Update rust-version
- Bump XDR
- Bump XDR
- Bump XDR
- Regen to pick up ContractCostType changes
- Bump XDR
- Update to reflect removal of SCSpecTypeSet
- Bump XDR
- Take change from txSOROBAN_RESOURCE_LIMIT_EXCEEDED to txSOROBAN_INVALID
- Run CI via in merge queue
- Update rust-version
- Bump curr and next
- Bump XDR
- Bump version to 20.0.0-rc1
Soroban Environment
- Attach the auth in recording mode to any valid tracker when possible
- Make RecordedAuthPayload consistently return None for invoker
- Expiration-related fixes
- Turn dynamic borrow panics into HostErrors
- Use Ed25519 verify_strict function rather than just verify, fix #857
- Misc int32 issues
- Enforce object handle integrity when inserting into containers, fix #569
- Add testcase for out-of-order scmaps, fix #223
- Add a function to compute the rent fee
- Use host.err for auth error
- Add a smoke test for recording auth for create contract host fn
- Stop treating storage errors as missing entries
- Refactor authorization manager to only maintain mutable borrow on minimal amount of fields
- Bump xdr
- Add rent bumps to the SAC
- Add is_admin function
- Bump xdr
- Add function to compute the write fee based on the ledger size
- Prohibit using disjoint signatures to cover the auth tree
- Enforce DepthLimiter in the Host to avoid stack overflow
- Relative objects in wasm
- Adapt to ResourceLimiter, replacing mem_fuel metering
- Make del_contract_data no-op for removing non-existent instance storage key
- Add "tracy" feature to enable Tracy profiler, with some basic annotat…
- Update host to account for the XDR changes
- Update rust-version
- Adapt to SCError change to be an enum, with ContractError(u32)
- Make some host errors non-recoverable in try_call
- Fix panic-string-logging code path broken by recent dynamic-borrow fix
- Add soroban-bench-utils, add benchmark tests to measure metering accuracy
- Bump env xdr and do the fee library changes corresponding to config changes
- Bump env xdr
- Remove event topic limits
- Bump env xdr
- Unify/fix expiration bump logic in host
- Add new tests for error escalation from contract calls
- Add a helper that invokes a host function 'end-to-end'
- Add helpers for container bulk init; applies to auth metering
- Switch some auth errors from Internal to InvalidInput
- Enable post-MVP WASM ops (sign-ext and mutable-globals), fix #968
- More token tests
- Alloc example
- Mop up some residual uses of format strings in errors (no longer supported)
- Add wasm for upgrade write-bytes contract
- Scale the linear cost model coefficient; improve model fitting
- Error if bumping past max_entry_expiration and and host function to retrieve max_entry_expiration
- Make has checks to properly populate the storage map in recording mode
- Clean up budget cost types
- Add debug events to storage error reporting
- Switch to stable rust-analyzer in CI
- Add some comments and tests to env-common/symbol.rs
- Upgrade dalek crates to new stable versions
- Add an option to return an error when encountering non-root auth in recording mode
- Reject env.json if there are duplicate export names, fix #189
- Tighten signature of unchecked_visit_val_obj, fix #595
- Tighten dependencies further
- Fix incorrect argument name
- Bump env xdr
- Tighten up Map and Vector and metering coverage
- Store dummy instance for test contracts
- Update XDR to take change that removes SCSpecTypeSet
- Fix comparison in Tag::is_object
- Fix calibration due to delak change
- Charge write fees for expiration entry bumps
- Reduce the expiration entry write size
- Refactor host to support the new expiration ledger approach
- Add lifetime threshold
- Enable build workflow for merge groups
- Remove key size from rent change computation
- Take change from txSOROBAN_RESOURCE_LIMIT_EXCEEDED to txSOROBAN_INVALID
- Add ExpirationEntry support
- Add git rev dep check to ci
- Fix encode contract events metering
- Trim deps
- Reject vals with invalid tags, fix #1029
- Host: fix EXPIRATION_ENTRY_SIZE constant
- Avoid iloop externalizing diagnostics for invalid references
- Add "coverage" Makefile target for lcov.info, add a test that extends coverage
- Fix asset-code rendering in native contract
- Fix rent changes extraction bug
- Graydon code review
- Jay code review
- Bump xdr and use curr instead of next
- Trivial xdr bump
- Tighten wasm interface version checks, and do on upload, Fix #1052
- Update wasmi to 0.31.0-soroban
- Bump version to 20.0.0-rc1
Soroban Rust SDK
- Implement deployer functions that return the deployed contract id
- Add Vec::to_vals
- Expose PRNG functions
- Expose secp256k1 and keccak256 in the SDK
- Upgrade env to v20.0.0-rc2
- Elaborate more in comment on PRNG strengths and weaknesses
- Bump version to 20.0.0-rc2
- Token events
- Update rust-version
- Update SDK to recent env
- Add admin function
- fix: use uppercase const name
- Fix allocator
- Add Arbitrary impl for Duration and Timepoint
- Fix Budget::memory_bytes_cost
- Bump env to c5607a2e9e296b2636b46dc910387aa3446b3e29
- Bump env
- Update dalek, remove non-syn2 exemptions, tighten deps
- Update map iterator to be index based
- Remove ScSpecTypeSet support, which was already mostly dead
- Provide a way to allow non-root auth in recording mode
- Update env version in SDK
- Update SDK to support expiration entry rework
- Bump env for bump interface changes
- Correct comment on String::copy_into_slice
- Add doc comments about why symbol_short!
- Add test vector for workspace setups where contract types live in a lib
- Update rust-version
- Enable build workflow for merge groups
- re-enable linux arm64 builds
- Fix/criadoperez
- Text corrections
- Update rust-version
- bump env
- Fix name of the Stellar Asset admin client
- Add git rev dep check to ci
- Remove authorized from standard token interface
- Bump env
- Adapt to removal of ConversionError from number type conversions
- Bump version to 20.0.0-rc1
Soroban RPC
- List --network under RPC options
- Enforce enabling diagnostics events
- simulateTransaction will automatically detect ledger entries which require restoring
- simulateTransaction will try to return diagnostic events on failure
- getLedgerEntries can query multiple ledger entries at once
- getLedgerEntries can set the maximum number of keys to query for
- Temporary ledger entry evictions are ingested
- Support StrKey format for contractIds field in getEvents request
- Limit the execution duration of the jrpc requests
- Performance fixes and improvements: add writethrough cache for config ledger entries and cache DB results better
- Fix ledgerentry visibility bug
- Fix simulation sequence number for bump/restore operations
- Improve missing command line arguments message
- Add missing config settings in ledger entry cache on reads
- Fix caching of GetLatestLedgerSequence
- Limit request size to 10MB
- Limit number of concurrent requests
- Improve HTTPRequestDurationLimiter by adding a recover handling
- Stream ledgers on initialization
- Increase instruction leeway to 20% in transaction simulation
- Validate xdr payloads in soroban-rpc requests
- Fix double-counting bug
- Fix datarace in bufferedResponseWriter.WriteOut
- Fix set_authorization_entries bug in transaction simulation
- Restore CORS support
Soroban CLI
- Add multi-party authorization + signing support
- Add two new output types for contract inspect
- Add config identity fund to fund accounts on networks
- Add restore/bump support with --wash_hash
- Allow passing true and false to boolean types
- Each generated contract method adds
<contract-arg>-file-path
- Add dotenv so directories can now set CLI args
- Generated TypeScript bindings have significantly improved
- Make Wallet injectable
- Correct generated README
- Allow fetching contract from network
- Removed --contract-name, added --overwrite
- Require configuring network settings
- Leveraging the latest soroban-client (v1.0.0-beta)
- Make aliases visible in help doc
- Ensure that the sim events are logged; improve format of main logs
- Fix --cost flag
- Set the exit code to 1 in case of an error
- Return an error once contract read is unable to read any entry
- wrap token no longer fails with valid inputs in sandbox mode
Preview 10 (July 13, 2023)
Software
Software | Version |
---|---|
XDR | e372df9f677961aac04c5a4cc80a3667f310b29f |
Soroban Environment | v0.0.17 |
Soroban Interface Version | 51 |
Stellar Core | 19.12.1-1406.b7d3a8f8d.focal~soroban |
Soroban Rust SDK | v0.9.2 |
Soroban CLI | v0.9.1 |
Soroban RPC | v0.9.2 |
Stellar Horizon | stellar-horizon:2.26.1~soroban-373 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:8a99332f834ca82e3ac1418143736af59b5288e792d1c4278d6c547c6ed8da3b |
Stellar JS Stellar Base | 10.0.0-soroban.3 |
Stellar JS Soroban Client | 0.9.2 |
Freighter | 5.2.3 |
Laboratory | 2.11.0 |
Soroban React Payment dapp | 1.1.0 |
Soroban Mint Token dapp | 1.1.0 |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Changelog
XDR
- Remove TransactionResultV2
- Regenerate for overhaul of error codes
- Bump xdr
- Bump XDR
- Update for state-expiration XDR changes
- Update rust-version
- Bump XDR
- Regenerate for new crypto cost types
- Bump XDR
- Bump op
- Generate for storage type removal
- Drop ContractCostType::VerifyEcdsaSecp256k1Sig
- Update next to pickup int256 cost types
- Regenerate rename
- Regenerate for typo
- Bump xdr with contract instance storage changes
- Regenerate for removal of ScVal::StorageType
- Regenerate for RestoreFootprintOp
- Generate rename
- Update crate-git-revision
Soroban Environment
- Move a bunch of code out of host, reorg modules slightly.
- Remove temp storage, fixes #758
- Bump xdr
- Anti features
- Err reform
- Some further cleanups to diagnostic events
- Bump xdr
- Enforce AUTH_REVOCABLE on contract balances
- Implement PRNG subsystem (round 2)
- Remove incorrect debug_assert from ed25519_pub_key_from_bytes
- Support Auth Next for host fns
- Bump xdr
- Update rust-version
- Switch to wasmi native fuel metering
- Fix get_authenticated_authorizations test utility.
- Change authentication contract errors to be auth errors.
- Improve VmInstantiation calibration
- Update storage interface for state expiration
- Update README.md
- Implement contract expiration bumps
- Calibrate wasmi fuel and tiered wasm instructions
- Bump env XDR
- Implement
TryFrom<&Error>
for ScVal - Provide host function for authorizing deep contract calls from current contract
- Switch auth from autoincrement nonces to temporary random values.
- Fix metering for internal events
- Return strings for name/symbol and use strkey for issuer.
- Remove Mergeable and rename Exclusive to Persistent
- Add secp256k1 and keccak256 host functions
- Add host functions for returning contract ids
- Fix comparisons
- Rename rawval to val
- Enforce readonly footprint on bump
- Add host functions for
{u,i}256
arithmetics - More raw to val
- Support Timepoint, Duration
- Bump xdr
- Check map order when rebuilding from exact iter
- Updates for contract instance related XDR changes.
- Change StorageType to Just Be An Enum
- Bump xdr for RestoreFootprintOp
- Bump xdr for rename
- Add host function for bumping contract instance
- Implement contract instance storage in Soroban host.
- Change
[IU]256
arithmetic host functions to take *Val not *Object. - Replace increase and decrease functions with approve
- Expose bumps
- Fix calibration tests
- Change
[IU]256
[from,to]_bytes
functions to work with Val - Bump wasmi version
Soroban Rust SDK
- Fix storage comment
- Noop in instance bump for tests
Soroban RPC
- Update js-soroban-client dependency from 0.9.0 to 0.9.1
Soroban CLI
- Update js-soroban-client dependency from 0.9.0 to 0.9.1
Preview 9 (May 24th, 2023)
Software
Software | Version |
---|---|
XDR | 2f16687fdf6f4bcfb56805e2035f69997f4b34c4 |
Soroban Environment | v0.0.16 |
Soroban Interface Version | 37 |
Stellar Core | 19.10.1-1310.6649f5173.focal~soroban |
Soroban Rust SDK | v0.8.4 |
Soroban CLI | v0.8.0 |
Soroban RPC | v0.8.0 |
Stellar Horizon | stellar-horizon:2.25.1~soroban-346 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:57e8ab498bfa14c65595fbb01cb94b1cdee9637ef2e6634e59d54f6958c05bdb |
Stellar JS Stellar Base | 9.0.0-soroban.1 |
Stellar JS Soroban Client | 0.7.0 |
Freighter | 5.0.1 |
Laboratory | 2.10.0 |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Changelog
XDR
See https://github.com/stellar/rs-stellar-xdr/releases v0.0.16 for more details.
Soroban Environment
See https://github.com/stellar/rs-soroban-env/releases v0.0.16 for more details.
Soroban Rust SDK
See https://github.com/stellar/rs-soroban-sdk/releases v0.8.4 for more details.
Soroban RPC
See https://github.com/stellar/soroban-tools/releases v0.8.0 for more details.
Soroban CLI
See https://github.com/stellar/soroban-tools/releases v0.8.0 for more details.
Preview 8 (April 4th, 2023)
Software
Software | Version |
---|---|
XDR | 7356dc237ee0db5626561c129fb3fa4beaabbac6 |
Soroban Environment | v0.0.15 |
Soroban Interface Version | 32 |
Stellar Core | 19.8.1-1246.064a2787a.focal~soroban |
Soroban Rust SDK | v0.7.0 |
Soroban CLI | v0.7.0 |
Soroban RPC | v0.7.0 |
Stellar Horizon | stellar-horizon:2.24.62~soroban-338 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:a057ec6f06c6702c005693f8265ed1261e901b153a754e97cf18b0962257e872 |
Stellar JS Stellar Base | 8.2.2-soroban.12 |
Stellar JS Soroban Client | v0.5.0 |
Freighter | v2.12.2 |
Laboratory | v2.8.0 |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Breaking changes note
This release includes a major overhaul of the value representation at the XDR level, which potentially breaks contracts that rely on the old type definitions, here is a summary of the changes:
- Removed the object/value split at the XDR level
- Expanded size of value tag from 8 to 128 cases
- Removed types:
U63
,Static
,Bitset
- Added
U256
,I256
and special case u64 subtypesTimepoint
andDuration
- Added
String
which is aBytes
-like object but displays as text - Enhanced
Symbol
to have a maximum size of 32 bytes (no more 10-char limit)
SDK support has also been added/updated for these types. See xdr, env and sdk changes for more details.
Changelog
XDR
- Make types wrapping Strings no longer aliases
- Value representation overhaul
- Diagnostic events
See https://github.com/stellar/rs-stellar-xdr/releases v0.0.15 for more details.
Soroban Environment
- Remove the unnecessary error events that appeared in non-error scenarios.
- Reform metering for value cloning and memory allocation.
- Provide more test coverage for Auth Next.
- Check issuer clawback flag when new contract balance is created.
- Add a test that covers out-of-order require_auth calls.
- Token name in events.
- Adapt Storage and SnapshotSource to use Rc only.
- Add host functions to convert addresses to/from account/contract ids.
- Value and object representation overhaul.
- Move InvokerType from common env to internal host implementation.
- fix thinko in vec_new_from_linear_memory.
- Improve safety of custom account contracts.
- Split out DeclaredSizeForMetering from MeteredClone and use it for Compare.
- Structured debug events.
- Fix an i128 conversion bug.
- Use new bulk memory ops for tuples.
- Host budget metering, cost model, calibration changes.
- Increase memory budget to 50MB.
See https://github.com/stellar/rs-soroban-env/releases v0.0.15 for more details.
Soroban Rust SDK
- Add docs in specs for types.
- Rename Serialize/Deserialize to To/FromXdr.
- Use the updated source_account() interface.
- Update storage docs.
- Expose reset budget functions to testutils.
- Adapt storage and snapshot interface to env changes.
- Add utils for converting from/to contract/account ids.
- Value and object representation overhaul.
- Add a getter for address of a generated contract client.
- Use String for log_fmt_values.
- Add a utility to call __check_auth in tests.
- Add more support for the new types in soroban-spec.
- Use vector bulk-init in Vec.
- Bump env and update for event changes.
- fix(macro): add new XDR types to parser.
- Update budget test.
- bump env and update budget print.
See https://github.com/stellar/rs-soroban-sdk/releases v0.7.0 for more details.
Soroban RPC
- Set a maximum ledger latency in /health method.
- Add resultMetaXdr and envelopeXdr back to getTransaction() response.
- Support for new
diagnostic
contract events.- soroban-rpc: Add filtering support for diagnostic events.
- soroban-rpc: Ingest diagnostic events.
- Remove 'soroban serve' subcommand.
- Limit preflight-computation concurrency through a worker pool.
- Miscellaneous fixes.
- General improvements to compilation and testing.
- Add contract events to simulateTransaction's response.
See https://github.com/stellar/soroban-tools/releases v0.7.0 for more details.
Soroban CLI
- Improved documentation, and
--help
text- feat: auto-generate comprehensive CLI docs.
- When using
invoke
, contract function names now come after the--
, likesoroban invoke --id <contract_id> -- hello --to "world"
- Improvements to identity management
- fix: allow using ENV to add identity and pass secret.
- Replaced
--identity
,--secret-key
, and--account
flags. Replace with single--source
, which understands identities, and secret keys. - feat: add better docs for UDT and add examples for each arg.
- Added
soroban --version
- Better errors, replacing
Unknown
- Refactor, so that the cli can be imported via the new
soroban-test
crate. This makes testing and using soroban-cli as a library easier.- feat: reorg into a proper library.
- feat: add new soroban-test crate.
- Update to Clap v4.
- fix(CLI): string/u/i256 XDR parsing.
- Support for new
diagnostic
type events
See https://github.com/stellar/soroban-tools/releases v0.7.0 for more details.
Preview 7 (February 16th, 2023)
Software
Software | Version |
---|---|
XDR | df18148747e807618acf4639db41c4fd6f0be9fc |
Soroban Environment | v0.0.14 |
Soroban Interface Version | 29 |
Stellar Core | 19.7.1-1204.871accefc.focal~soroban |
Soroban Rust SDK | v0.6.0 |
Soroban CLI | v0.6.0 |
Soroban RPC | 0.6.1-13 |
Stellar Horizon | stellar-horizon:2.24.61~soroban-335 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:81c23da078c90d0ba220f8fc93414d0ea44608adc616988930529c58df278739 |
Stellar JS Stellar Base | 8.2.2-soroban.11 |
Stellar JS Soroban Client | v0.4.0 |
Freighter | v2.10.0 |
Laboratory | v2.7.0 |
Futurenet Network Passphrase | Test 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. 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
Software | Version |
---|---|
XDR | 026c9cd074bdb28ddde8ee52f2a4502d9e518a09 |
Soroban Environment | v0.0.12 |
Soroban Interface Version | 27 |
Stellar Core | 19.6.1-1158.c0ad35aa1.focal~soroban |
Soroban Rust SDK | v0.4.2 |
Soroban CLI | v0.5.0 |
Soroban RPC | 0.4.0-10 |
Stellar Horizon | stellar-horizon:2.22.0~soroban-323 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart (amd64) | stellar/quickstart:soroban-dev@sha256:c4429def497ed78ca99ae40c8e2522ec932081b4428df992900b5bc8d53bd642 |
Stellar Quickstart (arm64) | stellar/quickstart:soroban-dev@sha256:37205510329845f5fe533bb7c4c182d8f35b3a3515f0a6729889067663e1ec97 |
Stellar JS Stellar Base | 8.0.1-soroban.6 |
Stellar JS Soroban Client | v0.3.0 |
Futurenet Network Passphrase | Test SDF Future Network ; October 2022 |
Changelog
Soroban Environment
- Wasm instruction level calibration
- Replace
im
containers withVec
- 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
Software | Version |
---|---|
XDR | 026c9cd074bdb28ddde8ee52f2a4502d9e518a09 |
Soroban Environment | v0.0.11 |
Soroban Interface Version | 26 |
Stellar Core | stellar-core_19.5.1-1137.b3a6bc281.focal~soroban |
Soroban Rust SDK | v0.3.2 |
Soroban CLI | v0.3.3 |
Soroban RPC | 0.3.1-32 |
Stellar Horizon | stellar-horizon:2.22.0~soroban-318 |
Stellar Friendbot | soroban-v0.0.2-alpha |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:8046391718f8e58b2b88b9c379abda3587bb874689fa09b2ed4871a764ebda27 |
Stellar JS Stellar Base | 8.0.1-soroban.5 |
Stellar JS Soroban Client | v0.2.0 |
Futurenet Network Passphrase | Test 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 assoroban 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
Software | Version |
---|---|
XDR | https://github.com/stellar/stellar-xdr-next/tree/48d5e17ae63bba0aa9725cd9d18d7438f44c07b1 |
Soroban Environment | v0.0.9 |
Soroban Interface Version | 23 |
Stellar Core | 19.5.1-1111.eba1d3de9.focal~soroban |
Soroban Rust SDK | v0.2.1 |
Soroban CLI | v0.2.1 |
Soroban RPC | 0.3.1-32 |
Stellar Horizon | 2.22.0~soroban-304 |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:0993d3350148af6ffeab5dc8f0b835236b28dade6dcae77ff8a09317162f768d |
Futurenet Network Passphrase | Test 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
Software | Version |
---|---|
XDR | https://github.com/stellar/stellar-xdr-next/tree/161e2e5b64425a49f9ccfef7f732ae742ed5eec4 |
Soroban Environment | v0.0.6 |
Soroban Interface Version | 23 |
Stellar Core | 19.4.1-1097.4e813f20e.focal~soroban |
Soroban Rust SDK | v0.1.1 |
Soroban CLI | v0.1.2 |
Soroban RPC | ??? |
Stellar Horizon | 2.22.0~soroban-304 |
Stellar Quickstart | stellar/quickstart:soroban-dev@sha256:e58d83f92a61f43406087f488dd1cba110a92646dca85f14b3a416163609e853 |
Futurenet Network Passphrase | Test 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.