diff --git a/docs/fundamentals-and-concepts/networks.mdx b/docs/fundamentals-and-concepts/networks.mdx index 4c3e6349e..fa118ea7f 100644 --- a/docs/fundamentals-and-concepts/networks.mdx +++ b/docs/fundamentals-and-concepts/networks.mdx @@ -3,7 +3,7 @@ title: Networks sidebar_position: 30 --- -Stellar has three networks: the public network (Mainnet, also called Pubnet or the Public Network), the test network (Testnet), and a dev network (Futurenet). Mainnet is the main network used by applications in production. It connects to real rails and requires XLM to cover minimum balances and transaction fees. The Testnet is a smaller, free-to-use network maintained by SDF that functions like the Mainnet but doesn’t connect to real money. It has a built-in testnet XLM faucet, and it's the best place for developers to test their applications. Futurenet is a dev network you can use to test more bleeding edge features. +Stellar has three networks: the public network (Mainnet, also called Pubnet or the Public Network), the test network (Testnet), and a dev network (Futurenet). Mainnet is the main network used by applications in production. It connects to real rails and requires XLM to cover minimum balances, transaction fees, and rent. The Testnet is a smaller, free-to-use network maintained by SDF that functions like the Mainnet but doesn’t connect to real money. It has a built-in testnet XLM faucet (called friendbot), and it's the best place for developers to test their applications. Futurenet is a dev network you can use to test more bleeding edge features that also has access to friendbot. ## Stats: Mainnet versus Testnet versus Futurenet @@ -13,7 +13,7 @@ Stellar has three networks: the public network (Mainnet, also called Pubnet or t - SDF offers a free [Horizon instance](https://horizon.stellar.org/) to interact with the Pubnet, or you can run your own - You need to fund your account with XLM from another account - Mainnet is limited to 1,000 operations per ledger and 30 smart contract transactions per ledger - - See more detailed network settings in the section on [Fees and Metering](https://soroban.stellar.org/docs/fundamentals-and-concepts/fees-and-metering) in the Soroban docs + - See more detailed smart contract network settings in the section on [Fees and Metering](https://soroban.stellar.org/docs/fundamentals-and-concepts/fees-and-metering) in the Soroban docs - No publicly available RPC, see RPC service providers [here](https://soroban.stellar.org/docs/reference/rpc-list) ### Testnet @@ -26,6 +26,12 @@ Stellar has three networks: the public network (Mainnet, also called Pubnet or t ### Futurenet +- _Does SDF run validator nodes?_ +- _Does SDF offer a Horizon instance?_ +- Friendbot is a faucet you can use for free Futurenet XLM +- _What are Futurenet's transaction limitations?_ +- _Does SDF offer a free RPC endpoint in Futurenet?_ + ## Friendbot Friendbot is a bot that funds accounts with fake XLM on Testnet or Futurenet. You can request XLM from friendbot using the Stellar Laboratory or with various SDKs. Requests to friendbot are rate limited, so use it wisely. Friendbot provides 10,000 fake XLM when funding a new account. @@ -34,7 +40,7 @@ If you are creating multiple accounts, you can fund your first account with frie ## Testnet and Futurenet data reset -Testnet and Futurenet are reset periodically to the genesis ledger to declutter the network, remove spam, reduce the time needed to catch up on the latest ledger, and help maintain the system. Resets clear all ledger entries (accounts, trustlines, offers, smart contract data, etc.), transactions, and historical data from Stellar Core and Horizon- which is why developers should not rely on the persistence of accounts or the state of any balances when using Testnet. +Testnet and Futurenet are reset periodically to the genesis ledger to declutter the network, remove spam, reduce the time needed to catch up on the latest ledger, and help maintain the system. Resets clear all ledger entries (accounts, trustlines, offers, smart contract data, etc.), transactions, and historical data from Stellar Core and Horizon- which is why developers should not rely on the persistence of accounts or the state of any balances when using Testnet or Futurenet. Futurenet resets are on a less regular cadence than Testnet resets and don't have a set schedule. @@ -53,9 +59,10 @@ It is recommended that you have testing infrastructure that can repopulate the T - Generate issuers of assets for testing the development of a wallet; - Generate orders on the order book (both current and historical) for testing the development of a trading client; -- Recreate liquidity pools. +- Recreate liquidity pools; +- Redeploy smart contracts. -If you maintain an application, you should think about creating a data set that is representative enough to test your primary use cases, and allow for robust testing even when Testnet is not available. +If you maintain an application, you should think about creating a data set that is representative enough to test your primary use cases, and allow for robust testing even when Testnet or Futurenet are not available. A script can automate this entire process by creating an account with friendbot and submitting a set of transactions that are predefined as a part of your testing infrastructure. @@ -77,15 +84,17 @@ A script can automate this entire process by creating an account with friendbot - The ability to control the data reset frequency; - The need to secure private or sensitive data (before launching on the Mainnet). You can always run your own test network for use cases that don’t work well with SDF’s Testnet. -## Moving your project from Testnet to production +## Moving your project from Testnet or Futurenet to production + +Mainnet, Testnet, and Futurenet each have their own unique passphrase, which is used to validate signatures on a given transaction. -The Mainnet and Testnet each have their own unique passphrase, which is used to validate signatures on a given transaction. +The current passphrases for the Stellar Mainnet, Testnet, and Futurenet are: -The current passphrases for the Stellar Pubnet and Testnet are: +**Mainnet (Pubnet)**: `Public Global Stellar Network ; September 2015` -**Mainnet (Pubnet)**: 'Public Global Stellar Network ; September 2015' +**Testnet**: `Test SDF Network ; September 2015` -**Testnet**: 'Test SDF Network ; September 2015' +**Futurenet**: `Test SDF Future Network ; October 2022` For applications that don’t rely on the state of the network (such as specific accounts needing to exist), you move to production by changing the network passphrase and ensuring your Horizon instance is connected to Mainnet.