rolldpos

Documentation

Index

• Constants
• type Option
  • func EnableDardanellesSubEpoch(height, numSubEpochs uint64) Option
• type Protocol
  • func NewProtocol(numCandidateDelegates, numDelegates, numSubEpochs uint64, opts ...Option) *Protocol
  • func (p *Protocol) GetEpochHeight(epochNum uint64) uint64
  • func (p *Protocol) GetEpochLastBlockHeight(epochNum uint64) uint64
  • func (p *Protocol) GetEpochNum(height uint64) uint64
  • func (p *Protocol) GetSubEpochNum(height uint64) uint64
  • func (p *Protocol) Handle(context.Context, action.Action, protocol.StateManager) (*action.Receipt, error)
  • func (p *Protocol) NumCandidateDelegates() uint64
  • func (p *Protocol) NumDelegates() uint64
  • func (p *Protocol) ReadState(context.Context, protocol.StateManager, []byte, ...[]byte) ([]byte, error)
  • func (p *Protocol) Validate(context.Context, action.Action) error

Constants

const ProtocolID = "rolldpos"

ProtocolID is the identity of this protocol

Types

type Option

type Option func(*Protocol) error

Option is optional setting for epoch protocol

func EnableDardanellesSubEpoch

func EnableDardanellesSubEpoch(height, numSubEpochs uint64) Option

EnableDardanellesSubEpoch will set give numSubEpochs at give height.

type Protocol

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

Protocol defines an epoch protocol

func NewProtocol

func NewProtocol(numCandidateDelegates, numDelegates, numSubEpochs uint64, opts ...Option) *Protocol

NewProtocol returns a new rolldpos protocol

func (*Protocol) GetEpochHeight

func (p *Protocol) GetEpochHeight(epochNum uint64) uint64

GetEpochHeight returns the start height of an epoch

func (*Protocol) GetEpochLastBlockHeight

func (p *Protocol) GetEpochLastBlockHeight(epochNum uint64) uint64

GetEpochLastBlockHeight returns the last height of an epoch

func (*Protocol) GetEpochNum

func (p *Protocol) GetEpochNum(height uint64) uint64

GetEpochNum returns the number of the epoch for a given height

func (*Protocol) GetSubEpochNum

func (p *Protocol) GetSubEpochNum(height uint64) uint64

GetSubEpochNum returns the sub epoch number of a block height

func (*Protocol) Handle

func (p *Protocol) Handle(context.Context, action.Action, protocol.StateManager) (*action.Receipt, error)

Handle handles a modification

func (*Protocol) NumCandidateDelegates

func (p *Protocol) NumCandidateDelegates() uint64

NumCandidateDelegates returns the number of delegate candidates for an epoch

func (*Protocol) NumDelegates

func (p *Protocol) NumDelegates() uint64

NumDelegates returns the number of delegates in an epoch

func (*Protocol) ReadState

func (p *Protocol) ReadState(context.Context, protocol.StateManager, []byte, ...[]byte) ([]byte, error)

ReadState read the state on blockchain via protocol

func (*Protocol) Validate

func (p *Protocol) Validate(context.Context, action.Action) error

Validate validates a modification