Enum Call 

pub enum Call<T: Config> {
    mint {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        external_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance,
        max_fee: Permill,
    },
    redeem {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        internal_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance,
        max_fee: Permill,
    },
    create_psm {
        internal_asset: T::AssetId,
        full_admin: Box<T::PalletsOrigin>,
        emergency_admin: Box<T::PalletsOrigin>,
        fee_destination: T::AccountId,
        max_debt: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance,
        min_swap_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance,
    },
    remove_psm {
        internal_asset: T::AssetId,
    },
    set_minting_fee {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        fee: Permill,
    },
    set_redemption_fee {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        fee: Permill,
    },
    set_max_debt {
        internal_asset: T::AssetId,
        value: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance,
    },
    set_asset_status {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        status: CircuitBreakerLevel,
    },
    set_asset_ceiling_weight {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
        weight: Permill,
    },
    add_external_asset {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
    },
    remove_external_asset {
        internal_asset: T::AssetId,
        external_asset: T::AssetId,
    },
    set_full_admin {
        internal_asset: T::AssetId,
        new_admin: Box<T::PalletsOrigin>,
    },
    set_emergency_admin {
        internal_asset: T::AssetId,
        new_admin: Box<T::PalletsOrigin>,
    },
    // some variants omitted
}

Contains a variant per dispatchable extrinsic that this pallet has.

Variants

mint

Swap external asset for internal on a specific PSM instance.

Dispatch Origin

Must be Signed by the user performing the swap.

Details

Transfers external_amount of external_asset from the caller to the internal_asset’s PSM reserve account, then mints internal_asset to the caller minus the minting fee. The fee is calculated using ceiling rounding (mul_ceil), ensuring the protocol never undercharges. The fee is transferred to PsmInfo::fee_destination of the targeted instance.

Parameters

• internal_asset: The internal stablecoin that identifies the PSM instance.
• external_asset: The external asset to deposit (must be approved on internal_asset).
• external_amount: Amount of external asset to deposit.
• max_fee: Maximum minting fee rate accepted by the caller.

Errors

• Error::PsmNotFound: If no PSM is registered for internal_asset.
• Error::UnsupportedAsset: If external_asset is not approved on this PSM.
• Error::MintingStopped: If the per-external circuit breaker is at MintingDisabled or higher.
• Error::BelowMinimumSwap: If the internal-equivalent of external_amount is below the instance’s min_swap_amount.
• Error::FeeTooHigh: If the configured minting fee exceeds max_fee.
• Error::ExceedsMaxPsmDebt: If minting would exceed this PSM’s debt ceiling (aggregate or per-asset).
• Error::DecimalsMismatch: If live decimals diverged from the snapshot taken at registration.
• Error::AmountTooSmallAfterConversion: If the conversion to the counter-asset rounds to zero; swap would transfer nothing.

Events

• Event::Minted: Emitted on successful mint.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

external_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance

max_fee: Permill

redeem

Swap internal for external asset on a specific PSM instance.

Dispatch Origin

Must be Signed by the user performing the swap.

Details

Burns internal_amount of internal_asset from the caller minus fee (transferred to the instance’s PsmInfo::fee_destination), then transfers the resulting amount in external_asset from the PSM reserve to the caller. The fee is calculated using ceiling rounding (mul_ceil), ensuring the protocol never undercharges. Redemptions use the decimals snapshotted when the PSM/external pair was registered, allowing existing positions to unwind even if live metadata later changes.

Parameters

• internal_asset: The internal stablecoin that identifies the PSM instance.
• external_asset: The external asset to receive (must be approved on internal_asset).
• internal_amount: Amount of internal_asset to redeem.
• max_fee: Maximum redemption fee rate accepted by the caller.

Errors

