feat: add proposer selection

bin/ev-reth/src/main.rs

@@ -6,10 +6,6 @@
 #![allow(missing_docs, rustdoc::missing_crate_level_docs)]
 
 use clap::Parser;
-use evolve_ev_reth::{
-    config::EvolveConfig,
-    rpc::txpool::{EvolveTxpoolApiImpl, EvolveTxpoolApiServer},
-};
 use reth_ethereum_cli::Cli;
 use reth_tracing_otlp::{OtlpConfig, OtlpProtocol};
 use tracing::info;
@@ -98,20 +94,9 @@ fn main() {
     if let Err(err) =
         Cli::<EvolveChainSpecParser, EvolveArgs>::parse().run(|builder, _evolve_args| async move {
             log_startup();
-            let handle = builder
-                .node(EvolveNode::new())
-                .extend_rpc_modules(move |ctx| {
-                    // Build custom txpool RPC with config + optional CLI/env override
-                    let evolve_cfg = EvolveConfig::default();
-                    let evolve_txpool =
-                        EvolveTxpoolApiImpl::new(ctx.pool().clone(), evolve_cfg.max_txpool_bytes);
-
-                    // Merge into all enabled transports (HTTP / WS)
-                    ctx.modules.merge_configured(evolve_txpool.into_rpc())?;
-                    Ok(())
-                })
-                .launch()
-                .await?;
+            // The evolve txpool and proposer RPC modules are registered by
+            // `EvolveNode::add_ons`.
+            let handle = builder.node(EvolveNode::new()).launch().await?;
 
             info!("=== EV-RETH: Node launched successfully with ev-reth payload builder ===");
             handle.node_exit_future.await

crates/ev-precompiles/README.md

@@ -4,7 +4,7 @@ Custom EVM precompiles for Evolve, providing native token supply management func
 
 ## Overview
 
-This crate implements custom precompiled contracts that extend the EVM with Evolve-specific functionality. Currently, it provides a mint/burn precompile that allows controlled manipulation of native token supply.
+This crate implements custom precompiled contracts that extend the EVM with Evolve-specific functionality. It provides a mint/burn precompile for controlled native token supply management and a proposer-control precompile for execution-owned ev-node proposer rotation.
 
 ## Mint Precompile
 
@@ -190,3 +190,71 @@ cast send --rpc-url $RPC_URL --private-key $OPERATOR_KEY \
   0x000000000000000000000000000000000000f100 \
   "mint(address,uint256)" 0xRECIPIENT 1000000000000000000
 ```
+
+## Proposer Control Precompile
+
+The proposer control precompile stores the ev-node proposer that should sign the next block. It is
+used by the ev-node EVM execution adapter to populate ADR-023's `NextProposerAddress` from execution
+state.
+
+### Address
+
+```
+0x000000000000000000000000000000000000f101
+```
+
+### Interface
+
+```solidity
+interface IProposerControl {
+    function nextProposer() external view returns (bytes32);
+    function setNextProposer(bytes32 proposer) external;
+    function admin() external view returns (address);
+}
+```
+
+The proposer is an opaque 32-byte value rather than an `address` so it can hold proposer
+identities that are not 20-byte EVM addresses (ev-node signer keys). For an EVM address,
+left-pad it to 32 bytes. The precompile only rejects the zero value; it does not validate
+that the bytes encode a usable proposer identity, so the admin must submit a correct value.
+
+### Configuration
+
+```json
+{
+  "config": {
+    "evolve": {
+      "proposerControlAdmin": "0x1234567890123456789012345678901234567890",
+      "proposerControlActivationHeight": 0,
+      "initialNextProposer": "0x000000000000000000000000abcdefabcdefabcdefabcdefabcdefabcdefabcd"
+    }
+  }
+}
+```
+
+`initialNextProposer` is a 32-byte value (a 20-byte address must be left-padded, as above).
+For existing chains, set `proposerControlActivationHeight` to a future block and upgrade all nodes
+before that height. `initialNextProposer` should be the currently active proposer so reads are stable
+before the first rotation transaction.
+
+### Operations
+
+The configured admin rotates the next proposer with:
+
+```bash
+cast send --rpc-url $RPC_URL --private-key $ADMIN_KEY \
+  0x000000000000000000000000000000000000f101 \
+  "setNextProposer(bytes32)" \
+  0x000000000000000000000000$(echo $NEXT_PROPOSER_ADDR | cut -c3-)
+```
+
+The stored proposer can be read through either the precompile ABI or ev-reth's convenience RPC
+(only registered when `proposerControlAdmin` is configured):
+
+```bash
+cast call --rpc-url $RPC_URL \
+  0x000000000000000000000000000000000000f101 \
+  "nextProposer()(bytes32)"
+
+cast rpc --rpc-url $RPC_URL evolve_getNextProposer latest
+```

crates/ev-precompiles/src/lib.rs

@@ -1 +1,2 @@
 pub mod mint;
+pub mod proposer;