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

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//! This module contains the implementation of pallet methods for evm.1819pub use pallet_evm::{PrecompileOutput, PrecompileResult, PrecompileHandle, account::CrossAccountId};20use evm_coder::{21	abi::AbiType,22	solidity_interface, solidity, ToLog,23	types::*,24	execution::{Result, Error},25	weight,26};27use pallet_evm_coder_substrate::dispatch_to_evm;28use sp_std::{vec, vec::Vec};29use up_data_structs::{30	AccessMode, CollectionMode, CollectionPermissions, OwnerRestrictedSet, Property,31	SponsoringRateLimit, SponsorshipState,32};33use alloc::format;3435use crate::{36	Pallet, CollectionHandle, Config, CollectionProperties, SelfWeightOf,37	eth::{38		CollectionPermissions as EvmPermissions, CollectionLimitField as EvmCollectionLimits, self,39	},40	weights::WeightInfo,41};4243/// Events for ethereum collection helper.44#[derive(ToLog)]45pub enum CollectionHelpersEvents {46	/// The collection has been created.47	CollectionCreated {48		/// Collection owner.49		#[indexed]50		owner: address,5152		/// Collection ID.53		#[indexed]54		collection_id: address,55	},56	/// The collection has been destroyed.57	CollectionDestroyed {58		/// Collection ID.59		#[indexed]60		collection_id: address,61	},62	/// The collection has been changed.63	CollectionChanged {64		/// Collection ID.65		#[indexed]66		collection_id: address,67	},6869	/// The token has been changed.70	TokenChanged {71		/// Collection ID.72		#[indexed]73		collection_id: address,74		/// Token ID.75		token_id: uint256,76	},77}7879/// Does not always represent a full collection, for RFT it is either80/// collection (Implementing ERC721), or specific collection token (Implementing ERC20).81pub trait CommonEvmHandler {82	/// Raw compiled binary code of the contract stub83	const CODE: &'static [u8];8485	/// Call precompiled handle.86	fn call(self, handle: &mut impl PrecompileHandle) -> Option<PrecompileResult>;87}8889/// @title A contract that allows you to work with collections.90#[solidity_interface(name = Collection)]91impl<T: Config> CollectionHandle<T>92where93	T::AccountId: From<[u8; 32]> + AsRef<[u8; 32]>,94{95	/// Set collection property.96	///97	/// @param key Property key.98	/// @param value Propery value.99	#[solidity(hide)]100	#[weight(<SelfWeightOf<T>>::set_collection_properties(1))]101	fn set_collection_property(102		&mut self,103		caller: caller,104		key: string,105		value: bytes,106	) -> Result<void> {107		let caller = T::CrossAccountId::from_eth(caller);108		let key = <Vec<u8>>::from(key)109			.try_into()110			.map_err(|_| "key too large")?;111		let value = value.0.try_into().map_err(|_| "value too large")?;112113		<Pallet<T>>::set_collection_property(self, &caller, Property { key, value })114			.map_err(dispatch_to_evm::<T>)115	}116117	/// Set collection properties.118	///119	/// @param properties Vector of properties key/value pair.120	#[weight(<SelfWeightOf<T>>::set_collection_properties(properties.len() as u32))]121	fn set_collection_properties(122		&mut self,123		caller: caller,124		properties: Vec<eth::Property>,125	) -> Result<void> {126		let caller = T::CrossAccountId::from_eth(caller);127128		let properties = properties129			.into_iter()130			.map(|eth::Property { key, value }| {131				let key = <Vec<u8>>::from(key)132					.try_into()133					.map_err(|_| "key too large")?;134135				let value = value.0.try_into().map_err(|_| "value too large")?;136137				Ok(Property { key, value })138			})139			.collect::<Result<Vec<_>>>()?;140141		<Pallet<T>>::set_collection_properties(self, &caller, properties)142			.map_err(dispatch_to_evm::<T>)143	}144145	/// Delete collection property.146	///147	/// @param key Property key.148	#[solidity(hide)]149	#[weight(<SelfWeightOf<T>>::delete_collection_properties(1))]150	fn delete_collection_property(&mut self, caller: caller, key: string) -> Result<()> {151		let caller = T::CrossAccountId::from_eth(caller);152		let key = <Vec<u8>>::from(key)153			.try_into()154			.map_err(|_| "key too large")?;155156		<Pallet<T>>::delete_collection_property(self, &caller, key).map_err(dispatch_to_evm::<T>)157	}158159	/// Delete collection properties.160	///161	/// @param keys Properties keys.162	#[weight(<SelfWeightOf<T>>::delete_collection_properties(keys.len() as u32))]163	fn delete_collection_properties(&mut self, caller: caller, keys: Vec<string>) -> Result<()> {164		let caller = T::CrossAccountId::from_eth(caller);165		let keys = keys166			.into_iter()167			.map(|key| {168				<Vec<u8>>::from(key)169					.try_into()170					.map_err(|_| Error::Revert("key too large".into()))171			})172			.collect::<Result<Vec<_>>>()?;173174		<Pallet<T>>::delete_collection_properties(self, &caller, keys).map_err(dispatch_to_evm::<T>)175	}176177	/// Get collection property.178	///179	/// @dev Throws error if key not found.180	///181	/// @param key Property key.182	/// @return bytes The property corresponding to the key.183	fn collection_property(&self, key: string) -> Result<bytes> {184		let key = <Vec<u8>>::from(key)185			.try_into()186			.map_err(|_| "key too large")?;187188		let props = CollectionProperties::<T>::get(self.id);189		let prop = props.get(&key).ok_or("key not found")?;190191		Ok(bytes(prop.to_vec()))192	}193194	/// Get collection properties.195	///196	/// @param keys Properties keys. Empty keys for all propertyes.197	/// @return Vector of properties key/value pairs.198	fn collection_properties(&self, keys: Vec<string>) -> Result<Vec<eth::Property>> {199		let keys = keys200			.into_iter()201			.map(|key| {202				<Vec<u8>>::from(key)203					.try_into()204					.map_err(|_| Error::Revert("key too large".into()))205			})206			.collect::<Result<Vec<_>>>()?;207208		let properties = Pallet::<T>::filter_collection_properties(209			self.id,210			if keys.is_empty() { None } else { Some(keys) },211		)212		.map_err(dispatch_to_evm::<T>)?;213214		let properties = properties215			.into_iter()216			.map(|p| {217				let key =218					string::from_utf8(p.key.into()).map_err(|e| Error::Revert(format!("{}", e)))?;219				let value = bytes(p.value.to_vec());220				Ok(eth::Property { key, value })221			})222			.collect::<Result<Vec<_>>>()?;223		Ok(properties)224	}225226	/// Set the sponsor of the collection.227	///228	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.229	///230	/// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.231	#[solidity(hide)]232	fn set_collection_sponsor(&mut self, caller: caller, sponsor: address) -> Result<void> {233		self.consume_store_reads_and_writes(1, 1)?;234235		let caller = T::CrossAccountId::from_eth(caller);236237		let sponsor = T::CrossAccountId::from_eth(sponsor);238		self.set_sponsor(&caller, sponsor.as_sub().clone())239			.map_err(dispatch_to_evm::<T>)240	}241242	/// Set the sponsor of the collection.243	///244	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.245	///246	/// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.247	fn set_collection_sponsor_cross(248		&mut self,249		caller: caller,250		sponsor: eth::CrossAccount,251	) -> Result<void> {252		self.consume_store_reads_and_writes(1, 1)?;253254		let caller = T::CrossAccountId::from_eth(caller);255256		let sponsor = sponsor.into_sub_cross_account::<T>()?;257		self.set_sponsor(&caller, sponsor.as_sub().clone())258			.map_err(dispatch_to_evm::<T>)259	}260261	/// Whether there is a pending sponsor.262	fn has_collection_pending_sponsor(&self) -> Result<bool> {263		Ok(matches!(264			self.collection.sponsorship,265			SponsorshipState::Unconfirmed(_)266		))267	}268269	/// Collection sponsorship confirmation.270	///271	/// @dev After setting the sponsor for the collection, it must be confirmed with this function.272	fn confirm_collection_sponsorship(&mut self, caller: caller) -> Result<void> {273		self.consume_store_writes(1)?;274275		let caller = T::CrossAccountId::from_eth(caller);276		self.confirm_sponsorship(caller.as_sub())277			.map_err(dispatch_to_evm::<T>)278	}279280	/// Remove collection sponsor.281	fn remove_collection_sponsor(&mut self, caller: caller) -> Result<void> {282		self.consume_store_reads_and_writes(1, 1)?;283		let caller = T::CrossAccountId::from_eth(caller);284		self.remove_sponsor(&caller).map_err(dispatch_to_evm::<T>)285	}286287	/// Get current sponsor.288	///289	/// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.290	fn collection_sponsor(&self) -> Result<eth::CrossAccount> {291		let sponsor = match self.collection.sponsorship.sponsor() {292			Some(sponsor) => sponsor,293			None => return Ok(Default::default()),294		};295296		Ok(eth::CrossAccount::from_sub::<T>(&sponsor))297	}298299	/// Get current collection limits.300	///301	/// @return Array of collection limits302	fn collection_limits(&self) -> Result<Vec<eth::CollectionLimit>> {303		let limits = &self.collection.limits;304305		Ok(vec![306			eth::CollectionLimit::from_opt_int(307				EvmCollectionLimits::AccountTokenOwnership,308				limits.account_token_ownership_limit,309			),310			eth::CollectionLimit::from_opt_int(311				EvmCollectionLimits::SponsoredDataSize,312				limits.sponsored_data_size,313			),314			limits315				.sponsored_data_rate_limit316				.and_then(|limit| {317					if let SponsoringRateLimit::Blocks(blocks) = limit {318						Some(eth::CollectionLimit::from_int(319							EvmCollectionLimits::SponsoredDataRateLimit,320							blocks,321						))322					} else {323						None324					}325				})326				.unwrap_or(eth::CollectionLimit::from_int(327					EvmCollectionLimits::SponsoredDataRateLimit,328					Default::default(),329				)),330			eth::CollectionLimit::from_opt_int(EvmCollectionLimits::TokenLimit, limits.token_limit),331			eth::CollectionLimit::from_opt_int(332				EvmCollectionLimits::SponsorTransferTimeout,333				limits.sponsor_transfer_timeout,334			),335			eth::CollectionLimit::from_opt_int(336				EvmCollectionLimits::SponsorApproveTimeout,337				limits.sponsor_approve_timeout,338			),339			eth::CollectionLimit::from_opt_bool(340				EvmCollectionLimits::OwnerCanTransfer,341				limits.owner_can_transfer,342			),343			eth::CollectionLimit::from_opt_bool(344				EvmCollectionLimits::OwnerCanDestroy,345				limits.owner_can_destroy,346			),347			eth::CollectionLimit::from_opt_bool(348				EvmCollectionLimits::TransferEnabled,349				limits.transfers_enabled,350			),351		])352	}353354	/// Set limits for the collection.355	/// @dev Throws error if limit not found.356	/// @param limit Some limit.357	#[solidity(rename_selector = "setCollectionLimit")]358	fn set_collection_limit(359		&mut self,360		caller: caller,361		limit: eth::CollectionLimit,362	) -> Result<void> {363		self.consume_store_reads_and_writes(1, 1)?;364365		let caller = T::CrossAccountId::from_eth(caller);366		<Pallet<T>>::update_limits(&caller, self, limit.try_into()?).map_err(dispatch_to_evm::<T>)367	}368369	/// Get contract address.370	fn contract_address(&self) -> Result<address> {371		Ok(crate::eth::collection_id_to_address(self.id))372	}373374	/// Add collection admin.375	/// @param newAdmin Cross account administrator address.376	fn add_collection_admin_cross(377		&mut self,378		caller: caller,379		new_admin: eth::CrossAccount,380	) -> Result<void> {381		self.consume_store_reads_and_writes(2, 2)?;382383		let caller = T::CrossAccountId::from_eth(caller);384		let new_admin = new_admin.into_sub_cross_account::<T>()?;385		<Pallet<T>>::toggle_admin(self, &caller, &new_admin, true).map_err(dispatch_to_evm::<T>)?;386		Ok(())387	}388389	/// Remove collection admin.390	/// @param admin Cross account administrator address.391	fn remove_collection_admin_cross(392		&mut self,393		caller: caller,394		admin: eth::CrossAccount,395	) -> Result<void> {396		self.consume_store_reads_and_writes(2, 2)?;397398		let caller = T::CrossAccountId::from_eth(caller);399		let admin = admin.into_sub_cross_account::<T>()?;400		<Pallet<T>>::toggle_admin(self, &caller, &admin, false).map_err(dispatch_to_evm::<T>)?;401		Ok(())402	}403404	/// Add collection admin.405	/// @param newAdmin Address of the added administrator.406	#[solidity(hide)]407	fn add_collection_admin(&mut self, caller: caller, new_admin: address) -> Result<void> {408		self.consume_store_reads_and_writes(2, 2)?;409410		let caller = T::CrossAccountId::from_eth(caller);411		let new_admin = T::CrossAccountId::from_eth(new_admin);412		<Pallet<T>>::toggle_admin(self, &caller, &new_admin, true).map_err(dispatch_to_evm::<T>)?;413		Ok(())414	}415416	/// Remove collection admin.417	///418	/// @param admin Address of the removed administrator.419	#[solidity(hide)]420	fn remove_collection_admin(&mut self, caller: caller, admin: address) -> Result<void> {421		self.consume_store_reads_and_writes(2, 2)?;422423		let caller = T::CrossAccountId::from_eth(caller);424		let admin = T::CrossAccountId::from_eth(admin);425		<Pallet<T>>::toggle_admin(self, &caller, &admin, false).map_err(dispatch_to_evm::<T>)?;426		Ok(())427	}428429	/// Toggle accessibility of collection nesting.430	///431	/// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'432	#[solidity(rename_selector = "setCollectionNesting")]433	fn set_nesting_bool(&mut self, caller: caller, enable: bool) -> Result<void> {434		self.consume_store_reads_and_writes(1, 1)?;435436		let caller = T::CrossAccountId::from_eth(caller);437438		let mut permissions = self.collection.permissions.clone();439		let mut nesting = permissions.nesting().clone();440		nesting.token_owner = enable;441		nesting.restricted = None;442		permissions.nesting = Some(nesting);443444		<Pallet<T>>::update_permissions(&caller, self, permissions).map_err(dispatch_to_evm::<T>)445	}446447	/// Toggle accessibility of collection nesting.448	///449	/// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'450	/// @param collections Addresses of collections that will be available for nesting.451	#[solidity(rename_selector = "setCollectionNesting")]452	fn set_nesting(453		&mut self,454		caller: caller,455		enable: bool,456		collections: Vec<address>,457	) -> Result<void> {458		self.consume_store_reads_and_writes(1, 1)?;459460		if collections.is_empty() {461			return Err("no addresses provided".into());462		}463		let caller = T::CrossAccountId::from_eth(caller);464465		let mut permissions = self.collection.permissions.clone();466		match enable {467			false => {468				let mut nesting = permissions.nesting().clone();469				nesting.token_owner = false;470				nesting.restricted = None;471				permissions.nesting = Some(nesting);472			}473			true => {474				let mut bv = OwnerRestrictedSet::new();475				for i in collections {476					bv.try_insert(crate::eth::map_eth_to_id(&i).ok_or_else(|| {477						Error::Revert("Can't convert address into collection id".into())478					})?)479					.map_err(|_| "too many collections")?;480				}481				let mut nesting = permissions.nesting().clone();482				nesting.token_owner = true;483				nesting.restricted = Some(bv);484				permissions.nesting = Some(nesting);485			}486		};487488		<Pallet<T>>::update_permissions(&caller, self, permissions).map_err(dispatch_to_evm::<T>)489	}490491	/// Returns nesting for a collection492	#[solidity(rename_selector = "collectionNestingRestrictedCollectionIds")]493	fn collection_nesting_restricted_ids(&self) -> Result<(bool, Vec<uint256>)> {494		let nesting = self.collection.permissions.nesting();495496		Ok((497			nesting.token_owner,498			nesting499				.restricted500				.clone()501				.map(|b| b.0.into_inner().iter().map(|id| id.0.into()).collect())502				.unwrap_or_default(),503		))504	}505506	/// Returns permissions for a collection507	fn collection_nesting_permissions(&self) -> Result<Vec<(EvmPermissions, bool)>> {508		let nesting = self.collection.permissions.nesting();509		Ok(vec![510			(EvmPermissions::CollectionAdmin, nesting.collection_admin),511			(EvmPermissions::TokenOwner, nesting.token_owner),512		])513	}514	/// Set the collection access method.515	/// @param mode Access mode516	/// 	0 for Normal517	/// 	1 for AllowList518	fn set_collection_access(&mut self, caller: caller, mode: uint8) -> Result<void> {519		self.consume_store_reads_and_writes(1, 1)?;520521		let caller = T::CrossAccountId::from_eth(caller);522		let permissions = CollectionPermissions {523			access: Some(match mode {524				0 => AccessMode::Normal,525				1 => AccessMode::AllowList,526				_ => return Err("not supported access mode".into()),527			}),528			..Default::default()529		};530		<Pallet<T>>::update_permissions(&caller, self, permissions).map_err(dispatch_to_evm::<T>)531	}532533	/// Checks that user allowed to operate with collection.534	///535	/// @param user User address to check.536	fn allowlisted_cross(&self, user: eth::CrossAccount) -> Result<bool> {537		let user = user.into_sub_cross_account::<T>()?;538		Ok(Pallet::<T>::allowed(self.id, user))539	}540541	/// Add the user to the allowed list.542	///543	/// @param user Address of a trusted user.544	#[solidity(hide)]545	fn add_to_collection_allow_list(&mut self, caller: caller, user: address) -> Result<void> {546		self.consume_store_writes(1)?;547548		let caller = T::CrossAccountId::from_eth(caller);549		let user = T::CrossAccountId::from_eth(user);550		<Pallet<T>>::toggle_allowlist(self, &caller, &user, true).map_err(dispatch_to_evm::<T>)?;551		Ok(())552	}553554	/// Add user to allowed list.555	///556	/// @param user User cross account address.557	fn add_to_collection_allow_list_cross(558		&mut self,559		caller: caller,560		user: eth::CrossAccount,561	) -> Result<void> {562		self.consume_store_writes(1)?;563564		let caller = T::CrossAccountId::from_eth(caller);565		let user = user.into_sub_cross_account::<T>()?;566		Pallet::<T>::toggle_allowlist(self, &caller, &user, true).map_err(dispatch_to_evm::<T>)?;567		Ok(())568	}569570	/// Remove the user from the allowed list.571	///572	/// @param user Address of a removed user.573	#[solidity(hide)]574	fn remove_from_collection_allow_list(&mut self, caller: caller, user: address) -> Result<void> {575		self.consume_store_writes(1)?;576577		let caller = T::CrossAccountId::from_eth(caller);578		let user = T::CrossAccountId::from_eth(user);579		<Pallet<T>>::toggle_allowlist(self, &caller, &user, false).map_err(dispatch_to_evm::<T>)?;580		Ok(())581	}582583	/// Remove user from allowed list.584	///585	/// @param user User cross account address.586	fn remove_from_collection_allow_list_cross(587		&mut self,588		caller: caller,589		user: eth::CrossAccount,590	) -> Result<void> {591		self.consume_store_writes(1)?;592593		let caller = T::CrossAccountId::from_eth(caller);594		let user = user.into_sub_cross_account::<T>()?;595		Pallet::<T>::toggle_allowlist(self, &caller, &user, false).map_err(dispatch_to_evm::<T>)?;596		Ok(())597	}598599	/// Switch permission for minting.600	///601	/// @param mode Enable if "true".602	fn set_collection_mint_mode(&mut self, caller: caller, mode: bool) -> Result<void> {603		self.consume_store_reads_and_writes(1, 1)?;604605		let caller = T::CrossAccountId::from_eth(caller);606		let permissions = CollectionPermissions {607			mint_mode: Some(mode),608			..Default::default()609		};610		<Pallet<T>>::update_permissions(&caller, self, permissions).map_err(dispatch_to_evm::<T>)611	}612613	/// Check that account is the owner or admin of the collection614	///615	/// @param user account to verify616	/// @return "true" if account is the owner or admin617	#[solidity(hide, rename_selector = "isOwnerOrAdmin")]618	fn is_owner_or_admin_eth(&self, user: address) -> Result<bool> {619		let user = T::CrossAccountId::from_eth(user);620		Ok(self.is_owner_or_admin(&user))621	}622623	/// Check that account is the owner or admin of the collection624	///625	/// @param user User cross account to verify626	/// @return "true" if account is the owner or admin627	fn is_owner_or_admin_cross(&self, user: eth::CrossAccount) -> Result<bool> {628		let user = user.into_sub_cross_account::<T>()?;629		Ok(self.is_owner_or_admin(&user))630	}631632	/// Returns collection type633	///634	/// @return `Fungible` or `NFT` or `ReFungible`635	fn unique_collection_type(&self) -> Result<string> {636		let mode = match self.collection.mode {637			CollectionMode::Fungible(_) => "Fungible",638			CollectionMode::NFT => "NFT",639			CollectionMode::ReFungible => "ReFungible",640		};641		Ok(mode.into())642	}643644	/// Get collection owner.645	///646	/// @return Tuble with sponsor address and his substrate mirror.647	/// If address is canonical then substrate mirror is zero and vice versa.648	fn collection_owner(&self) -> Result<eth::CrossAccount> {649		Ok(eth::CrossAccount::from_sub_cross_account::<T>(650			&T::CrossAccountId::from_sub(self.owner.clone()),651		))652	}653654	/// Changes collection owner to another account655	///656	/// @dev Owner can be changed only by current owner657	/// @param newOwner new owner account658	#[solidity(hide, rename_selector = "changeCollectionOwner")]659	fn set_owner(&mut self, caller: caller, new_owner: address) -> Result<void> {660		self.consume_store_writes(1)?;661662		let caller = T::CrossAccountId::from_eth(caller);663		let new_owner = T::CrossAccountId::from_eth(new_owner);664		self.change_owner(caller, new_owner)665			.map_err(dispatch_to_evm::<T>)666	}667668	/// Get collection administrators669	///670	/// @return Vector of tuples with admins address and his substrate mirror.671	/// If address is canonical then substrate mirror is zero and vice versa.672	fn collection_admins(&self) -> Result<Vec<eth::CrossAccount>> {673		let result = crate::IsAdmin::<T>::iter_prefix((self.id,))674			.map(|(admin, _)| eth::CrossAccount::from_sub_cross_account::<T>(&admin))675			.collect();676		Ok(result)677	}678679	/// Changes collection owner to another account680	///681	/// @dev Owner can be changed only by current owner682	/// @param newOwner new owner cross account683	fn change_collection_owner_cross(684		&mut self,685		caller: caller,686		new_owner: eth::CrossAccount,687	) -> Result<void> {688		self.consume_store_writes(1)?;689690		let caller = T::CrossAccountId::from_eth(caller);691		let new_owner = new_owner.into_sub_cross_account::<T>()?;692		self.change_owner(caller, new_owner)693			.map_err(dispatch_to_evm::<T>)694	}695}696697/// Contains static property keys and values.698pub mod static_property {699	use evm_coder::{700		execution::{Result, Error},701	};702	use alloc::format;703704	const EXPECT_CONVERT_ERROR: &str = "length < limit";705706	/// Keys.707	pub mod key {708		use super::*;709710		/// Key "baseURI".711		pub fn base_uri() -> up_data_structs::PropertyKey {712			property_key_from_bytes(b"baseURI").expect(EXPECT_CONVERT_ERROR)713		}714715		/// Key "url".716		pub fn url() -> up_data_structs::PropertyKey {717			property_key_from_bytes(b"URI").expect(EXPECT_CONVERT_ERROR)718		}719720		/// Key "suffix".721		pub fn suffix() -> up_data_structs::PropertyKey {722			property_key_from_bytes(b"URISuffix").expect(EXPECT_CONVERT_ERROR)723		}724725		/// Key "parentNft".726		pub fn parent_nft() -> up_data_structs::PropertyKey {727			property_key_from_bytes(b"parentNft").expect(EXPECT_CONVERT_ERROR)728		}729	}730731	/// Convert `byte` to [`PropertyKey`].732	pub fn property_key_from_bytes(bytes: &[u8]) -> Result<up_data_structs::PropertyKey> {733		bytes.to_vec().try_into().map_err(|_| {734			Error::Revert(format!(735				"Property key is too long. Max length is {}.",736				up_data_structs::PropertyKey::bound()737			))738		})739	}740741	/// Convert `bytes` to [`PropertyValue`].742	pub fn property_value_from_bytes(bytes: &[u8]) -> Result<up_data_structs::PropertyValue> {743		bytes.to_vec().try_into().map_err(|_| {744			Error::Revert(format!(745				"Property key is too long. Max length is {}.",746				up_data_structs::PropertyKey::bound()747			))748		})749	}750}