Enum Call

pub enum Call<T: Config> {
    validate {
        payload: ValidatePayloadOf<T>,
        signature: T::Signature,
    },
    declare {
        payload: AffidavitPayloadOf<T>,
        signature: T::Signature,
    },
    elect {
        payload: ElectionPayloadOf<T>,
        signature: T::Signature,
    },
    chill {
        affidavit_pub: AffidavitId<T>,
    },
    force_genesis_config {
        field: ForceGenesisConfig<T>,
    },
    // some variants omitted
}

Contains a variant per dispatchable extrinsic that this pallet has.

Variants

validate

Register an author’s new affidavit signing key for the upcoming session’s participation as a validator.

This extrinsic allows an author to declare their off-chain signing key that will be used to sign affidavits for the next session’s election.

It ensures that only valid and available authors can register keys.

Notes

• Affidavit Keys are session-specific and are updated each session.
• This extrinsic allows submission of affidavit for next session only.
• Affidavit Declaration/Submission will rotate keys once every submission for further sessions then.

Errors

Returns a DispatchError if author-role authorization fails.

Fields

payload: ValidatePayloadOf<T>

signature: T::Signature

declare

Submit an affidavit for the upcoming session election.

This extrinsic allows an author to declare their election weights (affidavit) for the next session. It also rotates the author’s signing key for the subsequent affidavit.

Parameters

• origin: Must be a signed account corresponding to the author submitting the affidavit.
• payload: The payload that was signed off-chain representing the affidavit data.
• signature: The author’s signature of the payload, used for verification.
• new_key: A new affidavit signing key to replace the current one for the next upcoming session.

Notes

• Affidavit submissions are session-specific.
• Key rotation ensures authors maintain fresh signing keys for security.
• Only validated and available authors can submit affidavits.

Errors

Returns a DispatchError if un-privileged to submit an affidavit.

Fields

payload: AffidavitPayloadOf<T>

signature: T::Signature

elect

Execute the election for the upcoming session.

This extrinsic allows an author to act as the election runner for the election session (next-session). It verifies the author’s affidavit-based signature, prepares the election using all submitted affidavits, and records the runner for audit and reward attribution.

Since this is an unsigned extrinsic, it is constructed and submitted by validator offchain workers (OCWs).

Although unsigned, it is treated as a pseudo-inherent:

• It is authorized via affidavit signature verification
• It may carry rewards for successfully running the election
• It is expected to be submitted locally by validators rather than propagated by external transaction authors

Errors

Returns a DispatchError if election execution or authorization fails.

Fields

payload: ElectionPayloadOf<T>

signature: T::Signature

chill

Request to step back or “chill” immediately from election participation by erasing affidavit keys.

This safely avoids penalties by pausing an author’s duties.

This extrinsic allows an author to withdraw from participating in upcoming elections or prevent submitting future affidavits. The actual effect depends on the current block relative to the affidavit submissions and election windows.

Note that its always advised to chill validation before resign author role to skip unnecessary invalid affidavit declarations.

Parameters

• origin: Must be a signed account corresponding to the author i.e., controller/role account.
• affidavit_pub : Public affidavit key registered for a new session’s affidavit submission.

Notes

• Removing affidavit keys ensures authors cannot unfairly influence future elections.
• By inspecting returned errors, callers can compute the optimal chill window.

Errors

Returns a DispatchError with diagnostic in case of irrevocable duties assigned.

Fields

affidavit_pub: AffidavitId<T>

force_genesis_config

Force-update a selected genesis configuration parameter.

Origin: Root only.

This extrinsic allows privileged modification of runtime parameters that were originally defined at genesis.

• AllowAffidavits - Enables or disables affidavit submission.
• AffidavitBeginsAt - Updates the start of the affidavit submission window.
• AffidavitEndsAt - Updates the end of the affidavit submission window.
• ElectionBeginsAt - Updates when election execution begins within the session.
• ElectionRunnerPointsUpgrade - Updates the reward points for election runners.
• ValidateTxPriority - Updates the priority for validation-related extrinsics.
• ElectionTxPriority - Updates the priority for election execution extrinsics.
• AffidavitTxPriority - Updates the priority for affidavit submission extrinsics.
• FinalityAfter - Updates the time-based delay before operations are considered final.
• FinalityTicks - Updates the block-based confirmation threshold for finality.

