rawdb

package
v0.0.0-...-140c642 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 24, 2021 License: GPL-3.0 Imports: 18 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func AppendReceipts

func AppendReceipts(tx ethdb.DbWithPendingMutations, blockNumber uint64, receipts types.Receipts) error

WriteReceipts stores all the transaction receipts belonging to a block.

func DeleteAccount

func DeleteAccount(db DatabaseDeleter, addrHash common.Hash) error

func DeleteBadBlocks

func DeleteBadBlocks(db ethdb.Database)

DeleteBadBlocks deletes all the bad blocks from the database

func DeleteBlock

func DeleteBlock(db ethdb.Database, hash common.Hash, number uint64) error

DeleteBlock removes all block data associated with a hash.

func DeleteBlockWithoutNumber

func DeleteBlockWithoutNumber(db ethdb.Database, hash common.Hash, number uint64) error

DeleteBlockWithoutNumber removes all block data associated with a hash, except the hash to number mapping.

func DeleteBody

func DeleteBody(db DatabaseDeleter, hash common.Hash, number uint64)

DeleteBody removes all block body data associated with a hash.

func DeleteCanonicalHash

func DeleteCanonicalHash(db DatabaseDeleter, number uint64) error

DeleteCanonicalHash removes the number to hash canonical mapping.

func DeleteHeader

func DeleteHeader(db DatabaseDeleter, hash common.Hash, number uint64)

DeleteHeader removes all block header data associated with a hash.

func DeleteHeaderNumber

func DeleteHeaderNumber(db DatabaseDeleter, hash common.Hash)

DeleteHeaderNumber removes hash->number mapping.

func DeleteNewerReceipts

func DeleteNewerReceipts(db ethdb.Database, number uint64) error

DeleteNewerReceipts removes all receipt for given block number or newer

func DeleteReceipts

func DeleteReceipts(db ethdb.Database, number uint64) error

DeleteReceipts removes all receipt data associated with a block hash.

func DeleteTd

func DeleteTd(db DatabaseDeleter, hash common.Hash, number uint64) error

DeleteTd removes all block total difficulty data associated with a hash.

func DeleteTxLookupEntry

func DeleteTxLookupEntry(db DatabaseDeleter, hash common.Hash) error

DeleteTxLookupEntry removes all transaction data associated with a hash.

func FindCommonAncestor

func FindCommonAncestor(db databaseReader, a, b *types.Header) *types.Header

FindCommonAncestor returns the last common ancestor of two block headers

func HasBody

func HasBody(db databaseReader, hash common.Hash, number uint64) bool

HasBody verifies the existence of a block body corresponding to the hash.

func HasHeader

func HasHeader(db databaseReader, hash common.Hash, number uint64) bool

HasHeader verifies the existence of a block header corresponding to the hash.

func HasReceipts

func HasReceipts(db databaseReader, hash common.Hash, number uint64) bool

HasReceipts verifies the existence of all the transaction receipts belonging to a block.

func PlainDeleteAccount

func PlainDeleteAccount(db DatabaseDeleter, address common.Address) error

func PlainReadAccount

func PlainReadAccount(db databaseReader, address common.Address, acc *accounts.Account) (bool, error)

func PlainWriteAccount

func PlainWriteAccount(db DatabaseWriter, address common.Address, acc accounts.Account) error

func PopUncleanShutdownMarker

func PopUncleanShutdownMarker(db ethdb.Database)

PopUncleanShutdownMarker removes the last unclean shutdown marker

func PushUncleanShutdownMarker

func PushUncleanShutdownMarker(db ethdb.Database) ([]uint64, uint64, error)

PushUncleanShutdownMarker appends a new unclean shutdown marker and returns the previous data - a list of timestamps - a count of how many old unclean-shutdowns have been discarded

func ReadAccount

func ReadAccount(db databaseReader, addrHash common.Hash, acc *accounts.Account) (bool, error)

ReadAccount reading account object from multiple buckets of db

func ReadAllBadBlocks

func ReadAllBadBlocks(db ethdb.Database) []*types.Block

ReadAllBadBlocks retrieves all the bad blocks in the database. All returned blocks are sorted in reverse order by number.

func ReadAllHashes

func ReadAllHashes(db databaseReader, number uint64) []common.Hash

ReadAllHashes retrieves all the hashes assigned to blocks at a certain heights, both canonical and reorged forks included.

func ReadBadBlock

func ReadBadBlock(db ethdb.Database, hash common.Hash) *types.Block

ReadBadBlock retrieves the bad block with the corresponding block hash.

func ReadBlock

func ReadBlock(db ethdb.Database, hash common.Hash, number uint64) *types.Block

ReadBlock retrieves an entire block corresponding to the hash, assembling it back from the stored header and body. If either the header or body could not be retrieved nil is returned.