• Error::PsmNotFound: If no PSM is registered for internal_asset.
• Error::UnsupportedAsset: If external_asset is not approved on this PSM.
• Error::AllSwapsStopped: If the per-external circuit breaker is at AllDisabled.
• Error::BelowMinimumSwap: If internal_amount is below the instance’s min_swap_amount.
• Error::FeeTooHigh: If the configured redemption fee exceeds max_fee.
• Error::InsufficientReserve: If the PSM holds less of external_asset than the redemption requires.
• Error::AmountTooSmallAfterConversion: If the conversion to the counter-asset rounds to zero; swap would transfer nothing.

Events

• Event::Redeemed: Emitted on successful redemption.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

internal_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance

max_fee: Permill

create_psm

Create a PSM for a given internal asset.

If Config::CreateOrigin resolves to Some(account), takes a Config::Consideration deposit from that account for the instance’s footprint (refunded on remove_psm). If it resolves to None, no deposit is taken. The full_admin and emergency_admin origins are set from the provided arguments and may later be reassigned via Pallet::set_full_admin / Pallet::set_emergency_admin.

Dispatch Origin

Config::CreateOrigin, parameterised by internal_asset. With the recommended EnsureAssetOwner this is a signed origin that owns internal_asset.

Parameters

• internal_asset: The internal stablecoin keying the new PSM. Must exist in the fungibles backend; must not already have a PSM registered.
• full_admin: Origin granted full management of the new PSM.
• emergency_admin: Origin granted emergency management of the new PSM.
• fee_destination: Account that will receive mint/redeem fees.
• max_debt: Initial absolute internal-asset debt ceiling.
• min_swap_amount: Minimum swap amount for this instance, in internal-asset units. Must be non-zero.

Errors

• [DispatchError::BadOrigin]: The origin is not permitted by Config::CreateOrigin.
• Error::PsmAlreadyExists: A PSM is already registered for internal_asset.
• Error::ZeroMinSwapAmount: min_swap_amount is zero.
• Error::AssetDoesNotExist: The internal asset does not exist.
• Any error from establishing the Config::Consideration deposit when one is needed (e.g. the account cannot afford it).

Events

• Event::PsmCreated.

Fields

internal_asset: T::AssetId

full_admin: Box<T::PalletsOrigin>

emergency_admin: Box<T::PalletsOrigin>

fee_destination: T::AccountId

max_debt: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance

min_swap_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance

remove_psm

Remove a PSM. Callable by the current full_admin. All approved externals must be removed first and aggregate PSM debt must be zero.

If a creation deposit was taken, it is always returned to the account that originally paid it, regardless of any later admin reassignment.

Dispatch Origin

Must match the PSM’s full_admin.

Parameters

• internal_asset: The PSM instance to remove.

Errors

• Error::PsmNotFound: No PSM is registered for internal_asset.
• Error::PsmHasApprovedExternals: Approved externals still exist.
• Error::PsmHasDebt: Outstanding aggregate debt is non-zero.

Events

• Event::PsmRemoved.

Fields

internal_asset: T::AssetId

set_minting_fee

Set the minting fee for an (internal_asset, external_asset) pair.

Dispatch Origin

Must match the PSM instance’s full_admin (the Full privilege level).

Parameters

• internal_asset: The PSM instance to configure.
• external_asset: The external asset whose minting fee is being updated.
• fee: The new minting fee.

Errors

• Error::InsufficientPrivilege: If the origin only has Emergency privileges.
• Error::AssetNotApproved: If external_asset is not approved on internal_asset.

Events

• Event::MintingFeeUpdated: Emitted with old and new values.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

fee: Permill

set_redemption_fee

Set the redemption fee for an (internal_asset, external_asset) pair.

Dispatch Origin

Must match the PSM instance’s full_admin (the Full privilege level).

Parameters

• internal_asset: The PSM instance to configure.
• external_asset: The external asset whose redemption fee is being updated.
• fee: The new redemption fee.

Errors

• Error::InsufficientPrivilege: If the origin only has Emergency privileges.
• Error::AssetNotApproved: If external_asset is not approved on internal_asset.

Events

• Event::RedemptionFeeUpdated: Emitted with old and new values.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

fee: Permill

set_max_debt

Set the PSM debt ceiling per internal asset, shared across all approved external assets.