The call enforces consistency constraints where applicable:

• Affidavit window ordering:
  • AffidavitBeginsAt < AffidavitEndsAt
  • AffidavitEndsAt > AffidavitBeginsAt
• The following values must be non-zero:
  • transaction priorities
  • finality thresholds (FinalityAfter, FinalityTicks)

This call directly overwrites storage and emits an event containing the updated configuration variant.

Fields

field: ForceGenesisConfig<T>

Implementations

impl<T: Config> Call<T>

pub fn new_call_variant_validate( payload: ValidatePayloadOf<T>, signature: T::Signature, ) -> Self

Create a call with the variant validate.

pub fn new_call_variant_declare( payload: AffidavitPayloadOf<T>, signature: T::Signature, ) -> Self

Create a call with the variant declare.

pub fn new_call_variant_elect( payload: ElectionPayloadOf<T>, signature: T::Signature, ) -> Self

Create a call with the variant elect.

pub fn new_call_variant_chill(affidavit_pub: AffidavitId<T>) -> Self

Create a call with the variant chill.

pub fn new_call_variant_force_genesis_config( field: ForceGenesisConfig<T>, ) -> Self

Create a call with the variant force_genesis_config.

Trait Implementations

impl<T: Config> CheckIfFeeless for Call<T>

type Origin = <T as Config>::RuntimeOrigin

The Origin type of the runtime.

fn is_feeless(&self, origin: &Self::Origin) -> bool

Checks if the dispatchable satisfies the feeless condition as defined by #[pallet::feeless_if]

impl<T: Config> Clone for Call<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Config> Debug for Call<T>

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

Formats the value using the given formatter.

impl<T: Config> Decode for Call<T>

fn decode<__CodecInputEdqy: Input>( __codec_input_edqy: &mut __CodecInputEdqy, ) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<T: Config> Encode for Call<T>

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

fn encode(&self) -> Vec<u8>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R

where F: FnOnce(&[u8]) -> R,

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<T: Config> GetCallIndex for Call<T>

fn get_call_index(&self) -> u8

Return the index of this Call.

fn get_call_indices() -> &'static [u8]

Return all call indices in the same order as [GetCallName].

impl<T: Config> GetCallName for Call<T>

fn get_call_name(&self) -> &'static str

Return the function name of the Call.

fn get_call_names() -> &'static [&'static str]

Return all function names in the same order as [GetCallIndex].

impl<T: Config> GetDispatchInfo for Call<T>

fn get_dispatch_info(&self) -> DispatchInfo

Return a DispatchInfo, containing relevant information of this dispatch.

impl<T: Config> PartialEq for Call<T>

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl<T> TypeInfo for Call<T>

where PhantomData<(T,)>: TypeInfo + 'static, ValidatePayloadOf<T>: TypeInfo + 'static, T::Signature: TypeInfo + 'static, AffidavitPayloadOf<T>: TypeInfo + 'static, ElectionPayloadOf<T>: TypeInfo + 'static, AffidavitId<T>: TypeInfo + 'static, ForceGenesisConfig<T>: TypeInfo + 'static, T: Config + 'static,

type Identity = Call<T>

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<T: Config> UnfilteredDispatchable for Call<T>

type RuntimeOrigin = <T as Config>::RuntimeOrigin

The origin type of the runtime, (i.e. frame_system::Config::RuntimeOrigin).

fn dispatch_bypass_filter( self, origin: Self::RuntimeOrigin, ) -> DispatchResultWithPostInfo

Dispatch this call but do not check the filter in origin.

impl<T: Config> DecodeWithMemTracking for Call<T>

where ValidatePayloadOf<T>: DecodeWithMemTracking, T::Signature: DecodeWithMemTracking, AffidavitPayloadOf<T>: DecodeWithMemTracking, ElectionPayloadOf<T>: DecodeWithMemTracking, AffidavitId<T>: DecodeWithMemTracking, ForceGenesisConfig<T>: DecodeWithMemTracking,

impl<T: Config> EncodeLike for Call<T>

impl<T: Config> Eq for Call<T>