Skip to content

docs(node): add stateless validator architecture guide #46

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.

Sign up for GitHub

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

Merged
flyq merged 15 commits into from
May 9, 2026
+390 −14
Merged

docs(node): add stateless validator architecture guide #46

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
2c3d627
add validator arch
flyq May 6, 2026
0a21ac7
docs(node): document what the validator reads from genesis
flyq May 8, 2026
4152e7d
docs(node): address PR #46 review comments
flyq May 8, 2026
c2e3679
Update validator-architecture.md
flyq May 8, 2026
c0ca33e
fix review
flyq May 8, 2026
c684f82
docs: tighten precompiles row, defer details to spec page
flyq May 8, 2026
e6c03af
docs(node): correct pre/post-execution hooks, wrap reference-impl in …
Troublor May 8, 2026
62c08fe
fix fmt
flyq May 8, 2026
0a2c957
fix review
flyq May 8, 2026
bfe4b5e
docs(node): address PR #46 round 5 nits
flyq May 9, 2026
d1913cf
fix review
flyq May 9, 2026
dc62636
fix review
flyq May 9, 2026
4ae7aa1
fix the code line
flyq May 9, 2026
e67f3de
add eth_getCodeByHash
flyq May 9, 2026
53da992
fix review
flyq May 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions docs/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,20 +59,20 @@ When in doubt: top-level pages prioritize readability, layer pages prioritize de

Use these exact forms consistently. Do not alternate between variants.

| Term | Correct | Incorrect |
| --------------------- | ------------------------------------ | ----------------------------------------------------------- |
| Project name | MegaETH | megaETH, Mega ETH, megaeth, MEGAETH |
| EVM implementation | MegaEVM | MegaEvm, mega-evm, Mega EVM |
| Mainnet (proper noun) | MegaETH Mainnet | MegaETH mainnet, main net, main-net |
| Testnet (proper noun) | MegaETH Testnet | MegaETH testnet, test net, test-net |
| Currency ticker | ETH | eth, Eth |
| Currency name | ether | Ether, ETH (when referring to the currency, not the ticker) |
| Block type | mini-block | miniblock, mini block, MiniBlock |
| Onchain / offchain | onchain, offchain | on-chain, off-chain, on chain |
| Smart contract | smart contract | Smart Contract, smartcontract |
| Gas dimensions | compute gas, storage gas | Compute Gas, Storage Gas, Compute gas |
| Spec names | MiniRex, Rex, Rex1, Rex2, Rex3, Rex4 | minirex, MINIREX, mini-rex, rex-3 |
| State trie | SALT | Salt, salt |
| Term | Correct | Incorrect |
| --------------------- | -------------------------------------------------------- | ----------------------------------------------------------- |
| Project name | MegaETH | megaETH, Mega ETH, megaeth, MEGAETH |
| EVM implementation | MegaEVM | MegaEvm, mega-evm, Mega EVM |
| Mainnet (proper noun) | MegaETH Mainnet | MegaETH mainnet, main net, main-net |
| Testnet (proper noun) | MegaETH Testnet | MegaETH testnet, test net, test-net |
| Currency ticker | ETH | eth, Eth |
| Currency name | ether | Ether, ETH (when referring to the currency, not the ticker) |
| Block type | mini-block | miniblock, mini block, MiniBlock |
| Onchain / offchain | onchain, offchain | on-chain, off-chain, on chain |
| Smart contract | smart contract | Smart Contract, smartcontract |
| Gas dimensions | compute gas, storage gas | Compute Gas, Storage Gas, Compute gas |
| Spec names | MiniRex, MiniRex1, MiniRex2, Rex, Rex1, Rex2, Rex3, Rex4 | minirex, MINIREX, mini-rex, rex-3 |
| State trie | SALT | Salt, salt |

**Capitalization rules:**

Expand Down
1 change: 1 addition & 0 deletions docs/SUMMARY.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,4 +44,5 @@
## Node Operation

- [Stateless Validation](node/stateless-validation.md)
- [Validator Architecture](node/validator-architecture.md)
- [Get Block Witness](node/witness.md)
Loading
Loading