blockchain

package
v0.30.1-binance.5 Latest Latest
Warning

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

 Go to latest Published: Apr 15, 2019 License: Apache-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// BlockchainChannel is a channel for blocks and status updates (`BlockStore` height)
	BlockchainChannel = byte(0x40)
)
View Source 
const (
	// StateChannel is a channel for state and status updates (`StateStore` height)
	StateChannel = byte(0x35)
)

Variables

This section is empty.

Functions

func RegisterBlockchainMessages added in v0.19.0 

func RegisterBlockchainMessages(cdc *amino.Codec)

func RegisterBlockchainStateMessages 

func RegisterBlockchainStateMessages(cdc *amino.Codec)

Types

type BlockPool 

type BlockPool struct {
	cmn.BaseService
	// contains filtered or unexported fields
}

func NewBlockPool 

func NewBlockPool(start int64, requestsCh chan<- BlockRequest, errorsCh chan<- peerError) *BlockPool

func (*BlockPool) AddBlock 

func (pool *BlockPool) AddBlock(peerID p2p.ID, block *types.Block, blockSize int)

TODO: ensure that blocks come in order for each peer.

func (*BlockPool) GetStatus 

func (pool *BlockPool) GetStatus() (height int64, numPending int32, lenRequesters int)

func (*BlockPool) IsCaughtUp 

func (pool *BlockPool) IsCaughtUp() bool

TODO: relax conditions, prevent abuse.

func (*BlockPool) MaxPeerHeight added in v0.12.0 

func (pool *BlockPool) MaxPeerHeight() int64

MaxPeerHeight returns the highest height reported by a peer.

func (*BlockPool) OnStart 

func (pool *BlockPool) OnStart() error

func (*BlockPool) OnStop 

func (pool *BlockPool) OnStop()

func (*BlockPool) PeekTwoBlocks 

func (pool *BlockPool) PeekTwoBlocks() (first *types.Block, second *types.Block)

We need to see the second block's Commit to validate the first block. So we peek two blocks at a time. The caller will verify the commit.

func (*BlockPool) PopRequest 

func (pool *BlockPool) PopRequest()

Pop the first block at pool.height It must have been validated by 'second'.Commit from PeekTwoBlocks().

func (*BlockPool) RedoRequest 

func (pool *BlockPool) RedoRequest(height int64) p2p.ID

Invalidates the block at pool.height, Remove the peer and redo request from others. Returns the ID of the removed peer.

func (*BlockPool) RemovePeer 

func (pool *BlockPool) RemovePeer(peerID p2p.ID)

func (*BlockPool) SetPeerHeight 

func (pool *BlockPool) SetPeerHeight(peerID p2p.ID, height int64)

Sets the peer's alleged blockchain height.

type BlockRequest 

type BlockRequest struct {
	Height int64
	PeerID p2p.ID
}

type BlockStore 

type BlockStore struct {
	// contains filtered or unexported fields
}

BlockStore is a simple low level store for blocks.

There are three types of information stored:

  • BlockMeta: Meta information about each block
  • Block part: Parts of each block, aggregated w/ PartSet
  • Commit: The commit part of each block, for gossiping precommit votes

Currently the precommit signatures are duplicated in the Block parts as well as the Commit. In the future this may change, perhaps by moving the Commit data outside the Block. (TODO)

// NOTE: BlockStore methods will panic if they encounter errors // deserializing loaded data, indicating probable corruption on disk.

func NewBlockStore 

func NewBlockStore(db dbm.DB) *BlockStore

NewBlockStore returns a new BlockStore with the given DB, initialized to the last height that was committed to the DB.

func (*BlockStore) Height 

func (bs *BlockStore) Height() int64

Height returns the last known contiguous block height.

func (*BlockStore) LoadBlock 

func (bs *BlockStore) LoadBlock(height int64) *types.Block

LoadBlock returns the block with the given height. If no block is found for that height, it returns nil.

func (*BlockStore) LoadBlockCommit 

func (bs *BlockStore) LoadBlockCommit(height int64) *types.Commit

LoadBlockCommit returns the Commit for the given height. This commit consists of the +2/3 and other Precommit-votes for block at `height`, and it comes from the block.LastCommit for `height+1`. If no commit is found for the given height, it returns nil.

func (*BlockStore) LoadBlockMeta 

func (bs *BlockStore) LoadBlockMeta(height int64) *types.BlockMeta

LoadBlockMeta returns the BlockMeta for the given height. If no block is found for the given height, it returns nil.

func (*BlockStore) LoadBlockPart 

func (bs *BlockStore) LoadBlockPart(height int64, index int) *types.Part

LoadBlockPart returns the Part at the given index from the block at the given height. If no part is found for the given height and index, it returns nil.

func (*BlockStore) LoadSeenCommit 

func (bs *BlockStore) LoadSeenCommit(height int64) *types.Commit

LoadSeenCommit returns the locally seen Commit for the given height. This is useful when we've seen a commit, but there has not yet been a new block at `height + 1` that includes this commit in its block.LastCommit.

func (*BlockStore) SaveBlock 

func (bs *BlockStore) SaveBlock(block *types.Block, blockParts *types.PartSet, seenCommit *types.Commit)

SaveBlock persists the given block, blockParts, and seenCommit to the underlying db. blockParts: Must be parts of the block seenCommit: The +2/3 precommits that were seen which committed at height. 

If all the nodes restart after committing a block,
we need this to reload the precommits to catch-up nodes to the
most recent height.  Otherwise they'd stall at H-1.

func (*BlockStore) SetHeight 

func (bs *BlockStore) SetHeight(height int64)

should be only used by state sync

type BlockStoreStateJSON 

