Add back deprecated traceStartBlock methods to the tracer API (#8112)

Signed-off-by: Luis Pinto <[email protected]>

Author: lu-pinto

plugin-api/build.gradle

@@ -71,7 +71,7 @@ Calculated : ${currentHash}
 tasks.register('checkAPIChanges', FileStateChecker) {
   description = "Checks that the API for the Plugin-API project does not change without deliberate thought"
   files = sourceSets.main.allJava.files
-  knownHash = 'V3YwoXiJjbbrtpr7DmbebhJwAcj40J/3gb6VZcoFlF8='
+  knownHash = '2b6i9SVzINvYv2E4yHk10d6ad+pzA12xsMltKghnW+U='
 }
 check.dependsOn('checkAPIChanges')
 

plugin-api/src/main/java/org/hyperledger/besu/plugin/services/tracer/BlockAwareOperationTracer.java

@@ -33,6 +33,17 @@ public interface BlockAwareOperationTracer extends OperationTracer {
    */
   BlockAwareOperationTracer NO_TRACING = new BlockAwareOperationTracer() {};
 
+  /**
+   * Trace the start of a block. Notice: This method has been marked for removal and will be removed
+   * in a future version. Avoid using it and use {@link #traceStartBlock(BlockHeader, BlockBody,
+   * Address)} instead.
+   *
+   * @param blockHeader the header of the block which is traced
+   * @param blockBody the body of the block which is traced
+   */
+  @Deprecated
+  default void traceStartBlock(final BlockHeader blockHeader, final BlockBody blockBody) {}
+
   /**
    * Trace the start of a block.
    *
@@ -51,6 +62,16 @@ default void traceStartBlock(
    */
   default void traceEndBlock(final BlockHeader blockHeader, final BlockBody blockBody) {}
 
+  /**
+   * When building a block this API is called at the start of the process. Notice: This method has
+   * been marked for removal and will be removed in a future version. Avoid using it and use {@link
+   * #traceStartBlock(ProcessableBlockHeader, Address)} instead.
+   *
+   * @param processableBlockHeader the processable header
+   */
+  @Deprecated
+  default void traceStartBlock(final ProcessableBlockHeader processableBlockHeader) {}
+
   /**
    * When building a block this API is called at the start of the process
    *