Clean up TdS/validator docs (#9638)

This commit is contained in:
Michael Vines
2020-04-21 16:59:09 -07:00
committed by GitHub
parent 45ff1f2379
commit 5b8d963ee2
22 changed files with 172 additions and 450 deletions

View File

@@ -1,60 +1,9 @@
# Connecting to a Cluster
See [Solana Clusters](../clusters.md) for general information about the
available clusters.
Solana maintains several different clusters with different purposes. Each
cluster features a Solana-run gossip node that serves as an entrypoint to the
cluster.
## Before you Begin
- Make sure you have first
[installed the Solana command line tools](install-solana-cli-tools.md)
## Choose a Cluster
#### Mainnet Beta
A permissionless, persistent cluster for early token holders and launch partners.
No smart contracts or inflation.
* 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
[Trust Wallet](../wallet/trust-wallet.md),
the wallet will always be connecting to Mainnet Beta.
* Gossip entrypoint for Mainnet Beta: `mainnet-beta.solana.com:8001`
* RPC URL for Mainnet Beta: `https://api.mainnet-beta.solana.com`
#### Devnet
* 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
* Devnet may be maintained by different validators than Mainnet Beta
* Gossip entrypoint for Devnet: `devnet.solana.com:8001`
* RPC URL for Devnet: `https://devnet.solana.com`
#### Testnet (Tour de SOL Cluster)
* Testnet is where we stress test recent release features on a live
cluster, particularly focused on network performance, stability and validator
behavior.
* [Tour de SOL](../tour-de-sol/README.md) initiative runs on Testnet, where we
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.
* Testnet typically runs a newer software release than both Devnet and
Mainnet Beta
* Testnet may be maintained by different validators than Mainnet Beta
* Gossip entrypoint for Testnet: `testnet.solana.com:8001`
* RPC URL for Testnet: `https://testnet.solana.com`
## Configure the Command-line
You can check what cluster the Solana CLI is currently targeting by
## Configure the command-line tool
You can check what cluster the Solana command-line tool (CLI) is currently targeting by
running the following command:
```bash
@@ -65,21 +14,11 @@ Use `solana config set` command to target a particular cluster. After setting
a cluster target, any future subcommands will send/receive information from that
cluster.
##### Targetting Mainnet Beta
```bash
solana config set --url https://api.mainnet-beta.solana.com
```
##### Targetting Devnet
For example to target the Devnet cluster, run:
```bash
solana config set --url https://devnet.solana.com
```
##### Targetting Testnet
```bash
solana config set --url https://testnet.solana.com
```
## Ensure Versions Match
Though not strictly necessary, the CLI will generally work best when its version