Builder Specs v0.2.0 (#3134)

## Issue Addressed

https://github.com/sigp/lighthouse/issues/3091

Extends https://github.com/sigp/lighthouse/pull/3062, adding pre-bellatrix block support on blinded endpoints and allowing the normal proposal flow (local payload construction) on blinded endpoints. This resulted in better fallback logic because the VC will not have to switch endpoints on failure in the BN <> Builder API, the BN can just fallback immediately and without repeating block processing that it shouldn't need to. We can also keep VC fallback from the VC<>BN API's blinded endpoint to full endpoint.

## Proposed Changes

- Pre-bellatrix blocks on blinded endpoints
- Add a new `PayloadCache` to the execution layer
- Better fallback-from-builder logic

## Todos

- [x] Remove VC transition logic
- [x] Add logic to only enable builder flow after Merge transition finalization
- [x] Tests
- [x] Fix metrics
- [x] Rustdocs


Co-authored-by: Mac L <mjladson@pm.me>
Co-authored-by: realbigsean <sean@sigmaprime.io>

scripts/local_testnet/dump_logs.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# Print the tail of all the logs output from local testnet
+# Print all the logs output from local testnet
 
 set -Eeuo pipefail
 
@@ -12,6 +12,6 @@ do
   echo "============================================================================="
   echo "$f"
   echo "============================================================================="
-  tail "$f"
+  cat "$f"
   echo ""
 done

scripts/local_testnet/start_local_testnet.sh

@@ -10,12 +10,14 @@ ulimit -n 65536
 
 # VC_COUNT is defaulted in vars.env
 DEBUG_LEVEL=${DEBUG_LEVEL:-info}
+BUILDER_PROPOSALS=
 
 # Get options
-while getopts "v:d:h" flag; do
+while getopts "v:d:ph" flag; do
   case "${flag}" in
     v) VC_COUNT=${OPTARG};;
     d) DEBUG_LEVEL=${OPTARG};;
+    p) BUILDER_PROPOSALS="-p";;
     h)
         validators=$(( $VALIDATOR_COUNT / $BN_COUNT ))
         echo "Start local testnet, defaults: 1 eth1 node, $BN_COUNT beacon nodes,"
@@ -26,6 +28,7 @@ while getopts "v:d:h" flag; do
         echo "Options:"
         echo "   -v: VC_COUNT    default: $VC_COUNT"
         echo "   -d: DEBUG_LEVEL default: info"
+        echo "   -p:             enable private tx proposals"
         echo "   -h:             this help"
         exit
         ;;
@@ -116,7 +119,7 @@ done
 
 # Start requested number of validator clients
 for (( vc=1; vc<=$VC_COUNT; vc++ )); do
-    execute_command_add_PID validator_node_$vc.log ./validator_client.sh $DATADIR/node_$vc http://localhost:$((BN_http_port_base + $vc)) $DEBUG_LEVEL
+    execute_command_add_PID validator_node_$vc.log ./validator_client.sh $BUILDER_PROPOSALS -d $DEBUG_LEVEL $DATADIR/node_$vc http://localhost:$((BN_http_port_base + $vc))
 done
 
 echo "Started!"

scripts/local_testnet/validator_client.sh

@@ -10,13 +10,24 @@ set -Eeuo pipefail
 
 source ./vars.env
 
-DEBUG_LEVEL=${3:-info}
+DEBUG_LEVEL=info
+
+BUILDER_PROPOSALS=
+
+# Get options
+while getopts "pd:" flag; do
+  case "${flag}" in
+    p) BUILDER_PROPOSALS="--builder-proposals";;
+    d) DEBUG_LEVEL=${OPTARG};;
+  esac
+done
 
 exec lighthouse \
 	--debug-level $DEBUG_LEVEL \
 	vc \
-	--datadir $1 \
+	$BUILDER_PROPOSALS \
+	--datadir ${@:$OPTIND:1} \
 	--testnet-dir $TESTNET_DIR \
 	--init-slashing-protection \
-	--beacon-nodes $2 \
+	--beacon-nodes ${@:$OPTIND+1:1} \
 	$VC_ARGS