Dispatch Origin

Must match the PSM instance’s full_admin; only the Full privilege level may use this call.

Parameters

• internal_asset: The PSM instance to configure.
• value: The new absolute debt ceiling, in internal-asset units.

Errors

• Error::InsufficientPrivilege: If the origin level cannot set the debt ceiling.
• Error::PsmNotFound: If no PSM is registered for internal_asset.

Events

• Event::MaxDebtUpdated: Emitted with old and new values.

Fields

internal_asset: T::AssetId

value: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance

set_asset_status

Set the circuit breaker per external asset on a PSM instance.

Dispatch Origin

Must match the PSM instance’s full_admin or emergency_admin; either the Full or Emergency privilege level may use this call.

Parameters

• internal_asset: The PSM instance to configure.
• external_asset: The external asset whose status is being updated.
• status: The new circuit breaker level for that external.

Errors

• Error::AssetNotApproved: If external_asset is not approved on internal_asset.

Events

• Event::AssetStatusUpdated: Emitted on a successful update.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

status: CircuitBreakerLevel

set_asset_ceiling_weight

Set the ceiling weight per external asset on a PSM instance.

Weights are normalised against the sum of weights within the same instance: max_asset_debt = (weight / sum_of_weights) * info.max_debt.

Dispatch Origin

Must match the PSM instance’s full_admin; only the Full privilege level may use this call.

Parameters

• internal_asset: The PSM instance to configure.
• external_asset: The external asset whose ceiling weight is being updated.
• weight: The new ceiling weight. Zero disables minting for this external.

Errors

• Error::InsufficientPrivilege: If the origin level cannot set ceiling weights.
• Error::AssetNotApproved: If external_asset is not approved on internal_asset.

Events

• Event::AssetCeilingWeightUpdated: Emitted with old and new values.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

weight: Permill

add_external_asset

Approve an external asset for a given internal asset.

Snapshots the external asset’s live decimals at registration time and increments PsmInfo::external_count.

Dispatch Origin

Must match the PSM instance’s full_admin (the Full privilege level).

Parameters

• internal_asset: The PSM instance to approve the external on.
• external_asset: The external asset to approve.

Errors

• Error::InsufficientPrivilege: If the origin only has Emergency privileges.
• Error::PsmNotFound: If no PSM is registered for internal_asset.
• Error::TooManyAssets: If the PSM is already at Config::MaxExternals.
• Error::AssetAlreadyApproved: If external_asset is already approved on this PSM.
• Error::AssetDoesNotExist: If external_asset does not exist in the underlying fungibles backend.
• Error::DecimalsMismatch: If the internal asset’s live decimals diverged from the snapshot in PsmInfo.
• Error::DecimalsRangeExceeded: If |asset_decimals − internal_decimals| exceeds MAX_DECIMALS_DIFF.

Events

• Event::ExternalAssetAdded: Emitted on a successful approval.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

remove_external_asset

Remove an external asset from a PSM instance.

Wipes the external’s per-instance state (status, decimals, fees, ceiling weight, debt counter) and decrements PsmInfo::external_count. The external must have zero outstanding debt on this instance.

Dispatch Origin

Must match the PSM instance’s full_admin (the Full privilege level).

Parameters

• internal_asset: The PSM instance to remove the external from.
• external_asset: The external asset to remove.

Errors

• Error::InsufficientPrivilege: If the origin only has Emergency privileges.
• Error::PsmNotFound: If no PSM is registered for internal_asset.
• Error::AssetNotApproved: If external_asset is not approved on this PSM.
• Error::AssetHasDebt: If the external still has non-zero outstanding debt.

Events

• Event::ExternalAssetRemoved: Emitted on a successful removal.

Fields

internal_asset: T::AssetId

external_asset: T::AssetId

set_full_admin

Reassign the PSM’s full_admin. Callable by the current full_admin.

Dispatch Origin

Must match the PSM’s current full_admin.

Parameters

• internal_asset: The PSM whose full_admin is being changed.
• new_admin: The new full_admin origin.

