security

type Admission ¶

type Admission uint8

Admission governs how a network's own validator set admits members.

const (
	// NoOwnSet: the network runs no validator set of its own; its security is
	// entirely restaked from its parent.
	NoOwnSet Admission = iota
	// Open: permissionless. Any staker meeting Threshold joins the set.
	Open
	// Gated: membership is admitted by the Manager (PoA / permissioned).
	Gated
)

type Manager ¶

type Manager uint8

Manager is the authority that governs a network's own validator set.

const (
	// PChain: the set is managed by P-Chain txs, authorised by the network Owner.
	PChain Manager = iota
	// Contract: the set is managed by an EVM staking contract on some chain.
	Contract
)

type Mode ¶

type Mode struct {
	RestakeParent bool
	Admission     Admission
	Threshold     uint64 // minimum stake for Open admission; 0 otherwise
	Manager       Manager
}

Mode is a network's complete security configuration.

The two axes are orthogonal:

• RestakeParent — the network leans on its parent's validator set.
• own set — whether it runs its OWN set, described by (Admission, Manager).

Their product spans every operating mode: a restaked L2 (RestakeParent, NoOwnSet), a sovereign L1 (¬RestakeParent, Open|Gated), and a hybrid L2 that restakes its parent AND runs an additive own set (RestakeParent, Open|Gated).

func (m Mode) Sovereign() bool

func (m Mode) Valid() error