laconicd/docs/guides/join_network.md
Daniel Choi e31fcc7012
update join_network docs (#827)
* update join_network docs

* add flag to cmd

* edit rpc-api flag
2021-03-02 11:41:12 -08:00

2.4 KiB

Joining Chainsafe's Public Testnet

This document outlines the steps to join the public testnet hosted by Chainsafe.

Steps

  1. Install the Ethermint binaries (ethermintd & ethermint cli)

    git clone https://github.com/cosmos/ethermint
    cd ethermint
    git checkout v0.4.1
    make install
    
  2. Create an Ethermint account

    ethermintcli keys add <keyname>
    
  3. Copy genesis file

    Follow this link and copy it over to the directory ~/.ethermintd/config/genesis.json

  4. Add peers

    Edit the file located in ~/.ethermintd/config/config.toml and edit line 350 (persistent_peers) to the following

    "05aa6587f07a0c6a9a8213f0138c4a76d476418a@18.204.206.179:26656,13d4a1c16d1f427988b7c499b6d150726aaf3aa0@3.86.104.251:26656,a00db749fa51e485c8376276d29d599258052f3e@54.210.246.165:26656"
    
  5. Validate genesis and start the Ethermint network

    ethermintd validate-genesis
    
    ethermintd start --pruning=nothing --rpc.unsafe --log_level "main:info,state:info,mempool:info" --trace
    

    (we recommend running the command in the background for convenience)

  6. Start the RPC server

    ethermintcli rest-server --laddr "tcp://localhost:8545" --unlock-key $KEY --chain-id etherminttestnet-777 --trace --rpc-api "web3,eth,net"
    

    where $KEY is the key name that was used in step 2. (we recommend running the command in the background for convenience)

  7. Request funds from the faucet

    You will need to know the Ethereum hex address, and it can be found with the following command:

    curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}' -H "Content-Type: application/json" http://localhost:8545
    

    Using the output of the above command, you will then send the command with your valid Ethereum address

    curl --header "Content-Type: application/json" --request POST --data '{"address":"0xYourEthereumHexAddress"}' 3.95.21.91:3000
    

Public Testnet Node RPC Endpoints

  • Node0: 54.210.246.165:8545
  • Node1: 3.86.104.251:8545
  • Node2: 18.204.206.179:8545

example:

curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' -H "Content-Type: application/json" 54.210.246.165:8545