Enum pallet_democracy::pallet::Call

pub enum Call<T: Config> {
    propose {
        proposal_hash: T::Hash,
        value: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance,
    },
    second {
        proposal: PropIndex,
        seconds_upper_bound: u32,
    },
    vote {
        ref_index: ReferendumIndex,
        vote: AccountVote<<<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance>,
    },
    emergency_cancel {
        ref_index: ReferendumIndex,
    },
    external_propose {
        proposal_hash: T::Hash,
    },
    external_propose_majority {
        proposal_hash: T::Hash,
    },
    external_propose_default {
        proposal_hash: T::Hash,
    },
    fast_track {
        proposal_hash: T::Hash,
        voting_period: T::BlockNumber,
        delay: T::BlockNumber,
    },
    veto_external {
        proposal_hash: T::Hash,
    },
    cancel_referendum {
        ref_index: ReferendumIndex,
    },
    cancel_queued {
        which: ReferendumIndex,
    },
    delegate {
        to: T::AccountId,
        conviction: Conviction,
        balance: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance,
    },
    undelegate {},
    clear_public_proposals {},
    note_preimage {
        encoded_proposal: Vec<u8>,
    },
    note_preimage_operational {
        encoded_proposal: Vec<u8>,
    },
    note_imminent_preimage {
        encoded_proposal: Vec<u8>,
    },
    note_imminent_preimage_operational {
        encoded_proposal: Vec<u8>,
    },
    reap_preimage {
        proposal_hash: T::Hash,
        proposal_len_upper_bound: u32,
    },
    unlock {
        target: T::AccountId,
    },
    remove_vote {
        index: ReferendumIndex,
    },
    remove_other_vote {
        target: T::AccountId,
        index: ReferendumIndex,
    },
    enact_proposal {
        proposal_hash: T::Hash,
        index: ReferendumIndex,
    },
    blacklist {
        proposal_hash: T::Hash,
        maybe_ref_index: Option<ReferendumIndex>,
    },
    cancel_proposal {
        prop_index: PropIndex,
    },
    // some variants omitted
}

Contains one variant per dispatchable that can be called by an extrinsic.

Variants

propose

Propose a sensitive action to be taken.

The dispatch origin of this call must be Signed and the sender must have funds to cover the deposit.

• proposal_hash: The hash of the proposal preimage.
• value: The amount of deposit (must be at least MinimumDeposit).

Emits Proposed.

Weight: O(p)

Fields of propose

proposal_hash: T::Hashvalue: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance

second

Signals agreement with a particular proposal.

The dispatch origin of this call must be Signed and the sender must have funds to cover the deposit, equal to the original deposit.

• proposal: The index of the proposal to second.
• seconds_upper_bound: an upper bound on the current number of seconds on this proposal. Extrinsic is weighted according to this value with no refund.

Weight: O(S) where S is the number of seconds a proposal already has.

Fields of second

proposal: PropIndexseconds_upper_bound: u32

vote

Vote in a referendum. If vote.is_aye(), the vote is to enact the proposal; otherwise it is a vote to keep the status quo.

The dispatch origin of this call must be Signed.

• ref_index: The index of the referendum to vote for.
• vote: The vote configuration.

Weight: O(R) where R is the number of referendums the voter has voted on.

Fields of vote

ref_index: ReferendumIndexvote: AccountVote<<<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance>

emergency_cancel

Schedule an emergency cancellation of a referendum. Cannot happen twice to the same referendum.

The dispatch origin of this call must be CancellationOrigin.

-ref_index: The index of the referendum to cancel.

Weight: O(1).

Fields of emergency_cancel

ref_index: ReferendumIndex

external_propose

Schedule a referendum to be tabled once it is legal to schedule an external referendum.

The dispatch origin of this call must be ExternalOrigin.

• proposal_hash: The preimage hash of the proposal.

Weight: O(V) with V number of vetoers in the blacklist of proposal. Decoding vec of length V. Charged as maximum

Fields of external_propose

proposal_hash: T::Hash

external_propose_majority

Schedule a majority-carries referendum to be tabled next once it is legal to schedule an external referendum.

The dispatch of this call must be ExternalMajorityOrigin.

• proposal_hash: The preimage hash of the proposal.

