blocksync

Documentation

Index

• Constants
• func ValidateMsg(pb proto.Message) error
• type BlockPool
  • func NewBlockPool(start int64, requestsCh chan<- BlockRequest, errorsCh chan<- peerError) *BlockPool
  • func (pool *BlockPool) AddBlock(peerID p2p.ID, block *types.Block, blockSize int)
  • func (pool *BlockPool) GetStatus() (height int64, numPending int32, lenRequesters int)
  • func (pool *BlockPool) IsCaughtUp() bool
  • func (pool *BlockPool) MaxPeerHeight() int64
  • func (pool *BlockPool) OnStart() error
  • func (pool *BlockPool) PeekTwoBlocks() (first *types.Block, second *types.Block)
  • func (pool *BlockPool) PopRequest()
  • func (pool *BlockPool) RedoRequest(height int64) p2p.ID
  • func (pool *BlockPool) RemovePeer(peerID p2p.ID)
  • func (pool *BlockPool) SetPeerRange(peerID p2p.ID, base int64, height int64)
• type BlockRequest
• type Handler
  • func NewHandler(state sm.State, blockExec *sm.BlockExecutor, store *store.BlockStore, ...) *Handler
  • func (bcR *Handler) AddPeer(peer p2p.Peer)
  • func (bcR *Handler) BroadcastStatusRequest()
  • func (bcR *Handler) GetChannels() []*p2p.ChannelDescriptor
  • func (bcR *Handler) OnStart() error
  • func (bcR *Handler) OnStop()
  • func (bcR *Handler) ReceiveEventMessage(e p2p.EventMessage)
  • func (bcR *Handler) RemovePeer(peer p2p.Peer, reason interface{})
  • func (bcR *Handler) SetLogger(l log.Logger)
  • func (bcR *Handler) SwitchToBlockSync(state sm.State) error

Constants

const (
	// NOTE: keep up to date with bcproto.BlockResponse
	BlockResponseMessagePrefixSize   = 4
	BlockResponseMessageFieldKeySize = 1
	MaxMsgSize                       = types.MaxBlockSizeBytes +
		BlockResponseMessagePrefixSize +
		BlockResponseMessageFieldKeySize
)

const (
	// BlocksyncChannel is a channel for blocks and status updates (`BlockStore` height)
	BlocksyncChannel = byte(0x40)
)

Functions

func ValidateMsg

func ValidateMsg(pb proto.Message) error

ValidateMsg validates a message.

Types

type BlockPool

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

BlockPool keeps track of the block sync peers, block requests and block responses.

func NewBlockPool

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

NewBlockPool returns a new BlockPool with the height equal to start. Block requests and errors will be sent to requestsCh and errorsCh accordingly.

func (*BlockPool) AddBlock

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

AddBlock validates that the block comes from the peer it was expected from and calls the requester to store it. TODO: ensure that blocks come in order for each peer.

func (*BlockPool) GetStatus

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

GetStatus returns pool's height, numPending requests and the number of requesters.

func (*BlockPool) IsCaughtUp

func (pool *BlockPool) IsCaughtUp() bool

IsCaughtUp returns true if this node is caught up, false - otherwise. TODO: relax conditions, prevent abuse.

func (*BlockPool) MaxPeerHeight

func (pool *BlockPool) MaxPeerHeight() int64

MaxPeerHeight returns the highest reported height.

func (*BlockPool) OnStart

func (pool *BlockPool) OnStart() error

OnStart implements service.Service by spawning requesters routine and recording pool's start time.

func (*BlockPool) PeekTwoBlocks

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

PeekTwoBlocks returns blocks at pool.height and pool.height+1. 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()

PopRequest pops 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

RedoRequest 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)

RemovePeer removes the peer with peerID from the pool. If there's no peer with peerID, function is a no-op.

func (*BlockPool) SetPeerRange

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

SetPeerRange sets the peer's alleged blockchain base and height.

type BlockRequest

type BlockRequest struct {
	Height int64
	PeerID p2p.ID
}

BlockRequest stores a block request identified by the block Height and the PeerID responsible for delivering the block

type Handler

type Handler struct {
	p2p.BaseHandler
	// contains filtered or unexported fields
}

Handler handles long-term catchup syncing.

func NewHandler

func NewHandler(state sm.State, blockExec *sm.BlockExecutor, store *store.BlockStore,
	blockSync bool) *Handler

NewHandler returns new reactor instance.

func (*Handler) AddPeer

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

AddPeer implements Handler by sending our state to peer.

func (*Handler) BroadcastStatusRequest

func (bcR *Handler) BroadcastStatusRequest()

BroadcastStatusRequest broadcasts `BlockStore` base and height.

func (*Handler) GetChannels

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

GetChannels implements Handler

func (*Handler) OnStart

func (bcR *Handler) OnStart() error

OnStart implements service.Service.

func (*Handler) OnStop

func (bcR *Handler) OnStop()

OnStop implements service.Service.

func (*Handler) ReceiveEventMessage

func (bcR *Handler) ReceiveEventMessage(e p2p.EventMessage)

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

func (*Handler) RemovePeer

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

RemovePeer implements Handler by removing peer from the pool.

func (*Handler) SetLogger

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

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

func (*Handler) SwitchToBlockSync

func (bcR *Handler) SwitchToBlockSync(state sm.State) error

SwitchToBlockSync is called by the state sync reactor when switching to block sync.