Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

02intro chapter change: Added Sepolia Testnetwork to Switching networks, changed ropsten to sepolia in gettting some ether,sending ether from metamask, and exploring transaction history of an address. #1197

Open
wants to merge 5 commits into
base: develop
Choose a base branch
from
22 changes: 12 additions & 10 deletions 02intro.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -153,6 +153,8 @@ Congratulations! You have set up your first Ethereum wallet.(((range="endofrange

Main Ethereum Network:: The main public Ethereum blockchain. Real ETH, real value, and real consequences.

Sepolia Test Network:: Sepolia is a public Proof-of-Stake (PoS) testnet. It was named after a neighborhood in Athens, Greece, where one of the Ethereum developers grew up. Currently, Sepolia is the recommended default testnet for smart contract development.

Ropsten Test Network:: Ethereum public test blockchain and network. ETH on this network has no value.

Kovan Test Network:: Ethereum public test blockchain and network using the Aura consensus protocol with proof of authority (federated signing). ETH on this network has no value. The Kovan test network is supported by Parity only. Other Ethereum clients use the Clique consensus protocol, which was proposed later, for proof of authority–based verification.
Expand All @@ -173,11 +175,11 @@ Your MetaMask wallet uses the same private key and Ethereum address on all the n

((("ether (generally)","testnet")))((("MetaMask","and testnet ether")))((("test ether","obtaining")))((("testnet","ether for")))((("wallets","testnet ether and")))Your first task is to get your wallet funded. You won't be doing that on the main network because real ether costs money and handling it requires a bit more experience. For now, you'll load your wallet with some testnet ether.

((("Ropsten Test Network")))Switch MetaMask to the _Ropsten Test Network_. Click Deposit, then click Ropsten Test Faucet. MetaMask will open a new web page, as shown in <<metamask_ropsten_faucet>>.
((("Sepolia Test Network")))Switch MetaMask to the _Sepolia Test Network_. Click Deposit, then click Sepolia Test Faucet. MetaMask will open a new web page, as shown in <<metamask_sepolia_faucet>>.

[[metamask_ropsten_faucet]]
[[metamask_sepolia_faucet]]
.MetaMask Ropsten Test Faucet
image::images/metamask_ropsten_faucet.png["MetaMask Ropsten Test Faucet"]
image::images/metamask_sepolia_faucet.png["MetaMask Sepolia Test Faucet"]

You may notice that the web page already contains your MetaMask wallet's Ethereum address. MetaMask integrates Ethereum-enabled web pages with your MetaMask wallet and can "see" Ethereum addresses on the web page, allowing you, for example, to send a payment to an online shop displaying an Ethereum address. MetaMask can also populate the web page with your own wallet's address as a recipient address if the web page requests it. In this page, the faucet application is asking MetaMask for a wallet address to send test ether to.

Expand All @@ -188,20 +190,20 @@ Click the green "request 1 ether from faucet" button. You will see a transaction
0x7c7ad5aaea6474adccf6f5c5d6abed11b70a350fbc6f9590109e099568090c57
----

In a few seconds, the new transaction will be mined by the Ropsten miners and your MetaMask wallet will show a balance of 1 ETH. Click on the transaction ID and your browser will take you to a _block explorer_, which is a website that allows you to visualize and explore blocks, addresses, and transactions. MetaMask uses the https://etherscan.io/[Etherscan block explorer], one of the more popular Ethereum block explorers. The transaction containing the payment from the Ropsten Test Faucet is shown in <<ropsten_block_explorer>>.
In a few seconds, the new transaction will be mined by the Sepolia miners and your MetaMask wallet will show a balance of 1 ETH. Click on the transaction ID and your browser will take you to a _block explorer_, which is a website that allows you to visualize and explore blocks, addresses, and transactions. MetaMask uses the https://etherscan.io/[Etherscan block explorer], one of the more popular Ethereum block explorers. The transaction containing the payment from the Ropsten Test Faucet is shown in <<sepolia_block_explorer>>.

[[ropsten_block_explorer]]
.Etherscan Ropsten block explorer
image::images/ropsten_block_explorer.png["Etherscan Ropsten Block Explorer"]
[[sepolia_block_explorer]]
.Etherscan Sepolia block explorer
image::images/sepolia_block_explorer.png["Etherscan Sepolia Block Explorer"]

The transaction has been recorded on the Ropsten blockchain and can be viewed at any time by anyone, simply by searching for the transaction ID, or http://bit.ly/2Q860Wk[visiting the link].

Try visiting that link, or entering the transaction hash into the _ropsten.etherscan.io_ website, to see it for yourself.
Try visiting that link, or entering the transaction hash into the _sepolia.etherscan.io_ website, to see it for yourself.

[[sending_eth_MetaMask]]
==== Sending Ether from MetaMask

((("MetaMask","sending ether from", id="ix_02intro-asciidoc6", range="startofrange")))((("test ether","sending", id="ix_02intro-asciidoc7", range="startofrange")))Once you've received your first test ether from the Ropsten Test Faucet, you can experiment with sending ether by trying to send some back to the faucet. As you can see on the Ropsten Test Faucet page, there is an option to "donate" 1 ETH to the faucet. This option is available so that once you're done testing, you can return the remainder of your test ether, so that someone else can use it next. Even though test ether has no value, some people hoard it, making it difficult for everyone else to use the test networks. Hoarding test ether is frowned upon!
((("MetaMask","sending ether from", id="ix_02intro-asciidoc6", range="startofrange")))((("test ether","sending", id="ix_02intro-asciidoc7", range="startofrange")))Once you've received your first test ether from the Sepolia Test Faucet, you can experiment with sending ether by trying to send some back to the faucet. As you can see on the Sepolia Test Faucet page, there is an option to "donate" 1 ETH to the faucet. This option is available so that once you're done testing, you can return the remainder of your test ether, so that someone else can use it next. Even though test ether has no value, some people hoard it, making it difficult for everyone else to use the test networks. Hoarding test ether is frowned upon!

Fortunately, we are not test ether hoarders. Click the orange "1 ether" button to tell MetaMask to create a transaction paying the faucet 1 ether. MetaMask will prepare a transaction and pop up a window with the confirmation, as shown in <<send_to_faucet>>.

Expand Down Expand Up @@ -230,7 +232,7 @@ Once you have a balance of 2 ETH, you can try again. This time, when you click t
[[explore_tx_history]]
==== Exploring the Transaction History of an Address

((("addresses","exploring transaction history of", id="ix_02intro-asciidoc8", range="startofrange")))((("MetaMask","exploring transaction history of an address with", id="ix_02intro-asciidoc9", range="startofrange")))By now you have become an expert in using MetaMask to send and receive test ether. Your wallet has received at least two payments and sent at least one. You can view all these transactions using the _ropsten.etherscan.io_ block explorer. You can either copy your wallet address and paste it into the block explorer's search box, or have MetaMask open the page for you. Next to your account icon in MetaMask, you will see a button showing three dots. Click on it to show a menu of account-related options (see <<metamask_account_context_menu>>).
((("addresses","exploring transaction history of", id="ix_02intro-asciidoc8", range="startofrange")))((("MetaMask","exploring transaction history of an address with", id="ix_02intro-asciidoc9", range="startofrange")))By now you have become an expert in using MetaMask to send and receive test ether. Your wallet has received at least two payments and sent at least one. You can view all these transactions using the _sepolia.etherscan.io_ block explorer. You can either copy your wallet address and paste it into the block explorer's search box, or have MetaMask open the page for you. Next to your account icon in MetaMask, you will see a button showing three dots. Click on it to show a menu of account-related options (see <<metamask_account_context_menu>>).

[[metamask_account_context_menu]]
.MetaMask account context menu
Expand Down