strongcoin1echo

Documentation

Index

• func NewStrongCoin1Echo() consinterface.CoinItemInterface
• type MsgState
  • func NewStrongCoin1EchoMsgState(isMv bool, gc *generalconfig.GeneralConfig) *MsgState
  • func (sms *MsgState) CheckFinishedMessage(deser *deserialized.DeserializedItem) bool
  • func (sms *MsgState) GetCoinSignType() types.SignType
  • func (sms *MsgState) GetCoins(round types.ConsensusRound) []types.BinVal
  • func (sms *MsgState) GotMsg(msgState consinterface.MessageState, deser *deserialized.DeserializedItem, ...) (types.ConsensusRound, error)
  • func (sms *MsgState) New(_ types.ConsensusIndex, presets []struct{ ... }) consinterface.CoinMessageStateInterface
• type StrongCoin1Echo
  • func (sc1 *StrongCoin1Echo) CheckCoinMessage(deser *deserialized.DeserializedItem, isLocal bool, alwaysGenerate bool, ...) (round types.ConsensusRound, ret messages.MsgHeader, ...)
  • func (sc1 *StrongCoin1Echo) GenerateCoinMessage(round types.ConsensusRound, alwaysGenerate bool, ...) (ret messages.MsgHeader)
  • func (StrongCoin1Echo) GetBufferCount(hdr messages.MsgIDHeader, gc *generalconfig.GeneralConfig, ...) (endThreshold int, maxPossible int, msgid messages.MsgID, err error)
  • func (StrongCoin1Echo) GetHeader(emptyPub sig.Pub, gc *generalconfig.GeneralConfig, headerID messages.HeaderID) (messages.MsgHeader, error)

Functions

func NewStrongCoin1Echo

func NewStrongCoin1Echo() consinterface.CoinItemInterface

Types

type MsgState

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

StrongCoin1EchoMsgState represents the state of messages implementing a strong coin through the use of threshold signatures.

func NewStrongCoin1EchoMsgState

func NewStrongCoin1EchoMsgState(isMv bool,
	gc *generalconfig.GeneralConfig) *MsgState

NewStrongCoin1EchoMsgState generates a new StrongCoin1EchoMsgState object.

func (*MsgState) CheckFinishedMessage

func (sms *MsgState) CheckFinishedMessage(deser *deserialized.DeserializedItem) bool

CheckFinishedMessage checks if the message is for the coin and if the coin is already known. If so true is returned, false otherwise.

func (*MsgState) GetCoinSignType

func (sms *MsgState) GetCoinSignType() types.SignType

GetCoinSignType returns what type of signature is used to sign coin messages

func (*MsgState) GetCoins

func (sms *MsgState) GetCoins(round types.ConsensusRound) []types.BinVal

GetCoins returns the set of binary coin values that are currently valid.

func (*MsgState) GotMsg

func (sms *MsgState) GotMsg(msgState consinterface.MessageState, deser *deserialized.DeserializedItem,
	gc *generalconfig.GeneralConfig, mc *consinterface.MemCheckers) (types.ConsensusRound, error)

GotMsg processes messages of type CoinMessage. Once an n-t threshold of these messages have been received from different processes the value of the coin is revealed.

func (*MsgState) New

func (sms *MsgState) New(_ types.ConsensusIndex, presets []struct {
	Round types.ConsensusRound
	Val   types.BinVal
}) consinterface.CoinMessageStateInterface

New creates a new empty StrongCoin1EchoMsgState object for the consensus index idx.

type StrongCoin1Echo

type StrongCoin1Echo struct {
}

StrongCoin1Echo represents a strong coin implemented by an n-t threshold signautre.

func (*StrongCoin1Echo) CheckCoinMessage

func (sc1 *StrongCoin1Echo) CheckCoinMessage(deser *deserialized.DeserializedItem,
	isLocal bool, alwaysGenerate bool, consItem consinterface.ConsItem, coinMsgState consinterface.CoinMessageStateInterface,
	msgState consinterface.MessageState) (round types.ConsensusRound, ret messages.MsgHeader,
	progress, shouldForward bool, err error)

CheckCoinMessage should be called from within ProcessMessage of the ConsensusItem that is using this coin. It returns the round the coin corresponds to and true in first boolean position if made progress towards decision, or false if already decided, and return true in second position if the message should be forwarded. If the message is invalid an error is returned.

func (*StrongCoin1Echo) GenerateCoinMessage

func (sc1 *StrongCoin1Echo) GenerateCoinMessage(round types.ConsensusRound, alwaysGenerate bool, consItem consinterface.ConsItem,
	coinMsgState consinterface.CoinMessageStateInterface, msgState consinterface.MessageState) (ret messages.MsgHeader)

func (StrongCoin1Echo) GetBufferCount

func (StrongCoin1Echo) GetBufferCount(hdr messages.MsgIDHeader, gc *generalconfig.GeneralConfig,
	memberChecker *consinterface.MemCheckers) (endThreshold int,
	maxPossible int, msgid messages.MsgID, err error)

GetBufferCount returns the thresholds for messages of type coin. The thresholds are n-t.

func (StrongCoin1Echo) GetHeader

func (StrongCoin1Echo) GetHeader(emptyPub sig.Pub, gc *generalconfig.GeneralConfig,
	headerID messages.HeaderID) (messages.MsgHeader, error)

GetHeader should a blank message header for the HeaderID, this object will be used to deserialize a message into itself (see consinterface.DeserializeMessage).