git.delta.rocks / unique-network / refs/commits / 8298cf829479

difftreelog

feat Rewrite tuple to named structures for TokenPropertyPermission. fix: AbiCoder derive macro

Trubnikov Sergey2022-12-19parent: #ab6e845.patch.diff
in: master

23 files changed

modifiedcrates/evm-coder/procedural/src/abi_derive/derive_enum.rsdiffbeforeafterboth
--- a/crates/evm-coder/procedural/src/abi_derive/derive_enum.rs
+++ b/crates/evm-coder/procedural/src/abi_derive/derive_enum.rs
@@ -86,6 +86,21 @@
 	)
 }
 
+pub fn impl_enum_solidity_type<'a>(name: &syn::Ident) -> proc_macro2::TokenStream {
+	quote! {
+		#[cfg(feature = "stubgen")]
+		impl ::evm_coder::solidity::SolidityType for #name {
+			fn names(tc: &::evm_coder::solidity::TypeCollector) -> Vec<String> {
+				Vec::new()
+			}
+
+			fn len() -> usize {
+				1
+			}
+		}
+	}
+}
+
 pub fn impl_enum_solidity_type_name(name: &syn::Ident) -> proc_macro2::TokenStream {
 	quote!(
 		#[cfg(feature = "stubgen")]
modifiedcrates/evm-coder/procedural/src/abi_derive/mod.rsdiffbeforeafterboth
--- a/crates/evm-coder/procedural/src/abi_derive/mod.rs
+++ b/crates/evm-coder/procedural/src/abi_derive/mod.rs
@@ -86,6 +86,7 @@
 	let abi_type = impl_enum_abi_type(name, option_count);
 	let abi_read = impl_enum_abi_read(name);
 	let abi_write = impl_enum_abi_write(name);
+	let solidity_type = impl_enum_solidity_type(name);
 	let solidity_type_name = impl_enum_solidity_type_name(name);
 	let solidity_struct_collect = impl_enum_solidity_struct_collect(
 		name,
@@ -102,6 +103,7 @@
 		#abi_type
 		#abi_read
 		#abi_write
+		#solidity_type
 		#solidity_type_name
 		#solidity_struct_collect
 	})
modifiedcrates/evm-coder/src/abi/impls.rsdiffbeforeafterboth
--- a/crates/evm-coder/src/abi/impls.rs
+++ b/crates/evm-coder/src/abi/impls.rs
@@ -184,6 +184,11 @@
 	}
 }
 
+macro_rules! count {
+    () => (0usize);
+    ( $x:tt $($xs:tt)* ) => (1usize + count!($($xs)*));
+}
+
 macro_rules! impl_tuples {
 	($($ident:ident)+) => {
 		impl<$($ident: AbiType,)+> AbiType for ($($ident,)+)
@@ -198,7 +203,7 @@
                 shift_left(1)
                 fixed(")")
             );
-			const FIELDS_COUNT: usize = 0 $(+ {let _ = <$ident as AbiType>::FIELDS_COUNT; 1})+;
+			const FIELDS_COUNT: usize = count!($($ident)*);
 
 			fn is_dynamic() -> bool {
 				false
modifiedcrates/evm-coder/src/solidity/impls.rsdiffbeforeafterboth
--- a/crates/evm-coder/src/solidity/impls.rs
+++ b/crates/evm-coder/src/solidity/impls.rs
@@ -74,6 +74,16 @@
 	}
 }
 
+impl<T: StructCollect + sealed::CanBePlacedInVec> StructCollect for Vec<T> {
+	fn name() -> String {
+		<T as StructCollect>::name() + "[]"
+	}
+
+	fn declaration() -> String {
+		unimplemented!("Vectors have not declarations.")
+	}
+}
+
 macro_rules! count {
     () => (0usize);
     ( $x:tt $($xs:tt)* ) => (1usize + count!($($xs)*));
@@ -131,60 +141,3 @@
 impl_tuples! {A B C D E F G H}
 impl_tuples! {A B C D E F G H I}
 impl_tuples! {A B C D E F G H I J}
-
-impl StructCollect for Property {
-	fn name() -> String {
-		"Property".into()
-	}
-
-	fn declaration() -> String {
-		use std::fmt::Write;
-
-		let mut str = String::new();
-		writeln!(str, "/// @dev Property struct").unwrap();
-		writeln!(str, "struct {} {{", Self::name()).unwrap();
-		writeln!(str, "\tstring key;").unwrap();
-		writeln!(str, "\tbytes value;").unwrap();
-		writeln!(str, "}}").unwrap();
-		str
-	}
-}
-
-impl SolidityTypeName for Property {
-	fn solidity_name(writer: &mut impl fmt::Write, tc: &TypeCollector) -> fmt::Result {
-		write!(writer, "{}", tc.collect_struct::<Self>())
-	}
-
-	fn is_simple() -> bool {
-		false
-	}
-
-	fn solidity_default(writer: &mut impl fmt::Write, tc: &TypeCollector) -> fmt::Result {
-		write!(writer, "{}(", tc.collect_struct::<Self>())?;
-		address::solidity_default(writer, tc)?;
-		write!(writer, ",")?;
-		uint256::solidity_default(writer, tc)?;
-		write!(writer, ")")
-	}
-}
-
-impl SolidityType for Property {
-	fn names(tc: &TypeCollector) -> Vec<string> {
-		let mut collected = Vec::with_capacity(Self::len());
-		{
-			let mut out = string::new();
-			string::solidity_name(&mut out, tc).expect("no fmt error");
-			collected.push(out);
-		}
-		{
-			let mut out = string::new();
-			bytes::solidity_name(&mut out, tc).expect("no fmt error");
-			collected.push(out);
-		}
-		collected
-	}
-
-	fn len() -> usize {
-		2
-	}
-}
modifiedcrates/evm-coder/src/solidity/mod.rsdiffbeforeafterboth
--- a/crates/evm-coder/src/solidity/mod.rs
+++ b/crates/evm-coder/src/solidity/mod.rs
@@ -76,7 +76,8 @@
 		self.anonymous.borrow_mut().insert(names, id);
 		format!("Tuple{}", id)
 	}
-	pub fn collect_struct<T: StructCollect>(&self) -> String {
+	pub fn collect_struct<T: StructCollect + SolidityType>(&self) -> String {
+		let _names = T::names(self);
 		self.collect(<T as StructCollect>::declaration());
 		<T as StructCollect>::name()
 	}
modifiedcrates/evm-coder/tests/abi_derive_generation.rsdiffbeforeafterboth
--- a/crates/evm-coder/tests/abi_derive_generation.rs
+++ b/crates/evm-coder/tests/abi_derive_generation.rs
@@ -100,6 +100,15 @@
 	}
 
 	#[test]
