git.delta.rocks / unique-network / refs/commits / 69b4e9b52402

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//! # Nonfungible Pallet EVM API18//!19//! Provides ERC-721 standart support implementation and EVM API for unique extensions for Nonfungible Pallet.20//! Method implementations are mostly doing parameter conversion and calling Nonfungible Pallet methods.2122extern crate alloc;23use core::{24	char::{REPLACEMENT_CHARACTER, decode_utf16},25	convert::TryInto,26};27use evm_coder::{abi::AbiType, ToLog, generate_stubgen, solidity_interface, types::*};28use frame_support::BoundedVec;29use up_data_structs::{30	TokenId, PropertyPermission, PropertyKeyPermission, Property, CollectionId, PropertyKey,31	CollectionPropertiesVec,32};33use pallet_evm_coder_substrate::{34	dispatch_to_evm, frontier_contract,35	execution::{Result, PreDispatch, Error},36};37use sp_std::{vec::Vec, vec};38use pallet_common::{39	CollectionHandle, CollectionPropertyPermissions, CommonCollectionOperations,40	erc::{CommonEvmHandler, PrecompileResult, CollectionCall, static_property::key},41	eth::{self, TokenUri},42};43use pallet_evm::{account::CrossAccountId, PrecompileHandle};44use pallet_evm_coder_substrate::call;45use pallet_structure::{SelfWeightOf as StructureWeight, weights::WeightInfo as _};46use sp_core::{U256, Get};4748use crate::{49	AccountBalance, Config, CreateItemData, NonfungibleHandle, Pallet, TokenData, TokensMinted,50	TokenProperties, SelfWeightOf, weights::WeightInfo,51};5253/// Nft events.54#[derive(ToLog)]55pub enum ERC721TokenEvent {56	/// The token has been changed.57	TokenChanged {58		/// Token ID.59		#[indexed]60		token_id: U256,61	},62}6364frontier_contract! {65	macro_rules! NonfungibleHandle_result {...}66	impl<T: Config> Contract for NonfungibleHandle<T> {...}67}6869/// @title A contract that allows to set and delete token properties and change token property permissions.70#[solidity_interface(name = TokenProperties, events(ERC721TokenEvent), enum(derive(PreDispatch)), enum_attr(weight))]71impl<T: Config> NonfungibleHandle<T> {72	/// @notice Set permissions for token property.73	/// @dev Throws error if `msg.sender` is not admin or owner of the collection.74	/// @param key Property key.75	/// @param isMutable Permission to mutate property.76	/// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.77	/// @param tokenOwner Permission to mutate property by token owner if property is mutable.78	#[solidity(hide)]79	#[weight(<SelfWeightOf<T>>::set_token_property_permissions(1))]80	fn set_token_property_permission(81		&mut self,82		caller: Caller,83		key: String,84		is_mutable: bool,85		collection_admin: bool,86		token_owner: bool,87	) -> Result<()> {88		let caller = T::CrossAccountId::from_eth(caller);89		<Pallet<T>>::set_token_property_permissions(90			self,91			&caller,92			vec![PropertyKeyPermission {93				key: <Vec<u8>>::from(key)94					.try_into()95					.map_err(|_| "too long key")?,96				permission: PropertyPermission {97					mutable: is_mutable,98					collection_admin,99					token_owner,100				},101			}],102		)103		.map_err(dispatch_to_evm::<T>)104	}105106	/// @notice Set permissions for token property.107	/// @dev Throws error if `msg.sender` is not admin or owner of the collection.108	/// @param permissions Permissions for keys.109	#[weight(<SelfWeightOf<T>>::set_token_property_permissions(permissions.len() as u32))]110	fn set_token_property_permissions(111		&mut self,112		caller: Caller,113		permissions: Vec<eth::TokenPropertyPermission>,114	) -> Result<()> {115		let caller = T::CrossAccountId::from_eth(caller);116		let perms = eth::TokenPropertyPermission::into_property_key_permissions(permissions)?;117118		<Pallet<T>>::set_token_property_permissions(self, &caller, perms)119			.map_err(dispatch_to_evm::<T>)120	}121122	/// @notice Get permissions for token properties.123	fn token_property_permissions(&self) -> Result<Vec<eth::TokenPropertyPermission>> {124		let perms = <Pallet<T>>::token_property_permission(self.id);125		Ok(perms126			.into_iter()127			.map(eth::TokenPropertyPermission::from)128			.collect())129	}130131	/// @notice Set token property value.132	/// @dev Throws error if `msg.sender` has no permission to edit the property.133	/// @param tokenId ID of the token.134	/// @param key Property key.135	/// @param value Property value.136	#[solidity(hide)]137	#[weight(<SelfWeightOf<T>>::set_token_properties(1))]138	fn set_property(139		&mut self,140		caller: Caller,141		token_id: U256,142		key: String,143		value: Bytes,144	) -> Result<()> {145		let caller = T::CrossAccountId::from_eth(caller);146		let token_id: u32 = token_id.try_into().map_err(|_| "token id overflow")?;147		let key = <Vec<u8>>::from(key)148			.try_into()149			.map_err(|_| "key too long")?;150		let value = value.0.try_into().map_err(|_| "value too long")?;151152		let nesting_budget = self153			.recorder154			.weight_calls_budget(<StructureWeight<T>>::find_parent());155156		<Pallet<T>>::set_token_property(157			self,158			&caller,159			TokenId(token_id),160			Property { key, value },161			&nesting_budget,162		)163		.map_err(dispatch_to_evm::<T>)164	}165166	/// @notice Set token properties value.167	/// @dev Throws error if `msg.sender` has no permission to edit the property.168	/// @param tokenId ID of the token.169	/// @param properties settable properties170	#[weight(<SelfWeightOf<T>>::set_token_properties(properties.len() as u32))]171	fn set_properties(172		&mut self,173		caller: Caller,174		token_id: U256,175		properties: Vec<eth::Property>,176	) -> Result<()> {177		let caller = T::CrossAccountId::from_eth(caller);178		let token_id: u32 = token_id.try_into().map_err(|_| "token id overflow")?;179180		let nesting_budget = self181			.recorder182			.weight_calls_budget(<StructureWeight<T>>::find_parent());183184		let properties = properties185			.into_iter()186			.map(eth::Property::try_into)187			.collect::<Result<Vec<_>>>()?;188189		<Pallet<T>>::set_token_properties(190			self,191			&caller,192			TokenId(token_id),193			properties.into_iter(),194			false,195			&nesting_budget,196		)197		.map_err(dispatch_to_evm::<T>)198	}199200	/// @notice Delete token property value.201	/// @dev Throws error if `msg.sender` has no permission to edit the property.202	/// @param tokenId ID of the token.203	/// @param key Property key.204	#[solidity(hide)]205	#[weight(<SelfWeightOf<T>>::delete_token_properties(1))]206	fn delete_property(&mut self, token_id: U256, caller: Caller, key: String) -> Result<()> {207		let caller = T::CrossAccountId::from_eth(caller);208		let token_id: u32 = token_id.try_into().map_err(|_| "token id overflow")?;209		let key = <Vec<u8>>::from(key)210			.try_into()211			.map_err(|_| "key too long")?;212213		let nesting_budget = self214			.recorder215			.weight_calls_budget(<StructureWeight<T>>::find_parent());216217		<Pallet<T>>::delete_token_property(self, &caller, TokenId(token_id), key, &nesting_budget)218			.map_err(dispatch_to_evm::<T>)219	}220221	/// @notice Delete token properties value.222	/// @dev Throws error if `msg.sender` has no permission to edit the property.223	/// @param tokenId ID of the token.224	/// @param keys Properties key.225	#[weight(<SelfWeightOf<T>>::delete_token_properties(keys.len() as u32))]226	fn delete_properties(227		&mut self,228		token_id: U256,229		caller: Caller,230		keys: Vec<String>,231	) -> Result<()> {232		let caller = T::CrossAccountId::from_eth(caller);233		let token_id: u32 = token_id.try_into().map_err(|_| "token id overflow")?;234		let keys = keys235			.into_iter()236			.map(|k| Ok(<Vec<u8>>::from(k).try_into().map_err(|_| "key too long")?))237			.collect::<Result<Vec<_>>>()?;238239		let nesting_budget = self240			.recorder241			.weight_calls_budget(<StructureWeight<T>>::find_parent());242243		<Pallet<T>>::delete_token_properties(244			self,245			&caller,246			TokenId(token_id),247			keys.into_iter(),248			&nesting_budget,249		)250		.map_err(dispatch_to_evm::<T>)251	}252253	/// @notice Get token property value.254	/// @dev Throws error if key not found255	/// @param tokenId ID of the token.256	/// @param key Property key.257	/// @return Property value bytes258	fn property(&self, token_id: U256, key: String) -> Result<Bytes> {259		let token_id: u32 = token_id.try_into().map_err(|_| "token id overflow")?;260		let key = <Vec<u8>>::from(key)261			.try_into()262			.map_err(|_| "key too long")?;263264		let props = <TokenProperties<T>>::get((self.id, token_id));265		let prop = props.get(&key).ok_or("key not found")?;266267		Ok(prop.to_vec().into())268	}269}270271#[derive(ToLog)]272pub enum ERC721Events {273	/// @dev This emits when ownership of any NFT changes by any mechanism.274	///  This event emits when NFTs are created (`from` == 0) and destroyed275	///  (`to` == 0). Exception: during contract creation, any number of NFTs276	///  may be created and assigned without emitting Transfer. At the time of277	///  any transfer, the approved address for that NFT (if any) is reset to none.278	Transfer {279		#[indexed]280		from: Address,281		#[indexed]282		to: Address,283		#[indexed]284		token_id: U256,285	},286	/// @dev This emits when the approved address for an NFT is changed or287	///  reaffirmed. The zero address indicates there is no approved address.288	///  When a Transfer event emits, this also indicates that the approved289	///  address for that NFT (if any) is reset to none.290	Approval {291		#[indexed]292		owner: Address,293		#[indexed]294		approved: Address,295		#[indexed]296		token_id: U256,297	},298	/// @dev This emits when an operator is enabled or disabled for an owner.299	///  The operator can manage all NFTs of the owner.300	#[allow(dead_code)]301	ApprovalForAll {302		#[indexed]303		owner: Address,304		#[indexed]305		operator: Address,306		approved: bool,307	},308}309310/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension311/// @dev See https://eips.ethereum.org/EIPS/eip-721312#[solidity_interface(name = ERC721Metadata, expect_selector = 0x5b5e139f, enum(derive(PreDispatch)), enum_attr(weight))]313impl<T: Config> NonfungibleHandle<T>314where315	T::AccountId: From<[u8; 32]> + AsRef<[u8; 32]>,316{317	/// @notice A descriptive name for a collection of NFTs in this contract318	/// @dev real implementation of this function lies in `ERC721UniqueExtensions`319	#[solidity(hide, rename_selector = "name")]320	fn name_proxy(&self) -> String {321		self.name()322	}323324	/// @notice An abbreviated name for NFTs in this contract325	/// @dev real implementation of this function lies in `ERC721UniqueExtensions`326	#[solidity(hide, rename_selector = "symbol")]327	fn symbol_proxy(&self) -> String {328		self.symbol()329	}330331	/// @notice A distinct Uniform Resource Identifier (URI) for a given asset.332	///333	/// @dev If the token has a `url` property and it is not empty, it is returned.334	///  Else If the collection does not have a property with key `schemaName` or its value is not equal to `ERC721Metadata`, it return an error `tokenURI not set`.335	///  If the collection property `baseURI` is empty or absent, return "" (empty string)336	///  otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix337	///  otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).338	///339	/// @return token's const_metadata340	#[solidity(rename_selector = "tokenURI")]341	fn token_uri(&self, token_id: U256) -> Result<String> {342		let token_id_u32: u32 = token_id.try_into().map_err(|_| "token id overflow")?;343344		match get_token_property(self, token_id_u32, &key::url()).as_deref() {345			Err(_) | Ok("") => (),346			Ok(url) => {347				return Ok(url.into());348			}349		};350351		let base_uri =352			pallet_common::Pallet::<T>::get_collection_property(self.id, &key::base_uri())353				.map(BoundedVec::into_inner)354				.map(String::from_utf8)355				.transpose()356				.map_err(|e| {357					Error::Revert(alloc::format!(358						"Can not convert value \"baseURI\" to string with error \"{}\"",359						e360					))361				})?;362363		let base_uri = match base_uri.as_deref() {364			None | Some("") => {365				return Ok("".into());366			}367			Some(base_uri) => base_uri.into(),368		};369370		Ok(371			match get_token_property(self, token_id_u32, &key::suffix()).as_deref() {372				Err(_) | Ok("") => base_uri,373				Ok(suffix) => base_uri + suffix,374			},375		)376	}377}378379/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension380/// @dev See https://eips.ethereum.org/EIPS/eip-721381#[solidity_interface(name = ERC721Enumerable, expect_selector = 0x780e9d63, enum(derive(PreDispatch)), enum_attr(weight))]382impl<T: Config> NonfungibleHandle<T> {383	/// @notice Enumerate valid NFTs384	/// @param index A counter less than `totalSupply()`385	/// @return The token identifier for the `index`th NFT,386	///  (sort order not specified)387	fn token_by_index(&self, index: U256) -> U256 {388		index389	}390391	/// @dev Not implemented392	fn token_of_owner_by_index(&self, _owner: Address, _index: U256) -> Result<U256> {393		// TODO: Not implemetable394		Err("not implemented".into())395	}396397	/// @notice Count NFTs tracked by this contract398	/// @return A count of valid NFTs tracked by this contract, where each one of399	///  them has an assigned and queryable owner not equal to the zero address400	fn total_supply(&self) -> Result<U256> {401		self.consume_store_reads(1)?;402		Ok(<Pallet<T>>::total_supply(self).into())403	}404}405406/// @title ERC-721 Non-Fungible Token Standard407/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md408#[solidity_interface(name = ERC721, events(ERC721Events), enum(derive(PreDispatch)), enum_attr(weight), expect_selector = 0x80ac58cd)]409impl<T: Config> NonfungibleHandle<T> {410	/// @notice Count all NFTs assigned to an owner411	/// @dev NFTs assigned to the zero address are considered invalid, and this412	///  function throws for queries about the zero address.413	/// @param owner An address for whom to query the balance414	/// @return The number of NFTs owned by `owner`, possibly zero415	fn balance_of(&self, owner: Address) -> Result<U256> {416		self.consume_store_reads(1)?;417		let owner = T::CrossAccountId::from_eth(owner);418		let balance = <AccountBalance<T>>::get((self.id, owner));419		Ok(balance.into())420	}421	/// @notice Find the owner of an NFT422	/// @dev NFTs assigned to zero address are considered invalid, and queries423	///  about them do throw.424	/// @param tokenId The identifier for an NFT425	/// @return The address of the owner of the NFT426	fn owner_of(&self, token_id: U256) -> Result<Address> {427		self.consume_store_reads(1)?;428		let token: TokenId = token_id.try_into()?;429		Ok(*<TokenData<T>>::get((self.id, token))430			.ok_or("token not found")?431			.owner432			.as_eth())433	}434	/// @dev Not implemented435	#[solidity(rename_selector = "safeTransferFrom")]436	fn safe_transfer_from_with_data(437		&mut self,438		_from: Address,439		_to: Address,440		_token_id: U256,441		_data: Bytes,442	) -> Result<()> {443		// TODO: Not implemetable444		Err("not implemented".into())445	}446	/// @dev Not implemented447	fn safe_transfer_from(&mut self, _from: Address, _to: Address, _token_id: U256) -> Result<()> {448		// TODO: Not implemetable449		Err("not implemented".into())450	}451452	/// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE453	///  TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE454	///  THEY MAY BE PERMANENTLY LOST455	/// @dev Throws unless `msg.sender` is the current owner or an authorized456	///  operator for this NFT. Throws if `from` is not the current owner. Throws457	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.458	/// @param from The current owner of the NFT459	/// @param to The new owner460	/// @param tokenId The NFT to transfer461	#[weight(<SelfWeightOf<T>>::transfer_from())]462	fn transfer_from(463		&mut self,464		caller: Caller,465		from: Address,466		to: Address,467		token_id: U256,468	) -> Result<()> {469		let caller = T::CrossAccountId::from_eth(caller);470		let from = T::CrossAccountId::from_eth(from);471		let to = T::CrossAccountId::from_eth(to);472		let token = token_id.try_into()?;473		let budget = self474			.recorder475			.weight_calls_budget(<StructureWeight<T>>::find_parent());476477		<Pallet<T>>::transfer_from(self, &caller, &from, &to, token, &budget)478			.map_err(dispatch_to_evm::<T>)?;479		Ok(())480	}481482	/// @notice Set or reaffirm the approved address for an NFT483	/// @dev The zero address indicates there is no approved address.484	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized485	///  operator of the current owner.486	/// @param approved The new approved NFT controller487	/// @param tokenId The NFT to approve488	#[weight(<SelfWeightOf<T>>::approve())]489	fn approve(&mut self, caller: Caller, approved: Address, token_id: U256) -> Result<()> {490		let caller = T::CrossAccountId::from_eth(caller);491		let approved = T::CrossAccountId::from_eth(approved);492		let token = token_id.try_into()?;493494		<Pallet<T>>::set_allowance(self, &caller, token, Some(&approved))495			.map_err(dispatch_to_evm::<T>)?;496		Ok(())497	}498499	/// @notice Sets or unsets the approval of a given operator.500	/// The `operator` is allowed to transfer all tokens of the `caller` on their behalf.501	/// @param operator Operator502	/// @param approved Should operator status be granted or revoked?503	#[weight(<SelfWeightOf<T>>::set_allowance_for_all())]504	fn set_approval_for_all(505		&mut self,506		caller: Caller,507		operator: Address,508		approved: bool,509	) -> Result<()> {510		let caller = T::CrossAccountId::from_eth(caller);511		let operator = T::CrossAccountId::from_eth(operator);512513		<Pallet<T>>::set_allowance_for_all(self, &caller, &operator, approved)514			.map_err(dispatch_to_evm::<T>)?;515		Ok(())516	}517518	/// @dev Not implemented519	fn get_approved(&self, _token_id: U256) -> Result<Address> {520		// TODO: Not implemetable521		Err("not implemented".into())522	}523524	/// @notice Tells whether the given `owner` approves the `operator`.525	#[weight(<SelfWeightOf<T>>::allowance_for_all())]526	fn is_approved_for_all(&self, owner: Address, operator: Address) -> Result<bool> {527		let owner = T::CrossAccountId::from_eth(owner);528		let operator = T::CrossAccountId::from_eth(operator);529530		Ok(<Pallet<T>>::allowance_for_all(self, &owner, &operator))531	}532}533534/// @title ERC721 Token that can be irreversibly burned (destroyed).535#[solidity_interface(name = ERC721Burnable, enum(derive(PreDispatch)), enum_attr(weight))]536impl<T: Config> NonfungibleHandle<T> {537	/// @notice Burns a specific ERC721 token.538	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized539	///  operator of the current owner.540	/// @param tokenId The NFT to approve541	#[weight(<SelfWeightOf<T>>::burn_item())]542	fn burn(&mut self, caller: Caller, token_id: U256) -> Result<()> {543		let caller = T::CrossAccountId::from_eth(caller);544		let token = token_id.try_into()?;545546		<Pallet<T>>::burn(self, &caller, token).map_err(dispatch_to_evm::<T>)?;547		Ok(())548	}549}550551/// @title ERC721 minting logic.552#[solidity_interface(name = ERC721UniqueMintable, enum(derive(PreDispatch)), enum_attr(weight))]553impl<T: Config> NonfungibleHandle<T> {554	/// @notice Function to mint a token.555	/// @param to The new owner556	/// @return uint256 The id of the newly minted token557	#[weight(<SelfWeightOf<T>>::create_item())]558	fn mint(&mut self, caller: Caller, to: Address) -> Result<U256> {559		let token_id: U256 = <TokensMinted<T>>::get(self.id)560			.checked_add(1)561			.ok_or("item id overflow")?562			.into();563		self.mint_check_id(caller, to, token_id)?;564		Ok(token_id)565	}566567	/// @notice Function to mint a token.568	/// @dev `tokenId` should be obtained with `nextTokenId` method,569	///  unlike standard, you can't specify it manually570	/// @param to The new owner571	/// @param tokenId ID of the minted NFT572	#[solidity(hide, rename_selector = "mint")]573	#[weight(<SelfWeightOf<T>>::create_item())]574	fn mint_check_id(&mut self, caller: Caller, to: Address, token_id: U256) -> Result<bool> {575		let caller = T::CrossAccountId::from_eth(caller);576		let to = T::CrossAccountId::from_eth(to);577		let token_id: u32 = token_id.try_into()?;578		let budget = self579			.recorder580			.weight_calls_budget(<StructureWeight<T>>::find_parent());581582		if <TokensMinted<T>>::get(self.id)583			.checked_add(1)584			.ok_or("item id overflow")?585			!= token_id586		{587			return Err("item id should be next".into());588		}589590		<Pallet<T>>::create_item(591			self,592			&caller,593			CreateItemData::<T> {594				properties: BoundedVec::default(),595				owner: to,596			},597			&budget,598		)599		.map_err(dispatch_to_evm::<T>)?;600601		Ok(true)602	}603604	/// @notice Function to mint token with the given tokenUri.605	/// @param to The new owner606	/// @param tokenUri Token URI that would be stored in the NFT properties607	/// @return uint256 The id of the newly minted token608	#[solidity(rename_selector = "mintWithTokenURI")]609	#[weight(<SelfWeightOf<T>>::create_item() + <SelfWeightOf<T>>::set_token_properties(1))]610	fn mint_with_token_uri(611		&mut self,612		caller: Caller,613		to: Address,614		token_uri: String,615	) -> Result<U256> {616		let token_id: U256 = <TokensMinted<T>>::get(self.id)617			.checked_add(1)618			.ok_or("item id overflow")?619			.into();620		self.mint_with_token_uri_check_id(caller, to, token_id, token_uri)?;621		Ok(token_id)622	}623624	/// @notice Function to mint token with the given tokenUri.625	/// @dev `tokenId` should be obtained with `nextTokenId` method,626	///  unlike standard, you can't specify it manually627	/// @param to The new owner628	/// @param tokenId ID of the minted NFT629	/// @param tokenUri Token URI that would be stored in the NFT properties630	#[solidity(hide, rename_selector = "mintWithTokenURI")]631	#[weight(<SelfWeightOf<T>>::create_item() + <SelfWeightOf<T>>::set_token_properties(1))]632	fn mint_with_token_uri_check_id(633		&mut self,634		caller: Caller,635		to: Address,636		token_id: U256,637		token_uri: String,638	) -> Result<bool> {639		let key = key::url();640		let permission = get_token_permission::<T>(self.id, &key)?;641		if !permission.collection_admin {642			return Err("Operation is not allowed".into());643		}644645		let caller = T::CrossAccountId::from_eth(caller);646		let to = T::CrossAccountId::from_eth(to);647		let token_id: u32 = token_id.try_into().map_err(|_| "amount overflow")?;648		let budget = self649			.recorder650			.weight_calls_budget(<StructureWeight<T>>::find_parent());651652		if <TokensMinted<T>>::get(self.id)653			.checked_add(1)654			.ok_or("item id overflow")?655			!= token_id656		{657			return Err("item id should be next".into());658		}659660		let mut properties = CollectionPropertiesVec::default();661		properties662			.try_push(Property {663				key,664				value: token_uri665					.into_bytes()666					.try_into()667					.map_err(|_| "token uri is too long")?,668			})669			.map_err(|e| Error::Revert(alloc::format!("Can't add property: {:?}", e)))?;670671		<Pallet<T>>::create_item(672			self,673			&caller,674			CreateItemData::<T> {675				properties,676				owner: to,677			},678			&budget,679		)680		.map_err(dispatch_to_evm::<T>)?;681		Ok(true)682	}683}684685fn get_token_property<T: Config>(686	collection: &CollectionHandle<T>,687	token_id: u32,688	key: &up_data_structs::PropertyKey,689) -> Result<String> {690	collection.consume_store_reads(1)?;691	let properties = <TokenProperties<T>>::try_get((collection.id, token_id))692		.map_err(|_| Error::Revert("Token properties not found".into()))?;693	if let Some(property) = properties.get(key) {694		return Ok(String::from_utf8_lossy(property).into());695	}696697	Err("Property tokenURI not found".into())698}699700fn get_token_permission<T: Config>(701	collection_id: CollectionId,702	key: &PropertyKey,703) -> Result<PropertyPermission> {704	let token_property_permissions = CollectionPropertyPermissions::<T>::try_get(collection_id)705		.map_err(|_| Error::Revert("No permissions for collection".into()))?;706	let a = token_property_permissions707		.get(key)708		.map(Clone::clone)709		.ok_or_else(|| {710			let key = String::from_utf8(key.clone().into_inner()).unwrap_or_default();711			Error::Revert(alloc::format!("No permission for key {}", key))712		})?;713	Ok(a)714}715716/// @title Unique extensions for ERC721.717#[solidity_interface(name = ERC721UniqueExtensions, enum(derive(PreDispatch)), enum_attr(weight))]718impl<T: Config> NonfungibleHandle<T>719where720	T::AccountId: From<[u8; 32]> + AsRef<[u8; 32]>,721{722	/// @notice A descriptive name for a collection of NFTs in this contract723	fn name(&self) -> String {724		decode_utf16(self.name.iter().copied())725			.map(|r| r.unwrap_or(REPLACEMENT_CHARACTER))726			.collect::<String>()727	}728729	/// @notice An abbreviated name for NFTs in this contract730	fn symbol(&self) -> String {731		String::from_utf8_lossy(&self.token_prefix).into()732	}733734	/// @notice A description for the collection.735	fn description(&self) -> String {736		decode_utf16(self.description.iter().copied())737			.map(|r| r.unwrap_or(REPLACEMENT_CHARACTER))738			.collect::<String>()739	}740741	/// Returns the owner (in cross format) of the token.742	///743	/// @param tokenId Id for the token.744	fn cross_owner_of(&self, token_id: U256) -> Result<eth::CrossAddress> {745		Self::token_owner(&self, token_id.try_into()?)746			.map(|o| eth::CrossAddress::from_sub_cross_account::<T>(&o))747			.map_err(|_| Error::Revert("token not found".into()))748	}749750	/// Returns the token properties.751	///752	/// @param tokenId Id for the token.753	/// @param keys Properties keys. Empty keys for all propertyes.754	/// @return Vector of properties key/value pairs.755	fn properties(&self, token_id: U256, keys: Vec<String>) -> Result<Vec<eth::Property>> {756		let keys = keys757			.into_iter()758			.map(|key| {759				<Vec<u8>>::from(key)760					.try_into()761					.map_err(|_| Error::Revert("key too large".into()))762			})763			.collect::<Result<Vec<_>>>()?;764765		<Self as CommonCollectionOperations<T>>::token_properties(766			&self,767			token_id.try_into()?,768			if keys.is_empty() { None } else { Some(keys) },769		)770		.into_iter()771		.map(eth::Property::try_from)772		.collect::<Result<Vec<_>>>()773	}774775	/// @notice Set or reaffirm the approved address for an NFT776	/// @dev The zero address indicates there is no approved address.777	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized778	///  operator of the current owner.779	/// @param approved The new substrate address approved NFT controller780	/// @param tokenId The NFT to approve781	#[weight(<SelfWeightOf<T>>::approve())]782	fn approve_cross(783		&mut self,784		caller: Caller,785		approved: eth::CrossAddress,786		token_id: U256,787	) -> Result<()> {788		let caller = T::CrossAccountId::from_eth(caller);789		let approved = approved.into_sub_cross_account::<T>()?;790		let token = token_id.try_into()?;791792		<Pallet<T>>::set_allowance(self, &caller, token, Some(&approved))793			.map_err(dispatch_to_evm::<T>)?;794		Ok(())795	}796797	/// @notice Transfer ownership of an NFT798	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`799	///  is the zero address. Throws if `tokenId` is not a valid NFT.800	/// @param to The new owner801	/// @param tokenId The NFT to transfer802	#[weight(<SelfWeightOf<T>>::transfer())]803	fn transfer(&mut self, caller: Caller, to: Address, token_id: U256) -> Result<()> {804		let caller = T::CrossAccountId::from_eth(caller);805		let to = T::CrossAccountId::from_eth(to);806		let token = token_id.try_into()?;807		let budget = self808			.recorder809			.weight_calls_budget(<StructureWeight<T>>::find_parent());810811		<Pallet<T>>::transfer(self, &caller, &to, token, &budget).map_err(dispatch_to_evm::<T>)?;812		Ok(())813	}814815	/// @notice Transfer ownership of an NFT816	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`817	///  is the zero address. Throws if `tokenId` is not a valid NFT.818	/// @param to The new owner819	/// @param tokenId The NFT to transfer820	#[weight(<SelfWeightOf<T>>::transfer())]821	fn transfer_cross(822		&mut self,823		caller: Caller,824		to: eth::CrossAddress,825		token_id: U256,826	) -> Result<()> {827		let caller = T::CrossAccountId::from_eth(caller);828		let to = to.into_sub_cross_account::<T>()?;829		let token = token_id.try_into()?;830		let budget = self831			.recorder832			.weight_calls_budget(<StructureWeight<T>>::find_parent());833834		<Pallet<T>>::transfer(self, &caller, &to, token, &budget).map_err(dispatch_to_evm::<T>)?;835		Ok(())836	}837838	/// @notice Transfer ownership of an NFT from cross account address to cross account address839	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`840	///  is the zero address. Throws if `tokenId` is not a valid NFT.841	/// @param from Cross acccount address of current owner842	/// @param to Cross acccount address of new owner843	/// @param tokenId The NFT to transfer844	#[weight(<SelfWeightOf<T>>::transfer())]845	fn transfer_from_cross(846		&mut self,847		caller: Caller,848		from: eth::CrossAddress,849		to: eth::CrossAddress,850		token_id: U256,851	) -> Result<()> {852		let caller = T::CrossAccountId::from_eth(caller);853		let from = from.into_sub_cross_account::<T>()?;854		let to = to.into_sub_cross_account::<T>()?;855		let token_id = token_id.try_into()?;856		let budget = self857			.recorder858			.weight_calls_budget(<StructureWeight<T>>::find_parent());859		Pallet::<T>::transfer_from(self, &caller, &from, &to, token_id, &budget)860			.map_err(dispatch_to_evm::<T>)?;861		Ok(())862	}863864	/// @notice Burns a specific ERC721 token.865	/// @dev Throws unless `msg.sender` is the current owner or an authorized866	///  operator for this NFT. Throws if `from` is not the current owner. Throws867	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.868	/// @param from The current owner of the NFT869	/// @param tokenId The NFT to transfer870	#[solidity(hide)]871	#[weight(<SelfWeightOf<T>>::burn_from())]872	fn burn_from(&mut self, caller: Caller, from: Address, token_id: U256) -> Result<()> {873		let caller = T::CrossAccountId::from_eth(caller);874		let from = T::CrossAccountId::from_eth(from);875		let token = token_id.try_into()?;876		let budget = self877			.recorder878			.weight_calls_budget(<StructureWeight<T>>::find_parent());879880		<Pallet<T>>::burn_from(self, &caller, &from, token, &budget)881			.map_err(dispatch_to_evm::<T>)?;882		Ok(())883	}884885	/// @notice Burns a specific ERC721 token.886	/// @dev Throws unless `msg.sender` is the current owner or an authorized887	///  operator for this NFT. Throws if `from` is not the current owner. Throws888	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.889	/// @param from The current owner of the NFT890	/// @param tokenId The NFT to transfer891	#[weight(<SelfWeightOf<T>>::burn_from())]892	fn burn_from_cross(893		&mut self,894		caller: Caller,895		from: eth::CrossAddress,896		token_id: U256,897	) -> Result<()> {898		let caller = T::CrossAccountId::from_eth(caller);899		let from = from.into_sub_cross_account::<T>()?;900		let token = token_id.try_into()?;901		let budget = self902			.recorder903			.weight_calls_budget(<StructureWeight<T>>::find_parent());904905		<Pallet<T>>::burn_from(self, &caller, &from, token, &budget)906			.map_err(dispatch_to_evm::<T>)?;907		Ok(())908	}909910	/// @notice Returns next free NFT ID.911	fn next_token_id(&self) -> Result<U256> {912		self.consume_store_reads(1)?;913		Ok(<TokensMinted<T>>::get(self.id)914			.checked_add(1)915			.ok_or("item id overflow")?916			.into())917	}918919	/// @notice Function to mint multiple tokens.920	/// @dev `tokenIds` should be an array of consecutive numbers and first number921	///  should be obtained with `nextTokenId` method922	/// @param to The new owner923	/// @param tokenIds IDs of the minted NFTs924	#[solidity(hide)]925	#[weight(<SelfWeightOf<T>>::create_multiple_items(token_ids.len() as u32))]926	fn mint_bulk(&mut self, caller: Caller, to: Address, token_ids: Vec<U256>) -> Result<bool> {927		let caller = T::CrossAccountId::from_eth(caller);928		let to = T::CrossAccountId::from_eth(to);929		let mut expected_index = <TokensMinted<T>>::get(self.id)930			.checked_add(1)931			.ok_or("item id overflow")?;932		let budget = self933			.recorder934			.weight_calls_budget(<StructureWeight<T>>::find_parent());935936		let total_tokens = token_ids.len();937		for id in token_ids.into_iter() {938			let id: u32 = id.try_into().map_err(|_| "token id overflow")?;939			if id != expected_index {940				return Err("item id should be next".into());941			}942			expected_index = expected_index.checked_add(1).ok_or("item id overflow")?;943		}944		let data = (0..total_tokens)945			.map(|_| CreateItemData::<T> {946				properties: BoundedVec::default(),947				owner: to.clone(),948			})949			.collect();950951		<Pallet<T>>::create_multiple_items(self, &caller, data, &budget)952			.map_err(dispatch_to_evm::<T>)?;953		Ok(true)954	}955956	/// @notice Function to mint multiple tokens with the given tokenUris.957	/// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive958	///  numbers and first number should be obtained with `nextTokenId` method959	/// @param to The new owner960	/// @param tokens array of pairs of token ID and token URI for minted tokens961	#[solidity(hide, rename_selector = "mintBulkWithTokenURI")]962	#[weight(<SelfWeightOf<T>>::create_multiple_items(tokens.len() as u32)  + <SelfWeightOf<T>>::set_token_properties(tokens.len() as u32))]963	fn mint_bulk_with_token_uri(964		&mut self,965		caller: Caller,966		to: Address,967		tokens: Vec<TokenUri>,968	) -> Result<bool> {969		let key = key::url();970		let caller = T::CrossAccountId::from_eth(caller);971		let to = T::CrossAccountId::from_eth(to);972		let mut expected_index = <TokensMinted<T>>::get(self.id)973			.checked_add(1)974			.ok_or("item id overflow")?;975		let budget = self976			.recorder977			.weight_calls_budget(<StructureWeight<T>>::find_parent());978979		let mut data = Vec::with_capacity(tokens.len());980		for TokenUri { id, uri } in tokens {981			let id: u32 = id.try_into().map_err(|_| "token id overflow")?;982			if id != expected_index {983				return Err("item id should be next".into());984			}985			expected_index = expected_index.checked_add(1).ok_or("item id overflow")?;986987			let mut properties = CollectionPropertiesVec::default();988			properties989				.try_push(Property {990					key: key.clone(),991					value: uri992						.into_bytes()993						.try_into()994						.map_err(|_| "token uri is too long")?,995				})996				.map_err(|e| Error::Revert(alloc::format!("Can't add property: {:?}", e)))?;997998			data.push(CreateItemData::<T> {999				properties,1000				owner: to.clone(),1001			});1002		}10031004		<Pallet<T>>::create_multiple_items(self, &caller, data, &budget)1005			.map_err(dispatch_to_evm::<T>)?;1006		Ok(true)1007	}10081009	/// @notice Function to mint a token.1010	/// @param to The new owner crossAccountId1011	/// @param properties Properties of minted token1012	/// @return uint256 The id of the newly minted token1013	#[weight(<SelfWeightOf<T>>::create_item() + <SelfWeightOf<T>>::set_token_properties(properties.len() as u32))]1014	fn mint_cross(1015		&mut self,1016		caller: Caller,1017		to: eth::CrossAddress,1018		properties: Vec<eth::Property>,1019	) -> Result<U256> {1020		let token_id = <TokensMinted<T>>::get(self.id)1021			.checked_add(1)1022			.ok_or("item id overflow")?;10231024		let to = to.into_sub_cross_account::<T>()?;10251026		let properties = properties1027			.into_iter()1028			.map(eth::Property::try_into)1029			.collect::<Result<Vec<_>>>()?1030			.try_into()1031			.map_err(|_| Error::Revert(alloc::format!("too many properties")))?;10321033		let caller = T::CrossAccountId::from_eth(caller);10341035		let budget = self1036			.recorder1037			.weight_calls_budget(<StructureWeight<T>>::find_parent());10381039		<Pallet<T>>::create_item(1040			self,1041			&caller,1042			CreateItemData::<T> {1043				properties,1044				owner: to,1045			},1046			&budget,1047		)1048		.map_err(dispatch_to_evm::<T>)?;10491050		Ok(token_id.into())1051	}10521053	/// @notice Returns collection helper contract address1054	fn collection_helper_address(&self) -> Address {1055		T::ContractAddress::get()1056	}1057}10581059#[solidity_interface(1060	name = UniqueNFT,1061	is(1062		ERC721,1063		ERC721Enumerable,1064		ERC721UniqueExtensions,1065		ERC721UniqueMintable,1066		ERC721Burnable,1067		ERC721Metadata(if(this.flags.erc721metadata)),1068		Collection(via(common_mut returns CollectionHandle<T>)),1069		TokenProperties,1070	),1071	enum(derive(PreDispatch)),1072)]1073impl<T: Config> NonfungibleHandle<T> where T::AccountId: From<[u8; 32]> + AsRef<[u8; 32]> {}10741075// Not a tests, but code generators1076generate_stubgen!(gen_impl, UniqueNFTCall<()>, true);1077generate_stubgen!(gen_iface, UniqueNFTCall<()>, false);10781079impl<T: Config> CommonEvmHandler for NonfungibleHandle<T>1080where1081	T::AccountId: From<[u8; 32]> + AsRef<[u8; 32]>,1082{1083	const CODE: &'static [u8] = include_bytes!("./stubs/UniqueNFT.raw");10841085	fn call(self, handle: &mut impl PrecompileHandle) -> Option<PrecompileResult> {1086		call::<T, UniqueNFTCall<T>, _, _>(handle, self)1087	}1088}