// Copyright 2014 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 . // Package core implements the Ethereum consensus protocol. package core import ( "fmt" "time" "github.com/ledgerwatch/log/v3" "golang.org/x/crypto/sha3" "golang.org/x/exp/slices" "github.com/ledgerwatch/erigon-lib/chain" libcommon "github.com/ledgerwatch/erigon-lib/common" "github.com/ledgerwatch/erigon-lib/common/cmp" "github.com/ledgerwatch/erigon-lib/metrics" "github.com/ledgerwatch/erigon/common/math" "github.com/ledgerwatch/erigon/common/u256" "github.com/ledgerwatch/erigon/consensus" "github.com/ledgerwatch/erigon/core/state" "github.com/ledgerwatch/erigon/core/types" "github.com/ledgerwatch/erigon/core/vm" "github.com/ledgerwatch/erigon/core/vm/evmtypes" "github.com/ledgerwatch/erigon/rlp" ) var ( blockExecutionTimer = metrics.GetOrCreateSummary("chain_execution_seconds") ) type SyncMode string const ( TriesInMemory = 128 // See gas_limit in https://github.com/gnosischain/specs/blob/master/execution/withdrawals.md SysCallGasLimit = uint64(30_000_000) ) type RejectedTx struct { Index int `json:"index" gencodec:"required"` Err string `json:"error" gencodec:"required"` } type RejectedTxs []*RejectedTx type EphemeralExecResult struct { StateRoot libcommon.Hash `json:"stateRoot"` TxRoot libcommon.Hash `json:"txRoot"` ReceiptRoot libcommon.Hash `json:"receiptsRoot"` LogsHash libcommon.Hash `json:"logsHash"` Bloom types.Bloom `json:"logsBloom" gencodec:"required"` Receipts types.Receipts `json:"receipts"` Rejected RejectedTxs `json:"rejected,omitempty"` Difficulty *math.HexOrDecimal256 `json:"currentDifficulty" gencodec:"required"` GasUsed math.HexOrDecimal64 `json:"gasUsed"` StateSyncReceipt *types.Receipt `json:"-"` } // ExecuteBlockEphemerally runs a block from provided stateReader and // writes the result to the provided stateWriter func ExecuteBlockEphemerally( chainConfig *chain.Config, vmConfig *vm.Config, blockHashFunc func(n uint64) libcommon.Hash, engine consensus.Engine, block *types.Block, stateReader state.StateReader, stateWriter state.WriterWithChangeSets, chainReader consensus.ChainReader, getTracer func(txIndex int, txHash libcommon.Hash) (vm.EVMLogger, error), logger log.Logger, ) (*EphemeralExecResult, error) { defer blockExecutionTimer.ObserveDuration(time.Now()) block.Uncles() ibs := state.New(stateReader) header := block.Header() usedGas := new(uint64) usedBlobGas := new(uint64) gp := new(GasPool) gp.AddGas(block.GasLimit()).AddBlobGas(chainConfig.GetMaxBlobGasPerBlock()) var ( rejectedTxs []*RejectedTx includedTxs types.Transactions receipts types.Receipts ) if err := InitializeBlockExecution(engine, chainReader, block.Header(), chainConfig, ibs, logger); err != nil { return nil, err } noop := state.NewNoopWriter() //fmt.Printf("====txs processing start: %d====\n", block.NumberU64()) for i, tx := range block.Transactions() { ibs.SetTxContext(tx.Hash(), block.Hash(), i) writeTrace := false if vmConfig.Debug && vmConfig.Tracer == nil { tracer, err := getTracer(i, tx.Hash()) if err != nil { return nil, fmt.Errorf("could not obtain tracer: %w", err) } vmConfig.Tracer = tracer writeTrace = true } receipt, _, err := ApplyTransaction(chainConfig, blockHashFunc, engine, nil, gp, ibs, noop, header, tx, usedGas, usedBlobGas, *vmConfig) if writeTrace { if ftracer, ok := vmConfig.Tracer.(vm.FlushableTracer); ok { ftracer.Flush(tx) } vmConfig.Tracer = nil } if err != nil { if !vmConfig.StatelessExec { return nil, fmt.Errorf("could not apply tx %d from block %d [%v]: %w", i, block.NumberU64(), tx.Hash().Hex(), err) } rejectedTxs = append(rejectedTxs, &RejectedTx{i, err.Error()}) } else { includedTxs = append(includedTxs, tx) if !vmConfig.NoReceipts { receipts = append(receipts, receipt) } } } receiptSha := types.DeriveSha(receipts) if !vmConfig.StatelessExec && chainConfig.IsByzantium(header.Number.Uint64()) && !vmConfig.NoReceipts && receiptSha != block.ReceiptHash() { return nil, fmt.Errorf("mismatched receipt headers for block %d (%s != %s)", block.NumberU64(), receiptSha.Hex(), block.ReceiptHash().Hex()) } if !vmConfig.StatelessExec && *usedGas != header.GasUsed { return nil, fmt.Errorf("gas used by execution: %d, in header: %d", *usedGas, header.GasUsed) } if header.BlobGasUsed != nil && *usedBlobGas != *header.BlobGasUsed { return nil, fmt.Errorf("blob gas used by execution: %d, in header: %d", *usedBlobGas, *header.BlobGasUsed) } var bloom types.Bloom if !vmConfig.NoReceipts { bloom = types.CreateBloom(receipts) if !vmConfig.StatelessExec && bloom != header.Bloom { return nil, fmt.Errorf("bloom computed by execution: %x, in header: %x", bloom, header.Bloom) } } if !vmConfig.ReadOnly { txs := block.Transactions() if _, _, _, err := FinalizeBlockExecution(engine, stateReader, block.Header(), txs, block.Uncles(), stateWriter, chainConfig, ibs, receipts, block.Withdrawals(), chainReader, false, logger); err != nil { return nil, err } } blockLogs := ibs.Logs() execRs := &EphemeralExecResult{ TxRoot: types.DeriveSha(includedTxs), ReceiptRoot: receiptSha, Bloom: bloom, LogsHash: rlpHash(blockLogs), Receipts: receipts, Difficulty: (*math.HexOrDecimal256)(header.Difficulty), GasUsed: math.HexOrDecimal64(*usedGas), Rejected: rejectedTxs, } if chainConfig.Bor != nil { var logs []*types.Log for _, receipt := range receipts { logs = append(logs, receipt.Logs...) } stateSyncReceipt := &types.Receipt{} if chainConfig.Consensus == chain.BorConsensus && len(blockLogs) > 0 { slices.SortStableFunc(blockLogs, func(i, j *types.Log) int { return cmp.Compare(i.Index, j.Index) }) if len(blockLogs) > len(logs) { stateSyncReceipt.Logs = blockLogs[len(logs):] // get state-sync logs from `state.Logs()` // fill the state sync with the correct information types.DeriveFieldsForBorReceipt(stateSyncReceipt, block.Hash(), block.NumberU64(), receipts) stateSyncReceipt.Status = types.ReceiptStatusSuccessful } } execRs.StateSyncReceipt = stateSyncReceipt } return execRs, nil } func rlpHash(x interface{}) (h libcommon.Hash) { hw := sha3.NewLegacyKeccak256() rlp.Encode(hw, x) //nolint:errcheck hw.Sum(h[:0]) return h } func SysCallContract(contract libcommon.Address, data []byte, chainConfig *chain.Config, ibs *state.IntraBlockState, header *types.Header, engine consensus.EngineReader, constCall bool) (result []byte, err error) { msg := types.NewMessage( state.SystemAddress, &contract, 0, u256.Num0, SysCallGasLimit, u256.Num0, nil, nil, data, nil, false, true, // isFree nil, // maxFeePerBlobGas ) vmConfig := vm.Config{NoReceipts: true, RestoreState: constCall} // Create a new context to be used in the EVM environment isBor := chainConfig.Bor != nil var txContext evmtypes.TxContext var author *libcommon.Address if isBor { author = &header.Coinbase txContext = evmtypes.TxContext{} } else { author = &state.SystemAddress txContext = NewEVMTxContext(msg) } blockContext := NewEVMBlockContext(header, GetHashFn(header, nil), engine, author) evm := vm.NewEVM(blockContext, txContext, ibs, chainConfig, vmConfig) ret, _, err := evm.Call( vm.AccountRef(msg.From()), *msg.To(), msg.Data(), msg.Gas(), msg.Value(), false, ) if isBor && err != nil { return nil, nil } return ret, err } // SysCreate is a special (system) contract creation methods for genesis constructors. func SysCreate(contract libcommon.Address, data []byte, chainConfig chain.Config, ibs *state.IntraBlockState, header *types.Header) (result []byte, err error) { msg := types.NewMessage( contract, nil, // to 0, u256.Num0, SysCallGasLimit, u256.Num0, nil, nil, data, nil, false, true, // isFree nil, // maxFeePerBlobGas ) vmConfig := vm.Config{NoReceipts: true} // Create a new context to be used in the EVM environment author := &contract txContext := NewEVMTxContext(msg) blockContext := NewEVMBlockContext(header, GetHashFn(header, nil), nil, author) evm := vm.NewEVM(blockContext, txContext, ibs, &chainConfig, vmConfig) ret, _, err := evm.SysCreate( vm.AccountRef(msg.From()), msg.Data(), msg.Gas(), msg.Value(), contract, ) return ret, err } func FinalizeBlockExecution( engine consensus.Engine, stateReader state.StateReader, header *types.Header, txs types.Transactions, uncles []*types.Header, stateWriter state.WriterWithChangeSets, cc *chain.Config, ibs *state.IntraBlockState, receipts types.Receipts, withdrawals []*types.Withdrawal, chainReader consensus.ChainReader, isMining bool, logger log.Logger, ) (newBlock *types.Block, newTxs types.Transactions, newReceipt types.Receipts, err error) { syscall := func(contract libcommon.Address, data []byte) ([]byte, error) { return SysCallContract(contract, data, cc, ibs, header, engine, false /* constCall */) } if isMining { newBlock, newTxs, newReceipt, err = engine.FinalizeAndAssemble(cc, header, ibs, txs, uncles, receipts, withdrawals, chainReader, syscall, nil, logger) } else { _, _, err = engine.Finalize(cc, header, ibs, txs, uncles, receipts, withdrawals, chainReader, syscall, logger) } if err != nil { return nil, nil, nil, err } if err := ibs.CommitBlock(cc.Rules(header.Number.Uint64(), header.Time), stateWriter); err != nil { return nil, nil, nil, fmt.Errorf("committing block %d failed: %w", header.Number.Uint64(), err) } if err := stateWriter.WriteChangeSets(); err != nil { return nil, nil, nil, fmt.Errorf("writing changesets for block %d failed: %w", header.Number.Uint64(), err) } return newBlock, newTxs, newReceipt, nil } func InitializeBlockExecution(engine consensus.Engine, chain consensus.ChainHeaderReader, header *types.Header, cc *chain.Config, ibs *state.IntraBlockState, logger log.Logger, ) error { engine.Initialize(cc, chain, header, ibs, func(contract libcommon.Address, data []byte, ibState *state.IntraBlockState, header *types.Header, constCall bool) ([]byte, error) { return SysCallContract(contract, data, cc, ibState, header, engine, constCall) }, logger) noop := state.NewNoopWriter() ibs.FinalizeTx(cc.Rules(header.Number.Uint64(), header.Time), noop) return nil }