Skip to content

Commit

Permalink
Update learn page
Browse files Browse the repository at this point in the history
  • Loading branch information
boundless-forest committed May 22, 2024
1 parent feecd28 commit 199fa03
Show file tree
Hide file tree
Showing 6 changed files with 12 additions and 20 deletions.
12 changes: 0 additions & 12 deletions docs/learn/darwinia.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/learn/ethereum-compatibility/account-system.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Account System
# Substrate Or Ethereum Account

The Darwinia network aspires to be a robust smart contract platform that boasts high compatibility with Ethereum. One of the primary areas of incompatibility lies in the account system. Utilizing the Substrate framework, Darwinia's default account system and signature protocols are significantly different from Ethereum's. This discrepancy means users cannot leverage Ethereum's battle-tested tools directly, necessitating additional learning to navigate our platform effectively. Such a requirement poses a barrier to entry for both casual traders and seasoned application developers.

Expand Down
2 changes: 1 addition & 1 deletion docs/learn/ethereum-compatibility/gas.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ One concern for smart contract developers is the gas mechanism. If there is a la

As explained above, Darwinia's EVM highly relies on opcode compatibility with the official Ethereum implementation. However, the unique underlying blockchain framework complicates matters. One key concept in the Polkadot relay chain and parachain architecture is "proof size". For parachains, there's a proof size limit of 5M; if exceeded, the relay chain will reject the inclusion of the parachain block, causing the parachain to hang. Considering this limitation, Darwinia's EVM gas calculation incorporates two components: opcode gas, identical to Ethereum's, and proof size cost. The final gas calculation is the greater of these two values. If discrepancies in gas usage are observed during contract interactions compared to Ethereum, this may be the underlying cause. We are actively seeking additional methods to resolve this problem.

## BlockGasLimit Limitation
## `BlockGasLimit` Limitation

In Ethereum, the number of pending transactions that can be included in the next block depends on the amount of gas each transaction consumes. When miners create new blocks, the total gas limit of all transactions in the block must be less than the block's gas limit. Since the London hard fork, each block has a target size of 15 million gas units, but the actual size of a block can vary depending on network demand. The maximum size of a block, known as the block gas limit, is set to **30 million** gas units.

Expand Down
5 changes: 5 additions & 0 deletions docs/learn/ethereum-compatibility/overview.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Overview

The Darwinia network inherits its EVM compatibility from the Polkadot EVM layer [Frontier](https://github.com/polkadot-evm/frontier). It keeps up with the latest Ethereum innovations, maintains opcode compatibility, and makes an effort to minimize incompatibility issues for applications developed on the Ethereum chain.

However, there are some key considerations to keep in mind when using the Darwinia network. This chapter serves as an introduction to these important points, and is a valuable resource to refer to when you encounter unexpected issues while developing on Darwinia.
6 changes: 2 additions & 4 deletions docs/learn/governance.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
# Governance

Currently, Darwinia employs OpenGov for governance. For more details on how it functions, please consult the Polkadot official [WIKI](https://wiki.polkadot.network/docs/learn-polkadot-opengov-index).
Currently, Darwinia employs OpenGov for governance. For more details on how it functions, please consult the Polkadot official [WIKI](https://wiki.polkadot.network/docs/learn-polkadot-opengov-index). We plans to transition from OpenGov to Tally in the future.

Darwinia plans to transition from OpenGov to Tally in the future.

Check out the [tutorial](../community/guide/governance.md).
Check out the [tutorial](../community/guide/governance.md) for how to use it.

## Parameters

Expand Down
5 changes: 3 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -312,12 +312,13 @@ plugins:
nav:
- Learn:
- What is Darwinia?: "index.md"
- Governance: "learn/governance.md"
- Ethereum Compatibility:
- Account System: "learn/ethereum-compatibility/account-system.md"
- Overview: "learn/ethereum-compatibility/overview.md"
- JSON-RPC APIs: "learn/ethereum-compatibility/jsonrpc.md"
- Substrate Or Ethereum Account: "learn/ethereum-compatibility/account-system.md"
- Gas: "learn/ethereum-compatibility/gas.md"
- EVM Tracing: "learn/ethereum-compatibility/evm-tracing.md"
- Governance: "learn/governance.md"
- Collator Staking: "learn/collator-staking.md"
- FAQ: "learn/faq.md"
- Developers:
Expand Down

0 comments on commit 199fa03

Please sign in to comment.