rawdb

package
v0.0.0-...-3da4c06 Latest Latest
Warning

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

Go to latest
Published: Jun 16, 2022 License: LGPL-3.0 Imports: 19 Imported by: 0

Documentation

Overview

Package rawdb contains a collection of low level database accessors.

Index

Constants

View Source
const (
	SpentByte byte = iota
	UnspentByte
	NAByte // not exist
)

Indicate whether the receipts corresponding to a blockHash is spent or not

Variables

View Source
var (

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

)

The fields below define the low level database schema prefixing.

View Source
var MsgNoShardStateFromDB = "failed to read shard state from DB"

MsgNoShardStateFromDB error message for shard state reading failure

Functions

func DeleteBlock

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

DeleteBlock removes all block data associated with a hash.

func DeleteBody

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

DeleteBody removes all block body data associated with a hash.

func DeleteCXReceiptsProofSpent

func DeleteCXReceiptsProofSpent(db DatabaseDeleter, shardID uint32, number uint64) error

DeleteCXReceiptsProofSpent removes unspent indicator of a given blockHash

func DeleteCanonicalHash

func DeleteCanonicalHash(db DatabaseDeleter, number uint64) error

DeleteCanonicalHash removes the number to hash canonical mapping.

func DeleteCrossLinkShardBlock

func DeleteCrossLinkShardBlock(db DatabaseDeleter, shardID uint32, blockNum uint64) error

DeleteCrossLinkShardBlock deletes the blockHash given shardID and blockNum

func DeleteCxLookupEntry

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

DeleteCxLookupEntry removes all transaction data associated with a hash.

func DeleteHeader

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

DeleteHeader removes all block header data associated with a hash.

func DeleteReceipts

func DeleteReceipts(db DatabaseDeleter, hash common.Hash, 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 DeleteValidatorSnapshot

func DeleteValidatorSnapshot(db DatabaseDeleter, addr common.Address, epoch *big.Int) error

DeleteValidatorSnapshot removes the validator's snapshot by its address

func DeleteValidatorStats

func DeleteValidatorStats(db DatabaseDeleter, addr common.Address) error

DeleteValidatorStats ..

func FindCommonAncestor

func FindCommonAncestor(db DatabaseReader, a, b *block.Header) *block.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 IteratorBlocks

func IteratorBlocks(iterator DatabaseIterator, cb func(blockNum uint64, hash common.Hash) bool) (minKey []byte, maxKey []byte)

func IteratorCXReceipt

func IteratorCXReceipt(iterator DatabaseIterator, cb func(it ethdb.Iterator, shardID uint32, number uint64, hash common.Hash) bool)

func IteratorCXReceiptsProofSpent

func IteratorCXReceiptsProofSpent(iterator DatabaseIterator, cb func(it ethdb.Iterator, shardID uint32, number uint64) bool)

func IteratorDelegatorDelegations

func IteratorDelegatorDelegations(iterator DatabaseIterator, cb func(it ethdb.Iterator, delegator common.Address) bool)

func IteratorValidatorSnapshot

func IteratorValidatorSnapshot(iterator DatabaseIterator, cb func(addr common.Address, epoch *big.Int) bool) (minKey []byte, maxKey []byte)

func IteratorValidatorStats

func IteratorValidatorStats(iterator DatabaseIterator, cb func(it ethdb.Iterator, addr common.Address) bool)

func ReadBlock

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

func ReadBlockCommitSig(db DatabaseReader, blockNum uint64) ([]byte, error)

ReadBlockCommitSig retrieves the signature signed on a block.

func ReadBlockRewardAccumulator

func ReadBlockRewardAccumulator(db DatabaseReader, number uint64) (*big.Int, error)

ReadBlockRewardAccumulator ..

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 DatabaseReader, hash common.Hash, number uint64) *types.Body

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 ReadCXReceipt

func ReadCXReceipt(db DatabaseReader, hash common.Hash) (*types.CXReceipt, common.Hash, uint64, uint64)

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

func ReadCXReceipts

func ReadCXReceipts(db DatabaseReader, shardID uint32, number uint64, hash common.Hash) (types.CXReceipts, error)

ReadCXReceipts retrieves all the transactions of receipts given destination shardID, number and blockHash

func ReadCXReceiptsProofSpent

func ReadCXReceiptsProofSpent(db DatabaseReader, shardID uint32, number uint64) (byte, error)

ReadCXReceiptsProofSpent check whether a CXReceiptsProof is unspent

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 ReadCrossLinkShardBlock

func ReadCrossLinkShardBlock(
	db DatabaseReader, shardID uint32, blockNum uint64,
) ([]byte, error)

ReadCrossLinkShardBlock retrieves the blockHash given shardID and blockNum

func ReadCxLookupEntry

