beam

type AncestorTracker interface {
	// Add adds a block to track
	Add(blkID ids.ID) error

	// Remove removes a block from tracking
	Remove(blkID ids.ID) error

	// IsAncestor returns true if ancestor is an ancestor of descendant
	IsAncestor(ancestor, descendant ids.ID) (bool, error)
}

type Block struct {
	PrntID     ids.ID
	Hght       uint64
	Tmstmp     int64
	ProposerID ids.NodeID
	TxList     [][]byte
	Certs      CertBundle
	// contains filtered or unexported fields
}

type CertBundle struct {
	BLSAgg [96]byte // BLS aggregate signature
	RTCert []byte   // Ringtail certificate (~3KB)
}

type Config struct {
	// Consensus parameters
	Params          Parameters
	StartupTracker  StartupTracker
	Sender          Sender
	Timer           Timer
	AncestorTracker AncestorTracker

	// Quantum parameters
	QuasarEnabled     bool
	QuasarTimeout     time.Duration
	RingtailThreshold int
}

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

type Parameters struct {
	K                     int           // Sample size
	AlphaPreference       int           // Preference threshold
	AlphaConfidence       int           // Confidence threshold
	Beta                  int           // Decision threshold
	MaxItemProcessingTime time.Duration // Max time to process an item
}

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

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

type QuasarConfig struct {
	Threshold     int
	QuasarTimeout time.Duration
	Validators    validators.State
}

type Sender interface {
	// SendGetAncestors sends a GetAncestors message
	SendGetAncestors(ctx context.Context, nodeID ids.NodeID, requestID uint32, containerID ids.ID) error

	// SendPullQuery sends a PullQuery message
	SendPullQuery(ctx context.Context, nodeIDs set.Set[ids.NodeID], requestID uint32, containerID ids.ID) error

	// SendPushQuery sends a PushQuery message
	SendPushQuery(ctx context.Context, nodeIDs set.Set[ids.NodeID], requestID uint32, container []byte) error

	// SendChits sends a Chits message
	SendChits(ctx context.Context, nodeID ids.NodeID, requestID uint32, preferredID ids.ID, acceptedID ids.ID) error
}

type SlashEvent struct {
	ProposerID ids.NodeID
	Height     uint64
	Reason     string
	Timestamp  time.Time
}

type StartupTracker interface {
	Started() bool
}

type Timer interface {
	// SetTimeout sets a timeout
	SetTimeout(duration time.Duration) error

	// Cancel cancels the current timeout
	Cancel() error
}

type VM interface {
	// GetBlock returns the block with the given ID
	GetBlock(context.Context, ids.ID) (quasar.Block, error)

	// BuildBlock builds a new block
	BuildBlock(context.Context) (quasar.Block, error)

	// SetPreference sets the preferred block
	SetPreference(context.Context, ids.ID) error

	// LastAccepted returns the last accepted block
	LastAccepted(context.Context) (ids.ID, error)

	// VerifyWithContext verifies a block with context
	VerifyWithContext(context.Context, quasar.Block) error
}