Unlike external_propose, blacklisting has no effect on this and it may replace a pre-scheduled external_propose call.

Weight: O(1)

Fields of external_propose_majority

proposal_hash: T::Hash

external_propose_default

Schedule a negative-turnout-bias referendum to be tabled next once it is legal to schedule an external referendum.

The dispatch of this call must be ExternalDefaultOrigin.

• proposal_hash: The preimage hash of the proposal.

Unlike external_propose, blacklisting has no effect on this and it may replace a pre-scheduled external_propose call.

Weight: O(1)

Fields of external_propose_default

proposal_hash: T::Hash

fast_track

Schedule the currently externally-proposed majority-carries referendum to be tabled immediately. If there is no externally-proposed referendum currently, or if there is one but it is not a majority-carries referendum then it fails.

The dispatch of this call must be FastTrackOrigin.

• proposal_hash: The hash of the current external proposal.
• voting_period: The period that is allowed for voting on this proposal. Increased to FastTrackVotingPeriod if too low.
• delay: The number of block after voting has ended in approval and this should be enacted. This doesn’t have a minimum amount.

Emits Started.

Weight: O(1)

Fields of fast_track

proposal_hash: T::Hashvoting_period: T::BlockNumberdelay: T::BlockNumber

veto_external

Veto and blacklist the external proposal hash.

The dispatch origin of this call must be VetoOrigin.

• proposal_hash: The preimage hash of the proposal to veto and blacklist.

Emits Vetoed.

Weight: O(V + log(V)) where V is number of existing vetoers

Fields of veto_external

proposal_hash: T::Hash

cancel_referendum

Remove a referendum.

The dispatch origin of this call must be Root.

• ref_index: The index of the referendum to cancel.

Weight: O(1).

Fields of cancel_referendum

ref_index: ReferendumIndex

cancel_queued

Cancel a proposal queued for enactment.

The dispatch origin of this call must be Root.

• which: The index of the referendum to cancel.

Weight: O(D) where D is the items in the dispatch queue. Weighted as D = 10.

Fields of cancel_queued

which: ReferendumIndex

delegate

Delegate the voting power (with some given conviction) of the sending account.

The balance delegated is locked for as long as it’s delegated, and thereafter for the time appropriate for the conviction’s lock period.

The dispatch origin of this call must be Signed, and the signing account must either:

• be delegating already; or

• have no voting activity (if there is, then it will need to be removed/consolidated through reap_vote or unvote).

• to: The account whose voting the target account’s voting power will follow.

• conviction: The conviction that will be attached to the delegated votes. When the account is undelegated, the funds will be locked for the corresponding period.

• balance: The amount of the account’s balance to be used in delegating. This must not be more than the account’s current balance.

Emits Delegated.

Weight: O(R) where R is the number of referendums the voter delegating to has voted on. Weight is charged as if maximum votes.

Fields of delegate

to: T::AccountIdconviction: Convictionbalance: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance

undelegate

Undelegate the voting power of the sending account.

Tokens may be unlocked following once an amount of time consistent with the lock period of the conviction with which the delegation was issued.

The dispatch origin of this call must be Signed and the signing account must be currently delegating.

Emits Undelegated.

Weight: O(R) where R is the number of referendums the voter delegating to has voted on. Weight is charged as if maximum votes.

Fields of undelegate

clear_public_proposals

Clears all public proposals.

The dispatch origin of this call must be Root.

Weight: O(1).

Fields of clear_public_proposals

note_preimage

Register the preimage for an upcoming proposal. This doesn’t require the proposal to be in the dispatch queue but does require a deposit, returned once enacted.

The dispatch origin of this call must be Signed.

• encoded_proposal: The preimage of a proposal.

Emits PreimageNoted.

Weight: O(E) with E size of encoded_proposal (protected by a required deposit).

Fields of note_preimage

encoded_proposal: Vec<u8>

note_preimage_operational

Same as note_preimage but origin is OperationalPreimageOrigin.

Fields of note_preimage_operational

encoded_proposal: Vec<u8>

note_imminent_preimage

Register the preimage for an upcoming proposal. This requires the proposal to be in the dispatch queue. No deposit is needed. When this call is successful, i.e. the preimage has not been uploaded before and matches some imminent proposal, no fee is paid.

