difftreelog
feat add eth methots for bulk properties
in: master
14 files changed
pallets/common/src/erc.rsdiffbeforeafterboth--- a/pallets/common/src/erc.rs
+++ b/pallets/common/src/erc.rs
@@ -27,7 +27,7 @@
use sp_std::vec::Vec;
use up_data_structs::{
AccessMode, CollectionMode, CollectionPermissions, OwnerRestrictedSet, Property,
- SponsoringRateLimit, SponsorshipState,
+ SponsoringRateLimit, SponsorshipState, PropertyKey,
};
use alloc::format;
@@ -97,6 +97,21 @@
.map_err(dispatch_to_evm::<T>)
}
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ #[weight(<SelfWeightOf<T>>::set_collection_properties(properties.len() as u32))]
+ fn set_collection_properties(
+ &mut self,
+ caller: caller,
+ properties: Vec<(string, bytes)>,
+ ) -> Result<void> {
+ for (key, value) in properties.into_iter() {
+ self.set_collection_property(caller, key, value)?;
+ }
+ Ok(())
+ }
+
/// Delete collection property.
///
/// @param key Property key.
@@ -123,12 +138,38 @@
.try_into()
.map_err(|_| "key too large")?;
- let props = <CollectionProperties<T>>::get(self.id);
+ let props = CollectionProperties::<T>::get(self.id);
let prop = props.get(&key).ok_or("key not found")?;
Ok(bytes(prop.to_vec()))
}
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ fn collection_properties(&self, keys: Vec<string>) -> Result<Vec<(string, bytes)>> {
+ let mut keys_ = Vec::<PropertyKey>::with_capacity(keys.len());
+ for key in keys {
+ keys_.push(
+ <Vec<u8>>::from(key)
+ .try_into()
+ .map_err(|_| Error::Revert("key too large".into()))?,
+ )
+ }
+ let properties = Pallet::<T>::filter_collection_properties(self.id, Some(keys_))
+ .map_err(dispatch_to_evm::<T>)?;
+
+ let mut properties_ = Vec::<(string, bytes)>::with_capacity(properties.len());
+ for p in properties {
+ let key =
+ string::from_utf8(p.key.into()).map_err(|e| Error::Revert(format!("{}", e)))?;
+ let value = bytes(p.value.to_vec());
+ properties_.push((key, value));
+ }
+ Ok(properties_)
+ }
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
pallets/fungible/src/stubs/UniqueFungible.rawdiffbeforeafterbothbinary blob — no preview
pallets/fungible/src/stubs/UniqueFungible.soldiffbeforeafterboth--- a/pallets/fungible/src/stubs/UniqueFungible.sol
+++ b/pallets/fungible/src/stubs/UniqueFungible.sol
@@ -18,7 +18,7 @@
}
/// @title A contract that allows you to work with collections.
-/// @dev the ERC-165 identifier for this interface is 0x25d897dc
+/// @dev the ERC-165 identifier for this interface is 0x5d354410
contract Collection is Dummy, ERC165 {
/// Set collection property.
///
@@ -33,6 +33,17 @@
dummy = 0;
}
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ /// @dev EVM selector for this function is: 0x50b26b2a,
+ /// or in textual repr: setCollectionProperties((string,bytes)[])
+ function setCollectionProperties(Tuple10[] memory properties) public {
+ require(false, stub_error);
+ properties;
+ dummy = 0;
+ }
+
/// Delete collection property.
///
/// @param key Property key.
@@ -59,6 +70,19 @@
return hex"";
}
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ /// @dev EVM selector for this function is: 0x285fb8e6,
+ /// or in textual repr: collectionProperties(string[])
+ function collectionProperties(string[] memory keys) public view returns (Tuple10[] memory) {
+ require(false, stub_error);
+ keys;
+ dummy;
+ return new Tuple10[](0);
+ }
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
@@ -397,6 +421,12 @@
}
}
+/// @dev anonymous struct
+struct Tuple10 {
+ string field_0;
+ bytes field_1;
+}
+
/// @dev the ERC-165 identifier for this interface is 0x032e5926
contract ERC20UniqueExtensions is Dummy, ERC165 {
/// @dev EVM selector for this function is: 0x0ecd0ab0,
pallets/nonfungible/src/stubs/UniqueNFT.rawdiffbeforeafterbothbinary blob — no preview
pallets/nonfungible/src/stubs/UniqueNFT.soldiffbeforeafterboth--- a/pallets/nonfungible/src/stubs/UniqueNFT.sol
+++ b/pallets/nonfungible/src/stubs/UniqueNFT.sol
@@ -91,7 +91,7 @@
}
/// @title A contract that allows you to work with collections.
-/// @dev the ERC-165 identifier for this interface is 0x25d897dc
+/// @dev the ERC-165 identifier for this interface is 0x5d354410
contract Collection is Dummy, ERC165 {
/// Set collection property.
///
@@ -106,6 +106,17 @@
dummy = 0;
}
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ /// @dev EVM selector for this function is: 0x50b26b2a,
+ /// or in textual repr: setCollectionProperties((string,bytes)[])
+ function setCollectionProperties(Tuple19[] memory properties) public {
+ require(false, stub_error);
+ properties;
+ dummy = 0;
+ }
+
/// Delete collection property.
///
/// @param key Property key.
@@ -132,6 +143,19 @@
return hex"";
}
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ /// @dev EVM selector for this function is: 0x285fb8e6,
+ /// or in textual repr: collectionProperties(string[])
+ function collectionProperties(string[] memory keys) public view returns (Tuple19[] memory) {
+ require(false, stub_error);
+ keys;
+ dummy;
+ return new Tuple19[](0);
+ }
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
@@ -470,6 +494,12 @@
}
}
+/// @dev anonymous struct
+struct Tuple19 {
+ string field_0;
+ bytes field_1;
+}
+
/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension
/// @dev See https://eips.ethereum.org/EIPS/eip-721
/// @dev the ERC-165 identifier for this interface is 0x5b5e139f
pallets/refungible/src/stubs/UniqueRefungible.rawdiffbeforeafterbothbinary blob — no preview
pallets/refungible/src/stubs/UniqueRefungible.soldiffbeforeafterboth--- a/pallets/refungible/src/stubs/UniqueRefungible.sol
+++ b/pallets/refungible/src/stubs/UniqueRefungible.sol
@@ -91,7 +91,7 @@
}
/// @title A contract that allows you to work with collections.
-/// @dev the ERC-165 identifier for this interface is 0x25d897dc
+/// @dev the ERC-165 identifier for this interface is 0x5d354410
contract Collection is Dummy, ERC165 {
/// Set collection property.
///
@@ -106,6 +106,17 @@
dummy = 0;
}
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ /// @dev EVM selector for this function is: 0x50b26b2a,
+ /// or in textual repr: setCollectionProperties((string,bytes)[])
+ function setCollectionProperties(Tuple19[] memory properties) public {
+ require(false, stub_error);
+ properties;
+ dummy = 0;
+ }
+
/// Delete collection property.
///
/// @param key Property key.
@@ -132,6 +143,19 @@
return hex"";
}
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ /// @dev EVM selector for this function is: 0x285fb8e6,
+ /// or in textual repr: collectionProperties(string[])
+ function collectionProperties(string[] memory keys) public view returns (Tuple19[] memory) {
+ require(false, stub_error);
+ keys;
+ dummy;
+ return new Tuple19[](0);
+ }
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
@@ -470,6 +494,12 @@
}
}
+/// @dev anonymous struct
+struct Tuple19 {
+ string field_0;
+ bytes field_1;
+}
+
/// @dev the ERC-165 identifier for this interface is 0x5b5e139f
contract ERC721Metadata is Dummy, ERC165 {
// /// @notice A descriptive name for a collection of NFTs in this contract
tests/src/eth/api/UniqueFungible.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueFungible.sol
+++ b/tests/src/eth/api/UniqueFungible.sol
@@ -13,7 +13,7 @@
}
/// @title A contract that allows you to work with collections.
-/// @dev the ERC-165 identifier for this interface is 0x25d897dc
+/// @dev the ERC-165 identifier for this interface is 0x5d354410
interface Collection is Dummy, ERC165 {
/// Set collection property.
///
@@ -23,6 +23,13 @@
/// or in textual repr: setCollectionProperty(string,bytes)
function setCollectionProperty(string memory key, bytes memory value) external;
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ /// @dev EVM selector for this function is: 0x50b26b2a,
+ /// or in textual repr: setCollectionProperties((string,bytes)[])
+ function setCollectionProperties(Tuple10[] memory properties) external;
+
/// Delete collection property.
///
/// @param key Property key.
@@ -40,6 +47,14 @@
/// or in textual repr: collectionProperty(string)
function collectionProperty(string memory key) external view returns (bytes memory);
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ /// @dev EVM selector for this function is: 0x285fb8e6,
+ /// or in textual repr: collectionProperties(string[])
+ function collectionProperties(string[] memory keys) external view returns (Tuple10[] memory);
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
@@ -258,6 +273,12 @@
function setOwnerCross(Tuple6 memory newOwner) external;
}
+/// @dev anonymous struct
+struct Tuple10 {
+ string field_0;
+ bytes field_1;
+}
+
/// @dev the ERC-165 identifier for this interface is 0x032e5926
interface ERC20UniqueExtensions is Dummy, ERC165 {
/// @dev EVM selector for this function is: 0x0ecd0ab0,
tests/src/eth/api/UniqueNFT.soldiffbeforeafterboth1// 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 to set and delete token properties and change token property permissions.16/// @dev the ERC-165 identifier for this interface is 0x4136937717interface TokenProperties is Dummy, ERC165 {18 /// @notice Set permissions for token property.19 /// @dev Throws error if `msg.sender` is not admin or owner of the collection.20 /// @param key Property key.21 /// @param isMutable Permission to mutate property.22 /// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.23 /// @param tokenOwner Permission to mutate property by token owner if property is mutable.24 /// @dev EVM selector for this function is: 0x222d97fa,25 /// or in textual repr: setTokenPropertyPermission(string,bool,bool,bool)26 function setTokenPropertyPermission(27 string memory key,28 bool isMutable,29 bool collectionAdmin,30 bool tokenOwner31 ) external;3233 /// @notice Set token property value.34 /// @dev Throws error if `msg.sender` has no permission to edit the property.35 /// @param tokenId ID of the token.36 /// @param key Property key.37 /// @param value Property value.38 /// @dev EVM selector for this function is: 0x1752d67b,39 /// or in textual repr: setProperty(uint256,string,bytes)40 function setProperty(41 uint256 tokenId,42 string memory key,43 bytes memory value44 ) external;4546 /// @notice Delete token property value.47 /// @dev Throws error if `msg.sender` has no permission to edit the property.48 /// @param tokenId ID of the token.49 /// @param key Property key.50 /// @dev EVM selector for this function is: 0x066111d1,51 /// or in textual repr: deleteProperty(uint256,string)52 function deleteProperty(uint256 tokenId, string memory key) external;5354 /// @notice Get token property value.55 /// @dev Throws error if key not found56 /// @param tokenId ID of the token.57 /// @param key Property key.58 /// @return Property value bytes59 /// @dev EVM selector for this function is: 0x7228c327,60 /// or in textual repr: property(uint256,string)61 function property(uint256 tokenId, string memory key) external view returns (bytes memory);62}6364/// @title A contract that allows you to work with collections.65/// @dev the ERC-165 identifier for this interface is 0x25d897dc66interface Collection is Dummy, ERC165 {67 /// Set collection property.68 ///69 /// @param key Property key.70 /// @param value Propery value.71 /// @dev EVM selector for this function is: 0x2f073f66,72 /// or in textual repr: setCollectionProperty(string,bytes)73 function setCollectionProperty(string memory key, bytes memory value) external;7475 /// Delete collection property.76 ///77 /// @param key Property key.78 /// @dev EVM selector for this function is: 0x7b7debce,79 /// or in textual repr: deleteCollectionProperty(string)80 function deleteCollectionProperty(string memory key) external;8182 /// Get collection property.83 ///84 /// @dev Throws error if key not found.85 ///86 /// @param key Property key.87 /// @return bytes The property corresponding to the key.88 /// @dev EVM selector for this function is: 0xcf24fd6d,89 /// or in textual repr: collectionProperty(string)90 function collectionProperty(string memory key) external view returns (bytes memory);9192 /// Set the sponsor of the collection.93 ///94 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.95 ///96 /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.97 /// @dev EVM selector for this function is: 0x7623402e,98 /// or in textual repr: setCollectionSponsor(address)99 function setCollectionSponsor(address sponsor) external;100101 /// Set the sponsor of the collection.102 ///103 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.104 ///105 /// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.106 /// @dev EVM selector for this function is: 0x84a1d5a8,107 /// or in textual repr: setCollectionSponsorCross((address,uint256))108 function setCollectionSponsorCross(Tuple6 memory sponsor) external;109110 /// Whether there is a pending sponsor.111 /// @dev EVM selector for this function is: 0x058ac185,112 /// or in textual repr: hasCollectionPendingSponsor()113 function hasCollectionPendingSponsor() external view returns (bool);114115 /// Collection sponsorship confirmation.116 ///117 /// @dev After setting the sponsor for the collection, it must be confirmed with this function.118 /// @dev EVM selector for this function is: 0x3c50e97a,119 /// or in textual repr: confirmCollectionSponsorship()120 function confirmCollectionSponsorship() external;121122 /// Remove collection sponsor.123 /// @dev EVM selector for this function is: 0x6e0326a3,124 /// or in textual repr: removeCollectionSponsor()125 function removeCollectionSponsor() external;126127 /// Get current sponsor.128 ///129 /// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.130 /// @dev EVM selector for this function is: 0x6ec0a9f1,131 /// or in textual repr: collectionSponsor()132 function collectionSponsor() external view returns (Tuple6 memory);133134 /// Set limits for the collection.135 /// @dev Throws error if limit not found.136 /// @param limit Name of the limit. Valid names:137 /// "accountTokenOwnershipLimit",138 /// "sponsoredDataSize",139 /// "sponsoredDataRateLimit",140 /// "tokenLimit",141 /// "sponsorTransferTimeout",142 /// "sponsorApproveTimeout"143 /// @param value Value of the limit.144 /// @dev EVM selector for this function is: 0x6a3841db,145 /// or in textual repr: setCollectionLimit(string,uint32)146 function setCollectionLimit(string memory limit, uint32 value) external;147148 /// Set limits for the collection.149 /// @dev Throws error if limit not found.150 /// @param limit Name of the limit. Valid names:151 /// "ownerCanTransfer",152 /// "ownerCanDestroy",153 /// "transfersEnabled"154 /// @param value Value of the limit.155 /// @dev EVM selector for this function is: 0x993b7fba,156 /// or in textual repr: setCollectionLimit(string,bool)157 function setCollectionLimit(string memory limit, bool value) external;158159 /// Get contract address.160 /// @dev EVM selector for this function is: 0xf6b4dfb4,161 /// or in textual repr: contractAddress()162 function contractAddress() external view returns (address);163164 /// Add collection admin.165 /// @param newAdmin Cross account administrator address.166 /// @dev EVM selector for this function is: 0x859aa7d6,167 /// or in textual repr: addCollectionAdminCross((address,uint256))168 function addCollectionAdminCross(Tuple6 memory newAdmin) external;169170 /// Remove collection admin.171 /// @param admin Cross account administrator address.172 /// @dev EVM selector for this function is: 0x6c0cd173,173 /// or in textual repr: removeCollectionAdminCross((address,uint256))174 function removeCollectionAdminCross(Tuple6 memory admin) external;175176 /// Add collection admin.177 /// @param newAdmin Address of the added administrator.178 /// @dev EVM selector for this function is: 0x92e462c7,179 /// or in textual repr: addCollectionAdmin(address)180 function addCollectionAdmin(address newAdmin) external;181182 /// Remove collection admin.183 ///184 /// @param admin Address of the removed administrator.185 /// @dev EVM selector for this function is: 0xfafd7b42,186 /// or in textual repr: removeCollectionAdmin(address)187 function removeCollectionAdmin(address admin) external;188189 /// Toggle accessibility of collection nesting.190 ///191 /// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'192 /// @dev EVM selector for this function is: 0x112d4586,193 /// or in textual repr: setCollectionNesting(bool)194 function setCollectionNesting(bool enable) external;195196 /// Toggle accessibility of collection nesting.197 ///198 /// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'199 /// @param collections Addresses of collections that will be available for nesting.200 /// @dev EVM selector for this function is: 0x64872396,201 /// or in textual repr: setCollectionNesting(bool,address[])202 function setCollectionNesting(bool enable, address[] memory collections) external;203204 /// Set the collection access method.205 /// @param mode Access mode206 /// 0 for Normal207 /// 1 for AllowList208 /// @dev EVM selector for this function is: 0x41835d4c,209 /// or in textual repr: setCollectionAccess(uint8)210 function setCollectionAccess(uint8 mode) external;211212 /// Checks that user allowed to operate with collection.213 ///214 /// @param user User address to check.215 /// @dev EVM selector for this function is: 0xd63a8e11,216 /// or in textual repr: allowed(address)217 function allowed(address user) external view returns (bool);218219 /// Add the user to the allowed list.220 ///221 /// @param user Address of a trusted user.222 /// @dev EVM selector for this function is: 0x67844fe6,223 /// or in textual repr: addToCollectionAllowList(address)224 function addToCollectionAllowList(address user) external;225226 /// Add user to allowed list.227 ///228 /// @param user User cross account address.229 /// @dev EVM selector for this function is: 0xa0184a3a,230 /// or in textual repr: addToCollectionAllowListCross((address,uint256))231 function addToCollectionAllowListCross(Tuple6 memory user) external;232233 /// Remove the user from the allowed list.234 ///235 /// @param user Address of a removed user.236 /// @dev EVM selector for this function is: 0x85c51acb,237 /// or in textual repr: removeFromCollectionAllowList(address)238 function removeFromCollectionAllowList(address user) external;239240 /// Remove user from allowed list.241 ///242 /// @param user User cross account address.243 /// @dev EVM selector for this function is: 0x09ba452a,244 /// or in textual repr: removeFromCollectionAllowListCross((address,uint256))245 function removeFromCollectionAllowListCross(Tuple6 memory user) external;246247 /// Switch permission for minting.248 ///249 /// @param mode Enable if "true".250 /// @dev EVM selector for this function is: 0x00018e84,251 /// or in textual repr: setCollectionMintMode(bool)252 function setCollectionMintMode(bool mode) external;253254 /// Check that account is the owner or admin of the collection255 ///256 /// @param user account to verify257 /// @return "true" if account is the owner or admin258 /// @dev EVM selector for this function is: 0x9811b0c7,259 /// or in textual repr: isOwnerOrAdmin(address)260 function isOwnerOrAdmin(address user) external view returns (bool);261262 /// Check that account is the owner or admin of the collection263 ///264 /// @param user User cross account to verify265 /// @return "true" if account is the owner or admin266 /// @dev EVM selector for this function is: 0x3e75a905,267 /// or in textual repr: isOwnerOrAdminCross((address,uint256))268 function isOwnerOrAdminCross(Tuple6 memory user) external view returns (bool);269270 /// Returns collection type271 ///272 /// @return `Fungible` or `NFT` or `ReFungible`273 /// @dev EVM selector for this function is: 0xd34b55b8,274 /// or in textual repr: uniqueCollectionType()275 function uniqueCollectionType() external view returns (string memory);276277 /// Get collection owner.278 ///279 /// @return Tuble with sponsor address and his substrate mirror.280 /// If address is canonical then substrate mirror is zero and vice versa.281 /// @dev EVM selector for this function is: 0xdf727d3b,282 /// or in textual repr: collectionOwner()283 function collectionOwner() external view returns (Tuple6 memory);284285 /// Changes collection owner to another account286 ///287 /// @dev Owner can be changed only by current owner288 /// @param newOwner new owner account289 /// @dev EVM selector for this function is: 0x4f53e226,290 /// or in textual repr: changeCollectionOwner(address)291 function changeCollectionOwner(address newOwner) external;292293 /// Get collection administrators294 ///295 /// @return Vector of tuples with admins address and his substrate mirror.296 /// If address is canonical then substrate mirror is zero and vice versa.297 /// @dev EVM selector for this function is: 0x5813216b,298 /// or in textual repr: collectionAdmins()299 function collectionAdmins() external view returns (Tuple6[] memory);300301 /// Changes collection owner to another account302 ///303 /// @dev Owner can be changed only by current owner304 /// @param newOwner new owner cross account305 /// @dev EVM selector for this function is: 0xe5c9913f,306 /// or in textual repr: setOwnerCross((address,uint256))307 function setOwnerCross(Tuple6 memory newOwner) external;308}309310/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension311/// @dev See https://eips.ethereum.org/EIPS/eip-721312/// @dev the ERC-165 identifier for this interface is 0x5b5e139f313interface ERC721Metadata is Dummy, ERC165 {314 // /// @notice A descriptive name for a collection of NFTs in this contract315 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`316 // /// @dev EVM selector for this function is: 0x06fdde03,317 // /// or in textual repr: name()318 // function name() external view returns (string memory);319320 // /// @notice An abbreviated name for NFTs in this contract321 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`322 // /// @dev EVM selector for this function is: 0x95d89b41,323 // /// or in textual repr: symbol()324 // function symbol() external view returns (string memory);325326 /// @notice A distinct Uniform Resource Identifier (URI) for a given asset.327 ///328 /// @dev If the token has a `url` property and it is not empty, it is returned.329 /// Else If the collection does not have a property with key `schemaName` or its value is not equal to `ERC721Metadata`, it return an error `tokenURI not set`.330 /// If the collection property `baseURI` is empty or absent, return "" (empty string)331 /// otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix332 /// otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).333 ///334 /// @return token's const_metadata335 /// @dev EVM selector for this function is: 0xc87b56dd,336 /// or in textual repr: tokenURI(uint256)337 function tokenURI(uint256 tokenId) external view returns (string memory);338}339340/// @title ERC721 Token that can be irreversibly burned (destroyed).341/// @dev the ERC-165 identifier for this interface is 0x42966c68342interface ERC721Burnable is Dummy, ERC165 {343 /// @notice Burns a specific ERC721 token.344 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized345 /// operator of the current owner.346 /// @param tokenId The NFT to approve347 /// @dev EVM selector for this function is: 0x42966c68,348 /// or in textual repr: burn(uint256)349 function burn(uint256 tokenId) external;350}351352/// @dev inlined interface353interface ERC721UniqueMintableEvents {354 event MintingFinished();355}356357/// @title ERC721 minting logic.358/// @dev the ERC-165 identifier for this interface is 0x476ff149359interface ERC721UniqueMintable is Dummy, ERC165, ERC721UniqueMintableEvents {360 /// @dev EVM selector for this function is: 0x05d2035b,361 /// or in textual repr: mintingFinished()362 function mintingFinished() external view returns (bool);363364 /// @notice Function to mint token.365 /// @param to The new owner366 /// @return uint256 The id of the newly minted token367 /// @dev EVM selector for this function is: 0x6a627842,368 /// or in textual repr: mint(address)369 function mint(address to) external returns (uint256);370371 // /// @notice Function to mint token.372 // /// @dev `tokenId` should be obtained with `nextTokenId` method,373 // /// unlike standard, you can't specify it manually374 // /// @param to The new owner375 // /// @param tokenId ID of the minted NFT376 // /// @dev EVM selector for this function is: 0x40c10f19,377 // /// or in textual repr: mint(address,uint256)378 // function mint(address to, uint256 tokenId) external returns (bool);379380 /// @notice Function to mint token with the given tokenUri.381 /// @param to The new owner382 /// @param tokenUri Token URI that would be stored in the NFT properties383 /// @return uint256 The id of the newly minted token384 /// @dev EVM selector for this function is: 0x45c17782,385 /// or in textual repr: mintWithTokenURI(address,string)386 function mintWithTokenURI(address to, string memory tokenUri) external returns (uint256);387388 // /// @notice Function to mint token with the given tokenUri.389 // /// @dev `tokenId` should be obtained with `nextTokenId` method,390 // /// unlike standard, you can't specify it manually391 // /// @param to The new owner392 // /// @param tokenId ID of the minted NFT393 // /// @param tokenUri Token URI that would be stored in the NFT properties394 // /// @dev EVM selector for this function is: 0x50bb4e7f,395 // /// or in textual repr: mintWithTokenURI(address,uint256,string)396 // function mintWithTokenURI(address to, uint256 tokenId, string memory tokenUri) external returns (bool);397398 /// @dev Not implemented399 /// @dev EVM selector for this function is: 0x7d64bcb4,400 /// or in textual repr: finishMinting()401 function finishMinting() external returns (bool);402}403404/// @title Unique extensions for ERC721.405/// @dev the ERC-165 identifier for this interface is 0x244543ee406interface ERC721UniqueExtensions is Dummy, ERC165 {407 /// @notice A descriptive name for a collection of NFTs in this contract408 /// @dev EVM selector for this function is: 0x06fdde03,409 /// or in textual repr: name()410 function name() external view returns (string memory);411412 /// @notice An abbreviated name for NFTs in this contract413 /// @dev EVM selector for this function is: 0x95d89b41,414 /// or in textual repr: symbol()415 function symbol() external view returns (string memory);416417 /// @notice Set or reaffirm the approved address for an NFT418 /// @dev The zero address indicates there is no approved address.419 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized420 /// operator of the current owner.421 /// @param approved The new substrate address approved NFT controller422 /// @param tokenId The NFT to approve423 /// @dev EVM selector for this function is: 0x0ecd0ab0,424 /// or in textual repr: approveCross((address,uint256),uint256)425 function approveCross(Tuple6 memory approved, uint256 tokenId) external;426427 /// @notice Transfer ownership of an NFT428 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`429 /// is the zero address. Throws if `tokenId` is not a valid NFT.430 /// @param to The new owner431 /// @param tokenId The NFT to transfer432 /// @dev EVM selector for this function is: 0xa9059cbb,433 /// or in textual repr: transfer(address,uint256)434 function transfer(address to, uint256 tokenId) external;435436 /// @notice Transfer ownership of an NFT from cross account address to cross account address437 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`438 /// is the zero address. Throws if `tokenId` is not a valid NFT.439 /// @param from Cross acccount address of current owner440 /// @param to Cross acccount address of new owner441 /// @param tokenId The NFT to transfer442 /// @dev EVM selector for this function is: 0xd5cf430b,443 /// or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)444 function transferFromCross(445 Tuple6 memory from,446 Tuple6 memory to,447 uint256 tokenId448 ) external;449450 /// @notice Burns a specific ERC721 token.451 /// @dev Throws unless `msg.sender` is the current owner or an authorized452 /// operator for this NFT. Throws if `from` is not the current owner. Throws453 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.454 /// @param from The current owner of the NFT455 /// @param tokenId The NFT to transfer456 /// @dev EVM selector for this function is: 0x79cc6790,457 /// or in textual repr: burnFrom(address,uint256)458 function burnFrom(address from, uint256 tokenId) external;459460 /// @notice Burns a specific ERC721 token.461 /// @dev Throws unless `msg.sender` is the current owner or an authorized462 /// operator for this NFT. Throws if `from` is not the current owner. Throws463 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.464 /// @param from The current owner of the NFT465 /// @param tokenId The NFT to transfer466 /// @dev EVM selector for this function is: 0xbb2f5a58,467 /// or in textual repr: burnFromCross((address,uint256),uint256)468 function burnFromCross(Tuple6 memory from, uint256 tokenId) external;469470 /// @notice Returns next free NFT ID.471 /// @dev EVM selector for this function is: 0x75794a3c,472 /// or in textual repr: nextTokenId()473 function nextTokenId() external view returns (uint256);474 // /// @notice Function to mint multiple tokens.475 // /// @dev `tokenIds` should be an array of consecutive numbers and first number476 // /// should be obtained with `nextTokenId` method477 // /// @param to The new owner478 // /// @param tokenIds IDs of the minted NFTs479 // /// @dev EVM selector for this function is: 0x44a9945e,480 // /// or in textual repr: mintBulk(address,uint256[])481 // function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);482483 // /// @notice Function to mint multiple tokens with the given tokenUris.484 // /// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive485 // /// numbers and first number should be obtained with `nextTokenId` method486 // /// @param to The new owner487 // /// @param tokens array of pairs of token ID and token URI for minted tokens488 // /// @dev EVM selector for this function is: 0x36543006,489 // /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])490 // function mintBulkWithTokenURI(address to, Tuple8[] memory tokens) external returns (bool);491492}493494/// @dev anonymous struct495struct Tuple8 {496 uint256 field_0;497 string field_1;498}499500/// @dev anonymous struct501struct Tuple6 {502 address field_0;503 uint256 field_1;504}505506/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension507/// @dev See https://eips.ethereum.org/EIPS/eip-721508/// @dev the ERC-165 identifier for this interface is 0x780e9d63509interface ERC721Enumerable is Dummy, ERC165 {510 /// @notice Enumerate valid NFTs511 /// @param index A counter less than `totalSupply()`512 /// @return The token identifier for the `index`th NFT,513 /// (sort order not specified)514 /// @dev EVM selector for this function is: 0x4f6ccce7,515 /// or in textual repr: tokenByIndex(uint256)516 function tokenByIndex(uint256 index) external view returns (uint256);517518 /// @dev Not implemented519 /// @dev EVM selector for this function is: 0x2f745c59,520 /// or in textual repr: tokenOfOwnerByIndex(address,uint256)521 function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);522523 /// @notice Count NFTs tracked by this contract524 /// @return A count of valid NFTs tracked by this contract, where each one of525 /// them has an assigned and queryable owner not equal to the zero address526 /// @dev EVM selector for this function is: 0x18160ddd,527 /// or in textual repr: totalSupply()528 function totalSupply() external view returns (uint256);529}530531/// @dev inlined interface532interface ERC721Events {533 event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);534 event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);535 event ApprovalForAll(address indexed owner, address indexed operator, bool approved);536}537538/// @title ERC-721 Non-Fungible Token Standard539/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md540/// @dev the ERC-165 identifier for this interface is 0x80ac58cd541interface ERC721 is Dummy, ERC165, ERC721Events {542 /// @notice Count all NFTs assigned to an owner543 /// @dev NFTs assigned to the zero address are considered invalid, and this544 /// function throws for queries about the zero address.545 /// @param owner An address for whom to query the balance546 /// @return The number of NFTs owned by `owner`, possibly zero547 /// @dev EVM selector for this function is: 0x70a08231,548 /// or in textual repr: balanceOf(address)549 function balanceOf(address owner) external view returns (uint256);550551 /// @notice Find the owner of an NFT552 /// @dev NFTs assigned to zero address are considered invalid, and queries553 /// about them do throw.554 /// @param tokenId The identifier for an NFT555 /// @return The address of the owner of the NFT556 /// @dev EVM selector for this function is: 0x6352211e,557 /// or in textual repr: ownerOf(uint256)558 function ownerOf(uint256 tokenId) external view returns (address);559560 /// @dev Not implemented561 /// @dev EVM selector for this function is: 0xb88d4fde,562 /// or in textual repr: safeTransferFrom(address,address,uint256,bytes)563 function safeTransferFrom(564 address from,565 address to,566 uint256 tokenId,567 bytes memory data568 ) external;569570 /// @dev Not implemented571 /// @dev EVM selector for this function is: 0x42842e0e,572 /// or in textual repr: safeTransferFrom(address,address,uint256)573 function safeTransferFrom(574 address from,575 address to,576 uint256 tokenId577 ) external;578579 /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE580 /// TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE581 /// THEY MAY BE PERMANENTLY LOST582 /// @dev Throws unless `msg.sender` is the current owner or an authorized583 /// operator for this NFT. Throws if `from` is not the current owner. Throws584 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.585 /// @param from The current owner of the NFT586 /// @param to The new owner587 /// @param tokenId The NFT to transfer588 /// @dev EVM selector for this function is: 0x23b872dd,589 /// or in textual repr: transferFrom(address,address,uint256)590 function transferFrom(591 address from,592 address to,593 uint256 tokenId594 ) external;595596 /// @notice Set or reaffirm the approved address for an NFT597 /// @dev The zero address indicates there is no approved address.598 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized599 /// operator of the current owner.600 /// @param approved The new approved NFT controller601 /// @param tokenId The NFT to approve602 /// @dev EVM selector for this function is: 0x095ea7b3,603 /// or in textual repr: approve(address,uint256)604 function approve(address approved, uint256 tokenId) external;605606 /// @dev Not implemented607 /// @dev EVM selector for this function is: 0xa22cb465,608 /// or in textual repr: setApprovalForAll(address,bool)609 function setApprovalForAll(address operator, bool approved) external;610611 /// @dev Not implemented612 /// @dev EVM selector for this function is: 0x081812fc,613 /// or in textual repr: getApproved(uint256)614 function getApproved(uint256 tokenId) external view returns (address);615616 /// @dev Not implemented617 /// @dev EVM selector for this function is: 0xe985e9c5,618 /// or in textual repr: isApprovedForAll(address,address)619 function isApprovedForAll(address owner, address operator) external view returns (address);620}621622interface UniqueNFT is623 Dummy,624 ERC165,625 ERC721,626 ERC721Enumerable,627 ERC721UniqueExtensions,628 ERC721UniqueMintable,629 ERC721Burnable,630 ERC721Metadata,631 Collection,632 TokenProperties633{}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 to set and delete token properties and change token property permissions.16/// @dev the ERC-165 identifier for this interface is 0x4136937717interface TokenProperties is Dummy, ERC165 {18 /// @notice Set permissions for token property.19 /// @dev Throws error if `msg.sender` is not admin or owner of the collection.20 /// @param key Property key.21 /// @param isMutable Permission to mutate property.22 /// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.23 /// @param tokenOwner Permission to mutate property by token owner if property is mutable.24 /// @dev EVM selector for this function is: 0x222d97fa,25 /// or in textual repr: setTokenPropertyPermission(string,bool,bool,bool)26 function setTokenPropertyPermission(27 string memory key,28 bool isMutable,29 bool collectionAdmin,30 bool tokenOwner31 ) external;3233 /// @notice Set token property value.34 /// @dev Throws error if `msg.sender` has no permission to edit the property.35 /// @param tokenId ID of the token.36 /// @param key Property key.37 /// @param value Property value.38 /// @dev EVM selector for this function is: 0x1752d67b,39 /// or in textual repr: setProperty(uint256,string,bytes)40 function setProperty(41 uint256 tokenId,42 string memory key,43 bytes memory value44 ) external;4546 /// @notice Delete token property value.47 /// @dev Throws error if `msg.sender` has no permission to edit the property.48 /// @param tokenId ID of the token.49 /// @param key Property key.50 /// @dev EVM selector for this function is: 0x066111d1,51 /// or in textual repr: deleteProperty(uint256,string)52 function deleteProperty(uint256 tokenId, string memory key) external;5354 /// @notice Get token property value.55 /// @dev Throws error if key not found56 /// @param tokenId ID of the token.57 /// @param key Property key.58 /// @return Property value bytes59 /// @dev EVM selector for this function is: 0x7228c327,60 /// or in textual repr: property(uint256,string)61 function property(uint256 tokenId, string memory key) external view returns (bytes memory);62}6364/// @title A contract that allows you to work with collections.65/// @dev the ERC-165 identifier for this interface is 0x5d35441066interface Collection is Dummy, ERC165 {67 /// Set collection property.68 ///69 /// @param key Property key.70 /// @param value Propery value.71 /// @dev EVM selector for this function is: 0x2f073f66,72 /// or in textual repr: setCollectionProperty(string,bytes)73 function setCollectionProperty(string memory key, bytes memory value) external;7475 /// Set collection properties.76 ///77 /// @param properties Vector of properties key/value pair.78 /// @dev EVM selector for this function is: 0x50b26b2a,79 /// or in textual repr: setCollectionProperties((string,bytes)[])80 function setCollectionProperties(Tuple19[] memory properties) external;8182 /// Delete collection property.83 ///84 /// @param key Property key.85 /// @dev EVM selector for this function is: 0x7b7debce,86 /// or in textual repr: deleteCollectionProperty(string)87 function deleteCollectionProperty(string memory key) external;8889 /// Get collection property.90 ///91 /// @dev Throws error if key not found.92 ///93 /// @param key Property key.94 /// @return bytes The property corresponding to the key.95 /// @dev EVM selector for this function is: 0xcf24fd6d,96 /// or in textual repr: collectionProperty(string)97 function collectionProperty(string memory key) external view returns (bytes memory);9899 /// Get collection properties.100 ///101 /// @param keys Properties keys.102 /// @return Vector of properties key/value pairs.103 /// @dev EVM selector for this function is: 0x285fb8e6,104 /// or in textual repr: collectionProperties(string[])105 function collectionProperties(string[] memory keys) external view returns (Tuple19[] memory);106107 /// Set the sponsor of the collection.108 ///109 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.110 ///111 /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.112 /// @dev EVM selector for this function is: 0x7623402e,113 /// or in textual repr: setCollectionSponsor(address)114 function setCollectionSponsor(address sponsor) external;115116 /// Set the sponsor of the collection.117 ///118 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.119 ///120 /// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.121 /// @dev EVM selector for this function is: 0x84a1d5a8,122 /// or in textual repr: setCollectionSponsorCross((address,uint256))123 function setCollectionSponsorCross(Tuple6 memory sponsor) external;124125 /// Whether there is a pending sponsor.126 /// @dev EVM selector for this function is: 0x058ac185,127 /// or in textual repr: hasCollectionPendingSponsor()128 function hasCollectionPendingSponsor() external view returns (bool);129130 /// Collection sponsorship confirmation.131 ///132 /// @dev After setting the sponsor for the collection, it must be confirmed with this function.133 /// @dev EVM selector for this function is: 0x3c50e97a,134 /// or in textual repr: confirmCollectionSponsorship()135 function confirmCollectionSponsorship() external;136137 /// Remove collection sponsor.138 /// @dev EVM selector for this function is: 0x6e0326a3,139 /// or in textual repr: removeCollectionSponsor()140 function removeCollectionSponsor() external;141142 /// Get current sponsor.143 ///144 /// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.145 /// @dev EVM selector for this function is: 0x6ec0a9f1,146 /// or in textual repr: collectionSponsor()147 function collectionSponsor() external view returns (Tuple6 memory);148149 /// Set limits for the collection.150 /// @dev Throws error if limit not found.151 /// @param limit Name of the limit. Valid names:152 /// "accountTokenOwnershipLimit",153 /// "sponsoredDataSize",154 /// "sponsoredDataRateLimit",155 /// "tokenLimit",156 /// "sponsorTransferTimeout",157 /// "sponsorApproveTimeout"158 /// @param value Value of the limit.159 /// @dev EVM selector for this function is: 0x6a3841db,160 /// or in textual repr: setCollectionLimit(string,uint32)161 function setCollectionLimit(string memory limit, uint32 value) external;162163 /// Set limits for the collection.164 /// @dev Throws error if limit not found.165 /// @param limit Name of the limit. Valid names:166 /// "ownerCanTransfer",167 /// "ownerCanDestroy",168 /// "transfersEnabled"169 /// @param value Value of the limit.170 /// @dev EVM selector for this function is: 0x993b7fba,171 /// or in textual repr: setCollectionLimit(string,bool)172 function setCollectionLimit(string memory limit, bool value) external;173174 /// Get contract address.175 /// @dev EVM selector for this function is: 0xf6b4dfb4,176 /// or in textual repr: contractAddress()177 function contractAddress() external view returns (address);178179 /// Add collection admin.180 /// @param newAdmin Cross account administrator address.181 /// @dev EVM selector for this function is: 0x859aa7d6,182 /// or in textual repr: addCollectionAdminCross((address,uint256))183 function addCollectionAdminCross(Tuple6 memory newAdmin) external;184185 /// Remove collection admin.186 /// @param admin Cross account administrator address.187 /// @dev EVM selector for this function is: 0x6c0cd173,188 /// or in textual repr: removeCollectionAdminCross((address,uint256))189 function removeCollectionAdminCross(Tuple6 memory admin) external;190191 /// Add collection admin.192 /// @param newAdmin Address of the added administrator.193 /// @dev EVM selector for this function is: 0x92e462c7,194 /// or in textual repr: addCollectionAdmin(address)195 function addCollectionAdmin(address newAdmin) external;196197 /// Remove collection admin.198 ///199 /// @param admin Address of the removed administrator.200 /// @dev EVM selector for this function is: 0xfafd7b42,201 /// or in textual repr: removeCollectionAdmin(address)202 function removeCollectionAdmin(address admin) external;203204 /// Toggle accessibility of collection nesting.205 ///206 /// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'207 /// @dev EVM selector for this function is: 0x112d4586,208 /// or in textual repr: setCollectionNesting(bool)209 function setCollectionNesting(bool enable) external;210211 /// Toggle accessibility of collection nesting.212 ///213 /// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'214 /// @param collections Addresses of collections that will be available for nesting.215 /// @dev EVM selector for this function is: 0x64872396,216 /// or in textual repr: setCollectionNesting(bool,address[])217 function setCollectionNesting(bool enable, address[] memory collections) external;218219 /// Set the collection access method.220 /// @param mode Access mode221 /// 0 for Normal222 /// 1 for AllowList223 /// @dev EVM selector for this function is: 0x41835d4c,224 /// or in textual repr: setCollectionAccess(uint8)225 function setCollectionAccess(uint8 mode) external;226227 /// Checks that user allowed to operate with collection.228 ///229 /// @param user User address to check.230 /// @dev EVM selector for this function is: 0xd63a8e11,231 /// or in textual repr: allowed(address)232 function allowed(address user) external view returns (bool);233234 /// Add the user to the allowed list.235 ///236 /// @param user Address of a trusted user.237 /// @dev EVM selector for this function is: 0x67844fe6,238 /// or in textual repr: addToCollectionAllowList(address)239 function addToCollectionAllowList(address user) external;240241 /// Add user to allowed list.242 ///243 /// @param user User cross account address.244 /// @dev EVM selector for this function is: 0xa0184a3a,245 /// or in textual repr: addToCollectionAllowListCross((address,uint256))246 function addToCollectionAllowListCross(Tuple6 memory user) external;247248 /// Remove the user from the allowed list.249 ///250 /// @param user Address of a removed user.251 /// @dev EVM selector for this function is: 0x85c51acb,252 /// or in textual repr: removeFromCollectionAllowList(address)253 function removeFromCollectionAllowList(address user) external;254255 /// Remove user from allowed list.256 ///257 /// @param user User cross account address.258 /// @dev EVM selector for this function is: 0x09ba452a,259 /// or in textual repr: removeFromCollectionAllowListCross((address,uint256))260 function removeFromCollectionAllowListCross(Tuple6 memory user) external;261262 /// Switch permission for minting.263 ///264 /// @param mode Enable if "true".265 /// @dev EVM selector for this function is: 0x00018e84,266 /// or in textual repr: setCollectionMintMode(bool)267 function setCollectionMintMode(bool mode) external;268269 /// Check that account is the owner or admin of the collection270 ///271 /// @param user account to verify272 /// @return "true" if account is the owner or admin273 /// @dev EVM selector for this function is: 0x9811b0c7,274 /// or in textual repr: isOwnerOrAdmin(address)275 function isOwnerOrAdmin(address user) external view returns (bool);276277 /// Check that account is the owner or admin of the collection278 ///279 /// @param user User cross account to verify280 /// @return "true" if account is the owner or admin281 /// @dev EVM selector for this function is: 0x3e75a905,282 /// or in textual repr: isOwnerOrAdminCross((address,uint256))283 function isOwnerOrAdminCross(Tuple6 memory user) external view returns (bool);284285 /// Returns collection type286 ///287 /// @return `Fungible` or `NFT` or `ReFungible`288 /// @dev EVM selector for this function is: 0xd34b55b8,289 /// or in textual repr: uniqueCollectionType()290 function uniqueCollectionType() external view returns (string memory);291292 /// Get collection owner.293 ///294 /// @return Tuble with sponsor address and his substrate mirror.295 /// If address is canonical then substrate mirror is zero and vice versa.296 /// @dev EVM selector for this function is: 0xdf727d3b,297 /// or in textual repr: collectionOwner()298 function collectionOwner() external view returns (Tuple6 memory);299300 /// Changes collection owner to another account301 ///302 /// @dev Owner can be changed only by current owner303 /// @param newOwner new owner account304 /// @dev EVM selector for this function is: 0x4f53e226,305 /// or in textual repr: changeCollectionOwner(address)306 function changeCollectionOwner(address newOwner) external;307308 /// Get collection administrators309 ///310 /// @return Vector of tuples with admins address and his substrate mirror.311 /// If address is canonical then substrate mirror is zero and vice versa.312 /// @dev EVM selector for this function is: 0x5813216b,313 /// or in textual repr: collectionAdmins()314 function collectionAdmins() external view returns (Tuple6[] memory);315316 /// Changes collection owner to another account317 ///318 /// @dev Owner can be changed only by current owner319 /// @param newOwner new owner cross account320 /// @dev EVM selector for this function is: 0xe5c9913f,321 /// or in textual repr: setOwnerCross((address,uint256))322 function setOwnerCross(Tuple6 memory newOwner) external;323}324325/// @dev anonymous struct326struct Tuple19 {327 string field_0;328 bytes field_1;329}330331/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension332/// @dev See https://eips.ethereum.org/EIPS/eip-721333/// @dev the ERC-165 identifier for this interface is 0x5b5e139f334interface ERC721Metadata is Dummy, ERC165 {335 // /// @notice A descriptive name for a collection of NFTs in this contract336 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`337 // /// @dev EVM selector for this function is: 0x06fdde03,338 // /// or in textual repr: name()339 // function name() external view returns (string memory);340341 // /// @notice An abbreviated name for NFTs in this contract342 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`343 // /// @dev EVM selector for this function is: 0x95d89b41,344 // /// or in textual repr: symbol()345 // function symbol() external view returns (string memory);346347 /// @notice A distinct Uniform Resource Identifier (URI) for a given asset.348 ///349 /// @dev If the token has a `url` property and it is not empty, it is returned.350 /// Else If the collection does not have a property with key `schemaName` or its value is not equal to `ERC721Metadata`, it return an error `tokenURI not set`.351 /// If the collection property `baseURI` is empty or absent, return "" (empty string)352 /// otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix353 /// otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).354 ///355 /// @return token's const_metadata356 /// @dev EVM selector for this function is: 0xc87b56dd,357 /// or in textual repr: tokenURI(uint256)358 function tokenURI(uint256 tokenId) external view returns (string memory);359}360361/// @title ERC721 Token that can be irreversibly burned (destroyed).362/// @dev the ERC-165 identifier for this interface is 0x42966c68363interface ERC721Burnable is Dummy, ERC165 {364 /// @notice Burns a specific ERC721 token.365 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized366 /// operator of the current owner.367 /// @param tokenId The NFT to approve368 /// @dev EVM selector for this function is: 0x42966c68,369 /// or in textual repr: burn(uint256)370 function burn(uint256 tokenId) external;371}372373/// @dev inlined interface374interface ERC721UniqueMintableEvents {375 event MintingFinished();376}377378/// @title ERC721 minting logic.379/// @dev the ERC-165 identifier for this interface is 0x476ff149380interface ERC721UniqueMintable is Dummy, ERC165, ERC721UniqueMintableEvents {381 /// @dev EVM selector for this function is: 0x05d2035b,382 /// or in textual repr: mintingFinished()383 function mintingFinished() external view returns (bool);384385 /// @notice Function to mint token.386 /// @param to The new owner387 /// @return uint256 The id of the newly minted token388 /// @dev EVM selector for this function is: 0x6a627842,389 /// or in textual repr: mint(address)390 function mint(address to) external returns (uint256);391392 // /// @notice Function to mint token.393 // /// @dev `tokenId` should be obtained with `nextTokenId` method,394 // /// unlike standard, you can't specify it manually395 // /// @param to The new owner396 // /// @param tokenId ID of the minted NFT397 // /// @dev EVM selector for this function is: 0x40c10f19,398 // /// or in textual repr: mint(address,uint256)399 // function mint(address to, uint256 tokenId) external returns (bool);400401 /// @notice Function to mint token with the given tokenUri.402 /// @param to The new owner403 /// @param tokenUri Token URI that would be stored in the NFT properties404 /// @return uint256 The id of the newly minted token405 /// @dev EVM selector for this function is: 0x45c17782,406 /// or in textual repr: mintWithTokenURI(address,string)407 function mintWithTokenURI(address to, string memory tokenUri) external returns (uint256);408409 // /// @notice Function to mint token with the given tokenUri.410 // /// @dev `tokenId` should be obtained with `nextTokenId` method,411 // /// unlike standard, you can't specify it manually412 // /// @param to The new owner413 // /// @param tokenId ID of the minted NFT414 // /// @param tokenUri Token URI that would be stored in the NFT properties415 // /// @dev EVM selector for this function is: 0x50bb4e7f,416 // /// or in textual repr: mintWithTokenURI(address,uint256,string)417 // function mintWithTokenURI(address to, uint256 tokenId, string memory tokenUri) external returns (bool);418419 /// @dev Not implemented420 /// @dev EVM selector for this function is: 0x7d64bcb4,421 /// or in textual repr: finishMinting()422 function finishMinting() external returns (bool);423}424425/// @title Unique extensions for ERC721.426/// @dev the ERC-165 identifier for this interface is 0x244543ee427interface ERC721UniqueExtensions is Dummy, ERC165 {428 /// @notice A descriptive name for a collection of NFTs in this contract429 /// @dev EVM selector for this function is: 0x06fdde03,430 /// or in textual repr: name()431 function name() external view returns (string memory);432433 /// @notice An abbreviated name for NFTs in this contract434 /// @dev EVM selector for this function is: 0x95d89b41,435 /// or in textual repr: symbol()436 function symbol() external view returns (string memory);437438 /// @notice Set or reaffirm the approved address for an NFT439 /// @dev The zero address indicates there is no approved address.440 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized441 /// operator of the current owner.442 /// @param approved The new substrate address approved NFT controller443 /// @param tokenId The NFT to approve444 /// @dev EVM selector for this function is: 0x0ecd0ab0,445 /// or in textual repr: approveCross((address,uint256),uint256)446 function approveCross(Tuple6 memory approved, uint256 tokenId) external;447448 /// @notice Transfer ownership of an NFT449 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`450 /// is the zero address. Throws if `tokenId` is not a valid NFT.451 /// @param to The new owner452 /// @param tokenId The NFT to transfer453 /// @dev EVM selector for this function is: 0xa9059cbb,454 /// or in textual repr: transfer(address,uint256)455 function transfer(address to, uint256 tokenId) external;456457 /// @notice Transfer ownership of an NFT from cross account address to cross account address458 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`459 /// is the zero address. Throws if `tokenId` is not a valid NFT.460 /// @param from Cross acccount address of current owner461 /// @param to Cross acccount address of new owner462 /// @param tokenId The NFT to transfer463 /// @dev EVM selector for this function is: 0xd5cf430b,464 /// or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)465 function transferFromCross(466 Tuple6 memory from,467 Tuple6 memory to,468 uint256 tokenId469 ) external;470471 /// @notice Burns a specific ERC721 token.472 /// @dev Throws unless `msg.sender` is the current owner or an authorized473 /// operator for this NFT. Throws if `from` is not the current owner. Throws474 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.475 /// @param from The current owner of the NFT476 /// @param tokenId The NFT to transfer477 /// @dev EVM selector for this function is: 0x79cc6790,478 /// or in textual repr: burnFrom(address,uint256)479 function burnFrom(address from, uint256 tokenId) external;480481 /// @notice Burns a specific ERC721 token.482 /// @dev Throws unless `msg.sender` is the current owner or an authorized483 /// operator for this NFT. Throws if `from` is not the current owner. Throws484 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.485 /// @param from The current owner of the NFT486 /// @param tokenId The NFT to transfer487 /// @dev EVM selector for this function is: 0xbb2f5a58,488 /// or in textual repr: burnFromCross((address,uint256),uint256)489 function burnFromCross(Tuple6 memory from, uint256 tokenId) external;490491 /// @notice Returns next free NFT ID.492 /// @dev EVM selector for this function is: 0x75794a3c,493 /// or in textual repr: nextTokenId()494 function nextTokenId() external view returns (uint256);495 // /// @notice Function to mint multiple tokens.496 // /// @dev `tokenIds` should be an array of consecutive numbers and first number497 // /// should be obtained with `nextTokenId` method498 // /// @param to The new owner499 // /// @param tokenIds IDs of the minted NFTs500 // /// @dev EVM selector for this function is: 0x44a9945e,501 // /// or in textual repr: mintBulk(address,uint256[])502 // function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);503504 // /// @notice Function to mint multiple tokens with the given tokenUris.505 // /// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive506 // /// numbers and first number should be obtained with `nextTokenId` method507 // /// @param to The new owner508 // /// @param tokens array of pairs of token ID and token URI for minted tokens509 // /// @dev EVM selector for this function is: 0x36543006,510 // /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])511 // function mintBulkWithTokenURI(address to, Tuple8[] memory tokens) external returns (bool);512513}514515/// @dev anonymous struct516struct Tuple8 {517 uint256 field_0;518 string field_1;519}520521/// @dev anonymous struct522struct Tuple6 {523 address field_0;524 uint256 field_1;525}526527/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension528/// @dev See https://eips.ethereum.org/EIPS/eip-721529/// @dev the ERC-165 identifier for this interface is 0x780e9d63530interface ERC721Enumerable is Dummy, ERC165 {531 /// @notice Enumerate valid NFTs532 /// @param index A counter less than `totalSupply()`533 /// @return The token identifier for the `index`th NFT,534 /// (sort order not specified)535 /// @dev EVM selector for this function is: 0x4f6ccce7,536 /// or in textual repr: tokenByIndex(uint256)537 function tokenByIndex(uint256 index) external view returns (uint256);538539 /// @dev Not implemented540 /// @dev EVM selector for this function is: 0x2f745c59,541 /// or in textual repr: tokenOfOwnerByIndex(address,uint256)542 function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);543544 /// @notice Count NFTs tracked by this contract545 /// @return A count of valid NFTs tracked by this contract, where each one of546 /// them has an assigned and queryable owner not equal to the zero address547 /// @dev EVM selector for this function is: 0x18160ddd,548 /// or in textual repr: totalSupply()549 function totalSupply() external view returns (uint256);550}551552/// @dev inlined interface553interface ERC721Events {554 event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);555 event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);556 event ApprovalForAll(address indexed owner, address indexed operator, bool approved);557}558559/// @title ERC-721 Non-Fungible Token Standard560/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md561/// @dev the ERC-165 identifier for this interface is 0x80ac58cd562interface ERC721 is Dummy, ERC165, ERC721Events {563 /// @notice Count all NFTs assigned to an owner564 /// @dev NFTs assigned to the zero address are considered invalid, and this565 /// function throws for queries about the zero address.566 /// @param owner An address for whom to query the balance567 /// @return The number of NFTs owned by `owner`, possibly zero568 /// @dev EVM selector for this function is: 0x70a08231,569 /// or in textual repr: balanceOf(address)570 function balanceOf(address owner) external view returns (uint256);571572 /// @notice Find the owner of an NFT573 /// @dev NFTs assigned to zero address are considered invalid, and queries574 /// about them do throw.575 /// @param tokenId The identifier for an NFT576 /// @return The address of the owner of the NFT577 /// @dev EVM selector for this function is: 0x6352211e,578 /// or in textual repr: ownerOf(uint256)579 function ownerOf(uint256 tokenId) external view returns (address);580581 /// @dev Not implemented582 /// @dev EVM selector for this function is: 0xb88d4fde,583 /// or in textual repr: safeTransferFrom(address,address,uint256,bytes)584 function safeTransferFrom(585 address from,586 address to,587 uint256 tokenId,588 bytes memory data589 ) external;590591 /// @dev Not implemented592 /// @dev EVM selector for this function is: 0x42842e0e,593 /// or in textual repr: safeTransferFrom(address,address,uint256)594 function safeTransferFrom(595 address from,596 address to,597 uint256 tokenId598 ) external;599600 /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE601 /// TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE602 /// THEY MAY BE PERMANENTLY LOST603 /// @dev Throws unless `msg.sender` is the current owner or an authorized604 /// operator for this NFT. Throws if `from` is not the current owner. Throws605 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.606 /// @param from The current owner of the NFT607 /// @param to The new owner608 /// @param tokenId The NFT to transfer609 /// @dev EVM selector for this function is: 0x23b872dd,610 /// or in textual repr: transferFrom(address,address,uint256)611 function transferFrom(612 address from,613 address to,614 uint256 tokenId615 ) external;616617 /// @notice Set or reaffirm the approved address for an NFT618 /// @dev The zero address indicates there is no approved address.619 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized620 /// operator of the current owner.621 /// @param approved The new approved NFT controller622 /// @param tokenId The NFT to approve623 /// @dev EVM selector for this function is: 0x095ea7b3,624 /// or in textual repr: approve(address,uint256)625 function approve(address approved, uint256 tokenId) external;626627 /// @dev Not implemented628 /// @dev EVM selector for this function is: 0xa22cb465,629 /// or in textual repr: setApprovalForAll(address,bool)630 function setApprovalForAll(address operator, bool approved) external;631632 /// @dev Not implemented633 /// @dev EVM selector for this function is: 0x081812fc,634 /// or in textual repr: getApproved(uint256)635 function getApproved(uint256 tokenId) external view returns (address);636637 /// @dev Not implemented638 /// @dev EVM selector for this function is: 0xe985e9c5,639 /// or in textual repr: isApprovedForAll(address,address)640 function isApprovedForAll(address owner, address operator) external view returns (address);641}642643interface UniqueNFT is644 Dummy,645 ERC165,646 ERC721,647 ERC721Enumerable,648 ERC721UniqueExtensions,649 ERC721UniqueMintable,650 ERC721Burnable,651 ERC721Metadata,652 Collection,653 TokenProperties654{}tests/src/eth/api/UniqueRefungible.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueRefungible.sol
+++ b/tests/src/eth/api/UniqueRefungible.sol
@@ -62,7 +62,7 @@
}
/// @title A contract that allows you to work with collections.
-/// @dev the ERC-165 identifier for this interface is 0x25d897dc
+/// @dev the ERC-165 identifier for this interface is 0x5d354410
interface Collection is Dummy, ERC165 {
/// Set collection property.
///
@@ -72,6 +72,13 @@
/// or in textual repr: setCollectionProperty(string,bytes)
function setCollectionProperty(string memory key, bytes memory value) external;
+ /// Set collection properties.
+ ///
+ /// @param properties Vector of properties key/value pair.
+ /// @dev EVM selector for this function is: 0x50b26b2a,
+ /// or in textual repr: setCollectionProperties((string,bytes)[])
+ function setCollectionProperties(Tuple19[] memory properties) external;
+
/// Delete collection property.
///
/// @param key Property key.
@@ -89,6 +96,14 @@
/// or in textual repr: collectionProperty(string)
function collectionProperty(string memory key) external view returns (bytes memory);
+ /// Get collection properties.
+ ///
+ /// @param keys Properties keys.
+ /// @return Vector of properties key/value pairs.
+ /// @dev EVM selector for this function is: 0x285fb8e6,
+ /// or in textual repr: collectionProperties(string[])
+ function collectionProperties(string[] memory keys) external view returns (Tuple19[] memory);
+
/// Set the sponsor of the collection.
///
/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.
@@ -307,6 +322,12 @@
function setOwnerCross(Tuple6 memory newOwner) external;
}
+/// @dev anonymous struct
+struct Tuple19 {
+ string field_0;
+ bytes field_1;
+}
+
/// @dev the ERC-165 identifier for this interface is 0x5b5e139f
interface ERC721Metadata is Dummy, ERC165 {
// /// @notice A descriptive name for a collection of NFTs in this contract
tests/src/eth/collectionProperties.test.tsdiffbeforeafterboth--- a/tests/src/eth/collectionProperties.test.ts
+++ b/tests/src/eth/collectionProperties.test.ts
@@ -161,3 +161,31 @@
await checkERC721Metadata(helper, 'rft');
});
});
+
+describe('EVM collection property', () => {
+ itEth('Set/read properties', async ({helper, privateKey}) => {
+ const alice = await privateKey('//Alice');
+ const collection = await helper.nft.mintCollection(alice, {name: 'A', description: 'B', tokenPrefix: 'C'});
+
+ const sender = await helper.eth.createAccountWithBalance(alice, 100n);
+ await collection.addAdmin(alice, {Ethereum: sender});
+
+ const collectionAddress = helper.ethAddress.fromCollectionId(collection.collectionId);
+ const contract = helper.ethNativeContract.collection(collectionAddress, 'nft', sender);
+
+ const key1 = 'key1';
+ const value1 = Buffer.from('value1');
+
+ const key2 = 'key2';
+ const value2 = Buffer.from('value2');
+
+ const writeProperties = [
+ [key1, '0x'+value1.toString('hex')],
+ [key2, '0x'+value2.toString('hex')],
+ ];
+
+ await contract.methods.setCollectionProperties(writeProperties).send();
+ const readProperties = await contract.methods.collectionProperties([key1, key2]).call();
+ expect(readProperties).to.be.like(writeProperties);
+ });
+});
tests/src/eth/fungibleAbi.jsondiffbeforeafterboth--- a/tests/src/eth/fungibleAbi.json
+++ b/tests/src/eth/fungibleAbi.json
@@ -229,6 +229,25 @@
"type": "function"
},
{
+ "inputs": [
+ { "internalType": "string[]", "name": "keys", "type": "string[]" }
+ ],
+ "name": "collectionProperties",
+ "outputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple10[]",
+ "name": "",
+ "type": "tuple[]"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
+ {
"inputs": [{ "internalType": "string", "name": "key", "type": "string" }],
"name": "collectionProperty",
"outputs": [{ "internalType": "bytes", "name": "", "type": "bytes" }],
@@ -463,6 +482,23 @@
},
{
"inputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple10[]",
+ "name": "properties",
+ "type": "tuple[]"
+ }
+ ],
+ "name": "setCollectionProperties",
+ "outputs": [],
+ "stateMutability": "nonpayable",
+ "type": "function"
+ },
+ {
+ "inputs": [
{ "internalType": "string", "name": "key", "type": "string" },
{ "internalType": "bytes", "name": "value", "type": "bytes" }
],
tests/src/eth/nonFungibleAbi.jsondiffbeforeafterboth--- a/tests/src/eth/nonFungibleAbi.json
+++ b/tests/src/eth/nonFungibleAbi.json
@@ -259,6 +259,25 @@
"type": "function"
},
{
+ "inputs": [
+ { "internalType": "string[]", "name": "keys", "type": "string[]" }
+ ],
+ "name": "collectionProperties",
+ "outputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple19[]",
+ "name": "",
+ "type": "tuple[]"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
+ {
"inputs": [{ "internalType": "string", "name": "key", "type": "string" }],
"name": "collectionProperty",
"outputs": [{ "internalType": "bytes", "name": "", "type": "bytes" }],
@@ -578,6 +597,23 @@
},
{
"inputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple19[]",
+ "name": "properties",
+ "type": "tuple[]"
+ }
+ ],
+ "name": "setCollectionProperties",
+ "outputs": [],
+ "stateMutability": "nonpayable",
+ "type": "function"
+ },
+ {
+ "inputs": [
{ "internalType": "string", "name": "key", "type": "string" },
{ "internalType": "bytes", "name": "value", "type": "bytes" }
],
tests/src/eth/reFungibleAbi.jsondiffbeforeafterboth--- a/tests/src/eth/reFungibleAbi.json
+++ b/tests/src/eth/reFungibleAbi.json
@@ -241,6 +241,25 @@
"type": "function"
},
{
+ "inputs": [
+ { "internalType": "string[]", "name": "keys", "type": "string[]" }
+ ],
+ "name": "collectionProperties",
+ "outputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple19[]",
+ "name": "",
+ "type": "tuple[]"
+ }
+ ],
+ "stateMutability": "view",
+ "type": "function"
+ },
+ {
"inputs": [{ "internalType": "string", "name": "key", "type": "string" }],
"name": "collectionProperty",
"outputs": [{ "internalType": "bytes", "name": "", "type": "bytes" }],
@@ -560,6 +579,23 @@
},
{
"inputs": [
+ {
+ "components": [
+ { "internalType": "string", "name": "field_0", "type": "string" },
+ { "internalType": "bytes", "name": "field_1", "type": "bytes" }
+ ],
+ "internalType": "struct Tuple19[]",
+ "name": "properties",
+ "type": "tuple[]"
+ }
+ ],
+ "name": "setCollectionProperties",
+ "outputs": [],
+ "stateMutability": "nonpayable",
+ "type": "function"
+ },
+ {
+ "inputs": [
{ "internalType": "string", "name": "key", "type": "string" },
{ "internalType": "bytes", "name": "value", "type": "bytes" }
],