feature: Add support for block validation (flashbots_validateBuilderSubmissionV3)

src/Nethermind/Nethermind.BlockValidation/BlockValidation.cs

@@ -0,0 +1,53 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using System;
+using System.Threading.Tasks;
+using Nethermind.Api;
+using Nethermind.Api.Extensions;
+using Nethermind.BlockValidation.Handlers;
+using Nethermind.Consensus.Processing;
+using Nethermind.JsonRpc.Modules;
+
+namespace Nethermind.BlockValidation;
+
+public class BlockValidation : INethermindPlugin
+{
+    private INethermindApi _api = null!;
+
+    private IBlockValidationConfig _blockValidationConfig = null!;
+
+    public virtual string Name => "BlockValidation";
+    public virtual string Description => "BlockValidation";
+    public string Author => "Nethermind";
+    public Task InitRpcModules()
+    {
+        ReadOnlyTxProcessingEnv readOnlyTxProcessingEnv = new ReadOnlyTxProcessingEnv(
+            _api.WorldStateManager ?? throw new ArgumentNullException(nameof(_api.WorldStateManager)),
+            _api.BlockTree ?? throw new ArgumentNullException(nameof(_api.BlockTree)),
+            _api.SpecProvider,
+            _api.LogManager
+        );
+        ValidateSubmissionHandler validateSubmissionHandler = new ValidateSubmissionHandler(
+            _api.BlockValidator ?? throw new ArgumentNullException(nameof(_api.BlockValidator)),
+            readOnlyTxProcessingEnv,
+            _api.GasLimitCalculator ?? throw new ArgumentNullException(nameof(_api.GasLimitCalculator)),
+            _blockValidationConfig
+        );
+        IFlashbotsRpcModule flashbotsRpcModule = new FlashbotsRpcModule(validateSubmissionHandler);
+
+        ArgumentNullException.ThrowIfNull(_api.RpcModuleProvider);
+        _api.RpcModuleProvider.RegisterSingle(flashbotsRpcModule);
+
+        return Task.CompletedTask;
+    }
+
+    public Task Init(INethermindApi api)
+    {
+        _api = api;
+        _blockValidationConfig = api.Config<IBlockValidationConfig>();
+        return Task.CompletedTask;
+    }
+
+    public ValueTask DisposeAsync() => ValueTask.CompletedTask;
+}

src/Nethermind/Nethermind.BlockValidation/BlockValidationConfig.cs

@@ -0,0 +1,13 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using Nethermind.Config;
+
+namespace Nethermind.BlockValidation;
+
+public class BlockValidationConfig: IBlockValidationConfig
+{
+    public bool UseBalanceDiffProfit { get; set; } = false ;
+
+    public bool ExcludeWithdrawals { get; set; } = false;
+}

src/Nethermind/Nethermind.BlockValidation/Data/BidTrace.cs

@@ -0,0 +1,21 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using Nethermind.Core;
+using Nethermind.Core.Crypto;
+using Nethermind.Int256;
+
+namespace Nethermind.BlockValidation.Data;
+
+public readonly struct BidTrace
+{
+    public ulong Slot { get; }
+    public Hash256 ParentHash { get; }
+    public Hash256 BlockHash { get; }
+    public PublicKey BuilderPublicKey { get; }
+    public PublicKey ProposerPublicKey { get; }
+    public Address ProposerFeeRecipient { get; }
+    public long GasLimit { get; }
+    public long GasUsed { get; }
+    public UInt256 Value { get; }
+}

src/Nethermind/Nethermind.BlockValidation/Data/BlockValidationResult.cs

