Function pallet_handles::pallet::dispatchables::change_handle

pub fn change_handle<T: Config>(
    msa_owner_key: T::AccountId,
    proof: MultiSignature,
    payload: ClaimHandlePayload<BlockNumberFor<T>>
)

Changes the handle for a caller’s MSA (Message Source Account) based on the provided payload. This function performs several validations before claiming the handle, including checking the size of the base_handle, ensuring the caller has valid MSA keys, verifying the payload signature, and finally calling the internal do_retire_handle and do_claim_handle functions to retire the current handle and claim the new one.

Arguments

• origin - The origin of the caller.
• msa_owner_key - The public key of the MSA owner.
• proof - The multi-signature proof for the payload.
• payload - The payload containing the information needed to change an existing handle.

Errors

This function may return an error as part of DispatchResult if any of the following validations fail:

• Error::InvalidHandleByteLength - The base_handle size exceeds the maximum allowed size.
• Error::InvalidMessageSourceAccount - The caller does not have a valid MessageSourceId.
• Error::InvalidSignature - The payload signature verification fails.

Events

• Event::HandleRetired
• Event::HandleClaimed

Warning: Doc-Only

This function is an automatically generated, and is doc-only, uncallable stub. See the real version in Pallet::change_handle.