rawdb

package
v1.1.3 Latest Latest
Warning

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

Go to latest
Published: Feb 13, 2020 License: GPL-3.0 Imports: 9 Imported by: 0

Documentation

Overview

Package rawdb contains a collection of low level database accessors.

Index

Constants

This section is empty.

Variables

View Source
var (

	// Chain index prefixes (use `i` + single byte to avoid mixing data types).
	BloomBitsIndexPrefix = []byte("siB") // BloomBitsIndexPrefix is the data table of a chain indexer to track its progress
)

The fields below define the low level database schema prefixing.

Functions

func DeleteBlock

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

DeleteBlock removes all block data associated with a hash.

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)

DeleteCanonicalHash removes the number to hash canonical mapping.

func DeleteFtLookupEntry

func DeleteFtLookupEntry(db DatabaseDeleter, fastHash common.Hash)

DeleteFtLookupEntry removes all fruit data associated with a hash.

func DeleteHeader

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

DeleteHeader removes all block header data associated with a hash.

func DeleteTd

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

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

func FindCommonAncestor

func FindCommonAncestor(db DatabaseReader, a, b *types.SnailHeader) *types.SnailHeader

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 HasCommitteeStates

func HasCommitteeStates(db DatabaseReader, committee uint64) bool

HasCommitteeStates indicates whether committee changes stored

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 ReadBlock

func ReadBlock(db DatabaseReader, hash common.Hash, number uint64) *types.SnailBlock

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 ReadBody

func ReadBody(db DatabaseReader, hash common.Hash, number uint64) *types.SnailBody

ReadBody retrieves the block body corresponding to the hash.

func ReadBodyRLP

func ReadBodyRLP(db DatabaseReader, 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

ReadCanonicalHash retrieves the hash assigned to a canonical block number.

func ReadChainConfig

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

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

func ReadCommitteeStates

func ReadCommitteeStates(db DatabaseReader, committee uint64) []*big.Int

ReadCommitteeStates returns the all committee members states flag sepecified with fastblock height

func ReadDatabaseVersion

func ReadDatabaseVersion(db DatabaseReader) int

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 ReadFruit

func ReadFruit(db DatabaseReader, fastHash common.Hash) (*types.SnailBlock, common.Hash, uint64, uint64)

ReadFruit retrieves a specific fruit from the database, along with its added positional metadata.

func ReadFtLookupEntry

func ReadFtLookupEntry(db DatabaseReader, fastHash common.Hash) (common.Hash, uint64, uint64)

ReadFtLookupEntry retrieves the positional metadata associated with a fruit hash to allow retrieving the fruit by hash.

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.SnailHeader

ReadHeader retrieves the block header corresponding to the hash.

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 ReadTd

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

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

func WriteBlock

func WriteBlock(db DatabaseWriter, block *types.SnailBlock)

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

func WriteBody

func WriteBody(db DatabaseWriter, hash common.Hash, number uint64, body *types.SnailBody)

WriteBody storea a block body into the database.

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)

WriteCanonicalHash stores the hash assigned to a canonical block number.

func WriteChainConfig

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

WriteChainConfig writes the chain config settings to the database.

func WriteCommitteeStates

func WriteCommitteeStates(db DatabaseWriter, committee uint64, changes []*big.Int)

WriteCommitteeStates store the all committee members sepecified with fastblock height

func WriteDatabaseVersion

func WriteDatabaseVersion(db DatabaseWriter, version int)

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 WriteFtLookupEntries

func WriteFtLookupEntries(db DatabaseWriter, block *types.SnailBlock)

WriteFtLookupEntries stores a positional metadata for every fruit from a block, enabling hash based fruit lookups.

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)

WriteHeadHeaderHash stores the hash of the current canonical head header.

func WriteHeader

func WriteHeader(db DatabaseWriter, header *types.SnailHeader)

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

func WriteTd

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

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

Types

type DatabaseDeleter

type DatabaseDeleter interface {
	Delete(key []byte) error
}

DatabaseDeleter wraps the Delete method of a backing data store.

type DatabaseReader

type DatabaseReader interface {
	Has(key []byte) (bool, error)
	Get(key []byte) ([]byte, error)
}

DatabaseReader wraps the Has and Get method of a backing data store.

type DatabaseWriter

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

DatabaseWriter wraps the Put method of a backing data store.

type FtLookupEntry

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

FtLookupEntry is a positional metadata to help looking up the data content of a fruit.

Jump to

Keyboard shortcuts

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