diff --git a/README.md b/README.md
index 9721af6..bb33f52 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,39 @@
-# XLayer Reth
+
+
+
[](https://opensource.org/licenses/MIT)
[](https://opensource.org/licenses/Apache-2.0)
[](https://www.rust-lang.org/)
[](https://github.com/okx/xlayer-reth/releases)
+[](https://github.com/paradigmxyz/reth/releases/tag/v1.11.3)
-
-## Overview
+# XLayer Reth
XLayer Reth is a customized implementation of [Reth](https://github.com/paradigmxyz/reth) optimized for the XLayer network, an Optimism-based Layer 2 solution.
This project provides a high-performance, production-ready Ethereum execution client tailored for XLayer's specific requirements. It builds upon the upstream Reth codebase with custom optimizations and features for the XLayer network.
+**[Run a dev node](#running-a-dev-node)** | **[Build a node](#building-from-source)** | **[Contribute to XLayer Reth](#contributing)**
+
+---
+
+## Table of Contents
+
+- [Getting Started](#getting-started)
+ - [Prerequisites](#prerequisites)
+ - [Building from Source](#building-from-source)
+ - [Docker Build](#docker-build)
+- [Initialization](#initialization)
+- [Running a Dev Node](#running-a-dev-node)
+- [Configuration](#configuration)
+- [Development](#development)
+- [Testing](#testing)
+ - [End-to-end Testing](#end-to-end-testing)
+ - [Flashblocks Tests](#flashblocks-tests)
+- [Contributing](#contributing)
+- [License](#license)
+
### Why built on top of Reth
XLayer Reth is built on top of [Reth](https://github.com/paradigmxyz/reth), extending it with XLayer-specific functionality:
@@ -96,6 +118,38 @@ xlayer-reth-node init --chain /path/to/genesis.json --datadir /data/xlayer
> **Note**: The `init` command only needs to be run once before the first start. It creates the database and writes the genesis block.
+## Running a Dev Node
+
+For local development and testing, you can run a dev node without requiring an external sequencer or L1 connection. The dev mode automatically mines blocks at a configurable interval.
+
+```bash
+OTEL_EXPORTER_OTLP_PROTOCOL=http cargo r -p xlayer-reth-node node \
+ --datadir .op-reth-ttt \
+ --engine.legacy-state-root \
+ --dev \
+ --dev.block-time 1s \
+ --builder.gaslimit 1500000000 \
+ --txpool.pending-max-count 10000000 \
+ --txpool.pending-max-size 10000 \
+ --txpool.basefee-max-count 10000000 \
+ --txpool.basefee-max-size 10000 \
+ --txpool.queued-max-count 10000000 \
+ --txpool.queued-max-size 10000 \
+ --txpool.blobpool-max-count 10000000 \
+ --txpool.blobpool-max-size 10000 \
+ --txpool.max-account-slots 10000000 \
+ --http \
+ --http.api eth,debug,net,web3,txpool \
+ --log.stdout.filter "info,engine::tree::payload_validator=debug"
+```
+
+Key flags:
+- `--dev`: Enables dev mode (auto-mining, no consensus required)
+- `--dev.block-time 1s`: Mine a new block every second
+- `--engine.legacy-state-root`: Use legacy state root computation
+- `--http` / `--http.api`: Enable HTTP RPC with the listed namespaces
+- `--datadir`: Directory for node data (created automatically if it doesn't exist)
+
## Configuration
XLayer Reth inherits all configuration options from [Reth](https://reth.rs/) and [OP Reth](https://github.com/paradigmxyz/reth). Run `xlayer-reth-node --help` for a complete list.
diff --git a/xlayer-logo.png b/xlayer-logo.png
new file mode 100644
index 0000000..b0f3416
Binary files /dev/null and b/xlayer-logo.png differ