HDRhunter Contract: HDRC Token
Token Contract
Overview
ETH Balance
0 ETH
Eth Value
$0.00More Info
Private Name Tags
ContractCreator
TokenTracker
Latest 25 from a total of 381 transactions
Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
---|---|---|---|---|---|---|---|---|---|
Mint And List Ed... | 19951206 | 88 days ago | IN | 0 ETH | 0.0005481 | ||||
Mint And List Ed... | 19951181 | 88 days ago | IN | 0 ETH | 0.00050006 | ||||
Mint And List Ed... | 19951160 | 88 days ago | IN | 0 ETH | 0.00055889 | ||||
Mint And List Ed... | 19945165 | 89 days ago | IN | 0 ETH | 0.00059917 | ||||
Mint And List Ed... | 19945134 | 89 days ago | IN | 0 ETH | 0.00060062 | ||||
Mint And List Ed... | 19945106 | 89 days ago | IN | 0 ETH | 0.0005857 | ||||
Mint And List Ed... | 19893184 | 96 days ago | IN | 0 ETH | 0.00055865 | ||||
Mint And List Ed... | 19893160 | 96 days ago | IN | 0 ETH | 0.00055837 | ||||
Mint And List Ed... | 19871511 | 99 days ago | IN | 0 ETH | 0.00062463 | ||||
Mint And List Ed... | 19871493 | 99 days ago | IN | 0 ETH | 0.00067904 | ||||
Mint And List Ed... | 19851245 | 102 days ago | IN | 0 ETH | 0.00065818 | ||||
Mint And List Ed... | 19851222 | 102 days ago | IN | 0 ETH | 0.00061888 | ||||
Mint And List Ed... | 19844385 | 103 days ago | IN | 0 ETH | 0.00069758 | ||||
Mint And List Ed... | 19844356 | 103 days ago | IN | 0 ETH | 0.00073715 | ||||
Mint And List Ed... | 19836573 | 104 days ago | IN | 0 ETH | 0.00060861 | ||||
Mint And List Ed... | 19836548 | 104 days ago | IN | 0 ETH | 0.00062874 | ||||
Mint And List Ed... | 19836523 | 104 days ago | IN | 0 ETH | 0.0006719 | ||||
Mint And List Ed... | 19830260 | 105 days ago | IN | 0 ETH | 0.00066183 | ||||
Mint And List Ed... | 19830208 | 105 days ago | IN | 0 ETH | 0.0006891 | ||||
Mint And List Ed... | 19830175 | 105 days ago | IN | 0 ETH | 0.00062059 | ||||
Mint And List Ed... | 19830108 | 105 days ago | IN | 0 ETH | 0.00060955 | ||||
Mint And List Ed... | 19830074 | 105 days ago | IN | 0 ETH | 0.00060604 | ||||
Mint And List Ed... | 19822010 | 106 days ago | IN | 0 ETH | 0.00073417 | ||||
Mint And List Ed... | 19821995 | 106 days ago | IN | 0 ETH | 0.00075506 | ||||
Mint And List Ed... | 19821979 | 106 days ago | IN | 0 ETH | 0.00072188 |
Latest 25 internal transactions (View All)
Advanced mode:
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
19759739 | 115 days ago | 0.0085 ETH | ||||
19759739 | 115 days ago | 0.0015 ETH | ||||
19736871 | 118 days ago | 0.0085 ETH | ||||
19736871 | 118 days ago | 0.0015 ETH | ||||
19704398 | 122 days ago | 0.0085 ETH | ||||
19704398 | 122 days ago | 0.0015 ETH | ||||
19647403 | 130 days ago | 0.0085 ETH | ||||
19647403 | 130 days ago | 0.0015 ETH | ||||
19270048 | 183 days ago | 0.0085 ETH | ||||
19270048 | 183 days ago | 0.0015 ETH | ||||
19108865 | 206 days ago | 0.0085 ETH | ||||
19108865 | 206 days ago | 0.0015 ETH | ||||
19087315 | 209 days ago | 0.0085 ETH | ||||
19087315 | 209 days ago | 0.0015 ETH | ||||
18883076 | 238 days ago | 0.0085 ETH | ||||
18883076 | 238 days ago | 0.0015 ETH | ||||
18863318 | 240 days ago | 0.00425 ETH | ||||
18863318 | 240 days ago | 0.00075 ETH | ||||
18858379 | 241 days ago | 0.0085 ETH | ||||
18858379 | 241 days ago | 0.0015 ETH | ||||
18858371 | 241 days ago | 0.0085 ETH | ||||
18858371 | 241 days ago | 0.0015 ETH | ||||
18858367 | 241 days ago | 0.0085 ETH | ||||
18858367 | 241 days ago | 0.0015 ETH | ||||
18858360 | 241 days ago | 0.0085 ETH |
Loading...
Loading
Minimal Proxy Contract for 0xfcbba7d799b06cf36f75361cc13ea5d15d9c748a
Contract Name:
ERC721KODACreatorWithBuyItNowAndFilterRegistry
Compiler Version
v0.8.17+commit.8df45f5f
Optimization Enabled:
Yes with 1000 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
pragma solidity 0.8.17; // SPDX-License-Identifier: MIT import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import {ERC721KODACreatorWithBuyItNow} from "./ERC721KODACreatorWithBuyItNow.sol"; import {UpdatableOperatorFiltererUpgradeable} from "../../operator-filter-registry/UpdatableOperatorFiltererUpgradeable.sol"; /// @author KnownOrigin Labs - https://knownorigin.io/ /// @notice ERC721 KODA Creator with Embedded Primary and Secondary Buy It Now Marketplace contract ERC721KODACreatorWithBuyItNowAndFilterRegistry is ERC721KODACreatorWithBuyItNow, UpdatableOperatorFiltererUpgradeable { /// @dev Configure operator registry with init param function __Module_init( address _operatorRegistry, address _subscriptionOrRegistrantToCopy ) internal override { _UpdatableOperatorFilterer_init( _operatorRegistry, _subscriptionOrRegistrantToCopy, _subscriptionOrRegistrantToCopy != address(0) ); } /// @dev Required for solidity compiler due to ownable clashes function owner() public view virtual override(OwnableUpgradeable, UpdatableOperatorFiltererUpgradeable) returns (address) { return super.owner(); } /// @dev Override the before transfer hook so that the operator filter can be checked against the from address function _beforeTokenTransfer( address _from, address _to, uint256 _tokenId ) internal override onlyAllowedOperator(_from) {} }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (access/Ownable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * By default, the owner account will be the one that deploys the contract. This * can later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract OwnableUpgradeable is Initializable, ContextUpgradeable { address private _owner; event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the deployer as the initial owner. */ function __Ownable_init() internal onlyInitializing { __Ownable_init_unchained(); } function __Ownable_init_unchained() internal onlyInitializing { _transferOwnership(_msgSender()); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { require(owner() == _msgSender(), "Ownable: caller is not the owner"); } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions anymore. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby removing any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { require(newOwner != address(0), "Ownable: new owner is the zero address"); _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (interfaces/draft-IERC1822.sol) pragma solidity ^0.8.0; /** * @dev ERC1822: Universal Upgradeable Proxy Standard (UUPS) documents a method for upgradeability through a simplified * proxy whose upgrades are fully controlled by the current implementation. */ interface IERC1822ProxiableUpgradeable { /** * @dev Returns the storage slot that the proxiable contract assumes is being used to store the implementation * address. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. */ function proxiableUUID() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (proxy/beacon/IBeacon.sol) pragma solidity ^0.8.0; /** * @dev This is the interface that {BeaconProxy} expects of its beacon. */ interface IBeaconUpgradeable { /** * @dev Must return an address that can be used as a delegate call target. * * {BeaconProxy} will check that this address is a contract. */ function implementation() external view returns (address); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (proxy/ERC1967/ERC1967Upgrade.sol) pragma solidity ^0.8.2; import "../beacon/IBeaconUpgradeable.sol"; import "../../interfaces/draft-IERC1822Upgradeable.sol"; import "../../utils/AddressUpgradeable.sol"; import "../../utils/StorageSlotUpgradeable.sol"; import "../utils/Initializable.sol"; /** * @dev This abstract contract provides getters and event emitting update functions for * https://eips.ethereum.org/EIPS/eip-1967[EIP1967] slots. * * _Available since v4.1._ * * @custom:oz-upgrades-unsafe-allow delegatecall */ abstract contract ERC1967UpgradeUpgradeable is Initializable { function __ERC1967Upgrade_init() internal onlyInitializing { } function __ERC1967Upgrade_init_unchained() internal onlyInitializing { } // This is the keccak-256 hash of "eip1967.proxy.rollback" subtracted by 1 bytes32 private constant _ROLLBACK_SLOT = 0x4910fdfa16fed3260ed0e7147f7cc6da11a60208b5b9406d12a635614ffd9143; /** * @dev Storage slot with the address of the current implementation. * This is the keccak-256 hash of "eip1967.proxy.implementation" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; /** * @dev Emitted when the implementation is upgraded. */ event Upgraded(address indexed implementation); /** * @dev Returns the current implementation address. */ function _getImplementation() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value; } /** * @dev Stores a new address in the EIP1967 implementation slot. */ function _setImplementation(address newImplementation) private { require(AddressUpgradeable.isContract(newImplementation), "ERC1967: new implementation is not a contract"); StorageSlotUpgradeable.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; } /** * @dev Perform implementation upgrade * * Emits an {Upgraded} event. */ function _upgradeTo(address newImplementation) internal { _setImplementation(newImplementation); emit Upgraded(newImplementation); } /** * @dev Perform implementation upgrade with additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCall( address newImplementation, bytes memory data, bool forceCall ) internal { _upgradeTo(newImplementation); if (data.length > 0 || forceCall) { _functionDelegateCall(newImplementation, data); } } /** * @dev Perform implementation upgrade with security checks for UUPS proxies, and additional setup call. * * Emits an {Upgraded} event. */ function _upgradeToAndCallUUPS( address newImplementation, bytes memory data, bool forceCall ) internal { // Upgrades from old implementations will perform a rollback test. This test requires the new // implementation to upgrade back to the old, non-ERC1822 compliant, implementation. Removing // this special case will break upgrade paths from old UUPS implementation to new ones. if (StorageSlotUpgradeable.getBooleanSlot(_ROLLBACK_SLOT).value) { _setImplementation(newImplementation); } else { try IERC1822ProxiableUpgradeable(newImplementation).proxiableUUID() returns (bytes32 slot) { require(slot == _IMPLEMENTATION_SLOT, "ERC1967Upgrade: unsupported proxiableUUID"); } catch { revert("ERC1967Upgrade: new implementation is not UUPS"); } _upgradeToAndCall(newImplementation, data, forceCall); } } /** * @dev Storage slot with the admin of the contract. * This is the keccak-256 hash of "eip1967.proxy.admin" subtracted by 1, and is * validated in the constructor. */ bytes32 internal constant _ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103; /** * @dev Emitted when the admin account has changed. */ event AdminChanged(address previousAdmin, address newAdmin); /** * @dev Returns the current admin. */ function _getAdmin() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value; } /** * @dev Stores a new address in the EIP1967 admin slot. */ function _setAdmin(address newAdmin) private { require(newAdmin != address(0), "ERC1967: new admin is the zero address"); StorageSlotUpgradeable.getAddressSlot(_ADMIN_SLOT).value = newAdmin; } /** * @dev Changes the admin of the proxy. * * Emits an {AdminChanged} event. */ function _changeAdmin(address newAdmin) internal { emit AdminChanged(_getAdmin(), newAdmin); _setAdmin(newAdmin); } /** * @dev The storage slot of the UpgradeableBeacon contract which defines the implementation for this proxy. * This is bytes32(uint256(keccak256('eip1967.proxy.beacon')) - 1)) and is validated in the constructor. */ bytes32 internal constant _BEACON_SLOT = 0xa3f0ad74e5423aebfd80d3ef4346578335a9a72aeaee59ff6cb3582b35133d50; /** * @dev Emitted when the beacon is upgraded. */ event BeaconUpgraded(address indexed beacon); /** * @dev Returns the current beacon. */ function _getBeacon() internal view returns (address) { return StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value; } /** * @dev Stores a new beacon in the EIP1967 beacon slot. */ function _setBeacon(address newBeacon) private { require(AddressUpgradeable.isContract(newBeacon), "ERC1967: new beacon is not a contract"); require( AddressUpgradeable.isContract(IBeaconUpgradeable(newBeacon).implementation()), "ERC1967: beacon implementation is not a contract" ); StorageSlotUpgradeable.getAddressSlot(_BEACON_SLOT).value = newBeacon; } /** * @dev Perform beacon upgrade with additional setup call. Note: This upgrades the address of the beacon, it does * not upgrade the implementation contained in the beacon (see {UpgradeableBeacon-_setImplementation} for that). * * Emits a {BeaconUpgraded} event. */ function _upgradeBeaconToAndCall( address newBeacon, bytes memory data, bool forceCall ) internal { _setBeacon(newBeacon); emit BeaconUpgraded(newBeacon); if (data.length > 0 || forceCall) { _functionDelegateCall(IBeaconUpgradeable(newBeacon).implementation(), data); } } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a delegate call. * * _Available since v3.4._ */ function _functionDelegateCall(address target, bytes memory data) private returns (bytes memory) { require(AddressUpgradeable.isContract(target), "Address: delegate call to non-contract"); // solhint-disable-next-line avoid-low-level-calls (bool success, bytes memory returndata) = target.delegatecall(data); return AddressUpgradeable.verifyCallResult(success, returndata, "Address: low-level delegate call failed"); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (proxy/utils/Initializable.sol) pragma solidity ^0.8.2; import "../../utils/AddressUpgradeable.sol"; /** * @dev This is a base contract to aid in writing upgradeable contracts, or any kind of contract that will be deployed * behind a proxy. Since proxied contracts do not make use of a constructor, it's common to move constructor logic to an * external initializer function, usually called `initialize`. It then becomes necessary to protect this initializer * function so it can only be called once. The {initializer} modifier provided by this contract will have this effect. * * The initialization functions use a version number. Once a version number is used, it is consumed and cannot be * reused. This mechanism prevents re-execution of each "step" but allows the creation of new initialization steps in * case an upgrade adds a module that needs to be initialized. * * For example: * * [.hljs-theme-light.nopadding] * ``` * contract MyToken is ERC20Upgradeable { * function initialize() initializer public { * __ERC20_init("MyToken", "MTK"); * } * } * contract MyTokenV2 is MyToken, ERC20PermitUpgradeable { * function initializeV2() reinitializer(2) public { * __ERC20Permit_init("MyToken"); * } * } * ``` * * TIP: To avoid leaving the proxy in an uninitialized state, the initializer function should be called as early as * possible by providing the encoded function call as the `_data` argument to {ERC1967Proxy-constructor}. * * CAUTION: When used with inheritance, manual care must be taken to not invoke a parent initializer twice, or to ensure * that all initializers are idempotent. This is not verified automatically as constructors are by Solidity. * * [CAUTION] * ==== * Avoid leaving a contract uninitialized. * * An uninitialized contract can be taken over by an attacker. This applies to both a proxy and its implementation * contract, which may impact the proxy. To prevent the implementation contract from being used, you should invoke * the {_disableInitializers} function in the constructor to automatically lock it when it is deployed: * * [.hljs-theme-light.nopadding] * ``` * /// @custom:oz-upgrades-unsafe-allow constructor * constructor() { * _disableInitializers(); * } * ``` * ==== */ abstract contract Initializable { /** * @dev Indicates that the contract has been initialized. * @custom:oz-retyped-from bool */ uint8 private _initialized; /** * @dev Indicates that the contract is in the process of being initialized. */ bool private _initializing; /** * @dev Triggered when the contract has been initialized or reinitialized. */ event Initialized(uint8 version); /** * @dev A modifier that defines a protected initializer function that can be invoked at most once. In its scope, * `onlyInitializing` functions can be used to initialize parent contracts. * * Similar to `reinitializer(1)`, except that functions marked with `initializer` can be nested in the context of a * constructor. * * Emits an {Initialized} event. */ modifier initializer() { bool isTopLevelCall = !_initializing; require( (isTopLevelCall && _initialized < 1) || (!AddressUpgradeable.isContract(address(this)) && _initialized == 1), "Initializable: contract is already initialized" ); _initialized = 1; if (isTopLevelCall) { _initializing = true; } _; if (isTopLevelCall) { _initializing = false; emit Initialized(1); } } /** * @dev A modifier that defines a protected reinitializer function that can be invoked at most once, and only if the * contract hasn't been initialized to a greater version before. In its scope, `onlyInitializing` functions can be * used to initialize parent contracts. * * A reinitializer may be used after the original initialization step. This is essential to configure modules that * are added through upgrades and that require initialization. * * When `version` is 1, this modifier is similar to `initializer`, except that functions marked with `reinitializer` * cannot be nested. If one is invoked in the context of another, execution will revert. * * Note that versions can jump in increments greater than 1; this implies that if multiple reinitializers coexist in * a contract, executing them in the right order is up to the developer or operator. * * WARNING: setting the version to 255 will prevent any future reinitialization. * * Emits an {Initialized} event. */ modifier reinitializer(uint8 version) { require(!_initializing && _initialized < version, "Initializable: contract is already initialized"); _initialized = version; _initializing = true; _; _initializing = false; emit Initialized(version); } /** * @dev Modifier to protect an initialization function so that it can only be invoked by functions with the * {initializer} and {reinitializer} modifiers, directly or indirectly. */ modifier onlyInitializing() { require(_initializing, "Initializable: contract is not initializing"); _; } /** * @dev Locks the contract, preventing any future reinitialization. This cannot be part of an initializer call. * Calling this in the constructor of a contract will prevent that contract from being initialized or reinitialized * to any version. It is recommended to use this to lock implementation contracts that are designed to be called * through proxies. * * Emits an {Initialized} event the first time it is successfully executed. */ function _disableInitializers() internal virtual { require(!_initializing, "Initializable: contract is initializing"); if (_initialized < type(uint8).max) { _initialized = type(uint8).max; emit Initialized(type(uint8).max); } } /** * @dev Internal function that returns the initialized version. Returns `_initialized` */ function _getInitializedVersion() internal view returns (uint8) { return _initialized; } /** * @dev Internal function that returns the initialized version. Returns `_initializing` */ function _isInitializing() internal view returns (bool) { return _initializing; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (proxy/utils/UUPSUpgradeable.sol) pragma solidity ^0.8.0; import "../../interfaces/draft-IERC1822Upgradeable.sol"; import "../ERC1967/ERC1967UpgradeUpgradeable.sol"; import "./Initializable.sol"; /** * @dev An upgradeability mechanism designed for UUPS proxies. The functions included here can perform an upgrade of an * {ERC1967Proxy}, when this contract is set as the implementation behind such a proxy. * * A security mechanism ensures that an upgrade does not turn off upgradeability accidentally, although this risk is * reinstated if the upgrade retains upgradeability but removes the security mechanism, e.g. by replacing * `UUPSUpgradeable` with a custom implementation of upgrades. * * The {_authorizeUpgrade} function must be overridden to include access restriction to the upgrade mechanism. * * _Available since v4.1._ */ abstract contract UUPSUpgradeable is Initializable, IERC1822ProxiableUpgradeable, ERC1967UpgradeUpgradeable { function __UUPSUpgradeable_init() internal onlyInitializing { } function __UUPSUpgradeable_init_unchained() internal onlyInitializing { } /// @custom:oz-upgrades-unsafe-allow state-variable-immutable state-variable-assignment address private immutable __self = address(this); /** * @dev Check that the execution is being performed through a delegatecall call and that the execution context is * a proxy contract with an implementation (as defined in ERC1967) pointing to self. This should only be the case * for UUPS and transparent proxies that are using the current contract as their implementation. Execution of a * function through ERC1167 minimal proxies (clones) would not normally pass this test, but is not guaranteed to * fail. */ modifier onlyProxy() { require(address(this) != __self, "Function must be called through delegatecall"); require(_getImplementation() == __self, "Function must be called through active proxy"); _; } /** * @dev Check that the execution is not being performed through a delegate call. This allows a function to be * callable on the implementing contract but not through proxies. */ modifier notDelegated() { require(address(this) == __self, "UUPSUpgradeable: must not be called through delegatecall"); _; } /** * @dev Implementation of the ERC1822 {proxiableUUID} function. This returns the storage slot used by the * implementation. It is used to validate the implementation's compatibility when performing an upgrade. * * IMPORTANT: A proxy pointing at a proxiable contract should not be considered proxiable itself, because this risks * bricking a proxy that upgrades to it, by delegating to itself until out of gas. Thus it is critical that this * function revert if invoked through a proxy. This is guaranteed by the `notDelegated` modifier. */ function proxiableUUID() external view virtual override notDelegated returns (bytes32) { return _IMPLEMENTATION_SLOT; } /** * @dev Upgrade the implementation of the proxy to `newImplementation`. * * Calls {_authorizeUpgrade}. * * Emits an {Upgraded} event. */ function upgradeTo(address newImplementation) external virtual onlyProxy { _authorizeUpgrade(newImplementation); _upgradeToAndCallUUPS(newImplementation, new bytes(0), false); } /** * @dev Upgrade the implementation of the proxy to `newImplementation`, and subsequently execute the function call * encoded in `data`. * * Calls {_authorizeUpgrade}. * * Emits an {Upgraded} event. */ function upgradeToAndCall(address newImplementation, bytes memory data) external payable virtual onlyProxy { _authorizeUpgrade(newImplementation); _upgradeToAndCallUUPS(newImplementation, data, true); } /** * @dev Function that should revert when `msg.sender` is not authorized to upgrade the contract. Called by * {upgradeTo} and {upgradeToAndCall}. * * Normally, this function will use an xref:access.adoc[access control] modifier such as {Ownable-onlyOwner}. * * ```solidity * function _authorizeUpgrade(address) internal override onlyOwner {} * ``` */ function _authorizeUpgrade(address newImplementation) internal virtual; /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol) pragma solidity ^0.8.0; import "../utils/ContextUpgradeable.sol"; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module which allows children to implement an emergency stop * mechanism that can be triggered by an authorized account. * * This module is used through inheritance. It will make available the * modifiers `whenNotPaused` and `whenPaused`, which can be applied to * the functions of your contract. Note that they will not be pausable by * simply including this module, only once the modifiers are put in place. */ abstract contract PausableUpgradeable is Initializable, ContextUpgradeable { /** * @dev Emitted when the pause is triggered by `account`. */ event Paused(address account); /** * @dev Emitted when the pause is lifted by `account`. */ event Unpaused(address account); bool private _paused; /** * @dev Initializes the contract in unpaused state. */ function __Pausable_init() internal onlyInitializing { __Pausable_init_unchained(); } function __Pausable_init_unchained() internal onlyInitializing { _paused = false; } /** * @dev Modifier to make a function callable only when the contract is not paused. * * Requirements: * * - The contract must not be paused. */ modifier whenNotPaused() { _requireNotPaused(); _; } /** * @dev Modifier to make a function callable only when the contract is paused. * * Requirements: * * - The contract must be paused. */ modifier whenPaused() { _requirePaused(); _; } /** * @dev Returns true if the contract is paused, and false otherwise. */ function paused() public view virtual returns (bool) { return _paused; } /** * @dev Throws if the contract is paused. */ function _requireNotPaused() internal view virtual { require(!paused(), "Pausable: paused"); } /** * @dev Throws if the contract is not paused. */ function _requirePaused() internal view virtual { require(paused(), "Pausable: not paused"); } /** * @dev Triggers stopped state. * * Requirements: * * - The contract must not be paused. */ function _pause() internal virtual whenNotPaused { _paused = true; emit Paused(_msgSender()); } /** * @dev Returns to normal state. * * Requirements: * * - The contract must be paused. */ function _unpause() internal virtual whenPaused { _paused = false; emit Unpaused(_msgSender()); } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; import "../proxy/utils/Initializable.sol"; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuardUpgradeable is Initializable { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; function __ReentrancyGuard_init() internal onlyInitializing { __ReentrancyGuard_init_unchained(); } function __ReentrancyGuard_init_unchained() internal onlyInitializing { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _status will be _NOT_ENTERED require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[49] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library AddressUpgradeable { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling * the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract. * * _Available since v4.8._ */ function verifyCallResultFromTarget( address target, bool success, bytes memory returndata, string memory errorMessage ) internal view returns (bytes memory) { if (success) { if (returndata.length == 0) { // only check isContract if the call was successful and the return data is empty // otherwise we already know that it was a contract require(isContract(target), "Address: call to non-contract"); } return returndata; } else { _revert(returndata, errorMessage); } } /** * @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the * revert reason or using the provided one. * * _Available since v4.3._ */ function verifyCallResult( bool success, bytes memory returndata, string memory errorMessage ) internal pure returns (bytes memory) { if (success) { return returndata; } else { _revert(returndata, errorMessage); } } function _revert(bytes memory returndata, string memory errorMessage) private pure { // Look for revert reason and bubble it up if present if (returndata.length > 0) { // The easiest way to bubble the revert reason is using memory via assembly /// @solidity memory-safe-assembly assembly { let returndata_size := mload(returndata) revert(add(32, returndata), returndata_size) } } else { revert(errorMessage); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; import "../proxy/utils/Initializable.sol"; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract ContextUpgradeable is Initializable { function __Context_init() internal onlyInitializing { } function __Context_init_unchained() internal onlyInitializing { } function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } /** * @dev This empty reserved space is put in place to allow future versions to add new * variables without shifting down storage in the inheritance chain. * See https://docs.openzeppelin.com/contracts/4.x/upgradeable#storage_gaps */ uint256[50] private __gap; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/StorageSlot.sol) pragma solidity ^0.8.0; /** * @dev Library for reading and writing primitive types to specific storage slots. * * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts. * This library helps with reading and writing to such slots without the need for inline assembly. * * The functions in this library return Slot structs that contain a `value` member that can be used to read or write. * * Example usage to set ERC1967 implementation slot: * ``` * contract ERC1967 { * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; * * function _getImplementation() internal view returns (address) { * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; * } * * function _setImplementation(address newImplementation) internal { * require(Address.isContract(newImplementation), "ERC1967: new implementation is not a contract"); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` * * _Available since v4.1 for `address`, `bool`, `bytes32`, and `uint256`._ */ library StorageSlotUpgradeable { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } /** * @dev Returns an `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { /// @solidity memory-safe-assembly assembly { r.slot := slot } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165.sol"; /** * @dev Interface for the NFT Royalty Standard. * * A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal * support for royalty payments across all NFT marketplaces and ecosystem participants. * * _Available since v4.5._ */ interface IERC2981 is IERC165 { /** * @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of * exchange. The royalty amount is denominated and should be paid in that same unit of exchange. */ function royaltyInfo(uint256 tokenId, uint256 salePrice) external view returns (address receiver, uint256 royaltyAmount); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol) pragma solidity ^0.8.0; import "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional metadata extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Metadata is IERC721 { /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/IERC721.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC721 compliant contract. */ interface IERC721 is IERC165 { /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in ``owner``'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721 * or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must * understand this adds an external call which potentially creates a reentrancy vulnerability. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol) pragma solidity ^0.8.0; /** * @title ERC721 token receiver interface * @dev Interface for any contract that wants to support safeTransfers * from ERC721 asset contracts. */ interface IERC721Receiver { /** * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom} * by `operator` from `from`, this function is called. * * It must return its Solidity selector to confirm the token transfer. * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted. * * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`. */ function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/math/Math.sol) pragma solidity ^0.8.0; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Down, // Toward negative infinity Up, // Toward infinity Zero // Toward zero } /** * @dev Returns the largest of two numbers. */ function max(uint256 a, uint256 b) internal pure returns (uint256) { return a > b ? a : b; } /** * @dev Returns the smallest of two numbers. */ function min(uint256 a, uint256 b) internal pure returns (uint256) { return a < b ? a : b; } /** * @dev Returns the average of two numbers. The result is rounded towards * zero. */ function average(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b) / 2 can overflow. return (a & b) + (a ^ b) / 2; } /** * @dev Returns the ceiling of the division of two numbers. * * This differs from standard division with `/` in that it rounds up instead * of rounding down. */ function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) { // (a + b - 1) / b can overflow on addition, so we distribute. return a == 0 ? 0 : (a - 1) / b + 1; } /** * @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0 * @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) * with further edits by Uniswap Labs also under MIT license. */ function mulDiv( uint256 x, uint256 y, uint256 denominator ) internal pure returns (uint256 result) { unchecked { // 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use // use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256 // variables such that product = prod1 * 2^256 + prod0. uint256 prod0; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod0 := mul(x, y) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { return prod0 / denominator; } // Make sure the result is less than 2^256. Also prevents denominator == 0. require(denominator > prod1); /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1. // See https://cs.stackexchange.com/q/138556/92363. // Does not overflow because the denominator cannot be zero at this stage in the function. uint256 twos = denominator & (~denominator + 1); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such // that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for // four bits. That is, denominator * inv = 1 mod 2^4. uint256 inverse = (3 * denominator) ^ 2; // Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works // in modular arithmetic, doubling the correct bits in each step. inverse *= 2 - denominator * inverse; // inverse mod 2^8 inverse *= 2 - denominator * inverse; // inverse mod 2^16 inverse *= 2 - denominator * inverse; // inverse mod 2^32 inverse *= 2 - denominator * inverse; // inverse mod 2^64 inverse *= 2 - denominator * inverse; // inverse mod 2^128 inverse *= 2 - denominator * inverse; // inverse mod 2^256 // Because the division is now exact we can divide by multiplying with the modular inverse of denominator. // This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is // less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1 // is no longer required. result = prod0 * inverse; return result; } } /** * @notice Calculates x * y / denominator with full precision, following the selected rounding direction. */ function mulDiv( uint256 x, uint256 y, uint256 denominator, Rounding rounding ) internal pure returns (uint256) { uint256 result = mulDiv(x, y, denominator); if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) { result += 1; } return result; } /** * @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down. * * Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11). */ function sqrt(uint256 a) internal pure returns (uint256) { if (a == 0) { return 0; } // For our first guess, we get the biggest power of 2 which is smaller than the square root of the target. // // We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have // `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`. // // This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)` // → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))` // → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)` // // Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit. uint256 result = 1 << (log2(a) >> 1); // At this point `result` is an estimation with one bit of precision. We know the true value is a uint128, // since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at // every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision // into the expected uint128 result. unchecked { result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; result = (result + a / result) >> 1; return min(result, a / result); } } /** * @notice Calculates sqrt(a), following the selected rounding direction. */ function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = sqrt(a); return result + (rounding == Rounding.Up && result * result < a ? 1 : 0); } } /** * @dev Return the log in base 2, rounded down, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 128; } if (value >> 64 > 0) { value >>= 64; result += 64; } if (value >> 32 > 0) { value >>= 32; result += 32; } if (value >> 16 > 0) { value >>= 16; result += 16; } if (value >> 8 > 0) { value >>= 8; result += 8; } if (value >> 4 > 0) { value >>= 4; result += 4; } if (value >> 2 > 0) { value >>= 2; result += 2; } if (value >> 1 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0); } } /** * @dev Return the log in base 10, rounded down, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >= 10**64) { value /= 10**64; result += 64; } if (value >= 10**32) { value /= 10**32; result += 32; } if (value >= 10**16) { value /= 10**16; result += 16; } if (value >= 10**8) { value /= 10**8; result += 8; } if (value >= 10**4) { value /= 10**4; result += 4; } if (value >= 10**2) { value /= 10**2; result += 2; } if (value >= 10**1) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log10(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log10(value); return result + (rounding == Rounding.Up && 10**result < value ? 1 : 0); } } /** * @dev Return the log in base 256, rounded down, of a positive value. * Returns 0 if given 0. * * Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string. */ function log256(uint256 value) internal pure returns (uint256) { uint256 result = 0; unchecked { if (value >> 128 > 0) { value >>= 128; result += 16; } if (value >> 64 > 0) { value >>= 64; result += 8; } if (value >> 32 > 0) { value >>= 32; result += 4; } if (value >> 16 > 0) { value >>= 16; result += 2; } if (value >> 8 > 0) { result += 1; } } return result; } /** * @dev Return the log in base 10, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + (rounding == Rounding.Up && 1 << (result * 8) < value ? 1 : 0); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.8.0) (utils/Strings.sol) pragma solidity ^0.8.0; import "./math/Math.sol"; /** * @dev String operations. */ library Strings { bytes16 private constant _SYMBOLS = "0123456789abcdef"; uint8 private constant _ADDRESS_LENGTH = 20; /** * @dev Converts a `uint256` to its ASCII `string` decimal representation. */ function toString(uint256 value) internal pure returns (string memory) { unchecked { uint256 length = Math.log10(value) + 1; string memory buffer = new string(length); uint256 ptr; /// @solidity memory-safe-assembly assembly { ptr := add(buffer, add(32, length)) } while (true) { ptr--; /// @solidity memory-safe-assembly assembly { mstore8(ptr, byte(mod(value, 10), _SYMBOLS)) } value /= 10; if (value == 0) break; } return buffer; } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { unchecked { return toHexString(value, Math.log256(value) + 1); } } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length. */ function toHexString(uint256 value, uint256 length) internal pure returns (string memory) { bytes memory buffer = new bytes(2 * length + 2); buffer[0] = "0"; buffer[1] = "x"; for (uint256 i = 2 * length + 1; i > 1; --i) { buffer[i] = _SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; import {KODASettings} from "../KODASettings.sol"; import "@openzeppelin/contracts/utils/Strings.sol"; import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol"; import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol"; import {IERC721Metadata, IERC2981} from "./interfaces/IERC721KODAEditions.sol"; import {IERC721KODACreator} from "./interfaces/IERC721KODACreator.sol"; import {ERC721KODAEditions} from "./ERC721KODAEditions.sol"; /** * @author KnownOrigin Labs - https://knownorigin.io/ * * @dev Contract which extends the KO Edition base enabling creator specific functionality */ contract ERC721KODACreator is ERC721KODAEditions, IERC721KODACreator { /** * @notice KODA Settings * @dev Defines the global settings for the linked KODA platform */ KODASettings public kodaSettings; /** * @notice Default Funds Handler * @dev Address of the fund handler that receives funds for all editions if an alternative has not been set in {_editionFundsHandler} */ address public defaultFundsHandler; /** * @notice Additional address enabled as a minter * @dev returns true if the address has been enabled as an additional minter * * - requires addition logic in place in inherited minting contracts */ mapping(address => bool) public additionalMinterEnabled; /** * @notice Additional address enabled as creators of editions * @dev returns true if the address has been enabled as an additional creator * */ mapping(address => bool) public additionalCreatorEnabled; /// @dev mapping of edition ID => address of the fund handler for a specific edition mapping(uint256 => address) internal _editionFundsHandler; modifier onlyApprovedMinter() { _onlyApprovedMinter(); _; } modifier onlyApprovedCreator() { _onlyApprovedCreator(); _; } /// @custom:oz-upgrades-unsafe-allow constructor constructor() initializer {} /** * @dev initialize method that replaces constructor in upgradeable contract * * Requirements: * * - `_artistAndOwner` must not be the zero address * - `_name` and `_symbol` must not be empty strings * - `_defaultFundsHandler` must not be the zero address * - `_settings` must not be the zero address * - should call all upgradeable `__[ContractName]_init()` methods from inherited contracts * * @param _artistAndOwner Who will be assigned attribution as lead artist and initial owner of the contract. * @param _name the NFT name * @param _symbol the NFT symbol * @param _defaultFundsHandler the address of the default address for receiving funds for all editions * @param _settings address of the platform KODASettings contract * @param _secondaryRoyaltyPercentage the default percentage value used for calculating royalties for secondary sales */ function initialize( address _artistAndOwner, string calldata _name, string calldata _symbol, address _defaultFundsHandler, KODASettings _settings, uint256 _secondaryRoyaltyPercentage, address _operatorRegistry, address _subscriptionOrRegistrantToCopy ) external initializer { if (_artistAndOwner == address(0)) revert ZeroAddress(); if (address(_settings) == address(0)) revert ZeroAddress(); if (_defaultFundsHandler == address(0)) revert ZeroAddress(); if (_artistAndOwner == address(this)) revert InvalidOwner(); if (bytes(_name).length == 0 || bytes(_symbol).length == 0) revert EmptyString(); name = _name; symbol = _symbol; defaultFundsHandler = _defaultFundsHandler; kodaSettings = _settings; nextEditionId = MAX_EDITION_SIZE; originalDeployer = _artistAndOwner; __KODABase_init(_secondaryRoyaltyPercentage); __Module_init(_operatorRegistry, _subscriptionOrRegistrantToCopy); _transferOwnership(_artistAndOwner); } /// @dev Allow a module to define custom init logic function __Module_init( address _operatorRegistry, address _subscriptionOrRegistrantToCopy ) internal virtual {} // ********** // // * PUBLIC * // // ********** // function contractURI() public view returns (string memory) { uint256 id; assembly { id := chainid() } return string.concat( kodaSettings.baseKOApi(), "/network/", Strings.toString(id), "/contracts/", Strings.toHexString(address(this)) ); } // * Contract Metadata * // /** * @notice Royalty Info for a Token Sale * @dev returns the royalty details for the edition a token belongs to - falls back to defaults * @param _tokenId the id of the token being sold * @param _salePrice currency/token agnostic sale price * @return receiver address to send royalty consideration to * @return royaltyAmount value to be sent to the receiver */ function royaltyInfo( uint256 _tokenId, uint256 _salePrice ) public view override returns (address receiver, uint256 royaltyAmount) { uint256 editionId = _tokenEditionId(_tokenId); receiver = editionFundsHandler(editionId); royaltyAmount = (_salePrice * editionRoyaltyPercentage(editionId)) / MODULO; } /** * @notice Check for Interface Support * @dev Returns true if this contract implements the interface defined by `interfaceId`. * @param interfaceId the ID of the interface to check * @return bool the interface is supported */ function supportsInterface( bytes4 interfaceId ) public pure virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId || // ERC165 interfaceId == type(IERC721).interfaceId || // ERC721 interfaceId == type(IERC721Metadata).interfaceId || // ERC721 Metadata interfaceId == type(IERC2981).interfaceId || // ERC2981 interfaceId == type(IERC721KODACreator).interfaceId; } /** * @notice Version of the Contract used in combination with {description} * @dev Function value can be more easily updated in event of an upgrade * @return string semver version */ function version() external pure override returns (string memory) { return "1.0.0"; } // * Editions * // /** * @notice Edition Funds Handler * @dev Returns the address that will receive sale proceeds for a given edition * @param _editionId the ID of an edition * @return address the funds handler address */ function editionFundsHandler( uint256 _editionId ) public view override returns (address) { address fundsHandler = _editionFundsHandler[_editionId]; if (fundsHandler != address(0)) { return fundsHandler; } return defaultFundsHandler; } /** * @notice Next Edition Token for Sale * @dev returns the ID of the next token that will be sold from a pre-minted edition * @param _editionId the ID of the edition * @return uint256 the next tokenId from the edition to be sold */ function getNextAvailablePrimarySaleToken( uint256 _editionId ) public view override returns (uint256) { if (isOpenEdition(_editionId)) revert IsOpenEdition(); return _getNextAvailablePrimarySaleToken( _editionId, _editionMaxTokenId(_editionId) ); } /** * @notice Next Edition Token for Sale * @dev returns the ID of the next token that will be sold from a pre-minted edition * @param _editionId the ID of the edition * @param _startId the ID of the starting point to look for the next token to sell * @return uint256 the next tokenId from the edition to be sold */ function getNextAvailablePrimarySaleToken( uint256 _editionId, uint256 _startId ) public view override returns (uint256) { if (isOpenEdition(_editionId)) revert IsOpenEdition(); return _getNextAvailablePrimarySaleToken(_editionId, _startId); } /** * @notice Mint An Open Edition Token * @dev allows the contract owner or additional minter to mint an open edition token * @param _editionId the ID of the edition to mint a token from * @param _recipient the address to transfer the token to */ function mintOpenEditionToken( uint256 _editionId, address _recipient ) public override onlyApprovedMinter returns (uint256) { return _mintSingleOpenEditionTo(_editionId, _recipient); } /** * @notice Mint Multiple Open Edition Tokens to the Edition Owner * @dev allows the contract owner or additional minter to mint * @param _editionId the ID of the edition to mint a token from * @param _quantity the number of tokens to mint */ function mintMultipleOpenEditionTokens( uint256 _editionId, uint256 _quantity, address _recipient ) public virtual override onlyApprovedMinter { if (_recipient != editionOwner(_editionId)) revert InvalidRecipient(); _mintMultipleOpenEditionToOwner(_editionId, _quantity); } // ********* // // * OWNER * // // ********* // /** * @notice Create a new Edition - optionally mint tokens and set a custom creator address and edition metadata URI * @dev Allows creation of an edition including minting a portion (or all) tokens upfront to any address and setting metadata * @param _editionSize the initial maximum supply of tokens in the edition * @param _mintQuantity the number of tokens to mint upfront - minting less than the edition size is considered an open edition * @param _recipient the address to transfer any minted tokens to * @param _creator an optional creator address to reflected in edition details * @param _uri the URI for fixed edition metadata * @return uint256 the new edition ID */ function createEdition( uint32 _editionSize, uint256 _mintQuantity, address _recipient, address _creator, string calldata _uri ) public override onlyApprovedCreator returns (uint256) { // mint to the minter or owner if address not specified address to = _recipient == address(0) ? additionalCreatorEnabled[msg.sender] ? msg.sender : owner() : _recipient; return _createEdition(_editionSize, _mintQuantity, to, _creator, _uri); } /** * @notice Create a new Edition as a collaboration with another entity, passing in a seperate funds handler for the edition - optionally mint tokens and set a custom creator address and edition metadata URI * @dev Allows creation of an edition including minting a portion (or all) tokens upfront to any address, setting metadata and a funds handler for this edition * @param _editionSize the initial maximum supply of tokens in the edition * @param _mintQuantity the number of tokens to mint upfront - minting less than the edition size is considered an open edition * @param _recipient the address to transfer any minted tokens to * @param _creator an optional creator address to reflected in edition details * @param _collabFundsHandler the address for receiving funds for this edition * @param _uri the URI for fixed edition metadata * @return editionId the new edition ID */ function createEditionAsCollaboration( uint32 _editionSize, uint256 _mintQuantity, address _recipient, address _creator, address _collabFundsHandler, string calldata _uri ) public override onlyApprovedCreator returns (uint256 editionId) { // mint to the minter or owner if address not specified address to = _recipient == address(0) ? additionalCreatorEnabled[msg.sender] ? msg.sender : owner() : _recipient; editionId = _createEdition( _editionSize, _mintQuantity, to, _creator, _uri ); _updateEditionFundsHandler(editionId, _collabFundsHandler); } /** * @notice Create Edition and Mint All Tokens to Owner * @dev allows the contract owner to creates an edition of specified size and mints all tokens to their address * @param _editionSize the number of tokens in the edition * @param _uri the metadata URI for the edition * @return uint256 the new edition ID */ function createEditionAndMintToOwner( uint32 _editionSize, string calldata _uri ) public override onlyOwner returns (uint256) { return _createEdition( _editionSize, _editionSize, owner(), address(0), _uri ); } /** * @notice Create Edition for Lazy Minting * @dev Allows the contract owner to create an edition of specified size for lazy minting * @param _editionSize the number of tokens in the edition * @param _uri the metadata URI for the edition * @return uint256 the new edition ID */ function createOpenEdition( uint32 _editionSize, string calldata _uri ) public override onlyApprovedCreator returns (uint256) { return _createEdition( _editionSize == 0 ? MAX_EDITION_SIZE : _editionSize, 0, additionalCreatorEnabled[msg.sender] ? msg.sender : owner(), address(0), _uri ); } /** * @notice Create Edition for Lazy Minting as a collaboration * @dev Allows the contract owner to create an edition of specified size for lazy minting as a collaboration with another entity, passing in a seperate funds handler for the edition * @param _editionSize the number of tokens in the edition * @param _collabFundsHandler the address for receiving funds for this edition * @param _uri the metadata URI for the edition * @return editionId the new edition ID */ function createOpenEditionAsCollaboration( uint32 _editionSize, address _collabFundsHandler, string calldata _uri ) public override onlyApprovedCreator returns (uint256 editionId) { editionId = _createEdition( _editionSize == 0 ? MAX_EDITION_SIZE : _editionSize, 0, additionalCreatorEnabled[msg.sender] ? msg.sender : owner(), address(0), _uri ); _updateEditionFundsHandler(editionId, _collabFundsHandler); } /** * @notice Enable/disable minting using an additional address * @dev allows the contract owner to enable/disable additional minting addresses * @param _minter address of the additional minter * @param _enabled whether the address is able to mint */ function updateAdditionalMinterEnabled( address _minter, bool _enabled ) external onlyOwner { additionalMinterEnabled[_minter] = _enabled; emit AdditionalMinterEnabled(_minter, _enabled); } /** * @notice Enable/disable edition creation using an additional address * @dev allows the contract owner to enable/disable additional creator addresses * @param _creator address of the additional creator * @param _enabled whether the address is able to be a creator */ function updateAdditionalCreatorEnabled( address _creator, bool _enabled ) external onlyOwner { additionalCreatorEnabled[_creator] = _enabled; emit AdditionalCreatorEnabled(_creator, _enabled); } /** * @notice Update Edition Funds Handler * @dev Allows the contract owner to set a specific fund handler for an edition, otherwise the default for all editions is used * @param _editionId the ID of the edition * @param _fundsHandler the address of the new funds handler for the edition */ function updateEditionFundsHandler( uint256 _editionId, address _fundsHandler ) public override onlyOwner { _updateEditionFundsHandler(_editionId, _fundsHandler); } /// @dev Internal logic for updating edition level funds handler overriding default function _updateEditionFundsHandler( uint256 _editionId, address _fundsHandler ) internal { if (_fundsHandler == address(0)) revert ZeroAddress(); if (!_editionExists(_editionId)) revert EditionDoesNotExist(); if (_editionFundsHandler[_editionId] != address(0)) revert AlreadySet(); _editionFundsHandler[_editionId] = _fundsHandler; emit EditionFundsHandlerUpdated(_editionId, _fundsHandler); } /** * @notice Update Edition Size * @dev allows the contract owner to update the number of tokens that can be minted in an edition * * Requirements: * * - should not allow edition size to exceed {Konstants-MAX_EDITION_SIZE} * - should not allow edition size to be reduced to less than has already been minted * * @param _editionId the ID of the edition to change the size of * @param _editionSize the new size to set for the edition * * Emits an {EditionSizeUpdated} event. */ function updateEditionSize( uint256 _editionId, uint32 _editionSize ) public override onlyOwner onlyOpenEdition(_editionId) { // can't set edition size beyond maximum if (_editionSize > MAX_EDITION_SIZE) revert EditionSizeTooLarge(); unchecked { // can't reduce edition size to less than what has been minted already if (_editionSize < editionMintedCount(_editionId)) revert EditionSizeTooSmall(); } _editions[_editionId].editionSize = _editionSize; emit EditionSizeUpdated(_editionId, _editionSize); } /// @dev Provided no primary sale has been made, an artist can correct any mistakes in their token URI function updateURIIfNoSaleMade( uint256 _editionId, string calldata _newURI ) external override onlyOwner { if (isOpenEdition(_editionId)) { if (_owners[_editionId] != address(0)) revert PrimarySaleMade(); } if ( _owners[_editionId + editionMintedCount(_editionId) - 1] != address(0) ) revert PrimarySaleMade(); _editions[_editionId].uri = _newURI; emit EditionURIUpdated(_editionId); } // ************ // // * INTERNAL * // // ************ // // * Contract Ownership * // // @dev Handle transferring and renouncing ownership in one go where owner always has a minimum balance // @dev See balanceOf for how the return value is adjusted. We just do this to reduce minting GAS function _transferOwnership(address _newOwner) internal override { // This is for keeping the balance slot of owner 'dirty' address _currentOwner = owner(); if (_currentOwner != address(0)) { _balances[_currentOwner] -= 1; } if (_newOwner != address(0)) { _balances[_newOwner] += 1; } super._transferOwnership(_newOwner); } // * Sale Helpers * // function _facilitateNextPrimarySale( uint256 _editionId, address _recipient ) internal virtual validateEdition(_editionId) returns (uint256 tokenId) { if (_editionSalesDisabled[_editionId]) revert EditionDisabled(); // Process open edition sale if (isOpenEdition(_editionId)) { return _facilitateOpenEditionSale(_editionId, _recipient); } // process batch minted edition tokenId = getNextAvailablePrimarySaleToken(_editionId); // Re-enter this contract to make address(this) the sender for transferring which should be approved to transfer tokens ERC721KODACreator(address(this)).transferFrom( ownerOf(tokenId), _recipient, tokenId ); } function _facilitateOpenEditionSale( uint256 _editionId, address _recipient ) internal virtual returns (uint256) { // Mint the token on demand uint256 tokenId = _mintSingleOpenEditionTo(_editionId, _recipient); // Return the token ID return tokenId; } function _getNextAvailablePrimarySaleToken( uint256 _editionId, uint256 _startId ) internal view virtual returns (uint256) { unchecked { // high to low for (_startId; _startId >= _editionId; --_startId) { // if no owner set - assume primary if not moved if (_owners[_startId] == address(0)) { return _startId; } } } revert("Primary market exhausted"); } // * Validators * // /// @dev validates that msg.sender is the contract owner or additional minter function _onlyApprovedMinter() internal virtual { if (msg.sender == owner()) return; if (additionalMinterEnabled[msg.sender]) return; revert NotAuthorised(); } /// @dev validates that msg.sender is the contract owner or additional creator function _onlyApprovedCreator() internal virtual { if (msg.sender == owner()) return; if (additionalCreatorEnabled[msg.sender]) return; revert NotAuthorised(); } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; import {IERC721Receiver} from "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol"; import {IERC721KODAEditions} from "./interfaces/IERC721KODAEditions.sol"; import {ITokenUriResolver} from "../interfaces/ITokenUriResolver.sol"; import {KODABaseUpgradeable} from "../KODABaseUpgradeable.sol"; /** * @author KnownOrigin Labs - https://knownorigin.io/ * @dev Base contract which extends the ERC721 NFT standards with edition-based minting logic */ abstract contract ERC721KODAEditions is KODABaseUpgradeable, IERC721KODAEditions { // * ERC721 State * // bytes4 internal constant ERC721_RECEIVED = bytes4(keccak256("onERC721Received(address,address,uint256,bytes)")); /// @notice Token name string public name; /// @notice Token symbol string public symbol; /// @dev Mapping of tokenId => owner - only set on first transfer (after mint) such as a primary sale and/or gift mapping(uint256 => address) internal _owners; /// @dev Mapping of owner => number of tokens owned mapping(address => uint256) internal _balances; /// @dev Mapping of owner => operator => approved mapping(address => mapping(address => bool)) internal _operatorApprovals; /// @dev Mapping of tokenId => approved address mapping(uint256 => address) internal _tokenApprovals; // * Custom State * // /// @dev ownership of latest editions recorded when contract ownership is transferred EditionOwnership[] internal _editionOwnerships; /// @notice Token URI resolver ITokenUriResolver public tokenUriResolver; /// @notice Original deployer of the 721 NFT address public originalDeployer; /// @dev tokens are minted in batches - the first token ID used is representative of the edition ID mapping(uint256 => Edition) internal _editions; /// @dev Given an edition ID, if the result is not address(0) then a specific creator has been set for an edition mapping(uint256 => address) internal _editionCreator; /// @dev The number of tokens minted from an open edition mapping(uint256 => uint256) internal _editionMintedCount; /// @dev For any given edition ID will be non zero if set by the contract owner for an edition mapping(uint256 => uint256) internal _editionRoyaltyPercentage; /// @dev Allows a creator to disable sales of their edition mapping(uint256 => bool) internal _editionSalesDisabled; /// @dev determines the maximum size and the next starting ID for each edition i.e. each edition starts at a multiple of 100,000 uint32 public constant MAX_EDITION_SIZE = 100_000; /** * @notice Next Edition ID * @dev the ID of the edition that will be created next */ uint256 public nextEditionId; // ************* // // * MODIFIERS * // // ************* // modifier onlyEditionOwner(uint256 _editionId) { _onlyEditionOwner(_editionId); _; } modifier onlyExistingEdition(uint256 _editionId) { _onlyExistingEdition(_editionId); _; } modifier onlyExistingToken(uint256 _tokenId) { _onlyExistingToken(_tokenId); _; } modifier onlyOpenEdition(uint256 _editionId) { _onlyOpenEdition(_editionId); _; } modifier onlyOpenEditionFromTokenId(uint256 _tokenId) { uint256 editionId = _tokenEditionId(_tokenId); _onlyOpenEdition(editionId); _; } modifier validateEdition(uint256 _editionId) { _validateEdition(_editionId); _; } // ********** // // * PUBLIC * // // ********** // /** * @notice Count all NFTs assigned to an owner * @dev NFTs assigned to the zero address are considered invalid, and this * function throws for queries about the zero address. * @param _owner An address for whom to query the balance * @return uint256 The number of NFTs owned by `_owner`, possibly zero */ function balanceOf(address _owner) public view override returns (uint256) { require(_owner != address(0), "Invalid owner"); return _owner == owner() ? _balances[_owner] - 1 : _balances[_owner]; } // * Approvals * // /** * @notice Change or reaffirm the approved address for an NFT * @dev The zero address indicates there is no approved address. * Throws unless `msg.sender` is the current NFT owner, or an authorized * operator of the current owner. * @param _approved The new approved NFT controller * @param _tokenId The NFT to approve */ function approve(address _approved, uint256 _tokenId) external override { address owner = ownerOf(_tokenId); require(_approved != owner, "Approved is owner"); require( _msgSender() == owner || isApprovedForAll(owner, _msgSender()), "Invalid sender" ); _approve(owner, _approved, _tokenId); } /** * @notice Get the approved address for a single NFT * @dev Throws if `_tokenId` is not a valid NFT. * @param _tokenId The NFT to find the approved address for * @return address The approved address for this NFT, or the zero address if there is none */ function getApproved( uint256 _tokenId ) public view override returns (address) { require( _exists(_tokenId), "ERC721: approved query for nonexistent token" ); return _tokenApprovals[_tokenId]; } /** * @notice Query if an address is an authorized operator for another address * @param _owner The address that owns the NFTs * @param _operator The address that acts on behalf of the owner * @return True if `_operator` is an approved operator for `_owner`, false otherwise */ function isApprovedForAll( address _owner, address _operator ) public view override returns (bool) { return _operatorApprovals[_owner][_operator]; } /** * @notice Enable or disable approval for a third party ("operator") to manage * all of `msg.sender`"s assets * @dev Emits the ApprovalForAll event. The contract MUST allow * multiple operators per owner. * @param _operator Address to add to the set of authorized operators * @param _approved True if the operator is approved, false to revoke approval */ function setApprovalForAll( address _operator, bool _approved ) public override { require(_msgSender() != _operator, "ERC721: approve to caller"); _operatorApprovals[_msgSender()][_operator] = _approved; emit ApprovalForAll(_msgSender(), _operator, _approved); } // * Transfers * // /** * @notice An extension to the default ERC721 behaviour, derived from ERC-875. * @dev Allowing for batch transfers from the provided address, will fail if from does not own all the tokens * @param _from the address to transfer tokens from * @param _to the address to transfer tokens to * @param _tokenIds list of token IDs to transfer */ function batchTransferFrom( address _from, address _to, uint256[] calldata _tokenIds ) public override { for (uint256 i = 0; i < _tokenIds.length; i++) { _safeTransferFrom(_from, _to, _tokenIds[i], bytes("")); } } /** * @notice Transfers the ownership of an NFT from one address to another address * @dev This works identically to the other function with an extra data parameter, except this function just sets data to "". * @param _from The current owner of the NFT * @param _to The new owner * @param _tokenId The NFT to transfer */ function safeTransferFrom( address _from, address _to, uint256 _tokenId ) public override { _safeTransferFrom(_from, _to, _tokenId, bytes("")); } /** * @notice Transfers the ownership of an NFT from one address to another address * @dev Throws unless `msg.sender` is the current owner, an authorized * operator, or the approved address for this NFT. Throws if `_from` is * not the current owner. Throws if `_to` is the zero address. Throws if * `_tokenId` is not a valid NFT. When transfer is complete, this function * checks if `_to` is a smart contract (code size > 0). If so, it calls * {onERC721Received} on `_to` and throws if the return value is not * `bytes4(keccak256("onERC721Received(address,address,uint256,bytes)"))`. * @param _from The current owner of the NFT * @param _to The new owner * @param _tokenId The NFT to transfer * @param _data Additional data with no specified format, sent in call to `_to` */ function safeTransferFrom( address _from, address _to, uint256 _tokenId, bytes calldata _data ) public override { _safeTransferFrom(_from, _to, _tokenId, _data); } /** * @notice Transfer ownership of an NFT -- THE CALLER IS RESPONSIBLE * TO CONFIRM THAT `_to` IS CAPABLE OF RECEIVING NFTS OR ELSE * THEY MAY BE PERMANENTLY LOST * @dev Throws unless `_msgSender()` is the current owner, an authorized * operator, or the approved address for this NFT. Throws if `_from` is * not the current owner. Throws if `_to` is the zero address. Throws if * `_tokenId` is not a valid NFT. * @param _from The current owner of the NFT * @param _to The new owner * @param _tokenId The NFT to transfer */ function transferFrom( address _from, address _to, uint256 _tokenId ) public override { _transferFrom(_from, _to, _tokenId); } // * Editions * // /** * @notice Edition Creator Address * @dev returns the address of the creator of works associated with an edition * @param _editionId the ID of the edition * @return address the address of the creator of the works associated with the edition */ function editionCreator( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (address) { return _editionCreator[_editionId] == address(0) ? editionOwner(_editionId) : _editionCreator[_editionId]; } /** * @notice Get Edition Details * @dev returns the full edition details * @param _editionId the ID of the edition * @return EditionDetails the full set of properties of the edition */ function editionDetails( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (EditionDetails memory) { return EditionDetails( editionOwner(_editionId), // edition owner editionCreator(_editionId), // edition creator _editionId, editionMintedCount(_editionId), editionSize(_editionId), isOpenEdition(_editionId), editionURI(_editionId) ); } /** * @notice Check if an Edition Exists * @dev returns whether edition with id `_editionId` exists or not * @param _editionId the ID of the edition * @return bool does the edition exist */ function editionExists( uint256 _editionId ) public view override returns (bool) { return _editionExists(_editionId); } /** * @notice Maximum Token ID of an Edition * @dev returns the last token ID of edition `_editionId` based on the edition's size * @param _editionId the ID of the edition * @return uint256 the maximum possible token ID */ function editionMaxTokenId( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (uint256) { return _editionMaxTokenId(_editionId); } /** * @notice Edition Minted Count * @dev returns the number of tokens minted for an edition - returns edition size if count is 0 but a token has been minted due to assumed batch mint * @param _editionId the id of the edition to get a count for * @return uint256 the number of tokens minted in the edition */ function editionMintedCount( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (uint256) { uint256 count = _editionMintedCount[_editionId]; if (count > 0) return count; if (!_editions[_editionId].isOpenEdition) return editionSize(_editionId); return 0; } /** * @notice Edition Owner * @dev calculates the owner of an edition from recorded ownerships - falls back to current contract owner * @param _editionId the id of the edition to get the owner of * @return address the address of the edition owner */ function editionOwner( uint256 _editionId ) public view override returns (address) { if (!_editionExists(_editionId)) return address(0); uint256 count = _editionOwnerships.length; if (count == 0) return owner(); unchecked { // the maximum number of ownerships that need checking = the number of editions from the current one to the end uint256 toCheck = (nextEditionId - _editionId) / MAX_EDITION_SIZE; uint256 i; // if less (or equal) need checking than the number of ownerships recorded, only check the latest ownerships if (toCheck < count) { i = count - toCheck; } for (i; i < count; i++) { if (_editionId <= _editionOwnerships[i].editionId) { return _editionOwnerships[i].editionOwner; } } } return owner(); } /** * @notice Edition Royalty Percentage * @dev returns the default secondary sale royalty percentage or a stored override value if set * @param _editionId the id of the edition to get the royalty percentage for * @return uint256 the royalty percentage value for the edition */ function editionRoyaltyPercentage( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (uint256) { uint256 royaltyOverride = _editionRoyaltyPercentage[_editionId]; return royaltyOverride == 0 ? defaultRoyaltyPercentage : royaltyOverride; } /** * @notice Check if Edition Primary Sales are Disabled * @dev returns whether or not primary sales of an edition are disabled * @param _editionId the ID of the edition * @return bool primary sales are disabled */ function editionSalesDisabled( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (bool) { return _editionSalesDisabled[_editionId]; } /** * @notice Edition Primary Sale Possible * @dev combines the logic of {editionSalesDisabled} and {editionSoldOut} * @param _editionId the ID of the edition * @return bool is a primary sale of the edition possible */ function editionSalesDisabledOrSoldOut( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (bool) { return _editionSalesDisabled[_editionId] || _editionSoldOut(_editionId); } /** * @notice Edition Primary Sale Possible * @dev combines the logic of {editionSalesDisabled} and {editionSoldOut} * @param _editionId the ID of the edition * @param _startId the ID of the token to start checking from * @return bool is a primary sale of the edition possible */ function editionSalesDisabledOrSoldOutFrom( uint256 _editionId, uint256 _startId ) public view override onlyExistingEdition(_editionId) returns (bool) { return _editionSalesDisabled[_editionId] || _editionSoldOutFrom(_editionId, _startId, 0); } /** * @notice Edition Size * @dev returns the maximum number of tokens that CAN BE minted in an edition * * - see {editionMintedCount} for the number of tokens minted in an edition so far * * @param _editionId the id of the edition * @return uint256 the size of the edition */ function editionSize( uint256 _editionId ) public view override returns (uint256) { return _editions[_editionId].editionSize; } /** * @notice Is the Edition Sold Out * @dev returns whether on not primary sales are still possible for an edition * @param _editionId the ID of the edition * @return bool the edition is sold out */ function editionSoldOut( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (bool) { return _editionSoldOut(_editionId); } /** * @notice Is the Edition Sold Out after a specific tokenId * @dev returns whether on not all tokens have been sold or transferred after `_startId` * @param _editionId the ID of the edition * @param _startId the ID of the token to start checking from * @return bool the edition is sold out from the startId pointer */ function editionSoldOutFrom( uint256 _editionId, uint256 _startId ) public view override onlyExistingEdition(_editionId) returns (bool) { return _editionSoldOutFrom(_editionId, _startId, 0); } /** * @notice Edition URI * @dev returns the URI for edition metadata - possibly the metadata for the first token if an external resolver is set * @param _editionId the ID of the edition * @return string the URI for the edition metadata */ function editionURI( uint256 _editionId ) public view override onlyExistingEdition(_editionId) returns (string memory) { // Here we are checking only that the edition has a edition level resolver - there may be a overridden token level resolver if ( tokenUriResolverActive() && tokenUriResolver.isDefined(_editionId, 0) ) { return tokenUriResolver.tokenURI(_editionId, 0); } return _editions[_editionId].uri; } /** * @notice Is Edition Open? * @dev returns whether or not an edition has tokens available to be minted * @param _editionId the ID of the edition check * @return bool is the edition open */ function isOpenEdition(uint256 _editionId) public view returns (bool) { return editionMintedCount(_editionId) < editionSize(_editionId); } // * Tokens * // /** * @notice Check the Existence of a Token * @dev returns whether or not a token exists with ID `_tokenID` * @param _tokenId the ID of the token * @return bool the token exists */ function exists(uint256 _tokenId) public view returns (bool) { return _exists(_tokenId); } /** * @notice Find the owner of an NFT * @dev NFTs assigned to zero address are considered invalid, and queries about them do throw. * @param _tokenId The identifier for an NFT * @return address The address of the owner of the NFT */ function ownerOf(uint256 _tokenId) public view override returns (address) { uint256 editionId = _tokenEditionId(_tokenId); address owner = _ownerOf(_tokenId, editionId); if (owner == address(0)) revert TokenDoesNotExist(); return owner; } /** * @notice Creator of the Works of an Edition Token * @dev returns the creator associated with the works of an edition * @param _tokenId the ID of the token in an edition * @return address the address of the creator */ function tokenEditionCreator( uint256 _tokenId ) public view override onlyExistingToken(_tokenId) returns (address) { return editionCreator(_tokenEditionId(_tokenId)); } /** * @notice Get Edition Details for a Token * @dev returns the full edition details for a token * @param _tokenId the ID of a token in an edition * @return EditionDetails the full set of properties for the edition */ function tokenEditionDetails( uint256 _tokenId ) public view override onlyExistingToken(_tokenId) returns (EditionDetails memory) { return editionDetails(_tokenEditionId(_tokenId)); } /** * @notice Get the Edition ID of a Token * @dev returns the ID of the edition the token belongs to * @param _tokenId the ID of a token in an edition * @return uint256 the ID of the edition the token belongs to */ function tokenEditionId( uint256 _tokenId ) public view override onlyExistingToken(_tokenId) returns (uint256) { return _tokenEditionId(_tokenId); } /** * @notice Get the Size of an Edition for a Token * @dev returns the size of the edition the token belongs to, see {editionSize} * @param _tokenId the ID of a token in an edition * @return uint256 the size of the edition the token belongs to */ function tokenEditionSize( uint256 _tokenId ) public view override onlyExistingToken(_tokenId) returns (uint256) { return editionSize(_tokenEditionId(_tokenId)); } /** * @notice Get the URI of the Metadata for a Token * @dev returns the URI of the token metadata or the metadata for the edition the token belongs to if an external resolver is not set * @param _tokenId the ID of a token in an edition * @return string the URI of the token or edition metadata */ function tokenURI( uint256 _tokenId ) public view onlyExistingToken(_tokenId) returns (string memory) { uint256 editionId = _tokenEditionId(_tokenId); if ( tokenUriResolverActive() && tokenUriResolver.isDefined(editionId, _tokenId) ) { return tokenUriResolver.tokenURI(editionId, _tokenId); } return _editions[editionId].uri; } /** * @notice Token URI Resolver Active * @dev return whether or not an external URI resolver has been set * @return bool is a token URI resolver set */ function tokenUriResolverActive() public view override returns (bool) { return address(tokenUriResolver) != address(0); } // ********* // // * OWNER * // // ********* // /** * @notice Enable/Disable Edition Sales * @dev allows the owner of the contract to enable/disable primary sales of an edition * @param _editionId the ID of the edition to enable/disable primary sales of * * Emits {EditionSalesDisabledUpdated} */ function toggleEditionSalesDisabled( uint256 _editionId ) public override onlyEditionOwner(_editionId) { bool disabled = !_editionSalesDisabled[_editionId]; _editionSalesDisabled[_editionId] = disabled; emit EditionSalesDisabledUpdated(_editionId, disabled); } /** * @notice Update Edition Creator * @dev allows the contact owner to provide edition attribution to another address * @param _editionId the ID of the edition to set a creator for * @param _creator the address of the creator associated with the works of an edition * * Emits {EditionCreatorUpdated} */ function updateEditionCreator( uint256 _editionId, address _creator ) public override onlyOwner { _updateEditionCreator(_editionId, _creator); } /** * @notice Update Secondary Royalty Percentage for an Edition * @dev allows the contract owner to set an edition level override for secondary royalties of a specific edition * @param _editionId the ID of the edition * @param _percentage the secondary royalty percentage using the same precision as {MODULO} * * Emits {EditionRoyaltyPercentageUpdated} */ function updateEditionRoyaltyPercentage( uint256 _editionId, uint256 _percentage ) public override onlyEditionOwner(_editionId) { if (_percentage > MAX_ROYALTY_PERCENTAGE) revert MaxRoyaltyPercentageExceeded(); _editionRoyaltyPercentage[_editionId] = _percentage; emit EditionRoyaltyPercentageUpdated(_editionId, _percentage); } /** * @notice Update Token URI Resolver * @dev allows the contract owner to update the token URI resolver for editions and tokens * @param _tokenUriResolver address of the token URI resolver contract * * Emits {TokenURIResolverUpdated} */ function updateTokenURIResolver( ITokenUriResolver _tokenUriResolver ) public override onlyOwner { tokenUriResolver = _tokenUriResolver; emit TokenURIResolverUpdated(address(_tokenUriResolver)); } // ************ // // * INTERNAL * // // ************ // // * Editions * // /** * @dev internal function for creating editions * * Requirements: * * - the parent contract should implement logic to decide who can use this * - `_editionSize` must not be 0 or greater than {Konstants-MAX_EDITION_SIZE} * - `_mintQuantity` must not be greater than `_editionSize` * - `_recipient` must not be `address(0)` if `mintQuantity` is greater than 0 * * @param _editionSize the maximum number of tokens that can be minted in the edition * @param _mintQuantity the number of tokens to mint immediately * @param _recipient the address to transfer any minted tokens to * @param _creator an optional address to attribute the works of the edition to * @param _uri the URI for the edition metadata * @return uint256 the ID of the new edition that is created * * Emits {EditionCreated} * Emits {EditionCreatorUpdated} if a `_creator` is not `address(0)` * Emits {Transfer} for any tokens that are minted */ function _createEdition( uint32 _editionSize, uint256 _mintQuantity, address _recipient, address _creator, string calldata _uri ) internal virtual returns (uint256) { if (_editionSize == 0 || _editionSize > MAX_EDITION_SIZE) revert InvalidEditionSize(); if (_mintQuantity > _editionSize) revert InvalidMintQuantity(); if (_recipient == address(0)) revert InvalidRecipient(); // configure start token ID uint256 editionId = nextEditionId; bool isOpen = _mintQuantity < _editionSize; unchecked { nextEditionId += MAX_EDITION_SIZE; } _editions[editionId] = Edition(_editionSize, isOpen, _uri); emit EditionCreated(editionId); if (_creator != address(0)) { _updateEditionCreator(editionId, _creator); } if (_mintQuantity > 0) { if (isOpen) _editionMintedCount[editionId] = _mintQuantity; _mintConsecutive(_recipient, _mintQuantity, editionId); } return editionId; } /** * @dev calculates if an edition exists * - edition size is used to calculate the existence of an edition * - an existing edition can't have its size set to 0 * * @param _editionId the ID of the edition * @return bool the edition exists */ function _editionExists(uint256 _editionId) internal view returns (bool) { return editionSize(_editionId) > 0; } /** * @dev calculates the maximum token ID for an edition based on the edition's ID and size * @param _editionId the ID of the edition * @return uint256 the maximum token ID that can be minted for the edition */ function _editionMaxTokenId( uint256 _editionId ) internal view returns (uint256) { return _editionId + editionSize(_editionId) - 1; } /** * @dev calculates whether the primary market of an an edition is exhausted * @param _editionId the ID of the edition * @return bool primary sales of the edition no longer possible */ function _editionSoldOut( uint256 _editionId ) internal view virtual returns (bool) { // isOpenEdition returns true if NOT ALL tokens in an edition have been minted, so sold out should always be false if (isOpenEdition(_editionId)) { return false; } // even for editions initially created as open, // we should check each token for an owner once all tokens have been minted // since they may have been minted by the owner to sell unchecked { for ( uint256 tokenId = _editionId; tokenId <= _editionMaxTokenId(_editionId); tokenId++ ) { if (_owners[tokenId] == address(0)) return false; } } return true; } /** * @dev calculates whether the primary market of an an edition is exhausted in a range * @param _editionId the ID of the edition * @param _startId the tokenId to start checking from * @param _quantity the number of tokens to check - to check a smaller range * @return bool primary sales of the edition no longer possible */ function _editionSoldOutFrom( uint256 _editionId, uint256 _startId, uint256 _quantity ) internal view virtual returns (bool) { if (_startId < _editionId) revert InvalidRange(); uint256 maxTokenId = _editionMaxTokenId(_editionId); if (_startId > maxTokenId) revert InvalidRange(); // if quantity 0, check all the way to the end of the edition uint256 finishId = _quantity == 0 ? maxTokenId : _startId + _quantity - 1; // don't check beyond maxTokenId if (finishId > maxTokenId) finishId = maxTokenId; unchecked { for (uint256 tokenId = _startId; tokenId <= finishId; tokenId++) { if (_owners[tokenId] == address(0)) return false; } } return true; } /** * @dev minting of multiple tokens of open edition `_editionId` to the edition owner * @dev optimised by not storing token ownership address which is accounted for in _ownerOf() * * Requirements: * * - only valid for open editions * - mints must not exceed the edition size * * @param _editionId the edition that the token is a member of * @param _quantity the number of tokens to mint */ function _mintMultipleOpenEditionToOwner( uint256 _editionId, uint256 _quantity ) internal virtual { if (!_editions[_editionId].isOpenEdition) revert BatchOrUnknownEdition(); address _owner = editionOwner(_editionId); unchecked { uint256 mintedCount = _editionMintedCount[_editionId]; if (mintedCount + _quantity > editionSize(_editionId)) revert EditionSizeExceeded(); _editionMintedCount[_editionId] += _quantity; _balances[_owner] += _quantity; // unlikely to exceed 2 ^ 256 - 1 uint256 firstTokenId = _editionId + mintedCount; for (uint256 i = 0; i < _quantity; i++) { _mintTransferToOwner(_owner, firstTokenId + i); } } } /** * @dev mints a single token of open edition `_editionId` to `_recipient` * * Requirements: * * - recipient is not the zero address * - only valid for open editions * - mints must not exceed the edition size * * @param _recipient the address to transfer the minted token to * @param _editionId the edition that the token is a member of * @return uint256 the minted token ID */ function _mintSingleOpenEditionTo( uint256 _editionId, address _recipient ) internal virtual returns (uint256) { if (_recipient == address(0)) revert InvalidRecipient(); _onlyOpenEdition(_editionId); unchecked { uint256 mintedCount = _editionMintedCount[_editionId]; // Get next token ID for sale uint256 tokenId = _editionId + mintedCount; _editionMintedCount[_editionId] += 1; _mintSingle(_recipient, tokenId); return tokenId; } } /** * @dev sets the address of the creator of works associated with an edition * @param _editionId the ID of the edition * @param _creator the address of the creator * * Emits {EditionCreatorUpdated} */ function _updateEditionCreator( uint256 _editionId, address _creator ) internal virtual { _editionCreator[_editionId] = _creator; emit EditionCreatorUpdated(_editionId, _creator); } // * Tokens * // /** * @dev Approve `_approved` to operate on `_tokenId` * * Emits an {Approval} event. */ function _approve( address _owner, address _approved, uint256 _tokenId ) internal virtual { _tokenApprovals[_tokenId] = _approved; emit Approval(_owner, _approved, _tokenId); } /// @dev Hook that is called before any token transfer. This includes minting and burning function _beforeTokenTransfer( address _from, address _to, uint256 _tokenId ) internal virtual {} /// @dev Hook that is called after any token transfer. This includes minting and burning function _afterTokenTransfer( address _from, address _to, uint256 _tokenId ) internal virtual {} /** * @dev returns the existence of a token by checking for an owner * @param _tokenId the token ID to check * @return bool the token exists */ function _exists(uint256 _tokenId) internal view returns (bool) { return _ownerOf(_tokenId, _tokenEditionId(_tokenId)) != address(0); } /** * @dev returns the address of the owner of a token * - Newly created editions and its tokens minted to a creator don't have the owner set until the token is sold on the primary market * - Therefore, if internally an edition exists and owner of token is zero address, then creator still owns the token * - Otherwise, the token owner is returned or the zero address if the token does not exist * * @param _tokenId the ID of the token to check * @param _editionId the ID of the edition the token belongs to * @return address the address of the token owner */ function _ownerOf( uint256 _tokenId, uint256 _editionId ) internal view virtual returns (address) { // If an owner assigned address _owner = _owners[_tokenId]; if (_owner != address(0)) { return _owner; } address _editionOwner = editionOwner(_editionId); if (_editionOwner != address(0)) { // if not open edition, return owner if (!_editions[_editionId].isOpenEdition) { return _editionOwner; } // if open edition, return owner below minted count, return 0 above minted count if (_tokenId < _editionId + _editionMintedCount[_editionId]) { return _editionOwner; } } return address(0); } /** * @dev calculates the edition ID using the token ID given and MAX_EDITION_SIZE * @param _tokenId the ID of the token to get edition ID for * @return uint256 the ID of the edition the token is from */ function _tokenEditionId(uint256 _tokenId) internal pure returns (uint256) { return (_tokenId / MAX_EDITION_SIZE) * MAX_EDITION_SIZE; } // * Contract Ownership * // /// @dev override {Ownable-_transferOwnership} to record the old owner as the current edition owner if not already recorded function _transferOwnership(address _newOwner) internal virtual override { // record the edition owner of the most recent edition if (nextEditionId > MAX_EDITION_SIZE) { _recordLatestEditionOwnership(owner()); } super._transferOwnership(_newOwner); } // * Validators * // function _onlyEditionOwner(uint256 _editionId) internal view { if (msg.sender == editionOwner(_editionId)) return; revert NotAuthorised(); } /// @dev reverts if the edition does not exist function _onlyExistingEdition(uint256 _editionId) internal view { if (!_editionExists(_editionId)) revert EditionDoesNotExist(); } /// @dev reverts if the token does not exist function _onlyExistingToken(uint256 _tokenId) internal view { if (!_exists(_tokenId)) revert TokenDoesNotExist(); } /// @dev reverts if the edition is not open function _onlyOpenEdition(uint256 _editionId) internal view { if (!isOpenEdition(_editionId)) revert BatchOrUnknownEdition(); } /// @dev reverts if the edition is not valid function _validateEdition(uint256 _editionId) internal view virtual { _onlyExistingEdition(_editionId); } // *********** // // * PRIVATE * // // *********** // // * Edition Ownership * // /** * @dev records the editionOwnership of the most recent edition if not already recorded * * - must only be used when at least one edition has been minted */ function _recordLatestEditionOwnership(address _editionOwner) private { uint256 count = _editionOwnerships.length; uint256 _editionId = nextEditionId - MAX_EDITION_SIZE; if (count == 0) { _editionOwnerships.push( EditionOwnership(_editionId, _editionOwner) ); return; } uint256 lastOwnershipId = _editionOwnerships[count - 1].editionId; bool ownershipNotRecorded = lastOwnershipId != _editionId; if (ownershipNotRecorded) { _editionOwnerships.push( EditionOwnership(_editionId, _editionOwner) ); } } // * Minting * // /** * @dev Mints multiple consecutive tokens starting at and including the first specified ID - must be pre-validated * @param _recipient address to mint to * @param _quantity the number of tokens to mint * @param _firstTokenId the token to start minting from */ function _mintConsecutive( address _recipient, uint256 _quantity, uint256 _firstTokenId ) private { unchecked { _balances[_recipient] += _quantity; // unlikely to exceed 2 ^ 256 - 1 if (_recipient == owner()) { for (uint256 i = 0; i < _quantity; i++) { _mintTransferToOwner(_recipient, _firstTokenId + i); } } else { for (uint256 i = 0; i < _quantity; i++) { _mintTransfer(_recipient, _firstTokenId + i); } } } } /** * @notice Mint a Single Token ID * @dev Mint a token with the specified tokenId and update the recipient balance - must be pre-validated * @param _recipient address to mint to * @param _tokenId id of the token to mint */ function _mintSingle(address _recipient, uint256 _tokenId) private { unchecked { _balances[_recipient] += 1; // unlikely to exceed 2 ^ 256 - 1 _mintTransfer(_recipient, _tokenId); } } /** * @notice Mint Transfer * @dev Transfer logic of minting a token - should be pre-validated and update balance in parent function * @param _recipient address to mint to * @param _tokenId id of the token to mint */ function _mintTransfer(address _recipient, uint256 _tokenId) private { _beforeTokenTransfer(address(0), _recipient, _tokenId); _owners[_tokenId] = _recipient; emit Transfer(address(0), _recipient, _tokenId); _afterTokenTransfer(address(0), _recipient, _tokenId); } /** * @notice Mint Transfer To Owner * @dev Transfer logic of minting a token to the edition owner - should be pre-validated and update balance in parent function * * Requirements: * * - `_owner` must only ever be the owner of the edition the token belongs to * * @param _owner address of the edition owner * @param _tokenId id of the token to mint */ function _mintTransferToOwner(address _owner, uint256 _tokenId) private { _beforeTokenTransfer(address(0), _owner, _tokenId); emit Transfer(address(0), _owner, _tokenId); _afterTokenTransfer(address(0), _owner, _tokenId); } // * Token Transfers * // /// @dev performs a transfer of a token and checks for a correct response if the `_to` is a contract function _safeTransferFrom( address _from, address _to, uint256 _tokenId, bytes memory _data ) private { _transferFrom(_from, _to, _tokenId); uint256 receiverCodeSize; assembly { receiverCodeSize := extcodesize(_to) } if (receiverCodeSize > 0) { bytes4 selector = IERC721Receiver(_to).onERC721Received( _msgSender(), _from, _tokenId, _data ); require(selector == ERC721_RECEIVED, "Invalid selector"); } } /** * @dev custom implementation of logic to transfer a token from one address to another * * Requirements: * * - `_to` must not be the zero address - we have custom logic which is optimised for minting to the contract owner * - the token must have an owner i.e. CAN NOT BE USED FOR MINTING * - the msg.sender must be the the current token owner, approved for all, or approved for the specific token * - should call before and after transfer hooks * - should clear any existing token approval * - should adjust the balances of the existing and new token owner * * Emits {Approval} * Emits {Transfer} */ function _transferFrom( address _from, address _to, uint256 _tokenId ) private { // enforce not being able to send to zero as we have explicit rules what a minted but unbound owner is if (_to == address(0)) revert InvalidRecipient(); // Ensure the owner is the sender address owner = _ownerOf(_tokenId, _tokenEditionId(_tokenId)); if (owner == address(0)) revert TokenDoesNotExist(); require(_from == owner, "Owner mismatch"); address spender = _msgSender(); address approvedAddress = getApproved(_tokenId); require( spender == owner || // sending to myself isApprovedForAll(owner, spender) || // is approved to send any behalf of owner approvedAddress == spender, // is approved to move this token ID "Invalid spender" ); // do before transfer check _beforeTokenTransfer(_from, _to, _tokenId); // Ensure approval for token ID is cleared _approve(owner, address(0), _tokenId); unchecked { // Modify balances _balances[_from] -= 1; _balances[_to] += 1; } _owners[_tokenId] = _to; emit Transfer(_from, _to, _tokenId); // do after transfer check _afterTokenTransfer(_from, _to, _tokenId); } }
pragma solidity 0.8.17; // SPDX-License-Identifier: MIT import {ERC721KODACreator} from "../ERC721KODACreator.sol"; import {IERC721KODACreatorWithBuyItNow} from "../interfaces/IERC721KODACreatorWithBuyItNow.sol"; /// @author KnownOrigin Labs - https://knownorigin.io/ /// @notice ERC721 KODA Creator with Embedded Primary and Secondary Buy It Now Marketplace contract ERC721KODACreatorWithBuyItNow is ERC721KODACreator, IERC721KODACreatorWithBuyItNow { /// @notice Edition ID -> Listing Metadata mapping(uint256 => EditionListing) public editionListing; /// @notice Token ID -> Owner Address -> Listing Metadata mapping(uint256 => mapping(address => TokenListing)) public tokenListing; // ********** // // * PUBLIC * // // ********** // /// @inheritdoc ERC721KODACreator function supportsInterface( bytes4 interfaceId ) public pure override returns (bool) { return interfaceId == type(IERC721KODACreatorWithBuyItNow).interfaceId || super.supportsInterface(interfaceId); } // * Marketplace * // /** * @notice Buy Edition Token * @dev allows the purchase of the next available token for sale from an edition listing * * Requirements: * * - the listing must exist * - the value sent must be equal to the listing price * - the listing must be active i.e. the current time must be after the listing start time * * @param _editionId the ID of the edition to purchase a token from * @param _recipient the address that should receive the token purchased */ function buyEditionToken( uint256 _editionId, address _recipient ) external payable override whenNotPaused nonReentrant { EditionListing storage listing = editionListing[_editionId]; if (listing.price == 0) revert InvalidListing(); if (msg.value != listing.price) revert InvalidPrice(); if (block.timestamp < listing.startDate) revert TooEarly(); if (listing.endDate > 0 && block.timestamp > listing.endDate) revert TooLate(); // when owner has renounced ownership, then the transfer will fail but nicer to fail early address _owner = owner(); if (_owner == address(0)) revert EditionSalesDisabled(); // get the next token ID uint256 tokenId = _facilitateNextPrimarySale(_editionId, _recipient); address platform = kodaSettings.platform(); uint256 primaryPercentageForPlatform = kodaSettings .platformPrimaryCommission(); uint256 platformProceeds = (msg.value * primaryPercentageForPlatform) / MODULO; // Where platform primary commission is zero from the settings, we don't need to execute the transaction bool success; if (platformProceeds > 0) { (success, ) = platform.call{value: platformProceeds}(""); if (!success) revert TransferFailed(); } // send all the funds to the handler - KO is part of this (success, ) = editionFundsHandler(_editionId).call{ value: msg.value - platformProceeds }(""); if (!success) revert TransferFailed(); emit BuyNowPurchased(tokenId, msg.sender, _owner, listing.price); } /** * @notice List a Token for sale * @dev allows the owner of a token to create a secondary buy it now listing * @param _tokenId the ID of the token to list for sale * @param _listingPrice the price to list the token for * @param _startDate the time the listing is enabled * @param _endDate the time the listing is disabled */ function createTokenBuyItNowListing( uint256 _tokenId, uint96 _listingPrice, uint128 _startDate, uint128 _endDate ) external override { if (_owners[_tokenId] != msg.sender) revert InvalidToken(); if (_listingPrice == 0) revert InvalidPrice(); if (tokenListing[_tokenId][msg.sender].price != 0) revert AlreadyListed(); // Store listing data tokenListing[_tokenId][msg.sender] = TokenListing( msg.sender, _listingPrice ); emit ListedTokenForBuyNow( msg.sender, _tokenId, _listingPrice, _startDate, _endDate ); } /** * @notice Delist a Token for Sale * @dev allows the owner of a token to remove a listing for the token * @param _tokenId the ID of the token to delist */ function deleteTokenBuyItNowListing(uint256 _tokenId) external override { if (tokenListing[_tokenId][msg.sender].price == 0) revert InvalidListing(); delete tokenListing[_tokenId][msg.sender]; emit BuyNowTokenDeListed(_tokenId); } /** * @notice Update Token Listing Price * @dev allows the owner of a token to update the price * @param _tokenId the ID of the token already listed * @param _listingPrice the new listing price to set */ function updateTokenBuyItNowListingPrice( uint256 _tokenId, uint96 _listingPrice ) external override { if (tokenListing[_tokenId][msg.sender].price == 0) revert InvalidListing(); if (ownerOf(_tokenId) != msg.sender) revert InvalidListing(); if (_listingPrice == 0) revert InvalidPrice(); tokenListing[_tokenId][msg.sender].price = _listingPrice; emit BuyNowTokenPriceChanged(_tokenId, _listingPrice); } /** * @notice Buy Token * @dev allows the purchase of a token listed for sale * * Requirements: * * - the listing must exist * - the value sent must be equal to the listing price * * @param _tokenId the ID of the token to purchase * @param _recipient the address that should receive the token purchased */ function buyToken( uint256 _tokenId, address _recipient ) external payable override nonReentrant { TokenListing storage listing = tokenListing[_tokenId][ ownerOf(_tokenId) ]; if (listing.price == 0) revert InvalidListing(); if (listing.price != msg.value) revert InvalidPrice(); // calculate proceeds owed to platform, creator and seller address platform = kodaSettings.platform(); uint256 secondaryPercentageForPlatform = kodaSettings .platformSecondaryCommission(); uint256 platformProceeds = (msg.value * secondaryPercentageForPlatform) / MODULO; (address receiver, uint256 royaltyAmount) = royaltyInfo( _tokenId, msg.value ); // Where platform proceeds is zero due to the settings, no need to call the transfer bool success; if (platformProceeds > 0) { (success, ) = platform.call{value: platformProceeds}(""); if (!success) revert TransferFailed(); } if (royaltyAmount > 0) { (success, ) = receiver.call{value: royaltyAmount}(""); if (!success) revert TransferFailed(); } // maximum platform commission and royalty percentage are both limited to 50% (max 100% of sale value total) // it is also extremely unlikely that they will ever both use the max so no need for additional validation/conditions (success, ) = listing.seller.call{ value: msg.value - royaltyAmount - platformProceeds }(""); if (!success) revert TransferFailed(); emit BuyNowTokenPurchased( _tokenId, msg.sender, _recipient, listing.seller, listing.price ); ERC721KODACreatorWithBuyItNow(address(this)).transferFrom( listing.seller, _recipient, _tokenId ); delete tokenListing[_tokenId][ownerOf(_tokenId)]; } /** * @notice Get the token listing details for the current token owner * @dev Get a token listing just from token ID and not worrying about current owner * @param _tokenId the ID of the token * @return TokenListing details of the token listing */ function getTokenListing( uint256 _tokenId ) external view returns (TokenListing memory) { return tokenListing[_tokenId][ownerOf(_tokenId)]; } // ********* // // * OWNER * // // ********* // // * Editions * // /** * @notice List and Edition for Buy It Now * @dev allows the edition owner to create a listing to enable sales of tokens from an edition * * @param _editionId the ID of the edition to create a listing for * @param _listingPrice the price to list for * @param _startDate the time that the listing becomes active * @param _endDate the time the listing is disabled */ function createEditionBuyItNowListing( uint256 _editionId, uint96 _listingPrice, uint128 _startDate, uint128 _endDate ) public override onlyEditionOwner(_editionId) { _createEditionBuyItNowListing( _editionId, _listingPrice, _startDate, _endDate ); } /** * @notice Delist an Edition for Sale * @param _editionId the ID of the edition to delist */ function deleteEditionBuyItNowListing( uint256 _editionId ) external override onlyEditionOwner(_editionId) { if (editionListing[_editionId].price == 0) revert EditionNotListed(); delete editionListing[_editionId]; emit BuyNowDeListed(_editionId); } /** * @notice Create and Mint an Edition and List it for Sale * @dev allows the contract owner to create a pre-minted edition and immediately list it for buy it now sales * @param _editionSize the size of the edition * @param _listingPrice the price that tokens can be bought for * @param _startDate the time that the listing should become active * @param _endDate the time the listing is disabled * @param _uri the metadata URI of the edition * @return uint256 the ID of the new edition created */ function mintAndListEditionForBuyNow( uint32 _editionSize, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, string calldata _uri ) external onlyOwner returns (uint256) { // Creator override only required if there are sub-minters in addition to contract owner uint256 editionId = _createEdition( _editionSize, _editionSize, owner(), address(0), _uri ); _createEditionBuyItNowListing( editionId, _listingPrice, _startDate, _endDate ); return editionId; } /** * @notice Create and Mint an Edition and List it for Sale * @dev allows the contract owner to create a pre-minted edition and immediately list it for buy it now sales * @param _editionSize the size of the edition * @param _listingPrice the price that tokens can be bought for * @param _startDate the time that the listing should become active * @param _endDate the time the listing is disabled * @param _collabFundsHandler the fund splitting contract * @param _uri the metadata URI of the edition * @return uint256 the ID of the new edition created */ function mintAndListEditionAsCollaborationForBuyNow( uint32 _editionSize, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, address _collabFundsHandler, string calldata _uri ) external onlyOwner returns (uint256) { // Creator override only required if there are sub-minters in addition to contract owner uint256 editionId = createEditionAsCollaboration( _editionSize, _editionSize, owner(), address(0), _collabFundsHandler, _uri ); _createEditionBuyItNowListing( editionId, _listingPrice, _startDate, _endDate ); return editionId; } /// @notice Setup the open edition template and list for buy it now /** * @notice Create an Open Edition and List it for Sale * @dev allows the contract owner to create an open edition and immediately list it for buy it now sales * @param _editionSize the size of the edition * @param _uri the metadata URI of the edition * @param _listingPrice the price that tokens can be bought for * @param _startDate the time that the listing should become active * @param _endDate the time the listing is disabled * @return uint256 the ID of the new edition created */ function setupAndListOpenEdition( string calldata _uri, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, uint32 _editionSize ) external override onlyOwner returns (uint256) { uint256 editionId = _createEdition( _editionSize == 0 ? MAX_EDITION_SIZE : _editionSize, 0, owner(), address(0), _uri ); _createEditionBuyItNowListing( editionId, _listingPrice, _startDate, _endDate ); return editionId; } /// @notice Setup the open edition template and list for buy it now /** * @notice Create an Open Edition and List it for Sale * @dev allows the contract owner to create an open edition and immediately list it for buy it now sales * @param _editionSize the size of the edition * @param _uri the metadata URI of the edition * @param _listingPrice the price that tokens can be bought for * @param _startDate the time that the listing should become active * @param _endDate the time the listing is disabled * @return uint256 the ID of the new edition created * @param _collabFundsHandler the fund splitting contract */ function setupAndListOpenEditionAsCollaboration( string calldata _uri, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, uint32 _editionSize, address _collabFundsHandler ) external onlyOwner returns (uint256) { uint256 editionId = createOpenEditionAsCollaboration( _editionSize == 0 ? MAX_EDITION_SIZE : _editionSize, _collabFundsHandler, _uri ); _createEditionBuyItNowListing( editionId, _listingPrice, _startDate, _endDate ); return editionId; } /** * @notice Update Edition Listing Price * @dev allows the contract owner to update the price of edition tokens listed for sale * @param _editionId the ID of the edition already listed * @param _listingPrice the new listing price to set */ function updateEditionBuyItNowListingPrice( uint256 _editionId, uint96 _listingPrice ) external override onlyEditionOwner(_editionId) { if (editionListing[_editionId].price == 0) revert EditionNotListed(); if (_listingPrice == 0) revert InvalidPrice(); // Set price editionListing[_editionId].price = _listingPrice; // Emit event emit BuyNowPriceChanged(_editionId, _listingPrice); } // ************ // // * INTERNAL * // // ************ // /** * @dev create a listing to enable sales of tokens from an edition * * Requirements: * * - Should have owner validation in parent function * - The edition exists * - A listing does not already exist for the edition * - The listing price is not less than the global minimum * * @param _editionId the ID of the edition to create a listing for * @param _listingPrice the price to list for * @param _startDate the time that the listing becomes active * @param _endDate the time the listing is disabled */ function _createEditionBuyItNowListing( uint256 _editionId, uint96 _listingPrice, uint128 _startDate, uint128 _endDate ) internal { if (editionListing[_editionId].price != 0) revert AlreadyListed(); if (_listingPrice == 0) revert InvalidPrice(); // automatically set approval for the contract against the edition owner if not already set // this is so do they do not need to do it manually in order to sell any editions they list if (!_operatorApprovals[msg.sender][address(this)]) { _operatorApprovals[msg.sender][address(this)] = true; emit ApprovalForAll(msg.sender, address(this), true); } // Store listing data editionListing[_editionId] = EditionListing( _listingPrice, _startDate, _endDate ); emit ListedEditionForBuyNow(_editionId, _listingPrice, _startDate); } }
pragma solidity 0.8.17; // SPDX-License-Identifier: MIT /// @author KnownOrigin Labs - https://knownorigin.io/ interface IERC721KODACreator { error AlreadySet(); error EditionDisabled(); error EditionSizeTooLarge(); error EditionSizeTooSmall(); error EmptyString(); error InvalidOwner(); error IsOpenEdition(); error OwnerRevoked(); error PrimarySaleMade(); error ZeroAddress(); event EditionSizeUpdated(uint256 indexed _editionId, uint256 _editionSize); event EditionFundsHandlerUpdated( uint256 indexed _editionId, address indexed _handler ); /// @dev Function value can be more easily updated in event of an upgrade function version() external pure returns (string memory); /// @dev Returns the address that will receive sale proceeds for a given edition function editionFundsHandler( uint256 _editionId ) external view returns (address); /// @dev returns the ID of the next token that will be sold from a pre-minted edition function getNextAvailablePrimarySaleToken( uint256 _editionId ) external view returns (uint256); /// @dev returns the ID of the next token that will be sold from a pre-minted edition function getNextAvailablePrimarySaleToken( uint256 _editionId, uint256 _startId ) external view returns (uint256); /// @dev allows the owner or additional minter to mint open edition tokens function mintOpenEditionToken( uint256 _editionId, address _recipient ) external returns (uint256); /** * @dev allows the contract owner or additional minter to mint multiple open edition tokens */ function mintMultipleOpenEditionTokens( uint256 _editionId, uint256 _quantity, address _recipient ) external; /// @dev Allows creation of an edition including minting a portion (or all) tokens upfront to any address and setting metadata function createEdition( uint32 _editionSize, uint256 _mintQuantity, address _recipient, address _creator, string calldata _uri ) external returns (uint256); /// @dev Allows creation of an edition including minting a portion (or all) tokens upfront to any address, setting metadata and a funds handler for this edition function createEditionAsCollaboration( uint32 _editionSize, uint256 _mintQuantity, address _recipient, address _creator, address _collabFundsHandler, string calldata _uri ) external returns (uint256 editionId); /// @dev allows the contract owner to creates an edition of specified size and mints all tokens to their address function createEditionAndMintToOwner( uint32 _editionSize, string calldata _uri ) external returns (uint256); /// @dev Allows the contract owner to create an edition of specified size for lazy minting function createOpenEdition( uint32 _editionSize, string calldata _uri ) external returns (uint256); /// @dev Allows the contract owner to create an edition of specified size for lazy minting as a collaboration with another entity, passing in a seperate funds handler for the edition function createOpenEditionAsCollaboration( uint32 _editionSize, address _collabFundsHandler, string calldata _uri ) external returns (uint256 editionId); /// @dev Allows the contract owner to add additional minters if the appropriate minting logic is in place function updateAdditionalMinterEnabled( address _minter, bool _enabled ) external; /// @dev Allows the contract owner to set a specific fund handler for an edition, otherwise the default for all editions is used function updateEditionFundsHandler( uint256 _editionId, address _fundsHandler ) external; /// @dev allows the contract owner to update the number of tokens that can be minted in an edition function updateEditionSize( uint256 _editionId, uint32 _editionSize ) external; /// @dev Provided no primary sale has been made, an artist can correct any mistakes in their token URI function updateURIIfNoSaleMade( uint256 _editionId, string calldata _newURI ) external; }
pragma solidity 0.8.17; // SPDX-License-Identifier: MIT /// @author KnownOrigin Labs - https://knownorigin.io/ interface IERC721KODACreatorWithBuyItNow { error AlreadyListed(); error EditionNotListed(); error EditionSalesDisabled(); error InvalidEdition(); error InvalidFeesTotal(); error InvalidListing(); error InvalidPrice(); error TooEarly(); error TooLate(); error TransferFailed(); error InvalidToken(); event BuyNowDeListed(uint256 indexed _editionId); event BuyNowPriceChanged(uint256 indexed _editionId, uint256 _price); event BuyNowPurchased( uint256 indexed _tokenId, address _buyer, address _currentOwner, uint256 _price ); event BuyNowTokenDeListed(uint256 indexed _tokenId); event BuyNowTokenPriceChanged(uint256 indexed _tokenId, uint256 _price); event BuyNowTokenPurchased( uint256 indexed _tokenId, address _caller, address _recipient, address _currentOwner, uint256 _price ); event ListedEditionForBuyNow( uint256 indexed _editionId, uint96 _price, uint128 _startDate ); event ListedTokenForBuyNow( address indexed _seller, uint256 indexed _tokenId, uint96 _price, uint128 _startDate, uint128 _endDate ); struct EditionListing { uint128 price; uint128 startDate; uint128 endDate; } struct TokenListing { address seller; uint128 price; } /// @dev allows the purchase of the next available token for sale from an edition listing function buyEditionToken( uint256 _editionId, address _recipient ) external payable; /// @dev allows the owner of a token to create a secondary buy it now listing function createTokenBuyItNowListing( uint256 _tokenId, uint96 _listingPrice, uint128 _startDate, uint128 _endDate ) external; /// @dev allows the owner of a token to remove a listing for the token function deleteTokenBuyItNowListing(uint256 _tokenId) external; /// @dev allows the owner of a token to update the price function updateTokenBuyItNowListingPrice( uint256 _tokenId, uint96 _listingPrice ) external; /// @dev allows the purchase of a token listed for sale function buyToken(uint256 _tokenId, address _recipient) external payable; /// @dev Get a token listing just from token ID and not worrying about current Owner function getTokenListing( uint256 _tokenId ) external view returns (TokenListing memory); /// @dev allows the contract owner to create a listing to enable sales of tokens from an edition function createEditionBuyItNowListing( uint256 _editionId, uint96 _listingPrice, uint128 _startDate, uint128 _endDate ) external; /// @dev allows the contract owner to remove an edition listing function deleteEditionBuyItNowListing(uint256 _editionId) external; /// @dev allows the contract owner to create a pre-minted edition and immediately list it for buy it now sales function mintAndListEditionForBuyNow( uint32 _editionSize, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, string calldata _uri ) external returns (uint256); /// @dev allows the contract owner to create an open edition and immediately list it for buy it now sales function setupAndListOpenEdition( string calldata _uri, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, uint32 _customMintLimit ) external returns (uint256 _editionId); /// @dev allows the contract owner to create an open edition and immediately list it for buy it now sales function setupAndListOpenEditionAsCollaboration( string calldata _uri, uint96 _listingPrice, uint128 _startDate, uint128 _endDate, uint32 _customMintLimit, address _collabFundsHandler ) external returns (uint256 _editionId); /// @dev allows the contract owner to update the price of edition tokens listed for sale function updateEditionBuyItNowListingPrice( uint256 _editionId, uint96 _listingPrice ) external; }
pragma solidity 0.8.17; // SPDX-License-Identifier: MIT import {IERC721Metadata} from "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol"; import {IERC2981} from "@openzeppelin/contracts/interfaces/IERC2981.sol"; import {ITokenUriResolver} from "../../interfaces/ITokenUriResolver.sol"; /// @author KnownOrigin Labs - https://knownorigin.io/ interface IERC721KODAEditions is IERC721Metadata, IERC2981 { error BatchOrUnknownEdition(); error EditionDoesNotExist(); error EditionSizeExceeded(); error InvalidRange(); error InvalidEditionSize(); error InvalidMintQuantity(); error InvalidRecipient(); error NotAuthorised(); error TokenAlreadyMinted(); error TokenDoesNotExist(); /// @dev emitted when a new edition is created event EditionCreated(uint256 indexed _editionId); /// @dev emitted when the creator address for an edition is updated event EditionCreatorUpdated(uint256 indexed _editionId, address _creator); /// @dev emitted when the owner updates the edition override for secondary royalty event EditionRoyaltyPercentageUpdated( uint256 indexed _editionId, uint256 _percentage ); /// @dev emitted when edition sales are enabled/disabled event EditionSalesDisabledUpdated( uint256 indexed _editionId, bool _disabled ); /// @dev emitted when the edition metadata URI is updated event EditionURIUpdated(uint256 indexed _editionId); /// @dev emitted when the external token metadata URI resolver is updated event TokenURIResolverUpdated(address indexed _tokenUriResolver); /// @dev Struct defining the properties of an edition stored internally struct Edition { uint32 editionSize; // on-chain edition size bool isOpenEdition; // true if not all tokens were minted at creation string uri; // the referenced metadata } /// @dev Struct defining the full property set of an edition exposed externally struct EditionDetails { address owner; address creator; uint256 editionId; uint256 mintedCount; uint256 size; bool isOpenEdition; string uri; } /// @dev struct defining the ownership record of an edition struct EditionOwnership { uint256 editionId; address editionOwner; } /// @dev returns the creator address for an edition used to indicate if the NFT creator is different to the contract creator/owner function editionCreator(uint256 _editionId) external view returns (address); /// @dev returns the full set of properties for an edition, see {EditionDetails} function editionDetails( uint256 _editionId ) external view returns (EditionDetails memory); /// @dev returns whether the edition exists or not function editionExists(uint256 _editionId) external view returns (bool); /// @dev returns the maximum possible token ID that can be minted in an edition function editionMaxTokenId( uint256 _editionId ) external view returns (uint256); /// @dev returns the number of tokens currently minted in an edition function editionMintedCount( uint256 _editionId ) external view returns (uint256); /// @dev returns the owner of an edition, by default this will be the contract owner at the time the edition was first created function editionOwner(uint256 _editionId) external view returns (address); /// @dev returns the royalty percentage used for secondary sales of an edition function editionRoyaltyPercentage( uint256 _editionId ) external view returns (uint256); /// @dev returns a boolean indicating whether sales are disabled or not for an edition function editionSalesDisabled( uint256 _editionId ) external view returns (bool); /// @dev returns a boolean indicating whether an edition is sold out (primary market) or sales are otherwise disabled function editionSalesDisabledOrSoldOut( uint256 _editionId ) external view returns (bool); /// @dev returns a boolean indicating whether an edition is sold out (primary market) or sales are otherwise disabled function editionSalesDisabledOrSoldOutFrom( uint256 _editionId, uint256 _startId ) external view returns (bool); /// @dev returns the size (the maximum number of tokens that can be minted) of an edition function editionSize(uint256 _editionId) external view returns (uint256); /// @dev returns a boolean indicating whether primary listings of an edition have sold out or not function editionSoldOut(uint256 _editionId) external view returns (bool); /// @dev returns a boolean indicating whether primary listings of an edition have sold out or not in a range function editionSoldOutFrom( uint256 _editionId, uint256 _startId ) external view returns (bool); /// @dev returns the metadata URI for an edition function editionURI( uint256 _editionId ) external view returns (string memory); /// @dev returns the edition creator address for the edition that a token with `_tokenId` belongs to function tokenEditionCreator( uint256 _tokenId ) external view returns (address); /// @dev returns the full set of properties of the edition that token `_tokenId` belongs to, see {EditionDetails} function tokenEditionDetails( uint256 _tokenId ) external view returns (EditionDetails memory); /// @dev returns the ID of an edition that a token with ID `_tokenId` belongs to function tokenEditionId(uint256 _tokenId) external view returns (uint256); /// @dev returns the size of the edition that a token with `_tokenId` belongs to function tokenEditionSize(uint256 _tokenId) external view returns (uint256); /// @dev returns a boolean indicating whether an external token metadata URI resolver is active or not function tokenUriResolverActive() external view returns (bool); /// @dev used to execute a simultaneous transfer of multiple tokens with IDs `_tokenIds` function batchTransferFrom( address _from, address _to, uint256[] calldata _tokenIds ) external; /// @dev used to enabled/disable sales of an edition function toggleEditionSalesDisabled(uint256 _editionId) external; /// @dev used to update the address of the creator associated with the works of an edition function updateEditionCreator( uint256 _editionId, address _creator ) external; /// @dev used to update the royalty percentage for external secondary sales of tokens belonging to a specific edition function updateEditionRoyaltyPercentage( uint256 _editionId, uint256 _percentage ) external; /// @dev used to set an external token URI resolver for the contract function updateTokenURIResolver( ITokenUriResolver _tokenUriResolver ) external; }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; error AlreadyListed(); error AlreadySet(); error EditionDisabled(); error EditionNotListed(); error EditionSalesDisabled(); error EmptyString(); error InvalidListing(); error InvalidOwner(); error InvalidPrice(); error InvalidToken(); error IsOpenEdition(); error OnlyAdmin(); error OnlyVerifiedArtist(); error OwnerRevoked(); error PrimarySaleMade(); error TooEarly(); error TransferFailed(); error ZeroAddress();
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; interface IKOAccessControlsLookup { function hasAdminRole(address _address) external view returns (bool); function isVerifiedArtist( uint256 _index, address _account, bytes32[] calldata _merkleProof ) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; /** * @dev required interface for the base contract for KnownOrigin Creator Contracts */ interface IKODABaseUpgradeable { error MaxRoyaltyPercentageExceeded(); /// @dev Emitted when additional minter addresses are enabled or disabled event AdditionalMinterEnabled(address indexed _minter, bool _enabled); /// @dev Emitted when additional creator addresses are enabled or disabled event AdditionalCreatorEnabled(address indexed _creator, bool _enabled); /// @dev Emitted when the owner updates the default secondary royalty percentage event DefaultRoyaltyPercentageUpdated(uint256 _percentage); /// @dev Allows the owner to pause some contract actions function pause() external; /// @dev Allows the owner to unpause function unpause() external; /// @dev Allows the contract owner to update the default secondary sale royalty percentage function updateDefaultRoyaltyPercentage(uint256 _percentage) external; }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; import {IKOAccessControlsLookup} from "./IKOAccessControlsLookup.sol"; interface IKODASettings { error MaxCommissionExceeded(); error OnlyAdmin(); event PlatformPrimaryCommissionUpdated(uint256 _percentage); event PlatformSecondaryCommissionUpdated(uint256 _percentage); event PlatformUpdated(address indexed _platform); event BaseKOAPIUpdated(string _baseKOApi); function initialize( address _platform, string calldata _baseKOApi, IKOAccessControlsLookup _accessControls ) external; /// @notice Admin update for primary sale platform percentage for V4 or newer KODA contracts when sold within platform function updatePlatformPrimaryCommission(uint256 _percentage) external; /// @notice Admin update for secondary sale platform percentage for V4 or newer KODA contracts when sold within platform function updatePlatformSecondaryCommission(uint256 _percentage) external; /// @notice Admin can update the address that will receive proceeds from primary and secondary sales function setPlatform(address _platform) external; /// @notice Admin can update the base KO API function setBaseKOApi(string calldata _baseKOApi) external; }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; interface ITokenUriResolver { /// @notice Return the edition or token level URI - token level trumps edition level if found function tokenURI( uint256 _editionId, uint256 _tokenId ) external view returns (string memory); /// @notice Do we have an edition level or token level token URI resolver set function isDefined( uint256 _editionId, uint256 _tokenId ) external view returns (bool); }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; import {OwnableUpgradeable} from "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol"; import {PausableUpgradeable} from "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol"; import {ReentrancyGuardUpgradeable} from "@openzeppelin/contracts-upgradeable/security/ReentrancyGuardUpgradeable.sol"; import {Konstants} from "./Konstants.sol"; import {IKODABaseUpgradeable} from "./interfaces/IKODABaseUpgradeable.sol"; /** * @dev Base contract for KnownOrigin Creator NFT minting contracts * * - requires IKODABaseUpgradable interface for errors and events * - requires OpenZeppelin upgradable contracts to make inheriting contracts ownable and pausable * * - includes storage of default secondary marketplace royalties and additionally enabled minting addresses managed by the owner */ abstract contract KODABaseUpgradeable is OwnableUpgradeable, PausableUpgradeable, ReentrancyGuardUpgradeable, Konstants, IKODABaseUpgradeable { /** * @notice Default Royalty Percentage for Secondary Sales * @dev default percentage value used to calculate royalty consideration on secondary sales stored with the same precision as `MODULO` */ uint256 public defaultRoyaltyPercentage; // * Upgradeable Init * // /** * @notice Initialise the base contract with the default royalty percentage * @dev the inheriting contract must call otherwise the secondary royalty will be zero * @param _initialRoyaltyPercentage percentage to initially set the contract default royalty */ function __KODABase_init(uint256 _initialRoyaltyPercentage) internal { __ReentrancyGuard_init(); _updateDefaultRoyaltyPercentage(_initialRoyaltyPercentage); } // * OWNER * // /// @notice Allows the owner to pause some contract actions function pause() external onlyOwner whenNotPaused { _pause(); } /// @notice Allows the owner to unpause function unpause() external onlyOwner whenPaused { _unpause(); } /** * @notice Set the default royalty percentage to `_percentage` * @dev allows the owner to set {defaultRoyaltyPercentage} * @param _percentage the value to set with the same precision as {KODASettings-MODULO} */ function updateDefaultRoyaltyPercentage( uint256 _percentage ) external onlyOwner { _updateDefaultRoyaltyPercentage(_percentage); } // * INTERNAL * // /// @dev Internal method for updating the the secondary royalty percentage used for calculating royalty for external marketplaces function _updateDefaultRoyaltyPercentage(uint256 _percentage) internal { if (_percentage > MAX_ROYALTY_PERCENTAGE) revert MaxRoyaltyPercentageExceeded(); defaultRoyaltyPercentage = _percentage; emit DefaultRoyaltyPercentageUpdated(_percentage); } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; import {UUPSUpgradeable} from "@openzeppelin/contracts-upgradeable/proxy/utils/UUPSUpgradeable.sol"; import {IKOAccessControlsLookup} from "./interfaces/IKOAccessControlsLookup.sol"; import {IKODASettings} from "./interfaces/IKODASettings.sol"; import {ZeroAddress} from "./errors/KODAErrors.sol"; import {Konstants} from "./Konstants.sol"; /// @title KnownOrigin Generalised Marketplace Settings For KODA Version 4 and beyond /// @notice KODASettings grants flexibility in commission collected at primary and secondary point of sale contract KODASettings is UUPSUpgradeable, Konstants, IKODASettings { /// @notice Address of the contract that defines who can update settings IKOAccessControlsLookup public accessControls; /// @notice Fee applied to all primary sales uint256 public platformPrimaryCommission; /// @notice Fee applied to all secondary sales uint256 public platformSecondaryCommission; /// @notice Address of the platform handler address public platform; /// @notice Base KO API endpoint string public baseKOApi; /// @custom:oz-upgrades-unsafe-allow constructor constructor() initializer {} function initialize( address _platform, string calldata _baseKOApi, IKOAccessControlsLookup _accessControls ) external initializer { if (_platform == address(0)) revert ZeroAddress(); if (address(_accessControls) == address(0)) revert ZeroAddress(); __UUPSUpgradeable_init(); platformPrimaryCommission = 15_00000; platformSecondaryCommission = 2_50000; platform = _platform; baseKOApi = _baseKOApi; accessControls = _accessControls; } /// @dev Only admins can trigger smart contract upgrades function _authorizeUpgrade(address) internal view override { if (!accessControls.hasAdminRole(msg.sender)) revert OnlyAdmin(); } /// @notice Admin update for primary sale platform percentage for V4 or newer KODA contracts when sold within platform /// @dev It is possible to set this value to zero function updatePlatformPrimaryCommission(uint256 _percentage) external { if (!accessControls.hasAdminRole(msg.sender)) revert OnlyAdmin(); if (_percentage > MAX_PLATFORM_COMMISSION) revert MaxCommissionExceeded(); platformPrimaryCommission = _percentage; emit PlatformPrimaryCommissionUpdated(_percentage); } /// @notice Admin update for secondary sale platform percentage for V4 or newer KODA contracts when sold within platform /// @dev It is possible to set this value to zero function updatePlatformSecondaryCommission(uint256 _percentage) external { if (!accessControls.hasAdminRole(msg.sender)) revert OnlyAdmin(); if (_percentage > MAX_PLATFORM_COMMISSION) revert MaxCommissionExceeded(); platformSecondaryCommission = _percentage; emit PlatformSecondaryCommissionUpdated(_percentage); } /// @notice Admin can update the address that will receive proceeds from primary and secondary sales function setPlatform(address _platform) external { if (!accessControls.hasAdminRole(msg.sender)) revert OnlyAdmin(); if (_platform == address(0)) revert ZeroAddress(); platform = _platform; emit PlatformUpdated(_platform); } /// @notice Admin can update the base KO API function setBaseKOApi(string calldata _baseKOApi) external { if (!accessControls.hasAdminRole(msg.sender)) revert OnlyAdmin(); baseKOApi = _baseKOApi; emit BaseKOAPIUpdated(_baseKOApi); } }
// SPDX-License-Identifier: MIT pragma solidity 0.8.17; contract Konstants { /// @notice Maximum Platform Commission for Primary and Secondary Sales /// @dev precision 100.00000% uint24 public constant MAX_PLATFORM_COMMISSION = 50_00000; /// @notice Maximum Royalty Percentage for Secondary Sales /// @dev precision 100.00000% uint24 public constant MAX_ROYALTY_PERCENTAGE = 50_00000; /// @notice Denominator used for percentage calculations /// @dev precision 100.00000% uint24 public constant MODULO = 100_00000; }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.17; interface IOperatorFilterRegistry { function isOperatorAllowed( address registrant, address operator ) external view returns (bool); function register(address registrant) external; function registerAndSubscribe( address registrant, address subscription ) external; function registerAndCopyEntries( address registrant, address registrantToCopy ) external; function unregister(address addr) external; function updateOperator( address registrant, address operator, bool filtered ) external; function updateOperators( address registrant, address[] calldata operators, bool filtered ) external; function updateCodeHash( address registrant, bytes32 codehash, bool filtered ) external; function updateCodeHashes( address registrant, bytes32[] calldata codeHashes, bool filtered ) external; function subscribe( address registrant, address registrantToSubscribe ) external; function unsubscribe(address registrant, bool copyExistingEntries) external; function subscriptionOf(address addr) external returns (address registrant); function subscribers( address registrant ) external returns (address[] memory); function subscriberAt( address registrant, uint256 index ) external returns (address); function copyEntriesOf( address registrant, address registrantToCopy ) external; function isOperatorFiltered( address registrant, address operator ) external returns (bool); function isCodeHashOfFiltered( address registrant, address operatorWithCode ) external returns (bool); function isCodeHashFiltered( address registrant, bytes32 codeHash ) external returns (bool); function filteredOperators( address addr ) external returns (address[] memory); function filteredCodeHashes( address addr ) external returns (bytes32[] memory); function filteredOperatorAt( address registrant, uint256 index ) external returns (address); function filteredCodeHashAt( address registrant, uint256 index ) external returns (bytes32); function isRegistered(address addr) external returns (bool); function codeHashOf(address addr) external returns (bytes32); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.17; import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol"; import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol"; /** * @title UpdatableOperatorFiltererUpgradeable * @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another * registrant's entries in the OperatorFilterRegistry. This contract allows the Owner to update the * OperatorFilterRegistry address via updateOperatorFilterRegistryAddress, including to the zero address, * which will bypass registry checks. * Note that OpenSea will still disable creator fee enforcement if filtered operators begin fulfilling orders * on-chain, eg, if the registry is revoked or bypassed. * @dev This smart contract is meant to be inherited by token contracts so they can use the following: * - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods. * - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods. */ abstract contract UpdatableOperatorFiltererUpgradeable is Initializable { error OperatorNotAllowed(address operator); error OnlyOwner(); IOperatorFilterRegistry public operatorFilterRegistry; /** * @notice Initialise the operator filterer * @param _registry address of operator filter registry * @param subscriptionOrRegistrantToCopy address of subscription or registrant to copy * @param subscribe boolean if to subscribe */ function _UpdatableOperatorFilterer_init( address _registry, address subscriptionOrRegistrantToCopy, bool subscribe ) internal onlyInitializing { operatorFilterRegistry = IOperatorFilterRegistry(_registry); // If an inheriting token contract is deployed to a network without the registry deployed, the modifier // will not revert, but the contract will need to be registered with the registry once it is deployed in // order for the modifier to filter addresses. _performFilterRegistryRegistrationOperations( subscriptionOrRegistrantToCopy, subscribe ); } modifier onlyAllowedOperator(address from) virtual { // Allow spending tokens from addresses with balance // Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred // from an EOA. if (from != msg.sender) { _checkFilterOperator(msg.sender); } _; } modifier onlyAllowedOperatorApproval(address operator) virtual { _checkFilterOperator(operator); _; } /** * @notice Update the address that the contract will make OperatorFilter checks against. When set to the zero * address, checks will be bypassed. OnlyOwner. */ function updateOperatorFilterRegistryAddress( address newRegistry, address subscriptionOrRegistrantToCopy, bool subscribe ) public virtual { if (msg.sender != owner()) revert OnlyOwner(); operatorFilterRegistry = IOperatorFilterRegistry(newRegistry); _performFilterRegistryRegistrationOperations( subscriptionOrRegistrantToCopy, subscribe ); } /** * @dev assume the contract has an owner, but leave specific Ownable implementation up to inheriting contract */ function owner() public view virtual returns (address); function _checkFilterOperator(address operator) internal view virtual { IOperatorFilterRegistry registry = operatorFilterRegistry; // Check registry code length to facilitate testing in environments without a deployed registry. if ( address(registry) != address(0) && address(registry).code.length > 0 ) { if (!registry.isOperatorAllowed(address(this), operator)) { revert OperatorNotAllowed(operator); } } } /// @dev Optionally perform additional registration operations after updating the operator filter registry function _performFilterRegistryRegistrationOperations( address subscriptionOrRegistrantToCopy, bool subscribe ) internal { if (address(operatorFilterRegistry).code.length > 0) { if (subscribe) { operatorFilterRegistry.registerAndSubscribe( address(this), subscriptionOrRegistrantToCopy ); } else { if (subscriptionOrRegistrantToCopy != address(0)) { operatorFilterRegistry.registerAndCopyEntries( address(this), subscriptionOrRegistrantToCopy ); } else { operatorFilterRegistry.register(address(this)); } } } } }
{ "optimizer": { "enabled": true, "runs": 1000, "details": { "yul": true } }, "viaIR": true, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "libraries": {} }
[{"inputs":[],"name":"AlreadyListed","type":"error"},{"inputs":[],"name":"AlreadySet","type":"error"},{"inputs":[],"name":"BatchOrUnknownEdition","type":"error"},{"inputs":[],"name":"EditionDisabled","type":"error"},{"inputs":[],"name":"EditionDoesNotExist","type":"error"},{"inputs":[],"name":"EditionNotListed","type":"error"},{"inputs":[],"name":"EditionSalesDisabled","type":"error"},{"inputs":[],"name":"EditionSizeExceeded","type":"error"},{"inputs":[],"name":"EditionSizeTooLarge","type":"error"},{"inputs":[],"name":"EditionSizeTooSmall","type":"error"},{"inputs":[],"name":"EmptyString","type":"error"},{"inputs":[],"name":"InvalidEdition","type":"error"},{"inputs":[],"name":"InvalidEditionSize","type":"error"},{"inputs":[],"name":"InvalidFeesTotal","type":"error"},{"inputs":[],"name":"InvalidListing","type":"error"},{"inputs":[],"name":"InvalidMintQuantity","type":"error"},{"inputs":[],"name":"InvalidOwner","type":"error"},{"inputs":[],"name":"InvalidPrice","type":"error"},{"inputs":[],"name":"InvalidRange","type":"error"},{"inputs":[],"name":"InvalidRecipient","type":"error"},{"inputs":[],"name":"InvalidToken","type":"error"},{"inputs":[],"name":"IsOpenEdition","type":"error"},{"inputs":[],"name":"MaxRoyaltyPercentageExceeded","type":"error"},{"inputs":[],"name":"NotAuthorised","type":"error"},{"inputs":[],"name":"OnlyOwner","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","type":"error"},{"inputs":[],"name":"OwnerRevoked","type":"error"},{"inputs":[],"name":"PrimarySaleMade","type":"error"},{"inputs":[],"name":"TokenAlreadyMinted","type":"error"},{"inputs":[],"name":"TokenDoesNotExist","type":"error"},{"inputs":[],"name":"TooEarly","type":"error"},{"inputs":[],"name":"TooLate","type":"error"},{"inputs":[],"name":"TransferFailed","type":"error"},{"inputs":[],"name":"ZeroAddress","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_creator","type":"address"},{"indexed":false,"internalType":"bool","name":"_enabled","type":"bool"}],"name":"AdditionalCreatorEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_minter","type":"address"},{"indexed":false,"internalType":"bool","name":"_enabled","type":"bool"}],"name":"AdditionalMinterEnabled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"BuyNowDeListed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_price","type":"uint256"}],"name":"BuyNowPriceChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"},{"indexed":false,"internalType":"address","name":"_buyer","type":"address"},{"indexed":false,"internalType":"address","name":"_currentOwner","type":"address"},{"indexed":false,"internalType":"uint256","name":"_price","type":"uint256"}],"name":"BuyNowPurchased","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"BuyNowTokenDeListed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_price","type":"uint256"}],"name":"BuyNowTokenPriceChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"},{"indexed":false,"internalType":"address","name":"_caller","type":"address"},{"indexed":false,"internalType":"address","name":"_recipient","type":"address"},{"indexed":false,"internalType":"address","name":"_currentOwner","type":"address"},{"indexed":false,"internalType":"uint256","name":"_price","type":"uint256"}],"name":"BuyNowTokenPurchased","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_percentage","type":"uint256"}],"name":"DefaultRoyaltyPercentageUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"EditionCreated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"address","name":"_creator","type":"address"}],"name":"EditionCreatorUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":true,"internalType":"address","name":"_handler","type":"address"}],"name":"EditionFundsHandlerUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_percentage","type":"uint256"}],"name":"EditionRoyaltyPercentageUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"bool","name":"_disabled","type":"bool"}],"name":"EditionSalesDisabledUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_editionSize","type":"uint256"}],"name":"EditionSizeUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"EditionURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"_editionId","type":"uint256"},{"indexed":false,"internalType":"uint96","name":"_price","type":"uint96"},{"indexed":false,"internalType":"uint128","name":"_startDate","type":"uint128"}],"name":"ListedEditionForBuyNow","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_seller","type":"address"},{"indexed":true,"internalType":"uint256","name":"_tokenId","type":"uint256"},{"indexed":false,"internalType":"uint96","name":"_price","type":"uint96"},{"indexed":false,"internalType":"uint128","name":"_startDate","type":"uint128"},{"indexed":false,"internalType":"uint128","name":"_endDate","type":"uint128"}],"name":"ListedTokenForBuyNow","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Paused","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"_tokenUriResolver","type":"address"}],"name":"TokenURIResolverUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"address","name":"account","type":"address"}],"name":"Unpaused","type":"event"},{"inputs":[],"name":"MAX_EDITION_SIZE","outputs":[{"internalType":"uint32","name":"","type":"uint32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_PLATFORM_COMMISSION","outputs":[{"internalType":"uint24","name":"","type":"uint24"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_ROYALTY_PERCENTAGE","outputs":[{"internalType":"uint24","name":"","type":"uint24"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MODULO","outputs":[{"internalType":"uint24","name":"","type":"uint24"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"additionalCreatorEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"additionalMinterEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_approved","type":"address"},{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256[]","name":"_tokenIds","type":"uint256[]"}],"name":"batchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"}],"name":"buyEditionToken","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"}],"name":"buyToken","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"uint256","name":"_mintQuantity","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"},{"internalType":"address","name":"_creator","type":"address"},{"internalType":"string","name":"_uri","type":"string"}],"name":"createEdition","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"string","name":"_uri","type":"string"}],"name":"createEditionAndMintToOwner","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"uint256","name":"_mintQuantity","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"},{"internalType":"address","name":"_creator","type":"address"},{"internalType":"address","name":"_collabFundsHandler","type":"address"},{"internalType":"string","name":"_uri","type":"string"}],"name":"createEditionAsCollaboration","outputs":[{"internalType":"uint256","name":"editionId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"}],"name":"createEditionBuyItNowListing","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"string","name":"_uri","type":"string"}],"name":"createOpenEdition","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"address","name":"_collabFundsHandler","type":"address"},{"internalType":"string","name":"_uri","type":"string"}],"name":"createOpenEditionAsCollaboration","outputs":[{"internalType":"uint256","name":"editionId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"}],"name":"createTokenBuyItNowListing","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"defaultFundsHandler","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"defaultRoyaltyPercentage","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"deleteEditionBuyItNowListing","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"deleteTokenBuyItNowListing","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionCreator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionDetails","outputs":[{"components":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"creator","type":"address"},{"internalType":"uint256","name":"editionId","type":"uint256"},{"internalType":"uint256","name":"mintedCount","type":"uint256"},{"internalType":"uint256","name":"size","type":"uint256"},{"internalType":"bool","name":"isOpenEdition","type":"bool"},{"internalType":"string","name":"uri","type":"string"}],"internalType":"struct IERC721KODAEditions.EditionDetails","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionExists","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionFundsHandler","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"editionListing","outputs":[{"internalType":"uint128","name":"price","type":"uint128"},{"internalType":"uint128","name":"startDate","type":"uint128"},{"internalType":"uint128","name":"endDate","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionMaxTokenId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionMintedCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionRoyaltyPercentage","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionSalesDisabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionSalesDisabledOrSoldOut","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint256","name":"_startId","type":"uint256"}],"name":"editionSalesDisabledOrSoldOutFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionSize","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionSoldOut","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint256","name":"_startId","type":"uint256"}],"name":"editionSoldOutFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"editionURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"exists","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"getNextAvailablePrimarySaleToken","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint256","name":"_startId","type":"uint256"}],"name":"getNextAvailablePrimarySaleToken","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"getTokenListing","outputs":[{"components":[{"internalType":"address","name":"seller","type":"address"},{"internalType":"uint128","name":"price","type":"uint128"}],"internalType":"struct IERC721KODACreatorWithBuyItNow.TokenListing","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_artistAndOwner","type":"address"},{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"},{"internalType":"address","name":"_defaultFundsHandler","type":"address"},{"internalType":"contract KODASettings","name":"_settings","type":"address"},{"internalType":"uint256","name":"_secondaryRoyaltyPercentage","type":"uint256"},{"internalType":"address","name":"_operatorRegistry","type":"address"},{"internalType":"address","name":"_subscriptionOrRegistrantToCopy","type":"address"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_owner","type":"address"},{"internalType":"address","name":"_operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"isOpenEdition","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"kodaSettings","outputs":[{"internalType":"contract KODASettings","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"},{"internalType":"address","name":"_collabFundsHandler","type":"address"},{"internalType":"string","name":"_uri","type":"string"}],"name":"mintAndListEditionAsCollaborationForBuyNow","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"},{"internalType":"string","name":"_uri","type":"string"}],"name":"mintAndListEditionForBuyNow","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint256","name":"_quantity","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"}],"name":"mintMultipleOpenEditionTokens","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"address","name":"_recipient","type":"address"}],"name":"mintOpenEditionToken","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextEditionId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"operatorFilterRegistry","outputs":[{"internalType":"contract IOperatorFilterRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"originalDeployer","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"paused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint256","name":"_salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"bytes","name":"_data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_operator","type":"address"},{"internalType":"bool","name":"_approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_uri","type":"string"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"},{"internalType":"uint32","name":"_editionSize","type":"uint32"}],"name":"setupAndListOpenEdition","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_uri","type":"string"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"},{"internalType":"uint128","name":"_startDate","type":"uint128"},{"internalType":"uint128","name":"_endDate","type":"uint128"},{"internalType":"uint32","name":"_editionSize","type":"uint32"},{"internalType":"address","name":"_collabFundsHandler","type":"address"}],"name":"setupAndListOpenEditionAsCollaboration","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"}],"name":"toggleEditionSalesDisabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenEditionCreator","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenEditionDetails","outputs":[{"components":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"creator","type":"address"},{"internalType":"uint256","name":"editionId","type":"uint256"},{"internalType":"uint256","name":"mintedCount","type":"uint256"},{"internalType":"uint256","name":"size","type":"uint256"},{"internalType":"bool","name":"isOpenEdition","type":"bool"},{"internalType":"string","name":"uri","type":"string"}],"internalType":"struct IERC721KODAEditions.EditionDetails","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenEditionId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenEditionSize","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"address","name":"","type":"address"}],"name":"tokenListing","outputs":[{"internalType":"address","name":"seller","type":"address"},{"internalType":"uint128","name":"price","type":"uint128"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenUriResolver","outputs":[{"internalType":"contract ITokenUriResolver","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenUriResolverActive","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_from","type":"address"},{"internalType":"address","name":"_to","type":"address"},{"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"unpause","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_creator","type":"address"},{"internalType":"bool","name":"_enabled","type":"bool"}],"name":"updateAdditionalCreatorEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_minter","type":"address"},{"internalType":"bool","name":"_enabled","type":"bool"}],"name":"updateAdditionalMinterEnabled","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_percentage","type":"uint256"}],"name":"updateDefaultRoyaltyPercentage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"}],"name":"updateEditionBuyItNowListingPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"address","name":"_creator","type":"address"}],"name":"updateEditionCreator","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"address","name":"_fundsHandler","type":"address"}],"name":"updateEditionFundsHandler","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint256","name":"_percentage","type":"uint256"}],"name":"updateEditionRoyaltyPercentage","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"uint32","name":"_editionSize","type":"uint32"}],"name":"updateEditionSize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newRegistry","type":"address"},{"internalType":"address","name":"subscriptionOrRegistrantToCopy","type":"address"},{"internalType":"bool","name":"subscribe","type":"bool"}],"name":"updateOperatorFilterRegistryAddress","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_tokenId","type":"uint256"},{"internalType":"uint96","name":"_listingPrice","type":"uint96"}],"name":"updateTokenBuyItNowListingPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"contract ITokenUriResolver","name":"_tokenUriResolver","type":"address"}],"name":"updateTokenURIResolver","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_editionId","type":"uint256"},{"internalType":"string","name":"_newURI","type":"string"}],"name":"updateURIIfNoSaleMade","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"version","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"}]
Loading...
Loading
Loading...
Loading
OVERVIEW
Meet HDRhunter, a digital artist and researcher of AI tools for creating art.Multichain Portfolio | 26 Chains
Chain | Token | Portfolio % | Price | Amount | Value |
---|
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.