pezkuwichain
1c0e57d984
This commit systematically rebrands various references from Parity Technologies' Polkadot/Substrate ecosystem to PezkuwiChain within the kurdistan-sdk. Key changes include: - Updated external repository URLs (zombienet-sdk, parity-db, parity-scale-codec, wasm-instrument) to point to pezkuwichain forks. - Modified internal documentation and code comments to reflect PezkuwiChain naming and structure. - Replaced direct references to with or specific paths within the for XCM, Pezkuwi, and other modules. - Cleaned up deprecated issue and PR references in various and files, particularly in and modules. - Adjusted image and logo URLs in documentation to point to PezkuwiChain assets. - Removed or rephrased comments related to external Polkadot/Substrate PRs and issues. This is a significant step towards fully customizing the SDK for the PezkuwiChain ecosystem.
103 lines
4.6 KiB
Rust
103 lines
4.6 KiB
Rust
// This file is part of Bizinikiwi.
|
|
|
|
// Copyright (C) Parity Technologies (UK) Ltd.
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
//! Traits for creating, editing and destroying assets.
|
|
//!
|
|
//! See the [`crate::traits::fungibles`] doc for more information about fungibles traits.
|
|
|
|
use super::Inspect;
|
|
use crate::traits::tokens::{AssetId, Balance};
|
|
use pezsp_runtime::{DispatchError, DispatchResult};
|
|
|
|
/// Trait for providing the ability to create new fungible assets.
|
|
pub trait Create<AccountId>: Inspect<AccountId> {
|
|
/// Create a new fungible asset.
|
|
fn create(
|
|
id: Self::AssetId,
|
|
admin: AccountId,
|
|
is_sufficient: bool,
|
|
min_balance: Self::Balance,
|
|
) -> DispatchResult;
|
|
}
|
|
|
|
/// Trait for refunding the existence deposit of a target asset account.
|
|
///
|
|
/// The existence deposit might by necessary and present in cases where the asset held by the
|
|
/// account is insufficient for the required storage, or when the system cannot provide a consumer
|
|
/// reference for any reason.
|
|
pub trait Refund<AccountId> {
|
|
/// Means of identifying one asset class from another.
|
|
type AssetId: AssetId;
|
|
/// Scalar type for representing deposit balance of an account.
|
|
type Balance: Balance;
|
|
/// Returns the amount of account deposit and depositor address, if any.
|
|
fn deposit_held(id: Self::AssetId, who: AccountId) -> Option<(AccountId, Self::Balance)>;
|
|
/// Return the deposit (if any) of a target asset account.
|
|
fn refund(id: Self::AssetId, who: AccountId) -> DispatchResult;
|
|
}
|
|
|
|
/// Trait for providing the ability to destroy existing fungible assets.
|
|
pub trait Destroy<AccountId>: Inspect<AccountId> {
|
|
/// Start the destruction an existing fungible asset.
|
|
/// * `id`: The `AssetId` to be destroyed. successfully.
|
|
/// * `maybe_check_owner`: An optional account id that can be used to authorize the destroy
|
|
/// command. If not provided, no authorization checks will be performed before destroying
|
|
/// asset.
|
|
fn start_destroy(id: Self::AssetId, maybe_check_owner: Option<AccountId>) -> DispatchResult;
|
|
|
|
/// Destroy all accounts associated with a given asset.
|
|
/// `destroy_accounts` should only be called after `start_destroy` has been called, and the
|
|
/// asset is in a `Destroying` state
|
|
///
|
|
/// * `id`: The identifier of the asset to be destroyed. This must identify an existing asset.
|
|
/// * `max_items`: The maximum number of accounts to be destroyed for a given call of the
|
|
/// function. This value should be small enough to allow the operation fit into a logical
|
|
/// block.
|
|
///
|
|
/// Response:
|
|
/// * u32: Total number of approvals which were actually destroyed
|
|
///
|
|
/// Due to weight restrictions, this function may need to be called multiple
|
|
/// times to fully destroy all approvals. It will destroy `max_items` approvals at a
|
|
/// time.
|
|
fn destroy_accounts(id: Self::AssetId, max_items: u32) -> Result<u32, DispatchError>;
|
|
/// Destroy all approvals associated with a given asset up to the `max_items`
|
|
/// `destroy_approvals` should only be called after `start_destroy` has been called, and the
|
|
/// asset is in a `Destroying` state
|
|
///
|
|
/// * `id`: The identifier of the asset to be destroyed. This must identify an existing asset.
|
|
/// * `max_items`: The maximum number of accounts to be destroyed for a given call of the
|
|
/// function. This value should be small enough to allow the operation fit into a logical
|
|
/// block.
|
|
///
|
|
/// Response:
|
|
/// * u32: Total number of approvals which were actually destroyed
|
|
///
|
|
/// Due to weight restrictions, this function may need to be called multiple
|
|
/// times to fully destroy all approvals. It will destroy `max_items` approvals at a
|
|
/// time.
|
|
fn destroy_approvals(id: Self::AssetId, max_items: u32) -> Result<u32, DispatchError>;
|
|
|
|
/// Complete destroying asset and unreserve currency.
|
|
/// `finish_destroy` should only be called after `start_destroy` has been called, and the
|
|
/// asset is in a `Destroying` state. All accounts or approvals should be destroyed before
|
|
/// hand.
|
|
///
|
|
/// * `id`: The identifier of the asset to be destroyed. This must identify an existing asset.
|
|
fn finish_destroy(id: Self::AssetId) -> DispatchResult;
|
|
}
|