consensus/XDPoS, core, consensus/tests: fix verifyheaders parent lookups for epoch switches

Problem: VerifyHeaders could fail on epoch-switch batches when consensus hooks looked up parent headers through ChainReader before the batch had been written to disk.

Cause: the import paths passed the raw chain reader into VerifyHeaders, so helper lookups could only see DB-backed state and missed in-flight headers during block and header-only imports.

Solution: wrap the VerifyHeaders entry points with a batch-aware verifyChainReader so current-batch headers and blocks are visible during validation, add focused regression tests for epoch-switch parent resolution, and keep wrapper reuse as a no-op instead of mutating an existing cache.

Author: gzliudan

consensus/XDPoS/XDPoS.go

@@ -216,6 +216,7 @@ func (x *XDPoS) VerifyHeaders(chain consensus.ChainReader, headers []*types.Head
 
 	abort := make(chan struct{})
 	results := make(chan error, len(headers))
+	chain = NewVerifyHeadersChainReader(chain, headers, nil)
 
 	// Split the headers list into v1 and v2 buckets
 	var v1headers []*types.Header
@@ -234,7 +235,6 @@ func (x *XDPoS) VerifyHeaders(chain consensus.ChainReader, headers []*types.Head
 		}
 	}
 
-
 	if v1headers != nil {
 		x.EngineV1.VerifyHeaders(chain, v1headers, v1fullVerifies, abort, results)
 	}

consensus/XDPoS/verify_chain_reader.go

@@ -0,0 +1,106 @@
+package XDPoS
+
+import (
+	"github.com/XinFinOrg/XDPoSChain/common"
+	"github.com/XinFinOrg/XDPoSChain/consensus"
+	"github.com/XinFinOrg/XDPoSChain/core/types"
+	"github.com/XinFinOrg/XDPoSChain/params"
+)
+
+type verifyChainReader struct {
+	chain           consensus.ChainReader
+	headersByHash   map[common.Hash]*types.Header
+	headersByNumber map[uint64]*types.Header
+	blocksByHashNo  map[hashAndNumber]*types.Block
+}
+
+type hashAndNumber struct {
+	hash   common.Hash
+	number uint64
+}
+
+var _ consensus.ChainReader = (*verifyChainReader)(nil)
+
+func NewVerifyHeadersChainReader(chain consensus.ChainReader, headers []*types.Header, blocks []*types.Block) consensus.ChainReader {
+	if reader, ok := chain.(*verifyChainReader); ok {
+		return reader
+	}
+	reader := &verifyChainReader{
+		chain:           chain,
+		headersByHash:   make(map[common.Hash]*types.Header, len(headers)),
+		headersByNumber: make(map[uint64]*types.Header, len(headers)),
+		blocksByHashNo:  make(map[hashAndNumber]*types.Block, len(blocks)),
+	}
+	for _, header := range headers {
+		if header == nil || header.Number == nil {
+			continue
+		}
+		hash := header.Hash()
+		number := header.Number.Uint64()
+		reader.headersByHash[hash] = header
+		if _, exists := reader.headersByNumber[number]; !exists {
+			reader.headersByNumber[number] = header
+		}
+	}
+	for _, block := range blocks {
+		if block == nil {
+			continue
+		}
+		reader.blocksByHashNo[hashAndNumber{hash: block.Hash(), number: block.NumberU64()}] = block
+	}
+	return reader
+}
+
+func (r *verifyChainReader) Config() *params.ChainConfig {
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.Config()
+}
+
+func (r *verifyChainReader) CurrentHeader() *types.Header {
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.CurrentHeader()
+}
+
+func (r *verifyChainReader) GetHeader(hash common.Hash, number uint64) *types.Header {
+	if header, ok := r.headersByHash[hash]; ok && header.Number != nil && header.Number.Uint64() == number {
+		return header
+	}
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.GetHeader(hash, number)
+}
+
+func (r *verifyChainReader) GetHeaderByNumber(number uint64) *types.Header {
+	if header, ok := r.headersByNumber[number]; ok {
+		return header
+	}
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.GetHeaderByNumber(number)
+}
+
+func (r *verifyChainReader) GetHeaderByHash(hash common.Hash) *types.Header {
+	if header, ok := r.headersByHash[hash]; ok {
+		return header
+	}
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.GetHeaderByHash(hash)
+}
+
+func (r *verifyChainReader) GetBlock(hash common.Hash, number uint64) *types.Block {
+	if block, ok := r.blocksByHashNo[hashAndNumber{hash: hash, number: number}]; ok {
+		return block
+	}
+	if r.chain == nil {
+		return nil
+	}
+	return r.chain.GetBlock(hash, number)
+}

consensus/XDPoS/verify_chain_reader_test.go