Note, due to concurrent download of header and block body the header and thus canonical hash can be stored in the database but the body data not (yet).

func ReadBlockByHash

func ReadBlockByHash(db ethdb.Database, hash common.Hash) (*types.Block, error)

func ReadBlockByNumber

func ReadBlockByNumber(db ethdb.Database, number uint64) (*types.Block, error)

func ReadBloomBits

func ReadBloomBits(db databaseReader, bit uint, section uint64, head common.Hash) ([]byte, error)

ReadBloomBits retrieves the compressed bloom bit vector belonging to the given section and bit index from the.

func ReadBody

func ReadBody(db ethdb.Database, hash common.Hash, number uint64) *types.Body

ReadBody retrieves the block body corresponding to the hash.

func ReadBodyRLP

func ReadBodyRLP(db ethdb.Database, hash common.Hash, number uint64) rlp.RawValue

ReadBodyRLP retrieves the block body (transactions and uncles) in RLP encoding.

func ReadCanonicalHash

func ReadCanonicalHash(db databaseReader, number uint64) (common.Hash, error)

ReadCanonicalHash retrieves the hash assigned to a canonical block number.

func ReadChainConfig

func ReadChainConfig(db databaseReader, hash common.Hash) (*params.ChainConfig, error)

ReadChainConfig retrieves the consensus settings based on the given genesis hash.

func ReadDatabaseVersion

func ReadDatabaseVersion(db databaseReader) *uint64

ReadDatabaseVersion retrieves the version number of the database.

func ReadFastTrieProgress

func ReadFastTrieProgress(db databaseReader) uint64

ReadFastTrieProgress retrieves the number of tries nodes fast synced to allow reporting correct numbers across restarts.

func ReadHeadBlockHash

func ReadHeadBlockHash(db databaseReader) common.Hash

ReadHeadBlockHash retrieves the hash of the current canonical head block.

func ReadHeadFastBlockHash

func ReadHeadFastBlockHash(db databaseReader) common.Hash

ReadHeadFastBlockHash retrieves the hash of the current fast-sync head block.

func ReadHeadHeaderHash

func ReadHeadHeaderHash(db databaseReader) common.Hash

ReadHeadHeaderHash retrieves the hash of the current canonical head header.

func ReadHeader

func ReadHeader(db databaseReader, hash common.Hash, number uint64) *types.Header

ReadHeader retrieves the block header corresponding to the hash.

func ReadHeaderByHash

func ReadHeaderByHash(db databaseReader, hash common.Hash) (*types.Header, error)

func ReadHeaderByNumber

func ReadHeaderByNumber(db databaseReader, number uint64) *types.Header

func ReadHeaderNumber

func ReadHeaderNumber(db databaseReader, hash common.Hash) *uint64

ReadHeaderNumber returns the header number assigned to a hash.

func ReadHeaderRLP

func ReadHeaderRLP(db databaseReader, hash common.Hash, number uint64) rlp.RawValue

ReadHeaderRLP retrieves a block header in its raw RLP database encoding.

func ReadRawReceipts

func ReadRawReceipts(db ethdb.Database, hash common.Hash, number uint64) types.Receipts

ReadRawReceipts retrieves all the transaction receipts belonging to a block. The receipt metadata fields are not guaranteed to be populated, so they should not be used. Use ReadReceipts instead if the metadata is needed.

func ReadReceipt

func ReadReceipt(db ethdb.Database, hash common.Hash) (*types.Receipt, common.Hash, uint64, uint64)

ReadReceipt retrieves a specific transaction receipt from the database, along with its added positional metadata.

func ReadReceipts

func ReadReceipts(db ethdb.Database, hash common.Hash, number uint64) types.Receipts

ReadReceipts retrieves all the transaction receipts belonging to a block, including its correspoinding metadata fields. If it is unable to populate these metadata fields then nil is returned.

The current implementation populates these metadata fields by reading the receipts' corresponding block body, so if the block body is not found it will return nil even if the receipt itself is stored.

func ReadSenders

func ReadSenders(db databaseReader, hash common.Hash, number uint64) ([]common.Address, error)

func ReadStorageBodyRLP

func ReadStorageBodyRLP(db ethdb.Database, hash common.Hash, number uint64) rlp.RawValue

func ReadTd

func ReadTd(db databaseReader, hash common.Hash, number uint64) (*big.Int, error)

ReadTd retrieves a block's total difficulty corresponding to the hash.

func ReadTdRLP

func ReadTdRLP(db databaseReader, hash common.Hash, number uint64) rlp.RawValue

ReadTdRLP retrieves a block's total difficulty corresponding to the hash in RLP encoding.

func ReadTransaction

func ReadTransaction(db ethdb.Database, hash common.Hash) (*types.Transaction, common.Hash, uint64, uint64)

ReadTransaction retrieves a specific transaction from the database, along with its added positional metadata.