func ReadCxLookupEntry(db DatabaseReader, hash common.Hash) (common.Hash, uint64, uint64)

ReadCxLookupEntry retrieves the positional metadata associated with a transaction hash to allow retrieving cross shard receipt by hash in destination shard not the original transaction in source shard return nil if not found

func ReadDatabaseVersion

func ReadDatabaseVersion(db DatabaseReader) int

ReadDatabaseVersion retrieves the version number of the database.

func ReadDelegationsByDelegator

func ReadDelegationsByDelegator(db DatabaseReader, delegator common.Address) (staking.DelegationIndexes, error)

ReadDelegationsByDelegator retrieves the list of validators delegated by a delegator Returns empty results instead of error if there is not data found.

func ReadEpochBlockNumber

func ReadEpochBlockNumber(db DatabaseReader, epoch *big.Int) (*big.Int, error)

ReadEpochBlockNumber retrieves the epoch block number for the given epoch, or nil if the given epoch is not found in the database.

func ReadEpochVdfBlockNum

func ReadEpochVdfBlockNum(db DatabaseReader, epoch *big.Int) ([]byte, error)

ReadEpochVdfBlockNum retrieves the VDF block number for the given epoch

func ReadEpochVrfBlockNums

func ReadEpochVrfBlockNums(db DatabaseReader, epoch *big.Int) ([]byte, error)

ReadEpochVrfBlockNums retrieves the VRF block numbers for the given epoch

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) *block.Header

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 ReadPendingCrossLinks(db DatabaseReader) ([]byte, error)

ReadPendingCrossLinks retrieves last pending crosslinks.

func ReadPreimage

func ReadPreimage(db DatabaseReader, hash common.Hash) []byte

ReadPreimage retrieves a single preimage of the provided hash.

func ReadReceipt

func ReadReceipt(db DatabaseReader, 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 DatabaseReader, hash common.Hash, number uint64) types.Receipts

ReadReceipts retrieves all the transaction receipts belonging to a block.

func ReadShardLastCrossLink(db DatabaseReader, shardID uint32) ([]byte, error)

ReadShardLastCrossLink read the last cross link of a shard

func ReadShardState

func ReadShardState(
	db DatabaseReader, epoch *big.Int,
) (*shard.State, error)

ReadShardState retrieves shard state of a specific epoch.

func ReadStakingTransaction

func ReadStakingTransaction(db DatabaseReader, hash common.Hash) (*staking.StakingTransaction, common.Hash, uint64, uint64)

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

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 ReadTransaction

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

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

func ReadTxLookupEntry

func ReadTxLookupEntry(db DatabaseReader, hash common.Hash) (common.Hash, uint64, uint64)

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

func ReadValidatorList

func ReadValidatorList(db DatabaseReader) ([]common.Address, error)

ReadValidatorList retrieves all staking validators by its address

func ReadValidatorSnapshot

func ReadValidatorSnapshot(
	db DatabaseReader, addr common.Address, epoch *big.Int,
) (*staking.ValidatorSnapshot, error)

ReadValidatorSnapshot retrieves validator's snapshot by its address

func ReadValidatorStats

func ReadValidatorStats(
	db DatabaseReader, addr common.Address,
) (*staking.ValidatorStats, error)

ReadValidatorStats retrieves validator's stats by its address,

func WriteBlock

func WriteBlock(db DatabaseWriter, block *types.Block) error

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

func WriteBlockCommitSig

func WriteBlockCommitSig(db DatabaseWriter, blockNum uint64, sigAndBitmap []byte) error

WriteBlockCommitSig ..

func WriteBlockRewardAccumulator

func WriteBlockRewardAccumulator(db DatabaseWriter, newAccum *big.Int, number uint64) error

WriteBlockRewardAccumulator ..

func WriteBlockStxLookUpEntries

func WriteBlockStxLookUpEntries(db DatabaseWriter, block *types.Block) error

WriteBlockStxLookUpEntries writes all look up entries of block's staking transactions

func WriteBlockTxLookUpEntries

func WriteBlockTxLookUpEntries(db DatabaseWriter, block *types.Block) error

WriteBlockTxLookUpEntries writes all look up entries of block's transactions

func WriteBloomBits

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

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

func WriteBody

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

WriteBody storea a block body into the database.

func WriteBodyRLP

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

WriteBodyRLP stores an RLP encoded block body into the database.

func WriteCXReceipts

func WriteCXReceipts(db DatabaseWriter, shardID uint32, number uint64, hash common.Hash, receipts types.CXReceipts) error

WriteCXReceipts stores all the transaction receipts given destination shardID, blockNumber and blockHash

func WriteCXReceiptsProofSpent

func WriteCXReceiptsProofSpent(dbw DatabaseWriter, cxp *types.CXReceiptsProof) error

