chore: docs nits (#2292)

* chore: docs cleanup

* chore: few docs

Author: rakita

book/src/architecture.md

@@ -7,7 +7,7 @@ You can use REVM in two main ways:
 1. Run regular Ethereum transactions using a Execution API
 2. Create your own custom version of the EVM (for Layer 2 solutions or other chains) using EVM framework
 
-To see usage examples you can check the [examples folder](https://github.com/bluealloy/revm/tree/ main/examples). Other than documentation, examples are main resource to see and learn about Revm.
+To see usage examples you can check the [examples folder](https://github.com/bluealloy/revm/tree/main/examples). Other than documentation, examples are main resource to see and learn about Revm.
 
 The main `revm` library combines all crates into one package and reexports them, standalone library are useful if there is need to import functionality with smaller scope. You can see overview of revm crates in [crates folder](https://github.com/bluealloy/revm/tree/main/crates).
 

book/src/awesome.md

@@ -35,10 +35,12 @@ A curated list of excellent Revm-related resources. Feel free to contribute to t
 - [**Revmc:**](https://github.com/paradigmxyz/revmc) JIT and AOT compiler for the Ethereum Virtual Machine, leveraging Revm.
 - [**Risc0-ethereum**](https://github.com/risc0/risc0-ethereum) is a zero-knowledge verifiable general computing platform, with Ethereum integration
 - [**Kona**](https://github.com/op-rs/kona) is a suite of portable implementations of the OP Stack rollup state transition, namely the derivation pipeline and the block execution logic.
+- [**mevlog-rs**](https://github.com/pawurb/mevlog-rs): Rust-based CLI tool for querying and monitoring Ethereum blockchain transactions, with flexible filtering and EVM tracing capabilities. It's a tool for MEV searchers who prefer command-line workflows over web-based explorers.   
 
 
 #### Tutorials
 - (**MyEvm**)
 - **Revm is All You Need:** Guide on building simulated blockchain environments. Link: https://medium.com/@solidquant/revm-is-all-you-need-e01b5b0421e4
 - [**Uniswap Swap Example:**](https://github.com/bluealloy/revm/tree/main/examples/uniswap_get_reserves) Demonstrates a USDC swap on Uniswap V2.evm is available in the [awesome-revm](./awesome.md) section o
-- [**revm-by-example:**](https://github.com/Cionn3/revm-by-example) Practical examples using the Rust Ethereum Virtual Machine.
+- [**revm-by-example:**](https://github.com/Cionn3/revm-by-example) Practical examples using the Rust Ethereum Virtual Machine.
+- How to Discover long-tail MEV Strategies using Revm: https://pawelurbanek.com/long-tail-mev-revm

book/src/contact.md

@@ -13,5 +13,5 @@ Unless you explicitly state otherwise, any contribution intentionally submitted
 
 ### Security
 
-If there is security question/findings please contact me directly on email at`[email protected]` or on keybase [@draganrakita](https://keybase.io/draganrakita/).
+If there is security question/findings please contact me directly on email at`[email protected]` or on keybase `@draganrakita`
 

crates/database/src/states/state.rs

@@ -87,9 +87,6 @@ impl<DB: Database> State<DB> {
     ///
     /// Update will create transitions for all accounts that are updated.
     ///
-    /// Like [CacheAccount::increment_balance], this assumes that incremented balances are not
-    /// zero, and will not overflow once incremented.
-    ///
     /// If using this to implement withdrawals, zero balances must be filtered out before calling this function.
     pub fn increment_balances(
         &mut self,

examples/README.md

@@ -1,10 +1,9 @@
 # examples:
-* block_traces:
-* contract_deployment: 
-* database_components: 
-* uniswap_get_reserves: 
-* uniswap_v2_usdc_swap: 
-* erc20_gas: 
-* my_evm: 
-* custom_opcodes: 
-* #cheatcode_inspector: 
+* `contract_deployment`: Example of deployment of the contract from solidity compilation and calling deployed contract.
+* `my_evm`: Example and tutorial on how to create your custom evm.
+* `erc20_gas`: Example of custom EVM that uses ERC20 token to pay for Gas.
+* `uniswap_get_reserves`: Example of using alloy to fetch state and sol! to call a function of the contract.
+* `uniswap_v2_usdc_swap`: Similar to `uniswap_get_reserves` with more examples of usage.
+* `block_traces`: Uses Alloy to fetch blocks transaction and state from provider to execute full block. It uses Eip3155 opcode tracer and saves output to the file.
+* `custom_opcodes`: Example of introducing a custom instruction to the mainnet Evm.
+* `database_components`: Example of decouples Database in `State` and `BlockHash` and how to use it inside Revm.