func ReadTransactions

func ReadTransactions(db ethdb.Database, baseTxId uint64, amount uint32) ([]*types.Transaction, error)

func ReadTxLookupEntry

func ReadTxLookupEntry(db databaseReader, hash common.Hash) *uint64

ReadTxLookupEntry retrieves the positional metadata associated with a transaction hash to allow retrieving the transaction or receipt by hash.

func WriteAccount

func WriteAccount(db DatabaseWriter, addrHash common.Hash, acc accounts.Account) error

func WriteAncientBlock

func WriteAncientBlock(db DatabaseWriter, block *types.Block, receipts types.Receipts, td *big.Int) int

FIXME: implement in Turbo-Geth WriteAncientBlock writes entire block data into ancient store and returns the total written size.

func WriteBadBlock

func WriteBadBlock(db ethdb.Database, block *types.Block)

WriteBadBlock serializes the bad block into the database. If the cumulated bad blocks exceeds the limitation, the oldest will be dropped.

func WriteBlock

func WriteBlock(ctx context.Context, db ethdb.Database, block *types.Block) error

WriteBlock serializes a block into the database, header and body separately.

func WriteBloomBits

func WriteBloomBits(db DatabaseWriter, bit uint, section uint64, head common.Hash, bits []byte)

WriteBloomBits stores the compressed bloom bits vector belonging to the given section and bit index.

func WriteBody

func WriteBody(db ethdb.Database, hash common.Hash, number uint64, body *types.Body) error

WriteBody - writes body in Network format, later staged sync will convert it into Storage format

func WriteBodyRLP

func WriteBodyRLP(db DatabaseWriter, hash common.Hash, number uint64, rlp rlp.RawValue)

WriteBodyRLP stores an RLP encoded block body into the database.

func WriteCanonicalHash

func WriteCanonicalHash(db DatabaseWriter, hash common.Hash, number uint64) error

WriteCanonicalHash stores the hash assigned to a canonical block number.

func WriteChainConfig

func WriteChainConfig(db DatabaseWriter, hash common.Hash, cfg *params.ChainConfig) error

WriteChainConfig writes the chain config settings to the database.

func WriteDatabaseVersion

func WriteDatabaseVersion(db DatabaseWriter, version uint64) error

WriteDatabaseVersion stores the version number of the database

func WriteFastTrieProgress

func WriteFastTrieProgress(db DatabaseWriter, count uint64)

WriteFastTrieProgress stores the fast sync trie process counter to support retrieving it across restarts.

func WriteHeadBlockHash

func WriteHeadBlockHash(db DatabaseWriter, hash common.Hash)

WriteHeadBlockHash stores the head block's hash.

func WriteHeadFastBlockHash

func WriteHeadFastBlockHash(db DatabaseWriter, hash common.Hash)

WriteHeadFastBlockHash stores the hash of the current fast-sync head block.

func WriteHeadHeaderHash

func WriteHeadHeaderHash(db DatabaseWriter, hash common.Hash) error

WriteHeadHeaderHash stores the hash of the current canonical head header.

func WriteHeader

func WriteHeader(ctx context.Context, db DatabaseWriter, header *types.Header)

WriteHeader stores a block header into the database and also stores the hash- to-number mapping.

func WriteHeaderNumber

func WriteHeaderNumber(db DatabaseWriter, hash common.Hash, number uint64)

WriteHeaderNumber stores the hash->number mapping.

func WriteReceipts

func WriteReceipts(tx DatabaseWriter, number uint64, receipts types.Receipts) error

WriteReceipts stores all the transaction receipts belonging to a block.

func WriteSenders

func WriteSenders(ctx context.Context, db DatabaseWriter, hash common.Hash, number uint64, senders []common.Address) error

func WriteTd

func WriteTd(db DatabaseWriter, hash common.Hash, number uint64, td *big.Int) error

WriteTd stores the total difficulty of a block into the database.

func WriteTransactions

func WriteTransactions(db ethdb.Database, txs []*types.Transaction, baseTxId uint64) error

func WriteTxLookupEntries

func WriteTxLookupEntries(db DatabaseWriter, block *types.Block)

WriteTxLookupEntries stores a positional metadata for every transaction from a block, enabling hash based transaction and receipt lookups.

Types

type DatabaseDeleter

type DatabaseDeleter interface {
	Delete(bucket string, k, v []byte) error
}

DatabaseDeleter wraps the Delete method of a backing data store.

type DatabaseWriter

type DatabaseWriter interface {
	Put(bucket string, key []byte, value []byte) error
}

DatabaseWriter wraps the Put method of a backing data store.

type TxLookupEntry

type TxLookupEntry struct {
	BlockHash  common.Hash
	BlockIndex uint64
	Index      uint64
}

TxLookupEntry is a positional metadata to help looking up the data content of a transaction or receipt given only its hash.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL