Struct CheckFreeExtrinsicUse

pub struct CheckFreeExtrinsicUse<T: Config + Send + Sync>(/* private fields */);

The TransactionExtension trait is implemented on CheckFreeExtrinsicUse to validate that a provider has not already been revoked if the calling extrinsic is revoking a provider to an MSA. The purpose of this is to ensure that the revoke_delegation_by_delegator extrinsic cannot be repeatedly called and flood the network.

Implementations

impl<T: Config + Send + Sync> CheckFreeExtrinsicUse<T>

pub fn validate_delegation_by_delegator( account_id: &T::AccountId, provider_msa_id: &MessageSourceId, ) -> TransactionValidity

Validates the delegation by making sure that the MSA ids used are valid and the delegation is is still active. Returns a ValidTransaction or wrapped ValidityError

Arguments:

• account_id: the account id of the delegator that is revoking the delegation relationship
• provider_msa_id the MSA ID of the provider (the “other end” of the delegation).

Errors

• ValidityError::InvalidMsaKey - if account_id does not have an MSA
• ValidityError::InvalidDelegation - if the delegation with delegator_msa_id is invalid

pub fn validate_delegation_by_provider( account_id: &T::AccountId, delegator_msa_id: &MessageSourceId, ) -> TransactionValidity

Validates the delegation by making sure that the MSA ids used are valid and that the delegation is still active. Returns a ValidTransaction or wrapped ValidityError

Arguments:

• account_id: the account id of the provider that is revoking the delegation relationship
• delegator_msa_id the MSA ID of the delegator (the “other end” of the delegation).

Errors

• ValidityError::InvalidMsaKey - if account_id does not have an MSA
• ValidityError::InvalidDelegation - if the delegation with delegator_msa_id is invalid

pub fn validate_key_delete( signing_public_key: &T::AccountId, public_key_to_delete: &T::AccountId, ) -> TransactionValidity

Validates that a key being revoked is both valid and owned by a valid MSA account. Returns a ValidTransaction or wrapped ValidityError::InvalidMsaKey Arguments:

• signing_public_key: the account id calling for revoking the key, and which owns the msa also associated with key
• public_key_to_delete: the account id to revoke as an access key for account_id’s msa

Errors

• ValidityError::InvalidSelfRemoval - if signing_public_key and public_key_to_delete are the same.
• ValidityError::InvalidMsaKey - if account_id does not have an MSA or if ‘public_key_to_delete’ does not have an MSA.
• ValidityError::NotKeyOwner - if the signing_public_key and public_key_to_delete do not belong to the same MSA ID.

pub fn ensure_msa_can_retire(account_id: &T::AccountId) -> TransactionValidity