Errors

• Error::PsmNotFound: No PSM is registered for internal_asset.

Events

• Event::FullAdminChanged.

Fields

internal_asset: T::AssetId

new_admin: Box<T::PalletsOrigin>

set_emergency_admin

Reassign the PSM’s emergency_admin. Callable by the current full_admin.

Dispatch Origin

Must match the PSM’s current full_admin.

Parameters

• internal_asset: The PSM whose emergency_admin is being changed.
• new_admin: The new emergency_admin origin.

Errors

• Error::PsmNotFound: No PSM is registered for internal_asset.

Events

• Event::EmergencyAdminChanged.

Fields

internal_asset: T::AssetId

new_admin: Box<T::PalletsOrigin>

Implementations

impl<T: Config> Call<T>

pub fn new_call_variant_mint( internal_asset: T::AssetId, external_asset: T::AssetId, external_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance, max_fee: Permill, ) -> Self

Create a call with the variant mint.

pub fn new_call_variant_redeem( internal_asset: T::AssetId, external_asset: T::AssetId, internal_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance, max_fee: Permill, ) -> Self

Create a call with the variant redeem.

pub fn new_call_variant_create_psm( internal_asset: T::AssetId, full_admin: Box<T::PalletsOrigin>, emergency_admin: Box<T::PalletsOrigin>, fee_destination: T::AccountId, max_debt: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance, min_swap_amount: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance, ) -> Self

Create a call with the variant create_psm.

pub fn new_call_variant_remove_psm(internal_asset: T::AssetId) -> Self

Create a call with the variant remove_psm.

pub fn new_call_variant_set_minting_fee( internal_asset: T::AssetId, external_asset: T::AssetId, fee: Permill, ) -> Self

Create a call with the variant set_minting_fee.

pub fn new_call_variant_set_redemption_fee( internal_asset: T::AssetId, external_asset: T::AssetId, fee: Permill, ) -> Self

Create a call with the variant set_redemption_fee.

pub fn new_call_variant_set_max_debt( internal_asset: T::AssetId, value: <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance, ) -> Self

Create a call with the variant set_max_debt.

pub fn new_call_variant_set_asset_status( internal_asset: T::AssetId, external_asset: T::AssetId, status: CircuitBreakerLevel, ) -> Self

Create a call with the variant set_asset_status.

pub fn new_call_variant_set_asset_ceiling_weight( internal_asset: T::AssetId, external_asset: T::AssetId, weight: Permill, ) -> Self

Create a call with the variant set_asset_ceiling_weight.

pub fn new_call_variant_add_external_asset( internal_asset: T::AssetId, external_asset: T::AssetId, ) -> Self

Create a call with the variant add_external_asset.

pub fn new_call_variant_remove_external_asset( internal_asset: T::AssetId, external_asset: T::AssetId, ) -> Self

Create a call with the variant remove_external_asset.

pub fn new_call_variant_set_full_admin( internal_asset: T::AssetId, new_admin: Box<T::PalletsOrigin>, ) -> Self

Create a call with the variant set_full_admin.

pub fn new_call_variant_set_emergency_admin( internal_asset: T::AssetId, new_admin: Box<T::PalletsOrigin>, ) -> Self

Create a call with the variant set_emergency_admin.

Trait Implementations

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

fn authorize( &self, source: TransactionSource, ) -> Option<Result<(ValidTransaction, Weight), TransactionValidityError>>

The authorize function.

fn weight_of_authorize(&self) -> Weight

The weight of the authorization function.

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, T::AssetId: TypeInfo + 'static, <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance: TypeInfo + 'static, Box<T::PalletsOrigin>: TypeInfo + 'static, T::AccountId: 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 T::AssetId: DecodeWithMemTracking, <<T as Config>::Fungibles as FungiblesInspect<<T as Config>::AccountId>>::Balance: DecodeWithMemTracking, Box<T::PalletsOrigin>: DecodeWithMemTracking, T::AccountId: DecodeWithMemTracking,

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

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