+	#[cfg(feature = "stubgen")]
+	fn struct_collect_vec() {
+		assert_eq!(
+			<Vec<u8> as ::evm_coder::solidity::StructCollect>::name(),
+			"uint8[]"
+		);
+	}
+
+	#[test]
 	fn impl_abi_type_signature() {
 		assert_eq!(
 			<TypeStruct1SimpleParam as evm_coder::abi::AbiType>::SIGNATURE
modifiedpallets/common/src/eth.rsdiffbeforeafterboth
--- a/pallets/common/src/eth.rs
+++ b/pallets/common/src/eth.rs
@@ -16,6 +16,7 @@
 
 //! The module contains a number of functions for converting and checking ethereum identifiers.
 
+use sp_std::{vec, vec::Vec};
 use evm_coder::{
 	AbiCoder,
 	types::{uint256, address},
@@ -183,3 +184,102 @@
 	/// Permission to change the property for the owner of the token. See [`up_data_structs::PropertyPermission::collection_admin`]
 	CollectionAdmin,
 }
+
+/// Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.
+#[derive(Debug, Default, AbiCoder)]
+pub struct PropertyPermission {
+	/// TokenPermission field.
+	code: EthTokenPermissions,
+	/// TokenPermission value.
+	value: bool,
+}
+
+impl PropertyPermission {
+	pub fn into_vec(pp: up_data_structs::PropertyPermission) -> Vec<Self> {
+		vec![
+			PropertyPermission {
+				code: EthTokenPermissions::Mutable,
+				value: pp.mutable,
+			},
+			PropertyPermission {
+				code: EthTokenPermissions::TokenOwner,
+				value: pp.token_owner,
+			},
+			PropertyPermission {
+				code: EthTokenPermissions::CollectionAdmin,
+				value: pp.collection_admin,
+			},
+		]
+	}
+
+	pub fn from_vec(permission: Vec<Self>) -> up_data_structs::PropertyPermission {
+		let mut token_permission = up_data_structs::PropertyPermission::default();
+
+		for PropertyPermission { code, value } in permission {
+			match code {
+				EthTokenPermissions::Mutable => token_permission.mutable = value,
+				EthTokenPermissions::TokenOwner => token_permission.token_owner = value,
+				EthTokenPermissions::CollectionAdmin => token_permission.collection_admin = value,
+			}
+		}
+		token_permission
+	}
+}
+
+/// Ethereum representation of Token Property Permissions.
+#[derive(Debug, Default, AbiCoder)]
+pub struct TokenPropertyPermission {
+	/// Token property key.
+	key: evm_coder::types::string,
+	/// Token property permissions.
+	permissions: Vec<PropertyPermission>,
+}
+
+impl
+	From<(
+		up_data_structs::PropertyKey,
+		up_data_structs::PropertyPermission,
+	)> for TokenPropertyPermission
+{
+	fn from(
+		value: (
+			up_data_structs::PropertyKey,
+			up_data_structs::PropertyPermission,
+		),
+	) -> Self {
+		let (key, permission) = value;
+		let key = evm_coder::types::string::from_utf8(key.into_inner())
+			.expect("Stored key must be valid");
+		let permissions = PropertyPermission::into_vec(permission);
+		Self { key, permissions }
+	}
+}
+
+impl TokenPropertyPermission {
+	pub fn into_property_key_permissions(
+		permissions: Vec<TokenPropertyPermission>,
+	) -> evm_coder::execution::Result<Vec<up_data_structs::PropertyKeyPermission>> {
+		let mut perms = Vec::new();
+
+		for TokenPropertyPermission { key, permissions } in permissions {
+			if permissions.len() > <EthTokenPermissions as evm_coder::abi::AbiType>::FIELDS_COUNT {
+				return Err(alloc::format!(
+					"Actual number of fields {} for {}, which exceeds the maximum value of {}",
+					permissions.len(),
+					stringify!(EthTokenPermissions),
+					<EthTokenPermissions as evm_coder::abi::AbiType>::FIELDS_COUNT
+				)
+				.as_str()
+				.into());
+			}
+
+			let token_permission = PropertyPermission::from_vec(permissions);
+
+			perms.push(up_data_structs::PropertyKeyPermission {
+				key: key.into_bytes().try_into().map_err(|_| "too long key")?,
+				permission: token_permission,
+			});
+		}
+		Ok(perms)
+	}
+}
modifiedpallets/evm-contract-helpers/src/stubs/ContractHelpers.rawdiffbeforeafterboth

binary blob — no preview

modifiedpallets/fungible/src/stubs/UniqueFungible.rawdiffbeforeafterboth

binary blob — no preview

modifiedpallets/fungible/src/stubs/UniqueFungible.soldiffbeforeafterboth
--- a/pallets/fungible/src/stubs/UniqueFungible.sol
+++ b/pallets/fungible/src/stubs/UniqueFungible.sol
@@ -470,9 +470,12 @@
 	uint256 sub;
 }
 
+/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.
 enum CollectionPermissions {
-	CollectionAdmin,
-	TokenOwner
+	/// @dev Owner of token can nest tokens under it.
+	TokenOwner,
+	/// @dev Admin of token collection can nest tokens under token.
+	CollectionAdmin
 }
 
 /// @dev anonymous struct
@@ -516,9 +519,11 @@
 	uint256 field_2;
 }
 
-/// @dev Property struct
+/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).
 struct Property {
+	/// @dev Property key.
 	string key;
+	/// @dev Property value.
 	bytes value;
 }
 
modifiedpallets/nonfungible/src/erc.rsdiffbeforeafterboth
--- a/pallets/nonfungible/src/erc.rs
+++ b/pallets/nonfungible/src/erc.rs
@@ -38,7 +38,7 @@
 use pallet_common::{
 	CollectionHandle, CollectionPropertyPermissions, CommonCollectionOperations,
 	erc::{CommonEvmHandler, PrecompileResult, CollectionCall, static_property::key},
-	eth::{Property as PropertyStruct, EthCrossAccount, EthTokenPermissions},
+	eth::{Property as PropertyStruct, EthCrossAccount},
 };
 use pallet_evm::{account::CrossAccountId, PrecompileHandle};
 use pallet_evm_coder_substrate::call;
@@ -94,40 +94,12 @@
 	fn set_token_property_permissions(
 		&mut self,
 		caller: caller,
-		permissions: Vec<(string, Vec<(EthTokenPermissions, bool)>)>,
+		permissions: Vec<pallet_common::eth::TokenPropertyPermission>,
 	) -> Result<()> {
 		let caller = T::CrossAccountId::from_eth(caller);
-		let mut perms = Vec::new();
-
-		for (key, pp) in permissions {
-			if pp.len() > EthTokenPermissions::FIELDS_COUNT {
-				return Err(alloc::format!(
-					"Actual number of fields {} for {}, which exceeds the maximum value of {}",
-					pp.len(),
-					stringify!(EthTokenPermissions),
-					EthTokenPermissions::FIELDS_COUNT
-				)
-				.as_str()
-				.into());
-			}
-
-			let mut token_permission = PropertyPermission::default();
-
-			for (perm, value) in pp {
-				match perm {
-					EthTokenPermissions::Mutable => token_permission.mutable = value,
-					EthTokenPermissions::TokenOwner => token_permission.token_owner = value,
-					EthTokenPermissions::CollectionAdmin => {
-						token_permission.collection_admin = value
-					}
-				}
-			}
-
-			perms.push(PropertyKeyPermission {
-				key: key.into_bytes().try_into().map_err(|_| "too long key")?,
-				permission: token_permission,
-			});
-		}
+		let perms = pallet_common::eth::TokenPropertyPermission::into_property_key_permissions(
+			permissions,
+		)?;
 
 		<Pallet<T>>::set_token_property_permissions(self, &caller, perms)
 			.map_err(dispatch_to_evm::<T>)
@@ -136,19 +108,11 @@
 	/// @notice Get permissions for token properties.
 	fn token_property_permissions(
 		&self,
-	) -> Result<Vec<(string, Vec<(EthTokenPermissions, bool)>)>> {
+	) -> Result<Vec<pallet_common::eth::TokenPropertyPermission>> {
 		let perms = <Pallet<T>>::token_property_permission(self.id);
 		Ok(perms
 			.into_iter()
-			.map(|(key, pp)| {
-				let key = string::from_utf8(key.into_inner()).expect("Stored key must be valid");
-				let pp = vec![
-					(EthTokenPermissions::Mutable, pp.mutable),
-					(EthTokenPermissions::TokenOwner, pp.token_owner),
-					(EthTokenPermissions::CollectionAdmin, pp.collection_admin),
-				];
-				(key, pp)
-			})
+			.map(pallet_common::eth::TokenPropertyPermission::from)
 			.collect())
 	}
 
modifiedpallets/nonfungible/src/stubs/UniqueNFT.rawdiffbeforeafterboth

binary blob — no preview

modifiedpallets/nonfungible/src/stubs/UniqueNFT.soldiffbeforeafterboth
--- a/pallets/nonfungible/src/stubs/UniqueNFT.sol
+++ b/pallets/nonfungible/src/stubs/UniqueNFT.sol
@@ -42,7 +42,7 @@
 	/// @param permissions Permissions for keys.
 	/// @dev EVM selector for this function is: 0xbd92983a,
 	///  or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])
-	function setTokenPropertyPermissions(Tuple61[] memory permissions) public {
+	function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) public {
 		require(false, stub_error);
 		permissions;
 		dummy = 0;
@@ -51,10 +51,10 @@
 	/// @notice Get permissions for token properties.
 	/// @dev EVM selector for this function is: 0xf23d7790,
 	///  or in textual repr: tokenPropertyPermissions()
-	function tokenPropertyPermissions() public view returns (Tuple61[] memory) {
+	function tokenPropertyPermissions() public view returns (TokenPropertyPermission[] memory) {
 		require(false, stub_error);
 		dummy;
-		return new Tuple61[](0);
+		return new TokenPropertyPermission[](0);
 	}
 
 	// /// @notice Set token property value.
@@ -127,12 +127,30 @@
 	}
 }
 
-/// @dev Property struct
+/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).
 struct Property {
+	/// @dev Property key.
 	string key;
+	/// @dev Property value.
 	bytes value;
 }
 
+/// @dev Ethereum representation of Token Property Permissions.
+struct TokenPropertyPermission {
+	/// @dev Token property key.
+	string key;
+	/// @dev Token property permissions.
+	PropertyPermission[] permissions;
+}
+
+/// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.
+struct PropertyPermission {
+	/// @dev TokenPermission field.
+	EthTokenPermissions code;
+	/// @dev TokenPermission value.
+	bool value;
+}
+
 /// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.
 enum EthTokenPermissions {
 	/// @dev Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]
@@ -141,18 +159,6 @@
 	TokenOwner,
 	/// @dev Permission to change the property for the owner of the token. See [`up_data_structs::PropertyPermission::collection_admin`]
 	CollectionAdmin
-}
-
-/// @dev anonymous struct
-struct Tuple61 {
-	string field_0;
-	Tuple59[] field_1;
-}
-
-/// @dev anonymous struct
-struct Tuple59 {
-	EthTokenPermissions field_0;
-	bool field_1;
 }
 
 /// @title A contract that allows you to work with collections.
@@ -608,9 +614,12 @@
 	uint256 sub;
 }
 
