Skip to content

Commit 655281a

Browse files
authored
make networks doc more readable by using table - by claude (#1649)
1 parent 2022408 commit 655281a

1 file changed

Lines changed: 29 additions & 24 deletions

File tree

docs/learn/fundamentals/networks.mdx

Lines changed: 29 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,40 +7,45 @@ sidebar_position: 20
77

88
# Networks
99

10-
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 financial 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 resets on a regular cadence, so it's the best place for developers to test applications when they need a stable environment that mirrors Mainnet functionality. Futurenet is a dev network you can use to test more bleeding edge features that also has access to its own Friendbot. It resets whenever a reset is necessary, so it's not as predictable as Testnet, but it is where new features may be introduced before they are implemented in stable releases.
10+
Stellar has three networks: the public network (Mainnet, also called Pubnet or the Public Network), the test network (Testnet), and a dev network (Futurenet).
1111

12-
## Stats: Mainnet versus Testnet versus Futurenet
12+
- **Mainnet** is the main network used by applications in production. It connects to real financial rails and requires XLM to cover minimum balances, transaction fees, and rent.
13+
- **Testnet** is a smaller, free-to-use network maintained by SDF that functions like Mainnet but doesn't connect to real money. It resets on a regular cadence, making it the best place for developers to test applications in a stable environment that mirrors Mainnet functionality.
14+
- **Futurenet** is a dev network for testing bleeding-edge features. It resets whenever necessary, so it's less predictable than Testnet, but it's where new features are introduced before stable releases.
1315

14-
### Mainnet
16+
## Network Comparison
1517

16-
- Validator nodes are run by the public
17-
- SDF offers free [Horizon Testnet and Futurenet Instances](../../data/apis/api-providers.mdx#sdf-provided-horizon) to interact with the Testnet and Futurenet. The ecosystem has [Horizon providers](../../data/apis/api-providers.mdx) whom offer instances for Testnet and Mainnet. You can [run your own Horizon](../../data/apis/horizon/admin-guide/overview.mdx) or use an instance offered by an [infrastructure provider](../../data/apis/api-providers.mdx).
18-
- You need to fund your account with XLM from another account
19-
- Mainnet is limited to 1,000 operations per ledger and will be limited to a maximum of 100 smart contract transactions per ledger (the precise amount of smart contract txs per ledger can vary greatly depending on transaction [resource limits](./fees-resource-limits-metering.mdx#resource-limitations)).
20-
- See more detailed smart contract network settings in the section on [Fees and Metering](./fees-resource-limits-metering.mdx).
21-
- No publicly available RPC, see RPC service providers [here](../../data/apis/api-providers.mdx)
18+
| Feature | Mainnet | Testnet | Futurenet |
19+
| --- | --- | --- | --- |
20+
| **Purpose** | Production network | Stable testing environment | Bleeding-edge feature testing |
21+
| **Validator Nodes** | Run by the public | SDF runs three core validator nodes | SDF runs core validator nodes |
22+
| **Funding** | Real XLM required from another account | Free via Friendbot | Free via Friendbot |
23+
| **Horizon Instance** | [Multiple providers available](../../data/apis/api-providers.mdx) | [Free SDF instance](https://horizon-testnet.stellar.org/) | [Free SDF instance](https://horizon-futurenet.stellar.org) |
24+
| **RPC Endpoints** | [Third-party providers only](../../data/apis/api-providers.mdx) | [Free SDF endpoints](../../data/apis/api-providers.mdx#sdf-provided-rpc) | [Free SDF endpoints](../../data/apis/api-providers.mdx#sdf-provided-rpc) |
25+
| **Operations per Ledger** | 1,000 | 100 | 100 |
26+
| **Smart Contract Transactions per Ledger** | Max 100\* | 1 | 1 |
27+
| **Network Resets** | Never | Regular cadence | As needed (unpredictable) |
28+
| **Friendbot Available** | No | Yes (10,000 XLM) | Yes (10,000 XLM) |
2229

23-
### Testnet
30+
\*The precise amount can vary based on [resource limits](./fees-resource-limits-metering.mdx#resource-limitations). See [Fees and Metering](./fees-resource-limits-metering.mdx) for detailed smart contract network settings.
2431

25-
- SDF runs three core validator nodes
26-
- SDF offers a free [Horizon instance](https://horizon-testnet.stellar.org/) you can use to interact with the Testnet
27-
- Friendbot is a faucet you can use for free Testnet XLM
28-
- Testnet is limited to 100 operations per ledger and one smart contract transaction per ledger
29-
- SDF offers free RPC endpoints, more information [here](../../data/apis/api-providers.mdx#sdf-provided-rpc)
32+
## Friendbot
3033

31-
### Futurenet
34+
Friendbot is a bot that funds accounts with fake XLM on Testnet or Futurenet. You can request XLM from Friendbot using the [Stellar Lab](../../tools/lab/account.mdx#fund-account) or with various SDKs.
3235

33-
- SDF runs core validator nodes
34-
- SDF offers a free [Horizon instance](https://horizon-futurenet.stellar.org) you can use to interact with the Futurenet
35-
- Friendbot is a faucet you can use for free Futurenet XLM
36-
- Futurenet is limited to 100 operations per ledger and one smart contract transaction per ledger
37-
- SDF offers free RPC endpoints, more information [here](../../data/apis/api-providers.mdx#sdf-provided-rpc)
36+
**Key details:**
3837

39-
## Friendbot
38+
- Requests are rate limited, so use wisely
39+
- Provides 10,000 fake XLM when funding a new account
40+
- For multiple accounts: fund your first account with Friendbot, then use that account to fund subsequent accounts using the Create Account operation
41+
42+
## Getting Started
43+
44+
**For Production:** Use Mainnet with real XLM and production-ready infrastructure.
4045

41-
Friendbot is a bot that funds accounts with fake XLM on Testnet or Futurenet. You can request XLM from Friendbot using the [Stellar Lab](../../tools/lab/account.mdx) 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.
46+
**For Testing:** Use Testnet for stable development and testing that mirrors production behavior.
4247

43-
If you are creating multiple accounts, you can fund your first account with Friendbot and then use that first account to fund your subsequent accounts using the Create Account operation.
48+
**For Experimental Features:** Use Futurenet to test the latest features before they're released.
4449

4550
## Testnet and Futurenet data reset
4651

0 commit comments

Comments
 (0)