Versions in this module Expand all Collapse all v1 v1.0.0 May 10, 2023 Changes in this version + const BlockChainVersion + const DefaultTriesInMemory + const KilnAllocData + var BadHashes = map[common.Hash]bool + var ErrBannedHash = errors.New("banned hash") + 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 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 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 GetArbOSSpeedLimitPerSecond func(statedb *state.StateDB) (uint64, error) + var InterceptRPCGasCap = func(gascap *uint64, msg types.Message, header *types.Header, ...) + var InterceptRPCMessage = func(msg types.Message, ctx context.Context, statedb *state.StateDB, ...) (types.Message, *ExecutionResult, error) + var ReadyEVMForL2 func(evm *vm.EVM, msg Message) + var RenderRPCError func(data []byte) error + var SenderCacher = newTxSenderCacher(runtime.NumCPU()) + func CalcGasLimit(parentGasLimit, desiredLimit uint64) uint64 + func CanTransfer(db vm.StateDB, addr common.Address, amount *big.Int) bool + func CommitGenesisState(db ethdb.Database, triedb *trie.Database, blockhash 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 GetHashFn(ref *types.Header, chain ChainContext) func(n uint64) common.Hash + func IntrinsicGas(data []byte, accessList types.AccessList, isContractCreation bool, ...) (uint64, error) + func LoadCliqueConfig(db ethdb.Database, genesis *Genesis) (*params.CliqueConfig, error) + func NewEVMBlockContext(header *types.Header, chain ChainContext, author *common.Address) vm.BlockContext + func NewEVMTxContext(msg Message) vm.TxContext + func SetupGenesisBlock(db ethdb.Database, triedb *trie.Database, genesis *Genesis) (*params.ChainConfig, common.Hash, error) + func SetupGenesisBlockWithOverride(db ethdb.Database, triedb *trie.Database, genesis *Genesis, ...) (*params.ChainConfig, common.Hash, error) + func Transfer(db vm.StateDB, sender, recipient common.Address, amount *big.Int) + func WriteHeadBlock(db ethdb.Database, block *types.Block, prevDifficulty *big.Int) + type BlockChain struct + func NewBlockChain(db ethdb.Database, cacheConfig *CacheConfig, chainConfig *params.ChainConfig, ...) (*BlockChain, error) + func (bc *BlockChain) ClipToPostNitroGenesis(blockNum rpc.BlockNumber) (rpc.BlockNumber, rpc.BlockNumber) + func (bc *BlockChain) Config() *params.ChainConfig + func (bc *BlockChain) ContractCode(hash common.Hash) ([]byte, error) + func (bc *BlockChain) ContractCodeWithPrefix(hash common.Hash) ([]byte, error) + func (bc *BlockChain) CurrentBlock() *types.Block + func (bc *BlockChain) CurrentFastBlock() *types.Block + func (bc *BlockChain) CurrentFinalizedBlock() *types.Block + func (bc *BlockChain) CurrentHeader() *types.Header + func (bc *BlockChain) CurrentSafeBlock() *types.Block + 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 + 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) InsertBlockWithoutSetHead(block *types.Block) error + func (bc *BlockChain) InsertChain(chain types.Blocks) (int, error) + func (bc *BlockChain) InsertHeaderChain(chain []*types.Header, checkFreq int) (int, error) + func (bc *BlockChain) InsertReceiptChain(blockChain types.Blocks, receiptChain []types.Receipts, ancientLimit uint64) (int, error) + func (bc *BlockChain) Processor() Processor + func (bc *BlockChain) RecoverState(block *types.Block) error + func (bc *BlockChain) ReorgToOldBlock(newHead *types.Block) error + 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(block *types.Block) + func (bc *BlockChain) SetHead(head uint64) error + func (bc *BlockChain) SetHeadWithTimestamp(timestamp uint64) error + func (bc *BlockChain) SetSafe(block *types.Block) + func (bc *BlockChain) SetTrieFlushInterval(interval time.Duration) + func (bc *BlockChain) SetTxLookupLimit(limit uint64) + 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() *trie.Database + func (bc *BlockChain) TrieNode(hash common.Hash) ([]byte, error) + func (bc *BlockChain) TxLookupLimit() uint64 + func (bc *BlockChain) Validator() Validator + func (bc *BlockChain) WriteBlockAndSetHead(block *types.Block, receipts []*types.Receipt, logs []*types.Log, ...) (status WriteStatus, err error) + func (bc *BlockChain) WriteBlockAndSetHeadWithTime(block *types.Block, receipts []*types.Receipt, logs []*types.Log, ...) (status WriteStatus, err error) + 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) + func (b *BlockGen) BaseFee() *big.Int + func (b *BlockGen) GetBalance(addr common.Address) *big.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) SetPoS() + func (b *BlockGen) TxNonce(addr common.Address) uint64 + type BlockValidator struct + func NewBlockValidator(config *params.ChainConfig, blockchain *BlockChain, engine consensus.Engine) *BlockValidator + func (v *BlockValidator) ValidateBody(block *types.Block) error + func (v *BlockValidator) ValidateState(block *types.Block, statedb *state.StateDB, receipts types.Receipts, ...) 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 + SnapshotRestoreMaxGas uint64 + SnapshotWait bool + TrieCleanJournal string + TrieCleanLimit int + TrieCleanNoPrefetch bool + TrieCleanRejournal time.Duration + TrieDirtyDisabled bool + TrieDirtyLimit int + TrieRetention time.Duration + TrieTimeLimit time.Duration + TriesInMemory uint64 + 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 + OverrideShanghai *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 + ReturnData []byte + ScheduledTxes types.Transactions + TopLevelDeployed *common.Address + UsedGas uint64 + func ApplyMessage(evm *vm.EVM, msg Message, gp *GasPool) (*ExecutionResult, error) + func ApplyTransaction(config *params.ChainConfig, bc ChainContext, author *common.Address, ...) (*types.Receipt, *ExecutionResult, error) + func ApplyTransactionWithResultFilter(config *params.ChainConfig, bc ChainContext, author *common.Address, ...) (*types.Receipt, *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) String() string + func (gp *GasPool) SubGas(amount uint64) error + type Genesis struct + Alloc GenesisAlloc + BaseFee *big.Int + Coinbase common.Address + Config *params.ChainConfig + Difficulty *big.Int + 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 DefaultRinkebyGenesisBlock() *Genesis + func DefaultSepoliaGenesisBlock() *Genesis + func DeveloperGenesisBlock(period uint64, gasLimit uint64, faucet common.Address) *Genesis + func ReadGenesis(db ethdb.Database) (*Genesis, error) + func (g *Genesis) Commit(db ethdb.Database, triedb *trie.Database) (*types.Block, error) + func (g *Genesis) MustCommit(db ethdb.Database) *types.Block + func (g *Genesis) ToBlock() *types.Block + func (g *Genesis) UnmarshalJSON(input []byte) error + func (g Genesis) MarshalJSON() ([]byte, error) + type GenesisAccount struct + Balance *big.Int + Code []byte + Nonce uint64 + PrivateKey []byte + Storage map[common.Hash]common.Hash + func (g *GenesisAccount) UnmarshalJSON(input []byte) error + func (g GenesisAccount) MarshalJSON() ([]byte, error) + type GenesisAlloc map[common.Address]GenesisAccount + func (ga *GenesisAlloc) UnmarshalJSON(data []byte) error + 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, checkFreq int) (int, error) + func (hc *HeaderChain) WriteHeaders(headers []*types.Header) (int, error) + type Message interface + AccessList func() types.AccessList + Data func() []byte + From func() common.Address + Gas func() uint64 + GasFeeCap func() *big.Int + GasPrice func() *big.Int + GasTipCap func() *big.Int + IsFake func() bool + Nonce func() uint64 + RunMode func() types.MessageRunMode + To func() *common.Address + UnderlyingTransaction func() *types.Transaction + Value func() *big.Int + type NewMinedBlockEvent struct + Block *types.Block + type NewTxsEvent struct + Txs []*types.Transaction + type NodeInterfaceBackendAPI interface + BlockByNumber func(ctx context.Context, number rpc.BlockNumber) (*types.Block, error) + ChainConfig func() *params.ChainConfig + CurrentBlock func() *types.Block + GetEVM func(ctx context.Context, msg Message, state *state.StateDB, header *types.Header, ...) (*vm.EVM, func() error, error) + GetLogs func(ctx context.Context, blockHash common.Hash, number uint64) ([][]*types.Log, error) + type Prefetcher interface + Prefetch func(block *types.Block, statedb *state.StateDB, cfg vm.Config, interrupt *uint32) + 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, bc *BlockChain, engine consensus.Engine) *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 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 + type WriteStatus byte + const CanonStatTy + const NonStatTy + const SideStatTy