Merge pull request #272 from sei-protocol/alexander-patch

Improve differences with Ethereum Page

Author: alexander-sei

content/evm/building-a-frontend.mdx

@@ -25,7 +25,6 @@ Ethers.js is ideal for developers who want a comprehensive, battle-tested librar
   - Works well with both TypeScript and JavaScript
   - All-in-one solution for wallet connection and contract interaction
 - **Cons**:
-
   - Larger bundle size compared to Viem
   - Not specifically designed for React hooks integration
 
@@ -39,7 +38,6 @@ Viem is perfect for developers who want fine-grained control over their blockcha
   - Lower-level API gives more control
   - Smaller bundle size
 - **Cons**:
-
   - Steeper learning curve
   - Requires more boilerplate code for some operations
   - Requires separate handling for wallet connection and contract interactions
@@ -79,7 +77,7 @@ This command creates a new folder with a React project using TypeScript. Open `s
 
 ## Project Structure
 
-For clarity, we'll create separate components for each library implementation. Let's set up the project structure:
+For clarity, we'll create separate components for each library implementation. First, let's set up the project structure:
 
 ```bash copy
 cd sei-token-interface
@@ -808,7 +806,7 @@ npm run dev
 
 This will start a local development server, at `http://localhost:5173`. You can toggle between the different library implementations to see how each one works.
 
-To build your application, build first:
+To build your application, run:
 
 ```bash copy
 npm run build

content/evm/differences-with-ethereum.mdx

@@ -1,13 +1,33 @@
+import { Callout } from 'nextra/components';
+
 # Divergence from Ethereum
 
 While Sei features full EVM compatibility, there are some distinctions between
-Sei's EVM and Ethereum itself.
-
-## EVM Differences
-
-Unlike Ethereum mainnet which is on Cancun for its execution layer, Sei uses the
-Shanghai version of EVM. This means that features like blob transactions are not
-supported on Sei.
+Sei's EVM and Ethereum itself:
+
+|                       | Sei                                                                                   | Ethereum Mainnet                                                     |
+| --------------------- | ------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| Gas per Second        | ~ 25 MegaGas/s                                                                        | ~ 3 MegaGas/s                                                        |
+| TPS                   | ~ 12,500                                                                              | ~ 11                                                                 |
+| Block time            | 400 ms                                                                                | 12 s                                                                 |
+| Finality              | Instant                                                                               | Various commitment levels (i.e., safe, latest, justified, finalized) |
+| EVM Version           | Shanghai                                                                              | Cancun                                                               |
+| Gas Limit             | 10 M                                                                                  | 36 M                                                                 |
+| Byte Size Limit       | 21 MB                                                                                 | No byte-denominated limits                                           |
+| Execution environment | EVM and CosmWasm                                                                      | EVM                                                                  |
+| Address space         | Dual ECDSA-derived addresses; sei-native Bech32 (sei…) + EVM-compatible address (0x…) | ECDSA-derived address (0x…)                                          |
+
+- Sei uses the [Shanghai](https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/shanghai.md) version of EVM. This means features rolled out on Ethereum mainnet via the [Cancun](https://github.com/ethereum/execution-specs/blob/master/network-upgrades/mainnet-upgrades/cancun.md) upgrade (i.e., EIP-4844 or blob transactions) are not supported on Sei
+- Sei’s gas limit is 10M as opposed to Ethereum’s 30M. Sei also has a byte size limit of 21MB.
+- Sei has instant finality. This means the various commitment levels typical for Ethereum (i.e., safe, latest, justified) do not apply on Sei.
+
+- **Sei is a dual-execution environment (EVM and CosmWasm).** This means:
+  - Non-EVM transactions can update EVM-accessible state.
+    - For example, an account’s SEI balance can be affected by both Cosmos (bank send, wasm execute) transactions as well as EVM send transactions
+  - Sei assets can not only exist as EVM (i.e., ERC20/721/1155), but also as CW (i.e., CW20, CW721) or as native (Sei, IBC, Tokenfactory).
+  - User accounts on Sei have [two addresses](https://www.docs.sei.io/learn/account-structure) derived from the same public key (sei-native Bech32 and EVM-compatible 0x…)
+
+<Callout type="info">💡 Interoperability between EVM and CosmWasm is governed and navigated via [precompiles](./precompiles/example-usage) and [pointer contracts](./pointers/standard)</Callout>
 
 ## Opcode Differences
 
@@ -58,14 +78,6 @@ subspace: evm
 value: '"0.007500000000000000"'
 ```
 
-## Block Limit
-
-Sei has a gas limit of 10M on `pacific-1`, compared to
-Ethereum’s 30M.
-
-In addition, Sei also has a byte size limit of 21MB, whereas Ethereum doesn’t
-have byte-denominated limits.
-
 ## Non-EVM Transactions
 
 On Sei there exists non-EVM transactions which may update states accessible by