@@ -0,0 +1,47 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using System.Text.Json.Serialization;
+using Nethermind.JsonRpc;
+
+namespace Nethermind.BlockValidation.Data;
+
+/// <summary>
+/// Represents the result of a block validation.
+/// </summary>
+public class BlockValidationResult
+{
+
+    public static ResultWrapper<BlockValidationResult> Invalid(string error)
+    {
+        return ResultWrapper<BlockValidationResult>.Success(new BlockValidationResult
+        {
+            Status = BlockValidationStatus.Invalid,
+            ValidationError = error
+        });
+    }
+
+    public static ResultWrapper<BlockValidationResult> Valid()
+    {
+        return ResultWrapper<BlockValidationResult>.Success(new BlockValidationResult
+        {
+            Status = BlockValidationStatus.Valid
+        });
+    }
+
+    public static ResultWrapper<BlockValidationResult> Error(string error)
+    {
+        return ResultWrapper<BlockValidationResult>.Fail(error);
+    }
+
+    /// <summary>
+    /// The status of the validation of the builder submissions
+    /// </summary>
+    public string Status { get; set; } = BlockValidationStatus.Invalid;
+
+    /// <summary>
+    /// Message providing additional details on the validation error if the payload is classified as <see cref="ValidationStatus.Invalid"/>.
+    /// </summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public string? ValidationError { get; set; }
+}

src/Nethermind/Nethermind.BlockValidation/Data/BlockValidationStatus.cs

@@ -0,0 +1,17 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+namespace Nethermind.BlockValidation.Data;
+
+public static class BlockValidationStatus
+{
+    /// <summary>
+    /// The submissions are invalid.
+    /// </summary>
+    public const string Invalid = "Invalid";
+
+    /// <summary>
+    /// The submissions are valid.
+    /// </summary>
+    public const string Valid = "Valid";
+}

src/Nethermind/Nethermind.BlockValidation/Data/BuilderBlockValidationRequest.cs

@@ -0,0 +1,19 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using Nethermind.Core.Crypto;
+
+namespace Nethermind.BlockValidation.Data;
+
+public class BuilderBlockValidationRequest
+{
+    /// <summary>
+    /// The block hash of the parent beacon block.
+    /// <see cref=https://github.com/flashbots/builder/blob/df9c765067d57ab4b2d0ad39dbb156cbe4965778/eth/block-validation/api.go#L198"/>
+    /// </summary>
+    public Hash256 ParentBeaconBlockRoot { get; set; } = Keccak.Zero;
+
+    public long RegisterGasLimit { get; set; }
+
+    public SubmitBlockRequest BlockRequest { get; set; }
+}

src/Nethermind/Nethermind.BlockValidation/Data/SubmitBlockRequest.cs

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using Nethermind.Core.Crypto;
+using Nethermind.Merge.Plugin.Data;
+
+namespace Nethermind.BlockValidation.Data;
+
+public readonly struct SubmitBlockRequest
+{
+    private readonly ExecutionPayload _executionPayload;
+    private readonly BlobsBundleV1 _blobsBundle;
+
+    public SubmitBlockRequest(ExecutionPayload executionPayload, BlobsBundleV1 blobsBundle, BidTrace message)
+    {
+        _executionPayload = executionPayload;
+        _blobsBundle = blobsBundle;
+        Message = message;
+    }
+    public readonly ExecutionPayload ExecutionPayload => _executionPayload;
+    public readonly BlobsBundleV1 BlobsBundle => _blobsBundle;
+    public BidTrace Message { get; }
+}

src/Nethermind/Nethermind.BlockValidation/FlashbotsRpcModule.cs

@@ -0,0 +1,23 @@
+// SPDX-FileCopyrightText: 2024 Demerzel Solutions Limited
+// SPDX-License-Identifier: LGPL-3.0-only
+
+using System.Threading.Tasks;
+using Nethermind.BlockValidation.Data;
+using Nethermind.BlockValidation.Handlers;
+using Nethermind.JsonRpc;
+
+namespace Nethermind.BlockValidation;
+
+public class FlashbotsRpcModule : IFlashbotsRpcModule
+{
+    private readonly ValidateSubmissionHandler _validateSubmissionHandler;
+
+    public FlashbotsRpcModule(ValidateSubmissionHandler validateSubmissionHandler)
+    {
+        _validateSubmissionHandler = validateSubmissionHandler;
+    }
+
+    Task<ResultWrapper<BlockValidationResult>> IFlashbotsRpcModule.flashbots_validateBuilderSubmissionV3(BuilderBlockValidationRequest @params) =>
+        _validateSubmissionHandler.ValidateSubmission(@params);
+
+}