Validates that a MSA being retired exists, does not belong to a registered provider, that account_id is the only access key associated with the MSA, does not have a token balance associated with it, and that there are no delegations to providers. Returns a ValidTransaction or wrapped `ValidityError

Arguments:

• account_id: the account id associated with the MSA to retire

Errors

• ValidityError::InvalidMsaKey
• ValidityError::InvalidRegisteredProviderCannotBeRetired
• ValidityError::InvalidMoreThanOneKeyExists
• ValidityError::InvalidNonZeroProviderDelegations
• ValidityError::InvalidMsaHoldingTokenCannotBeRetired

pub fn validate_msa_token_withdrawal( receiver_account_id: &T::AccountId, msa_owner_public_key: &T::AccountId, msa_owner_proof: &MultiSignature, authorization_payload: &AuthorizedKeyData<T>, ) -> TransactionValidity

Validates that a request to withdraw tokens from an MSA passes the following checks:

• Receiver (origin) is NOT a control key for any MSA
• Signed payload matches MSA ID and signature validation
• Signature is not a duplicate
• MSA has tokens available to be withdrawn

Errors

[ValidityError::NotKeyOwner] - transaction origin does not match the authorized public key [ValidityError::MsaOwnershipInvalidSignature] - payload verification failed (bad signature, duplicate signature, invalid payload, payload/signature mismatch) [ValidityError::IneligibleOrigin] - transaction origin is an MSA control key [ValidityError::InsufficientBalanceToWithdraw] - MSA balance is zero [ValidityError::InvalidMsaKey] - signing MSA control key does not match MSA ID in payload

impl<T: Config + Send + Sync> CheckFreeExtrinsicUse<T>

pub fn new() -> Self

Create new TransactionExtension to check runtime version.

Trait Implementations

impl<T: Clone + Config + Send + Sync> Clone for CheckFreeExtrinsicUse<T>

fn clone(&self) -> CheckFreeExtrinsicUse<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Config + Send + Sync> Debug for CheckFreeExtrinsicUse<T>

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

Formats the value using the given formatter.

impl<T: Config + Send + Sync> Decode for CheckFreeExtrinsicUse<T>

where PhantomData<T>: Decode,

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 + Send + Sync> Encode for CheckFreeExtrinsicUse<T>

where PhantomData<T>: Encode,

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<__CodecOutputReturn, __CodecUsingEncodedCallback: FnOnce(&[u8]) -> __CodecOutputReturn>( &self, f: __CodecUsingEncodedCallback, ) -> __CodecOutputReturn

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

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<T: PartialEq + Config + Send + Sync> PartialEq for CheckFreeExtrinsicUse<T>

fn eq(&self, other: &CheckFreeExtrinsicUse<T>) -> 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: Config + Send + Sync> TransactionExtension<<T as Config>::RuntimeCall> for CheckFreeExtrinsicUse<T>

where T::RuntimeCall: Dispatchable<Info = DispatchInfo> + IsSubType<Call<T>>, <T as Config>::RuntimeOrigin: AsSystemOriginSigner<T::AccountId> + Clone,

const IDENTIFIER: &'static str = "CheckFreeExtrinsicUse"

Unique identifier of this signed extension.

type Implicit = ()

Any additional data which was known at the time of transaction construction and can be useful in authenticating the transaction. This is determined dynamically in part from the on-chain environment using the implicit function and not directly contained in the transaction itself and therefore is considered “implicit”.

type Val = Val

The type that encodes information that can be passed from validate to prepare.

type Pre = Pre

The type that encodes information that can be passed from prepare to post_dispatch.

fn weight(&self, call: &T::RuntimeCall) -> Weight

The weight consumed by executing this extension instance fully during transaction dispatch.

fn validate( &self, origin: <T as Config>::RuntimeOrigin, call: &T::RuntimeCall, _info: &DispatchInfoOf<T::RuntimeCall>, _len: usize, _self_implicit: Self::Implicit, _inherited_implication: &impl Encode, _source: TransactionSource, ) -> ValidateResult<Self::Val, T::RuntimeCall>

Validate a transaction for the transaction queue.

fn prepare( self, val: Self::Val, _origin: &<T as Config>::RuntimeOrigin, _call: &T::RuntimeCall, _info: &DispatchInfoOf<T::RuntimeCall>, _len: usize, ) -> Result<Self::Pre, TransactionValidityError>

Do any pre-flight stuff for a transaction after validation.

fn post_dispatch_details( pre: Self::Pre, _info: &DispatchInfo, _post_info: &PostDispatchInfoOf<T::RuntimeCall>, _len: usize, _result: &DispatchResult, ) -> Result<Weight, TransactionValidityError>

Do any post-flight stuff for an extrinsic.

fn implicit(&self) -> Result<Self::Implicit, TransactionValidityError>

Determine any additional data which was known at the time of transaction construction and can be useful in authenticating the transaction. The expected usage of this is to include in any data which is signed and verified as part of transaction validation. Also perform any pre-signature-verification checks and return an error if needed.

fn metadata() -> Vec<TransactionExtensionMetadata>

Returns the metadata for this extension.

fn post_dispatch( pre: Self::Pre, info: &<Call as Dispatchable>::Info, post_info: &mut <Call as Dispatchable>::PostInfo, len: usize, result: &Result<(), DispatchError>, ) -> Result<(), TransactionValidityError>

A wrapper for post_dispatch_details that refunds the unspent weight consumed by this extension into the post dispatch information.

fn bare_validate( _call: &Call, _info: &<Call as Dispatchable>::Info, _len: usize, ) -> Result<ValidTransaction, TransactionValidityError>

Validation logic for bare extrinsics.

fn bare_validate_and_prepare( _call: &Call, _info: &<Call as Dispatchable>::Info, _len: usize, ) -> Result<(), TransactionValidityError>

All pre-flight logic run before dispatching bare extrinsics.

fn bare_post_dispatch( _info: &<Call as Dispatchable>::Info, _post_info: &mut <Call as Dispatchable>::PostInfo, _len: usize, _result: &Result<(), DispatchError>, ) -> Result<(), TransactionValidityError>

Post dispatch logic run after dispatching bare extrinsics.

impl<T> TypeInfo for CheckFreeExtrinsicUse<T>

where PhantomData<T>: TypeInfo + 'static, T: Config + Send + Sync + 'static,

type Identity = CheckFreeExtrinsicUse<T>

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl<T: Config + Send + Sync> DecodeWithMemTracking for CheckFreeExtrinsicUse<T>

where PhantomData<T>: DecodeWithMemTracking,

impl<T: Config + Send + Sync> EncodeLike for CheckFreeExtrinsicUse<T>

where PhantomData<T>: Encode,

impl<T: Eq + Config + Send + Sync> Eq for CheckFreeExtrinsicUse<T>

impl<T: Config + Send + Sync> StructuralPartialEq for CheckFreeExtrinsicUse<T>