pub struct Pallet<T, I = ()>(/* private fields */);
Expand description

The Pallet struct, the main type that implements traits and standalone functions within the pallet.

Implementations§

source§

impl<T: Config<I>, I: 'static> Pallet<T, I>

source

pub fn do_transfer( collection: T::CollectionId, item: T::ItemId, dest: T::AccountId, with_details: impl FnOnce(&CollectionDetails<<T as SystemConfig>::AccountId, <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>, &mut ItemDetails<<T as SystemConfig>::AccountId, <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>) -> DispatchResult ) -> DispatchResult

Perform a transfer of an item from one account to another within a collection.

§Errors

This function returns a dispatch error in the following cases:

  • The collection or item does not exist (UnknownCollection).
  • The collection is frozen, and no transfers are allowed (Frozen).
  • The item is locked, and transfers are not permitted (Locked).
  • The with_details closure returns an error.
source

pub fn do_create_collection( collection: T::CollectionId, owner: T::AccountId, admin: T::AccountId, deposit: <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance, free_holding: bool, event: Event<T, I> ) -> DispatchResult

Create a new collection with the provided details.

§Errors

This function returns a dispatch error in the following cases:

  • If the collection ID is already in use (InUse).
  • If reserving the deposit fails (e.g., insufficient funds).
source

pub fn do_destroy_collection( collection: T::CollectionId, witness: DestroyWitness, maybe_check_owner: Option<T::AccountId> ) -> Result<DestroyWitness, DispatchError>

Destroy a collection along with its associated items and metadata.

§Errors

This function returns a dispatch error in the following cases:

source

pub fn do_mint( collection: T::CollectionId, item: T::ItemId, owner: T::AccountId, with_details: impl FnOnce(&CollectionDetails<<T as SystemConfig>::AccountId, <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>) -> DispatchResult ) -> DispatchResult

Mint (create) a new item within a collection and assign ownership to an account.

§Errors

This function returns a dispatch error in the following cases:

  • The item already exists in the collection (AlreadyExists).
  • The collection does not exist (UnknownCollection).
  • The provided closure with_details returns an error.
  • The collection has reached its maximum supply (MaxSupplyReached).
  • An arithmetic overflow occurs when incrementing the number of items in the collection.
  • The currency reserve operation for the item deposit fails for any reason.
source

pub fn do_burn( collection: T::CollectionId, item: T::ItemId, with_details: impl FnOnce(&CollectionDetails<<T as SystemConfig>::AccountId, <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>, &ItemDetails<<T as SystemConfig>::AccountId, <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>) -> DispatchResult ) -> DispatchResult

Burn (destroy) an item from a collection.

§Errors

This function returns a Dispatch error in the following cases:

  • The item is locked and burns are not permitted (Locked).
  • The collection or item does not exist (UnknownCollection).
  • The with_details closure returns an error.
source

pub fn do_set_price( collection: T::CollectionId, item: T::ItemId, sender: T::AccountId, price: Option<<<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>, whitelisted_buyer: Option<T::AccountId> ) -> DispatchResult

Set or remove the price for an item in a collection.

§Errors

This function returns a dispatch error in the following cases:

source

pub fn do_buy_item( collection: T::CollectionId, item: T::ItemId, buyer: T::AccountId, bid_price: <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance ) -> DispatchResult

Buy an item from a collection.

§Errors

This function returns a dispatch error in the following cases:

  • The item or collection does not exist (UnknownItem or UnknownCollection).
  • The buyer is the current owner of the item (NoPermission).
  • The item is not for sale (NotForSale).
  • The bid price is lower than the item’s sale price (BidTooLow).
  • The item is set to be sold only to a specific buyer, and the provided buyer is not the whitelisted buyer (NoPermission).
  • The currency transfer between the buyer and the owner fails for any reason.
source§

impl<T: Config<I>, I: 'static> Pallet<T, I>

source

pub fn owner( collection: T::CollectionId, item: T::ItemId ) -> Option<T::AccountId>

Get the owner of the item, if the item exists.

source

pub fn collection_owner(collection: T::CollectionId) -> Option<T::AccountId>

Get the owner of the item, if the item exists.

source§

impl<T: Config<I>, I: 'static> Pallet<T, I>

source

