difftreelog
Merge pull request #869 from UniqueNetwork/feature/generalize_2_methods
in: master
Feature/generalize_2_methods
34 files changed
Cargo.lockdiffbeforeafterboth--- a/Cargo.lock
+++ b/Cargo.lock
@@ -6361,7 +6361,7 @@
[[package]]
name = "pallet-fungible"
-version = "0.1.9"
+version = "0.1.10"
dependencies = [
"evm-coder",
"frame-benchmarking",
@@ -6774,7 +6774,7 @@
[[package]]
name = "pallet-refungible"
-version = "0.2.12"
+version = "0.2.13"
dependencies = [
"evm-coder",
"frame-benchmarking",
pallets/common/src/eth.rsdiffbeforeafterboth--- a/pallets/common/src/eth.rs
+++ b/pallets/common/src/eth.rs
@@ -18,7 +18,10 @@
use alloc::format;
use sp_std::{vec, vec::Vec};
-use evm_coder::{AbiCoder, types::Address};
+use evm_coder::{
+ AbiCoder,
+ types::{Address, String},
+};
pub use pallet_evm::{Config, account::CrossAccountId};
use sp_core::{H160, U256};
use up_data_structs::CollectionId;
@@ -390,6 +393,16 @@
}
}
+/// Data for creation token with uri.
+#[derive(Debug, AbiCoder)]
+pub struct TokenUri {
+ /// Id of new token.
+ pub id: U256,
+
+ /// Uri of new token.
+ pub uri: String,
+}
+
/// Nested collections.
#[derive(Debug, Default, AbiCoder)]
pub struct CollectionNesting {
pallets/common/src/lib.rsdiffbeforeafterboth--- a/pallets/common/src/lib.rs
+++ b/pallets/common/src/lib.rs
@@ -66,10 +66,11 @@
ensure,
traits::{Imbalance, Get, Currency, WithdrawReasons, ExistenceRequirement},
dispatch::Pays,
- transactional,
+ transactional, fail,
};
use pallet_evm::GasWeightMapping;
use up_data_structs::{
+ AccessMode,
COLLECTION_NUMBER_LIMIT,
Collection,
RpcCollection,
@@ -124,6 +125,8 @@
pub use pallet::*;
use sp_core::H160;
use sp_runtime::{ArithmeticError, DispatchError, DispatchResult};
+
+use crate::erc::CollectionHelpersEvents;
#[cfg(feature = "runtime-benchmarks")]
pub mod benchmarking;
pub mod dispatch;
@@ -1264,6 +1267,133 @@
Ok(())
}
+ /// A batch operation to add, edit or remove properties for a token.
+ /// It sets or removes a token's properties according to
+ /// `properties_updates` contents:
+ /// * sets a property under the <key> with the value provided `(<key>, Some(<value>))`
+ /// * removes a property under the <key> if the value is `None` `(<key>, None)`.
+ ///
+ /// - `nesting_budget`: Limit for searching parents in-depth to check ownership.
+ /// - `is_token_create`: Indicates that method is called during token initialization.
+ /// Allows to bypass ownership check.
+ ///
+ /// All affected properties should have `mutable` permission
+ /// to be **deleted** or to be **set more than once**,
+ /// and the sender should have permission to edit those properties.
+ ///
+ /// This function fires an event for each property change.
+ /// In case of an error, all the changes (including the events) will be reverted
+ /// since the function is transactional.
+ pub fn modify_token_properties(
+ collection: &CollectionHandle<T>,
+ sender: &T::CrossAccountId,
+ token_id: TokenId,
+ properties_updates: impl Iterator<Item = (PropertyKey, Option<PropertyValue>)>,
+ is_token_create: bool,
+ mut stored_properties: Properties,
+ is_token_owner: impl Fn() -> Result<bool, DispatchError>,
+ set_token_properties: impl FnOnce(Properties),
+ ) -> DispatchResult {
+ let is_collection_admin = collection.is_owner_or_admin(sender);
+ let permissions = Self::property_permissions(collection.id);
+
+ let mut token_owner_result = None;
+ let mut is_token_owner = || -> Result<bool, DispatchError> {
+ *token_owner_result.get_or_insert_with(&is_token_owner)
+ };
+
+ for (key, value) in properties_updates {
+ let permission = permissions
+ .get(&key)
+ .cloned()
+ .unwrap_or_else(PropertyPermission::none);
+
+ let is_property_exists = stored_properties.get(&key).is_some();
+
+ match permission {
+ PropertyPermission { mutable: false, .. } if is_property_exists => {
+ return Err(<Error<T>>::NoPermission.into());
+ }
+
+ PropertyPermission {
+ collection_admin,
+ token_owner,
+ ..
+ } => {
+ //TODO: investigate threats during public minting.
+ let is_token_create =
+ is_token_create && (collection_admin || token_owner) && value.is_some();
+ if !(is_token_create
+ || (collection_admin && is_collection_admin)
+ || (token_owner && is_token_owner()?))
+ {
+ fail!(<Error<T>>::NoPermission);
+ }
+ }
+ }
+
+ match value {
+ Some(value) => {
+ stored_properties
+ .try_set(key.clone(), value)
+ .map_err(<Error<T>>::from)?;
+
+ Self::deposit_event(Event::TokenPropertySet(collection.id, token_id, key));
+ }
+ None => {
+ stored_properties.remove(&key).map_err(<Error<T>>::from)?;
+
+ Self::deposit_event(Event::TokenPropertyDeleted(collection.id, token_id, key));
+ }
+ }
+
+ <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()),
+ );
+ }
+
+ set_token_properties(stored_properties);
+
+ Ok(())
+ }
+
+ /// Sets or unsets the approval of a given operator.
+ ///
+ /// The `operator` is allowed to transfer all token pieces of the `owner` on their behalf.
+ /// - `owner`: Token owner
+ /// - `operator`: Operator
+ /// - `approve`: Should operator status be granted or revoked?
+ pub fn set_allowance_for_all(
+ collection: &CollectionHandle<T>,
+ owner: &T::CrossAccountId,
+ operator: &T::CrossAccountId,
+ approve: bool,
+ set_allowance: impl FnOnce(),
+ log: evm_coder::ethereum::Log,
+ ) -> DispatchResult {
+ if collection.permissions.access() == AccessMode::AllowList {
+ collection.check_allowlist(owner)?;
+ collection.check_allowlist(operator)?;
+ }
+
+ Self::ensure_correct_receiver(operator)?;
+
+ set_allowance();
+
+ <PalletEvm<T>>::deposit_log(log);
+ Self::deposit_event(Event::ApprovedForAll(
+ collection.id,
+ owner.clone(),
+ operator.clone(),
+ approve,
+ ));
+ Ok(())
+ }
+
/// Set collection property.
///
/// * `collection` - Collection handler.
pallets/evm-contract-helpers/src/stubs/ContractHelpers.rawdiffbeforeafterbothbinary blob — no preview
pallets/fungible/CHANGELOG.mddiffbeforeafterboth--- a/pallets/fungible/CHANGELOG.md
+++ b/pallets/fungible/CHANGELOG.md
@@ -4,6 +4,12 @@
<!-- bureaucrate goes here -->
+## [0.1.10] - 2023-02-01
+
+### Added
+
+- The functions `allowanceCross` to `ERC20UniqueExtensions` interface.
+
## [0.1.9] - 2022-12-01
### Added
pallets/fungible/Cargo.tomldiffbeforeafterboth--- a/pallets/fungible/Cargo.toml
+++ b/pallets/fungible/Cargo.toml
@@ -2,7 +2,7 @@
edition = "2021"
license = "GPLv3"
name = "pallet-fungible"
-version = "0.1.9"
+version = "0.1.10"
[dependencies]
# Note: `package = "parity-scale-codec"` must be supplied since the `Encode` macro searches for it.
pallets/fungible/src/erc.rsdiffbeforeafterboth--- a/pallets/fungible/src/erc.rs
+++ b/pallets/fungible/src/erc.rs
@@ -19,6 +19,7 @@
extern crate alloc;
use core::char::{REPLACEMENT_CHARACTER, decode_utf16};
use core::convert::TryInto;
+use evm_coder::AbiCoder;
use evm_coder::{
abi::AbiType, ToLog, execution::*, generate_stubgen, solidity, solidity_interface, types::*,
weight,
@@ -27,6 +28,7 @@
use pallet_common::{
CollectionHandle,
erc::{CommonEvmHandler, PrecompileResult, CollectionCall},
+ eth::CrossAddress,
};
use sp_std::vec::Vec;
use pallet_evm::{account::CrossAccountId, PrecompileHandle};
@@ -57,6 +59,12 @@
},
}
+#[derive(AbiCoder, Debug)]
+pub struct AmountForAddress {
+ to: Address,
+ amount: U256,
+}
+
#[solidity_interface(name = ERC20, events(ERC20Events), expect_selector = 0x942e8b22)]
impl<T: Config> FungibleHandle<T> {
fn name(&self) -> Result<String> {
@@ -161,6 +169,17 @@
where
T::AccountId: From<[u8; 32]>,
{
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ fn allowance_cross(&self, owner: CrossAddress, spender: CrossAddress) -> Result<U256> {
+ let owner = owner.into_sub_cross_account::<T>()?;
+ let spender = spender.into_sub_cross_account::<T>()?;
+
+ Ok(<Allowance<T>>::get((self.id, owner, spender)).into())
+ }
+
/// @notice A description for the collection.
fn description(&self) -> Result<String> {
Ok(decode_utf16(self.description.iter().copied())
@@ -169,12 +188,7 @@
}
#[weight(<SelfWeightOf<T>>::create_item())]
- fn mint_cross(
- &mut self,
- caller: Caller,
- to: pallet_common::eth::CrossAddress,
- amount: U256,
- ) -> Result<bool> {
+ fn mint_cross(&mut self, caller: Caller, to: CrossAddress, amount: U256) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
let to = to.into_sub_cross_account::<T>()?;
let amount = amount.try_into().map_err(|_| "amount overflow")?;
@@ -190,7 +204,7 @@
fn approve_cross(
&mut self,
caller: Caller,
- spender: pallet_common::eth::CrossAddress,
+ spender: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
@@ -231,7 +245,7 @@
fn burn_from_cross(
&mut self,
caller: Caller,
- from: pallet_common::eth::CrossAddress,
+ from: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
@@ -249,14 +263,14 @@
/// Mint tokens for multiple accounts.
/// @param amounts array of pairs of account address and amount
#[weight(<SelfWeightOf<T>>::create_multiple_items_ex(amounts.len() as u32))]
- fn mint_bulk(&mut self, caller: Caller, amounts: Vec<(Address, U256)>) -> Result<bool> {
+ fn mint_bulk(&mut self, caller: Caller, amounts: Vec<AmountForAddress>) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
let budget = self
.recorder
.weight_calls_budget(<StructureWeight<T>>::find_parent());
let amounts = amounts
.into_iter()
- .map(|(to, amount)| {
+ .map(|AmountForAddress { to, amount }| {
Ok((
T::CrossAccountId::from_eth(to),
amount.try_into().map_err(|_| "amount overflow")?,
@@ -270,12 +284,7 @@
}
#[weight(<SelfWeightOf<T>>::transfer())]
- fn transfer_cross(
- &mut self,
- caller: Caller,
- to: pallet_common::eth::CrossAddress,
- amount: U256,
- ) -> Result<bool> {
+ fn transfer_cross(&mut self, caller: Caller, to: CrossAddress, amount: U256) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
let to = to.into_sub_cross_account::<T>()?;
let amount = amount.try_into().map_err(|_| "amount overflow")?;
@@ -291,8 +300,8 @@
fn transfer_from_cross(
&mut self,
caller: Caller,
- from: pallet_common::eth::CrossAddress,
- to: pallet_common::eth::CrossAddress,
+ from: CrossAddress,
+ to: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
pallets/fungible/src/lib.rsdiffbeforeafterboth--- a/pallets/fungible/src/lib.rs
+++ b/pallets/fungible/src/lib.rs
@@ -165,8 +165,8 @@
pub type Allowance<T: Config> = StorageNMap<
Key = (
Key<Twox64Concat, CollectionId>,
- Key<Blake2_128, T::CrossAccountId>,
- Key<Blake2_128Concat, T::CrossAccountId>,
+ Key<Blake2_128, T::CrossAccountId>, // Owner
+ Key<Blake2_128Concat, T::CrossAccountId>, // Spender
),
Value = u128,
QueryKind = ValueQuery,
pallets/fungible/src/stubs/UniqueFungible.rawdiffbeforeafterbothbinary blob — no preview
pallets/fungible/src/stubs/UniqueFungible.soldiffbeforeafterboth--- a/pallets/fungible/src/stubs/UniqueFungible.sol
+++ b/pallets/fungible/src/stubs/UniqueFungible.sol
@@ -511,8 +511,22 @@
bytes value;
}
-/// @dev the ERC-165 identifier for this interface is 0x65789571
+/// @dev the ERC-165 identifier for this interface is 0x85d7dea6
contract ERC20UniqueExtensions is Dummy, ERC165 {
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ /// @dev EVM selector for this function is: 0xe0af4bd7,
+ /// or in textual repr: allowanceCross((address,uint256),(address,uint256))
+ function allowanceCross(CrossAddress memory owner, CrossAddress memory spender) public view returns (uint256) {
+ require(false, stub_error);
+ owner;
+ spender;
+ dummy;
+ return 0;
+ }
+
/// @notice A description for the collection.
/// @dev EVM selector for this function is: 0x7284e416,
/// or in textual repr: description()
@@ -576,7 +590,7 @@
/// @param amounts array of pairs of account address and amount
/// @dev EVM selector for this function is: 0x1acf2d55,
/// or in textual repr: mintBulk((address,uint256)[])
- function mintBulk(Tuple9[] memory amounts) public returns (bool) {
+ function mintBulk(AmountForAddress[] memory amounts) public returns (bool) {
require(false, stub_error);
amounts;
dummy = 0;
@@ -618,10 +632,9 @@
}
}
-/// @dev anonymous struct
-struct Tuple9 {
- address field_0;
- uint256 field_1;
+struct AmountForAddress {
+ address to;
+ uint256 amount;
}
/// @dev the ERC-165 identifier for this interface is 0x40c10f19
pallets/nonfungible/src/erc.rsdiffbeforeafterboth--- a/pallets/nonfungible/src/erc.rs
+++ b/pallets/nonfungible/src/erc.rs
@@ -38,7 +38,7 @@
use pallet_common::{
CollectionHandle, CollectionPropertyPermissions, CommonCollectionOperations,
erc::{CommonEvmHandler, PrecompileResult, CollectionCall, static_property::key},
- eth,
+ eth::{self, TokenUri},
};
use pallet_evm::{account::CrossAccountId, PrecompileHandle};
use pallet_evm_coder_substrate::call;
@@ -948,7 +948,7 @@
&mut self,
caller: Caller,
to: Address,
- tokens: Vec<(U256, String)>,
+ tokens: Vec<TokenUri>,
) -> Result<bool> {
let key = key::url();
let caller = T::CrossAccountId::from_eth(caller);
@@ -961,7 +961,7 @@
.weight_calls_budget(<StructureWeight<T>>::find_parent());
let mut data = Vec::with_capacity(tokens.len());
- for (id, token_uri) in tokens {
+ for TokenUri { id, uri } in tokens {
let id: u32 = id.try_into().map_err(|_| "token id overflow")?;
if id != expected_index {
return Err("item id should be next".into());
@@ -972,7 +972,7 @@
properties
.try_push(Property {
key: key.clone(),
- value: token_uri
+ value: uri
.into_bytes()
.try_into()
.map_err(|_| "token uri is too long")?,
pallets/nonfungible/src/lib.rsdiffbeforeafterboth--- a/pallets/nonfungible/src/lib.rs
+++ b/pallets/nonfungible/src/lib.rs
@@ -101,18 +101,18 @@
};
use up_data_structs::{
AccessMode, CollectionId, CollectionFlags, CustomDataLimit, TokenId, CreateCollectionData,
- CreateNftExData, mapping::TokenAddressMapping, budget::Budget, Property, PropertyPermission,
- PropertyKey, PropertyValue, PropertyKeyPermission, Properties, PropertyScope, TrySetProperty,
- TokenChild, AuxPropertyValue, PropertiesPermissionMap,
+ CreateNftExData, mapping::TokenAddressMapping, budget::Budget, Property, PropertyKey,
+ PropertyValue, PropertyKeyPermission, Properties, PropertyScope, TrySetProperty, TokenChild,
+ AuxPropertyValue, PropertiesPermissionMap,
};
use pallet_evm::{account::CrossAccountId, Pallet as PalletEvm};
use pallet_common::{
Error as CommonError, Pallet as PalletCommon, Event as CommonEvent, CollectionHandle,
- eth::collection_id_to_address, erc::CollectionHelpersEvents,
+ eth::collection_id_to_address,
};
use pallet_structure::{Pallet as PalletStructure, Error as StructureError};
use pallet_evm_coder_substrate::{SubstrateRecorder, WithRecorder};
-use sp_core::{H160, Get};
+use sp_core::H160;
use sp_runtime::{ArithmeticError, DispatchError, DispatchResult, TransactionOutcome};
use sp_std::{vec::Vec, vec, collections::btree_map::BTreeMap};
use core::ops::Deref;
@@ -578,10 +578,6 @@
}
/// A batch operation to add, edit or remove properties for a token.
- /// It sets or removes a token's properties according to
- /// `properties_updates` contents:
- /// * sets a property under the <key> with the value provided `(<key>, Some(<value>))`
- /// * removes a property under the <key> if the value is `None` `(<key>, None)`.
///
/// - `nesting_budget`: Limit for searching parents in-depth to check ownership.
/// - `is_token_create`: Indicates that method is called during token initialization.
@@ -603,97 +599,30 @@
is_token_create: bool,
nesting_budget: &dyn Budget,
) -> DispatchResult {
- let mut collection_admin_status = None;
- let mut token_owner_result = None;
-
- let mut is_collection_admin =
- || *collection_admin_status.get_or_insert_with(|| collection.is_owner_or_admin(sender));
+ let is_token_owner = || {
+ let is_owned = <PalletStructure<T>>::check_indirectly_owned(
+ sender.clone(),
+ collection.id,
+ token_id,
+ None,
+ nesting_budget,
+ )?;
- let mut is_token_owner = || {
- *token_owner_result.get_or_insert_with(|| -> Result<bool, DispatchError> {
- let is_owned = <PalletStructure<T>>::check_indirectly_owned(
- sender.clone(),
- collection.id,
- token_id,
- None,
- nesting_budget,
- )?;
-
- Ok(is_owned)
- })
+ Ok(is_owned)
};
-
- let mut stored_properties = <TokenProperties<T>>::get((collection.id, token_id));
- let permissions = <PalletCommon<T>>::property_permissions(collection.id);
-
- for (key, value) in properties_updates {
- let permission = permissions
- .get(&key)
- .cloned()
- .unwrap_or_else(PropertyPermission::none);
-
- let is_property_exists = stored_properties.get(&key).is_some();
-
- match permission {
- PropertyPermission { mutable: false, .. } if is_property_exists => {
- return Err(<CommonError<T>>::NoPermission.into());
- }
-
- PropertyPermission {
- collection_admin,
- token_owner,
- ..
- } => {
- //TODO: investigate threats during public minting.
- if is_token_create && (collection_admin || token_owner) && value.is_some() {
- // Pass
- } else if collection_admin && is_collection_admin() {
- // Pass
- } else if token_owner && is_token_owner()? {
- // Pass
- } else {
- fail!(<CommonError<T>>::NoPermission);
- }
- }
- }
- match value {
- Some(value) => {
- stored_properties
- .try_set(key.clone(), value)
- .map_err(<CommonError<T>>::from)?;
-
- <PalletCommon<T>>::deposit_event(CommonEvent::TokenPropertySet(
- collection.id,
- token_id,
- key,
- ));
- }
- None => {
- stored_properties
- .remove(&key)
- .map_err(<CommonError<T>>::from)?;
-
- <PalletCommon<T>>::deposit_event(CommonEvent::TokenPropertyDeleted(
- collection.id,
- token_id,
- key,
- ));
- }
- }
-
- <PalletEvm<T>>::deposit_log(
- CollectionHelpersEvents::TokenChanged {
- collection_id: collection_id_to_address(collection.id),
- token_id: token_id.into(),
- }
- .to_log(T::ContractAddress::get()),
- );
- }
-
- <TokenProperties<T>>::set((collection.id, token_id), stored_properties);
+ let stored_properties = <TokenProperties<T>>::get((collection.id, token_id));
- Ok(())
+ <PalletCommon<T>>::modify_token_properties(
+ collection,
+ sender,
+ token_id,
+ properties_updates,
+ is_token_create,
+ stored_properties,
+ is_token_owner,
+ |properties| <TokenProperties<T>>::set((collection.id, token_id), properties),
+ )
}
/// Batch operation to add or edit properties for the token
@@ -1418,31 +1347,19 @@
operator: &T::CrossAccountId,
approve: bool,
) -> DispatchResult {
- if collection.permissions.access() == AccessMode::AllowList {
- collection.check_allowlist(owner)?;
- collection.check_allowlist(operator)?;
- }
-
- <PalletCommon<T>>::ensure_correct_receiver(operator)?;
-
- // =========
-
- <CollectionAllowance<T>>::insert((collection.id, owner, operator), approve);
- <PalletEvm<T>>::deposit_log(
+ <PalletCommon<T>>::set_allowance_for_all(
+ collection,
+ owner,
+ operator,
+ approve,
+ || <CollectionAllowance<T>>::insert((collection.id, owner, operator), approve),
ERC721Events::ApprovalForAll {
owner: *owner.as_eth(),
operator: *operator.as_eth(),
approved: approve,
}
.to_log(collection_id_to_address(collection.id)),
- );
- <PalletCommon<T>>::deposit_event(CommonEvent::ApprovedForAll(
- collection.id,
- owner.clone(),
- operator.clone(),
- approve,
- ));
- Ok(())
+ )
}
/// Tells whether the given `owner` approves the `operator`.
pallets/nonfungible/src/stubs/UniqueNFT.rawdiffbeforeafterbothbinary blob — no preview
pallets/nonfungible/src/stubs/UniqueNFT.soldiffbeforeafterboth--- a/pallets/nonfungible/src/stubs/UniqueNFT.sol
+++ b/pallets/nonfungible/src/stubs/UniqueNFT.sol
@@ -949,7 +949,7 @@
// /// @param tokens array of pairs of token ID and token URI for minted tokens
// /// @dev EVM selector for this function is: 0x36543006,
// /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])
- // function mintBulkWithTokenURI(address to, Tuple15[] memory tokens) public returns (bool) {
+ // function mintBulkWithTokenURI(address to, TokenUri[] memory tokens) public returns (bool) {
// require(false, stub_error);
// to;
// tokens;
@@ -981,10 +981,12 @@
}
}
-/// @dev anonymous struct
-struct Tuple15 {
- uint256 field_0;
- string field_1;
+/// Data for creation token with uri.
+struct TokenUri {
+ /// Id of new token.
+ uint256 id;
+ /// Uri of new token.
+ string uri;
}
/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
pallets/refungible/CHANGELOG.mddiffbeforeafterboth--- a/pallets/refungible/CHANGELOG.md
+++ b/pallets/refungible/CHANGELOG.md
@@ -4,6 +4,12 @@
<!-- bureaucrate goes here -->
+## [0.2.13] - 2023-02-01
+
+### Added
+
+- The functions `allowanceCross` to `ERC20UniqueExtensions` interface.
+
## [0.2.12] - 2023-01-20
### Fixed
pallets/refungible/Cargo.tomldiffbeforeafterboth--- a/pallets/refungible/Cargo.toml
+++ b/pallets/refungible/Cargo.toml
@@ -2,7 +2,7 @@
edition = "2021"
license = "GPLv3"
name = "pallet-refungible"
-version = "0.2.12"
+version = "0.2.13"
[dependencies]
# Note: `package = "parity-scale-codec"` must be supplied since the `Encode` macro searches for it.
pallets/refungible/src/erc.rsdiffbeforeafterboth--- a/pallets/refungible/src/erc.rs
+++ b/pallets/refungible/src/erc.rs
@@ -34,7 +34,7 @@
CollectionHandle, CollectionPropertyPermissions, CommonCollectionOperations,
Error as CommonError,
erc::{CommonEvmHandler, CollectionCall, static_property::key},
- eth,
+ eth::{self, TokenUri},
};
use pallet_evm::{account::CrossAccountId, PrecompileHandle};
use pallet_evm_coder_substrate::{call, dispatch_to_evm};
@@ -999,7 +999,7 @@
&mut self,
caller: Caller,
to: Address,
- tokens: Vec<(U256, String)>,
+ tokens: Vec<TokenUri>,
) -> Result<bool> {
let key = key::url();
let caller = T::CrossAccountId::from_eth(caller);
@@ -1017,7 +1017,7 @@
.collect::<BTreeMap<_, _>>()
.try_into()
.unwrap();
- for (id, token_uri) in tokens {
+ for TokenUri { id, uri } in tokens {
let id: u32 = id.try_into().map_err(|_| "token id overflow")?;
if id != expected_index {
return Err("item id should be next".into());
@@ -1028,7 +1028,7 @@
properties
.try_push(Property {
key: key.clone(),
- value: token_uri
+ value: uri
.into_bytes()
.try_into()
.map_err(|_| "token uri is too long")?,
pallets/refungible/src/erc_token.rsdiffbeforeafterboth--- a/pallets/refungible/src/erc_token.rs
+++ b/pallets/refungible/src/erc_token.rs
@@ -31,7 +31,7 @@
use pallet_common::{
CommonWeightInfo,
erc::{CommonEvmHandler, PrecompileResult},
- eth::collection_id_to_address,
+ eth::{collection_id_to_address, CrossAddress},
};
use pallet_evm::{account::CrossAccountId, PrecompileHandle};
use pallet_evm_coder_substrate::{call, dispatch_to_evm, WithRecorder};
@@ -203,6 +203,17 @@
where
T::AccountId: From<[u8; 32]>,
{
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ fn allowance_cross(&self, owner: CrossAddress, spender: CrossAddress) -> Result<U256> {
+ let owner = owner.into_sub_cross_account::<T>()?;
+ let spender = spender.into_sub_cross_account::<T>()?;
+
+ Ok(<Allowance<T>>::get((self.id, self.1, owner, spender)).into())
+ }
+
/// @dev Function that burns an amount of the token of a given account,
/// deducting from the sender's allowance for said account.
/// @param from The account whose tokens will be burnt.
@@ -230,7 +241,7 @@
fn burn_from_cross(
&mut self,
caller: Caller,
- from: pallet_common::eth::CrossAddress,
+ from: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
@@ -256,7 +267,7 @@
fn approve_cross(
&mut self,
caller: Caller,
- spender: pallet_common::eth::CrossAddress,
+ spender: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
@@ -283,12 +294,7 @@
/// @param to The crossaccount to transfer to.
/// @param amount The amount to be transferred.
#[weight(<CommonWeights<T>>::transfer())]
- fn transfer_cross(
- &mut self,
- caller: Caller,
- to: pallet_common::eth::CrossAddress,
- amount: U256,
- ) -> Result<bool> {
+ fn transfer_cross(&mut self, caller: Caller, to: CrossAddress, amount: U256) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
let to = to.into_sub_cross_account::<T>()?;
let amount = amount.try_into().map_err(|_| "amount overflow")?;
@@ -309,8 +315,8 @@
fn transfer_from_cross(
&mut self,
caller: Caller,
- from: pallet_common::eth::CrossAddress,
- to: pallet_common::eth::CrossAddress,
+ from: CrossAddress,
+ to: CrossAddress,
amount: U256,
) -> Result<bool> {
let caller = T::CrossAccountId::from_eth(caller);
pallets/refungible/src/lib.rsdiffbeforeafterboth--- a/pallets/refungible/src/lib.rs
+++ b/pallets/refungible/src/lib.rs
@@ -92,22 +92,22 @@
use core::ops::Deref;
use evm_coder::ToLog;
-use frame_support::{ensure, fail, storage::with_transaction, transactional};
+use frame_support::{ensure, storage::with_transaction, transactional};
use pallet_evm::{account::CrossAccountId, Pallet as PalletEvm};
use pallet_evm_coder_substrate::WithRecorder;
use pallet_common::{
CommonCollectionOperations, Error as CommonError, eth::collection_id_to_address,
- Event as CommonEvent, Pallet as PalletCommon, erc::CollectionHelpersEvents,
+ Event as CommonEvent, Pallet as PalletCommon,
};
use pallet_structure::Pallet as PalletStructure;
-use sp_core::{Get, H160};
+use sp_core::H160;
use sp_runtime::{ArithmeticError, DispatchError, DispatchResult, TransactionOutcome};
use sp_std::{vec::Vec, vec, collections::btree_map::BTreeMap};
use up_data_structs::{
AccessMode, budget::Budget, CollectionId, CollectionFlags, CreateCollectionData,
mapping::TokenAddressMapping, MAX_REFUNGIBLE_PIECES, Property, PropertyKey,
- PropertyKeyPermission, PropertyPermission, PropertyScope, PropertyValue, TokenId,
- TrySetProperty, PropertiesPermissionMap, CreateRefungibleExMultipleOwners, TokenOwnerError,
+ PropertyKeyPermission, PropertyScope, PropertyValue, TokenId, TrySetProperty,
+ PropertiesPermissionMap, CreateRefungibleExMultipleOwners, TokenOwnerError,
};
pub use pallet::*;
@@ -240,13 +240,13 @@
QueryKind = ValueQuery,
>;
- /// Operator set by a wallet owner that could perform certain transactions on all tokens in the wallet.
+ /// Spender set by a wallet owner that could perform certain transactions on all tokens in the wallet.
#[pallet::storage]
pub type CollectionAllowance<T: Config> = StorageNMap<
Key = (
Key<Twox64Concat, CollectionId>,
- Key<Blake2_128Concat, T::CrossAccountId>,
- Key<Blake2_128Concat, T::CrossAccountId>,
+ Key<Blake2_128Concat, T::CrossAccountId>, // Owner
+ Key<Blake2_128Concat, T::CrossAccountId>, // Spender
),
Value = bool,
QueryKind = ValueQuery,
@@ -541,7 +541,6 @@
is_token_create: bool,
nesting_budget: &dyn Budget,
) -> DispatchResult {
- let is_collection_admin = || collection.is_owner_or_admin(sender);
let is_token_owner = || -> Result<bool, DispatchError> {
let balance = collection.balance(sender.clone(), token_id);
let total_pieces: u128 =
@@ -560,77 +559,19 @@
Ok(is_bundle_owner)
};
-
- let mut stored_properties = <TokenProperties<T>>::get((collection.id, token_id));
- let permissions = <PalletCommon<T>>::property_permissions(collection.id);
-
- for (key, value) in properties_updates {
- let permission = permissions
- .get(&key)
- .cloned()
- .unwrap_or_else(PropertyPermission::none);
-
- let is_property_exists = stored_properties.get(&key).is_some();
-
- match permission {
- PropertyPermission { mutable: false, .. } if is_property_exists => {
- return Err(<CommonError<T>>::NoPermission.into());
- }
- PropertyPermission {
- collection_admin,
- token_owner,
- ..
- } => {
- //TODO: investigate threats during public minting.
- let is_token_create =
- is_token_create && (collection_admin || token_owner) && value.is_some();
- if !(is_token_create
- || (collection_admin && is_collection_admin())
- || (token_owner && is_token_owner()?))
- {
- fail!(<CommonError<T>>::NoPermission);
- }
- }
- }
-
- match value {
- Some(value) => {
- stored_properties
- .try_set(key.clone(), value)
- .map_err(<CommonError<T>>::from)?;
-
- <PalletCommon<T>>::deposit_event(CommonEvent::TokenPropertySet(
- collection.id,
- token_id,
- key,
- ));
- }
- None => {
- stored_properties
- .remove(&key)
- .map_err(<CommonError<T>>::from)?;
-
- <PalletCommon<T>>::deposit_event(CommonEvent::TokenPropertyDeleted(
- collection.id,
- token_id,
- key,
- ));
- }
- }
-
- <PalletEvm<T>>::deposit_log(
- CollectionHelpersEvents::TokenChanged {
- collection_id: collection_id_to_address(collection.id),
- token_id: token_id.into(),
- }
- .to_log(T::ContractAddress::get()),
- );
- }
+ let stored_properties = <TokenProperties<T>>::get((collection.id, token_id));
- <TokenProperties<T>>::set((collection.id, token_id), stored_properties);
-
- Ok(())
+ <PalletCommon<T>>::modify_token_properties(
+ collection,
+ sender,
+ token_id,
+ properties_updates,
+ is_token_create,
+ stored_properties,
+ is_token_owner,
+ |properties| <TokenProperties<T>>::set((collection.id, token_id), properties),
+ )
}
pub fn set_token_properties(
@@ -1462,43 +1403,31 @@
pub fn set_allowance_for_all(
collection: &RefungibleHandle<T>,
owner: &T::CrossAccountId,
- operator: &T::CrossAccountId,
+ spender: &T::CrossAccountId,
approve: bool,
) -> DispatchResult {
- if collection.permissions.access() == AccessMode::AllowList {
- collection.check_allowlist(owner)?;
- collection.check_allowlist(operator)?;
- }
-
- <PalletCommon<T>>::ensure_correct_receiver(operator)?;
-
- // =========
-
- <CollectionAllowance<T>>::insert((collection.id, owner, operator), approve);
- <PalletEvm<T>>::deposit_log(
+ <PalletCommon<T>>::set_allowance_for_all(
+ collection,
+ owner,
+ spender,
+ approve,
+ || <CollectionAllowance<T>>::insert((collection.id, owner, spender), approve),
ERC721Events::ApprovalForAll {
owner: *owner.as_eth(),
- operator: *operator.as_eth(),
+ operator: *spender.as_eth(),
approved: approve,
}
.to_log(collection_id_to_address(collection.id)),
- );
- <PalletCommon<T>>::deposit_event(CommonEvent::ApprovedForAll(
- collection.id,
- owner.clone(),
- operator.clone(),
- approve,
- ));
- Ok(())
+ )
}
/// Tells whether the given `owner` approves the `operator`.
pub fn allowance_for_all(
collection: &RefungibleHandle<T>,
owner: &T::CrossAccountId,
- operator: &T::CrossAccountId,
+ spender: &T::CrossAccountId,
) -> bool {
- <CollectionAllowance<T>>::get((collection.id, owner, operator))
+ <CollectionAllowance<T>>::get((collection.id, owner, spender))
}
pub fn repair_item(collection: &RefungibleHandle<T>, token: TokenId) -> DispatchResult {
pallets/refungible/src/stubs/UniqueRefungible.rawdiffbeforeafterbothbinary blob — no preview
pallets/refungible/src/stubs/UniqueRefungible.soldiffbeforeafterboth--- a/pallets/refungible/src/stubs/UniqueRefungible.sol
+++ b/pallets/refungible/src/stubs/UniqueRefungible.sol
@@ -938,7 +938,7 @@
// /// @param tokens array of pairs of token ID and token URI for minted tokens
// /// @dev EVM selector for this function is: 0x36543006,
// /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])
- // function mintBulkWithTokenURI(address to, Tuple14[] memory tokens) public returns (bool) {
+ // function mintBulkWithTokenURI(address to, TokenUri[] memory tokens) public returns (bool) {
// require(false, stub_error);
// to;
// tokens;
@@ -982,10 +982,12 @@
}
}
-/// @dev anonymous struct
-struct Tuple14 {
- uint256 field_0;
- string field_1;
+/// Data for creation token with uri.
+struct TokenUri {
+ /// Id of new token.
+ uint256 id;
+ /// Uri of new token.
+ string uri;
}
/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
pallets/refungible/src/stubs/UniqueRefungibleToken.rawdiffbeforeafterbothbinary blob — no preview
pallets/refungible/src/stubs/UniqueRefungibleToken.soldiffbeforeafterboth--- a/pallets/refungible/src/stubs/UniqueRefungibleToken.sol
+++ b/pallets/refungible/src/stubs/UniqueRefungibleToken.sol
@@ -36,8 +36,22 @@
}
}
-/// @dev the ERC-165 identifier for this interface is 0xe17a7d2b
+/// @dev the ERC-165 identifier for this interface is 0x01d536fc
contract ERC20UniqueExtensions is Dummy, ERC165 {
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ /// @dev EVM selector for this function is: 0xe0af4bd7,
+ /// or in textual repr: allowanceCross((address,uint256),(address,uint256))
+ function allowanceCross(CrossAddress memory owner, CrossAddress memory spender) public view returns (uint256) {
+ require(false, stub_error);
+ owner;
+ spender;
+ dummy;
+ return 0;
+ }
+
// /// @dev Function that burns an amount of the token of a given account,
// /// deducting from the sender's allowance for said account.
// /// @param from The account whose tokens will be burnt.
pallets/unique/src/eth/stubs/CollectionHelpers.rawdiffbeforeafterbothbinary blob — no preview
runtime/common/ethereum/sponsoring/refungible.rsdiffbeforeafterboth--- a/runtime/common/ethereum/sponsoring/refungible.rs
+++ b/runtime/common/ethereum/sponsoring/refungible.rs
@@ -341,7 +341,9 @@
ERC165Call(_, _) => None,
// Not sponsored
- BurnFrom { .. } | BurnFromCross { .. } | Repartition { .. } => None,
+ AllowanceCross { .. } | BurnFrom { .. } | BurnFromCross { .. } | Repartition { .. } => {
+ None
+ }
TransferCross { .. } | TransferFromCross { .. } => {
let RefungibleTokenHandle(handle, token_id) = token;
tests/src/eth/abi/fungible.jsondiffbeforeafterboth--- a/tests/src/eth/abi/fungible.json
+++ b/tests/src/eth/abi/fungible.json
@@ -101,6 +101,32 @@
{ "internalType": "uint256", "name": "sub", "type": "uint256" }
],
"internalType": "struct CrossAddress",
+ "name": "owner",
+ "type": "tuple"
+ },
+ {
+ "components": [
+ { "internalType": "address", "name": "eth", "type": "address" },
+ { "internalType": "uint256", "name": "sub", "type": "uint256" }
+ ],
+ "internalType": "struct CrossAddress",
+ "name": "spender",
+ "type": "tuple"
+ }
+ ],
+ "name": "allowanceCross",
+ "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }],
+ "stateMutability": "view",
+ "type": "function"
+ },
+ {
+ "inputs": [
+ {
+ "components": [
+ { "internalType": "address", "name": "eth", "type": "address" },
+ { "internalType": "uint256", "name": "sub", "type": "uint256" }
+ ],
+ "internalType": "struct CrossAddress",
"name": "user",
"type": "tuple"
}
@@ -408,10 +434,10 @@
"inputs": [
{
"components": [
- { "internalType": "address", "name": "field_0", "type": "address" },
- { "internalType": "uint256", "name": "field_1", "type": "uint256" }
+ { "internalType": "address", "name": "to", "type": "address" },
+ { "internalType": "uint256", "name": "amount", "type": "uint256" }
],
- "internalType": "struct Tuple9[]",
+ "internalType": "struct AmountForAddress[]",
"name": "amounts",
"type": "tuple[]"
}
tests/src/eth/abi/reFungibleToken.jsondiffbeforeafterboth--- a/tests/src/eth/abi/reFungibleToken.json
+++ b/tests/src/eth/abi/reFungibleToken.json
@@ -61,6 +61,32 @@
},
{
"inputs": [
+ {
+ "components": [
+ { "internalType": "address", "name": "eth", "type": "address" },
+ { "internalType": "uint256", "name": "sub", "type": "uint256" }
+ ],
+ "internalType": "struct CrossAddress",
+ "name": "owner",
+ "type": "tuple"
+ },
+ {
+ "components": [
+ { "internalType": "address", "name": "eth", "type": "address" },
+ { "internalType": "uint256", "name": "sub", "type": "uint256" }
+ ],
+ "internalType": "struct CrossAddress",
+ "name": "spender",
+ "type": "tuple"
+ }
+ ],
+ "name": "allowanceCross",
+ "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }],
+ "stateMutability": "view",
+ "type": "function"
+ },
+ {
+ "inputs": [
{ "internalType": "address", "name": "spender", "type": "address" },
{ "internalType": "uint256", "name": "amount", "type": "uint256" }
],
tests/src/eth/api/UniqueFungible.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueFungible.sol
+++ b/tests/src/eth/api/UniqueFungible.sol
@@ -353,8 +353,16 @@
bytes value;
}
-/// @dev the ERC-165 identifier for this interface is 0x65789571
+/// @dev the ERC-165 identifier for this interface is 0x85d7dea6
interface ERC20UniqueExtensions is Dummy, ERC165 {
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ /// @dev EVM selector for this function is: 0xe0af4bd7,
+ /// or in textual repr: allowanceCross((address,uint256),(address,uint256))
+ function allowanceCross(CrossAddress memory owner, CrossAddress memory spender) external view returns (uint256);
+
/// @notice A description for the collection.
/// @dev EVM selector for this function is: 0x7284e416,
/// or in textual repr: description()
@@ -390,7 +398,7 @@
/// @param amounts array of pairs of account address and amount
/// @dev EVM selector for this function is: 0x1acf2d55,
/// or in textual repr: mintBulk((address,uint256)[])
- function mintBulk(Tuple9[] memory amounts) external returns (bool);
+ function mintBulk(AmountForAddress[] memory amounts) external returns (bool);
/// @dev EVM selector for this function is: 0x2ada85ff,
/// or in textual repr: transferCross((address,uint256),uint256)
@@ -410,10 +418,9 @@
function collectionHelperAddress() external view returns (address);
}
-/// @dev anonymous struct
-struct Tuple9 {
- address field_0;
- uint256 field_1;
+struct AmountForAddress {
+ address to;
+ uint256 amount;
}
/// @dev the ERC-165 identifier for this interface is 0x40c10f19
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, Tuple13[] 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/// @dev anonymous struct664struct Tuple13 {665 uint256 field_0;666 string field_1;667}668669/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension670/// @dev See https://eips.ethereum.org/EIPS/eip-721671/// @dev the ERC-165 identifier for this interface is 0x780e9d63672interface ERC721Enumerable is Dummy, ERC165 {673 /// @notice Enumerate valid NFTs674 /// @param index A counter less than `totalSupply()`675 /// @return The token identifier for the `index`th NFT,676 /// (sort order not specified)677 /// @dev EVM selector for this function is: 0x4f6ccce7,678 /// or in textual repr: tokenByIndex(uint256)679 function tokenByIndex(uint256 index) external view returns (uint256);680681 /// @dev Not implemented682 /// @dev EVM selector for this function is: 0x2f745c59,683 /// or in textual repr: tokenOfOwnerByIndex(address,uint256)684 function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);685686 /// @notice Count NFTs tracked by this contract687 /// @return A count of valid NFTs tracked by this contract, where each one of688 /// them has an assigned and queryable owner not equal to the zero address689 /// @dev EVM selector for this function is: 0x18160ddd,690 /// or in textual repr: totalSupply()691 function totalSupply() external view returns (uint256);692}693694/// @dev inlined interface695interface ERC721Events {696 event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);697 event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);698 event ApprovalForAll(address indexed owner, address indexed operator, bool approved);699}700701/// @title ERC-721 Non-Fungible Token Standard702/// @dev See https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md703/// @dev the ERC-165 identifier for this interface is 0x80ac58cd704interface ERC721 is Dummy, ERC165, ERC721Events {705 /// @notice Count all NFTs assigned to an owner706 /// @dev NFTs assigned to the zero address are considered invalid, and this707 /// function throws for queries about the zero address.708 /// @param owner An address for whom to query the balance709 /// @return The number of NFTs owned by `owner`, possibly zero710 /// @dev EVM selector for this function is: 0x70a08231,711 /// or in textual repr: balanceOf(address)712 function balanceOf(address owner) external view returns (uint256);713714 /// @notice Find the owner of an NFT715 /// @dev NFTs assigned to zero address are considered invalid, and queries716 /// about them do throw.717 /// @param tokenId The identifier for an NFT718 /// @return The address of the owner of the NFT719 /// @dev EVM selector for this function is: 0x6352211e,720 /// or in textual repr: ownerOf(uint256)721 function ownerOf(uint256 tokenId) external view returns (address);722723 /// @dev Not implemented724 /// @dev EVM selector for this function is: 0xb88d4fde,725 /// or in textual repr: safeTransferFrom(address,address,uint256,bytes)726 function safeTransferFrom(727 address from,728 address to,729 uint256 tokenId,730 bytes memory data731 ) external;732733 /// @dev Not implemented734 /// @dev EVM selector for this function is: 0x42842e0e,735 /// or in textual repr: safeTransferFrom(address,address,uint256)736 function safeTransferFrom(737 address from,738 address to,739 uint256 tokenId740 ) external;741742 /// @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE743 /// TO CONFIRM THAT `to` IS CAPABLE OF RECEIVING NFTS OR ELSE744 /// THEY MAY BE PERMANENTLY LOST745 /// @dev Throws unless `msg.sender` is the current owner or an authorized746 /// operator for this NFT. Throws if `from` is not the current owner. Throws747 /// if `to` is the zero address. Throws if `tokenId` is not a valid NFT.748 /// @param from The current owner of the NFT749 /// @param to The new owner750 /// @param tokenId The NFT to transfer751 /// @dev EVM selector for this function is: 0x23b872dd,752 /// or in textual repr: transferFrom(address,address,uint256)753 function transferFrom(754 address from,755 address to,756 uint256 tokenId757 ) external;758759 /// @notice Set or reaffirm the approved address for an NFT760 /// @dev The zero address indicates there is no approved address.761 /// @dev Throws unless `msg.sender` is the current NFT owner, or an authorized762 /// operator of the current owner.763 /// @param approved The new approved NFT controller764 /// @param tokenId The NFT to approve765 /// @dev EVM selector for this function is: 0x095ea7b3,766 /// or in textual repr: approve(address,uint256)767 function approve(address approved, uint256 tokenId) external;768769 /// @notice Sets or unsets the approval of a given operator.770 /// The `operator` is allowed to transfer all tokens of the `caller` on their behalf.771 /// @param operator Operator772 /// @param approved Should operator status be granted or revoked?773 /// @dev EVM selector for this function is: 0xa22cb465,774 /// or in textual repr: setApprovalForAll(address,bool)775 function setApprovalForAll(address operator, bool approved) external;776777 /// @dev Not implemented778 /// @dev EVM selector for this function is: 0x081812fc,779 /// or in textual repr: getApproved(uint256)780 function getApproved(uint256 tokenId) external view returns (address);781782 /// @notice Tells whether the given `owner` approves the `operator`.783 /// @dev EVM selector for this function is: 0xe985e9c5,784 /// or in textual repr: isApprovedForAll(address,address)785 function isApprovedForAll(address owner, address operator) external view returns (bool);786}787788interface UniqueNFT is789 Dummy,790 ERC165,791 ERC721,792 ERC721Enumerable,793 ERC721UniqueExtensions,794 ERC721UniqueMintable,795 ERC721Burnable,796 ERC721Metadata,797 Collection,798 TokenProperties799{}1// SPDX-License-Identifier: OTHER2// This code is automatically generated34pragma solidity >=0.8.0 <0.9.0;56/// @dev common stubs holder7interface Dummy {89}1011interface ERC165 is Dummy {12 function supportsInterface(bytes4 interfaceID) external view returns (bool);13}1415/// @title A contract that allows to set and delete token properties and change token property permissions.16/// @dev the ERC-165 identifier for this interface is 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{}tests/src/eth/api/UniqueRefungible.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueRefungible.sol
+++ b/tests/src/eth/api/UniqueRefungible.sol
@@ -638,7 +638,7 @@
// /// @param tokens array of pairs of token ID and token URI for minted tokens
// /// @dev EVM selector for this function is: 0x36543006,
// /// or in textual repr: mintBulkWithTokenURI(address,(uint256,string)[])
- // function mintBulkWithTokenURI(address to, Tuple12[] memory tokens) external returns (bool);
+ // function mintBulkWithTokenURI(address to, TokenUri[] memory tokens) external returns (bool);
/// @notice Function to mint a token.
/// @param to The new owner crossAccountId
@@ -661,10 +661,12 @@
function collectionHelperAddress() external view returns (address);
}
-/// @dev anonymous struct
-struct Tuple12 {
- uint256 field_0;
- string field_1;
+/// Data for creation token with uri.
+struct TokenUri {
+ /// Id of new token.
+ uint256 id;
+ /// Uri of new token.
+ string uri;
}
/// @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
tests/src/eth/api/UniqueRefungibleToken.soldiffbeforeafterboth--- a/tests/src/eth/api/UniqueRefungibleToken.sol
+++ b/tests/src/eth/api/UniqueRefungibleToken.sol
@@ -23,8 +23,16 @@
function parentTokenId() external view returns (uint256);
}
-/// @dev the ERC-165 identifier for this interface is 0xe17a7d2b
+/// @dev the ERC-165 identifier for this interface is 0x01d536fc
interface ERC20UniqueExtensions is Dummy, ERC165 {
+ /// @dev Function to check the amount of tokens that an owner allowed to a spender.
+ /// @param owner crossAddress The address which owns the funds.
+ /// @param spender crossAddress The address which will spend the funds.
+ /// @return A uint256 specifying the amount of tokens still available for the spender.
+ /// @dev EVM selector for this function is: 0xe0af4bd7,
+ /// or in textual repr: allowanceCross((address,uint256),(address,uint256))
+ function allowanceCross(CrossAddress memory owner, CrossAddress memory spender) external view returns (uint256);
+
// /// @dev Function that burns an amount of the token of a given account,
// /// deducting from the sender's allowance for said account.
// /// @param from The account whose tokens will be burnt.
tests/src/eth/fungible.test.tsdiffbeforeafterboth--- a/tests/src/eth/fungible.test.ts
+++ b/tests/src/eth/fungible.test.ts
@@ -134,6 +134,12 @@
const allowance = await contract.methods.allowance(owner, spender).call();
expect(+allowance).to.equal(100);
}
+ {
+ const ownerCross = helper.ethCrossAccount.fromAddress(owner);
+ const spenderCross = helper.ethCrossAccount.fromAddress(spender);
+ const allowance = await contract.methods.allowanceCross(ownerCross, spenderCross).call();
+ expect(+allowance).to.equal(100);
+ }
});
itEth('Can perform approveCross()', async ({helper}) => {
tests/src/eth/proxy/UniqueNFTProxy.soldiffbeforeafterboth--- a/tests/src/eth/proxy/UniqueNFTProxy.sol
+++ b/tests/src/eth/proxy/UniqueNFTProxy.sol
@@ -168,7 +168,7 @@
return proxied.mintBulk(to, tokenIds);
}
- function mintBulkWithTokenURI(address to, Tuple6[] memory tokens)
+ function mintBulkWithTokenURI(address to, TokenUri[] memory tokens)
external
override
returns (bool)
tests/src/eth/reFungible.test.tsdiffbeforeafterboth--- a/tests/src/eth/reFungible.test.ts
+++ b/tests/src/eth/reFungible.test.ts
@@ -219,8 +219,16 @@
await rftToken.methods.approve(operator, 15n).send({from: owner});
await contract.methods.setApprovalForAll(operator, true).send({from: owner});
await rftToken.methods.burnFrom(owner, 10n).send({from: operator});
+ }
+ {
const allowance = await rftToken.methods.allowance(owner, operator).call();
- expect(allowance).to.be.equal('5');
+ expect(+allowance).to.be.equal(5);
+ }
+ {
+ const ownerCross = helper.ethCrossAccount.fromAddress(owner);
+ const operatorCross = helper.ethCrossAccount.fromAddress(operator);
+ const allowance = await rftToken.methods.allowanceCross(ownerCross, operatorCross).call();
+ expect(+allowance).to.equal(5);
}
});