The dispatch origin of this call must be Signed.

• encoded_proposal: The preimage of a proposal.

Emits PreimageNoted.

Weight: O(E) with E size of encoded_proposal (protected by a required deposit).

Fields of note_imminent_preimage

encoded_proposal: Vec<u8>

note_imminent_preimage_operational

Same as note_imminent_preimage but origin is OperationalPreimageOrigin.

Fields of note_imminent_preimage_operational

encoded_proposal: Vec<u8>

reap_preimage

Remove an expired proposal preimage and collect the deposit.

The dispatch origin of this call must be Signed.

• proposal_hash: The preimage hash of a proposal.
• proposal_length_upper_bound: an upper bound on length of the proposal. Extrinsic is weighted according to this value with no refund.

This will only work after VotingPeriod blocks from the time that the preimage was noted, if it’s the same account doing it. If it’s a different account, then it’ll only work an additional EnactmentPeriod later.

Emits PreimageReaped.

Weight: O(D) where D is length of proposal.

Fields of reap_preimage

proposal_hash: T::Hashproposal_len_upper_bound: u32

unlock

Unlock tokens that have an expired lock.

The dispatch origin of this call must be Signed.

• target: The account to remove the lock on.

Weight: O(R) with R number of vote of target.

Fields of unlock

target: T::AccountId

remove_vote

Remove a vote for a referendum.

If:

• the referendum was cancelled, or
• the referendum is ongoing, or
• the referendum has ended such that
  • the vote of the account was in opposition to the result; or
  • there was no conviction to the account’s vote; or
  • the account made a split vote …then the vote is removed cleanly and a following call to unlock may result in more funds being available.

If, however, the referendum has ended and:

• it finished corresponding to the vote of the account, and
• the account made a standard vote with conviction, and
• the lock period of the conviction is not over …then the lock will be aggregated into the overall account’s lock, which may involve overlocking (where the two locks are combined into a single lock that is the maximum of both the amount locked and the time is it locked for).

The dispatch origin of this call must be Signed, and the signer must have a vote registered for referendum index.

• index: The index of referendum of the vote to be removed.

Weight: O(R + log R) where R is the number of referenda that target has voted on. Weight is calculated for the maximum number of vote.

Fields of remove_vote

index: ReferendumIndex

remove_other_vote

Remove a vote for a referendum.

If the target is equal to the signer, then this function is exactly equivalent to remove_vote. If not equal to the signer, then the vote must have expired, either because the referendum was cancelled, because the voter lost the referendum or because the conviction period is over.

The dispatch origin of this call must be Signed.

• target: The account of the vote to be removed; this account must have voted for referendum index.
• index: The index of referendum of the vote to be removed.

Weight: O(R + log R) where R is the number of referenda that target has voted on. Weight is calculated for the maximum number of vote.

Fields of remove_other_vote

target: T::AccountIdindex: ReferendumIndex

enact_proposal

Enact a proposal from a referendum. For now we just make the weight be the maximum.

Fields of enact_proposal

proposal_hash: T::Hashindex: ReferendumIndex

blacklist

Permanently place a proposal into the blacklist. This prevents it from ever being proposed again.

If called on a queued public or external proposal, then this will result in it being removed. If the ref_index supplied is an active referendum with the proposal hash, then it will be cancelled.

The dispatch origin of this call must be BlacklistOrigin.

• proposal_hash: The proposal hash to blacklist permanently.
• ref_index: An ongoing referendum whose hash is proposal_hash, which will be cancelled.

Weight: O(p) (though as this is an high-privilege dispatch, we assume it has a reasonable value).

Fields of blacklist

proposal_hash: T::Hashmaybe_ref_index: Option<ReferendumIndex>

cancel_proposal

Remove a proposal.

The dispatch origin of this call must be CancelProposalOrigin.

• prop_index: The index of the proposal to cancel.

Weight: O(p) where p = PublicProps::<T>::decode_len()

Fields of cancel_proposal

prop_index: PropIndex

Implementations

impl<T: Config> Call<T>

