From e56f4ddd7ebafd7b40fe5d8dffc1989314ce9406 Mon Sep 17 00:00:00 2001 From: araskachoi Date: Wed, 18 Nov 2020 10:21:12 -0800 Subject: [PATCH 1/5] join network doc --- docs/guides/join_network.md | 40 +++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 docs/guides/join_network.md diff --git a/docs/guides/join_network.md b/docs/guides/join_network.md new file mode 100644 index 000000000..a499fabed --- /dev/null +++ b/docs/guides/join_network.md @@ -0,0 +1,40 @@ + + + +# Joining Chainsafe's Public Testnet + +This document outlines the steps to join the public testnet hosted by [Chainsafe](https://chainsafe.io). + +## Steps: +1. Install the Ethermint binaries (ethermintd & ethermint cli): +``` +git clone https://github.com/cosmos/ethermint +cd ethermint +make install +``` + +2. Create an Ethermint account: +``` +ethermintcli keys add +``` + +3. Copy genesis file: +Follow this [link](https://gist.github.com/araskachoi/43f86f3edff23729b817e8b0bb86295a) 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; +``` +"f618ed93d19dd0b162ef8ba8707f924674454a58@54.210.246.165:26656,24891ad476acc000b20507128ed18e20c6faacc7@18.204.206.179:26656,b765eda477f864743887219d1536698005d7c13e@3.86.104.251: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 +``` + +Then your node should start to sync with the network and blocks should be imported. After the node is caught up, it should be ready to interact with the Ethermint network! \ No newline at end of file From 04813e0e92148af262fdabf96a3f59607ec30b2c Mon Sep 17 00:00:00 2001 From: araskachoi Date: Wed, 18 Nov 2020 10:30:43 -0800 Subject: [PATCH 2/5] include faucet instructions --- docs/guides/join_network.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/guides/join_network.md b/docs/guides/join_network.md index a499fabed..60c2cbe08 100644 --- a/docs/guides/join_network.md +++ b/docs/guides/join_network.md @@ -37,4 +37,15 @@ ethermintd validate-genesis ethermintd start --pruning=nothing --rpc.unsafe --log_level "main:info,state:info,mempool:info" --trace ``` +6. 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" 54.210.246.165: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":"0xYouEthereumHexAddress"}' 3.95.21.91:3000 +``` + Then your node should start to sync with the network and blocks should be imported. After the node is caught up, it should be ready to interact with the Ethermint network! \ No newline at end of file From 0116b5d0b262edad5fa2ecc0a50d895e6a121eae Mon Sep 17 00:00:00 2001 From: araskachoi Date: Wed, 18 Nov 2020 10:30:54 -0800 Subject: [PATCH 3/5] add rpc instructions --- docs/guides/join_network.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/guides/join_network.md b/docs/guides/join_network.md index 60c2cbe08..f58548a77 100644 --- a/docs/guides/join_network.md +++ b/docs/guides/join_network.md @@ -36,16 +36,22 @@ 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. Request funds from the faucet: +6. Start the RPC server: +``` +ethermintcli rest-server --laddr "tcp://localhost:8545" --unlock-key $KEY --chain-id etherminttestnet-1 --trace +``` +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" 54.210.246.165:8545 +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":"0xYouEthereumHexAddress"}' 3.95.21.91:3000 ``` - -Then your node should start to sync with the network and blocks should be imported. After the node is caught up, it should be ready to interact with the Ethermint network! \ No newline at end of file From 6017b665895a6876484383f30708f58e3f1eabbc Mon Sep 17 00:00:00 2001 From: araskachoi Date: Tue, 24 Nov 2020 15:23:06 -0800 Subject: [PATCH 4/5] edit persistent peers --- docs/guides/join_network.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/guides/join_network.md b/docs/guides/join_network.md index f58548a77..acb0a814f 100644 --- a/docs/guides/join_network.md +++ b/docs/guides/join_network.md @@ -26,7 +26,7 @@ Follow this [link](https://gist.github.com/araskachoi/43f86f3edff23729b817e8b0bb 4. Add peers: Edit the file located in ~/.ethermintd/config/config.toml and edit line 350 (persistent_peers) to the following; ``` -"f618ed93d19dd0b162ef8ba8707f924674454a58@54.210.246.165:26656,24891ad476acc000b20507128ed18e20c6faacc7@18.204.206.179:26656,b765eda477f864743887219d1536698005d7c13e@3.86.104.251:26656" +"6a93c60346eab9968c81036c261daedf7d2ca78f@54.210.246.165:26656,b1a0805e746ccf4c4b27c0cd4d180bdd6932525c@18.204.206.179:26656,7d4e24a6dce1b91add27adbd5e0ccd74a2bd53c2@3.86.104.251:26656" ``` 5. Validate genesis and start the Ethermint network: From 26203e2496df604599c37b5504f585b93251b729 Mon Sep 17 00:00:00 2001 From: araskachoi Date: Fri, 4 Dec 2020 14:02:44 -0800 Subject: [PATCH 5/5] update to latest testnet --- docs/guides/join_network.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/guides/join_network.md b/docs/guides/join_network.md index acb0a814f..234ad1419 100644 --- a/docs/guides/join_network.md +++ b/docs/guides/join_network.md @@ -26,7 +26,7 @@ Follow this [link](https://gist.github.com/araskachoi/43f86f3edff23729b817e8b0bb 4. Add peers: Edit the file located in ~/.ethermintd/config/config.toml and edit line 350 (persistent_peers) to the following; ``` -"6a93c60346eab9968c81036c261daedf7d2ca78f@54.210.246.165:26656,b1a0805e746ccf4c4b27c0cd4d180bdd6932525c@18.204.206.179:26656,7d4e24a6dce1b91add27adbd5e0ccd74a2bd53c2@3.86.104.251:26656" +"aad1e55aa61b9142e57db756b398bb769ec4132a@54.210.246.165:26656,519613343d7d0773fb99da6fffca858d8df33cd4@18.204.206.179:26656,64ffe6743666b0e186638013117f164c5cf16d21@3.86.104.251:26656" ``` 5. Validate genesis and start the Ethermint network: @@ -53,5 +53,16 @@ curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1 ``` 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":"0xYouEthereumHexAddress"}' 3.95.21.91:3000 +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 +``` \ No newline at end of file