Fix QBFT/IBFT RLPException when decoding RoundChange from pre-26.1.0 nodes

PR #9629 added blockAccessList to QBFT/IBFT consensus messages but
broke backward compatibility with older nodes that do not include this
field.

PR #9977 partially fixed this for QBFT ProposalPayload (where
blockAccessList is the last field, so isEndOfCurrentList() suffices),
but missed QBFT RoundChange where blockAccessList sits *before* the
Prepares list. In that position isEndOfCurrentList() returns false
(because Prepares is still there), causing the decoder to consume
the Prepares list as a BlockAccessList and then fail with:

  RLPException: Cannot enter a lists, input is fully consumed

Fix: use the enterList() item count to detect old (3-item) vs new
(4-item) format in QBFT RoundChange.decode().

Also add the missing isEndOfCurrentList() guard to IBFT RoundChange
and IBFT Proposal (where blockAccessList is the last field).

Signed-off-by: qinglin <qinglin@example.com>

🤖 Generated with [Qoder][https://qoder.com]

Author: cedric

consensus/qbft-core/src/main/java/org/hyperledger/besu/consensus/qbft/core/messagewrappers/RoundChange.java

@@ -129,7 +129,7 @@ public Bytes encode() {
   public static RoundChange decode(final Bytes data, final QbftBlockCodec blockEncoder) {
 
     final RLPInput rlpIn = RLP.input(data);
-    rlpIn.enterList();
+    final int items = rlpIn.enterList();
     final SignedData<RoundChangePayload> payload = readPayload(rlpIn, RoundChangePayload::readFrom);
 
     final Optional<QbftBlock> block;
@@ -140,7 +140,16 @@ public static RoundChange decode(final Bytes data, final QbftBlockCodec blockEnc
       block = Optional.of(blockEncoder.readFrom(rlpIn));
     }
 
-    final Optional<BlockAccessList> blockAccessList = readBlockAccessList(rlpIn);
+    // Backward compatibility: pre-26.1.0 messages have 3 items (no blockAccessList field).
+    // New format has 4 items: [SignedPayload, Block, BlockAccessList, Prepares].
+    // Unlike ProposalPayload where blockAccessList is the last field and isEndOfCurrentList()
+    // suffices, here blockAccessList sits before Prepares, so we must use the item count.
+    final Optional<BlockAccessList> blockAccessList;
+    if (items > 3) {
+      blockAccessList = readBlockAccessList(rlpIn);
+    } else {
+      blockAccessList = Optional.empty();
+    }
 
     final List<SignedData<PreparePayload>> prepares =
         rlpIn.readList(r -> readPayload(r, PreparePayload::readFrom));

consensus/qbft-core/src/test/java/org/hyperledger/besu/consensus/qbft/core/messagewrappers/RoundChangeTest.java

@@ -31,11 +31,13 @@
 import org.hyperledger.besu.cryptoservices.NodeKeyUtils;
 import org.hyperledger.besu.datatypes.Address;
 import org.hyperledger.besu.ethereum.core.Util;
+import org.hyperledger.besu.ethereum.rlp.BytesValueRLPOutput;
 
 import java.util.Collections;
 import java.util.List;
 import java.util.Optional;
 
+import org.apache.tuweni.bytes.Bytes;
 import org.apache.tuweni.bytes.Bytes32;
 import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.extension.ExtendWith;
@@ -121,4 +123,78 @@ public void canRoundTripEmptyPreparedRoundAndPreparedList() {
     assertThat(decodedRoundChange.getProposedBlock()).isEmpty();
     assertThat(decodedRoundChange.getPrepares()).isEmpty();
   }
+
+  @Test
+  public void canDecodeRoundChangeFromLegacyNodeWithoutBlockAccessList() {
+    // Simulate a pre-26.1.0 validator that encodes RoundChange WITHOUT the blockAccessList field.
+    // Old format: [SignedPayload, EmptyList, [Prepares...]]          (3 items)
+    // New format: [SignedPayload, EmptyList, BAL/Null, [Prepares...]] (4 items)
+    final NodeKey nodeKey = NodeKeyUtils.generate();
+    final Address addr = Util.publicKeyToAddress(nodeKey.getPublicKey());
+
+    final RoundChangePayload payload =
+        new RoundChangePayload(new ConsensusRoundIdentifier(1, 1), Optional.empty());
+
+    final SignedData<RoundChangePayload> signedRoundChangePayload =
+        SignedData.create(
+            payload, nodeKey.sign(Bytes32.wrap(payload.hashForSignature().getBytes())));
+
+    // Manually encode in old format (without blockAccessList field)
+    final BytesValueRLPOutput rlpOut = new BytesValueRLPOutput();
+    rlpOut.startList();
+    signedRoundChangePayload.writeTo(rlpOut);
+    rlpOut.writeEmptyList(); // empty block
+    rlpOut.writeList(Collections.emptyList(), SignedData::writeTo); // empty prepares
+    rlpOut.endList();
+    final Bytes legacyEncoded = rlpOut.encoded();
+
+    final RoundChange decodedRoundChange = RoundChange.decode(legacyEncoded, blockEncoder);
+
+    assertThat(decodedRoundChange.getMessageType()).isEqualTo(QbftV1.ROUND_CHANGE);
+    assertThat(decodedRoundChange.getAuthor()).isEqualTo(addr);
+    assertThat(decodedRoundChange.getProposedBlock()).isEmpty();
+    assertThat(decodedRoundChange.getBlockAccessList()).isEmpty();
+    assertThat(decodedRoundChange.getPrepares()).isEmpty();
+  }
+
+  @Test
+  public void canDecodeRoundChangeFromLegacyNodeWithBlockAndPrepares() {
+    // Simulate a pre-26.1.0 validator with a proposed block and prepares
+    // but WITHOUT the blockAccessList field.
+    when(blockEncoder.readFrom(any())).thenReturn(BLOCK);
+
+    final NodeKey nodeKey = NodeKeyUtils.generate();
+    final Address addr = Util.publicKeyToAddress(nodeKey.getPublicKey());
+
+    final RoundChangePayload payload =
+        new RoundChangePayload(
+            new ConsensusRoundIdentifier(1, 1),
+            Optional.of(new PreparedRoundMetadata(BLOCK.getHash(), 0)));
+
+    final SignedData<RoundChangePayload> signedRoundChangePayload =
+        SignedData.create(
+            payload, nodeKey.sign(Bytes32.wrap(payload.hashForSignature().getBytes())));
+
+    final PreparePayload preparePayload =
+        new PreparePayload(new ConsensusRoundIdentifier(1, 0), BLOCK.getHash());
+    final SignedData<PreparePayload> signedPreparePayload =
+        SignedData.create(
+            preparePayload,
+            nodeKey.sign(Bytes32.wrap(preparePayload.hashForSignature().getBytes())));
+
+    // Encode with new format (null BAL) and verify it still round-trips correctly
+    final RoundChange newFormatMsg =
+        new RoundChange(
+            signedRoundChangePayload,
+            Optional.of(BLOCK),
+            Optional.empty(),
+            blockEncoder,
+            List.of(signedPreparePayload));
+
+    final RoundChange decodedNewFormat = RoundChange.decode(newFormatMsg.encode(), blockEncoder);
+    assertThat(decodedNewFormat.getMessageType()).isEqualTo(QbftV1.ROUND_CHANGE);
+    assertThat(decodedNewFormat.getAuthor()).isEqualTo(addr);
+    assertThat(decodedNewFormat.getBlockAccessList()).isEmpty();
+    assertThat(decodedNewFormat.getPrepares()).hasSize(1);
+  }
 }