git.delta.rocks / unique-network / refs/commits / 8ad09da9d2af

difftreelog

fix(nft) name/symbol should be always callable

Yaroslav Bolyukin2022-10-13parent: #f8b7b18.patch.diff
in: master

4 files changed

modifiedpallets/nonfungible/src/erc.rsdiffbeforeafterboth
--- a/pallets/nonfungible/src/erc.rs
+++ b/pallets/nonfungible/src/erc.rs
@@ -203,15 +203,17 @@
 #[solidity_interface(name = ERC721Metadata, expect_selector = 0x5b5e139f)]
 impl<T: Config> NonfungibleHandle<T> {
 	/// @notice A descriptive name for a collection of NFTs in this contract
-	fn name(&self) -> Result<string> {
-		Ok(decode_utf16(self.name.iter().copied())
-			.map(|r| r.unwrap_or(REPLACEMENT_CHARACTER))
-			.collect::<string>())
+	/// @dev real implementation of this function lies in `ERC721UniqueExtensions`
+	#[solidity(hide, rename_selector = "name")]
+	fn name_proxy(&self) -> Result<string> {
+		self.name()
 	}
 
 	/// @notice An abbreviated name for NFTs in this contract
-	fn symbol(&self) -> Result<string> {
-		Ok(string::from_utf8_lossy(&self.token_prefix).into())
+	/// @dev real implementation of this function lies in `ERC721UniqueExtensions`
+	#[solidity(hide, rename_selector = "symbol")]
+	fn symbol_proxy(&self) -> Result<string> {
+		self.symbol()
 	}
 
 	/// @notice A distinct Uniform Resource Identifier (URI) for a given asset.
@@ -571,6 +573,18 @@
 /// @title Unique extensions for ERC721.
 #[solidity_interface(name = ERC721UniqueExtensions)]
 impl<T: Config> NonfungibleHandle<T> {
+	/// @notice A descriptive name for a collection of NFTs in this contract
+	fn name(&self) -> Result<string> {
+		Ok(decode_utf16(self.name.iter().copied())
+			.map(|r| r.unwrap_or(REPLACEMENT_CHARACTER))
+			.collect::<string>())
+	}
+
+	/// @notice An abbreviated name for NFTs in this contract
+	fn symbol(&self) -> Result<string> {
+		Ok(string::from_utf8_lossy(&self.token_prefix).into())
+	}
+
 	/// @notice Transfer ownership of an NFT
 	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`
 	///  is the zero address. Throws if `tokenId` is not a valid NFT.
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
@@ -21,23 +21,25 @@
 /// @dev See https://eips.ethereum.org/EIPS/eip-721
 /// @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
-	/// @dev EVM selector for this function is: 0x06fdde03,
-	///  or in textual repr: name()
-	function name() public view returns (string memory) {
-		require(false, stub_error);
-		dummy;
-		return "";
-	}
+	// /// @notice A descriptive name for a collection of NFTs in this contract
+	// /// @dev real implementation of this function lies in `ERC721UniqueExtensions`
+	// /// @dev EVM selector for this function is: 0x06fdde03,
+	// ///  or in textual repr: name()
+	// function name() public view returns (string memory) {
+	// 	require(false, stub_error);
+	// 	dummy;
+	// 	return "";
+	// }
 
-	/// @notice An abbreviated name for NFTs in this contract
-	/// @dev EVM selector for this function is: 0x95d89b41,
-	///  or in textual repr: symbol()
-	function symbol() public view returns (string memory) {
-		require(false, stub_error);
-		dummy;
-		return "";
-	}
+	// /// @notice An abbreviated name for NFTs in this contract
+	// /// @dev real implementation of this function lies in `ERC721UniqueExtensions`
+	// /// @dev EVM selector for this function is: 0x95d89b41,
+	// ///  or in textual repr: symbol()
+	// function symbol() public view returns (string memory) {
+	// 	require(false, stub_error);
+	// 	dummy;
+	// 	return "";
+	// }
 
 	/// @notice A distinct Uniform Resource Identifier (URI) for a given asset.
 	///
@@ -504,8 +506,26 @@
 }
 
 /// @title Unique extensions for ERC721.
-/// @dev the ERC-165 identifier for this interface is 0xd74d154f
+/// @dev the ERC-165 identifier for this interface is 0x4468500d
 contract ERC721UniqueExtensions is Dummy, ERC165 {
+	/// @notice A descriptive name for a collection of NFTs in this contract
+	/// @dev EVM selector for this function is: 0x06fdde03,
+	///  or in textual repr: name()
+	function name() public view returns (string memory) {
+		require(false, stub_error);
+		dummy;
+		return "";
+	}
+
+	/// @notice An abbreviated name for NFTs in this contract
+	/// @dev EVM selector for this function is: 0x95d89b41,
+	///  or in textual repr: symbol()
+	function symbol() public view returns (string memory) {
+		require(false, stub_error);
+		dummy;
+		return "";
+	}
+
 	/// @notice Transfer ownership of an NFT
 	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`
 	///  is the zero address. Throws if `tokenId` is not a valid NFT.
modifiedtests/src/eth/api/UniqueNFT.soldiffbeforeafterboth
before · tests/src/eth/api/UniqueNFT.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 ERC-721 Non-Fungible Token Standard, optional metadata extension16/// @dev See https://eips.ethereum.org/EIPS/eip-72117/// @dev the ERC-165 identifier for this interface is 0x5b5e139f18interface ERC721Metadata is Dummy, ERC165 {19	/// @notice A descriptive name for a collection of NFTs in this contract20	/// @dev EVM selector for this function is: 0x06fdde03,21	///  or in textual repr: name()22	function name() external view returns (string memory);2324	/// @notice An abbreviated name for NFTs in this contract25	/// @dev EVM selector for this function is: 0x95d89b41,26	///  or in textual repr: symbol()27	function symbol() external view returns (string memory);2829	/// @notice A distinct Uniform Resource Identifier (URI) for a given asset.30	///31	/// @dev If the token has a `url` property and it is not empty, it is returned.32	///  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`.33	///  If the collection property `baseURI` is empty or absent, return "" (empty string)34	///  otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix35	///  otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).36	///37	/// @return token's const_metadata38	/// @dev EVM selector for this function is: 0xc87b56dd,39	///  or in textual repr: tokenURI(uint256)40	function tokenURI(uint256 tokenId) external view returns (string memory);41}4243/// @title A contract that allows to set and delete token properties and change token property permissions.44/// @dev the ERC-165 identifier for this interface is 0x4136937745interface TokenProperties is Dummy, ERC165 {46	/// @notice Set permissions for token property.47	/// @dev Throws error if `msg.sender` is not admin or owner of the collection.48	/// @param key Property key.49	/// @param isMutable Permission to mutate property.50	/// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.51	/// @param tokenOwner Permission to mutate property by token owner if property is mutable.52	/// @dev EVM selector for this function is: 0x222d97fa,53	///  or in textual repr: setTokenPropertyPermission(string,bool,bool,bool)54	function setTokenPropertyPermission(55		string memory key,56		bool isMutable,57		bool collectionAdmin,58		bool tokenOwner59	) external;6061	/// @notice Set token property value.62	/// @dev Throws error if `msg.sender` has no permission to edit the property.63	/// @param tokenId ID of the token.64	/// @param key Property key.65	/// @param value Property value.66	/// @dev EVM selector for this function is: 0x1752d67b,67	///  or in textual repr: setProperty(uint256,string,bytes)68	function setProperty(69		uint256 tokenId,70		string memory key,71		bytes memory value72	) external;7374	/// @notice Delete token property value.75	/// @dev Throws error if `msg.sender` has no permission to edit the property.76	/// @param tokenId ID of the token.77	/// @param key Property key.78	/// @dev EVM selector for this function is: 0x066111d1,79	///  or in textual repr: deleteProperty(uint256,string)80	function deleteProperty(uint256 tokenId, string memory key) external;8182	/// @notice Get token property value.83	/// @dev Throws error if key not found84	/// @param tokenId ID of the token.85	/// @param key Property key.86	/// @return Property value bytes87	/// @dev EVM selector for this function is: 0x7228c327,88	///  or in textual repr: property(uint256,string)89	function property(uint256 tokenId, string memory key) external view returns (bytes memory);90}9192/// @title A contract that allows you to work with collections.93/// @dev the ERC-165 identifier for this interface is 0x3e1e808394interface Collection is Dummy, ERC165 {95	/// Set collection property.96	///97	/// @param key Property key.98	/// @param value Propery value.99	/// @dev EVM selector for this function is: 0x2f073f66,100	///  or in textual repr: setCollectionProperty(string,bytes)101	function setCollectionProperty(string memory key, bytes memory value) external;102103	/// Delete collection property.104	///105	/// @param key Property key.106	/// @dev EVM selector for this function is: 0x7b7debce,107	///  or in textual repr: deleteCollectionProperty(string)108	function deleteCollectionProperty(string memory key) external;109110	/// Get collection property.111	///112	/// @dev Throws error if key not found.113	///114	/// @param key Property key.115	/// @return bytes The property corresponding to the key.116	/// @dev EVM selector for this function is: 0xcf24fd6d,117	///  or in textual repr: collectionProperty(string)118	function collectionProperty(string memory key) external view returns (bytes memory);119120	/// Set the sponsor of the collection.121	///122	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.123	///124	/// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.125	/// @dev EVM selector for this function is: 0x7623402e,126	///  or in textual repr: setCollectionSponsor(address)127	function setCollectionSponsor(address sponsor) external;128129	/// Whether there is a pending sponsor.130	/// @dev EVM selector for this function is: 0x058ac185,131	///  or in textual repr: hasCollectionPendingSponsor()132	function hasCollectionPendingSponsor() external view returns (bool);133134	/// Collection sponsorship confirmation.135	///136	/// @dev After setting the sponsor for the collection, it must be confirmed with this function.137	/// @dev EVM selector for this function is: 0x3c50e97a,138	///  or in textual repr: confirmCollectionSponsorship()139	function confirmCollectionSponsorship() external;140141	/// Remove collection sponsor.142	/// @dev EVM selector for this function is: 0x6e0326a3,143	///  or in textual repr: removeCollectionSponsor()144	function removeCollectionSponsor() external;145146	/// Get current sponsor.147	///148	/// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.149	/// @dev EVM selector for this function is: 0x6ec0a9f1,150	///  or in textual repr: collectionSponsor()151	function collectionSponsor() external view returns (Tuple15 memory);152153	/// Set limits for the collection.154	/// @dev Throws error if limit not found.155	/// @param limit Name of the limit. Valid names:156	/// 	"accountTokenOwnershipLimit",157	/// 	"sponsoredDataSize",158	/// 	"sponsoredDataRateLimit",159	/// 	"tokenLimit",160	/// 	"sponsorTransferTimeout",161	/// 	"sponsorApproveTimeout"162	/// @param value Value of the limit.163	/// @dev EVM selector for this function is: 0x6a3841db,164	///  or in textual repr: setCollectionLimit(string,uint32)165	function setCollectionLimit(string memory limit, uint32 value) external;166167	/// Set limits for the collection.168	/// @dev Throws error if limit not found.169	/// @param limit Name of the limit. Valid names:170	/// 	"ownerCanTransfer",171	/// 	"ownerCanDestroy",172	/// 	"transfersEnabled"173	/// @param value Value of the limit.174	/// @dev EVM selector for this function is: 0x993b7fba,175	///  or in textual repr: setCollectionLimit(string,bool)176	function setCollectionLimit(string memory limit, bool value) external;177178	/// Get contract address.179	/// @dev EVM selector for this function is: 0xf6b4dfb4,180	///  or in textual repr: contractAddress()181	function contractAddress() external view returns (address);182183	/// Add collection admin.184	/// @param newAdmin Address of the added administrator.185	/// @dev EVM selector for this function is: 0x92e462c7,186	///  or in textual repr: addCollectionAdmin(address)187	function addCollectionAdmin(address newAdmin) external;188189	/// Remove collection admin.190	///191	/// @param admin Address of the removed administrator.192	/// @dev EVM selector for this function is: 0xfafd7b42,193	///  or in textual repr: removeCollectionAdmin(address)194	function removeCollectionAdmin(address admin) external;195196	/// Toggle accessibility of collection nesting.197	///198	/// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'199	/// @dev EVM selector for this function is: 0x112d4586,200	///  or in textual repr: setCollectionNesting(bool)201	function setCollectionNesting(bool enable) external;202203	/// Toggle accessibility of collection nesting.204	///205	/// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'206	/// @param collections Addresses of collections that will be available for nesting.207	/// @dev EVM selector for this function is: 0x64872396,208	///  or in textual repr: setCollectionNesting(bool,address[])209	function setCollectionNesting(bool enable, address[] memory collections) external;210211	/// Set the collection access method.212	/// @param mode Access mode213	/// 	0 for Normal214	/// 	1 for AllowList215	/// @dev EVM selector for this function is: 0x41835d4c,216	///  or in textual repr: setCollectionAccess(uint8)217	function setCollectionAccess(uint8 mode) external;218219	/// Checks that user allowed to operate with collection.220	///221	/// @param user User address to check.222	/// @dev EVM selector for this function is: 0xd63a8e11,223	///  or in textual repr: allowed(address)224	function allowed(address user) external view returns (bool);225226	/// Add the user to the allowed list.227	///228	/// @param user Address of a trusted user.229	/// @dev EVM selector for this function is: 0x67844fe6,230	///  or in textual repr: addToCollectionAllowList(address)231	function addToCollectionAllowList(address 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	/// Switch permission for minting.241	///242	/// @param mode Enable if "true".243	/// @dev EVM selector for this function is: 0x00018e84,244	///  or in textual repr: setCollectionMintMode(bool)245	function setCollectionMintMode(bool mode) external;246247	/// Check that account is the owner or admin of the collection248	///249	/// @param user account to verify250	/// @return "true" if account is the owner or admin251	/// @dev EVM selector for this function is: 0x9811b0c7,252	///  or in textual repr: isOwnerOrAdmin(address)253	function isOwnerOrAdmin(address user) external view returns (bool);254255	/// Returns collection type256	///257	/// @return `Fungible` or `NFT` or `ReFungible`258	/// @dev EVM selector for this function is: 0xd34b55b8,259	///  or in textual repr: uniqueCollectionType()260	function uniqueCollectionType() external view returns (string memory);261262	/// Get collection owner.263	///264	/// @return Tuble with sponsor address and his substrate mirror.265	/// If address is canonical then substrate mirror is zero and vice versa.266	/// @dev EVM selector for this function is: 0xdf727d3b,267	///  or in textual repr: collectionOwner()268	function collectionOwner() external view returns (Tuple15 memory);269270	/// Changes collection owner to another account271	///272	/// @dev Owner can be changed only by current owner273	/// @param newOwner new owner account274	/// @dev EVM selector for this function is: 0x13af4035,275	///  or in textual repr: setOwner(address)276	function setOwner(address newOwner) external;277}278279/// @dev anonymous struct280struct Tuple15 {281	address field_0;282	uint256 field_1;283}284285/// @title ERC721 Token that can be irreversibly burned (destroyed).286/// @dev the ERC-165 identifier for this interface is 0x42966c68287interface ERC721Burnable is Dummy, ERC165 {288	/// @notice Burns a specific ERC721 token.289	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized290	///  operator of the current owner.291	/// @param tokenId The NFT to approve292	/// @dev EVM selector for this function is: 0x42966c68,293	///  or in textual repr: burn(uint256)294	function burn(uint256 tokenId) external;295}296297/// @dev inlined interface298interface ERC721MintableEvents {299	event MintingFinished();300}301302/// @title ERC721 minting logic.303/// @dev the ERC-165 identifier for this interface is 0x68ccfe89304interface ERC721Mintable is Dummy, ERC165, ERC721MintableEvents {305	/// @dev EVM selector for this function is: 0x05d2035b,306	///  or in textual repr: mintingFinished()307	function mintingFinished() external view returns (bool);308309	/// @notice Function to mint token.310	/// @dev `tokenId` should be obtained with `nextTokenId` method,311	///  unlike standard, you can't specify it manually312	/// @param to The new owner313	/// @param tokenId ID of the minted NFT314	/// @dev EVM selector for this function is: 0x40c10f19,315	///  or in textual repr: mint(address,uint256)316	function mint(address to, uint256 tokenId) external returns (bool);317318	/// @notice Function to mint token with the given tokenUri.319	/// @dev `tokenId` should be obtained with `nextTokenId` method,320	///  unlike standard, you can't specify it manually321	/// @param to The new owner322	/// @param tokenId ID of the minted NFT323	/// @param tokenUri Token URI that would be stored in the NFT properties324	/// @dev EVM selector for this function is: 0x50bb4e7f,325	///  or in textual repr: mintWithTokenURI(address,uint256,string)326	function mintWithTokenURI(327		address to,328		uint256 tokenId,329		string memory tokenUri330	) external returns (bool);331332	/// @dev Not implemented333	/// @dev EVM selector for this function is: 0x7d64bcb4,334	///  or in textual repr: finishMinting()335	function finishMinting() external returns (bool);336}337338/// @title Unique extensions for ERC721.339/// @dev the ERC-165 identifier for this interface is 0xd74d154f340interface ERC721UniqueExtensions is Dummy, ERC165 {341	/// @notice Transfer ownership of an NFT342	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`343	///  is the zero address. Throws if `tokenId` is not a valid NFT.344	/// @param to The new owner345	/// @param tokenId The NFT to transfer346	/// @dev EVM selector for this function is: 0xa9059cbb,347	///  or in textual repr: transfer(address,uint256)348	function transfer(address to, uint256 tokenId) external;349350	/// @notice Burns a specific ERC721 token.351	/// @dev Throws unless `msg.sender` is the current owner or an authorized352	///  operator for this NFT. Throws if `from` is not the current owner. Throws353	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.354	/// @param from The current owner of the NFT355	/// @param tokenId The NFT to transfer356	/// @dev EVM selector for this function is: 0x79cc6790,357	///  or in textual repr: burnFrom(address,uint256)358	function burnFrom(address from, uint256 tokenId) external;359360	/// @notice Returns next free NFT ID.361	/// @dev EVM selector for this function is: 0x75794a3c,362	///  or in textual repr: nextTokenId()363	function nextTokenId() external view returns (uint256);364365	/// @notice Function to mint multiple tokens.366	/// @dev `tokenIds` should be an array of consecutive numbers and first number367	///  should be obtained with `nextTokenId` method368	/// @param to The new owner369	/// @param tokenIds IDs of the minted NFTs370	/// @dev EVM selector for this function is: 0x44a9945e,371	///  or in textual repr: mintBulk(address,uint256[])372	function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);373374	/// @notice Function to mint multiple tokens with the given tokenUris.375	/// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive376	///  numbers and first number should be obtained with `nextTokenId` method377	/// @param to The new owner378	/// @param tokens array of pairs of token ID and token URI for minted tokens379	/// @dev EVM selector for this function is: 0x36543006,380	///  or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])381	function mintBulkWithTokenURI(address to, Tuple6[] memory tokens) external returns (bool);382}383384/// @dev anonymous struct385struct Tuple6 {386	uint256 field_0;387	string field_1;388}389390/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension391/// @dev See https://eips.ethereum.org/EIPS/eip-721392/// @dev the ERC-165 identifier for this interface is 0x780e9d63393interface ERC721Enumerable is Dummy, ERC165 {394	/// @notice Enumerate valid NFTs395	/// @param index A counter less than `totalSupply()`396	/// @return The token identifier for the `index`th NFT,397	///  (sort order not specified)398	/// @dev EVM selector for this function is: 0x4f6ccce7,399	///  or in textual repr: tokenByIndex(uint256)400	function tokenByIndex(uint256 index) external view returns (uint256);401402	/// @dev Not implemented403	/// @dev EVM selector for this function is: 0x2f745c59,404	///  or in textual repr: tokenOfOwnerByIndex(address,uint256)405	function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);406407	/// @notice Count NFTs tracked by this contract408	/// @return A count of valid NFTs tracked by this contract, where each one of409	///  them has an assigned and queryable owner not equal to the zero address410	/// @dev EVM selector for this function is: 0x18160ddd,411	///  or in textual repr: totalSupply()412	function totalSupply() external view returns (uint256);413}414415/// @dev inlined interface416interface ERC721Events {417	event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);418	event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);419	event ApprovalForAll(address indexed owner, address indexed operator, bool approved);420}421422/// @title ERC-721 Non-Fungible Token Standard423/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md424/// @dev the ERC-165 identifier for this interface is 0x80ac58cd425interface ERC721 is Dummy, ERC165, ERC721Events {426	/// @notice Count all NFTs assigned to an owner427	/// @dev NFTs assigned to the zero address are considered invalid, and this428	///  function throws for queries about the zero address.429	/// @param owner An address for whom to query the balance430	/// @return The number of NFTs owned by `owner`, possibly zero431	/// @dev EVM selector for this function is: 0x70a08231,432	///  or in textual repr: balanceOf(address)433	function balanceOf(address owner) external view returns (uint256);434435	/// @notice Find the owner of an NFT436	/// @dev NFTs assigned to zero address are considered invalid, and queries437	///  about them do throw.438	/// @param tokenId The identifier for an NFT439	/// @return The address of the owner of the NFT440	/// @dev EVM selector for this function is: 0x6352211e,441	///  or in textual repr: ownerOf(uint256)442	function ownerOf(uint256 tokenId) external view returns (address);443444	/// @dev Not implemented445	/// @dev EVM selector for this function is: 0xb88d4fde,446	///  or in textual repr: safeTransferFrom(address,address,uint256,bytes)447	function safeTransferFrom(448		address from,449		address to,450		uint256 tokenId,451		bytes memory data452	) external;453454	/// @dev Not implemented455	/// @dev EVM selector for this function is: 0x42842e0e,456	///  or in textual repr: safeTransferFrom(address,address,uint256)457	function safeTransferFrom(458		address from,459		address to,460		uint256 tokenId461	) external;462463	/// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE464	///  TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE465	///  THEY MAY BE PERMANENTLY LOST466	/// @dev Throws unless `msg.sender` is the current owner or an authorized467	///  operator for this NFT. Throws if `from` is not the current owner. Throws468	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.469	/// @param from The current owner of the NFT470	/// @param to The new owner471	/// @param tokenId The NFT to transfer472	/// @dev EVM selector for this function is: 0x23b872dd,473	///  or in textual repr: transferFrom(address,address,uint256)474	function transferFrom(475		address from,476		address to,477		uint256 tokenId478	) external;479480	/// @notice Set or reaffirm the approved address for an NFT481	/// @dev The zero address indicates there is no approved address.482	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized483	///  operator of the current owner.484	/// @param approved The new approved NFT controller485	/// @param tokenId The NFT to approve486	/// @dev EVM selector for this function is: 0x095ea7b3,487	///  or in textual repr: approve(address,uint256)488	function approve(address approved, uint256 tokenId) external;489490	/// @dev Not implemented491	/// @dev EVM selector for this function is: 0xa22cb465,492	///  or in textual repr: setApprovalForAll(address,bool)493	function setApprovalForAll(address operator, bool approved) external;494495	/// @dev Not implemented496	/// @dev EVM selector for this function is: 0x081812fc,497	///  or in textual repr: getApproved(uint256)498	function getApproved(uint256 tokenId) external view returns (address);499500	/// @dev Not implemented501	/// @dev EVM selector for this function is: 0xe985e9c5,502	///  or in textual repr: isApprovedForAll(address,address)503	function isApprovedForAll(address owner, address operator) external view returns (address);504}505506interface UniqueNFT is507	Dummy,508	ERC165,509	ERC721,510	ERC721Enumerable,511	ERC721UniqueExtensions,512	ERC721Mintable,513	ERC721Burnable,514	Collection,515	TokenProperties,516	ERC721Metadata517{}
after · tests/src/eth/api/UniqueNFT.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 ERC-721 Non-Fungible Token Standard, optional metadata extension16/// @dev See https://eips.ethereum.org/EIPS/eip-72117/// @dev the ERC-165 identifier for this interface is 0x5b5e139f18interface ERC721Metadata is Dummy, ERC165 {19	// /// @notice A descriptive name for a collection of NFTs in this contract20	// /// @dev real implementation of this function lies in `ERC721UniqueExtensions`21	// /// @dev EVM selector for this function is: 0x06fdde03,22	// ///  or in textual repr: name()23	// function name() external view returns (string memory);2425	// /// @notice An abbreviated name for NFTs in this contract26	// /// @dev real implementation of this function lies in `ERC721UniqueExtensions`27	// /// @dev EVM selector for this function is: 0x95d89b41,28	// ///  or in textual repr: symbol()29	// function symbol() external view returns (string memory);3031	/// @notice A distinct Uniform Resource Identifier (URI) for a given asset.32	///33	/// @dev If the token has a `url` property and it is not empty, it is returned.34	///  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`.35	///  If the collection property `baseURI` is empty or absent, return "" (empty string)36	///  otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix37	///  otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).38	///39	/// @return token's const_metadata40	/// @dev EVM selector for this function is: 0xc87b56dd,41	///  or in textual repr: tokenURI(uint256)42	function tokenURI(uint256 tokenId) external view returns (string memory);43}4445/// @title A contract that allows to set and delete token properties and change token property permissions.46/// @dev the ERC-165 identifier for this interface is 0x4136937747interface TokenProperties is Dummy, ERC165 {48	/// @notice Set permissions for token property.49	/// @dev Throws error if `msg.sender` is not admin or owner of the collection.50	/// @param key Property key.51	/// @param isMutable Permission to mutate property.52	/// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.53	/// @param tokenOwner Permission to mutate property by token owner if property is mutable.54	/// @dev EVM selector for this function is: 0x222d97fa,55	///  or in textual repr: setTokenPropertyPermission(string,bool,bool,bool)56	function setTokenPropertyPermission(57		string memory key,58		bool isMutable,59		bool collectionAdmin,60		bool tokenOwner61	) external;6263	/// @notice Set token property value.64	/// @dev Throws error if `msg.sender` has no permission to edit the property.65	/// @param tokenId ID of the token.66	/// @param key Property key.67	/// @param value Property value.68	/// @dev EVM selector for this function is: 0x1752d67b,69	///  or in textual repr: setProperty(uint256,string,bytes)70	function setProperty(71		uint256 tokenId,72		string memory key,73		bytes memory value74	) external;7576	/// @notice Delete token property value.77	/// @dev Throws error if `msg.sender` has no permission to edit the property.78	/// @param tokenId ID of the token.79	/// @param key Property key.80	/// @dev EVM selector for this function is: 0x066111d1,81	///  or in textual repr: deleteProperty(uint256,string)82	function deleteProperty(uint256 tokenId, string memory key) external;8384	/// @notice Get token property value.85	/// @dev Throws error if key not found86	/// @param tokenId ID of the token.87	/// @param key Property key.88	/// @return Property value bytes89	/// @dev EVM selector for this function is: 0x7228c327,90	///  or in textual repr: property(uint256,string)91	function property(uint256 tokenId, string memory key) external view returns (bytes memory);92}9394/// @title A contract that allows you to work with collections.95/// @dev the ERC-165 identifier for this interface is 0x3e1e808396interface Collection is Dummy, ERC165 {97	/// Set collection property.98	///99	/// @param key Property key.100	/// @param value Propery value.101	/// @dev EVM selector for this function is: 0x2f073f66,102	///  or in textual repr: setCollectionProperty(string,bytes)103	function setCollectionProperty(string memory key, bytes memory value) external;104105	/// Delete collection property.106	///107	/// @param key Property key.108	/// @dev EVM selector for this function is: 0x7b7debce,109	///  or in textual repr: deleteCollectionProperty(string)110	function deleteCollectionProperty(string memory key) external;111112	/// Get collection property.113	///114	/// @dev Throws error if key not found.115	///116	/// @param key Property key.117	/// @return bytes The property corresponding to the key.118	/// @dev EVM selector for this function is: 0xcf24fd6d,119	///  or in textual repr: collectionProperty(string)120	function collectionProperty(string memory key) external view returns (bytes memory);121122	/// Set the sponsor of the collection.123	///124	/// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.125	///126	/// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.127	/// @dev EVM selector for this function is: 0x7623402e,128	///  or in textual repr: setCollectionSponsor(address)129	function setCollectionSponsor(address sponsor) external;130131	/// Whether there is a pending sponsor.132	/// @dev EVM selector for this function is: 0x058ac185,133	///  or in textual repr: hasCollectionPendingSponsor()134	function hasCollectionPendingSponsor() external view returns (bool);135136	/// Collection sponsorship confirmation.137	///138	/// @dev After setting the sponsor for the collection, it must be confirmed with this function.139	/// @dev EVM selector for this function is: 0x3c50e97a,140	///  or in textual repr: confirmCollectionSponsorship()141	function confirmCollectionSponsorship() external;142143	/// Remove collection sponsor.144	/// @dev EVM selector for this function is: 0x6e0326a3,145	///  or in textual repr: removeCollectionSponsor()146	function removeCollectionSponsor() external;147148	/// Get current sponsor.149	///150	/// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.151	/// @dev EVM selector for this function is: 0x6ec0a9f1,152	///  or in textual repr: collectionSponsor()153	function collectionSponsor() external view returns (Tuple15 memory);154155	/// Set limits for the collection.156	/// @dev Throws error if limit not found.157	/// @param limit Name of the limit. Valid names:158	/// 	"accountTokenOwnershipLimit",159	/// 	"sponsoredDataSize",160	/// 	"sponsoredDataRateLimit",161	/// 	"tokenLimit",162	/// 	"sponsorTransferTimeout",163	/// 	"sponsorApproveTimeout"164	/// @param value Value of the limit.165	/// @dev EVM selector for this function is: 0x6a3841db,166	///  or in textual repr: setCollectionLimit(string,uint32)167	function setCollectionLimit(string memory limit, uint32 value) external;168169	/// Set limits for the collection.170	/// @dev Throws error if limit not found.171	/// @param limit Name of the limit. Valid names:172	/// 	"ownerCanTransfer",173	/// 	"ownerCanDestroy",174	/// 	"transfersEnabled"175	/// @param value Value of the limit.176	/// @dev EVM selector for this function is: 0x993b7fba,177	///  or in textual repr: setCollectionLimit(string,bool)178	function setCollectionLimit(string memory limit, bool value) external;179180	/// Get contract address.181	/// @dev EVM selector for this function is: 0xf6b4dfb4,182	///  or in textual repr: contractAddress()183	function contractAddress() external view returns (address);184185	/// Add collection admin.186	/// @param newAdmin Address of the added administrator.187	/// @dev EVM selector for this function is: 0x92e462c7,188	///  or in textual repr: addCollectionAdmin(address)189	function addCollectionAdmin(address newAdmin) external;190191	/// Remove collection admin.192	///193	/// @param admin Address of the removed administrator.194	/// @dev EVM selector for this function is: 0xfafd7b42,195	///  or in textual repr: removeCollectionAdmin(address)196	function removeCollectionAdmin(address admin) external;197198	/// Toggle accessibility of collection nesting.199	///200	/// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'201	/// @dev EVM selector for this function is: 0x112d4586,202	///  or in textual repr: setCollectionNesting(bool)203	function setCollectionNesting(bool enable) external;204205	/// Toggle accessibility of collection nesting.206	///207	/// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'208	/// @param collections Addresses of collections that will be available for nesting.209	/// @dev EVM selector for this function is: 0x64872396,210	///  or in textual repr: setCollectionNesting(bool,address[])211	function setCollectionNesting(bool enable, address[] memory collections) external;212213	/// Set the collection access method.214	/// @param mode Access mode215	/// 	0 for Normal216	/// 	1 for AllowList217	/// @dev EVM selector for this function is: 0x41835d4c,218	///  or in textual repr: setCollectionAccess(uint8)219	function setCollectionAccess(uint8 mode) external;220221	/// Checks that user allowed to operate with collection.222	///223	/// @param user User address to check.224	/// @dev EVM selector for this function is: 0xd63a8e11,225	///  or in textual repr: allowed(address)226	function allowed(address user) external view returns (bool);227228	/// Add the user to the allowed list.229	///230	/// @param user Address of a trusted user.231	/// @dev EVM selector for this function is: 0x67844fe6,232	///  or in textual repr: addToCollectionAllowList(address)233	function addToCollectionAllowList(address user) external;234235	/// Remove the user from the allowed list.236	///237	/// @param user Address of a removed user.238	/// @dev EVM selector for this function is: 0x85c51acb,239	///  or in textual repr: removeFromCollectionAllowList(address)240	function removeFromCollectionAllowList(address user) external;241242	/// Switch permission for minting.243	///244	/// @param mode Enable if "true".245	/// @dev EVM selector for this function is: 0x00018e84,246	///  or in textual repr: setCollectionMintMode(bool)247	function setCollectionMintMode(bool mode) external;248249	/// Check that account is the owner or admin of the collection250	///251	/// @param user account to verify252	/// @return "true" if account is the owner or admin253	/// @dev EVM selector for this function is: 0x9811b0c7,254	///  or in textual repr: isOwnerOrAdmin(address)255	function isOwnerOrAdmin(address user) external view returns (bool);256257	/// Returns collection type258	///259	/// @return `Fungible` or `NFT` or `ReFungible`260	/// @dev EVM selector for this function is: 0xd34b55b8,261	///  or in textual repr: uniqueCollectionType()262	function uniqueCollectionType() external view returns (string memory);263264	/// Get collection owner.265	///266	/// @return Tuble with sponsor address and his substrate mirror.267	/// If address is canonical then substrate mirror is zero and vice versa.268	/// @dev EVM selector for this function is: 0xdf727d3b,269	///  or in textual repr: collectionOwner()270	function collectionOwner() external view returns (Tuple15 memory);271272	/// Changes collection owner to another account273	///274	/// @dev Owner can be changed only by current owner275	/// @param newOwner new owner account276	/// @dev EVM selector for this function is: 0x13af4035,277	///  or in textual repr: setOwner(address)278	function setOwner(address newOwner) external;279}280281/// @dev anonymous struct282struct Tuple15 {283	address field_0;284	uint256 field_1;285}286287/// @title ERC721 Token that can be irreversibly burned (destroyed).288/// @dev the ERC-165 identifier for this interface is 0x42966c68289interface ERC721Burnable is Dummy, ERC165 {290	/// @notice Burns a specific ERC721 token.291	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized292	///  operator of the current owner.293	/// @param tokenId The NFT to approve294	/// @dev EVM selector for this function is: 0x42966c68,295	///  or in textual repr: burn(uint256)296	function burn(uint256 tokenId) external;297}298299/// @dev inlined interface300interface ERC721MintableEvents {301	event MintingFinished();302}303304/// @title ERC721 minting logic.305/// @dev the ERC-165 identifier for this interface is 0x68ccfe89306interface ERC721Mintable is Dummy, ERC165, ERC721MintableEvents {307	/// @dev EVM selector for this function is: 0x05d2035b,308	///  or in textual repr: mintingFinished()309	function mintingFinished() external view returns (bool);310311	/// @notice Function to mint token.312	/// @dev `tokenId` should be obtained with `nextTokenId` method,313	///  unlike standard, you can't specify it manually314	/// @param to The new owner315	/// @param tokenId ID of the minted NFT316	/// @dev EVM selector for this function is: 0x40c10f19,317	///  or in textual repr: mint(address,uint256)318	function mint(address to, uint256 tokenId) external returns (bool);319320	/// @notice Function to mint token with the given tokenUri.321	/// @dev `tokenId` should be obtained with `nextTokenId` method,322	///  unlike standard, you can't specify it manually323	/// @param to The new owner324	/// @param tokenId ID of the minted NFT325	/// @param tokenUri Token URI that would be stored in the NFT properties326	/// @dev EVM selector for this function is: 0x50bb4e7f,327	///  or in textual repr: mintWithTokenURI(address,uint256,string)328	function mintWithTokenURI(329		address to,330		uint256 tokenId,331		string memory tokenUri332	) external returns (bool);333334	/// @dev Not implemented335	/// @dev EVM selector for this function is: 0x7d64bcb4,336	///  or in textual repr: finishMinting()337	function finishMinting() external returns (bool);338}339340/// @title Unique extensions for ERC721.341/// @dev the ERC-165 identifier for this interface is 0x4468500d342interface ERC721UniqueExtensions is Dummy, ERC165 {343	/// @notice A descriptive name for a collection of NFTs in this contract344	/// @dev EVM selector for this function is: 0x06fdde03,345	///  or in textual repr: name()346	function name() external view returns (string memory);347348	/// @notice An abbreviated name for NFTs in this contract349	/// @dev EVM selector for this function is: 0x95d89b41,350	///  or in textual repr: symbol()351	function symbol() external view returns (string memory);352353	/// @notice Transfer ownership of an NFT354	/// @dev Throws unless `msg.sender` is the current owner. Throws if `to`355	///  is the zero address. Throws if `tokenId` is not a valid NFT.356	/// @param to The new owner357	/// @param tokenId The NFT to transfer358	/// @dev EVM selector for this function is: 0xa9059cbb,359	///  or in textual repr: transfer(address,uint256)360	function transfer(address to, uint256 tokenId) external;361362	/// @notice Burns a specific ERC721 token.363	/// @dev Throws unless `msg.sender` is the current owner or an authorized364	///  operator for this NFT. Throws if `from` is not the current owner. Throws365	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.366	/// @param from The current owner of the NFT367	/// @param tokenId The NFT to transfer368	/// @dev EVM selector for this function is: 0x79cc6790,369	///  or in textual repr: burnFrom(address,uint256)370	function burnFrom(address from, uint256 tokenId) external;371372	/// @notice Returns next free NFT ID.373	/// @dev EVM selector for this function is: 0x75794a3c,374	///  or in textual repr: nextTokenId()375	function nextTokenId() external view returns (uint256);376377	/// @notice Function to mint multiple tokens.378	/// @dev `tokenIds` should be an array of consecutive numbers and first number379	///  should be obtained with `nextTokenId` method380	/// @param to The new owner381	/// @param tokenIds IDs of the minted NFTs382	/// @dev EVM selector for this function is: 0x44a9945e,383	///  or in textual repr: mintBulk(address,uint256[])384	function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);385386	/// @notice Function to mint multiple tokens with the given tokenUris.387	/// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive388	///  numbers and first number should be obtained with `nextTokenId` method389	/// @param to The new owner390	/// @param tokens array of pairs of token ID and token URI for minted tokens391	/// @dev EVM selector for this function is: 0x36543006,392	///  or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])393	function mintBulkWithTokenURI(address to, Tuple6[] memory tokens) external returns (bool);394}395396/// @dev anonymous struct397struct Tuple6 {398	uint256 field_0;399	string field_1;400}401402/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension403/// @dev See https://eips.ethereum.org/EIPS/eip-721404/// @dev the ERC-165 identifier for this interface is 0x780e9d63405interface ERC721Enumerable is Dummy, ERC165 {406	/// @notice Enumerate valid NFTs407	/// @param index A counter less than `totalSupply()`408	/// @return The token identifier for the `index`th NFT,409	///  (sort order not specified)410	/// @dev EVM selector for this function is: 0x4f6ccce7,411	///  or in textual repr: tokenByIndex(uint256)412	function tokenByIndex(uint256 index) external view returns (uint256);413414	/// @dev Not implemented415	/// @dev EVM selector for this function is: 0x2f745c59,416	///  or in textual repr: tokenOfOwnerByIndex(address,uint256)417	function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);418419	/// @notice Count NFTs tracked by this contract420	/// @return A count of valid NFTs tracked by this contract, where each one of421	///  them has an assigned and queryable owner not equal to the zero address422	/// @dev EVM selector for this function is: 0x18160ddd,423	///  or in textual repr: totalSupply()424	function totalSupply() external view returns (uint256);425}426427/// @dev inlined interface428interface ERC721Events {429	event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);430	event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);431	event ApprovalForAll(address indexed owner, address indexed operator, bool approved);432}433434/// @title ERC-721 Non-Fungible Token Standard435/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md436/// @dev the ERC-165 identifier for this interface is 0x80ac58cd437interface ERC721 is Dummy, ERC165, ERC721Events {438	/// @notice Count all NFTs assigned to an owner439	/// @dev NFTs assigned to the zero address are considered invalid, and this440	///  function throws for queries about the zero address.441	/// @param owner An address for whom to query the balance442	/// @return The number of NFTs owned by `owner`, possibly zero443	/// @dev EVM selector for this function is: 0x70a08231,444	///  or in textual repr: balanceOf(address)445	function balanceOf(address owner) external view returns (uint256);446447	/// @notice Find the owner of an NFT448	/// @dev NFTs assigned to zero address are considered invalid, and queries449	///  about them do throw.450	/// @param tokenId The identifier for an NFT451	/// @return The address of the owner of the NFT452	/// @dev EVM selector for this function is: 0x6352211e,453	///  or in textual repr: ownerOf(uint256)454	function ownerOf(uint256 tokenId) external view returns (address);455456	/// @dev Not implemented457	/// @dev EVM selector for this function is: 0xb88d4fde,458	///  or in textual repr: safeTransferFrom(address,address,uint256,bytes)459	function safeTransferFrom(460		address from,461		address to,462		uint256 tokenId,463		bytes memory data464	) external;465466	/// @dev Not implemented467	/// @dev EVM selector for this function is: 0x42842e0e,468	///  or in textual repr: safeTransferFrom(address,address,uint256)469	function safeTransferFrom(470		address from,471		address to,472		uint256 tokenId473	) external;474475	/// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE476	///  TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE477	///  THEY MAY BE PERMANENTLY LOST478	/// @dev Throws unless `msg.sender` is the current owner or an authorized479	///  operator for this NFT. Throws if `from` is not the current owner. Throws480	///  if `to` is the zero address. Throws if `tokenId` is not a valid NFT.481	/// @param from The current owner of the NFT482	/// @param to The new owner483	/// @param tokenId The NFT to transfer484	/// @dev EVM selector for this function is: 0x23b872dd,485	///  or in textual repr: transferFrom(address,address,uint256)486	function transferFrom(487		address from,488		address to,489		uint256 tokenId490	) external;491492	/// @notice Set or reaffirm the approved address for an NFT493	/// @dev The zero address indicates there is no approved address.494	/// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized495	///  operator of the current owner.496	/// @param approved The new approved NFT controller497	/// @param tokenId The NFT to approve498	/// @dev EVM selector for this function is: 0x095ea7b3,499	///  or in textual repr: approve(address,uint256)500	function approve(address approved, uint256 tokenId) external;501502	/// @dev Not implemented503	/// @dev EVM selector for this function is: 0xa22cb465,504	///  or in textual repr: setApprovalForAll(address,bool)505	function setApprovalForAll(address operator, bool approved) external;506507	/// @dev Not implemented508	/// @dev EVM selector for this function is: 0x081812fc,509	///  or in textual repr: getApproved(uint256)510	function getApproved(uint256 tokenId) external view returns (address);511512	/// @dev Not implemented513	/// @dev EVM selector for this function is: 0xe985e9c5,514	///  or in textual repr: isApprovedForAll(address,address)515	function isApprovedForAll(address owner, address operator) external view returns (address);516}517518interface UniqueNFT is519	Dummy,520	ERC165,521	ERC721,522	ERC721Enumerable,523	ERC721UniqueExtensions,524	ERC721Mintable,525	ERC721Burnable,526	Collection,527	TokenProperties,528	ERC721Metadata529{}