+/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.
 enum CollectionPermissions {
-	CollectionAdmin,
-	TokenOwner
+	/// @dev Owner of token can nest tokens under it.
+	TokenOwner,
+	/// @dev Admin of token collection can nest tokens under token.
+	CollectionAdmin
 }
 
 /// @dev anonymous struct
modifiedpallets/refungible/src/erc.rsdiffbeforeafterboth
--- a/pallets/refungible/src/erc.rs
+++ b/pallets/refungible/src/erc.rs
@@ -33,7 +33,7 @@
 use pallet_common::{
 	CollectionHandle, CollectionPropertyPermissions, CommonCollectionOperations,
 	erc::{CommonEvmHandler, CollectionCall, static_property::key},
-	eth::{Property as PropertyStruct, EthCrossAccount, EthTokenPermissions},
+	eth::{Property as PropertyStruct, EthCrossAccount},
 	Error as CommonError,
 };
 use pallet_evm::{account::CrossAccountId, PrecompileHandle};
@@ -97,47 +97,13 @@
 	fn set_token_property_permissions(
 		&mut self,
 		caller: caller,
-		permissions: Vec<(string, Vec<(EthTokenPermissions, bool)>)>,
+		permissions: Vec<pallet_common::eth::TokenPropertyPermission>,
 	) -> Result<()> {
 		let caller = T::CrossAccountId::from_eth(caller);
-		const PERMISSIONS_FIELDS_COUNT: usize = 3;
-
-		let mut perms = Vec::new();
-
-		for (key, pp) in permissions {
-			if pp.len() > PERMISSIONS_FIELDS_COUNT {
-				return Err(alloc::format!(
-					"Actual number of fields {} for {}, which exceeds the maximum value of {}",
-					pp.len(),
-					stringify!(EthTokenPermissions),
-					PERMISSIONS_FIELDS_COUNT
-				)
-				.as_str()
-				.into());
-			}
-
-			let mut token_permission = PropertyPermission {
-				mutable: false,
-				collection_admin: false,
-				token_owner: false,
-			};
+		let perms = pallet_common::eth::TokenPropertyPermission::into_property_key_permissions(
+			permissions,
+		)?;
 
-			for (perm, value) in pp {
-				match perm {
-					EthTokenPermissions::Mutable => token_permission.mutable = value,
-					EthTokenPermissions::TokenOwner => token_permission.token_owner = value,
-					EthTokenPermissions::CollectionAdmin => {
-						token_permission.collection_admin = value
-					}
-				}
-			}
-
-			perms.push(PropertyKeyPermission {
-				key: key.into_bytes().try_into().map_err(|_| "too long key")?,
-				permission: token_permission,
-			});
-		}
-
 		<Pallet<T>>::set_token_property_permissions(self, &caller, perms)
 			.map_err(dispatch_to_evm::<T>)
 	}
@@ -145,19 +111,11 @@
 	/// @notice Get permissions for token properties.
 	fn token_property_permissions(
 		&self,
-	) -> Result<Vec<(string, Vec<(EthTokenPermissions, bool)>)>> {
+	) -> Result<Vec<pallet_common::eth::TokenPropertyPermission>> {
 		let perms = <Pallet<T>>::token_property_permission(self.id);
 		Ok(perms
 			.into_iter()
-			.map(|(key, pp)| {
-				let key = string::from_utf8(key.into_inner()).expect("Stored key must be valid");
-				let pp = vec![
-					(EthTokenPermissions::Mutable, pp.mutable),
-					(EthTokenPermissions::TokenOwner, pp.token_owner),
-					(EthTokenPermissions::CollectionAdmin, pp.collection_admin),
-				];
-				(key, pp)
-			})
+			.map(pallet_common::eth::TokenPropertyPermission::from)
 			.collect())
 	}
 
modifiedpallets/refungible/src/stubs/UniqueRefungible.rawdiffbeforeafterboth

binary blob — no preview

modifiedpallets/refungible/src/stubs/UniqueRefungible.soldiffbeforeafterboth
--- a/pallets/refungible/src/stubs/UniqueRefungible.sol
+++ b/pallets/refungible/src/stubs/UniqueRefungible.sol
@@ -42,7 +42,7 @@
 	/// @param permissions Permissions for keys.
 	/// @dev EVM selector for this function is: 0xbd92983a,
 	///  or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])
-	function setTokenPropertyPermissions(Tuple60[] memory permissions) public {
+	function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) public {
 		require(false, stub_error);
 		permissions;
 		dummy = 0;
@@ -51,10 +51,10 @@
 	/// @notice Get permissions for token properties.
 	/// @dev EVM selector for this function is: 0xf23d7790,
 	///  or in textual repr: tokenPropertyPermissions()
-	function tokenPropertyPermissions() public view returns (Tuple60[] memory) {
+	function tokenPropertyPermissions() public view returns (TokenPropertyPermission[] memory) {
 		require(false, stub_error);
 		dummy;
-		return new Tuple60[](0);
+		return new TokenPropertyPermission[](0);
 	}
 
 	// /// @notice Set token property value.
@@ -127,12 +127,30 @@
 	}
 }
 
-/// @dev Property struct
+/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).
 struct Property {
+	/// @dev Property key.
 	string key;
+	/// @dev Property value.
 	bytes value;
 }
 
+/// @dev Ethereum representation of Token Property Permissions.
+struct TokenPropertyPermission {
+	/// @dev Token property key.
+	string key;
+	/// @dev Token property permissions.
+	PropertyPermission[] permissions;
+}
+
+/// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.
+struct PropertyPermission {
+	/// @dev TokenPermission field.
+	EthTokenPermissions code;
+	/// @dev TokenPermission value.
+	bool value;
+}
+
 /// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.
 enum EthTokenPermissions {
 	/// @dev Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]
@@ -141,18 +159,6 @@
 	TokenOwner,
 	/// @dev Permission to change the property for the owner of the token. See [`up_data_structs::PropertyPermission::collection_admin`]
 	CollectionAdmin
-}
-
-/// @dev anonymous struct
-struct Tuple60 {
-	string field_0;
-	Tuple58[] field_1;
-}
-
-/// @dev anonymous struct
-struct Tuple58 {
-	EthTokenPermissions field_0;
-	bool field_1;
 }
 
 /// @title A contract that allows you to work with collections.
@@ -608,9 +614,12 @@
 	uint256 sub;
 }
 
+/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.
 enum CollectionPermissions {
-	CollectionAdmin,
-	TokenOwner
+	/// @dev Owner of token can nest tokens under it.
+	TokenOwner,
+	/// @dev Admin of token collection can nest tokens under token.
+	CollectionAdmin
 }
 
 /// @dev anonymous struct
modifiedpallets/refungible/src/stubs/UniqueRefungibleToken.rawdiffbeforeafterboth

binary blob — no preview

modifiedpallets/unique/src/eth/stubs/CollectionHelpers.rawdiffbeforeafterboth

binary blob — no preview