type BlockStoreStateJSON struct {
	Height int64 `json:"height"`
}

func LoadBlockStoreStateJSON 

func LoadBlockStoreStateJSON(db dbm.DB) BlockStoreStateJSON

LoadBlockStoreStateJSON returns the BlockStoreStateJSON as loaded from disk. If no BlockStoreStateJSON was previously persisted, it returns the zero value.

func (BlockStoreStateJSON) Save 

func (bsj BlockStoreStateJSON) Save(db dbm.DB)

Save persists the blockStore state to the database as JSON.

type BlockchainMessage 

type BlockchainMessage interface {
	ValidateBasic() error
}

BlockchainMessage is a generic message for this reactor.

type BlockchainReactor 

type BlockchainReactor struct {
	p2p.BaseReactor
	// contains filtered or unexported fields
}

BlockchainReactor handles long-term catchup syncing.

func NewBlockchainReactor 

func NewBlockchainReactor(state sm.State, blockExec *sm.BlockExecutor, store *BlockStore,
	fastSync bool) *BlockchainReactor

NewBlockchainReactor returns new reactor instance.

func (*BlockchainReactor) AddPeer 

func (bcR *BlockchainReactor) AddPeer(peer p2p.Peer)

AddPeer implements Reactor by sending our state to peer.

func (*BlockchainReactor) BroadcastStatusRequest 

func (bcR *BlockchainReactor) BroadcastStatusRequest() error

BroadcastStatusRequest broadcasts `BlockStore` height.

func (*BlockchainReactor) GetChannels 

func (bcR *BlockchainReactor) GetChannels() []*p2p.ChannelDescriptor

GetChannels implements Reactor

func (*BlockchainReactor) OnStart 

func (bcR *BlockchainReactor) OnStart() error

OnStart implements cmn.Service.

func (*BlockchainReactor) OnStop 

func (bcR *BlockchainReactor) OnStop()

OnStop implements cmn.Service.

func (*BlockchainReactor) Receive 

func (bcR *BlockchainReactor) Receive(chID byte, src p2p.Peer, msgBytes []byte)

Receive implements Reactor by handling 4 types of messages (look below).

func (*BlockchainReactor) RemovePeer 

func (bcR *BlockchainReactor) RemovePeer(peer p2p.Peer, reason interface{})

RemovePeer implements Reactor by removing peer from the pool.

func (*BlockchainReactor) SetLogger added in v0.12.0 

func (bcR *BlockchainReactor) SetLogger(l log.Logger)

SetLogger implements cmn.Service by setting the logger on reactor and pool.

func (*BlockchainReactor) SwitchToBlockchain 

func (bcR *BlockchainReactor) SwitchToBlockchain(state *sm.State)

SwitchToBlockchain switches from fastest_sync mode to blockchain mode. It resets the state, turns off fastest_sync, and starts the blockchain state-machine

type BlockchainStateMessage 

type BlockchainStateMessage interface{}

BlockchainMessage is a generic message for this reactor.

type StatePool 

type StatePool struct {
	cmn.BaseService
	// contains filtered or unexported fields
}

func NewStatePool 

func NewStatePool(requestsCh chan<- StateRequest, errorsCh chan<- peerError, keysPerRequest int64) *StatePool

func (*StatePool) AddStateChunk 

func (pool *StatePool) AddStateChunk(peerID p2p.ID, msg *bcStateResponseMessage)

func (*StatePool) OnStart 

func (pool *StatePool) OnStart() error

func (*StatePool) OnStop 

func (pool *StatePool) OnStop()

func (*StatePool) RemovePeer 

func (pool *StatePool) RemovePeer(peerID p2p.ID)

func (*StatePool) SetPeerHeight 

func (pool *StatePool) SetPeerHeight(peerID p2p.ID, height int64)

Sets the peer's alleged blockchain height.

type StateReactor 

type StateReactor struct {
	p2p.BaseReactor
	// contains filtered or unexported fields
}

BlockchainReactor handles long-term catchup syncing.

func NewStateReactor 

func NewStateReactor(stateDB dbm.DB, app proxy.AppConnState, config *cfg.Config) *StateReactor

NewStateReactor returns new reactor instance.

func (*StateReactor) AddPeer 

func (bcSR *StateReactor) AddPeer(peer p2p.Peer)

AddPeer implements Reactor by sending our state to peer.

func (*StateReactor) BroadcastStateStatusRequest 

func (bcSR *StateReactor) BroadcastStateStatusRequest()

BroadcastStatusRequest broadcasts `StateStore` height.

func (*StateReactor) GetChannels 

func (_ *StateReactor) GetChannels() []*p2p.ChannelDescriptor

GetChannels implements Reactor

func (*StateReactor) OnStart 

func (bcSR *StateReactor) OnStart() error

OnStart implements cmn.Service.

func (*StateReactor) OnStop 

func (bcSR *StateReactor) OnStop()

OnStop implements cmn.Service.

func (*StateReactor) Receive 

func (bcSR *StateReactor) Receive(chID byte, src p2p.Peer, msgBytes []byte)

Receive implements Reactor by handling 4 types of messages (see below).

func (*StateReactor) RemovePeer 

func (bcSR *StateReactor) RemovePeer(peer p2p.Peer, reason interface{})

RemovePeer implements Reactor by removing peer from the pool.

func (*StateReactor) SetLogger 

func (bcSR *StateReactor) SetLogger(l log.Logger)

SetLogger implements cmn.Service by setting the logger on reactor and pool.

type StateRequest 

type StateRequest struct {
	Height     int64
	PeerID     p2p.ID
	StartIndex int64
	EndIndex   int64
}

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.