Created Fulu skeleton (#9325)

Author: lucassaldanha

acceptance-tests/src/acceptance-test/java/tech/pegasys/teku/test/acceptance/MergedGenesisInteropModeAcceptanceTest.java

@@ -75,28 +75,22 @@ private static TekuNodeConfigBuilder createTekuNodeBuilderForMilestone(
             .withInteropNumberOfValidators(64)
             .withValidatorProposerDefaultFeeRecipient("0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73");
 
-    switch (specMilestone) {
-      // We do not need to consider PHASE0, ALTAIR or BELLATRIX as they are all pre-Merge
-      // milestones
-      case CAPELLA:
-        tekuNodeConfigBuilder.withCapellaEpoch(UInt64.ZERO);
-        break;
-      case DENEB:
-        tekuNodeConfigBuilder.withCapellaEpoch(UInt64.ZERO);
-        tekuNodeConfigBuilder.withDenebEpoch(UInt64.ZERO);
-        break;
-      case ELECTRA:
-        tekuNodeConfigBuilder.withCapellaEpoch(UInt64.ZERO);
-        tekuNodeConfigBuilder.withDenebEpoch(UInt64.ZERO);
-        tekuNodeConfigBuilder.withElectraEpoch(UInt64.ZERO);
-        break;
-      default:
-        // Test will reach this whenever a new milestone is added and isn't mapped on the switch.
-        // This is a way to force us to always remember to validate that a new milestone can start
-        // from a merged
-        // state.
-        fail("Milestone %s not used on merged genesis interop test", specMilestone);
+    if (specMilestone.isGreaterThanOrEqualTo(SpecMilestone.CAPELLA)) {
+      tekuNodeConfigBuilder.withCapellaEpoch(UInt64.ZERO);
+    }
+    if (specMilestone.isGreaterThanOrEqualTo(SpecMilestone.DENEB)) {
+      tekuNodeConfigBuilder.withDenebEpoch(UInt64.ZERO);
+    }
+    if (specMilestone.isGreaterThanOrEqualTo(SpecMilestone.ELECTRA)) {
+      tekuNodeConfigBuilder.withElectraEpoch(UInt64.ZERO);
     }
+    if (specMilestone.isGreaterThanOrEqualTo(SpecMilestone.FULU)) {
+      tekuNodeConfigBuilder.withFuluEpoch(UInt64.ZERO);
+    }
+    if (specMilestone.isGreaterThan(SpecMilestone.FULU)) {
+      fail("Milestone %s not used on merged genesis interop test", specMilestone);
+    }
+
     return tekuNodeConfigBuilder;
   }
 }

acceptance-tests/src/testFixtures/java/tech/pegasys/teku/test/acceptance/dsl/TekuNodeConfigBuilder.java

@@ -173,6 +173,18 @@ public TekuNodeConfigBuilder withElectraEpoch(final UInt64 electraForkEpoch) {
     return this;
   }
 
+  public TekuNodeConfigBuilder withFuluEpoch(final UInt64 fuluForkEpoch) {
+    mustBe(NodeType.BEACON_NODE);
+    LOG.debug("Xnetwork-fulu-fork-epoch={}", fuluForkEpoch);
+    configMap.put("Xnetwork-fulu-fork-epoch", fuluForkEpoch.toString());
+    specConfigModifier =
+        specConfigModifier.andThen(
+            specConfigBuilder ->
+                specConfigBuilder.fuluBuilder(
+                    fuluBuilder -> fuluBuilder.fuluForkEpoch(fuluForkEpoch)));
+    return this;
+  }
+
   public TekuNodeConfigBuilder withTrustedSetupFromClasspath(final String trustedSetup)
       throws Exception {
     mustBe(NodeType.BEACON_NODE);

data/beaconrestapi/src/integration-test/java/tech/pegasys/teku/beaconrestapi/v3/GetNewBlockV3IntegrationTest.java

@@ -28,6 +28,7 @@
 import static tech.pegasys.teku.infrastructure.unsigned.UInt64.ONE;
 import static tech.pegasys.teku.spec.SpecMilestone.BELLATRIX;
 import static tech.pegasys.teku.spec.SpecMilestone.DENEB;
+import static tech.pegasys.teku.spec.SpecMilestone.FULU;
 
 import com.fasterxml.jackson.databind.JsonNode;
 import com.google.common.io.Resources;
@@ -55,7 +56,9 @@
 import tech.pegasys.teku.spec.datastructures.metadata.BlockContainerAndMetaData;
 import tech.pegasys.teku.spec.util.DataStructureUtil;
 
-@TestSpecContext(allMilestones = true)
+@TestSpecContext(
+    allMilestones = true,
+    ignoredMilestones = FULU) // TODO-fulu eventually we remove this ignore
 public class GetNewBlockV3IntegrationTest extends AbstractDataBackedRestAPIIntegrationTest {
 
   private DataStructureUtil dataStructureUtil;

data/beaconrestapi/src/test/resources/tech/pegasys/teku/beaconrestapi/handlers/v1/config/mainnetConfig.json

@@ -144,5 +144,20 @@
 "DOMAIN_AGGREGATE_AND_PROOF" : "0x06000000",
 "CHURN_LIMIT_QUOTIENT" : "65536",
 "BLS_WITHDRAWAL_PREFIX" : "0x00",
-"MIN_ACTIVATION_BALANCE" : "32000000000"
+"MIN_ACTIVATION_BALANCE" : "32000000000",
+"FIELD_ELEMENTS_PER_EXT_BLOB":"8192",
+"FIELD_ELEMENTS_PER_CELL":"64",
+"KZG_COMMITMENTS_INCLUSION_PROOF_DEPTH":"4",
+"MIN_EPOCHS_FOR_DATA_COLUMN_SIDECARS_REQUESTS":"4096",
+"MAX_BLOBS_PER_BLOCK_FULU":"12",
+"FULU_FORK_EPOCH":"18446744073709551615",
+"FULU_FORK_VERSION":"0x06000000",
+"NUMBER_OF_COLUMNS":"128",
+"NUMBER_OF_CUSTODY_GROUPS":"128",
+"DATA_COLUMN_SIDECAR_SUBNET_COUNT":"128",
+"MAX_REQUEST_DATA_COLUMN_SIDECARS":"16384",
+"SAMPLES_PER_SLOT":"8",
+"CUSTODY_REQUIREMENT":"4",
+"VALIDATOR_CUSTODY_REQUIREMENT":"8",
+"BALANCE_PER_ADDITIONAL_CUSTODY_GROUP":"32000000000"
 }

data/provider/src/main/java/tech/pegasys/teku/api/SchemaObjectProvider.java

@@ -98,7 +98,7 @@ public BeaconBlock getBlindedBlock(
               block.getParentRoot(),
               block.getStateRoot(),
               getBlindedBlockBodyDeneb(block.getBody()));
-      case ELECTRA ->
+      case ELECTRA, FULU ->
           new BlindedBlockElectra(
               block.getSlot(),
               block.getProposerIndex(),
@@ -147,7 +147,7 @@ public BeaconBlock getBeaconBlock(
               block.getParentRoot(),
               block.getStateRoot(),
               getBeaconBlockBodyDeneb(block.getBody()));
-      case ELECTRA ->
+      case ELECTRA, FULU ->
           new BeaconBlockElectra(
               block.getSlot(),
               block.getProposerIndex(),

data/serializer/src/main/java/tech/pegasys/teku/api/schema/Version.java

@@ -22,7 +22,8 @@ public enum Version {
   bellatrix,
   capella,
   deneb,
-  electra;
+  electra,
+  fulu;
 
   public static Version fromMilestone(final SpecMilestone milestone) {
     return switch (milestone) {
@@ -32,6 +33,7 @@ public static Version fromMilestone(final SpecMilestone milestone) {
       case CAPELLA -> capella;
       case DENEB -> deneb;
       case ELECTRA -> electra;
+      case FULU -> fulu;
     };
   }
 }

data/serializer/src/test/java/tech/pegasys/teku/api/schema/BeaconStateTest.java

@@ -41,7 +41,7 @@ public void shouldConvertToInternalObject(final SpecContext ctx) {
           case BELLATRIX -> new BeaconStateBellatrix(beaconStateInternal);
           case CAPELLA -> new BeaconStateCapella(beaconStateInternal);
           case DENEB -> new BeaconStateDeneb(beaconStateInternal);
-          case ELECTRA -> new BeaconStateElectra(beaconStateInternal);
+          case ELECTRA, FULU -> new BeaconStateElectra(beaconStateInternal);
         };
 
     assertThat(beaconState.asInternalBeaconState(spec)).isEqualTo(beaconStateInternal);

ethereum/executionlayer/src/main/java/tech/pegasys/teku/ethereum/executionlayer/MilestoneBasedEngineJsonRpcMethodsResolver.java

@@ -76,6 +76,9 @@ public MilestoneBasedEngineJsonRpcMethodsResolver(
                 case ELECTRA:
                   methodsByMilestone.put(milestone, electraSupportedMethods());
                   break;
+                case FULU:
+                  methodsByMilestone.put(milestone, fuluSupportedMethods());
+                  break;
               }
             });
   }
@@ -120,6 +123,16 @@ private Map<EngineApiMethod, EngineJsonRpcMethod<?>> electraSupportedMethods() {
     return methods;
   }
 
+  private Map<EngineApiMethod, EngineJsonRpcMethod<?>> fuluSupportedMethods() {
+    final Map<EngineApiMethod, EngineJsonRpcMethod<?>> methods = new HashMap<>();
+
+    methods.put(ENGINE_NEW_PAYLOAD, new EngineNewPayloadV4(executionEngineClient));
+    methods.put(ENGINE_GET_PAYLOAD, new EngineGetPayloadV4(executionEngineClient, spec));
+    methods.put(ENGINE_FORK_CHOICE_UPDATED, new EngineForkChoiceUpdatedV3(executionEngineClient));
+
+    return methods;
+  }
+
   @Override
   @SuppressWarnings({"unchecked", "unused"})
   public <T> EngineJsonRpcMethod<T> getMethod(

ethereum/executionlayer/src/test/java/tech/pegasys/teku/ethereum/executionlayer/MilestoneBasedEngineJsonRpcMethodsResolverTest.java

@@ -200,6 +200,28 @@ private static Stream<Arguments> electraMethods() {
         arguments(ENGINE_FORK_CHOICE_UPDATED, EngineForkChoiceUpdatedV3.class));
   }
 
+  @ParameterizedTest
+  @MethodSource("fuluMethods")
+  void shouldProvideExpectedMethodsForFulu(
+      final EngineApiMethod method, final Class<EngineJsonRpcMethod<?>> expectedMethodClass) {
+    final Spec electraSpec = TestSpecFactory.createMinimalFulu();
+
+    final MilestoneBasedEngineJsonRpcMethodsResolver engineMethodsResolver =
+        new MilestoneBasedEngineJsonRpcMethodsResolver(electraSpec, executionEngineClient);
+
+    final EngineJsonRpcMethod<Object> providedMethod =
+        engineMethodsResolver.getMethod(method, () -> SpecMilestone.FULU, Object.class);
+
+    assertThat(providedMethod).isExactlyInstanceOf(expectedMethodClass);
+  }
+
+  private static Stream<Arguments> fuluMethods() {
+    return Stream.of(
+        arguments(ENGINE_NEW_PAYLOAD, EngineNewPayloadV4.class),
+        arguments(ENGINE_GET_PAYLOAD, EngineGetPayloadV4.class),
+        arguments(ENGINE_FORK_CHOICE_UPDATED, EngineForkChoiceUpdatedV3.class));
+  }
+
   @Test
   void getsCapabilities() {
     final Spec spec =

ethereum/json-types/src/main/java/tech/pegasys/teku/ethereum/json/types/EthereumTypes.java

@@ -95,7 +95,9 @@ public class EthereumTypes {
 
   public static final StringValueTypeDefinition<SpecMilestone> MILESTONE_TYPE =
       new EnumTypeDefinition<>(
-          SpecMilestone.class, milestone -> milestone.name().toLowerCase(Locale.ROOT), Set.of());
+          SpecMilestone.class,
+          milestone -> milestone.name().toLowerCase(Locale.ROOT),
+          Set.of(SpecMilestone.FULU)); // TODO-fulu eventually we remove this ignore
 
   public static final EnumHeaderTypeDefinition<SpecMilestone> ETH_CONSENSUS_HEADER_TYPE =
       new EnumHeaderTypeDefinition.EnumTypeHeaderDefinitionBuilder<>(
@@ -105,6 +107,8 @@ public class EthereumTypes {
           .description(
               "Required in response so client can deserialize returned json or ssz data more effectively.")
           .example("phase0")
+          .excludedEnumerations(
+              Set.of(SpecMilestone.FULU)) // TODO-fulu eventually we remove this ignore
           .build();
 
   public static final BooleanHeaderTypeDefinition ETH_HEADER_EXECUTION_PAYLOAD_BLINDED_TYPE =