modifiedtests/src/eth/abi/nonFungible.jsondiffbeforeafterboth
--- a/tests/src/eth/abi/nonFungible.json
+++ b/tests/src/eth/abi/nonFungible.json
@@ -752,22 +752,22 @@
     "inputs": [
       {
         "components": [
-          { "internalType": "string", "name": "field_0", "type": "string" },
+          { "internalType": "string", "name": "key", "type": "string" },
           {
             "components": [
               {
                 "internalType": "enum EthTokenPermissions",
-                "name": "field_0",
+                "name": "code",
                 "type": "uint8"
               },
-              { "internalType": "bool", "name": "field_1", "type": "bool" }
+              { "internalType": "bool", "name": "value", "type": "bool" }
             ],
-            "internalType": "struct Tuple59[]",
-            "name": "field_1",
+            "internalType": "struct PropertyPermission[]",
+            "name": "permissions",
             "type": "tuple[]"
           }
         ],
-        "internalType": "struct Tuple61[]",
+        "internalType": "struct TokenPropertyPermission[]",
         "name": "permissions",
         "type": "tuple[]"
       }
@@ -818,22 +818,22 @@
     "outputs": [
       {
         "components": [
-          { "internalType": "string", "name": "field_0", "type": "string" },
+          { "internalType": "string", "name": "key", "type": "string" },
           {
             "components": [
               {
                 "internalType": "enum EthTokenPermissions",
-                "name": "field_0",
+                "name": "code",
                 "type": "uint8"
               },
-              { "internalType": "bool", "name": "field_1", "type": "bool" }
+              { "internalType": "bool", "name": "value", "type": "bool" }
             ],
-            "internalType": "struct Tuple59[]",
-            "name": "field_1",
+            "internalType": "struct PropertyPermission[]",
+            "name": "permissions",
             "type": "tuple[]"
           }
         ],
-        "internalType": "struct Tuple61[]",
+        "internalType": "struct TokenPropertyPermission[]",
         "name": "",
         "type": "tuple[]"
       }
modifiedtests/src/eth/abi/reFungible.jsondiffbeforeafterboth
--- a/tests/src/eth/abi/reFungible.json
+++ b/tests/src/eth/abi/reFungible.json
@@ -734,22 +734,22 @@
     "inputs": [
       {
         "components": [
-          { "internalType": "string", "name": "field_0", "type": "string" },
+          { "internalType": "string", "name": "key", "type": "string" },
           {
             "components": [
               {
                 "internalType": "enum EthTokenPermissions",
-                "name": "field_0",
+                "name": "code",
                 "type": "uint8"
               },
-              { "internalType": "bool", "name": "field_1", "type": "bool" }
+              { "internalType": "bool", "name": "value", "type": "bool" }
             ],
-            "internalType": "struct Tuple58[]",
-            "name": "field_1",
+            "internalType": "struct PropertyPermission[]",
+            "name": "permissions",
             "type": "tuple[]"
           }
         ],
-        "internalType": "struct Tuple60[]",
+        "internalType": "struct TokenPropertyPermission[]",
         "name": "permissions",
         "type": "tuple[]"
       }
@@ -809,22 +809,22 @@
     "outputs": [
       {
         "components": [
-          { "internalType": "string", "name": "field_0", "type": "string" },
+          { "internalType": "string", "name": "key", "type": "string" },
           {
             "components": [
               {
                 "internalType": "enum EthTokenPermissions",
-                "name": "field_0",
+                "name": "code",
                 "type": "uint8"
               },
-              { "internalType": "bool", "name": "field_1", "type": "bool" }
+              { "internalType": "bool", "name": "value", "type": "bool" }
             ],
-            "internalType": "struct Tuple58[]",
-            "name": "field_1",
+            "internalType": "struct PropertyPermission[]",
+            "name": "permissions",
             "type": "tuple[]"
           }
         ],
-        "internalType": "struct Tuple60[]",
+        "internalType": "struct TokenPropertyPermission[]",
         "name": "",
         "type": "tuple[]"
       }
modifiedtests/src/eth/api/UniqueFungible.soldiffbeforeafterboth
before · tests/src/eth/api/UniqueFungible.sol
1// SPDX-License-Identifier: OTHER2// This code is automatically generated34pragma solidity >=0.8.0 <0.9.0;56/// @dev common stubs holder7interface Dummy {89}1011interface ERC165 is Dummy {12	function supportsInterface(bytes4 interfaceID) external view returns (bool);13}1415/// @title A contract that allows you to work with collections.16/// @dev the ERC-165 identifier for this interface is 0x81172a7517interface Collection is Dummy, ERC165 {18	// /// Set collection property.19	// ///20	// /// @param key Property key.21	// /// @param value Propery value.22	// /// @dev EVM selector for this function is: 0x2f073f66,23	// ///  or in textual repr: setCollectionProperty(string,bytes)24	// function setCollectionProperty(string memory key, bytes memory value) external;2526	/// Set collection properties.27	///28	/// @param properties Vector of properties key/value pair.29	/// @dev EVM selector for this function is: 0x50b26b2a,30	///  or in textual repr: setCollectionProperties((string,bytes)[])31	function setCollectionProperties(Property[] memory properties) external;3233	// /// Delete collection property.34	// ///35	// /// @param key Property key.36	// /// @dev EVM selector for this function is: 0x7b7debce,37	// ///  or in textual repr: deleteCollectionProperty(string)38	// function deleteCollectionProperty(string memory key) external;3940	/// Delete collection properties.41	///42	/// @param keys Properties keys.43	/// @dev EVM selector for this function is: 0xee206ee3,44	///  or in textual repr: deleteCollectionProperties(string[])45	function deleteCollectionProperties(string[] memory keys) external;4647	/// Get collection property.48	///49	/// @dev Throws error if key not found.50	///51	/// @param key Property key.52	/// @return bytes The property corresponding to the key.53	/// @dev EVM selector for this function is: 0xcf24fd6d,54	///  or in textual repr: collectionProperty(string)55	function collectionProperty(string memory key) external view returns (bytes memory);5657	/// Get collection properties.58	///59	/// @param keys Properties keys. Empty keys for all propertyes.60	/// @return Vector of properties key/value pairs.61	/// @dev EVM selector for this function is: 0x285fb8e6,62	///  or in textual repr: collectionProperties(string[])63	function collectionProperties(string[] memory keys) external view returns (Property[] memory);6465	// /// Set the sponsor of the collection.66	// ///67	// /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.68	// ///69	// /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.70	// /// @dev EVM selector for this function is: 0x7623402e,71	// ///  or in textual repr: setCollectionSponsor(address)72	// function setCollectionSponsor(address sponsor) external;7374	/// Set the sponsor of the collection.75	///76	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.77	///78	/// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.79	/// @dev EVM selector for this function is: 0x84a1d5a8,80	///  or in textual repr: setCollectionSponsorCross((address,uint256))81	function setCollectionSponsorCross(EthCrossAccount memory sponsor) external;8283	/// Whether there is a pending sponsor.84	/// @dev EVM selector for this function is: 0x058ac185,85	///  or in textual repr: hasCollectionPendingSponsor()86	function hasCollectionPendingSponsor() external view returns (bool);8788	/// Collection sponsorship confirmation.89	///90	/// @dev After setting the sponsor for the collection, it must be confirmed with this function.91	/// @dev EVM selector for this function is: 0x3c50e97a,92	///  or in textual repr: confirmCollectionSponsorship()93	function confirmCollectionSponsorship() external;9495	/// Remove collection sponsor.96	/// @dev EVM selector for this function is: 0x6e0326a3,97	///  or in textual repr: removeCollectionSponsor()98	function removeCollectionSponsor() external;99100	/// Get current sponsor.101	///102	/// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.103	/// @dev EVM selector for this function is: 0x6ec0a9f1,104	///  or in textual repr: collectionSponsor()105	function collectionSponsor() external view returns (EthCrossAccount memory);106107	/// Get current collection limits.108	///109	/// @return Array of tuples (byte, bool, uint256) with limits and their values. Order of limits:110	/// 	"accountTokenOwnershipLimit",111	/// 	"sponsoredDataSize",112	/// 	"sponsoredDataRateLimit",113	/// 	"tokenLimit",114	/// 	"sponsorTransferTimeout",115	/// 	"sponsorApproveTimeout"116	///  	"ownerCanTransfer",117	/// 	"ownerCanDestroy",118	/// 	"transfersEnabled"119	/// Return `false` if a limit not set.120	/// @dev EVM selector for this function is: 0xf63bc572,121	///  or in textual repr: collectionLimits()122	function collectionLimits() external view returns (Tuple21[] memory);123124	/// Set limits for the collection.125	/// @dev Throws error if limit not found.126	/// @param limit Name of the limit. Valid names:127	/// 	"accountTokenOwnershipLimit",128	/// 	"sponsoredDataSize",129	/// 	"sponsoredDataRateLimit",130	/// 	"tokenLimit",131	/// 	"sponsorTransferTimeout",132	/// 	"sponsorApproveTimeout"133	///  	"ownerCanTransfer",134	/// 	"ownerCanDestroy",135	/// 	"transfersEnabled"136	/// @param status enable\disable limit. Works only with `true`.137	/// @param value Value of the limit.138	/// @dev EVM selector for this function is: 0x88150bd0,139	///  or in textual repr: setCollectionLimit(uint8,bool,uint256)140	function setCollectionLimit(141		CollectionLimits limit,142		bool status,143		uint256 value144	) external;145146	/// Get contract address.147	/// @dev EVM selector for this function is: 0xf6b4dfb4,148	///  or in textual repr: contractAddress()149	function contractAddress() external view returns (address);150151	/// Add collection admin.152	/// @param newAdmin Cross account administrator address.153	/// @dev EVM selector for this function is: 0x859aa7d6,154	///  or in textual repr: addCollectionAdminCross((address,uint256))155	function addCollectionAdminCross(EthCrossAccount memory newAdmin) external;156157	/// Remove collection admin.158	/// @param admin Cross account administrator address.159	/// @dev EVM selector for this function is: 0x6c0cd173,160	///  or in textual repr: removeCollectionAdminCross((address,uint256))161	function removeCollectionAdminCross(EthCrossAccount memory admin) external;162163	// /// Add collection admin.164	// /// @param newAdmin Address of the added administrator.165	// /// @dev EVM selector for this function is: 0x92e462c7,166	// ///  or in textual repr: addCollectionAdmin(address)167	// function addCollectionAdmin(address newAdmin) external;168169	// /// Remove collection admin.170	// ///171	// /// @param admin Address of the removed administrator.172	// /// @dev EVM selector for this function is: 0xfafd7b42,173	// ///  or in textual repr: removeCollectionAdmin(address)174	// function removeCollectionAdmin(address admin) external;175176	/// Toggle accessibility of collection nesting.177	///178	/// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'179	/// @dev EVM selector for this function is: 0x112d4586,180	///  or in textual repr: setCollectionNesting(bool)181	function setCollectionNesting(bool enable) external;182183	/// Toggle accessibility of collection nesting.184	///185	/// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'186	/// @param collections Addresses of collections that will be available for nesting.187	/// @dev EVM selector for this function is: 0x64872396,188	///  or in textual repr: setCollectionNesting(bool,address[])189	function setCollectionNesting(bool enable, address[] memory collections) external;190191	/// Returns nesting for a collection192	/// @dev EVM selector for this function is: 0x22d25bfe,193	///  or in textual repr: collectionNestingRestrictedCollectionIds()194	function collectionNestingRestrictedCollectionIds() external view returns (Tuple26 memory);195196	/// Returns permissions for a collection197	/// @dev EVM selector for this function is: 0x5b2eaf4b,198	///  or in textual repr: collectionNestingPermissions()199	function collectionNestingPermissions() external view returns (Tuple29[] memory);200201	/// Set the collection access method.202	/// @param mode Access mode203	/// 	0 for Normal204	/// 	1 for AllowList205	/// @dev EVM selector for this function is: 0x41835d4c,206	///  or in textual repr: setCollectionAccess(uint8)207	function setCollectionAccess(uint8 mode) external;208209	/// Checks that user allowed to operate with collection.210	///211	/// @param user User address to check.212	/// @dev EVM selector for this function is: 0x91b6df49,213	///  or in textual repr: allowlistedCross((address,uint256))214	function allowlistedCross(EthCrossAccount memory user) external view returns (bool);215216	// /// Add the user to the allowed list.217	// ///218	// /// @param user Address of a trusted user.219	// /// @dev EVM selector for this function is: 0x67844fe6,220	// ///  or in textual repr: addToCollectionAllowList(address)221	// function addToCollectionAllowList(address user) external;222223	/// Add user to allowed list.224	///225	/// @param user User cross account address.226	/// @dev EVM selector for this function is: 0xa0184a3a,227	///  or in textual repr: addToCollectionAllowListCross((address,uint256))228	function addToCollectionAllowListCross(EthCrossAccount memory user) external;229230	// /// Remove the user from the allowed list.231	// ///232	// /// @param user Address of a removed user.233	// /// @dev EVM selector for this function is: 0x85c51acb,234	// ///  or in textual repr: removeFromCollectionAllowList(address)235	// function removeFromCollectionAllowList(address user) external;236237	/// Remove user from allowed list.238	///239	/// @param user User cross account address.240	/// @dev EVM selector for this function is: 0x09ba452a,241	///  or in textual repr: removeFromCollectionAllowListCross((address,uint256))242	function removeFromCollectionAllowListCross(EthCrossAccount memory user) external;243244	/// Switch permission for minting.245	///246	/// @param mode Enable if "true".247	/// @dev EVM selector for this function is: 0x00018e84,248	///  or in textual repr: setCollectionMintMode(bool)249	function setCollectionMintMode(bool mode) external;250251	// /// Check that account is the owner or admin of the collection252	// ///253	// /// @param user account to verify254	// /// @return "true" if account is the owner or admin255	// /// @dev EVM selector for this function is: 0x9811b0c7,256	// ///  or in textual repr: isOwnerOrAdmin(address)257	// function isOwnerOrAdmin(address user) external view returns (bool);258259	/// Check that account is the owner or admin of the collection260	///261	/// @param user User cross account to verify262	/// @return "true" if account is the owner or admin263	/// @dev EVM selector for this function is: 0x3e75a905,264	///  or in textual repr: isOwnerOrAdminCross((address,uint256))265	function isOwnerOrAdminCross(EthCrossAccount memory user) external view returns (bool);266267	/// Returns collection type268	///269	/// @return `Fungible` or `NFT` or `ReFungible`270	/// @dev EVM selector for this function is: 0xd34b55b8,271	///  or in textual repr: uniqueCollectionType()272	function uniqueCollectionType() external view returns (string memory);273274	/// Get collection owner.275	///276	/// @return Tuble with sponsor address and his substrate mirror.277	/// If address is canonical then substrate mirror is zero and vice versa.278	/// @dev EVM selector for this function is: 0xdf727d3b,279	///  or in textual repr: collectionOwner()280	function collectionOwner() external view returns (EthCrossAccount memory);281282	// /// Changes collection owner to another account283	// ///284	// /// @dev Owner can be changed only by current owner285	// /// @param newOwner new owner account286	// /// @dev EVM selector for this function is: 0x4f53e226,287	// ///  or in textual repr: changeCollectionOwner(address)288	// function changeCollectionOwner(address newOwner) external;289290	/// Get collection administrators291	///292	/// @return Vector of tuples with admins address and his substrate mirror.293	/// If address is canonical then substrate mirror is zero and vice versa.294	/// @dev EVM selector for this function is: 0x5813216b,295	///  or in textual repr: collectionAdmins()296	function collectionAdmins() external view returns (EthCrossAccount[] memory);297298	/// Changes collection owner to another account299	///300	/// @dev Owner can be changed only by current owner301	/// @param newOwner new owner cross account302	/// @dev EVM selector for this function is: 0x6496c497,303	///  or in textual repr: changeCollectionOwnerCross((address,uint256))304	function changeCollectionOwnerCross(EthCrossAccount memory newOwner) external;305}306307/// @dev Cross account struct308struct EthCrossAccount {309	address eth;310	uint256 sub;311}312313/// @dev anonymous struct314struct Tuple29 {315	CollectionPermissions field_0;316	bool field_1;317}318319enum CollectionPermissions {320	CollectionAdmin,321	TokenOwner322}323324/// @dev anonymous struct325struct Tuple26 {326	bool field_0;327	uint256[] field_1;328}329330/// @dev [`CollectionLimits`](up_data_structs::CollectionLimits) representation for EVM.331enum CollectionLimits {332	/// @dev How many tokens can a user have on one account.333	AccountTokenOwnership,334	/// @dev How many bytes of data are available for sponsorship.335	SponsoredDataSize,336	/// @dev In any case, chain default: [`SponsoringRateLimit::SponsoringDisabled`]337	SponsoredDataRateLimit,338	/// @dev How many tokens can be mined into this collection.339	TokenLimit,340	/// @dev Timeouts for transfer sponsoring.341	SponsorTransferTimeout,342	/// @dev Timeout for sponsoring an approval in passed blocks.343	SponsorApproveTimeout,344	/// @dev Whether the collection owner of the collection can send tokens (which belong to other users).345	OwnerCanTransfer,346	/// @dev Can the collection owner burn other people's tokens.347	OwnerCanDestroy,348	/// @dev Is it possible to send tokens from this collection between users.349	TransferEnabled350}351352/// @dev anonymous struct353struct Tuple21 {354	CollectionLimits field_0;355	bool field_1;356	uint256 field_2;357}358359/// @dev Property struct360struct Property {361	string key;362	bytes value;363}364365/// @dev the ERC-165 identifier for this interface is 0x7dee5997366interface ERC20UniqueExtensions is Dummy, ERC165 {367	/// @notice A description for the collection.368	/// @dev EVM selector for this function is: 0x7284e416,369	///  or in textual repr: description()370	function description() external view returns (string memory);371372	/// @dev EVM selector for this function is: 0x269e6158,373	///  or in textual repr: mintCross((address,uint256),uint256)374	function mintCross(EthCrossAccount memory to, uint256 amount) external returns (bool);375376	/// @dev EVM selector for this function is: 0x0ecd0ab0,377	///  or in textual repr: approveCross((address,uint256),uint256)378	function approveCross(EthCrossAccount memory spender, uint256 amount) external returns (bool);379380	// /// Burn tokens from account381	// /// @dev Function that burns an `amount` of the tokens of a given account,382	// /// deducting from the sender's allowance for said account.383	// /// @param from The account whose tokens will be burnt.384	// /// @param amount The amount that will be burnt.385	// /// @dev EVM selector for this function is: 0x79cc6790,386	// ///  or in textual repr: burnFrom(address,uint256)387	// function burnFrom(address from, uint256 amount) external returns (bool);388389	/// Burn tokens from account390	/// @dev Function that burns an `amount` of the tokens of a given account,391	/// deducting from the sender's allowance for said account.392	/// @param from The account whose tokens will be burnt.393	/// @param amount The amount that will be burnt.394	/// @dev EVM selector for this function is: 0xbb2f5a58,395	///  or in textual repr: burnFromCross((address,uint256),uint256)396	function burnFromCross(EthCrossAccount memory from, uint256 amount) external returns (bool);397398	/// Mint tokens for multiple accounts.399	/// @param amounts array of pairs of account address and amount400	/// @dev EVM selector for this function is: 0x1acf2d55,401	///  or in textual repr: mintBulk((address,uint256)[])402	function mintBulk(Tuple9[] memory amounts) external returns (bool);403404	/// @dev EVM selector for this function is: 0x2ada85ff,405	///  or in textual repr: transferCross((address,uint256),uint256)406	function transferCross(EthCrossAccount memory to, uint256 amount) external returns (bool);407408	/// @dev EVM selector for this function is: 0xd5cf430b,409	///  or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)410	function transferFromCross(411		EthCrossAccount memory from,412		EthCrossAccount memory to,413		uint256 amount414	) external returns (bool);415}416417/// @dev anonymous struct418struct Tuple9 {419	address field_0;420	uint256 field_1;421}422423/// @dev the ERC-165 identifier for this interface is 0x40c10f19424interface ERC20Mintable is Dummy, ERC165 {425	/// Mint tokens for `to` account.426	/// @param to account that will receive minted tokens427	/// @param amount amount of tokens to mint428	/// @dev EVM selector for this function is: 0x40c10f19,429	///  or in textual repr: mint(address,uint256)430	function mint(address to, uint256 amount) external returns (bool);431}432433/// @dev inlined interface434interface ERC20Events {435	event Transfer(address indexed from, address indexed to, uint256 value);436	event Approval(address indexed owner, address indexed spender, uint256 value);437}438439/// @dev the ERC-165 identifier for this interface is 0x8cb847c4440interface ERC20 is Dummy, ERC165, ERC20Events {441	/// @dev EVM selector for this function is: 0x06fdde03,442	///  or in textual repr: name()443	function name() external view returns (string memory);444445	/// @dev EVM selector for this function is: 0x95d89b41,446	///  or in textual repr: symbol()447	function symbol() external view returns (string memory);448449	/// @dev EVM selector for this function is: 0x18160ddd,450	///  or in textual repr: totalSupply()451	function totalSupply() external view returns (uint256);452453	/// @dev EVM selector for this function is: 0x313ce567,454	///  or in textual repr: decimals()455	function decimals() external view returns (uint8);456457	/// @dev EVM selector for this function is: 0x70a08231,458	///  or in textual repr: balanceOf(address)459	function balanceOf(address owner) external view returns (uint256);460461	/// @dev EVM selector for this function is: 0xa9059cbb,462	///  or in textual repr: transfer(address,uint256)463	function transfer(address to, uint256 amount) external returns (bool);464465	/// @dev EVM selector for this function is: 0x23b872dd,466	///  or in textual repr: transferFrom(address,address,uint256)467	function transferFrom(468		address from,469		address to,470		uint256 amount471	) external returns (bool);472473	/// @dev EVM selector for this function is: 0x095ea7b3,474	///  or in textual repr: approve(address,uint256)475	function approve(address spender, uint256 amount) external returns (bool);476477	/// @dev EVM selector for this function is: 0xdd62ed3e,478	///  or in textual repr: allowance(address,address)479	function allowance(address owner, address spender) external view returns (uint256);480481	/// @notice Returns collection helper contract address482	/// @dev EVM selector for this function is: 0x1896cce6,483	///  or in textual repr: collectionHelperAddress()484	function collectionHelperAddress() external view returns (address);485}486487interface UniqueFungible is Dummy, ERC165, ERC20, ERC20Mintable, ERC20UniqueExtensions, Collection {}
after · tests/src/eth/api/UniqueFungible.sol
1// SPDX-License-Identifier: OTHER2// This code is automatically generated34pragma solidity >=0.8.0 <0.9.0;56/// @dev common stubs holder7interface Dummy {89}1011interface ERC165 is Dummy {12	function supportsInterface(bytes4 interfaceID) external view returns (bool);13}1415/// @title A contract that allows you to work with collections.16/// @dev the ERC-165 identifier for this interface is 0x81172a7517interface Collection is Dummy, ERC165 {18	// /// Set collection property.19	// ///20	// /// @param key Property key.21	// /// @param value Propery value.22	// /// @dev EVM selector for this function is: 0x2f073f66,23	// ///  or in textual repr: setCollectionProperty(string,bytes)24	// function setCollectionProperty(string memory key, bytes memory value) external;2526	/// Set collection properties.27	///28	/// @param properties Vector of properties key/value pair.29	/// @dev EVM selector for this function is: 0x50b26b2a,30	///  or in textual repr: setCollectionProperties((string,bytes)[])31	function setCollectionProperties(Property[] memory properties) external;3233	// /// Delete collection property.34	// ///35	// /// @param key Property key.36	// /// @dev EVM selector for this function is: 0x7b7debce,37	// ///  or in textual repr: deleteCollectionProperty(string)38	// function deleteCollectionProperty(string memory key) external;3940	/// Delete collection properties.41	///42	/// @param keys Properties keys.43	/// @dev EVM selector for this function is: 0xee206ee3,44	///  or in textual repr: deleteCollectionProperties(string[])45	function deleteCollectionProperties(string[] memory keys) external;4647	/// Get collection property.48	///49	/// @dev Throws error if key not found.50	///51	/// @param key Property key.52	/// @return bytes The property corresponding to the key.53	/// @dev EVM selector for this function is: 0xcf24fd6d,54	///  or in textual repr: collectionProperty(string)55	function collectionProperty(string memory key) external view returns (bytes memory);5657	/// Get collection properties.58	///59	/// @param keys Properties keys. Empty keys for all propertyes.60	/// @return Vector of properties key/value pairs.61	/// @dev EVM selector for this function is: 0x285fb8e6,62	///  or in textual repr: collectionProperties(string[])63	function collectionProperties(string[] memory keys) external view returns (Property[] memory);6465	// /// Set the sponsor of the collection.66	// ///67	// /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.68	// ///69	// /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.70	// /// @dev EVM selector for this function is: 0x7623402e,71	// ///  or in textual repr: setCollectionSponsor(address)72	// function setCollectionSponsor(address sponsor) external;7374	/// Set the sponsor of the collection.75	///76	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.77	///78	/// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.79	/// @dev EVM selector for this function is: 0x84a1d5a8,80	///  or in textual repr: setCollectionSponsorCross((address,uint256))81	function setCollectionSponsorCross(EthCrossAccount memory sponsor) external;8283	/// Whether there is a pending sponsor.84	/// @dev EVM selector for this function is: 0x058ac185,85	///  or in textual repr: hasCollectionPendingSponsor()86	function hasCollectionPendingSponsor() external view returns (bool);8788	/// Collection sponsorship confirmation.89	///90	/// @dev After setting the sponsor for the collection, it must be confirmed with this function.91	/// @dev EVM selector for this function is: 0x3c50e97a,92	///  or in textual repr: confirmCollectionSponsorship()93	function confirmCollectionSponsorship() external;9495	/// Remove collection sponsor.96	/// @dev EVM selector for this function is: 0x6e0326a3,97	///  or in textual repr: removeCollectionSponsor()98	function removeCollectionSponsor() external;99100	/// Get current sponsor.101	///102	/// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.103	/// @dev EVM selector for this function is: 0x6ec0a9f1,104	///  or in textual repr: collectionSponsor()105	function collectionSponsor() external view returns (EthCrossAccount memory);106107	/// Get current collection limits.108	///109	/// @return Array of tuples (byte, bool, uint256) with limits and their values. Order of limits:110	/// 	"accountTokenOwnershipLimit",111	/// 	"sponsoredDataSize",112	/// 	"sponsoredDataRateLimit",113	/// 	"tokenLimit",114	/// 	"sponsorTransferTimeout",115	/// 	"sponsorApproveTimeout"116	///  	"ownerCanTransfer",117	/// 	"ownerCanDestroy",118	/// 	"transfersEnabled"119	/// Return `false` if a limit not set.120	/// @dev EVM selector for this function is: 0xf63bc572,121	///  or in textual repr: collectionLimits()122	function collectionLimits() external view returns (Tuple21[] memory);123124	/// Set limits for the collection.125	/// @dev Throws error if limit not found.126	/// @param limit Name of the limit. Valid names:127	/// 	"accountTokenOwnershipLimit",128	/// 	"sponsoredDataSize",129	/// 	"sponsoredDataRateLimit",130	/// 	"tokenLimit",131	/// 	"sponsorTransferTimeout",132	/// 	"sponsorApproveTimeout"133	///  	"ownerCanTransfer",134	/// 	"ownerCanDestroy",135	/// 	"transfersEnabled"136	/// @param status enable\disable limit. Works only with `true`.137	/// @param value Value of the limit.138	/// @dev EVM selector for this function is: 0x88150bd0,139	///  or in textual repr: setCollectionLimit(uint8,bool,uint256)140	function setCollectionLimit(141		CollectionLimits limit,142		bool status,143		uint256 value144	) external;145146	/// Get contract address.147	/// @dev EVM selector for this function is: 0xf6b4dfb4,148	///  or in textual repr: contractAddress()149	function contractAddress() external view returns (address);150151	/// Add collection admin.152	/// @param newAdmin Cross account administrator address.153	/// @dev EVM selector for this function is: 0x859aa7d6,154	///  or in textual repr: addCollectionAdminCross((address,uint256))155	function addCollectionAdminCross(EthCrossAccount memory newAdmin) external;156157	/// Remove collection admin.158	/// @param admin Cross account administrator address.159	/// @dev EVM selector for this function is: 0x6c0cd173,160	///  or in textual repr: removeCollectionAdminCross((address,uint256))161	function removeCollectionAdminCross(EthCrossAccount memory admin) external;162163	// /// Add collection admin.164	// /// @param newAdmin Address of the added administrator.165	// /// @dev EVM selector for this function is: 0x92e462c7,166	// ///  or in textual repr: addCollectionAdmin(address)167	// function addCollectionAdmin(address newAdmin) external;168169	// /// Remove collection admin.170	// ///171	// /// @param admin Address of the removed administrator.172	// /// @dev EVM selector for this function is: 0xfafd7b42,173	// ///  or in textual repr: removeCollectionAdmin(address)174	// function removeCollectionAdmin(address admin) external;175176	/// Toggle accessibility of collection nesting.177	///178	/// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'179	/// @dev EVM selector for this function is: 0x112d4586,180	///  or in textual repr: setCollectionNesting(bool)181	function setCollectionNesting(bool enable) external;182183	/// Toggle accessibility of collection nesting.184	///185	/// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'186	/// @param collections Addresses of collections that will be available for nesting.187	/// @dev EVM selector for this function is: 0x64872396,188	///  or in textual repr: setCollectionNesting(bool,address[])189	function setCollectionNesting(bool enable, address[] memory collections) external;190191	/// Returns nesting for a collection192	/// @dev EVM selector for this function is: 0x22d25bfe,193	///  or in textual repr: collectionNestingRestrictedCollectionIds()194	function collectionNestingRestrictedCollectionIds() external view returns (Tuple26 memory);195196	/// Returns permissions for a collection197	/// @dev EVM selector for this function is: 0x5b2eaf4b,198	///  or in textual repr: collectionNestingPermissions()199	function collectionNestingPermissions() external view returns (Tuple29[] memory);200201	/// Set the collection access method.202	/// @param mode Access mode203	/// 	0 for Normal204	/// 	1 for AllowList205	/// @dev EVM selector for this function is: 0x41835d4c,206	///  or in textual repr: setCollectionAccess(uint8)207	function setCollectionAccess(uint8 mode) external;208209	/// Checks that user allowed to operate with collection.210	///211	/// @param user User address to check.212	/// @dev EVM selector for this function is: 0x91b6df49,213	///  or in textual repr: allowlistedCross((address,uint256))214	function allowlistedCross(EthCrossAccount memory user) external view returns (bool);215216	// /// Add the user to the allowed list.217	// ///218	// /// @param user Address of a trusted user.219	// /// @dev EVM selector for this function is: 0x67844fe6,220	// ///  or in textual repr: addToCollectionAllowList(address)221	// function addToCollectionAllowList(address user) external;222223	/// Add user to allowed list.224	///225	/// @param user User cross account address.226	/// @dev EVM selector for this function is: 0xa0184a3a,227	///  or in textual repr: addToCollectionAllowListCross((address,uint256))228	function addToCollectionAllowListCross(EthCrossAccount memory user) external;229230	// /// Remove the user from the allowed list.231	// ///232	// /// @param user Address of a removed user.233	// /// @dev EVM selector for this function is: 0x85c51acb,234	// ///  or in textual repr: removeFromCollectionAllowList(address)235	// function removeFromCollectionAllowList(address user) external;236237	/// Remove user from allowed list.238	///239	/// @param user User cross account address.240	/// @dev EVM selector for this function is: 0x09ba452a,241	///  or in textual repr: removeFromCollectionAllowListCross((address,uint256))242	function removeFromCollectionAllowListCross(EthCrossAccount memory user) external;243244	/// Switch permission for minting.245	///246	/// @param mode Enable if "true".247	/// @dev EVM selector for this function is: 0x00018e84,248	///  or in textual repr: setCollectionMintMode(bool)249	function setCollectionMintMode(bool mode) external;250251	// /// Check that account is the owner or admin of the collection252	// ///253	// /// @param user account to verify254	// /// @return "true" if account is the owner or admin255	// /// @dev EVM selector for this function is: 0x9811b0c7,256	// ///  or in textual repr: isOwnerOrAdmin(address)257	// function isOwnerOrAdmin(address user) external view returns (bool);258259	/// Check that account is the owner or admin of the collection260	///261	/// @param user User cross account to verify262	/// @return "true" if account is the owner or admin263	/// @dev EVM selector for this function is: 0x3e75a905,264	///  or in textual repr: isOwnerOrAdminCross((address,uint256))265	function isOwnerOrAdminCross(EthCrossAccount memory user) external view returns (bool);266267	/// Returns collection type268	///269	/// @return `Fungible` or `NFT` or `ReFungible`270	/// @dev EVM selector for this function is: 0xd34b55b8,271	///  or in textual repr: uniqueCollectionType()272	function uniqueCollectionType() external view returns (string memory);273274	/// Get collection owner.275	///276	/// @return Tuble with sponsor address and his substrate mirror.277	/// If address is canonical then substrate mirror is zero and vice versa.278	/// @dev EVM selector for this function is: 0xdf727d3b,279	///  or in textual repr: collectionOwner()280	function collectionOwner() external view returns (EthCrossAccount memory);281282	// /// Changes collection owner to another account283	// ///284	// /// @dev Owner can be changed only by current owner285	// /// @param newOwner new owner account286	// /// @dev EVM selector for this function is: 0x4f53e226,287	// ///  or in textual repr: changeCollectionOwner(address)288	// function changeCollectionOwner(address newOwner) external;289290	/// Get collection administrators291	///292	/// @return Vector of tuples with admins address and his substrate mirror.293	/// If address is canonical then substrate mirror is zero and vice versa.294	/// @dev EVM selector for this function is: 0x5813216b,295	///  or in textual repr: collectionAdmins()296	function collectionAdmins() external view returns (EthCrossAccount[] memory);297298	/// Changes collection owner to another account299	///300	/// @dev Owner can be changed only by current owner301	/// @param newOwner new owner cross account302	/// @dev EVM selector for this function is: 0x6496c497,303	///  or in textual repr: changeCollectionOwnerCross((address,uint256))304	function changeCollectionOwnerCross(EthCrossAccount memory newOwner) external;305}306307/// @dev Cross account struct308struct EthCrossAccount {309	address eth;310	uint256 sub;311}312313/// @dev anonymous struct314struct Tuple29 {315	CollectionPermissions field_0;316	bool field_1;317}318319/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.320enum CollectionPermissions {321	/// @dev Owner of token can nest tokens under it.322	TokenOwner,323	/// @dev Admin of token collection can nest tokens under token.324	CollectionAdmin325}326327/// @dev anonymous struct328struct Tuple26 {329	bool field_0;330	uint256[] field_1;331}332333/// @dev [`CollectionLimits`](up_data_structs::CollectionLimits) representation for EVM.334enum CollectionLimits {335	/// @dev How many tokens can a user have on one account.336	AccountTokenOwnership,337	/// @dev How many bytes of data are available for sponsorship.338	SponsoredDataSize,339	/// @dev In any case, chain default: [`SponsoringRateLimit::SponsoringDisabled`]340	SponsoredDataRateLimit,341	/// @dev How many tokens can be mined into this collection.342	TokenLimit,343	/// @dev Timeouts for transfer sponsoring.344	SponsorTransferTimeout,345	/// @dev Timeout for sponsoring an approval in passed blocks.346	SponsorApproveTimeout,347	/// @dev Whether the collection owner of the collection can send tokens (which belong to other users).348	OwnerCanTransfer,349	/// @dev Can the collection owner burn other people's tokens.350	OwnerCanDestroy,351	/// @dev Is it possible to send tokens from this collection between users.352	TransferEnabled353}354355/// @dev anonymous struct356struct Tuple21 {357	CollectionLimits field_0;358	bool field_1;359	uint256 field_2;360}361362/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).363struct Property {364	/// @dev Property key.365	string key;366	/// @dev Property value.367	bytes value;368}369370/// @dev the ERC-165 identifier for this interface is 0x7dee5997371interface ERC20UniqueExtensions is Dummy, ERC165 {372	/// @notice A description for the collection.373	/// @dev EVM selector for this function is: 0x7284e416,374	///  or in textual repr: description()375	function description() external view returns (string memory);376377	/// @dev EVM selector for this function is: 0x269e6158,378	///  or in textual repr: mintCross((address,uint256),uint256)379	function mintCross(EthCrossAccount memory to, uint256 amount) external returns (bool);380381	/// @dev EVM selector for this function is: 0x0ecd0ab0,382	///  or in textual repr: approveCross((address,uint256),uint256)383	function approveCross(EthCrossAccount memory spender, uint256 amount) external returns (bool);384385	// /// Burn tokens from account386	// /// @dev Function that burns an `amount` of the tokens of a given account,387	// /// deducting from the sender's allowance for said account.388	// /// @param from The account whose tokens will be burnt.389	// /// @param amount The amount that will be burnt.390	// /// @dev EVM selector for this function is: 0x79cc6790,391	// ///  or in textual repr: burnFrom(address,uint256)392	// function burnFrom(address from, uint256 amount) external returns (bool);393394	/// Burn tokens from account395	/// @dev Function that burns an `amount` of the tokens of a given account,396	/// deducting from the sender's allowance for said account.397	/// @param from The account whose tokens will be burnt.398	/// @param amount The amount that will be burnt.399	/// @dev EVM selector for this function is: 0xbb2f5a58,400	///  or in textual repr: burnFromCross((address,uint256),uint256)401	function burnFromCross(EthCrossAccount memory from, uint256 amount) external returns (bool);402403	/// Mint tokens for multiple accounts.404	/// @param amounts array of pairs of account address and amount405	/// @dev EVM selector for this function is: 0x1acf2d55,406	///  or in textual repr: mintBulk((address,uint256)[])407	function mintBulk(Tuple9[] memory amounts) external returns (bool);408409	/// @dev EVM selector for this function is: 0x2ada85ff,410	///  or in textual repr: transferCross((address,uint256),uint256)411	function transferCross(EthCrossAccount memory to, uint256 amount) external returns (bool);412413	/// @dev EVM selector for this function is: 0xd5cf430b,414	///  or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)415	function transferFromCross(416		EthCrossAccount memory from,417		EthCrossAccount memory to,418		uint256 amount419	) external returns (bool);420}421422/// @dev anonymous struct423struct Tuple9 {424	address field_0;425	uint256 field_1;426}427428/// @dev the ERC-165 identifier for this interface is 0x40c10f19429interface ERC20Mintable is Dummy, ERC165 {430	/// Mint tokens for `to` account.431	/// @param to account that will receive minted tokens432	/// @param amount amount of tokens to mint433	/// @dev EVM selector for this function is: 0x40c10f19,434	///  or in textual repr: mint(address,uint256)435	function mint(address to, uint256 amount) external returns (bool);436}437438/// @dev inlined interface439interface ERC20Events {440	event Transfer(address indexed from, address indexed to, uint256 value);441	event Approval(address indexed owner, address indexed spender, uint256 value);442}443444/// @dev the ERC-165 identifier for this interface is 0x8cb847c4445interface ERC20 is Dummy, ERC165, ERC20Events {446	/// @dev EVM selector for this function is: 0x06fdde03,447	///  or in textual repr: name()448	function name() external view returns (string memory);449450	/// @dev EVM selector for this function is: 0x95d89b41,451	///  or in textual repr: symbol()452	function symbol() external view returns (string memory);453454	/// @dev EVM selector for this function is: 0x18160ddd,455	///  or in textual repr: totalSupply()456	function totalSupply() external view returns (uint256);457458	/// @dev EVM selector for this function is: 0x313ce567,459	///  or in textual repr: decimals()460	function decimals() external view returns (uint8);461462	/// @dev EVM selector for this function is: 0x70a08231,463	///  or in textual repr: balanceOf(address)464	function balanceOf(address owner) external view returns (uint256);465466	/// @dev EVM selector for this function is: 0xa9059cbb,467	///  or in textual repr: transfer(address,uint256)468	function transfer(address to, uint256 amount) external returns (bool);469470	/// @dev EVM selector for this function is: 0x23b872dd,471	///  or in textual repr: transferFrom(address,address,uint256)472	function transferFrom(473		address from,474		address to,475		uint256 amount476	) external returns (bool);477478	/// @dev EVM selector for this function is: 0x095ea7b3,479	///  or in textual repr: approve(address,uint256)480	function approve(address spender, uint256 amount) external returns (bool);481482	/// @dev EVM selector for this function is: 0xdd62ed3e,483	///  or in textual repr: allowance(address,address)484	function allowance(address owner, address spender) external view returns (uint256);485486	/// @notice Returns collection helper contract address487	/// @dev EVM selector for this function is: 0x1896cce6,488	///  or in textual repr: collectionHelperAddress()489	function collectionHelperAddress() external view returns (address);490}491492interface UniqueFungible is Dummy, ERC165, ERC20, ERC20Mintable, ERC20UniqueExtensions, Collection {}
modifiedtests/src/eth/api/UniqueNFT.soldiffbeforeafterboth
--- a/tests/src/eth/api/UniqueNFT.sol
+++ b/tests/src/eth/api/UniqueNFT.sol
@@ -30,12 +30,12 @@
 	/// @param permissions Permissions for keys.
 	/// @dev EVM selector for this function is: 0xbd92983a,
 	///  or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])
-	function setTokenPropertyPermissions(Tuple53[] memory permissions) external;
+	function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) external;
 
 	/// @notice Get permissions for token properties.
 	/// @dev EVM selector for this function is: 0xf23d7790,
 	///  or in textual repr: tokenPropertyPermissions()
-	function tokenPropertyPermissions() external view returns (Tuple53[] memory);
+	function tokenPropertyPermissions() external view returns (TokenPropertyPermission[] memory);
 
 	// /// @notice Set token property value.
 	// /// @dev Throws error if `msg.sender` has no permission to edit the property.
@@ -80,12 +80,30 @@
 	function property(uint256 tokenId, string memory key) external view returns (bytes memory);
 }
 
-/// @dev Property struct
+/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).
 struct Property {
+	/// @dev Property key.
 	string key;
+	/// @dev Property value.
 	bytes value;
 }
 
+/// @dev Ethereum representation of Token Property Permissions.
+struct TokenPropertyPermission {
+	/// @dev Token property key.
+	string key;
+	/// @dev Token property permissions.
+	PropertyPermission[] permissions;
+}
+
+/// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.
+struct PropertyPermission {
+	/// @dev TokenPermission field.
+	EthTokenPermissions code;
+	/// @dev TokenPermission value.
+	bool value;
+}
+
 /// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.
 enum EthTokenPermissions {
 	/// @dev Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]
@@ -96,18 +114,6 @@
 	CollectionAdmin
 }
 
-/// @dev anonymous struct
-struct Tuple53 {
-	string field_0;
-	Tuple51[] field_1;
-}
-
-/// @dev anonymous struct
-struct Tuple51 {
-	EthTokenPermissions field_0;
-	bool field_1;
-}
-
 /// @title A contract that allows you to work with collections.
 /// @dev the ERC-165 identifier for this interface is 0x81172a75
 interface Collection is Dummy, ERC165 {
@@ -412,9 +418,12 @@
 	bool field_1;
 }
 
+/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.
 enum CollectionPermissions {
-	CollectionAdmin,
-	TokenOwner
+	/// @dev Owner of token can nest tokens under it.
+	TokenOwner,
+	/// @dev Admin of token collection can nest tokens under token.
+	CollectionAdmin
 }
 
 /// @dev anonymous struct
modifiedtests/src/eth/api/UniqueRefungible.soldiffbeforeafterboth
--- a/tests/src/eth/api/UniqueRefungible.sol
+++ b/tests/src/eth/api/UniqueRefungible.sol
@@ -30,12 +30,12 @@
 	/// @param permissions Permissions for keys.
 	/// @dev EVM selector for this function is: 0xbd92983a,
 	///  or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])
-	function setTokenPropertyPermissions(Tuple52[] memory permissions) external;
+	function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) external;
 
 	/// @notice Get permissions for token properties.
 	/// @dev EVM selector for this function is: 0xf23d7790,
 	///  or in textual repr: tokenPropertyPermissions()