WriteCXReceiptsProofSpent write CXReceiptsProof as spent into 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 WriteCrossLinkShardBlock

func WriteCrossLinkShardBlock(db DatabaseWriter, shardID uint32, blockNum uint64, data []byte) error

WriteCrossLinkShardBlock stores the blockHash given shardID and blockNum

func WriteCxLookupEntries

func WriteCxLookupEntries(db DatabaseWriter, block *types.Block) error

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

func WriteDatabaseVersion

func WriteDatabaseVersion(db DatabaseWriter, version int) error

WriteDatabaseVersion stores the version number of the database

func WriteDelegationsByDelegator

func WriteDelegationsByDelegator(db DatabaseWriter, delegator common.Address, indexes staking.DelegationIndexes) error

WriteDelegationsByDelegator stores the list of validators delegated by a delegator

func WriteEpochBlockNumber

func WriteEpochBlockNumber(db DatabaseWriter, epoch, blockNum *big.Int) error

WriteEpochBlockNumber stores the given epoch-number-to-epoch-block-number in the database.

func WriteEpochVdfBlockNum

func WriteEpochVdfBlockNum(db DatabaseWriter, epoch *big.Int, data []byte) error

WriteEpochVdfBlockNum stores the VDF block number for the given epoch

func WriteEpochVrfBlockNums

func WriteEpochVrfBlockNums(db DatabaseWriter, epoch *big.Int, data []byte) error

WriteEpochVrfBlockNums stores the VRF block numbers for the given epoch

func WriteHeadBlockHash

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

WriteHeadBlockHash stores the head block's hash.

func WriteHeadFastBlockHash

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

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(db DatabaseWriter, header *block.Header) error

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

func WritePendingCrossLinks(db DatabaseWriter, bytes []byte) error

WritePendingCrossLinks stores last pending crosslinks into database.

func WritePendingSlashingCandidates

func WritePendingSlashingCandidates(db DatabaseWriter, bytes []byte) error

WritePendingSlashingCandidates stores last pending slashing candidates into database.

func WritePreimages

func WritePreimages(db DatabaseWriter, number uint64, preimages map[common.Hash][]byte) error

WritePreimages writes the provided set of preimages to the database. `number` is the current block number, and is used for debug messages only.

func WriteReceipts

func WriteReceipts(db DatabaseWriter, hash common.Hash, number uint64, receipts types.Receipts) error

WriteReceipts stores all the transaction receipts belonging to a block.

func WriteShardLastCrossLink(db DatabaseWriter, shardID uint32, data []byte) error

WriteShardLastCrossLink stores the last cross link of a shard

func WriteShardStateBytes

func WriteShardStateBytes(db DatabaseWriter, epoch *big.Int, data []byte) error

WriteShardStateBytes stores sharding state into database.

func WriteSnapdbInfo

func WriteSnapdbInfo(db DatabaseWriter, info *SnapdbInfo) error

WriteSnapdbInfo write the SnapdbInfo into db

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 WriteValidatorList

func WriteValidatorList(
	db DatabaseWriter, addrs []common.Address,
) error

WriteValidatorList stores all staking validators by its address

func WriteValidatorSnapshot

func WriteValidatorSnapshot(batch DatabaseWriter, v *staking.ValidatorWrapper, epoch *big.Int) error

WriteValidatorSnapshot stores validator's snapshot by its address

func WriteValidatorStats

func WriteValidatorStats(
	batch DatabaseWriter, addr common.Address, stats *staking.ValidatorStats,
) error

WriteValidatorStats stores validator's stats by its address

Types

type DatabaseDeleter

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

DatabaseDeleter wraps the Delete method of a backing data store.

type DatabaseIterator

type DatabaseIterator interface {
	NewIteratorWithPrefix(prefix []byte) ethdb.Iterator
}

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 SnapdbInfo

type SnapdbInfo struct {
	NetworkType         nodeconfig.NetworkType // network type
	BlockHeader         *block.Header          // latest header at snapshot
	AccountCount        uint64                 // number of dumped account
	OffchainDataDumped  bool                   // is OffchainData dumped
	IndexerDataDumped   bool                   // is IndexerData dumped
	StateDataDumped     bool                   // is StateData dumped
	DumpedSize          uint64                 // size of key-value already dumped
	LastAccountKey      hexutil.Bytes          // MPT key of the account last dumped, use this to continue dumping
	LastAccountStateKey hexutil.Bytes          // MPT key of the account's state last dumped, use this to continue dumping
}

SnapdbInfo only used by cmd/astra/dumpdb.go

func ReadSnapdbInfo

func ReadSnapdbInfo(db DatabaseReader) *SnapdbInfo

ReadSnapdbInfo return the SnapdbInfo of the db

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