difftreelog
doc(rmrk): style + minor revisions
in: master
3 files changed
pallets/proxy-rmrk-core/src/lib.rsdiffbeforeafterboth1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// This file is part of Unique Network.34// Unique Network is free software: you can redistribute it and/or modify5// it under the terms of the GNU General Public License as published by6// the Free Software Foundation, either version 3 of the License, or7// (at your option) any later version.89// Unique Network is distributed in the hope that it will be useful,10// but WITHOUT ANY WARRANTY; without even the implied warranty of11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the12// GNU General Public License for more details.1314// You should have received a copy of the GNU General Public License15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.1617//! # RMRK Core Proxy Pallet18//!19//! A pallet used as proxy for RMRK Core (<https://rmrk-team.github.io/rmrk-substrate/#/pallets/rmrk-core>).20//!21//! - [`Config`]22//! - [`Call`]23//! - [`Pallet`]24//!25//! ## Overview26//!27//! The RMRK Core Proxy pallet mirrors the functionality of RMRK Core,28//! binding its externalities to Unique's own underlying structure.29//! It is purposed to mimic RMRK Core exactly, allowing seamless integrations30//! of solutions based on RMRK.31//!32//! RMRK Core itself contains essential functionality for RMRK's nested and33//! multi-resourced NFTs.34//!35//! *Note*, that while RMRK itself is subject to active development and restructuring,36//! the proxy may be caught temporarily out of date.37//!38//! ### What is RMRK?39//!40//! RMRK is a set of NFT standards which compose several "NFT 2.0 lego" primitives.41//! Putting these legos together allows a user to create NFT systems of arbitrary complexity.42//!43//! Meaning, RMRK NFTs are dynamic, able to nest into each other and form a hierarchy,44//! make use of specific changeable and partially shared metadata in the form of resources,45//! and more.46//!47//! Visit RMRK documentation and repositories to learn more:48//! - Docs: <https://docs.rmrk.app/getting-started/>49//! - FAQ: <https://coda.io/@rmrk/faq>50//! - Substrate code repository: <https://github.com/rmrk-team/rmrk-substrate>51//! - RMRK specification repository: <https://github.com/rmrk-team/rmrk-spec>52//! 53//! ## Terminology54//! 55//! For more information on RMRK, see RMRK's own documentation.56//! 57//! ### Intro to RMRK58//! 59//! - **Resource:** Additional piece of metadata of an NFT usually serving to add 60//! a piece of media on top of the root metadata (NFT's own), be it a different wing 61//! on the root template bird or something entirely unrelated.62//! 63//! - **Base:** A list of possible "components" - Parts, a combination of which can 64//! be appended/equipped to/on an NFT.65//! 66//! - **Part:** Something that, together with other Parts, can constitute an NFT. 67//! Parts are defined in the Base to which they belong. Parts can be either 68//! of the `slot` type or `fixed` type. Slots are intended for equippables.69//! Note that "part of something" and "Part of a Base" can be easily confused, 70//! and in this documentation these words are distinguished by the capital letter.71//! 72//! - **Theme:** Named objects of variable => value pairs which get interpolated into 73//! the Base's `themable` Parts. Themes can hold any value, but are often represented 74//! in RMRK's examples as colors applied to visible Parts.75//! 76//! ### Peculiarities in Unique77//! 78//! - **Scoped properties:** Properties that are normally obscured from users. 79//! Their purpose is to contain structured metadata that was not included in the Unique standard 80//! for collections and tokens, meant to be operated on by proxies and other outliers. 81//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is 82//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined 83//! properties, which, along with other safeguards, makes them impossible to tamper with.84//! 85//! - **Auxiliary properties:** A slightly different structure of properties, 86//! trading universality of use for more convenient storage, writes and access. 87//! Meant to be inaccessible to end users.88//!89//! ## Proxy Implementation90//!91//! An external user is supposed to be able to utilize this proxy as they would92//! utilize RMRK, and get exactly the same results. Normally, Unique transactions93//! are off-limits to RMRK collections and tokens, and vice versa. However,94//! the information stored on chain can be freely interpreted by storage reads and RPCs.95//!96//! ### ID Mapping97//!98//! RMRK's collections' IDs are counted independently of Unique's and start at 0.99//! Note that tokens' IDs still start at 1.100//! The collections themselves, as well as tokens, are stored as Unique collections,101//! and thus RMRK IDs are mapped to Unique IDs (but not vice versa).102//!103//! ### External/Internal Collection Insulation104//!105//! A Unique transaction cannot target collections purposed for RMRK,106//! and they are flagged as `external` to specify that. On the other hand,107//! due to the mapping, RMRK transactions and RPCs simply cannot reach Unique collections.108//!109//! ### Native Properties110//!111//! Many of RMRK's native parameters are stored as scoped properties of a collection112//! or an NFT on the chain. Scoped properties are prefixed with `rmrk:`, where `:`113//! is an unacceptable symbol in user-defined properties, which, along with other safeguards,114//! makes them impossible to tamper with.115//!116//! ### Collection and NFT Types, and Base, Parts and Themes Handling117//!118//! RMRK introduces the concept of a Base, which is a catalgoue of Parts,119//! possible components of an NFT. Due to its similarity with the functionality120//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes121//! are the collection's NFTs. See [`CollectionType`](pallet_rmrk_core::misc::CollectionType) and122//! [`NftType`](pallet_rmrk_core::misc::NftType).123//! 124//! ## Interface125//!126//! ### Dispatchables127//!128//! - `create_collection` - Create a new collection of NFTs.129//! - `destroy_collection` - Destroy a collection.130//! - `change_collection_issuer` - Change the issuer of a collection.131//! Analogous to Unique's collection's [`owner`](up_data_structs::Collection).132//! - `lock_collection` - "Lock" the collection and prevent new token creation. **Cannot be undone.**133//! - `mint_nft` - Mint an NFT in a specified collection.134//! - `burn_nft` - Burn an NFT, destroying it and its nested tokens.135//! - `send` - Transfer an NFT from an account/NFT A to another account/NFT B.136//! - `accept_nft` - Accept an NFT sent from another account to self or an owned NFT.137//! - `reject_nft` - Reject an NFT sent from another account to self or owned NFT and **burn it**.138//! - `accept_resource` - Accept the addition of a newly created pending resource to an existing NFT.139//! - `accept_resource_removal` - Accept the removal of a removal-pending resource from an NFT.140//! - `set_property` - Add or edit a custom user property of a token or a collection.141//! - `set_priority` - Set a different order of resource priorities for an NFT.142//! - `add_basic_resource` - Create and set/propose a basic resource for an NFT.143//! - `add_composable_resource` - Create and set/propose a composable resource for an NFT.144//! - `add_slot_resource` - Create and set/propose a slot resource for an NFT.145//! - `remove_resource` - Remove and erase a resource from an NFT.146147#![cfg_attr(not(feature = "std"), no_std)]148149use frame_support::{pallet_prelude::*, transactional, BoundedVec, dispatch::DispatchResult};150use frame_system::{pallet_prelude::*, ensure_signed};151use sp_runtime::{DispatchError, Permill, traits::StaticLookup};152use sp_std::{153 vec::Vec,154 collections::{btree_set::BTreeSet, btree_map::BTreeMap},155};156use up_data_structs::{*, mapping::TokenAddressMapping};157use pallet_common::{158 Pallet as PalletCommon, Error as CommonError, CollectionHandle, CommonCollectionOperations,159};160use pallet_nonfungible::{Pallet as PalletNft, NonfungibleHandle, TokenData};161use pallet_structure::{Pallet as PalletStructure, Error as StructureError};162use pallet_evm::account::CrossAccountId;163use core::convert::AsRef;164165pub use pallet::*;166167#[cfg(feature = "runtime-benchmarks")]168pub mod benchmarking;169pub mod misc;170pub mod property;171pub mod rpc;172pub mod weights;173174pub type SelfWeightOf<T> = <T as Config>::WeightInfo;175176use weights::WeightInfo;177use misc::*;178pub use property::*;179180use RmrkProperty::*;181182/// Maximum number of levels of depth in the token nesting tree.183pub const NESTING_BUDGET: u32 = 5;184185type PendingTarget = (CollectionId, TokenId);186type PendingChild = (RmrkCollectionId, RmrkNftId);187type PendingChildrenSet = BTreeSet<PendingChild>;188189type BasesMap = BTreeMap<RmrkBaseId, u32>;190191#[frame_support::pallet]192pub mod pallet {193 use super::*;194 use pallet_evm::account;195196 #[pallet::config]197 pub trait Config:198 frame_system::Config + pallet_common::Config + pallet_nonfungible::Config + account::Config199 {200 /// Overarching event type.201 type Event: From<Event<Self>> + IsType<<Self as frame_system::Config>::Event>;202203 /// The weight information of this pallet.204 type WeightInfo: WeightInfo;205 }206207 /// Latest yet-unused collection ID.208 #[pallet::storage]209 #[pallet::getter(fn collection_index)]210 pub type CollectionIndex<T: Config> = StorageValue<_, RmrkCollectionId, ValueQuery>;211212 /// Mapping from RMRK collection ID to Unique's.213 #[pallet::storage]214 pub type UniqueCollectionId<T: Config> =215 StorageMap<_, Twox64Concat, RmrkCollectionId, CollectionId, ValueQuery>;216217 #[pallet::pallet]218 #[pallet::generate_store(pub(super) trait Store)]219 pub struct Pallet<T>(_);220221 #[pallet::event]222 #[pallet::generate_deposit(pub(super) fn deposit_event)]223 pub enum Event<T: Config> {224 CollectionCreated {225 issuer: T::AccountId,226 collection_id: RmrkCollectionId,227 },228 CollectionDestroyed {229 issuer: T::AccountId,230 collection_id: RmrkCollectionId,231 },232 IssuerChanged {233 old_issuer: T::AccountId,234 new_issuer: T::AccountId,235 collection_id: RmrkCollectionId,236 },237 CollectionLocked {238 issuer: T::AccountId,239 collection_id: RmrkCollectionId,240 },241 NftMinted {242 owner: T::AccountId,243 collection_id: RmrkCollectionId,244 nft_id: RmrkNftId,245 },246 NFTBurned {247 owner: T::AccountId,248 nft_id: RmrkNftId,249 },250 NFTSent {251 sender: T::AccountId,252 recipient: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,253 collection_id: RmrkCollectionId,254 nft_id: RmrkNftId,255 approval_required: bool,256 },257 NFTAccepted {258 sender: T::AccountId,259 recipient: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,260 collection_id: RmrkCollectionId,261 nft_id: RmrkNftId,262 },263 NFTRejected {264 sender: T::AccountId,265 collection_id: RmrkCollectionId,266 nft_id: RmrkNftId,267 },268 PropertySet {269 collection_id: RmrkCollectionId,270 maybe_nft_id: Option<RmrkNftId>,271 key: RmrkKeyString,272 value: RmrkValueString,273 },274 ResourceAdded {275 nft_id: RmrkNftId,276 resource_id: RmrkResourceId,277 },278 ResourceRemoval {279 nft_id: RmrkNftId,280 resource_id: RmrkResourceId,281 },282 ResourceAccepted {283 nft_id: RmrkNftId,284 resource_id: RmrkResourceId,285 },286 ResourceRemovalAccepted {287 nft_id: RmrkNftId,288 resource_id: RmrkResourceId,289 },290 PrioritySet {291 collection_id: RmrkCollectionId,292 nft_id: RmrkNftId,293 },294 }295296 #[pallet::error]297 pub enum Error<T> {298 /* Unique proxy-specific events */299 /// Property of the type of RMRK collection could not be read successfully.300 CorruptedCollectionType,301 // NftTypeEncodeError,302 /// Too many symbols supplied as the property key. The maximum is [256](up_data_structs::MAX_PROPERTY_KEY_LENGTH).303 RmrkPropertyKeyIsTooLong,304 /// Too many bytes supplied as the property value. The maximum is [32768](up_data_structs::MAX_PROPERTY_VALUE_LENGTH).305 RmrkPropertyValueIsTooLong,306 /// Could not find a property by the supplied key.307 RmrkPropertyIsNotFound,308 /// Something went wrong when decoding encoded data from the storage.309 /// Perhaps, there was a wrong key supplied for the type, or the data was improperly stored.310 UnableToDecodeRmrkData,311312 /* RMRK compatible events */313 /// Only destroying collections without tokens is allowed.314 CollectionNotEmpty,315 /// Could not find an ID for a collection. It is likely there were too many collections created on the chain, causing an overflow.316 NoAvailableCollectionId,317 /// Token does not exist, or there is no suitable ID for it, likely too many tokens were created in a collection, causing an overflow.318 NoAvailableNftId,319 /// Collection does not exist, has a wrong type, or does not map to a Unique ID.320 CollectionUnknown,321 /// No permission to perform action.322 NoPermission,323 /// Token is marked as non-transferable, and thus cannot be transferred.324 NonTransferable,325 /// Too many tokens created in the collection, no new ones are allowed.326 CollectionFullOrLocked,327 /// No such resource found.328 ResourceDoesntExist,329 /// If an NFT is sent to a descendant, that would form a nesting loop, an ouroboros.330 /// Sending to self is redundant.331 CannotSendToDescendentOrSelf,332 /// Not the target owner of the sent NFT.333 CannotAcceptNonOwnedNft,334 /// Not the target owner of the sent NFT.335 CannotRejectNonOwnedNft,336 /// NFT was not sent and is not pending.337 CannotRejectNonPendingNft,338 /// Resource is not pending for the operation.339 ResourceNotPending,340 /// Could not find an ID for the resource. It is likely there were too many resources created on an NFT, causing an overflow.341 NoAvailableResourceId,342 }343344 #[pallet::call]345 impl<T: Config> Pallet<T> {346 // todo :refactor replace every collection_id with rmrk_collection_id (and nft_id) in arguments for uniformity?347348 /// Create a new collection of NFTs.349 ///350 /// # Permissions:351 /// * Anyone - will be assigned as the issuer of the collection.352 ///353 /// # Arguments:354 /// - `metadata`: Metadata describing the collection, e.g. IPFS hash. Cannot be changed.355 /// - `max`: Optional maximum number of tokens.356 /// - `symbol`: UTF-8 string with token prefix, by which to represent the token in wallets and UIs.357 /// Analogous to Unique's [`token_prefix`](up_data_structs::Collection). Cannot be changed.358 #[transactional]359 #[pallet::weight(<SelfWeightOf<T>>::create_collection())]360 pub fn create_collection(361 origin: OriginFor<T>,362 metadata: RmrkString,363 max: Option<u32>,364 symbol: RmrkCollectionSymbol,365 ) -> DispatchResult {366 let sender = ensure_signed(origin)?;367368 let limits = CollectionLimits {369 owner_can_transfer: Some(false),370 token_limit: max,371 ..Default::default()372 };373374 let data = CreateCollectionData {375 limits: Some(limits),376 token_prefix: symbol377 .into_inner()378 .try_into()379 .map_err(|_| <CommonError<T>>::CollectionTokenPrefixLimitExceeded)?,380 permissions: Some(CollectionPermissions {381 nesting: Some(NestingPermissions {382 token_owner: true,383 collection_admin: false,384 restricted: None,385 #[cfg(feature = "runtime-benchmarks")]386 permissive: false,387 }),388 ..Default::default()389 }),390 ..Default::default()391 };392393 let unique_collection_id = Self::init_collection(394 T::CrossAccountId::from_sub(sender.clone()),395 data,396 [397 Self::encode_rmrk_property(Metadata, &metadata)?,398 Self::encode_rmrk_property(CollectionType, &misc::CollectionType::Regular)?,399 ]400 .into_iter(),401 )?;402 let rmrk_collection_id = <CollectionIndex<T>>::get();403404 <UniqueCollectionId<T>>::insert(rmrk_collection_id, unique_collection_id);405406 <PalletCommon<T>>::set_scoped_collection_property(407 unique_collection_id,408 RMRK_SCOPE,409 Self::encode_rmrk_property(RmrkInternalCollectionId, &rmrk_collection_id)?,410 )?;411412 <CollectionIndex<T>>::mutate(|n| *n += 1);413414 Self::deposit_event(Event::CollectionCreated {415 issuer: sender,416 collection_id: rmrk_collection_id,417 });418419 Ok(())420 }421422 /// Destroy a collection.423 ///424 /// Only empty collections can be destroyed. If it has any tokens, they must be burned first.425 ///426 /// # Permissions:427 /// * Collection issuer428 ///429 /// # Arguments:430 /// - `collection_id`: RMRK ID of the collection to destroy.431 #[transactional]432 #[pallet::weight(<SelfWeightOf<T>>::destroy_collection())]433 pub fn destroy_collection(434 origin: OriginFor<T>,435 collection_id: RmrkCollectionId,436 ) -> DispatchResult {437 let sender = ensure_signed(origin)?;438 let cross_sender = T::CrossAccountId::from_sub(sender.clone());439440 let collection = Self::get_typed_nft_collection(441 Self::unique_collection_id(collection_id)?,442 misc::CollectionType::Regular,443 )?;444 collection.check_is_external()?;445446 <PalletNft<T>>::destroy_collection(collection, &cross_sender)447 .map_err(Self::map_unique_err_to_proxy)?;448449 Self::deposit_event(Event::CollectionDestroyed {450 issuer: sender,451 collection_id,452 });453454 Ok(())455 }456457 /// Change the issuer of a collection. Analogous to Unique's collection's [`owner`](up_data_structs::Collection).458 ///459 /// # Permissions:460 /// * Collection issuer461 ///462 /// # Arguments:463 /// - `collection_id`: RMRK collection ID to change the issuer of.464 /// - `new_issuer`: Collection's new issuer.465 #[transactional]466 #[pallet::weight(<SelfWeightOf<T>>::change_collection_issuer())]467 pub fn change_collection_issuer(468 origin: OriginFor<T>,469 collection_id: RmrkCollectionId,470 new_issuer: <T::Lookup as StaticLookup>::Source,471 ) -> DispatchResult {472 let sender = ensure_signed(origin)?;473474 let collection = Self::get_nft_collection(Self::unique_collection_id(collection_id)?)?;475 collection.check_is_external()?;476477 let new_issuer = T::Lookup::lookup(new_issuer)?;478479 Self::change_collection_owner(480 Self::unique_collection_id(collection_id)?,481 misc::CollectionType::Regular,482 sender.clone(),483 new_issuer.clone(),484 )?;485486 Self::deposit_event(Event::IssuerChanged {487 old_issuer: sender,488 new_issuer,489 collection_id,490 });491492 Ok(())493 }494495 /// "Lock" the collection and prevent new token creation. Cannot be undone.496 ///497 /// # Permissions:498 /// * Collection issuer499 ///500 /// # Arguments:501 /// - `collection_id`: RMRK ID of the collection to lock.502 #[transactional]503 #[pallet::weight(<SelfWeightOf<T>>::lock_collection())]504 pub fn lock_collection(505 origin: OriginFor<T>,506 collection_id: RmrkCollectionId,507 ) -> DispatchResult {508 let sender = ensure_signed(origin)?;509 let cross_sender = T::CrossAccountId::from_sub(sender.clone());510511 let collection = Self::get_typed_nft_collection(512 Self::unique_collection_id(collection_id)?,513 misc::CollectionType::Regular,514 )?;515 collection.check_is_external()?;516517 Self::check_collection_owner(&collection, &cross_sender)?;518519 let token_count = collection.total_supply();520521 let mut collection = collection.into_inner();522 collection.limits.token_limit = Some(token_count);523 collection.save()?;524525 Self::deposit_event(Event::CollectionLocked {526 issuer: sender,527 collection_id,528 });529530 Ok(())531 }532533 /// Mint an NFT in a specified collection.534 ///535 /// # Permissions:536 /// * Collection issuer537 ///538 /// # Arguments:539 /// - `owner`: Owner account of the NFT. If set to None, defaults to the sender (collection issuer).540 /// - `collection_id`: RMRK collection ID for the NFT to be minted within. Cannot be changed.541 /// - `recipient`: Receiver account of the royalty. Has no effect if the `royalty_amount` is not set. Cannot be changed.542 /// - `royalty_amount`: Optional permillage reward from each trade for the `recipient`. Cannot be changed.543 /// - `metadata`: Arbitrary data about an NFT, e.g. IPFS hash. Cannot be changed.544 /// - `transferable`: Can this NFT be transferred? Cannot be changed.545 /// - `resources`: Resource data to be added to the NFT immediately after minting.546 #[transactional]547 #[pallet::weight(<SelfWeightOf<T>>::mint_nft(resources.as_ref().map(|r| r.len() as u32).unwrap_or(0)))]548 pub fn mint_nft(549 origin: OriginFor<T>,550 owner: Option<T::AccountId>,551 collection_id: RmrkCollectionId,552 recipient: Option<T::AccountId>,553 royalty_amount: Option<Permill>,554 metadata: RmrkString,555 transferable: bool,556 resources: Option<BoundedVec<RmrkResourceTypes, MaxResourcesOnMint>>,557 ) -> DispatchResult {558 let sender = ensure_signed(origin)?;559 let cross_sender = T::CrossAccountId::from_sub(sender.clone());560561 let owner = owner.unwrap_or(sender.clone());562 let cross_owner = T::CrossAccountId::from_sub(owner.clone());563564 let collection = Self::get_typed_nft_collection(565 Self::unique_collection_id(collection_id)?,566 misc::CollectionType::Regular,567 )?;568 collection.check_is_external()?;569570 let royalty_info = royalty_amount.map(|amount| rmrk_traits::RoyaltyInfo {571 recipient: recipient.unwrap_or_else(|| owner.clone()),572 amount,573 });574575 let nft_id = Self::create_nft(576 &cross_sender,577 &cross_owner,578 &collection,579 [580 Self::encode_rmrk_property(TokenType, &NftType::Regular)?,581 Self::encode_rmrk_property(Transferable, &transferable)?,582 Self::encode_rmrk_property(PendingNftAccept, &None::<PendingTarget>)?,583 Self::encode_rmrk_property(RoyaltyInfo, &royalty_info)?,584 Self::encode_rmrk_property(Metadata, &metadata)?,585 Self::encode_rmrk_property(Equipped, &false)?,586 Self::encode_rmrk_property(ResourcePriorities, &<Vec<u8>>::new())?,587 Self::encode_rmrk_property(NextResourceId, &(0 as RmrkResourceId))?,588 Self::encode_rmrk_property(PendingChildren, &PendingChildrenSet::new())?,589 Self::encode_rmrk_property(AssociatedBases, &BasesMap::new())?,590 ]591 .into_iter(),592 )593 .map_err(|err| match err {594 DispatchError::Arithmetic(_) => <Error<T>>::NoAvailableNftId.into(),595 err => Self::map_unique_err_to_proxy(err),596 })?;597598 if let Some(resources) = resources {599 for resource in resources {600 Self::resource_add(sender.clone(), collection.id, nft_id, resource)?;601 }602 }603604 Self::deposit_event(Event::NftMinted {605 owner,606 collection_id,607 nft_id: nft_id.0,608 });609610 Ok(())611 }612613 /// Burn an NFT, destroying it and its nested tokens up to the specified limit.614 /// If the burning budget is exceeded, the transaction is reverted.615 ///616 /// This is the way to burn a nested token as well.617 ///618 /// For more information, see [`burn_recursively`](pallet_nonfungible::pallet::Pallet::burn_recursively).619 ///620 /// # Permissions:621 /// * Token owner622 ///623 /// # Arguments:624 /// - `collection_id`: RMRK ID of the collection in which the NFT to burn belongs to.625 /// - `nft_id`: ID of the NFT to be destroyed.626 /// - `max_burns`: Maximum number of tokens to burn, assuming nesting. The transaction627 /// is reverted if there are more tokens to burn in the nesting tree than this number.628 /// This is primarily a mechanism of transaction weight control.629 #[transactional]630 #[pallet::weight(<SelfWeightOf<T>>::burn_nft(*max_burns))]631 pub fn burn_nft(632 origin: OriginFor<T>,633 collection_id: RmrkCollectionId,634 nft_id: RmrkNftId,635 max_burns: u32,636 ) -> DispatchResult {637 let sender = ensure_signed(origin)?;638 let cross_sender = T::CrossAccountId::from_sub(sender.clone());639640 let collection = Self::get_typed_nft_collection(641 Self::unique_collection_id(collection_id)?,642 misc::CollectionType::Regular,643 )?;644 collection.check_is_external()?;645646 Self::destroy_nft(647 cross_sender,648 Self::unique_collection_id(collection_id)?,649 nft_id.into(),650 max_burns,651 <Error<T>>::NoPermission,652 )653 .map_err(|err| Self::map_unique_err_to_proxy(err.error))?;654655 Self::deposit_event(Event::NFTBurned {656 owner: sender,657 nft_id,658 });659660 Ok(())661 }662663 /// Transfer an NFT from an account/NFT A to another account/NFT B.664 /// The token must be transferable. Nesting cannot occur deeper than the [`NESTING_BUDGET`].665 ///666 /// If the target owner is an NFT owned by another account, then the NFT will enter667 /// the pending state and will have to be accepted by the other account.668 ///669 /// # Permissions:670 /// - Token owner671 ///672 /// # Arguments:673 /// - `collection_id`: RMRK ID of the collection of the NFT to be transferred.674 /// - `nft_id`: ID of the NFT to be transferred.675 /// - `new_owner`: New owner of the nft which can be either an account or a NFT.676 #[transactional]677 #[pallet::weight(<SelfWeightOf<T>>::send())]678 pub fn send(679 origin: OriginFor<T>,680 rmrk_collection_id: RmrkCollectionId,681 rmrk_nft_id: RmrkNftId,682 new_owner: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,683 ) -> DispatchResult {684 let sender = ensure_signed(origin.clone())?;685 let cross_sender = T::CrossAccountId::from_sub(sender.clone());686687 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;688 let nft_id = rmrk_nft_id.into();689690 let collection =691 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;692 collection.check_is_external()?;693694 let token_data =695 <TokenData<T>>::get((collection_id, nft_id)).ok_or(<Error<T>>::NoAvailableNftId)?;696697 let from = token_data.owner;698699 ensure!(700 Self::get_nft_property_decoded(collection_id, nft_id, RmrkProperty::Transferable)?,701 <Error<T>>::NonTransferable702 );703704 ensure!(705 Self::get_nft_property_decoded::<Option<PendingTarget>>(706 collection_id,707 nft_id,708 RmrkProperty::PendingNftAccept709 )?710 .is_none(),711 <Error<T>>::NoPermission712 );713714 let target_owner;715 let approval_required;716717 match new_owner {718 RmrkAccountIdOrCollectionNftTuple::AccountId(ref account_id) => {719 target_owner = T::CrossAccountId::from_sub(account_id.clone());720 approval_required = false;721 }722 RmrkAccountIdOrCollectionNftTuple::CollectionAndNftTuple(723 target_collection_id,724 target_nft_id,725 ) => {726 let target_collection_id = Self::unique_collection_id(target_collection_id)?;727728 let target_nft_budget = budget::Value::new(NESTING_BUDGET);729730 let target_nft_owner = <PalletStructure<T>>::get_checked_topmost_owner(731 target_collection_id,732 target_nft_id.into(),733 Some((collection_id, nft_id)),734 &target_nft_budget,735 )736 .map_err(Self::map_unique_err_to_proxy)?;737738 approval_required = cross_sender != target_nft_owner;739740 if approval_required {741 target_owner = target_nft_owner;742743 <PalletNft<T>>::set_scoped_token_property(744 collection.id,745 nft_id,746 RMRK_SCOPE,747 Self::encode_rmrk_property::<Option<PendingTarget>>(748 PendingNftAccept,749 &Some((target_collection_id, target_nft_id.into())),750 )?,751 )?;752753 Self::insert_pending_child(754 (target_collection_id, target_nft_id.into()),755 (rmrk_collection_id, rmrk_nft_id),756 )?;757 } else {758 target_owner = T::CrossTokenAddressMapping::token_to_address(759 target_collection_id,760 target_nft_id.into(),761 );762 }763 }764 }765766 let src_nft_budget = budget::Value::new(NESTING_BUDGET);767768 <PalletNft<T>>::transfer_from(769 &collection,770 &cross_sender,771 &from,772 &target_owner,773 nft_id,774 &src_nft_budget,775 )776 .map_err(Self::map_unique_err_to_proxy)?;777778 Self::deposit_event(Event::NFTSent {779 sender,780 recipient: new_owner,781 collection_id: rmrk_collection_id,782 nft_id: rmrk_nft_id,783 approval_required,784 });785786 Ok(())787 }788789 /// Accept an NFT sent from another account to self or an owned NFT.790 ///791 /// The NFT in question must be pending, and, thus, be [sent](`crate::pallet::Call::send`) first.792 ///793 /// # Permissions:794 /// - Token-owner-to-be795 ///796 /// # Arguments:797 /// - `rmrk_collection_id`: RMRK collection ID of the NFT to be accepted.798 /// - `rmrk_nft_id`: ID of the NFT to be accepted.799 /// - `new_owner`: Either the sender's account ID or a sender-owned NFT,800 /// whichever the accepted NFT was sent to.801 #[transactional]802 #[pallet::weight(<SelfWeightOf<T>>::accept_nft())]803 pub fn accept_nft(804 origin: OriginFor<T>,805 rmrk_collection_id: RmrkCollectionId,806 rmrk_nft_id: RmrkNftId,807 new_owner: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,808 ) -> DispatchResult {809 let sender = ensure_signed(origin.clone())?;810 let cross_sender = T::CrossAccountId::from_sub(sender.clone());811812 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;813 let nft_id = rmrk_nft_id.into();814815 let collection =816 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;817 collection.check_is_external()?;818819 let new_cross_owner = match new_owner {820 RmrkAccountIdOrCollectionNftTuple::AccountId(ref account_id) => {821 T::CrossAccountId::from_sub(account_id.clone())822 }823 RmrkAccountIdOrCollectionNftTuple::CollectionAndNftTuple(824 target_collection_id,825 target_nft_id,826 ) => {827 let target_collection_id = Self::unique_collection_id(target_collection_id)?;828829 T::CrossTokenAddressMapping::token_to_address(830 target_collection_id,831 TokenId(target_nft_id),832 )833 }834 };835836 let budget = budget::Value::new(NESTING_BUDGET);837838 <PalletNft<T>>::transfer(839 &collection,840 &cross_sender,841 &new_cross_owner,842 nft_id,843 &budget,844 )845 .map_err(|err| {846 if err == <CommonError<T>>::UserIsNotAllowedToNest.into() {847 <Error<T>>::CannotAcceptNonOwnedNft.into()848 } else {849 Self::map_unique_err_to_proxy(err)850 }851 })?;852853 let pending_target = Self::get_nft_property_decoded::<Option<PendingTarget>>(854 collection_id,855 nft_id,856 RmrkProperty::PendingNftAccept,857 )?;858859 if let Some(pending_target) = pending_target {860 Self::remove_pending_child(pending_target, (rmrk_collection_id, rmrk_nft_id))?;861862 <PalletNft<T>>::set_scoped_token_property(863 collection.id,864 nft_id,865 RMRK_SCOPE,866 Self::encode_rmrk_property(PendingNftAccept, &None::<PendingTarget>)?,867 )?;868 }869870 Self::deposit_event(Event::NFTAccepted {871 sender,872 recipient: new_owner,873 collection_id: rmrk_collection_id,874 nft_id: rmrk_nft_id,875 });876877 Ok(())878 }879880 /// Reject an NFT sent from another account to self or owned NFT.881 /// The NFT in question will not be sent back and burnt instead.882 ///883 /// The NFT in question must be pending, and, thus, be [sent](`crate::pallet::Call::send`) first.884 ///885 /// # Permissions:886 /// - Token-owner-to-be-not887 ///888 /// # Arguments:889 /// - `rmrk_collection_id`: RMRK ID of the NFT to be rejected.890 /// - `rmrk_nft_id`: ID of the NFT to be rejected.891 #[transactional]892 #[pallet::weight(<SelfWeightOf<T>>::reject_nft())]893 pub fn reject_nft(894 origin: OriginFor<T>,895 rmrk_collection_id: RmrkCollectionId,896 rmrk_nft_id: RmrkNftId,897 ) -> DispatchResult {898 let sender = ensure_signed(origin)?;899 let cross_sender = T::CrossAccountId::from_sub(sender.clone());900901 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;902 let nft_id = rmrk_nft_id.into();903904 let collection =905 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;906 collection.check_is_external()?;907908 ensure!(909 <TokenData<T>>::get((collection_id, nft_id)).is_some(),910 <Error<T>>::NoAvailableNftId911 );912913 let pending_target = Self::get_nft_property_decoded::<Option<PendingTarget>>(914 collection_id,915 nft_id,916 RmrkProperty::PendingNftAccept,917 )?;918919 match pending_target {920 Some(pending_target) => {921 Self::remove_pending_child(pending_target, (rmrk_collection_id, rmrk_nft_id))?922 }923 None => return Err(<Error<T>>::CannotRejectNonPendingNft.into()),924 }925926 Self::destroy_nft(927 cross_sender,928 collection_id,929 nft_id,930 NESTING_BUDGET,931 <Error<T>>::CannotRejectNonOwnedNft,932 )933 .map_err(|err| Self::map_unique_err_to_proxy(err.error))?;934935 Self::deposit_event(Event::NFTRejected {936 sender,937 collection_id: rmrk_collection_id,938 nft_id: rmrk_nft_id,939 });940941 Ok(())942 }943944 /// Accept the addition of a newly created pending resource to an existing NFT.945 ///946 /// This transaction is needed when a resource is created and assigned to an NFT947 /// by a non-owner, i.e. the collection issuer, with one of the948 /// [`add_...` transactions](crate::pallet::Call::add_basic_resource).949 ///950 /// # Permissions:951 /// - Token owner952 ///953 /// # Arguments:954 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.955 /// - `rmrk_nft_id`: ID of the NFT with a pending resource to be accepted.956 /// - `resource_id`: ID of the newly created pending resource.957 #[transactional]958 #[pallet::weight(<SelfWeightOf<T>>::accept_resource())]959 pub fn accept_resource(960 origin: OriginFor<T>,961 rmrk_collection_id: RmrkCollectionId,962 rmrk_nft_id: RmrkNftId,963 resource_id: RmrkResourceId,964 ) -> DispatchResult {965 let sender = ensure_signed(origin)?;966 let cross_sender = T::CrossAccountId::from_sub(sender);967968 let collection_id = Self::unique_collection_id(rmrk_collection_id)969 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;970 let collection =971 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;972 collection.check_is_external()?;973974 let nft_id = rmrk_nft_id.into();975976 let budget = budget::Value::new(NESTING_BUDGET);977978 let nft_owner =979 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)980 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;981982 Self::try_mutate_resource_info(collection_id, nft_id, resource_id, |res| {983 ensure!(res.pending, <Error<T>>::ResourceNotPending);984 ensure!(cross_sender == nft_owner, <Error<T>>::NoPermission);985986 res.pending = false;987988 Ok(())989 })?;990991 Self::deposit_event(Event::<T>::ResourceAccepted {992 nft_id: rmrk_nft_id,993 resource_id,994 });995996 Ok(())997 }998999 /// Accept the removal of a removal-pending resource from an NFT.1000 ///1001 /// This transaction is needed when a non-owner, i.e. the collection issuer,1002 /// requests a [removal](`crate::pallet::Call::remove_resource`) of a resource from an NFT.1003 ///1004 /// # Permissions:1005 /// - Token owner1006 ///1007 /// # Arguments:1008 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1009 /// - `rmrk_nft_id`: ID of the NFT with a resource to be removed.1010 /// - `resource_id`: ID of the removal-pending resource.1011 #[transactional]1012 #[pallet::weight(<SelfWeightOf<T>>::accept_resource_removal())]1013 pub fn accept_resource_removal(1014 origin: OriginFor<T>,1015 rmrk_collection_id: RmrkCollectionId,1016 rmrk_nft_id: RmrkNftId,1017 resource_id: RmrkResourceId,1018 ) -> DispatchResult {1019 let sender = ensure_signed(origin)?;1020 let cross_sender = T::CrossAccountId::from_sub(sender);10211022 let collection_id = Self::unique_collection_id(rmrk_collection_id)1023 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;1024 let collection =1025 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1026 collection.check_is_external()?;10271028 let nft_id = rmrk_nft_id.into();10291030 let budget = budget::Value::new(NESTING_BUDGET);10311032 let nft_owner =1033 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)1034 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;10351036 ensure!(cross_sender == nft_owner, <Error<T>>::NoPermission);10371038 let resource_id_key = Self::get_scoped_property_key(ResourceId(resource_id))?;10391040 let resource_info = <PalletNft<T>>::token_aux_property((1041 collection_id,1042 nft_id,1043 RMRK_SCOPE,1044 resource_id_key.clone(),1045 ))1046 .ok_or(<Error<T>>::ResourceDoesntExist)?;10471048 let resource_info: RmrkResourceInfo = Self::decode_property_value(&resource_info)?;10491050 ensure!(1051 resource_info.pending_removal,1052 <Error<T>>::ResourceNotPending1053 );10541055 <PalletNft<T>>::remove_token_aux_property(1056 collection_id,1057 nft_id,1058 RMRK_SCOPE,1059 resource_id_key,1060 );10611062 if let RmrkResourceTypes::Composable(resource) = resource_info.resource {1063 let base_id = resource.base;10641065 Self::remove_associated_base_id(collection_id, nft_id, base_id)?;1066 }10671068 Self::deposit_event(Event::<T>::ResourceRemovalAccepted {1069 nft_id: rmrk_nft_id,1070 resource_id,1071 });10721073 Ok(())1074 }10751076 /// Add or edit a custom user property, a key-value pair, describing the metadata1077 /// of a token or a collection, on either one of these.1078 ///1079 /// Note that in this proxy implementation many details regarding RMRK are stored1080 /// as scoped properties prefixed with "rmrk:", normally inaccessible1081 /// to external transactions and RPCs.1082 ///1083 /// # Permissions:1084 /// - Collection issuer - in case of collection property1085 /// - Token owner - in case of NFT property1086 ///1087 /// # Arguments:1088 /// - `rmrk_collection_id`: RMRK collection ID.1089 /// - `maybe_nft_id`: Optional ID of the NFT. If left empty, then the property is set for the collection.1090 /// - `key`: Key of the custom property to be referenced by.1091 /// - `value`: Value of the custom property to be stored.1092 #[transactional]1093 #[pallet::weight(<SelfWeightOf<T>>::set_property())]1094 pub fn set_property(1095 origin: OriginFor<T>,1096 #[pallet::compact] rmrk_collection_id: RmrkCollectionId,1097 maybe_nft_id: Option<RmrkNftId>,1098 key: RmrkKeyString,1099 value: RmrkValueString,1100 ) -> DispatchResult {1101 let sender = ensure_signed(origin)?;1102 let sender = T::CrossAccountId::from_sub(sender);11031104 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1105 let collection =1106 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1107 collection.check_is_external()?;11081109 let budget = budget::Value::new(NESTING_BUDGET);11101111 match maybe_nft_id {1112 Some(nft_id) => {1113 let token_id: TokenId = nft_id.into();11141115 Self::ensure_nft_type(collection_id, token_id, NftType::Regular)?;1116 Self::ensure_nft_owner(collection_id, token_id, &sender, &budget)?;11171118 <PalletNft<T>>::set_scoped_token_property(1119 collection_id,1120 token_id,1121 RMRK_SCOPE,1122 Self::encode_rmrk_property(UserProperty(key.as_slice()), &value)?,1123 )?;1124 }1125 None => {1126 let collection = Self::get_typed_nft_collection(1127 collection_id,1128 misc::CollectionType::Regular,1129 )?;11301131 Self::check_collection_owner(&collection, &sender)?;11321133 <PalletCommon<T>>::set_scoped_collection_property(1134 collection_id,1135 RMRK_SCOPE,1136 Self::encode_rmrk_property(UserProperty(key.as_slice()), &value)?,1137 )?;1138 }1139 }11401141 Self::deposit_event(Event::PropertySet {1142 collection_id: rmrk_collection_id,1143 maybe_nft_id,1144 key,1145 value,1146 });11471148 Ok(())1149 }11501151 /// Set a different order of resource priorities for an NFT. Priorities can be used,1152 /// for example, for order of rendering.1153 ///1154 /// Note that the priorities are not updated automatically, and are an empty vector1155 /// by default. There is no pre-set definition for the order to be particular,1156 /// it can be interpreted arbitrarily use-case by use-case.1157 ///1158 /// # Permissions:1159 /// - Token owner1160 ///1161 /// # Arguments:1162 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1163 /// - `rmrk_nft_id`: ID of the NFT to rearrange resource priorities for.1164 /// - `priorities`: Ordered vector of resource IDs.1165 #[transactional]1166 #[pallet::weight(<SelfWeightOf<T>>::set_priority())]1167 pub fn set_priority(1168 origin: OriginFor<T>,1169 rmrk_collection_id: RmrkCollectionId,1170 rmrk_nft_id: RmrkNftId,1171 priorities: BoundedVec<RmrkResourceId, RmrkMaxPriorities>,1172 ) -> DispatchResult {1173 let sender = ensure_signed(origin)?;1174 let sender = T::CrossAccountId::from_sub(sender);11751176 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1177 let nft_id = rmrk_nft_id.into();11781179 let collection =1180 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1181 collection.check_is_external()?;11821183 let budget = budget::Value::new(NESTING_BUDGET);11841185 Self::ensure_nft_type(collection_id, nft_id, NftType::Regular)?;1186 Self::ensure_nft_owner(collection_id, nft_id, &sender, &budget)?;11871188 <PalletNft<T>>::set_scoped_token_property(1189 collection_id,1190 nft_id,1191 RMRK_SCOPE,1192 Self::encode_rmrk_property(ResourcePriorities, &priorities.into_inner())?,1193 )?;11941195 Self::deposit_event(Event::<T>::PrioritySet {1196 collection_id: rmrk_collection_id,1197 nft_id: rmrk_nft_id,1198 });11991200 Ok(())1201 }12021203 /// Create and set/propose a basic resource for an NFT.1204 ///1205 /// A basic resource is the simplest, lacking a Base and anything that comes with it.1206 /// See RMRK docs for more information and examples.1207 ///1208 /// # Permissions:1209 /// - Collection issuer - if not the token owner, adding the resource will warrant1210 /// the owner's [acceptance](crate::pallet::Call::accept_resource).1211 ///1212 /// # Arguments:1213 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1214 /// - `nft_id`: ID of the NFT to assign a resource to.1215 /// - `resource`: Data of the resource to be created.1216 #[transactional]1217 #[pallet::weight(<SelfWeightOf<T>>::add_basic_resource())]1218 pub fn add_basic_resource(1219 origin: OriginFor<T>,1220 rmrk_collection_id: RmrkCollectionId,1221 nft_id: RmrkNftId,1222 resource: RmrkBasicResource,1223 ) -> DispatchResult {1224 let sender = ensure_signed(origin.clone())?;12251226 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1227 let collection =1228 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1229 collection.check_is_external()?;12301231 let resource_id = Self::resource_add(1232 sender,1233 collection_id,1234 nft_id.into(),1235 RmrkResourceTypes::Basic(resource),1236 )?;12371238 Self::deposit_event(Event::ResourceAdded {1239 nft_id,1240 resource_id,1241 });1242 Ok(())1243 }12441245 /// Create and set/propose a composable resource for an NFT.1246 ///1247 /// A composable resource links to a Base and has a subset of its Parts it is composed of.1248 /// See RMRK docs for more information and examples.1249 ///1250 /// # Permissions:1251 /// - Collection issuer - if not the token owner, adding the resource will warrant1252 /// the owner's [acceptance](crate::pallet::Call::accept_resource).1253 ///1254 /// # Arguments:1255 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1256 /// - `nft_id`: ID of the NFT to assign a resource to.1257 /// - `resource`: Data of the resource to be created.1258 #[transactional]1259 #[pallet::weight(<SelfWeightOf<T>>::add_composable_resource())]1260 pub fn add_composable_resource(1261 origin: OriginFor<T>,1262 rmrk_collection_id: RmrkCollectionId,1263 nft_id: RmrkNftId,1264 resource: RmrkComposableResource,1265 ) -> DispatchResult {1266 let sender = ensure_signed(origin.clone())?;12671268 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1269 let collection =1270 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1271 collection.check_is_external()?;12721273 let base_id = resource.base;12741275 let resource_id = Self::resource_add(1276 sender,1277 collection_id,1278 nft_id.into(),1279 RmrkResourceTypes::Composable(resource),1280 )?;12811282 <PalletNft<T>>::try_mutate_token_aux_property(1283 collection_id,1284 nft_id.into(),1285 RMRK_SCOPE,1286 Self::get_scoped_property_key(AssociatedBases)?,1287 |value| -> DispatchResult {1288 let mut bases: BasesMap = match value {1289 Some(value) => Self::decode_property_value(value)?,1290 None => BasesMap::new(),1291 };12921293 *bases.entry(base_id).or_insert(0) += 1;12941295 *value = Some(Self::encode_property_value(&bases)?);1296 Ok(())1297 },1298 )?;12991300 Self::deposit_event(Event::ResourceAdded {1301 nft_id,1302 resource_id,1303 });1304 Ok(())1305 }13061307 /// Create and set/propose a slot resource for an NFT.1308 ///1309 /// A slot resource links to a Base and a slot ID in it which it can fit into.1310 /// See RMRK docs for more information and examples.1311 ///1312 /// # Permissions:1313 /// - Collection issuer - if not the token owner, adding the resource will warrant1314 /// the owner's [acceptance](crate::pallet::Call::accept_resource).1315 ///1316 /// # Arguments:1317 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1318 /// - `nft_id`: ID of the NFT to assign a resource to.1319 /// - `resource`: Data of the resource to be created.1320 #[transactional]1321 #[pallet::weight(<SelfWeightOf<T>>::add_slot_resource())]1322 pub fn add_slot_resource(1323 origin: OriginFor<T>,1324 rmrk_collection_id: RmrkCollectionId,1325 nft_id: RmrkNftId,1326 resource: RmrkSlotResource,1327 ) -> DispatchResult {1328 let sender = ensure_signed(origin.clone())?;13291330 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1331 let collection =1332 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1333 collection.check_is_external()?;13341335 let resource_id = Self::resource_add(1336 sender,1337 collection_id,1338 nft_id.into(),1339 RmrkResourceTypes::Slot(resource),1340 )?;13411342 Self::deposit_event(Event::ResourceAdded {1343 nft_id,1344 resource_id,1345 });1346 Ok(())1347 }13481349 /// Remove and erase a resource from an NFT.1350 ///1351 /// If the sender does not own the NFT, then it will be pending confirmation,1352 /// and will have to be [accepted](crate::pallet::Call::accept_resource_removal) by the token owner.1353 ///1354 /// # Permissions1355 /// - Collection issuer1356 ///1357 /// # Arguments1358 /// - `collection_id`: RMRK ID of a collection to which the NFT making use of the resource belongs to.1359 /// - `nft_id`: ID of the NFT with a resource to be removed.1360 /// - `resource_id`: ID of the resource to be removed.1361 #[transactional]1362 #[pallet::weight(<SelfWeightOf<T>>::remove_resource())]1363 pub fn remove_resource(1364 origin: OriginFor<T>,1365 rmrk_collection_id: RmrkCollectionId,1366 nft_id: RmrkNftId,1367 resource_id: RmrkResourceId,1368 ) -> DispatchResult {1369 let sender = ensure_signed(origin.clone())?;13701371 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1372 let collection =1373 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1374 collection.check_is_external()?;13751376 Self::resource_remove(sender, collection_id, nft_id.into(), resource_id)?;13771378 Self::deposit_event(Event::ResourceRemoval {1379 nft_id,1380 resource_id,1381 });1382 Ok(())1383 }1384 }1385}13861387impl<T: Config> Pallet<T> {1388 /// Transform one of possible RMRK keys into a byte key with a RMRK scope.1389 pub fn get_scoped_property_key(rmrk_key: RmrkProperty) -> Result<PropertyKey, DispatchError> {1390 let key = rmrk_key.to_key::<T>()?;13911392 let scoped_key = RMRK_SCOPE1393 .apply(key)1394 .map_err(|_| <Error<T>>::RmrkPropertyKeyIsTooLong)?;13951396 Ok(scoped_key)1397 }13981399 /// Form a Unique property, transforming a RMRK key into bytes (without assigning the scope yet)1400 /// and encoding the value from an arbitrary type into bytes.1401 pub fn encode_rmrk_property<E: Encode>(1402 rmrk_key: RmrkProperty,1403 value: &E,1404 ) -> Result<Property, DispatchError> {1405 let key = rmrk_key.to_key::<T>()?;14061407 let value = Self::encode_property_value(value)?;14081409 let property = Property { key, value };14101411 Ok(property)1412 }14131414 /// Encode property value from an arbitrary type into bytes for storage.1415 pub fn encode_property_value<E: Encode, S: Get<u32>>(1416 value: &E,1417 ) -> Result<BoundedBytes<S>, DispatchError> {1418 let value = value1419 .encode()1420 .try_into()1421 .map_err(|_| <Error<T>>::RmrkPropertyValueIsTooLong)?;14221423 Ok(value)1424 }14251426 /// Decode property value from bytes into an arbitrary type.1427 pub fn decode_property_value<D: Decode, S: Get<u32>>(1428 vec: &BoundedBytes<S>,1429 ) -> Result<D, DispatchError> {1430 vec.decode()1431 .map_err(|_| <Error<T>>::UnableToDecodeRmrkData.into())1432 }14331434 /// Change the limit of a property value byte vector.1435 pub fn rebind<L, S>(vec: &BoundedVec<u8, L>) -> Result<BoundedVec<u8, S>, DispatchError>1436 where1437 BoundedVec<u8, S>: TryFrom<Vec<u8>>,1438 {1439 vec.rebind()1440 .map_err(|_| <Error<T>>::RmrkPropertyValueIsTooLong.into())1441 }14421443 /// Initialize a new NFT collection with certain RMRK-scoped properties.1444 ///1445 /// See [`init_collection`](pallet_nonfungible::pallet::Pallet::init_collection) for more details.1446 fn init_collection(1447 sender: T::CrossAccountId,1448 data: CreateCollectionData<T::AccountId>,1449 properties: impl Iterator<Item = Property>,1450 ) -> Result<CollectionId, DispatchError> {1451 let collection_id = <PalletNft<T>>::init_collection(sender, data, true);14521453 if let Err(DispatchError::Arithmetic(_)) = &collection_id {1454 return Err(<Error<T>>::NoAvailableCollectionId.into());1455 }14561457 <PalletCommon<T>>::set_scoped_collection_properties(1458 collection_id?,1459 RMRK_SCOPE,1460 properties,1461 )?;14621463 collection_id1464 }14651466 /// Mint a new NFT with certain RMRK-scoped properties. Sender must be the collection owner.1467 ///1468 /// See [`create_item`](pallet_nonfungible::pallet::Pallet::create_item) for more details.1469 pub fn create_nft(1470 sender: &T::CrossAccountId,1471 owner: &T::CrossAccountId,1472 collection: &NonfungibleHandle<T>,1473 properties: impl Iterator<Item = Property>,1474 ) -> Result<TokenId, DispatchError> {1475 let data = CreateNftExData {1476 properties: BoundedVec::default(),1477 owner: owner.clone(),1478 };14791480 let budget = budget::Value::new(NESTING_BUDGET);14811482 <PalletNft<T>>::create_item(collection, sender, data, &budget)?;14831484 let nft_id = <PalletNft<T>>::current_token_id(collection.id);14851486 <PalletNft<T>>::set_scoped_token_properties(collection.id, nft_id, RMRK_SCOPE, properties)?;14871488 Ok(nft_id)1489 }14901491 /// Burn an NFT, along with its nested children, limited by `max_burns`. The sender must be the token owner.1492 ///1493 /// See [`burn_recursively`](pallet_nonfungible::pallet::Pallet::burn_recursively) for more details.1494 fn destroy_nft(1495 sender: T::CrossAccountId,1496 collection_id: CollectionId,1497 token_id: TokenId,1498 max_burns: u32,1499 error_if_not_owned: Error<T>,1500 ) -> DispatchResultWithPostInfo {1501 let collection =1502 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;15031504 let token_data =1505 <TokenData<T>>::get((collection_id, token_id)).ok_or(<Error<T>>::NoAvailableNftId)?;15061507 let from = token_data.owner;15081509 let owner_check_budget = budget::Value::new(NESTING_BUDGET);15101511 ensure!(1512 <PalletStructure<T>>::check_indirectly_owned(1513 sender.clone(),1514 collection_id,1515 token_id,1516 None,1517 &owner_check_budget1518 )?,1519 error_if_not_owned,1520 );15211522 let burns_budget = budget::Value::new(max_burns);1523 let breadth_budget = budget::Value::new(max_burns);15241525 <PalletNft<T>>::burn_recursively(1526 &collection,1527 &from,1528 token_id,1529 &burns_budget,1530 &breadth_budget,1531 )1532 }15331534 /// Add a sent token pending acceptance to the target owning token as a property.1535 fn insert_pending_child(1536 target: (CollectionId, TokenId),1537 child: (RmrkCollectionId, RmrkNftId),1538 ) -> DispatchResult {1539 Self::mutate_pending_children(target, |pending_children| {1540 pending_children.insert(child);1541 })1542 }15431544 /// Remove a sent token pending acceptance from the target token's properties.1545 fn remove_pending_child(1546 target: (CollectionId, TokenId),1547 child: (RmrkCollectionId, RmrkNftId),1548 ) -> DispatchResult {1549 Self::mutate_pending_children(target, |pending_children| {1550 pending_children.remove(&child);1551 })1552 }15531554 /// Apply a mutation to the property of a token containing sent tokens1555 /// that are currently pending acceptance.1556 fn mutate_pending_children(1557 (target_collection_id, target_nft_id): (CollectionId, TokenId),1558 f: impl FnOnce(&mut PendingChildrenSet),1559 ) -> DispatchResult {1560 <PalletNft<T>>::try_mutate_token_aux_property(1561 target_collection_id,1562 target_nft_id,1563 RMRK_SCOPE,1564 Self::get_scoped_property_key(PendingChildren)?,1565 |pending_children| -> DispatchResult {1566 let mut map = match pending_children {1567 Some(map) => Self::decode_property_value(map)?,1568 None => PendingChildrenSet::new(),1569 };15701571 f(&mut map);15721573 *pending_children = Some(Self::encode_property_value(&map)?);15741575 Ok(())1576 },1577 )1578 }15791580 /// Get an iterator from a token's property containing tokens sent to it1581 /// that are currently pending acceptance.1582 fn iterate_pending_children(1583 collection_id: CollectionId,1584 nft_id: TokenId,1585 ) -> Result<impl Iterator<Item = PendingChild>, DispatchError> {1586 let property = <PalletNft<T>>::token_aux_property((1587 collection_id,1588 nft_id,1589 RMRK_SCOPE,1590 Self::get_scoped_property_key(PendingChildren)?,1591 ));15921593 let pending_children = match property {1594 Some(map) => Self::decode_property_value(&map)?,1595 None => PendingChildrenSet::new(),1596 };15971598 Ok(pending_children.into_iter())1599 }16001601 /// Get incremented resource ID from within an NFT's properties and store the new latest ID.1602 /// Thus, the returned resource ID should be used.1603 /// 1604 /// Resource IDs are unique only across an NFT.1605 fn acquire_next_resource_id(1606 collection_id: CollectionId,1607 nft_id: TokenId,1608 ) -> Result<RmrkResourceId, DispatchError> {1609 let resource_id: RmrkResourceId =1610 Self::get_nft_property_decoded(collection_id, nft_id, NextResourceId)?;16111612 let next_id = resource_id1613 .checked_add(1)1614 .ok_or(<Error<T>>::NoAvailableResourceId)?;16151616 <PalletNft<T>>::set_scoped_token_property(1617 collection_id,1618 nft_id,1619 RMRK_SCOPE,1620 Self::encode_rmrk_property(NextResourceId, &next_id)?,1621 )?;16221623 Ok(resource_id)1624 }16251626 /// Create and add a resource for a regular NFT, mark it as pending if the sender1627 /// is not the token owner. The sender must be the collection owner.1628 fn resource_add(1629 sender: T::AccountId,1630 collection_id: CollectionId,1631 nft_id: TokenId,1632 resource: RmrkResourceTypes,1633 ) -> Result<RmrkResourceId, DispatchError> {1634 let collection =1635 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1636 ensure!(collection.owner == sender, Error::<T>::NoPermission);16371638 let sender = T::CrossAccountId::from_sub(sender);1639 let budget = budget::Value::new(NESTING_BUDGET);16401641 let nft_owner = <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)1642 .map_err(Self::map_unique_err_to_proxy)?;16431644 let pending = sender != nft_owner;16451646 let id = Self::acquire_next_resource_id(collection_id, nft_id)?;16471648 let resource_info = RmrkResourceInfo {1649 id,1650 resource,1651 pending,1652 pending_removal: false,1653 };16541655 <PalletNft<T>>::try_mutate_token_aux_property(1656 collection_id,1657 nft_id,1658 RMRK_SCOPE,1659 Self::get_scoped_property_key(ResourceId(id))?,1660 |value| -> DispatchResult {1661 *value = Some(Self::encode_property_value(&resource_info)?);16621663 Ok(())1664 },1665 )?;16661667 Ok(id)1668 }16691670 /// Designate a resource for erasure from an NFT, and remove it if the sender is the token owner.1671 /// The sender must be the collection owner.1672 fn resource_remove(1673 sender: T::AccountId,1674 collection_id: CollectionId,1675 nft_id: TokenId,1676 resource_id: RmrkResourceId,1677 ) -> DispatchResult {1678 let collection =1679 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1680 ensure!(collection.owner == sender, Error::<T>::NoPermission);16811682 let resource_id_key = Self::get_scoped_property_key(ResourceId(resource_id))?;16831684 let resource = <PalletNft<T>>::token_aux_property((1685 collection_id,1686 nft_id,1687 RMRK_SCOPE,1688 resource_id_key.clone(),1689 ))1690 .ok_or(<Error<T>>::ResourceDoesntExist)?;16911692 let resource_info: RmrkResourceInfo = Self::decode_property_value(&resource)?;16931694 let budget = up_data_structs::budget::Value::new(NESTING_BUDGET);1695 let topmost_owner =1696 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)?;16971698 let sender = T::CrossAccountId::from_sub(sender);1699 if topmost_owner == sender {1700 <PalletNft<T>>::remove_token_aux_property(1701 collection_id,1702 nft_id,1703 RMRK_SCOPE,1704 Self::get_scoped_property_key(ResourceId(resource_id))?,1705 );17061707 if let RmrkResourceTypes::Composable(resource) = resource_info.resource {1708 let base_id = resource.base;17091710 Self::remove_associated_base_id(collection_id, nft_id, base_id)?;1711 }1712 } else {1713 Self::try_mutate_resource_info(collection_id, nft_id, resource_id, |res| {1714 res.pending_removal = true;17151716 Ok(())1717 })?;1718 }17191720 Ok(())1721 }17221723 /// Remove a Base ID from an NFT if they are associated. 1724 /// The Base itself is deleted if the number of associated NFTs reaches 0.1725 fn remove_associated_base_id(1726 collection_id: CollectionId,1727 nft_id: TokenId,1728 base_id: RmrkBaseId,1729 ) -> DispatchResult {1730 <PalletNft<T>>::try_mutate_token_aux_property(1731 collection_id,1732 nft_id,1733 RMRK_SCOPE,1734 Self::get_scoped_property_key(AssociatedBases)?,1735 |value| -> DispatchResult {1736 let mut bases: BasesMap = match value {1737 Some(value) => Self::decode_property_value(value)?,1738 None => BasesMap::new(),1739 };17401741 let remaining = bases.get(&base_id);17421743 if let Some(remaining) = remaining {1744 if let Some(0) | None = remaining.checked_sub(1) {1745 bases.remove(&base_id);1746 }1747 }17481749 *value = Some(Self::encode_property_value(&bases)?);1750 Ok(())1751 },1752 )1753 }17541755 /// Apply a mutation to a resource stored in the token properties of an NFT.1756 fn try_mutate_resource_info(1757 collection_id: CollectionId,1758 nft_id: TokenId,1759 resource_id: RmrkResourceId,1760 f: impl FnOnce(&mut RmrkResourceInfo) -> DispatchResult,1761 ) -> DispatchResult {1762 <PalletNft<T>>::try_mutate_token_aux_property(1763 collection_id,1764 nft_id,1765 RMRK_SCOPE,1766 Self::get_scoped_property_key(ResourceId(resource_id))?,1767 |value| match value {1768 Some(value) => {1769 let mut resource_info: RmrkResourceInfo = Self::decode_property_value(value)?;17701771 f(&mut resource_info)?;17721773 *value = Self::encode_property_value(&resource_info)?;17741775 Ok(())1776 }1777 None => Err(<Error<T>>::ResourceDoesntExist.into()),1778 },1779 )1780 }17811782 /// Change the owner of an NFT collection, ensuring that the sender is the current owner.1783 fn change_collection_owner(1784 collection_id: CollectionId,1785 collection_type: misc::CollectionType,1786 sender: T::AccountId,1787 new_owner: T::AccountId,1788 ) -> DispatchResult {1789 let collection = Self::get_typed_nft_collection(collection_id, collection_type)?;1790 Self::check_collection_owner(&collection, &T::CrossAccountId::from_sub(sender))?;17911792 let mut collection = collection.into_inner();17931794 collection.owner = new_owner;1795 collection.save()1796 }17971798 /// Ensure that an account is the collection owner/issuer, return an error if not.1799 pub fn check_collection_owner(1800 collection: &NonfungibleHandle<T>,1801 account: &T::CrossAccountId,1802 ) -> DispatchResult {1803 collection1804 .check_is_owner(account)1805 .map_err(Self::map_unique_err_to_proxy)1806 }18071808 /// Get the latest yet-unused RMRK collection index from the storage.1809 pub fn last_collection_idx() -> RmrkCollectionId {1810 <CollectionIndex<T>>::get()1811 }18121813 /// Get a mapping from a RMRK collection ID to its corresponding Unique collection ID.1814 pub fn unique_collection_id(1815 rmrk_collection_id: RmrkCollectionId,1816 ) -> Result<CollectionId, DispatchError> {1817 <UniqueCollectionId<T>>::try_get(rmrk_collection_id)1818 .map_err(|_| <Error<T>>::CollectionUnknown.into())1819 }18201821 /// Get a mapping from a Unique collection ID to its RMRK collection ID counterpart, if it exists.1822 pub fn rmrk_collection_id(1823 unique_collection_id: CollectionId,1824 ) -> Result<RmrkCollectionId, DispatchError> {1825 Self::get_collection_property_decoded(unique_collection_id, RmrkInternalCollectionId)1826 }18271828 /// Fetch a Unique NFT collection.1829 pub fn get_nft_collection(1830 collection_id: CollectionId,1831 ) -> Result<NonfungibleHandle<T>, DispatchError> {1832 let collection = <CollectionHandle<T>>::try_get(collection_id)1833 .map_err(|_| <Error<T>>::CollectionUnknown)?;18341835 match collection.mode {1836 CollectionMode::NFT => Ok(NonfungibleHandle::cast(collection)),1837 _ => Err(<Error<T>>::CollectionUnknown.into()),1838 }1839 }18401841 /// Check if an NFT collection with such an ID exists.1842 pub fn collection_exists(collection_id: CollectionId) -> bool {1843 <CollectionHandle<T>>::try_get(collection_id).is_ok()1844 }18451846 /// Fetch and decode a RMRK-scoped collection property value in bytes.1847 pub fn get_collection_property(1848 collection_id: CollectionId,1849 key: RmrkProperty,1850 ) -> Result<PropertyValue, DispatchError> {1851 let collection_property = <PalletCommon<T>>::collection_properties(collection_id)1852 .get(&Self::get_scoped_property_key(key)?)1853 .ok_or(<Error<T>>::CollectionUnknown)?1854 .clone();18551856 Ok(collection_property)1857 }18581859 /// Fetch a RMRK-scoped collection property and decode it from bytes into an appropriate type.1860 pub fn get_collection_property_decoded<V: Decode>(1861 collection_id: CollectionId,1862 key: RmrkProperty,1863 ) -> Result<V, DispatchError> {1864 Self::decode_property_value(&Self::get_collection_property(collection_id, key)?)1865 }18661867 /// Get the type of a collection stored as a scoped property.1868 ///1869 /// RMRK Core proxy differentiates between regular collections as well as RMRK Bases as collections.1870 pub fn get_collection_type(1871 collection_id: CollectionId,1872 ) -> Result<misc::CollectionType, DispatchError> {1873 Self::get_collection_property_decoded(collection_id, CollectionType).map_err(|err| {1874 if err != <Error<T>>::CollectionUnknown.into() {1875 <Error<T>>::CorruptedCollectionType.into()1876 } else {1877 err1878 }1879 })1880 }18811882 /// Ensure that the type of the collection equals the provided type,1883 /// otherwise return an error.1884 pub fn ensure_collection_type(1885 collection_id: CollectionId,1886 collection_type: misc::CollectionType,1887 ) -> DispatchResult {1888 let actual_type = Self::get_collection_type(collection_id)?;1889 ensure!(1890 actual_type == collection_type,1891 <CommonError<T>>::NoPermission1892 );18931894 Ok(())1895 }18961897 /// Fetch an NFT collection, but make sure it has the appropriate type.1898 pub fn get_typed_nft_collection(1899 collection_id: CollectionId,1900 collection_type: misc::CollectionType,1901 ) -> Result<NonfungibleHandle<T>, DispatchError> {1902 Self::ensure_collection_type(collection_id, collection_type)?;19031904 Self::get_nft_collection(collection_id)1905 }19061907 /// Same as [`get_typed_nft_collection`](crate::pallet::Pallet::get_typed_nft_collection),1908 /// but also return the Unique collection ID.1909 pub fn get_typed_nft_collection_mapped(1910 rmrk_collection_id: RmrkCollectionId,1911 collection_type: misc::CollectionType,1912 ) -> Result<(NonfungibleHandle<T>, CollectionId), DispatchError> {1913 let unique_collection_id = match collection_type {1914 misc::CollectionType::Regular => Self::unique_collection_id(rmrk_collection_id)?,1915 _ => rmrk_collection_id.into(),1916 };19171918 let collection = Self::get_typed_nft_collection(unique_collection_id, collection_type)?;19191920 Ok((collection, unique_collection_id))1921 }19221923 /// Fetch and decode a RMRK-scoped NFT property value in bytes.1924 pub fn get_nft_property(1925 collection_id: CollectionId,1926 nft_id: TokenId,1927 key: RmrkProperty,1928 ) -> Result<PropertyValue, DispatchError> {1929 let nft_property = <PalletNft<T>>::token_properties((collection_id, nft_id))1930 .get(&Self::get_scoped_property_key(key)?)1931 .ok_or(<Error<T>>::RmrkPropertyIsNotFound)?1932 .clone();19331934 Ok(nft_property)1935 }19361937 /// Fetch a RMRK-scoped NFT property and decode it from bytes into an appropriate type.1938 pub fn get_nft_property_decoded<V: Decode>(1939 collection_id: CollectionId,1940 nft_id: TokenId,1941 key: RmrkProperty,1942 ) -> Result<V, DispatchError> {1943 Self::decode_property_value(&Self::get_nft_property(collection_id, nft_id, key)?)1944 }19451946 /// Check that an NFT exists.1947 pub fn nft_exists(collection_id: CollectionId, nft_id: TokenId) -> bool {1948 <TokenData<T>>::contains_key((collection_id, nft_id))1949 }19501951 /// Get the type of an NFT stored as a scoped property.1952 ///1953 /// RMRK Core proxy differentiates between regular NFTs, and RMRK Parts and Themes.1954 pub fn get_nft_type(1955 collection_id: CollectionId,1956 token_id: TokenId,1957 ) -> Result<NftType, DispatchError> {1958 Self::get_nft_property_decoded(collection_id, token_id, TokenType)1959 .map_err(|_| <Error<T>>::NoAvailableNftId.into())1960 }19611962 /// Ensure that the type of the NFT equals the provided type, otherwise return an error.1963 pub fn ensure_nft_type(1964 collection_id: CollectionId,1965 token_id: TokenId,1966 nft_type: NftType,1967 ) -> DispatchResult {1968 let actual_type = Self::get_nft_type(collection_id, token_id)?;1969 ensure!(actual_type == nft_type, <Error<T>>::NoPermission);19701971 Ok(())1972 }19731974 /// Ensure that an account is the owner of the token, either directly1975 /// or at the top of the nesting hierarchy; return an error if it is not.1976 pub fn ensure_nft_owner(1977 collection_id: CollectionId,1978 token_id: TokenId,1979 possible_owner: &T::CrossAccountId,1980 nesting_budget: &dyn budget::Budget,1981 ) -> DispatchResult {1982 let is_owned = <PalletStructure<T>>::check_indirectly_owned(1983 possible_owner.clone(),1984 collection_id,1985 token_id,1986 None,1987 nesting_budget,1988 )1989 .map_err(Self::map_unique_err_to_proxy)?;19901991 ensure!(is_owned, <Error<T>>::NoPermission);19921993 Ok(())1994 }19951996 /// Fetch non-scoped properties of a collection or a token that match the filter keys supplied,1997 /// or, if None are provided, return all non-scoped properties.1998 pub fn filter_user_properties<Key, Value, R, Mapper>(1999 collection_id: CollectionId,2000 token_id: Option<TokenId>,2001 filter_keys: Option<Vec<RmrkPropertyKey>>,2002 mapper: Mapper,2003 ) -> Result<Vec<R>, DispatchError>2004 where2005 Key: TryFrom<RmrkPropertyKey> + AsRef<[u8]>,2006 Value: Decode + Default,2007 Mapper: Fn(Key, Value) -> R,2008 {2009 filter_keys2010 .map(|keys| {2011 let properties = keys2012 .into_iter()2013 .filter_map(|key| {2014 let key: Key = key.try_into().ok()?;20152016 let value = match token_id {2017 Some(token_id) => Self::get_nft_property_decoded(2018 collection_id,2019 token_id,2020 UserProperty(key.as_ref()),2021 ),2022 None => Self::get_collection_property_decoded(2023 collection_id,2024 UserProperty(key.as_ref()),2025 ),2026 }2027 .ok()?;20282029 Some(mapper(key, value))2030 })2031 .collect();20322033 Ok(properties)2034 })2035 .unwrap_or_else(|| {2036 let properties =2037 Self::iterate_user_properties(collection_id, token_id, mapper)?.collect();20382039 Ok(properties)2040 })2041 }20422043 /// Get all non-scoped properties from a collection or a token, and apply some transformation,2044 /// supplied by `mapper`, to each key-value pair.2045 pub fn iterate_user_properties<Key, Value, R, Mapper>(2046 collection_id: CollectionId,2047 token_id: Option<TokenId>,2048 mapper: Mapper,2049 ) -> Result<impl Iterator<Item = R>, DispatchError>2050 where2051 Key: TryFrom<RmrkPropertyKey> + AsRef<[u8]>,2052 Value: Decode + Default,2053 Mapper: Fn(Key, Value) -> R,2054 {2055 let properties = match token_id {2056 Some(token_id) => <PalletNft<T>>::token_properties((collection_id, token_id)),2057 None => <PalletCommon<T>>::collection_properties(collection_id),2058 };20592060 let properties = properties.into_iter().filter_map(move |(key, value)| {2061 let key = strip_key_prefix(&key, USER_PROPERTY_PREFIX)?;20622063 let key: Key = key.to_vec().try_into().ok()?;2064 let value: Value = value.decode().ok()?;20652066 Some(mapper(key, value))2067 });20682069 Ok(properties)2070 }20712072 /// Match Unique errors to RMRK's own and return the RMRK error if a match is successful.2073 fn map_unique_err_to_proxy(err: DispatchError) -> DispatchError {2074 map_unique_err_to_proxy! {2075 match err {2076 CommonError::NoPermission => NoPermission,2077 CommonError::CollectionTokenLimitExceeded => CollectionFullOrLocked,2078 CommonError::PublicMintingNotAllowed => NoPermission,2079 CommonError::TokenNotFound => NoAvailableNftId,2080 CommonError::ApprovedValueTooLow => NoPermission,2081 CommonError::CantDestroyNotEmptyCollection => CollectionNotEmpty,2082 StructureError::TokenNotFound => NoAvailableNftId,2083 StructureError::OuroborosDetected => CannotSendToDescendentOrSelf,2084 }2085 }2086 }2087}1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// This file is part of Unique Network.34// Unique Network is free software: you can redistribute it and/or modify5// it under the terms of the GNU General Public License as published by6// the Free Software Foundation, either version 3 of the License, or7// (at your option) any later version.89// Unique Network is distributed in the hope that it will be useful,10// but WITHOUT ANY WARRANTY; without even the implied warranty of11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the12// GNU General Public License for more details.1314// You should have received a copy of the GNU General Public License15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.1617//! # RMRK Core Proxy Pallet18//!19//! A pallet used as proxy for RMRK Core (<https://rmrk-team.github.io/rmrk-substrate/#/pallets/rmrk-core>).20//!21//! - [`Config`]22//! - [`Call`]23//! - [`Pallet`]24//!25//! ## Overview26//!27//! The RMRK Core Proxy pallet mirrors the functionality of RMRK Core,28//! binding its externalities to Unique's own underlying structure.29//! It is purposed to mimic RMRK Core exactly, allowing seamless integrations30//! of solutions based on RMRK.31//!32//! RMRK Core itself contains essential functionality for RMRK's nested and33//! multi-resourced NFTs.34//!35//! *Note*, that while RMRK itself is subject to active development and restructuring,36//! the proxy may be caught temporarily out of date.37//!38//! ### What is RMRK?39//!40//! RMRK is a set of NFT standards which compose several "NFT 2.0 lego" primitives.41//! Putting these legos together allows a user to create NFT systems of arbitrary complexity.42//!43//! Meaning, RMRK NFTs are dynamic, able to nest into each other and form a hierarchy,44//! make use of specific changeable and partially shared metadata in the form of resources,45//! and more.46//!47//! Visit RMRK documentation and repositories to learn more:48//! - Docs: <https://docs.rmrk.app/getting-started/>49//! - FAQ: <https://coda.io/@rmrk/faq>50//! - Substrate code repository: <https://github.com/rmrk-team/rmrk-substrate>51//! - RMRK specification repository: <https://github.com/rmrk-team/rmrk-spec>52//!53//! ## Terminology54//!55//! For more information on RMRK, see RMRK's own documentation.56//!57//! ### Intro to RMRK58//!59//! - **Resource:** Additional piece of metadata of an NFT usually serving to add60//! a piece of media on top of the root metadata (NFT's own), be it a different wing61//! on the root template bird or something entirely unrelated.62//!63//! - **Base:** A list of possible "components" - Parts, a combination of which can64//! be appended/equipped to/on an NFT.65//!66//! - **Part:** Something that, together with other Parts, can constitute an NFT.67//! Parts are defined in the Base to which they belong. Parts can be either68//! of the `slot` type or `fixed` type. Slots are intended for equippables.69//! Note that "part of something" and "Part of a Base" can be easily confused,70//! and in this documentation these words are distinguished by the capital letter.71//!72//! - **Theme:** Named objects of variable => value pairs which get interpolated into73//! the Base's `themable` Parts. Themes can hold any value, but are often represented74//! in RMRK's examples as colors applied to visible Parts.75//!76//! ### Peculiarities in Unique77//!78//! - **Scoped properties:** Properties that are normally obscured from users.79//! Their purpose is to contain structured metadata that was not included in the Unique standard80//! for collections and tokens, meant to be operated on by proxies and other outliers.81//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is82//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined83//! properties, which, along with other safeguards, makes them impossible to tamper with.84//!85//! - **Auxiliary properties:** A slightly different structure of properties,86//! trading universality of use for more convenient storage, writes and access.87//! Meant to be inaccessible to end users.88//!89//! ## Proxy Implementation90//!91//! An external user is supposed to be able to utilize this proxy as they would92//! utilize RMRK, and get exactly the same results. Normally, Unique transactions93//! are off-limits to RMRK collections and tokens, and vice versa. However,94//! the information stored on chain can be freely interpreted by storage reads and RPCs.95//!96//! ### ID Mapping97//!98//! RMRK's collections' IDs are counted independently of Unique's and start at 0.99//! Note that tokens' IDs still start at 1.100//! The collections themselves, as well as tokens, are stored as Unique collections,101//! and thus RMRK IDs are mapped to Unique IDs (but not vice versa).102//!103//! ### External/Internal Collection Insulation104//!105//! A Unique transaction cannot target collections purposed for RMRK,106//! and they are flagged as `external` to specify that. On the other hand,107//! due to the mapping, RMRK transactions and RPCs simply cannot reach Unique collections.108//!109//! ### Native Properties110//!111//! Many of RMRK's native parameters are stored as scoped properties of a collection112//! or an NFT on the chain. Scoped properties are prefixed with `rmrk:`, where `:`113//! is an unacceptable symbol in user-defined properties, which, along with other safeguards,114//! makes them impossible to tamper with.115//!116//! ### Collection and NFT Types, and Base, Parts and Themes Handling117//!118//! RMRK introduces the concept of a Base, which is a catalgoue of Parts,119//! possible components of an NFT. Due to its similarity with the functionality120//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes121//! are the collection's NFTs. See [`CollectionType`] and [`NftType`].122//!123//! ## Interface124//!125//! ### Dispatchables126//!127//! - `create_collection` - Create a new collection of NFTs.128//! - `destroy_collection` - Destroy a collection.129//! - `change_collection_issuer` - Change the issuer of a collection.130//! Analogous to Unique's collection's [`owner`](up_data_structs::Collection).131//! - `lock_collection` - "Lock" the collection and prevent new token creation. **Cannot be undone.**132//! - `mint_nft` - Mint an NFT in a specified collection.133//! - `burn_nft` - Burn an NFT, destroying it and its nested tokens.134//! - `send` - Transfer an NFT from an account/NFT A to another account/NFT B.135//! - `accept_nft` - Accept an NFT sent from another account to self or an owned NFT.136//! - `reject_nft` - Reject an NFT sent from another account to self or owned NFT and **burn it**.137//! - `accept_resource` - Accept the addition of a newly created pending resource to an existing NFT.138//! - `accept_resource_removal` - Accept the removal of a removal-pending resource from an NFT.139//! - `set_property` - Add or edit a custom user property of a token or a collection.140//! - `set_priority` - Set a different order of resource priorities for an NFT.141//! - `add_basic_resource` - Create and set/propose a basic resource for an NFT.142//! - `add_composable_resource` - Create and set/propose a composable resource for an NFT.143//! - `add_slot_resource` - Create and set/propose a slot resource for an NFT.144//! - `remove_resource` - Remove and erase a resource from an NFT.145146#![cfg_attr(not(feature = "std"), no_std)]147148use frame_support::{pallet_prelude::*, transactional, BoundedVec, dispatch::DispatchResult};149use frame_system::{pallet_prelude::*, ensure_signed};150use sp_runtime::{DispatchError, Permill, traits::StaticLookup};151use sp_std::{152 vec::Vec,153 collections::{btree_set::BTreeSet, btree_map::BTreeMap},154};155use up_data_structs::{*, mapping::TokenAddressMapping};156use pallet_common::{157 Pallet as PalletCommon, Error as CommonError, CollectionHandle, CommonCollectionOperations,158};159use pallet_nonfungible::{Pallet as PalletNft, NonfungibleHandle, TokenData};160use pallet_structure::{Pallet as PalletStructure, Error as StructureError};161use pallet_evm::account::CrossAccountId;162use core::convert::AsRef;163164pub use pallet::*;165166#[cfg(feature = "runtime-benchmarks")]167pub mod benchmarking;168pub mod misc;169pub mod property;170pub mod rpc;171pub mod weights;172173pub type SelfWeightOf<T> = <T as Config>::WeightInfo;174175use weights::WeightInfo;176use misc::*;177pub use property::*;178179use RmrkProperty::*;180181/// Maximum number of levels of depth in the token nesting tree.182pub const NESTING_BUDGET: u32 = 5;183184type PendingTarget = (CollectionId, TokenId);185type PendingChild = (RmrkCollectionId, RmrkNftId);186type PendingChildrenSet = BTreeSet<PendingChild>;187188type BasesMap = BTreeMap<RmrkBaseId, u32>;189190#[frame_support::pallet]191pub mod pallet {192 use super::*;193 use pallet_evm::account;194195 #[pallet::config]196 pub trait Config:197 frame_system::Config + pallet_common::Config + pallet_nonfungible::Config + account::Config198 {199 /// Overarching event type.200 type Event: From<Event<Self>> + IsType<<Self as frame_system::Config>::Event>;201202 /// The weight information of this pallet.203 type WeightInfo: WeightInfo;204 }205206 /// Latest yet-unused collection ID.207 #[pallet::storage]208 #[pallet::getter(fn collection_index)]209 pub type CollectionIndex<T: Config> = StorageValue<_, RmrkCollectionId, ValueQuery>;210211 /// Mapping from RMRK collection ID to Unique's.212 #[pallet::storage]213 pub type UniqueCollectionId<T: Config> =214 StorageMap<_, Twox64Concat, RmrkCollectionId, CollectionId, ValueQuery>;215216 #[pallet::pallet]217 #[pallet::generate_store(pub(super) trait Store)]218 pub struct Pallet<T>(_);219220 #[pallet::event]221 #[pallet::generate_deposit(pub(super) fn deposit_event)]222 pub enum Event<T: Config> {223 CollectionCreated {224 issuer: T::AccountId,225 collection_id: RmrkCollectionId,226 },227 CollectionDestroyed {228 issuer: T::AccountId,229 collection_id: RmrkCollectionId,230 },231 IssuerChanged {232 old_issuer: T::AccountId,233 new_issuer: T::AccountId,234 collection_id: RmrkCollectionId,235 },236 CollectionLocked {237 issuer: T::AccountId,238 collection_id: RmrkCollectionId,239 },240 NftMinted {241 owner: T::AccountId,242 collection_id: RmrkCollectionId,243 nft_id: RmrkNftId,244 },245 NFTBurned {246 owner: T::AccountId,247 nft_id: RmrkNftId,248 },249 NFTSent {250 sender: T::AccountId,251 recipient: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,252 collection_id: RmrkCollectionId,253 nft_id: RmrkNftId,254 approval_required: bool,255 },256 NFTAccepted {257 sender: T::AccountId,258 recipient: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,259 collection_id: RmrkCollectionId,260 nft_id: RmrkNftId,261 },262 NFTRejected {263 sender: T::AccountId,264 collection_id: RmrkCollectionId,265 nft_id: RmrkNftId,266 },267 PropertySet {268 collection_id: RmrkCollectionId,269 maybe_nft_id: Option<RmrkNftId>,270 key: RmrkKeyString,271 value: RmrkValueString,272 },273 ResourceAdded {274 nft_id: RmrkNftId,275 resource_id: RmrkResourceId,276 },277 ResourceRemoval {278 nft_id: RmrkNftId,279 resource_id: RmrkResourceId,280 },281 ResourceAccepted {282 nft_id: RmrkNftId,283 resource_id: RmrkResourceId,284 },285 ResourceRemovalAccepted {286 nft_id: RmrkNftId,287 resource_id: RmrkResourceId,288 },289 PrioritySet {290 collection_id: RmrkCollectionId,291 nft_id: RmrkNftId,292 },293 }294295 #[pallet::error]296 pub enum Error<T> {297 /* Unique proxy-specific events */298 /// Property of the type of RMRK collection could not be read successfully.299 CorruptedCollectionType,300 // NftTypeEncodeError,301 /// Too many symbols supplied as the property key. The maximum is [256](up_data_structs::MAX_PROPERTY_KEY_LENGTH).302 RmrkPropertyKeyIsTooLong,303 /// Too many bytes supplied as the property value. The maximum is [32768](up_data_structs::MAX_PROPERTY_VALUE_LENGTH).304 RmrkPropertyValueIsTooLong,305 /// Could not find a property by the supplied key.306 RmrkPropertyIsNotFound,307 /// Something went wrong when decoding encoded data from the storage.308 /// Perhaps, there was a wrong key supplied for the type, or the data was improperly stored.309 UnableToDecodeRmrkData,310311 /* RMRK compatible events */312 /// Only destroying collections without tokens is allowed.313 CollectionNotEmpty,314 /// Could not find an ID for a collection. It is likely there were too many collections created on the chain, causing an overflow.315 NoAvailableCollectionId,316 /// Token does not exist, or there is no suitable ID for it, likely too many tokens were created in a collection, causing an overflow.317 NoAvailableNftId,318 /// Collection does not exist, has a wrong type, or does not map to a Unique ID.319 CollectionUnknown,320 /// No permission to perform action.321 NoPermission,322 /// Token is marked as non-transferable, and thus cannot be transferred.323 NonTransferable,324 /// Too many tokens created in the collection, no new ones are allowed.325 CollectionFullOrLocked,326 /// No such resource found.327 ResourceDoesntExist,328 /// If an NFT is sent to a descendant, that would form a nesting loop, an ouroboros.329 /// Sending to self is redundant.330 CannotSendToDescendentOrSelf,331 /// Not the target owner of the sent NFT.332 CannotAcceptNonOwnedNft,333 /// Not the target owner of the sent NFT.334 CannotRejectNonOwnedNft,335 /// NFT was not sent and is not pending.336 CannotRejectNonPendingNft,337 /// Resource is not pending for the operation.338 ResourceNotPending,339 /// Could not find an ID for the resource. It is likely there were too many resources created on an NFT, causing an overflow.340 NoAvailableResourceId,341 }342343 #[pallet::call]344 impl<T: Config> Pallet<T> {345 // todo :refactor replace every collection_id with rmrk_collection_id (and nft_id) in arguments for uniformity?346347 /// Create a new collection of NFTs.348 ///349 /// # Permissions:350 /// * Anyone - will be assigned as the issuer of the collection.351 ///352 /// # Arguments:353 /// - `metadata`: Metadata describing the collection, e.g. IPFS hash. Cannot be changed.354 /// - `max`: Optional maximum number of tokens.355 /// - `symbol`: UTF-8 string with token prefix, by which to represent the token in wallets and UIs.356 /// Analogous to Unique's [`token_prefix`](up_data_structs::Collection). Cannot be changed.357 #[transactional]358 #[pallet::weight(<SelfWeightOf<T>>::create_collection())]359 pub fn create_collection(360 origin: OriginFor<T>,361 metadata: RmrkString,362 max: Option<u32>,363 symbol: RmrkCollectionSymbol,364 ) -> DispatchResult {365 let sender = ensure_signed(origin)?;366367 let limits = CollectionLimits {368 owner_can_transfer: Some(false),369 token_limit: max,370 ..Default::default()371 };372373 let data = CreateCollectionData {374 limits: Some(limits),375 token_prefix: symbol376 .into_inner()377 .try_into()378 .map_err(|_| <CommonError<T>>::CollectionTokenPrefixLimitExceeded)?,379 permissions: Some(CollectionPermissions {380 nesting: Some(NestingPermissions {381 token_owner: true,382 collection_admin: false,383 restricted: None,384 #[cfg(feature = "runtime-benchmarks")]385 permissive: false,386 }),387 ..Default::default()388 }),389 ..Default::default()390 };391392 let unique_collection_id = Self::init_collection(393 T::CrossAccountId::from_sub(sender.clone()),394 data,395 [396 Self::encode_rmrk_property(Metadata, &metadata)?,397 Self::encode_rmrk_property(CollectionType, &misc::CollectionType::Regular)?,398 ]399 .into_iter(),400 )?;401 let rmrk_collection_id = <CollectionIndex<T>>::get();402403 <UniqueCollectionId<T>>::insert(rmrk_collection_id, unique_collection_id);404405 <PalletCommon<T>>::set_scoped_collection_property(406 unique_collection_id,407 RMRK_SCOPE,408 Self::encode_rmrk_property(RmrkInternalCollectionId, &rmrk_collection_id)?,409 )?;410411 <CollectionIndex<T>>::mutate(|n| *n += 1);412413 Self::deposit_event(Event::CollectionCreated {414 issuer: sender,415 collection_id: rmrk_collection_id,416 });417418 Ok(())419 }420421 /// Destroy a collection.422 ///423 /// Only empty collections can be destroyed. If it has any tokens, they must be burned first.424 ///425 /// # Permissions:426 /// * Collection issuer427 ///428 /// # Arguments:429 /// - `collection_id`: RMRK ID of the collection to destroy.430 #[transactional]431 #[pallet::weight(<SelfWeightOf<T>>::destroy_collection())]432 pub fn destroy_collection(433 origin: OriginFor<T>,434 collection_id: RmrkCollectionId,435 ) -> DispatchResult {436 let sender = ensure_signed(origin)?;437 let cross_sender = T::CrossAccountId::from_sub(sender.clone());438439 let collection = Self::get_typed_nft_collection(440 Self::unique_collection_id(collection_id)?,441 misc::CollectionType::Regular,442 )?;443 collection.check_is_external()?;444445 <PalletNft<T>>::destroy_collection(collection, &cross_sender)446 .map_err(Self::map_unique_err_to_proxy)?;447448 Self::deposit_event(Event::CollectionDestroyed {449 issuer: sender,450 collection_id,451 });452453 Ok(())454 }455456 /// Change the issuer of a collection. Analogous to Unique's collection's [`owner`](up_data_structs::Collection).457 ///458 /// # Permissions:459 /// * Collection issuer460 ///461 /// # Arguments:462 /// - `collection_id`: RMRK collection ID to change the issuer of.463 /// - `new_issuer`: Collection's new issuer.464 #[transactional]465 #[pallet::weight(<SelfWeightOf<T>>::change_collection_issuer())]466 pub fn change_collection_issuer(467 origin: OriginFor<T>,468 collection_id: RmrkCollectionId,469 new_issuer: <T::Lookup as StaticLookup>::Source,470 ) -> DispatchResult {471 let sender = ensure_signed(origin)?;472473 let collection = Self::get_nft_collection(Self::unique_collection_id(collection_id)?)?;474 collection.check_is_external()?;475476 let new_issuer = T::Lookup::lookup(new_issuer)?;477478 Self::change_collection_owner(479 Self::unique_collection_id(collection_id)?,480 misc::CollectionType::Regular,481 sender.clone(),482 new_issuer.clone(),483 )?;484485 Self::deposit_event(Event::IssuerChanged {486 old_issuer: sender,487 new_issuer,488 collection_id,489 });490491 Ok(())492 }493494 /// "Lock" the collection and prevent new token creation. Cannot be undone.495 ///496 /// # Permissions:497 /// * Collection issuer498 ///499 /// # Arguments:500 /// - `collection_id`: RMRK ID of the collection to lock.501 #[transactional]502 #[pallet::weight(<SelfWeightOf<T>>::lock_collection())]503 pub fn lock_collection(504 origin: OriginFor<T>,505 collection_id: RmrkCollectionId,506 ) -> DispatchResult {507 let sender = ensure_signed(origin)?;508 let cross_sender = T::CrossAccountId::from_sub(sender.clone());509510 let collection = Self::get_typed_nft_collection(511 Self::unique_collection_id(collection_id)?,512 misc::CollectionType::Regular,513 )?;514 collection.check_is_external()?;515516 Self::check_collection_owner(&collection, &cross_sender)?;517518 let token_count = collection.total_supply();519520 let mut collection = collection.into_inner();521 collection.limits.token_limit = Some(token_count);522 collection.save()?;523524 Self::deposit_event(Event::CollectionLocked {525 issuer: sender,526 collection_id,527 });528529 Ok(())530 }531532 /// Mint an NFT in a specified collection.533 ///534 /// # Permissions:535 /// * Collection issuer536 ///537 /// # Arguments:538 /// - `owner`: Owner account of the NFT. If set to None, defaults to the sender (collection issuer).539 /// - `collection_id`: RMRK collection ID for the NFT to be minted within. Cannot be changed.540 /// - `recipient`: Receiver account of the royalty. Has no effect if the `royalty_amount` is not set. Cannot be changed.541 /// - `royalty_amount`: Optional permillage reward from each trade for the `recipient`. Cannot be changed.542 /// - `metadata`: Arbitrary data about an NFT, e.g. IPFS hash. Cannot be changed.543 /// - `transferable`: Can this NFT be transferred? Cannot be changed.544 /// - `resources`: Resource data to be added to the NFT immediately after minting.545 #[transactional]546 #[pallet::weight(<SelfWeightOf<T>>::mint_nft(resources.as_ref().map(|r| r.len() as u32).unwrap_or(0)))]547 pub fn mint_nft(548 origin: OriginFor<T>,549 owner: Option<T::AccountId>,550 collection_id: RmrkCollectionId,551 recipient: Option<T::AccountId>,552 royalty_amount: Option<Permill>,553 metadata: RmrkString,554 transferable: bool,555 resources: Option<BoundedVec<RmrkResourceTypes, MaxResourcesOnMint>>,556 ) -> DispatchResult {557 let sender = ensure_signed(origin)?;558 let cross_sender = T::CrossAccountId::from_sub(sender.clone());559560 let owner = owner.unwrap_or(sender.clone());561 let cross_owner = T::CrossAccountId::from_sub(owner.clone());562563 let collection = Self::get_typed_nft_collection(564 Self::unique_collection_id(collection_id)?,565 misc::CollectionType::Regular,566 )?;567 collection.check_is_external()?;568569 let royalty_info = royalty_amount.map(|amount| rmrk_traits::RoyaltyInfo {570 recipient: recipient.unwrap_or_else(|| owner.clone()),571 amount,572 });573574 let nft_id = Self::create_nft(575 &cross_sender,576 &cross_owner,577 &collection,578 [579 Self::encode_rmrk_property(TokenType, &NftType::Regular)?,580 Self::encode_rmrk_property(Transferable, &transferable)?,581 Self::encode_rmrk_property(PendingNftAccept, &None::<PendingTarget>)?,582 Self::encode_rmrk_property(RoyaltyInfo, &royalty_info)?,583 Self::encode_rmrk_property(Metadata, &metadata)?,584 Self::encode_rmrk_property(Equipped, &false)?,585 Self::encode_rmrk_property(ResourcePriorities, &<Vec<u8>>::new())?,586 Self::encode_rmrk_property(NextResourceId, &(0 as RmrkResourceId))?,587 Self::encode_rmrk_property(PendingChildren, &PendingChildrenSet::new())?,588 Self::encode_rmrk_property(AssociatedBases, &BasesMap::new())?,589 ]590 .into_iter(),591 )592 .map_err(|err| match err {593 DispatchError::Arithmetic(_) => <Error<T>>::NoAvailableNftId.into(),594 err => Self::map_unique_err_to_proxy(err),595 })?;596597 if let Some(resources) = resources {598 for resource in resources {599 Self::resource_add(sender.clone(), collection.id, nft_id, resource)?;600 }601 }602603 Self::deposit_event(Event::NftMinted {604 owner,605 collection_id,606 nft_id: nft_id.0,607 });608609 Ok(())610 }611612 /// Burn an NFT, destroying it and its nested tokens up to the specified limit.613 /// If the burning budget is exceeded, the transaction is reverted.614 ///615 /// This is the way to burn a nested token as well.616 ///617 /// For more information, see [`burn_recursively`](pallet_nonfungible::pallet::Pallet::burn_recursively).618 ///619 /// # Permissions:620 /// * Token owner621 ///622 /// # Arguments:623 /// - `collection_id`: RMRK ID of the collection in which the NFT to burn belongs to.624 /// - `nft_id`: ID of the NFT to be destroyed.625 /// - `max_burns`: Maximum number of tokens to burn, assuming nesting. The transaction626 /// is reverted if there are more tokens to burn in the nesting tree than this number.627 /// This is primarily a mechanism of transaction weight control.628 #[transactional]629 #[pallet::weight(<SelfWeightOf<T>>::burn_nft(*max_burns))]630 pub fn burn_nft(631 origin: OriginFor<T>,632 collection_id: RmrkCollectionId,633 nft_id: RmrkNftId,634 max_burns: u32,635 ) -> DispatchResult {636 let sender = ensure_signed(origin)?;637 let cross_sender = T::CrossAccountId::from_sub(sender.clone());638639 let collection = Self::get_typed_nft_collection(640 Self::unique_collection_id(collection_id)?,641 misc::CollectionType::Regular,642 )?;643 collection.check_is_external()?;644645 Self::destroy_nft(646 cross_sender,647 Self::unique_collection_id(collection_id)?,648 nft_id.into(),649 max_burns,650 <Error<T>>::NoPermission,651 )652 .map_err(|err| Self::map_unique_err_to_proxy(err.error))?;653654 Self::deposit_event(Event::NFTBurned {655 owner: sender,656 nft_id,657 });658659 Ok(())660 }661662 /// Transfer an NFT from an account/NFT A to another account/NFT B.663 /// The token must be transferable. Nesting cannot occur deeper than the [`NESTING_BUDGET`].664 ///665 /// If the target owner is an NFT owned by another account, then the NFT will enter666 /// the pending state and will have to be accepted by the other account.667 ///668 /// # Permissions:669 /// - Token owner670 ///671 /// # Arguments:672 /// - `collection_id`: RMRK ID of the collection of the NFT to be transferred.673 /// - `nft_id`: ID of the NFT to be transferred.674 /// - `new_owner`: New owner of the nft which can be either an account or a NFT.675 #[transactional]676 #[pallet::weight(<SelfWeightOf<T>>::send())]677 pub fn send(678 origin: OriginFor<T>,679 rmrk_collection_id: RmrkCollectionId,680 rmrk_nft_id: RmrkNftId,681 new_owner: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,682 ) -> DispatchResult {683 let sender = ensure_signed(origin.clone())?;684 let cross_sender = T::CrossAccountId::from_sub(sender.clone());685686 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;687 let nft_id = rmrk_nft_id.into();688689 let collection =690 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;691 collection.check_is_external()?;692693 let token_data =694 <TokenData<T>>::get((collection_id, nft_id)).ok_or(<Error<T>>::NoAvailableNftId)?;695696 let from = token_data.owner;697698 ensure!(699 Self::get_nft_property_decoded(collection_id, nft_id, RmrkProperty::Transferable)?,700 <Error<T>>::NonTransferable701 );702703 ensure!(704 Self::get_nft_property_decoded::<Option<PendingTarget>>(705 collection_id,706 nft_id,707 RmrkProperty::PendingNftAccept708 )?709 .is_none(),710 <Error<T>>::NoPermission711 );712713 let target_owner;714 let approval_required;715716 match new_owner {717 RmrkAccountIdOrCollectionNftTuple::AccountId(ref account_id) => {718 target_owner = T::CrossAccountId::from_sub(account_id.clone());719 approval_required = false;720 }721 RmrkAccountIdOrCollectionNftTuple::CollectionAndNftTuple(722 target_collection_id,723 target_nft_id,724 ) => {725 let target_collection_id = Self::unique_collection_id(target_collection_id)?;726727 let target_nft_budget = budget::Value::new(NESTING_BUDGET);728729 let target_nft_owner = <PalletStructure<T>>::get_checked_topmost_owner(730 target_collection_id,731 target_nft_id.into(),732 Some((collection_id, nft_id)),733 &target_nft_budget,734 )735 .map_err(Self::map_unique_err_to_proxy)?;736737 approval_required = cross_sender != target_nft_owner;738739 if approval_required {740 target_owner = target_nft_owner;741742 <PalletNft<T>>::set_scoped_token_property(743 collection.id,744 nft_id,745 RMRK_SCOPE,746 Self::encode_rmrk_property::<Option<PendingTarget>>(747 PendingNftAccept,748 &Some((target_collection_id, target_nft_id.into())),749 )?,750 )?;751752 Self::insert_pending_child(753 (target_collection_id, target_nft_id.into()),754 (rmrk_collection_id, rmrk_nft_id),755 )?;756 } else {757 target_owner = T::CrossTokenAddressMapping::token_to_address(758 target_collection_id,759 target_nft_id.into(),760 );761 }762 }763 }764765 let src_nft_budget = budget::Value::new(NESTING_BUDGET);766767 <PalletNft<T>>::transfer_from(768 &collection,769 &cross_sender,770 &from,771 &target_owner,772 nft_id,773 &src_nft_budget,774 )775 .map_err(Self::map_unique_err_to_proxy)?;776777 Self::deposit_event(Event::NFTSent {778 sender,779 recipient: new_owner,780 collection_id: rmrk_collection_id,781 nft_id: rmrk_nft_id,782 approval_required,783 });784785 Ok(())786 }787788 /// Accept an NFT sent from another account to self or an owned NFT.789 ///790 /// The NFT in question must be pending, and, thus, be [sent](`Pallet::send`) first.791 ///792 /// # Permissions:793 /// - Token-owner-to-be794 ///795 /// # Arguments:796 /// - `rmrk_collection_id`: RMRK collection ID of the NFT to be accepted.797 /// - `rmrk_nft_id`: ID of the NFT to be accepted.798 /// - `new_owner`: Either the sender's account ID or a sender-owned NFT,799 /// whichever the accepted NFT was sent to.800 #[transactional]801 #[pallet::weight(<SelfWeightOf<T>>::accept_nft())]802 pub fn accept_nft(803 origin: OriginFor<T>,804 rmrk_collection_id: RmrkCollectionId,805 rmrk_nft_id: RmrkNftId,806 new_owner: RmrkAccountIdOrCollectionNftTuple<T::AccountId>,807 ) -> DispatchResult {808 let sender = ensure_signed(origin.clone())?;809 let cross_sender = T::CrossAccountId::from_sub(sender.clone());810811 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;812 let nft_id = rmrk_nft_id.into();813814 let collection =815 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;816 collection.check_is_external()?;817818 let new_cross_owner = match new_owner {819 RmrkAccountIdOrCollectionNftTuple::AccountId(ref account_id) => {820 T::CrossAccountId::from_sub(account_id.clone())821 }822 RmrkAccountIdOrCollectionNftTuple::CollectionAndNftTuple(823 target_collection_id,824 target_nft_id,825 ) => {826 let target_collection_id = Self::unique_collection_id(target_collection_id)?;827828 T::CrossTokenAddressMapping::token_to_address(829 target_collection_id,830 TokenId(target_nft_id),831 )832 }833 };834835 let budget = budget::Value::new(NESTING_BUDGET);836837 <PalletNft<T>>::transfer(838 &collection,839 &cross_sender,840 &new_cross_owner,841 nft_id,842 &budget,843 )844 .map_err(|err| {845 if err == <CommonError<T>>::UserIsNotAllowedToNest.into() {846 <Error<T>>::CannotAcceptNonOwnedNft.into()847 } else {848 Self::map_unique_err_to_proxy(err)849 }850 })?;851852 let pending_target = Self::get_nft_property_decoded::<Option<PendingTarget>>(853 collection_id,854 nft_id,855 RmrkProperty::PendingNftAccept,856 )?;857858 if let Some(pending_target) = pending_target {859 Self::remove_pending_child(pending_target, (rmrk_collection_id, rmrk_nft_id))?;860861 <PalletNft<T>>::set_scoped_token_property(862 collection.id,863 nft_id,864 RMRK_SCOPE,865 Self::encode_rmrk_property(PendingNftAccept, &None::<PendingTarget>)?,866 )?;867 }868869 Self::deposit_event(Event::NFTAccepted {870 sender,871 recipient: new_owner,872 collection_id: rmrk_collection_id,873 nft_id: rmrk_nft_id,874 });875876 Ok(())877 }878879 /// Reject an NFT sent from another account to self or owned NFT.880 /// The NFT in question will not be sent back and burnt instead.881 ///882 /// The NFT in question must be pending, and, thus, be [sent](`Pallet::send`) first.883 ///884 /// # Permissions:885 /// - Token-owner-to-be-not886 ///887 /// # Arguments:888 /// - `rmrk_collection_id`: RMRK ID of the NFT to be rejected.889 /// - `rmrk_nft_id`: ID of the NFT to be rejected.890 #[transactional]891 #[pallet::weight(<SelfWeightOf<T>>::reject_nft())]892 pub fn reject_nft(893 origin: OriginFor<T>,894 rmrk_collection_id: RmrkCollectionId,895 rmrk_nft_id: RmrkNftId,896 ) -> DispatchResult {897 let sender = ensure_signed(origin)?;898 let cross_sender = T::CrossAccountId::from_sub(sender.clone());899900 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;901 let nft_id = rmrk_nft_id.into();902903 let collection =904 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;905 collection.check_is_external()?;906907 ensure!(908 <TokenData<T>>::get((collection_id, nft_id)).is_some(),909 <Error<T>>::NoAvailableNftId910 );911912 let pending_target = Self::get_nft_property_decoded::<Option<PendingTarget>>(913 collection_id,914 nft_id,915 RmrkProperty::PendingNftAccept,916 )?;917918 match pending_target {919 Some(pending_target) => {920 Self::remove_pending_child(pending_target, (rmrk_collection_id, rmrk_nft_id))?921 }922 None => return Err(<Error<T>>::CannotRejectNonPendingNft.into()),923 }924925 Self::destroy_nft(926 cross_sender,927 collection_id,928 nft_id,929 NESTING_BUDGET,930 <Error<T>>::CannotRejectNonOwnedNft,931 )932 .map_err(|err| Self::map_unique_err_to_proxy(err.error))?;933934 Self::deposit_event(Event::NFTRejected {935 sender,936 collection_id: rmrk_collection_id,937 nft_id: rmrk_nft_id,938 });939940 Ok(())941 }942943 /// Accept the addition of a newly created pending resource to an existing NFT.944 ///945 /// This transaction is needed when a resource is created and assigned to an NFT946 /// by a non-owner, i.e. the collection issuer, with one of the947 /// [`add_...` transactions](Pallet::add_basic_resource).948 ///949 /// # Permissions:950 /// - Token owner951 ///952 /// # Arguments:953 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.954 /// - `rmrk_nft_id`: ID of the NFT with a pending resource to be accepted.955 /// - `resource_id`: ID of the newly created pending resource.956 #[transactional]957 #[pallet::weight(<SelfWeightOf<T>>::accept_resource())]958 pub fn accept_resource(959 origin: OriginFor<T>,960 rmrk_collection_id: RmrkCollectionId,961 rmrk_nft_id: RmrkNftId,962 resource_id: RmrkResourceId,963 ) -> DispatchResult {964 let sender = ensure_signed(origin)?;965 let cross_sender = T::CrossAccountId::from_sub(sender);966967 let collection_id = Self::unique_collection_id(rmrk_collection_id)968 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;969 let collection =970 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;971 collection.check_is_external()?;972973 let nft_id = rmrk_nft_id.into();974975 let budget = budget::Value::new(NESTING_BUDGET);976977 let nft_owner =978 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)979 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;980981 Self::try_mutate_resource_info(collection_id, nft_id, resource_id, |res| {982 ensure!(res.pending, <Error<T>>::ResourceNotPending);983 ensure!(cross_sender == nft_owner, <Error<T>>::NoPermission);984985 res.pending = false;986987 Ok(())988 })?;989990 Self::deposit_event(Event::<T>::ResourceAccepted {991 nft_id: rmrk_nft_id,992 resource_id,993 });994995 Ok(())996 }997998 /// Accept the removal of a removal-pending resource from an NFT.999 ///1000 /// This transaction is needed when a non-owner, i.e. the collection issuer,1001 /// requests a [removal](`Pallet::remove_resource`) of a resource from an NFT.1002 ///1003 /// # Permissions:1004 /// - Token owner1005 ///1006 /// # Arguments:1007 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1008 /// - `rmrk_nft_id`: ID of the NFT with a resource to be removed.1009 /// - `resource_id`: ID of the removal-pending resource.1010 #[transactional]1011 #[pallet::weight(<SelfWeightOf<T>>::accept_resource_removal())]1012 pub fn accept_resource_removal(1013 origin: OriginFor<T>,1014 rmrk_collection_id: RmrkCollectionId,1015 rmrk_nft_id: RmrkNftId,1016 resource_id: RmrkResourceId,1017 ) -> DispatchResult {1018 let sender = ensure_signed(origin)?;1019 let cross_sender = T::CrossAccountId::from_sub(sender);10201021 let collection_id = Self::unique_collection_id(rmrk_collection_id)1022 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;1023 let collection =1024 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1025 collection.check_is_external()?;10261027 let nft_id = rmrk_nft_id.into();10281029 let budget = budget::Value::new(NESTING_BUDGET);10301031 let nft_owner =1032 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)1033 .map_err(|_| <Error<T>>::ResourceDoesntExist)?;10341035 ensure!(cross_sender == nft_owner, <Error<T>>::NoPermission);10361037 let resource_id_key = Self::get_scoped_property_key(ResourceId(resource_id))?;10381039 let resource_info = <PalletNft<T>>::token_aux_property((1040 collection_id,1041 nft_id,1042 RMRK_SCOPE,1043 resource_id_key.clone(),1044 ))1045 .ok_or(<Error<T>>::ResourceDoesntExist)?;10461047 let resource_info: RmrkResourceInfo = Self::decode_property_value(&resource_info)?;10481049 ensure!(1050 resource_info.pending_removal,1051 <Error<T>>::ResourceNotPending1052 );10531054 <PalletNft<T>>::remove_token_aux_property(1055 collection_id,1056 nft_id,1057 RMRK_SCOPE,1058 resource_id_key,1059 );10601061 if let RmrkResourceTypes::Composable(resource) = resource_info.resource {1062 let base_id = resource.base;10631064 Self::remove_associated_base_id(collection_id, nft_id, base_id)?;1065 }10661067 Self::deposit_event(Event::<T>::ResourceRemovalAccepted {1068 nft_id: rmrk_nft_id,1069 resource_id,1070 });10711072 Ok(())1073 }10741075 /// Add or edit a custom user property, a key-value pair, describing the metadata1076 /// of a token or a collection, on either one of these.1077 ///1078 /// Note that in this proxy implementation many details regarding RMRK are stored1079 /// as scoped properties prefixed with "rmrk:", normally inaccessible1080 /// to external transactions and RPCs.1081 ///1082 /// # Permissions:1083 /// - Collection issuer - in case of collection property1084 /// - Token owner - in case of NFT property1085 ///1086 /// # Arguments:1087 /// - `rmrk_collection_id`: RMRK collection ID.1088 /// - `maybe_nft_id`: Optional ID of the NFT. If left empty, then the property is set for the collection.1089 /// - `key`: Key of the custom property to be referenced by.1090 /// - `value`: Value of the custom property to be stored.1091 #[transactional]1092 #[pallet::weight(<SelfWeightOf<T>>::set_property())]1093 pub fn set_property(1094 origin: OriginFor<T>,1095 #[pallet::compact] rmrk_collection_id: RmrkCollectionId,1096 maybe_nft_id: Option<RmrkNftId>,1097 key: RmrkKeyString,1098 value: RmrkValueString,1099 ) -> DispatchResult {1100 let sender = ensure_signed(origin)?;1101 let sender = T::CrossAccountId::from_sub(sender);11021103 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1104 let collection =1105 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1106 collection.check_is_external()?;11071108 let budget = budget::Value::new(NESTING_BUDGET);11091110 match maybe_nft_id {1111 Some(nft_id) => {1112 let token_id: TokenId = nft_id.into();11131114 Self::ensure_nft_type(collection_id, token_id, NftType::Regular)?;1115 Self::ensure_nft_owner(collection_id, token_id, &sender, &budget)?;11161117 <PalletNft<T>>::set_scoped_token_property(1118 collection_id,1119 token_id,1120 RMRK_SCOPE,1121 Self::encode_rmrk_property(UserProperty(key.as_slice()), &value)?,1122 )?;1123 }1124 None => {1125 let collection = Self::get_typed_nft_collection(1126 collection_id,1127 misc::CollectionType::Regular,1128 )?;11291130 Self::check_collection_owner(&collection, &sender)?;11311132 <PalletCommon<T>>::set_scoped_collection_property(1133 collection_id,1134 RMRK_SCOPE,1135 Self::encode_rmrk_property(UserProperty(key.as_slice()), &value)?,1136 )?;1137 }1138 }11391140 Self::deposit_event(Event::PropertySet {1141 collection_id: rmrk_collection_id,1142 maybe_nft_id,1143 key,1144 value,1145 });11461147 Ok(())1148 }11491150 /// Set a different order of resource priorities for an NFT. Priorities can be used,1151 /// for example, for order of rendering.1152 ///1153 /// Note that the priorities are not updated automatically, and are an empty vector1154 /// by default. There is no pre-set definition for the order to be particular,1155 /// it can be interpreted arbitrarily use-case by use-case.1156 ///1157 /// # Permissions:1158 /// - Token owner1159 ///1160 /// # Arguments:1161 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1162 /// - `rmrk_nft_id`: ID of the NFT to rearrange resource priorities for.1163 /// - `priorities`: Ordered vector of resource IDs.1164 #[transactional]1165 #[pallet::weight(<SelfWeightOf<T>>::set_priority())]1166 pub fn set_priority(1167 origin: OriginFor<T>,1168 rmrk_collection_id: RmrkCollectionId,1169 rmrk_nft_id: RmrkNftId,1170 priorities: BoundedVec<RmrkResourceId, RmrkMaxPriorities>,1171 ) -> DispatchResult {1172 let sender = ensure_signed(origin)?;1173 let sender = T::CrossAccountId::from_sub(sender);11741175 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1176 let nft_id = rmrk_nft_id.into();11771178 let collection =1179 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1180 collection.check_is_external()?;11811182 let budget = budget::Value::new(NESTING_BUDGET);11831184 Self::ensure_nft_type(collection_id, nft_id, NftType::Regular)?;1185 Self::ensure_nft_owner(collection_id, nft_id, &sender, &budget)?;11861187 <PalletNft<T>>::set_scoped_token_property(1188 collection_id,1189 nft_id,1190 RMRK_SCOPE,1191 Self::encode_rmrk_property(ResourcePriorities, &priorities.into_inner())?,1192 )?;11931194 Self::deposit_event(Event::<T>::PrioritySet {1195 collection_id: rmrk_collection_id,1196 nft_id: rmrk_nft_id,1197 });11981199 Ok(())1200 }12011202 /// Create and set/propose a basic resource for an NFT.1203 ///1204 /// A basic resource is the simplest, lacking a Base and anything that comes with it.1205 /// See RMRK docs for more information and examples.1206 ///1207 /// # Permissions:1208 /// - Collection issuer - if not the token owner, adding the resource will warrant1209 /// the owner's [acceptance](Pallet::accept_resource).1210 ///1211 /// # Arguments:1212 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1213 /// - `nft_id`: ID of the NFT to assign a resource to.1214 /// - `resource`: Data of the resource to be created.1215 #[transactional]1216 #[pallet::weight(<SelfWeightOf<T>>::add_basic_resource())]1217 pub fn add_basic_resource(1218 origin: OriginFor<T>,1219 rmrk_collection_id: RmrkCollectionId,1220 nft_id: RmrkNftId,1221 resource: RmrkBasicResource,1222 ) -> DispatchResult {1223 let sender = ensure_signed(origin.clone())?;12241225 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1226 let collection =1227 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1228 collection.check_is_external()?;12291230 let resource_id = Self::resource_add(1231 sender,1232 collection_id,1233 nft_id.into(),1234 RmrkResourceTypes::Basic(resource),1235 )?;12361237 Self::deposit_event(Event::ResourceAdded {1238 nft_id,1239 resource_id,1240 });1241 Ok(())1242 }12431244 /// Create and set/propose a composable resource for an NFT.1245 ///1246 /// A composable resource links to a Base and has a subset of its Parts it is composed of.1247 /// See RMRK docs for more information and examples.1248 ///1249 /// # Permissions:1250 /// - Collection issuer - if not the token owner, adding the resource will warrant1251 /// the owner's [acceptance](Pallet::accept_resource).1252 ///1253 /// # Arguments:1254 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1255 /// - `nft_id`: ID of the NFT to assign a resource to.1256 /// - `resource`: Data of the resource to be created.1257 #[transactional]1258 #[pallet::weight(<SelfWeightOf<T>>::add_composable_resource())]1259 pub fn add_composable_resource(1260 origin: OriginFor<T>,1261 rmrk_collection_id: RmrkCollectionId,1262 nft_id: RmrkNftId,1263 resource: RmrkComposableResource,1264 ) -> DispatchResult {1265 let sender = ensure_signed(origin.clone())?;12661267 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1268 let collection =1269 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1270 collection.check_is_external()?;12711272 let base_id = resource.base;12731274 let resource_id = Self::resource_add(1275 sender,1276 collection_id,1277 nft_id.into(),1278 RmrkResourceTypes::Composable(resource),1279 )?;12801281 <PalletNft<T>>::try_mutate_token_aux_property(1282 collection_id,1283 nft_id.into(),1284 RMRK_SCOPE,1285 Self::get_scoped_property_key(AssociatedBases)?,1286 |value| -> DispatchResult {1287 let mut bases: BasesMap = match value {1288 Some(value) => Self::decode_property_value(value)?,1289 None => BasesMap::new(),1290 };12911292 *bases.entry(base_id).or_insert(0) += 1;12931294 *value = Some(Self::encode_property_value(&bases)?);1295 Ok(())1296 },1297 )?;12981299 Self::deposit_event(Event::ResourceAdded {1300 nft_id,1301 resource_id,1302 });1303 Ok(())1304 }13051306 /// Create and set/propose a slot resource for an NFT.1307 ///1308 /// A slot resource links to a Base and a slot ID in it which it can fit into.1309 /// See RMRK docs for more information and examples.1310 ///1311 /// # Permissions:1312 /// - Collection issuer - if not the token owner, adding the resource will warrant1313 /// the owner's [acceptance](Pallet::accept_resource).1314 ///1315 /// # Arguments:1316 /// - `rmrk_collection_id`: RMRK collection ID of the NFT.1317 /// - `nft_id`: ID of the NFT to assign a resource to.1318 /// - `resource`: Data of the resource to be created.1319 #[transactional]1320 #[pallet::weight(<SelfWeightOf<T>>::add_slot_resource())]1321 pub fn add_slot_resource(1322 origin: OriginFor<T>,1323 rmrk_collection_id: RmrkCollectionId,1324 nft_id: RmrkNftId,1325 resource: RmrkSlotResource,1326 ) -> DispatchResult {1327 let sender = ensure_signed(origin.clone())?;13281329 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1330 let collection =1331 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1332 collection.check_is_external()?;13331334 let resource_id = Self::resource_add(1335 sender,1336 collection_id,1337 nft_id.into(),1338 RmrkResourceTypes::Slot(resource),1339 )?;13401341 Self::deposit_event(Event::ResourceAdded {1342 nft_id,1343 resource_id,1344 });1345 Ok(())1346 }13471348 /// Remove and erase a resource from an NFT.1349 ///1350 /// If the sender does not own the NFT, then it will be pending confirmation,1351 /// and will have to be [accepted](Pallet::accept_resource_removal) by the token owner.1352 ///1353 /// # Permissions1354 /// - Collection issuer1355 ///1356 /// # Arguments1357 /// - `collection_id`: RMRK ID of a collection to which the NFT making use of the resource belongs to.1358 /// - `nft_id`: ID of the NFT with a resource to be removed.1359 /// - `resource_id`: ID of the resource to be removed.1360 #[transactional]1361 #[pallet::weight(<SelfWeightOf<T>>::remove_resource())]1362 pub fn remove_resource(1363 origin: OriginFor<T>,1364 rmrk_collection_id: RmrkCollectionId,1365 nft_id: RmrkNftId,1366 resource_id: RmrkResourceId,1367 ) -> DispatchResult {1368 let sender = ensure_signed(origin.clone())?;13691370 let collection_id = Self::unique_collection_id(rmrk_collection_id)?;1371 let collection =1372 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1373 collection.check_is_external()?;13741375 Self::resource_remove(sender, collection_id, nft_id.into(), resource_id)?;13761377 Self::deposit_event(Event::ResourceRemoval {1378 nft_id,1379 resource_id,1380 });1381 Ok(())1382 }1383 }1384}13851386impl<T: Config> Pallet<T> {1387 /// Transform one of possible RMRK keys into a byte key with a RMRK scope.1388 pub fn get_scoped_property_key(rmrk_key: RmrkProperty) -> Result<PropertyKey, DispatchError> {1389 let key = rmrk_key.to_key::<T>()?;13901391 let scoped_key = RMRK_SCOPE1392 .apply(key)1393 .map_err(|_| <Error<T>>::RmrkPropertyKeyIsTooLong)?;13941395 Ok(scoped_key)1396 }13971398 /// Form a Unique property, transforming a RMRK key into bytes (without assigning the scope yet)1399 /// and encoding the value from an arbitrary type into bytes.1400 pub fn encode_rmrk_property<E: Encode>(1401 rmrk_key: RmrkProperty,1402 value: &E,1403 ) -> Result<Property, DispatchError> {1404 let key = rmrk_key.to_key::<T>()?;14051406 let value = Self::encode_property_value(value)?;14071408 let property = Property { key, value };14091410 Ok(property)1411 }14121413 /// Encode property value from an arbitrary type into bytes for storage.1414 pub fn encode_property_value<E: Encode, S: Get<u32>>(1415 value: &E,1416 ) -> Result<BoundedBytes<S>, DispatchError> {1417 let value = value1418 .encode()1419 .try_into()1420 .map_err(|_| <Error<T>>::RmrkPropertyValueIsTooLong)?;14211422 Ok(value)1423 }14241425 /// Decode property value from bytes into an arbitrary type.1426 pub fn decode_property_value<D: Decode, S: Get<u32>>(1427 vec: &BoundedBytes<S>,1428 ) -> Result<D, DispatchError> {1429 vec.decode()1430 .map_err(|_| <Error<T>>::UnableToDecodeRmrkData.into())1431 }14321433 /// Change the limit of a property value byte vector.1434 pub fn rebind<L, S>(vec: &BoundedVec<u8, L>) -> Result<BoundedVec<u8, S>, DispatchError>1435 where1436 BoundedVec<u8, S>: TryFrom<Vec<u8>>,1437 {1438 vec.rebind()1439 .map_err(|_| <Error<T>>::RmrkPropertyValueIsTooLong.into())1440 }14411442 /// Initialize a new NFT collection with certain RMRK-scoped properties.1443 ///1444 /// See [`init_collection`](pallet_nonfungible::pallet::Pallet::init_collection) for more details.1445 fn init_collection(1446 sender: T::CrossAccountId,1447 data: CreateCollectionData<T::AccountId>,1448 properties: impl Iterator<Item = Property>,1449 ) -> Result<CollectionId, DispatchError> {1450 let collection_id = <PalletNft<T>>::init_collection(sender, data, true);14511452 if let Err(DispatchError::Arithmetic(_)) = &collection_id {1453 return Err(<Error<T>>::NoAvailableCollectionId.into());1454 }14551456 <PalletCommon<T>>::set_scoped_collection_properties(1457 collection_id?,1458 RMRK_SCOPE,1459 properties,1460 )?;14611462 collection_id1463 }14641465 /// Mint a new NFT with certain RMRK-scoped properties. Sender must be the collection owner.1466 ///1467 /// See [`create_item`](pallet_nonfungible::pallet::Pallet::create_item) for more details.1468 pub fn create_nft(1469 sender: &T::CrossAccountId,1470 owner: &T::CrossAccountId,1471 collection: &NonfungibleHandle<T>,1472 properties: impl Iterator<Item = Property>,1473 ) -> Result<TokenId, DispatchError> {1474 let data = CreateNftExData {1475 properties: BoundedVec::default(),1476 owner: owner.clone(),1477 };14781479 let budget = budget::Value::new(NESTING_BUDGET);14801481 <PalletNft<T>>::create_item(collection, sender, data, &budget)?;14821483 let nft_id = <PalletNft<T>>::current_token_id(collection.id);14841485 <PalletNft<T>>::set_scoped_token_properties(collection.id, nft_id, RMRK_SCOPE, properties)?;14861487 Ok(nft_id)1488 }14891490 /// Burn an NFT, along with its nested children, limited by `max_burns`. The sender must be the token owner.1491 ///1492 /// See [`burn_recursively`](pallet_nonfungible::pallet::Pallet::burn_recursively) for more details.1493 fn destroy_nft(1494 sender: T::CrossAccountId,1495 collection_id: CollectionId,1496 token_id: TokenId,1497 max_burns: u32,1498 error_if_not_owned: Error<T>,1499 ) -> DispatchResultWithPostInfo {1500 let collection =1501 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;15021503 let token_data =1504 <TokenData<T>>::get((collection_id, token_id)).ok_or(<Error<T>>::NoAvailableNftId)?;15051506 let from = token_data.owner;15071508 let owner_check_budget = budget::Value::new(NESTING_BUDGET);15091510 ensure!(1511 <PalletStructure<T>>::check_indirectly_owned(1512 sender.clone(),1513 collection_id,1514 token_id,1515 None,1516 &owner_check_budget1517 )?,1518 error_if_not_owned,1519 );15201521 let burns_budget = budget::Value::new(max_burns);1522 let breadth_budget = budget::Value::new(max_burns);15231524 <PalletNft<T>>::burn_recursively(1525 &collection,1526 &from,1527 token_id,1528 &burns_budget,1529 &breadth_budget,1530 )1531 }15321533 /// Add a sent token pending acceptance to the target owning token as a property.1534 fn insert_pending_child(1535 target: (CollectionId, TokenId),1536 child: (RmrkCollectionId, RmrkNftId),1537 ) -> DispatchResult {1538 Self::mutate_pending_children(target, |pending_children| {1539 pending_children.insert(child);1540 })1541 }15421543 /// Remove a sent token pending acceptance from the target token's properties.1544 fn remove_pending_child(1545 target: (CollectionId, TokenId),1546 child: (RmrkCollectionId, RmrkNftId),1547 ) -> DispatchResult {1548 Self::mutate_pending_children(target, |pending_children| {1549 pending_children.remove(&child);1550 })1551 }15521553 /// Apply a mutation to the property of a token containing sent tokens1554 /// that are currently pending acceptance.1555 fn mutate_pending_children(1556 (target_collection_id, target_nft_id): (CollectionId, TokenId),1557 f: impl FnOnce(&mut PendingChildrenSet),1558 ) -> DispatchResult {1559 <PalletNft<T>>::try_mutate_token_aux_property(1560 target_collection_id,1561 target_nft_id,1562 RMRK_SCOPE,1563 Self::get_scoped_property_key(PendingChildren)?,1564 |pending_children| -> DispatchResult {1565 let mut map = match pending_children {1566 Some(map) => Self::decode_property_value(map)?,1567 None => PendingChildrenSet::new(),1568 };15691570 f(&mut map);15711572 *pending_children = Some(Self::encode_property_value(&map)?);15731574 Ok(())1575 },1576 )1577 }15781579 /// Get an iterator from a token's property containing tokens sent to it1580 /// that are currently pending acceptance.1581 fn iterate_pending_children(1582 collection_id: CollectionId,1583 nft_id: TokenId,1584 ) -> Result<impl Iterator<Item = PendingChild>, DispatchError> {1585 let property = <PalletNft<T>>::token_aux_property((1586 collection_id,1587 nft_id,1588 RMRK_SCOPE,1589 Self::get_scoped_property_key(PendingChildren)?,1590 ));15911592 let pending_children = match property {1593 Some(map) => Self::decode_property_value(&map)?,1594 None => PendingChildrenSet::new(),1595 };15961597 Ok(pending_children.into_iter())1598 }15991600 /// Get incremented resource ID from within an NFT's properties and store the new latest ID.1601 /// Thus, the returned resource ID should be used.1602 ///1603 /// Resource IDs are unique only across an NFT.1604 fn acquire_next_resource_id(1605 collection_id: CollectionId,1606 nft_id: TokenId,1607 ) -> Result<RmrkResourceId, DispatchError> {1608 let resource_id: RmrkResourceId =1609 Self::get_nft_property_decoded(collection_id, nft_id, NextResourceId)?;16101611 let next_id = resource_id1612 .checked_add(1)1613 .ok_or(<Error<T>>::NoAvailableResourceId)?;16141615 <PalletNft<T>>::set_scoped_token_property(1616 collection_id,1617 nft_id,1618 RMRK_SCOPE,1619 Self::encode_rmrk_property(NextResourceId, &next_id)?,1620 )?;16211622 Ok(resource_id)1623 }16241625 /// Create and add a resource for a regular NFT, mark it as pending if the sender1626 /// is not the token owner. The sender must be the collection owner.1627 fn resource_add(1628 sender: T::AccountId,1629 collection_id: CollectionId,1630 nft_id: TokenId,1631 resource: RmrkResourceTypes,1632 ) -> Result<RmrkResourceId, DispatchError> {1633 let collection =1634 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1635 ensure!(collection.owner == sender, Error::<T>::NoPermission);16361637 let sender = T::CrossAccountId::from_sub(sender);1638 let budget = budget::Value::new(NESTING_BUDGET);16391640 let nft_owner = <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)1641 .map_err(Self::map_unique_err_to_proxy)?;16421643 let pending = sender != nft_owner;16441645 let id = Self::acquire_next_resource_id(collection_id, nft_id)?;16461647 let resource_info = RmrkResourceInfo {1648 id,1649 resource,1650 pending,1651 pending_removal: false,1652 };16531654 <PalletNft<T>>::try_mutate_token_aux_property(1655 collection_id,1656 nft_id,1657 RMRK_SCOPE,1658 Self::get_scoped_property_key(ResourceId(id))?,1659 |value| -> DispatchResult {1660 *value = Some(Self::encode_property_value(&resource_info)?);16611662 Ok(())1663 },1664 )?;16651666 Ok(id)1667 }16681669 /// Designate a resource for erasure from an NFT, and remove it if the sender is the token owner.1670 /// The sender must be the collection owner.1671 fn resource_remove(1672 sender: T::AccountId,1673 collection_id: CollectionId,1674 nft_id: TokenId,1675 resource_id: RmrkResourceId,1676 ) -> DispatchResult {1677 let collection =1678 Self::get_typed_nft_collection(collection_id, misc::CollectionType::Regular)?;1679 ensure!(collection.owner == sender, Error::<T>::NoPermission);16801681 let resource_id_key = Self::get_scoped_property_key(ResourceId(resource_id))?;16821683 let resource = <PalletNft<T>>::token_aux_property((1684 collection_id,1685 nft_id,1686 RMRK_SCOPE,1687 resource_id_key.clone(),1688 ))1689 .ok_or(<Error<T>>::ResourceDoesntExist)?;16901691 let resource_info: RmrkResourceInfo = Self::decode_property_value(&resource)?;16921693 let budget = up_data_structs::budget::Value::new(NESTING_BUDGET);1694 let topmost_owner =1695 <PalletStructure<T>>::find_topmost_owner(collection_id, nft_id, &budget)?;16961697 let sender = T::CrossAccountId::from_sub(sender);1698 if topmost_owner == sender {1699 <PalletNft<T>>::remove_token_aux_property(1700 collection_id,1701 nft_id,1702 RMRK_SCOPE,1703 Self::get_scoped_property_key(ResourceId(resource_id))?,1704 );17051706 if let RmrkResourceTypes::Composable(resource) = resource_info.resource {1707 let base_id = resource.base;17081709 Self::remove_associated_base_id(collection_id, nft_id, base_id)?;1710 }1711 } else {1712 Self::try_mutate_resource_info(collection_id, nft_id, resource_id, |res| {1713 res.pending_removal = true;17141715 Ok(())1716 })?;1717 }17181719 Ok(())1720 }17211722 /// Remove a Base ID from an NFT if they are associated.1723 /// The Base itself is deleted if the number of associated NFTs reaches 0.1724 fn remove_associated_base_id(1725 collection_id: CollectionId,1726 nft_id: TokenId,1727 base_id: RmrkBaseId,1728 ) -> DispatchResult {1729 <PalletNft<T>>::try_mutate_token_aux_property(1730 collection_id,1731 nft_id,1732 RMRK_SCOPE,1733 Self::get_scoped_property_key(AssociatedBases)?,1734 |value| -> DispatchResult {1735 let mut bases: BasesMap = match value {1736 Some(value) => Self::decode_property_value(value)?,1737 None => BasesMap::new(),1738 };17391740 let remaining = bases.get(&base_id);17411742 if let Some(remaining) = remaining {1743 if let Some(0) | None = remaining.checked_sub(1) {1744 bases.remove(&base_id);1745 }1746 }17471748 *value = Some(Self::encode_property_value(&bases)?);1749 Ok(())1750 },1751 )1752 }17531754 /// Apply a mutation to a resource stored in the token properties of an NFT.1755 fn try_mutate_resource_info(1756 collection_id: CollectionId,1757 nft_id: TokenId,1758 resource_id: RmrkResourceId,1759 f: impl FnOnce(&mut RmrkResourceInfo) -> DispatchResult,1760 ) -> DispatchResult {1761 <PalletNft<T>>::try_mutate_token_aux_property(1762 collection_id,1763 nft_id,1764 RMRK_SCOPE,1765 Self::get_scoped_property_key(ResourceId(resource_id))?,1766 |value| match value {1767 Some(value) => {1768 let mut resource_info: RmrkResourceInfo = Self::decode_property_value(value)?;17691770 f(&mut resource_info)?;17711772 *value = Self::encode_property_value(&resource_info)?;17731774 Ok(())1775 }1776 None => Err(<Error<T>>::ResourceDoesntExist.into()),1777 },1778 )1779 }17801781 /// Change the owner of an NFT collection, ensuring that the sender is the current owner.1782 fn change_collection_owner(1783 collection_id: CollectionId,1784 collection_type: misc::CollectionType,1785 sender: T::AccountId,1786 new_owner: T::AccountId,1787 ) -> DispatchResult {1788 let collection = Self::get_typed_nft_collection(collection_id, collection_type)?;1789 Self::check_collection_owner(&collection, &T::CrossAccountId::from_sub(sender))?;17901791 let mut collection = collection.into_inner();17921793 collection.owner = new_owner;1794 collection.save()1795 }17961797 /// Ensure that an account is the collection owner/issuer, return an error if not.1798 pub fn check_collection_owner(1799 collection: &NonfungibleHandle<T>,1800 account: &T::CrossAccountId,1801 ) -> DispatchResult {1802 collection1803 .check_is_owner(account)1804 .map_err(Self::map_unique_err_to_proxy)1805 }18061807 /// Get the latest yet-unused RMRK collection index from the storage.1808 pub fn last_collection_idx() -> RmrkCollectionId {1809 <CollectionIndex<T>>::get()1810 }18111812 /// Get a mapping from a RMRK collection ID to its corresponding Unique collection ID.1813 pub fn unique_collection_id(1814 rmrk_collection_id: RmrkCollectionId,1815 ) -> Result<CollectionId, DispatchError> {1816 <UniqueCollectionId<T>>::try_get(rmrk_collection_id)1817 .map_err(|_| <Error<T>>::CollectionUnknown.into())1818 }18191820 /// Get a mapping from a Unique collection ID to its RMRK collection ID counterpart, if it exists.1821 pub fn rmrk_collection_id(1822 unique_collection_id: CollectionId,1823 ) -> Result<RmrkCollectionId, DispatchError> {1824 Self::get_collection_property_decoded(unique_collection_id, RmrkInternalCollectionId)1825 }18261827 /// Fetch a Unique NFT collection.1828 pub fn get_nft_collection(1829 collection_id: CollectionId,1830 ) -> Result<NonfungibleHandle<T>, DispatchError> {1831 let collection = <CollectionHandle<T>>::try_get(collection_id)1832 .map_err(|_| <Error<T>>::CollectionUnknown)?;18331834 match collection.mode {1835 CollectionMode::NFT => Ok(NonfungibleHandle::cast(collection)),1836 _ => Err(<Error<T>>::CollectionUnknown.into()),1837 }1838 }18391840 /// Check if an NFT collection with such an ID exists.1841 pub fn collection_exists(collection_id: CollectionId) -> bool {1842 <CollectionHandle<T>>::try_get(collection_id).is_ok()1843 }18441845 /// Fetch and decode a RMRK-scoped collection property value in bytes.1846 pub fn get_collection_property(1847 collection_id: CollectionId,1848 key: RmrkProperty,1849 ) -> Result<PropertyValue, DispatchError> {1850 let collection_property = <PalletCommon<T>>::collection_properties(collection_id)1851 .get(&Self::get_scoped_property_key(key)?)1852 .ok_or(<Error<T>>::CollectionUnknown)?1853 .clone();18541855 Ok(collection_property)1856 }18571858 /// Fetch a RMRK-scoped collection property and decode it from bytes into an appropriate type.1859 pub fn get_collection_property_decoded<V: Decode>(1860 collection_id: CollectionId,1861 key: RmrkProperty,1862 ) -> Result<V, DispatchError> {1863 Self::decode_property_value(&Self::get_collection_property(collection_id, key)?)1864 }18651866 /// Get the type of a collection stored as a scoped property.1867 ///1868 /// RMRK Core proxy differentiates between regular collections as well as RMRK Bases as collections.1869 pub fn get_collection_type(1870 collection_id: CollectionId,1871 ) -> Result<misc::CollectionType, DispatchError> {1872 Self::get_collection_property_decoded(collection_id, CollectionType).map_err(|err| {1873 if err != <Error<T>>::CollectionUnknown.into() {1874 <Error<T>>::CorruptedCollectionType.into()1875 } else {1876 err1877 }1878 })1879 }18801881 /// Ensure that the type of the collection equals the provided type,1882 /// otherwise return an error.1883 pub fn ensure_collection_type(1884 collection_id: CollectionId,1885 collection_type: misc::CollectionType,1886 ) -> DispatchResult {1887 let actual_type = Self::get_collection_type(collection_id)?;1888 ensure!(1889 actual_type == collection_type,1890 <CommonError<T>>::NoPermission1891 );18921893 Ok(())1894 }18951896 /// Fetch an NFT collection, but make sure it has the appropriate type.1897 pub fn get_typed_nft_collection(1898 collection_id: CollectionId,1899 collection_type: misc::CollectionType,1900 ) -> Result<NonfungibleHandle<T>, DispatchError> {1901 Self::ensure_collection_type(collection_id, collection_type)?;19021903 Self::get_nft_collection(collection_id)1904 }19051906 /// Same as [`get_typed_nft_collection`](crate::pallet::Pallet::get_typed_nft_collection),1907 /// but also return the Unique collection ID.1908 pub fn get_typed_nft_collection_mapped(1909 rmrk_collection_id: RmrkCollectionId,1910 collection_type: misc::CollectionType,1911 ) -> Result<(NonfungibleHandle<T>, CollectionId), DispatchError> {1912 let unique_collection_id = match collection_type {1913 misc::CollectionType::Regular => Self::unique_collection_id(rmrk_collection_id)?,1914 _ => rmrk_collection_id.into(),1915 };19161917 let collection = Self::get_typed_nft_collection(unique_collection_id, collection_type)?;19181919 Ok((collection, unique_collection_id))1920 }19211922 /// Fetch and decode a RMRK-scoped NFT property value in bytes.1923 pub fn get_nft_property(1924 collection_id: CollectionId,1925 nft_id: TokenId,1926 key: RmrkProperty,1927 ) -> Result<PropertyValue, DispatchError> {1928 let nft_property = <PalletNft<T>>::token_properties((collection_id, nft_id))1929 .get(&Self::get_scoped_property_key(key)?)1930 .ok_or(<Error<T>>::RmrkPropertyIsNotFound)?1931 .clone();19321933 Ok(nft_property)1934 }19351936 /// Fetch a RMRK-scoped NFT property and decode it from bytes into an appropriate type.1937 pub fn get_nft_property_decoded<V: Decode>(1938 collection_id: CollectionId,1939 nft_id: TokenId,1940 key: RmrkProperty,1941 ) -> Result<V, DispatchError> {1942 Self::decode_property_value(&Self::get_nft_property(collection_id, nft_id, key)?)1943 }19441945 /// Check that an NFT exists.1946 pub fn nft_exists(collection_id: CollectionId, nft_id: TokenId) -> bool {1947 <TokenData<T>>::contains_key((collection_id, nft_id))1948 }19491950 /// Get the type of an NFT stored as a scoped property.1951 ///1952 /// RMRK Core proxy differentiates between regular NFTs, and RMRK Parts and Themes.1953 pub fn get_nft_type(1954 collection_id: CollectionId,1955 token_id: TokenId,1956 ) -> Result<NftType, DispatchError> {1957 Self::get_nft_property_decoded(collection_id, token_id, TokenType)1958 .map_err(|_| <Error<T>>::NoAvailableNftId.into())1959 }19601961 /// Ensure that the type of the NFT equals the provided type, otherwise return an error.1962 pub fn ensure_nft_type(1963 collection_id: CollectionId,1964 token_id: TokenId,1965 nft_type: NftType,1966 ) -> DispatchResult {1967 let actual_type = Self::get_nft_type(collection_id, token_id)?;1968 ensure!(actual_type == nft_type, <Error<T>>::NoPermission);19691970 Ok(())1971 }19721973 /// Ensure that an account is the owner of the token, either directly1974 /// or at the top of the nesting hierarchy; return an error if it is not.1975 pub fn ensure_nft_owner(1976 collection_id: CollectionId,1977 token_id: TokenId,1978 possible_owner: &T::CrossAccountId,1979 nesting_budget: &dyn budget::Budget,1980 ) -> DispatchResult {1981 let is_owned = <PalletStructure<T>>::check_indirectly_owned(1982 possible_owner.clone(),1983 collection_id,1984 token_id,1985 None,1986 nesting_budget,1987 )1988 .map_err(Self::map_unique_err_to_proxy)?;19891990 ensure!(is_owned, <Error<T>>::NoPermission);19911992 Ok(())1993 }19941995 /// Fetch non-scoped properties of a collection or a token that match the filter keys supplied,1996 /// or, if None are provided, return all non-scoped properties.1997 pub fn filter_user_properties<Key, Value, R, Mapper>(1998 collection_id: CollectionId,1999 token_id: Option<TokenId>,2000 filter_keys: Option<Vec<RmrkPropertyKey>>,2001 mapper: Mapper,2002 ) -> Result<Vec<R>, DispatchError>2003 where2004 Key: TryFrom<RmrkPropertyKey> + AsRef<[u8]>,2005 Value: Decode + Default,2006 Mapper: Fn(Key, Value) -> R,2007 {2008 filter_keys2009 .map(|keys| {2010 let properties = keys2011 .into_iter()2012 .filter_map(|key| {2013 let key: Key = key.try_into().ok()?;20142015 let value = match token_id {2016 Some(token_id) => Self::get_nft_property_decoded(2017 collection_id,2018 token_id,2019 UserProperty(key.as_ref()),2020 ),2021 None => Self::get_collection_property_decoded(2022 collection_id,2023 UserProperty(key.as_ref()),2024 ),2025 }2026 .ok()?;20272028 Some(mapper(key, value))2029 })2030 .collect();20312032 Ok(properties)2033 })2034 .unwrap_or_else(|| {2035 let properties =2036 Self::iterate_user_properties(collection_id, token_id, mapper)?.collect();20372038 Ok(properties)2039 })2040 }20412042 /// Get all non-scoped properties from a collection or a token, and apply some transformation,2043 /// supplied by `mapper`, to each key-value pair.2044 pub fn iterate_user_properties<Key, Value, R, Mapper>(2045 collection_id: CollectionId,2046 token_id: Option<TokenId>,2047 mapper: Mapper,2048 ) -> Result<impl Iterator<Item = R>, DispatchError>2049 where2050 Key: TryFrom<RmrkPropertyKey> + AsRef<[u8]>,2051 Value: Decode + Default,2052 Mapper: Fn(Key, Value) -> R,2053 {2054 let properties = match token_id {2055 Some(token_id) => <PalletNft<T>>::token_properties((collection_id, token_id)),2056 None => <PalletCommon<T>>::collection_properties(collection_id),2057 };20582059 let properties = properties.into_iter().filter_map(move |(key, value)| {2060 let key = strip_key_prefix(&key, USER_PROPERTY_PREFIX)?;20612062 let key: Key = key.to_vec().try_into().ok()?;2063 let value: Value = value.decode().ok()?;20642065 Some(mapper(key, value))2066 });20672068 Ok(properties)2069 }20702071 /// Match Unique errors to RMRK's own and return the RMRK error if a match is successful.2072 fn map_unique_err_to_proxy(err: DispatchError) -> DispatchError {2073 map_unique_err_to_proxy! {2074 match err {2075 CommonError::NoPermission => NoPermission,2076 CommonError::CollectionTokenLimitExceeded => CollectionFullOrLocked,2077 CommonError::PublicMintingNotAllowed => NoPermission,2078 CommonError::TokenNotFound => NoAvailableNftId,2079 CommonError::ApprovedValueTooLow => NoPermission,2080 CommonError::CantDestroyNotEmptyCollection => CollectionNotEmpty,2081 StructureError::TokenNotFound => NoAvailableNftId,2082 StructureError::OuroborosDetected => CannotSendToDescendentOrSelf,2083 }2084 }2085 }2086}pallets/proxy-rmrk-equip/src/lib.rsdiffbeforeafterboth--- a/pallets/proxy-rmrk-equip/src/lib.rs
+++ b/pallets/proxy-rmrk-equip/src/lib.rs
@@ -52,41 +52,41 @@
//! - FAQ: <https://coda.io/@rmrk/faq>
//! - Substrate code repository: <https://github.com/rmrk-team/rmrk-substrate>
//! - RMRK spec repository: <https://github.com/rmrk-team/rmrk-spec>
-//!
+//!
//! ## Terminology
-//!
+//!
//! For more information on RMRK, see RMRK's own documentation.
-//!
+//!
//! ### Intro to RMRK
-//!
-//! - **Resource:** Additional piece of metadata of an NFT usually serving to add
-//! a piece of media on top of the root metadata (NFT's own), be it a different wing
+//!
+//! - **Resource:** Additional piece of metadata of an NFT usually serving to add
+//! a piece of media on top of the root metadata (NFT's own), be it a different wing
//! on the root template bird or something entirely unrelated.
-//!
-//! - **Base:** A list of possible "components" - Parts, a combination of which can
+//!
+//! - **Base:** A list of possible "components" - Parts, a combination of which can
//! be appended/equipped to/on an NFT.
-//!
-//! - **Part:** Something that, together with other Parts, can constitute an NFT.
-//! Parts are defined in the Base to which they belong. Parts can be either
+//!
+//! - **Part:** Something that, together with other Parts, can constitute an NFT.
+//! Parts are defined in the Base to which they belong. Parts can be either
//! of the `slot` type or `fixed` type. Slots are intended for equippables.
-//! Note that "part of something" and "Part of a Base" can be easily confused,
+//! Note that "part of something" and "Part of a Base" can be easily confused,
//! and in this documentation these words are distinguished by the capital letter.
-//!
-//! - **Theme:** Named objects of variable => value pairs which get interpolated into
-//! the Base's `themable` Parts. Themes can hold any value, but are often represented
+//!
+//! - **Theme:** Named objects of variable => value pairs which get interpolated into
+//! the Base's `themable` Parts. Themes can hold any value, but are often represented
//! in RMRK's examples as colors applied to visible Parts.
-//!
+//!
//! ### Peculiarities in Unique
-//!
-//! - **Scoped properties:** Properties that are normally obscured from users.
-//! Their purpose is to contain structured metadata that was not included in the Unique standard
-//! for collections and tokens, meant to be operated on by proxies and other outliers.
-//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is
-//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined
+//!
+//! - **Scoped properties:** Properties that are normally obscured from users.
+//! Their purpose is to contain structured metadata that was not included in the Unique standard
+//! for collections and tokens, meant to be operated on by proxies and other outliers.
+//! Scoped properties are prefixed with `some-scope:`, where `some-scope` is
+//! an arbitrary keyword, like "rmrk", and `:` is an unacceptable symbol in user-defined
//! properties, which, along with other safeguards, makes them impossible to tamper with.
-//!
-//! - **Auxiliary properties:** A slightly different structure of properties,
-//! trading universality of use for more convenient storage, writes and access.
+//!
+//! - **Auxiliary properties:** A slightly different structure of properties,
+//! trading universality of use for more convenient storage, writes and access.
//! Meant to be inaccessible to end users.
//!
//! ## Proxy Implementation
@@ -121,8 +121,7 @@
//! RMRK introduces the concept of a Base, which is a catalgoue of Parts,
//! possible components of an NFT. Due to its similarity with the functionality
//! of a token collection, a Base is stored and handled as one, and the Base's Parts and Themes
-//! are the collection's NFTs. See [`CollectionType`](pallet_rmrk_core::misc::CollectionType) and
-//! [`NftType`](pallet_rmrk_core::misc::NftType).
+//! are the collection's NFTs. See [`CollectionType`] and [`NftType`].
//!
//! ## Interface
//!
@@ -415,7 +414,7 @@
}
impl<T: Config> Pallet<T> {
- /// Create or renew an NFT serving as a Part.
+ /// Create or renew an NFT serving as a Part inside a collection serving as a Base.
fn create_part(
sender: &T::CrossAccountId,
collection: &NonfungibleHandle<T>,
primitives/rmrk-traits/src/resource.rsdiffbeforeafterboth--- a/primitives/rmrk-traits/src/resource.rs
+++ b/primitives/rmrk-traits/src/resource.rs
@@ -151,8 +151,8 @@
"#)
)]
pub struct ResourceInfo<BoundedString, BoundedParts> {
- /// ID a unique identifier for a resource across all those of a single NFT.
- /// The combination of a collection ID, an NFT ID, and the resource ID must be
+ /// ID is a unique identifier for a resource across all those of a single NFT.
+ /// The combination of a collection ID, an NFT ID, and the resource ID must be
/// unique across the entire RMRK ecosystem.
//#[cfg_attr(feature = "std", serde(with = "serialize::vec"))]
pub id: ResourceId,