Versions in this module Expand all Collapse all v0 v0.0.1 Oct 19, 2023 Changes in this version + const BlockChainVersion + const TriesInMemory + var BadHashes = map[common.Hash]bool + var ErrAncestorHasNotBeenVerified = errors.New("block ancestor has not been verified") + var ErrBannedHash = errors.New("banned hash") + var ErrBlobFeeCapTooLow = errors.New("max fee per blob gas less than block blob gas fee") + var ErrCurrentBlockNotFound = errors.New("current block not found") + 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 ErrKnownBadBlock = errors.New("already known bad block") + 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 SenderCacher = newTxSenderCacher(runtime.NumCPU()) + func ApplyTransaction(config *params.ChainConfig, bc ChainContext, author *common.Address, ...) (*types.Receipt, error) + func CalcGasLimit(parentGasLimit, desiredLimit uint64) uint64 + func CalculateDiffHash(d *types.DiffLayer) (common.Hash, error) + 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 LoadChainConfig(db ethdb.Database, genesis *Genesis) (*params.ChainConfig, common.Hash, error) + func NewEVMBlockContext(header *types.Header, chain ChainContext, author *common.Address) vm.BlockContext + func NewEVMTxContext(msg *Message) vm.TxContext + func NewStatePrefetcher(config *params.ChainConfig, bc *BlockChain, engine consensus.Engine) *statePrefetcher + func NewVerifyManager(blockchain *BlockChain, peers verifyPeers, allowInsecure bool) (*remoteVerifyManager, error) + func NewVerifyTask(diffhash common.Hash, header *types.Header, peers verifyPeers, ...) *verifyTask + 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) + type AsyncReceiptBloomGenerator struct + func NewAsyncReceiptBloomGenerator(txNums int) *AsyncReceiptBloomGenerator + func (p *AsyncReceiptBloomGenerator) Apply(receipt *types.Receipt) + func (p *AsyncReceiptBloomGenerator) Close() + type BlockChain struct + func EnableDoubleSignChecker(bc *BlockChain) (*BlockChain, error) + func EnablePipelineCommit(bc *BlockChain) (*BlockChain, error) + 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) GetHighestVerifiedHeader() *types.Header + func (bc *BlockChain) GetJustifiedNumber(header *types.Header) uint64 + 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) GetTrieFlushInterval() time.Duration + func (bc *BlockChain) GetTrustedDiffLayer(blockHash common.Hash) *types.DiffLayer + func (bc *BlockChain) GetUnclesInChain(block *types.Block, length int) []*types.Header + func (bc *BlockChain) GetVMConfig() *vm.Config + func (bc *BlockChain) GetVerifyResult(blockNumber uint64, blockHash common.Hash, diffHash common.Hash) *VerifyResult + 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) (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) SetHead(head uint64) error + func (bc *BlockChain) SetHeadWithTimestamp(timestamp uint64) error + 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) StateAtWithSharedPool(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) SubscribeChainBlockEvent(ch chan<- ChainHeadEvent) 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) SubscribeFinalizedHeaderEvent(ch chan<- FinalizedHeaderEvent) 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) TriesInMemory() uint64 + 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) + type BlockChainOption func(*BlockChain) (*BlockChain, error) + func EnableBlockValidator(chainConfig *params.ChainConfig, engine consensus.Engine, mode VerifyMode, ...) BlockChainOption + func EnablePersistDiff(limit uint64) BlockChainOption + 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) 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) Timestamp() uint64 + 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) RemoteVerifyManager() *remoteVerifyManager + func (v *BlockValidator) ValidateBody(block *types.Block) error + func (v *BlockValidator) ValidateState(block *types.Block, statedb *state.StateDB, receipts types.Receipts, ...) error + type BlockValidatorOption func(*BlockValidator) *BlockValidator + func EnableRemoteVerifyManager(remoteValidator *remoteVerifyManager) BlockValidatorOption + 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 + NoTries bool + Preimages bool + SnapshotLimit int + SnapshotNoBuild bool + SnapshotWait bool + TrieCleanLimit int + TrieCleanNoPrefetch bool + TrieDirtyDisabled bool + TrieDirtyLimit int + 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 + OverrideCancun *uint64 + OverrideVerkle *uint64 + type ChainReader interface + Config func() *params.ChainConfig + Engine func() consensus.Engine + GetJustifiedNumber func(header *types.Header) uint64 + 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 + 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 FinalizedHeaderEvent struct + Header *types.Header + 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) + func (f *ForkChoice) ReorgNeededWithFastFinality(current *types.Header, header *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 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 DeveloperGenesisBlock(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) GetBlockHashesFromHash(hash common.Hash, max uint64) []common.Hash + 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) GetHighestVerifiedHeader() *types.Header + func (hc *HeaderChain) GetJustifiedNumber(header *types.Header) uint64 + 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 NewVoteEvent struct + Vote *types.VoteEnvelope + type Prefetcher interface + Prefetch func(block *types.Block, statedb *state.StateDB, cfg *vm.Config, ...) + PrefetchMining func(txs TransactionsByPriceAndNonce, header *types.Header, gasLimit uint64, ...) + type Processor interface + Process func(block *types.Block, statedb *state.StateDB, cfg vm.Config) (*state.StateDB, types.Receipts, []*types.Log, uint64, error) + type ReannoTxsEvent struct + Txs []*types.Transaction + type ReceiptBloomGenerator struct + func NewReceiptBloomGenerator() *ReceiptBloomGenerator + func (p *ReceiptBloomGenerator) Apply(receipt *types.Receipt) + type ReceiptProcessor interface + Apply func(receipt *types.Receipt) + 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) (*state.StateDB, 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 TransactionsByPriceAndNonce interface + Forward func(tx *types.Transaction) + PeekWithUnwrap func() *types.Transaction + Shift func() + type UpdateHeadBlocksCallback func(ethdb.KeyValueWriter, *types.Header) (*types.Header, bool) + type Validator interface + RemoteVerifyManager func() *remoteVerifyManager + ValidateBody func(block *types.Block) error + ValidateState func(block *types.Block, state *state.StateDB, receipts types.Receipts, ...) error + type VerifyMode uint32 + const FullVerify + const InsecureVerify + const LocalVerify + const NoneVerify + func (mode *VerifyMode) UnmarshalText(text []byte) error + func (mode VerifyMode) IsValid() bool + func (mode VerifyMode) MarshalText() ([]byte, error) + func (mode VerifyMode) NeedRemoteVerify() bool + func (mode VerifyMode) String() string + type VerifyPeer interface + ID func() string + RequestRoot func(blockNumber uint64, blockHash common.Hash, diffHash common.Hash) error + type VerifyResult struct + BlockHash common.Hash + BlockNumber uint64 + Root common.Hash + Status types.VerifyStatus + type WriteStatus byte + const CanonStatTy + const NonStatTy + const SideStatTy