Add v20.0.0 (#668)

* add P12 Release * formatting * Update releases.mdx * formatting * update horizon,stellar-base,cli * add stellar sdk + base, soroban-client, Quickstart, changelog * remove http from quickstart endpoint * v20.0.0-rc2 -> v20.0.0 * Preview 12 -> Stable v20.0.0 * update CLI, RPC, Core Versions * update stellar cor version * Content updates to go along with the preview 12 version updates (#682) * update the token interface to reflect the Rust SDK * feat: get Getting Started ready for v20.0.x I don't know what the exact version of the CLI will be out by next Monday. In the source here, I've guessed that maybe it will be `20.0.3`. * update `openrpc.json` file to reflect new updates * Update static/openrpc.json Co-authored-by: Alfonso Acosta <[email protected]> --------- Co-authored-by: Chad Ostrowski <[email protected]> Co-authored-by: Molly Karcher <[email protected]> Co-authored-by: Alfonso Acosta <[email protected]> * Update token-interface.mdx * nit:formatting --------- Co-authored-by: Elliot Voris <[email protected]> Co-authored-by: Chad Ostrowski <[email protected]> Co-authored-by: Molly Karcher <[email protected]> Co-authored-by: Alfonso Acosta <[email protected]>
stellar-deprecated · Dec 18, 2023 · 7e27560 · 7e27560
1 parent c3f18dc
commit 7e27560
Show file tree

Hide file tree

Showing 31 changed files with 602 additions and 165 deletions.
diff --git a/dapps/dapp-challenges/challenge-1-payment.mdx b/dapps/dapp-challenges/challenge-1-payment.mdx
@@ -73,7 +73,7 @@ yarn
 
 ## Checkpoint 2: 🎬 Deploy Smart Contracts
 
-For this step you will need to clone and deploy the Soroban token smart contract from the [Soroban Examples repository](https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/token). This Soroban token smart contract, broken into several smaller modules (as is the custom for complex smart contracts like this one), enables you to create and manage tokens on Soroban.
+For this step you will need to clone and deploy the Soroban token smart contract from the [Soroban Examples repository](https://github.com/stellar/soroban-examples/tree/v20.0.0/token). This Soroban token smart contract, broken into several smaller modules (as is the custom for complex smart contracts like this one), enables you to create and manage tokens on Soroban.
 
 The Soroban token is a custom token that will be used to facilitate payments in the Payment Dapp. Tokens are essentially programmable assets on a blockchain, and smart contracts provide the automation and rules for these tokens. They allow for predefined conditions and actions related to the tokens, such as issuance, transfer, and more complex functions, ensuring the execution of these operations without the need for intermediaries. In the case of this Payment Dapp, you will use the Soroban token to initialize and mint "Demo Token" assets, or DT, that you can then use to make payments via the Payment Dapp.
 

diff --git a/docs/TUTORIAL-TEMPLATE.mdx b/docs/TUTORIAL-TEMPLATE.mdx
@@ -16,17 +16,17 @@ Place each link definition at the bottom of the section it (first) is used In
 
 :::
 
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
-[example demonstrates]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/hello_world
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
+[example demonstrates]: https://github.com/stellar/soroban-examples/tree/v20.0.0/hello_world
 [other example]: getting-started/
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 ```bash
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in
@@ -67,7 +67,7 @@ impl HelloContract {
 mod test;
 ```
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/hello_world
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/hello_world
 
 ## How it Works
 

diff --git a/docs/advanced-tutorials/atomic-multi-swap.mdx b/docs/advanced-tutorials/atomic-multi-swap.mdx
@@ -28,6 +28,6 @@ Follow the comments in the code for more information.
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
 
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 [Atomic Swap]: atomic-swap.mdx
-[atomic swap batching example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/atomic_multiswap
+[atomic swap batching example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/atomic_multiswap
diff --git a/docs/advanced-tutorials/atomic-swap.mdx b/docs/advanced-tutorials/atomic-swap.mdx
@@ -30,18 +30,18 @@ Soroban token usage.
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
 
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
-[atomic swap example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/atomic_swap
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
+[atomic swap example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/atomic_swap
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 [Setup]: ../getting-started/setup.mdx
 
 ```
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in [Gitpod][oigp].
@@ -131,7 +131,7 @@ fn move_token(
 }
 ```
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/atomic_swap
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/atomic_swap
 
 ## How it Works
 
@@ -208,7 +208,7 @@ contract invocation.
 
 Open the [`atomic_swap/src/test.rs`] file to follow along.
 
-[`atomic_swap/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/atomic_swap/src/test.rs
+[`atomic_swap/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/atomic_swap/src/test.rs
 
 Refer to another examples for the general information on the test setup.
 

diff --git a/docs/advanced-tutorials/custom-account.mdx b/docs/advanced-tutorials/custom-account.mdx
@@ -50,19 +50,19 @@ development.
 :::
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
-[custom account example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/account
+[custom account example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/account
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 [Setup]: ../getting-started/setup.mdx
 
 ```
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in [Gitpod][oigp].
@@ -320,7 +320,7 @@ function we don't exceed the spending limits.
 
 Open the [`account/src/test.rs`] file to follow along.
 
-[`account/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/account/src/test.rs
+[`account/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/account/src/test.rs
 
 Refer to another examples for the general information on the test setup.
 

diff --git a/docs/advanced-tutorials/fuzzing.mdx b/docs/advanced-tutorials/fuzzing.mdx
@@ -25,24 +25,24 @@ with the [`proptest`] and [`proptest-arbitrary-interop`] crates. It builds on
 the [timelock example].
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
-[fuzzing example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing
+[fuzzing example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing
 [`cargo-fuzz`]: https://docs.rs/cargo-fuzz
 [`arbitrary`]: https://docs.rs/arbitrary
 [`proptest`]: https://docs.rs/proptest
 [`proptest-arbitrary-interop`]: https://docs.rs/proptest-arbitrary-interop
-[timelock example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/timelock
+[timelock example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/timelock
 
 ## Run the Example
 
 First go through the [setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 [setup]: ../getting-started/setup.mdx
 
 ```bash
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 You will also need the `cargo-fuzz` tool, and to run `cargo-fuzz` you will need
@@ -142,7 +142,7 @@ fuzzing.
 The example used for this tutorial is based on the [`timelock`] example program,
 with some changes to demonstrate fuzzing.
 
-[`timelock`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/timelock
+[`timelock`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/timelock
 
 The contract, `ClaimableBalanceContract`, allows one party to deposit an
 arbitrary quantity of a token to the contract, specifying additionally: the
@@ -225,8 +225,8 @@ Our `soroban-examples/fuzzing` directory looks like
 There are special considerations to note in the configuration of both the
 [contract's manifest] and the [fuzzing crate's manifest].
 
-[contract's manifest]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing/Cargo.toml
-[fuzzing crate's manifest]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing/fuzz/Cargo.toml
+[contract's manifest]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing/Cargo.toml
+[fuzzing crate's manifest]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing/fuzz/Cargo.toml
 
 Within the contract's manifest one must specificy the crate type as both
 "cdylib" and "rlib":
@@ -297,7 +297,7 @@ features = ["testutils"]
 First let's look at [`fuzz_target_1.rs`]. This fuzz test does two things: it
 first deposits an arbitrary amount, then it claims an arbitrary amount.
 
-[`fuzz_target_1.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing/fuzz/fuzz_targets/fuzz_target_1.rs
+[`fuzz_target_1.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing/fuzz/fuzz_targets/fuzz_target_1.rs
 
 Again, you can run this fuzzer from the `soroban-examples/fuzzing` directory
 with the following command:
@@ -777,7 +777,7 @@ turn that feature on.
 The [`fuzz_target_2.rs`] example, demonstrates the use of `SorobanArbitrary`,
 the advancement of time, and more advanced fuzzing techniques.
 
-[`fuzz_target_2.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing/fuzz/fuzz_targets/fuzz_target_2.rs
+[`fuzz_target_2.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing/fuzz/fuzz_targets/fuzz_target_2.rs
 
 This fuzz test takes a much more complex input, where some of the values are
 user-defined types exported from the contract under test. This test is
@@ -945,4 +945,4 @@ convert fuzz tests to property tests to help prevent regressions.
 The [`proptest.rs`] file is a translation of `fuzz_target_1.rs` to a property
 test.
 
-[`proptest.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/fuzzing/src/proptest.rs
+[`proptest.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/fuzzing/src/proptest.rs
diff --git a/docs/advanced-tutorials/liquidity-pool.mdx b/docs/advanced-tutorials/liquidity-pool.mdx
@@ -50,17 +50,17 @@ here.](https://developers.stellar.org/docs/encyclopedia/liquidity-on-stellar-sde
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
 
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
-[liquidity pool example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/liquidity_pool
-[source code]: https://github.com/stellar/soroban-examples/blob/v20.0.0-rc2/liquidity_pool/src/lib.rs#L143
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
+[liquidity pool example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/liquidity_pool
+[source code]: https://github.com/stellar/soroban-examples/blob/v20.0.0/liquidity_pool/src/lib.rs#L143
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 ```bash
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in
@@ -473,7 +473,7 @@ pub fn create_contract(
 </TabItem>
 </Tabs>
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/liquidity_pool
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/liquidity_pool
 
 ## How it Works
 
@@ -911,7 +911,7 @@ fn test() {
 }
 ```
 
-[`liquidity_pool/src/test.rs`]: https://github.com/stellar/soroban-examples/blob/v20.0.0-rc2/liquidity_pool/src/test.rs
+[`liquidity_pool/src/test.rs`]: https://github.com/stellar/soroban-examples/blob/v20.0.0/liquidity_pool/src/test.rs
 
 In any test the first thing that is always required is an `Env`, which is the
 Soroban environment that the contract will run in.

diff --git a/docs/advanced-tutorials/single-offer-sale.mdx b/docs/advanced-tutorials/single-offer-sale.mdx
@@ -28,7 +28,7 @@ a seller to set up an offer to sell token A for token B to multiple buyers. The
 comments in the [source code] explain how the contract should be used.
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
-[single offer sale example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/single_offer
-[source code]: https://github.com/stellar/soroban-examples/blob/v20.0.0-rc2/single_offer/src/lib.rs
+[single offer sale example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/single_offer
+[source code]: https://github.com/stellar/soroban-examples/blob/v20.0.0/single_offer/src/lib.rs
diff --git a/docs/advanced-tutorials/stellar-asset-contract.mdx b/docs/advanced-tutorials/stellar-asset-contract.mdx
@@ -198,4 +198,4 @@ implementation.
 This interface can be found in the [SDK]. It extends the common
 [token interface](tokens.mdx).
 
-[SDK]: https://github.com/stellar/rs-soroban-sdk/blob/v20.0.0-rc2/soroban-sdk/src/token.rs
+[SDK]: https://github.com/stellar/rs-soroban-sdk/blob/v20.0.0/soroban-sdk/src/token.rs
diff --git a/docs/advanced-tutorials/timelock.mdx b/docs/advanced-tutorials/timelock.mdx
@@ -26,10 +26,10 @@ greatly simplified claimable balance similar to the [claimable balance] feature
 available on Stellar.
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
 The contract accepts deposits of an amount of a token, and allows other users
 to claim it before or after a time point.
 
-[timelock example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/timelock
+[timelock example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/timelock
 [claimable balance]: https://developers.stellar.org/docs/glossary/claimable-balance
diff --git a/docs/advanced-tutorials/tokens.mdx b/docs/advanced-tutorials/tokens.mdx
@@ -26,17 +26,17 @@ the [Token Interface].
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
 
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
-[token example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/token
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
+[token example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/token
 [Token Interface]: ../reference/interfaces/token-interface.mdx
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 ```bash
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in
@@ -530,7 +530,7 @@ pub enum DataKey {
 </TabItem>
 </Tabs>
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/token
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/token
 
 ## How it Works
 

diff --git a/docs/basic-tutorials/alloc.mdx b/docs/basic-tutorials/alloc.mdx
@@ -23,21 +23,21 @@ description: Use the allocator feature in a smart contract.
 
 The [allocator example] demonstrates how to utilize the allocator feature when writing a contract.
 
-[allocator example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/alloc
+[allocator example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/alloc
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
 The `soroban-sdk` crate provides a lightweight bump-pointer allocator which can be used to emulate heap memory allocation in a Wasm smart contract.
 
 ## Run the Example
 
-First go through the [Setup] process to get your development environment configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+First go through the [Setup] process to get your development environment configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 [setup]: ../getting-started/setup.mdx
 
 ```
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in [Gitpod][oigp].
@@ -96,7 +96,7 @@ impl AllocContract {
 }
 ```
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/alloc
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/alloc
 
 ## How it Works
 

diff --git a/docs/basic-tutorials/auth.mdx b/docs/basic-tutorials/auth.mdx
@@ -27,20 +27,20 @@ authorization using the Soroban Host-managed auth framework.
 This example is an extension of the [storing data example].
 
 [![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)][oigp]
-[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2
+[oigp]: https://gitpod.io/#https://github.com/stellar/soroban-examples/tree/v20.0.0
 
 [storing data example]: ../getting-started/storing-data.mdx
-[auth example]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/auth
+[auth example]: https://github.com/stellar/soroban-examples/tree/v20.0.0/auth
 
 ## Run the Example
 
 First go through the [Setup] process to get your development environment
-configured, then clone the `v20.0.0-rc2` tag of `soroban-examples` repository:
+configured, then clone the `v20.0.0` tag of `soroban-examples` repository:
 
 [Setup]: ../getting-started/setup.mdx
 
 ```
-git clone -b v20.0.0-rc2 https://github.com/stellar/soroban-examples
+git clone -b v20.0.0 https://github.com/stellar/soroban-examples
 ```
 
 Or, skip the development environment setup and open this example in [Gitpod][oigp].
@@ -113,7 +113,7 @@ impl IncrementContract {
 }
 ```
 
-Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/auth
+Ref: https://github.com/stellar/soroban-examples/tree/v20.0.0/auth
 
 ## How it Works
 
@@ -188,7 +188,7 @@ user.require_auth_for_args((value,).into_val(&env));
 
 Open the [`auth/src/test.rs`] file to follow along.
 
-[`auth/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0-rc2/auth/src/test.rs
+[`auth/src/test.rs`]: https://github.com/stellar/soroban-examples/tree/v20.0.0/auth/src/test.rs
 
 ```rust title="auth/src/test.rs"
 fn test() {