difftreelog
misk: Move TokenChanged event into ERC721 contracts
in: master
16 files changed
pallets/common/src/erc.rsdiffbeforeafterboth--- a/pallets/common/src/erc.rs
+++ b/pallets/common/src/erc.rs
@@ -26,7 +26,6 @@
};
use pallet_evm_coder_substrate::dispatch_to_evm;
use sp_std::{vec, vec::Vec};
-use sp_core::U256;
use up_data_structs::{
CollectionMode, CollectionPermissions, OwnerRestrictedSet, Property, SponsoringRateLimit,
SponsorshipState,
@@ -62,18 +61,9 @@
},
/// The collection has been changed.
CollectionChanged {
- /// Collection ID.
- #[indexed]
- collection_id: Address,
- },
-
- /// The token has been changed.
- TokenChanged {
/// Collection ID.
#[indexed]
collection_id: Address,
- /// Token ID.
- token_id: U256,
},
}
pallets/common/src/lib.rsdiffbeforeafterboth--- a/pallets/common/src/lib.rs
+++ b/pallets/common/src/lib.rs
@@ -1250,6 +1250,7 @@
mut stored_properties: Properties,
is_token_owner: impl Fn() -> Result<bool, DispatchError>,
set_token_properties: impl FnOnce(Properties),
+ log: evm_coder::ethereum::Log,
) -> DispatchResult {
let is_collection_admin = collection.is_owner_or_admin(sender);
let permissions = Self::property_permissions(collection.id);
@@ -1304,13 +1305,7 @@
}
}
- <PalletEvm<T>>::deposit_log(
- CollectionHelpersEvents::TokenChanged {
- collection_id: eth::collection_id_to_address(collection.id),
- token_id: token_id.into(),
- }
- .to_log(T::ContractAddress::get()),
- );
+ <PalletEvm<T>>::deposit_log(log.clone());
}
set_token_properties(stored_properties);
pallets/nonfungible/src/erc.rsdiffbeforeafterboth--- a/pallets/nonfungible/src/erc.rs
+++ b/pallets/nonfungible/src/erc.rs
@@ -50,13 +50,26 @@
TokenProperties, SelfWeightOf, weights::WeightInfo,
};
+/// Nft events.
+#[derive(ToLog)]
+pub enum ERC721TokenEvent {
+ /// The token has been changed.
+ TokenChanged {
+ /// Collection ID.
+ #[indexed]
+ collection_id: Address,
+ /// Token ID.
+ token_id: U256,
+ },
+}
+
frontier_contract! {
macro_rules! NonfungibleHandle_result {...}
impl<T: Config> Contract for NonfungibleHandle<T> {...}
}
/// @title A contract that allows to set and delete token properties and change token property permissions.
-#[solidity_interface(name = TokenProperties, enum(derive(PreDispatch)), enum_attr(weight))]
+#[solidity_interface(name = TokenProperties, events(ERC721TokenEvent), enum(derive(PreDispatch)), enum_attr(weight))]
impl<T: Config> NonfungibleHandle<T> {
/// @notice Set permissions for token property.
/// @dev Throws error if `msg.sender` is not admin or owner of the collection.
pallets/nonfungible/src/lib.rsdiffbeforeafterboth--- a/pallets/nonfungible/src/lib.rs
+++ b/pallets/nonfungible/src/lib.rs
@@ -112,7 +112,7 @@
};
use pallet_structure::{Pallet as PalletStructure, Error as StructureError};
use pallet_evm_coder_substrate::{SubstrateRecorder, WithRecorder};
-use sp_core::H160;
+use sp_core::{Get, H160};
use sp_runtime::{ArithmeticError, DispatchError, DispatchResult, TransactionOutcome};
use sp_std::{vec::Vec, vec, collections::btree_map::BTreeMap};
use core::ops::Deref;
@@ -622,6 +622,11 @@
stored_properties,
is_token_owner,
|properties| <TokenProperties<T>>::set((collection.id, token_id), properties),
+ erc::ERC721TokenEvent::TokenChanged {
+ collection_id: collection_id_to_address(collection.id),
+ token_id: token_id.into(),
+ }
+ .to_log(T::ContractAddress::get()),
)
}
pallets/nonfungible/src/stubs/UniqueNFT.soldiffbeforeafterboth--- a/pallets/nonfungible/src/stubs/UniqueNFT.sol
+++ b/pallets/nonfungible/src/stubs/UniqueNFT.sol
@@ -17,9 +17,14 @@
}
}
+/// @dev inlined interface
+contract ERC721TokenEvent {
+ event TokenChanged(address indexed collectionId, uint256 tokenId);
+}
+
/// @title A contract that allows to set and delete token properties and change token property permissions.
/// @dev the ERC-165 identifier for this interface is 0xde0695c2
-contract TokenProperties is Dummy, ERC165 {
+contract TokenProperties is Dummy, ERC165, ERC721TokenEvent {
// /// @notice Set permissions for token property.
// /// @dev Throws error if `msg.sender` is not admin or owner of the collection.
// /// @param key Property key.
pallets/refungible/src/erc.rsdiffbeforeafterboth--- a/pallets/refungible/src/erc.rs
+++ b/pallets/refungible/src/erc.rs
@@ -59,8 +59,21 @@
pub const ADDRESS_FOR_PARTIALLY_OWNED_TOKENS: H160 = H160::repeat_byte(0xff);
+/// Rft events.
+#[derive(ToLog)]
+pub enum ERC721TokenEvent {
+ /// The token has been changed.
+ TokenChanged {
+ /// Collection ID.
+ #[indexed]
+ collection_id: Address,
+ /// Token ID.
+ token_id: U256,
+ },
+}
+
/// @title A contract that allows to set and delete token properties and change token property permissions.
-#[solidity_interface(name = TokenProperties, enum(derive(PreDispatch)), enum_attr(weight))]
+#[solidity_interface(name = TokenProperties, events(ERC721TokenEvent), enum(derive(PreDispatch)), enum_attr(weight))]
impl<T: Config> RefungibleHandle<T> {
/// @notice Set permissions for token property.
/// @dev Throws error if `msg.sender` is not admin or owner of the collection.
pallets/refungible/src/lib.rsdiffbeforeafterboth--- a/pallets/refungible/src/lib.rs
+++ b/pallets/refungible/src/lib.rs
@@ -100,7 +100,7 @@
Event as CommonEvent, Pallet as PalletCommon,
};
use pallet_structure::Pallet as PalletStructure;
-use sp_core::H160;
+use sp_core::{Get, H160};
use sp_runtime::{ArithmeticError, DispatchError, DispatchResult, TransactionOutcome};
use sp_std::{vec::Vec, vec, collections::btree_map::BTreeMap};
use up_data_structs::{
@@ -571,6 +571,11 @@
stored_properties,
is_token_owner,
|properties| <TokenProperties<T>>::set((collection.id, token_id), properties),
+ erc::ERC721TokenEvent::TokenChanged {
+ collection_id: collection_id_to_address(collection.id),
+ token_id: token_id.into(),
+ }
+ .to_log(T::ContractAddress::get()),
)
}
pallets/refungible/src/stubs/UniqueRefungible.soldiffbeforeafterboth--- a/pallets/refungible/src/stubs/UniqueRefungible.sol
+++ b/pallets/refungible/src/stubs/UniqueRefungible.sol
@@ -17,9 +17,14 @@
}
}
+/// @dev inlined interface
+contract ERC721TokenEvent {
+ event TokenChanged(address indexed collectionId, uint256 tokenId);
+}
+
/// @title A contract that allows to set and delete token properties and change token property permissions.
/// @dev the ERC-165 identifier for this interface is 0xde0695c2
-contract TokenProperties is Dummy, ERC165 {
+contract TokenProperties is Dummy, ERC165, ERC721TokenEvent {
// /// @notice Set permissions for token property.
// /// @dev Throws error if `msg.sender` is not admin or owner of the collection.
// /// @param key Property key.
pallets/unique/src/eth/stubs/CollectionHelpers.soldiffbeforeafterboth--- a/pallets/unique/src/eth/stubs/CollectionHelpers.sol
+++ b/pallets/unique/src/eth/stubs/CollectionHelpers.sol
@@ -22,7 +22,6 @@
event CollectionCreated(address indexed owner, address indexed collectionId);
event CollectionDestroyed(address indexed collectionId);
event CollectionChanged(address indexed collectionId);
- event TokenChanged(address indexed collectionId, uint256 tokenId);
}
/// @title Contract, which allows users to operate with collections
tests/src/eth/abi/collectionHelpers.jsondiffbeforeafterboth--- a/tests/src/eth/abi/collectionHelpers.json
+++ b/tests/src/eth/abi/collectionHelpers.json
@@ -45,25 +45,6 @@
"type": "event"
},
{
- "anonymous": false,
- "inputs": [
- {
- "indexed": true,
- "internalType": "address",
- "name": "collectionId",
- "type": "address"
- },
- {
- "indexed": false,
- "internalType": "uint256",
- "name": "tokenId",
- "type": "uint256"
- }
- ],
- "name": "TokenChanged",
- "type": "event"
- },
- {
"inputs": [
{ "internalType": "uint32", "name": "collectionId", "type": "uint32" }
],
tests/src/eth/abi/nonFungible.jsondiffbeforeafterboth--- a/tests/src/eth/abi/nonFungible.json
+++ b/tests/src/eth/abi/nonFungible.json
@@ -55,6 +55,25 @@
{
"indexed": true,
"internalType": "address",
+ "name": "collectionId",
+ "type": "address"
+ },
+ {
+ "indexed": false,
+ "internalType": "uint256",
+ "name": "tokenId",
+ "type": "uint256"
+ }
+ ],
+ "name": "TokenChanged",
+ "type": "event"
+ },
+ {
+ "anonymous": false,
+ "inputs": [
+ {
+ "indexed": true,
+ "internalType": "address",
"name": "from",
"type": "address"
},
tests/src/eth/abi/reFungible.jsondiffbeforeafterboth--- a/tests/src/eth/abi/reFungible.json
+++ b/tests/src/eth/abi/reFungible.json
@@ -55,6 +55,25 @@
{
"indexed": true,
"internalType": "address",
+ "name": "collectionId",
+ "type": "address"
+ },
+ {
+ "indexed": false,
+ "internalType": "uint256",
+ "name": "tokenId",
+ "type": "uint256"
+ }
+ ],
+ "name": "TokenChanged",
+ "type": "event"
+ },
+ {
+ "anonymous": false,
+ "inputs": [
+ {
+ "indexed": true,
+ "internalType": "address",
"name": "from",
"type": "address"
},
tests/src/eth/api/CollectionHelpers.soldiffbeforeafterboth--- a/tests/src/eth/api/CollectionHelpers.sol
+++ b/tests/src/eth/api/CollectionHelpers.sol
@@ -17,7 +17,6 @@
event CollectionCreated(address indexed owner, address indexed collectionId);
event CollectionDestroyed(address indexed collectionId);
event CollectionChanged(address indexed collectionId);
- event TokenChanged(address indexed collectionId, uint256 tokenId);
}
/// @title Contract, which allows users to operate with collections
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 0xde0695c217interface 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(string memory key, bool isMutable, bool collectionAdmin, bool tokenOwner) external;2728 /// @notice Set permissions for token property.29 /// @dev Throws error if `msg.sender` is not admin or owner of the collection.30 /// @param permissions Permissions for keys.31 /// @dev EVM selector for this function is: 0xbd92983a,32 /// or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])33 function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) external;3435 /// @notice Get permissions for token properties.36 /// @dev EVM selector for this function is: 0xf23d7790,37 /// or in textual repr: tokenPropertyPermissions()38 function tokenPropertyPermissions() external view returns (TokenPropertyPermission[] memory);3940 // /// @notice Set token property value.41 // /// @dev Throws error if `msg.sender` has no permission to edit the property.42 // /// @param tokenId ID of the token.43 // /// @param key Property key.44 // /// @param value Property value.45 // /// @dev EVM selector for this function is: 0x1752d67b,46 // /// or in textual repr: setProperty(uint256,string,bytes)47 // function setProperty(uint256 tokenId, string memory key, bytes memory value) external;4849 /// @notice Set token properties value.50 /// @dev Throws error if `msg.sender` has no permission to edit the property.51 /// @param tokenId ID of the token.52 /// @param properties settable properties53 /// @dev EVM selector for this function is: 0x14ed3a6e,54 /// or in textual repr: setProperties(uint256,(string,bytes)[])55 function setProperties(uint256 tokenId, Property[] memory properties) external;5657 // /// @notice Delete token property value.58 // /// @dev Throws error if `msg.sender` has no permission to edit the property.59 // /// @param tokenId ID of the token.60 // /// @param key Property key.61 // /// @dev EVM selector for this function is: 0x066111d1,62 // /// or in textual repr: deleteProperty(uint256,string)63 // function deleteProperty(uint256 tokenId, string memory key) external;6465 /// @notice Delete token properties value.66 /// @dev Throws error if `msg.sender` has no permission to edit the property.67 /// @param tokenId ID of the token.68 /// @param keys Properties key.69 /// @dev EVM selector for this function is: 0xc472d371,70 /// or in textual repr: deleteProperties(uint256,string[])71 function deleteProperties(uint256 tokenId, string[] memory keys) external;7273 /// @notice Get token property value.74 /// @dev Throws error if key not found75 /// @param tokenId ID of the token.76 /// @param key Property key.77 /// @return Property value bytes78 /// @dev EVM selector for this function is: 0x7228c327,79 /// or in textual repr: property(uint256,string)80 function property(uint256 tokenId, string memory key) external view returns (bytes memory);81}8283/// Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).84struct Property {85 string key;86 bytes value;87}8889/// Ethereum representation of Token Property Permissions.90struct TokenPropertyPermission {91 /// Token property key.92 string key;93 /// Token property permissions.94 PropertyPermission[] permissions;95}9697/// Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.98struct PropertyPermission {99 /// TokenPermission field.100 TokenPermissionField code;101 /// TokenPermission value.102 bool value;103}104105/// Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.106enum TokenPermissionField {107 /// Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]108 Mutable,109 /// Change permission for the collection administrator. See [`up_data_structs::PropertyPermission::token_owner`]110 TokenOwner,111 /// Permission to change the property for the owner of the token. See [`up_data_structs::PropertyPermission::collection_admin`]112 CollectionAdmin113}114115/// @title A contract that allows you to work with collections.116/// @dev the ERC-165 identifier for this interface is 0x2a14cfd1117interface Collection is Dummy, ERC165 {118 // /// Set collection property.119 // ///120 // /// @param key Property key.121 // /// @param value Propery value.122 // /// @dev EVM selector for this function is: 0x2f073f66,123 // /// or in textual repr: setCollectionProperty(string,bytes)124 // function setCollectionProperty(string memory key, bytes memory value) external;125126 /// Set collection properties.127 ///128 /// @param properties Vector of properties key/value pair.129 /// @dev EVM selector for this function is: 0x50b26b2a,130 /// or in textual repr: setCollectionProperties((string,bytes)[])131 function setCollectionProperties(Property[] memory properties) external;132133 // /// Delete collection property.134 // ///135 // /// @param key Property key.136 // /// @dev EVM selector for this function is: 0x7b7debce,137 // /// or in textual repr: deleteCollectionProperty(string)138 // function deleteCollectionProperty(string memory key) external;139140 /// Delete collection properties.141 ///142 /// @param keys Properties keys.143 /// @dev EVM selector for this function is: 0xee206ee3,144 /// or in textual repr: deleteCollectionProperties(string[])145 function deleteCollectionProperties(string[] memory keys) external;146147 /// Get collection property.148 ///149 /// @dev Throws error if key not found.150 ///151 /// @param key Property key.152 /// @return bytes The property corresponding to the key.153 /// @dev EVM selector for this function is: 0xcf24fd6d,154 /// or in textual repr: collectionProperty(string)155 function collectionProperty(string memory key) external view returns (bytes memory);156157 /// Get collection properties.158 ///159 /// @param keys Properties keys. Empty keys for all propertyes.160 /// @return Vector of properties key/value pairs.161 /// @dev EVM selector for this function is: 0x285fb8e6,162 /// or in textual repr: collectionProperties(string[])163 function collectionProperties(string[] memory keys) external view returns (Property[] memory);164165 // /// Set the sponsor of the collection.166 // ///167 // /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.168 // ///169 // /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.170 // /// @dev EVM selector for this function is: 0x7623402e,171 // /// or in textual repr: setCollectionSponsor(address)172 // function setCollectionSponsor(address sponsor) external;173174 /// Set the sponsor of the collection.175 ///176 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.177 ///178 /// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.179 /// @dev EVM selector for this function is: 0x84a1d5a8,180 /// or in textual repr: setCollectionSponsorCross((address,uint256))181 function setCollectionSponsorCross(CrossAddress memory sponsor) external;182183 /// Whether there is a pending sponsor.184 /// @dev EVM selector for this function is: 0x058ac185,185 /// or in textual repr: hasCollectionPendingSponsor()186 function hasCollectionPendingSponsor() external view returns (bool);187188 /// Collection sponsorship confirmation.189 ///190 /// @dev After setting the sponsor for the collection, it must be confirmed with this function.191 /// @dev EVM selector for this function is: 0x3c50e97a,192 /// or in textual repr: confirmCollectionSponsorship()193 function confirmCollectionSponsorship() external;194195 /// Remove collection sponsor.196 /// @dev EVM selector for this function is: 0x6e0326a3,197 /// or in textual repr: removeCollectionSponsor()198 function removeCollectionSponsor() external;199200 /// Get current sponsor.201 ///202 /// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.203 /// @dev EVM selector for this function is: 0x6ec0a9f1,204 /// or in textual repr: collectionSponsor()205 function collectionSponsor() external view returns (CrossAddress memory);206207 /// Get current collection limits.208 ///209 /// @return Array of collection limits210 /// @dev EVM selector for this function is: 0xf63bc572,211 /// or in textual repr: collectionLimits()212 function collectionLimits() external view returns (CollectionLimit[] memory);213214 /// Set limits for the collection.215 /// @dev Throws error if limit not found.216 /// @param limit Some limit.217 /// @dev EVM selector for this function is: 0x2316ee74,218 /// or in textual repr: setCollectionLimit((uint8,(bool,uint256)))219 function setCollectionLimit(CollectionLimit memory limit) external;220221 /// Get contract address.222 /// @dev EVM selector for this function is: 0xf6b4dfb4,223 /// or in textual repr: contractAddress()224 function contractAddress() external view returns (address);225226 /// Add collection admin.227 /// @param newAdmin Cross account administrator address.228 /// @dev EVM selector for this function is: 0x859aa7d6,229 /// or in textual repr: addCollectionAdminCross((address,uint256))230 function addCollectionAdminCross(CrossAddress memory newAdmin) external;231232 /// Remove collection admin.233 /// @param admin Cross account administrator address.234 /// @dev EVM selector for this function is: 0x6c0cd173,235 /// or in textual repr: removeCollectionAdminCross((address,uint256))236 function removeCollectionAdminCross(CrossAddress memory admin) external;237238 // /// Add collection admin.239 // /// @param newAdmin Address of the added administrator.240 // /// @dev EVM selector for this function is: 0x92e462c7,241 // /// or in textual repr: addCollectionAdmin(address)242 // function addCollectionAdmin(address newAdmin) external;243244 // /// Remove collection admin.245 // ///246 // /// @param admin Address of the removed administrator.247 // /// @dev EVM selector for this function is: 0xfafd7b42,248 // /// or in textual repr: removeCollectionAdmin(address)249 // function removeCollectionAdmin(address admin) external;250251 /// Toggle accessibility of collection nesting.252 ///253 /// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'254 /// @dev EVM selector for this function is: 0x112d4586,255 /// or in textual repr: setCollectionNesting(bool)256 function setCollectionNesting(bool enable) external;257258 /// Toggle accessibility of collection nesting.259 ///260 /// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'261 /// @param collections Addresses of collections that will be available for nesting.262 /// @dev EVM selector for this function is: 0x64872396,263 /// or in textual repr: setCollectionNesting(bool,address[])264 function setCollectionNesting(bool enable, address[] memory collections) external;265266 /// Returns nesting for a collection267 /// @dev EVM selector for this function is: 0x22d25bfe,268 /// or in textual repr: collectionNestingRestrictedCollectionIds()269 function collectionNestingRestrictedCollectionIds() external view returns (CollectionNesting memory);270271 /// Returns permissions for a collection272 /// @dev EVM selector for this function is: 0x5b2eaf4b,273 /// or in textual repr: collectionNestingPermissions()274 function collectionNestingPermissions() external view returns (CollectionNestingPermission[] memory);275276 /// Set the collection access method.277 /// @param mode Access mode278 /// @dev EVM selector for this function is: 0x41835d4c,279 /// or in textual repr: setCollectionAccess(uint8)280 function setCollectionAccess(AccessMode mode) external;281282 /// Checks that user allowed to operate with collection.283 ///284 /// @param user User address to check.285 /// @dev EVM selector for this function is: 0x91b6df49,286 /// or in textual repr: allowlistedCross((address,uint256))287 function allowlistedCross(CrossAddress memory user) external view returns (bool);288289 // /// Add the user to the allowed list.290 // ///291 // /// @param user Address of a trusted user.292 // /// @dev EVM selector for this function is: 0x67844fe6,293 // /// or in textual repr: addToCollectionAllowList(address)294 // function addToCollectionAllowList(address user) external;295296 /// Add user to allowed list.297 ///298 /// @param user User cross account address.299 /// @dev EVM selector for this function is: 0xa0184a3a,300 /// or in textual repr: addToCollectionAllowListCross((address,uint256))301 function addToCollectionAllowListCross(CrossAddress memory user) external;302303 // /// Remove the user from the allowed list.304 // ///305 // /// @param user Address of a removed user.306 // /// @dev EVM selector for this function is: 0x85c51acb,307 // /// or in textual repr: removeFromCollectionAllowList(address)308 // function removeFromCollectionAllowList(address user) external;309310 /// Remove user from allowed list.311 ///312 /// @param user User cross account address.313 /// @dev EVM selector for this function is: 0x09ba452a,314 /// or in textual repr: removeFromCollectionAllowListCross((address,uint256))315 function removeFromCollectionAllowListCross(CrossAddress memory user) external;316317 /// Switch permission for minting.318 ///319 /// @param mode Enable if "true".320 /// @dev EVM selector for this function is: 0x00018e84,321 /// or in textual repr: setCollectionMintMode(bool)322 function setCollectionMintMode(bool mode) external;323324 // /// Check that account is the owner or admin of the collection325 // ///326 // /// @param user account to verify327 // /// @return "true" if account is the owner or admin328 // /// @dev EVM selector for this function is: 0x9811b0c7,329 // /// or in textual repr: isOwnerOrAdmin(address)330 // function isOwnerOrAdmin(address user) external view returns (bool);331332 /// Check that account is the owner or admin of the collection333 ///334 /// @param user User cross account to verify335 /// @return "true" if account is the owner or admin336 /// @dev EVM selector for this function is: 0x3e75a905,337 /// or in textual repr: isOwnerOrAdminCross((address,uint256))338 function isOwnerOrAdminCross(CrossAddress memory user) external view returns (bool);339340 /// Returns collection type341 ///342 /// @return `Fungible` or `NFT` or `ReFungible`343 /// @dev EVM selector for this function is: 0xd34b55b8,344 /// or in textual repr: uniqueCollectionType()345 function uniqueCollectionType() external view returns (string memory);346347 /// Get collection owner.348 ///349 /// @return Tuble with sponsor address and his substrate mirror.350 /// If address is canonical then substrate mirror is zero and vice versa.351 /// @dev EVM selector for this function is: 0xdf727d3b,352 /// or in textual repr: collectionOwner()353 function collectionOwner() external view returns (CrossAddress memory);354355 // /// Changes collection owner to another account356 // ///357 // /// @dev Owner can be changed only by current owner358 // /// @param newOwner new owner account359 // /// @dev EVM selector for this function is: 0x4f53e226,360 // /// or in textual repr: changeCollectionOwner(address)361 // function changeCollectionOwner(address newOwner) external;362363 /// Get collection administrators364 ///365 /// @return Vector of tuples with admins address and his substrate mirror.366 /// If address is canonical then substrate mirror is zero and vice versa.367 /// @dev EVM selector for this function is: 0x5813216b,368 /// or in textual repr: collectionAdmins()369 function collectionAdmins() external view returns (CrossAddress[] memory);370371 /// Changes collection owner to another account372 ///373 /// @dev Owner can be changed only by current owner374 /// @param newOwner new owner cross account375 /// @dev EVM selector for this function is: 0x6496c497,376 /// or in textual repr: changeCollectionOwnerCross((address,uint256))377 function changeCollectionOwnerCross(CrossAddress memory newOwner) external;378}379380/// Cross account struct381struct CrossAddress {382 address eth;383 uint256 sub;384}385386/// Ethereum representation of `AccessMode` (see [`up_data_structs::AccessMode`]).387enum AccessMode {388 /// Access grant for owner and admins. Used as default.389 Normal,390 /// Like a [`Normal`](AccessMode::Normal) but also users in allow list.391 AllowList392}393394/// Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) field.395struct CollectionNestingPermission {396 CollectionPermissionField field;397 bool value;398}399400/// Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.401enum CollectionPermissionField {402 /// Owner of token can nest tokens under it.403 TokenOwner,404 /// Admin of token collection can nest tokens under token.405 CollectionAdmin406}407408/// Nested collections.409struct CollectionNesting {410 bool token_owner;411 uint256[] ids;412}413414/// [`CollectionLimits`](up_data_structs::CollectionLimits) field representation for EVM.415struct CollectionLimit {416 CollectionLimitField field;417 OptionUint256 value;418}419420/// Optional value421struct OptionUint256 {422 /// Shows the status of accessibility of value423 bool status;424 /// Actual value if `status` is true425 uint256 value;426}427428/// [`CollectionLimits`](up_data_structs::CollectionLimits) fields representation for EVM.429enum CollectionLimitField {430 /// How many tokens can a user have on one account.431 AccountTokenOwnership,432 /// How many bytes of data are available for sponsorship.433 SponsoredDataSize,434 /// In any case, chain default: [`SponsoringRateLimit::SponsoringDisabled`]435 SponsoredDataRateLimit,436 /// How many tokens can be mined into this collection.437 TokenLimit,438 /// Timeouts for transfer sponsoring.439 SponsorTransferTimeout,440 /// Timeout for sponsoring an approval in passed blocks.441 SponsorApproveTimeout,442 /// Whether the collection owner of the collection can send tokens (which belong to other users).443 OwnerCanTransfer,444 /// Can the collection owner burn other people's tokens.445 OwnerCanDestroy,446 /// Is it possible to send tokens from this collection between users.447 TransferEnabled448}449450/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension451/// @dev See https://eips.ethereum.org/EIPS/eip-721452/// @dev the ERC-165 identifier for this interface is 0x5b5e139f453interface ERC721Metadata is Dummy, ERC165 {454 // /// @notice A descriptive name for a collection of NFTs in this contract455 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`456 // /// @dev EVM selector for this function is: 0x06fdde03,457 // /// or in textual repr: name()458 // function name() external view returns (string memory);459460 // /// @notice An abbreviated name for NFTs in this contract461 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`462 // /// @dev EVM selector for this function is: 0x95d89b41,463 // /// or in textual repr: symbol()464 // function symbol() external view returns (string memory);465466 /// @notice A distinct Uniform Resource Identifier (URI) for a given asset.467 ///468 /// @dev If the token has a `url` property and it is not empty, it is returned.469 /// 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`.470 /// If the collection property `baseURI` is empty or absent, return "" (empty string)471 /// otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix472 /// otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).473 ///474 /// @return token's const_metadata475 /// @dev EVM selector for this function is: 0xc87b56dd,476 /// or in textual repr: tokenURI(uint256)477 function tokenURI(uint256 tokenId) external view returns (string memory);478}479480/// @title ERC721 Token that can be irreversibly burned (destroyed).481/// @dev the ERC-165 identifier for this interface is 0x42966c68482interface ERC721Burnable is Dummy, ERC165 {483 /// @notice Burns a specific ERC721 token.484 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized485 /// operator of the current owner.486 /// @param tokenId The NFT to approve487 /// @dev EVM selector for this function is: 0x42966c68,488 /// or in textual repr: burn(uint256)489 function burn(uint256 tokenId) external;490}491492/// @title ERC721 minting logic.493/// @dev the ERC-165 identifier for this interface is 0x3fd94ea6494interface ERC721UniqueMintable is Dummy, ERC165 {495 /// @notice Function to mint a token.496 /// @param to The new owner497 /// @return uint256 The id of the newly minted token498 /// @dev EVM selector for this function is: 0x6a627842,499 /// or in textual repr: mint(address)500 function mint(address to) external returns (uint256);501502 // /// @notice Function to mint a token.503 // /// @dev `tokenId` should be obtained with `nextTokenId` method,504 // /// unlike standard, you can't specify it manually505 // /// @param to The new owner506 // /// @param tokenId ID of the minted NFT507 // /// @dev EVM selector for this function is: 0x40c10f19,508 // /// or in textual repr: mint(address,uint256)509 // function mint(address to, uint256 tokenId) external returns (bool);510511 /// @notice Function to mint token with the given tokenUri.512 /// @param to The new owner513 /// @param tokenUri Token URI that would be stored in the NFT properties514 /// @return uint256 The id of the newly minted token515 /// @dev EVM selector for this function is: 0x45c17782,516 /// or in textual repr: mintWithTokenURI(address,string)517 function mintWithTokenURI(address to, string memory tokenUri) external returns (uint256);518 // /// @notice Function to mint token with the given tokenUri.519 // /// @dev `tokenId` should be obtained with `nextTokenId` method,520 // /// unlike standard, you can't specify it manually521 // /// @param to The new owner522 // /// @param tokenId ID of the minted NFT523 // /// @param tokenUri Token URI that would be stored in the NFT properties524 // /// @dev EVM selector for this function is: 0x50bb4e7f,525 // /// or in textual repr: mintWithTokenURI(address,uint256,string)526 // function mintWithTokenURI(address to, uint256 tokenId, string memory tokenUri) external returns (bool);527528}529530/// @title Unique extensions for ERC721.531/// @dev the ERC-165 identifier for this interface is 0x16de3152532interface ERC721UniqueExtensions is Dummy, ERC165 {533 /// @notice A descriptive name for a collection of NFTs in this contract534 /// @dev EVM selector for this function is: 0x06fdde03,535 /// or in textual repr: name()536 function name() external view returns (string memory);537538 /// @notice An abbreviated name for NFTs in this contract539 /// @dev EVM selector for this function is: 0x95d89b41,540 /// or in textual repr: symbol()541 function symbol() external view returns (string memory);542543 /// @notice A description for the collection.544 /// @dev EVM selector for this function is: 0x7284e416,545 /// or in textual repr: description()546 function description() external view returns (string memory);547548 /// Returns the owner (in cross format) of the token.549 ///550 /// @param tokenId Id for the token.551 /// @dev EVM selector for this function is: 0x2b29dace,552 /// or in textual repr: crossOwnerOf(uint256)553 function crossOwnerOf(uint256 tokenId) external view returns (CrossAddress memory);554555 /// Returns the token properties.556 ///557 /// @param tokenId Id for the token.558 /// @param keys Properties keys. Empty keys for all propertyes.559 /// @return Vector of properties key/value pairs.560 /// @dev EVM selector for this function is: 0xe07ede7e,561 /// or in textual repr: properties(uint256,string[])562 function properties(uint256 tokenId, string[] memory keys) external view returns (Property[] memory);563564 /// @notice Set or reaffirm the approved address for an NFT565 /// @dev The zero address indicates there is no approved address.566 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized567 /// operator of the current owner.568 /// @param approved The new substrate address approved NFT controller569 /// @param tokenId The NFT to approve570 /// @dev EVM selector for this function is: 0x0ecd0ab0,571 /// or in textual repr: approveCross((address,uint256),uint256)572 function approveCross(CrossAddress memory approved, uint256 tokenId) external;573574 /// @notice Transfer ownership of an NFT575 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`576 /// is the zero address. Throws if `tokenId` is not a valid NFT.577 /// @param to The new owner578 /// @param tokenId The NFT to transfer579 /// @dev EVM selector for this function is: 0xa9059cbb,580 /// or in textual repr: transfer(address,uint256)581 function transfer(address to, uint256 tokenId) external;582583 /// @notice Transfer ownership of an NFT584 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`585 /// is the zero address. Throws if `tokenId` is not a valid NFT.586 /// @param to The new owner587 /// @param tokenId The NFT to transfer588 /// @dev EVM selector for this function is: 0x2ada85ff,589 /// or in textual repr: transferCross((address,uint256),uint256)590 function transferCross(CrossAddress memory to, uint256 tokenId) external;591592 /// @notice Transfer ownership of an NFT from cross account address to cross account address593 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`594 /// is the zero address. Throws if `tokenId` is not a valid NFT.595 /// @param from Cross acccount address of current owner596 /// @param to Cross acccount address of new owner597 /// @param tokenId The NFT to transfer598 /// @dev EVM selector for this function is: 0xd5cf430b,599 /// or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)600 function transferFromCross(601 CrossAddress memory from,602 CrossAddress memory to,603 uint256 tokenId604 ) external;605606 // /// @notice Burns a specific ERC721 token.607 // /// @dev Throws unless `msg.sender` is the current owner or an authorized608 // /// operator for this NFT. Throws if `from` is not the current owner. Throws609 // /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.610 // /// @param from The current owner of the NFT611 // /// @param tokenId The NFT to transfer612 // /// @dev EVM selector for this function is: 0x79cc6790,613 // /// or in textual repr: burnFrom(address,uint256)614 // function burnFrom(address from, uint256 tokenId) external;615616 /// @notice Burns a specific ERC721 token.617 /// @dev Throws unless `msg.sender` is the current owner or an authorized618 /// operator for this NFT. Throws if `from` is not the current owner. Throws619 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.620 /// @param from The current owner of the NFT621 /// @param tokenId The NFT to transfer622 /// @dev EVM selector for this function is: 0xbb2f5a58,623 /// or in textual repr: burnFromCross((address,uint256),uint256)624 function burnFromCross(CrossAddress memory from, uint256 tokenId) external;625626 /// @notice Returns next free NFT ID.627 /// @dev EVM selector for this function is: 0x75794a3c,628 /// or in textual repr: nextTokenId()629 function nextTokenId() external view returns (uint256);630631 // /// @notice Function to mint multiple tokens.632 // /// @dev `tokenIds` should be an array of consecutive numbers and first number633 // /// should be obtained with `nextTokenId` method634 // /// @param to The new owner635 // /// @param tokenIds IDs of the minted NFTs636 // /// @dev EVM selector for this function is: 0x44a9945e,637 // /// or in textual repr: mintBulk(address,uint256[])638 // function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);639640 // /// @notice Function to mint multiple tokens with the given tokenUris.641 // /// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive642 // /// numbers and first number should be obtained with `nextTokenId` method643 // /// @param to The new owner644 // /// @param tokens array of pairs of token ID and token URI for minted tokens645 // /// @dev EVM selector for this function is: 0x36543006,646 // /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])647 // function mintBulkWithTokenURI(address to, TokenUri[] memory tokens) external returns (bool);648649 /// @notice Function to mint a token.650 /// @param to The new owner crossAccountId651 /// @param properties Properties of minted token652 /// @return uint256 The id of the newly minted token653 /// @dev EVM selector for this function is: 0xb904db03,654 /// or in textual repr: mintCross((address,uint256),(string,bytes)[])655 function mintCross(CrossAddress memory to, Property[] memory properties) external returns (uint256);656657 /// @notice Returns collection helper contract address658 /// @dev EVM selector for this function is: 0x1896cce6,659 /// or in textual repr: collectionHelperAddress()660 function collectionHelperAddress() external view returns (address);661}662663/// Data for creation token with uri.664struct TokenUri {665 /// Id of new token.666 uint256 id;667 /// Uri of new token.668 string uri;669}670671/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension672/// @dev See https://eips.ethereum.org/EIPS/eip-721673/// @dev the ERC-165 identifier for this interface is 0x780e9d63674interface ERC721Enumerable is Dummy, ERC165 {675 /// @notice Enumerate valid NFTs676 /// @param index A counter less than `totalSupply()`677 /// @return The token identifier for the `index`th NFT,678 /// (sort order not specified)679 /// @dev EVM selector for this function is: 0x4f6ccce7,680 /// or in textual repr: tokenByIndex(uint256)681 function tokenByIndex(uint256 index) external view returns (uint256);682683 /// @dev Not implemented684 /// @dev EVM selector for this function is: 0x2f745c59,685 /// or in textual repr: tokenOfOwnerByIndex(address,uint256)686 function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);687688 /// @notice Count NFTs tracked by this contract689 /// @return A count of valid NFTs tracked by this contract, where each one of690 /// them has an assigned and queryable owner not equal to the zero address691 /// @dev EVM selector for this function is: 0x18160ddd,692 /// or in textual repr: totalSupply()693 function totalSupply() external view returns (uint256);694}695696/// @dev inlined interface697interface ERC721Events {698 event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);699 event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);700 event ApprovalForAll(address indexed owner, address indexed operator, bool approved);701}702703/// @title ERC-721 Non-Fungible Token Standard704/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md705/// @dev the ERC-165 identifier for this interface is 0x80ac58cd706interface ERC721 is Dummy, ERC165, ERC721Events {707 /// @notice Count all NFTs assigned to an owner708 /// @dev NFTs assigned to the zero address are considered invalid, and this709 /// function throws for queries about the zero address.710 /// @param owner An address for whom to query the balance711 /// @return The number of NFTs owned by `owner`, possibly zero712 /// @dev EVM selector for this function is: 0x70a08231,713 /// or in textual repr: balanceOf(address)714 function balanceOf(address owner) external view returns (uint256);715716 /// @notice Find the owner of an NFT717 /// @dev NFTs assigned to zero address are considered invalid, and queries718 /// about them do throw.719 /// @param tokenId The identifier for an NFT720 /// @return The address of the owner of the NFT721 /// @dev EVM selector for this function is: 0x6352211e,722 /// or in textual repr: ownerOf(uint256)723 function ownerOf(uint256 tokenId) external view returns (address);724725 /// @dev Not implemented726 /// @dev EVM selector for this function is: 0xb88d4fde,727 /// or in textual repr: safeTransferFrom(address,address,uint256,bytes)728 function safeTransferFrom(729 address from,730 address to,731 uint256 tokenId,732 bytes memory data733 ) external;734735 /// @dev Not implemented736 /// @dev EVM selector for this function is: 0x42842e0e,737 /// or in textual repr: safeTransferFrom(address,address,uint256)738 function safeTransferFrom(739 address from,740 address to,741 uint256 tokenId742 ) external;743744 /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE745 /// TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE746 /// THEY MAY BE PERMANENTLY LOST747 /// @dev Throws unless `msg.sender` is the current owner or an authorized748 /// operator for this NFT. Throws if `from` is not the current owner. Throws749 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.750 /// @param from The current owner of the NFT751 /// @param to The new owner752 /// @param tokenId The NFT to transfer753 /// @dev EVM selector for this function is: 0x23b872dd,754 /// or in textual repr: transferFrom(address,address,uint256)755 function transferFrom(756 address from,757 address to,758 uint256 tokenId759 ) external;760761 /// @notice Set or reaffirm the approved address for an NFT762 /// @dev The zero address indicates there is no approved address.763 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized764 /// operator of the current owner.765 /// @param approved The new approved NFT controller766 /// @param tokenId The NFT to approve767 /// @dev EVM selector for this function is: 0x095ea7b3,768 /// or in textual repr: approve(address,uint256)769 function approve(address approved, uint256 tokenId) external;770771 /// @notice Sets or unsets the approval of a given operator.772 /// The `operator` is allowed to transfer all tokens of the `caller` on their behalf.773 /// @param operator Operator774 /// @param approved Should operator status be granted or revoked?775 /// @dev EVM selector for this function is: 0xa22cb465,776 /// or in textual repr: setApprovalForAll(address,bool)777 function setApprovalForAll(address operator, bool approved) external;778779 /// @dev Not implemented780 /// @dev EVM selector for this function is: 0x081812fc,781 /// or in textual repr: getApproved(uint256)782 function getApproved(uint256 tokenId) external view returns (address);783784 /// @notice Tells whether the given `owner` approves the `operator`.785 /// @dev EVM selector for this function is: 0xe985e9c5,786 /// or in textual repr: isApprovedForAll(address,address)787 function isApprovedForAll(address owner, address operator) external view returns (bool);788}789790interface UniqueNFT is791 Dummy,792 ERC165,793 ERC721,794 ERC721Enumerable,795 ERC721UniqueExtensions,796 ERC721UniqueMintable,797 ERC721Burnable,798 ERC721Metadata,799 Collection,800 TokenProperties801{}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/// @dev inlined interface16interface ERC721TokenEvent {17 event TokenChanged(address indexed collectionId, uint256 tokenId);18}1920/// @title A contract that allows to set and delete token properties and change token property permissions.21/// @dev the ERC-165 identifier for this interface is 0xde0695c222interface TokenProperties is Dummy, ERC165, ERC721TokenEvent {23 // /// @notice Set permissions for token property.24 // /// @dev Throws error if `msg.sender` is not admin or owner of the collection.25 // /// @param key Property key.26 // /// @param isMutable Permission to mutate property.27 // /// @param collectionAdmin Permission to mutate property by collection admin if property is mutable.28 // /// @param tokenOwner Permission to mutate property by token owner if property is mutable.29 // /// @dev EVM selector for this function is: 0x222d97fa,30 // /// or in textual repr: setTokenPropertyPermission(string,bool,bool,bool)31 // function setTokenPropertyPermission(string memory key, bool isMutable, bool collectionAdmin, bool tokenOwner) external;3233 /// @notice Set permissions for token property.34 /// @dev Throws error if `msg.sender` is not admin or owner of the collection.35 /// @param permissions Permissions for keys.36 /// @dev EVM selector for this function is: 0xbd92983a,37 /// or in textual repr: setTokenPropertyPermissions((string,(uint8,bool)[])[])38 function setTokenPropertyPermissions(TokenPropertyPermission[] memory permissions) external;3940 /// @notice Get permissions for token properties.41 /// @dev EVM selector for this function is: 0xf23d7790,42 /// or in textual repr: tokenPropertyPermissions()43 function tokenPropertyPermissions() external view returns (TokenPropertyPermission[] memory);4445 // /// @notice Set token property value.46 // /// @dev Throws error if `msg.sender` has no permission to edit the property.47 // /// @param tokenId ID of the token.48 // /// @param key Property key.49 // /// @param value Property value.50 // /// @dev EVM selector for this function is: 0x1752d67b,51 // /// or in textual repr: setProperty(uint256,string,bytes)52 // function setProperty(uint256 tokenId, string memory key, bytes memory value) external;5354 /// @notice Set token properties value.55 /// @dev Throws error if `msg.sender` has no permission to edit the property.56 /// @param tokenId ID of the token.57 /// @param properties settable properties58 /// @dev EVM selector for this function is: 0x14ed3a6e,59 /// or in textual repr: setProperties(uint256,(string,bytes)[])60 function setProperties(uint256 tokenId, Property[] memory properties) external;6162 // /// @notice Delete token property value.63 // /// @dev Throws error if `msg.sender` has no permission to edit the property.64 // /// @param tokenId ID of the token.65 // /// @param key Property key.66 // /// @dev EVM selector for this function is: 0x066111d1,67 // /// or in textual repr: deleteProperty(uint256,string)68 // function deleteProperty(uint256 tokenId, string memory key) external;6970 /// @notice Delete token properties value.71 /// @dev Throws error if `msg.sender` has no permission to edit the property.72 /// @param tokenId ID of the token.73 /// @param keys Properties key.74 /// @dev EVM selector for this function is: 0xc472d371,75 /// or in textual repr: deleteProperties(uint256,string[])76 function deleteProperties(uint256 tokenId, string[] memory keys) external;7778 /// @notice Get token property value.79 /// @dev Throws error if key not found80 /// @param tokenId ID of the token.81 /// @param key Property key.82 /// @return Property value bytes83 /// @dev EVM selector for this function is: 0x7228c327,84 /// or in textual repr: property(uint256,string)85 function property(uint256 tokenId, string memory key) external view returns (bytes memory);86}8788/// Ethereum representation of collection [`PropertyKey`](up_data_structs::PropertyKey) and [`PropertyValue`](up_data_structs::PropertyValue).89struct Property {90 string key;91 bytes value;92}9394/// Ethereum representation of Token Property Permissions.95struct TokenPropertyPermission {96 /// Token property key.97 string key;98 /// Token property permissions.99 PropertyPermission[] permissions;100}101102/// Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) as an key and value.103struct PropertyPermission {104 /// TokenPermission field.105 TokenPermissionField code;106 /// TokenPermission value.107 bool value;108}109110/// Ethereum representation of TokenPermissions (see [`up_data_structs::PropertyPermission`]) fields as an enumeration.111enum TokenPermissionField {112 /// Permission to change the property and property permission. See [`up_data_structs::PropertyPermission::mutable`]113 Mutable,114 /// Change permission for the collection administrator. See [`up_data_structs::PropertyPermission::token_owner`]115 TokenOwner,116 /// Permission to change the property for the owner of the token. See [`up_data_structs::PropertyPermission::collection_admin`]117 CollectionAdmin118}119120/// @title A contract that allows you to work with collections.121/// @dev the ERC-165 identifier for this interface is 0x2a14cfd1122interface Collection is Dummy, ERC165 {123 // /// Set collection property.124 // ///125 // /// @param key Property key.126 // /// @param value Propery value.127 // /// @dev EVM selector for this function is: 0x2f073f66,128 // /// or in textual repr: setCollectionProperty(string,bytes)129 // function setCollectionProperty(string memory key, bytes memory value) external;130131 /// Set collection properties.132 ///133 /// @param properties Vector of properties key/value pair.134 /// @dev EVM selector for this function is: 0x50b26b2a,135 /// or in textual repr: setCollectionProperties((string,bytes)[])136 function setCollectionProperties(Property[] memory properties) external;137138 // /// Delete collection property.139 // ///140 // /// @param key Property key.141 // /// @dev EVM selector for this function is: 0x7b7debce,142 // /// or in textual repr: deleteCollectionProperty(string)143 // function deleteCollectionProperty(string memory key) external;144145 /// Delete collection properties.146 ///147 /// @param keys Properties keys.148 /// @dev EVM selector for this function is: 0xee206ee3,149 /// or in textual repr: deleteCollectionProperties(string[])150 function deleteCollectionProperties(string[] memory keys) external;151152 /// Get collection property.153 ///154 /// @dev Throws error if key not found.155 ///156 /// @param key Property key.157 /// @return bytes The property corresponding to the key.158 /// @dev EVM selector for this function is: 0xcf24fd6d,159 /// or in textual repr: collectionProperty(string)160 function collectionProperty(string memory key) external view returns (bytes memory);161162 /// Get collection properties.163 ///164 /// @param keys Properties keys. Empty keys for all propertyes.165 /// @return Vector of properties key/value pairs.166 /// @dev EVM selector for this function is: 0x285fb8e6,167 /// or in textual repr: collectionProperties(string[])168 function collectionProperties(string[] memory keys) external view returns (Property[] memory);169170 // /// Set the sponsor of the collection.171 // ///172 // /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.173 // ///174 // /// @param sponsor Address of the sponsor from whose account funds will be debited for operations with the contract.175 // /// @dev EVM selector for this function is: 0x7623402e,176 // /// or in textual repr: setCollectionSponsor(address)177 // function setCollectionSponsor(address sponsor) external;178179 /// Set the sponsor of the collection.180 ///181 /// @dev In order for sponsorship to work, it must be confirmed on behalf of the sponsor.182 ///183 /// @param sponsor Cross account address of the sponsor from whose account funds will be debited for operations with the contract.184 /// @dev EVM selector for this function is: 0x84a1d5a8,185 /// or in textual repr: setCollectionSponsorCross((address,uint256))186 function setCollectionSponsorCross(CrossAddress memory sponsor) external;187188 /// Whether there is a pending sponsor.189 /// @dev EVM selector for this function is: 0x058ac185,190 /// or in textual repr: hasCollectionPendingSponsor()191 function hasCollectionPendingSponsor() external view returns (bool);192193 /// Collection sponsorship confirmation.194 ///195 /// @dev After setting the sponsor for the collection, it must be confirmed with this function.196 /// @dev EVM selector for this function is: 0x3c50e97a,197 /// or in textual repr: confirmCollectionSponsorship()198 function confirmCollectionSponsorship() external;199200 /// Remove collection sponsor.201 /// @dev EVM selector for this function is: 0x6e0326a3,202 /// or in textual repr: removeCollectionSponsor()203 function removeCollectionSponsor() external;204205 /// Get current sponsor.206 ///207 /// @return Tuble with sponsor address and his substrate mirror. If there is no confirmed sponsor error "Contract has no sponsor" throw.208 /// @dev EVM selector for this function is: 0x6ec0a9f1,209 /// or in textual repr: collectionSponsor()210 function collectionSponsor() external view returns (CrossAddress memory);211212 /// Get current collection limits.213 ///214 /// @return Array of collection limits215 /// @dev EVM selector for this function is: 0xf63bc572,216 /// or in textual repr: collectionLimits()217 function collectionLimits() external view returns (CollectionLimit[] memory);218219 /// Set limits for the collection.220 /// @dev Throws error if limit not found.221 /// @param limit Some limit.222 /// @dev EVM selector for this function is: 0x2316ee74,223 /// or in textual repr: setCollectionLimit((uint8,(bool,uint256)))224 function setCollectionLimit(CollectionLimit memory limit) external;225226 /// Get contract address.227 /// @dev EVM selector for this function is: 0xf6b4dfb4,228 /// or in textual repr: contractAddress()229 function contractAddress() external view returns (address);230231 /// Add collection admin.232 /// @param newAdmin Cross account administrator address.233 /// @dev EVM selector for this function is: 0x859aa7d6,234 /// or in textual repr: addCollectionAdminCross((address,uint256))235 function addCollectionAdminCross(CrossAddress memory newAdmin) external;236237 /// Remove collection admin.238 /// @param admin Cross account administrator address.239 /// @dev EVM selector for this function is: 0x6c0cd173,240 /// or in textual repr: removeCollectionAdminCross((address,uint256))241 function removeCollectionAdminCross(CrossAddress memory admin) external;242243 // /// Add collection admin.244 // /// @param newAdmin Address of the added administrator.245 // /// @dev EVM selector for this function is: 0x92e462c7,246 // /// or in textual repr: addCollectionAdmin(address)247 // function addCollectionAdmin(address newAdmin) external;248249 // /// Remove collection admin.250 // ///251 // /// @param admin Address of the removed administrator.252 // /// @dev EVM selector for this function is: 0xfafd7b42,253 // /// or in textual repr: removeCollectionAdmin(address)254 // function removeCollectionAdmin(address admin) external;255256 /// Toggle accessibility of collection nesting.257 ///258 /// @param enable If "true" degenerates to nesting: 'Owner' else to nesting: 'Disabled'259 /// @dev EVM selector for this function is: 0x112d4586,260 /// or in textual repr: setCollectionNesting(bool)261 function setCollectionNesting(bool enable) external;262263 /// Toggle accessibility of collection nesting.264 ///265 /// @param enable If "true" degenerates to nesting: {OwnerRestricted: [1, 2, 3]} else to nesting: 'Disabled'266 /// @param collections Addresses of collections that will be available for nesting.267 /// @dev EVM selector for this function is: 0x64872396,268 /// or in textual repr: setCollectionNesting(bool,address[])269 function setCollectionNesting(bool enable, address[] memory collections) external;270271 /// Returns nesting for a collection272 /// @dev EVM selector for this function is: 0x22d25bfe,273 /// or in textual repr: collectionNestingRestrictedCollectionIds()274 function collectionNestingRestrictedCollectionIds() external view returns (CollectionNesting memory);275276 /// Returns permissions for a collection277 /// @dev EVM selector for this function is: 0x5b2eaf4b,278 /// or in textual repr: collectionNestingPermissions()279 function collectionNestingPermissions() external view returns (CollectionNestingPermission[] memory);280281 /// Set the collection access method.282 /// @param mode Access mode283 /// @dev EVM selector for this function is: 0x41835d4c,284 /// or in textual repr: setCollectionAccess(uint8)285 function setCollectionAccess(AccessMode mode) external;286287 /// Checks that user allowed to operate with collection.288 ///289 /// @param user User address to check.290 /// @dev EVM selector for this function is: 0x91b6df49,291 /// or in textual repr: allowlistedCross((address,uint256))292 function allowlistedCross(CrossAddress memory user) external view returns (bool);293294 // /// Add the user to the allowed list.295 // ///296 // /// @param user Address of a trusted user.297 // /// @dev EVM selector for this function is: 0x67844fe6,298 // /// or in textual repr: addToCollectionAllowList(address)299 // function addToCollectionAllowList(address user) external;300301 /// Add user to allowed list.302 ///303 /// @param user User cross account address.304 /// @dev EVM selector for this function is: 0xa0184a3a,305 /// or in textual repr: addToCollectionAllowListCross((address,uint256))306 function addToCollectionAllowListCross(CrossAddress memory user) external;307308 // /// Remove the user from the allowed list.309 // ///310 // /// @param user Address of a removed user.311 // /// @dev EVM selector for this function is: 0x85c51acb,312 // /// or in textual repr: removeFromCollectionAllowList(address)313 // function removeFromCollectionAllowList(address user) external;314315 /// Remove user from allowed list.316 ///317 /// @param user User cross account address.318 /// @dev EVM selector for this function is: 0x09ba452a,319 /// or in textual repr: removeFromCollectionAllowListCross((address,uint256))320 function removeFromCollectionAllowListCross(CrossAddress memory user) external;321322 /// Switch permission for minting.323 ///324 /// @param mode Enable if "true".325 /// @dev EVM selector for this function is: 0x00018e84,326 /// or in textual repr: setCollectionMintMode(bool)327 function setCollectionMintMode(bool mode) external;328329 // /// Check that account is the owner or admin of the collection330 // ///331 // /// @param user account to verify332 // /// @return "true" if account is the owner or admin333 // /// @dev EVM selector for this function is: 0x9811b0c7,334 // /// or in textual repr: isOwnerOrAdmin(address)335 // function isOwnerOrAdmin(address user) external view returns (bool);336337 /// Check that account is the owner or admin of the collection338 ///339 /// @param user User cross account to verify340 /// @return "true" if account is the owner or admin341 /// @dev EVM selector for this function is: 0x3e75a905,342 /// or in textual repr: isOwnerOrAdminCross((address,uint256))343 function isOwnerOrAdminCross(CrossAddress memory user) external view returns (bool);344345 /// Returns collection type346 ///347 /// @return `Fungible` or `NFT` or `ReFungible`348 /// @dev EVM selector for this function is: 0xd34b55b8,349 /// or in textual repr: uniqueCollectionType()350 function uniqueCollectionType() external view returns (string memory);351352 /// Get collection owner.353 ///354 /// @return Tuble with sponsor address and his substrate mirror.355 /// If address is canonical then substrate mirror is zero and vice versa.356 /// @dev EVM selector for this function is: 0xdf727d3b,357 /// or in textual repr: collectionOwner()358 function collectionOwner() external view returns (CrossAddress memory);359360 // /// Changes collection owner to another account361 // ///362 // /// @dev Owner can be changed only by current owner363 // /// @param newOwner new owner account364 // /// @dev EVM selector for this function is: 0x4f53e226,365 // /// or in textual repr: changeCollectionOwner(address)366 // function changeCollectionOwner(address newOwner) external;367368 /// Get collection administrators369 ///370 /// @return Vector of tuples with admins address and his substrate mirror.371 /// If address is canonical then substrate mirror is zero and vice versa.372 /// @dev EVM selector for this function is: 0x5813216b,373 /// or in textual repr: collectionAdmins()374 function collectionAdmins() external view returns (CrossAddress[] memory);375376 /// Changes collection owner to another account377 ///378 /// @dev Owner can be changed only by current owner379 /// @param newOwner new owner cross account380 /// @dev EVM selector for this function is: 0x6496c497,381 /// or in textual repr: changeCollectionOwnerCross((address,uint256))382 function changeCollectionOwnerCross(CrossAddress memory newOwner) external;383}384385/// Cross account struct386struct CrossAddress {387 address eth;388 uint256 sub;389}390391/// Ethereum representation of `AccessMode` (see [`up_data_structs::AccessMode`]).392enum AccessMode {393 /// Access grant for owner and admins. Used as default.394 Normal,395 /// Like a [`Normal`](AccessMode::Normal) but also users in allow list.396 AllowList397}398399/// Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) field.400struct CollectionNestingPermission {401 CollectionPermissionField field;402 bool value;403}404405/// Ethereum representation of `NestingPermissions` (see [`up_data_structs::NestingPermissions`]) fields as an enumeration.406enum CollectionPermissionField {407 /// Owner of token can nest tokens under it.408 TokenOwner,409 /// Admin of token collection can nest tokens under token.410 CollectionAdmin411}412413/// Nested collections.414struct CollectionNesting {415 bool token_owner;416 uint256[] ids;417}418419/// [`CollectionLimits`](up_data_structs::CollectionLimits) field representation for EVM.420struct CollectionLimit {421 CollectionLimitField field;422 OptionUint256 value;423}424425/// Optional value426struct OptionUint256 {427 /// Shows the status of accessibility of value428 bool status;429 /// Actual value if `status` is true430 uint256 value;431}432433/// [`CollectionLimits`](up_data_structs::CollectionLimits) fields representation for EVM.434enum CollectionLimitField {435 /// How many tokens can a user have on one account.436 AccountTokenOwnership,437 /// How many bytes of data are available for sponsorship.438 SponsoredDataSize,439 /// In any case, chain default: [`SponsoringRateLimit::SponsoringDisabled`]440 SponsoredDataRateLimit,441 /// How many tokens can be mined into this collection.442 TokenLimit,443 /// Timeouts for transfer sponsoring.444 SponsorTransferTimeout,445 /// Timeout for sponsoring an approval in passed blocks.446 SponsorApproveTimeout,447 /// Whether the collection owner of the collection can send tokens (which belong to other users).448 OwnerCanTransfer,449 /// Can the collection owner burn other people's tokens.450 OwnerCanDestroy,451 /// Is it possible to send tokens from this collection between users.452 TransferEnabled453}454455/// @title ERC-721 Non-Fungible Token Standard, optional metadata extension456/// @dev See https://eips.ethereum.org/EIPS/eip-721457/// @dev the ERC-165 identifier for this interface is 0x5b5e139f458interface ERC721Metadata is Dummy, ERC165 {459 // /// @notice A descriptive name for a collection of NFTs in this contract460 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`461 // /// @dev EVM selector for this function is: 0x06fdde03,462 // /// or in textual repr: name()463 // function name() external view returns (string memory);464465 // /// @notice An abbreviated name for NFTs in this contract466 // /// @dev real implementation of this function lies in `ERC721UniqueExtensions`467 // /// @dev EVM selector for this function is: 0x95d89b41,468 // /// or in textual repr: symbol()469 // function symbol() external view returns (string memory);470471 /// @notice A distinct Uniform Resource Identifier (URI) for a given asset.472 ///473 /// @dev If the token has a `url` property and it is not empty, it is returned.474 /// 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`.475 /// If the collection property `baseURI` is empty or absent, return "" (empty string)476 /// otherwise, if token property `suffix` present and is non-empty, return concatenation of baseURI and suffix477 /// otherwise, return concatenation of `baseURI` and stringified token id (decimal stringifying, without paddings).478 ///479 /// @return token's const_metadata480 /// @dev EVM selector for this function is: 0xc87b56dd,481 /// or in textual repr: tokenURI(uint256)482 function tokenURI(uint256 tokenId) external view returns (string memory);483}484485/// @title ERC721 Token that can be irreversibly burned (destroyed).486/// @dev the ERC-165 identifier for this interface is 0x42966c68487interface ERC721Burnable is Dummy, ERC165 {488 /// @notice Burns a specific ERC721 token.489 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized490 /// operator of the current owner.491 /// @param tokenId The NFT to approve492 /// @dev EVM selector for this function is: 0x42966c68,493 /// or in textual repr: burn(uint256)494 function burn(uint256 tokenId) external;495}496497/// @title ERC721 minting logic.498/// @dev the ERC-165 identifier for this interface is 0x3fd94ea6499interface ERC721UniqueMintable is Dummy, ERC165 {500 /// @notice Function to mint a token.501 /// @param to The new owner502 /// @return uint256 The id of the newly minted token503 /// @dev EVM selector for this function is: 0x6a627842,504 /// or in textual repr: mint(address)505 function mint(address to) external returns (uint256);506507 // /// @notice Function to mint a token.508 // /// @dev `tokenId` should be obtained with `nextTokenId` method,509 // /// unlike standard, you can't specify it manually510 // /// @param to The new owner511 // /// @param tokenId ID of the minted NFT512 // /// @dev EVM selector for this function is: 0x40c10f19,513 // /// or in textual repr: mint(address,uint256)514 // function mint(address to, uint256 tokenId) external returns (bool);515516 /// @notice Function to mint token with the given tokenUri.517 /// @param to The new owner518 /// @param tokenUri Token URI that would be stored in the NFT properties519 /// @return uint256 The id of the newly minted token520 /// @dev EVM selector for this function is: 0x45c17782,521 /// or in textual repr: mintWithTokenURI(address,string)522 function mintWithTokenURI(address to, string memory tokenUri) external returns (uint256);523 // /// @notice Function to mint token with the given tokenUri.524 // /// @dev `tokenId` should be obtained with `nextTokenId` method,525 // /// unlike standard, you can't specify it manually526 // /// @param to The new owner527 // /// @param tokenId ID of the minted NFT528 // /// @param tokenUri Token URI that would be stored in the NFT properties529 // /// @dev EVM selector for this function is: 0x50bb4e7f,530 // /// or in textual repr: mintWithTokenURI(address,uint256,string)531 // function mintWithTokenURI(address to, uint256 tokenId, string memory tokenUri) external returns (bool);532533}534535/// @title Unique extensions for ERC721.536/// @dev the ERC-165 identifier for this interface is 0x16de3152537interface ERC721UniqueExtensions is Dummy, ERC165 {538 /// @notice A descriptive name for a collection of NFTs in this contract539 /// @dev EVM selector for this function is: 0x06fdde03,540 /// or in textual repr: name()541 function name() external view returns (string memory);542543 /// @notice An abbreviated name for NFTs in this contract544 /// @dev EVM selector for this function is: 0x95d89b41,545 /// or in textual repr: symbol()546 function symbol() external view returns (string memory);547548 /// @notice A description for the collection.549 /// @dev EVM selector for this function is: 0x7284e416,550 /// or in textual repr: description()551 function description() external view returns (string memory);552553 /// Returns the owner (in cross format) of the token.554 ///555 /// @param tokenId Id for the token.556 /// @dev EVM selector for this function is: 0x2b29dace,557 /// or in textual repr: crossOwnerOf(uint256)558 function crossOwnerOf(uint256 tokenId) external view returns (CrossAddress memory);559560 /// Returns the token properties.561 ///562 /// @param tokenId Id for the token.563 /// @param keys Properties keys. Empty keys for all propertyes.564 /// @return Vector of properties key/value pairs.565 /// @dev EVM selector for this function is: 0xe07ede7e,566 /// or in textual repr: properties(uint256,string[])567 function properties(uint256 tokenId, string[] memory keys) external view returns (Property[] memory);568569 /// @notice Set or reaffirm the approved address for an NFT570 /// @dev The zero address indicates there is no approved address.571 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized572 /// operator of the current owner.573 /// @param approved The new substrate address approved NFT controller574 /// @param tokenId The NFT to approve575 /// @dev EVM selector for this function is: 0x0ecd0ab0,576 /// or in textual repr: approveCross((address,uint256),uint256)577 function approveCross(CrossAddress memory approved, uint256 tokenId) external;578579 /// @notice Transfer ownership of an NFT580 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`581 /// is the zero address. Throws if `tokenId` is not a valid NFT.582 /// @param to The new owner583 /// @param tokenId The NFT to transfer584 /// @dev EVM selector for this function is: 0xa9059cbb,585 /// or in textual repr: transfer(address,uint256)586 function transfer(address to, uint256 tokenId) external;587588 /// @notice Transfer ownership of an NFT589 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`590 /// is the zero address. Throws if `tokenId` is not a valid NFT.591 /// @param to The new owner592 /// @param tokenId The NFT to transfer593 /// @dev EVM selector for this function is: 0x2ada85ff,594 /// or in textual repr: transferCross((address,uint256),uint256)595 function transferCross(CrossAddress memory to, uint256 tokenId) external;596597 /// @notice Transfer ownership of an NFT from cross account address to cross account address598 /// @dev Throws unless `msg.sender` is the current owner. Throws if `to`599 /// is the zero address. Throws if `tokenId` is not a valid NFT.600 /// @param from Cross acccount address of current owner601 /// @param to Cross acccount address of new owner602 /// @param tokenId The NFT to transfer603 /// @dev EVM selector for this function is: 0xd5cf430b,604 /// or in textual repr: transferFromCross((address,uint256),(address,uint256),uint256)605 function transferFromCross(606 CrossAddress memory from,607 CrossAddress memory to,608 uint256 tokenId609 ) external;610611 // /// @notice Burns a specific ERC721 token.612 // /// @dev Throws unless `msg.sender` is the current owner or an authorized613 // /// operator for this NFT. Throws if `from` is not the current owner. Throws614 // /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.615 // /// @param from The current owner of the NFT616 // /// @param tokenId The NFT to transfer617 // /// @dev EVM selector for this function is: 0x79cc6790,618 // /// or in textual repr: burnFrom(address,uint256)619 // function burnFrom(address from, uint256 tokenId) external;620621 /// @notice Burns a specific ERC721 token.622 /// @dev Throws unless `msg.sender` is the current owner or an authorized623 /// operator for this NFT. Throws if `from` is not the current owner. Throws624 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.625 /// @param from The current owner of the NFT626 /// @param tokenId The NFT to transfer627 /// @dev EVM selector for this function is: 0xbb2f5a58,628 /// or in textual repr: burnFromCross((address,uint256),uint256)629 function burnFromCross(CrossAddress memory from, uint256 tokenId) external;630631 /// @notice Returns next free NFT ID.632 /// @dev EVM selector for this function is: 0x75794a3c,633 /// or in textual repr: nextTokenId()634 function nextTokenId() external view returns (uint256);635636 // /// @notice Function to mint multiple tokens.637 // /// @dev `tokenIds` should be an array of consecutive numbers and first number638 // /// should be obtained with `nextTokenId` method639 // /// @param to The new owner640 // /// @param tokenIds IDs of the minted NFTs641 // /// @dev EVM selector for this function is: 0x44a9945e,642 // /// or in textual repr: mintBulk(address,uint256[])643 // function mintBulk(address to, uint256[] memory tokenIds) external returns (bool);644645 // /// @notice Function to mint multiple tokens with the given tokenUris.646 // /// @dev `tokenIds` is array of pairs of token ID and token URI. Token IDs should be consecutive647 // /// numbers and first number should be obtained with `nextTokenId` method648 // /// @param to The new owner649 // /// @param tokens array of pairs of token ID and token URI for minted tokens650 // /// @dev EVM selector for this function is: 0x36543006,651 // /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])652 // function mintBulkWithTokenURI(address to, TokenUri[] memory tokens) external returns (bool);653654 /// @notice Function to mint a token.655 /// @param to The new owner crossAccountId656 /// @param properties Properties of minted token657 /// @return uint256 The id of the newly minted token658 /// @dev EVM selector for this function is: 0xb904db03,659 /// or in textual repr: mintCross((address,uint256),(string,bytes)[])660 function mintCross(CrossAddress memory to, Property[] memory properties) external returns (uint256);661662 /// @notice Returns collection helper contract address663 /// @dev EVM selector for this function is: 0x1896cce6,664 /// or in textual repr: collectionHelperAddress()665 function collectionHelperAddress() external view returns (address);666}667668/// Data for creation token with uri.669struct TokenUri {670 /// Id of new token.671 uint256 id;672 /// Uri of new token.673 string uri;674}675676/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension677/// @dev See https://eips.ethereum.org/EIPS/eip-721678/// @dev the ERC-165 identifier for this interface is 0x780e9d63679interface ERC721Enumerable is Dummy, ERC165 {680 /// @notice Enumerate valid NFTs681 /// @param index A counter less than `totalSupply()`682 /// @return The token identifier for the `index`th NFT,683 /// (sort order not specified)684 /// @dev EVM selector for this function is: 0x4f6ccce7,685 /// or in textual repr: tokenByIndex(uint256)686 function tokenByIndex(uint256 index) external view returns (uint256);687688 /// @dev Not implemented689 /// @dev EVM selector for this function is: 0x2f745c59,690 /// or in textual repr: tokenOfOwnerByIndex(address,uint256)691 function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);692693 /// @notice Count NFTs tracked by this contract694 /// @return A count of valid NFTs tracked by this contract, where each one of695 /// them has an assigned and queryable owner not equal to the zero address696 /// @dev EVM selector for this function is: 0x18160ddd,697 /// or in textual repr: totalSupply()698 function totalSupply() external view returns (uint256);699}700701/// @dev inlined interface702interface ERC721Events {703 event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);704 event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);705 event ApprovalForAll(address indexed owner, address indexed operator, bool approved);706}707708/// @title ERC-721 Non-Fungible Token Standard709/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md710/// @dev the ERC-165 identifier for this interface is 0x80ac58cd711interface ERC721 is Dummy, ERC165, ERC721Events {712 /// @notice Count all NFTs assigned to an owner713 /// @dev NFTs assigned to the zero address are considered invalid, and this714 /// function throws for queries about the zero address.715 /// @param owner An address for whom to query the balance716 /// @return The number of NFTs owned by `owner`, possibly zero717 /// @dev EVM selector for this function is: 0x70a08231,718 /// or in textual repr: balanceOf(address)719 function balanceOf(address owner) external view returns (uint256);720721 /// @notice Find the owner of an NFT722 /// @dev NFTs assigned to zero address are considered invalid, and queries723 /// about them do throw.724 /// @param tokenId The identifier for an NFT725 /// @return The address of the owner of the NFT726 /// @dev EVM selector for this function is: 0x6352211e,727 /// or in textual repr: ownerOf(uint256)728 function ownerOf(uint256 tokenId) external view returns (address);729730 /// @dev Not implemented731 /// @dev EVM selector for this function is: 0xb88d4fde,732 /// or in textual repr: safeTransferFrom(address,address,uint256,bytes)733 function safeTransferFrom(734 address from,735 address to,736 uint256 tokenId,737 bytes memory data738 ) external;739740 /// @dev Not implemented741 /// @dev EVM selector for this function is: 0x42842e0e,742 /// or in textual repr: safeTransferFrom(address,address,uint256)743 function safeTransferFrom(744 address from,745 address to,746 uint256 tokenId747 ) external;748749 /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE750 /// TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE751 /// THEY MAY BE PERMANENTLY LOST752 /// @dev Throws unless `msg.sender` is the current owner or an authorized753 /// operator for this NFT. Throws if `from` is not the current owner. Throws754 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.755 /// @param from The current owner of the NFT756 /// @param to The new owner757 /// @param tokenId The NFT to transfer758 /// @dev EVM selector for this function is: 0x23b872dd,759 /// or in textual repr: transferFrom(address,address,uint256)760 function transferFrom(761 address from,762 address to,763 uint256 tokenId764 ) external;765766 /// @notice Set or reaffirm the approved address for an NFT767 /// @dev The zero address indicates there is no approved address.768 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized769 /// operator of the current owner.770 /// @param approved The new approved NFT controller771 /// @param tokenId The NFT to approve772 /// @dev EVM selector for this function is: 0x095ea7b3,773 /// or in textual repr: approve(address,uint256)774 function approve(address approved, uint256 tokenId) external;775776 /// @notice Sets or unsets the approval of a given operator.777 /// The `operator` is allowed to transfer all tokens of the `caller` on their behalf.778 /// @param operator Operator779 /// @param approved Should operator status be granted or revoked?780 /// @dev EVM selector for this function is: 0xa22cb465,781 /// or in textual repr: setApprovalForAll(address,bool)782 function setApprovalForAll(address operator, bool approved) external;783784 /// @dev Not implemented785 /// @dev EVM selector for this function is: 0x081812fc,786 /// or in textual repr: getApproved(uint256)787 function getApproved(uint256 tokenId) external view returns (address);788789 /// @notice Tells whether the given `owner` approves the `operator`.790 /// @dev EVM selector for this function is: 0xe985e9c5,791 /// or in textual repr: isApprovedForAll(address,address)792 function isApprovedForAll(address owner, address operator) external view returns (bool);793}794795interface UniqueNFT is796 Dummy,797 ERC165,798 ERC721,799 ERC721Enumerable,800 ERC721UniqueExtensions,801 ERC721UniqueMintable,802 ERC721Burnable,803 ERC721Metadata,804 Collection,805 TokenProperties806{}tests/src/eth/api/UniqueRefungible.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueRefungible.sol
+++ b/tests/src/eth/api/UniqueRefungible.sol
@@ -12,9 +12,14 @@
function supportsInterface(bytes4 interfaceID) external view returns (bool);
}
+/// @dev inlined interface
+interface ERC721TokenEvent {
+ event TokenChanged(address indexed collectionId, uint256 tokenId);
+}
+
/// @title A contract that allows to set and delete token properties and change token property permissions.
/// @dev the ERC-165 identifier for this interface is 0xde0695c2
-interface TokenProperties is Dummy, ERC165 {
+interface TokenProperties is Dummy, ERC165, ERC721TokenEvent {
// /// @notice Set permissions for token property.
// /// @dev Throws error if `msg.sender` is not admin or owner of the collection.
// /// @param key Property key.
tests/src/eth/events.test.tsdiffbeforeafterboth--- a/tests/src/eth/events.test.ts
+++ b/tests/src/eth/events.test.ts
@@ -29,8 +29,10 @@
});
});
-function clearEvents(ethEvents: NormalizedEvent[], subEvents: IEvent[]) {
- ethEvents.splice(0);
+function clearEvents(ethEvents: NormalizedEvent[] | null, subEvents: IEvent[]) {
+ if (ethEvents !== null) {
+ ethEvents.splice(0);
+ }
subEvents.splice(0);
}
@@ -374,7 +376,6 @@
const owner = await helper.eth.createAccountWithBalance(donor);
const {collectionAddress} = await helper.eth.createCollection(mode, owner, 'A', 'B', 'C');
const collection = await helper.ethNativeContract.collection(collectionAddress, mode, owner);
- const collectionHelper = await helper.ethNativeContract.collectionHelpers(owner);
const result = await collection.methods.mint(owner).send({from: owner});
const tokenId = result.events.Transfer.returnValues.tokenId;
await collection.methods.setTokenPropertyPermissions([
@@ -384,38 +385,31 @@
[TokenPermissionField.CollectionAdmin, true]],
],
]).send({from: owner});
-
- const ethEvents: any = [];
- collectionHelper.events.allEvents((_: any, event: any) => {
- ethEvents.push(event);
- });
const {unsubscribe, collectedEvents: subEvents} = await helper.subscribeEvents([{section: 'common', names: ['TokenPropertySet', 'TokenPropertyDeleted']}]);
{
- await collection.methods.setProperties(tokenId, [{key: 'A', value: [1,2,3]}]).send({from: owner});
+ const result = await collection.methods.setProperties(tokenId, [{key: 'A', value: [1,2,3]}]).send({from: owner});
await helper.wait.newBlocks(1);
- expect(ethEvents).to.containSubset([
- {
- event: 'TokenChanged',
- returnValues: {
- collectionId: collectionAddress,
- },
+ expect(result.events.TokenChanged).to.be.like({
+ event: 'TokenChanged',
+ returnValues: {
+ collectionId: collectionAddress,
+ tokenId: tokenId,
},
- ]);
+ });
expect(subEvents).to.containSubset([{method: 'TokenPropertySet'}]);
- clearEvents(ethEvents, subEvents);
+ clearEvents(null, subEvents);
}
{
- await collection.methods.deleteProperties(tokenId, ['A']).send({from: owner});
+ const result = await collection.methods.deleteProperties(tokenId, ['A']).send({from: owner});
await helper.wait.newBlocks(1);
- expect(ethEvents).to.containSubset([
- {
- event: 'TokenChanged',
- returnValues: {
- collectionId: collectionAddress,
- },
+ expect(result.events.TokenChanged).to.be.like({
+ event: 'TokenChanged',
+ returnValues: {
+ collectionId: collectionAddress,
+ tokenId: tokenId,
},
- ]);
+ });
expect(subEvents).to.containSubset([{method: 'TokenPropertyDeleted'}]);
}
unsubscribe();