Contract Overview
[ Download CSV Export ]
Latest 1 internal transaction
Parent Txn Hash | Block | From | To | Value | |||
---|---|---|---|---|---|---|---|
0x50c3dd7d0187e7af13cccacd1ca4c9e84e10270af5685fa92a021a359b93cdd8 | 53216273 | 84 days 14 hrs ago | Beethoven X: Deployer | Contract Creation | 0 FTM |
[ Download CSV Export ]
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
Reliquary
Compiler Version
v0.8.17+commit.8df45f5f
Optimization Enabled:
Yes with 200 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.15; import "./ReliquaryEvents.sol"; import "./interfaces/IReliquary.sol"; import "./interfaces/IEmissionCurve.sol"; import "./interfaces/IRewarder.sol"; import "./interfaces/INFTDescriptor.sol"; import "openzeppelin-contracts/contracts/token/ERC20/utils/SafeERC20.sol"; import "openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Burnable.sol"; import "openzeppelin-contracts/contracts/token/ERC721/extensions/ERC721Enumerable.sol"; import "openzeppelin-contracts/contracts/utils/Multicall.sol"; import "openzeppelin-contracts/contracts/access/AccessControlEnumerable.sol"; import "openzeppelin-contracts/contracts/security/ReentrancyGuard.sol"; /** * @title Reliquary * @author Justin Bebis, Zokunei & the Byte Masons team * * @notice This system is designed to manage incentives for deposited assets such that * behaviors can be programmed on a per-pool basis using maturity levels. Stake in a * pool, also referred to as "position," is represented by means of an NFT called a * "Relic." Each position has a "maturity" which captures the age of the position. * * @notice Deposits are tracked by Relic ID instead of by user. This allows for * increased composability without affecting accounting logic too much, and users can * trade their Relics without withdrawing liquidity or affecting the position's maturity. */ contract Reliquary is IReliquary, ERC721Burnable, ERC721Enumerable, AccessControlEnumerable, Multicall, ReentrancyGuard { using SafeERC20 for IERC20; /// @dev Access control roles. bytes32 private constant OPERATOR = keccak256("OPERATOR"); bytes32 private constant EMISSION_CURVE = keccak256("EMISSION_CURVE"); /// @dev Indicates whether tokens are being added to, or removed from, a pool. enum Kind { DEPOSIT, WITHDRAW, OTHER } /// @dev Level of precision rewards are calculated to. uint private constant ACC_REWARD_PRECISION = 1e12; /// @dev Nonce to use for new relicId. uint private idNonce; /// @notice Address of the reward token contract. address public immutable rewardToken; /// @notice Address of each NFTDescriptor contract. address[] public nftDescriptor; /// @notice Address of EmissionCurve contract. address public emissionCurve; /// @notice Info of each Reliquary pool. PoolInfo[] private poolInfo; /// @notice Level system for each Reliquary pool. LevelInfo[] private levels; /// @notice Address of the LP token for each Reliquary pool. address[] public poolToken; /// @notice Address of IRewarder contract for each Reliquary pool. address[] public rewarder; /// @notice Info of each staked position. mapping(uint => PositionInfo) internal positionForId; /// @dev Total allocation points. Must be the sum of all allocation points in all pools. uint public totalAllocPoint; error NonExistentRelic(); error BurningPrincipal(); error BurningRewards(); error RewardTokenAsPoolToken(); error EmptyArray(); error ArrayLengthMismatch(); error NonZeroFirstMaturity(); error UnsortedMaturityLevels(); error ZeroTotalAllocPoint(); error NonExistentPool(); error ZeroAmount(); error NotOwner(); error DuplicateRelicIds(); error RelicsNotOfSamePool(); error MergingEmptyRelics(); error MaxEmissionRateExceeded(); error NotApprovedOrOwner(); /** * @dev Constructs and initializes the contract. * @param _rewardToken The reward token contract address. * @param _emissionCurve The contract address for the EmissionCurve, which will return the emission rate. */ constructor(address _rewardToken, address _emissionCurve) ERC721("Reliquary Deposit", "RELIC") { rewardToken = _rewardToken; emissionCurve = _emissionCurve; _grantRole(DEFAULT_ADMIN_ROLE, msg.sender); } /// @notice Sets a new EmissionCurve for overall rewardToken emissions. Can only be called with the proper role. /// @param _emissionCurve The contract address for the EmissionCurve, which will return the base emission rate. function setEmissionCurve(address _emissionCurve) external override onlyRole(EMISSION_CURVE) { emissionCurve = _emissionCurve; emit ReliquaryEvents.LogSetEmissionCurve(_emissionCurve); } /** * @notice Add a new pool for the specified LP. Can only be called by an operator. * @param allocPoint The allocation points for the new pool. * @param _poolToken Address of the pooled ERC-20 token. * @param _rewarder Address of the rewarder delegate. * @param requiredMaturities Array of maturity (in seconds) required to achieve each level for this pool. * @param levelMultipliers The multipliers applied to the amount of `_poolToken` for each level within this pool. * @param name Name of pool to be displayed in NFT image. * @param _nftDescriptor The contract address for NFTDescriptor, which will return the token URI. */ function addPool( uint allocPoint, address _poolToken, address _rewarder, uint[] calldata requiredMaturities, uint[] calldata levelMultipliers, string memory name, address _nftDescriptor ) external override onlyRole(OPERATOR) { if (_poolToken == rewardToken) revert RewardTokenAsPoolToken(); if (requiredMaturities.length == 0) revert EmptyArray(); if (requiredMaturities.length != levelMultipliers.length) revert ArrayLengthMismatch(); if (requiredMaturities[0] != 0) revert NonZeroFirstMaturity(); if (requiredMaturities.length > 1) { uint highestMaturity; for (uint i = 1; i < requiredMaturities.length;) { if (requiredMaturities[i] <= highestMaturity) revert UnsortedMaturityLevels(); highestMaturity = requiredMaturities[i]; unchecked { ++i; } } } uint length = poolLength(); for (uint i; i < length;) { _updatePool(i); unchecked { ++i; } } uint totalAlloc = totalAllocPoint + allocPoint; if (totalAlloc == 0) revert ZeroTotalAllocPoint(); totalAllocPoint = totalAlloc; poolToken.push(_poolToken); rewarder.push(_rewarder); nftDescriptor.push(_nftDescriptor); poolInfo.push( PoolInfo({allocPoint: allocPoint, lastRewardTime: block.timestamp, accRewardPerShare: 0, name: name}) ); levels.push( LevelInfo({ requiredMaturities: requiredMaturities, multipliers: levelMultipliers, balance: new uint[](levelMultipliers.length) }) ); emit ReliquaryEvents.LogPoolAddition((poolToken.length - 1), allocPoint, _poolToken, _rewarder, _nftDescriptor); } /** * @notice Modify the given pool's properties. Can only be called by an operator. * @param pid The index of the pool. See poolInfo. * @param allocPoint New AP of the pool. * @param _rewarder Address of the rewarder delegate. * @param name Name of pool to be displayed in NFT image. * @param _nftDescriptor The contract address for NFTDescriptor, which will return the token URI. * @param overwriteRewarder True if _rewarder should be set. Otherwise _rewarder is ignored. */ function modifyPool( uint pid, uint allocPoint, address _rewarder, string calldata name, address _nftDescriptor, bool overwriteRewarder ) external override onlyRole(OPERATOR) { if (pid >= poolInfo.length) revert NonExistentPool(); uint length = poolLength(); for (uint i; i < length;) { _updatePool(i); unchecked { ++i; } } PoolInfo storage pool = poolInfo[pid]; uint totalAlloc = totalAllocPoint + allocPoint - pool.allocPoint; if (totalAlloc == 0) revert ZeroTotalAllocPoint(); totalAllocPoint = totalAlloc; pool.allocPoint = allocPoint; if (overwriteRewarder) { rewarder[pid] = _rewarder; } pool.name = name; nftDescriptor[pid] = _nftDescriptor; emit ReliquaryEvents.LogPoolModified( pid, allocPoint, overwriteRewarder ? _rewarder : rewarder[pid], _nftDescriptor ); } /// @notice Update reward variables for all pools. Be careful of gas spending! /// @param pids Pool IDs of all to be updated. Make sure to update all active pools. function massUpdatePools(uint[] calldata pids) external override nonReentrant { for (uint i; i < pids.length;) { _updatePool(pids[i]); unchecked { ++i; } } } /// @notice Update reward variables of the given pool. /// @param pid The index of the pool. See poolInfo. function updatePool(uint pid) external override nonReentrant { _updatePool(pid); } /** * @notice Deposit pool tokens to Reliquary for reward token allocation. * @param amount Token amount to deposit. * @param relicId NFT ID of the position being deposited to. */ function deposit(uint amount, uint relicId) external override nonReentrant { _requireApprovedOrOwner(relicId); _deposit(amount, relicId); } /** * @notice Withdraw pool tokens. * @param amount token amount to withdraw. * @param relicId NFT ID of the position being withdrawn. */ function withdraw(uint amount, uint relicId) external override nonReentrant { if (amount == 0) revert ZeroAmount(); _requireApprovedOrOwner(relicId); (uint poolId,) = _updatePosition(amount, relicId, Kind.WITHDRAW, address(0)); IERC20(poolToken[poolId]).safeTransfer(msg.sender, amount); emit ReliquaryEvents.Withdraw(poolId, amount, msg.sender, relicId); } /** * @notice Harvest proceeds for transaction sender to owner of Relic `relicId`. * @param relicId NFT ID of the position being harvested. * @param harvestTo Address to send rewards to (zero address if harvest should not be performed). */ function harvest(uint relicId, address harvestTo) external override nonReentrant { _requireApprovedOrOwner(relicId); (uint poolId, uint _pendingReward) = _updatePosition(0, relicId, Kind.OTHER, harvestTo); emit ReliquaryEvents.Harvest(poolId, _pendingReward, harvestTo, relicId); } /** * @notice Withdraw pool tokens and harvest proceeds for transaction sender to owner of Relic `relicId`. * @param amount token amount to withdraw. * @param relicId NFT ID of the position being withdrawn and harvested. * @param harvestTo Address to send rewards to (zero address if harvest should not be performed). */ function withdrawAndHarvest(uint amount, uint relicId, address harvestTo) external override nonReentrant { if (amount == 0) revert ZeroAmount(); _requireApprovedOrOwner(relicId); (uint poolId, uint _pendingReward) = _updatePosition(amount, relicId, Kind.WITHDRAW, harvestTo); IERC20(poolToken[poolId]).safeTransfer(msg.sender, amount); emit ReliquaryEvents.Withdraw(poolId, amount, msg.sender, relicId); emit ReliquaryEvents.Harvest(poolId, _pendingReward, harvestTo, relicId); } /** * @notice Withdraw without caring about rewards. EMERGENCY ONLY. * @param relicId NFT ID of the position to emergency withdraw from and burn. */ function emergencyWithdraw(uint relicId) external override nonReentrant { address to = ownerOf(relicId); if (to != msg.sender) revert NotOwner(); PositionInfo storage position = positionForId[relicId]; uint amount = position.amount; uint poolId = position.poolId; levels[poolId].balance[position.level] -= amount; _burn(relicId); delete positionForId[relicId]; IERC20(poolToken[poolId]).safeTransfer(to, amount); emit ReliquaryEvents.EmergencyWithdraw(poolId, amount, to, relicId); } /// @notice Update position without performing a deposit/withdraw/harvest. /// @param relicId The NFT ID of the position being updated. function updatePosition(uint relicId) external override nonReentrant { if (!_exists(relicId)) revert NonExistentRelic(); _updatePosition(0, relicId, Kind.OTHER, address(0)); } /// @notice Returns a PositionInfo object for the given relicId. function getPositionForId(uint relicId) external view override returns (PositionInfo memory position) { position = positionForId[relicId]; } /// @notice Returns a PoolInfo object for pool ID `pid`. function getPoolInfo(uint pid) external view override returns (PoolInfo memory pool) { pool = poolInfo[pid]; } /// @notice Returns a LevelInfo object for pool ID `pid`. function getLevelInfo(uint pid) external view override returns (LevelInfo memory levelInfo) { levelInfo = levels[pid]; } /** * @notice View function to retrieve the relicIds, poolIds, and pendingReward for each Relic owned by an address. * @param owner Address of the owner to retrieve info for. * @return pendingRewards Array of PendingReward objects. */ function pendingRewardsOfOwner(address owner) external view override returns (PendingReward[] memory pendingRewards) { uint balance = balanceOf(owner); pendingRewards = new PendingReward[](balance); for (uint i; i < balance;) { uint relicId = tokenOfOwnerByIndex(owner, i); pendingRewards[i] = PendingReward({ relicId: relicId, poolId: positionForId[relicId].poolId, pendingReward: pendingReward(relicId) }); unchecked { ++i; } } } /** * @notice View function to retrieve owned positions for an address. * @param owner Address of the owner to retrieve info for. * @return relicIds Each relicId owned by the given address. * @return positionInfos The PositionInfo object for each relicId. */ function relicPositionsOfOwner(address owner) external view override returns (uint[] memory relicIds, PositionInfo[] memory positionInfos) { uint balance = balanceOf(owner); relicIds = new uint[](balance); positionInfos = new PositionInfo[](balance); for (uint i; i < balance;) { relicIds[i] = tokenOfOwnerByIndex(owner, i); positionInfos[i] = positionForId[relicIds[i]]; unchecked { ++i; } } } /// @notice Returns whether `spender` is allowed to manage Relic `relicId`. function isApprovedOrOwner(address spender, uint relicId) external view override returns (bool) { return _isApprovedOrOwner(spender, relicId); } /** * @notice Create a new Relic NFT and deposit into this position. * @param to Address to mint the Relic to. * @param pid The index of the pool. See poolInfo. * @param amount Token amount to deposit. */ function createRelicAndDeposit(address to, uint pid, uint amount) public virtual override nonReentrant returns (uint id) { if (pid >= poolInfo.length) revert NonExistentPool(); id = _mint(to); PositionInfo storage position = positionForId[id]; position.poolId = pid; _deposit(amount, id); emit ReliquaryEvents.CreateRelic(pid, to, id); } /** * @notice Split an owned Relic into a new one, while maintaining maturity. * @param fromId The NFT ID of the Relic to split from. * @param amount Amount to move from existing Relic into the new one. * @param to Address to mint the Relic to. * @return newId The NFT ID of the new Relic. */ function split(uint fromId, uint amount, address to) public virtual override nonReentrant returns (uint newId) { if (amount == 0) revert ZeroAmount(); _requireApprovedOrOwner(fromId); PositionInfo storage fromPosition = positionForId[fromId]; uint fromAmount = fromPosition.amount; uint newFromAmount = fromAmount - amount; fromPosition.amount = newFromAmount; newId = _mint(to); PositionInfo storage newPosition = positionForId[newId]; newPosition.amount = amount; newPosition.entry = fromPosition.entry; uint level = fromPosition.level; newPosition.level = level; uint poolId = fromPosition.poolId; newPosition.poolId = poolId; uint multiplier = _updatePool(poolId) * levels[poolId].multipliers[level]; uint pendingFrom = fromAmount * multiplier / ACC_REWARD_PRECISION - fromPosition.rewardDebt; if (pendingFrom != 0) { fromPosition.rewardCredit += pendingFrom; } fromPosition.rewardDebt = newFromAmount * multiplier / ACC_REWARD_PRECISION; newPosition.rewardDebt = amount * multiplier / ACC_REWARD_PRECISION; emit ReliquaryEvents.CreateRelic(poolId, to, newId); emit ReliquaryEvents.Split(fromId, newId, amount); } /** * @notice Transfer amount from one Relic into another, updating maturity in the receiving Relic. * @param fromId The NFT ID of the Relic to transfer from. * @param toId The NFT ID of the Relic being transferred to. * @param amount The amount being transferred. */ function shift(uint fromId, uint toId, uint amount) public virtual override nonReentrant { if (amount == 0) revert ZeroAmount(); if (fromId == toId) revert DuplicateRelicIds(); _requireApprovedOrOwner(fromId); _requireApprovedOrOwner(toId); PositionInfo storage fromPosition = positionForId[fromId]; uint fromAmount = fromPosition.amount; uint poolId = fromPosition.poolId; PositionInfo storage toPosition = positionForId[toId]; if (poolId != toPosition.poolId) revert RelicsNotOfSamePool(); uint toAmount = toPosition.amount; toPosition.entry = (fromAmount * fromPosition.entry + toAmount * toPosition.entry) / (fromAmount + toAmount); uint newFromAmount = fromAmount - amount; fromPosition.amount = newFromAmount; uint newToAmount = toAmount + amount; toPosition.amount = newToAmount; (uint fromLevel, uint oldToLevel, uint newToLevel) = _shiftLevelBalances(fromId, toId, poolId, amount, toAmount, newToAmount); uint accRewardPerShare = _updatePool(poolId); uint fromMultiplier = accRewardPerShare * levels[poolId].multipliers[fromLevel]; uint pendingFrom = fromAmount * fromMultiplier / ACC_REWARD_PRECISION - fromPosition.rewardDebt; if (pendingFrom != 0) { fromPosition.rewardCredit += pendingFrom; } uint pendingTo = toAmount * levels[poolId].multipliers[oldToLevel] * accRewardPerShare / ACC_REWARD_PRECISION - toPosition.rewardDebt; if (pendingTo != 0) { toPosition.rewardCredit += pendingTo; } fromPosition.rewardDebt = newFromAmount * fromMultiplier / ACC_REWARD_PRECISION; toPosition.rewardDebt = newToAmount * accRewardPerShare * levels[poolId].multipliers[newToLevel] / ACC_REWARD_PRECISION; emit ReliquaryEvents.Shift(fromId, toId, amount); } /** * @notice Transfer entire position (including rewards) from one Relic into another, burning it * and updating maturity in the receiving Relic. * @param fromId The NFT ID of the Relic to transfer from. * @param toId The NFT ID of the Relic being transferred to. */ function merge(uint fromId, uint toId) public virtual override nonReentrant { if (fromId == toId) revert DuplicateRelicIds(); _requireApprovedOrOwner(fromId); _requireApprovedOrOwner(toId); PositionInfo storage fromPosition = positionForId[fromId]; uint fromAmount = fromPosition.amount; uint poolId = fromPosition.poolId; PositionInfo storage toPosition = positionForId[toId]; if (poolId != toPosition.poolId) revert RelicsNotOfSamePool(); uint toAmount = toPosition.amount; uint newToAmount = toAmount + fromAmount; if (newToAmount == 0) revert MergingEmptyRelics(); toPosition.entry = (fromAmount * fromPosition.entry + toAmount * toPosition.entry) / newToAmount; toPosition.amount = newToAmount; (uint fromLevel, uint oldToLevel, uint newToLevel) = _shiftLevelBalances(fromId, toId, poolId, fromAmount, toAmount, newToAmount); uint accRewardPerShare = _updatePool(poolId); uint pendingTo = accRewardPerShare * (fromAmount * levels[poolId].multipliers[fromLevel] + toAmount * levels[poolId].multipliers[oldToLevel]) / ACC_REWARD_PRECISION + fromPosition.rewardCredit - fromPosition.rewardDebt - toPosition.rewardDebt; if (pendingTo != 0) { toPosition.rewardCredit += pendingTo; } toPosition.rewardDebt = newToAmount * accRewardPerShare * levels[poolId].multipliers[newToLevel] / ACC_REWARD_PRECISION; _burn(fromId); delete positionForId[fromId]; emit ReliquaryEvents.Merge(fromId, toId, fromAmount); } /// @notice Burns the Relic with ID `tokenId`. Cannot be called if there is any principal or rewards in the Relic. function burn(uint tokenId) public virtual override (IReliquary, ERC721Burnable) { if (positionForId[tokenId].amount != 0) revert BurningPrincipal(); if (pendingReward(tokenId) != 0) revert BurningRewards(); super.burn(tokenId); } /** * @notice View function to see pending reward tokens on frontend. * @param relicId ID of the position. * @return pending reward amount for a given position owner. */ function pendingReward(uint relicId) public view override returns (uint pending) { PositionInfo storage position = positionForId[relicId]; uint poolId = position.poolId; PoolInfo storage pool = poolInfo[poolId]; uint accRewardPerShare = pool.accRewardPerShare; uint lpSupply = _poolBalance(position.poolId); uint lastRewardTime = pool.lastRewardTime; uint secondsSinceReward = block.timestamp - lastRewardTime; if (secondsSinceReward != 0 && lpSupply != 0) { uint reward = secondsSinceReward * _baseEmissionsPerSecond(lastRewardTime) * pool.allocPoint / totalAllocPoint; accRewardPerShare += reward * ACC_REWARD_PRECISION / lpSupply; } uint leveledAmount = position.amount * levels[poolId].multipliers[position.level]; pending = leveledAmount * accRewardPerShare / ACC_REWARD_PRECISION + position.rewardCredit - position.rewardDebt; } /** * @notice View function to see level of position if it were to be updated. * @param relicId ID of the position. * @return level Level for given position upon update. */ function levelOnUpdate(uint relicId) public view override returns (uint level) { PositionInfo storage position = positionForId[relicId]; LevelInfo storage levelInfo = levels[position.poolId]; uint length = levelInfo.requiredMaturities.length; if (length == 1) { return 0; } uint maturity = block.timestamp - position.entry; for (level = length - 1; true;) { if (maturity >= levelInfo.requiredMaturities[level]) { break; } unchecked { --level; } } } /// @notice Returns the number of Reliquary pools. function poolLength() public view override returns (uint pools) { pools = poolInfo.length; } /** * @notice Returns the ERC721 tokenURI given by the pool's NFTDescriptor. * @dev Can be gas expensive if used in a transaction and the NFTDescriptor is complex. * @param tokenId The NFT ID of the Relic to get the tokenURI for. */ function tokenURI(uint tokenId) public view override (ERC721) returns (string memory) { if (!_exists(tokenId)) revert NonExistentRelic(); return INFTDescriptor(nftDescriptor[positionForId[tokenId].poolId]).constructTokenURI(tokenId); } /// @dev Implement ERC165 to return which interfaces this contract conforms to function supportsInterface(bytes4 interfaceId) public view virtual override (IERC165, AccessControlEnumerable, ERC721, ERC721Enumerable) returns (bool) { return interfaceId == type(IReliquary).interfaceId || super.supportsInterface(interfaceId); } /// @dev Internal _updatePool function without nonReentrant modifier. function _updatePool(uint pid) internal returns (uint accRewardPerShare) { if (pid >= poolLength()) revert NonExistentPool(); PoolInfo storage pool = poolInfo[pid]; uint timestamp = block.timestamp; uint lastRewardTime = pool.lastRewardTime; uint secondsSinceReward = timestamp - lastRewardTime; accRewardPerShare = pool.accRewardPerShare; if (secondsSinceReward != 0) { uint lpSupply = _poolBalance(pid); if (lpSupply != 0) { uint reward = secondsSinceReward * _baseEmissionsPerSecond(lastRewardTime) * pool.allocPoint / totalAllocPoint; accRewardPerShare += reward * ACC_REWARD_PRECISION / lpSupply; pool.accRewardPerShare = accRewardPerShare; } pool.lastRewardTime = timestamp; emit ReliquaryEvents.LogUpdatePool(pid, timestamp, lpSupply, accRewardPerShare); } } /// @dev Internal deposit function that assumes relicId is valid. function _deposit(uint amount, uint relicId) internal { if (amount == 0) revert ZeroAmount(); (uint poolId,) = _updatePosition(amount, relicId, Kind.DEPOSIT, address(0)); IERC20(poolToken[poolId]).safeTransferFrom(msg.sender, address(this), amount); emit ReliquaryEvents.Deposit(poolId, amount, ownerOf(relicId), relicId); } /** * @dev Internal function called whenever a position's state needs to be modified. * @param amount Amount of poolToken to deposit/withdraw. * @param relicId The NFT ID of the position being updated. * @param kind Indicates whether tokens are being added to, or removed from, a pool. * @param harvestTo Address to send rewards to (zero address if harvest should not be performed). * @return poolId Pool ID of the given position. * @return _pendingReward Pending reward for given position owner. */ function _updatePosition(uint amount, uint relicId, Kind kind, address harvestTo) internal returns (uint poolId, uint _pendingReward) { PositionInfo storage position = positionForId[relicId]; poolId = position.poolId; uint accRewardPerShare = _updatePool(poolId); uint oldAmount = position.amount; uint newAmount; if (kind == Kind.DEPOSIT) { _updateEntry(amount, relicId); newAmount = oldAmount + amount; position.amount = newAmount; } else if (kind == Kind.WITHDRAW) { newAmount = oldAmount - amount; position.amount = newAmount; } else { newAmount = oldAmount; } uint oldLevel = position.level; uint newLevel = _updateLevel(relicId); if (oldLevel != newLevel) { levels[poolId].balance[oldLevel] -= oldAmount; levels[poolId].balance[newLevel] += newAmount; } else if (kind == Kind.DEPOSIT) { levels[poolId].balance[oldLevel] += amount; } else if (kind == Kind.WITHDRAW) { levels[poolId].balance[oldLevel] -= amount; } _pendingReward = oldAmount * levels[poolId].multipliers[oldLevel] * accRewardPerShare / ACC_REWARD_PRECISION - position.rewardDebt; position.rewardDebt = newAmount * levels[poolId].multipliers[newLevel] * accRewardPerShare / ACC_REWARD_PRECISION; bool _harvest = harvestTo != address(0); if (!_harvest && _pendingReward != 0) { position.rewardCredit += _pendingReward; } else if (_harvest) { uint total = _pendingReward + position.rewardCredit; uint received = _receivedReward(total); position.rewardCredit = total - received; if (received != 0) { IERC20(rewardToken).safeTransfer(harvestTo, received); address _rewarder = rewarder[poolId]; if (_rewarder != address(0)) { IRewarder(_rewarder).onReward(relicId, received, harvestTo); } } } if (kind == Kind.DEPOSIT) { address _rewarder = rewarder[poolId]; if (_rewarder != address(0)) { IRewarder(_rewarder).onDeposit(relicId, amount); } } else if (kind == Kind.WITHDRAW) { address _rewarder = rewarder[poolId]; if (_rewarder != address(0)) { IRewarder(_rewarder).onWithdraw(relicId, amount); } } } /** * @notice Updates the user's entry time based on the weight of their deposit or withdrawal. * @param amount The amount of the deposit / withdrawal. * @param relicId The NFT ID of the position being updated. */ function _updateEntry(uint amount, uint relicId) internal { PositionInfo storage position = positionForId[relicId]; uint weight = _findWeight(amount, position.amount); uint maturity = block.timestamp - position.entry; position.entry += maturity * weight / 1e18; } /** * @notice Updates the position's level based on entry time. * @param relicId The NFT ID of the position being updated. * @return newLevel Level of position after update. */ function _updateLevel(uint relicId) internal returns (uint newLevel) { newLevel = levelOnUpdate(relicId); PositionInfo storage position = positionForId[relicId]; if (position.level != newLevel) { position.level = newLevel; emit ReliquaryEvents.LevelChanged(relicId, newLevel); } } /// @dev Ensure the behavior of ERC721Enumerable _beforeTokenTransfer is preserved. function _beforeTokenTransfer(address from, address to, uint tokenId) internal override (ERC721, ERC721Enumerable) { ERC721Enumerable._beforeTokenTransfer(from, to, tokenId); } /** * @notice Calculate how much the owner will actually receive on harvest, given available reward tokens. * @param _pendingReward Amount of reward token owed. * @return received The minimum between amount owed and amount available. */ function _receivedReward(uint _pendingReward) internal view returns (uint received) { uint available = IERC20(rewardToken).balanceOf(address(this)); received = (available > _pendingReward) ? _pendingReward : available; } /// @notice Gets the base emission rate from external, upgradable contract. function _baseEmissionsPerSecond(uint lastRewardTime) internal view returns (uint rate) { rate = IEmissionCurve(emissionCurve).getRate(lastRewardTime); if (rate > 6e18) revert MaxEmissionRateExceeded(); } /** * @notice returns The total deposits of the pool's token, weighted by maturity level allocation. * @param pid The index of the pool. See poolInfo. * @return total The amount of pool tokens held by the contract. */ function _poolBalance(uint pid) internal view returns (uint total) { LevelInfo storage levelInfo = levels[pid]; uint length = levelInfo.balance.length; for (uint i; i < length;) { total += levelInfo.balance[i] * levelInfo.multipliers[i]; unchecked { ++i; } } } /// @notice Require the sender is either the owner of the Relic or approved to transfer it. /// @param relicId The NFT ID of the Relic. function _requireApprovedOrOwner(uint relicId) internal view { if (!_isApprovedOrOwner(msg.sender, relicId)) revert NotApprovedOrOwner(); } /** * @notice Utility function to find weights without any underflows or zero division problems. * @param addedValue New value being added. * @param oldValue Current amount of x. */ function _findWeight(uint addedValue, uint oldValue) internal pure returns (uint weightNew) { if (oldValue == 0) { weightNew = 1e18; } else { if (oldValue < addedValue) { uint weightOld = oldValue * 1e18 / (addedValue + oldValue); weightNew = 1e18 - weightOld; } else if (addedValue < oldValue) { weightNew = addedValue * 1e18 / (addedValue + oldValue); } else { weightNew = 1e18 / 2; } } } /// @dev Handle updating balances for each affected tranche when shifting and merging. function _shiftLevelBalances(uint fromId, uint toId, uint poolId, uint amount, uint toAmount, uint newToAmount) private returns (uint fromLevel, uint oldToLevel, uint newToLevel) { fromLevel = positionForId[fromId].level; oldToLevel = positionForId[toId].level; newToLevel = _updateLevel(toId); if (fromLevel != newToLevel) { levels[poolId].balance[fromLevel] -= amount; } if (oldToLevel != newToLevel) { levels[poolId].balance[oldToLevel] -= toAmount; } if (fromLevel != newToLevel && oldToLevel != newToLevel) { levels[poolId].balance[newToLevel] += newToAmount; } else if (fromLevel != newToLevel) { levels[poolId].balance[newToLevel] += amount; } else if (oldToLevel != newToLevel) { levels[poolId].balance[newToLevel] += toAmount; } } /// @dev Increments the ID nonce and mints a new Relic to `to`. function _mint(address to) private returns (uint id) { id = ++idNonce; _safeMint(to, id); } }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.17; library ReliquaryEvents { event CreateRelic(uint indexed pid, address indexed to, uint indexed relicId); event Deposit(uint indexed pid, uint amount, address indexed to, uint indexed relicId); event Withdraw(uint indexed pid, uint amount, address indexed to, uint indexed relicId); event EmergencyWithdraw(uint indexed pid, uint amount, address indexed to, uint indexed relicId); event Harvest(uint indexed pid, uint amount, address indexed to, uint indexed relicId); event LogPoolAddition( uint indexed pid, uint allocPoint, address indexed poolToken, address indexed rewarder, address nftDescriptor ); event LogPoolModified(uint indexed pid, uint allocPoint, address indexed rewarder, address nftDescriptor); event LogUpdatePool(uint indexed pid, uint lastRewardTime, uint lpSupply, uint accRewardPerShare); event LogSetEmissionCurve(address indexed emissionCurveAddress); event LevelChanged(uint indexed relicId, uint newLevel); event Split(uint indexed fromId, uint indexed toId, uint amount); event Shift(uint indexed fromId, uint indexed toId, uint amount); event Merge(uint indexed fromId, uint indexed toId, uint amount); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.15; import "openzeppelin-contracts/contracts/token/ERC721/extensions/IERC721Enumerable.sol"; /** * @notice Info for each Reliquary position. * `amount` LP token amount the position owner has provided. * `rewardDebt` Amount of reward token accumalated before the position's entry or last harvest. * `rewardCredit` Amount of reward token owed to the user on next harvest. * `entry` Used to determine the maturity of the position. * `poolId` ID of the pool to which this position belongs. * `level` Index of this position's level within the pool's array of levels. */ struct PositionInfo { uint amount; uint rewardDebt; uint rewardCredit; uint entry; // position owner's relative entry into the pool. uint poolId; // ensures that a single Relic is only used for one pool. uint level; } /** * @notice Info of each Reliquary pool. * `accRewardPerShare` Accumulated reward tokens per share of pool (1 / 1e12). * `lastRewardTime` Last timestamp the accumulated reward was updated. * `allocPoint` Pool's individual allocation - ratio of the total allocation. * `name` Name of pool to be displayed in NFT image. */ struct PoolInfo { uint accRewardPerShare; uint lastRewardTime; uint allocPoint; string name; } /** * @notice Info for each level in a pool that determines how maturity is rewarded. * `requiredMaturities` The minimum maturity (in seconds) required to reach each Level. * `multipliers` Multiplier for each level applied to amount of incentivized token when calculating rewards in the pool. * This is applied to both the numerator and denominator in the calculation such that the size of a user's position * is effectively considered to be the actual number of tokens times the multiplier for their level. * Also note that these multipliers do not affect the overall emission rate. * `balance` Total (actual) number of tokens deposited in positions at each level. */ struct LevelInfo { uint[] requiredMaturities; uint[] multipliers; uint[] balance; } /** * @notice Object representing pending rewards and related data for a position. * `relicId` The NFT ID of the given position. * `poolId` ID of the pool to which this position belongs. * `pendingReward` pending reward amount for a given position. */ struct PendingReward { uint relicId; uint poolId; uint pendingReward; } interface IReliquary is IERC721Enumerable { function setEmissionCurve(address _emissionCurve) external; function addPool( uint allocPoint, address _poolToken, address _rewarder, uint[] calldata requiredMaturity, uint[] calldata allocPoints, string memory name, address _nftDescriptor ) external; function modifyPool( uint pid, uint allocPoint, address _rewarder, string calldata name, address _nftDescriptor, bool overwriteRewarder ) external; function massUpdatePools(uint[] calldata pids) external; function updatePool(uint pid) external; function deposit(uint amount, uint relicId) external; function withdraw(uint amount, uint relicId) external; function harvest(uint relicId, address harvestTo) external; function withdrawAndHarvest(uint amount, uint relicId, address harvestTo) external; function emergencyWithdraw(uint relicId) external; function updatePosition(uint relicId) external; function getPositionForId(uint) external view returns (PositionInfo memory); function getPoolInfo(uint) external view returns (PoolInfo memory); function getLevelInfo(uint) external view returns (LevelInfo memory); function pendingRewardsOfOwner(address owner) external view returns (PendingReward[] memory pendingRewards); function relicPositionsOfOwner(address owner) external view returns (uint[] memory relicIds, PositionInfo[] memory positionInfos); function isApprovedOrOwner(address, uint) external view returns (bool); function createRelicAndDeposit(address to, uint pid, uint amount) external returns (uint id); function split(uint relicId, uint amount, address to) external returns (uint newId); function shift(uint fromId, uint toId, uint amount) external; function merge(uint fromId, uint toId) external; function burn(uint tokenId) external; function pendingReward(uint relicId) external view returns (uint pending); function levelOnUpdate(uint relicId) external view returns (uint level); function poolLength() external view returns (uint); function rewardToken() external view returns (address); function nftDescriptor(uint) external view returns (address); function emissionCurve() external view returns (address); function poolToken(uint) external view returns (address); function rewarder(uint) external view returns (address); function totalAllocPoint() external view returns (uint); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.15; interface IEmissionCurve { function getRate(uint lastRewardTime) external view returns (uint rate); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.15; interface IRewarder { function onReward(uint relicId, uint rewardAmount, address to) external; function onDeposit(uint relicId, uint depositAmount) external; function onWithdraw(uint relicId, uint withdrawalAmount) external; function pendingTokens(uint relicId, uint rewardAmount) external view returns (address[] memory, uint[] memory); }
// SPDX-License-Identifier: MIT pragma solidity ^0.8.15; interface INFTDescriptor { function constructTokenURI(uint relicId) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC20/utils/SafeERC20.sol) pragma solidity ^0.8.0; import "../IERC20.sol"; import "../extensions/draft-IERC20Permit.sol"; import "../../../utils/Address.sol"; /** * @title SafeERC20 * @dev Wrappers around ERC20 operations that throw on failure (when the token * contract returns false). Tokens that return no value (and instead revert or * throw on failure) are also supported, non-reverting calls are assumed to be * successful. * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract, * which allows you to call the safe operations as `token.safeTransfer(...)`, etc. */ library SafeERC20 { using Address for address; function safeTransfer( IERC20 token, address to, uint256 value ) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value)); } function safeTransferFrom( IERC20 token, address from, address to, uint256 value ) internal { _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value)); } /** * @dev Deprecated. This function has issues similar to the ones found in * {IERC20-approve}, and its usage is discouraged. * * Whenever possible, use {safeIncreaseAllowance} and * {safeDecreaseAllowance} instead. */ function safeApprove( IERC20 token, address spender, uint256 value ) internal { // safeApprove should only be called when setting an initial allowance, // or when resetting it to zero. To increase and decrease it, use // 'safeIncreaseAllowance' and 'safeDecreaseAllowance' require( (value == 0) || (token.allowance(address(this), spender) == 0), "SafeERC20: approve from non-zero to non-zero allowance" ); _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value)); } function safeIncreaseAllowance( IERC20 token, address spender, uint256 value ) internal { uint256 newAllowance = token.allowance(address(this), spender) + value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } function safeDecreaseAllowance( IERC20 token, address spender, uint256 value ) internal { unchecked { uint256 oldAllowance = token.allowance(address(this), spender); require(oldAllowance >= value, "SafeERC20: decreased allowance below zero"); uint256 newAllowance = oldAllowance - value; _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance)); } } function safePermit( IERC20Permit token, address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) internal { uint256 nonceBefore = token.nonces(owner); token.permit(owner, spender, value, deadline, v, r, s); uint256 nonceAfter = token.nonces(owner); require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed"); } /** * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement * on the return value: the return value is optional (but if data is returned, it must not be false). * @param token The token targeted by the call. * @param data The call data (encoded using abi.encode or one of its variants). */ function _callOptionalReturn(IERC20 token, bytes memory data) private { // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that // the target address contains contract code and also asserts for success in the low-level call. bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed"); if (returndata.length > 0) { // Return data is optional require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed"); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/extensions/ERC721Burnable.sol) pragma solidity ^0.8.0; import "../ERC721.sol"; import "../../../utils/Context.sol"; /** * @title ERC721 Burnable Token * @dev ERC721 Token that can be burned (destroyed). */ abstract contract ERC721Burnable is Context, ERC721 { /** * @dev Burns `tokenId`. See {ERC721-_burn}. * * Requirements: * * - The caller must own `tokenId` or be an approved operator. */ function burn(uint256 tokenId) public virtual { //solhint-disable-next-line max-line-length require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved"); _burn(tokenId); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/ERC721Enumerable.sol) pragma solidity ^0.8.0; import "../ERC721.sol"; import "./IERC721Enumerable.sol"; /** * @dev This implements an optional extension of {ERC721} defined in the EIP that adds * enumerability of all the token ids in the contract as well as all token ids owned by each * account. */ abstract contract ERC721Enumerable is ERC721, IERC721Enumerable { // Mapping from owner to list of owned token IDs mapping(address => mapping(uint256 => uint256)) private _ownedTokens; // Mapping from token ID to index of the owner tokens list mapping(uint256 => uint256) private _ownedTokensIndex; // Array with all token ids, used for enumeration uint256[] private _allTokens; // Mapping from token id to position in the allTokens array mapping(uint256 => uint256) private _allTokensIndex; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) { return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}. */ function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) { require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds"); return _ownedTokens[owner][index]; } /** * @dev See {IERC721Enumerable-totalSupply}. */ function totalSupply() public view virtual override returns (uint256) { return _allTokens.length; } /** * @dev See {IERC721Enumerable-tokenByIndex}. */ function tokenByIndex(uint256 index) public view virtual override returns (uint256) { require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds"); return _allTokens[index]; } /** * @dev Hook that is called before any token transfer. This includes minting * and burning. * * Calling conditions: * * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, ``from``'s `tokenId` will be burned. * - `from` cannot be the zero address. * - `to` cannot be the zero address. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer( address from, address to, uint256 tokenId ) internal virtual override { super._beforeTokenTransfer(from, to, tokenId); if (from == address(0)) { _addTokenToAllTokensEnumeration(tokenId); } else if (from != to) { _removeTokenFromOwnerEnumeration(from, tokenId); } if (to == address(0)) { _removeTokenFromAllTokensEnumeration(tokenId); } else if (to != from) { _addTokenToOwnerEnumeration(to, tokenId); } } /** * @dev Private function to add a token to this extension's ownership-tracking data structures. * @param to address representing the new owner of the given token ID * @param tokenId uint256 ID of the token to be added to the tokens list of the given address */ function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private { uint256 length = ERC721.balanceOf(to); _ownedTokens[to][length] = tokenId; _ownedTokensIndex[tokenId] = length; } /** * @dev Private function to add a token to this extension's token tracking data structures. * @param tokenId uint256 ID of the token to be added to the tokens list */ function _addTokenToAllTokensEnumeration(uint256 tokenId) private { _allTokensIndex[tokenId] = _allTokens.length; _allTokens.push(tokenId); } /** * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for * gas optimizations e.g. when performing a transfer operation (avoiding double writes). * This has O(1) time complexity, but alters the order of the _ownedTokens array. * @param from address representing the previous owner of the given token ID * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address */ function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private { // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = ERC721.balanceOf(from) - 1; uint256 tokenIndex = _ownedTokensIndex[tokenId]; // When the token to delete is the last token, the swap operation is unnecessary if (tokenIndex != lastTokenIndex) { uint256 lastTokenId = _ownedTokens[from][lastTokenIndex]; _ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index } // This also deletes the contents at the last position of the array delete _ownedTokensIndex[tokenId]; delete _ownedTokens[from][lastTokenIndex]; } /** * @dev Private function to remove a token from this extension's token tracking data structures. * This has O(1) time complexity, but alters the order of the _allTokens array. * @param tokenId uint256 ID of the token to be removed from the tokens list */ function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private { // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = _allTokens.length - 1; uint256 tokenIndex = _allTokensIndex[tokenId]; // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding // an 'if' statement (like in _removeTokenFromOwnerEnumeration) uint256 lastTokenId = _allTokens[lastTokenIndex]; _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index // This also deletes the contents at the last position of the array delete _allTokensIndex[tokenId]; _allTokens.pop(); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (utils/Multicall.sol) pragma solidity ^0.8.0; import "./Address.sol"; /** * @dev Provides a function to batch together multiple calls in a single external call. * * _Available since v4.1._ */ abstract contract Multicall { /** * @dev Receives and executes a batch of function calls on this contract. */ function multicall(bytes[] calldata data) external virtual returns (bytes[] memory results) { results = new bytes[](data.length); for (uint256 i = 0; i < data.length; i++) { results[i] = Address.functionDelegateCall(address(this), data[i]); } return results; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControlEnumerable.sol"; import "./AccessControl.sol"; import "../utils/structs/EnumerableSet.sol"; /** * @dev Extension of {AccessControl} that allows enumerating the members of each role. */ abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl { using EnumerableSet for EnumerableSet.AddressSet; mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers; /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) { return _roleMembers[role].at(index); } /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) { return _roleMembers[role].length(); } /** * @dev Overload {_grantRole} to track enumerable memberships */ function _grantRole(bytes32 role, address account) internal virtual override { super._grantRole(role, account); _roleMembers[role].add(account); } /** * @dev Overload {_revokeRole} to track enumerable memberships */ function _revokeRole(bytes32 role, address account) internal virtual override { super._revokeRole(role, account); _roleMembers[role].remove(account); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (security/ReentrancyGuard.sol) pragma solidity ^0.8.0; /** * @dev Contract module that helps prevent reentrant calls to a function. * * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier * available, which can be applied to functions to make sure there are no nested * (reentrant) calls to them. * * Note that because there is a single `nonReentrant` guard, functions marked as * `nonReentrant` may not call one another. This can be worked around by making * those functions `private`, and then adding `external` `nonReentrant` entry * points to them. * * TIP: If you would like to learn more about reentrancy and alternative ways * to protect against it, check out our blog post * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul]. */ abstract contract ReentrancyGuard { // Booleans are more expensive than uint256 or any type that takes up a full // word because each write operation emits an extra SLOAD to first read the // slot's contents, replace the bits taken up by the boolean, and then write // back. This is the compiler's defense against contract upgrades and // pointer aliasing, and it cannot be disabled. // The values being non-zero value makes deployment a bit more expensive, // but in exchange the refund on every call to nonReentrant will be lower in // amount. Since refunds are capped to a percentage of the total // transaction's gas, it is best to keep them low in cases like this one, to // increase the likelihood of the full refund coming into effect. uint256 private constant _NOT_ENTERED = 1; uint256 private constant _ENTERED = 2; uint256 private _status; constructor() { _status = _NOT_ENTERED; } /** * @dev Prevents a contract from calling itself, directly or indirectly. * Calling a `nonReentrant` function from another `nonReentrant` * function is not supported. It is possible to prevent this from happening * by making the `nonReentrant` function external, and making it call a * `private` function that does the actual work. */ modifier nonReentrant() { _nonReentrantBefore(); _; _nonReentrantAfter(); } function _nonReentrantBefore() private { // On the first call to nonReentrant, _notEntered will be true require(_status != _ENTERED, "ReentrancyGuard: reentrant call"); // Any calls to nonReentrant after this point will fail _status = _ENTERED; } function _nonReentrantAfter() private { // By storing the original value once again, a refund is triggered (see // https://eips.ethereum.org/EIPS/eip-2200) _status = _NOT_ENTERED; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol) pragma solidity ^0.8.0; import "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Enumerable is IERC721 { /** * @dev Returns the total amount of tokens stored by the contract. */ function totalSupply() external view returns (uint256); /** * @dev Returns a token ID owned by `owner` at a given `index` of its token list. * Use along with {balanceOf} to enumerate all of ``owner``'s tokens. */ function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256); /** * @dev Returns a token ID at a given `index` of all the tokens stored by the contract. * Use along with {totalSupply} to enumerate all tokens. */ function tokenByIndex(uint256 index) external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC20/IERC20.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 standard as defined in the EIP. */ interface IERC20 { /** * @dev Emitted when `value` tokens are moved from one account (`from`) to * another (`to`). * * Note that `value` may be zero. */ event Transfer(address indexed from, address indexed to, uint256 value); /** * @dev Emitted when the allowance of a `spender` for an `owner` is set by * a call to {approve}. `value` is the new allowance. */ event Approval(address indexed owner, address indexed spender, uint256 value); /** * @dev Returns the amount of tokens in existence. */ function totalSupply() external view returns (uint256); /** * @dev Returns the amount of tokens owned by `account`. */ function balanceOf(address account) external view returns (uint256); /** * @dev Moves `amount` tokens from the caller's account to `to`. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transfer(address to, uint256 amount) external returns (bool); /** * @dev Returns the remaining number of tokens that `spender` will be * allowed to spend on behalf of `owner` through {transferFrom}. This is * zero by default. * * This value changes when {approve} or {transferFrom} are called. */ function allowance(address owner, address spender) external view returns (uint256); /** * @dev Sets `amount` as the allowance of `spender` over the caller's tokens. * * Returns a boolean value indicating whether the operation succeeded. * * IMPORTANT: Beware that changing an allowance with this method brings the risk * that someone may use both the old and the new allowance by unfortunate * transaction ordering. One possible solution to mitigate this race * condition is to first reduce the spender's allowance to 0 and set the * desired value afterwards: * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 * * Emits an {Approval} event. */ function approve(address spender, uint256 amount) external returns (bool); /** * @dev Moves `amount` tokens from `from` to `to` using the * allowance mechanism. `amount` is then deducted from the caller's * allowance. * * Returns a boolean value indicating whether the operation succeeded. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 amount ) external returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/draft-IERC20Permit.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in * https://eips.ethereum.org/EIPS/eip-2612[EIP-2612]. * * Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by * presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't * need to send a transaction, and thus is not required to hold Ether at all. */ interface IERC20Permit { /** * @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens, * given ``owner``'s signed approval. * * IMPORTANT: The same issues {IERC20-approve} has related to transaction * ordering also apply here. * * Emits an {Approval} event. * * Requirements: * * - `spender` cannot be the zero address. * - `deadline` must be a timestamp in the future. * - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner` * over the EIP712-formatted function arguments. * - the signature must use ``owner``'s current nonce (see {nonces}). * * For more information on the signature format, see the * https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP * section]. */ function permit( address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s ) external; /** * @dev Returns the current nonce for `owner`. This value must be * included whenever a signature is generated for {permit}. * * Every successful call to {permit} increases ``owner``'s nonce by one. This * prevents a signature from being used multiple times. */ function nonces(address owner) external view returns (uint256); /** * @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}. */ // solhint-disable-next-line func-name-mixedcase function DOMAIN_SEPARATOR() external view returns (bytes32); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol) pragma solidity ^0.8.1; /** * @dev Collection of functions related to the address type */ library Address { /** * @dev Returns true if `account` is a contract. * * [IMPORTANT] * ==== * It is unsafe to assume that an address for which this function returns * false is an externally-owned account (EOA) and not a contract. * * Among others, `isContract` will return false for the following * types of addresses: * * - an externally-owned account * - a contract in construction * - an address where a contract will be created * - an address where a contract lived, but was destroyed * ==== * * [IMPORTANT] * ==== * You shouldn't rely on `isContract` to protect against flash loan attacks! * * Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets * like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract * constructor. * ==== */ function isContract(address account) internal view returns (bool) { // This method relies on extcodesize/address.code.length, which returns 0 // for contracts in construction, since the code is only stored at the end // of the constructor execution. return account.code.length > 0; } /** * @dev Replacement for Solidity's `transfer`: sends `amount` wei to * `recipient`, forwarding all available gas and reverting on errors. * * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost * of certain opcodes, possibly making contracts go over the 2300 gas limit * imposed by `transfer`, making them unable to receive funds via * `transfer`. {sendValue} removes this limitation. * * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more]. * * IMPORTANT: because control is transferred to `recipient`, care must be * taken to not create reentrancy vulnerabilities. Consider using * {ReentrancyGuard} or the * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern]. */ function sendValue(address payable recipient, uint256 amount) internal { require(address(this).balance >= amount, "Address: insufficient balance"); (bool success, ) = recipient.call{value: amount}(""); require(success, "Address: unable to send value, recipient may have reverted"); } /** * @dev Performs a Solidity function call using a low level `call`. A * plain `call` is an unsafe replacement for a function call: use this * function instead. * * If `target` reverts with a revert reason, it is bubbled up by this * function (like regular Solidity function calls). * * Returns the raw returned data. To convert to the expected return value, * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`]. * * Requirements: * * - `target` must be a contract. * - calling `target` with `data` must not revert. * * _Available since v3.1._ */ function functionCall(address target, bytes memory data) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, "Address: low-level call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with * `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCall( address target, bytes memory data, string memory errorMessage ) internal returns (bytes memory) { return functionCallWithValue(target, data, 0, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but also transferring `value` wei to `target`. * * Requirements: * * - the calling contract must have an ETH balance of at least `value`. * - the called Solidity function must be `payable`. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value ) internal returns (bytes memory) { return functionCallWithValue(target, data, value, "Address: low-level call with value failed"); } /** * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but * with `errorMessage` as a fallback revert reason when `target` reverts. * * _Available since v3.1._ */ function functionCallWithValue( address target, bytes memory data, uint256 value, string memory errorMessage ) internal returns (bytes memory) { require(address(this).balance >= value, "Address: insufficient balance for call"); (bool success, bytes memory returndata) = target.call{value: value}(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) { return functionStaticCall(target, data, "Address: low-level static call failed"); } /** * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`], * but performing a static call. * * _Available since v3.3._ */ function functionStaticCall( address target, bytes memory data, string memory errorMessage ) internal view returns (bytes memory) { (bool success, bytes memory returndata) = target.staticcall(data); return verifyCallResultFromTarget(target, success, returndata, errorMessage); } /** * @dev 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.7.0) (token/ERC721/ERC721.sol) pragma solidity ^0.8.0; import "./IERC721.sol"; import "./IERC721Receiver.sol"; import "./extensions/IERC721Metadata.sol"; import "../../utils/Address.sol"; import "../../utils/Context.sol"; import "../../utils/Strings.sol"; import "../../utils/introspection/ERC165.sol"; /** * @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including * the Metadata extension, but not including the Enumerable extension, which is available separately as * {ERC721Enumerable}. */ contract ERC721 is Context, ERC165, IERC721, IERC721Metadata { using Address for address; using Strings for uint256; // Token name string private _name; // Token symbol string private _symbol; // Mapping from token ID to owner address mapping(uint256 => address) private _owners; // Mapping owner address to token count mapping(address => uint256) private _balances; // Mapping from token ID to approved address mapping(uint256 => address) private _tokenApprovals; // Mapping from owner to operator approvals mapping(address => mapping(address => bool)) private _operatorApprovals; /** * @dev Initializes the contract by setting a `name` and a `symbol` to the token collection. */ constructor(string memory name_, string memory symbol_) { _name = name_; _symbol = symbol_; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == type(IERC721).interfaceId || interfaceId == type(IERC721Metadata).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721-balanceOf}. */ function balanceOf(address owner) public view virtual override returns (uint256) { require(owner != address(0), "ERC721: address zero is not a valid owner"); return _balances[owner]; } /** * @dev See {IERC721-ownerOf}. */ function ownerOf(uint256 tokenId) public view virtual override returns (address) { address owner = _owners[tokenId]; require(owner != address(0), "ERC721: invalid token ID"); return owner; } /** * @dev See {IERC721Metadata-name}. */ function name() public view virtual override returns (string memory) { return _name; } /** * @dev See {IERC721Metadata-symbol}. */ function symbol() public view virtual override returns (string memory) { return _symbol; } /** * @dev See {IERC721Metadata-tokenURI}. */ function tokenURI(uint256 tokenId) public view virtual override returns (string memory) { _requireMinted(tokenId); string memory baseURI = _baseURI(); return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : ""; } /** * @dev Base URI for computing {tokenURI}. If set, the resulting URI for each * token will be the concatenation of the `baseURI` and the `tokenId`. Empty * by default, can be overridden in child contracts. */ function _baseURI() internal view virtual returns (string memory) { return ""; } /** * @dev See {IERC721-approve}. */ function approve(address to, uint256 tokenId) public virtual override { address owner = ERC721.ownerOf(tokenId); require(to != owner, "ERC721: approval to current owner"); require( _msgSender() == owner || isApprovedForAll(owner, _msgSender()), "ERC721: approve caller is not token owner or approved for all" ); _approve(to, tokenId); } /** * @dev See {IERC721-getApproved}. */ function getApproved(uint256 tokenId) public view virtual override returns (address) { _requireMinted(tokenId); return _tokenApprovals[tokenId]; } /** * @dev See {IERC721-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual override { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC721-isApprovedForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev See {IERC721-transferFrom}. */ function transferFrom( address from, address to, uint256 tokenId ) public virtual override { //solhint-disable-next-line max-line-length require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved"); _transfer(from, to, tokenId); } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId ) public virtual override { safeTransferFrom(from, to, tokenId, ""); } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes memory data ) public virtual override { require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved"); _safeTransfer(from, to, tokenId, data); } /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * `data` is additional data, it has no specified format and it is sent in call to `to`. * * This internal function is equivalent to {safeTransferFrom}, and can be used to e.g. * implement alternative mechanisms to perform token transfer, such as signature-based. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function _safeTransfer( address from, address to, uint256 tokenId, bytes memory data ) internal virtual { _transfer(from, to, tokenId); require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer"); } /** * @dev Returns whether `tokenId` exists. * * Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}. * * Tokens start existing when they are minted (`_mint`), * and stop existing when they are burned (`_burn`). */ function _exists(uint256 tokenId) internal view virtual returns (bool) { return _owners[tokenId] != address(0); } /** * @dev Returns whether `spender` is allowed to manage `tokenId`. * * Requirements: * * - `tokenId` must exist. */ function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) { address owner = ERC721.ownerOf(tokenId); return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender); } /** * @dev Safely mints `tokenId` and transfers it to `to`. * * Requirements: * * - `tokenId` must not exist. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function _safeMint(address to, uint256 tokenId) internal virtual { _safeMint(to, tokenId, ""); } /** * @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is * forwarded in {IERC721Receiver-onERC721Received} to contract recipients. */ function _safeMint( address to, uint256 tokenId, bytes memory data ) internal virtual { _mint(to, tokenId); require( _checkOnERC721Received(address(0), to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer" ); } /** * @dev Mints `tokenId` and transfers it to `to`. * * WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible * * Requirements: * * - `tokenId` must not exist. * - `to` cannot be the zero address. * * Emits a {Transfer} event. */ function _mint(address to, uint256 tokenId) internal virtual { require(to != address(0), "ERC721: mint to the zero address"); require(!_exists(tokenId), "ERC721: token already minted"); _beforeTokenTransfer(address(0), to, tokenId); _balances[to] += 1; _owners[tokenId] = to; emit Transfer(address(0), to, tokenId); _afterTokenTransfer(address(0), to, tokenId); } /** * @dev Destroys `tokenId`. * The approval is cleared when the token is burned. * This is an internal function that does not check if the sender is authorized to operate on the token. * * Requirements: * * - `tokenId` must exist. * * Emits a {Transfer} event. */ function _burn(uint256 tokenId) internal virtual { address owner = ERC721.ownerOf(tokenId); _beforeTokenTransfer(owner, address(0), tokenId); // Clear approvals delete _tokenApprovals[tokenId]; _balances[owner] -= 1; delete _owners[tokenId]; emit Transfer(owner, address(0), tokenId); _afterTokenTransfer(owner, address(0), tokenId); } /** * @dev Transfers `tokenId` from `from` to `to`. * As opposed to {transferFrom}, this imposes no restrictions on msg.sender. * * Requirements: * * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * * Emits a {Transfer} event. */ function _transfer( address from, address to, uint256 tokenId ) internal virtual { require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner"); require(to != address(0), "ERC721: transfer to the zero address"); _beforeTokenTransfer(from, to, tokenId); // Clear approvals from the previous owner delete _tokenApprovals[tokenId]; _balances[from] -= 1; _balances[to] += 1; _owners[tokenId] = to; emit Transfer(from, to, tokenId); _afterTokenTransfer(from, to, tokenId); } /** * @dev Approve `to` to operate on `tokenId` * * Emits an {Approval} event. */ function _approve(address to, uint256 tokenId) internal virtual { _tokenApprovals[tokenId] = to; emit Approval(ERC721.ownerOf(tokenId), to, tokenId); } /** * @dev Approve `operator` to operate on all of `owner` tokens * * Emits an {ApprovalForAll} event. */ function _setApprovalForAll( address owner, address operator, bool approved ) internal virtual { require(owner != operator, "ERC721: approve to caller"); _operatorApprovals[owner][operator] = approved; emit ApprovalForAll(owner, operator, approved); } /** * @dev Reverts if the `tokenId` has not been minted yet. */ function _requireMinted(uint256 tokenId) internal view virtual { require(_exists(tokenId), "ERC721: invalid token ID"); } /** * @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address. * The call is not executed if the target address is not a contract. * * @param from address representing the previous owner of the given token ID * @param to target address that will receive the tokens * @param tokenId uint256 ID of the token to be transferred * @param data bytes optional data to send along with the call * @return bool whether the call correctly returned the expected magic value */ function _checkOnERC721Received( address from, address to, uint256 tokenId, bytes memory data ) private returns (bool) { if (to.isContract()) { try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) { return retval == IERC721Receiver.onERC721Received.selector; } catch (bytes memory reason) { if (reason.length == 0) { revert("ERC721: transfer to non ERC721Receiver implementer"); } else { /// @solidity memory-safe-assembly assembly { revert(add(32, reason), mload(reason)) } } } } else { return true; } } /** * @dev Hook that is called before any token transfer. This includes minting * and burning. * * Calling conditions: * * - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be * transferred to `to`. * - When `from` is zero, `tokenId` will be minted for `to`. * - When `to` is zero, ``from``'s `tokenId` will be burned. * - `from` and `to` are never both zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _beforeTokenTransfer( address from, address to, uint256 tokenId ) internal virtual {} /** * @dev Hook that is called after any transfer of tokens. This includes * minting and burning. * * Calling conditions: * * - when `from` and `to` are both non-zero. * - `from` and `to` are never both zero. * * To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks]. */ function _afterTokenTransfer( address from, address to, uint256 tokenId ) internal virtual {} }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/Context.sol) pragma solidity ^0.8.0; /** * @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 Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; /** * @dev External interface of AccessControlEnumerable declared to support ERC165 detection. */ interface IAccessControlEnumerable is IAccessControl { /** * @dev Returns one of the accounts that have `role`. `index` must be a * value between 0 and {getRoleMemberCount}, non-inclusive. * * Role bearers are not sorted in any particular way, and their ordering may * change at any point. * * WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure * you perform all queries on the same block. See the following * https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post] * for more information. */ function getRoleMember(bytes32 role, uint256 index) external view returns (address); /** * @dev Returns the number of accounts that have `role`. Can be used * together with {getRoleMember} to enumerate all bearers of a role. */ function getRoleMemberCount(bytes32 role) external view returns (uint256); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (access/AccessControl.sol) pragma solidity ^0.8.0; import "./IAccessControl.sol"; import "../utils/Context.sol"; import "../utils/Strings.sol"; import "../utils/introspection/ERC165.sol"; /** * @dev Contract module that allows children to implement role-based access * control mechanisms. This is a lightweight version that doesn't allow enumerating role * members except through off-chain means by accessing the contract event logs. Some * applications may benefit from on-chain enumerability, for those cases see * {AccessControlEnumerable}. * * Roles are referred to by their `bytes32` identifier. These should be exposed * in the external API and be unique. The best way to achieve this is by * using `public constant` hash digests: * * ``` * bytes32 public constant MY_ROLE = keccak256("MY_ROLE"); * ``` * * Roles can be used to represent a set of permissions. To restrict access to a * function call, use {hasRole}: * * ``` * function foo() public { * require(hasRole(MY_ROLE, msg.sender)); * ... * } * ``` * * Roles can be granted and revoked dynamically via the {grantRole} and * {revokeRole} functions. Each role has an associated admin role, and only * accounts that have a role's admin role can call {grantRole} and {revokeRole}. * * By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means * that only accounts with this role will be able to grant or revoke other * roles. More complex role relationships can be created by using * {_setRoleAdmin}. * * WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to * grant and revoke this role. Extra precautions should be taken to secure * accounts that have been granted it. */ abstract contract AccessControl is Context, IAccessControl, ERC165 { struct RoleData { mapping(address => bool) members; bytes32 adminRole; } mapping(bytes32 => RoleData) private _roles; bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00; /** * @dev Modifier that checks that an account has a specific role. Reverts * with a standardized message including the required role. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ * * _Available since v4.1._ */ modifier onlyRole(bytes32 role) { _checkRole(role); _; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId); } /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) public view virtual override returns (bool) { return _roles[role].members[account]; } /** * @dev Revert with a standard message if `_msgSender()` is missing `role`. * Overriding this function changes the behavior of the {onlyRole} modifier. * * Format of the revert message is described in {_checkRole}. * * _Available since v4.6._ */ function _checkRole(bytes32 role) internal view virtual { _checkRole(role, _msgSender()); } /** * @dev Revert with a standard message if `account` is missing `role`. * * The format of the revert reason is given by the following regular expression: * * /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/ */ function _checkRole(bytes32 role, address account) internal view virtual { if (!hasRole(role, account)) { revert( string( abi.encodePacked( "AccessControl: account ", Strings.toHexString(account), " is missing role ", Strings.toHexString(uint256(role), 32) ) ) ); } } /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) { return _roles[role].adminRole; } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleGranted} event. */ function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _grantRole(role, account); } /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. * * May emit a {RoleRevoked} event. */ function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) { _revokeRole(role, account); } /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been revoked `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. * * May emit a {RoleRevoked} event. */ function renounceRole(bytes32 role, address account) public virtual override { require(account == _msgSender(), "AccessControl: can only renounce roles for self"); _revokeRole(role, account); } /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. Note that unlike {grantRole}, this function doesn't perform any * checks on the calling account. * * May emit a {RoleGranted} event. * * [WARNING] * ==== * This function should only be called from the constructor when setting * up the initial roles for the system. * * Using this function in any other way is effectively circumventing the admin * system imposed by {AccessControl}. * ==== * * NOTE: This function is deprecated in favor of {_grantRole}. */ function _setupRole(bytes32 role, address account) internal virtual { _grantRole(role, account); } /** * @dev Sets `adminRole` as ``role``'s admin role. * * Emits a {RoleAdminChanged} event. */ function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual { bytes32 previousAdminRole = getRoleAdmin(role); _roles[role].adminRole = adminRole; emit RoleAdminChanged(role, previousAdminRole, adminRole); } /** * @dev Grants `role` to `account`. * * Internal function without access restriction. * * May emit a {RoleGranted} event. */ function _grantRole(bytes32 role, address account) internal virtual { if (!hasRole(role, account)) { _roles[role].members[account] = true; emit RoleGranted(role, account, _msgSender()); } } /** * @dev Revokes `role` from `account`. * * Internal function without access restriction. * * May emit a {RoleRevoked} event. */ function _revokeRole(bytes32 role, address account) internal virtual { if (hasRole(role, account)) { _roles[role].members[account] = false; emit RoleRevoked(role, account, _msgSender()); } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/structs/EnumerableSet.sol) pragma solidity ^0.8.0; /** * @dev Library for managing * https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive * types. * * Sets have the following properties: * * - Elements are added, removed, and checked for existence in constant time * (O(1)). * - Elements are enumerated in O(n). No guarantees are made on the ordering. * * ``` * contract Example { * // Add the library methods * using EnumerableSet for EnumerableSet.AddressSet; * * // Declare a set state variable * EnumerableSet.AddressSet private mySet; * } * ``` * * As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`) * and `uint256` (`UintSet`) are supported. * * [WARNING] * ==== * Trying to delete such a structure from storage will likely result in data corruption, rendering the structure unusable. * See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info. * * In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an array of EnumerableSet. * ==== */ library EnumerableSet { // To implement this library for multiple types with as little code // repetition as possible, we write it in terms of a generic Set type with // bytes32 values. // The Set implementation uses private functions, and user-facing // implementations (such as AddressSet) are just wrappers around the // underlying Set. // This means that we can only create new EnumerableSets for types that fit // in bytes32. struct Set { // Storage of set values bytes32[] _values; // Position of the value in the `values` array, plus 1 because index 0 // means a value is not in the set. mapping(bytes32 => uint256) _indexes; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function _add(Set storage set, bytes32 value) private returns (bool) { if (!_contains(set, value)) { set._values.push(value); // The value is stored at length-1, but we add 1 to all indexes // and use 0 as a sentinel value set._indexes[value] = set._values.length; return true; } else { return false; } } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function _remove(Set storage set, bytes32 value) private returns (bool) { // We read and store the value's index to prevent multiple reads from the same storage slot uint256 valueIndex = set._indexes[value]; if (valueIndex != 0) { // Equivalent to contains(set, value) // To delete an element from the _values array in O(1), we swap the element to delete with the last one in // the array, and then remove the last element (sometimes called as 'swap and pop'). // This modifies the order of the array, as noted in {at}. uint256 toDeleteIndex = valueIndex - 1; uint256 lastIndex = set._values.length - 1; if (lastIndex != toDeleteIndex) { bytes32 lastValue = set._values[lastIndex]; // Move the last value to the index where the value to delete is set._values[toDeleteIndex] = lastValue; // Update the index for the moved value set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex } // Delete the slot where the moved value was stored set._values.pop(); // Delete the index for the deleted slot delete set._indexes[value]; return true; } else { return false; } } /** * @dev Returns true if the value is in the set. O(1). */ function _contains(Set storage set, bytes32 value) private view returns (bool) { return set._indexes[value] != 0; } /** * @dev Returns the number of values on the set. O(1). */ function _length(Set storage set) private view returns (uint256) { return set._values.length; } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function _at(Set storage set, uint256 index) private view returns (bytes32) { return set._values[index]; } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function _values(Set storage set) private view returns (bytes32[] memory) { return set._values; } // Bytes32Set struct Bytes32Set { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _add(set._inner, value); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) { return _remove(set._inner, value); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) { return _contains(set._inner, value); } /** * @dev Returns the number of values in the set. O(1). */ function length(Bytes32Set storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) { return _at(set._inner, index); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(Bytes32Set storage set) internal view returns (bytes32[] memory) { return _values(set._inner); } // AddressSet struct AddressSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(AddressSet storage set, address value) internal returns (bool) { return _add(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(AddressSet storage set, address value) internal returns (bool) { return _remove(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(AddressSet storage set, address value) internal view returns (bool) { return _contains(set._inner, bytes32(uint256(uint160(value)))); } /** * @dev Returns the number of values in the set. O(1). */ function length(AddressSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(AddressSet storage set, uint256 index) internal view returns (address) { return address(uint160(uint256(_at(set._inner, index)))); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(AddressSet storage set) internal view returns (address[] memory) { bytes32[] memory store = _values(set._inner); address[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } // UintSet struct UintSet { Set _inner; } /** * @dev Add a value to a set. O(1). * * Returns true if the value was added to the set, that is if it was not * already present. */ function add(UintSet storage set, uint256 value) internal returns (bool) { return _add(set._inner, bytes32(value)); } /** * @dev Removes a value from a set. O(1). * * Returns true if the value was removed from the set, that is if it was * present. */ function remove(UintSet storage set, uint256 value) internal returns (bool) { return _remove(set._inner, bytes32(value)); } /** * @dev Returns true if the value is in the set. O(1). */ function contains(UintSet storage set, uint256 value) internal view returns (bool) { return _contains(set._inner, bytes32(value)); } /** * @dev Returns the number of values on the set. O(1). */ function length(UintSet storage set) internal view returns (uint256) { return _length(set._inner); } /** * @dev Returns the value stored at position `index` in the set. O(1). * * Note that there are no guarantees on the ordering of values inside the * array, and it may change when more values are added or removed. * * Requirements: * * - `index` must be strictly less than {length}. */ function at(UintSet storage set, uint256 index) internal view returns (uint256) { return uint256(_at(set._inner, index)); } /** * @dev Return the entire set in an array * * WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed * to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that * this function has an unbounded cost, and using it as part of a state-changing function may render the function * uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block. */ function values(UintSet storage set) internal view returns (uint256[] memory) { bytes32[] memory store = _values(set._inner); uint256[] memory result; /// @solidity memory-safe-assembly assembly { result := store } return result; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (token/ERC721/IERC721.sol) pragma solidity ^0.8.0; import "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC721 compliant contract. */ interface IERC721 is IERC165 { /** * @dev Emitted when `tokenId` token is transferred from `from` to `to`. */ event Transfer(address indexed from, address indexed to, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables `approved` to manage the `tokenId` token. */ event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId); /** * @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets. */ event ApprovalForAll(address indexed owner, address indexed operator, bool approved); /** * @dev Returns the number of tokens in ``owner``'s account. */ function balanceOf(address owner) external view returns (uint256 balance); /** * @dev Returns the owner of the `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function ownerOf(uint256 tokenId) external view returns (address owner); /** * @dev Safely transfers `tokenId` token from `from` to `to`. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId, bytes calldata data ) external; /** * @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients * are aware of the ERC721 protocol to prevent tokens from being forever locked. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must exist and be owned by `from`. * - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}. * - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer. * * Emits a {Transfer} event. */ function safeTransferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Transfers `tokenId` token from `from` to `to`. * * WARNING: Usage of this method is discouraged, use {safeTransferFrom} whenever possible. * * Requirements: * * - `from` cannot be the zero address. * - `to` cannot be the zero address. * - `tokenId` token must be owned by `from`. * - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}. * * Emits a {Transfer} event. */ function transferFrom( address from, address to, uint256 tokenId ) external; /** * @dev Gives permission to `to` to transfer `tokenId` token to another account. * The approval is cleared when the token is transferred. * * Only a single account can be approved at a time, so approving the zero address clears previous approvals. * * Requirements: * * - The caller must own the token or be an approved operator. * - `tokenId` must exist. * * Emits an {Approval} event. */ function approve(address to, uint256 tokenId) external; /** * @dev Approve or remove `operator` as an operator for the caller. * Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller. * * Requirements: * * - The `operator` cannot be the caller. * * Emits an {ApprovalForAll} event. */ function setApprovalForAll(address operator, bool _approved) external; /** * @dev Returns the account approved for `tokenId` token. * * Requirements: * * - `tokenId` must exist. */ function getApproved(uint256 tokenId) external view returns (address operator); /** * @dev Returns if the `operator` is allowed to manage all of the assets of `owner`. * * See {setApprovalForAll} */ function isApprovedForAll(address owner, address operator) external view returns (bool); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol) pragma solidity ^0.8.0; /** * @title ERC721 token receiver interface * @dev Interface for any contract that wants to support safeTransfers * from ERC721 asset contracts. */ interface IERC721Receiver { /** * @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom} * by `operator` from `from`, this function is called. * * It must return its Solidity selector to confirm the token transfer. * If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted. * * The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`. */ function onERC721Received( address operator, address from, uint256 tokenId, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol) pragma solidity ^0.8.0; import "../IERC721.sol"; /** * @title ERC-721 Non-Fungible Token Standard, optional metadata extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Metadata is IERC721 { /** * @dev Returns the token collection name. */ function name() external view returns (string memory); /** * @dev Returns the token collection symbol. */ function symbol() external view returns (string memory); /** * @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token. */ function tokenURI(uint256 tokenId) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol) pragma solidity ^0.8.0; /** * @dev String operations. */ library Strings { bytes16 private constant _HEX_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) { // Inspired by OraclizeAPI's implementation - MIT licence // https://github.com/oraclize/ethereum-api/blob/b42146b063c7d6ee1358846c198246239e9360e8/oraclizeAPI_0.4.25.sol if (value == 0) { return "0"; } uint256 temp = value; uint256 digits; while (temp != 0) { digits++; temp /= 10; } bytes memory buffer = new bytes(digits); while (value != 0) { digits -= 1; buffer[digits] = bytes1(uint8(48 + uint256(value % 10))); value /= 10; } return string(buffer); } /** * @dev Converts a `uint256` to its ASCII `string` hexadecimal representation. */ function toHexString(uint256 value) internal pure returns (string memory) { if (value == 0) { return "0x00"; } uint256 temp = value; uint256 length = 0; while (temp != 0) { length++; temp >>= 8; } return toHexString(value, length); } /** * @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] = _HEX_SYMBOLS[value & 0xf]; value >>= 4; } require(value == 0, "Strings: hex length insufficient"); return string(buffer); } /** * @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation. */ function toHexString(address addr) internal pure returns (string memory) { return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol) pragma solidity ^0.8.0; import "./IERC165.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 ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol) pragma solidity ^0.8.0; /** * @dev External interface of AccessControl declared to support ERC165 detection. */ interface IAccessControl { /** * @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole` * * `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite * {RoleAdminChanged} not being emitted signaling this. * * _Available since v3.1._ */ event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole); /** * @dev Emitted when `account` is granted `role`. * * `sender` is the account that originated the contract call, an admin role * bearer except when using {AccessControl-_setupRole}. */ event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Emitted when `account` is revoked `role`. * * `sender` is the account that originated the contract call: * - if using `revokeRole`, it is the admin role bearer * - if using `renounceRole`, it is the role bearer (i.e. `account`) */ event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender); /** * @dev Returns `true` if `account` has been granted `role`. */ function hasRole(bytes32 role, address account) external view returns (bool); /** * @dev Returns the admin role that controls `role`. See {grantRole} and * {revokeRole}. * * To change a role's admin, use {AccessControl-_setRoleAdmin}. */ function getRoleAdmin(bytes32 role) external view returns (bytes32); /** * @dev Grants `role` to `account`. * * If `account` had not been already granted `role`, emits a {RoleGranted} * event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function grantRole(bytes32 role, address account) external; /** * @dev Revokes `role` from `account`. * * If `account` had been granted `role`, emits a {RoleRevoked} event. * * Requirements: * * - the caller must have ``role``'s admin role. */ function revokeRole(bytes32 role, address account) external; /** * @dev Revokes `role` from the calling account. * * Roles are often managed via {grantRole} and {revokeRole}: this function's * purpose is to provide a mechanism for accounts to lose their privileges * if they are compromised (such as when a trusted device is misplaced). * * If the calling account had been granted `role`, emits a {RoleRevoked} * event. * * Requirements: * * - the caller must be `account`. */ function renounceRole(bytes32 role, address account) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol) pragma solidity ^0.8.0; /** * @dev Interface of the ERC165 standard, as defined in the * https://eips.ethereum.org/EIPS/eip-165[EIP]. * * Implementers can declare support of contract interfaces, which can then be * queried by others ({ERC165Checker}). * * For an implementation, see {ERC165}. */ interface IERC165 { /** * @dev Returns true if this contract implements the interface defined by * `interfaceId`. See the corresponding * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section] * to learn more about how these ids are created. * * This function call must use less than 30 000 gas. */ function supportsInterface(bytes4 interfaceId) external view returns (bool); }
{ "remappings": [ "base64/=lib/base64/", "cache_path /= 'forge-cache'/", "ds-test/=lib/forge-std/lib/ds-test/src/", "forge-std/=lib/forge-std/src/", "libs /= ['lib']/", "openzeppelin-contracts/=lib/openzeppelin-contracts/", "out /= 'out'/", "script /= 'scripts'/", "src /= 'contracts'/", "test /= 'test/foundry'/", "v2-core/=lib/v2-core/contracts/" ], "optimizer": { "enabled": true, "runs": 200 }, "metadata": { "bytecodeHash": "ipfs" }, "outputSelection": { "*": { "*": [ "evm.bytecode", "evm.deployedBytecode", "devdoc", "userdoc", "metadata", "abi" ] } }, "evmVersion": "london", "viaIR": true, "libraries": {} }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"address","name":"_rewardToken","type":"address"},{"internalType":"address","name":"_emissionCurve","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"ArrayLengthMismatch","type":"error"},{"inputs":[],"name":"BurningPrincipal","type":"error"},{"inputs":[],"name":"BurningRewards","type":"error"},{"inputs":[],"name":"DuplicateRelicIds","type":"error"},{"inputs":[],"name":"EmptyArray","type":"error"},{"inputs":[],"name":"MaxEmissionRateExceeded","type":"error"},{"inputs":[],"name":"MergingEmptyRelics","type":"error"},{"inputs":[],"name":"NonExistentPool","type":"error"},{"inputs":[],"name":"NonExistentRelic","type":"error"},{"inputs":[],"name":"NonZeroFirstMaturity","type":"error"},{"inputs":[],"name":"NotApprovedOrOwner","type":"error"},{"inputs":[],"name":"NotOwner","type":"error"},{"inputs":[],"name":"RelicsNotOfSamePool","type":"error"},{"inputs":[],"name":"RewardTokenAsPoolToken","type":"error"},{"inputs":[],"name":"UnsortedMaturityLevels","type":"error"},{"inputs":[],"name":"ZeroAmount","type":"error"},{"inputs":[],"name":"ZeroTotalAllocPoint","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"approved","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":false,"internalType":"bool","name":"approved","type":"bool"}],"name":"ApprovalForAll","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"previousAdminRole","type":"bytes32"},{"indexed":true,"internalType":"bytes32","name":"newAdminRole","type":"bytes32"}],"name":"RoleAdminChanged","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleGranted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"bytes32","name":"role","type":"bytes32"},{"indexed":true,"internalType":"address","name":"account","type":"address"},{"indexed":true,"internalType":"address","name":"sender","type":"address"}],"name":"RoleRevoked","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[],"name":"DEFAULT_ADMIN_ROLE","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"allocPoint","type":"uint256"},{"internalType":"address","name":"_poolToken","type":"address"},{"internalType":"address","name":"_rewarder","type":"address"},{"internalType":"uint256[]","name":"requiredMaturities","type":"uint256[]"},{"internalType":"uint256[]","name":"levelMultipliers","type":"uint256[]"},{"internalType":"string","name":"name","type":"string"},{"internalType":"address","name":"_nftDescriptor","type":"address"}],"name":"addPool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"pid","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"createRelicAndDeposit","outputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"deposit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"emergencyWithdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"emissionCurve","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"pid","type":"uint256"}],"name":"getLevelInfo","outputs":[{"components":[{"internalType":"uint256[]","name":"requiredMaturities","type":"uint256[]"},{"internalType":"uint256[]","name":"multipliers","type":"uint256[]"},{"internalType":"uint256[]","name":"balance","type":"uint256[]"}],"internalType":"struct LevelInfo","name":"levelInfo","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"pid","type":"uint256"}],"name":"getPoolInfo","outputs":[{"components":[{"internalType":"uint256","name":"accRewardPerShare","type":"uint256"},{"internalType":"uint256","name":"lastRewardTime","type":"uint256"},{"internalType":"uint256","name":"allocPoint","type":"uint256"},{"internalType":"string","name":"name","type":"string"}],"internalType":"struct PoolInfo","name":"pool","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"getPositionForId","outputs":[{"components":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"rewardDebt","type":"uint256"},{"internalType":"uint256","name":"rewardCredit","type":"uint256"},{"internalType":"uint256","name":"entry","type":"uint256"},{"internalType":"uint256","name":"poolId","type":"uint256"},{"internalType":"uint256","name":"level","type":"uint256"}],"internalType":"struct PositionInfo","name":"position","type":"tuple"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleAdmin","outputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"getRoleMember","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"}],"name":"getRoleMemberCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"grantRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"},{"internalType":"address","name":"harvestTo","type":"address"}],"name":"harvest","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"isApprovedOrOwner","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"levelOnUpdate","outputs":[{"internalType":"uint256","name":"level","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256[]","name":"pids","type":"uint256[]"}],"name":"massUpdatePools","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"fromId","type":"uint256"},{"internalType":"uint256","name":"toId","type":"uint256"}],"name":"merge","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"pid","type":"uint256"},{"internalType":"uint256","name":"allocPoint","type":"uint256"},{"internalType":"address","name":"_rewarder","type":"address"},{"internalType":"string","name":"name","type":"string"},{"internalType":"address","name":"_nftDescriptor","type":"address"},{"internalType":"bool","name":"overwriteRewarder","type":"bool"}],"name":"modifyPool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes[]","name":"data","type":"bytes[]"}],"name":"multicall","outputs":[{"internalType":"bytes[]","name":"results","type":"bytes[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"nftDescriptor","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"pendingReward","outputs":[{"internalType":"uint256","name":"pending","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"pendingRewardsOfOwner","outputs":[{"components":[{"internalType":"uint256","name":"relicId","type":"uint256"},{"internalType":"uint256","name":"poolId","type":"uint256"},{"internalType":"uint256","name":"pendingReward","type":"uint256"}],"internalType":"struct PendingReward[]","name":"pendingRewards","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"poolLength","outputs":[{"internalType":"uint256","name":"pools","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"poolToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"relicPositionsOfOwner","outputs":[{"internalType":"uint256[]","name":"relicIds","type":"uint256[]"},{"components":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"rewardDebt","type":"uint256"},{"internalType":"uint256","name":"rewardCredit","type":"uint256"},{"internalType":"uint256","name":"entry","type":"uint256"},{"internalType":"uint256","name":"poolId","type":"uint256"},{"internalType":"uint256","name":"level","type":"uint256"}],"internalType":"struct PositionInfo[]","name":"positionInfos","type":"tuple[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"renounceRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"role","type":"bytes32"},{"internalType":"address","name":"account","type":"address"}],"name":"revokeRole","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"rewardToken","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"rewarder","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_emissionCurve","type":"address"}],"name":"setEmissionCurve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"fromId","type":"uint256"},{"internalType":"uint256","name":"toId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"shift","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"fromId","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"address","name":"to","type":"address"}],"name":"split","outputs":[{"internalType":"uint256","name":"newId","type":"uint256"}],"stateMutability":"nonpayable","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":"index","type":"uint256"}],"name":"tokenByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"uint256","name":"index","type":"uint256"}],"name":"tokenOfOwnerByIndex","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalAllocPoint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"pid","type":"uint256"}],"name":"updatePool","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"updatePosition","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"relicId","type":"uint256"}],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"uint256","name":"relicId","type":"uint256"},{"internalType":"address","name":"harvestTo","type":"address"}],"name":"withdrawAndHarvest","outputs":[],"stateMutability":"nonpayable","type":"function"}]
Contract Creation Code
60a0346200042f57601f9062005f1890601f19906001600160401b03388490038581018416830190828211848310176200041957808491604097889485528339810103126200042f57620000538262000454565b62000062602080940162000454565b906200006d62000434565b92601184527014995b1a5c5d585c9e4811195c1bdcda5d607a1b858501526200009562000434565b600581526452454c494360d81b8682015284519682881162000419576000978854966001978881811c911680156200040e575b8a821014620003fa5790818d849311620003a7575b5089908d831160011462000346578b926200033a575b5050600019600383901b1c191690871b1788555b8151928311620003265785548681811c911680156200031b575b8882101462000307578a8111620002bf575b50869983116001146200025157509080620001c09899600b9796959493899262000245575b5050600019600383901b1c191690841b1783555b600c839055608052600f80546001600160a01b0319166001600160a01b0392909216919091179055838052600a825285842033855282528584205460ff1615620001fb575b50828052528233912062000469565b5051615a219081620004f7823960805181818161029d0152818161099d0152818161160d015281816128c80152818161300b01526133480152f35b838052600a825285842033855282528584209060ff198254161790553333847f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d8180a438620001b1565b01519050388062000158565b8588528688209991908316885b818110620002a9575099869594939192600b98979383620001c09c9d106200028f575b505050811b0183556200016c565b015160001960f88460031b161c1916905538808062000281565b828401518c559a87019a9288019288016200025e565b8689528789208b80860160051c8201928a8710620002fd575b0160051c019087905b828110620002f157505062000133565b8a8155018790620002e1565b92508192620002d8565b634e487b7160e01b89526022600452602489fd5b90607f169062000121565b634e487b7160e01b88526041600452602488fd5b015190503880620000f3565b90848a9416918c80528b8d20928d5b8d82821062000390575050841162000376575b505050811b01885562000107565b015160001960f88460031b161c1916905538808062000368565b8385015186558d9790950194938401930162000355565b9091508a8052898b208d80850160051c8201928c8610620003f0575b918b91869594930160051c01915b828110620003e1575050620000dd565b8d81558594508b9101620003d1565b92508192620003c3565b634e487b7160e01b8b52602260045260248bfd5b90607f1690620000c8565b634e487b7160e01b600052604160045260246000fd5b600080fd5b60408051919082016001600160401b038111838210176200041957604052565b51906001600160a01b03821682036200042f57565b91906001830160009082825280602052604082205415600014620004f05784549468010000000000000000861015620004dc5760018601808255861015620004c857836040949596828552602085200155549382526020522055600190565b634e487b7160e01b83526032600452602483fd5b634e487b7160e01b83526041600452602483fd5b5092505056fe608080604052600436101561001357600080fd5b60003560e01c90816301ffc9a7146137b757508063030101db146136f557806306fdde0314613652578063081812fc14613634578063081e3eda14613616578063095ea7b31461349c57806309f1c80a146131ce57806312f7086c146131b057806317caf6f11461319257806318160ddd1461317457806318fccc7614612e77578063215e83eb14612e1c57806323b872dd14612df8578063248a9ca314612dc95780632f2ff15d14612d025780632f380b3514612bc15780632f745c5914612b9a57806336568abe14612b0857806342842e0e14612ad557806342966c6814612a67578063430c208114612a36578063441a3e70146126685780634f6ccce7146125d757806351eb05a6146125ab5780635312ea8e1461248c57806357a5b58c146124245780636352211e146123f45780636705fcf31461235d5780636e7d4019146123025780636ecbae3f146120d057806370a08231146120ad5780637747dd8114611f605780638d74c2bf14611cf15780639010d07c14611caa57806391d1485414611c5d57806395d89b4114611b7e5780639a0e584a146115555780639a67759b1461152c578063a217fddf14611510578063a22cb4651461143e578063a6443e1e14611418578063ac9650d814611279578063b88d4fde146111f4578063b9be8cd514610fdf578063bd75fd6c14610ea4578063c346253d14610e49578063c87b56dd14610d1c578063ca15c87314610cf0578063d14d0a1a14610b2c578063d1abb9071461069f578063d1c2babb14610446578063d547741f14610405578063e2bbb158146103d6578063e48dc13514610327578063e985e9c5146102d15763f7c618c11461028757600080fd5b346102cc5760003660031901126102cc576040517f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03168152602090f35b600080fd5b346102cc5760403660031901126102cc576102ea613906565b6102f261391c565b9060018060a01b03809116600052600560205260406000209116600052602052602060ff604060002054166040519015158152f35b346102cc5760203660031901126102cc57610340613db4565b50600435600052601460205260c0604060002060056040519161036283613b17565b8054835260018101546020840152600281015460408401526003810154606084015260048101546080840152015460a08201526103d4604051809260a0809180518452602081015160208501526040810151604085015260608101516060850152608081015160808501520151910152565bf35b346102cc576103fe6103e736613a71565b906103f0614c5e565b6103f9826145e6565b6140fe565b6001600c55005b346102cc5760403660031901126102cc5761044460043561042461391c565b9080600052600a60205261043f600160406000200154614aca565b614bd5565b005b346102cc5761045436613a71565b61045c614c5e565b80821461068d5761046c826145e6565b610475816145e6565b8160005260146020526040600020918254600484015493836000526040600020916004830154860361067b578254926104ae8285613be3565b9283156106695760038101546104c49084613d94565b84600384019182546104d69089613d94565b6104df91613be3565b906104e991613e49565b90558382556104fc8486858b8b8b614609565b9199909261050982613ff7565b9761051383613d59565b509060019c8d8093019061052691613a24565b90546105369160031b1c89613d94565b958261054186613d59565b50019061054d91613a24565b96909164e8d4a51000978893549060031b1c61056891613d94565b61057191613be3565b61057b908b613d94565b04600283015461058a91613be3565b91015461059691613da7565b938a81019485546105a691613da7565b928b8415156105eb7f285dbc28e663286c77e3cd79d1cf1525744b4dfe015f41295fe5ae2858880bdf9b60209b610605986105f8976105f195610651575b5050613d94565b94613d59565b5001613a24565b90549060031b1c90613d94565b04905561061184615054565b8360005260148252610645604060002060056000918281558260018201558260028201558260038201558260048201550155565b604051908152a3600c55005b60026106609101918254613be3565b905538806105e4565b604051636677a12d60e11b8152600490fd5b604051634f13191b60e01b8152600490fd5b604051634cce529560e11b8152600490fd5b346102cc576106ad36613ab7565b90916106b7614c5e565b8015610b1a576106c6836145e6565b82600052602091601483526040600020926004840154926106e684613ff7565b90848654926000906106f88486613da7565b90818a5560058a01549561070b8c614496565b9687818114610ae65761076761077b9160026105f18a61076061073688858c9d9e9f6105f190613d59565b819291549061074a8c838360031b1c613da7565b919060031b600019811b9283911b169119161790565b9055613d59565b819291549061074a89838360031b1c613be3565b90555b6107878b613d59565b506001019061079591613a24565b93909164e8d4a51000948593549060031b1c6107b091613d94565b906107ba91613d94565b049260018b019384546107cc91613da7565b966107d68b613d59565b50600101906107e491613a24565b90549060031b1c6107f491613d94565b906107fe91613d94565b0490556001600160a01b03858116979095829189158080610add575b1561096757506002915001610830858254613be3565b90555b6109535750869084610844876139b6565b90549060031b1c16806108cb575b50610891817f614253edaf5943287293d855afffbb1f5f0403c51c84143aceaf27a50727b2fc9661088289613948565b90549060031b1c163390614cb4565b604051908152857f191a58d19a6a9b76e2e91bdc04ecbe7553dc094a5ad7af78175a0d9f884e264a853393a4604051908152a46001600c55005b809592503b156102cc57600080956044604051809881936305f7936f60e51b83528d60048401528660248401525af194851561094757818993610891927f614253edaf5943287293d855afffbb1f5f0403c51c84143aceaf27a50727b2fc98610938575b50965050610852565b61094190613b32565b8b61092f565b6040513d6000823e3d90fd5b634e487b7160e01b81526021600452602490fd5b15610974575b5050610833565b60029192500190610986825486613be3565b6040516370a0823160e01b815230600482015290927f00000000000000000000000000000000000000000000000000000000000000008916918881602481865afa908115610ad257908695949392918691610aa1575b5084811115610a9657506109f08480613da7565b9055826109fe575b5061096d565b610a09918391614cb4565b86610a13896139b6565b90549060031b1c169081610a28575b806109f8565b908092503b15610a9257829060648b83604051958694859363014a362160e71b8552600485015260248401528d60448401525af18015610a8757908291610a70575b80610a22565b610a7990613b32565b610a84578089610a6a565b80fd5b6040513d84823e3d90fd5b8280fd5b6109f0908095613da7565b8096508a8092503d8311610acb575b610aba8183613b60565b810103126102cc578594518e6109dc565b503d610ab0565b6040513d88823e3d90fd5b5086151561081a565b5082939450610b13610aff8260026105f160009a613d59565b819291549061074a8b838360031b1c613da7565b905561077e565b604051631f2a200560e01b8152600490fd5b346102cc576020806003193601126102cc57610b46613906565b90610b5082614ded565b610b5981613cd9565b90610b6381613cc2565b93610b716040519586613b60565b818552601f19610b8083613cc2565b018460005b828110610cda5750505060005b828110610c4f57505050826040519160408301604084528151809152846060850192019060005b818110610c3b575050508281038484015283808351928381520192019360005b828110610be65784840385f35b9091928260c082610c2c6001948a5160a0809180518452602081015160208501526040810151604085015260608101516060850152608081015160808501520151910152565b01960191019492919094610bd9565b825184529286019291860191600101610bb9565b610c598183615657565b610c638286613e35565b52610c6e8185613e35565b5160005260148552604060002090604051610c8881613b17565b8254815260056001938481015489840152600281015460408401526003810154606084015260048101546080840152015460a0820152610cc88289613e35565b52610cd38188613e35565b5001610b92565b610ce2613db4565b82828a010152018590610b85565b346102cc5760203660031901126102cc57600435600052600b6020526020604060002054604051908152f35b346102cc576020806003193601126102cc576004356000818152600260205260409020549091906001600160a01b031615610e3757600082602493825260148352610d6d60046040842001546139ed565b9490549160405195869384926344a5a61760e11b8452600484015260018060a01b039160031b1c165afa91821561094757600092610dbf575b50610dbb6040519282849384528301906138e1565b0390f35b9091503d806000833e610dd28183613b60565b81019082818303126102cc578051906001600160401b0382116102cc570181601f820112156102cc578051610e0681613b81565b92610e146040519485613b60565b8184528482840101116102cc57610e30918480850191016138be565b9082610da6565b604051631d1286b560e31b8152600490fd5b346102cc5760203660031901126102cc576004356013548110156102cc5760136000527f66de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a09001546040516001600160a01b039091168152602090f35b346102cc576020806003193601126102cc57610ebe613906565b90610ec882614ded565b610ed181613cc2565b92610edf6040519485613b60565b818452601f19610eee83613cc2565b018360005b828110610fb45750505060005b828110610f5857604080518581528651818701819052878701928201908760005b828110610f2e5784840385f35b85518051855280830151858401526040908101519085015294810194606090930192600101610f21565b80610f6560019284615657565b8060005260148652600460406000200154610f7f82613e69565b9060405192610f8d84613ae1565b8352878301526040820152610fa28288613e35565b52610fad8187613e35565b5001610f00565b604051610fc081613ae1565b6000815260008382015260006040820152828289010152018490610ef3565b346102cc5760603660031901126102cc57600435610ffb614c5e565b60443515610b1a57602435811461068d57611015816145e6565b6110206024356145e6565b806000526014602052604060002080546004820154916024356000526040600020926004840154810361067b57835492600383015461105f9082613d94565b600386019081546110709087613d94565b61107991613be3565b6110838684613be3565b61108c91613e49565b905561109a60443582613da7565b808455936110aa60443582613be3565b808755946110c08683604435876024358d614609565b936110cd87939293613ff7565b9283926110d989613d59565b50600101906110e791613a24565b90546110f79160031b1c84613d94565b968761110291613d94565b64e8d4a51000900460018a015461111891613da7565b806111dd575b5061112888613d59565b506001019061113691613a24565b90549060031b1c61114691613d94565b9061115091613d94565b64e8d4a510009004976001810198895461116991613da7565b91821515986111a298600164e8d4a510006111996105f89a8399839f996105eb996105f19b610651575050613d94565b04910155613d94565b0490556040519060443582527fda2a03409498a5fe8db3da030754afa618bc2228c0517ec5fa8c9b052979e9ea602060243593a36001600c55005b6111ec60028b01918254613be3565b90558c61111e565b346102cc5760803660031901126102cc5761120d613906565b61121561391c565b90606435906044356001600160401b0383116102cc57366023840112156102cc5761044493611251611274943690602481600401359101613b9c565b9261126461125f8433614fe6565b614f11565b61126f838383615237565b6155dc565b614fc6565b346102cc576020806003193601126102cc576001600160401b036004358181116102cc576112ab903690600401613a87565b90916112b682613cc2565b926112c46040519485613b60565b828452601f196112d384613cc2565b018560005b8281106114095750505060005b83811061134a57604080518781528651818901819052600092600582901b8301810191898b01918b9085015b82871061131e5785850386f35b90919293828061133a600193603f198a820301865288516138e1565b9601920196019592919092611311565b8060051b820135601e19833603018112156102cc578201908135918483116102cc57870182360381136102cc576113896113e991611404943691613b9c565b6000806040519261139984613ae1565b602784527f416464726573733a206c6f772d6c6576656c2064656c65676174652063616c6c8c850152660819985a5b195960ca1b60408501528b81519101305af46113e26154b8565b90306156e5565b6113f38288613e35565b526113fe8187613e35565b506146eb565b6112e5565b606087820183015281016112d8565b346102cc5760203660031901126102cc576020611436600435613f81565b604051908152f35b346102cc5760403660031901126102cc57611457613906565b602435908115158092036102cc576001600160a01b0316903382146114cb57336000526005602052604060002082600052602052604060002060ff1981541660ff83161790556040519081527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3160203392a3005b60405162461bcd60e51b815260206004820152601960248201527f4552433732313a20617070726f766520746f2063616c6c6572000000000000006044820152606490fd5b346102cc5760003660031901126102cc57602060405160008152f35b346102cc5760003660031901126102cc57600f546040516001600160a01b039091168152602090f35b346102cc5760e03660031901126102cc5761156e61391c565b611576613932565b6064356001600160401b0381116102cc57611595903690600401613a87565b906084356001600160401b0381116102cc576115b5903690600401613a87565b60a4356001600160401b0381116102cc57366023820112156102cc576115e5903690602481600401359101613b9c565b60c4356001600160a01b03811690036102cc576116006148dc565b6001600160a01b038781167f000000000000000000000000000000000000000000000000000000000000000090911614611b6c578415611b5a57818503611b48578335611b365760018511611ae9575b60105460005b818110611ad657505061166d600435601554613be3565b8015611ac457601555601254600160401b8110156119bd57876116998260016116bd9401601255613948565b90919082549060031b9160018060a01b039283811b93849216901b16911916179055565b601354600160401b8110156119bd57866116998260016116e094016013556139b6565b600e54600160401b8110156119bd576117028160016117289301600e556139ed565b815460c4356001600160a01b0390811660039390931b92831b921b918216911916179055565b6040519061173582613afc565b60008252602082014281526040830190600435825260608401928352601054600160401b8110156119bd578060016117709201601055613bf0565b949094611a355751845551600184015551600283015551908151906001600160401b0382116119bd57600301916117b1826117ab8554613c2a565b85613c7b565b602090601f8311600114611a565761180f959493929160009183611a4b575b50508160011b916000199060031b1c19161790555b6118066117f182613cd9565b94604051966117ff88613ae1565b3691613d0b565b85523691613d0b565b60208301526040820152601154600160401b8110156119bd578060016118389201601155613d59565b611a355781518051906001600160401b0382116119bd57600160401b82116119bd576020908354838555808410611a18575b500182600052602060002060005b838110611a04575050505060208201518051906001600160401b0382116119bd57600160401b82116119bd576020600184019182548484558085106119e7575b500190600052602060002060005b8381106119d35750505050600260409101910151908151916001600160401b0383116119bd57600160401b83116119bd5760209082548484558085106119a0575b500190600052602060002060005b83811061198c5785856012546000198101908111611976576040805160043581526001600160a01b0360c4358116602083015293841694909316927f916c1141fd0c2a70bb95c6e9f2376006b00f90a78c0db17abbf423c61db950df9190a4005b634e487b7160e01b600052601160045260246000fd5b600190602084519401938184015501611915565b6119b7908460005285846000209182019101613c64565b86611907565b634e487b7160e01b600052604160045260246000fd5b6001906020845194019381840155016118c6565b6119fe908460005285846000209182019101613c64565b886118b8565b600190602084519401938184015501611878565b611a2f908560005284846000209182019101613c64565b8761186a565b634e487b7160e01b600052600060045260246000fd5b015190508a806117d0565b90601f198316918460005260206000209260005b818110611aac575091600193918561180f999897969410611a93575b505050811b0190556117e5565b015160001960f88460031b161c191690558a8080611a86565b92936020600181928786015181550195019301611a6a565b604051632ae6f6af60e11b8152600490fd5b80611ae2600192613ff7565b5001611656565b600160005b868210611afc575050611650565b611b07828888613bd3565b351115611b24576001611b1b828888613bd3565b35910190611aee565b6040516367c462f760e01b8152600490fd5b6040516369afe63f60e11b8152600490fd5b60405163512509d360e11b8152600490fd5b60405163521299a960e01b8152600490fd5b60405163c982c8c360e01b8152600490fd5b346102cc5760003660031901126102cc5760405160006001805490611ba282613c2a565b80855291818116908115611c365750600114611bdd575b610dbb84611bc981860382613b60565b6040519182916020835260208301906138e1565b600081815292507fb10e2d527612073b26eecdfd717e6a320cf44b4afac2b0732d9fcbe2b7fa0cf65b828410611c1e575050508101602001611bc982611bb9565b80546020858701810191909152909301928101611c06565b60ff191660208087019190915292151560051b85019092019250611bc99150839050611bb9565b346102cc5760403660031901126102cc57611c7661391c565b600435600052600a60205260406000209060018060a01b0316600052602052602060ff604060002054166040519015158152f35b346102cc5760403660031901126102cc57600435600052600b6020526020611cd86024356040600020613a24565b905460405160039290921b1c6001600160a01b03168152f35b346102cc5760c03660031901126102cc5760248035600435611d11613932565b606435906001600160401b03908183116102cc57366023840112156102cc5782600401359182116102cc57368683850101116102cc576001600160a01b0392608435929084841684036102cc5760a4359182151583036102cc57611d736148dc565b60105480881015611f4e5760005b818110611f3b575050611d9387613bf0565b50611da089601554613be3565b90611db16002820192835490613da7565b918215611ac4578a869160039460155555611f29575b0191611dd7826117ab8554613c2a565b600090601f8311600114611e94579982917ffa4328c2a1268b2b661914d91df191c5271c699ddc97ccedda086c6d25b099f9999a9b600093611e87575b5050508160011b916000199060031b1c19161790555b611e3783611699886139ed565b15611e6b57611e6690915b604080519788526001600160a01b0390911660208801529190921694918291820190565b0390a3005b50611e6682611e79866139b6565b90549060031b1c1691611e42565b01013590508a8080611e14565b60008481526020808220949c929391601f198e16915b828210611f0f575050918c93917ffa4328c2a1268b2b661914d91df191c5271c699ddc97ccedda086c6d25b099f99b9c9d6001969410611ef3575b50505050811b019055611e2a565b60001960f88660031b161c19920101351690558a808080611ee5565b8060018598878395978a0101358155019701930190611eaa565b611f36866116998b6139b6565b611dc7565b80611f47600192613ff7565b5001611d81565b60405163904e0f5960e01b8152600490fd5b346102cc57611f6e36613ab7565b90611f77614c5e565b8015610b1a57827fcf0974dfd867840133a0d4b02f1672f24017796fb8892d1e0d587692e4da90ab602061206694611faf82976145e6565b83600052601482526040600020948554956105f8611fcd8389613da7565b97888355600161203f611fdf876146fa565b9b8c9b8c968760005260148b526040600020958987556003820154600388015561205d61202b60058401548060058b015560048501549a8b918260048d01558a6105f16105eb85613ff7565b8094819364e8d4a510009889958692613d94565b04946120508a820196875490613da7565b9081610651575050613d94565b04905587613d94565b04910155604051936001600160a01b0316907fb1ef6f1c5fca9fc83b81f6c18e6269a7942f041cadd830c353bb90f8680a3d4d600080a48152a36001600c55604051908152f35b346102cc5760203660031901126102cc5760206114366120cb613906565b614ded565b346102cc576020806003193601126102cc576120ea613906565b907ff0df1ecf66245243e1fe66eca783e2b1f173c34d37828b8788a74623e9a73e029081600052600a8152604060002033600052815260ff604060002054161561217357600f80546001600160a01b0319166001600160a01b0385169081179091557f097cb0b4d8d03c9f5f6d24fdb4d1c0764243aab030e9e385b0295badfe7a73e2600080a2005b61217c3361578f565b9160405161218981613afc565b604281528281019160603684378151156122ec576030835381516001908110156122ec57607860218401536041905b8082116122a857505061226557612231936122409260489260405196879376020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b88860152612208815180928a6037890191016138be565b8401917001034b99036b4b9b9b4b733903937b6329607d1b6037840152518093868401906138be565b01036028810185520183613b60565b61226160405192839262461bcd60e51b8452600484015260248301906138e1565b0390fd5b6064836040519062461bcd60e51b825280600483015260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152fd5b9091600f811660108110156122ec576f181899199a1a9b1b9c1cb0b131b232b360811b901a6122d7848661577e565b5360041c9180156119765760001901906121b8565b634e487b7160e01b600052603260045260246000fd5b346102cc5760203660031901126102cc576004356012548110156102cc5760126000527fbb8a6a4669ba250d26cd7a459eca9d215f8307e33aebe50379bc5a3617ec344401546040516001600160a01b039091168152602090f35b346102cc5760603660031901126102cc57612376613906565b60243590612382614c5e565b601054821015611f4e57602091612398826146fa565b80918160005260148552806004604060002001556123b8826044356140fe565b604051936001600160a01b0316907fb1ef6f1c5fca9fc83b81f6c18e6269a7942f041cadd830c353bb90f8680a3d4d600080a46001600c558152f35b346102cc5760203660031901126102cc576020612412600435614eb0565b6040516001600160a01b039091168152f35b346102cc5760203660031901126102cc576004356001600160401b0381116102cc57612454903690600401613a87565b9061245d614c5e565b60005b82811061246e576001600c55005b8061248561247f6001938686613bd3565b35613ff7565b5001612460565b346102cc5760203660031901126102cc576004356124a8614c5e565b6124b181614eb0565b6001600160a01b03818116913383036125995760207f6aaee64d11e8979fa392cd6388058c820f43709933f6a297e6e1005dddca62d691856000526014825261258b604060002094855492839161253661252260048a015499600260056125178d613d59565b509201549101613a24565b819291549061074a87838360031b1c613da7565b90556125418a615054565b8960005260148652612575604060002060056000918281558260018201558260028201558260038201558260048201550155565b61257e88613948565b90549060031b1c16614cb4565b604051908152a46001600c55005b6040516330cd747160e01b8152600490fd5b346102cc5760203660031901126102cc576125c4614c5e565b6125cf600435613ff7565b506001600c55005b346102cc5760203660031901126102cc5760043560085481101561260e5761260060209161397f565b90546040519160031b1c8152f35b60405162461bcd60e51b815260206004820152602c60248201527f455243373231456e756d657261626c653a20676c6f62616c20696e646578206f60448201526b7574206f6620626f756e647360a01b6064820152608490fd5b346102cc5761267636613a71565b61267e614c5e565b8115610b1a5761268d816145e6565b80600052602091601483526040600020926004840154906126ad82613ff7565b8554956000916126bd8689613da7565b908183556005830154986126d089614496565b99878b8a838214612a05575092612763856127468560016105f1878c6107606127336127849d61275e9f9d61272661271361275e9f928f936105f1600291613d59565b61074a8294925492838360031b1c613da7565b905560026105f186613d59565b61074a8294925492838360031b1c613be3565b97909364e8d4a51000988995549060031b1c90613d94565b613d94565b04946105f86127786001890197885490613da7565b9d60016105f18d613d59565b049055861561288657956127a2600283949596979801918254613be3565b90555b610953575082906127b5836139b6565b90546001600160a01b03939160031b1c83168061280d575b506127fd907f191a58d19a6a9b76e2e91bdc04ecbe7553dc094a5ad7af78175a0d9f884e264a9361088286613948565b6040519384523393a46001600c55005b8091503b156102cc57600080916044604051809481936305f7936f60e51b83528b60048401528a60248401525af18015610947577f191a58d19a6a9b76e2e91bdc04ecbe7553dc094a5ad7af78175a0d9f884e264a936127fd928792612877575b509350906127cd565b61288090613b32565b8861286e565b81612899575b50809192939495506127a5565b60026128a9910196875490613be3565b6040516370a0823160e01b8152306004820152966001600160a01b03907f0000000000000000000000000000000000000000000000000000000000000000821690858a602481855afa80156129fa5785969798999a86916129c5575b5085929190858111156129ba575061291d8580613da7565b905583612933575b50505086959493925061288c565b61293e918491614cb4565b612947866139b6565b90549060031b1c16908161295d575b8281612925565b908092503b15610a9257829160648392604051948593849263014a362160e71b84528c600485015260248401528160448401525af18015610a87579082916129a6575b80612956565b6129af90613b32565b610a845780866129a0565b61291d908096613da7565b8093929650888092503d83116129f3575b6129e08183613b60565b810103126102cc57905185949085612905565b503d6129d6565b6040513d87823e3d90fd5b975050612784926127638561274661275e979560016105f161275e9760009e6107606127138660026105f186613d59565b346102cc5760403660031901126102cc576020612a5d612a54613906565b60243590614fe6565b6040519015158152f35b346102cc5760203660031901126102cc57600435806000526014602052604060002054612ac357612a9781613e69565b612ab15780612aac61125f6104449333614fe6565b615054565b60405163faaea8f160e01b8152600490fd5b60405163f25a119760e01b8152600490fd5b346102cc57610444611274612ae936613a3c565b9060405192612af784613b45565b6000845261126461125f8433614fe6565b346102cc5760403660031901126102cc57612b2161391c565b336001600160a01b03821603612b3d5761044490600435614bd5565b60405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608490fd5b346102cc5760403660031901126102cc576020611436612bb8613906565b60243590615657565b346102cc576020806003193601126102cc57606080604051612be281613afc565b60008152600084820152600060408201520152612c00600435613bf0565b50604051612c0d81613afc565b81548152600191828101549084830191825260036002820154916040850192835201916040519286600096825492612c4484613c2a565b80885293828116908115612cdf5750600114612ca1575b50505050612c6f83610dbb95960384613b60565b6060850192835260405195869581875251908601525160408501525160608401525160808084015260a08301906138e1565b600090815282812092985092915b828410612ccc57505050830190940193612c6f86610dbb85612c5b565b80548785018a0152928801928101612caf565b60ff19168489015250505090151560051b8401019450612c6f86610dbb85612c5b565b346102cc5760403660031901126102cc57610444600435600b612d2361391c565b9180600052602090600a8252612d40600160406000200154614aca565b6000818152600a835260408082206001600160a01b0390961680835295845290205460ff1615612d79575b60005252604060002061588d565b80600052600a825260406000208460005282526040600020600160ff198254161790553384827f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d600080a4612d6b565b346102cc5760203660031901126102cc57600435600052600a6020526020600160406000200154604051908152f35b346102cc57610444612e0936613a3c565b91612e1761125f8433614fe6565b615237565b346102cc5760203660031901126102cc57600435600e548110156102cc57600e6000527fbb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fd01546040516001600160a01b039091168152602090f35b346102cc5760403660031901126102cc57600435612e9361391c565b90612e9c614c5e565b612ea5816145e6565b8060005260209160148352604060002092600484015490612ec582613ff7565b85549086600091600582015493612edb89614496565b94878682811461315157926105f8612f65612f3b8560016105f187610760612f27612f719c8a869f9d612713612f1a9161275e9f6105f1600291613d59565b905560026105f185613d59565b819291549061074a8c838360031b1c613be3565b9790612f598761275e64e8d4a510009b8c94549060031b1c88613d94565b04980197885490613da7565b9860016105f18d613d59565b0490556001600160a01b038581169586158080613148575b15612fdf5750505060028192939495969701612fa6848254613be3565b90555b6109535750907f614253edaf5943287293d855afffbb1f5f0403c51c84143aceaf27a50727b2fc91604051908152a46001600c55005b9890919815612ff8575b50508091929394959650612fa9565b60020197613007895485613be3565b91817f0000000000000000000000000000000000000000000000000000000000000000166040519a6370a0823160e01b8c523060048d0152878c602481855afa8015610ad257869798999a9b9c8791613117575b508581111561310c575061306f8580613da7565b905583613085575b505088979695949350612fe9565b613090918491614cb4565b613099876139b6565b90549060031b1c1690816130af575b8080613077565b908092503b15610a9257829160648392604051948593849263014a362160e71b84528d600485015260248401528b60448401525af18015610a87579082916130f8575b806130a8565b61310190613b32565b610a845780876130f2565b61306f908096613da7565b8097508a8092503d8311613141575b6131308183613b60565b810103126102cc578695518d61305b565b503d613126565b50841515612f89565b5094509161275e612f71926105f8612f65612f3b600197886105f160009c613d59565b346102cc5760003660031901126102cc576020600854604051908152f35b346102cc5760003660031901126102cc576020601554604051908152f35b346102cc5760203660031901126102cc576020611436600435613e69565b346102cc576020806003193601126102cc57600435906131ec614c5e565b6000828152600260205260409020546001600160a01b031615610e3757816000526014815260406000209160048301549261322684613ff7565b9381549260009460058401549461323c83614496565b95808714613486576132eb88996132ac8361327661326261275e9660026105f18d613d59565b819291549061074a8a838360031b1c613da7565b905561329e61328a8c60026105f18d613d59565b819291549061074a8a838360031b1c613be3565b90555b60016105f18a613d59565b93906132ca8361275e64e8d4a51000978894549060031b1c89613d94565b04946105f86132df60018c0197885490613da7565b9b60016105f18c613d59565b049055858515613316575050505060026133089101918254613be3565b90555b610953576001600c55005b9492949390919361332c575b505050505061330b565b600261333c910192835490613be3565b9360018060a01b0392837f000000000000000000000000000000000000000000000000000000000000000016926040516370a0823160e01b81523060048201528181602481885afa91821561347b57899261344a575b50508681111561343f57506133a78680613da7565b905585856133b6575b50613322565b856133c4916133c994614cb4565b6139b6565b90549060031b1c1691826133e0575b8080856133b0565b823b1561343a576064849283604051958694859363014a362160e71b8552600485015260248401528160448401525af1908115610a87578291613424575b806133d8565b61342d90613b32565b61343857808361341e565bfd5b505050fd5b6133a7908097613da7565b8199508092503d8311613474575b6134628183613b60565b810103126102cc578796518980613392565b503d613458565b6040513d8b823e3d90fd5b965061275e6132eb6132ac9960009a8b9a6132a1565b346102cc5760403660031901126102cc576134b5613906565b602435906001600160a01b0380806134cc85614eb0565b169216918083146135c7578033149081156135a2575b501561353757600083815260046020526040902080546001600160a01b0319168317905561350f83614eb0565b167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925600080a4005b60405162461bcd60e51b815260206004820152603d60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206f7220617070726f76656420666f7220616c6c0000006064820152608490fd5b9050600052600560205260406000203360005260205260ff60406000205416846134e2565b60405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b6064820152608490fd5b346102cc5760003660031901126102cc576020601054604051908152f35b346102cc5760203660031901126102cc576020612412600435614ed3565b346102cc5760003660031901126102cc576040516000805461367381613c2a565b80845290600190818116908115611c36575060011461369c57610dbb84611bc981860382613b60565b600080805292507f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e5635b8284106136dd575050508101602001611bc982611bb9565b805460208587018101919091529093019281016136c5565b346102cc5760203660031901126102cc5760606040805161371581613ae1565b828152826020820152015261379061372e600435613d59565b50610dbb6040519161373f83613ae1565b61374881613de6565b8352613769600261375b60018401613de6565b926020860193845201613de6565b90604084019182526137a6604051958695602087525160606020880152608087019061388a565b915191601f19928387830301604088015261388a565b91519084830301606085015261388a565b346102cc5760203660031901126102cc576004359063ffffffff60e01b82168092036102cc5760209163dd614ea960e01b81149081156137f9575b5015158152f35b635a05180f60e01b811491508115613813575b50836137f2565b637965db0b60e01b81149150811561382d575b508361380c565b63780e9d6360e01b811491508115613847575b5083613826565b6380ac58cd60e01b811491508115613879575b8115613868575b5083613840565b6301ffc9a760e01b14905083613861565b635b5e139f60e01b8114915061385a565b90815180825260208080930193019160005b8281106138aa575050505090565b83518552938101939281019260010161389c565b60005b8381106138d15750506000910152565b81810151838201526020016138c1565b906020916138fa815180928185528580860191016138be565b601f01601f1916010190565b600435906001600160a01b03821682036102cc57565b602435906001600160a01b03821682036102cc57565b604435906001600160a01b03821682036102cc57565b6012548110156122ec5760126000527fbb8a6a4669ba250d26cd7a459eca9d215f8307e33aebe50379bc5a3617ec34440190600090565b6008548110156122ec5760086000527ff3f7a9fe364faab93b216da50a3214154f22a0a2b415b23a84c8169e8b636ee30190600090565b6013548110156122ec5760136000527f66de8ffda797e3de9c05e8fc57b3bf0ec28a930d40b0d285d93c06501cf6a0900190600090565b600e548110156122ec57600e6000527fbb7b4a454dc3493923482f07822329ed19e8244eff582cc204f8554c3620c3fd0190600090565b80548210156122ec5760005260206000200190600090565b60609060031901126102cc576001600160a01b039060043582811681036102cc579160243590811681036102cc579060443590565b60409060031901126102cc576004359060243590565b9181601f840112156102cc578235916001600160401b0383116102cc576020808501948460051b0101116102cc57565b60609060031901126102cc5760043590602435906044356001600160a01b03811681036102cc5790565b606081019081106001600160401b038211176119bd57604052565b608081019081106001600160401b038211176119bd57604052565b60c081019081106001600160401b038211176119bd57604052565b6001600160401b0381116119bd57604052565b602081019081106001600160401b038211176119bd57604052565b90601f801991011681019081106001600160401b038211176119bd57604052565b6001600160401b0381116119bd57601f01601f191660200190565b929192613ba882613b81565b91613bb66040519384613b60565b8294818452818301116102cc578281602093846000960137010152565b91908110156122ec5760051b0190565b9190820180921161197657565b6010548110156122ec57601060005260021b7f1b6847dc741a1b0cd08d278845f9d819d87b734759afb55fe2de5cb82a9ae6720190600090565b90600182811c92168015613c5a575b6020831014613c4457565b634e487b7160e01b600052602260045260246000fd5b91607f1691613c39565b818110613c6f575050565b60008155600101613c64565b9190601f8111613c8a57505050565b613cb6926000526020600020906020601f840160051c83019310613cb8575b601f0160051c0190613c64565b565b9091508190613ca9565b6001600160401b0381116119bd5760051b60200190565b90613ce382613cc2565b613cf06040519182613b60565b8281528092613d01601f1991613cc2565b0190602036910137565b9291613d1682613cc2565b91613d246040519384613b60565b829481845260208094019160051b81019283116102cc57905b828210613d4a5750505050565b81358152908301908301613d3d565b6011548110156122ec576003906011600052027f31ecc21a745e3968a04e9570e4425bc18fa8019c68028196b546d1669c200c680190600090565b8181029291811591840414171561197657565b9190820391821161197657565b60405190613dc182613b17565b8160a06000918281528260208201528260408201528260608201528260808201520152565b9060405191828154918282526020928383019160005283600020936000905b828210613e1b57505050613cb692500383613b60565b855484526001958601958895509381019390910190613e05565b80518210156122ec5760209160051b010190565b8115613e53570490565b634e487b7160e01b600052601260045260246000fd5b60005260146020526040600020600481015490613e8582613bf0565b5091825492613e938261457c565b906001810154613ea38142613da7565b9081151580613f78575b613f00575b50505050613ef464e8d4a51000613ee8613efd9561275e6001956105f8613eda895492613d59565b508860058b01549101613a24565b04600284015490613be3565b91015490613da7565b90565b916002613f1c613f2593613f16613f2e966144ed565b90613d94565b91015490613d94565b60155490613e49565b9064e8d4a510009182810292818404149015171561197657613ee860019361275e613f6f613efd98613f6964e8d4a5100096613ef498613e49565b90613be3565b97505093613eb2565b50831515613ead565b6000526014602052604060002090613f9c6004830154613d59565b509081549260018414613fee57613fb860038092015442613da7565b9060001994858101908111611976575b613fd28186613a24565b905490831b1c831015613fe6578501613fc8565b945050509050565b50915050600090565b90601054821015611f4e5761400b82613bf0565b50916001830180549061401e8242613da7565b948054958061402f575b5050505050565b6140388561457c565b9384614087575b5050507fcb7325664a4a3b7c7223eefc492a97ca4fdf94d46884621e5a8fae5a04b2b9d291606091429055604051904282526020820152856040820152a23880808080614028565b61409f6140aa92613f16613f25939a9697959a6144ed565b600289015490613d94565b9264e8d4a5100093848102948186041490151715611976576140f3606093613f69847fcb7325664a4a3b7c7223eefc492a97ca4fdf94d46884621e5a8fae5a04b2b9d297613e49565b80975591819361403f565b8015610b1a576000828152601460205260409182822060049283820154938461412681613ff7565b938581548a8652601460205289862096875480156000146143bc57508490670de0b6b3a76400005b6003998a01805490916141618242613da7565b9061416b91613d94565b670de0b6b3a7640000900461417f91613be3565b9055888d61418d8686613be3565b908188558282858860058c0154946141a490614496565b9a858c809714156000146105f161425c9c61275e9b6142509a6142349961275e9861421e986001976143a2575061420d6107609361074a926142006141ee8c60026105f18c613d59565b61074a829492549283838d1b1c613da7565b905560026105f188613d59565b928195849392549485911b1c613be3565b9a909464e8d4a510009b8c9654911b1c90613d94565b049660016105f161424a828c019a8b5490613da7565b9b613d59565b9054908c1b1c90613d94565b049055811561439b5760026142749101918254613be3565b90555b614280856139b6565b90546001600160a01b03948592909190821b1c821680614342575b506142a587613948565b9054911b1c16908651926323b872dd60e01b60208501523360248501523060448501528560648501526064845260a08401918483106001600160401b0384111761432f5750507f9a2a1e97e6d641080089aafc36750cfdef4c79f8b3ace6fa4c384fa2f047695994926020949261431d928952614ced565b61432687614eb0565b169451908152a4565b634e487b7160e01b825260419052602490fd5b809192503b156143975783809160448b8b5194859384926303004b4760e01b8452898401528b60248401525af1801561438d57908592911561429b5761438790613b32565b3861429b565b88513d86823e3d90fd5b8380fd5b5050614277565b915050610760915061074a61420d8860026105f188613d59565b9394509092909181101561443157670de0b6b3a76400009081810290808204830361441e57906143ef6143f5928b613be3565b90613e49565b810390811161440b57918888928195945b61414e565b634e487b7160e01b865260118552602486fd5b634e487b7160e01b885260118752602488fd5b888882811015614482575050670de0b6b3a7640000880290670de0b6b3a763ffff198983040161446f5788926144068b9695936143ef889487613be3565b634e487b7160e01b875260118652602487fd5b9281959492506706f05b59d3b2000061414e565b906144a082613f81565b91806000526014602052826005604060002001818154036144c057505050565b557f8bdaee675270281b7bc2d5b9ced20517ecf5ce96158973ef78072a7bc1491b446020604051858152a2565b90602060018060a01b03600f5416926024604051809581936315dd902560e21b835260048301525afa91821561094757600092614549575b506753444835ec580000821161453757565b604051632dfc35e960e21b8152600490fd5b90916020823d8211614574575b8161456360209383613b60565b81010312610a845750519038614525565b3d9150614556565b90614588600092613d59565b50600281019081546000926001809301905b8285106145a8575050505050565b9091926145db8597613f696145be849886613a24565b90546145ca8c89613a24565b929054600393841b1c921b1c613d94565b96019392919061459a565b6145f09033614fe6565b156145f757565b60405163390cdd9b60e21b8152600490fd5b959293909491956000526014602052600560406000200154958560005261463860056040600020015496614496565b94859283891415806146d2575b8489141590816146b9575b80806146b2575b1561467657505050506146729160026105f161273393613d59565b9055565b9295509091156146945750506146729160026105f161273393613d59565b9093506146a057505050565b6146729160026105f161273393613d59565b5081614657565b6146cb6125228b60026105f189613d59565b9055614650565b6146e46125228b60026105f188613d59565b9055614645565b60001981146119765760010190565b90614706600d546146eb565b9182600d558260409182519261471b84613b45565b60008085526001600160a01b038316918215614899576000858152600260205260409020546001600160a01b031661485657600854858352602090600982528083852055600160401b8110156148425761479861477f8260018a940160085561397f565b819391549060031b600019811b9283911b169119161790565b90556147a385614ded565b84845260068252828420818552825286838520558684526007825282842055838352600381528183208054906001820180921161482e57926002889693613cb69a9896936112749a9655858452528120826001600160601b0360a01b8254161790557fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8180a46154e8565b634e487b7160e01b85526011600452602485fd5b634e487b7160e01b84526041600452602484fd5b5162461bcd60e51b815260206004820152601c60248201527f4552433732313a20746f6b656e20616c7265616479206d696e746564000000006044820152606490fd5b5162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f20616464726573736044820152606490fd5b3360009081527fcc154f7b876a360d54d1dd91709acfea951faf52857cd1bb669415168b037aed602090815260408083205490927f523a704056dcd17bcf83bed8b68c59416dac1119be77755efe3bde0a64e46e0c9160ff16156149405750505050565b6149493361578f565b9184519061495682613afc565b60428252848201926060368537825115614ab65760308453825190600191821015614ab65790607860218501536041915b818311614a4857505050614a065760486122619386936149ea936149db985198899376020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8a860152612208815180928c6037890191016138be565b01036028810187520185613b60565b5192839262461bcd60e51b8452600484015260248301906138e1565b60648486519062461bcd60e51b825280600483015260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152fd5b909192600f81166010811015614aa2576f181899199a1a9b1b9c1cb0b131b232b360811b901a614a78858761577e565b5360041c928015614a8e57600019019190614987565b634e487b7160e01b82526011600452602482fd5b634e487b7160e01b83526032600452602483fd5b634e487b7160e01b81526032600452602490fd5b600090808252602090600a8252604092838120338252835260ff848220541615614af45750505050565b614afd3361578f565b91845190614b0a82613afc565b60428252848201926060368537825115614ab65760308453825190600191821015614ab65790607860218501536041915b818311614b8f57505050614a065760486122619386936149ea936149db985198899376020b1b1b2b9b9a1b7b73a3937b61d1030b1b1b7bab73a1604d1b8a860152612208815180928c6037890191016138be565b909192600f81166010811015614aa2576f181899199a1a9b1b9c1cb0b131b232b360811b901a614bbf858761577e565b5360041c928015614a8e57600019019190614b3b565b906040614c1392600090808252600a6020528282209360018060a01b03169384835260205260ff8383205416614c16575b8152600b602052206158fb565b50565b808252600a60205282822084835260205282822060ff1981541690553384827ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b8580a4614c06565b6002600c5414614c6f576002600c55565b60405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c006044820152606490fd5b60405163a9059cbb60e01b60208201526001600160a01b039092166024830152604480830193909352918152613cb691614ced82613afc565b60018060a01b03169060405160408101908082106001600160401b038311176119bd57614d5e916040526020938482527f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564858301526000808587829751910182855af1614d586154b8565b916156e5565b805180614d6c575b50505050565b81849181010312614de95782015190811591821503610a845750614d9257808080614d66565b6084906040519062461bcd60e51b82526004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152fd5b5080fd5b6001600160a01b03168015614e0d57600052600360205260406000205490565b60405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b6064820152608490fd5b15614e6b57565b60405162461bcd60e51b815260206004820152601860248201527f4552433732313a20696e76616c696420746f6b656e20494400000000000000006044820152606490fd5b6000908152600260205260409020546001600160a01b0316613efd811515614e64565b600081815260026020526040902054614ef6906001600160a01b03161515614e64565b6000908152600460205260409020546001600160a01b031690565b15614f1857565b60405162461bcd60e51b815260206004820152602d60248201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560448201526c1c881bdc88185c1c1c9bdd9959609a1b6064820152608490fd5b60809060208152603260208201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b60608201520190565b15614fcd57565b60405162461bcd60e51b81528061226160048201614f73565b906001600160a01b038080614ffa84614eb0565b1693169183831493841561502d575b508315615017575b50505090565b61502391929350614ed3565b1614388080615011565b909350600052600560205260406000208260005260205260ff604060002054169238615009565b61505d81614eb0565b6001600160a01b03811690816151b0575060085482600052600960205280604060002055600160401b8110156119bd576150a161477f82600186940160085561397f565b90555b600854600019808201929183116119765760009284845260096020526040906150d0828620549161397f565b90549060031b1c806150e461477f8461397f565b905585526009602052818520558484528381812055600854801561519c57820161510d8161397f565b8482549160031b1b191690556008558484526004602052808420916001600160601b0360a01b92838154169055838552600360205281852080549182019182116151885755848452600260205283209081541690557fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8280a4565b634e487b7160e01b86526011600452602486fd5b634e487b7160e01b85526031600452602485fd5b6151b990614ded565b6000198101908111611976576000908382526020906007825260409182842054828103615200575b50858452838381205584845260068152828420918452528120556150a4565b85855260068252838520838652825283852054868652600683528486208287528352808587205585526007825283852055386151e1565b9061524183614eb0565b6001600160a01b0383811692918116839003615465578116928315615414578261537e575060085484600052600960205280604060002055600160401b8110156119bd5761529961477f82600188940160085561397f565b90555b81830361534b575b5060008381526004602052604081206001600160601b0360a01b90818154169055828252600360205260408220805490600019820191821161533757558382526003602052604082208054906001820180921161533757558482526002602052604082208054909116841790557fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9080a4565b634e487b7160e01b84526011600452602484fd5b61535490614ded565b604060008481526006602052818120838252602052858282205585815260076020522055386152a4565b83830361538c575b5061529c565b61539590614ded565b60001981019081116119765760009085825260209060078252604091828420548281036153dd575b508784528383812055858452600681528284209184525281205538615386565b86855260068252838520838652825283852054878652600683528486208287528352808587205585526007825283852055386153bd565b60405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b6064820152608490fd5b60405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b6064820152608490fd5b3d156154e3573d906154c982613b81565b916154d76040519384613b60565b82523d6000602084013e565b606090565b9091600091803b156155d3576155336020918493604051948580948193630a85bd0160e11b9a8b845233600485015284602485015260448401526080606484015260848301906138e1565b03926001600160a01b03165af19082908261558b575b505061557d576155576154b8565b805190816155785760405162461bcd60e51b81528061226160048201614f73565b602001fd5b6001600160e01b0319161490565b909192506020813d82116155cb575b816155a760209383613b60565b81010312614de95751906001600160e01b031982168203610a845750903880615549565b3d915061559a565b50505050600190565b91926000929190813b1561564d576020916156329185604051958680958194630a85bd0160e11b9b8c845233600485015260018060a01b03809516602485015260448401526080606484015260848301906138e1565b0393165af19082908261558b57505061557d576155576154b8565b5050505050600190565b61566081614ded565b82101561568c5760018060a01b0316600052600660205260406000209060005260205260406000205490565b60405162461bcd60e51b815260206004820152602b60248201527f455243373231456e756d657261626c653a206f776e657220696e646578206f7560448201526a74206f6620626f756e647360a81b6064820152608490fd5b9192901561574757508151156156f9575090565b3b156157025790565b60405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606490fd5b82519091501561575a5750805190602001fd5b60405162461bcd60e51b8152602060048201529081906122619060248301906138e1565b9081518110156122ec570160200190565b6040519061579c82613ae1565b602a82526020820160403682378251156122ec576030905381516001908110156122ec57607860218401536029905b80821161581f5750506157db5790565b606460405162461bcd60e51b815260206004820152602060248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152fd5b9091600f81166010811015615878576f181899199a1a9b1b9c1cb0b131b232b360811b901a61584e848661577e565b5360041c9180156158635760001901906157cb565b60246000634e487b7160e01b81526011600452fd5b60246000634e487b7160e01b81526032600452fd5b919060018301600090828252806020526040822054156000146158f557845494600160401b8610156158e157836158d161477f886001604098999a01855584613a24565b9055549382526020522055600190565b634e487b7160e01b83526041600452602483fd5b50925050565b906001820190600092818452826020526040842054908115156000146159e457600019918083018181116159d0578254908482019182116159bc57808203615987575b50505080548015615973578201916159568383613a24565b909182549160031b1b191690555582526020526040812055600190565b634e487b7160e01b86526031600452602486fd5b6159a761599761477f9386613a24565b90549060031b1c92839286613a24565b9055865284602052604086205538808061593e565b634e487b7160e01b88526011600452602488fd5b634e487b7160e01b87526011600452602487fd5b505050509056fea2646970667358221220e79be0d416e9c81a6dbe3ed3b56be1fb64d12cebae9ec563361013c2c33ce7c664736f6c63430008110033000000000000000000000000f24bcf4d1e507740041c9cfd2dddb29585adce1e0000000000000000000000009b3a90c586f25d815076636f71df721a88c9408a
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000f24bcf4d1e507740041c9cfd2dddb29585adce1e0000000000000000000000009b3a90c586f25d815076636f71df721a88c9408a
-----Decoded View---------------
Arg [0] : _rewardToken (address): 0xf24bcf4d1e507740041c9cfd2dddb29585adce1e
Arg [1] : _emissionCurve (address): 0x9b3a90c586f25d815076636f71df721a88c9408a
-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 000000000000000000000000f24bcf4d1e507740041c9cfd2dddb29585adce1e
Arg [1] : 0000000000000000000000009b3a90c586f25d815076636f71df721a88c9408a
Age | Block | Fee Address | BC Fee Address | Voting Power | Jailed | Incoming |
---|
Validator ID :
0 FTM
Amount Staked
0
Amount Delegated
0
Staking Total
0
Staking Start Epoch
0
Staking Start Time
0
Proof of Importance
0
Origination Score
0
Validation Score
0
Active
0
Online
0
Downtime
0 s
Address | Amount | claimed Rewards | Created On Epoch | Created On |
---|
Make sure to use the "Vote Down" button for any spammy posts, and the "Vote Up" for interesting conversations.