Update Futurenet to Testnet Across Documentation (#577)

* Futurenet -> Testnet

* fix broken links

* update-rpc-page

* Update testnet.mdx

* Pass 1

* format

* update table in testnet.mdx

* update state expiration example script to use testnet

* replacing futurenet with testnet in contract deployment example

* revert SDC contnet

* include testnet network passphrase on releases page

* update freighter to include testnet alongside futurenet

* revert SDC to Use Futurenet for the time being

* style: fix up markdown syntax and style in `rpc.mdx`

Also adds some small linguistic and grammer changes, as well as more
updates from Futurenet to Testnet

* docs: include Testnet when describing what RPC servers SDF maintains

* style: changing a single ellipsis character with three periods

* docs: include gh repo links to the software that runs in quickstart

* add the Testnet network to the example `initialize.sh` script

* change contract-invoking transaction example code to use Testnet

* change to valid futurenet URLs in dapp challenges

* Apply suggestions from code review

minor tweaks that slipped through the cracks

---------

Co-authored-by: Elliot Voris <[email protected]>

api/methods/getLedgerEntries.mdx

@@ -390,4 +390,4 @@ And the response we get contains (even more) `LedgerEntryData` that we can decod
 ```
 
 [`increment` example contract]: /docs/getting-started/storing-data
-["View XDR" page of the Stellar Laboratory]: <https://laboratory.stellar.org/#xdr-viewer?type=LedgerEntryData&network=futurenet>
+["View XDR" page of the Stellar Laboratory]: <https://laboratory.stellar.org/#xdr-viewer?type=LedgerEntryData&network=testnet>

api/methods/getNetwork.mdx

@@ -30,8 +30,8 @@ General info about the currently configured network.
   "jsonrpc": "2.0",
   "id": 8675309,
   "result": {
-    "friendbotUrl": "https://friendbot-futurenet.stellar.org/",
-    "passphrase": "Test SDF Future Network ; October 2022",
+    "friendbotUrl": "https://friendbot.stellar.org/",
+    "passphrase": "Test SDF Network ; September 2015",
     "protocolVersion": "20"
   }
 }

dapps/dapp-challenges/challenge-1-payment.mdx

@@ -267,7 +267,7 @@ Once the deployment is complete, you should see something similar to the followi
 
 You can now visit the preview link to see your deployed dapp! 🎉
 
-You will need to add some Futurenet network lumens to your Freighter wallet to interact with the deployed dapp. Visit [https://laboratory.stellar.org/#create-account](https://laboratory.stellar.org/#create-account), and follow the instructions to create your Freighter account on Futurenet.7
+You will need to add some Futurenet network lumens to your Freighter wallet to interact with the deployed dapp. Visit [https://laboratory.stellar.org/#create-account](https://laboratory.stellar.org/#create-account), and follow the instructions to create your Freighter account on Futurenet.
 
 ## Checkpoint 7: ✅ Complete the Challenge!
 

dapps/guides/initialization.mdx

@@ -115,21 +115,27 @@ else
   SOROBAN_RPC_HOST="http://localhost:8000"
 fi
 
-SOROBAN_RPC_URL="https://rpc-futurenet.stellar.org"
-
 case "$1" in
 standalone)
   echo "Using standalone network"
   SOROBAN_NETWORK_PASSPHRASE="Standalone Network ; February 2017"
   FRIENDBOT_URL="$SOROBAN_RPC_HOST/friendbot"
+  SOROBAN_RPC_URL="$SOROBAN_RPC_HOST/soroban/rpc"
   ;;
 futurenet)
   echo "Using Futurenet network"
   SOROBAN_NETWORK_PASSPHRASE="Test SDF Future Network ; October 2022"
   FRIENDBOT_URL="https://friendbot-futurenet.stellar.org/"
+  SOROBAN_RPC_URL="https://rpc-futurenet.stellar.org"
+  ;;
+testnet)
+  echo "Using Testnet network"
+  SOROBAN_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
+  FRIENDBOT_URL="https://friendbot.stellar.org/"
+  SOROBAN_RPC_URL="https://soroban-testnet.stellar.org"
   ;;
 *)
-  echo "Usage: $0 standalone|futurenet"
+  echo "Usage: $0 standalone|futurenet|testnet"
   exit 1
   ;;
 esac

dapps/guides/react.mdx

@@ -10,7 +10,7 @@ Below is a list of the libraries used throughout the frontend code and their res
 
 ```jsx
 import { SorobanReactProvider } from "@soroban-react/core";
-import { futurenet, sandbox, standalone } from "@soroban-react/chains";
+import { testnet, sandbox, standalone } from "@soroban-react/chains";
 import { freighter } from "@soroban-react/freighter";
 import { ChainMetadata, Connector } from "@soroban-react/types";
 import type {

dapps/index.mdx

@@ -13,7 +13,7 @@ This course operates within the pre-release version of Soroban. Expect breaking
 
 While the course specifically focuses on the Soroban platform, the knowledge you gain can be applied to other transaction processors such as different blockchains, L2s, and permissioned ledgers. The skills you acquire here are meant to be transferable and versatile.
 
-Through The Soroban Dapps Challenge, you'll have hands-on experience using Soroban's initial versions of the smart contracts environment, a Rust SDK, a CLI, and an RPC server. You'll learn how to write, test, and deploy smart contracts, and you'll get to see your code in action on our special test network, Futurenet.
+Through The Soroban Dapps Challenge, you'll have hands-on experience using Soroban's initial versions of the smart contracts environment, a Rust SDK, a CLI, and an RPC server. You'll learn how to write, test, and deploy smart contracts, and you'll get to see your code in action on Futurenet.
 
 # What this course entails
 

docs/advanced-tutorials/liquidity-pool.mdx

@@ -533,7 +533,7 @@ fn initialize(e: Env, token_wasm_hash: BytesN<32>, taken_a: Address, token_b: Ad
 [creating its own `POOL` token]: #creating-a-custom-token-for-lp-shares
 [interacting with contracts for `token_a` and `token_b`]: #token-transfers-tofrom-the-lp-contract
 [`token` example contract]: ./tokens
-[installed]: ../getting-started/deploy-to-futurenet#two-step-deployment
+[installed]: ../getting-started/deploy-to-testnet#two-step-deployment
 [lexicographical order]: https://developers.stellar.org/docs/encyclopedia/liquidity-on-stellar-sdex-liquidity-pools#liquidity-pool-participation
 
 ### A "Constant Product" Liquidity Pool

docs/basic-tutorials/deployer.mdx

@@ -133,7 +133,7 @@ as well.
 
 See the [tests](#tests) for an example of uploading the contract code
 programmatically. For the actual on-chain installation see the general deployment
-[tutorial](https://soroban.stellar.org/docs/getting-started/deploy-to-futurenet).
+[tutorial](https://soroban.stellar.org/docs/getting-started/deploy-to-testnet).
 
 ### Authorization
 

docs/fundamentals-and-concepts/fees-and-metering.mdx

@@ -60,7 +60,7 @@ The implementation details for fee computation are provided by the following [li
 
 The best way to find the required fees for any Soroban transaction is to use the transaction simulation with [preflight service](./interacting-with-contracts.mdx#preflight).
 
-The fee rates are currently defined for the Futurenet as follows:
+The fee rates are currently defined for the Testnet as follows:
 
 | Description                       | Cost (stroops)       |
 | --------------------------------- | -------------------- |
@@ -77,7 +77,7 @@ The fee rates are currently defined for the Futurenet as follows:
 | Temp entry rent coefficient       | 10 months in ledgers |
 | Persistent entry rent coefficient | 1 month in ledgers   |
 
-Note, that write fees grow linearly from empty ledger to 2 GB (ledger "target size"), and then grow linearly, but with a 1000x factor after exceeding the target. This is to bound the ledger size growth. As Futurenet is a small, test network, the target size is set to just 2 GB.
+Note, that write fees grow linearly from empty ledger to 2 GB (ledger "target size"), and then grow linearly, but with a 1000x factor after exceeding the target. This is to bound the ledger size growth. As Testnet is a small, test network, the target size is set to just 2 GB.
 
 One ledger worth of rent costs `write_fee / rent_coefficient`, where `write_fee` is the cost of writing the ledger entry and `rent_coefficient` is a number of ledgers for which the whole write fee will be paid. Given the numbers above, this means that 1 month of renting the ledger space for the temporary entry costs `write_fee / 10` and it costs `write_fee` for a persistent entry (10x more).
 
@@ -91,7 +91,7 @@ Ledger close time is constrained to a few seconds, thus preventing the execution
 
 These resource limits may change in the Mainnet release. They can also be updated, usually increased, based on the network validator vote and consensus.
 
-The current (Futurenet) limits are as follows:
+The current (Testnet) limits are as follows:
 
 | Resource                   | Limit       |
 | -------------------------- | ----------- |

docs/fundamentals-and-concepts/invoking-contracts-with-transactions.mdx

@@ -63,7 +63,7 @@ npm install --save soroban-client
 
   // Configure SorobanClient to use the `soroban-rpc` instance of your
   // choosing.
-  const server = new Server("https://rpc-futurenet.stellar.org:443");
+  const server = new Server("https://soroban-testnet.stellar.org:443");
 
   // Here we will use a deployed instance of the `increment` example contract.
   const contractAddress =
@@ -78,7 +78,7 @@ npm install --save soroban-client
   // fee, and network passphrase are provided.
   let builtTransaction = new TransactionBuilder(sourceAccount, {
     fee: BASE_FEE,
-    networkPassphrase: Networks.FUTURENET,
+    networkPassphrase: Networks.TESTNET,
   })
     // The invocation of the `increment` function of our contract is added
     // to the transaction. Note: `increment` doesn't require any parameters,
@@ -172,7 +172,7 @@ from stellar_sdk.soroban_rpc import GetTransactionStatus, SendTransactionStatus
 source_keypair = Keypair.from_secret('SCQN3XGRO65BHNSWLSHYIR4B65AHLDUQ7YLHGIWQ4677AZFRS77TCZRB')
 
 # Configure SorobanClient to use the `soroban-rpc` instance of your choosing.
-soroban_server = SorobanServer('https://rpc-futurenet.stellar.org')
+soroban_server = SorobanServer('https://soroban-testnet.stellar.org')
 
 # Here we will use a deployed instance of the `increment` example contract.
 contract_address = 'CBEOJUP5FU6KKOEZ7RMTSKZ7YLBS5D6LVATIGCESOGXSZEQ2UWQFKZW6'
@@ -187,7 +187,7 @@ built_transaction = (
     TransactionBuilder(
         source_account=source_account,
         base_fee=100,
-        network_passphrase=Network.FUTURENET_NETWORK_PASSPHRASE,
+        network_passphrase=Network.TESTNET_NETWORK_PASSPHRASE,
     )
     # The invocation of the `increment` function of our contract is added to the
     # transaction. Note: `increment` doesn't require any parameters, but many

docs/fundamentals-and-concepts/migrating-from-evm/smart-contract-deployment.mdx

@@ -104,8 +104,8 @@ from stellar_sdk.soroban.soroban_rpc import TransactionStatus
 
 # TODO: You need to replace the following parameters according to the actual situation
 secret = "SAAPYAPTTRZMCUZFPG3G66V4ZMHTK4TWA6NS7U4F7Z3IMUD52EK4DDEV"
-rpc_server_url = "http://127.0.0.1:8000/soroban/rpc"
-network_passphrase = Network.FUTURENET_NETWORK_PASSPHRASE
+rpc_server_url = "https://soroban-testnet.stellar.org"
+network_passphrase = Network.TESTNET_NETWORK_PASSPHRASE
 contract_file_path = "/path/to/compiled/soroban_contract.wasm"
 
 kp = Keypair.from_secret(secret)
@@ -921,7 +921,7 @@ test test::test ... ok
 
 Now that we have a working vault contract, we can deploy it to a network and interact with it.
 
-This section requires you to have a funded Keypair to use with Stellar's Futurenet. You can create and fund one using the [Stellar Laboratory](https://laboratory.stellar.org/#account-creator?network=futurenet).
+This section requires you to have a funded Keypair to use with Stellar's Testnet. You can create and fund one using the [Stellar Laboratory](https://laboratory.stellar.org/#account-creator?network=testnet).
 
 Below you will find a series of commands that will help you build, deploy and interact with the vault and token contracts. You can use them to follow along as we walk through the process of building, deploying, and interacting with the contracts. It may behoove you to keep these commands in a `scripts` directory in your project. This way, you can easily run them from your terminal.
 
@@ -942,8 +942,8 @@ soroban contract build
 soroban contract deploy \
     --wasm soroban_token_contract.wasm \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022'
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015'
 ```
 
 </TabItem>
@@ -955,8 +955,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     initialize \
     --admin <USER_ADDRESS> \
@@ -974,8 +974,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     mint \
     --to <USER_OR_VAULT_ADDRESS> \
@@ -991,8 +991,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
         balance \
     --id <USER_OR_VAULT_ADDRESS>
@@ -1014,8 +1014,8 @@ soroban contract install --wasm soroban_token_contract.wasm
 soroban contract deploy \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022'
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015'
 ```
 
 </TabItem>
@@ -1027,8 +1027,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     initialize \
     --token_wasm_hash 73593275ee3bcacc2aef8d641a1d5108618064bdfff84a826576b8caff395add \
@@ -1044,8 +1044,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     share_id
 ```
@@ -1059,8 +1059,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     deposit \
     --from <USER_ADDRESS> \
@@ -1076,8 +1076,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     get_rsrvs
 ```
@@ -1091,8 +1091,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     withdraw \
     --to <USER_ADDRESS> \
@@ -1116,8 +1116,8 @@ Next, we need to deploy the token contract. We can do this by running the `deplo
 soroban contract deploy \
     --wasm soroban_token_contract.wasm \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022'
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015'
 ```
 
 We should receive an output with the token contract ID. We will need this ID for the next step.
@@ -1141,8 +1141,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     initialize \
     --admin <USER_ADDRESS> \
@@ -1157,8 +1157,8 @@ Next, we need to deploy the vault contract. We can do this by running the `deplo
 soroban contract deploy \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022'
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015'
 ```
 
 We should receive an output with the vault contract ID. We will need this ID for the next step.
@@ -1212,8 +1212,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     initialize \
     --token_wasm_hash 73593275ee3bcacc2aef8d641a1d5108618064bdfff84a826576b8caff395add \
@@ -1245,8 +1245,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     mint \
     --to <USER_OR_VAULT_ADDRESS> \
@@ -1260,8 +1260,8 @@ soroban contract invoke \
     --wasm soroban_token_contract.wasm \
     --id <TOKEN_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
         balance \
     --id <USER_ADDRESS>
@@ -1280,8 +1280,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <ACCOUNT_SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     deposit \
     --from <USER_ADDRESS> \
@@ -1295,8 +1295,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     get_rsrvs
 ```
@@ -1316,8 +1316,8 @@ soroban contract invoke \
     --wasm target/wasm32-unknown-unknown/release/vault.wasm \
     --id <VAULT_CONTRACT_ID> \
     --source <SECRET_KEY> \
-    --rpc-url https://rpc-futurenet.stellar.org:443 \
-    --network-passphrase 'Test SDF Future Network ; October 2022' \
+    --rpc-url https://soroban-testnet.stellar.org:443 \
+    --network-passphrase 'Test SDF Network ; September 2015' \
     -- \
     withdraw \
     --to <USER_ADDRESS> \