git.delta.rocks / unique-network / refs/commits / d4f7a1e6b1bd

--- a/client/rpc/src/lib.rs
+++ b/client/rpc/src/lib.rs
@@ -42,6 +42,7 @@
 #[rpc(server)]
 #[async_trait]
 pub trait UniqueApi<BlockHash, CrossAccountId, AccountId> {
+	/// Get tokens owned by account.
 	#[method(name = "unique_accountTokens")]
 	fn account_tokens(
 		&self,
@@ -49,12 +50,16 @@
 		account: CrossAccountId,
 		at: Option<BlockHash>,
 	) -> Result<Vec<TokenId>>;
+
+	/// Get tokens contained within a collection.
 	#[method(name = "unique_collectionTokens")]
 	fn collection_tokens(
 		&self,
 		collection: CollectionId,
 		at: Option<BlockHash>,
 	) -> Result<Vec<TokenId>>;
+
+	/// Check if the token exists.
 	#[method(name = "unique_tokenExists")]
 	fn token_exists(
 		&self,
@@ -63,6 +68,7 @@
 		at: Option<BlockHash>,
 	) -> Result<bool>;
 
+	/// Get the token owner.
 	#[method(name = "unique_tokenOwner")]
 	fn token_owner(
 		&self,
@@ -80,6 +86,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Vec<CrossAccountId>>;
 
+	/// Get the topmost token owner in the hierarchy of a possibly nested token.
 	#[method(name = "unique_topmostTokenOwner")]
 	fn topmost_token_owner(
 		&self,
@@ -87,6 +94,8 @@
 		token: TokenId,
 		at: Option<BlockHash>,
 	) -> Result<Option<CrossAccountId>>;
+
+	/// Get tokens nested directly into the token.
 	#[method(name = "unique_tokenChildren")]
 	fn token_children(
 		&self,
@@ -95,6 +104,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Vec<TokenChild>>;
 
+	/// Get collection properties, optionally limited to the provided keys.
 	#[method(name = "unique_collectionProperties")]
 	fn collection_properties(
 		&self,
@@ -103,6 +113,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Vec<Property>>;
 
+	/// Get token properties, optionally limited to the provided keys.
 	#[method(name = "unique_tokenProperties")]
 	fn token_properties(
 		&self,
@@ -112,6 +123,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Vec<Property>>;
 
+	/// Get property permissions, optionally limited to the provided keys.
 	#[method(name = "unique_propertyPermissions")]
 	fn property_permissions(
 		&self,
@@ -120,6 +132,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Vec<PropertyKeyPermission>>;
 
+	/// Get token data, including properties, optionally limited to the provided keys, and total pieces for an RFT.
 	#[method(name = "unique_tokenData")]
 	fn token_data(
 		&self,
@@ -129,8 +142,11 @@
 		at: Option<BlockHash>,
 	) -> Result<TokenData<CrossAccountId>>;
 
+	/// Get the amount of distinctive tokens present in a collection.
 	#[method(name = "unique_totalSupply")]
 	fn total_supply(&self, collection: CollectionId, at: Option<BlockHash>) -> Result<u32>;
+
+	/// Get the amount of any user tokens owned by an account.
 	#[method(name = "unique_accountBalance")]
 	fn account_balance(
 		&self,
@@ -138,6 +154,8 @@
 		account: CrossAccountId,
 		at: Option<BlockHash>,
 	) -> Result<u32>;
+
+	/// Get the amount of a specific token owned by an account.
 	#[method(name = "unique_balance")]
 	fn balance(
 		&self,
@@ -146,6 +164,8 @@
 		token: TokenId,
 		at: Option<BlockHash>,
 	) -> Result<String>;
+
+	/// Get the amount of currently possible sponsored transactions on a token for the fee to be taken off a sponsor.
 	#[method(name = "unique_allowance")]
 	fn allowance(
 		&self,
@@ -156,18 +176,23 @@
 		at: Option<BlockHash>,
 	) -> Result<String>;
 
+	/// Get the list of admin accounts of a collection.
 	#[method(name = "unique_adminlist")]
 	fn adminlist(
 		&self,
 		collection: CollectionId,
 		at: Option<BlockHash>,
 	) -> Result<Vec<CrossAccountId>>;
+
+	/// Get the list of accounts allowed to operate within a collection.
 	#[method(name = "unique_allowlist")]
 	fn allowlist(
 		&self,
 		collection: CollectionId,
 		at: Option<BlockHash>,
 	) -> Result<Vec<CrossAccountId>>;
+
+	/// Check if a user is allowed to operate within a collection.
 	#[method(name = "unique_allowed")]
 	fn allowed(
 		&self,
@@ -175,17 +200,24 @@
 		user: CrossAccountId,
 		at: Option<BlockHash>,
 	) -> Result<bool>;
+
+	/// Get the last token ID created in a collection.
 	#[method(name = "unique_lastTokenId")]
 	fn last_token_id(&self, collection: CollectionId, at: Option<BlockHash>) -> Result<TokenId>;
+
+	/// Get collection info by the specified ID.
 	#[method(name = "unique_collectionById")]
 	fn collection_by_id(
 		&self,
 		collection: CollectionId,
 		at: Option<BlockHash>,
 	) -> Result<Option<RpcCollection<AccountId>>>;
+
+	/// Get chain stats about collections.
 	#[method(name = "unique_collectionStats")]
 	fn collection_stats(&self, at: Option<BlockHash>) -> Result<CollectionStats>;
 
+	/// Get the number of blocks until sponsoring a transaction is available.
 	#[method(name = "unique_nextSponsored")]
 	fn next_sponsored(
 		&self,
@@ -195,6 +227,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Option<u64>>;
 
+	/// Get effective collection limits. If not explicitly set, get the chain defaults.
 	#[method(name = "unique_effectiveCollectionLimits")]
 	fn effective_collection_limits(
 		&self,
@@ -202,6 +235,7 @@
 		at: Option<BlockHash>,
 	) -> Result<Option<CollectionLimits>>;
 
+	/// Get the total amount of pieces of an RFT.
 	#[method(name = "unique_totalPieces")]
 	fn total_pieces(
 		&self,
@@ -228,20 +262,20 @@
 		Theme,
 	>
 	{
+		/// Get the latest created collection ID.
 		#[method(name = "rmrk_lastCollectionIdx")]
-		/// Get the latest created collection id
 		fn last_collection_idx(&self, at: Option<BlockHash>) -> Result<RmrkCollectionId>;
 
+		/// Get collection info by ID.
 		#[method(name = "rmrk_collectionById")]
-		/// Get collection by id
 		fn collection_by_id(
 			&self,
 			id: RmrkCollectionId,
 			at: Option<BlockHash>,
 		) -> Result<Option<CollectionInfo>>;
 
+		/// Get NFT info by collection and NFT IDs.
 		#[method(name = "rmrk_nftById")]
-		/// Get NFT by collection id and NFT id
 		fn nft_by_id(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -249,8 +283,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Option<NftInfo>>;
 
+		/// Get tokens owned by an account in a collection.
 		#[method(name = "rmrk_accountTokens")]
-		/// Get tokens owned by an account in a collection
 		fn account_tokens(
 			&self,
 			account_id: AccountId,
@@ -258,8 +292,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<RmrkNftId>>;
 
+		/// Get tokens nested in an NFT - its direct children (not the children's children).
 		#[method(name = "rmrk_nftChildren")]
-		/// Get NFT children
 		fn nft_children(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -267,8 +301,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<RmrkNftChild>>;
 
+		/// Get collection properties, created by the user - not the proxy-specific properties.
 		#[method(name = "rmrk_collectionProperties")]
-		/// Get collection properties
 		fn collection_properties(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -276,8 +310,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<PropertyInfo>>;
 
+		/// Get NFT properties, created by the user - not the proxy-specific properties.
 		#[method(name = "rmrk_nftProperties")]
-		/// Get NFT properties
 		fn nft_properties(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -286,8 +320,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<PropertyInfo>>;
 
+		/// Get data of resources of an NFT.
 		#[method(name = "rmrk_nftResources")]
-		/// Get NFT resources
 		fn nft_resources(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -295,8 +329,8 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<ResourceInfo>>;
 
+		/// Get the priority of a resource in an NFT.
 		#[method(name = "rmrk_nftResourcePriority")]
-		/// Get NFT resource priority
 		fn nft_resource_priority(
 			&self,
 			collection_id: RmrkCollectionId,
@@ -305,14 +339,15 @@
 			at: Option<BlockHash>,
 		) -> Result<Option<u32>>;
 
+		/// Get base info by its ID.
 		#[method(name = "rmrk_base")]
-		/// Get base info
 		fn base(&self, base_id: RmrkBaseId, at: Option<BlockHash>) -> Result<Option<BaseInfo>>;
 
+		/// Get all parts of a base.
 		#[method(name = "rmrk_baseParts")]
-		/// Get all Base's parts
 		fn base_parts(&self, base_id: RmrkBaseId, at: Option<BlockHash>) -> Result<Vec<PartType>>;
 
+		/// Get the theme names belonging to a base.
 		#[method(name = "rmrk_themeNames")]
 		fn theme_names(
 			&self,
@@ -320,6 +355,7 @@
 			at: Option<BlockHash>,
 		) -> Result<Vec<RmrkThemeName>>;
 
+		/// Get theme info, including properties, optionally limited to the provided keys.
 		#[method(name = "rmrk_themes")]
 		fn theme(
 			&self,

--- a/pallets/common/src/lib.rs
+++ b/pallets/common/src/lib.rs
@@ -441,7 +441,7 @@
 			u128,
 		),
 
-		/// The colletion property has been set.
+		/// The colletion property has been added or edited.
 		CollectionPropertySet(
 			/// Id of collection to which property has been set.
 			CollectionId,
@@ -457,7 +457,7 @@
 			PropertyKey,
 		),
 
-		/// The token property has been set.
+		/// The token property has been added or edited.
 		TokenPropertySet(
 			/// Identifier of the collection whose token has the property set.
 			CollectionId,
@@ -477,9 +477,9 @@
 			PropertyKey,
 		),
 
-		/// The colletion property permission has been set.
+		/// The token property permission of a collection has been set.
 		PropertyPermissionSet(
-			/// Id of collection to which property permission has been set.
+			/// ID of collection to which property permission has been set.
 			CollectionId,
 			/// The property permission that was set.
 			PropertyKey,
@@ -524,26 +524,26 @@
 		/// Metadata flag frozen
 		MetadataFlagFrozen,
 
-		/// Item not exists.
+		/// Item does not exist
 		TokenNotFound,
-		/// Item balance not enough.
+		/// Item is balance not enough
 		TokenValueTooLow,
-		/// Requested value more than approved.
+		/// Requested value is more than the approved
 		ApprovedValueTooLow,
 		/// Tried to approve more than owned
 		CantApproveMoreThanOwned,
 
 		/// Can't transfer tokens to ethereum zero address
 		AddressIsZero,
-		/// Target collection doesn't supports this operation
+		/// Target collection doesn't support this operation
 		UnsupportedOperation,
 
-		/// Not sufficient funds to perform action
+		/// Insufficient funds to perform an action
 		NotSufficientFounds,
 
-		/// User not passed nesting rule
+		/// User does not satisfy the nesting rule
 		UserIsNotAllowedToNest,
-		/// Only tokens from specific collections may nest tokens under this
+		/// Only tokens from specific collections may nest tokens under this one
 		SourceCollectionIsNotAllowedToNest,
 
 		/// Tried to store more data than allowed in collection field
@@ -558,7 +558,7 @@
 		/// Property key is too long
 		PropertyKeyIsTooLong,
 
-		/// Only ASCII letters, digits, and '_', '-' are allowed
+		/// Only ASCII letters, digits, and symbols `_`, `-`, and `.` are allowed
 		InvalidCharacterInPropertyKey,
 
 		/// Empty property keys are forbidden
@@ -571,7 +571,7 @@
 		CollectionIsInternal,
 	}
 
-	/// Storage of the count of created collections.
+	/// Storage of the count of created collections. Essentially contains the last collection ID.
 	#[pallet::storage]
 	pub type CreatedCollectionCount<T> = StorageValue<Value = CollectionId, QueryKind = ValueQuery>;
 
@@ -600,7 +600,7 @@
 		OnEmpty = up_data_structs::CollectionProperties,
 	>;
 
-	/// Storage of collection properties permissions.
+	/// Storage of token property permissions of a collection.
 	#[pallet::storage]
 	#[pallet::getter(fn property_permissions)]
 	pub type CollectionPropertyPermissions<T> = StorageMap<
@@ -610,7 +610,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Storage of collection admins count.
+	/// Storage of the amount of collection admins.
 	#[pallet::storage]
 	pub type AdminAmount<T> = StorageMap<
 		Hasher = Blake2_128Concat,
@@ -619,7 +619,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// List of collection admins
+	/// List of collection admins.
 	#[pallet::storage]
 	pub type IsAdmin<T: Config> = StorageNMap<
 		Key = (
@@ -630,7 +630,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Allowlisted collection users
+	/// Allowlisted collection users.
 	#[pallet::storage]
 	pub type Allowlist<T: Config> = StorageNMap<
 		Key = (

--- a/pallets/fungible/src/lib.rs
+++ b/pallets/fungible/src/lib.rs
@@ -119,8 +119,7 @@
 	pub enum Error<T> {
 		/// Not Fungible item data used to mint in Fungible collection.
 		NotFungibleDataUsedToMintFungibleCollectionToken,
-		/// Not default id passed as TokenId argument.
-		/// The default value of TokenId for Fungible collection is 0.
+		/// Fungible tokens hold no ID, and the default value of TokenId for Fungible collection is 0.
 		FungibleItemsHaveNoId,
 		/// Tried to set data for fungible item.
 		FungibleItemsDontHaveData,
@@ -157,7 +156,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Storage for delegated assets.
+	/// Storage for assets delegated to a limited extent to other users.
 	#[pallet::storage]
 	pub type Allowance<T: Config> = StorageNMap<
 		Key = (
@@ -172,7 +171,6 @@
 
 /// Wrapper around untyped collection handle, asserting inner collection is of fungible type.
 /// Required for interaction with Fungible collections, type safety and implementation [`solidity_interface`][`evm_coder::solidity_interface`].
-
 pub struct FungibleHandle<T: Config>(pallet_common::CollectionHandle<T>);
 
 /// Implementation of methods required for dispatching during runtime.

--- a/pallets/nonfungible/src/lib.rs
+++ b/pallets/nonfungible/src/lib.rs
@@ -21,7 +21,7 @@
 //! - [`Config`]
 //! - [`NonfungibleHandle`]
 //! - [`Pallet`]
-//! - [`CommonWeights`]
+//! - [`CommonWeights`](common::CommonWeights)
 //!
 //! ## Overview
 //!
@@ -130,6 +130,8 @@
 pub type CreateItemData<T> = CreateNftExData<<T as pallet_evm::account::Config>::CrossAccountId>;
 pub(crate) type SelfWeightOf<T> = <T as Config>::WeightInfo;
 
+/// Token data, stored independently from other data used to describe it
+/// for the convenience of database access. Notably contains the owner account address.
 #[struct_versioning::versioned(version = 2, upper)]
 #[derive(Encode, Decode, TypeInfo, MaxEncodedLen)]
 pub struct ItemData<CrossAccountId> {
@@ -176,17 +178,17 @@
 	#[pallet::generate_store(pub(super) trait Store)]
 	pub struct Pallet<T>(_);
 
-	/// Amount of tokens minted for collection.
+	/// Total amount of minted tokens in a collection.
 	#[pallet::storage]
 	pub type TokensMinted<T: Config> =
 		StorageMap<Hasher = Twox64Concat, Key = CollectionId, Value = u32, QueryKind = ValueQuery>;
 
-	/// Amount of burnt tokens for collection.
+	/// Amount of burnt tokens in a collection.
 	#[pallet::storage]
 	pub type TokensBurnt<T: Config> =
 		StorageMap<Hasher = Twox64Concat, Key = CollectionId, Value = u32, QueryKind = ValueQuery>;
 
-	/// Custom data serialized to bytes for token.
+	/// Token data, used to partially describe a token.
 	#[pallet::storage]
 	pub type TokenData<T: Config> = StorageNMap<
 		Key = (Key<Twox64Concat, CollectionId>, Key<Twox64Concat, TokenId>),
@@ -194,7 +196,7 @@
 		QueryKind = OptionQuery,
 	>;
 
-	/// Key-Value map stored for token.
+	/// Map of key-value pairs, describing the metadata of a token.
 	#[pallet::storage]
 	#[pallet::getter(fn token_properties)]
 	pub type TokenProperties<T: Config> = StorageNMap<
@@ -204,7 +206,14 @@
 		OnEmpty = up_data_structs::TokenProperties,
 	>;
 
-	/// Custom data that is serialized to bytes and attached to a token property.
+	/// Custom data of a token that is serialized to bytes,
+	/// primarily reserved for on-chain operations,
+	/// normally obscured from the external users.
+	///
+	/// Auxiliary properties are slightly different from
+	/// usual [`TokenProperties`] due to an unlimited number
+	/// and separately stored and written-to key-value pairs.
+	///
 	/// Currently used to store RMRK data.
 	#[pallet::storage]
 	#[pallet::getter(fn token_aux_property)]
@@ -244,7 +253,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Amount of tokens owned by account.
+	/// Amount of tokens owned by an account in a collection.
 	#[pallet::storage]
 	pub type AccountBalance<T: Config> = StorageNMap<
 		Key = (
@@ -255,7 +264,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Allowance set by an owner for a spender for a token.
+	/// Allowance set by a token owner for another user to perform one of certain transactions on a token.
 	#[pallet::storage]
 	pub type Allowance<T: Config> = StorageNMap<
 		Key = (Key<Twox64Concat, CollectionId>, Key<Twox64Concat, TokenId>),
@@ -263,6 +272,7 @@
 		QueryKind = OptionQuery,
 	>;
 
+	/// Upgrade from the old schema to properties.
 	#[pallet::hooks]
 	impl<T: Config> Hooks<BlockNumberFor<T>> for Pallet<T> {
 		fn on_runtime_upgrade() -> Weight {

--- a/pallets/refungible/src/lib.rs
+++ b/pallets/refungible/src/lib.rs
@@ -21,7 +21,7 @@
 //! - [`Config`]
 //! - [`RefungibleHandle`]
 //! - [`Pallet`]
-//! - [`CommonWeights`]
+//! - [`CommonWeights`](common::CommonWeights)
 //!
 //! ## Overview
 //!
@@ -119,6 +119,8 @@
 pub mod weights;
 pub(crate) type SelfWeightOf<T> = <T as Config>::WeightInfo;
 
+/// Token data, stored independently from other data used to describe it
+/// for the convenience of database access. Notably contains the token metadata.
 #[struct_versioning::versioned(version = 2, upper)]
 #[derive(Encode, Decode, Default, TypeInfo, MaxEncodedLen)]
 pub struct ItemData {
@@ -143,13 +145,13 @@
 	pub enum Error<T> {
 		/// Not Refungible item data used to mint in Refungible collection.
 		NotRefungibleDataUsedToMintFungibleCollectionToken,
-		/// Maximum refungibility exceeded
+		/// Maximum refungibility exceeded.
 		WrongRefungiblePieces,
-		/// Refungible token can't be repartitioned by user who isn't owns all pieces
+		/// Refungible token can't be repartitioned by user who isn't owns all pieces.
 		RepartitionWhileNotOwningAllPieces,
-		/// Refungible token can't nest other tokens
+		/// Refungible token can't nest other tokens.
 		RefungibleDisallowsNesting,
-		/// Setting item properties is not allowed
+		/// Setting item properties is not allowed.
 		SettingPropertiesNotAllowed,
 	}
 
@@ -167,17 +169,17 @@
 	#[pallet::generate_store(pub(super) trait Store)]
 	pub struct Pallet<T>(_);
 
-	/// Amount of tokens minted for collection
+	/// Total amount of minted tokens in a collection.
 	#[pallet::storage]
 	pub type TokensMinted<T: Config> =
 		StorageMap<Hasher = Twox64Concat, Key = CollectionId, Value = u32, QueryKind = ValueQuery>;
 
-	/// Amount of burnt tokens for collection
+	/// Amount of tokens burnt in a collection.
 	#[pallet::storage]
 	pub type TokensBurnt<T: Config> =
 		StorageMap<Hasher = Twox64Concat, Key = CollectionId, Value = u32, QueryKind = ValueQuery>;
 
-	/// Custom data serialized to bytes for token
+	/// Token data, used to partially describe a token.
 	#[pallet::storage]
 	pub type TokenData<T: Config> = StorageNMap<
 		Key = (Key<Twox64Concat, CollectionId>, Key<Twox64Concat, TokenId>),
@@ -185,6 +187,7 @@
 		QueryKind = ValueQuery,
 	>;
 
+	/// Amount of pieces a refungible token is split into.
 	#[pallet::storage]
 	#[pallet::getter(fn token_properties)]
 	pub type TokenProperties<T: Config> = StorageNMap<
@@ -202,7 +205,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Used to enumerate tokens owned by account
+	/// Used to enumerate tokens owned by account.
 	#[pallet::storage]
 	pub type Owned<T: Config> = StorageNMap<
 		Key = (
@@ -214,7 +217,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Amount of tokens owned by account
+	/// Amount of tokens (not pieces) partially owned by an account within a collection.
 	#[pallet::storage]
 	pub type AccountBalance<T: Config> = StorageNMap<
 		Key = (
@@ -226,7 +229,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Amount of token pieces owned by account
+	/// Amount of token pieces owned by account.
 	#[pallet::storage]
 	pub type Balance<T: Config> = StorageNMap<
 		Key = (
@@ -239,7 +242,7 @@
 		QueryKind = ValueQuery,
 	>;
 
-	/// Allowance set by an owner for a spender for a token
+	/// Allowance set by a token owner for another user to perform one of certain transactions on a number of pieces of a token.
 	#[pallet::storage]
 	pub type Allowance<T: Config> = StorageNMap<
 		Key = (

--- a/pallets/scheduler/src/lib.rs
+++ b/pallets/scheduler/src/lib.rs
@@ -24,7 +24,7 @@
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
-// 	http://www.apache.org/licenses/LICENSE-2.0
+// 	<http://www.apache.org/licenses/LICENSE-2.0>
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ -50,7 +50,7 @@
 //! Also possible to book a call with a certain frequency.
 //!
 //! Key differences from the original pallet:
-//! https://crates.io/crates/pallet-scheduler
+//! <https://crates.io/crates/pallet-scheduler>
 //! Schedule Id restricted by 16 bytes. Identificator for booked call.
 //! Priority limited by HARD DEADLINE (<= 63). Calls over maximum weight don't include to block.
 //! The maximum weight that may be scheduled per block for any dispatchables of less priority than `schedule::HARD_DEADLINE`.
@@ -267,6 +267,7 @@
 
 	/// A Scheduler-Runtime interface for finer payment handling.
 	pub trait DispatchCall<T: frame_system::Config + Config, SelfContainedSignedInfo> {
+		/// Reserve (lock) the maximum spendings on a call, calculated from its weight and the repetition count.
 		fn reserve_balance(
 			id: ScheduledId,
 			sponsor: <T as frame_system::Config>::AccountId,
@@ -274,7 +275,7 @@
 			count: u32,
 		) -> Result<(), DispatchError>;
 
-		/// Unlock centain amount from payer
+		/// Unreserve (unlock) a certain amount from the payer's reserved funds, returning the change.
 		fn pay_for_call(
 			id: ScheduledId,
 			sponsor: <T as frame_system::Config>::AccountId,
@@ -290,6 +291,7 @@
 			TransactionValidityError,
 		>;
 
+		/// Release unspent reserved funds in case of a schedule cancel.
 		fn cancel_reserve(
 			id: ScheduledId,
 			sponsor: <T as frame_system::Config>::AccountId,
@@ -494,9 +496,8 @@
 					Agenda::<T>::append(wake, Some(s));
 				}
 			}
-			/// Weight should be 0, because transaction already paid
+			// Total weight should be 0, because the transaction is already paid for
 			0
-			//total_weight
 		}
 	}
 

--- a/pallets/structure/src/lib.rs
+++ b/pallets/structure/src/lib.rs
@@ -78,19 +78,19 @@
 
 	#[pallet::error]
 	pub enum Error<T> {
-		/// While searched for owner, got already checked account
+		/// While nesting, encountered an already checked account, detecting a loop.
 		OuroborosDetected,
-		/// While searched for owner, encountered depth limit
+		/// While nesting, reached the depth limit of nesting, exceeding the provided budget.
 		DepthLimit,
-		/// While iterating over children, encountered breadth limit
+		/// While nesting, reached the breadth limit of nesting, exceeding the provided budget.
 		BreadthLimit,
-		/// While searched for owner, found token owner by not-yet-existing token
+		/// Couldn't find the token owner that is itself a token.
 		TokenNotFound,
 	}
 
 	#[pallet::event]
 	pub enum Event<T> {
-		/// Executed call on behalf of token
+		/// Executed call on behalf of the token.
 		Executed(DispatchResult),
 	}
 
@@ -126,11 +126,11 @@
 
 #[derive(PartialEq)]
 pub enum Parent<CrossAccountId> {
-	/// Token owned by normal account
+	/// Token owned by a normal account.
 	User(CrossAccountId),
-	/// Passed token not found
+	/// Could not find the token provided as the owner.
 	TokenNotFound,
-	/// Token owner is another token (target token still may not exist)
+	/// Token owner is another token (still, the target token may not exist).
 	Token(CollectionId, TokenId),
 }
 

--- a/pallets/unique/src/eth/mod.rs
+++ b/pallets/unique/src/eth/mod.rs
@@ -14,6 +14,8 @@
 // You should have received a copy of the GNU General Public License
 // along with Unique Network. If not, see <http://www.gnu.org/licenses/>.
 
+//! Implementation of CollectionHelpers contract.
+
 use core::marker::PhantomData;
 use evm_coder::{execution::*, generate_stubgen, solidity_interface, weight, types::*};
 use ethereum as _;
@@ -33,7 +35,8 @@
 use sp_std::vec::Vec;
 use alloc::format;
 
-struct EvmCollectionHelpers<T: Config>(SubstrateRecorder<T>);
+/// See [`CollectionHelpersCall`]
+pub struct EvmCollectionHelpers<T: Config>(SubstrateRecorder<T>);
 impl<T: Config> WithRecorder<T> for EvmCollectionHelpers<T> {
 	fn recorder(&self) -> &SubstrateRecorder<T> {
 		&self.0
@@ -44,8 +47,14 @@
 	}
 }
 
+/// @title Contract, which allows users to operate with collections
 #[solidity_interface(name = "CollectionHelpers", events(CollectionHelpersEvents))]
 impl<T: Config + pallet_nonfungible::Config> EvmCollectionHelpers<T> {
+	/// Create an NFT collection
+	/// @param name Name of the collection
+	/// @param description Informative description of the collection
+	/// @param token_prefix Token prefix to represent the collection tokens in UI and user applications
+	/// @return address Address of the newly created collection
 	#[weight(<SelfWeightOf<T>>::create_collection())]
 	fn create_nonfungible_collection(
 		&mut self,
@@ -100,6 +109,9 @@
 		Ok(address)
 	}
 
+	/// Check if a collection exists
+	/// @param collection_address Address of the collection in question
+	/// @return bool Does the collection exist?
 	fn is_collection_exist(&self, _caller: caller, collection_address: address) -> Result<bool> {
 		if let Some(id) = pallet_common::eth::map_eth_to_id(&collection_address) {
 			let collection_id = id;
@@ -110,6 +122,7 @@
 	}
 }
 
+/// Implements [`OnMethodCall`], which delegates call to [`EvmCollectionHelpers`]
 pub struct CollectionHelpersOnMethodCall<T: Config>(PhantomData<*const T>);
 impl<T: Config + pallet_nonfungible::Config> OnMethodCall<T> for CollectionHelpersOnMethodCall<T> {
 	fn is_reserved(contract: &sp_core::H160) -> bool {

14// You should have received a copy of the GNU General Public License14// You should have received a copy of the GNU General Public License
15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.
16
17//! # Unique Pallet
18//!
19//! A pallet governing Unique transactions.
20//!
21//! - [`Config`]
22//! - [`Call`]
23//! - [`Pallet`]
24//!
25//! ## Overview
26//!
27//! The Unique pallet's purpose is to be the primary interface between
28//! external users and the inner structure of the Unique chains.
29//!
30//! It also contains an implementation of [`CollectionHelpers`][`eth`],
31//! an Ethereum contract dealing with collection operations.
32//!
33//! ## Interface
34//!
35//! ### Dispatchables
36//!
37//! - `create_collection` - Create a collection of tokens. **Deprecated**, use `create_collection_ex`.
38//! - `create_collection_ex` - Create a collection of tokens with explicit parameters.
39//! - `destroy_collection` - Destroy a collection if no tokens exist within.
40//! - `add_to_allow_list` - Add an address to allow list.
41//! - `remove_from_allow_list` - Remove an address from allow list.
42//! - `change_collection_owner` - Change the owner of the collection.
43//! - `add_collection_admin` - Add an admin to a collection.
44//! - `remove_collection_admin` - Remove admin of a collection.
45//! - `set_collection_sponsor` - Invite a new collection sponsor.
46//! - `confirm_sponsorship` - Confirm own sponsorship of a collection, becoming the sponsor.
47//! - `remove_collection_sponsor` - Remove a sponsor from a collection.
48//! - `create_item` - Create an item within a collection.
49//! - `create_multiple_items` - Create multiple items within a collection.
50//! - `set_collection_properties` - Add or change collection properties.
51//! - `delete_collection_properties` - Delete specified collection properties.
52//! - `set_token_properties` - Add or change token properties.
53//! - `delete_token_properties` - Delete token properties.
54//! - `set_token_property_permissions` - Add or change token property permissions of a collection.
55//! - `create_multiple_items_ex` - Create multiple items within a collection with explicitly specified initial parameters.
56//! - `set_transfers_enabled_flag` - Completely allow or disallow transfers for a particular collection.
57//! - `burn_item` - Destroy an item.
58//! - `burn_from` - Destroy an item on behalf of the owner as a non-owner account.
59//! - `transfer` - Change ownership of the token.
60//! - `transfer_from` - Change ownership of the token on behalf of the owner as a non-owner account.
61//! - `approve` - Allow a non-permissioned address to transfer or burn an item.
62//! - `set_collection_limits` - Set specific limits of a collection.
63//! - `set_collection_permissions` - Set specific permissions of a collection.
64//! - `repartition` - Re-partition a refungible token, while owning all of its parts.
1665
17#![recursion_limit = "1024"]66#![recursion_limit = "1024"]
18#![cfg_attr(not(feature = "std"), no_std)]67#![cfg_attr(not(feature = "std"), no_std)]
54pub mod weights;103pub mod weights;
55use weights::WeightInfo;104use weights::WeightInfo;
56105
106/// Maximum number of levels of depth in the token nesting tree.
57const NESTING_BUDGET: u32 = 5;107pub const NESTING_BUDGET: u32 = 5;
58108
59decl_error! {109decl_error! {
60	/// Error for non-fungible-token module.110	/// Errors for the common Unique transactions.
61	pub enum Error for Module<T: Config> {111	pub enum Error for Module<T: Config> {
62		/// Decimal_points parameter must be lower than MAX_DECIMAL_POINTS constant, currently it is 30.112		/// Decimal_points parameter must be lower than [`up_data_structs::MAX_DECIMAL_POINTS`].
63		CollectionDecimalPointLimitExceeded,113		CollectionDecimalPointLimitExceeded,
64		/// This address is not set as sponsor, use setCollectionSponsor first.114		/// This address is not set as sponsor, use setCollectionSponsor first.
65		ConfirmUnsetSponsorFail,115		ConfirmUnsetSponsorFail,
66		/// Length of items properties must be greater than 0.116		/// Length of items properties must be greater than 0.
67		EmptyArgument,117		EmptyArgument,
68		/// Repertition is only supported by refungible collection118		/// Repertition is only supported by refungible collection.
69		RepartitionCalledOnNonRefungibleCollection,119		RepartitionCalledOnNonRefungibleCollection,
70	}120	}
71}121}
72122
123/// Configuration trait of this pallet.
73pub trait Config: system::Config + pallet_common::Config + Sized + TypeInfo {124pub trait Config: system::Config + pallet_common::Config + Sized + TypeInfo {
125	/// Overarching event type.
74	type Event: From<Event<Self>> + Into<<Self as frame_system::Config>::Event>;126	type Event: From<Event<Self>> + Into<<Self as frame_system::Config>::Event>;
75127
76	/// Weight information for extrinsics in this pallet.128	/// Weight information for extrinsics in this pallet.
77	type WeightInfo: WeightInfo;129	type WeightInfo: WeightInfo;
130
131	/// Weight information for common pallet operations.
78	type CommonWeightInfo: CommonWeightInfo<Self::CrossAccountId>;132	type CommonWeightInfo: CommonWeightInfo<Self::CrossAccountId>;
133
134	/// Weight info information for extra refungible pallet operations.
79	type RefungibleExtensionsWeightInfo: RefungibleExtensionsWeightInfo;135	type RefungibleExtensionsWeightInfo: RefungibleExtensionsWeightInfo;
80}136}
81137
88		/// Collection sponsor was removed144		/// Collection sponsor was removed
89		///145		///
90		/// # Arguments146		/// # Arguments
91		///
92		/// * collection_id: Globally unique collection identifier.147		/// * collection_id: ID of the affected collection.
93		CollectionSponsorRemoved(CollectionId),148		CollectionSponsorRemoved(CollectionId),
94149
95		/// Collection admin was added150		/// Collection admin was added
96		///151		///
97		/// # Arguments152		/// # Arguments
98		///
99		/// * collection_id: Globally unique collection identifier.153		/// * collection_id: ID of the affected collection.
100		///
101		/// * admin:  Admin address.154		/// * admin: Admin address.
102		CollectionAdminAdded(CollectionId, CrossAccountId),155		CollectionAdminAdded(CollectionId, CrossAccountId),
103156
104		/// Collection owned was change157		/// Collection owned was changed
105		///158		///
106		/// # Arguments159		/// # Arguments
107		///
108		/// * collection_id: Globally unique collection identifier.160		/// * collection_id: ID of the affected collection.
109		///
110		/// * owner:  New owner address.161		/// * owner: New owner address.
111		CollectionOwnedChanged(CollectionId, AccountId),162		CollectionOwnedChanged(CollectionId, AccountId),
112163
113		/// Collection sponsor was set164		/// Collection sponsor was set
114		///165		///
115		/// # Arguments166		/// # Arguments
116		///
117		/// * collection_id: Globally unique collection identifier.167		/// * collection_id: ID of the affected collection.
118		///
119		/// * owner:  New sponsor address.168		/// * owner: New sponsor address.
120		CollectionSponsorSet(CollectionId, AccountId),169		CollectionSponsorSet(CollectionId, AccountId),
121170
122		/// New sponsor was confirm171		/// New sponsor was confirm
123		///172		///
124		/// # Arguments173		/// # Arguments
125		///
126		/// * collection_id: Globally unique collection identifier.174		/// * collection_id: ID of the affected collection.
127		///
128		/// * sponsor:  New sponsor address.175		/// * sponsor: New sponsor address.
129		SponsorshipConfirmed(CollectionId, AccountId),176		SponsorshipConfirmed(CollectionId, AccountId),
130177
131		/// Collection admin was removed178		/// Collection admin was removed
132		///179		///
133		/// # Arguments180		/// # Arguments
134		///
135		/// * collection_id: Globally unique collection identifier.181		/// * collection_id: ID of the affected collection.
136		///
137		/// * admin:  Admin address.182		/// * admin: Removed admin address.
138		CollectionAdminRemoved(CollectionId, CrossAccountId),183		CollectionAdminRemoved(CollectionId, CrossAccountId),
139184
140		/// Address was remove from allow list185		/// Address was removed from the allow list
141		///186		///
142		/// # Arguments187		/// # Arguments
143		///
144		/// * collection_id: Globally unique collection identifier.188		/// * collection_id: ID of the affected collection.
145		///
146		/// * user:  Address.189		/// * user: Address of the removed account.
147		AllowListAddressRemoved(CollectionId, CrossAccountId),190		AllowListAddressRemoved(CollectionId, CrossAccountId),
148191
149		/// Address was add to allow list192		/// Address was added to the allow list
150		///193		///
151		/// # Arguments194		/// # Arguments
152		///
153		/// * collection_id: Globally unique collection identifier.195		/// * collection_id: ID of the affected collection.
154		///
155		/// * user:  Address.196		/// * user: Address of the added account.
156		AllowListAddressAdded(CollectionId, CrossAccountId),197		AllowListAddressAdded(CollectionId, CrossAccountId),
157198
158		/// Collection limits was set199		/// Collection limits were set
159		///200		///
160		/// # Arguments201		/// # Arguments
161		///
162		/// * collection_id: Globally unique collection identifier.202		/// * collection_id: ID of the affected collection.
163		CollectionLimitSet(CollectionId),203		CollectionLimitSet(CollectionId),
164204
205		/// Collection permissions were set
206		///
207		/// # Arguments
208		/// * collection_id: ID of the affected collection.
165		CollectionPermissionSet(CollectionId),209		CollectionPermissionSet(CollectionId),
166	}210	}
167}211}
198		ChainVersion: u64;242		ChainVersion: u64;
199		//#endregion243		//#endregion
200244
201		//#region Tokens transfer rate limit baskets245		//#region Tokens transfer sponosoring rate limit baskets
202		/// (Collection id (controlled?2), who created (real))246		/// (Collection id (controlled?2), who created (real))
203		/// TODO: Off chain worker should remove from this map when collection gets removed247		/// TODO: Off chain worker should remove from this map when collection gets removed
204		pub CreateItemBasket get(fn create_item_basket): map hasher(blake2_128_concat) (CollectionId, T::AccountId) => Option<T::BlockNumber>;248		pub CreateItemBasket get(fn create_item_basket): map hasher(blake2_128_concat) (CollectionId, T::AccountId) => Option<T::BlockNumber>;
214		/// Collection id (controlled?2), token id (controlled?2)258		/// Collection id (controlled?2), token id (controlled?2)
215		#[deprecated]259		#[deprecated]
216		pub VariableMetaDataBasket get(fn variable_meta_data_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;260		pub VariableMetaDataBasket get(fn variable_meta_data_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;
261		/// Last sponsoring of token property setting // todo:doc rephrase this and the following
217		pub TokenPropertyBasket get(fn token_property_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;262		pub TokenPropertyBasket get(fn token_property_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;
218263
219		/// Approval sponsoring264		/// Last sponsoring of NFT approval in a collection
220		pub NftApproveBasket get(fn nft_approve_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;265		pub NftApproveBasket get(fn nft_approve_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId => Option<T::BlockNumber>;
266		/// Last sponsoring of fungible tokens approval in a collection
221		pub FungibleApproveBasket get(fn fungible_approve_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(twox_64_concat) T::AccountId => Option<T::BlockNumber>;267		pub FungibleApproveBasket get(fn fungible_approve_basket): double_map hasher(blake2_128_concat) CollectionId, hasher(twox_64_concat) T::AccountId => Option<T::BlockNumber>;
268		/// Last sponsoring of RFT approval in a collection
222		pub RefungibleApproveBasket get(fn refungible_approve_basket): nmap hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId, hasher(twox_64_concat) T::AccountId => Option<T::BlockNumber>;269		pub RefungibleApproveBasket get(fn refungible_approve_basket): nmap hasher(blake2_128_concat) CollectionId, hasher(blake2_128_concat) TokenId, hasher(twox_64_concat) T::AccountId => Option<T::BlockNumber>;
223	}270	}
224}271}
225272
226decl_module! {273decl_module! {
274	/// Type alias to Pallet, to be used by construct_runtime.
227	pub struct Module<T: Config> for enum Call275	pub struct Module<T: Config> for enum Call
228	where276	where
229		origin: T::Origin277		origin: T::Origin
244			0292			0
245		}293		}
246294
247		/// This method creates a Collection of NFTs. Each Token may have multiple properties encoded as an array of bytes of certain length. The initial owner of the collection is set to the address that signed the transaction and can be changed later.295		/// Create a collection of tokens.
296		///
297		/// Each Token may have multiple properties encoded as an array of bytes
298		/// of certain length. The initial owner of the collection is set
299		/// to the address that signed the transaction and can be changed later.
300		///
301		/// Prefer the more advanced [`create_collection_ex`][`Pallet::create_collection_ex`] instead.
248		///302		///
249		/// # Permissions303		/// # Permissions
250		///304		///
251		/// * Anyone.305		/// * Anyone - becomes the owner of the new collection.
252		///306		///
253		/// # Arguments307		/// # Arguments
254		///308		///
255		/// * collection_name: UTF-16 string with collection name (limit 64 characters), will be stored as zero-terminated.309		/// * `collection_name`: Wide-character string with collection name
256		///310		/// (limit [`MAX_COLLECTION_NAME_LENGTH`]).
257		/// * collection_description: UTF-16 string with collection description (limit 256 characters), will be stored as zero-terminated.311		/// * `collection_description`: Wide-character string with collection description
258		///312		/// (limit [`MAX_COLLECTION_DESCRIPTION_LENGTH`]).
259		/// * token_prefix: UTF-8 string with token prefix.313		/// * `token_prefix`: Byte string containing the token prefix to mark a collection
260		///314		/// to which a token belongs (limit [`MAX_TOKEN_PREFIX_LENGTH`]).
261		/// * mode: [CollectionMode] collection type and type dependent data.315		/// * `mode`: Type of items stored in the collection and type dependent data.
262		// returns collection ID316		// returns collection ID
263		#[weight = <SelfWeightOf<T>>::create_collection()]317		#[weight = <SelfWeightOf<T>>::create_collection()]
264		#[transactional]318		#[transactional]
265		#[deprecated]319		#[deprecated(note = "`create_collection_ex` is more up-to-date and advanced, prefer it instead")]
266		pub fn create_collection(origin,320		pub fn create_collection(
321			origin,
267								 collection_name: BoundedVec<u16, ConstU32<MAX_COLLECTION_NAME_LENGTH>>,322			collection_name: BoundedVec<u16, ConstU32<MAX_COLLECTION_NAME_LENGTH>>,
278			Self::create_collection_ex(origin, data)334			Self::create_collection_ex(origin, data)
279		}335		}
280336
281		/// This method creates a collection337		/// Create a collection with explicit parameters.
282		///338		///
283		/// Prefer it to deprecated [`created_collection`] method339		/// Prefer it to the deprecated [`create_collection`][`Pallet::create_collection`] method.
340		///
341		/// # Permissions
342		///
343		/// * Anyone - becomes the owner of the new collection.
344		///
345		/// # Arguments
346		///
347		/// * `data`: Explicit data of a collection used for its creation.
284		#[weight = <SelfWeightOf<T>>::create_collection()]348		#[weight = <SelfWeightOf<T>>::create_collection()]
285		#[transactional]349		#[transactional]
286		pub fn create_collection_ex(origin, data: CreateCollectionData<T::AccountId>) -> DispatchResult {350		pub fn create_collection_ex(origin, data: CreateCollectionData<T::AccountId>) -> DispatchResult {
293			Ok(())357			Ok(())
294		}358		}
295359
296		/// Destroys collection if no tokens within this collection360		/// Destroy a collection if no tokens exist within.
297		///361		///
298		/// # Permissions362		/// # Permissions
299		///363		///
300		/// * Collection Owner.364		/// * Collection owner
301		///365		///
302		/// # Arguments366		/// # Arguments
303		///367		///
304		/// * collection_id: collection to destroy.368		/// * `collection_id`: Collection to destroy.
305		#[weight = <SelfWeightOf<T>>::destroy_collection()]369		#[weight = <SelfWeightOf<T>>::destroy_collection()]
306		#[transactional]370		#[transactional]
307		pub fn destroy_collection(origin, collection_id: CollectionId) -> DispatchResult {371		pub fn destroy_collection(origin, collection_id: CollectionId) -> DispatchResult {
328		///392		///
329		/// # Permissions393		/// # Permissions
330		///394		///
331		/// * Collection Owner395		/// * Collection owner
332		/// * Collection Admin396		/// * Collection admin
333		///397		///
334		/// # Arguments398		/// # Arguments
335		///399		///
336		/// * collection_id.400		/// * `collection_id`: ID of the modified collection.
337		///401		/// * `address`: ID of the address to be added to the allowlist.
338		/// * address.
339		#[weight = <SelfWeightOf<T>>::add_to_allow_list()]402		#[weight = <SelfWeightOf<T>>::add_to_allow_list()]
340		#[transactional]403		#[transactional]
341		pub fn add_to_allow_list(origin, collection_id: CollectionId, address: T::CrossAccountId) -> DispatchResult{404		pub fn add_to_allow_list(origin, collection_id: CollectionId, address: T::CrossAccountId) -> DispatchResult{
363		///426		///
364		/// # Permissions427		/// # Permissions
365		///428		///
366		/// * Collection Owner429		/// * Collection owner
367		/// * Collection Admin430		/// * Collection admin
368		///431		///
369		/// # Arguments432		/// # Arguments
370		///433		///
371		/// * collection_id.434		/// * `collection_id`: ID of the modified collection.
372		///435		/// * `address`: ID of the address to be removed from the allowlist.
373		/// * address.
374		#[weight = <SelfWeightOf<T>>::remove_from_allow_list()]436		#[weight = <SelfWeightOf<T>>::remove_from_allow_list()]
375		#[transactional]437		#[transactional]
376		pub fn remove_from_allow_list(origin, collection_id: CollectionId, address: T::CrossAccountId) -> DispatchResult{438		pub fn remove_from_allow_list(origin, collection_id: CollectionId, address: T::CrossAccountId) -> DispatchResult{
398		///460		///
399		/// # Permissions461		/// # Permissions
400		///462		///
401		/// * Collection Owner.463		/// * Collection owner
402		///464		///
403		/// # Arguments465		/// # Arguments
404		///466		///
405		/// * collection_id.467		/// * `collection_id`: ID of the modified collection.
406		///468		/// * `new_owner`: ID of the account that will become the owner.
407		/// * new_owner.
408		#[weight = <SelfWeightOf<T>>::change_collection_owner()]469		#[weight = <SelfWeightOf<T>>::change_collection_owner()]
409		#[transactional]470		#[transactional]
410		pub fn change_collection_owner(origin, collection_id: CollectionId, new_owner: T::AccountId) -> DispatchResult {471		pub fn change_collection_owner(origin, collection_id: CollectionId, new_owner: T::AccountId) -> DispatchResult {
424			target_collection.save()485			target_collection.save()
425		}486		}
426487
427		/// Adds an admin of the Collection.488		/// Add an admin to a collection.
428		/// NFT Collection can be controlled by multiple admin addresses (some which can also be servers, for example). Admins can issue and burn NFTs, as well as add and remove other admins, but cannot change NFT or Collection ownership.489		///
490		/// NFT Collection can be controlled by multiple admin addresses
491		/// (some which can also be servers, for example). Admins can issue
492		/// and burn NFTs, as well as add and remove other admins,
493		/// but cannot change NFT or Collection ownership.
429		///494		///
430		/// # Permissions495		/// # Permissions
431		///496		///
432		/// * Collection Owner.497		/// * Collection owner
433		/// * Collection Admin.498		/// * Collection admin
434		///499		///
435		/// # Arguments500		/// # Arguments
436		///501		///
437		/// * collection_id: ID of the Collection to add admin for.502		/// * `collection_id`: ID of the Collection to add an admin for.
438		///
439		/// * new_admin_id: Address of new admin to add.503		/// * `new_admin`: Address of new admin to add.
440		#[weight = <SelfWeightOf<T>>::add_collection_admin()]504		#[weight = <SelfWeightOf<T>>::add_collection_admin()]
441		#[transactional]505		#[transactional]
442		pub fn add_collection_admin(origin, collection_id: CollectionId, new_admin_id: T::CrossAccountId) -> DispatchResult {506		pub fn add_collection_admin(origin, collection_id: CollectionId, new_admin: T::CrossAccountId) -> DispatchResult {
443			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);507			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);
444			let collection = <CollectionHandle<T>>::try_get(collection_id)?;508			let collection = <CollectionHandle<T>>::try_get(collection_id)?;
445			collection.check_is_internal()?;509			collection.check_is_internal()?;
446510
447			<Pallet<T>>::deposit_event(Event::<T>::CollectionAdminAdded(511			<Pallet<T>>::deposit_event(Event::<T>::CollectionAdminAdded(
448				collection_id,512				collection_id,
449				new_admin_id.clone()513				new_admin.clone()
450			));514			));
451515
452			<PalletCommon<T>>::toggle_admin(&collection, &sender, &new_admin_id, true)516			<PalletCommon<T>>::toggle_admin(&collection, &sender, &new_admin, true)
453		}517		}
454518
455		/// Remove admin address of the Collection. An admin address can remove itself. List of admins may become empty, in which case only Collection Owner will be able to add an Admin.519		/// Remove admin of a collection.
520		///
521		/// An admin address can remove itself. List of admins may become empty,
522		/// in which case only Collection Owner will be able to add an Admin.
456		///523		///
457		/// # Permissions524		/// # Permissions
458		///525		///
459		/// * Collection Owner.526		/// * Collection owner
460		/// * Collection Admin.527		/// * Collection admin
461		///528		///
462		/// # Arguments529		/// # Arguments
463		///530		///
464		/// * collection_id: ID of the Collection to remove admin for.531		/// * `collection_id`: ID of the collection to remove the admin for.
465		///
466		/// * account_id: Address of admin to remove.532		/// * `account_id`: Address of the admin to remove.
467		#[weight = <SelfWeightOf<T>>::remove_collection_admin()]533		#[weight = <SelfWeightOf<T>>::remove_collection_admin()]
468		#[transactional]534		#[transactional]
469		pub fn remove_collection_admin(origin, collection_id: CollectionId, account_id: T::CrossAccountId) -> DispatchResult {535		pub fn remove_collection_admin(origin, collection_id: CollectionId, account_id: T::CrossAccountId) -> DispatchResult {
479			<PalletCommon<T>>::toggle_admin(&collection, &sender, &account_id, false)545			<PalletCommon<T>>::toggle_admin(&collection, &sender, &account_id, false)
480		}546		}
481547
548		/// Set (invite) a new collection sponsor.
549		///
550		/// If successful, confirmation from the sponsor-to-be will be pending.
551		///
482		/// # Permissions552		/// # Permissions
483		///553		///
484		/// * Collection Owner554		/// * Collection owner
555		/// * Collection admin
485		///556		///
486		/// # Arguments557		/// # Arguments
487		///558		///
488		/// * collection_id.559		/// * `collection_id`: ID of the modified collection.
489		///560		/// * `new_sponsor`: ID of the account of the sponsor-to-be.
490		/// * new_sponsor.
491		#[weight = <SelfWeightOf<T>>::set_collection_sponsor()]561		#[weight = <SelfWeightOf<T>>::set_collection_sponsor()]
492		#[transactional]562		#[transactional]
493		pub fn set_collection_sponsor(origin, collection_id: CollectionId, new_sponsor: T::AccountId) -> DispatchResult {563		pub fn set_collection_sponsor(origin, collection_id: CollectionId, new_sponsor: T::AccountId) -> DispatchResult {
507			target_collection.save()577			target_collection.save()
508		}578		}
509579
580		/// Confirm own sponsorship of a collection, becoming the sponsor.
581		///
582		/// An invitation must be pending, see [`set_collection_sponsor`][`Pallet::set_collection_sponsor`].
583		/// Sponsor can pay the fees of a transaction instead of the sender,
584		/// but only within specified limits.
585		///
510		/// # Permissions586		/// # Permissions
511		///587		///
512		/// * Sponsor.588		/// * Sponsor-to-be
513		///589		///
514		/// # Arguments590		/// # Arguments
515		///591		///
516		/// * collection_id.592		/// * `collection_id`: ID of the collection with the pending sponsor.
517		#[weight = <SelfWeightOf<T>>::confirm_sponsorship()]593		#[weight = <SelfWeightOf<T>>::confirm_sponsorship()]
518		#[transactional]594		#[transactional]
519		pub fn confirm_sponsorship(origin, collection_id: CollectionId) -> DispatchResult {595		pub fn confirm_sponsorship(origin, collection_id: CollectionId) -> DispatchResult {
534			target_collection.save()610			target_collection.save()
535		}611		}
536612
537		/// Switch back to pay-per-own-transaction model.613		/// Remove a collection's a sponsor, making everyone pay for their own transactions.
538		///614		///
539		/// # Permissions615		/// # Permissions
540		///616		///
541		/// * Collection owner.617		/// * Collection owner
542		///618		///
543		/// # Arguments619		/// # Arguments
544		///620		///
545		/// * collection_id.621		/// * `collection_id`: ID of the collection with the sponsor to remove.
546		#[weight = <SelfWeightOf<T>>::remove_collection_sponsor()]622		#[weight = <SelfWeightOf<T>>::remove_collection_sponsor()]
547		#[transactional]623		#[transactional]
548		pub fn remove_collection_sponsor(origin, collection_id: CollectionId) -> DispatchResult {624		pub fn remove_collection_sponsor(origin, collection_id: CollectionId) -> DispatchResult {
560			target_collection.save()636			target_collection.save()
561		}637		}
562638
563		/// This method creates a concrete instance of NFT Collection created with CreateCollection method.639		/// Mint an item within a collection.
640		///
641		/// A collection must exist first, see [`create_collection_ex`][`Pallet::create_collection_ex`].
564		///642		///
565		/// # Permissions643		/// # Permissions
566		///644		///
567		/// * Collection Owner.645		/// * Collection owner
568		/// * Collection Admin.646		/// * Collection admin
569		/// * Anyone if647		/// * Anyone if
570		///     * Allow List is enabled, and648		///     * Allow List is enabled, and
571		///     * Address is added to allow list, and649		///     * Address is added to allow list, and
572		///     * MintPermission is enabled (see SetMintPermission method)650		///     * MintPermission is enabled (see [`set_collection_permissions`][`Pallet::set_collection_permissions`])
573		///651		///
574		/// # Arguments652		/// # Arguments
575		///653		///
576		/// * collection_id: ID of the collection.654		/// * `collection_id`: ID of the collection to which an item would belong.
577		///
578		/// * owner: Address, initial owner of the NFT.655		/// * `owner`: Address of the initial owner of the item.
579		///
580		/// * data: Token data to store on chain.656		/// * `data`: Token data describing the item to store on chain.
581		#[weight = T::CommonWeightInfo::create_item()]657		#[weight = T::CommonWeightInfo::create_item()]
582		#[transactional]658		#[transactional]
583		pub fn create_item(origin, collection_id: CollectionId, owner: T::CrossAccountId, data: CreateItemData) -> DispatchResultWithPostInfo {659		pub fn create_item(origin, collection_id: CollectionId, owner: T::CrossAccountId, data: CreateItemData) -> DispatchResultWithPostInfo {
587			dispatch_tx::<T, _>(collection_id, |d| d.create_item(sender, owner, data, &budget))663			dispatch_tx::<T, _>(collection_id, |d| d.create_item(sender, owner, data, &budget))
588		}664		}
589665
590		/// This method creates multiple items in a collection created with CreateCollection method.666		/// Create multiple items within a collection.
667		///
668		/// A collection must exist first, see [`create_collection_ex`][`Pallet::create_collection_ex`].
591		///669		///
592		/// # Permissions670		/// # Permissions
593		///671		///
594		/// * Collection Owner.672		/// * Collection owner
595		/// * Collection Admin.673		/// * Collection admin
596		/// * Anyone if674		/// * Anyone if
597		///     * Allow List is enabled, and675		///     * Allow List is enabled, and
598		///     * Address is added to allow list, and676		///     * Address is added to the allow list, and
599		///     * MintPermission is enabled (see SetMintPermission method)677		///     * MintPermission is enabled (see [`set_collection_permissions`][`Pallet::set_collection_permissions`])
600		///678		///
601		/// # Arguments679		/// # Arguments
602		///680		///
603		/// * collection_id: ID of the collection.681		/// * `collection_id`: ID of the collection to which the tokens would belong.
604		///
605		/// * itemsData: Array items properties. Each property is an array of bytes itself, see [create_item].
606		///
607		/// * owner: Address, initial owner of the NFT.682		/// * `owner`: Address of the initial owner of the tokens.
683		/// * `items_data`: Vector of data describing each item to be created.
608		#[weight = T::CommonWeightInfo::create_multiple_items(&items_data)]684		#[weight = T::CommonWeightInfo::create_multiple_items(&items_data)]
609		#[transactional]685		#[transactional]
610		pub fn create_multiple_items(origin, collection_id: CollectionId, owner: T::CrossAccountId, items_data: Vec<CreateItemData>) -> DispatchResultWithPostInfo {686		pub fn create_multiple_items(origin, collection_id: CollectionId, owner: T::CrossAccountId, items_data: Vec<CreateItemData>) -> DispatchResultWithPostInfo {
615			dispatch_tx::<T, _>(collection_id, |d| d.create_multiple_items(sender, owner, items_data, &budget))691			dispatch_tx::<T, _>(collection_id, |d| d.create_multiple_items(sender, owner, items_data, &budget))
616		}692		}
617693
694		/// Add or change collection properties.
695		///
696		/// # Permissions
697		///
698		/// * Collection owner
699		/// * Collection admin
700		///
701		/// # Arguments
702		///
703		/// * `collection_id`: ID of the modified collection.
704		/// * `properties`: Vector of key-value pairs stored as the collection's metadata.
705		/// Keys support Latin letters, `-`, `_`, and `.` as symbols.
618		#[weight = T::CommonWeightInfo::set_collection_properties(properties.len() as u32)]706		#[weight = T::CommonWeightInfo::set_collection_properties(properties.len() as u32)]
619		#[transactional]707		#[transactional]
620		pub fn set_collection_properties(708		pub fn set_collection_properties(
629			dispatch_tx::<T, _>(collection_id, |d| d.set_collection_properties(sender, properties))717			dispatch_tx::<T, _>(collection_id, |d| d.set_collection_properties(sender, properties))
630		}718		}
631719
720		/// Delete specified collection properties.
721		///
722		/// # Permissions
723		///
724		/// * Collection Owner
725		/// * Collection Admin
726		///
727		/// # Arguments
728		///
729		/// * `collection_id`: ID of the modified collection.
730		/// * `property_keys`: Vector of keys of the properties to be deleted.
731		/// Keys support Latin letters, `-`, `_`, and `.` as symbols.
632		#[weight = T::CommonWeightInfo::delete_collection_properties(property_keys.len() as u32)]732		#[weight = T::CommonWeightInfo::delete_collection_properties(property_keys.len() as u32)]
633		#[transactional]733		#[transactional]
634		pub fn delete_collection_properties(734		pub fn delete_collection_properties(
643			dispatch_tx::<T, _>(collection_id, |d| d.delete_collection_properties(&sender, property_keys))743			dispatch_tx::<T, _>(collection_id, |d| d.delete_collection_properties(&sender, property_keys))
644		}744		}
645745
746		/// Add or change token properties according to collection's permissions.
747		/// Currently properties only work with NFTs.
748		///
749		/// # Permissions
750		///
751		/// * Depends on collection's token property permissions and specified property mutability:
752		/// 	* Collection owner
753		/// 	* Collection admin
754		/// 	* Token owner
755		///
756		/// See [`set_token_property_permissions`][`Pallet::set_token_property_permissions`].
757		///
758		/// # Arguments
759		///
760		/// * `collection_id: ID of the collection to which the token belongs.
761		/// * `token_id`: ID of the modified token.
762		/// * `properties`: Vector of key-value pairs stored as the token's metadata.
763		/// Keys support Latin letters, `-`, `_`, and `.` as symbols.
646		#[weight = T::CommonWeightInfo::set_token_properties(properties.len() as u32)]764		#[weight = T::CommonWeightInfo::set_token_properties(properties.len() as u32)]
647		#[transactional]765		#[transactional]
648		pub fn set_token_properties(766		pub fn set_token_properties(
659			dispatch_tx::<T, _>(collection_id, |d| d.set_token_properties(sender, token_id, properties, &budget))777			dispatch_tx::<T, _>(collection_id, |d| d.set_token_properties(sender, token_id, properties, &budget))
660		}778		}
661779
780		/// Delete specified token properties. Currently properties only work with NFTs.
781		///
782		/// # Permissions
783		///
784		/// * Depends on collection's token property permissions and specified property mutability:
785		/// 	* Collection owner
786		/// 	* Collection admin
787		/// 	* Token owner
788		///
789		/// # Arguments
790		///
791		/// * `collection_id`: ID of the collection to which the token belongs.
792		/// * `token_id`: ID of the modified token.
793		/// * `property_keys`: Vector of keys of the properties to be deleted.
794		/// Keys support Latin letters, `-`, `_`, and `.` as symbols.
662		#[weight = T::CommonWeightInfo::delete_token_properties(property_keys.len() as u32)]795		#[weight = T::CommonWeightInfo::delete_token_properties(property_keys.len() as u32)]
663		#[transactional]796		#[transactional]
664		pub fn delete_token_properties(797		pub fn delete_token_properties(
675			dispatch_tx::<T, _>(collection_id, |d| d.delete_token_properties(sender, token_id, property_keys, &budget))808			dispatch_tx::<T, _>(collection_id, |d| d.delete_token_properties(sender, token_id, property_keys, &budget))
676		}809		}
677810
811		/// Add or change token property permissions of a collection.
812		///
813		/// Without a permission for a particular key, a property with that key
814		/// cannot be created in a token.
815		///
816		/// # Permissions
817		///
818		/// * Collection owner
819		/// * Collection admin
820		///
821		/// # Arguments
822		///
823		/// * `collection_id`: ID of the modified collection.
824		/// * `property_permissions`: Vector of permissions for property keys.
825		/// Keys support Latin letters, `-`, `_`, and `.` as symbols.
678		#[weight = T::CommonWeightInfo::set_token_property_permissions(property_permissions.len() as u32)]826		#[weight = T::CommonWeightInfo::set_token_property_permissions(property_permissions.len() as u32)]
679		#[transactional]827		#[transactional]
680		pub fn set_token_property_permissions(828		pub fn set_token_property_permissions(
689			dispatch_tx::<T, _>(collection_id, |d| d.set_token_property_permissions(&sender, property_permissions))837			dispatch_tx::<T, _>(collection_id, |d| d.set_token_property_permissions(&sender, property_permissions))
690		}838		}
691839
840		/// Create multiple items within a collection with explicitly specified initial parameters.
841		///
842		/// # Permissions
843		///
844		/// * Collection owner
845		/// * Collection admin
846		/// * Anyone if
847		///     * Allow List is enabled, and
848		///     * Address is added to allow list, and
849		///     * MintPermission is enabled (see [`set_collection_permissions`][`Pallet::set_collection_permissions`])
850		///
851		/// # Arguments
852		///
853		/// * `collection_id`: ID of the collection to which the tokens would belong.
854		/// * `data`: Explicit item creation data.
692		#[weight = T::CommonWeightInfo::create_multiple_items_ex(&data)]855		#[weight = T::CommonWeightInfo::create_multiple_items_ex(&data)]
693		#[transactional]856		#[transactional]
694		pub fn create_multiple_items_ex(origin, collection_id: CollectionId, data: CreateItemExData<T::CrossAccountId>) -> DispatchResultWithPostInfo {857		pub fn create_multiple_items_ex(origin, collection_id: CollectionId, data: CreateItemExData<T::CrossAccountId>) -> DispatchResultWithPostInfo {
698			dispatch_tx::<T, _>(collection_id, |d| d.create_multiple_items_ex(sender, data, &budget))861			dispatch_tx::<T, _>(collection_id, |d| d.create_multiple_items_ex(sender, data, &budget))
699		}862		}
700863
701		/// Set transfers_enabled value for particular collection864		/// Completely allow or disallow transfers for a particular collection.
702		///865		///
703		/// # Permissions866		/// # Permissions
704		///867		///
705		/// * Collection Owner.868		/// * Collection owner
706		///869		///
707		/// # Arguments870		/// # Arguments
708		///871		///
709		/// * collection_id: ID of the collection.872		/// * `collection_id`: ID of the collection.
710		///873		/// * `value`: New value of the flag, are transfers allowed?
711		/// * value: New flag value.
712		#[weight = <SelfWeightOf<T>>::set_transfers_enabled_flag()]874		#[weight = <SelfWeightOf<T>>::set_transfers_enabled_flag()]
713		#[transactional]875		#[transactional]
714		pub fn set_transfers_enabled_flag(origin, collection_id: CollectionId, value: bool) -> DispatchResult {876		pub fn set_transfers_enabled_flag(origin, collection_id: CollectionId, value: bool) -> DispatchResult {
723			target_collection.save()885			target_collection.save()
724		}886		}
725887
726		/// Destroys a concrete instance of NFT.888		/// Destroy an item.
727		///889		///
728		/// # Permissions890		/// # Permissions
729		///891		///
730		/// * Collection Owner.892		/// * Collection owner
731		/// * Collection Admin.893		/// * Collection admin
732		/// * Current NFT Owner.894		/// * Current item owner
733		///895		///
734		/// # Arguments896		/// # Arguments
735		///897		///
736		/// * collection_id: ID of the collection.898		/// * `collection_id`: ID of the collection to which the item belongs.
737		///
738		/// * item_id: ID of NFT to burn.899		/// * `item_id`: ID of item to burn.
900		/// * `value`: Number of pieces of the item to destroy.
901		/// 	* Non-Fungible Mode: An NFT is indivisible, there is always 1 corresponding to an ID.
902		///     * Fungible Mode: The desired number of pieces to burn.
903		///     * Re-Fungible Mode: The desired number of pieces to burn.
739		#[weight = T::CommonWeightInfo::burn_item()]904		#[weight = T::CommonWeightInfo::burn_item()]
740		#[transactional]905		#[transactional]
741		pub fn burn_item(origin, collection_id: CollectionId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {906		pub fn burn_item(origin, collection_id: CollectionId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {
752			Ok(post_info)917			Ok(post_info)
753		}918		}
754919
755		/// Destroys a concrete instance of NFT on behalf of the owner920		/// Destroy a token on behalf of the owner as a non-owner account.
921		///
756		/// See also: [`approve`]922		/// See also: [`approve`][`Pallet::approve`].
923		///
924		/// After this method executes, one approval is removed from the total so that
925		/// the approved address will not be able to transfer this item again from this owner.
757		///926		///
758		/// # Permissions927		/// # Permissions
759		///928		///
760		/// * Collection Owner.929		/// * Collection owner
761		/// * Collection Admin.930		/// * Collection admin
762		/// * Current NFT Owner.931		/// * Current token owner
932		/// * Address approved by current item owner
763		///933		///
764		/// # Arguments934		/// # Arguments
765		///935		///
936		/// * `from`: The owner of the burning item.
766		/// * collection_id: ID of the collection.937		/// * `collection_id`: ID of the collection to which the item belongs.
767		///
768		/// * item_id: ID of NFT to burn.938		/// * `item_id`: ID of item to burn.
769		///939		/// * `value`: Number of pieces to burn.
770		/// * from: owner of item940		/// 	* Non-Fungible Mode: An NFT is indivisible, there is always 1 corresponding to an ID.
941		///     * Fungible Mode: The desired number of pieces to burn.
942		///     * Re-Fungible Mode: The desired number of pieces to burn.
771		#[weight = T::CommonWeightInfo::burn_from()]943		#[weight = T::CommonWeightInfo::burn_from()]
772		#[transactional]944		#[transactional]
773		pub fn burn_from(origin, collection_id: CollectionId, from: T::CrossAccountId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {945		pub fn burn_from(origin, collection_id: CollectionId, from: T::CrossAccountId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {
781		///953		///
782		/// # Permissions954		/// # Permissions
783		///955		///
784		/// * Collection Owner956		/// * Collection owner
785		/// * Collection Admin957		/// * Collection admin
786		/// * Current NFT owner958		/// * Current token owner
787		///959		///
788		/// # Arguments960		/// # Arguments
789		///961		///
790		/// * recipient: Address of token recipient.962		/// * `recipient`: Address of token recipient.
791		///963		/// * `collection_id`: ID of the collection the item belongs to.
792		/// * collection_id.
793		///
794		/// * item_id: ID of the item964		/// * `item_id`: ID of the item.
795		///     * Non-Fungible Mode: Required.965		///     * Non-Fungible Mode: Required.
796		///     * Fungible Mode: Ignored.966		///     * Fungible Mode: Ignored.
797		///     * Re-Fungible Mode: Required.967		///     * Re-Fungible Mode: Required.
798		///968		///
799		/// * value: Amount to transfer.969		/// * `value`: Amount to transfer.
800		///     * Non-Fungible Mode: Ignored970		/// 	* Non-Fungible Mode: An NFT is indivisible, there is always 1 corresponding to an ID.
801		///     * Fungible Mode: Must specify transferred amount971		///     * Fungible Mode: The desired number of pieces to transfer.
802		///     * Re-Fungible Mode: Must specify transferred portion (between 0 and 1)972		///     * Re-Fungible Mode: The desired number of pieces to transfer.
803		#[weight = T::CommonWeightInfo::transfer()]973		#[weight = T::CommonWeightInfo::transfer()]
804		#[transactional]974		#[transactional]
805		pub fn transfer(origin, recipient: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {975		pub fn transfer(origin, recipient: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, value: u128) -> DispatchResultWithPostInfo {
809			dispatch_tx::<T, _>(collection_id, |d| d.transfer(sender, recipient, item_id, value, &budget))979			dispatch_tx::<T, _>(collection_id, |d| d.transfer(sender, recipient, item_id, value, &budget))
810		}980		}
811981
812		/// Set, change, or remove approved address to transfer the ownership of the NFT.982		/// Allow a non-permissioned address to transfer or burn an item.
813		///983		///
814		/// # Permissions984		/// # Permissions
815		///985		///
816		/// * Collection Owner986		/// * Collection owner
817		/// * Collection Admin987		/// * Collection admin
818		/// * Current NFT owner988		/// * Current item owner
819		///989		///
820		/// # Arguments990		/// # Arguments
821		///991		///
822		/// * approved: Address that is approved to transfer this NFT or zero (if needed to remove approval).992		/// * `spender`: Account to be approved to make specific transactions on non-owned tokens.
823		///993		/// * `collection_id`: ID of the collection the item belongs to.
824		/// * collection_id.
825		///
826		/// * item_id: ID of the item.994		/// * `item_id`: ID of the item transactions on which are now approved.
995		/// * `amount`: Number of pieces of the item approved for a transaction (maximum of 1 for NFTs).
996		/// Set to 0 to revoke the approval.
827		#[weight = T::CommonWeightInfo::approve()]997		#[weight = T::CommonWeightInfo::approve()]
828		#[transactional]998		#[transactional]
829		pub fn approve(origin, spender: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, amount: u128) -> DispatchResultWithPostInfo {999		pub fn approve(origin, spender: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, amount: u128) -> DispatchResultWithPostInfo {
832			dispatch_tx::<T, _>(collection_id, |d| d.approve(sender, spender, item_id, amount))1002			dispatch_tx::<T, _>(collection_id, |d| d.approve(sender, spender, item_id, amount))
833		}1003		}
8341004
835		/// Change ownership of a NFT on behalf of the owner. See Approve method for additional information. After this method executes, the approval is removed so that the approved address will not be able to transfer this NFT again from this owner.1005		/// Change ownership of an item on behalf of the owner as a non-owner account.
836		///1006		///
837		/// # Permissions1007		/// See the [`approve`][`Pallet::approve`] method for additional information.
838		/// * Collection Owner
839		/// * Collection Admin
840		/// * Current NFT owner
841		/// * Address approved by current NFT owner
842		///1008		///
843		/// # Arguments1009		/// After this method executes, one approval is removed from the total so that
1010		/// the approved address will not be able to transfer this item again from this owner.
844		///1011		///
845		/// * from: Address that owns token.1012		/// # Permissions
846		///1013		///
847		/// * recipient: Address of token recipient.1014		/// * Collection owner
848		///
849		/// * collection_id.1015		/// * Collection admin
1016		/// * Current item owner
1017		/// * Address approved by current item owner
850		///1018		///
851		/// * item_id: ID of the item.1019		/// # Arguments
852		///1020		///
1021		/// * `from`: Address that currently owns the token.
1022		/// * `recipient`: Address of the new token-owner-to-be.
1023		/// * `collection_id`: ID of the collection the item.
1024		/// * `item_id`: ID of the item to be transferred.
853		/// * value: Amount to transfer.1025		/// * `value`: Amount to transfer.
1026		/// 	* Non-Fungible Mode: An NFT is indivisible, there is always 1 corresponding to an ID.
1027		///     * Fungible Mode: The desired number of pieces to transfer.
1028		///     * Re-Fungible Mode: The desired number of pieces to transfer.
854		#[weight = T::CommonWeightInfo::transfer_from()]1029		#[weight = T::CommonWeightInfo::transfer_from()]
855		#[transactional]1030		#[transactional]
856		pub fn transfer_from(origin, from: T::CrossAccountId, recipient: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, value: u128 ) -> DispatchResultWithPostInfo {1031		pub fn transfer_from(origin, from: T::CrossAccountId, recipient: T::CrossAccountId, collection_id: CollectionId, item_id: TokenId, value: u128 ) -> DispatchResultWithPostInfo {
860			dispatch_tx::<T, _>(collection_id, |d| d.transfer_from(sender, from, recipient, item_id, value, &budget))1035			dispatch_tx::<T, _>(collection_id, |d| d.transfer_from(sender, from, recipient, item_id, value, &budget))
861		}1036		}
8621037
1038		/// Set specific limits of a collection. Empty, or None fields mean chain default.
1039		///
1040		/// # Permissions
1041		///
1042		/// * Collection owner
1043		/// * Collection admin
1044		///
1045		/// # Arguments
1046		///
1047		/// * `collection_id`: ID of the modified collection.
1048		/// * `new_limit`: New limits of the collection. Fields that are not set (None)
1049		/// will not overwrite the old ones.
863		#[weight = <SelfWeightOf<T>>::set_collection_limits()]1050		#[weight = <SelfWeightOf<T>>::set_collection_limits()]
864		#[transactional]1051		#[transactional]
865		pub fn set_collection_limits(1052		pub fn set_collection_limits(
882			target_collection.save()1069			target_collection.save()
883		}1070		}
8841071
1072		/// Set specific permissions of a collection. Empty, or None fields mean chain default.
1073		///
1074		/// # Permissions
1075		///
1076		/// * Collection owner
1077		/// * Collection admin
1078		///
1079		/// # Arguments
1080		///
1081		/// * `collection_id`: ID of the modified collection.
1082		/// * `new_permission`: New permissions of the collection. Fields that are not set (None)
1083		/// will not overwrite the old ones.
885		#[weight = <SelfWeightOf<T>>::set_collection_limits()]1084		#[weight = <SelfWeightOf<T>>::set_collection_limits()]
886		#[transactional]1085		#[transactional]
887		pub fn set_collection_permissions(1086		pub fn set_collection_permissions(
888			origin,1087			origin,
889			collection_id: CollectionId,1088			collection_id: CollectionId,
890			new_limit: CollectionPermissions,1089			new_permission: CollectionPermissions,
891		) -> DispatchResult {1090		) -> DispatchResult {
892			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);1091			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);
893			let mut target_collection = <CollectionHandle<T>>::try_get(collection_id)?;1092			let mut target_collection = <CollectionHandle<T>>::try_get(collection_id)?;
894			target_collection.check_is_internal()?;1093			target_collection.check_is_internal()?;
895			target_collection.check_is_owner_or_admin(&sender)?;1094			target_collection.check_is_owner_or_admin(&sender)?;
896			let old_limit = &target_collection.permissions;1095			let old_limit = &target_collection.permissions;
8971096
898			target_collection.permissions = <PalletCommon<T>>::clamp_permissions(target_collection.mode.clone(), &old_limit, new_limit)?;1097			target_collection.permissions = <PalletCommon<T>>::clamp_permissions(target_collection.mode.clone(), &old_limit, new_permission)?;
8991098
900			<Pallet<T>>::deposit_event(Event::<T>::CollectionPermissionSet(1099			<Pallet<T>>::deposit_event(Event::<T>::CollectionPermissionSet(
901				collection_id1100				collection_id
904			target_collection.save()1103			target_collection.save()
905		}1104		}
9061105
1106		/// Re-partition a refungible token, while owning all of its parts/pieces.
1107		///
1108		/// # Permissions
1109		///
1110		/// * Token owner (must own every part)
1111		///
1112		/// # Arguments
1113		///
1114		/// * `collection_id`: ID of the collection the RFT belongs to.
1115		/// * `token_id`: ID of the RFT.
1116		/// * `amount`: New number of parts/pieces into which the token shall be partitioned.
907		#[weight = T::RefungibleExtensionsWeightInfo::repartition()]1117		#[weight = T::RefungibleExtensionsWeightInfo::repartition()]
908		#[transactional]1118		#[transactional]
909		pub fn repartition(1119		pub fn repartition(
910			origin,1120			origin,
911			collection_id: CollectionId,1121			collection_id: CollectionId,
912			token: TokenId,1122			token_id: TokenId,
913			amount: u128,1123			amount: u128,
914		) -> DispatchResultWithPostInfo {1124		) -> DispatchResultWithPostInfo {
915			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);1125			let sender = T::CrossAccountId::from_sub(ensure_signed(origin)?);
916			dispatch_tx::<T, _>(collection_id, |d| {1126			dispatch_tx::<T, _>(collection_id, |d| {
917				if let Some(refungible_extensions) = d.refungible_extensions() {1127				if let Some(refungible_extensions) = d.refungible_extensions() {
918					refungible_extensions.repartition(&sender, token, amount)1128					refungible_extensions.repartition(&sender, token_id, amount)
919				} else {1129				} else {
920					fail!(<Error<T>>::RepartitionCalledOnNonRefungibleCollection)1130					fail!(<Error<T>>::RepartitionCalledOnNonRefungibleCollection)
921				}1131				}