Versions in this module Expand all Collapse all v1 v1.0.3 Sep 5, 2024 v1.0.2 Sep 5, 2024 Changes in this version + const BlockChainVersion + var ErrBlobFeeCapTooLow = errors.New("max fee per blob gas less than block blob gas fee") + var ErrBlobTxCreate = errors.New("blob transaction of type create") + var ErrFeeCapTooLow = errors.New("max fee per gas less than block base fee") + var ErrFeeCapVeryHigh = errors.New("max fee per gas higher than 2^256-1") + var ErrGasLimitReached = errors.New("gas limit reached") + var ErrGasUintOverflow = errors.New("gas uint64 overflow") + var ErrInsufficientBalanceWitness = errors.New("insufficient funds to cover witness access costs for transaction") + var ErrInsufficientFunds = errors.New("insufficient funds for gas * price + value") + var ErrInsufficientFundsForTransfer = errors.New("insufficient funds for transfer") + var ErrIntrinsicGas = errors.New("intrinsic gas too low") + var ErrKnownBlock = errors.New("block already known") + var ErrMaxInitCodeSizeExceeded = errors.New("max initcode size exceeded") + var ErrMissingBlobHashes = errors.New("blob transaction missing blob hashes") + var ErrNoGenesis = errors.New("genesis not found in chain") + var ErrNonceMax = errors.New("nonce has max value") + var ErrNonceTooHigh = errors.New("nonce too high") + var ErrNonceTooLow = errors.New("nonce too low") + var ErrSenderNoEOA = errors.New("sender not an eoa") + var ErrTipAboveFeeCap = errors.New("max priority fee per gas higher than max fee per gas") + var ErrTipVeryHigh = errors.New("max priority fee per gas higher than 2^256-1") + var ErrTxTypeNotSupported = types.ErrTxTypeNotSupported + var SenderCacher = newTxSenderCacher(runtime.NumCPU()) + func ApplyTransaction(config *params.ChainConfig, bc ChainContext, author *common.Address, ...) (*types.Receipt, error) + func ApplyTransactionWithEVM(msg *Message, config *params.ChainConfig, gp *GasPool, statedb *state.StateDB, ...) (receipt *types.Receipt, err error) + func CalcGasLimit(parentGasLimit, desiredLimit uint64) uint64 + func CanTransfer(db vm.StateDB, addr common.Address, amount *uint256.Int) bool + func ExecuteStateless(config *params.ChainConfig, witness *stateless.Witness) (common.Hash, common.Hash, error) + func GenerateChain(config *params.ChainConfig, parent *types.Block, engine consensus.Engine, ...) ([]*types.Block, []types.Receipts) + func GenerateChainWithGenesis(genesis *Genesis, engine consensus.Engine, n int, gen func(int, *BlockGen)) (ethdb.Database, []*types.Block, []types.Receipts) + func GenerateVerkleChain(config *params.ChainConfig, parent *types.Block, engine consensus.Engine, ...) ([]*types.Block, []types.Receipts, []*verkle.VerkleProof, []verkle.StateDiff) + func GenerateVerkleChainWithGenesis(genesis *Genesis, engine consensus.Engine, n int, gen func(int, *BlockGen)) (ethdb.Database, []*types.Block, []types.Receipts, []*verkle.VerkleProof, ...) + func GetHashFn(ref *types.Header, chain ChainContext) func(n uint64) common.Hash + func IntrinsicGas(data []byte, accessList types.AccessList, ...) (uint64, error) + func LoadChainConfig(db ethdb.Database, genesis *Genesis) (*params.ChainConfig, error) + func NewEVMBlockContext(header *types.Header, chain ChainContext, author *common.Address) vm.BlockContext + func NewEVMTxContext(msg *Message) vm.TxContext + func ProcessBeaconBlockRoot(beaconRoot common.Hash, vmenv *vm.EVM, statedb *state.StateDB) + func SetupGenesisBlock(db ethdb.Database, triedb *triedb.Database, genesis *Genesis) (*params.ChainConfig, common.Hash, error) + func SetupGenesisBlockWithOverride(db ethdb.Database, triedb *triedb.Database, genesis *Genesis, ...) (*params.ChainConfig, common.Hash, error) + func Transfer(db vm.StateDB, sender, recipient common.Address, amount *uint256.Int) + type BlockChain struct + func NewBlockChain(db ethdb.Database, cacheConfig *CacheConfig, genesis *Genesis, ...) (*BlockChain, error) + func (bc *BlockChain) Config() *params.ChainConfig + func (bc *BlockChain) ContractCodeWithPrefix(hash common.Hash) ([]byte, error) + func (bc *BlockChain) CurrentBlock() *types.Header + func (bc *BlockChain) CurrentFinalBlock() *types.Header + func (bc *BlockChain) CurrentHeader() *types.Header + func (bc *BlockChain) CurrentSafeBlock() *types.Header + func (bc *BlockChain) CurrentSnapBlock() *types.Header + func (bc *BlockChain) Engine() consensus.Engine + func (bc *BlockChain) Export(w io.Writer) error + func (bc *BlockChain) ExportN(w io.Writer, first uint64, last uint64) error + func (bc *BlockChain) GasLimit() uint64 + func (bc *BlockChain) Genesis() *types.Block + func (bc *BlockChain) GetAncestor(hash common.Hash, number, ancestor uint64, maxNonCanonical *uint64) (common.Hash, uint64) + func (bc *BlockChain) GetBlock(hash common.Hash, number uint64) *types.Block + func (bc *BlockChain) GetBlockByHash(hash common.Hash) *types.Block + func (bc *BlockChain) GetBlockByNumber(number uint64) *types.Block + func (bc *BlockChain) GetBlocksFromHash(hash common.Hash, n int) (blocks []*types.Block) + func (bc *BlockChain) GetBody(hash common.Hash) *types.Body + func (bc *BlockChain) GetBodyRLP(hash common.Hash) rlp.RawValue + func (bc *BlockChain) GetCanonicalHash(number uint64) common.Hash + func (bc *BlockChain) GetHeader(hash common.Hash, number uint64) *types.Header + func (bc *BlockChain) GetHeaderByHash(hash common.Hash) *types.Header + func (bc *BlockChain) GetHeaderByNumber(number uint64) *types.Header + func (bc *BlockChain) GetHeadersFrom(number, count uint64) []rlp.RawValue + func (bc *BlockChain) GetReceiptsByHash(hash common.Hash) types.Receipts + func (bc *BlockChain) GetTd(hash common.Hash, number uint64) *big.Int + func (bc *BlockChain) GetTransactionLookup(hash common.Hash) (*rawdb.LegacyTxLookupEntry, *types.Transaction, error) + func (bc *BlockChain) GetTrieFlushInterval() time.Duration + func (bc *BlockChain) GetUnclesInChain(block *types.Block, length int) []*types.Header + func (bc *BlockChain) GetVMConfig() *vm.Config + func (bc *BlockChain) HasBlock(hash common.Hash, number uint64) bool + func (bc *BlockChain) HasBlockAndState(hash common.Hash, number uint64) bool + func (bc *BlockChain) HasFastBlock(hash common.Hash, number uint64) bool + func (bc *BlockChain) HasHeader(hash common.Hash, number uint64) bool + func (bc *BlockChain) HasState(hash common.Hash) bool + func (bc *BlockChain) HeaderChain() *HeaderChain + func (bc *BlockChain) InsertBlockWithoutSetHead(block *types.Block) error + func (bc *BlockChain) InsertChain(chain types.Blocks) (int, error) + func (bc *BlockChain) InsertHeaderChain(chain []*types.Header) (int, error) + func (bc *BlockChain) InsertReceiptChain(blockChain types.Blocks, receiptChain []types.Receipts, ancientLimit uint64) (int, error) + func (bc *BlockChain) Processor() Processor + func (bc *BlockChain) Reset() error + func (bc *BlockChain) ResetWithGenesisBlock(genesis *types.Block) error + func (bc *BlockChain) SetBlockValidatorAndProcessorForTesting(v Validator, p Processor) + func (bc *BlockChain) SetCanonical(head *types.Block) (common.Hash, error) + func (bc *BlockChain) SetFinalized(header *types.Header) + func (bc *BlockChain) SetHead(head uint64) error + func (bc *BlockChain) SetHeadWithTimestamp(timestamp uint64) error + func (bc *BlockChain) SetSafe(header *types.Header) + func (bc *BlockChain) SetTrieFlushInterval(interval time.Duration) + func (bc *BlockChain) SnapSyncCommitHead(hash common.Hash) error + func (bc *BlockChain) Snapshots() *snapshot.Tree + func (bc *BlockChain) State() (*state.StateDB, error) + func (bc *BlockChain) StateAt(root common.Hash) (*state.StateDB, error) + func (bc *BlockChain) StateCache() state.Database + func (bc *BlockChain) Stop() + func (bc *BlockChain) StopInsert() + func (bc *BlockChain) SubscribeBlockProcessingEvent(ch chan<- bool) event.Subscription + func (bc *BlockChain) SubscribeChainEvent(ch chan<- ChainEvent) event.Subscription + func (bc *BlockChain) SubscribeChainHeadEvent(ch chan<- ChainHeadEvent) event.Subscription + func (bc *BlockChain) SubscribeChainSideEvent(ch chan<- ChainSideEvent) event.Subscription + func (bc *BlockChain) SubscribeLogsEvent(ch chan<- []*types.Log) event.Subscription + func (bc *BlockChain) SubscribeRemovedLogsEvent(ch chan<- RemovedLogsEvent) event.Subscription + func (bc *BlockChain) TrieDB() *triedb.Database + func (bc *BlockChain) TxIndexProgress() (TxIndexProgress, error) + func (bc *BlockChain) Validator() Validator + type BlockGen struct + func (b *BlockGen) AddTx(tx *types.Transaction) + func (b *BlockGen) AddTxWithChain(bc *BlockChain, tx *types.Transaction) + func (b *BlockGen) AddTxWithVMConfig(tx *types.Transaction, config vm.Config) + func (b *BlockGen) AddUncheckedReceipt(receipt *types.Receipt) + func (b *BlockGen) AddUncheckedTx(tx *types.Transaction) + func (b *BlockGen) AddUncle(h *types.Header) + func (b *BlockGen) AddWithdrawal(w *types.Withdrawal) uint64 + func (b *BlockGen) BaseFee() *big.Int + func (b *BlockGen) Difficulty() *big.Int + func (b *BlockGen) Gas() uint64 + func (b *BlockGen) GetBalance(addr common.Address) *uint256.Int + func (b *BlockGen) Number() *big.Int + func (b *BlockGen) OffsetTime(seconds int64) + func (b *BlockGen) PrevBlock(index int) *types.Block + func (b *BlockGen) SetCoinbase(addr common.Address) + func (b *BlockGen) SetDifficulty(diff *big.Int) + func (b *BlockGen) SetExtra(data []byte) + func (b *BlockGen) SetNonce(nonce types.BlockNonce) + func (b *BlockGen) SetParentBeaconRoot(root common.Hash) + func (b *BlockGen) SetPoS() + func (b *BlockGen) Signer() types.Signer + func (b *BlockGen) Timestamp() uint64 + func (b *BlockGen) TxNonce(addr common.Address) uint64 + type BlockValidator struct + func NewBlockValidator(config *params.ChainConfig, blockchain *BlockChain) *BlockValidator + func (v *BlockValidator) ValidateBody(block *types.Block) error + func (v *BlockValidator) ValidateState(block *types.Block, statedb *state.StateDB, receipts types.Receipts, ...) error + func (v *BlockValidator) ValidateWitness(witness *stateless.Witness, receiptRoot common.Hash, stateRoot common.Hash) error + type BloomIndexer struct + func (b *BloomIndexer) Commit() error + func (b *BloomIndexer) Process(ctx context.Context, header *types.Header) error + func (b *BloomIndexer) Prune(threshold uint64) error + func (b *BloomIndexer) Reset(ctx context.Context, section uint64, lastSectionHead common.Hash) error + type CacheConfig struct + Preimages bool + SnapshotLimit int + SnapshotNoBuild bool + SnapshotWait bool + StateHistory uint64 + StateScheme string + TrieCleanLimit int + TrieCleanNoPrefetch bool + TrieDirtyDisabled bool + TrieDirtyLimit int + TrieTimeLimit time.Duration + func DefaultCacheConfigWithScheme(scheme string) *CacheConfig + type ChainContext interface + Engine func() consensus.Engine + GetHeader func(common.Hash, uint64) *types.Header + type ChainEvent struct + Block *types.Block + Hash common.Hash + Logs []*types.Log + type ChainHeadEvent struct + Block *types.Block + type ChainIndexer struct + func NewBloomIndexer(db ethdb.Database, size, confirms uint64) *ChainIndexer + func NewChainIndexer(chainDb ethdb.Database, indexDb ethdb.Database, backend ChainIndexerBackend, ...) *ChainIndexer + func (c *ChainIndexer) AddCheckpoint(section uint64, shead common.Hash) + func (c *ChainIndexer) AddChildIndexer(indexer *ChainIndexer) + func (c *ChainIndexer) Close() error + func (c *ChainIndexer) Prune(threshold uint64) error + func (c *ChainIndexer) SectionHead(section uint64) common.Hash + func (c *ChainIndexer) Sections() (uint64, uint64, common.Hash) + func (c *ChainIndexer) Start(chain ChainIndexerChain) + type ChainIndexerBackend interface + Commit func() error + Process func(ctx context.Context, header *types.Header) error + Prune func(threshold uint64) error + Reset func(ctx context.Context, section uint64, prevHead common.Hash) error + type ChainIndexerChain interface + CurrentHeader func() *types.Header + SubscribeChainHeadEvent func(ch chan<- ChainHeadEvent) event.Subscription + type ChainOverrides struct + OverrideCancun *uint64 + OverrideVerkle *uint64 + type ChainReader interface + Config func() *params.ChainConfig + GetTd func(common.Hash, uint64) *big.Int + type ChainSideEvent struct + Block *types.Block + type DeleteBlockContentCallback func(ethdb.KeyValueWriter, common.Hash, uint64) + type ExecutionResult struct + Err error + RefundedGas uint64 + ReturnData []byte + UsedGas uint64 + func ApplyMessage(evm *vm.EVM, msg *Message, gp *GasPool) (*ExecutionResult, error) + func (result *ExecutionResult) Failed() bool + func (result *ExecutionResult) Return() []byte + func (result *ExecutionResult) Revert() []byte + func (result *ExecutionResult) Unwrap() error + type ForkChoice struct + func NewForkChoice(chainReader ChainReader, preserve func(header *types.Header) bool) *ForkChoice + func (f *ForkChoice) ReorgNeeded(current *types.Header, extern *types.Header) (bool, error) + type GasPool uint64 + func (gp *GasPool) AddGas(amount uint64) *GasPool + func (gp *GasPool) Gas() uint64 + func (gp *GasPool) SetGas(gas uint64) + func (gp *GasPool) String() string + func (gp *GasPool) SubGas(amount uint64) error + type Genesis struct + Alloc types.GenesisAlloc + BaseFee *big.Int + BlobGasUsed *uint64 + Coinbase common.Address + Config *params.ChainConfig + Difficulty *big.Int + ExcessBlobGas *uint64 + ExtraData []byte + GasLimit uint64 + GasUsed uint64 + Mixhash common.Hash + Nonce uint64 + Number uint64 + ParentHash common.Hash + Timestamp uint64 + func DefaultGenesisBlock() *Genesis + func DefaultGoerliGenesisBlock() *Genesis + func DefaultHoleskyGenesisBlock() *Genesis + func DefaultSepoliaGenesisBlock() *Genesis + func DeveloperGenesisBlock(gasLimit uint64, faucet *common.Address) *Genesis + func ReadGenesis(db ethdb.Database) (*Genesis, error) + func (g *Genesis) Commit(db ethdb.Database, triedb *triedb.Database) (*types.Block, error) + func (g *Genesis) IsVerkle() bool + func (g *Genesis) MustCommit(db ethdb.Database, triedb *triedb.Database) *types.Block + func (g *Genesis) ToBlock() *types.Block + func (g *Genesis) UnmarshalJSON(input []byte) error + func (g Genesis) MarshalJSON() ([]byte, error) + type GenesisAccount = types.Account + type GenesisAlloc = types.GenesisAlloc + type GenesisMismatchError struct + New common.Hash + Stored common.Hash + func (e *GenesisMismatchError) Error() string + type HeaderChain struct + func NewHeaderChain(chainDb ethdb.Database, config *params.ChainConfig, engine consensus.Engine, ...) (*HeaderChain, error) + func (hc *HeaderChain) Config() *params.ChainConfig + func (hc *HeaderChain) CurrentHeader() *types.Header + func (hc *HeaderChain) Engine() consensus.Engine + func (hc *HeaderChain) GetAncestor(hash common.Hash, number, ancestor uint64, maxNonCanonical *uint64) (common.Hash, uint64) + func (hc *HeaderChain) GetBlock(hash common.Hash, number uint64) *types.Block + func (hc *HeaderChain) GetBlockNumber(hash common.Hash) *uint64 + func (hc *HeaderChain) GetCanonicalHash(number uint64) common.Hash + func (hc *HeaderChain) GetHeader(hash common.Hash, number uint64) *types.Header + func (hc *HeaderChain) GetHeaderByHash(hash common.Hash) *types.Header + func (hc *HeaderChain) GetHeaderByNumber(number uint64) *types.Header + func (hc *HeaderChain) GetHeadersFrom(number, count uint64) []rlp.RawValue + func (hc *HeaderChain) GetTd(hash common.Hash, number uint64) *big.Int + func (hc *HeaderChain) HasHeader(hash common.Hash, number uint64) bool + func (hc *HeaderChain) InsertHeaderChain(chain []*types.Header, start time.Time, forker *ForkChoice) (WriteStatus, error) + func (hc *HeaderChain) Reorg(headers []*types.Header) error + func (hc *HeaderChain) SetCurrentHeader(head *types.Header) + func (hc *HeaderChain) SetGenesis(head *types.Header) + func (hc *HeaderChain) SetHead(head uint64, updateFn UpdateHeadBlocksCallback, ...) + func (hc *HeaderChain) SetHeadWithTimestamp(time uint64, updateFn UpdateHeadBlocksCallback, ...) + func (hc *HeaderChain) ValidateHeaderChain(chain []*types.Header) (int, error) + func (hc *HeaderChain) WriteHeaders(headers []*types.Header) (int, error) + type Message struct + AccessList types.AccessList + BlobGasFeeCap *big.Int + BlobHashes []common.Hash + Data []byte + From common.Address + GasFeeCap *big.Int + GasLimit uint64 + GasPrice *big.Int + GasTipCap *big.Int + Nonce uint64 + SkipAccountChecks bool + To *common.Address + Value *big.Int + func TransactionToMessage(tx *types.Transaction, s types.Signer, baseFee *big.Int) (*Message, error) + type NewMinedBlockEvent struct + Block *types.Block + type NewTxsEvent struct + Txs []*types.Transaction + type Prefetcher interface + Prefetch func(block *types.Block, statedb *state.StateDB, cfg vm.Config, ...) + type Processor interface + Process func(block *types.Block, statedb *state.StateDB, cfg vm.Config) (types.Receipts, []*types.Log, uint64, error) + type RemovedLogsEvent struct + Logs []*types.Log + type StateProcessor struct + func NewStateProcessor(config *params.ChainConfig, chain *HeaderChain) *StateProcessor + func (p *StateProcessor) Process(block *types.Block, statedb *state.StateDB, cfg vm.Config) (types.Receipts, []*types.Log, uint64, error) + type StateTransition struct + func NewStateTransition(evm *vm.EVM, msg *Message, gp *GasPool) *StateTransition + func (st *StateTransition) TransitionDb() (*ExecutionResult, error) + type TxIndexProgress struct + Indexed uint64 + Remaining uint64 + func (progress TxIndexProgress) Done() bool + type UpdateHeadBlocksCallback func(ethdb.KeyValueWriter, *types.Header) (*types.Header, bool) + type Validator interface + ValidateBody func(block *types.Block) error + ValidateState func(block *types.Block, state *state.StateDB, receipts types.Receipts, ...) error + ValidateWitness func(witness *stateless.Witness, receiptRoot common.Hash, stateRoot common.Hash) error + type WriteStatus byte + const CanonStatTy + const NonStatTy + const SideStatTy