pub fn create( origin: OriginFor<T>, collection: T::CollectionId, admin: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Issue a new collection of non-fungible items from a public origin.

This new collection has no items initially and its owner is the origin.

The origin must conform to the configured CreateOrigin and have sufficient funds free.

ItemDeposit funds of sender are reserved.

Parameters:

  • collection: The identifier of the new collection. This must not be currently in use.
  • admin: The admin of this collection. The admin is the initial address of each member of the collection’s admin team.

Emits Created event when successful.

Weight: O(1)

source

pub fn force_create( origin: OriginFor<T>, collection: T::CollectionId, owner: <<T as Config>::Lookup as StaticLookup>::Source, free_holding: bool ) -> DispatchResult

Issue a new collection of non-fungible items from a privileged origin.

This new collection has no items initially.

The origin must conform to ForceOrigin.

Unlike create, no funds are reserved.

  • collection: The identifier of the new item. This must not be currently in use.
  • owner: The owner of this collection of items. The owner has full superuser permissions over this item, but may later change and configure the permissions using transfer_ownership and set_team.

Emits ForceCreated event when successful.

Weight: O(1)

source

pub fn destroy( origin: OriginFor<T>, collection: T::CollectionId, witness: DestroyWitness ) -> DispatchResultWithPostInfo

Destroy a collection of fungible items.

The origin must conform to ForceOrigin or must be Signed and the sender must be the owner of the collection.

  • collection: The identifier of the collection to be destroyed.
  • witness: Information on the items minted in the collection. This must be correct.

Emits Destroyed event when successful.

Weight: O(n + m) where:

  • n = witness.items
  • m = witness.item_metadatas
  • a = witness.attributes
source

pub fn mint( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, owner: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Mint an item of a particular collection.

The origin must be Signed and the sender must be the Issuer of the collection.

  • collection: The collection of the item to be minted.
  • item: The item value of the item to be minted.
  • beneficiary: The initial owner of the minted item.

Emits Issued event when successful.

Weight: O(1)

source

pub fn burn( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, check_owner: Option<<<T as Config>::Lookup as StaticLookup>::Source> ) -> DispatchResult

Destroy a single item.

Origin must be Signed and the signing account must be either:

  • the Admin of the collection;

  • the Owner of the item;

  • collection: The collection of the item to be burned.

  • item: The item of the item to be burned.

  • check_owner: If Some then the operation will fail with WrongOwner unless the item is owned by this value.

Emits Burned with the actual amount burned.

Weight: O(1) Modes: check_owner.is_some().

source

pub fn transfer( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, dest: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Move an item from the sender account to another.

This resets the approved account of the item.

Origin must be Signed and the signing account must be either:

  • the Admin of the collection;
  • the Owner of the item;
  • the approved delegate for the item (in this case, the approval is reset).

Arguments:

  • collection: The collection of the item to be transferred.
  • item: The item of the item to be transferred.
  • dest: The account to receive ownership of the item.

Emits Transferred.

Weight: O(1)

source

pub fn redeposit( origin: OriginFor<T>, collection: T::CollectionId, items: Vec<T::ItemId> ) -> DispatchResult

Reevaluate the deposits on some items.

Origin must be Signed and the sender should be the Owner of the collection.

  • collection: The collection to be frozen.
  • items: The items of the collection whose deposits will be reevaluated.

NOTE: This exists as a best-effort function. Any items which are unknown or in the case that the owner account does not have reservable funds to pay for a deposit increase are ignored. Generally the owner isn’t going to call this on items whose existing deposit is less than the refreshed deposit as it would only cost them, so it’s of little consequence.

It will still return an error in the case that the collection is unknown of the signer is not permitted to call it.

Weight: O(items.len())

source

pub fn freeze( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId ) -> DispatchResult

Disallow further unprivileged transfer of an item.

Origin must be Signed and the sender should be the Freezer of the collection.

  • collection: The collection of the item to be frozen.
  • item: The item of the item to be frozen.

Emits Frozen.

Weight: O(1)

source

pub fn thaw( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId ) -> DispatchResult

Re-allow unprivileged transfer of an item.

Origin must be Signed and the sender should be the Freezer of the collection.

  • collection: The collection of the item to be thawed.
  • item: The item of the item to be thawed.

Emits Thawed.

Weight: O(1)

source

pub fn freeze_collection( origin: OriginFor<T>, collection: T::CollectionId ) -> DispatchResult

Disallow further unprivileged transfers for a whole collection.

Origin must be Signed and the sender should be the Freezer of the collection.

  • collection: The collection to be frozen.

Emits CollectionFrozen.

Weight: O(1)

source

pub fn thaw_collection( origin: OriginFor<T>, collection: T::CollectionId ) -> DispatchResult

Re-allow unprivileged transfers for a whole collection.

Origin must be Signed and the sender should be the Admin of the collection.

  • collection: The collection to be thawed.

Emits CollectionThawed.

Weight: O(1)

source

pub fn transfer_ownership( origin: OriginFor<T>, collection: T::CollectionId, new_owner: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Change the Owner of a collection.

Origin must be Signed and the sender should be the Owner of the collection.

  • collection: The collection whose owner should be changed.
  • owner: The new Owner of this collection. They must have called set_accept_ownership with collection in order for this operation to succeed.

Emits OwnerChanged.

Weight: O(1)

source

pub fn set_team( origin: OriginFor<T>, collection: T::CollectionId, issuer: <<T as Config>::Lookup as StaticLookup>::Source, admin: <<T as Config>::Lookup as StaticLookup>::Source, freezer: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Change the Issuer, Admin and Freezer of a collection.

Origin must be Signed and the sender should be the Owner of the collection.

  • collection: The collection whose team should be changed.
  • issuer: The new Issuer of this collection.
  • admin: The new Admin of this collection.
  • freezer: The new Freezer of this collection.

Emits TeamChanged.

Weight: O(1)

source

pub fn approve_transfer( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, delegate: <<T as Config>::Lookup as StaticLookup>::Source ) -> DispatchResult

Approve an item to be transferred by a delegated third-party account.

The origin must conform to ForceOrigin or must be Signed and the sender must be either the owner of the item or the admin of the collection.

  • collection: The collection of the item to be approved for delegated transfer.
  • item: The item of the item to be approved for delegated transfer.
  • delegate: The account to delegate permission to transfer the item.

Important NOTE: The approved account gets reset after each transfer.

Emits ApprovedTransfer on success.

Weight: O(1)

source

pub fn cancel_approval( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, maybe_check_delegate: Option<<<T as Config>::Lookup as StaticLookup>::Source> ) -> DispatchResult

Cancel the prior approval for the transfer of an item by a delegate.

Origin must be either:

  • the Force origin;
  • Signed with the signer being the Admin of the collection;
  • Signed with the signer being the Owner of the item;

Arguments:

  • collection: The collection of the item of whose approval will be cancelled.
  • item: The item of the item of whose approval will be cancelled.
  • maybe_check_delegate: If Some will ensure that the given account is the one to which permission of transfer is delegated.

Emits ApprovalCancelled on success.

Weight: O(1)

source

pub fn force_item_status( origin: OriginFor<T>, collection: T::CollectionId, owner: <<T as Config>::Lookup as StaticLookup>::Source, issuer: <<T as Config>::Lookup as StaticLookup>::Source, admin: <<T as Config>::Lookup as StaticLookup>::Source, freezer: <<T as Config>::Lookup as StaticLookup>::Source, free_holding: bool, is_frozen: bool ) -> DispatchResult

Alter the attributes of a given item.

Origin must be ForceOrigin.

  • collection: The identifier of the item.
  • owner: The new Owner of this item.
  • issuer: The new Issuer of this item.
  • admin: The new Admin of this item.
  • freezer: The new Freezer of this item.
  • free_holding: Whether a deposit is taken for holding an item of this collection.
  • is_frozen: Whether this collection is frozen except for permissioned/admin instructions.

Emits ItemStatusChanged with the identity of the item.

Weight: O(1)

source

pub fn set_attribute( origin: OriginFor<T>, collection: T::CollectionId, maybe_item: Option<T::ItemId>, key: BoundedVec<u8, T::KeyLimit>, value: BoundedVec<u8, T::ValueLimit> ) -> DispatchResult

Set an attribute for a collection or item.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

If the origin is Signed, then funds of signer are reserved according to the formula: MetadataDepositBase + DepositPerByte * (key.len + value.len) taking into account any already reserved funds.

  • collection: The identifier of the collection whose item’s metadata to set.
  • maybe_item: The identifier of the item whose metadata to set.
  • key: The key of the attribute.
  • value: The value to which to set the attribute.

Emits AttributeSet.

Weight: O(1)

source

pub fn clear_attribute( origin: OriginFor<T>, collection: T::CollectionId, maybe_item: Option<T::ItemId>, key: BoundedVec<u8, T::KeyLimit> ) -> DispatchResult

Clear an attribute for a collection or item.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

Any deposit is freed for the collection’s owner.

  • collection: The identifier of the collection whose item’s metadata to clear.
  • maybe_item: The identifier of the item whose metadata to clear.
  • key: The key of the attribute.

Emits AttributeCleared.

Weight: O(1)

source

pub fn set_metadata( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, data: BoundedVec<u8, T::StringLimit>, is_frozen: bool ) -> DispatchResult

Set the metadata for an item.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

If the origin is Signed, then funds of signer are reserved according to the formula: MetadataDepositBase + DepositPerByte * data.len taking into account any already reserved funds.

  • collection: The identifier of the collection whose item’s metadata to set.
  • item: The identifier of the item whose metadata to set.
  • data: The general information of this item. Limited in length by StringLimit.
  • is_frozen: Whether the metadata should be frozen against further changes.

Emits MetadataSet.

Weight: O(1)

source

pub fn clear_metadata( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId ) -> DispatchResult

Clear the metadata for an item.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the item.

Any deposit is freed for the collection’s owner.

  • collection: The identifier of the collection whose item’s metadata to clear.
  • item: The identifier of the item whose metadata to clear.

Emits MetadataCleared.

Weight: O(1)

source

pub fn set_collection_metadata( origin: OriginFor<T>, collection: T::CollectionId, data: BoundedVec<u8, T::StringLimit>, is_frozen: bool ) -> DispatchResult

Set the metadata for a collection.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

If the origin is Signed, then funds of signer are reserved according to the formula: MetadataDepositBase + DepositPerByte * data.len taking into account any already reserved funds.

  • collection: The identifier of the item whose metadata to update.
  • data: The general information of this item. Limited in length by StringLimit.
  • is_frozen: Whether the metadata should be frozen against further changes.

Emits CollectionMetadataSet.

Weight: O(1)

source

pub fn clear_collection_metadata( origin: OriginFor<T>, collection: T::CollectionId ) -> DispatchResult

Clear the metadata for a collection.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

Any deposit is freed for the collection’s owner.

  • collection: The identifier of the collection whose metadata to clear.

Emits CollectionMetadataCleared.

Weight: O(1)

source

pub fn set_accept_ownership( origin: OriginFor<T>, maybe_collection: Option<T::CollectionId> ) -> DispatchResult

Set (or reset) the acceptance of ownership for a particular account.

Origin must be Signed and if maybe_collection is Some, then the signer must have a provider reference.

  • maybe_collection: The identifier of the collection whose ownership the signer is willing to accept, or if None, an indication that the signer is willing to accept no ownership transferal.

Emits OwnershipAcceptanceChanged.

source

pub fn set_collection_max_supply( origin: OriginFor<T>, collection: T::CollectionId, max_supply: u32 ) -> DispatchResult

Set the maximum amount of items a collection could have.

Origin must be either ForceOrigin or Signed and the sender should be the Owner of the collection.

Note: This function can only succeed once per collection.

  • collection: The identifier of the collection to change.
  • max_supply: The maximum amount of items a collection could have.

Emits CollectionMaxSupplySet event when successful.

source

pub fn set_price( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, price: Option<<<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance>, whitelisted_buyer: Option<<<T as Config>::Lookup as StaticLookup>::Source> ) -> DispatchResult

Set (or reset) the price for an item.

Origin must be Signed and must be the owner of the asset item.

  • collection: The collection of the item.
  • item: The item to set the price for.
  • price: The price for the item. Pass None, to reset the price.
  • buyer: Restricts the buy operation to a specific account.

Emits ItemPriceSet on success if the price is not None. Emits ItemPriceRemoved on success if the price is None.

source

pub fn buy_item( origin: OriginFor<T>, collection: T::CollectionId, item: T::ItemId, bid_price: <<T as Config<I>>::Currency as Currency<<T as SystemConfig>::AccountId>>::Balance ) -> DispatchResult

Allows to buy an item if it’s up for sale.

Origin must be Signed and must not be the owner of the item.

  • collection: The collection of the item.
  • item: The item the sender wants to buy.
  • bid_price: The price the sender is willing to pay.

Emits ItemBought on success.

Trait Implementations§

source§

impl<T: Config<I>, I: 'static> BeforeAllRuntimeMigrations for Pallet<T, I>

source§

fn before_all_runtime_migrations() -> Weight

Something that should happen before runtime migrations are executed.
source§

impl<T, I: 'static> Benchmarking for Pallet<T, I>
where T: Config + Config<I>,

source§

fn benchmarks(extra: bool) -> Vec<BenchmarkMetadata>

Get the benchmarks available for this pallet. Generally there is one benchmark per extrinsic, so these are sometimes just called “extrinsics”. Read more
source§

fn run_benchmark( extrinsic: &[u8], c: &[(BenchmarkParameter, u32)], whitelist: &[TrackedStorageKey], verify: bool, internal_repeats: u32 ) -> Result<Vec<BenchmarkResult>, BenchmarkError>

Run the benchmarks for this pallet.
source§

impl<T: Config<I>, I: 'static> Callable<T> for Pallet<T, I>

§

type RuntimeCall = Call<T, I>

source§

impl<T, I> Clone for Pallet<T, I>

source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<T: Config<I>, I: 'static> Create<<T as Config>::AccountId> for Pallet<T, I>

source§

fn create_collection( collection: &Self::CollectionId, who: &T::AccountId, admin: &T::AccountId ) -> DispatchResult

Create a collection of nonfungible items to be owned by who and managed by admin.

source§

impl<T, I> Debug for Pallet<T, I>

source§

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

Formats the value using the given formatter. Read more
source§

impl<T: Config<I>, I: 'static> Destroy<<T as Config>::AccountId> for Pallet<T, I>

§

type DestroyWitness = DestroyWitness

The witness data needed to destroy an item.
source§

fn get_destroy_witness( collection: &Self::CollectionId ) -> Option<DestroyWitness>

Provide the appropriate witness data needed to destroy an item.
source§

fn destroy( collection: Self::CollectionId, witness: Self::DestroyWitness, maybe_check_owner: Option<T::AccountId> ) -> Result<Self::DestroyWitness, DispatchError>

Destroy an existing fungible item. Read more
source§

impl<T: Config<I>, I: 'static> GetStorageVersion for Pallet<T, I>

§

type InCodeStorageVersion = StorageVersion

This type is generated by the pallet macro. Read more
source§

fn in_code_storage_version() -> Self::InCodeStorageVersion

Returns the in-code storage version as specified in the storage_version attribute, or [NoStorageVersionSet] if the attribute is missing.
source§

fn on_chain_storage_version() -> StorageVersion

Returns the storage version of the pallet as last set in the actual on-chain storage.
§

fn current_storage_version() -> Self::InCodeStorageVersion

👎Deprecated: This method has been renamed to in_code_storage_version and will be removed after March 2024.
DEPRECATED: Use [Self::current_storage_version] instead. Read more
source§

impl<T: Config<I>, I: 'static> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

§

fn on_initialize(_n: BlockNumber) -> Weight

Block initialization hook. This is called at the very beginning of block execution. Read more
§

fn on_finalize(_n: BlockNumber)

Block finalization hook. This is called at the very end of block execution. Read more
§

fn on_idle(_n: BlockNumber, _remaining_weight: Weight) -> Weight

Hook to consume a block’s idle time. This will run when the block is being finalized (before [Hooks::on_finalize]). Read more
§

fn on_poll(_n: BlockNumber, _weight: &mut WeightMeter)

A hook to run logic after inherent application. Read more
§

fn on_runtime_upgrade() -> Weight

Hook executed when a code change (aka. a “runtime upgrade”) is detected by the FRAME Executive pallet. Read more
§

fn try_state(_n: BlockNumber) -> Result<(), DispatchError>

Execute the sanity checks of this pallet, per block. Read more
§

fn pre_upgrade() -> Result<Vec<u8>, DispatchError>

Execute some pre-checks prior to a runtime upgrade. Read more
§

fn post_upgrade(_state: Vec<u8>) -> Result<(), DispatchError>

Execute some post-checks after a runtime upgrade. Read more
§

fn offchain_worker(_n: BlockNumber)

Implementing this function on a pallet allows you to perform long-running tasks that are dispatched as separate threads, and entirely independent of the main blockchain execution. Read more
§

fn integrity_test()

Check the integrity of this pallet’s configuration. Read more
source§

impl<T: Config<I>, I: 'static> Inspect<<T as Config>::AccountId> for Pallet<T, I>

source§

fn attribute( collection: &Self::CollectionId, item: &Self::ItemId, key: &[u8] ) -> Option<Vec<u8>>

Returns the attribute value of item of collection corresponding to key.

When key is empty, we return the item metadata value.

By default this is None; no attributes are defined.

source§

fn collection_attribute( collection: &Self::CollectionId, key: &[u8] ) -> Option<Vec<u8>>

Returns the attribute value of item of collection corresponding to key.

When key is empty, we return the item metadata value.

By default this is None; no attributes are defined.

source§

fn can_transfer(collection: &Self::CollectionId, item: &Self::ItemId) -> bool

Returns true if the item of collection may be transferred.

Default implementation is that all items are transferable.

§

type ItemId = <T as Config<I>>::ItemId

Type for identifying an item.
§

type CollectionId = <T as Config<I>>::CollectionId

Type for identifying a collection (an identifier for an independent collection of items).
source§

fn owner( collection: &Self::CollectionId, item: &Self::ItemId ) -> Option<<T as SystemConfig>::AccountId>

Returns the owner of item of collection, or None if the item doesn’t exist (or somehow has no owner).
source§

fn collection_owner( collection: &Self::CollectionId ) -> Option<<T as SystemConfig>::AccountId>

Returns the owner of the collection, if there is one. For many NFTs this may not make any sense, so users of this API should not be surprised to find a collection results in None here.
§

fn typed_attribute<K, V>( collection: &Self::CollectionId, item: &Self::ItemId, key: &K ) -> Option<V>
where K: Encode, V: Decode,

Returns the strongly-typed attribute value of item of collection corresponding to key. Read more
§

fn typed_collection_attribute<K, V>( collection: &Self::CollectionId, key: &K ) -> Option<V>
where K: Encode, V: Decode,

Returns the strongly-typed attribute value of collection corresponding to key. Read more
source§

impl<T: Config<I>, I: 'static> InspectEnumerable<<T as Config>::AccountId> for Pallet<T, I>

source§

fn collections() -> Self::CollectionsIterator

Returns an iterator of the collections in existence.

NOTE: iterating this list invokes a storage read per item.

source§

fn items(collection: &Self::CollectionId) -> Self::ItemsIterator

Returns an iterator of the items of a collection in existence.

NOTE: iterating this list invokes a storage read per item.

source§

fn owned(who: &T::AccountId) -> Self::OwnedIterator

Returns an iterator of the items of all collections owned by who.

NOTE: iterating this list invokes a storage read per item.

source§

fn owned_in_collection( collection: &Self::CollectionId, who: &T::AccountId ) -> Self::OwnedInCollectionIterator

Returns an iterator of the items of collection owned by who.

NOTE: iterating this list invokes a storage read per item.

§

type CollectionsIterator = KeyPrefixIterator<<T as Config<I>>::CollectionId>

The iterator type for [Self::collections].
§

type ItemsIterator = KeyPrefixIterator<<T as Config<I>>::ItemId>

The iterator type for [Self::items].
§

type OwnedIterator = KeyPrefixIterator<(<T as Config<I>>::CollectionId, <T as Config<I>>::ItemId)>

The iterator type for [Self::owned].
§

type OwnedInCollectionIterator = KeyPrefixIterator<<T as Config<I>>::ItemId>

The iterator type for [Self::owned_in_collection].
source§

impl<T: Config<I>, I: 'static> IntegrityTest for Pallet<T, I>

source§

fn integrity_test()

See [Hooks::integrity_test].
source§

impl<T: Config<I>, I: 'static> Mutate<<T as Config>::AccountId> for Pallet<T, I>

source§

fn mint_into( collection: &Self::CollectionId, item: &Self::ItemId, who: &T::AccountId ) -> DispatchResult

Mint some item of collection to be owned by who. Read more
source§

fn burn( collection: &Self::CollectionId, item: &Self::ItemId, maybe_check_owner: Option<&T::AccountId> ) -> DispatchResult

Burn some item of collection. Read more
§

fn set_attribute( _collection: &Self::CollectionId, _item: &Self::ItemId, _key: &[u8], _value: &[u8] ) -> Result<(), DispatchError>

Set attribute value of item of collection’s key. Read more
§

fn set_typed_attribute<K, V>( collection: &Self::CollectionId, item: &Self::ItemId, key: &K, value: &V ) -> Result<(), DispatchError>
where K: Encode, V: Encode,

Attempt to set the strongly-typed attribute value of item of collection’s key. Read more
§

fn set_collection_attribute( _collection: &Self::CollectionId, _key: &[u8], _value: &[u8] ) -> Result<(), DispatchError>

Set attribute value of collection’s key. Read more
§

fn set_typed_collection_attribute<K, V>( collection: &Self::CollectionId, key: &K, value: &V ) -> Result<(), DispatchError>
where K: Encode, V: Encode,

Attempt to set the strongly-typed attribute value of collection’s key. Read more
source§

impl<T: Config<I>, I: 'static> OffchainWorker<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn offchain_worker(n: BlockNumberFor<T>)

This function is being called after every block import (when fully synced). Read more
source§

impl<T: Config<I>, I: 'static> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn on_finalize(n: BlockNumberFor<T>)

See [Hooks::on_finalize].
source§

impl<T: Config<I>, I: 'static> OnGenesis for Pallet<T, I>

source§

fn on_genesis()

Something that should happen at genesis.
source§

impl<T: Config<I>, I: 'static> OnIdle<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn on_idle(n: BlockNumberFor<T>, remaining_weight: Weight) -> Weight

See [Hooks::on_idle].
source§

impl<T: Config<I>, I: 'static> OnInitialize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn on_initialize(n: BlockNumberFor<T>) -> Weight

See [Hooks::on_initialize].
source§

impl<T: Config<I>, I: 'static> OnPoll<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn on_poll(n: BlockNumberFor<T>, weight: &mut WeightMeter)

Code to execute every now and then at the beginning of the block after inherent application. Read more
source§

impl<T: Config<I>, I: 'static> OnRuntimeUpgrade for Pallet<T, I>

source§

fn on_runtime_upgrade() -> Weight

See [Hooks::on_runtime_upgrade].
source§

fn pre_upgrade() -> Result<Vec<u8>, TryRuntimeError>

See [Hooks::pre_upgrade].
source§

fn post_upgrade(state: Vec<u8>) -> Result<(), TryRuntimeError>

See [Hooks::post_upgrade].
§

fn try_on_runtime_upgrade(checks: bool) -> Result<Weight, DispatchError>

The expected and default behavior of this method is to handle executing pre_upgrade -> on_runtime_upgrade -> post_upgrade hooks for a migration. Read more
source§

impl<T: Config<I>, I: 'static> PalletInfoAccess for Pallet<T, I>

source§

fn index() -> usize

Index of the pallet as configured in the runtime.
source§

fn name() -> &'static str

Name of the pallet as configured in the runtime.
source§

fn name_hash() -> [u8; 16]

Two128 hash of name.
source§

fn module_name() -> &'static str

Name of the Rust module containing the pallet.
source§

fn crate_version() -> CrateVersion

Version of the crate containing the pallet.
source§

impl<T: Config<I>, I: 'static> PalletsInfoAccess for Pallet<T, I>

source§

fn count() -> usize

The number of pallets’ information that this type represents. Read more
source§

fn infos() -> Vec<PalletInfoData>

All of the pallets’ information that this type represents.
source§

impl<T, I> PartialEq for Pallet<T, I>

source§

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<T: Config<I>, I: 'static> StorageInfoTrait for Pallet<T, I>

source§

fn storage_info() -> Vec<StorageInfo>

source§

impl<T: Config<I>, I: 'static> Transfer<<T as Config>::AccountId> for Pallet<T, I>

source§

fn transfer( collection: &Self::CollectionId, item: &Self::ItemId, destination: &T::AccountId ) -> DispatchResult

Transfer item of collection into destination account.
source§

impl<T: Config<I>, I: 'static> TryDecodeEntireStorage for Pallet<T, I>

source§

fn try_decode_entire_state() -> Result<usize, Vec<TryDecodeEntireStorageError>>

Decode the entire data under the given storage, returning Ok(bytes_decoded) if success.
source§

impl<T: Config<I>, I: 'static> TryState<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T, I>

source§

fn try_state( n: BlockNumberFor<T>, _s: TryStateSelect ) -> Result<(), TryRuntimeError>

Execute the state checks.
source§

impl<T: Config<I>, I: 'static> WhitelistedStorageKeys for Pallet<T, I>

source§

fn whitelisted_storage_keys() -> Vec<TrackedStorageKey>

Returns a Vec<TrackedStorageKey> indicating the storage keys that should be whitelisted during benchmarking. This means that those keys will be excluded from the benchmarking performance calculation.
source§

impl<T, I> Eq for Pallet<T, I>

Auto Trait Implementations§

§

impl<T, I> RefUnwindSafe for Pallet<T, I>

§

impl<T, I> Send for Pallet<T, I>
where I: Send, T: Send,

§

impl<T, I> Sync for Pallet<T, I>
where I: Sync, T: Sync,

§

impl<T, I> Unpin for Pallet<T, I>
where I: Unpin, T: Unpin,

§

impl<T, I> UnwindSafe for Pallet<T, I>
where I: UnwindSafe, T: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> CheckedConversion for T

§

fn checked_from<T>(t: T) -> Option<Self>
where Self: TryFrom<T>,

Convert from a value of T into an equivalent instance of Option<Self>. Read more
§

fn checked_into<T>(self) -> Option<T>
where Self: TryInto<T>,

Consume self to return Some equivalent value of Option<T>. Read more
§

impl<T> Conv for T

§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
source§

impl<T> DynClone for T
where T: Clone,

source§

fn __clone_box(&self, _: Private) -> *mut ()

source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<T> FmtForward for T

§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, U> IntoKey<U> for T
where U: FromKey<T>,

§

fn into_key(self) -> U

§

impl<T> IsType<T> for T

§

fn from_ref(t: &T) -> &T

Cast reference.
§

fn into_ref(&self) -> &T

Cast reference.
§

fn from_mut(t: &mut T) -> &mut T

Cast mutable reference.
§

fn into_mut(&mut self) -> &mut T

Cast mutable reference.
§

impl<T, Outer> IsWrappedBy<Outer> for T
where Outer: AsRef<T> + AsMut<T> + From<T>, T: From<Outer>,

§

fn from_ref(outer: &Outer) -> &T

Get a reference to the inner from the outer.

§

fn from_mut(outer: &mut Outer) -> &mut T

Get a mutable reference to the inner from the outer.

§

impl<T> Pipe for T
where T: ?Sized,

§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> SaturatedConversion for T

source§

fn saturated_from<T>(t: T) -> Self
where Self: UniqueSaturatedFrom<T>,

Convert from a value of T into an equivalent instance of Self. Read more
source§

fn saturated_into<T>(self) -> T
where Self: UniqueSaturatedInto<T>,

Consume self to return an equivalent value of T. Read more
§

impl<SS, SP> SupersetOf<SS> for SP
where SS: SubsetOf<SP>,

§

fn to_subset(&self) -> Option<SS>

The inverse inclusion map: attempts to construct self from the equivalent element of its superset. Read more
§

fn is_in_subset(&self) -> bool

Checks if self is actually part of its subset T (and can be converted to it).
§

fn to_subset_unchecked(&self) -> SS

Use with care! Same as self.to_subset but without any property checks. Always succeeds.
§

fn from_subset(element: &SS) -> SP

The inclusion map: converts self to the equivalent element of its superset.
§

impl<T> Tap for T

§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
§

impl<T> TryConv for T

§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T, U> TryIntoKey<U> for T
where U: TryFromKey<T>,

§

type Error = <U as TryFromKey<T>>::Error

§

fn try_into_key(self) -> Result<U, <U as TryFromKey<T>>::Error>

§

impl<S, T> UncheckedInto<T> for S
where T: UncheckedFrom<S>,

§

fn unchecked_into(self) -> T

The counterpart to unchecked_from.
source§

impl<T, S> UniqueSaturatedInto<T> for S
where T: Bounded, S: TryInto<T>,

source§

fn unique_saturated_into(self) -> T

Consume self to return an equivalent value of T.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<T> JsonSchemaMaybe for T

§

impl<T> MaybeDebug for T
where T: Debug,

§

impl<T> MaybeRefUnwindSafe for T
where T: RefUnwindSafe,

§

impl<T> MaybeRefUnwindSafe for T
where T: RefUnwindSafe,

§

impl<T> Member for T
where T: Send + Sync + Debug + Eq + PartialEq + Clone + 'static,

source§

impl<T> Scalar for T
where T: 'static + Clone + PartialEq + Debug,