Struct linera_base::ownership::ChainOwnership

pub struct ChainOwnership {
    pub super_owners: BTreeSet<Owner>,
    pub owners: BTreeMap<Owner, u64>,
    pub multi_leader_rounds: u32,
    pub open_multi_leader_rounds: bool,
    pub timeout_config: TimeoutConfig,
}

Represents the owner(s) of a chain.

Fields

super_owners: BTreeSet<Owner>

Super owners can propose fast blocks in the first round, and regular blocks in any round.

owners: BTreeMap<Owner, u64>

The regular owners, with their weights that determine how often they are round leader.

multi_leader_rounds: u32

The number of rounds in which all owners are allowed to propose blocks.

open_multi_leader_rounds: bool

Whether the multi-leader rounds are unrestricted, i.e. not limited to chain owners. This should only be true on chains with restrictive application permissions and an application-based mechanism to select block proposers.

timeout_config: TimeoutConfig

The timeout configuration: how long fast, multi-leader and single-leader rounds last.

Implementations

impl ChainOwnership

pub fn single_super(owner: Owner) -> Self

Creates a ChainOwnership with a single super owner.

pub fn single(owner: Owner) -> Self

Creates a ChainOwnership with a single regular owner.

pub fn multiple( owners_and_weights: impl IntoIterator<Item = (Owner, u64)>, multi_leader_rounds: u32, timeout_config: TimeoutConfig, ) -> Self

Creates a ChainOwnership with the specified regular owners.

pub fn with_regular_owner(self, owner: Owner, weight: u64) -> Self

Adds a regular owner.

pub fn is_active(&self) -> bool

Returns whether there are any owners or super owners or it is a public chain.

pub fn verify_owner(&self, owner: &Owner) -> bool

Returns true if this is an owner or super owner.

pub fn round_timeout(&self, round: Round) -> Option<TimeDelta>

Returns the duration of the given round.

pub fn first_round(&self) -> Round

Returns the first consensus round for this configuration.

pub fn all_owners(&self) -> impl Iterator<Item = &Owner>

Returns an iterator over all super owners, followed by all owners.

pub fn next_round(&self, round: Round) -> Option<Round>

Returns the round following the specified one, if any.

Trait Implementations

impl Clone for ChainOwnership

fn clone(&self) -> ChainOwnership

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChainOwnership

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChainOwnership

fn default() -> ChainOwnership

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChainOwnership

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for ChainOwnership

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl InputType for ChainOwnership

type RawValueType = ChainOwnership

The raw type used for validator.

fn type_name() -> Cow<'static, str>

Type the name.

fn create_type_info(registry: &mut Registry) -> String

Create type information in the registry and return qualified typename.

fn parse(value: Option<Value>) -> InputValueResult<Self>

Parse from Value. None represents undefined.

fn to_value(&self) -> Value

Convert to a Value for introspection.

fn as_raw_value(&self) -> Option<&Self::RawValueType>

Returns a reference to the raw value.

fn qualified_type_name() -> String

Qualified typename.

impl OutputType for ChainOwnership

fn type_name() -> Cow<'static, str>

Type the name.

fn create_type_info(registry: &mut Registry) -> String

Create type information in the registry and return qualified typename.

async fn resolve( &self, _: &ContextSelectionSet<'_>, _field: &Positioned<Field>, ) -> ServerResult<Value>

Resolve an output value to async_graphql::Value.

fn qualified_type_name() -> String

Qualified typename.

fn introspection_type_name(&self) -> Cow<'static, str>

Introspection type name

impl PartialEq for ChainOwnership

fn eq(&self, other: &ChainOwnership) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl ScalarType for ChainOwnership

fn parse(value: Value) -> InputValueResult<Self>

Parse a scalar value.

fn to_value(&self) -> Value

Convert the scalar to Value.

fn is_valid(_value: &ConstValue) -> bool

Checks for a valid scalar value.

impl Serialize for ChainOwnership

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl WitLoad for ChainOwnership

fn load<Instance>( memory: &Memory<'_, Instance>, location: GuestPointer, ) -> Result<Self, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Loads an instance of the type from the location in the guest’s memory.

fn lift_from<Instance>( flat_layout: <Self::Layout as Layout>::Flat, memory: &Memory<'_, Instance>, ) -> Result<Self, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Lifts an instance of the type from the flat_layout representation.

impl WitStore for ChainOwnership

fn store<Instance>( &self, memory: &mut Memory<'_, Instance>, location: GuestPointer, ) -> Result<(), RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Stores the type at the location in the guest’s memory.

fn lower<Instance>( &self, memory: &mut Memory<'_, Instance>, ) -> Result<<Self::Layout as Layout>::Flat, RuntimeError>

where Instance: InstanceWithMemory, <Instance::Runtime as Runtime>::Memory: RuntimeMemory<Instance>,

Lowers the type into its flat layout representation.

impl WitType for ChainOwnership

const SIZE: u32 = 64u32

The size of the type when laid out in memory.

type Layout = <HCons<BTreeSet<Owner>, HCons<BTreeMap<Owner, u64>, HCons<u32, HCons<bool, HCons<TimeoutConfig, HNil>>>>> as WitType>::Layout

The layout of the type as fundamental types.

type Dependencies = HCons<BTreeSet<Owner>, HCons<BTreeMap<Owner, u64>, HCons<u32, HCons<bool, HCons<TimeoutConfig, HNil>>>>>

Other WitTypes that this type depends on.

fn wit_type_name() -> Cow<'static, str>

Generates the WIT type name for this type.

fn wit_type_declaration() -> Cow<'static, str>

Generates the WIT type declaration for this type.

impl Eq for ChainOwnership

impl StructuralPartialEq for ChainOwnership