Skip to main content

Validator Deposits

Overview​

  • You will need to make a deposit of 1 GNO for each validator.
  • You can make a bulk deposit for up to 128 validators at a time.

Pre-requisites​

  • Execution Layer client and Beacon Node should be fully synced
  • Validator process should already be running

GNO on Gnosis Chain​

  • Validators need to be funded using GNO on Gnosis Chain
  • You will need to bridge GNO over from Ethereum to Gnosis Chain
tip

You can use Transferto.xyz or the Omnibridge to bridge GNO from Ethereum to Gnosis Chain.

Option 1: Deposit UI​

Step 1: Connect your Wallet​

  1. Go to https://deposit.gnosischain.com/ and connect your web3 wallet on the Gnosis Chain to the application.

In this example we use MetaMask.

Step 2: Upload deposit_data.json​

  1. Select the Deposit tab. Upload your deposit_data.json file from Step 4 of the interactive guide It will be located in the same folder as the generated keystores.
note

If you can't upload the file, you may want to check the file permissions to make sure the user account you are logged in as has read permissions. You can grant permissions using the sudo chmod command.

Step 3: Validate Deposit data​

  1. The app will validate the json file and list the number of validator deposits you are making and the required GNO to deposit. Click Deposit to continue.

Step 4: Acknowledge Risks​

  1. Check that you understand the risks and ensure you are interacting with the correct contract before proceeding.

Step 5: Verify Transaction Parameters​

You are responsible for the transaction. Fraudulent websites might try to lure you into sending funds to them, instead of the official deposit contract. Make sure that you are sending the transaction with the correct data.

caution

Verify that the contract address you're interacting with is 0x9C58BAcC331c9aa871AFD802DB6379a98e80CEdb (GNO on Gnosis Chain)

caution

Check that the transaction uses the transferAndCall method.

caution

Check that the transaction's data includes the Deposit Contract address (0x0B98057eA310F4d31F2a452B414647007d1645d9)

0x4000aea00000000000000000000000000b98057ea310f4d31f2a452b414647007d1645d9

Step 6: Complete Deposit​

  1. Complete the deposit.

Step 7: Validator Activation​

tip

It will take about 1.5 hours for your validators to start proposing and attesting to blocks.

  • Following a successful deposit, the Gnosis Beacon Chain will wait for 1024 Gnosis Chain blocks plus up to 64 Gnosis Beacon Chain epochs before adding validators to the pool.
  • This is roughly 1 hour and 25 minutes before the validators start proposing and attesting blocks on the Gnosis Chain.
  • Once live, you can view your validator(s) on the explorer. Copy the pubkey(s) listed in the deposit_data.json file (a key will be generated for each validator as "pubkey": "<your-public-key>") and paste into the search box at https://gnosischa.in/.

Option 2: Direct interaction with Contracts​

A modification to the Gnosis Chain deposit contract allows you to deposit in batches (this functionality is not available for the ETH2 deposit contract). One transaction can be used to initiate deposits for up to 128 validators. The assumption is that every validator deposits 1 GNO(which is converted to 32mGNO) in every entry of the batch. The following script simplifies the process.

Step 1: Get Deposit Script​

Pull the docker image with the deposit script:

docker pull ghcr.io/gnosischain/deposit-script:latest

Step 2: Configure .env file​

Prepare .env file with the following lines:

STAKING_ACCOUNT_PRIVATE_KEY=0000000000000000000000000000000000000000000000000000000000000000

RPC_URL=https://rpc.gnosischain.com
GAS_PRICE=2000000000

# number of deposits in one transaction, should be in range [1, 128]
BATCH_SIZE=128
# total number of deposits to read from file
N=256
# index of the first deposit to read from file
OFFSET=0

# address of the GNO token
TOKEN_ADDRESS=0x9C58BAcC331c9aa871AFD802DB6379a98e80CEdb
# address of the GBC deposit contract
DEPOSIT_CONTRACT_ADDRESS=0x0B98057eA310F4d31F2a452B414647007d1645d9
# block where the deposit contract was deployed at
START_BLOCK_NUMBER=19469077

STAKING_ACCOUNT_PRIVATE_KEY is the private key of the account which holds the necessary amount of GNO tokens for deposit. Any account may be used for funding, but it must also have a small amount of xDai to process transactions. In the above example, 2 transactions will occur with 256 total deposits of 1 GNO each.

Step 3: Import deposit_data.json files​

Copy the deposit_data.json generated during Step 4 of the interactive guide to the current directory.

Step 4: Run Deposit script​

Run the deposit script (/path/to/ should be a valid path to the .env file you have created):

docker run --rm --env-file /path/to/.env \
    -v $(pwd)/deposit_data-xxxxxxxxxx.json:/tmp/deposit_data.json \
    ghcr.io/gnosischain/deposit-script:latest /tmp/deposit_data.json

Step 5: Validator Activation​

tip

It will take about 1.5 hours for your validators to start proposing and attesting to blocks.

  • Following a successful deposit, the Gnosis Beacon Chain will wait for 1024 Gnosis Chain blocks plus up to 64 Gnosis Beacon Chain epochs before adding validators to the pool.
  • This is roughly 1 hour and 25 minutes before the validators start proposing and attesting blocks on the Gnosis Chain.
  • Once live, you can view your validator(s) on the explorer. Copy the pubkey(s) listed in the deposit_data.json file (a key will be generated for each validator as "pubkey": "<your-public-key>") and paste into the search box at https://gnosischa.in//.

Appendix​

Depositing For Chiado Testnet​

Required:

  1. Chiado Testnet xDai: https://faucet.chiadochain.net/
  2. Chiado Testnet GNO: This can be obtained from discord upon request

You can run the deposit UI locally following its repository README instructions: https://github.com/gnosischain/gbc-deposit-ui#gnosis-beacon-chain-deposit-ui