pub fn new_call_variant_propose(
    proposal_hash: T::Hash,
    value: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Self

Create a call with the variant propose.

pub fn new_call_variant_second(
    proposal: PropIndex,
    seconds_upper_bound: u32
) -> Self

Create a call with the variant second.

pub fn new_call_variant_vote(
    ref_index: ReferendumIndex,
    vote: AccountVote<<<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance>
) -> Self

Create a call with the variant vote.

pub fn new_call_variant_emergency_cancel(ref_index: ReferendumIndex) -> Self

Create a call with the variant emergency_cancel.

pub fn new_call_variant_external_propose(proposal_hash: T::Hash) -> Self

Create a call with the variant external_propose.

pub fn new_call_variant_external_propose_majority(
    proposal_hash: T::Hash
) -> Self

Create a call with the variant external_propose_majority.

pub fn new_call_variant_external_propose_default(proposal_hash: T::Hash) -> Self

Create a call with the variant external_propose_default.

pub fn new_call_variant_fast_track(
    proposal_hash: T::Hash,
    voting_period: T::BlockNumber,
    delay: T::BlockNumber
) -> Self

Create a call with the variant fast_track.

pub fn new_call_variant_veto_external(proposal_hash: T::Hash) -> Self

Create a call with the variant veto_external.

pub fn new_call_variant_cancel_referendum(ref_index: ReferendumIndex) -> Self

Create a call with the variant cancel_referendum.

pub fn new_call_variant_cancel_queued(which: ReferendumIndex) -> Self

Create a call with the variant cancel_queued.

pub fn new_call_variant_delegate(
    to: T::AccountId,
    conviction: Conviction,
    balance: <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance
) -> Self

Create a call with the variant delegate.

pub fn new_call_variant_undelegate() -> Self

Create a call with the variant undelegate.

pub fn new_call_variant_clear_public_proposals() -> Self

Create a call with the variant clear_public_proposals.

pub fn new_call_variant_note_preimage(encoded_proposal: Vec<u8>) -> Self

Create a call with the variant note_preimage.

pub fn new_call_variant_note_preimage_operational(
    encoded_proposal: Vec<u8>
) -> Self

Create a call with the variant note_preimage_operational.

pub fn new_call_variant_note_imminent_preimage(
    encoded_proposal: Vec<u8>
) -> Self

Create a call with the variant note_imminent_preimage.

pub fn new_call_variant_note_imminent_preimage_operational(
    encoded_proposal: Vec<u8>
) -> Self

Create a call with the variant note_imminent_preimage_operational.

pub fn new_call_variant_reap_preimage(
    proposal_hash: T::Hash,
    proposal_len_upper_bound: u32
) -> Self

Create a call with the variant reap_preimage.

pub fn new_call_variant_unlock(target: T::AccountId) -> Self

Create a call with the variant unlock.

pub fn new_call_variant_remove_vote(index: ReferendumIndex) -> Self

Create a call with the variant remove_vote.

pub fn new_call_variant_remove_other_vote(
    target: T::AccountId,
    index: ReferendumIndex
) -> Self

Create a call with the variant remove_other_vote.

pub fn new_call_variant_enact_proposal(
    proposal_hash: T::Hash,
    index: ReferendumIndex
) -> Self

Create a call with the variant enact_proposal.

pub fn new_call_variant_blacklist(
    proposal_hash: T::Hash,
    maybe_ref_index: Option<ReferendumIndex>
) -> Self

Create a call with the variant blacklist.

pub fn new_call_variant_cancel_proposal(prop_index: PropIndex) -> Self

Create a call with the variant cancel_proposal.

Trait Implementations

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

fn clone(&self) -> Self

Returns a copy 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 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 encode_to<__CodecOutputEdqy: Output + ?Sized>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

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

fn size_hint(&self) -> usize

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

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

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> 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.

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<Call<T>> for Call<T>

fn eq(&self, other: &Self) -> 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 !=.

impl<T: Config> TypeInfo for Call<T> where
    PhantomData<(T,)>: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance: HasCompact,
    AccountVote<<<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance>: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::BlockNumber: TypeInfo + 'static,
    T::BlockNumber: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    <<T as Config>::Currency as Currency<<T as Config>::AccountId>>::Balance: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    T::AccountId: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T::Hash: TypeInfo + 'static,
    T: Config + 'static, 

type Identity = Self

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 Origin = OriginFor<T>

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

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

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

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

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