Warning! Contract bytecode has been changed and doesn't match the verified one. Therefore, interaction with this smart contract may be risky.
- Contract name:
- NomisScore
- Optimization enabled
- true
- Compiler version
- v0.8.19+commit.7dd6d404
- Optimization runs
- 200
- EVM Version
- default
- Verified at
- 2024-02-28T08:59:56.066212Z
contracts/NomisScore.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.19;
import "@openzeppelin/contracts-upgradeable/utils/cryptography/EIP712Upgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol";
import "./NomisReferralManager.sol";
import "./NomisPriceManager.sol";
///////////////////////////////////////////////////////////////
// ___ __ ______ ___ __ __ ________ ______ //
// /__/\ /__/\ /_____/\ /__//_//_/\ /_______/\/_____/\ //
// \::\_\\ \ \\:::_ \ \\::\| \| \ \ \__.::._\/\::::_\/_ //
// \:. `-\ \ \\:\ \ \ \\:. \ \ \::\ \ \:\/___/\ //
// \:. _ \ \\:\ \ \ \\:.\-/\ \ \ _\::\ \__\_::._\:\ //
// \. \`-\ \ \\:\_\ \ \\. \ \ \ \/__\::\__/\ /____\:\ //
// \__\/ \__\/ \_____\/ \__\/ \__\/\________\/ \_____\/ //
// //
///////////////////////////////////////////////////////////////
/**
* @title NomisScore
* @dev The NomisScore contract is an ERC721 token contract with additional functionality for managing scores.
* @custom:security-contact info@nomis.cc
*/
contract NomisScore is
NomisReferralManager,
NomisPriceManager,
EIP712Upgradeable
{
using CountersUpgradeable for CountersUpgradeable.Counter;
CountersUpgradeable.Counter private _tokenIds;
/*#########################
## Variables ##
##########################*/
string private _baseUri;
/*#########################
## Events ##
##########################*/
/**
* @dev Emitted when a score is minted or changed.
* @param tokenId The changed token id.
* @param owner The address to which the score is being changed.
* @param score The score being changed.
* @param calculationModel The scoring calculation model.
* @param chainId The blockchain id in which the score was calculated.
*/
event ChangedScore(
uint256 indexed tokenId,
address indexed owner,
uint16 score,
uint16 calculationModel,
uint256 chainId,
string metadataUrl,
string referralCode,
string referrerCode
);
/**
* @dev Emitted when the owner of the contract withdraws the funds from the contract balance.
* @param owner The address of the owner who withdrew the funds.
* @param balance The amount of funds withdrawn by the owner.
*/
event Withdrawal(address indexed owner, uint256 indexed balance);
/**
* @dev Emitted when the base URI is changed.
* @param baseUri The new base URI.
*/
event ChangedBaseURI(string indexed baseUri);
/*#########################
## Constructor ##
##########################*/
/**
* @dev Constructor for the NomisScore ERC721Upgradeable contract.
* @param initialFee The initial minting fee for the contract.
* @param initialCalcModelsCount The initial scoring calculation models count.
* Initializes the token ID counter to zero and sets the initial minting fee.
*/
function initialize(
uint256 initialFee,
uint16 initialCalcModelsCount
) public initializer {
__ERC721_init("NomisScore", "NMSS");
__EIP712_init("NMSS", "0.9");
__Ownable_init();
_tokenIds.increment();
_mintFee = initialFee;
_updateFee = initialFee;
require(
initialCalcModelsCount > 0,
"constructor: initialCalcModelsCount should be greater than 0"
);
_calcModelsCount = initialCalcModelsCount;
}
/*#########################
## Write Functions ##
##########################*/
/**
* @dev Sets the score for the calling address.
* @param signature The signature used to verify the message.
* @param score The score being set.
* @param calculationModel The scoring calculation model.
* @param deadline The deadline for submitting the transaction.
* @param metadataUrl The URI for the token metadata.
* @param chainId The blockchain id in which the score was calculated.
* @param referralCode The minter referral code.
* @param referrerCode The referrer code.
* @param discountedMintFee The discounted mint fee.
*/
function setScore(
bytes calldata signature,
uint16 score,
uint16 calculationModel,
uint256 deadline,
string calldata metadataUrl,
uint256 chainId,
string calldata referralCode,
string calldata referrerCode,
uint256 discountedMintFee
) external payable whenNotPaused equalsFee(calculationModel, chainId, discountedMintFee) {
require(score <= 10000, "setScore: Score must be less than 10000");
require(
block.timestamp <= deadline,
"setScore: Signed transaction expired"
);
require(
calculationModel < _calcModelsCount,
"setScore: calculationModel should be less than calculation model count"
);
bytes32 referralCodeBytes = keccak256(bytes(referralCode));
bytes32 referrerCodeBytes = keccak256(bytes(referrerCode));
// Verify the signer of the message
bytes32 messageHash = _hashTypedDataV4(
keccak256(
abi.encode(
keccak256(
"SetScoreMessage(uint16 score,uint16 calculationModel,address to,uint256 nonce,uint256 deadline,bytes32 metadataUrl,uint256 chainId,bytes32 referralCode,bytes32 referrerCode,uint256 discountedMintFee)"
),
score,
calculationModel,
msg.sender,
_nonce[msg.sender]++,
deadline,
keccak256(bytes(metadataUrl)),
chainId,
referralCodeBytes,
referrerCodeBytes,
discountedMintFee
)
)
);
address signer = ECDSAUpgradeable.recover(messageHash, signature);
require(
signer == owner() && signer != address(0),
"setScore: Invalid signature"
);
bool isNewScore = false;
Score storage scoreStruct = _score[msg.sender][chainId][
calculationModel
];
if (scoreStruct.updated == 0) {
isNewScore = true;
scoreStruct.tokenId = _tokenIds.current();
}
uint256 tokenId = scoreStruct.tokenId;
scoreStruct.updated = block.timestamp;
if (scoreStruct.value != score) {
scoreStruct.value = score;
}
if (isNewScore) {
_walletToReferralCode[msg.sender] = referralCode;
_referralCodeToWallet[referralCodeBytes] = msg.sender;
_referrerCodeToTokenIds[referrerCodeBytes].push(tokenId);
_safeMint(msg.sender, tokenId);
_tokenIds.increment();
++calculationModelToMintCountUsed[calculationModel];
tokenIdToCalcModel[tokenId] = calculationModel;
tokenIdToChainId[tokenId] = chainId;
_walletToTokenIds[msg.sender].push(tokenId);
if (referrerCodeBytes != 0) {
address referrerWallet = _referralCodeToWallet[
referrerCodeBytes
];
if (referrerWallet != address(0)) {
uint256 rewardValue = 0;
if (_individualReward[referrerWallet] > 0) {
rewardValue = _individualReward[referrerWallet];
} else {
rewardValue = _referralReward;
}
(bool success, ) = payable(referrerWallet).call{
value: rewardValue
}("");
require(success, "setScore: claim referral reward failed");
emit RewardedWallet(msg.sender, block.timestamp);
emit ClaimedReferralReward(
referrerWallet,
rewardValue,
1,
block.timestamp
);
} else {
_claimableReferralWallets[referrerCodeBytes].push(msg.sender);
}
}
}
_setTokenURI(tokenId, metadataUrl);
emit ChangedScore(
tokenId,
msg.sender,
score,
calculationModel,
chainId,
metadataUrl,
referralCode,
referrerCode
);
}
/**
* @dev Allows the contract owner to withdraw a specific amount of native balance held by the contract.
* Can only be called by the owner.
* Emits a {Withdrawal} event upon successful withdrawal.
* Throws a require error if there are no funds available for withdrawal.
* Throws a require error if the specified withdrawal amount is greater than the contract balance.
* @param amount The amount of balance to be withdrawn.
*/
function withdraw(uint256 amount) external onlyOwner {
uint256 balance = address(this).balance;
require(balance > 0, "Withdrawal: No funds available");
require(amount <= balance, "Withdrawal: Insufficient funds");
(bool success, ) = msg.sender.call{value: amount}("");
require(success, "Withdrawal: transfer failed");
emit Withdrawal(msg.sender, amount);
}
/**
* @dev Pauses the contract.
* See {Pausable-_pause}.
* Can only be called by the owner.
*/
function pause() external onlyOwner {
_pause();
}
/**
* @dev Unpauses the contract.
* See {Pausable-_unpause}.
* Can only be called by the owner.
*/
function unpause() external onlyOwner {
_unpause();
}
/**
* @dev Changes the base URI for token metadata.
* @param baseUri The new base URI.
*/
function setBaseUri(string memory baseUri) external onlyOwner {
_baseUri = baseUri;
emit ChangedBaseURI(baseUri);
}
/*#########################
## Read Functions ##
##########################*/
/**
* @dev Returns the score and associated metadata for a given address.
* @param addr The address to get the score for.
* @param blockchainId The blockchain id in which the score was calculated.
* @param calcModel The scoring calculation model.
* @return score The score for the specified address.
* @return updated The timestamp when the score was last updated for the specified address.
* @return tokenId The token id with score for the specified address.
* @return calculationModel The scoring calculation model.
* @return chainId The blockchain id in which the score was calculated.
* @return owner The score owner.
*/
function getScore(
address addr,
uint256 blockchainId,
uint16 calcModel
)
external
view
returns (
uint16 score,
uint256 updated,
uint256 tokenId,
uint16 calculationModel,
uint256 chainId,
address owner
)
{
Score storage scoreStruct = _score[addr][blockchainId][calcModel];
score = scoreStruct.value;
updated = scoreStruct.updated;
tokenId = scoreStruct.tokenId;
calculationModel = calcModel;
chainId = blockchainId;
owner = addr;
}
/**
* @dev Returns the score and associated metadata for a given token id.
* @param id The token id to get the score for.
* @return score The score for the specified address.
* @return updated The timestamp when the score was last updated for the specified address.
* @return tokenId The token id with score for the specified address.
* @return calculationModel The scoring calculation model.
* @return chainId The blockchain id in which the score was calculated.
* @return owner The score owner.
*/
function getScoreByTokenId(
uint256 id
)
external
view
returns (
uint16 score,
uint256 updated,
uint256 tokenId,
uint16 calculationModel,
uint256 chainId,
address owner
)
{
address scoreOwner = ownerOf(id);
calculationModel = tokenIdToCalcModel[id];
chainId = tokenIdToChainId[id];
Score storage scoreStruct = _score[scoreOwner][chainId][
calculationModel
];
score = scoreStruct.value;
updated = scoreStruct.updated;
tokenId = scoreStruct.tokenId;
owner = scoreOwner;
}
/**
* @dev Get the current token id.
* @return The current token id.
*/
function getCurrentTokenId() external view returns (uint256) {
return _tokenIds.current();
}
/**
* @dev Returns the token IDs associated with a given address.
* @param addr The address for which to retrieve the token IDs.
* @return An array of token IDs owned by the specified address.
*/
function getTokenIds(
address addr
) external view returns (uint256[] memory) {
require(_tokenIds.current() > 0, "getTokenIds: No tokens minted");
return _walletToTokenIds[addr];
}
/**
* @dev Returns the base URI of the token. This method is called internally by the {tokenURI} method.
* @return A string containing the base URI of the token.
*/
function _baseURI() internal view override returns (string memory) {
return _baseUri;
}
/**
* @dev Returns an URI for a given token ID.
* This method is called by the {tokenURI} method from ERC721Upgradeable contract, which in turn can be called by clients to get metadata.
* @param tokenId The token ID to query for the URI.
* @return A string containing the URI for the given token ID.
*/
function tokenURI(
uint256 tokenId
)
public
view
override(ERC721URIStorageUpgradeable)
returns (string memory)
{
return super.tokenURI(tokenId);
}
/**
* @dev Hook that is called before any token transfer.
* @param from The address to transfer from.
* @param to The address to transfer to.
* @param tokenId The ID of the token being transferred.
* @param batchSize The batch size.
*/
function _beforeTokenTransfer(
address from,
address to,
uint256 tokenId,
uint256 batchSize
) internal override(ERC721Upgradeable) {
require(
from == address(0),
"NonTransferrableERC721Token: Nomis score can't be transferred."
);
super._beforeTokenTransfer(from, to, tokenId, batchSize);
}
/**
* @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;
}
@openzeppelin/contracts-upgradeable/interfaces/IERC5267Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC5267.sol)
pragma solidity ^0.8.0;
interface IERC5267Upgradeable {
/**
* @dev MAY be emitted to signal that the domain could have changed.
*/
event EIP712DomainChanged();
/**
* @dev returns the fields and values that describe the domain separator used by this contract for EIP-712
* signature.
*/
function eip712Domain()
external
view
returns (
bytes1 fields,
string memory name,
string memory version,
uint256 chainId,
address verifyingContract,
bytes32 salt,
uint256[] memory extensions
);
}
@openzeppelin/contracts-upgradeable/interfaces/IERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC721.sol)
pragma solidity ^0.8.0;
import "../token/ERC721/IERC721Upgradeable.sol";
@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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]
* ```solidity
* 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 Returns the highest version that has been initialized. See {reinitializer}.
*/
function _getInitializedVersion() internal view returns (uint8) {
return _initialized;
}
/**
* @dev Returns `true` if the contract is currently initializing. See {onlyInitializing}.
*/
function _isInitializing() internal view returns (bool) {
return _initializing;
}
}
@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../utils/ContextUpgradeable.sol";
import {Initializable} from "../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. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling 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;
}
@openzeppelin/contracts-upgradeable/interfaces/IERC165Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol)
pragma solidity ^0.8.0;
import "../utils/introspection/IERC165Upgradeable.sol";
@openzeppelin/contracts-upgradeable/interfaces/IERC4906Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (interfaces/IERC4906.sol)
pragma solidity ^0.8.0;
import "./IERC165Upgradeable.sol";
import "./IERC721Upgradeable.sol";
/// @title EIP-721 Metadata Update Extension
interface IERC4906Upgradeable is IERC165Upgradeable, IERC721Upgradeable {
/// @dev This event emits when the metadata of a token is changed.
/// So that the third-party platforms such as NFT market could
/// timely update the images and related attributes of the NFT.
event MetadataUpdate(uint256 _tokenId);
/// @dev This event emits when the metadata of a range of tokens is changed.
/// So that the third-party platforms such as NFT market could
/// timely update the images and related attributes of the NFTs.
event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId);
}
@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
pragma solidity ^0.8.0;
import "../utils/ContextUpgradeable.sol";
import {Initializable} from "../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;
}
@openzeppelin/contracts-upgradeable/token/ERC721/ERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.0;
import "./IERC721Upgradeable.sol";
import "./IERC721ReceiverUpgradeable.sol";
import "./extensions/IERC721MetadataUpgradeable.sol";
import "../../utils/AddressUpgradeable.sol";
import "../../utils/ContextUpgradeable.sol";
import "../../utils/StringsUpgradeable.sol";
import "../../utils/introspection/ERC165Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/
contract ERC721Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC721Upgradeable, IERC721MetadataUpgradeable {
using AddressUpgradeable for address;
using StringsUpgradeable for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to owner address
mapping(uint256 => address) private _owners;
// Mapping owner address to token count
mapping(address => uint256) private _balances;
// Mapping from token ID to approved address
mapping(uint256 => address) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/
function __ERC721_init(string memory name_, string memory symbol_) internal onlyInitializing {
__ERC721_init_unchained(name_, symbol_);
}
function __ERC721_init_unchained(string memory name_, string memory symbol_) internal onlyInitializing {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
return
interfaceId == type(IERC721Upgradeable).interfaceId ||
interfaceId == type(IERC721MetadataUpgradeable).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
require(owner != address(0), "ERC721: address zero is not a valid owner");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
address owner = _ownerOf(tokenId);
require(owner != address(0), "ERC721: invalid token ID");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return "";
}
/**
* @dev See {IERC721-approve}.
*/
function approve(address to, uint256 tokenId) public virtual override {
address owner = ERC721Upgradeable.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not token owner or approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
_requireMinted(tokenId);
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/
function transferFrom(address from, address to, uint256 tokenId) public virtual override {
//solhint-disable-next-line max-line-length
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual override {
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_safeTransfer(from, to, tokenId, data);
}
/**
* @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.
*
* `data` is additional data, it has no specified format and it is sent in call to `to`.
*
* This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeTransfer(address from, address to, uint256 tokenId, bytes memory data) internal virtual {
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted (`_mint`),
* and stop existing when they are burned (`_burn`).
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return _ownerOf(tokenId) != address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
address owner = ERC721Upgradeable.ownerOf(tokenId);
return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
}
/**
* @dev Safely mints `tokenId` and transfers it to `to`.
*
* Requirements:
*
* - `tokenId` must not exist.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeMint(address to, uint256 tokenId) internal virtual {
_safeMint(to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/
function _safeMint(address to, uint256 tokenId, bytes memory data) internal virtual {
_mint(to, tokenId);
require(
_checkOnERC721Received(address(0), to, tokenId, data),
"ERC721: transfer to non ERC721Receiver implementer"
);
}
/**
* @dev Mints `tokenId` and transfers it to `to`.
*
* WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
*
* Requirements:
*
* - `tokenId` must not exist.
* - `to` cannot be the zero address.
*
* Emits a {Transfer} event.
*/
function _mint(address to, uint256 tokenId) internal virtual {
require(to != address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId, 1);
// Check that tokenId was not minted by `_beforeTokenTransfer` hook
require(!_exists(tokenId), "ERC721: token already minted");
unchecked {
// Will not overflow unless all 2**256 token ids are minted to the same owner.
// Given that tokens are minted one by one, it is impossible in practice that
// this ever happens. Might change if we allow batch minting.
// The ERC fails to describe this case.
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId, 1);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal virtual {
address owner = ERC721Upgradeable.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId, 1);
// Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
owner = ERC721Upgradeable.ownerOf(tokenId);
// Clear approvals
delete _tokenApprovals[tokenId];
unchecked {
// Cannot overflow, as that would require more tokens to be burned/transferred
// out than the owner initially received through minting and transferring in.
_balances[owner] -= 1;
}
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId, 1);
}
/**
* @dev Transfers `tokenId` from `from` to `to`.
* As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
*
* Emits a {Transfer} event.
*/
function _transfer(address from, address to, uint256 tokenId) internal virtual {
require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
require(to != address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId, 1);
// Check that tokenId was not transferred by `_beforeTokenTransfer` hook
require(ERC721Upgradeable.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
// Clear approvals from the previous owner
delete _tokenApprovals[tokenId];
unchecked {
// `_balances[from]` cannot overflow for the same reason as described in `_burn`:
// `from`'s balance is the number of token held, which is at least one before the current
// transfer.
// `_balances[to]` could overflow in the conditions described in `_mint`. That would require
// all 2**256 token ids to be minted, which in practice is impossible.
_balances[from] -= 1;
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId, 1);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits an {Approval} event.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_tokenApprovals[tokenId] = to;
emit Approval(ERC721Upgradeable.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` has not been minted yet.
*/
function _requireMinted(uint256 tokenId) internal view virtual {
require(_exists(tokenId), "ERC721: invalid token ID");
}
/**
* @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
* The call is not executed if the target address is not a contract.
*
* @param from address representing the previous owner of the given token ID
* @param to target address that will receive the tokens
* @param tokenId uint256 ID of the token to be transferred
* @param data bytes optional data to send along with the call
* @return bool whether the call correctly returned the expected magic value
*/
function _checkOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory data
) private returns (bool) {
if (to.isContract()) {
try IERC721ReceiverUpgradeable(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
return retval == IERC721ReceiverUpgradeable.onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
/// @solidity memory-safe-assembly
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
return true;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
* - When `from` is zero, the tokens will be minted for `to`.
* - When `to` is zero, ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
* - When `from` is zero, the tokens were minted for `to`.
* - When `to` is zero, ``from``'s tokens were burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
* being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
* that `ownerOf(tokenId)` is `a`.
*/
// solhint-disable-next-line func-name-mixedcase
function __unsafe_increaseBalance(address account, uint256 amount) internal {
_balances[account] += amount;
}
/**
* @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[44] private __gap;
}
@openzeppelin/contracts-upgradeable/token/ERC721/IERC721ReceiverUpgradeable.sol
// 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 IERC721ReceiverUpgradeable {
/**
* @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);
}
@openzeppelin/contracts-upgradeable/token/ERC721/IERC721Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165Upgradeable.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721Upgradeable is IERC165Upgradeable {
/**
* @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);
}
@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721URIStorageUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/extensions/ERC721URIStorage.sol)
pragma solidity ^0.8.0;
import "../ERC721Upgradeable.sol";
import "../../../interfaces/IERC4906Upgradeable.sol";
import {Initializable} from "../../../proxy/utils/Initializable.sol";
/**
* @dev ERC721 token with storage based token URI management.
*/
abstract contract ERC721URIStorageUpgradeable is Initializable, IERC4906Upgradeable, ERC721Upgradeable {
using StringsUpgradeable for uint256;
// Optional mapping for token URIs
mapping(uint256 => string) private _tokenURIs;
function __ERC721URIStorage_init() internal onlyInitializing {
}
function __ERC721URIStorage_init_unchained() internal onlyInitializing {
}
/**
* @dev See {IERC165-supportsInterface}
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721Upgradeable, IERC165Upgradeable) returns (bool) {
return interfaceId == bytes4(0x49064906) || super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory _tokenURI = _tokenURIs[tokenId];
string memory base = _baseURI();
// If there is no base URI, return the token URI.
if (bytes(base).length == 0) {
return _tokenURI;
}
// If both are set, concatenate the baseURI and tokenURI (via abi.encodePacked).
if (bytes(_tokenURI).length > 0) {
return string(abi.encodePacked(base, _tokenURI));
}
return super.tokenURI(tokenId);
}
/**
* @dev Sets `_tokenURI` as the tokenURI of `tokenId`.
*
* Emits {MetadataUpdate}.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
require(_exists(tokenId), "ERC721URIStorage: URI set of nonexistent token");
_tokenURIs[tokenId] = _tokenURI;
emit MetadataUpdate(tokenId);
}
/**
* @dev See {ERC721-_burn}. This override additionally checks to see if a
* token-specific URI was set for the token, and if so, it deletes the token URI from
* the storage mapping.
*/
function _burn(uint256 tokenId) internal virtual override {
super._burn(tokenId);
if (bytes(_tokenURIs[tokenId]).length != 0) {
delete _tokenURIs[tokenId];
}
}
/**
* @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;
}
@openzeppelin/contracts-upgradeable/token/ERC721/extensions/IERC721MetadataUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC721Upgradeable.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional metadata extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721MetadataUpgradeable is IERC721Upgradeable {
/**
* @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);
}
@openzeppelin/contracts-upgradeable/utils/AddressUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.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
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [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://consensys.net/diligence/blog/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.8.0/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 Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @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,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(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);
}
}
}
@openzeppelin/contracts-upgradeable/utils/ContextUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
pragma solidity ^0.8.0;
import {Initializable} from "../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;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
/**
* @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;
}
@openzeppelin/contracts-upgradeable/utils/CountersUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/Counters.sol)
pragma solidity ^0.8.0;
/**
* @title Counters
* @author Matt Condon (@shrugs)
* @dev Provides counters that can only be incremented, decremented or reset. This can be used e.g. to track the number
* of elements in a mapping, issuing ERC721 ids, or counting request ids.
*
* Include with `using Counters for Counters.Counter;`
*/
library CountersUpgradeable {
struct Counter {
// This variable should never be directly accessed by users of the library: interactions must be restricted to
// the library's function. As of Solidity v0.5.2, this cannot be enforced, though there is a proposal to add
// this feature: see https://github.com/ethereum/solidity/issues/4637
uint256 _value; // default: 0
}
function current(Counter storage counter) internal view returns (uint256) {
return counter._value;
}
function increment(Counter storage counter) internal {
unchecked {
counter._value += 1;
}
}
function decrement(Counter storage counter) internal {
uint256 value = counter._value;
require(value > 0, "Counter: decrement overflow");
unchecked {
counter._value = value - 1;
}
}
function reset(Counter storage counter) internal {
counter._value = 0;
}
}
@openzeppelin/contracts-upgradeable/utils/StringsUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/MathUpgradeable.sol";
import "./math/SignedMathUpgradeable.sol";
/**
* @dev String operations.
*/
library StringsUpgradeable {
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 = MathUpgradeable.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 `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMathUpgradeable.abs(value))));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, MathUpgradeable.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);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}
@openzeppelin/contracts-upgradeable/utils/cryptography/ECDSAUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/ECDSA.sol)
pragma solidity ^0.8.0;
import "../StringsUpgradeable.sol";
/**
* @dev Elliptic Curve Digital Signature Algorithm (ECDSA) operations.
*
* These functions can be used to verify that a message was signed by the holder
* of the private keys of a given address.
*/
library ECDSAUpgradeable {
enum RecoverError {
NoError,
InvalidSignature,
InvalidSignatureLength,
InvalidSignatureS,
InvalidSignatureV // Deprecated in v4.8
}
function _throwError(RecoverError error) private pure {
if (error == RecoverError.NoError) {
return; // no error: do nothing
} else if (error == RecoverError.InvalidSignature) {
revert("ECDSA: invalid signature");
} else if (error == RecoverError.InvalidSignatureLength) {
revert("ECDSA: invalid signature length");
} else if (error == RecoverError.InvalidSignatureS) {
revert("ECDSA: invalid signature 's' value");
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature` or error string. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*
* Documentation for signature generation:
* - with https://web3js.readthedocs.io/en/v1.3.4/web3-eth-accounts.html#sign[Web3.js]
* - with https://docs.ethers.io/v5/api/signer/#Signer-signMessage[ethers]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
if (signature.length == 65) {
bytes32 r;
bytes32 s;
uint8 v;
// ecrecover takes the signature parameters, and the only way to get them
// currently is to use assembly.
/// @solidity memory-safe-assembly
assembly {
r := mload(add(signature, 0x20))
s := mload(add(signature, 0x40))
v := byte(0, mload(add(signature, 0x60)))
}
return tryRecover(hash, v, r, s);
} else {
return (address(0), RecoverError.InvalidSignatureLength);
}
}
/**
* @dev Returns the address that signed a hashed message (`hash`) with
* `signature`. This address can then be used for verification purposes.
*
* The `ecrecover` EVM opcode allows for malleable (non-unique) signatures:
* this function rejects them by requiring the `s` value to be in the lower
* half order, and the `v` value to be either 27 or 28.
*
* IMPORTANT: `hash` _must_ be the result of a hash operation for the
* verification to be secure: it is possible to craft signatures that
* recover to arbitrary addresses for non-hashed data. A safe way to ensure
* this is by receiving a hash of the original message (which may otherwise
* be too long), and then calling {toEthSignedMessageHash} on it.
*/
function recover(bytes32 hash, bytes memory signature) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, signature);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `r` and `vs` short-signature fields separately.
*
* See https://eips.ethereum.org/EIPS/eip-2098[EIP-2098 short signatures]
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address, RecoverError) {
bytes32 s = vs & bytes32(0x7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff);
uint8 v = uint8((uint256(vs) >> 255) + 27);
return tryRecover(hash, v, r, s);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `r and `vs` short-signature fields separately.
*
* _Available since v4.2._
*/
function recover(bytes32 hash, bytes32 r, bytes32 vs) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, r, vs);
_throwError(error);
return recovered;
}
/**
* @dev Overload of {ECDSA-tryRecover} that receives the `v`,
* `r` and `s` signature fields separately.
*
* _Available since v4.3._
*/
function tryRecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address, RecoverError) {
// EIP-2 still allows signature malleability for ecrecover(). Remove this possibility and make the signature
// unique. Appendix F in the Ethereum Yellow paper (https://ethereum.github.io/yellowpaper/paper.pdf), defines
// the valid range for s in (301): 0 < s < secp256k1n ÷ 2 + 1, and for v in (302): v ∈ {27, 28}. Most
// signatures from current libraries generate a unique signature with an s-value in the lower half order.
//
// If your library generates malleable signatures, such as s-values in the upper range, calculate a new s-value
// with 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFEBAAEDCE6AF48A03BBFD25E8CD0364141 - s1 and flip v from 27 to 28 or
// vice versa. If your library also generates signatures with 0/1 for v instead 27/28, add 27 to v to accept
// these malleable signatures as well.
if (uint256(s) > 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF5D576E7357A4501DDFE92F46681B20A0) {
return (address(0), RecoverError.InvalidSignatureS);
}
// If the signature is valid (and not malleable), return the signer address
address signer = ecrecover(hash, v, r, s);
if (signer == address(0)) {
return (address(0), RecoverError.InvalidSignature);
}
return (signer, RecoverError.NoError);
}
/**
* @dev Overload of {ECDSA-recover} that receives the `v`,
* `r` and `s` signature fields separately.
*/
function recover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) internal pure returns (address) {
(address recovered, RecoverError error) = tryRecover(hash, v, r, s);
_throwError(error);
return recovered;
}
/**
* @dev Returns an Ethereum Signed Message, created from a `hash`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes32 hash) internal pure returns (bytes32 message) {
// 32 is the length in bytes of hash,
// enforced by the type signature above
/// @solidity memory-safe-assembly
assembly {
mstore(0x00, "\x19Ethereum Signed Message:\n32")
mstore(0x1c, hash)
message := keccak256(0x00, 0x3c)
}
}
/**
* @dev Returns an Ethereum Signed Message, created from `s`. This
* produces hash corresponding to the one signed with the
* https://eth.wiki/json-rpc/API#eth_sign[`eth_sign`]
* JSON-RPC method as part of EIP-191.
*
* See {recover}.
*/
function toEthSignedMessageHash(bytes memory s) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19Ethereum Signed Message:\n", StringsUpgradeable.toString(s.length), s));
}
/**
* @dev Returns an Ethereum Signed Typed Data, created from a
* `domainSeparator` and a `structHash`. This produces hash corresponding
* to the one signed with the
* https://eips.ethereum.org/EIPS/eip-712[`eth_signTypedData`]
* JSON-RPC method as part of EIP-712.
*
* See {recover}.
*/
function toTypedDataHash(bytes32 domainSeparator, bytes32 structHash) internal pure returns (bytes32 data) {
/// @solidity memory-safe-assembly
assembly {
let ptr := mload(0x40)
mstore(ptr, "\x19\x01")
mstore(add(ptr, 0x02), domainSeparator)
mstore(add(ptr, 0x22), structHash)
data := keccak256(ptr, 0x42)
}
}
/**
* @dev Returns an Ethereum Signed Data with intended validator, created from a
* `validator` and `data` according to the version 0 of EIP-191.
*
* See {recover}.
*/
function toDataWithIntendedValidatorHash(address validator, bytes memory data) internal pure returns (bytes32) {
return keccak256(abi.encodePacked("\x19\x00", validator, data));
}
}
@openzeppelin/contracts-upgradeable/utils/cryptography/EIP712Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/cryptography/EIP712.sol)
pragma solidity ^0.8.8;
import "./ECDSAUpgradeable.sol";
import "../../interfaces/IERC5267Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev https://eips.ethereum.org/EIPS/eip-712[EIP 712] is a standard for hashing and signing of typed structured data.
*
* The encoding specified in the EIP is very generic, and such a generic implementation in Solidity is not feasible,
* thus this contract does not implement the encoding itself. Protocols need to implement the type-specific encoding
* they need in their contracts using a combination of `abi.encode` and `keccak256`.
*
* This contract implements the EIP 712 domain separator ({_domainSeparatorV4}) that is used as part of the encoding
* scheme, and the final step of the encoding to obtain the message digest that is then signed via ECDSA
* ({_hashTypedDataV4}).
*
* The implementation of the domain separator was designed to be as efficient as possible while still properly updating
* the chain id to protect against replay attacks on an eventual fork of the chain.
*
* NOTE: This contract implements the version of the encoding known as "v4", as implemented by the JSON RPC method
* https://docs.metamask.io/guide/signing-data.html[`eth_signTypedDataV4` in MetaMask].
*
* NOTE: In the upgradeable version of this contract, the cached values will correspond to the address, and the domain
* separator of the implementation contract. This will cause the `_domainSeparatorV4` function to always rebuild the
* separator from the immutable values, which is cheaper than accessing a cached version in cold storage.
*
* _Available since v3.4._
*
* @custom:storage-size 52
*/
abstract contract EIP712Upgradeable is Initializable, IERC5267Upgradeable {
bytes32 private constant _TYPE_HASH =
keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
/// @custom:oz-renamed-from _HASHED_NAME
bytes32 private _hashedName;
/// @custom:oz-renamed-from _HASHED_VERSION
bytes32 private _hashedVersion;
string private _name;
string private _version;
/**
* @dev Initializes the domain separator and parameter caches.
*
* The meaning of `name` and `version` is specified in
* https://eips.ethereum.org/EIPS/eip-712#definition-of-domainseparator[EIP 712]:
*
* - `name`: the user readable name of the signing domain, i.e. the name of the DApp or the protocol.
* - `version`: the current major version of the signing domain.
*
* NOTE: These parameters cannot be changed except through a xref:learn::upgrading-smart-contracts.adoc[smart
* contract upgrade].
*/
function __EIP712_init(string memory name, string memory version) internal onlyInitializing {
__EIP712_init_unchained(name, version);
}
function __EIP712_init_unchained(string memory name, string memory version) internal onlyInitializing {
_name = name;
_version = version;
// Reset prior values in storage if upgrading
_hashedName = 0;
_hashedVersion = 0;
}
/**
* @dev Returns the domain separator for the current chain.
*/
function _domainSeparatorV4() internal view returns (bytes32) {
return _buildDomainSeparator();
}
function _buildDomainSeparator() private view returns (bytes32) {
return keccak256(abi.encode(_TYPE_HASH, _EIP712NameHash(), _EIP712VersionHash(), block.chainid, address(this)));
}
/**
* @dev Given an already https://eips.ethereum.org/EIPS/eip-712#definition-of-hashstruct[hashed struct], this
* function returns the hash of the fully encoded EIP712 message for this domain.
*
* This hash can be used together with {ECDSA-recover} to obtain the signer of a message. For example:
*
* ```solidity
* bytes32 digest = _hashTypedDataV4(keccak256(abi.encode(
* keccak256("Mail(address to,string contents)"),
* mailTo,
* keccak256(bytes(mailContents))
* )));
* address signer = ECDSA.recover(digest, signature);
* ```
*/
function _hashTypedDataV4(bytes32 structHash) internal view virtual returns (bytes32) {
return ECDSAUpgradeable.toTypedDataHash(_domainSeparatorV4(), structHash);
}
/**
* @dev See {EIP-5267}.
*
* _Available since v4.9._
*/
function eip712Domain()
public
view
virtual
override
returns (
bytes1 fields,
string memory name,
string memory version,
uint256 chainId,
address verifyingContract,
bytes32 salt,
uint256[] memory extensions
)
{
// If the hashed name and version in storage are non-zero, the contract hasn't been properly initialized
// and the EIP712 domain is not reliable, as it will be missing name and version.
require(_hashedName == 0 && _hashedVersion == 0, "EIP712: Uninitialized");
return (
hex"0f", // 01111
_EIP712Name(),
_EIP712Version(),
block.chainid,
address(this),
bytes32(0),
new uint256[](0)
);
}
/**
* @dev The name parameter for the EIP712 domain.
*
* NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
* are a concern.
*/
function _EIP712Name() internal virtual view returns (string memory) {
return _name;
}
/**
* @dev The version parameter for the EIP712 domain.
*
* NOTE: This function reads from storage by default, but can be redefined to return a constant value if gas costs
* are a concern.
*/
function _EIP712Version() internal virtual view returns (string memory) {
return _version;
}
/**
* @dev The hash of the name parameter for the EIP712 domain.
*
* NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Name` instead.
*/
function _EIP712NameHash() internal view returns (bytes32) {
string memory name = _EIP712Name();
if (bytes(name).length > 0) {
return keccak256(bytes(name));
} else {
// If the name is empty, the contract may have been upgraded without initializing the new storage.
// We return the name hash in storage if non-zero, otherwise we assume the name is empty by design.
bytes32 hashedName = _hashedName;
if (hashedName != 0) {
return hashedName;
} else {
return keccak256("");
}
}
}
/**
* @dev The hash of the version parameter for the EIP712 domain.
*
* NOTE: In previous versions this function was virtual. In this version you should override `_EIP712Version` instead.
*/
function _EIP712VersionHash() internal view returns (bytes32) {
string memory version = _EIP712Version();
if (bytes(version).length > 0) {
return keccak256(bytes(version));
} else {
// If the version is empty, the contract may have been upgraded without initializing the new storage.
// We return the version hash in storage if non-zero, otherwise we assume the version is empty by design.
bytes32 hashedVersion = _hashedVersion;
if (hashedVersion != 0) {
return hashedVersion;
} else {
return keccak256("");
}
}
}
/**
* @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[48] private __gap;
}
@openzeppelin/contracts-upgradeable/utils/introspection/ERC165Upgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
pragma solidity ^0.8.0;
import "./IERC165Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165Upgradeable is Initializable, IERC165Upgradeable {
function __ERC165_init() internal onlyInitializing {
}
function __ERC165_init_unchained() internal onlyInitializing {
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165Upgradeable).interfaceId;
}
/**
* @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;
}
@openzeppelin/contracts-upgradeable/utils/introspection/IERC165Upgradeable.sol
// 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 IERC165Upgradeable {
/**
* @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);
}
@openzeppelin/contracts-upgradeable/utils/math/MathUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library MathUpgradeable {
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) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 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 256, 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 << 3) < value ? 1 : 0);
}
}
}
@openzeppelin/contracts-upgradeable/utils/math/SignedMathUpgradeable.sol
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMathUpgradeable {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}
contracts/NomisPriceManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.19;
import "./NomisStorageManager.sol";
import "./NomisWhitelistManager.sol";
///////////////////////////////////////////////////////////////
// ___ __ ______ ___ __ __ ________ ______ //
// /__/\ /__/\ /_____/\ /__//_//_/\ /_______/\/_____/\ //
// \::\_\\ \ \\:::_ \ \\::\| \| \ \ \__.::._\/\::::_\/_ //
// \:. `-\ \ \\:\ \ \ \\:. \ \ \::\ \ \:\/___/\ //
// \:. _ \ \\:\ \ \ \\:.\-/\ \ \ _\::\ \__\_::._\:\ //
// \. \`-\ \ \\:\_\ \ \\. \ \ \ \/__\::\__/\ /____\:\ //
// \__\/ \__\/ \_____\/ \__\/ \__\/\________\/ \_____\/ //
// //
///////////////////////////////////////////////////////////////
/**
* @title NomisPriceManager
* @dev The Nomis price manager contract.
* @custom:security-contact info@nomis.cc
*/
contract NomisPriceManager is
NomisStorageManager,
NomisWhitelistManager
{
/*#########################
## Variables ##
##########################*/
uint256 internal _mintFee;
uint256 internal _updateFee;
/*#########################
## Mappings ##
##########################*/
/**
* @dev A mapping of calculation model to free mint count.
*/
mapping(uint16 => uint16) public calculationModelToFreeMintCount;
/**
* @dev The individual mint fee value for each address.
*/
mapping(address => mapping(uint16 => uint256)) internal _individualMintFee;
/**
* @dev The individual update fee value for each address.
*/
mapping(address => mapping(uint16 => uint256)) internal _individualUpdateFee;
/*#########################
## Modifiers ##
##########################*/
/**
* @dev Modifier that checks if the passed fee is equal to the current mint fee set.
* @param calcModel The scoring calculation model.
* @param chainId The blockchain id in which the score was calculated.
* @param discountedMintFee The discounted mint fee.
* Requirements:
* The fee passed must be equal to the current mint or update fee set.
*/
modifier equalsFee(uint16 calcModel, uint256 chainId, uint256 discountedMintFee) {
address _wallet = msg.sender;
uint256 _fee = msg.value;
// check update fee
uint256 walletUpdateFee = _individualUpdateFee[_wallet][calcModel];
uint256 walletMintFee;
if (discountedMintFee > 0) {
walletMintFee = discountedMintFee;
}
Score storage scoreStruct = _score[_wallet][chainId][calcModel];
if (_individualMintFee[_wallet][calcModel] > 0) {
walletMintFee = _individualMintFee[_wallet][calcModel];
}
if (scoreStruct.updated > 0) {
require(
(_fee == walletUpdateFee && _fee > 0) ||
whitelist[_wallet][calcModel] ||
_fee == _updateFee,
"Update fee: wrong update fee value"
);
_;
return;
}
// check mint fee
require(
(_fee == walletMintFee && _fee > 0) ||
whitelist[_wallet][calcModel] ||
_fee == _mintFee ||
calculationModelToMintCountUsed[calcModel] <
calculationModelToFreeMintCount[calcModel],
"Mint fee: wrong mint fee value"
);
_;
}
/*#########################
## Events ##
##########################*/
/**
* @dev Emitted when the mint fee is changed.
* @param mintFee The new mint fee.
*/
event ChangedMintFee(uint256 indexed mintFee);
/**
* @dev Emitted when the update fee is changed.
* @param updateFee The new update fee.
*/
event ChangedUpdateFee(uint256 indexed updateFee);
/**
* @dev Emitted when the individual mint fee is changed.
* @param wallet The address of the wallet.
* @param calculationModel The scoring calculation model.
* @param mintFee The new individual mint fee.
*/
event ChangedIndividualMintFee(
address indexed wallet,
uint16 indexed calculationModel,
uint256 indexed mintFee
);
/**
* @dev Emitted when the individual update fee is changed.
* @param wallet The address of the wallet.
* @param calculationModel The scoring calculation model.
* @param updateFee The new individual update fee.
*/
event ChangedIndividualUpdateFee(
address indexed wallet,
uint16 indexed calculationModel,
uint256 indexed updateFee
);
/**
* @dev Emitted when the free mint count is changed for calculation model.
*/
event ChangedFreeMintCount(
uint16 indexed calculationModel,
uint16 indexed freeMintCount
);
/*#########################
## Write Functions ##
##########################*/
/**
* @dev Sets the new mint fee.
* @param mintFee The new mint fee.
* @notice Only the contract owner can call this function.
*/
function setMintFee(uint256 mintFee) external onlyOwner {
_mintFee = mintFee;
emit ChangedMintFee(mintFee);
}
/**
* @dev Sets the new update fee.
* @param updateFee The new update fee.
* @notice Only the contract owner can call this function.
*/
function setUpdateFee(uint256 updateFee) external onlyOwner {
_updateFee = updateFee;
emit ChangedUpdateFee(updateFee);
}
/**
* @dev Sets the individual mint fee for the given address.
* @param wallet The address to set the individual mint fee for.
* @param calcModel The scoring calculation model.
* @param fee The individual mint fee.
* @notice Only the contract owner can call this function.
*/
function setIndividualMintFee(
address wallet,
uint16 calcModel,
uint256 fee
) external onlyOwner {
_individualMintFee[wallet][calcModel] = fee;
emit ChangedIndividualMintFee(wallet, calcModel, fee);
}
/**
* @dev Sets the individual update fee for the given address.
* @param wallet The address to set the individual update fee for.
* @param calcModel The scoring calculation model.
* @param fee The individual update fee.
* @notice Only the contract owner can call this function.
*/
function setIndividualUpdateFee(
address wallet,
uint16 calcModel,
uint256 fee
) external onlyOwner {
_individualUpdateFee[wallet][calcModel] = fee;
emit ChangedIndividualUpdateFee(wallet, calcModel, fee);
}
/**
* @dev Sets the new free mint count for given scoring calculation model.
* @param freeMintCount The new free mint count.
* @param calcModel The scoring calculation model.
* @notice Only the contract owner can call this function.
*/
function setFreeMints(
uint16 freeMintCount,
uint16 calcModel
) external onlyOwner {
calculationModelToFreeMintCount[calcModel] = freeMintCount;
emit ChangedFreeMintCount(calcModel, freeMintCount);
}
/*#########################
## Read Functions ##
##########################*/
/**
* @dev Returns the current mint fee.
* @return The current mint fee.
*/
function getMintFee() external view returns (uint256) {
return _mintFee;
}
/**
* @dev Returns the current update fee.
* @return The current update fee.
*/
function getUpdateFee() external view returns (uint256) {
return _updateFee;
}
/**
* @dev Sets the individual mint fee for the given address.
* @param wallet The address to set the individual mint fee for.
* @param calcModel The scoring calculation model.
* @return The individual mint fee.
* @notice Only the contract owner can call this function.
*/
function getIndividualMintFee(
address wallet,
uint16 calcModel
) external view returns (uint256) {
return _individualMintFee[wallet][calcModel];
}
/**
* @dev Sets the individual update fee for the given address.
* @param wallet The address to set the individual update fee for.
* @param calcModel The scoring calculation model.
* @return The individual update fee.
* @notice Only the contract owner can call this function.
*/
function getIndividualUpdateFee(
address wallet,
uint16 calcModel
) external view returns (uint256) {
return _individualUpdateFee[wallet][calcModel];
}
/**
* @dev Returns the current free mint count for given scoring calculation model.
* @param calcModel The scoring calculation model.
* @return The current free mint count.
*/
function getFreeMints(uint16 calcModel) external view returns (uint16) {
return calculationModelToFreeMintCount[calcModel];
}
}
contracts/NomisReferralManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.19;
import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/security/PausableUpgradeable.sol";
import "@openzeppelin/contracts-upgradeable/token/ERC721/extensions/ERC721URIStorageUpgradeable.sol";
///////////////////////////////////////////////////////////////
// ___ __ ______ ___ __ __ ________ ______ //
// /__/\ /__/\ /_____/\ /__//_//_/\ /_______/\/_____/\ //
// \::\_\\ \ \\:::_ \ \\::\| \| \ \ \__.::._\/\::::_\/_ //
// \:. `-\ \ \\:\ \ \ \\:. \ \ \::\ \ \:\/___/\ //
// \:. _ \ \\:\ \ \ \\:.\-/\ \ \ _\::\ \__\_::._\:\ //
// \. \`-\ \ \\:\_\ \ \\. \ \ \ \/__\::\__/\ /____\:\ //
// \__\/ \__\/ \_____\/ \__\/ \__\/\________\/ \_____\/ //
// //
///////////////////////////////////////////////////////////////
/**
* @title NomisReferralManager
* @dev The NomisReferralManager contract.
* @custom:security-contact info@nomis.cc
*/
contract NomisReferralManager is
OwnableUpgradeable,
PausableUpgradeable,
ERC721URIStorageUpgradeable
{
/*#########################
## Variables ##
##########################*/
uint256 internal _referralReward;
/*#########################
## Mappings ##
##########################*/
/**
* @dev A mapping of addresses to referral codes (string).
*/
mapping(address => string) internal _walletToReferralCode;
/**
* @dev A mapping of referrer codes (bytes32) to wallets.
*/
mapping(bytes32 => address) internal _referralCodeToWallet;
/**
* @dev The individual rewards per referral value for each address.
*/
mapping(address => uint256) internal _individualReward;
/**
* @dev A mapping of not claimed referrals to referer code
*/
mapping(bytes32 => address[]) internal _claimableReferralWallets;
/**
* @dev A mapping of token ids of owners who referred by referrer code.
*/
mapping(bytes32 => uint256[]) internal _referrerCodeToTokenIds;
/*#########################
## Events ##
##########################*/
/**
* @dev Emitted when the referrer withdraws the own referral rewards from the contract balance.
* @param owner The address of the referrer who withdrew the referral rewards.
* @param balance The amount of referral rewards withdrawn by the referrer.
* @param timestamp The timestamp when the referral rewards were withdrawn.
* @param referralCount The number of claimable referrals for the referrer.
*/
event ClaimedReferralReward(
address indexed owner,
uint256 indexed balance,
uint referralCount,
uint256 timestamp
);
/**
* @dev Emitted when the referred wallet added the own referral rewards from the contract balance.
* @param wallet The address of the wallet.
* @param timestamp The timestamp when the referral rewards were claimed.
*/
event RewardedWallet(address indexed wallet, uint256 timestamp);
/**
* @dev Emitted when the referred wallets added the own referral rewards from the contract balance.
* @param wallets The addresses of the wallets.
* @param timestamp The timestamp when the referral rewards were claimed.
*/
event RewardedWallets(address[] wallets, uint256 timestamp);
/**
* @dev Emitted when the referral reward is changed.
* @param referralReward The new referral reward.
*/
event ChangedReferralReward(uint256 indexed referralReward);
/*#########################
## Write Functions ##
##########################*/
/**
* @dev Claim referral rewards.
*/
function claimReferralRewards() external whenNotPaused {
// get reward value per referral
uint256 rewardValue = 0;
if (_individualReward[msg.sender] > 0) {
rewardValue = _individualReward[msg.sender];
} else {
rewardValue = _referralReward;
}
// get an array of not claimed referrals
bytes32 referralCodeBytes = keccak256(
bytes(_walletToReferralCode[msg.sender])
);
address[] memory claimableReferralWallets = _claimableReferralWallets[
referralCodeBytes
];
uint256 referralsCount = claimableReferralWallets.length;
emit RewardedWallets(claimableReferralWallets, block.timestamp);
uint256 claimableReward = referralsCount * rewardValue;
require(
claimableReward > 0,
"claimReferralRewards: No rewards available"
);
require(
claimableReward <= address(this).balance,
"claimReferralRewards: Insufficient funds"
);
delete _claimableReferralWallets[referralCodeBytes];
(bool success, ) = msg.sender.call{value: claimableReward}("");
require(success, "claimReferralRewards: transfer failed");
emit ClaimedReferralReward(
msg.sender,
claimableReward,
referralsCount,
block.timestamp
);
}
/**
* @dev Sets the individual wallet reward.
* @param wallet The address to set the individual reward for.
* @param rewardValue The new reward value.
* @notice Only the contract owner can call this function.
*/
function setIndividualReward(
address wallet,
uint256 rewardValue
) external onlyOwner {
_individualReward[wallet] = rewardValue;
}
/**
* @dev Sets the referral reward.
* @param referralReward The referral reward.
* @notice Only the contract owner can call this function.
* @notice The referral reward is the amount of native currency that will be paid to the referrer when a new score is minted.
*/
function setReferralReward(uint256 referralReward) external onlyOwner {
_referralReward = referralReward;
emit ChangedReferralReward(referralReward);
}
/*#########################
## Read Functions ##
##########################*/
/**
* @dev Returns the referral code for the given address.
* @param addr The address to get the referral code for.
* @return The referral code for the given address.
*/
function getReferralCode(
address addr
) external view returns (string memory) {
return _walletToReferralCode[addr];
}
/**
* @dev Returns the address for the given referral code.
* @param referralCode The referral code to get the wallet for.
* @return The address for the given referral code.
*/
function getWalletByReferralCode(
string memory referralCode
) external view returns (address) {
return getWalletByReferralCode(keccak256(bytes(referralCode)));
}
/**
* @dev Returns the address for the given referral code.
* @param referralCode The referral code to get the wallet for.
* @return The address for the given referral code.
*/
function getWalletByReferralCode(
bytes32 referralCode
) private view returns (address) {
require(
referralCode != 0,
"getWalletByReferralCode: Invalid referral code"
);
return _referralCodeToWallet[referralCode];
}
/**
* @dev Returns the wallets for the given referrer code.
* @param referrerCode The referrer code to get the wallets for.
* @return The wallets for the given referrer code.
*/
function getWalletsByReferrerCode(
string memory referrerCode
) public view returns (address[] memory) {
uint256[] memory referredTokenIds = _referrerCodeToTokenIds[
keccak256(bytes(referrerCode))
];
// Create a new dynamic array with the correct size to store valid token IDs
address[] memory wallets = new address[](referredTokenIds.length);
// Copy the valid token IDs to the new array
for (uint256 i = 0; i < referredTokenIds.length; ++i) {
wallets[i] = ownerOf(referredTokenIds[i]);
}
return wallets;
}
/**
* @dev Returns the claimable reward for the given wallet.
* @param wallet The wallet to get the claimable reward for.
* @return The claimable reward for the given wallet.
*/
function getClaimableReward(
address wallet
) external view returns (uint256) {
// get reward value per referral
uint256 rewardValue = 0;
if (_individualReward[wallet] > 0) {
rewardValue = _individualReward[wallet];
} else {
rewardValue = _referralReward;
}
// get an array of all not claimed referrals
bytes32 referralCodeBytes = keccak256(
bytes(_walletToReferralCode[msg.sender])
);
address[] memory claimableReferralWallets = _claimableReferralWallets[
referralCodeBytes
];
return claimableReferralWallets.length * rewardValue;
}
/**
* @dev Returns the current referral reward.
* @return The current referral reward.
* @notice Only the contract owner can call this function.
*/
function getReferralReward() external view returns (uint256) {
return _referralReward;
}
}
contracts/NomisStorageManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.19;
import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
///////////////////////////////////////////////////////////////
// ___ __ ______ ___ __ __ ________ ______ //
// /__/\ /__/\ /_____/\ /__//_//_/\ /_______/\/_____/\ //
// \::\_\\ \ \\:::_ \ \\::\| \| \ \ \__.::._\/\::::_\/_ //
// \:. `-\ \ \\:\ \ \ \\:. \ \ \::\ \ \:\/___/\ //
// \:. _ \ \\:\ \ \ \\:.\-/\ \ \ _\::\ \__\_::._\:\ //
// \. \`-\ \ \\:\_\ \ \\. \ \ \ \/__\::\__/\ /____\:\ //
// \__\/ \__\/ \_____\/ \__\/ \__\/\________\/ \_____\/ //
// //
///////////////////////////////////////////////////////////////
/**
* @title NomisStorageManager
* @dev The Nomis storage manager contract.
* @custom:security-contact info@nomis.cc
*/
contract NomisStorageManager is
OwnableUpgradeable
{
/*#########################
## Structs ##
##########################*/
/**
* @dev The Score struct represents a user's score.
* @param tokenId The token id with score for the specified address.
* @param updated The timestamp when the score was last updated for the specified address.
* @param value The score for the specified address.
*/
struct Score {
uint256 tokenId;
uint256 updated;
uint16 value;
}
/*#########################
## Variables ##
##########################*/
uint16 internal _calcModelsCount;
/*#########################
## Mappings ##
##########################*/
/**
* @dev A mapping of token id to calculation model.
*/
mapping(uint256 => uint16) public tokenIdToCalcModel;
/**
* @dev A mapping of token id to chain id.
*/
mapping(uint256 => uint256) public tokenIdToChainId;
/**
* @dev A mapping of calculation model to mint count used.
*/
mapping(uint16 => uint256) public calculationModelToMintCountUsed;
/**
* @dev A mapping of addresses, chains and calculation methods to scores.
*/
mapping(address => mapping(uint256 => mapping(uint16 => Score)))
internal _score;
/**
* @dev A mapping of addresses to nonces for replay protection.
*/
mapping(address => uint256) internal _nonce;
/**
* @dev A mapping of wallet to its token ids.
*/
mapping(address => uint256[]) internal _walletToTokenIds;
/*#########################
## Events ##
##########################*/
/**
* Emitted when the calculation models count is changed.
*/
event ChangedCalculationModelsCount(uint256 indexed calcModelsCount);
/*#########################
## Write Functions ##
##########################*/
/**
* @dev Sets the number of scoring calculation models.
* @param calcModelsCount The number of scoring calculation models to set.
*/
function setCalcModelsCount(uint16 calcModelsCount) external onlyOwner {
require(
calcModelsCount > 0,
"setCalcModelsCount: calcModelsCount should be greater than 0"
);
_calcModelsCount = calcModelsCount;
emit ChangedCalculationModelsCount(calcModelsCount);
}
/*#########################
## Read Functions ##
##########################*/
/**
* @dev Returns the number of scoring calculation models.
* @return The number of scoring calculation models.
*/
function getCalcModelsCount() external view returns (uint16) {
return _calcModelsCount;
}
/**
* @dev Returns the nonce value for the calling address.
* @param addr The address to get the nonce for.
* @return The nonce value for the calling address.
*/
function getNonce(address addr) external view returns (uint256) {
return _nonce[addr];
}
}
contracts/NomisWhitelistManager.sol
// SPDX-License-Identifier: MIT
pragma solidity 0.8.19;
import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
///////////////////////////////////////////////////////////////
// ___ __ ______ ___ __ __ ________ ______ //
// /__/\ /__/\ /_____/\ /__//_//_/\ /_______/\/_____/\ //
// \::\_\\ \ \\:::_ \ \\::\| \| \ \ \__.::._\/\::::_\/_ //
// \:. `-\ \ \\:\ \ \ \\:. \ \ \::\ \ \:\/___/\ //
// \:. _ \ \\:\ \ \ \\:.\-/\ \ \ _\::\ \__\_::._\:\ //
// \. \`-\ \ \\:\_\ \ \\. \ \ \ \/__\::\__/\ /____\:\ //
// \__\/ \__\/ \_____\/ \__\/ \__\/\________\/ \_____\/ //
// //
///////////////////////////////////////////////////////////////
/**
* @title NomisWhitelistManager
* @dev The Nomis whitelist manager contract.
* @custom:security-contact info@nomis.cc
*/
contract NomisWhitelistManager is
OwnableUpgradeable
{
/*#########################
## Mappings ##
##########################*/
/**
* @dev A mapping of addresses with scoring calculation model to whitelist.
*/
mapping(address => mapping(uint16 => bool)) public whitelist;
/*#########################
## Events ##
##########################*/
/**
* @dev Emitted when the wallet is added to whitelist or removed from it for calculation model.
* @param wallet The address of the wallet.
* @param calculationModel The scoring calculation model.
* @param status The status of the wallet in whitelist.
*/
event ChangedWhitelistStatus(
address indexed wallet,
uint16 indexed calculationModel,
bool indexed status
);
/*#########################
## Write Functions ##
##########################*/
/**
* @dev Adds the given addresses to the whitelist.
* @param actors The addresses to be added to the whitelist.
* @param calcModel The scoring calculation model.
*/
function whitelistAddresses(
address[] calldata actors,
uint16 calcModel
) external onlyOwner {
for (uint256 i = 0; i < actors.length; ++i) {
whitelist[actors[i]][calcModel] = true;
emit ChangedWhitelistStatus(actors[i], calcModel, true);
}
}
/**
* @dev Removes the given addresses from the whitelist.
* @param actors The addresses to be removed from the whitelist.
* @param calcModel The scoring calculation model.
*/
function unWhitelistAddresses(
address[] calldata actors,
uint16 calcModel
) external onlyOwner {
for (uint256 i = 0; i < actors.length; ++i) {
whitelist[actors[i]][calcModel] = false;
emit ChangedWhitelistStatus(actors[i], calcModel, false);
}
}
}
Compiler Settings
{"viaIR":true,"outputSelection":{"*":{"*":["abi","evm.bytecode","evm.deployedBytecode","evm.methodIdentifiers"]}},"optimizer":{"runs":200,"enabled":true},"libraries":{}}
Contract ABI
[{"type":"event","name":"Approval","inputs":[{"type":"address","name":"owner","internalType":"address","indexed":true},{"type":"address","name":"approved","internalType":"address","indexed":true},{"type":"uint256","name":"tokenId","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ApprovalForAll","inputs":[{"type":"address","name":"owner","internalType":"address","indexed":true},{"type":"address","name":"operator","internalType":"address","indexed":true},{"type":"bool","name":"approved","internalType":"bool","indexed":false}],"anonymous":false},{"type":"event","name":"BatchMetadataUpdate","inputs":[{"type":"uint256","name":"_fromTokenId","internalType":"uint256","indexed":false},{"type":"uint256","name":"_toTokenId","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"ChangedBaseURI","inputs":[{"type":"string","name":"baseUri","internalType":"string","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedCalculationModelsCount","inputs":[{"type":"uint256","name":"calcModelsCount","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedFreeMintCount","inputs":[{"type":"uint16","name":"calculationModel","internalType":"uint16","indexed":true},{"type":"uint16","name":"freeMintCount","internalType":"uint16","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedIndividualMintFee","inputs":[{"type":"address","name":"wallet","internalType":"address","indexed":true},{"type":"uint16","name":"calculationModel","internalType":"uint16","indexed":true},{"type":"uint256","name":"mintFee","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedIndividualUpdateFee","inputs":[{"type":"address","name":"wallet","internalType":"address","indexed":true},{"type":"uint16","name":"calculationModel","internalType":"uint16","indexed":true},{"type":"uint256","name":"updateFee","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedMintFee","inputs":[{"type":"uint256","name":"mintFee","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedReferralReward","inputs":[{"type":"uint256","name":"referralReward","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedScore","inputs":[{"type":"uint256","name":"tokenId","internalType":"uint256","indexed":true},{"type":"address","name":"owner","internalType":"address","indexed":true},{"type":"uint16","name":"score","internalType":"uint16","indexed":false},{"type":"uint16","name":"calculationModel","internalType":"uint16","indexed":false},{"type":"uint256","name":"chainId","internalType":"uint256","indexed":false},{"type":"string","name":"metadataUrl","internalType":"string","indexed":false},{"type":"string","name":"referralCode","internalType":"string","indexed":false},{"type":"string","name":"referrerCode","internalType":"string","indexed":false}],"anonymous":false},{"type":"event","name":"ChangedUpdateFee","inputs":[{"type":"uint256","name":"updateFee","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"ChangedWhitelistStatus","inputs":[{"type":"address","name":"wallet","internalType":"address","indexed":true},{"type":"uint16","name":"calculationModel","internalType":"uint16","indexed":true},{"type":"bool","name":"status","internalType":"bool","indexed":true}],"anonymous":false},{"type":"event","name":"ClaimedReferralReward","inputs":[{"type":"address","name":"owner","internalType":"address","indexed":true},{"type":"uint256","name":"balance","internalType":"uint256","indexed":true},{"type":"uint256","name":"referralCount","internalType":"uint256","indexed":false},{"type":"uint256","name":"timestamp","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"EIP712DomainChanged","inputs":[],"anonymous":false},{"type":"event","name":"Initialized","inputs":[{"type":"uint8","name":"version","internalType":"uint8","indexed":false}],"anonymous":false},{"type":"event","name":"MetadataUpdate","inputs":[{"type":"uint256","name":"_tokenId","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"OwnershipTransferred","inputs":[{"type":"address","name":"previousOwner","internalType":"address","indexed":true},{"type":"address","name":"newOwner","internalType":"address","indexed":true}],"anonymous":false},{"type":"event","name":"Paused","inputs":[{"type":"address","name":"account","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"RewardedWallet","inputs":[{"type":"address","name":"wallet","internalType":"address","indexed":true},{"type":"uint256","name":"timestamp","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"RewardedWallets","inputs":[{"type":"address[]","name":"wallets","internalType":"address[]","indexed":false},{"type":"uint256","name":"timestamp","internalType":"uint256","indexed":false}],"anonymous":false},{"type":"event","name":"Transfer","inputs":[{"type":"address","name":"from","internalType":"address","indexed":true},{"type":"address","name":"to","internalType":"address","indexed":true},{"type":"uint256","name":"tokenId","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"event","name":"Unpaused","inputs":[{"type":"address","name":"account","internalType":"address","indexed":false}],"anonymous":false},{"type":"event","name":"Withdrawal","inputs":[{"type":"address","name":"owner","internalType":"address","indexed":true},{"type":"uint256","name":"balance","internalType":"uint256","indexed":true}],"anonymous":false},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"approve","inputs":[{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"balanceOf","inputs":[{"type":"address","name":"owner","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"","internalType":"uint16"}],"name":"calculationModelToFreeMintCount","inputs":[{"type":"uint16","name":"","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"calculationModelToMintCountUsed","inputs":[{"type":"uint16","name":"","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"claimReferralRewards","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bytes1","name":"fields","internalType":"bytes1"},{"type":"string","name":"name","internalType":"string"},{"type":"string","name":"version","internalType":"string"},{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"address","name":"verifyingContract","internalType":"address"},{"type":"bytes32","name":"salt","internalType":"bytes32"},{"type":"uint256[]","name":"extensions","internalType":"uint256[]"}],"name":"eip712Domain","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"getApproved","inputs":[{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"","internalType":"uint16"}],"name":"getCalcModelsCount","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getClaimableReward","inputs":[{"type":"address","name":"wallet","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getCurrentTokenId","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"","internalType":"uint16"}],"name":"getFreeMints","inputs":[{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getIndividualMintFee","inputs":[{"type":"address","name":"wallet","internalType":"address"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getIndividualUpdateFee","inputs":[{"type":"address","name":"wallet","internalType":"address"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getMintFee","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getNonce","inputs":[{"type":"address","name":"addr","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"string","name":"","internalType":"string"}],"name":"getReferralCode","inputs":[{"type":"address","name":"addr","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getReferralReward","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"score","internalType":"uint16"},{"type":"uint256","name":"updated","internalType":"uint256"},{"type":"uint256","name":"tokenId","internalType":"uint256"},{"type":"uint16","name":"calculationModel","internalType":"uint16"},{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"address","name":"owner","internalType":"address"}],"name":"getScore","inputs":[{"type":"address","name":"addr","internalType":"address"},{"type":"uint256","name":"blockchainId","internalType":"uint256"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"score","internalType":"uint16"},{"type":"uint256","name":"updated","internalType":"uint256"},{"type":"uint256","name":"tokenId","internalType":"uint256"},{"type":"uint16","name":"calculationModel","internalType":"uint16"},{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"address","name":"owner","internalType":"address"}],"name":"getScoreByTokenId","inputs":[{"type":"uint256","name":"id","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256[]","name":"","internalType":"uint256[]"}],"name":"getTokenIds","inputs":[{"type":"address","name":"addr","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"getUpdateFee","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"getWalletByReferralCode","inputs":[{"type":"string","name":"referralCode","internalType":"string"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"address[]","name":"","internalType":"address[]"}],"name":"getWalletsByReferrerCode","inputs":[{"type":"string","name":"referrerCode","internalType":"string"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"initialize","inputs":[{"type":"uint256","name":"initialFee","internalType":"uint256"},{"type":"uint16","name":"initialCalcModelsCount","internalType":"uint16"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"isApprovedForAll","inputs":[{"type":"address","name":"owner","internalType":"address"},{"type":"address","name":"operator","internalType":"address"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"string","name":"","internalType":"string"}],"name":"name","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"owner","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"address","name":"","internalType":"address"}],"name":"ownerOf","inputs":[{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"pause","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"paused","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"renounceOwnership","inputs":[]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"safeTransferFrom","inputs":[{"type":"address","name":"from","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"safeTransferFrom","inputs":[{"type":"address","name":"from","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"tokenId","internalType":"uint256"},{"type":"bytes","name":"data","internalType":"bytes"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setApprovalForAll","inputs":[{"type":"address","name":"operator","internalType":"address"},{"type":"bool","name":"approved","internalType":"bool"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setBaseUri","inputs":[{"type":"string","name":"baseUri","internalType":"string"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setCalcModelsCount","inputs":[{"type":"uint16","name":"calcModelsCount","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setFreeMints","inputs":[{"type":"uint16","name":"freeMintCount","internalType":"uint16"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setIndividualMintFee","inputs":[{"type":"address","name":"wallet","internalType":"address"},{"type":"uint16","name":"calcModel","internalType":"uint16"},{"type":"uint256","name":"fee","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setIndividualReward","inputs":[{"type":"address","name":"wallet","internalType":"address"},{"type":"uint256","name":"rewardValue","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setIndividualUpdateFee","inputs":[{"type":"address","name":"wallet","internalType":"address"},{"type":"uint16","name":"calcModel","internalType":"uint16"},{"type":"uint256","name":"fee","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setMintFee","inputs":[{"type":"uint256","name":"mintFee","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setReferralReward","inputs":[{"type":"uint256","name":"referralReward","internalType":"uint256"}]},{"type":"function","stateMutability":"payable","outputs":[],"name":"setScore","inputs":[{"type":"bytes","name":"signature","internalType":"bytes"},{"type":"uint16","name":"score","internalType":"uint16"},{"type":"uint16","name":"calculationModel","internalType":"uint16"},{"type":"uint256","name":"deadline","internalType":"uint256"},{"type":"string","name":"metadataUrl","internalType":"string"},{"type":"uint256","name":"chainId","internalType":"uint256"},{"type":"string","name":"referralCode","internalType":"string"},{"type":"string","name":"referrerCode","internalType":"string"},{"type":"uint256","name":"discountedMintFee","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"setUpdateFee","inputs":[{"type":"uint256","name":"updateFee","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"supportsInterface","inputs":[{"type":"bytes4","name":"interfaceId","internalType":"bytes4"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"string","name":"","internalType":"string"}],"name":"symbol","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint16","name":"","internalType":"uint16"}],"name":"tokenIdToCalcModel","inputs":[{"type":"uint256","name":"","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"uint256","name":"","internalType":"uint256"}],"name":"tokenIdToChainId","inputs":[{"type":"uint256","name":"","internalType":"uint256"}]},{"type":"function","stateMutability":"view","outputs":[{"type":"string","name":"","internalType":"string"}],"name":"tokenURI","inputs":[{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"transferFrom","inputs":[{"type":"address","name":"from","internalType":"address"},{"type":"address","name":"to","internalType":"address"},{"type":"uint256","name":"tokenId","internalType":"uint256"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"transferOwnership","inputs":[{"type":"address","name":"newOwner","internalType":"address"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"unWhitelistAddresses","inputs":[{"type":"address[]","name":"actors","internalType":"address[]"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"unpause","inputs":[]},{"type":"function","stateMutability":"view","outputs":[{"type":"bool","name":"","internalType":"bool"}],"name":"whitelist","inputs":[{"type":"address","name":"","internalType":"address"},{"type":"uint16","name":"","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"whitelistAddresses","inputs":[{"type":"address[]","name":"actors","internalType":"address[]"},{"type":"uint16","name":"calcModel","internalType":"uint16"}]},{"type":"function","stateMutability":"nonpayable","outputs":[],"name":"withdraw","inputs":[{"type":"uint256","name":"amount","internalType":"uint256"}]}]
Contract Creation Code
0x6080806040523461001657614551908161001c8239f35b600080fdfe608060408181526004918236101561001657600080fd5b600090813560e01c90816301ffc9a7146124df5750806305eaab4b1461225a57806306fdde03146121b0578063081812fc14612191578063095ea7b3146120205780630f25b13714611f695780631048fbf814611f4957806323b872dd14611f245780632b08672f14611e565780632d0335ab14611e1d5780632e1a7d4d14611ce95780633938da5914611c455780633be159ed14611ba55780633f4ba83a14611b0f57806342842e0e14611adb578063523033aa14610de65780635618923614611abb578063590adabe14611a925780635c975abb14611a6e5780635ff329af146119a0578063631c1052146118b85780636352211e146118885780636a2e770f1461184057806370a08231146117ab578063710b43001461175d578063715018a6146117005780637a5caab3146116e05780637ca40d1c14610f995780638456cb5914610f3e57806384b0196e14610e455780638da5cb5b14610e1c5780638e52c21714610de65780638ee67edb14610d985780638fb6c6f614610d50578063902a859a14610cde57806392c4034414610c9057806395d89b4114610bab57806397f5eda614610b115780639995626614610ade578063a09bddaa14610ab1578063a0bcfc7f1461090a578063a22cb4651461083a578063a93986b1146107d3578063b7b0ccde146107b3578063b88d4fde14610729578063bdbbd85b146106c2578063c87b56dd1461068f578063cbec2cdb1461066b578063d004b0361461058d578063d241c3291461053a578063db0b2b101461048f578063e985e9c514610441578063eddd0d9c146103f9578063eef1d20f146103b8578063f2fde38b146103225763fc1ac1d31461028c57600080fd5b3461031f5761029a3661278d565b6020815191012080156102c55760209350815261012f83528160018060a01b03912054169051908152f35b825162461bcd60e51b8152602081860152602e60248201527f67657457616c6c65744279526566657272616c436f64653a20496e76616c696460448201526d20726566657272616c20636f646560901b6064820152608490fd5b80fd5b5091346103b45760203660031901126103b45761033d6125ad565b91610346612871565b6001600160a01b03831615610362578361035f846128c9565b80f35b906020608492519162461bcd60e51b8352820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152fd5b8280fd5b5090346103f557806003193601126103f5576103d26125ad565b6103da612871565b6001600160a01b031682526101306020528120602435905580f35b5080fd5b5082346103f55760203660031901126103f55735610415612871565b8061013b557f0dfc6eec96b100579d23188487733288387140dea6c20dcf97a742a857b132738280a280f35b5090346103f557806003193601126103f55760ff816020936104616125ad565b6104696125c8565b6001600160a01b03918216835260ce875283832091168252855220549151911615158152f35b5090346103f55761049f36612673565b906104a8612871565b845b8181106104b5578580f35b610535906001600160a01b03806104d56104d084878a6144f7565b614507565b168852602061013a815287892061ffff871691828b5252878920916001928360ff1982541617905561050b6104d085888b6144f7565b167f89260241ebd53b9ff7a3778cb628f41b86fcce20041a1f23c751005663420c7a8a80a46131c3565b6104aa565b5090346103f557806003193601126103f55760ff8160209361055a6125ad565b61056261260b565b6001600160a01b03909116825261013a865282822061ffff9091168252855220549151911615158152f35b509190346103b45760209182600319360112610667576105ab6125ad565b90610174541561062457506001600160a01b031683526101398252808320815181548082529185528385209094859283860192915b8682821061060d578590610609886105fa8489038561271a565b51928284938452830190612808565b0390f35b8354855288955090930192600192830192016105e0565b825162461bcd60e51b8152908101849052601d60248201527f676574546f6b656e4964733a204e6f20746f6b656e73206d696e7465640000006044820152606490fd5b8380fd5b5090346103f557816003193601126103f55760209061ffff61013354169051908152f35b503461031f57602036600319011261031f57506106af6106099235614261565b9051918291602083526020830190612588565b5090346103f5576106d23661283c565b809391926106de612871565b60018060a01b03169182865261013f60205261ffff8187209416938487526020528520557ff3d990281b2074ce0d470fa6b9bb65b5376fbd7e946d091e47490a06743f496d8480a480f35b5082346103f55760803660031901126103f5576107446125ad565b9061074d6125c8565b91604435606435936001600160401b0385116107af57366023860112156107af576107876107aa9486602461035f98369301359101612756565b9261079a6107958433612d40565b612c67565b6107a5838383612e08565b6130ad565b612d1c565b8580fd5b5090346103f557816003193601126103f55760209061013c549051908152f35b5090346103f5576107e33661283c565b809391926107ef612871565b60018060a01b03169182865261013e60205261ffff8187209416938487526020528520557fdb0ab24533f4d50ca30cd5978eddbb5a07340c32ff1809f24f6ce598e8eafc398480a480f35b509190346103b457806003193601126103b4576108556125ad565b9060243591821515809303610906576001600160a01b0316923384146108c4575033845260ce60205280842083855260205280842060ff1981541660ff8416179055519081527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3160203392a380f35b6020606492519162461bcd60e51b8352820152601960248201527f4552433732313a20617070726f766520746f2063616c6c6572000000000000006044820152fd5b8480fd5b5090346103f55761091a3661278d565b90610923612871565b8151936001600160401b038511610a9e5750610175906109438254612981565b601f8111610a46575b5060209182601f87116001146109c5579580869761098e97916109ba575b508160011b916000199060031b1c19161790555b5192828480945193849201612565565b81010390207f9bda31c5daf938016d59248ce284119fc191a83aabdfb40b4405397af0a9c97b8280a280f35b90508501513861096a565b8186527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f90601f198816875b818110610a2f575091889161098e989960019410610a16575b5050811b01905561097e565b87015160001960f88460031b161c191690553880610a0a565b91928660018192868b0151815501940192016109f1565b610a8e908386527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f601f880160051c81019160208910610a94575b601f0160051c0190613168565b3861094c565b9091508190610a81565b634e487b7160e01b845260419052602483fd5b5091346103b45760203660031901126103b4578160209361ffff9235815261013485522054169051908152f35b5090346103f55760203660031901126103f5578060209261ffff610b0061262d565b168152610136845220549051908152f35b5090346103f55760603660031901126103f557610609610b2f6125ad565b602435610b3a61261c565b6001600160a01b03929092168086526101376020908152858720838852815285872061ffff948516808952908252968690206002810154600182015491549751951685529084015260408301949094526060820194909452608081019390935260a0830191909152819060c0820190565b5090346103f557816003193601126103f5578051908260ca54610bcd81612981565b80855291600191808316908115610c685750600114610c0b575b505050610bf98261060994038361271a565b51918291602083526020830190612588565b945060ca85527f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee15b828610610c5057505050610bf98260206106099582010194610be7565b80546020878701810191909152909501948101610c33565b610609975086935060209250610bf994915060ff191682840152151560051b82010194610be7565b5090346103f55760203660031901126103f55761060991610cd79190610bf99082906001600160a01b03610cc26125ad565b16815261012e60205220825193848092612b94565b038361271a565b5090346103f557806003193601126103f557610cf861262d565b90610d0161260b565b610d09612871565b61ffff8091169182855261013d60205284209216918261ffff198254161790557fc3ae431c8f115f13156aad0dc084ce6c552f8ae33c5dda5c7d7dc7e450f4255e8380a380f35b5082346103f55760203660031901126103f55735610d6c612871565b8061012d557f14ea2ed84c55d689785f43bcf8e2a56a3bd24dd6fc33946dfd7f7b5bdb5f03218280a280f35b5090346103f557806003193601126103f55780602092610db66125ad565b610dbe61260b565b6001600160a01b03909116825261013e855282822061ffff9091168252845220549051908152f35b5090346103f55760203660031901126103f5576020918161ffff9182610e0a61262d565b16815261013d85522054169051908152f35b5090346103f557816003193601126103f55760335490516001600160a01b039091168152602090f35b5082346103f557816003193601126103f557610140541580610f33575b15610ef857610ecc8361060984825192610e8684610e7f816129bb565b038561271a565b610ed9815191610ea083610e9981612a72565b038461271a565b805192610eac846126ce565b8484528151978897600f60f81b895260e060208a015260e0890190612588565b9187830390880152612588565b9146606086015230608086015260a085015283820360c0850152612808565b606490602084519162461bcd60e51b835282015260156024820152741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b6044820152fd5b506101415415610e62565b5090346103f557816003193601126103f55760207f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25891610f7c612871565b610f8461317f565b600160ff19606554161760655551338152a180f35b5091346103b457816003193601126103b457610fb361260b565b83549060ff92838360081c1615918280936116d4575b80156116be575b1561166457600193838560ff198316178955611653575b50855194610ff4866126ff565b600a8652602095694e6f6d697353636f726560b01b878201526110156131fc565b61102d838b5460081c166110288161321c565b61321c565b8151906001600160401b039182811161156857808c61104d60c954612981565b95601f968d888211611607575b50508c91878411600114611586579261157b575b5050600019600383901b1c191690891b1760c9555b8051908282116115685781908c8b61109c60ca54612981565b87811161151c575b5050508a9085831160011461149c578d92611491575b5050600019600383901b1c191690881b1760ca555b6110d76131fc565b918951926110e4846126ff565b6003845262302e3960e81b8a850152611106858d5460081c166110288161321c565b805183811161147e57808d610142938d6111208654612981565b90878211611433575b50508d918684116001146113aa579261139f575b5050600019600383901b1c1916908a1b1790555b825191821161138c57610143928b8a61116a8654612981565b86858211611337575b505050508b8a9284116001146112ab57926111c49492819261ffff989795926112a0575b5050600019600383901b1c191690891b1790555b89610140558961014155895460081c166110288161321c565b6111cd336128c9565b61017485815401905582358061013b5561013c551690811561123757506101339061ffff19825416179055611200578380f35b7f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989261ff0019855416855551908152a13880808380f35b855162461bcd60e51b8152908101859052603c60248201527f636f6e7374727563746f723a20696e697469616c43616c634d6f64656c73436f60448201527f756e742073686f756c642062652067726561746572207468616e2030000000006064820152608490fd5b015190503880611197565b9091899392601f1984168684527f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d532935b8d8282106113215750509161ffff9897959391856111c498969410611308575b505050811b0190556111ab565b015160001960f88460031b161c191690553880806112fb565b8385015186558d979095019493840193016112db565b61137a9352847f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d5329181880160051c8301938810611383575b0160051c0190613168565b8b8a3886611173565b9250819261136f565b634e487b7160e01b8b526041865260248bfd5b01519050388061113d565b91908d94508e8684527f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae1993601f198616915b82821061141257505084116113f9575b505050811b019055611151565b015160001960f88460031b161c191690553880806113ec565b91929395968291958786015181550195019301908f918f96959493926113dc565b61147791878552887f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae199181880160051c8301938810611383570160051c0190613168565b388e611129565b634e487b7160e01b8d526041885260248dfd5b0151905038806110ba565b60ca8e528a93507f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee19190601f1984168f8e5b82821061150557505084116114ec575b505050811b0160ca556110cf565b015160001960f88460031b161c191690553880806114de565b8385015186558e979095019493840193018e6114ce565b60ca6115609352877f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee19181870160051c8301938710611383570160051c0190613168565b8c8b386110a4565b634e487b7160e01b8c526041875260248cfd5b01519050388061106e565b60c981528c94507f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d28929190601f198516908f5b8282106115f057505084116115d7575b505050811b0160c955611083565b015160001960f88460031b161c191690553880806115c9565b8385015186558f979095019493840193018f6115b9565b61164c9160c98552897f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d289181880160051c8301938810611383570160051c0190613168565b388d61105a565b61ffff191661010117875538610fe7565b855162461bcd60e51b8152602081840152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608490fd5b50303b158015610fd05750600185851614610fd0565b50600185851610610fc9565b5090346103f557816003193601126103f55760209061013b549051908152f35b503461031f578060031936011261031f57611719612871565b603380546001600160a01b0319811690915581906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b5090346103f557806003193601126103f5578060209261177b6125ad565b61178361260b565b6001600160a01b03909116825261013f855282822061ffff9091168252845220549051908152f35b5082346103f55760203660031901126103f5576001600160a01b036117ce6125ad565b169081156117eb57602084808585815260cc845220549051908152f35b608490602085519162461bcd60e51b8352820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152fd5b5082346103f55760203660031901126103f5573561185c612871565b8061013c557f1a1fdd6048edb5d9cc6acd350eadec9121194106777efa0f11794b3f9e62955b8280a280f35b503461031f57602036600319011261031f57506118a76020923561295e565b90516001600160a01b039091168152f35b5090346103f5576118c83661278d565b805160208092012083526101328152818320908251808383829554938481520190875283872092875b8582821061198a575050506119089250038361271a565b81519361191485613128565b946119218551968761271a565b808652611930601f1991613128565b0136838701375b8251811015611978578061195761195161197393866131d2565b5161295e565b61196182886131d2565b6001600160a01b0390911690526131c3565b611937565b835182815280610609818501886127cb565b85548452600195860195889550930192016118f1565b5090346103f557602090816003193601126103b4576119bd6125ad565b6001600160a01b0390811684526101308352818420549093908015611a6357905b33815261012e84526119fa611a01848320855192838092612b94565b038261271a565b8481519101208152610131845282812094835191828688549182815201978252868220915b818110611a4d578787611a468888611a40818f038261271a565b5161313f565b9051908152f35b8254841689529787019760019283019201611a26565b5061012d54906119de565b5090346103f557816003193601126103f55760209060ff6065541690519015158152f35b5091346103b45760203660031901126103b4576020928291358152610135845220549051908152f35b5090346103f557816003193601126103f557602090610174549051908152f35b5090346103f5576107aa61035f91611af23661263e565b91925192611aff846126ce565b86845261079a6107958433612d40565b5091346103b457826003193601126103b457611b29612871565b6065549060ff821615611b6b575060ff1916606555513381527f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa90602090a180f35b606490602084519162461bcd60e51b8352820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152fd5b5091346103b45760208060031936011261066757610609913590611bc88261295e565b9185526101348152838520546101358252848620546001600160a01b039093168087526101378352858720848852835285872061ffff928316808952935295859020600281015460018201549154965192168252602082015260408101949094526060840152608083015260a082019290925290819060c0820190565b5090346103f557611c5536612673565b919290611c60612871565b845b818110611c6d578580f35b611ce490866001600160a01b0380611c896104d085888c6144f7565b16825260209061013a825286832061ffff8916928385525286832060ff198154169055611cba6104d085888c6144f7565b167f89260241ebd53b9ff7a3778cb628f41b86fcce20041a1f23c751005663420c7a8380a46131c3565b611c62565b5091346103b45760203660031901126103b457803591611d07612871565b478015611dda578311611d97578380808086335af1611d24612f89565b5015611d54575050337f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b658380a380f35b906020606492519162461bcd60e51b8352820152601b60248201527f5769746864726177616c3a207472616e73666572206661696c656400000000006044820152fd5b906020606492519162461bcd60e51b8352820152601e60248201527f5769746864726177616c3a20496e73756666696369656e742066756e647300006044820152fd5b815162461bcd60e51b8152602081850152601e60248201527f5769746864726177616c3a204e6f2066756e647320617661696c61626c6500006044820152606490fd5b5090346103f55760203660031901126103f55760209181906001600160a01b03611e456125ad565b168152610138845220549051908152f35b5091346103b45760203660031901126103b45761ffff611e7461262d565b611e7c612871565b16918215611ebb575050610133805461ffff1916821790557f279cbae98d21cc94b9c9de893c44ac632afa05edb3f83372abad1c412673959e8280a280f35b906020608492519162461bcd60e51b8352820152603c60248201527f73657443616c634d6f64656c73436f756e743a2063616c634d6f64656c73436f60448201527f756e742073686f756c642062652067726561746572207468616e2030000000006064820152fd5b503461031f5761035f611f363661263e565b91611f446107958433612d40565b612e08565b5090346103f557816003193601126103f55760209061012d549051908152f35b50826101203660031901126103f5576001600160401b03813581811161066757611f9690369084016125de565b91611f9f61260b565b92611fa861261c565b9160843581811161201c57611fc090369088016125de565b60c49391933583811161201857611fda9036908a016125de565b94909360e4359081116120145761035f99611ff7913691016125de565b97909661200261317f565b610104359960a43595606435936132b8565b8a80fd5b8980fd5b8780fd5b5091346103b457816003193601126103b45761203a6125ad565b6024359290916001600160a01b03919082806120558761295e565b1694169380851461214457803314908115612125575b50156120bd575083855260cd602052842080546001600160a01b031916831790556120958361295e565b167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258480a480f35b6020608492519162461bcd60e51b8352820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152fd5b9050865260ce60205281862033875260205260ff82872054163861206b565b506020608492519162461bcd60e51b8352820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152fd5b503461031f57602036600319011261031f57506118a760209235612c29565b5090346103f557816003193601126103f5578051908260c9546121d281612981565b80855291600191808316908115610c6857506001146121fd57505050610bf98261060994038361271a565b945060c985527f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d285b82861061224257505050610bf98260206106099582010194610be7565b80546020878701810191909152909501948101612225565b509190346103b457826003193601126103b45761227561317f565b3383526020906101308252808420548015156000146124d457915b61012e81526119fa6122a9838720845192838092612b94565b81815191012093848652610131808352838720948451809687918682549182815201918b52868b20908b5b888282106124b4575050505061233692916122f091038861271a565b7f10e5dd73c78f20ac02a01872a45cab5e858e67f5b51725e641fe2af492967abd61232888519888519182918a83528a8301906127cb565b42898301520390a18661313f565b95861561245e5747871161240a57875282528286208054878255806123f1575b50508580808088335af1612368612f89565b50156123a25750907f16e0c135ad5198482dd8326eb47c9c1a3adef8cb405f743c99a0c1fd414e116091815193845242908401523392a380f35b915162461bcd60e51b815291820152602560248201527f636c61696d526566657272616c526577617264733a207472616e736665722066604482015264185a5b195960da1b6064820152608490fd5b61240391885283882090810190613168565b3880612356565b845162461bcd60e51b8152808401859052602860248201527f636c61696d526566657272616c526577617264733a20496e73756666696369656044820152676e742066756e647360c01b6064820152608490fd5b845162461bcd60e51b8152808401859052602a60248201527f636c61696d526566657272616c526577617264733a204e6f207265776172647360448201526920617661696c61626c6560b01b6064820152608490fd5b83546001600160a01b031685528b955090930192600192830192016122d4565b5061012d5491612290565b905083346103b45760203660031901126103b4573563ffffffff60e01b81168091036103b45760209250632483248360e11b8114908115612522575b5015158152f35b6380ac58cd60e01b811491508115612554575b8115612543575b508361251b565b6301ffc9a760e01b1490508361253c565b635b5e139f60e01b81149150612535565b60005b8381106125785750506000910152565b8181015183820152602001612568565b906020916125a181518092818552858086019101612565565b601f01601f1916010190565b600435906001600160a01b03821682036125c357565b600080fd5b602435906001600160a01b03821682036125c357565b9181601f840112156125c3578235916001600160401b0383116125c357602083818601950101116125c357565b6024359061ffff821682036125c357565b6044359061ffff821682036125c357565b6004359061ffff821682036125c357565b60609060031901126125c3576001600160a01b039060043582811681036125c3579160243590811681036125c3579060443590565b9060406003198301126125c3576004356001600160401b03928382116125c357806023830112156125c35781600401359384116125c35760248460051b830101116125c357602401919060243561ffff811681036125c35790565b602081019081106001600160401b038211176126e957604052565b634e487b7160e01b600052604160045260246000fd5b604081019081106001600160401b038211176126e957604052565b90601f801991011681019081106001600160401b038211176126e957604052565b6001600160401b0381116126e957601f01601f191660200190565b9291926127628261273b565b91612770604051938461271a565b8294818452818301116125c3578281602093846000960137010152565b60206003198201126125c357600435906001600160401b0382116125c357806023830112156125c3578160246127c893600401359101612756565b90565b90815180825260208080930193019160005b8281106127eb575050505090565b83516001600160a01b0316855293810193928101926001016127dd565b90815180825260208080930193019160005b828110612828575050505090565b83518552938101939281019260010161281a565b60609060031901126125c3576004356001600160a01b03811681036125c3579060243561ffff811681036125c3579060443590565b6033546001600160a01b0316330361288557565b606460405162461bcd60e51b815260206004820152602060248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152fd5b603380546001600160a01b039283166001600160a01b0319821681179092559091167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a3565b1561291957565b60405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606490fd5b600090815260cb60205260409020546001600160a01b03166127c8811515612912565b90600182811c921680156129b1575b602083101461299b57565b634e487b7160e01b600052602260045260246000fd5b91607f1691612990565b906000916101429081546129ce81612981565b80835292600191808316908115612a4d57506001146129ee575b50505050565b90929394506000527f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae19916000925b848410612a3557505060209250010190388080806129e8565b80546020858501810191909152909301928101612a1c565b92505050602093945060ff929192191683830152151560051b010190388080806129e8565b90600091610143908154612a8581612981565b80835292600191808316908115612a4d5750600114612aa45750505050565b90929394506000527f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d532916000925b848410612aeb57505060209250010190388080806129e8565b80546020858501810191909152909301928101612ad2565b90600091610175908154612b1681612981565b80835292600191808316908115612a4d5750600114612b355750505050565b90929394506000527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f916000925b848410612b7c57505060209250010190388080806129e8565b80546020858501810191909152909301928101612b63565b9060009291805491612ba583612981565b918282526001938481169081600014612c065750600114612bc65750505050565b90919394506000526020928360002092846000945b838610612bf25750505050010190388080806129e8565b805485870183015294019385908201612bdb565b9294505050602093945060ff191683830152151560051b010190388080806129e8565b600081815260cb6020526040902054612c4c906001600160a01b03161515612912565b600090815260cd60205260409020546001600160a01b031690565b15612c6e57565b60405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608490fd5b60809060208152603260208201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b60608201520190565b15612d2357565b60405162461bcd60e51b815280612d3c60048201612cc9565b0390fd5b906001600160a01b038080612d548461295e565b16931691838314938415612d87575b508315612d71575b50505090565b612d7d91929350612c29565b1614388080612d6b565b90935060005260ce60205260406000208260005260205260ff604060002054169238612d63565b15612db557565b60405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608490fd5b90612e3091612e168461295e565b6001600160a01b0393918416928492909183168414612dae565b16918215612f385781612ecd5781612e5291612e4b8661295e565b1614612dae565b7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600084815260cd602052604081206001600160601b0360a01b9081815416905583825260cc602052604082206000198154019055848252604082206001815401905585825260cb60205284604083209182541617905580a4565b60405162461bcd60e51b815260206004820152603e60248201527f4e6f6e5472616e736665727261626c65455243373231546f6b656e3a204e6f6d60448201527f69732073636f72652063616e2774206265207472616e736665727265642e00006064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b3d15612fb4573d90612f9a8261273b565b91612fa8604051938461271a565b82523d6000602084013e565b606090565b9091600091803b156130a4576130046020918493604051948580948193630a85bd0160e11b9a8b84523360048501528460248501526044840152608060648401526084830190612588565b03926001600160a01b03165af19082908261305c575b505061304e57613028612f89565b805190816130495760405162461bcd60e51b815280612d3c60048201612cc9565b602001fd5b6001600160e01b0319161490565b909192506020813d821161309c575b816130786020938361271a565b810103126103f55751906001600160e01b03198216820361031f575090388061301a565b3d915061306b565b50505050600190565b91926000929190813b1561311e576020916131039185604051958680958194630a85bd0160e11b9b8c845233600485015260018060a01b0380951660248501526044840152608060648401526084830190612588565b0393165af19082908261305c57505061304e57613028612f89565b5050505050600190565b6001600160401b0381116126e95760051b60200190565b8181029291811591840414171561315257565b634e487b7160e01b600052601160045260246000fd5b818110613173575050565b60008155600101613168565b60ff6065541661318b57565b60405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606490fd5b60001981146131525760010190565b80518210156131e65760209160051b010190565b634e487b7160e01b600052603260045260246000fd5b60405190613209826126ff565b60048252634e4d535360e01b6020830152565b1561322357565b60405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608490fd5b9190601f811161328b57505050565b6132b6926000526020600020906020601f840160051c83019310610a9457601f0160051c0190613168565b565b9b9a999897969594939291903360005261013f602052604060002061ffff84166000526020526040600020546000908d6134fe575b33600052610137602052604060002089600052602052604060002061ffff861660005260205260406000203360005261013e80602052604060002061ffff88166000526020526040600020546134d5575b50600101546134215750341480613418575b80156133ef575b80156133e3575b80156133b8575b15613373576132b69c613574565b60405162461bcd60e51b815260206004820152601e60248201527f4d696e74206665653a2077726f6e67206d696e74206665652076616c756500006044820152606490fd5b5061ffff831660005261013660205260406000205461013d60205261ffff6040600020541611613365565b5061013b54341461335e565b503360005261013a602052604060002061ffff841660005260205260ff60406000205416613357565b50341515613350565b90503414806134cc575b80156134a3575b8015613497575b15613447576132b69c613574565b60405162461bcd60e51b815260206004820152602260248201527f557064617465206665653a2077726f6e6720757064617465206665652076616c604482015261756560f01b6064820152608490fd5b5061013c543414613439565b503360005261013a602052604060002061ffff841660005260205260ff60406000205416613432565b5034151561342b565b90925033600052602052604060002061ffff86166000526020526001604060002054929061333e565b8d91506132ed565b80548210156131e65760005260206000200190600090565b8054600160401b8110156126e95761353b91600182018155613506565b819291549060031b91821b91600019901b1916179055565b908060209392818452848401376000828201840152601f01601f1916010190565b909b9a98969391999b95949561271061ffff8c1611613f5c57824211613f0b5761ffff610133541661ffff85161015613e91578a8d93366135b6908b8d612756565b805190602001209d8e958d36906135cc92612756565b8051906020012095336000526101386020526040600020928354936135f0856131c3565b90556135fd368c8e612756565b80519060200120906040519460208601967fc11af91045266b8c5df4fb4c0d475785635da25fd18ae4bb0d9b02415d5f93bd885261ffff16604087015261ffff8b16606087015233608087015260a086015260c085015260e08401528861010084015261012083015285610140830152610160908183015281528061018081011061018082016001600160401b0310176126e9576101808101604052519020906136a56141de565b6136ad614232565b936040519460208601927f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f8452604087015260608601524660808601523060a086015260a0855260c08501948086106001600160401b038711176126e957856137429560e260429361373c9661374a9a6040528151902061190160f01b855260c2820152015220923691612756565b90614117565b919091613ffd565b6033546001600160a01b03918216911681149081613e87575b5015613e425760009933600052610137602052604060002084600052602052604060002061ffff841660005260205260406000209a60018c015415613e34575b60028c549c42600182015501805461ffff8d1661ffff821603613e20575b5050613a38575b50506137d5368486612756565b60008a815260cb60205260409020546001600160a01b0316156139dc578960005260fb602052604060002081516001600160401b0381116126e9578b92613826826138208554612981565b8561327c565b602090601f831160011461390e576138fe99957ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce760207f3f19ae12b2e27269f8cfcf53b4960a5ac6ba1d714d2c729941e7b20adf54ee679f9d99949761ffff9f9c9761ffff9597806138e09b6138ee9f9a600092613903575b50508160011b916000199060031b1c19161790555b604051908152a16040519c8d9c168c521660208b015260408a015260c060608a015260c0890191613553565b918683036080880152613553565b9083820360a08501523397613553565b0390a3565b01519050388061389f565b908360005260206000209160005b601f19851681106139c15750957ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce760207f3f19ae12b2e27269f8cfcf53b4960a5ac6ba1d714d2c729941e7b20adf54ee679f9d99949761ffff9f9c9761ffff956138fe9f9b986138e09b6138ee9f9a9260019383601f198116106139a8575b505050811b0190556138b4565b015160001960f88460031b161c1916905538808061399b565b8183015184558f96506001909301926020928301920161391c565b60405162461bcd60e51b815260206004820152602e60248201527f45524337323155524953746f726167653a2055524920736574206f66206e6f6e60448201526d32bc34b9ba32b73a103a37b5b2b760911b6064820152608490fd5b3360005261012e60205260406000206001600160401b0388116126e957613a6988613a638354612981565b8361327c565b876000601f8211600114613db957600091613dae575b508860011b906000198a60031b1c19161790555b60005261012f6020526040600020336001600160601b0360a01b82541617905580600052610132602052613acb8a604060002061351e565b604051613ad7816126ce565b600081523315613d6a576107aa613b9891613b34613b118e613b17613b118260005260cb60205260018060a01b0360406000205416151590565b15613fb1565b600090815260cb60205260409020546001600160a01b0316151590565b3360005260cc6020526040600020600181540190558c60005260cb6020526040600020336001600160601b0360a01b8254161790558c3360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a48c33612fb9565b6101746001815401905561ffff82166000526101366020526040600020613bbf81546131c3565b905589600052610134602052604060002061ffff831661ffff198254161790556101356020528260406000205533600052610139602052613c048a604060002061351e565b80613c10575b806137c8565b600090815261012f60205260409020546001600160a01b03168015613d2057600081815261013060205260409020548015613d1557905b600080808085855af1613c58612f89565b5015613cc1576040514281527f554d9717d841320a49468eba4a7c75a535cf5b26f6063330058afcd6ed492ff460203392a27f16e0c135ad5198482dd8326eb47c9c1a3adef8cb405f743c99a0c1fd414e11606040805160018152426020820152a35b38613c0a565b60405162461bcd60e51b815260206004820152602660248201527f73657453636f72653a20636c61696d20726566657272616c207265776172642060448201526519985a5b195960d21b6064820152608490fd5b5061012d5490613c47565b5061013160205260406000208054600160401b8110156126e957613d4991600182018155613506565b81546001600160a01b0360039290921b91821b19163390911b179055613cbb565b606460405162461bcd60e51b815260206004820152602060248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152fd5b905089013538613a7f565b60008381526020812092505b8b601f198c168210613e0857505089601f19811610613dee575b5050600188811b019055613a93565b8a013560001960038b901b60f8161c191690553880613ddf565b60018394602093948493013581550193019101613dc5565b61ffff191661ffff8d1617905538806137c1565b506001610174548c556137a3565b60405162461bcd60e51b815260206004820152601b60248201527f73657453636f72653a20496e76616c6964207369676e617475726500000000006044820152606490fd5b9050151538613763565b60405162461bcd60e51b815260206004820152604660248201527f73657453636f72653a2063616c63756c6174696f6e4d6f64656c2073686f756c60448201527f64206265206c657373207468616e2063616c63756c6174696f6e206d6f64656c6064820152650818dbdd5b9d60d21b608482015260a490fd5b60405162461bcd60e51b8152602060048201526024808201527f73657453636f72653a205369676e6564207472616e73616374696f6e206578706044820152631a5c995960e21b6064820152608490fd5b60405162461bcd60e51b815260206004820152602760248201527f73657453636f72653a2053636f7265206d757374206265206c6573732074686160448201526606e2031303030360cc1b6064820152608490fd5b15613fb857565b60405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606490fd5b6005811015614101578061400e5750565b6001810361405b5760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606490fd5b600281036140a85760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606490fd5b6003146140b157565b60405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608490fd5b634e487b7160e01b600052602160045260246000fd5b90604181511460001461414557614141916020820151906060604084015193015160001a9061414f565b9091565b5050600090600290565b9291907f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083116141d25791608094939160ff602094604051948552168484015260408301526060820152600093849182805260015afa156141c55781516001600160a01b038116156141bf579190565b50600190565b50604051903d90823e3d90fd5b50505050600090600390565b6040516141ee816119fa816129bb565b80519081156141fe576020012090565b505061014054801561420d5790565b507fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a47090565b604051614242816119fa81612a72565b8051908115614252576020012090565b505061014154801561420d5790565b600081815260cb6020526040902054614284906001600160a01b03161515612912565b600081815260209060fb82526040906119fa6142a7838320845192838092612b94565b82516142b6816119fa81612b03565b80519182156144ed5780516144bc57505050600084815260cb60205260409020546142eb906001600160a01b03161515612912565b8151916142fb83610e9981612b03565b8251156144a75784859083967a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000009081811015614498575b50506d04ee2d6d415b85acef81000000008083101561448a575b50662386f26fc100008083101561447b575b506305f5e1008083101561446c575b506127108083101561445d575b50606482101561444d575b600a80921015614443575b600190816021818a01996143b66143a18c61273b565b9b6143ae89519d8e61271a565b808d5261273b565b8b8b019890601f1901368a37508a0101905b61440d575b5050505090614401946127c89493925195836143f28895518092888089019101612565565b84019151809386840190612565565b0103808452018261271a565b600019019083906f181899199a1a9b1b9c1cb0b131b232b360811b8282061a83530491821561443e579190826143c8565b6143cd565b956001019561438b565b9590606460029104910195614380565b60049197920491019538614375565b60089197920491019538614368565b60109197920491019538614359565b869197920491019538614347565b9197509150048195388061432d565b925092505051906144b7826126ce565b815290565b9195509150846144d96127c8959451968794868087019101612565565b820161440182518093868085019101612565565b9550505050505090565b91908110156131e65760051b0190565b356001600160a01b03811681036125c3579056fea2646970667358221220bff3d256514e882d44205a2fd15cadf96e4595cc46eb2660cf6948933361d2de64736f6c63430008130033Deployed ByteCode
0x608060408181526004918236101561001657600080fd5b600090813560e01c90816301ffc9a7146124df5750806305eaab4b1461225a57806306fdde03146121b0578063081812fc14612191578063095ea7b3146120205780630f25b13714611f695780631048fbf814611f4957806323b872dd14611f245780632b08672f14611e565780632d0335ab14611e1d5780632e1a7d4d14611ce95780633938da5914611c455780633be159ed14611ba55780633f4ba83a14611b0f57806342842e0e14611adb578063523033aa14610de65780635618923614611abb578063590adabe14611a925780635c975abb14611a6e5780635ff329af146119a0578063631c1052146118b85780636352211e146118885780636a2e770f1461184057806370a08231146117ab578063710b43001461175d578063715018a6146117005780637a5caab3146116e05780637ca40d1c14610f995780638456cb5914610f3e57806384b0196e14610e455780638da5cb5b14610e1c5780638e52c21714610de65780638ee67edb14610d985780638fb6c6f614610d50578063902a859a14610cde57806392c4034414610c9057806395d89b4114610bab57806397f5eda614610b115780639995626614610ade578063a09bddaa14610ab1578063a0bcfc7f1461090a578063a22cb4651461083a578063a93986b1146107d3578063b7b0ccde146107b3578063b88d4fde14610729578063bdbbd85b146106c2578063c87b56dd1461068f578063cbec2cdb1461066b578063d004b0361461058d578063d241c3291461053a578063db0b2b101461048f578063e985e9c514610441578063eddd0d9c146103f9578063eef1d20f146103b8578063f2fde38b146103225763fc1ac1d31461028c57600080fd5b3461031f5761029a3661278d565b6020815191012080156102c55760209350815261012f83528160018060a01b03912054169051908152f35b825162461bcd60e51b8152602081860152602e60248201527f67657457616c6c65744279526566657272616c436f64653a20496e76616c696460448201526d20726566657272616c20636f646560901b6064820152608490fd5b80fd5b5091346103b45760203660031901126103b45761033d6125ad565b91610346612871565b6001600160a01b03831615610362578361035f846128c9565b80f35b906020608492519162461bcd60e51b8352820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b6064820152fd5b8280fd5b5090346103f557806003193601126103f5576103d26125ad565b6103da612871565b6001600160a01b031682526101306020528120602435905580f35b5080fd5b5082346103f55760203660031901126103f55735610415612871565b8061013b557f0dfc6eec96b100579d23188487733288387140dea6c20dcf97a742a857b132738280a280f35b5090346103f557806003193601126103f55760ff816020936104616125ad565b6104696125c8565b6001600160a01b03918216835260ce875283832091168252855220549151911615158152f35b5090346103f55761049f36612673565b906104a8612871565b845b8181106104b5578580f35b610535906001600160a01b03806104d56104d084878a6144f7565b614507565b168852602061013a815287892061ffff871691828b5252878920916001928360ff1982541617905561050b6104d085888b6144f7565b167f89260241ebd53b9ff7a3778cb628f41b86fcce20041a1f23c751005663420c7a8a80a46131c3565b6104aa565b5090346103f557806003193601126103f55760ff8160209361055a6125ad565b61056261260b565b6001600160a01b03909116825261013a865282822061ffff9091168252855220549151911615158152f35b509190346103b45760209182600319360112610667576105ab6125ad565b90610174541561062457506001600160a01b031683526101398252808320815181548082529185528385209094859283860192915b8682821061060d578590610609886105fa8489038561271a565b51928284938452830190612808565b0390f35b8354855288955090930192600192830192016105e0565b825162461bcd60e51b8152908101849052601d60248201527f676574546f6b656e4964733a204e6f20746f6b656e73206d696e7465640000006044820152606490fd5b8380fd5b5090346103f557816003193601126103f55760209061ffff61013354169051908152f35b503461031f57602036600319011261031f57506106af6106099235614261565b9051918291602083526020830190612588565b5090346103f5576106d23661283c565b809391926106de612871565b60018060a01b03169182865261013f60205261ffff8187209416938487526020528520557ff3d990281b2074ce0d470fa6b9bb65b5376fbd7e946d091e47490a06743f496d8480a480f35b5082346103f55760803660031901126103f5576107446125ad565b9061074d6125c8565b91604435606435936001600160401b0385116107af57366023860112156107af576107876107aa9486602461035f98369301359101612756565b9261079a6107958433612d40565b612c67565b6107a5838383612e08565b6130ad565b612d1c565b8580fd5b5090346103f557816003193601126103f55760209061013c549051908152f35b5090346103f5576107e33661283c565b809391926107ef612871565b60018060a01b03169182865261013e60205261ffff8187209416938487526020528520557fdb0ab24533f4d50ca30cd5978eddbb5a07340c32ff1809f24f6ce598e8eafc398480a480f35b509190346103b457806003193601126103b4576108556125ad565b9060243591821515809303610906576001600160a01b0316923384146108c4575033845260ce60205280842083855260205280842060ff1981541660ff8416179055519081527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3160203392a380f35b6020606492519162461bcd60e51b8352820152601960248201527f4552433732313a20617070726f766520746f2063616c6c6572000000000000006044820152fd5b8480fd5b5090346103f55761091a3661278d565b90610923612871565b8151936001600160401b038511610a9e5750610175906109438254612981565b601f8111610a46575b5060209182601f87116001146109c5579580869761098e97916109ba575b508160011b916000199060031b1c19161790555b5192828480945193849201612565565b81010390207f9bda31c5daf938016d59248ce284119fc191a83aabdfb40b4405397af0a9c97b8280a280f35b90508501513861096a565b8186527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f90601f198816875b818110610a2f575091889161098e989960019410610a16575b5050811b01905561097e565b87015160001960f88460031b161c191690553880610a0a565b91928660018192868b0151815501940192016109f1565b610a8e908386527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f601f880160051c81019160208910610a94575b601f0160051c0190613168565b3861094c565b9091508190610a81565b634e487b7160e01b845260419052602483fd5b5091346103b45760203660031901126103b4578160209361ffff9235815261013485522054169051908152f35b5090346103f55760203660031901126103f5578060209261ffff610b0061262d565b168152610136845220549051908152f35b5090346103f55760603660031901126103f557610609610b2f6125ad565b602435610b3a61261c565b6001600160a01b03929092168086526101376020908152858720838852815285872061ffff948516808952908252968690206002810154600182015491549751951685529084015260408301949094526060820194909452608081019390935260a0830191909152819060c0820190565b5090346103f557816003193601126103f5578051908260ca54610bcd81612981565b80855291600191808316908115610c685750600114610c0b575b505050610bf98261060994038361271a565b51918291602083526020830190612588565b945060ca85527f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee15b828610610c5057505050610bf98260206106099582010194610be7565b80546020878701810191909152909501948101610c33565b610609975086935060209250610bf994915060ff191682840152151560051b82010194610be7565b5090346103f55760203660031901126103f55761060991610cd79190610bf99082906001600160a01b03610cc26125ad565b16815261012e60205220825193848092612b94565b038361271a565b5090346103f557806003193601126103f557610cf861262d565b90610d0161260b565b610d09612871565b61ffff8091169182855261013d60205284209216918261ffff198254161790557fc3ae431c8f115f13156aad0dc084ce6c552f8ae33c5dda5c7d7dc7e450f4255e8380a380f35b5082346103f55760203660031901126103f55735610d6c612871565b8061012d557f14ea2ed84c55d689785f43bcf8e2a56a3bd24dd6fc33946dfd7f7b5bdb5f03218280a280f35b5090346103f557806003193601126103f55780602092610db66125ad565b610dbe61260b565b6001600160a01b03909116825261013e855282822061ffff9091168252845220549051908152f35b5090346103f55760203660031901126103f5576020918161ffff9182610e0a61262d565b16815261013d85522054169051908152f35b5090346103f557816003193601126103f55760335490516001600160a01b039091168152602090f35b5082346103f557816003193601126103f557610140541580610f33575b15610ef857610ecc8361060984825192610e8684610e7f816129bb565b038561271a565b610ed9815191610ea083610e9981612a72565b038461271a565b805192610eac846126ce565b8484528151978897600f60f81b895260e060208a015260e0890190612588565b9187830390880152612588565b9146606086015230608086015260a085015283820360c0850152612808565b606490602084519162461bcd60e51b835282015260156024820152741152540dcc4c8e88155b9a5b9a5d1a585b1a5e9959605a1b6044820152fd5b506101415415610e62565b5090346103f557816003193601126103f55760207f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25891610f7c612871565b610f8461317f565b600160ff19606554161760655551338152a180f35b5091346103b457816003193601126103b457610fb361260b565b83549060ff92838360081c1615918280936116d4575b80156116be575b1561166457600193838560ff198316178955611653575b50855194610ff4866126ff565b600a8652602095694e6f6d697353636f726560b01b878201526110156131fc565b61102d838b5460081c166110288161321c565b61321c565b8151906001600160401b039182811161156857808c61104d60c954612981565b95601f968d888211611607575b50508c91878411600114611586579261157b575b5050600019600383901b1c191690891b1760c9555b8051908282116115685781908c8b61109c60ca54612981565b87811161151c575b5050508a9085831160011461149c578d92611491575b5050600019600383901b1c191690881b1760ca555b6110d76131fc565b918951926110e4846126ff565b6003845262302e3960e81b8a850152611106858d5460081c166110288161321c565b805183811161147e57808d610142938d6111208654612981565b90878211611433575b50508d918684116001146113aa579261139f575b5050600019600383901b1c1916908a1b1790555b825191821161138c57610143928b8a61116a8654612981565b86858211611337575b505050508b8a9284116001146112ab57926111c49492819261ffff989795926112a0575b5050600019600383901b1c191690891b1790555b89610140558961014155895460081c166110288161321c565b6111cd336128c9565b61017485815401905582358061013b5561013c551690811561123757506101339061ffff19825416179055611200578380f35b7f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989261ff0019855416855551908152a13880808380f35b855162461bcd60e51b8152908101859052603c60248201527f636f6e7374727563746f723a20696e697469616c43616c634d6f64656c73436f60448201527f756e742073686f756c642062652067726561746572207468616e2030000000006064820152608490fd5b015190503880611197565b9091899392601f1984168684527f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d532935b8d8282106113215750509161ffff9897959391856111c498969410611308575b505050811b0190556111ab565b015160001960f88460031b161c191690553880806112fb565b8385015186558d979095019493840193016112db565b61137a9352847f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d5329181880160051c8301938810611383575b0160051c0190613168565b8b8a3886611173565b9250819261136f565b634e487b7160e01b8b526041865260248bfd5b01519050388061113d565b91908d94508e8684527f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae1993601f198616915b82821061141257505084116113f9575b505050811b019055611151565b015160001960f88460031b161c191690553880806113ec565b91929395968291958786015181550195019301908f918f96959493926113dc565b61147791878552887f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae199181880160051c8301938810611383570160051c0190613168565b388e611129565b634e487b7160e01b8d526041885260248dfd5b0151905038806110ba565b60ca8e528a93507f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee19190601f1984168f8e5b82821061150557505084116114ec575b505050811b0160ca556110cf565b015160001960f88460031b161c191690553880806114de565b8385015186558e979095019493840193018e6114ce565b60ca6115609352877f42d72674974f694b5f5159593243114d38a5c39c89d6b62fee061ff523240ee19181870160051c8301938710611383570160051c0190613168565b8c8b386110a4565b634e487b7160e01b8c526041875260248cfd5b01519050388061106e565b60c981528c94507f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d28929190601f198516908f5b8282106115f057505084116115d7575b505050811b0160c955611083565b015160001960f88460031b161c191690553880806115c9565b8385015186558f979095019493840193018f6115b9565b61164c9160c98552897f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d289181880160051c8301938810611383570160051c0190613168565b388d61105a565b61ffff191661010117875538610fe7565b855162461bcd60e51b8152602081840152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b6064820152608490fd5b50303b158015610fd05750600185851614610fd0565b50600185851610610fc9565b5090346103f557816003193601126103f55760209061013b549051908152f35b503461031f578060031936011261031f57611719612871565b603380546001600160a01b0319811690915581906001600160a01b03167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08280a380f35b5090346103f557806003193601126103f5578060209261177b6125ad565b61178361260b565b6001600160a01b03909116825261013f855282822061ffff9091168252845220549051908152f35b5082346103f55760203660031901126103f5576001600160a01b036117ce6125ad565b169081156117eb57602084808585815260cc845220549051908152f35b608490602085519162461bcd60e51b8352820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152fd5b5082346103f55760203660031901126103f5573561185c612871565b8061013c557f1a1fdd6048edb5d9cc6acd350eadec9121194106777efa0f11794b3f9e62955b8280a280f35b503461031f57602036600319011261031f57506118a76020923561295e565b90516001600160a01b039091168152f35b5090346103f5576118c83661278d565b805160208092012083526101328152818320908251808383829554938481520190875283872092875b8582821061198a575050506119089250038361271a565b81519361191485613128565b946119218551968761271a565b808652611930601f1991613128565b0136838701375b8251811015611978578061195761195161197393866131d2565b5161295e565b61196182886131d2565b6001600160a01b0390911690526131c3565b611937565b835182815280610609818501886127cb565b85548452600195860195889550930192016118f1565b5090346103f557602090816003193601126103b4576119bd6125ad565b6001600160a01b0390811684526101308352818420549093908015611a6357905b33815261012e84526119fa611a01848320855192838092612b94565b038261271a565b8481519101208152610131845282812094835191828688549182815201978252868220915b818110611a4d578787611a468888611a40818f038261271a565b5161313f565b9051908152f35b8254841689529787019760019283019201611a26565b5061012d54906119de565b5090346103f557816003193601126103f55760209060ff6065541690519015158152f35b5091346103b45760203660031901126103b4576020928291358152610135845220549051908152f35b5090346103f557816003193601126103f557602090610174549051908152f35b5090346103f5576107aa61035f91611af23661263e565b91925192611aff846126ce565b86845261079a6107958433612d40565b5091346103b457826003193601126103b457611b29612871565b6065549060ff821615611b6b575060ff1916606555513381527f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa90602090a180f35b606490602084519162461bcd60e51b8352820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152fd5b5091346103b45760208060031936011261066757610609913590611bc88261295e565b9185526101348152838520546101358252848620546001600160a01b039093168087526101378352858720848852835285872061ffff928316808952935295859020600281015460018201549154965192168252602082015260408101949094526060840152608083015260a082019290925290819060c0820190565b5090346103f557611c5536612673565b919290611c60612871565b845b818110611c6d578580f35b611ce490866001600160a01b0380611c896104d085888c6144f7565b16825260209061013a825286832061ffff8916928385525286832060ff198154169055611cba6104d085888c6144f7565b167f89260241ebd53b9ff7a3778cb628f41b86fcce20041a1f23c751005663420c7a8380a46131c3565b611c62565b5091346103b45760203660031901126103b457803591611d07612871565b478015611dda578311611d97578380808086335af1611d24612f89565b5015611d54575050337f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b658380a380f35b906020606492519162461bcd60e51b8352820152601b60248201527f5769746864726177616c3a207472616e73666572206661696c656400000000006044820152fd5b906020606492519162461bcd60e51b8352820152601e60248201527f5769746864726177616c3a20496e73756666696369656e742066756e647300006044820152fd5b815162461bcd60e51b8152602081850152601e60248201527f5769746864726177616c3a204e6f2066756e647320617661696c61626c6500006044820152606490fd5b5090346103f55760203660031901126103f55760209181906001600160a01b03611e456125ad565b168152610138845220549051908152f35b5091346103b45760203660031901126103b45761ffff611e7461262d565b611e7c612871565b16918215611ebb575050610133805461ffff1916821790557f279cbae98d21cc94b9c9de893c44ac632afa05edb3f83372abad1c412673959e8280a280f35b906020608492519162461bcd60e51b8352820152603c60248201527f73657443616c634d6f64656c73436f756e743a2063616c634d6f64656c73436f60448201527f756e742073686f756c642062652067726561746572207468616e2030000000006064820152fd5b503461031f5761035f611f363661263e565b91611f446107958433612d40565b612e08565b5090346103f557816003193601126103f55760209061012d549051908152f35b50826101203660031901126103f5576001600160401b03813581811161066757611f9690369084016125de565b91611f9f61260b565b92611fa861261c565b9160843581811161201c57611fc090369088016125de565b60c49391933583811161201857611fda9036908a016125de565b94909360e4359081116120145761035f99611ff7913691016125de565b97909661200261317f565b610104359960a43595606435936132b8565b8a80fd5b8980fd5b8780fd5b5091346103b457816003193601126103b45761203a6125ad565b6024359290916001600160a01b03919082806120558761295e565b1694169380851461214457803314908115612125575b50156120bd575083855260cd602052842080546001600160a01b031916831790556120958361295e565b167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258480a480f35b6020608492519162461bcd60e51b8352820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152fd5b9050865260ce60205281862033875260205260ff82872054163861206b565b506020608492519162461bcd60e51b8352820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152fd5b503461031f57602036600319011261031f57506118a760209235612c29565b5090346103f557816003193601126103f5578051908260c9546121d281612981565b80855291600191808316908115610c6857506001146121fd57505050610bf98261060994038361271a565b945060c985527f66be4f155c5ef2ebd3772b228f2f00681e4ed5826cdb3b1943cc11ad15ad1d285b82861061224257505050610bf98260206106099582010194610be7565b80546020878701810191909152909501948101612225565b509190346103b457826003193601126103b45761227561317f565b3383526020906101308252808420548015156000146124d457915b61012e81526119fa6122a9838720845192838092612b94565b81815191012093848652610131808352838720948451809687918682549182815201918b52868b20908b5b888282106124b4575050505061233692916122f091038861271a565b7f10e5dd73c78f20ac02a01872a45cab5e858e67f5b51725e641fe2af492967abd61232888519888519182918a83528a8301906127cb565b42898301520390a18661313f565b95861561245e5747871161240a57875282528286208054878255806123f1575b50508580808088335af1612368612f89565b50156123a25750907f16e0c135ad5198482dd8326eb47c9c1a3adef8cb405f743c99a0c1fd414e116091815193845242908401523392a380f35b915162461bcd60e51b815291820152602560248201527f636c61696d526566657272616c526577617264733a207472616e736665722066604482015264185a5b195960da1b6064820152608490fd5b61240391885283882090810190613168565b3880612356565b845162461bcd60e51b8152808401859052602860248201527f636c61696d526566657272616c526577617264733a20496e73756666696369656044820152676e742066756e647360c01b6064820152608490fd5b845162461bcd60e51b8152808401859052602a60248201527f636c61696d526566657272616c526577617264733a204e6f207265776172647360448201526920617661696c61626c6560b01b6064820152608490fd5b83546001600160a01b031685528b955090930192600192830192016122d4565b5061012d5491612290565b905083346103b45760203660031901126103b4573563ffffffff60e01b81168091036103b45760209250632483248360e11b8114908115612522575b5015158152f35b6380ac58cd60e01b811491508115612554575b8115612543575b508361251b565b6301ffc9a760e01b1490508361253c565b635b5e139f60e01b81149150612535565b60005b8381106125785750506000910152565b8181015183820152602001612568565b906020916125a181518092818552858086019101612565565b601f01601f1916010190565b600435906001600160a01b03821682036125c357565b600080fd5b602435906001600160a01b03821682036125c357565b9181601f840112156125c3578235916001600160401b0383116125c357602083818601950101116125c357565b6024359061ffff821682036125c357565b6044359061ffff821682036125c357565b6004359061ffff821682036125c357565b60609060031901126125c3576001600160a01b039060043582811681036125c3579160243590811681036125c3579060443590565b9060406003198301126125c3576004356001600160401b03928382116125c357806023830112156125c35781600401359384116125c35760248460051b830101116125c357602401919060243561ffff811681036125c35790565b602081019081106001600160401b038211176126e957604052565b634e487b7160e01b600052604160045260246000fd5b604081019081106001600160401b038211176126e957604052565b90601f801991011681019081106001600160401b038211176126e957604052565b6001600160401b0381116126e957601f01601f191660200190565b9291926127628261273b565b91612770604051938461271a565b8294818452818301116125c3578281602093846000960137010152565b60206003198201126125c357600435906001600160401b0382116125c357806023830112156125c3578160246127c893600401359101612756565b90565b90815180825260208080930193019160005b8281106127eb575050505090565b83516001600160a01b0316855293810193928101926001016127dd565b90815180825260208080930193019160005b828110612828575050505090565b83518552938101939281019260010161281a565b60609060031901126125c3576004356001600160a01b03811681036125c3579060243561ffff811681036125c3579060443590565b6033546001600160a01b0316330361288557565b606460405162461bcd60e51b815260206004820152602060248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e65726044820152fd5b603380546001600160a01b039283166001600160a01b0319821681179092559091167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a3565b1561291957565b60405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606490fd5b600090815260cb60205260409020546001600160a01b03166127c8811515612912565b90600182811c921680156129b1575b602083101461299b57565b634e487b7160e01b600052602260045260246000fd5b91607f1691612990565b906000916101429081546129ce81612981565b80835292600191808316908115612a4d57506001146129ee575b50505050565b90929394506000527f7917ad5f1bd6fa6d4f9128143f89bcba30c5b503e76ecd2dd7562ddf9706ae19916000925b848410612a3557505060209250010190388080806129e8565b80546020858501810191909152909301928101612a1c565b92505050602093945060ff929192191683830152151560051b010190388080806129e8565b90600091610143908154612a8581612981565b80835292600191808316908115612a4d5750600114612aa45750505050565b90929394506000527f90f1fbe211cc96d1ddedecd2113dc32c31d712d12ce1f36d6a07e605dcf7d532916000925b848410612aeb57505060209250010190388080806129e8565b80546020858501810191909152909301928101612ad2565b90600091610175908154612b1681612981565b80835292600191808316908115612a4d5750600114612b355750505050565b90929394506000527f94b016e6b5eafb28c9d47c3523378ec087cc0ead8b7eff2840605504c1f1ac6f916000925b848410612b7c57505060209250010190388080806129e8565b80546020858501810191909152909301928101612b63565b9060009291805491612ba583612981565b918282526001938481169081600014612c065750600114612bc65750505050565b90919394506000526020928360002092846000945b838610612bf25750505050010190388080806129e8565b805485870183015294019385908201612bdb565b9294505050602093945060ff191683830152151560051b010190388080806129e8565b600081815260cb6020526040902054612c4c906001600160a01b03161515612912565b600090815260cd60205260409020546001600160a01b031690565b15612c6e57565b60405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608490fd5b60809060208152603260208201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b60608201520190565b15612d2357565b60405162461bcd60e51b815280612d3c60048201612cc9565b0390fd5b906001600160a01b038080612d548461295e565b16931691838314938415612d87575b508315612d71575b50505090565b612d7d91929350612c29565b1614388080612d6b565b90935060005260ce60205260406000208260005260205260ff604060002054169238612d63565b15612db557565b60405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608490fd5b90612e3091612e168461295e565b6001600160a01b0393918416928492909183168414612dae565b16918215612f385781612ecd5781612e5291612e4b8661295e565b1614612dae565b7fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef600084815260cd602052604081206001600160601b0360a01b9081815416905583825260cc602052604082206000198154019055848252604082206001815401905585825260cb60205284604083209182541617905580a4565b60405162461bcd60e51b815260206004820152603e60248201527f4e6f6e5472616e736665727261626c65455243373231546f6b656e3a204e6f6d60448201527f69732073636f72652063616e2774206265207472616e736665727265642e00006064820152608490fd5b60405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b3d15612fb4573d90612f9a8261273b565b91612fa8604051938461271a565b82523d6000602084013e565b606090565b9091600091803b156130a4576130046020918493604051948580948193630a85bd0160e11b9a8b84523360048501528460248501526044840152608060648401526084830190612588565b03926001600160a01b03165af19082908261305c575b505061304e57613028612f89565b805190816130495760405162461bcd60e51b815280612d3c60048201612cc9565b602001fd5b6001600160e01b0319161490565b909192506020813d821161309c575b816130786020938361271a565b810103126103f55751906001600160e01b03198216820361031f575090388061301a565b3d915061306b565b50505050600190565b91926000929190813b1561311e576020916131039185604051958680958194630a85bd0160e11b9b8c845233600485015260018060a01b0380951660248501526044840152608060648401526084830190612588565b0393165af19082908261305c57505061304e57613028612f89565b5050505050600190565b6001600160401b0381116126e95760051b60200190565b8181029291811591840414171561315257565b634e487b7160e01b600052601160045260246000fd5b818110613173575050565b60008155600101613168565b60ff6065541661318b57565b60405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606490fd5b60001981146131525760010190565b80518210156131e65760209160051b010190565b634e487b7160e01b600052603260045260246000fd5b60405190613209826126ff565b60048252634e4d535360e01b6020830152565b1561322357565b60405162461bcd60e51b815260206004820152602b60248201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960448201526a6e697469616c697a696e6760a81b6064820152608490fd5b9190601f811161328b57505050565b6132b6926000526020600020906020601f840160051c83019310610a9457601f0160051c0190613168565b565b9b9a999897969594939291903360005261013f602052604060002061ffff84166000526020526040600020546000908d6134fe575b33600052610137602052604060002089600052602052604060002061ffff861660005260205260406000203360005261013e80602052604060002061ffff88166000526020526040600020546134d5575b50600101546134215750341480613418575b80156133ef575b80156133e3575b80156133b8575b15613373576132b69c613574565b60405162461bcd60e51b815260206004820152601e60248201527f4d696e74206665653a2077726f6e67206d696e74206665652076616c756500006044820152606490fd5b5061ffff831660005261013660205260406000205461013d60205261ffff6040600020541611613365565b5061013b54341461335e565b503360005261013a602052604060002061ffff841660005260205260ff60406000205416613357565b50341515613350565b90503414806134cc575b80156134a3575b8015613497575b15613447576132b69c613574565b60405162461bcd60e51b815260206004820152602260248201527f557064617465206665653a2077726f6e6720757064617465206665652076616c604482015261756560f01b6064820152608490fd5b5061013c543414613439565b503360005261013a602052604060002061ffff841660005260205260ff60406000205416613432565b5034151561342b565b90925033600052602052604060002061ffff86166000526020526001604060002054929061333e565b8d91506132ed565b80548210156131e65760005260206000200190600090565b8054600160401b8110156126e95761353b91600182018155613506565b819291549060031b91821b91600019901b1916179055565b908060209392818452848401376000828201840152601f01601f1916010190565b909b9a98969391999b95949561271061ffff8c1611613f5c57824211613f0b5761ffff610133541661ffff85161015613e91578a8d93366135b6908b8d612756565b805190602001209d8e958d36906135cc92612756565b8051906020012095336000526101386020526040600020928354936135f0856131c3565b90556135fd368c8e612756565b80519060200120906040519460208601967fc11af91045266b8c5df4fb4c0d475785635da25fd18ae4bb0d9b02415d5f93bd885261ffff16604087015261ffff8b16606087015233608087015260a086015260c085015260e08401528861010084015261012083015285610140830152610160908183015281528061018081011061018082016001600160401b0310176126e9576101808101604052519020906136a56141de565b6136ad614232565b936040519460208601927f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f8452604087015260608601524660808601523060a086015260a0855260c08501948086106001600160401b038711176126e957856137429560e260429361373c9661374a9a6040528151902061190160f01b855260c2820152015220923691612756565b90614117565b919091613ffd565b6033546001600160a01b03918216911681149081613e87575b5015613e425760009933600052610137602052604060002084600052602052604060002061ffff841660005260205260406000209a60018c015415613e34575b60028c549c42600182015501805461ffff8d1661ffff821603613e20575b5050613a38575b50506137d5368486612756565b60008a815260cb60205260409020546001600160a01b0316156139dc578960005260fb602052604060002081516001600160401b0381116126e9578b92613826826138208554612981565b8561327c565b602090601f831160011461390e576138fe99957ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce760207f3f19ae12b2e27269f8cfcf53b4960a5ac6ba1d714d2c729941e7b20adf54ee679f9d99949761ffff9f9c9761ffff9597806138e09b6138ee9f9a600092613903575b50508160011b916000199060031b1c19161790555b604051908152a16040519c8d9c168c521660208b015260408a015260c060608a015260c0890191613553565b918683036080880152613553565b9083820360a08501523397613553565b0390a3565b01519050388061389f565b908360005260206000209160005b601f19851681106139c15750957ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce760207f3f19ae12b2e27269f8cfcf53b4960a5ac6ba1d714d2c729941e7b20adf54ee679f9d99949761ffff9f9c9761ffff956138fe9f9b986138e09b6138ee9f9a9260019383601f198116106139a8575b505050811b0190556138b4565b015160001960f88460031b161c1916905538808061399b565b8183015184558f96506001909301926020928301920161391c565b60405162461bcd60e51b815260206004820152602e60248201527f45524337323155524953746f726167653a2055524920736574206f66206e6f6e60448201526d32bc34b9ba32b73a103a37b5b2b760911b6064820152608490fd5b3360005261012e60205260406000206001600160401b0388116126e957613a6988613a638354612981565b8361327c565b876000601f8211600114613db957600091613dae575b508860011b906000198a60031b1c19161790555b60005261012f6020526040600020336001600160601b0360a01b82541617905580600052610132602052613acb8a604060002061351e565b604051613ad7816126ce565b600081523315613d6a576107aa613b9891613b34613b118e613b17613b118260005260cb60205260018060a01b0360406000205416151590565b15613fb1565b600090815260cb60205260409020546001600160a01b0316151590565b3360005260cc6020526040600020600181540190558c60005260cb6020526040600020336001600160601b0360a01b8254161790558c3360007fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a48c33612fb9565b6101746001815401905561ffff82166000526101366020526040600020613bbf81546131c3565b905589600052610134602052604060002061ffff831661ffff198254161790556101356020528260406000205533600052610139602052613c048a604060002061351e565b80613c10575b806137c8565b600090815261012f60205260409020546001600160a01b03168015613d2057600081815261013060205260409020548015613d1557905b600080808085855af1613c58612f89565b5015613cc1576040514281527f554d9717d841320a49468eba4a7c75a535cf5b26f6063330058afcd6ed492ff460203392a27f16e0c135ad5198482dd8326eb47c9c1a3adef8cb405f743c99a0c1fd414e11606040805160018152426020820152a35b38613c0a565b60405162461bcd60e51b815260206004820152602660248201527f73657453636f72653a20636c61696d20726566657272616c207265776172642060448201526519985a5b195960d21b6064820152608490fd5b5061012d5490613c47565b5061013160205260406000208054600160401b8110156126e957613d4991600182018155613506565b81546001600160a01b0360039290921b91821b19163390911b179055613cbb565b606460405162461bcd60e51b815260206004820152602060248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152fd5b905089013538613a7f565b60008381526020812092505b8b601f198c168210613e0857505089601f19811610613dee575b5050600188811b019055613a93565b8a013560001960038b901b60f8161c191690553880613ddf565b60018394602093948493013581550193019101613dc5565b61ffff191661ffff8d1617905538806137c1565b506001610174548c556137a3565b60405162461bcd60e51b815260206004820152601b60248201527f73657453636f72653a20496e76616c6964207369676e617475726500000000006044820152606490fd5b9050151538613763565b60405162461bcd60e51b815260206004820152604660248201527f73657453636f72653a2063616c63756c6174696f6e4d6f64656c2073686f756c60448201527f64206265206c657373207468616e2063616c63756c6174696f6e206d6f64656c6064820152650818dbdd5b9d60d21b608482015260a490fd5b60405162461bcd60e51b8152602060048201526024808201527f73657453636f72653a205369676e6564207472616e73616374696f6e206578706044820152631a5c995960e21b6064820152608490fd5b60405162461bcd60e51b815260206004820152602760248201527f73657453636f72653a2053636f7265206d757374206265206c6573732074686160448201526606e2031303030360cc1b6064820152608490fd5b15613fb857565b60405162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606490fd5b6005811015614101578061400e5750565b6001810361405b5760405162461bcd60e51b815260206004820152601860248201527f45434453413a20696e76616c6964207369676e617475726500000000000000006044820152606490fd5b600281036140a85760405162461bcd60e51b815260206004820152601f60248201527f45434453413a20696e76616c6964207369676e6174757265206c656e677468006044820152606490fd5b6003146140b157565b60405162461bcd60e51b815260206004820152602260248201527f45434453413a20696e76616c6964207369676e6174757265202773272076616c604482015261756560f01b6064820152608490fd5b634e487b7160e01b600052602160045260246000fd5b90604181511460001461414557614141916020820151906060604084015193015160001a9061414f565b9091565b5050600090600290565b9291907f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a083116141d25791608094939160ff602094604051948552168484015260408301526060820152600093849182805260015afa156141c55781516001600160a01b038116156141bf579190565b50600190565b50604051903d90823e3d90fd5b50505050600090600390565b6040516141ee816119fa816129bb565b80519081156141fe576020012090565b505061014054801561420d5790565b507fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a47090565b604051614242816119fa81612a72565b8051908115614252576020012090565b505061014154801561420d5790565b600081815260cb6020526040902054614284906001600160a01b03161515612912565b600081815260209060fb82526040906119fa6142a7838320845192838092612b94565b82516142b6816119fa81612b03565b80519182156144ed5780516144bc57505050600084815260cb60205260409020546142eb906001600160a01b03161515612912565b8151916142fb83610e9981612b03565b8251156144a75784859083967a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000009081811015614498575b50506d04ee2d6d415b85acef81000000008083101561448a575b50662386f26fc100008083101561447b575b506305f5e1008083101561446c575b506127108083101561445d575b50606482101561444d575b600a80921015614443575b600190816021818a01996143b66143a18c61273b565b9b6143ae89519d8e61271a565b808d5261273b565b8b8b019890601f1901368a37508a0101905b61440d575b5050505090614401946127c89493925195836143f28895518092888089019101612565565b84019151809386840190612565565b0103808452018261271a565b600019019083906f181899199a1a9b1b9c1cb0b131b232b360811b8282061a83530491821561443e579190826143c8565b6143cd565b956001019561438b565b9590606460029104910195614380565b60049197920491019538614375565b60089197920491019538614368565b60109197920491019538614359565b869197920491019538614347565b9197509150048195388061432d565b925092505051906144b7826126ce565b815290565b9195509150846144d96127c8959451968794868087019101612565565b820161440182518093868085019101612565565b9550505050505090565b91908110156131e65760051b0190565b356001600160a01b03811681036125c3579056fea2646970667358221220bff3d256514e882d44205a2fd15cadf96e4595cc46eb2660cf6948933361d2de64736f6c63430008130033