2020-07-10 22:11:07 -07:00
|
|
|
---
|
|
|
|
title: Solana Clusters
|
|
|
|
---
|
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
Solana maintains several different clusters with different purposes.
|
|
|
|
|
|
|
|
Before you begin make sure you have first
|
|
|
|
[installed the Solana command line tools](cli/install-solana-cli-tools.md)
|
|
|
|
|
|
|
|
Explorers:
|
2020-07-10 22:11:07 -07:00
|
|
|
|
|
|
|
- [http://explorer.solana.com/](https://explorer.solana.com/).
|
|
|
|
- [http://solanabeach.io/](http://solanabeach.io/).
|
2020-04-21 16:59:09 -07:00
|
|
|
|
|
|
|
## Devnet
|
|
|
|
|
2020-07-10 22:11:07 -07:00
|
|
|
- Devnet serves as a playground for anyone who wants to take Solana for a
|
|
|
|
test drive, as a user, token holder, app developer, or validator.
|
|
|
|
- Application developers should target Devnet.
|
|
|
|
- Potential validators should first target Devnet.
|
|
|
|
- Key differences between Devnet and Mainnet Beta:
|
|
|
|
- Devnet tokens are **not real**
|
|
|
|
- Devnet includes a token faucet for airdrops for application testing
|
|
|
|
- Devnet may be subject to ledger resets
|
|
|
|
- Devnet typically runs a newer software version than Mainnet Beta
|
2020-10-10 08:39:13 -07:00
|
|
|
- Gossip entrypoint for Devnet: `entrypoint.devnet.solana.com:8001`
|
2020-10-28 12:07:01 -07:00
|
|
|
- Metrics environment variable for Devnet:
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2020-10-28 12:07:01 -07:00
|
|
|
```bash
|
|
|
|
export SOLANA_METRICS_CONFIG="host=https://metrics.solana.com:8086,db=devnet,u=scratch_writer,p=topsecret"
|
|
|
|
```
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2021-05-13 21:13:28 -07:00
|
|
|
- RPC URL for Devnet: `https://api.devnet.solana.com`
|
2020-04-21 16:59:09 -07:00
|
|
|
|
|
|
|
##### Example `solana` command-line configuration
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
2021-05-13 21:13:28 -07:00
|
|
|
solana config set --url https://api.devnet.solana.com
|
2020-04-21 16:59:09 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
##### Example `solana-validator` command-line
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
|
|
|
$ solana-validator \
|
2021-03-16 09:17:45 -07:00
|
|
|
--identity validator-keypair.json \
|
|
|
|
--vote-account vote-account-keypair.json \
|
2020-08-17 15:09:31 -07:00
|
|
|
--trusted-validator dv1LfzJvDF7S1fBKpFgKoKXK5yoSosmkAdfbxBo1GqJ \
|
2020-04-21 16:59:09 -07:00
|
|
|
--no-untrusted-rpc \
|
2021-03-16 09:17:45 -07:00
|
|
|
--ledger ledger \
|
2020-04-21 16:59:09 -07:00
|
|
|
--rpc-port 8899 \
|
2020-04-23 21:36:40 -07:00
|
|
|
--dynamic-port-range 8000-8010 \
|
2020-08-31 00:25:39 -07:00
|
|
|
--entrypoint entrypoint.devnet.solana.com:8001 \
|
2020-09-30 11:37:09 -07:00
|
|
|
--expected-genesis-hash EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG \
|
2020-10-09 08:25:46 -07:00
|
|
|
--wal-recovery-mode skip_any_corrupted_record \
|
2020-04-21 16:59:09 -07:00
|
|
|
--limit-ledger-size
|
|
|
|
```
|
|
|
|
|
2020-06-05 16:44:58 -07:00
|
|
|
The `--trusted-validator`s is operated by Solana
|
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
## Testnet
|
|
|
|
|
2020-07-10 22:11:07 -07:00
|
|
|
- Testnet is where we stress test recent release features on a live
|
|
|
|
cluster, particularly focused on network performance, stability and validator
|
|
|
|
behavior.
|
2020-07-15 13:11:51 -07:00
|
|
|
- [Tour de SOL](tour-de-sol.md) initiative runs on Testnet, where we
|
2020-07-10 22:11:07 -07:00
|
|
|
encourage malicious behavior and attacks on the network to help us find and
|
|
|
|
squash bugs or network vulnerabilities.
|
|
|
|
- Testnet tokens are **not real**
|
|
|
|
- Testnet may be subject to ledger resets.
|
2020-08-30 22:38:58 -07:00
|
|
|
- Testnet includes a token faucet for airdrops for application testing
|
2020-07-10 22:11:07 -07:00
|
|
|
- Testnet typically runs a newer software release than both Devnet and
|
|
|
|
Mainnet Beta
|
2020-10-10 08:39:13 -07:00
|
|
|
- Gossip entrypoint for Testnet: `entrypoint.testnet.solana.com:8001`
|
2020-10-28 12:07:01 -07:00
|
|
|
- Metrics environment variable for Testnet:
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2020-10-28 12:07:01 -07:00
|
|
|
```bash
|
|
|
|
export SOLANA_METRICS_CONFIG="host=https://metrics.solana.com:8086,db=tds,u=testnet_write,p=c4fa841aa918bf8274e3e2a44d77568d9861b3ea"
|
|
|
|
```
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2021-05-13 21:13:28 -07:00
|
|
|
- RPC URL for Testnet: `https://api.testnet.solana.com`
|
2020-04-21 16:59:09 -07:00
|
|
|
|
|
|
|
##### Example `solana` command-line configuration
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
2021-05-13 21:13:28 -07:00
|
|
|
solana config set --url https://api.testnet.solana.com
|
2020-04-21 16:59:09 -07:00
|
|
|
```
|
|
|
|
|
|
|
|
##### Example `solana-validator` command-line
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
|
|
|
$ solana-validator \
|
2021-03-16 09:17:45 -07:00
|
|
|
--identity validator-keypair.json \
|
|
|
|
--vote-account vote-account-keypair.json \
|
2020-04-21 16:59:09 -07:00
|
|
|
--trusted-validator 5D1fNXzvv5NjV1ysLjirC4WY92RNsVH18vjmcszZd8on \
|
2021-02-27 09:33:21 -08:00
|
|
|
--trusted-validator 7XSY3MrYnK8vq693Rju17bbPkCN3Z7KvvfvJx4kdrsSY \
|
2020-08-22 09:21:47 -07:00
|
|
|
--trusted-validator Ft5fbkqNa76vnsjYNwjDZUXoTWpP7VYm3mtsaQckQADN \
|
2020-06-08 08:17:19 -07:00
|
|
|
--trusted-validator 9QxCLckBiJc783jnMvXZubK4wH86Eqqvashtrwvcsgkv \
|
2020-04-21 16:59:09 -07:00
|
|
|
--no-untrusted-rpc \
|
2021-03-16 09:17:45 -07:00
|
|
|
--ledger ledger \
|
2020-04-21 16:59:09 -07:00
|
|
|
--rpc-port 8899 \
|
2020-04-23 21:36:40 -07:00
|
|
|
--dynamic-port-range 8000-8010 \
|
2020-08-31 00:25:39 -07:00
|
|
|
--entrypoint entrypoint.testnet.solana.com:8001 \
|
2021-05-17 08:05:09 -07:00
|
|
|
--entrypoint entrypoint2.testnet.solana.com:8001 \
|
|
|
|
--entrypoint entrypoint3.testnet.solana.com:8001 \
|
2020-04-21 16:59:09 -07:00
|
|
|
--expected-genesis-hash 4uhcVJyU9pJkvQyS88uRDiswHXSCkY3zQawwpjk2NsNY \
|
2020-10-09 08:25:46 -07:00
|
|
|
--wal-recovery-mode skip_any_corrupted_record \
|
2020-04-21 16:59:09 -07:00
|
|
|
--limit-ledger-size
|
|
|
|
```
|
|
|
|
|
2020-06-05 16:44:58 -07:00
|
|
|
The identity of the `--trusted-validator`s are:
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2021-02-27 09:33:21 -08:00
|
|
|
- `5D1fNXzvv5NjV1ysLjirC4WY92RNsVH18vjmcszZd8on` - Solana Foundation (testnet.solana.com)
|
|
|
|
- `7XSY3MrYnK8vq693Rju17bbPkCN3Z7KvvfvJx4kdrsSY` - Solana Foundation (Break RPC node)
|
2020-07-10 22:11:07 -07:00
|
|
|
- `Ft5fbkqNa76vnsjYNwjDZUXoTWpP7VYm3mtsaQckQADN` - Certus One
|
|
|
|
- `9QxCLckBiJc783jnMvXZubK4wH86Eqqvashtrwvcsgkv` - Algo|Stake
|
2020-06-05 16:44:58 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
## Mainnet Beta
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
A permissionless, persistent cluster for early token holders and launch partners.
|
2020-11-03 10:48:57 -08:00
|
|
|
Currently, rewards and inflation are disabled.
|
2020-07-10 22:11:07 -07:00
|
|
|
|
|
|
|
- Tokens that are issued on Mainnet Beta are **real** SOL
|
|
|
|
- If you have paid money to purchase/be issued tokens, such as through our
|
|
|
|
CoinList auction, these tokens will be transferred on Mainnet Beta.
|
|
|
|
- Note: If you are using a non-command-line wallet such as
|
2020-11-03 12:53:17 -08:00
|
|
|
[Solflare](wallet-guide/solflare.md),
|
2020-07-10 22:11:07 -07:00
|
|
|
the wallet will always be connecting to Mainnet Beta.
|
2020-12-18 10:54:48 -08:00
|
|
|
- Gossip entrypoint for Mainnet Beta: `entrypoint.mainnet-beta.solana.com:8001`
|
2020-10-28 12:07:01 -07:00
|
|
|
- Metrics environment variable for Mainnet Beta:
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2020-10-28 12:07:01 -07:00
|
|
|
```bash
|
|
|
|
export SOLANA_METRICS_CONFIG="host=https://metrics.solana.com:8086,db=mainnet-beta,u=mainnet-beta_write,p=password"
|
|
|
|
```
|
2021-04-30 01:20:56 -07:00
|
|
|
|
2020-07-10 22:11:07 -07:00
|
|
|
- RPC URL for Mainnet Beta: `https://api.mainnet-beta.solana.com`
|
2020-04-21 16:59:09 -07:00
|
|
|
|
|
|
|
##### Example `solana` command-line configuration
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
|
|
|
solana config set --url https://api.mainnet-beta.solana.com
|
|
|
|
```
|
|
|
|
|
|
|
|
##### Example `solana-validator` command-line
|
2020-07-10 22:11:07 -07:00
|
|
|
|
2020-04-21 16:59:09 -07:00
|
|
|
```bash
|
|
|
|
$ solana-validator \
|
|
|
|
--identity ~/validator-keypair.json \
|
|
|
|
--vote-account ~/vote-account-keypair.json \
|
|
|
|
--trusted-validator 7Np41oeYqPefeNQEHSv1UDhYrehxin3NStELsSKCT4K2 \
|
|
|
|
--trusted-validator GdnSyH3YtwcxFvQrVVJMm1JhTS4QVX7MFsX56uJLUfiZ \
|
|
|
|
--trusted-validator DE1bawNcRJB9rVm3buyMVfr8mBEoyyu73NBovf2oXJsJ \
|
|
|
|
--trusted-validator CakcnaRDHka2gXyfbEd2d3xsvkJkqsLw2akB3zsN1D2S \
|
|
|
|
--no-untrusted-rpc \
|
2021-03-16 09:17:45 -07:00
|
|
|
--ledger ledger \
|
2020-04-21 16:59:09 -07:00
|
|
|
--rpc-port 8899 \
|
2020-10-09 08:25:46 -07:00
|
|
|
--private-rpc \
|
2020-04-23 21:36:40 -07:00
|
|
|
--dynamic-port-range 8000-8010 \
|
2020-12-18 10:54:48 -08:00
|
|
|
--entrypoint entrypoint.mainnet-beta.solana.com:8001 \
|
|
|
|
--entrypoint entrypoint2.mainnet-beta.solana.com:8001 \
|
|
|
|
--entrypoint entrypoint3.mainnet-beta.solana.com:8001 \
|
|
|
|
--entrypoint entrypoint4.mainnet-beta.solana.com:8001 \
|
|
|
|
--entrypoint entrypoint5.mainnet-beta.solana.com:8001 \
|
2020-04-21 16:59:09 -07:00
|
|
|
--expected-genesis-hash 5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d \
|
2020-10-09 08:25:46 -07:00
|
|
|
--wal-recovery-mode skip_any_corrupted_record \
|
2020-04-21 16:59:09 -07:00
|
|
|
--limit-ledger-size
|
|
|
|
```
|
2020-06-05 16:44:58 -07:00
|
|
|
|
|
|
|
All four `--trusted-validator`s are operated by Solana
|