go-ethereum/core/state/sync.go
CPerezz a5a5f40aa7
core/state: add hash-based filter methods and NewPartialStateSync
Extends ContractFilter interface with hash-based methods (ShouldSyncStorageByHash,
ShouldSyncCodeByHash) for efficient filtering during snap sync when only account
hashes are available.

Adds NewPartialStateSync() function that accepts filter callbacks to control which
accounts have their storage/code synced during healing. This prevents the healing
phase from re-syncing storage for accounts that were intentionally skipped during
initial sync.

Part of partial statefulness Phase 2.
2026-04-17 11:09:19 +02:00

75 lines
3.3 KiB
Go

// Copyright 2015 The go-ethereum Authors
// This file is part of the go-ethereum library.
//
// The go-ethereum library is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// The go-ethereum library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
package state
import (
"github.com/ethereum/go-ethereum/common"
"github.com/ethereum/go-ethereum/core/types"
"github.com/ethereum/go-ethereum/ethdb"
"github.com/ethereum/go-ethereum/rlp"
"github.com/ethereum/go-ethereum/trie"
)
// NewStateSync creates a new state trie download scheduler.
func NewStateSync(root common.Hash, database ethdb.KeyValueReader, onLeaf func(keys [][]byte, leaf []byte) error, scheme string) *trie.Sync {
return NewPartialStateSync(root, database, onLeaf, scheme, nil, nil)
}
// NewPartialStateSync creates a state trie download scheduler with optional filtering.
// The shouldSyncStorage callback, if non-nil, is called with the account hash to determine
// whether to sync storage for that account. This enables partial statefulness where only
// selected contracts have their storage synced.
// The shouldSyncCode callback, if non-nil, is called to determine whether to sync bytecode.
func NewPartialStateSync(root common.Hash, database ethdb.KeyValueReader, onLeaf func(keys [][]byte, leaf []byte) error, scheme string, shouldSyncStorage func(accountHash common.Hash) bool, shouldSyncCode func(accountHash common.Hash) bool) *trie.Sync {
// Register the storage slot callback if the external callback is specified.
var onSlot func(keys [][]byte, path []byte, leaf []byte, parent common.Hash, parentPath []byte) error
if onLeaf != nil {
onSlot = func(keys [][]byte, path []byte, leaf []byte, parent common.Hash, parentPath []byte) error {
return onLeaf(keys, leaf)
}
}
// Register the account callback to connect the state trie and the storage
// trie belongs to the contract.
var syncer *trie.Sync
onAccount := func(keys [][]byte, path []byte, leaf []byte, parent common.Hash, parentPath []byte) error {
if onLeaf != nil {
if err := onLeaf(keys, leaf); err != nil {
return err
}
}
var obj types.StateAccount
if err := rlp.DecodeBytes(leaf, &obj); err != nil {
return err
}
// Extract account hash from the path (first key in keys slice)
var accountHash common.Hash
if len(keys) > 0 {
accountHash = common.BytesToHash(keys[0])
}
// Only add storage subtrie if filter allows it (or no filter is set)
if shouldSyncStorage == nil || shouldSyncStorage(accountHash) {
syncer.AddSubTrie(obj.Root, path, parent, parentPath, onSlot)
}
// Only add code entry if filter allows it (or no filter is set)
if shouldSyncCode == nil || shouldSyncCode(accountHash) {
syncer.AddCodeEntry(common.BytesToHash(obj.CodeHash), path, parent, parentPath)
}
return nil
}
syncer = trie.NewSync(root, database, onAccount, scheme)
return syncer
}