-	function tokenPropertyPermissions() external view returns (Tuple52[] memory);
+	function tokenPropertyPermissions() external view returns (TokenPropertyPermission[] memory);
 
 	// /// @notice Set token property value.
 	// /// @dev Throws error if `msg.sender` has no permission to edit the property.
@@ -80,12 +80,30 @@
 	function property(uint256 tokenId, string memory key) external view returns (bytes memory);
 }
 
-/// @dev Property struct
+/// @dev Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).
 struct Property {
+	/// @dev Property key.
 	string key;
+	/// @dev Property value.
 	bytes value;
 }
 
+/// @dev Ethereum representation of Token Property Permissions.
+struct TokenPropertyPermission {
+	/// @dev Token property key.
+	string key;
+	/// @dev Token property permissions.
+	PropertyPermission[] permissions;
+}
+
+/// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.
+struct PropertyPermission {
+	/// @dev TokenPermission field.
+	EthTokenPermissions code;
+	/// @dev TokenPermission value.
+	bool value;
+}
+
 /// @dev Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.
 enum EthTokenPermissions {
 	/// @dev Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]
@@ -96,18 +114,6 @@
 	CollectionAdmin
 }
 
-/// @dev anonymous struct
-struct Tuple52 {
-	string field_0;
-	Tuple50[] field_1;
-}
-
-/// @dev anonymous struct
-struct Tuple50 {
-	EthTokenPermissions field_0;
-	bool field_1;
-}
-
 /// @title A contract that allows you to work with collections.
 /// @dev the ERC-165 identifier for this interface is 0x81172a75
 interface Collection is Dummy, ERC165 {
@@ -412,9 +418,12 @@
 	bool field_1;
 }
 
+/// @dev Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.
 enum CollectionPermissions {
-	CollectionAdmin,
-	TokenOwner
+	/// @dev Owner of token can nest tokens under it.
+	TokenOwner,
+	/// @dev Admin of token collection can nest tokens under token.
+	CollectionAdmin
 }
 
 /// @dev anonymous struct