Practicing with the Test Network

An Ethereum test network (testnet for short) is an Ethereum blockchain, functionally identical to the standard Ethereum blockchain, but it's intended to be used for testing smart contracts before they go live onto the main "real" blockchain (called mainnet). Testnets run in parallel with mainnet - there are actually several of them running right now!

You can read more about some of the Execution Layer testnets here if you like. Rocket Pool uses Holesky for its Execution Layer testnet. You can use a block explorer for it here if you'd like to take a look at it: https://holesky.etherscan.io/

The same concept applies to the Consensus Layer as well. Rocket Pool uses Holesky for its Consensus Layer testnet. You can find a block explorer for it here: https://holesky.beaconcha.in/

Because the networks are intended for testing, ETH on them is given out for free to help people test. This ETH cannot be transferred to mainnet; it must stay on Holesky and has no real value, so you can think of it as Monopoly money.

DANGER

DO NOT use your real ETH from mainnet at any point if you are trying out Rocket Pool's test network! You will lose your funds forever if you do this! You should only use test ETH that you received on the Holesky network from a faucet (described below)!

Configuring the Testnet

The default configuration of Rocket Pool using Docker handles all of the settings involved in using a testnet for you automatically. There's nothing special you need to do.

If you're using a different setup with an external execution or consensus client, or are running your clients natively without Docker, then you will need to set this up manually:

  • For Geth: add --holesky to the launch command.
  • For Lighthouse: add --network holesky to the launch command.
  • For Nimbus: add --network=holesky to the launch command.
  • For Prysm: add --holesky to the launch command.
  • For Teku: add --network=holesky to the launch command.
  • For Lodestar: prefix the launch command with LODESTAR_NETWORK=holesky

Check the next section to learn how to get some test ETH on Holesky, which you'll need to test Rocket Pool out.

Getting Test ETH on Holesky

To use the Rocket Pool test network, you'll need ETH on Holesky. Luckily, you can get this for free using a faucet - an automated service that will provide you with Holesky ETH to test with.

NOTE

You will need to provide an Ethereum address in order to receive test ETH.

If you are just trying to stake your ETH normally and receive rETH, please review the Staking Guide before getting Holesky ETH. You will be prompted to return here at the appropriate step.

If you are planning to run a node, please go through the Node Operator Guide to set up a node and create a new wallet first. You will be prompted to return here at the appropriate step.

Rocket Pool provides a faucet in its Discord server. Join the server and head to the #support channel.

Here, you can ask for testnet ETH. You will need to provide your node address.

NOTE

The testnet faucet bot is no longer directly accessible to the public due to previous abuse.

It is only available to the dev team and prominent members of the community.

To receive testnet eth, run the below commands, state your intentions in the channel.

Be patient and someone will access the faucet on your behalf.

If you aren't planning to register a node and just want some ETH to test staking to receive rETH, type the following command in the channel:

!holeskyEth <your holesky address>

without the angle brackets. If your wallet doesn't have any ETH already, the bot will send your wallet 1 ETH to test with.

If you are planning to run a node, do the following:

  1. Start by running the !holeskyEth command above to acquire enough ETH to register your node
  2. Register your node (see the Preparing your Node page for instructions)
  3. Run the following command to get 8 Holesky ETH so you can create a validator:
!holeskyOperator <your holesky address>

In order to use !holeskyOperator, the address you provide it must be a registered Rocket Pool node. Therefore, you must follow these 3 steps in that order.

Getting Test RPL on Holesky

If you're testing out node operation, you'll need some test RPL in addition to test ETH.

Rocket Pool provides a faucet in its Discord server. Join the server and head to the #support channel.

Here, you can ask for testnet RPL. You will need to provide your node address.

NOTE

The testnet faucet bot is no longer directly accessible to the public due to previous abuse.

It is only available to the dev team and prominent members of the community.

To receive testnet RPL, run the below commands, state your intentions in the channel.

Be patient and someone will access the faucet on your behalf.

!holeskyRpl <your holesky node address>

This will provide you with 600 of the legacy (v1) RPL token, which is analogous to the original RPL token on mainnet. Rocket Pool uses a new (v2) RPL token which supports the inflation used to reward node operators.

To learn how to swap legacy RPL for new RPL, follow the steps in the Creating a Minipool (Validator) guide.