wip: update readme

Author: dylanlott

README.md

@@ -1,20 +1,23 @@
 # The Signet Block Builder
 
-The Builder is responsible for transactions through the Signet rollup, from ingestion and simulation to block construction and submission to Ethereum L1.
+The Builder simulates bundles and transactions against the latest chain state to create valid Signet rollup blocks and submits them to the configured host chain as an [EIP-4844 transaction](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-4844.md).
+
+Bundles are treated as Flashbots-style bundles, meaning that the Builder should respect transaction ordering, bundle atomicity, and the specified revertability.
 
 ---
 
 ## 🚀 System Design
 
-The Builder orchestrates a series of asynchronous actors that work together to:
+The Builder orchestrates a series of asynchronous actors that work together to build blocks for every assigned slot.
 
 1. **Env** - watches the latest host and rollup blocks to monitor gas rates and block updates.
 2. **Cache** - polls bundle and transaction caches and adds them to the cache.
-3. **Simulator** - simulates transactions against rollup state and block environment to build them into a cohesive block.
-5. **Submit** - builds a blob transaction of the built block and sends it to Ethereum L1.
-6. **Metrics** - records block and tx data.
+3. **Simulator** - simulates transactions and bundles against rollup state and block environment to build them into a cohesive block.
+5. **Submit** - creates a blob transaction from the built block and sends it to Ethereum L1.
+6. **Metrics** - records block and tx data over time.
 
 ```mermaid
+%%{ init : { "theme" : "dark" } }%%
 flowchart TD
     %% ────────────── INITIALIZATION ──────────────
     A0(["Start main"]) --> A1[Init tracing & logging]
@@ -30,11 +33,11 @@ flowchart TD
     end
 
     %% ────────────── CONNECTIONS & DATA FLOW ──────────────
-    A2_BuilderConfig --> A4_Providers["Connect Providers"]
-
-    A4_Providers -.host_provider.-> MetricsTaskActor
-    A4_Providers -.host_provider.->SubmitTaskActor
-    A4_Providers -.ru_provider.-> SimulatorTaskActor
+    A2_BuilderConfig -.host_provider.-> MetricsTaskActor
+    A2_BuilderConfig -.host_provider.->SubmitTaskActor
+    A2_BuilderConfig -.ru_provider.-> SimulatorTaskActor
+    A2_BuilderConfig -.host_provider.-> EnvTaskActor
+    A2_BuilderConfig -.ru_provider.-> EnvTaskActor
 
     EnvTaskActor ==block_env==> SimulatorTaskActor
     CacheSystem ==sim_cache ==> SimulatorTaskActor
@@ -73,6 +76,36 @@ The Builder is configured via environment variables. The following values are su
 
 ---
 
+## 💾 EVM Behavior
+
+### 🗿 Inherited Header Values
+
+`PREVRANDAO` is set to a random byte string for each block.
+
+```rust
+// `src/tasks/env.rs`
+prevrandao: Some(B256::random()),
+```
+
+`TIMESTAMP` - Block timestamps are set to the same value as the current Ethereum block.
+
+Blob gas values `excess_blob_gas` and `blob_gasprice` are also set to 0 for all Signet blocks.
+
+### 🔢 Disabled Opcodes 
+
+`BLOBHASH` - EIP-4844 is not supported on Signet.
+`BLOBBASEFEE` - EIP4844 is not supported.
+
+## ⛽ Transaction Submission
+
+When a completed, non-empty Signet block is received by the Submit task, it prepares the block data into a blob transaction and submits it to the network. 
+
+If it fails, it will retry up to 3 times with a 12.5% bump on each retry. 
+
+The previous header's basefee is tracked through the build loop and used for gas estimation purposes in the Submit Task.
+
+---
+
 ## 📤 Transaction Sender
 
 A binary (`bin/submit-transaction.rs`) for continously sending very small transactions for testing block construction.
@@ -87,6 +120,10 @@ The following values are available for configuring the transaction sender:
 | `SIGNER_CHAIN_ID`   | Yes      | Chain ID used for signing                        |
 | `SIGNER_KEY`        | Yes      | Signing key used to sign the transaction         |
 
+The transaction submitter is located at `bin/submit_transaction.rs`.
+
+Run the transaction submitter with `cargo run --bin transaction-submitter`
+
 ---
 
 ## 🛠️ Development

src/test_utils.rs

@@ -45,6 +45,7 @@ pub fn setup_test_config() -> Result<BuilderConfig> {
             1740681556, // pecorino start timestamp as sane default
             0, 1,
         ),
+        block_confirmation_buffer: todo!(),
     };
     Ok(config)
 }