@@ -0,0 +1,131 @@
+package XDPoS
+
+import (
+	"math/big"
+	"testing"
+
+	"github.com/XinFinOrg/XDPoSChain/common"
+	"github.com/XinFinOrg/XDPoSChain/core/types"
+	"github.com/XinFinOrg/XDPoSChain/params"
+	"github.com/XinFinOrg/XDPoSChain/trie"
+	"github.com/stretchr/testify/assert"
+)
+
+func makeTestBlock(number int64, time int64, txs ...*types.Transaction) *types.Block {
+	header := &types.Header{
+		Number:     big.NewInt(number),
+		Time:       big.NewInt(time),
+		Difficulty: big.NewInt(1),
+		GasLimit:   1_000_000,
+	}
+	return types.NewBlock(header, txs, nil, nil, trie.NewStackTrie(nil))
+}
+
+type stubVerifyChainReader struct {
+	config          *params.ChainConfig
+	currentHeader   *types.Header
+	headersByHash   map[common.Hash]*types.Header
+	headersByNumber map[uint64]*types.Header
+	blocksByHashNo  map[hashAndNumber]*types.Block
+}
+
+func (s *stubVerifyChainReader) Config() *params.ChainConfig { return s.config }
+
+func (s *stubVerifyChainReader) CurrentHeader() *types.Header { return s.currentHeader }
+
+func (s *stubVerifyChainReader) GetHeader(hash common.Hash, number uint64) *types.Header {
+	header := s.GetHeaderByHash(hash)
+	if header == nil || header.Number == nil || header.Number.Uint64() != number {
+		return nil
+	}
+	return header
+}
+
+func (s *stubVerifyChainReader) GetHeaderByNumber(number uint64) *types.Header {
+	if s.headersByNumber == nil {
+		return nil
+	}
+	return s.headersByNumber[number]
+}
+
+func (s *stubVerifyChainReader) GetHeaderByHash(hash common.Hash) *types.Header {
+	if s.headersByHash == nil {
+		return nil
+	}
+	return s.headersByHash[hash]
+}
+
+func (s *stubVerifyChainReader) GetBlock(hash common.Hash, number uint64) *types.Block {
+	if s.blocksByHashNo == nil {
+		return nil
+	}
+	return s.blocksByHashNo[hashAndNumber{hash: hash, number: number}]
+}
+
+func TestVerifyChainReaderWithNilChainIsNilSafe(t *testing.T) {
+	batchHeader := &types.Header{Number: big.NewInt(1)}
+	reader := NewVerifyHeadersChainReader(nil, []*types.Header{batchHeader}, nil).(*verifyChainReader)
+
+	assert.NotNil(t, reader)
+	assert.Nil(t, reader.Config())
+	assert.Nil(t, reader.CurrentHeader())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeaderByNumber(1).Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeaderByHash(batchHeader.Hash()).Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeader(batchHeader.Hash(), 1).Hash())
+	assert.Nil(t, reader.GetBlock(batchHeader.Hash(), 1))
+	assert.Nil(t, reader.GetHeader(common.Hash{}, 2))
+	assert.Nil(t, reader.GetBlock(common.Hash{}, 2))
+}
+
+func TestVerifyChainReaderShadowsBatchEntries(t *testing.T) {
+	baseHeader := &types.Header{Number: big.NewInt(100), Time: big.NewInt(1)}
+	batchHeader := &types.Header{Number: big.NewInt(100), Time: big.NewInt(2)}
+	batchTx := types.NewTransaction(1, common.Address{0x1}, big.NewInt(1), 21000, big.NewInt(1), []byte{0x1})
+	batchBlock := makeTestBlock(100, 2, batchTx)
+	batchHeader = batchBlock.Header()
+	currentHeader := &types.Header{Number: big.NewInt(99), Time: big.NewInt(3)}
+	baseBlock := types.NewBlockWithHeader(baseHeader)
+
+	base := &stubVerifyChainReader{
+		config:        params.TestXDPoSMockChainConfig,
+		currentHeader: currentHeader,
+		headersByHash: map[common.Hash]*types.Header{baseHeader.Hash(): baseHeader},
+		headersByNumber: map[uint64]*types.Header{
+			100: baseHeader,
+		},
+		blocksByHashNo: map[hashAndNumber]*types.Block{
+			{hash: baseHeader.Hash(), number: 100}: baseBlock,
+		},
+	}
+
+	reader := NewVerifyHeadersChainReader(base, []*types.Header{batchHeader}, []*types.Block{batchBlock}).(*verifyChainReader)
+
+	assert.Equal(t, params.TestXDPoSMockChainConfig, reader.Config())
+	assert.Equal(t, currentHeader.Hash(), reader.CurrentHeader().Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeaderByNumber(100).Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeaderByHash(batchHeader.Hash()).Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetHeader(batchHeader.Hash(), 100).Hash())
+	assert.Equal(t, batchHeader.Hash(), reader.GetBlock(batchHeader.Hash(), 100).Hash())
+	assert.Len(t, reader.GetBlock(batchHeader.Hash(), 100).Transactions(), 1)
+	assert.Equal(t, baseHeader.Hash(), reader.GetBlock(baseHeader.Hash(), 100).Hash())
+}
+
+func TestVerifyChainReaderReusesExistingWrapper(t *testing.T) {
+	firstTx := types.NewTransaction(1, common.Address{0x1}, big.NewInt(1), 21000, big.NewInt(1), []byte{0x1})
+	secondTx := types.NewTransaction(2, common.Address{0x2}, big.NewInt(2), 21000, big.NewInt(1), []byte{0x2})
+	firstBlock := makeTestBlock(100, 1, firstTx)
+	secondBlock := makeTestBlock(101, 2, secondTx)
+
+	reader := NewVerifyHeadersChainReader(nil, []*types.Header{firstBlock.Header()}, []*types.Block{firstBlock})
+	reused := NewVerifyHeadersChainReader(reader, []*types.Header{secondBlock.Header()}, nil)
+
+	assert.Same(t, reader, reused)
+	wrapped := reused.(*verifyChainReader)
+	assert.Len(t, wrapped.GetBlock(firstBlock.Hash(), firstBlock.NumberU64()).Transactions(), 1)
+	assert.Nil(t, wrapped.GetHeaderByNumber(secondBlock.NumberU64()))
+	assert.Nil(t, wrapped.GetBlock(secondBlock.Hash(), secondBlock.NumberU64()))
+
+	reused = NewVerifyHeadersChainReader(reused, nil, []*types.Block{secondBlock})
+	wrapped = reused.(*verifyChainReader)
+	assert.Nil(t, wrapped.GetBlock(secondBlock.Hash(), secondBlock.NumberU64()))
+}