Source Code
Overview
APE Balance
APE Value
$0.00Multichain Info
N/A
View more zero value Internal Transactions in Advanced View mode
Advanced mode:
Cross-Chain Transactions
Loading...
Loading
Contract Name:
RewardMintRegistryV2
Compiler Version
v0.8.15+commit.e14f2714
Optimization Enabled:
Yes with 100 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "@openzeppelin/contracts-upgradeable/token/ERC1155/ERC1155Upgradeable.sol";
import "@openzeppelin/contracts-upgradeable/access/OwnableUpgradeable.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@openzeppelin/contracts/utils/Base64.sol";
interface IERC721 {
function balanceOf(address owner) external view returns (uint256 balance);
}
/**
* @title RewardMintRegistryV2
* @dev RewardMintRegistryV2 is a contract for managing free NFT minting with URI metadata generation.
*/
contract RewardMintRegistryV2 is OwnableUpgradeable, ERC1155Upgradeable {
/// @dev Triggered when trying to update a non-existent rewardMint.
error RewardMintDoesNotExist();
/// @dev Triggered when providing an invalid input.
error InvalidInput();
/// @dev Triggered when minting is not enabled.
error MintingNotEnabled();
/// @dev Triggered when the user has already minted.
error TokenAlreadyMinted();
/// @dev Triggered when the user does not have a valid collection requirement.
error InvalidCollectionRequirement();
/// @dev Triggered when the user does not have enough shards.
error InsufficientShards();
/// @dev Triggered when the user has reached the maximum number of mints per user.
error MaxMintPerUserReached();
/// @dev Triggered when claiming is not enabled.
error ClaimingNotEnabled();
/// @dev Emitted when a new rewardMint is registered.
event RegisteredRewardMint(uint256 indexed id, string name, string uri);
/// @dev Emitted when the metadata is updated.
event MetadataUpdate(uint256 _tokenId);
struct RewardMint {
uint256 id;
string nftName;
string assetURI;
string artistName;
string description;
uint256 mintedSupply;
uint32 maxMintPerUser;
uint32 mintStartTime;
uint32 mintEndTime;
bool mintingPaused;
bool claimEnabled;
bool shardsEnabled;
bool collectionRequirementsEnabled;
}
struct ShardsBalance {
uint256 requiredShards;
address shardContract;
}
struct CollectionRequirement {
uint256 id;
uint256 requiredBalance;
address collectionContract;
}
// Mapping from address -> rewardMint ID -> minted.
mapping(address => mapping(uint256 => bool)) minted;
// Mapping from rewardMint ID -> RewardMint.
mapping(uint256 => RewardMint) rewardMints;
// Mapping from rewardMint ID -> ShardsBalance.
mapping(uint256 => ShardsBalance) shardsBalances;
// Mapping from rewardMint ID -> CollectionRequirement.
mapping(uint256 => mapping(uint256 => CollectionRequirement))
public collectionRequirements;
// Add a counter for collection balances per ID
mapping(uint256 => uint256) private collectionBalanceCounter;
// Total number of freemints.
uint256 public idCounter;
uint256 public totalTokensMinted;
// Contract Metadata
string public name;
string public symbol;
// Mint Override
bool public mintingEnabled;
// V2 - Updated State Variables
struct ShardRequirement {
uint256 id;
uint256 requiredShards;
address shardContract;
}
// Mapping from rewardMint ID -> ShardRequirement.
mapping(uint256 => mapping(uint256 => ShardRequirement))
public shardRequirements;
// Add a counter for shard requirements per ID
mapping(uint256 => uint256) private shardRequirementCounter;
// =============================================================
// INITIALIZATION
// =============================================================
function initialize(
string calldata _name,
string calldata _symbol
) external initializer {
__Ownable_init();
__ERC1155_init("");
name = _name;
symbol = _symbol;
}
// =============================================================
// FREEMINT LOGIC
// =============================================================
/**
* @dev A method for the owner to register a new rewardMint.
* @param nftName The name of the NFT.
* @param assetURI The URI of the NFT.
* @param artistName The name of the artist.
* @param description The description of the NFT.
* @param maxMintPerUser The maximum number of mints per user.
* @param mintStartTime The start time of the mint.
* @param mintEndTime The end time of the mint.
* @param claimEnabled Whether the mint is claimable.
* @param shardsEnabled Whether shards are enabled.
* @param collectionRequirementsEnabled Whether collection requirements are enabled.
*/
function registerRewardMint(
string memory nftName,
string memory assetURI,
string memory artistName,
string memory description,
uint32 maxMintPerUser,
uint32 mintStartTime,
uint32 mintEndTime,
bool claimEnabled,
bool shardsEnabled,
bool collectionRequirementsEnabled
) external onlyOwner {
uint256 freemintId = ++idCounter;
RewardMint storage rewardMint = rewardMints[freemintId];
rewardMint.id = freemintId;
rewardMint.nftName = nftName;
rewardMint.assetURI = assetURI;
rewardMint.artistName = artistName;
rewardMint.description = description;
rewardMint.maxMintPerUser = maxMintPerUser;
rewardMint.mintStartTime = mintStartTime;
rewardMint.mintEndTime = mintEndTime;
rewardMint.mintedSupply = 0;
rewardMint.mintingPaused = false;
rewardMint.claimEnabled = claimEnabled;
rewardMint.shardsEnabled = shardsEnabled;
rewardMint
.collectionRequirementsEnabled = collectionRequirementsEnabled;
emit RegisteredRewardMint(freemintId, nftName, assetURI);
}
/**
* @dev A method for the owner to register a new required shards balance (multiple shards).
* @param _id The ID of the rewardMint.
* @param requiredShards The number of shards required.
* @param shardContract The address of the shard contract.
*/
function registerShardRequirement(
uint256 _id,
uint256 requiredShards,
address shardContract
) external onlyOwner {
_rewardExists(_id);
uint256 shardId = shardRequirementCounter[_id]++;
shardRequirements[_id][shardId] = ShardRequirement({
id: _id,
requiredShards: requiredShards,
shardContract: shardContract
});
}
/**
* @dev A method for the owner to register a new collection balance.
* @param _id The ID of the rewardMint.
* @param requiredBalance The balance of the collection.
* @param collectionContract The address of the collection contract.
*/
function registerCollectionBalanceRequirement(
uint256 _id,
uint256 requiredBalance,
address collectionContract
) external onlyOwner {
_rewardExists(_id);
uint256 balanceId = collectionBalanceCounter[_id]++;
collectionRequirements[_id][balanceId] = CollectionRequirement({
id: _id,
requiredBalance: requiredBalance,
collectionContract: collectionContract
});
}
// =============================================================
// Metadata Management
// =============================================================
/**
* @dev Sets the asset URI for retrieving the NFT image.
* @param _id The ID of the rewardMint.
* @param assetURI The URI of the NFT.
*/
function setAssetURI(
uint256 _id,
string calldata assetURI
) external onlyOwner {
rewardMints[_id].assetURI = assetURI;
emit MetadataUpdate(_id);
}
/**
* @dev A method for the owner to update the metadata of a rewardMint.
* @param _id The ID of the rewardMint.
* @param nftName The name of the NFT.
* @param artistName The name of the artist.
* @param description The description of the NFT.
*/
function updateMetadata(
uint256 _id,
string memory nftName,
string memory artistName,
string memory description
) external onlyOwner {
rewardMints[_id].nftName = nftName;
rewardMints[_id].artistName = artistName;
rewardMints[_id].description = description;
emit MetadataUpdate(_id);
}
// =============================================================
// MINT CONTROL
// =============================================================
/**
* @dev Pauses the minting of a rewardMint.
* @param _id The ID of the rewardMint.
*/
function pauseMintById(uint256 _id) external onlyOwner {
rewardMints[_id].mintingPaused = true;
}
/**
* @dev Resumes the minting of a rewardMint.
* @param _id The ID of the rewardMint.
*/
function resumeMintById(uint256 _id) external onlyOwner {
rewardMints[_id].mintingPaused = false;
}
/**
* @dev Toggles the minting for all rewardMints.
*/
function toggleMinting() external onlyOwner {
mintingEnabled = !mintingEnabled;
}
// =============================================================
// Minting
// =============================================================
/**
* @dev A method for the user to mint a token.
* @param _id The ID of the rewardMint.
* @param quantity The quantity of tokens to mint.
* @param data The data to mint the tokens with.
*/
function mint(
address to,
uint256 _id,
uint256 quantity,
bytes memory data
) external {
RewardMint storage rewardMint = rewardMints[_id];
// 1. First check if claiming is enabled at all
if (!rewardMint.claimEnabled) {
revert ClaimingNotEnabled();
}
// 2. Check if mint window is open and not paused
_requireOpenMint(
rewardMint.mintStartTime,
rewardMint.mintEndTime,
rewardMint.mintingPaused
);
// 3. Validate input parameters
if (quantity == 0) {
revert InvalidInput();
}
// 4. Check max mint per user limit
uint256 newMintCount = balanceOf(to, _id) + quantity;
if (newMintCount > rewardMint.maxMintPerUser) {
revert MaxMintPerUserReached();
}
// 5. Check collection requirements if enabled
if (rewardMint.collectionRequirementsEnabled) {
if (!hasValidCollectionRequirement(to, _id)) {
revert InvalidCollectionRequirement();
}
}
// 6. Check shard requirements if enabled
if (rewardMint.shardsEnabled) {
if (!hasValidShardRequirement(to, _id)) {
revert InsufficientShards();
}
}
// 7. Update state
++totalTokensMinted;
++rewardMint.mintedSupply;
// 8. Mint tokens
_mint(to, rewardMint.id, quantity, data);
}
/**
* @dev A method for the owner to batch mint tokens.
* @param _id The ID of the rewardMint.
* @param recipients The addresses to mint the tokens to.
*/
function batchAdminMint(
uint256 _id,
address[] calldata recipients,
uint256[] calldata quantities
) external onlyOwner {
if (recipients.length != quantities.length) {
revert InvalidInput();
}
RewardMint storage rewardMint = rewardMints[_id];
uint256 batchTotalMinted = 0;
for (uint256 i = 0; i < recipients.length; i++) {
address to = recipients[i];
uint256 quantity = quantities[i];
_mint(to, rewardMint.id, quantity, "");
if (!minted[to][_id]) {
minted[to][_id] = true;
}
batchTotalMinted += quantity;
}
totalTokensMinted += batchTotalMinted;
rewardMint.mintedSupply += batchTotalMinted;
}
// =============================================================
// SETTER FUNCTIONS
// =============================================================
/**
* @dev A method for the owner to toggle claiming for a rewardMint.
* @param _id The ID of the rewardMint.
* @param claimEnabled Whether claiming is enabled.
*/
function toggleClaiming(uint256 _id, bool claimEnabled) external onlyOwner {
rewardMints[_id].claimEnabled = claimEnabled;
}
/**
* @dev A method for the owner to toggle shards for a rewardMint.
* @param _id The ID of the rewardMint.
* @param shardsEnabled Whether shards are enabled.
*/
function toggleShardRequirement(
uint256 _id,
bool shardsEnabled
) external onlyOwner {
rewardMints[_id].shardsEnabled = shardsEnabled;
}
/**
* @dev A method for the owner to toggle collection requirements for a rewardMint.
* @param _id The ID of the rewardMint.
* @param collectionRequirementsEnabled Whether collection requirements are enabled.
*/
function toggleCollectionRequirements(
uint256 _id,
bool collectionRequirementsEnabled
) external onlyOwner {
rewardMints[_id]
.collectionRequirementsEnabled = collectionRequirementsEnabled;
}
/**
* @dev A method for the owner to set the maximum number of mints per user for a rewardMint.
* @param _id The ID of the rewardMint.
* @param maxMintPerUser The maximum number of mints per user.
*/
function setMaxMintPerUser(
uint256 _id,
uint32 maxMintPerUser
) external onlyOwner {
rewardMints[_id].maxMintPerUser = maxMintPerUser;
}
function updateMintDuration(
uint256 _id,
uint32 mintStartTime,
uint32 mintEndTime
) external onlyOwner {
rewardMints[_id].mintStartTime = mintStartTime;
rewardMints[_id].mintEndTime = mintEndTime;
}
function updateCollectionRequirement(
uint256 _id,
uint256 index,
uint256 requiredBalance,
address collectionContract
) external onlyOwner {
_rewardExists(_id);
collectionRequirements[_id][index].requiredBalance = requiredBalance;
collectionRequirements[_id][index]
.collectionContract = collectionContract;
}
function updateShardRequirement(
uint256 _id,
uint256 index,
uint256 requiredShards,
address shardContract
) external onlyOwner {
_rewardExists(_id);
shardRequirements[_id][index].requiredShards = requiredShards;
shardRequirements[_id][index].shardContract = shardContract;
}
// =============================================================
// VIEW FUNCTIONS
// =============================================================
/**
* @dev Returns the total quantity for a token ID
* @param _id uint256 ID of the token to query
* @return amount of token in existence
*/
function hasMinted(address user, uint256 _id) external view returns (bool) {
return balanceOf(user, _id) > 0;
}
/**
* @dev Returns the total quantity for a token ID
* @param _id uint256 ID of the token to query
* @return amount of token in existence
*/
function totalSupply(uint256 _id) public view returns (uint256) {
return rewardMints[_id].mintedSupply;
}
function isPaused(uint256 _id) public view returns (bool) {
return rewardMints[_id].mintingPaused;
}
/**
* @dev A method for the owner to get the details of a rewardMint.
* @param _id The ID of the rewardMint.
*/
function getFreemintDetails(
uint256 _id
) external view returns (RewardMint memory) {
return rewardMints[_id];
}
/**
* @dev A method for the owner to get the details of a shard requirement (multiple shards).
* @param _id The ID of the rewardMint.
* @param index The index of the shard requirement.
*/
function getShardRequirementByIndex(
uint256 _id,
uint256 index
) external view returns (ShardRequirement memory) {
return shardRequirements[_id][index];
}
/**
* @dev A method for the owner to get the details of a collection requirement.
* @param _id The ID of the rewardMint.
*/
function getCollectionRequirement(
uint256 _id,
uint256 index
) external view returns (CollectionRequirement memory) {
return collectionRequirements[_id][index];
}
/**
* @dev A method for the owner to get the number of collection requirements for an ID.
* @param _id The ID of the rewardMint.
*/
function getCollectionRequirementCount(
uint256 _id
) external view returns (uint256) {
return collectionBalanceCounter[_id];
}
/**
* @dev A method for the owner to get the number of shard requirements for an ID.
* @param _id The ID of the rewardMint.
*/
function getShardRequirementCount(
uint256 _id
) external view returns (uint256) {
return shardRequirementCounter[_id];
}
/**
* @dev Returns all reward mints.
*/
function getAllRewardMints() external view returns (RewardMint[] memory) {
RewardMint[] memory allRewardMints = new RewardMint[](idCounter);
for (uint256 i = 1; i <= idCounter; i++) {
allRewardMints[i - 1] = rewardMints[i];
}
return allRewardMints;
}
function getAllCollectionRequirements(
uint256 _id
) external view returns (CollectionRequirement[] memory) {
uint256 count = collectionBalanceCounter[_id];
CollectionRequirement[]
memory allCollectionRequirements = new CollectionRequirement[](
count
);
for (uint256 i = 0; i < count; i++) {
allCollectionRequirements[i] = collectionRequirements[_id][i];
}
return allCollectionRequirements;
}
function getAllShardRequirements(
uint256 _id
) external view returns (ShardRequirement[] memory) {
uint256 count = shardRequirementCounter[_id];
ShardRequirement[] memory allShardRequirements = new ShardRequirement[](
count
);
for (uint256 i = 0; i < count; i++) {
allShardRequirements[i] = shardRequirements[_id][i];
}
return allShardRequirements;
}
// =============================================================
// Internal
// =============================================================
/**
* @dev Reverts with `MintingNotEnabled` if minting is not currently possible.
*/
function _requireOpenMint(
uint32 mintStartTime,
uint32 mintEndTime,
bool mintingPaused
) internal view {
bool isActive = mintStartTime <= uint32(block.timestamp) &&
mintEndTime >= uint32(block.timestamp);
// Check if minting override is enabled
if (!mintingEnabled) {
revert MintingNotEnabled();
}
if (!isActive || mintingPaused) {
revert MintingNotEnabled();
}
}
/**
* @dev A method for the owner to check if a rewardMint exists.
* @param _id The ID of the rewardMint.
*/
function _rewardExists(uint256 _id) internal view returns (bool) {
if (rewardMints[_id].id == 0) {
revert RewardMintDoesNotExist();
}
return true;
}
// =============================================================
// Collection Requirements
// =============================================================
/**
* @dev A method for the owner to check if any collection balance requirements are met (OR Logic).
* @param user The address of the user.
* @param _id The ID of the rewardMint.
*/
function hasValidCollectionRequirement(
address user,
uint256 _id
) public view returns (bool) {
uint256 count = collectionBalanceCounter[_id];
for (uint256 i = 0; i < count; i++) {
CollectionRequirement storage requirement = collectionRequirements[
_id
][i];
if (requirement.requiredBalance > 0) {
if (
IERC721(requirement.collectionContract).balanceOf(user) >=
requirement.requiredBalance
) {
return true;
}
}
}
return false;
}
// =============================================================
// Shard Requirements
// =============================================================
/**
* @dev A method for the owner to check if shard requirements are met (AND Logic).
* @param user The address of the user.
* @param _id The ID of the rewardMint.
*/
function hasValidShardRequirement(
address user,
uint256 _id
) public view returns (bool) {
if (!rewardMints[_id].shardsEnabled) {
return true;
}
uint256 count = shardRequirementCounter[_id];
for (uint256 i = 0; i < count; i++) {
ShardRequirement storage requirement = shardRequirements[_id][i];
if (requirement.requiredShards > 0) {
if (
IERC721(requirement.shardContract).balanceOf(user) <
requirement.requiredShards
) {
return false;
}
}
}
return true;
}
// =============================================================
// ERC1155 OVERRIDES
// =============================================================
/**
* @dev A method to get the URI of a raffle.
* @param id The ID of the raffle.
*/
function uri(
uint256 id
) public view virtual override returns (string memory) {
RewardMint memory rewardMint = rewardMints[id];
string memory metadata = string(
abi.encodePacked(
"data:application/json;base64,",
Base64.encode(
abi.encodePacked(
'{ "name": "',
rewardMint.nftName,
'", "id": "',
Strings.toString(id),
'", "image": "',
rewardMint.assetURI,
'", "properties": { "artistName": "',
rewardMint.artistName,
'"}, "description": "',
rewardMint.description,
'"}'
)
)
)
);
return metadata;
}
}// 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;
}// 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;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC1155/ERC1155.sol)
pragma solidity ^0.8.0;
import "./IERC1155Upgradeable.sol";
import "./IERC1155ReceiverUpgradeable.sol";
import "./extensions/IERC1155MetadataURIUpgradeable.sol";
import "../../utils/AddressUpgradeable.sol";
import "../../utils/ContextUpgradeable.sol";
import "../../utils/introspection/ERC165Upgradeable.sol";
import {Initializable} from "../../proxy/utils/Initializable.sol";
/**
* @dev Implementation of the basic standard multi-token.
* See https://eips.ethereum.org/EIPS/eip-1155
* Originally based on code by Enjin: https://github.com/enjin/erc-1155
*
* _Available since v3.1._
*/
contract ERC1155Upgradeable is Initializable, ContextUpgradeable, ERC165Upgradeable, IERC1155Upgradeable, IERC1155MetadataURIUpgradeable {
using AddressUpgradeable for address;
// Mapping from token ID to account balances
mapping(uint256 => mapping(address => uint256)) private _balances;
// Mapping from account to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
// Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json
string private _uri;
/**
* @dev See {_setURI}.
*/
function __ERC1155_init(string memory uri_) internal onlyInitializing {
__ERC1155_init_unchained(uri_);
}
function __ERC1155_init_unchained(string memory uri_) internal onlyInitializing {
_setURI(uri_);
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165Upgradeable, IERC165Upgradeable) returns (bool) {
return
interfaceId == type(IERC1155Upgradeable).interfaceId ||
interfaceId == type(IERC1155MetadataURIUpgradeable).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC1155MetadataURI-uri}.
*
* This implementation returns the same URI for *all* token types. It relies
* on the token type ID substitution mechanism
* https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
*
* Clients calling this function must replace the `\{id\}` substring with the
* actual token type ID.
*/
function uri(uint256) public view virtual override returns (string memory) {
return _uri;
}
/**
* @dev See {IERC1155-balanceOf}.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) public view virtual override returns (uint256) {
require(account != address(0), "ERC1155: address zero is not a valid owner");
return _balances[id][account];
}
/**
* @dev See {IERC1155-balanceOfBatch}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] memory accounts,
uint256[] memory ids
) public view virtual override returns (uint256[] memory) {
require(accounts.length == ids.length, "ERC1155: accounts and ids length mismatch");
uint256[] memory batchBalances = new uint256[](accounts.length);
for (uint256 i = 0; i < accounts.length; ++i) {
batchBalances[i] = balanceOf(accounts[i], ids[i]);
}
return batchBalances;
}
/**
* @dev See {IERC1155-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC1155-isApprovedForAll}.
*/
function isApprovedForAll(address account, address operator) public view virtual override returns (bool) {
return _operatorApprovals[account][operator];
}
/**
* @dev See {IERC1155-safeTransferFrom}.
*/
function safeTransferFrom(
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) public virtual override {
require(
from == _msgSender() || isApprovedForAll(from, _msgSender()),
"ERC1155: caller is not token owner or approved"
);
_safeTransferFrom(from, to, id, amount, data);
}
/**
* @dev See {IERC1155-safeBatchTransferFrom}.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) public virtual override {
require(
from == _msgSender() || isApprovedForAll(from, _msgSender()),
"ERC1155: caller is not token owner or approved"
);
_safeBatchTransferFrom(from, to, ids, amounts, data);
}
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function _safeTransferFrom(
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) internal virtual {
require(to != address(0), "ERC1155: transfer to the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, from, to, ids, amounts, data);
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
unchecked {
_balances[id][from] = fromBalance - amount;
}
_balances[id][to] += amount;
emit TransferSingle(operator, from, to, id, amount);
_afterTokenTransfer(operator, from, to, ids, amounts, data);
_doSafeTransferAcceptanceCheck(operator, from, to, id, amount, data);
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function _safeBatchTransferFrom(
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
require(to != address(0), "ERC1155: transfer to the zero address");
address operator = _msgSender();
_beforeTokenTransfer(operator, from, to, ids, amounts, data);
for (uint256 i = 0; i < ids.length; ++i) {
uint256 id = ids[i];
uint256 amount = amounts[i];
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: insufficient balance for transfer");
unchecked {
_balances[id][from] = fromBalance - amount;
}
_balances[id][to] += amount;
}
emit TransferBatch(operator, from, to, ids, amounts);
_afterTokenTransfer(operator, from, to, ids, amounts, data);
_doSafeBatchTransferAcceptanceCheck(operator, from, to, ids, amounts, data);
}
/**
* @dev Sets a new URI for all token types, by relying on the token type ID
* substitution mechanism
* https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the EIP].
*
* By this mechanism, any occurrence of the `\{id\}` substring in either the
* URI or any of the amounts in the JSON file at said URI will be replaced by
* clients with the token type ID.
*
* For example, the `https://token-cdn-domain/\{id\}.json` URI would be
* interpreted by clients as
* `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json`
* for token type ID 0x4cce0.
*
* See {uri}.
*
* Because these URIs cannot be meaningfully represented by the {URI} event,
* this function emits no events.
*/
function _setURI(string memory newuri) internal virtual {
_uri = newuri;
}
/**
* @dev Creates `amount` tokens of token type `id`, and assigns them to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function _mint(address to, uint256 id, uint256 amount, bytes memory data) internal virtual {
require(to != address(0), "ERC1155: mint to the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
_balances[id][to] += amount;
emit TransferSingle(operator, address(0), to, id, amount);
_afterTokenTransfer(operator, address(0), to, ids, amounts, data);
_doSafeTransferAcceptanceCheck(operator, address(0), to, id, amount, data);
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function _mintBatch(
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {
require(to != address(0), "ERC1155: mint to the zero address");
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
address operator = _msgSender();
_beforeTokenTransfer(operator, address(0), to, ids, amounts, data);
for (uint256 i = 0; i < ids.length; i++) {
_balances[ids[i]][to] += amounts[i];
}
emit TransferBatch(operator, address(0), to, ids, amounts);
_afterTokenTransfer(operator, address(0), to, ids, amounts, data);
_doSafeBatchTransferAcceptanceCheck(operator, address(0), to, ids, amounts, data);
}
/**
* @dev Destroys `amount` tokens of token type `id` from `from`
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `from` must have at least `amount` tokens of token type `id`.
*/
function _burn(address from, uint256 id, uint256 amount) internal virtual {
require(from != address(0), "ERC1155: burn from the zero address");
address operator = _msgSender();
uint256[] memory ids = _asSingletonArray(id);
uint256[] memory amounts = _asSingletonArray(amount);
_beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
unchecked {
_balances[id][from] = fromBalance - amount;
}
emit TransferSingle(operator, from, address(0), id, amount);
_afterTokenTransfer(operator, from, address(0), ids, amounts, "");
}
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
*/
function _burnBatch(address from, uint256[] memory ids, uint256[] memory amounts) internal virtual {
require(from != address(0), "ERC1155: burn from the zero address");
require(ids.length == amounts.length, "ERC1155: ids and amounts length mismatch");
address operator = _msgSender();
_beforeTokenTransfer(operator, from, address(0), ids, amounts, "");
for (uint256 i = 0; i < ids.length; i++) {
uint256 id = ids[i];
uint256 amount = amounts[i];
uint256 fromBalance = _balances[id][from];
require(fromBalance >= amount, "ERC1155: burn amount exceeds balance");
unchecked {
_balances[id][from] = fromBalance - amount;
}
}
emit TransferBatch(operator, from, address(0), ids, amounts);
_afterTokenTransfer(operator, from, address(0), ids, amounts, "");
}
/**
* @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, "ERC1155: setting approval status for self");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Hook that is called before any token transfer. This includes minting
* and burning, as well as batched variants.
*
* The same hook is called on both single and batched variants. For single
* transfers, the length of the `ids` and `amounts` arrays will be 1.
*
* Calling conditions (for each `id` and `amount` pair):
*
* - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* of token type `id` will be transferred to `to`.
* - When `from` is zero, `amount` tokens of token type `id` will be minted
* for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
* will be burned.
* - `from` and `to` are never both zero.
* - `ids` and `amounts` have the same, non-zero length.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting
* and burning, as well as batched variants.
*
* The same hook is called on both single and batched variants. For single
* transfers, the length of the `id` and `amount` arrays will be 1.
*
* Calling conditions (for each `id` and `amount` pair):
*
* - When `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* of token type `id` will be transferred to `to`.
* - When `from` is zero, `amount` tokens of token type `id` will be minted
* for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens of token type `id`
* will be burned.
* - `from` and `to` are never both zero.
* - `ids` and `amounts` have the same, non-zero length.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) internal virtual {}
function _doSafeTransferAcceptanceCheck(
address operator,
address from,
address to,
uint256 id,
uint256 amount,
bytes memory data
) private {
if (to.isContract()) {
try IERC1155ReceiverUpgradeable(to).onERC1155Received(operator, from, id, amount, data) returns (bytes4 response) {
if (response != IERC1155ReceiverUpgradeable.onERC1155Received.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non-ERC1155Receiver implementer");
}
}
}
function _doSafeBatchTransferAcceptanceCheck(
address operator,
address from,
address to,
uint256[] memory ids,
uint256[] memory amounts,
bytes memory data
) private {
if (to.isContract()) {
try IERC1155ReceiverUpgradeable(to).onERC1155BatchReceived(operator, from, ids, amounts, data) returns (
bytes4 response
) {
if (response != IERC1155ReceiverUpgradeable.onERC1155BatchReceived.selector) {
revert("ERC1155: ERC1155Receiver rejected tokens");
}
} catch Error(string memory reason) {
revert(reason);
} catch {
revert("ERC1155: transfer to non-ERC1155Receiver implementer");
}
}
}
function _asSingletonArray(uint256 element) private pure returns (uint256[] memory) {
uint256[] memory array = new uint256[](1);
array[0] = element;
return array;
}
/**
* @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[47] private __gap;
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC1155/extensions/IERC1155MetadataURI.sol)
pragma solidity ^0.8.0;
import "../IERC1155Upgradeable.sol";
/**
* @dev Interface of the optional ERC1155MetadataExtension interface, as defined
* in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[EIP].
*
* _Available since v3.1._
*/
interface IERC1155MetadataURIUpgradeable is IERC1155Upgradeable {
/**
* @dev Returns the URI for token type `id`.
*
* If the `\{id\}` substring is present in the URI, it must be replaced by
* clients with the actual token type ID.
*/
function uri(uint256 id) external view returns (string memory);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC1155/IERC1155Receiver.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165Upgradeable.sol";
/**
* @dev _Available since v3.1._
*/
interface IERC1155ReceiverUpgradeable is IERC165Upgradeable {
/**
* @dev Handles the receipt of a single ERC1155 token type. This function is
* called at the end of a `safeTransferFrom` after the balance has been updated.
*
* NOTE: To accept the transfer, this must return
* `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))`
* (i.e. 0xf23a6e61, or its own function selector).
*
* @param operator The address which initiated the transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param id The ID of the token being transferred
* @param value The amount of tokens being transferred
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed
*/
function onERC1155Received(
address operator,
address from,
uint256 id,
uint256 value,
bytes calldata data
) external returns (bytes4);
/**
* @dev Handles the receipt of a multiple ERC1155 token types. This function
* is called at the end of a `safeBatchTransferFrom` after the balances have
* been updated.
*
* NOTE: To accept the transfer(s), this must return
* `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))`
* (i.e. 0xbc197c81, or its own function selector).
*
* @param operator The address which initiated the batch transfer (i.e. msg.sender)
* @param from The address which previously owned the token
* @param ids An array containing ids of each token being transferred (order and length must match values array)
* @param values An array containing amounts of each token being transferred (order and length must match ids array)
* @param data Additional data with no specified format
* @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed
*/
function onERC1155BatchReceived(
address operator,
address from,
uint256[] calldata ids,
uint256[] calldata values,
bytes calldata data
) external returns (bytes4);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC1155/IERC1155.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165Upgradeable.sol";
/**
* @dev Required interface of an ERC1155 compliant contract, as defined in the
* https://eips.ethereum.org/EIPS/eip-1155[EIP].
*
* _Available since v3.1._
*/
interface IERC1155Upgradeable is IERC165Upgradeable {
/**
* @dev Emitted when `value` tokens of token type `id` are transferred from `from` to `to` by `operator`.
*/
event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value);
/**
* @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all
* transfers.
*/
event TransferBatch(
address indexed operator,
address indexed from,
address indexed to,
uint256[] ids,
uint256[] values
);
/**
* @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to
* `approved`.
*/
event ApprovalForAll(address indexed account, address indexed operator, bool approved);
/**
* @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI.
*
* If an {URI} event was emitted for `id`, the standard
* https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value
* returned by {IERC1155MetadataURI-uri}.
*/
event URI(string value, uint256 indexed id);
/**
* @dev Returns the amount of tokens of token type `id` owned by `account`.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function balanceOf(address account, uint256 id) external view returns (uint256);
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}.
*
* Requirements:
*
* - `accounts` and `ids` must have the same length.
*/
function balanceOfBatch(
address[] calldata accounts,
uint256[] calldata ids
) external view returns (uint256[] memory);
/**
* @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`,
*
* Emits an {ApprovalForAll} event.
*
* Requirements:
*
* - `operator` cannot be the caller.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns true if `operator` is approved to transfer ``account``'s tokens.
*
* See {setApprovalForAll}.
*/
function isApprovedForAll(address account, address operator) external view returns (bool);
/**
* @dev Transfers `amount` tokens of token type `id` from `from` to `to`.
*
* Emits a {TransferSingle} event.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}.
* - `from` must have a balance of tokens of type `id` of at least `amount`.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the
* acceptance magic value.
*/
function safeTransferFrom(address from, address to, uint256 id, uint256 amount, bytes calldata data) external;
/**
* @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}.
*
* Emits a {TransferBatch} event.
*
* Requirements:
*
* - `ids` and `amounts` must have the same length.
* - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the
* acceptance magic value.
*/
function safeBatchTransferFrom(
address from,
address to,
uint256[] calldata ids,
uint256[] calldata amounts,
bytes calldata data
) external;
}// 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);
}
}
}// 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;
}// 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;
}// 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);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (utils/Base64.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides a set of functions to operate with Base64 strings.
*
* _Available since v4.5._
*/
library Base64 {
/**
* @dev Base64 Encoding/Decoding Table
*/
string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
/**
* @dev Converts a `bytes` to its Bytes64 `string` representation.
*/
function encode(bytes memory data) internal pure returns (string memory) {
/**
* Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
* https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
*/
if (data.length == 0) return "";
// Loads the table into memory
string memory table = _TABLE;
// Encoding takes 3 bytes chunks of binary data from `bytes` data parameter
// and split into 4 numbers of 6 bits.
// The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up
// - `data.length + 2` -> Round up
// - `/ 3` -> Number of 3-bytes chunks
// - `4 *` -> 4 characters for each chunk
string memory result = new string(4 * ((data.length + 2) / 3));
/// @solidity memory-safe-assembly
assembly {
// Prepare the lookup table (skip the first "length" byte)
let tablePtr := add(table, 1)
// Prepare result pointer, jump over length
let resultPtr := add(result, 32)
// Run over the input, 3 bytes at a time
for {
let dataPtr := data
let endPtr := add(data, mload(data))
} lt(dataPtr, endPtr) {
} {
// Advance 3 bytes
dataPtr := add(dataPtr, 3)
let input := mload(dataPtr)
// To write each character, shift the 3 bytes (18 bits) chunk
// 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
// and apply logical AND with 0x3F which is the number of
// the previous character in the ASCII table prior to the Base64 Table
// The result is then added to the table to get the character to write,
// and finally write it in the result pointer but with a left shift
// of 256 (1 byte) - 8 (1 ASCII char) = 248 bits
mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
}
// When data `bytes` is not exactly 3 bytes long
// it is padded with `=` characters at the end
switch mod(mload(data), 3)
case 1 {
mstore8(sub(resultPtr, 1), 0x3d)
mstore8(sub(resultPtr, 2), 0x3d)
}
case 2 {
mstore8(sub(resultPtr, 1), 0x3d)
}
}
return result;
}
}// 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 Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// 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);
}
}
}// 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 SignedMath {
/**
* @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);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
import "./math/SignedMath.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.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, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
/**
* @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));
}
}{
"optimizer": {
"enabled": true,
"runs": 100
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
},
"libraries": {}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[],"name":"ClaimingNotEnabled","type":"error"},{"inputs":[],"name":"InsufficientShards","type":"error"},{"inputs":[],"name":"InvalidCollectionRequirement","type":"error"},{"inputs":[],"name":"InvalidInput","type":"error"},{"inputs":[],"name":"MaxMintPerUserReached","type":"error"},{"inputs":[],"name":"MintingNotEnabled","type":"error"},{"inputs":[],"name":"RewardMintDoesNotExist","type":"error"},{"inputs":[],"name":"TokenAlreadyMinted","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint8","name":"version","type":"uint8"}],"name":"Initialized","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"MetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"string","name":"name","type":"string"},{"indexed":false,"internalType":"string","name":"uri","type":"string"}],"name":"RegisteredRewardMint","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"address[]","name":"recipients","type":"address[]"},{"internalType":"uint256[]","name":"quantities","type":"uint256[]"}],"name":"batchAdminMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"collectionRequirements","outputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredBalance","type":"uint256"},{"internalType":"address","name":"collectionContract","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"getAllCollectionRequirements","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredBalance","type":"uint256"},{"internalType":"address","name":"collectionContract","type":"address"}],"internalType":"struct RewardMintRegistryV2.CollectionRequirement[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getAllRewardMints","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"string","name":"nftName","type":"string"},{"internalType":"string","name":"assetURI","type":"string"},{"internalType":"string","name":"artistName","type":"string"},{"internalType":"string","name":"description","type":"string"},{"internalType":"uint256","name":"mintedSupply","type":"uint256"},{"internalType":"uint32","name":"maxMintPerUser","type":"uint32"},{"internalType":"uint32","name":"mintStartTime","type":"uint32"},{"internalType":"uint32","name":"mintEndTime","type":"uint32"},{"internalType":"bool","name":"mintingPaused","type":"bool"},{"internalType":"bool","name":"claimEnabled","type":"bool"},{"internalType":"bool","name":"shardsEnabled","type":"bool"},{"internalType":"bool","name":"collectionRequirementsEnabled","type":"bool"}],"internalType":"struct RewardMintRegistryV2.RewardMint[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"getAllShardRequirements","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredShards","type":"uint256"},{"internalType":"address","name":"shardContract","type":"address"}],"internalType":"struct RewardMintRegistryV2.ShardRequirement[]","name":"","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getCollectionRequirement","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredBalance","type":"uint256"},{"internalType":"address","name":"collectionContract","type":"address"}],"internalType":"struct RewardMintRegistryV2.CollectionRequirement","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"getCollectionRequirementCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"getFreemintDetails","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"string","name":"nftName","type":"string"},{"internalType":"string","name":"assetURI","type":"string"},{"internalType":"string","name":"artistName","type":"string"},{"internalType":"string","name":"description","type":"string"},{"internalType":"uint256","name":"mintedSupply","type":"uint256"},{"internalType":"uint32","name":"maxMintPerUser","type":"uint32"},{"internalType":"uint32","name":"mintStartTime","type":"uint32"},{"internalType":"uint32","name":"mintEndTime","type":"uint32"},{"internalType":"bool","name":"mintingPaused","type":"bool"},{"internalType":"bool","name":"claimEnabled","type":"bool"},{"internalType":"bool","name":"shardsEnabled","type":"bool"},{"internalType":"bool","name":"collectionRequirementsEnabled","type":"bool"}],"internalType":"struct RewardMintRegistryV2.RewardMint","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getShardRequirementByIndex","outputs":[{"components":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredShards","type":"uint256"},{"internalType":"address","name":"shardContract","type":"address"}],"internalType":"struct RewardMintRegistryV2.ShardRequirement","name":"","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"getShardRequirementCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"hasMinted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"hasValidCollectionRequirement","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"hasValidShardRequirement","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"idCounter","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"_name","type":"string"},{"internalType":"string","name":"_symbol","type":"string"}],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"isPaused","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"quantity","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"mintingEnabled","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"pauseMintById","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"requiredBalance","type":"uint256"},{"internalType":"address","name":"collectionContract","type":"address"}],"name":"registerCollectionBalanceRequirement","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"nftName","type":"string"},{"internalType":"string","name":"assetURI","type":"string"},{"internalType":"string","name":"artistName","type":"string"},{"internalType":"string","name":"description","type":"string"},{"internalType":"uint32","name":"maxMintPerUser","type":"uint32"},{"internalType":"uint32","name":"mintStartTime","type":"uint32"},{"internalType":"uint32","name":"mintEndTime","type":"uint32"},{"internalType":"bool","name":"claimEnabled","type":"bool"},{"internalType":"bool","name":"shardsEnabled","type":"bool"},{"internalType":"bool","name":"collectionRequirementsEnabled","type":"bool"}],"name":"registerRewardMint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"requiredShards","type":"uint256"},{"internalType":"address","name":"shardContract","type":"address"}],"name":"registerShardRequirement","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"resumeMintById","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"string","name":"assetURI","type":"string"}],"name":"setAssetURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint32","name":"maxMintPerUser","type":"uint32"}],"name":"setMaxMintPerUser","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"","type":"uint256"}],"name":"shardRequirements","outputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"requiredShards","type":"uint256"},{"internalType":"address","name":"shardContract","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"bool","name":"claimEnabled","type":"bool"}],"name":"toggleClaiming","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"bool","name":"collectionRequirementsEnabled","type":"bool"}],"name":"toggleCollectionRequirements","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"toggleMinting","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"bool","name":"shardsEnabled","type":"bool"}],"name":"toggleShardRequirement","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"}],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalTokensMinted","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"requiredBalance","type":"uint256"},{"internalType":"address","name":"collectionContract","type":"address"}],"name":"updateCollectionRequirement","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"string","name":"nftName","type":"string"},{"internalType":"string","name":"artistName","type":"string"},{"internalType":"string","name":"description","type":"string"}],"name":"updateMetadata","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint32","name":"mintStartTime","type":"uint32"},{"internalType":"uint32","name":"mintEndTime","type":"uint32"}],"name":"updateMintDuration","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_id","type":"uint256"},{"internalType":"uint256","name":"index","type":"uint256"},{"internalType":"uint256","name":"requiredShards","type":"uint256"},{"internalType":"address","name":"shardContract","type":"address"}],"name":"updateShardRequirement","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}]Contract Creation Code
608060405234801561001057600080fd5b506144c1806100206000396000f3fe608060405234801561001057600080fd5b50600436106102a95760003560e01c80637d55094d11610172578063bdf2a43c116100d9578063e985e9c511610092578063e985e9c5146106c6578063eb08ab2814610702578063f242432a1461070b578063f2fde38b1461071e578063f3a2deea14610731578063f4103e4d14610751578063f8f1147d1461076457600080fd5b8063bdf2a43c1461060a578063c401aa9914610637578063ce757efd1461064a578063d55b53e61461065d578063dc4f3b8014610670578063dc73dece1461068357600080fd5b8063a0cef62c1161012b578063a0cef62c1461057b578063a22cb4651461058e578063a2cb6af5146105a1578063a6c696f6146105c1578063a782b124146105d4578063bd85b039146105e757600080fd5b80637d55094d146105125780638549feba1461051a5780638da5cb5b1461052d57806395d89b41146105465780639d6ff5581461054e5780639fd6db121461056e57600080fd5b806333189c421161021657806362c5a671116101cf57806362c5a671146104a8578063715018a6146104c8578063731133e9146104d05780637666d075146104e357806377726263146104f65780637d549e991461050957600080fd5b806333189c42146103c8578063457af70c146103db5780634cd88b76146103fb5780634e1273f41461040e57806358ca190e1461042e5780635ecaef431461044157600080fd5b80630e89341c116102685780630e89341c1461034957806311b46a991461035c5780631b300fb51461037c578063258ff2de1461038f5780632bcd3539146103a25780632eb2c2d6146103b557600080fd5b806255a613146102ae578062fdd58e146102c357806301247ab6146102e957806301ffc9a7146102fc57806306fdde031461031f5780630d23677214610334575b600080fd5b6102c16102bc366004613121565b610777565b005b6102d66102d13660046131b6565b6108d6565b6040519081526020015b60405180910390f35b6102c16102f73660046131e0565b610971565b61030f61030a366004613235565b6109ca565b60405190151581526020016102e0565b610327610a1a565b6040516102e091906132b1565b61033c610aa8565b6040516102e091906133bc565b61032761035736600461341e565b610e3a565b61036f61036a36600461341e565b61119a565b6040516102e09190613437565b6102c161038a36600461341e565b611494565b6102c161039d36600461341e565b6114ba565b6102c16103b03660046131e0565b6114e6565b6102c16103c3366004613593565b61153f565b6102c16103d636600461367d565b61158b565b6103ee6103e93660046136c8565b6115e8565b6040516102e0919061370c565b6102c161040936600461371a565b611638565b61042161041c366004613785565b611780565b6040516102e0919061388a565b6102c161043c36600461389d565b6118a9565b61048461044f3660046136c8565b60d36020908152600092835260408084209091529082529020805460018201546002909201549091906001600160a01b031683565b6040805193845260208401929092526001600160a01b0316908201526060016102e0565b6102d66104b636600461341e565b600090815260cd602052604090205490565b6102c161193f565b6102c16104de3660046138d2565b611953565b6102c16104f1366004613946565b611adc565b6102c1610504366004613989565b611b35565b6102d660cf5481565b6102c1611b6b565b6102c16105283660046139b5565b611b87565b6033546001600160a01b03166040516102e09190613ac7565b610327611d21565b6102d661055c36600461341e565b600090815260d4602052604090205490565b60d25461030f9060ff1681565b6102c1610589366004613989565b611d2e565b6102c161059c366004613adb565b611d64565b6105b46105af36600461341e565b611d73565b6040516102e09190613b05565b6103ee6105cf3660046136c8565b611e5c565b6102c16105e2366004613b53565b611eac565b6102d66105f536600461341e565b600090815260ca602052604090206005015490565b61030f61061836600461341e565b600090815260ca6020526040902060060154600160601b900460ff1690565b6102c1610645366004613b76565b611edf565b6102c1610658366004613989565b611f74565b61030f61066b3660046131b6565b611faa565b6102c161067e36600461389d565b6120b6565b6104846106913660046136c8565b60cc6020908152600092835260408084209091529082529020805460018201546002909201549091906001600160a01b031683565b61030f6106d4366004613bfb565b6001600160a01b03918216600090815260986020908152604080832093909416825291909152205460ff1690565b6102d660ce5481565b6102c1610719366004613c25565b61214c565b6102c161072c366004613c89565b612191565b61074461073f36600461341e565b61220a565b6040516102e09190613ca4565b61030f61075f3660046131b6565b6122f3565b61030f6107723660046131b6565b6123d6565b61077f6123eb565b82811461079f5760405163b4fa3fb360e01b815260040160405180910390fd5b600085815260ca6020526040812090805b8581101561089a5760008787838181106107cc576107cc613ce6565b90506020020160208101906107e19190613c89565b905060008686848181106107f7576107f7613ce6565b90506020020135905061081f8286600001548360405180602001604052806000815250612445565b6001600160a01b038216600090815260c9602090815260408083208d845290915290205460ff16610879576001600160a01b038216600090815260c9602090815260408083208d84529091529020805460ff191660011790555b6108838185613d12565b93505050808061089290613d2a565b9150506107b0565b508060cf60008282546108ad9190613d12565b92505081905550808260050160008282546108c89190613d12565b909155505050505050505050565b60006001600160a01b0383166109465760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b5060008181526097602090815260408083206001600160a01b03861684529091529020545b92915050565b6109796123eb565b6109828461255b565b50600093845260cc60209081526040808620948652939052919092206001810192909255600290910180546001600160a01b0319166001600160a01b03909216919091179055565b60006001600160e01b03198216636cdb3d1360e11b14806109fb57506001600160e01b031982166303a24d0760e21b145b8061096b57506301ffc9a760e01b6001600160e01b031983161461096b565b60d08054610a2790613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610a5390613d43565b8015610aa05780601f10610a7557610100808354040283529160200191610aa0565b820191906000526020600020905b815481529060010190602001808311610a8357829003601f168201915b505050505081565b6060600060ce546001600160401b03811115610ac657610ac661344a565b604051908082528060200260200182016040528015610aff57816020015b610aec61302a565b815260200190600190039081610ae45790505b50905060015b60ce548111610e345760ca6000828152602001908152602001600020604051806101a001604052908160008201548152602001600182018054610b4790613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610b7390613d43565b8015610bc05780601f10610b9557610100808354040283529160200191610bc0565b820191906000526020600020905b815481529060010190602001808311610ba357829003601f168201915b50505050508152602001600282018054610bd990613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610c0590613d43565b8015610c525780601f10610c2757610100808354040283529160200191610c52565b820191906000526020600020905b815481529060010190602001808311610c3557829003601f168201915b50505050508152602001600382018054610c6b90613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610c9790613d43565b8015610ce45780601f10610cb957610100808354040283529160200191610ce4565b820191906000526020600020905b815481529060010190602001808311610cc757829003601f168201915b50505050508152602001600482018054610cfd90613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610d2990613d43565b8015610d765780601f10610d4b57610100808354040283529160200191610d76565b820191906000526020600020905b815481529060010190602001808311610d5957829003601f168201915b50505091835250506005820154602082015260069091015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b9091041615156101009091015282610e06600184613d77565b81518110610e1657610e16613ce6565b60200260200101819052508080610e2c90613d2a565b915050610b05565b50919050565b600081815260ca6020908152604080832081516101a08101909252805482526001810180546060959484019190610e7090613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610e9c90613d43565b8015610ee95780601f10610ebe57610100808354040283529160200191610ee9565b820191906000526020600020905b815481529060010190602001808311610ecc57829003601f168201915b50505050508152602001600282018054610f0290613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610f2e90613d43565b8015610f7b5780601f10610f5057610100808354040283529160200191610f7b565b820191906000526020600020905b815481529060010190602001808311610f5e57829003601f168201915b50505050508152602001600382018054610f9490613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610fc090613d43565b801561100d5780601f10610fe25761010080835404028352916020019161100d565b820191906000526020600020905b815481529060010190602001808311610ff057829003601f168201915b5050505050815260200160048201805461102690613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461105290613d43565b801561109f5780601f106110745761010080835404028352916020019161109f565b820191906000526020600020905b81548152906001019060200180831161108257829003601f168201915b5050509183525050600582015460208083019190915260069092015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b909104161515610100909101528101519091506000906111729061113d86612591565b60408086015160608701516080880151925161115e95949390602001613daa565b604051602081830303815290604052612623565b6040516020016111829190613ebe565b60408051601f19818403018152919052949350505050565b6111a261302a565b60ca6000838152602001908152602001600020604051806101a0016040529081600082015481526020016001820180546111db90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461120790613d43565b80156112545780601f1061122957610100808354040283529160200191611254565b820191906000526020600020905b81548152906001019060200180831161123757829003601f168201915b5050505050815260200160028201805461126d90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461129990613d43565b80156112e65780601f106112bb576101008083540402835291602001916112e6565b820191906000526020600020905b8154815290600101906020018083116112c957829003601f168201915b505050505081526020016003820180546112ff90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461132b90613d43565b80156113785780601f1061134d57610100808354040283529160200191611378565b820191906000526020600020905b81548152906001019060200180831161135b57829003601f168201915b5050505050815260200160048201805461139190613d43565b80601f01602080910402602001604051908101604052809291908181526020018280546113bd90613d43565b801561140a5780601f106113df5761010080835404028352916020019161140a565b820191906000526020600020905b8154815290600101906020018083116113ed57829003601f168201915b50505091835250506005820154602082015260069091015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b9091041615156101009091015292915050565b61149c6123eb565b600090815260ca60205260409020600601805460ff60601b19169055565b6114c26123eb565b600090815260ca60205260409020600601805460ff60601b1916600160601b179055565b6114ee6123eb565b6114f78461255b565b50600093845260d360209081526040808620948652939052919092206001810192909255600290910180546001600160a01b0319166001600160a01b03909216919091179055565b6001600160a01b03851633148061155b575061155b85336106d4565b6115775760405162461bcd60e51b815260040161093d90613f03565b6115848585858585612775565b5050505050565b6115936123eb565b600083815260ca602052604090206002016115af828483613fb1565b506040518381527ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce79060200160405180910390a1505050565b6115f06130ac565b50600091825260cc6020908152604080842092845291815291819020815160608101835281548152600182015493810193909352600201546001600160a01b03169082015290565b600054610100900460ff16158080156116585750600054600160ff909116105b806116725750303b158015611672575060005460ff166001145b6116d55760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161093d565b6000805460ff1916600117905580156116f8576000805461ff0019166101001790555b61170061294d565b6117186040518060200160405280600081525061297c565b60d0611725858783613fb1565b5060d1611733838583613fb1565b508015611584576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b606081518351146117e55760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b606482015260840161093d565b600083516001600160401b038111156118005761180061344a565b604051908082528060200260200182016040528015611829578160200160208202803683370190505b50905060005b84518110156118a15761187485828151811061184d5761184d613ce6565b602002602001015185838151811061186757611867613ce6565b60200260200101516108d6565b82828151811061188657611886613ce6565b602090810291909101015261189a81613d2a565b905061182f565b509392505050565b6118b16123eb565b6118ba8361255b565b50600083815260cd60205260408120805490826118d683613d2a565b909155506040805160608101825286815260208082019687526001600160a01b03958616828401908152600098895260cc825283892094895293905295209451855592516001850155509051600290920180546001600160a01b03191692909116919091179055565b6119476123eb565b61195160006129ac565b565b600083815260ca602052604090206006810154600160681b900460ff1661198d576040516371642c7760e11b815260040160405180910390fd5b60068101546119c09063ffffffff600160201b8204811691600160401b81049091169060ff600160601b909104166129fe565b826000036119e15760405163b4fa3fb360e01b815260040160405180910390fd5b6000836119ee87876108d6565b6119f89190613d12565b600683015490915063ffffffff16811115611a265760405163048f6ddf60e01b815260040160405180910390fd5b6006820154600160781b900460ff1615611a6157611a4486866122f3565b611a615760405163c00b832f60e01b815260040160405180910390fd5b6006820154600160701b900460ff1615611a9c57611a7f8686611faa565b611a9c576040516323884f4360e11b815260040160405180910390fd5b60cf60008154611aab90613d2a565b90915550600582018054600090611ac190613d2a565b909155508154611ad49087908686612445565b505050505050565b611ae46123eb565b600092835260ca602052604090922060060180546bffffffffffffffff000000001916600160201b63ffffffff9384160263ffffffff60401b191617600160401b9290931691909102919091179055565b611b3d6123eb565b600091825260ca60205260409091206006018054911515600160701b0260ff60701b19909216919091179055565b611b736123eb565b60d2805460ff19811660ff90911615179055565b611b8f6123eb565b600060ce60008154611ba090613d2a565b9182905550600081815260ca6020526040902081815590915060018101611bc78d8261406a565b5060028101611bd68c8261406a565b5060038101611be58b8261406a565b5060048101611bf48a8261406a565b50878160060160006101000a81548163ffffffff021916908363ffffffff160217905550868160060160046101000a81548163ffffffff021916908363ffffffff160217905550858160060160086101000a81548163ffffffff021916908363ffffffff16021790555060008160050181905550600081600601600c6101000a81548160ff0219169083151502179055508481600601600d6101000a81548160ff0219169083151502179055508381600601600e6101000a81548160ff0219169083151502179055508281600601600f6101000a81548160ff021916908315150217905550817f04e8929daf8362cceafb1829f3c1cf33366f56a819e661c33d398ef7cdfe44f18d8d604051611d0b929190614123565b60405180910390a2505050505050505050505050565b60d18054610a2790613d43565b611d366123eb565b600091825260ca60205260409091206006018054911515600160781b0260ff60781b19909216919091179055565b611d6f338383612a7c565b5050565b600081815260cd6020526040812054606091816001600160401b03811115611d9d57611d9d61344a565b604051908082528060200260200182016040528015611dd657816020015b611dc36130ac565b815260200190600190039081611dbb5790505b50905060005b828110156118a157600085815260cc60209081526040808320848452825291829020825160608101845281548152600182015492810192909252600201546001600160a01b0316918101919091528251839083908110611e3e57611e3e613ce6565b60200260200101819052508080611e5490613d2a565b915050611ddc565b611e646130ac565b50600091825260d36020908152604080842092845291815291819020815160608101835281548152600182015493810193909352600201546001600160a01b03169082015290565b611eb46123eb565b600091825260ca6020526040909120600601805463ffffffff191663ffffffff909216919091179055565b611ee76123eb565b600084815260ca60205260409020600101611f02848261406a565b50600084815260ca60205260409020600301611f1e838261406a565b50600084815260ca60205260409020600401611f3a828261406a565b506040518481527ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce79060200160405180910390a150505050565b611f7c6123eb565b600091825260ca60205260409091206006018054911515600160681b0260ff60681b19909216919091179055565b600081815260ca6020526040812060060154600160701b900460ff16611fd25750600161096b565b600082815260d46020526040812054905b818110156120ab57600084815260d360209081526040808320848452909152902060018101541561209857600181015460028201546040516370a0823160e01b81526001600160a01b03909116906370a0823190612045908a90600401613ac7565b602060405180830381865afa158015612062573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906120869190614151565b1015612098576000935050505061096b565b50806120a381613d2a565b915050611fe3565b506001949350505050565b6120be6123eb565b6120c78361255b565b50600083815260d460205260408120805490826120e383613d2a565b909155506040805160608101825286815260208082019687526001600160a01b03958616828401908152600098895260d3825283892094895293905295209451855592516001850155509051600290920180546001600160a01b03191692909116919091179055565b6001600160a01b038516331480612168575061216885336106d4565b6121845760405162461bcd60e51b815260040161093d90613f03565b6115848585858585612b5c565b6121996123eb565b6001600160a01b0381166121fe5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b606482015260840161093d565b612207816129ac565b50565b600081815260d46020526040812054606091816001600160401b038111156122345761223461344a565b60405190808252806020026020018201604052801561226d57816020015b61225a6130ac565b8152602001906001900390816122525790505b50905060005b828110156118a157600085815260d360209081526040808320848452825291829020825160608101845281548152600182015492810192909252600201546001600160a01b03169181019190915282518390839081106122d5576122d5613ce6565b602002602001018190525080806122eb90613d2a565b915050612273565b600081815260cd6020526040812054815b818110156123cb57600084815260cc6020908152604080832084845290915290206001810154156123b857600181015460028201546040516370a0823160e01b81526001600160a01b03909116906370a0823190612366908a90600401613ac7565b602060405180830381865afa158015612383573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123a79190614151565b106123b8576001935050505061096b565b50806123c381613d2a565b915050612304565b506000949350505050565b6000806123e384846108d6565b119392505050565b6033546001600160a01b031633146119515760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161093d565b6001600160a01b0384166124a55760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b606482015260840161093d565b3360006124b185612c8a565b905060006124be85612c8a565b905060008681526097602090815260408083206001600160a01b038b168452909152812080548792906124f2908490613d12565b909155505060408051878152602081018790526001600160a01b03808a1692600092918716917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a461255283600089898989612cd5565b50505050505050565b600081815260ca6020526040812054810361258957604051631cdaa5e760e21b815260040160405180910390fd5b506001919050565b6060600061259e83612e30565b60010190506000816001600160401b038111156125bd576125bd61344a565b6040519080825280601f01601f1916602001820160405280156125e7576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a85049450846125f157509392505050565b6060815160000361264257505060408051602081019091526000815290565b600060405180606001604052806040815260200161444c60409139905060006003845160026126719190613d12565b61267b919061416a565b61268690600461418c565b6001600160401b0381111561269d5761269d61344a565b6040519080825280601f01601f1916602001820160405280156126c7576020820181803683370190505b509050600182016020820185865187015b80821015612733576003820191508151603f8160121c168501518453600184019350603f81600c1c168501518453600184019350603f8160061c168501518453600184019350603f81168501518453506001830192506126d8565b505060038651066001811461274f57600281146127625761276a565b603d6001830353603d600283035361276a565b603d60018303535b509195945050505050565b81518351146127d75760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b606482015260840161093d565b6001600160a01b0384166127fd5760405162461bcd60e51b815260040161093d906141ab565b3360005b84518110156128e757600085828151811061281e5761281e613ce6565b60200260200101519050600085838151811061283c5761283c613ce6565b60209081029190910181015160008481526097835260408082206001600160a01b038e16835290935291909120549091508181101561288d5760405162461bcd60e51b815260040161093d906141f0565b60008381526097602090815260408083206001600160a01b038e8116855292528083208585039055908b168252812080548492906128cc908490613d12565b92505081905550505050806128e090613d2a565b9050612801565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb878760405161293792919061423a565b60405180910390a4611ad4818787878787612f08565b600054610100900460ff166129745760405162461bcd60e51b815260040161093d9061425f565b611951612fc3565b600054610100900460ff166129a35760405162461bcd60e51b815260040161093d9061425f565b61220781612ff3565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60004263ffffffff168463ffffffff1611158015612a2857504263ffffffff168363ffffffff1610155b60d25490915060ff16612a4e57604051630732158d60e31b815260040160405180910390fd5b801580612a585750815b15612a7657604051630732158d60e31b815260040160405180910390fd5b50505050565b816001600160a01b0316836001600160a01b031603612aef5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b606482015260840161093d565b6001600160a01b03838116600081815260986020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b038416612b825760405162461bcd60e51b815260040161093d906141ab565b336000612b8e85612c8a565b90506000612b9b85612c8a565b905060008681526097602090815260408083206001600160a01b038c16845290915290205485811015612be05760405162461bcd60e51b815260040161093d906141f0565b60008781526097602090815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290612c1f908490613d12565b909155505060408051888152602081018890526001600160a01b03808b16928c821692918816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a4612c7f848a8a8a8a8a612cd5565b505050505050505050565b60408051600180825281830190925260609160009190602080830190803683370190505090508281600081518110612cc457612cc4613ce6565b602090810291909101015292915050565b6001600160a01b0384163b15611ad45760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190612d1990899089908890889088906004016142aa565b6020604051808303816000875af1925050508015612d54575060408051601f3d908101601f19168201909252612d51918101906142ef565b60015b612e0057612d6061430c565b806308c379a003612d995750612d74614328565b80612d7f5750612d9b565b8060405162461bcd60e51b815260040161093d91906132b1565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b606482015260840161093d565b6001600160e01b0319811663f23a6e6160e01b146125525760405162461bcd60e51b815260040161093d906143b1565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310612e6f5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310612e9b576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310612eb957662386f26fc10000830492506010015b6305f5e1008310612ed1576305f5e100830492506008015b6127108310612ee557612710830492506004015b60648310612ef7576064830492506002015b600a831061096b5760010192915050565b6001600160a01b0384163b15611ad45760405163bc197c8160e01b81526001600160a01b0385169063bc197c8190612f4c90899089908890889088906004016143f9565b6020604051808303816000875af1925050508015612f87575060408051601f3d908101601f19168201909252612f84918101906142ef565b60015b612f9357612d6061430c565b6001600160e01b0319811663bc197c8160e01b146125525760405162461bcd60e51b815260040161093d906143b1565b600054610100900460ff16612fea5760405162461bcd60e51b815260040161093d9061425f565b611951336129ac565b600054610100900460ff1661301a5760405162461bcd60e51b815260040161093d9061425f565b612207816099611d6f828261406a565b604051806101a00160405280600081526020016060815260200160608152602001606081526020016060815260200160008152602001600063ffffffff168152602001600063ffffffff168152602001600063ffffffff1681526020016000151581526020016000151581526020016000151581526020016000151581525090565b6040518060600160405280600081526020016000815260200160006001600160a01b031681525090565b60008083601f8401126130e857600080fd5b5081356001600160401b038111156130ff57600080fd5b6020830191508360208260051b850101111561311a57600080fd5b9250929050565b60008060008060006060868803121561313957600080fd5b8535945060208601356001600160401b038082111561315757600080fd5b61316389838a016130d6565b9096509450604088013591508082111561317c57600080fd5b50613189888289016130d6565b969995985093965092949392505050565b80356001600160a01b03811681146131b157600080fd5b919050565b600080604083850312156131c957600080fd5b6131d28361319a565b946020939093013593505050565b600080600080608085870312156131f657600080fd5b8435935060208501359250604085013591506132146060860161319a565b905092959194509250565b6001600160e01b03198116811461220757600080fd5b60006020828403121561324757600080fd5b81356132528161321f565b9392505050565b60005b8381101561327457818101518382015260200161325c565b83811115612a765750506000910152565b6000815180845261329d816020860160208601613259565b601f01601f19169290920160200192915050565b6020815260006132526020830184613285565b60006101a08251845260208301518160208601526132e482860182613285565b915050604083015184820360408601526132fe8282613285565b915050606083015184820360608601526133188282613285565b915050608083015184820360808601526133328282613285565b91505060a083015160a085015260c083015161335660c086018263ffffffff169052565b5060e083015161336e60e086018263ffffffff169052565b506101008381015163ffffffff169085015261012080840151151590850152610140808401511515908501526101608084015115159085015261018092830151151592909301919091525090565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b8281101561341157603f198886030184526133ff8583516132c4565b945092850192908501906001016133e3565b5092979650505050505050565b60006020828403121561343057600080fd5b5035919050565b60208152600061325260208301846132c4565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b03811182821017156134855761348561344a565b6040525050565b60006001600160401b038211156134a5576134a561344a565b5060051b60200190565b600082601f8301126134c057600080fd5b813560206134cd8261348c565b6040516134da8282613460565b83815260059390931b85018201928281019150868411156134fa57600080fd5b8286015b8481101561351557803583529183019183016134fe565b509695505050505050565b600082601f83011261353157600080fd5b81356001600160401b0381111561354a5761354a61344a565b604051613561601f8301601f191660200182613460565b81815284602083860101111561357657600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156135ab57600080fd5b6135b48661319a565b94506135c26020870161319a565b935060408601356001600160401b03808211156135de57600080fd5b6135ea89838a016134af565b9450606088013591508082111561360057600080fd5b61360c89838a016134af565b9350608088013591508082111561362257600080fd5b5061362f88828901613520565b9150509295509295909350565b60008083601f84011261364e57600080fd5b5081356001600160401b0381111561366557600080fd5b60208301915083602082850101111561311a57600080fd5b60008060006040848603121561369257600080fd5b8335925060208401356001600160401b038111156136af57600080fd5b6136bb8682870161363c565b9497909650939450505050565b600080604083850312156136db57600080fd5b50508035926020909101359150565b80518252602080820151908301526040908101516001600160a01b0316910152565b6060810161096b82846136ea565b6000806000806040858703121561373057600080fd5b84356001600160401b038082111561374757600080fd5b6137538883890161363c565b9096509450602087013591508082111561376c57600080fd5b506137798782880161363c565b95989497509550505050565b6000806040838503121561379857600080fd5b82356001600160401b03808211156137af57600080fd5b818501915085601f8301126137c357600080fd5b813560206137d08261348c565b6040516137dd8282613460565b83815260059390931b85018201928281019150898411156137fd57600080fd5b948201945b83861015613822576138138661319a565b82529482019490820190613802565b9650508601359250508082111561383857600080fd5b50613845858286016134af565b9150509250929050565b600081518084526020808501945080840160005b8381101561387f57815187529582019590820190600101613863565b509495945050505050565b602081526000613252602083018461384f565b6000806000606084860312156138b257600080fd5b83359250602084013591506138c96040850161319a565b90509250925092565b600080600080608085870312156138e857600080fd5b6138f18561319a565b9350602085013592506040850135915060608501356001600160401b0381111561391a57600080fd5b61392687828801613520565b91505092959194509250565b803563ffffffff811681146131b157600080fd5b60008060006060848603121561395b57600080fd5b8335925061396b60208501613932565b91506138c960408501613932565b803580151581146131b157600080fd5b6000806040838503121561399c57600080fd5b823591506139ac60208401613979565b90509250929050565b6000806000806000806000806000806101408b8d0312156139d557600080fd5b8a356001600160401b03808211156139ec57600080fd5b6139f88e838f01613520565b9b5060208d0135915080821115613a0e57600080fd5b613a1a8e838f01613520565b9a5060408d0135915080821115613a3057600080fd5b613a3c8e838f01613520565b995060608d0135915080821115613a5257600080fd5b50613a5f8d828e01613520565b975050613a6e60808c01613932565b9550613a7c60a08c01613932565b9450613a8a60c08c01613932565b9350613a9860e08c01613979565b9250613aa76101008c01613979565b9150613ab66101208c01613979565b90509295989b9194979a5092959850565b6001600160a01b0391909116815260200190565b60008060408385031215613aee57600080fd5b613af78361319a565b91506139ac60208401613979565b6020808252825182820181905260009190848201906040850190845b81811015613b4757613b348385516136ea565b9284019260609290920191600101613b21565b50909695505050505050565b60008060408385031215613b6657600080fd5b823591506139ac60208401613932565b60008060008060808587031215613b8c57600080fd5b8435935060208501356001600160401b0380821115613baa57600080fd5b613bb688838901613520565b94506040870135915080821115613bcc57600080fd5b613bd888838901613520565b93506060870135915080821115613bee57600080fd5b5061392687828801613520565b60008060408385031215613c0e57600080fd5b613c178361319a565b91506139ac6020840161319a565b600080600080600060a08688031215613c3d57600080fd5b613c468661319a565b9450613c546020870161319a565b9350604086013592506060860135915060808601356001600160401b03811115613c7d57600080fd5b61362f88828901613520565b600060208284031215613c9b57600080fd5b6132528261319a565b6020808252825182820181905260009190848201906040850190845b81811015613b4757613cd38385516136ea565b9284019260609290920191600101613cc0565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008219821115613d2557613d25613cfc565b500190565b600060018201613d3c57613d3c613cfc565b5060010190565b600181811c90821680613d5757607f821691505b602082108103610e3457634e487b7160e01b600052602260045260246000fd5b600082821015613d8957613d89613cfc565b500390565b60008151613da0818560208601613259565b9290920192915050565b6a3d90113730b6b2911d101160a91b81528551600090613dd181600b850160208b01613259565b691116101134b2111d101160b11b600b918401918201528651613dfb816015840160208b01613259565b6c1116101134b6b0b3b2911d101160991b601592909101918201528551613e29816022840160208a01613259565b7f222c202270726f70657274696573223a207b20226172746973744e616d65223a6022929091019182015261101160f11b60428201528451613e72816044840160208901613259565b73113e9610113232b9b1b934b83a34b7b7111d101160611b60449290910191820152613eb2613ea46058830186613d8e565b61227d60f01b815260020190565b98975050505050505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c000000815260008251613ef681601d850160208701613259565b91909101601d0192915050565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b601f821115613f9757600081815260208120601f850160051c81016020861015613f785750805b601f850160051c820191505b81811015611ad457828155600101613f84565b505050565b600019600383901b1c191660019190911b1790565b6001600160401b03831115613fc857613fc861344a565b613fdc83613fd68354613d43565b83613f51565b6000601f84116001811461400a5760008515613ff85750838201355b6140028682613f9c565b845550611584565b600083815260209020601f19861690835b8281101561403b578685013582556020948501946001909201910161401b565b50868210156140585760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b81516001600160401b038111156140835761408361344a565b614097816140918454613d43565b84613f51565b602080601f8311600181146140c657600084156140b45750858301515b6140be8582613f9c565b865550611ad4565b600085815260208120601f198616915b828110156140f5578886015182559484019460019091019084016140d6565b50858210156141135787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6040815260006141366040830185613285565b82810360208401526141488185613285565b95945050505050565b60006020828403121561416357600080fd5b5051919050565b60008261418757634e487b7160e01b600052601260045260246000fd5b500490565b60008160001904831182151516156141a6576141a6613cfc565b500290565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60408152600061424d604083018561384f565b8281036020840152614148818561384f565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190526000906142e490830184613285565b979650505050505050565b60006020828403121561430157600080fd5b81516132528161321f565b600060033d11156143255760046000803e5060005160e01c5b90565b600060443d10156143365790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561436557505050505090565b828501915081518181111561437d5750505050505090565b843d87010160208285010111156143975750505050505090565b6143a660208286010187613460565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906144259083018661384f565b8281036060840152614437818661384f565b90508281036080840152613eb2818561328556fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa26469706673582212209136e424bbf4f8965f62c0972a1ba31bb1d945f2ea717381832a54080311a42864736f6c634300080f0033
Deployed Bytecode
0x608060405234801561001057600080fd5b50600436106102a95760003560e01c80637d55094d11610172578063bdf2a43c116100d9578063e985e9c511610092578063e985e9c5146106c6578063eb08ab2814610702578063f242432a1461070b578063f2fde38b1461071e578063f3a2deea14610731578063f4103e4d14610751578063f8f1147d1461076457600080fd5b8063bdf2a43c1461060a578063c401aa9914610637578063ce757efd1461064a578063d55b53e61461065d578063dc4f3b8014610670578063dc73dece1461068357600080fd5b8063a0cef62c1161012b578063a0cef62c1461057b578063a22cb4651461058e578063a2cb6af5146105a1578063a6c696f6146105c1578063a782b124146105d4578063bd85b039146105e757600080fd5b80637d55094d146105125780638549feba1461051a5780638da5cb5b1461052d57806395d89b41146105465780639d6ff5581461054e5780639fd6db121461056e57600080fd5b806333189c421161021657806362c5a671116101cf57806362c5a671146104a8578063715018a6146104c8578063731133e9146104d05780637666d075146104e357806377726263146104f65780637d549e991461050957600080fd5b806333189c42146103c8578063457af70c146103db5780634cd88b76146103fb5780634e1273f41461040e57806358ca190e1461042e5780635ecaef431461044157600080fd5b80630e89341c116102685780630e89341c1461034957806311b46a991461035c5780631b300fb51461037c578063258ff2de1461038f5780632bcd3539146103a25780632eb2c2d6146103b557600080fd5b806255a613146102ae578062fdd58e146102c357806301247ab6146102e957806301ffc9a7146102fc57806306fdde031461031f5780630d23677214610334575b600080fd5b6102c16102bc366004613121565b610777565b005b6102d66102d13660046131b6565b6108d6565b6040519081526020015b60405180910390f35b6102c16102f73660046131e0565b610971565b61030f61030a366004613235565b6109ca565b60405190151581526020016102e0565b610327610a1a565b6040516102e091906132b1565b61033c610aa8565b6040516102e091906133bc565b61032761035736600461341e565b610e3a565b61036f61036a36600461341e565b61119a565b6040516102e09190613437565b6102c161038a36600461341e565b611494565b6102c161039d36600461341e565b6114ba565b6102c16103b03660046131e0565b6114e6565b6102c16103c3366004613593565b61153f565b6102c16103d636600461367d565b61158b565b6103ee6103e93660046136c8565b6115e8565b6040516102e0919061370c565b6102c161040936600461371a565b611638565b61042161041c366004613785565b611780565b6040516102e0919061388a565b6102c161043c36600461389d565b6118a9565b61048461044f3660046136c8565b60d36020908152600092835260408084209091529082529020805460018201546002909201549091906001600160a01b031683565b6040805193845260208401929092526001600160a01b0316908201526060016102e0565b6102d66104b636600461341e565b600090815260cd602052604090205490565b6102c161193f565b6102c16104de3660046138d2565b611953565b6102c16104f1366004613946565b611adc565b6102c1610504366004613989565b611b35565b6102d660cf5481565b6102c1611b6b565b6102c16105283660046139b5565b611b87565b6033546001600160a01b03166040516102e09190613ac7565b610327611d21565b6102d661055c36600461341e565b600090815260d4602052604090205490565b60d25461030f9060ff1681565b6102c1610589366004613989565b611d2e565b6102c161059c366004613adb565b611d64565b6105b46105af36600461341e565b611d73565b6040516102e09190613b05565b6103ee6105cf3660046136c8565b611e5c565b6102c16105e2366004613b53565b611eac565b6102d66105f536600461341e565b600090815260ca602052604090206005015490565b61030f61061836600461341e565b600090815260ca6020526040902060060154600160601b900460ff1690565b6102c1610645366004613b76565b611edf565b6102c1610658366004613989565b611f74565b61030f61066b3660046131b6565b611faa565b6102c161067e36600461389d565b6120b6565b6104846106913660046136c8565b60cc6020908152600092835260408084209091529082529020805460018201546002909201549091906001600160a01b031683565b61030f6106d4366004613bfb565b6001600160a01b03918216600090815260986020908152604080832093909416825291909152205460ff1690565b6102d660ce5481565b6102c1610719366004613c25565b61214c565b6102c161072c366004613c89565b612191565b61074461073f36600461341e565b61220a565b6040516102e09190613ca4565b61030f61075f3660046131b6565b6122f3565b61030f6107723660046131b6565b6123d6565b61077f6123eb565b82811461079f5760405163b4fa3fb360e01b815260040160405180910390fd5b600085815260ca6020526040812090805b8581101561089a5760008787838181106107cc576107cc613ce6565b90506020020160208101906107e19190613c89565b905060008686848181106107f7576107f7613ce6565b90506020020135905061081f8286600001548360405180602001604052806000815250612445565b6001600160a01b038216600090815260c9602090815260408083208d845290915290205460ff16610879576001600160a01b038216600090815260c9602090815260408083208d84529091529020805460ff191660011790555b6108838185613d12565b93505050808061089290613d2a565b9150506107b0565b508060cf60008282546108ad9190613d12565b92505081905550808260050160008282546108c89190613d12565b909155505050505050505050565b60006001600160a01b0383166109465760405162461bcd60e51b815260206004820152602a60248201527f455243313135353a2061646472657373207a65726f206973206e6f742061207660448201526930b634b21037bbb732b960b11b60648201526084015b60405180910390fd5b5060008181526097602090815260408083206001600160a01b03861684529091529020545b92915050565b6109796123eb565b6109828461255b565b50600093845260cc60209081526040808620948652939052919092206001810192909255600290910180546001600160a01b0319166001600160a01b03909216919091179055565b60006001600160e01b03198216636cdb3d1360e11b14806109fb57506001600160e01b031982166303a24d0760e21b145b8061096b57506301ffc9a760e01b6001600160e01b031983161461096b565b60d08054610a2790613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610a5390613d43565b8015610aa05780601f10610a7557610100808354040283529160200191610aa0565b820191906000526020600020905b815481529060010190602001808311610a8357829003601f168201915b505050505081565b6060600060ce546001600160401b03811115610ac657610ac661344a565b604051908082528060200260200182016040528015610aff57816020015b610aec61302a565b815260200190600190039081610ae45790505b50905060015b60ce548111610e345760ca6000828152602001908152602001600020604051806101a001604052908160008201548152602001600182018054610b4790613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610b7390613d43565b8015610bc05780601f10610b9557610100808354040283529160200191610bc0565b820191906000526020600020905b815481529060010190602001808311610ba357829003601f168201915b50505050508152602001600282018054610bd990613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610c0590613d43565b8015610c525780601f10610c2757610100808354040283529160200191610c52565b820191906000526020600020905b815481529060010190602001808311610c3557829003601f168201915b50505050508152602001600382018054610c6b90613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610c9790613d43565b8015610ce45780601f10610cb957610100808354040283529160200191610ce4565b820191906000526020600020905b815481529060010190602001808311610cc757829003601f168201915b50505050508152602001600482018054610cfd90613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610d2990613d43565b8015610d765780601f10610d4b57610100808354040283529160200191610d76565b820191906000526020600020905b815481529060010190602001808311610d5957829003601f168201915b50505091835250506005820154602082015260069091015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b9091041615156101009091015282610e06600184613d77565b81518110610e1657610e16613ce6565b60200260200101819052508080610e2c90613d2a565b915050610b05565b50919050565b600081815260ca6020908152604080832081516101a08101909252805482526001810180546060959484019190610e7090613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610e9c90613d43565b8015610ee95780601f10610ebe57610100808354040283529160200191610ee9565b820191906000526020600020905b815481529060010190602001808311610ecc57829003601f168201915b50505050508152602001600282018054610f0290613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610f2e90613d43565b8015610f7b5780601f10610f5057610100808354040283529160200191610f7b565b820191906000526020600020905b815481529060010190602001808311610f5e57829003601f168201915b50505050508152602001600382018054610f9490613d43565b80601f0160208091040260200160405190810160405280929190818152602001828054610fc090613d43565b801561100d5780601f10610fe25761010080835404028352916020019161100d565b820191906000526020600020905b815481529060010190602001808311610ff057829003601f168201915b5050505050815260200160048201805461102690613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461105290613d43565b801561109f5780601f106110745761010080835404028352916020019161109f565b820191906000526020600020905b81548152906001019060200180831161108257829003601f168201915b5050509183525050600582015460208083019190915260069092015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b909104161515610100909101528101519091506000906111729061113d86612591565b60408086015160608701516080880151925161115e95949390602001613daa565b604051602081830303815290604052612623565b6040516020016111829190613ebe565b60408051601f19818403018152919052949350505050565b6111a261302a565b60ca6000838152602001908152602001600020604051806101a0016040529081600082015481526020016001820180546111db90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461120790613d43565b80156112545780601f1061122957610100808354040283529160200191611254565b820191906000526020600020905b81548152906001019060200180831161123757829003601f168201915b5050505050815260200160028201805461126d90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461129990613d43565b80156112e65780601f106112bb576101008083540402835291602001916112e6565b820191906000526020600020905b8154815290600101906020018083116112c957829003601f168201915b505050505081526020016003820180546112ff90613d43565b80601f016020809104026020016040519081016040528092919081815260200182805461132b90613d43565b80156113785780601f1061134d57610100808354040283529160200191611378565b820191906000526020600020905b81548152906001019060200180831161135b57829003601f168201915b5050505050815260200160048201805461139190613d43565b80601f01602080910402602001604051908101604052809291908181526020018280546113bd90613d43565b801561140a5780601f106113df5761010080835404028352916020019161140a565b820191906000526020600020905b8154815290600101906020018083116113ed57829003601f168201915b50505091835250506005820154602082015260069091015463ffffffff8082166040840152600160201b820481166060840152600160401b820416608083015260ff600160601b82048116151560a0840152600160681b82048116151560c0840152600160701b82048116151560e0840152600160781b9091041615156101009091015292915050565b61149c6123eb565b600090815260ca60205260409020600601805460ff60601b19169055565b6114c26123eb565b600090815260ca60205260409020600601805460ff60601b1916600160601b179055565b6114ee6123eb565b6114f78461255b565b50600093845260d360209081526040808620948652939052919092206001810192909255600290910180546001600160a01b0319166001600160a01b03909216919091179055565b6001600160a01b03851633148061155b575061155b85336106d4565b6115775760405162461bcd60e51b815260040161093d90613f03565b6115848585858585612775565b5050505050565b6115936123eb565b600083815260ca602052604090206002016115af828483613fb1565b506040518381527ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce79060200160405180910390a1505050565b6115f06130ac565b50600091825260cc6020908152604080842092845291815291819020815160608101835281548152600182015493810193909352600201546001600160a01b03169082015290565b600054610100900460ff16158080156116585750600054600160ff909116105b806116725750303b158015611672575060005460ff166001145b6116d55760405162461bcd60e51b815260206004820152602e60248201527f496e697469616c697a61626c653a20636f6e747261637420697320616c72656160448201526d191e481a5b9a5d1a585b1a5e995960921b606482015260840161093d565b6000805460ff1916600117905580156116f8576000805461ff0019166101001790555b61170061294d565b6117186040518060200160405280600081525061297c565b60d0611725858783613fb1565b5060d1611733838583613fb1565b508015611584576000805461ff0019169055604051600181527f7f26b83ff96e1f2b6a682f133852f6798a09c465da95921460cefb38474024989060200160405180910390a15050505050565b606081518351146117e55760405162461bcd60e51b815260206004820152602960248201527f455243313135353a206163636f756e747320616e6420696473206c656e677468604482015268040dad2e6dac2e8c6d60bb1b606482015260840161093d565b600083516001600160401b038111156118005761180061344a565b604051908082528060200260200182016040528015611829578160200160208202803683370190505b50905060005b84518110156118a15761187485828151811061184d5761184d613ce6565b602002602001015185838151811061186757611867613ce6565b60200260200101516108d6565b82828151811061188657611886613ce6565b602090810291909101015261189a81613d2a565b905061182f565b509392505050565b6118b16123eb565b6118ba8361255b565b50600083815260cd60205260408120805490826118d683613d2a565b909155506040805160608101825286815260208082019687526001600160a01b03958616828401908152600098895260cc825283892094895293905295209451855592516001850155509051600290920180546001600160a01b03191692909116919091179055565b6119476123eb565b61195160006129ac565b565b600083815260ca602052604090206006810154600160681b900460ff1661198d576040516371642c7760e11b815260040160405180910390fd5b60068101546119c09063ffffffff600160201b8204811691600160401b81049091169060ff600160601b909104166129fe565b826000036119e15760405163b4fa3fb360e01b815260040160405180910390fd5b6000836119ee87876108d6565b6119f89190613d12565b600683015490915063ffffffff16811115611a265760405163048f6ddf60e01b815260040160405180910390fd5b6006820154600160781b900460ff1615611a6157611a4486866122f3565b611a615760405163c00b832f60e01b815260040160405180910390fd5b6006820154600160701b900460ff1615611a9c57611a7f8686611faa565b611a9c576040516323884f4360e11b815260040160405180910390fd5b60cf60008154611aab90613d2a565b90915550600582018054600090611ac190613d2a565b909155508154611ad49087908686612445565b505050505050565b611ae46123eb565b600092835260ca602052604090922060060180546bffffffffffffffff000000001916600160201b63ffffffff9384160263ffffffff60401b191617600160401b9290931691909102919091179055565b611b3d6123eb565b600091825260ca60205260409091206006018054911515600160701b0260ff60701b19909216919091179055565b611b736123eb565b60d2805460ff19811660ff90911615179055565b611b8f6123eb565b600060ce60008154611ba090613d2a565b9182905550600081815260ca6020526040902081815590915060018101611bc78d8261406a565b5060028101611bd68c8261406a565b5060038101611be58b8261406a565b5060048101611bf48a8261406a565b50878160060160006101000a81548163ffffffff021916908363ffffffff160217905550868160060160046101000a81548163ffffffff021916908363ffffffff160217905550858160060160086101000a81548163ffffffff021916908363ffffffff16021790555060008160050181905550600081600601600c6101000a81548160ff0219169083151502179055508481600601600d6101000a81548160ff0219169083151502179055508381600601600e6101000a81548160ff0219169083151502179055508281600601600f6101000a81548160ff021916908315150217905550817f04e8929daf8362cceafb1829f3c1cf33366f56a819e661c33d398ef7cdfe44f18d8d604051611d0b929190614123565b60405180910390a2505050505050505050505050565b60d18054610a2790613d43565b611d366123eb565b600091825260ca60205260409091206006018054911515600160781b0260ff60781b19909216919091179055565b611d6f338383612a7c565b5050565b600081815260cd6020526040812054606091816001600160401b03811115611d9d57611d9d61344a565b604051908082528060200260200182016040528015611dd657816020015b611dc36130ac565b815260200190600190039081611dbb5790505b50905060005b828110156118a157600085815260cc60209081526040808320848452825291829020825160608101845281548152600182015492810192909252600201546001600160a01b0316918101919091528251839083908110611e3e57611e3e613ce6565b60200260200101819052508080611e5490613d2a565b915050611ddc565b611e646130ac565b50600091825260d36020908152604080842092845291815291819020815160608101835281548152600182015493810193909352600201546001600160a01b03169082015290565b611eb46123eb565b600091825260ca6020526040909120600601805463ffffffff191663ffffffff909216919091179055565b611ee76123eb565b600084815260ca60205260409020600101611f02848261406a565b50600084815260ca60205260409020600301611f1e838261406a565b50600084815260ca60205260409020600401611f3a828261406a565b506040518481527ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce79060200160405180910390a150505050565b611f7c6123eb565b600091825260ca60205260409091206006018054911515600160681b0260ff60681b19909216919091179055565b600081815260ca6020526040812060060154600160701b900460ff16611fd25750600161096b565b600082815260d46020526040812054905b818110156120ab57600084815260d360209081526040808320848452909152902060018101541561209857600181015460028201546040516370a0823160e01b81526001600160a01b03909116906370a0823190612045908a90600401613ac7565b602060405180830381865afa158015612062573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906120869190614151565b1015612098576000935050505061096b565b50806120a381613d2a565b915050611fe3565b506001949350505050565b6120be6123eb565b6120c78361255b565b50600083815260d460205260408120805490826120e383613d2a565b909155506040805160608101825286815260208082019687526001600160a01b03958616828401908152600098895260d3825283892094895293905295209451855592516001850155509051600290920180546001600160a01b03191692909116919091179055565b6001600160a01b038516331480612168575061216885336106d4565b6121845760405162461bcd60e51b815260040161093d90613f03565b6115848585858585612b5c565b6121996123eb565b6001600160a01b0381166121fe5760405162461bcd60e51b815260206004820152602660248201527f4f776e61626c653a206e6577206f776e657220697320746865207a65726f206160448201526564647265737360d01b606482015260840161093d565b612207816129ac565b50565b600081815260d46020526040812054606091816001600160401b038111156122345761223461344a565b60405190808252806020026020018201604052801561226d57816020015b61225a6130ac565b8152602001906001900390816122525790505b50905060005b828110156118a157600085815260d360209081526040808320848452825291829020825160608101845281548152600182015492810192909252600201546001600160a01b03169181019190915282518390839081106122d5576122d5613ce6565b602002602001018190525080806122eb90613d2a565b915050612273565b600081815260cd6020526040812054815b818110156123cb57600084815260cc6020908152604080832084845290915290206001810154156123b857600181015460028201546040516370a0823160e01b81526001600160a01b03909116906370a0823190612366908a90600401613ac7565b602060405180830381865afa158015612383573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906123a79190614151565b106123b8576001935050505061096b565b50806123c381613d2a565b915050612304565b506000949350505050565b6000806123e384846108d6565b119392505050565b6033546001600160a01b031633146119515760405162461bcd60e51b815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015260640161093d565b6001600160a01b0384166124a55760405162461bcd60e51b815260206004820152602160248201527f455243313135353a206d696e7420746f20746865207a65726f206164647265736044820152607360f81b606482015260840161093d565b3360006124b185612c8a565b905060006124be85612c8a565b905060008681526097602090815260408083206001600160a01b038b168452909152812080548792906124f2908490613d12565b909155505060408051878152602081018790526001600160a01b03808a1692600092918716917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a461255283600089898989612cd5565b50505050505050565b600081815260ca6020526040812054810361258957604051631cdaa5e760e21b815260040160405180910390fd5b506001919050565b6060600061259e83612e30565b60010190506000816001600160401b038111156125bd576125bd61344a565b6040519080825280601f01601f1916602001820160405280156125e7576020820181803683370190505b5090508181016020015b600019016f181899199a1a9b1b9c1cb0b131b232b360811b600a86061a8153600a85049450846125f157509392505050565b6060815160000361264257505060408051602081019091526000815290565b600060405180606001604052806040815260200161444c60409139905060006003845160026126719190613d12565b61267b919061416a565b61268690600461418c565b6001600160401b0381111561269d5761269d61344a565b6040519080825280601f01601f1916602001820160405280156126c7576020820181803683370190505b509050600182016020820185865187015b80821015612733576003820191508151603f8160121c168501518453600184019350603f81600c1c168501518453600184019350603f8160061c168501518453600184019350603f81168501518453506001830192506126d8565b505060038651066001811461274f57600281146127625761276a565b603d6001830353603d600283035361276a565b603d60018303535b509195945050505050565b81518351146127d75760405162461bcd60e51b815260206004820152602860248201527f455243313135353a2069647320616e6420616d6f756e7473206c656e677468206044820152670dad2e6dac2e8c6d60c31b606482015260840161093d565b6001600160a01b0384166127fd5760405162461bcd60e51b815260040161093d906141ab565b3360005b84518110156128e757600085828151811061281e5761281e613ce6565b60200260200101519050600085838151811061283c5761283c613ce6565b60209081029190910181015160008481526097835260408082206001600160a01b038e16835290935291909120549091508181101561288d5760405162461bcd60e51b815260040161093d906141f0565b60008381526097602090815260408083206001600160a01b038e8116855292528083208585039055908b168252812080548492906128cc908490613d12565b92505081905550505050806128e090613d2a565b9050612801565b50846001600160a01b0316866001600160a01b0316826001600160a01b03167f4a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb878760405161293792919061423a565b60405180910390a4611ad4818787878787612f08565b600054610100900460ff166129745760405162461bcd60e51b815260040161093d9061425f565b611951612fc3565b600054610100900460ff166129a35760405162461bcd60e51b815260040161093d9061425f565b61220781612ff3565b603380546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e090600090a35050565b60004263ffffffff168463ffffffff1611158015612a2857504263ffffffff168363ffffffff1610155b60d25490915060ff16612a4e57604051630732158d60e31b815260040160405180910390fd5b801580612a585750815b15612a7657604051630732158d60e31b815260040160405180910390fd5b50505050565b816001600160a01b0316836001600160a01b031603612aef5760405162461bcd60e51b815260206004820152602960248201527f455243313135353a2073657474696e6720617070726f76616c20737461747573604482015268103337b91039b2b63360b91b606482015260840161093d565b6001600160a01b03838116600081815260986020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b6001600160a01b038416612b825760405162461bcd60e51b815260040161093d906141ab565b336000612b8e85612c8a565b90506000612b9b85612c8a565b905060008681526097602090815260408083206001600160a01b038c16845290915290205485811015612be05760405162461bcd60e51b815260040161093d906141f0565b60008781526097602090815260408083206001600160a01b038d8116855292528083208985039055908a16825281208054889290612c1f908490613d12565b909155505060408051888152602081018890526001600160a01b03808b16928c821692918816917fc3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f62910160405180910390a4612c7f848a8a8a8a8a612cd5565b505050505050505050565b60408051600180825281830190925260609160009190602080830190803683370190505090508281600081518110612cc457612cc4613ce6565b602090810291909101015292915050565b6001600160a01b0384163b15611ad45760405163f23a6e6160e01b81526001600160a01b0385169063f23a6e6190612d1990899089908890889088906004016142aa565b6020604051808303816000875af1925050508015612d54575060408051601f3d908101601f19168201909252612d51918101906142ef565b60015b612e0057612d6061430c565b806308c379a003612d995750612d74614328565b80612d7f5750612d9b565b8060405162461bcd60e51b815260040161093d91906132b1565b505b60405162461bcd60e51b815260206004820152603460248201527f455243313135353a207472616e7366657220746f206e6f6e2d455243313135356044820152732932b1b2b4bb32b91034b6b83632b6b2b73a32b960611b606482015260840161093d565b6001600160e01b0319811663f23a6e6160e01b146125525760405162461bcd60e51b815260040161093d906143b1565b60008072184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b8310612e6f5772184f03e93ff9f4daa797ed6e38ed64bf6a1f0160401b830492506040015b6d04ee2d6d415b85acef81000000008310612e9b576d04ee2d6d415b85acef8100000000830492506020015b662386f26fc100008310612eb957662386f26fc10000830492506010015b6305f5e1008310612ed1576305f5e100830492506008015b6127108310612ee557612710830492506004015b60648310612ef7576064830492506002015b600a831061096b5760010192915050565b6001600160a01b0384163b15611ad45760405163bc197c8160e01b81526001600160a01b0385169063bc197c8190612f4c90899089908890889088906004016143f9565b6020604051808303816000875af1925050508015612f87575060408051601f3d908101601f19168201909252612f84918101906142ef565b60015b612f9357612d6061430c565b6001600160e01b0319811663bc197c8160e01b146125525760405162461bcd60e51b815260040161093d906143b1565b600054610100900460ff16612fea5760405162461bcd60e51b815260040161093d9061425f565b611951336129ac565b600054610100900460ff1661301a5760405162461bcd60e51b815260040161093d9061425f565b612207816099611d6f828261406a565b604051806101a00160405280600081526020016060815260200160608152602001606081526020016060815260200160008152602001600063ffffffff168152602001600063ffffffff168152602001600063ffffffff1681526020016000151581526020016000151581526020016000151581526020016000151581525090565b6040518060600160405280600081526020016000815260200160006001600160a01b031681525090565b60008083601f8401126130e857600080fd5b5081356001600160401b038111156130ff57600080fd5b6020830191508360208260051b850101111561311a57600080fd5b9250929050565b60008060008060006060868803121561313957600080fd5b8535945060208601356001600160401b038082111561315757600080fd5b61316389838a016130d6565b9096509450604088013591508082111561317c57600080fd5b50613189888289016130d6565b969995985093965092949392505050565b80356001600160a01b03811681146131b157600080fd5b919050565b600080604083850312156131c957600080fd5b6131d28361319a565b946020939093013593505050565b600080600080608085870312156131f657600080fd5b8435935060208501359250604085013591506132146060860161319a565b905092959194509250565b6001600160e01b03198116811461220757600080fd5b60006020828403121561324757600080fd5b81356132528161321f565b9392505050565b60005b8381101561327457818101518382015260200161325c565b83811115612a765750506000910152565b6000815180845261329d816020860160208601613259565b601f01601f19169290920160200192915050565b6020815260006132526020830184613285565b60006101a08251845260208301518160208601526132e482860182613285565b915050604083015184820360408601526132fe8282613285565b915050606083015184820360608601526133188282613285565b915050608083015184820360808601526133328282613285565b91505060a083015160a085015260c083015161335660c086018263ffffffff169052565b5060e083015161336e60e086018263ffffffff169052565b506101008381015163ffffffff169085015261012080840151151590850152610140808401511515908501526101608084015115159085015261018092830151151592909301919091525090565b6000602080830181845280855180835260408601915060408160051b870101925083870160005b8281101561341157603f198886030184526133ff8583516132c4565b945092850192908501906001016133e3565b5092979650505050505050565b60006020828403121561343057600080fd5b5035919050565b60208152600061325260208301846132c4565b634e487b7160e01b600052604160045260246000fd5b601f8201601f191681016001600160401b03811182821017156134855761348561344a565b6040525050565b60006001600160401b038211156134a5576134a561344a565b5060051b60200190565b600082601f8301126134c057600080fd5b813560206134cd8261348c565b6040516134da8282613460565b83815260059390931b85018201928281019150868411156134fa57600080fd5b8286015b8481101561351557803583529183019183016134fe565b509695505050505050565b600082601f83011261353157600080fd5b81356001600160401b0381111561354a5761354a61344a565b604051613561601f8301601f191660200182613460565b81815284602083860101111561357657600080fd5b816020850160208301376000918101602001919091529392505050565b600080600080600060a086880312156135ab57600080fd5b6135b48661319a565b94506135c26020870161319a565b935060408601356001600160401b03808211156135de57600080fd5b6135ea89838a016134af565b9450606088013591508082111561360057600080fd5b61360c89838a016134af565b9350608088013591508082111561362257600080fd5b5061362f88828901613520565b9150509295509295909350565b60008083601f84011261364e57600080fd5b5081356001600160401b0381111561366557600080fd5b60208301915083602082850101111561311a57600080fd5b60008060006040848603121561369257600080fd5b8335925060208401356001600160401b038111156136af57600080fd5b6136bb8682870161363c565b9497909650939450505050565b600080604083850312156136db57600080fd5b50508035926020909101359150565b80518252602080820151908301526040908101516001600160a01b0316910152565b6060810161096b82846136ea565b6000806000806040858703121561373057600080fd5b84356001600160401b038082111561374757600080fd5b6137538883890161363c565b9096509450602087013591508082111561376c57600080fd5b506137798782880161363c565b95989497509550505050565b6000806040838503121561379857600080fd5b82356001600160401b03808211156137af57600080fd5b818501915085601f8301126137c357600080fd5b813560206137d08261348c565b6040516137dd8282613460565b83815260059390931b85018201928281019150898411156137fd57600080fd5b948201945b83861015613822576138138661319a565b82529482019490820190613802565b9650508601359250508082111561383857600080fd5b50613845858286016134af565b9150509250929050565b600081518084526020808501945080840160005b8381101561387f57815187529582019590820190600101613863565b509495945050505050565b602081526000613252602083018461384f565b6000806000606084860312156138b257600080fd5b83359250602084013591506138c96040850161319a565b90509250925092565b600080600080608085870312156138e857600080fd5b6138f18561319a565b9350602085013592506040850135915060608501356001600160401b0381111561391a57600080fd5b61392687828801613520565b91505092959194509250565b803563ffffffff811681146131b157600080fd5b60008060006060848603121561395b57600080fd5b8335925061396b60208501613932565b91506138c960408501613932565b803580151581146131b157600080fd5b6000806040838503121561399c57600080fd5b823591506139ac60208401613979565b90509250929050565b6000806000806000806000806000806101408b8d0312156139d557600080fd5b8a356001600160401b03808211156139ec57600080fd5b6139f88e838f01613520565b9b5060208d0135915080821115613a0e57600080fd5b613a1a8e838f01613520565b9a5060408d0135915080821115613a3057600080fd5b613a3c8e838f01613520565b995060608d0135915080821115613a5257600080fd5b50613a5f8d828e01613520565b975050613a6e60808c01613932565b9550613a7c60a08c01613932565b9450613a8a60c08c01613932565b9350613a9860e08c01613979565b9250613aa76101008c01613979565b9150613ab66101208c01613979565b90509295989b9194979a5092959850565b6001600160a01b0391909116815260200190565b60008060408385031215613aee57600080fd5b613af78361319a565b91506139ac60208401613979565b6020808252825182820181905260009190848201906040850190845b81811015613b4757613b348385516136ea565b9284019260609290920191600101613b21565b50909695505050505050565b60008060408385031215613b6657600080fd5b823591506139ac60208401613932565b60008060008060808587031215613b8c57600080fd5b8435935060208501356001600160401b0380821115613baa57600080fd5b613bb688838901613520565b94506040870135915080821115613bcc57600080fd5b613bd888838901613520565b93506060870135915080821115613bee57600080fd5b5061392687828801613520565b60008060408385031215613c0e57600080fd5b613c178361319a565b91506139ac6020840161319a565b600080600080600060a08688031215613c3d57600080fd5b613c468661319a565b9450613c546020870161319a565b9350604086013592506060860135915060808601356001600160401b03811115613c7d57600080fd5b61362f88828901613520565b600060208284031215613c9b57600080fd5b6132528261319a565b6020808252825182820181905260009190848201906040850190845b81811015613b4757613cd38385516136ea565b9284019260609290920191600101613cc0565b634e487b7160e01b600052603260045260246000fd5b634e487b7160e01b600052601160045260246000fd5b60008219821115613d2557613d25613cfc565b500190565b600060018201613d3c57613d3c613cfc565b5060010190565b600181811c90821680613d5757607f821691505b602082108103610e3457634e487b7160e01b600052602260045260246000fd5b600082821015613d8957613d89613cfc565b500390565b60008151613da0818560208601613259565b9290920192915050565b6a3d90113730b6b2911d101160a91b81528551600090613dd181600b850160208b01613259565b691116101134b2111d101160b11b600b918401918201528651613dfb816015840160208b01613259565b6c1116101134b6b0b3b2911d101160991b601592909101918201528551613e29816022840160208a01613259565b7f222c202270726f70657274696573223a207b20226172746973744e616d65223a6022929091019182015261101160f11b60428201528451613e72816044840160208901613259565b73113e9610113232b9b1b934b83a34b7b7111d101160611b60449290910191820152613eb2613ea46058830186613d8e565b61227d60f01b815260020190565b98975050505050505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c000000815260008251613ef681601d850160208701613259565b91909101601d0192915050565b6020808252602e908201527f455243313135353a2063616c6c6572206973206e6f7420746f6b656e206f776e60408201526d195c881bdc88185c1c1c9bdd995960921b606082015260800190565b601f821115613f9757600081815260208120601f850160051c81016020861015613f785750805b601f850160051c820191505b81811015611ad457828155600101613f84565b505050565b600019600383901b1c191660019190911b1790565b6001600160401b03831115613fc857613fc861344a565b613fdc83613fd68354613d43565b83613f51565b6000601f84116001811461400a5760008515613ff85750838201355b6140028682613f9c565b845550611584565b600083815260209020601f19861690835b8281101561403b578685013582556020948501946001909201910161401b565b50868210156140585760001960f88860031b161c19848701351681555b505060018560011b0183555050505050565b81516001600160401b038111156140835761408361344a565b614097816140918454613d43565b84613f51565b602080601f8311600181146140c657600084156140b45750858301515b6140be8582613f9c565b865550611ad4565b600085815260208120601f198616915b828110156140f5578886015182559484019460019091019084016140d6565b50858210156141135787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b6040815260006141366040830185613285565b82810360208401526141488185613285565b95945050505050565b60006020828403121561416357600080fd5b5051919050565b60008261418757634e487b7160e01b600052601260045260246000fd5b500490565b60008160001904831182151516156141a6576141a6613cfc565b500290565b60208082526025908201527f455243313135353a207472616e7366657220746f20746865207a65726f206164604082015264647265737360d81b606082015260800190565b6020808252602a908201527f455243313135353a20696e73756666696369656e742062616c616e636520666f60408201526939103a3930b739b332b960b11b606082015260800190565b60408152600061424d604083018561384f565b8281036020840152614148818561384f565b6020808252602b908201527f496e697469616c697a61626c653a20636f6e7472616374206973206e6f74206960408201526a6e697469616c697a696e6760a81b606082015260800190565b6001600160a01b03868116825285166020820152604081018490526060810183905260a0608082018190526000906142e490830184613285565b979650505050505050565b60006020828403121561430157600080fd5b81516132528161321f565b600060033d11156143255760046000803e5060005160e01c5b90565b600060443d10156143365790565b6040516003193d81016004833e81513d6001600160401b03816024840111818411171561436557505050505090565b828501915081518181111561437d5750505050505090565b843d87010160208285010111156143975750505050505090565b6143a660208286010187613460565b509095945050505050565b60208082526028908201527f455243313135353a204552433131353552656365697665722072656a656374656040820152676420746f6b656e7360c01b606082015260800190565b6001600160a01b0386811682528516602082015260a0604082018190526000906144259083018661384f565b8281036060840152614437818661384f565b90508281036080840152613eb2818561328556fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa26469706673582212209136e424bbf4f8965f62c0972a1ba31bb1d945f2ea717381832a54080311a42864736f6c634300080f0033
Loading...
Loading
Loading...
Loading
Loading...
Loading
Loading...
Loading
Loading...
Loading
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.