ethereum / ethereum-org-website

Ethereum.org is a primary online resource for the Ethereum community.
https://ethereum.org/
MIT License
4.91k stars 4.68k forks source link

Review texts still referring to mining/miners etc. #12030

Open Satglow opened 5 months ago

Satglow commented 5 months ago

Describe the bug

Several articles still refer to miners/mining/proof-of-work as the current process. This should be reviewed whether it is still relevant, or only relevant for queries of archived data (e.g. for fields of tables/functions). The context should be highlighted, if we still use them somewhere. (This bug is not related to the descriptions of the processes before the Merge.) I have found the following examples:

12/Nodes and clients

The light nodes do not participate in consensus (i.e. they cannot be miners/validators), but they can access the Ethereum blockchain with the same functionality and security guarantees as a full node.

12/Client diversity

Addressing client diversity requires more than individual users to choose minority clients - it requires mining/validator pools and institutions like the major dapps and exchanges to switch clients too.

15/Data and Analytics

Many Block Explorers offer RESTful API gateways that will provide developers visibility into real-time data on blocks, transactions, miners, accounts, and other on-chain activity.

15/JSON-RPC

String "latest" - for the latest mined block

Use eth_getTransactionReceipt to get the contract address, after the transaction was mined, when you created a contract.

(eth_getBlockByHash function’s return:) nonce: DATA, 8 Bytes - hash of the generated proof-of-work. miner: DATA, 20 Bytes - the address of the beneficiary to whom the mining rewards were given.

(eth_newFilter function’s parameters:) fromBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions. toBlock: QUANTITY|TAG - (optional, default: "latest") Integer block number, or "latest" for the last mined block or "pending", "earliest" for not yet mined transactions.

Wait for a moment and check if your miner is running and retry it.

16/Anatomy of a smart contract

When a transaction is mined, smart contracts can emit events and write logs to the blockchain that the frontend can then process.

19/Ethereum Glossary terms

The algorithm used to identify the head of the blockchain. On the execution layer the head of the chain is identified as the one with the greatest total difficulty behind it. This means the true head of the chain is the one that required the most work to mine it. On the consensus layer the algorithm observes the accumulated attestations from validators (LMD_GHOST).

(Reward’s definition:) An amount of ether included in each new block as a reward by the network to the miner who found the proof-of-work solution.

22/Patricia Merkle Tries

transactionIndex is its index within the block it's mined.

22/Networking layer

Transaction exchange refers to exchanging pending transactions between nodes so that miners can select some of them for inclusion in the next block.

23/Misc/Ethereum Mainnet for enterpise

Ethereum Mainnet is secured by the interaction of thousands of independent nodes run by individuals and miners throughout the world.

To reproduce

See description above.

Expected behavior

Review the content and correct it as per set up/process.

Screenshots

No response

Desktop (please complete the following information)

No response

Smartphone (please complete the following information)

No response

Additional context

No response

Would you like to work on this issue?

github-actions[bot] commented 3 months ago

This issue is stale because it has been open 45 days with no activity.

d0ra-1h3-3xpl0ra commented 3 months ago

I can help after triage is done and the scope is set. lmk

github-actions[bot] commented 2 months ago

This issue is stale because it has been open 45 days with no activity.

wackerow commented 3 weeks ago

Thanks @Satglow! Appreciate you curating this list, I agree with your proposed changes.

Hey @d0ra-1h3-3xpl0ra, would you still be interested in working on this? Will go ahead and assign you for now; can always re-assign if you don't have capacity.

corwintines commented 5 days ago

Just wanted to check @d0ra-1h3-3xpl0ra if you were still interested in this. If not, will open this back up next loop through.