Sponsored
MoonPay
Buy, sell and swap Ethereum with MoonPay.Buy Now!
Spend less on fees, more on crypto. Buy crypto easily with MoonPay Balance. 20M+ users trust MoonPay worldwide.
MetaMask
Manage your web3 everything with MetaMask Portfolio. Try Now!
Ready to onboard to Ethereum? With MetaMask Portfolio, you're in control.
eToro
One-stop crypto shop: trusted, simple & safe.
Don’t invest unless you’re prepared to lose all the money you invest.
Sponsored
MetaMask
Meet MetaMask Portfolio - your key to getting more out of web3. Try Now
Ready to simplify your web3 experience? Try the all-in-one web3 app trusted by millions worldwide.
MetaMask
Swap directly on 9 networks Try Now
Available on 9 networks: Ethereum mainnet, Linea, Polygon, Optimism, BNB Chain, zkSync Era, Base, Avalanche.
Sponsored
Сoins.game
100 free spins for registration. Spin now!
Everyday giveaways up to 100 ETH, Lucky Spins. Deposit BONUS 300% and Cashbacks!
BC.GAME
- The Best ETH Casino Claim Now!
5000+ Slots & Live Casino Games, 50+cryptos. Register with Etherscan and get 760% deposit bonus. Win Big$, withdraw it fast.
Stake
200% Bonus, 100K Daily Giveaways, Instant Withdrawals Play Now!
Slots, Roulette, Poker & more - Proud sponsors of UFC, Everton & StakeF1 team!
Sponsored
BC.GAME
- The Best ETH Casino Claim Now!
5000+ Slots & Live Casino Games, 50+cryptos. Register with Etherscan and get 760% deposit bonus. Win Big$, withdraw it fast.
CryptoSlots
Play & Get 25 Free Spins at CryptoSlots Play Now
Anonymous play on awesome games - sign up now for 25 free jackpot spins - worth $100s!
CryptoWins
200% More Funds to Play on Us up to 4 BTC! Claim Now!
100s of games, generous bonuses, 20+ years of trusted gaming. Join CryptoWins & start winning today!
OpenSeaOverview
Max Total Supply
0 XENT
Holders
12,258
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
1 XENTLoading...
Loading
Loading...
Loading
Loading...
Loading
| # | Exchange | Pair | Price | 24H Volume | % Volume |
|---|
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 Name:
XENTorrent
Compiler Version
v0.8.17+commit.8df45f5f
Optimization Enabled:
Yes with 20 runs
Other Settings:
default evmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/interfaces/IERC2981.sol";
import "@openzeppelin/contracts/utils/Base64.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "@faircrypto/xen-crypto/contracts/XENCrypto.sol";
import "@faircrypto/xen-crypto/contracts/interfaces/IBurnableToken.sol";
import "@faircrypto/xen-crypto/contracts/interfaces/IBurnRedeemable.sol";
import "operator-filter-registry/src/DefaultOperatorFilterer.sol";
import "./libs/ERC2771Context.sol";
import "./interfaces/IERC2771.sol";
import "./interfaces/IXENTorrent.sol";
import "./interfaces/IXENProxying.sol";
import "./libs/MintInfo.sol";
import "./libs/Metadata.sol";
import "./libs/Array.sol";
/*
\\ // ||||||||||| |\ || A CRYPTOCURRENCY FOR THE MASSES
\\ // || |\\ ||
\\ // || ||\\ || PRINCIPLES OF XEN:
\\// || || \\ || - No pre-mint; starts with zero supply
XX |||||||| || \\ || - No admin keys
//\\ || || \\ || - Immutable contract
// \\ || || \\||
// \\ || || \\|
// \\ ||||||||||| || \| Copyright (C) FairCrypto Foundation 2022
XENFT XEN Torrent props:
- count: number of VMUs
- mintInfo: (term, maturityTs, cRank start, AMP, EAA, apex, limited, group, redeemed)
*/
contract XENTorrent is
DefaultOperatorFilterer, // required to support OpenSea royalties
IXENTorrent,
IXENProxying,
IBurnableToken,
IBurnRedeemable,
ERC2771Context, // required to support meta transactions
IERC2981, // required to support NFT royalties
ERC721("XEN Torrent", "XENT")
{
// HELPER LIBRARIES
using Strings for uint256;
using MintInfo for uint256;
using Array for uint256[];
// PUBLIC CONSTANTS
// XENFT common business logic
uint256 public constant BLACKOUT_TERM = 7 * 24 * 3600; /* 7 days in sec */
// XENFT categories' params
uint256 public constant COMMON_CATEGORY_COUNTER = 10_001;
uint256 public constant SPECIAL_CATEGORIES_VMU_THRESHOLD = 99;
uint256 public constant LIMITED_CATEGORY_TIME_THRESHOLD = 3_600 * 24 * 365;
uint256 public constant POWER_GROUP_SIZE = 7_500;
string public constant AUTHORS = "@MrJackLevin @lbelyaev faircrypto.org";
uint256 public constant ROYALTY_BP = 250;
// PUBLIC MUTABLE STATE
// increasing counters for NFT tokenIds, also used as salt for proxies' spinning
uint256 public tokenIdCounter = COMMON_CATEGORY_COUNTER;
// Indexing of params by categories and classes:
// 0: Collector
// 1: Limited
// 2: Rare
// 3: Epic
// 4: Legendary
// 5: Exotic
// 6: Xunicorn
// [0, B1, B2, B3, B4, B5, B6]
uint256[] public specialClassesBurnRates;
// [0, 0, R1, R2, R3, R4, R5]
uint256[] public specialClassesTokenLimits;
// [0, 0, 0 + 1, R1+1, R2+1, R3+1, R4+1]
uint256[] public specialClassesCounters;
// mapping: NFT tokenId => count of Virtual Mining Units
mapping(uint256 => uint256) public vmuCount;
// mapping: NFT tokenId => burned XEN
mapping(uint256 => uint256) public xenBurned;
// mapping: NFT tokenId => MintInfo (used in tokenURI generation)
// MintInfo encoded as:
// term (uint16)
// | maturityTs (uint64)
// | rank (uint128)
// | amp (uint16)
// | eaa (uint16)
// | class (uint8):
// [7] isApex
// [6] isLimited
// [0-5] powerGroupIdx
// | redeemed (uint8)
mapping(uint256 => uint256) public mintInfo;
// PUBLIC IMMUTABLE STATE
// pointer to XEN Crypto contract
XENCrypto public immutable xenCrypto;
// genesisTs for the contract
uint256 public immutable genesisTs;
// start of operations block number
uint256 public immutable startBlockNumber;
// PRIVATE STATE
// original contract marking to distinguish from proxy copies
address private immutable _original;
// original deployer address to be used for setting trusted forwarder
address private immutable _deployer;
// address to be used for royalties' tracking
address private immutable _royaltyReceiver;
// reentrancy guard constants and state
// using non-zero constants to save gas avoiding repeated initialization
uint256 private constant _NOT_USED = 2**256 - 1; // 0xFF..FF
uint256 private constant _USED = _NOT_USED - 1; // 0xFF..FE
// used as both
// - reentrancy guard (_NOT_USED > _USED > _NOT_USED)
// - for keeping state while awaiting for OnTokenBurned callback (_NOT_USED > tokenId > _NOT_USED)
uint256 private _tokenId;
// mapping Address => tokenId[]
mapping(address => uint256[]) private _ownedTokens;
/**
@dev Constructor. Creates XEN Torrent contract, setting immutable parameters
*/
constructor(
address xenCrypto_,
uint256[] memory burnRates_,
uint256[] memory tokenLimits_,
uint256 startBlockNumber_,
address forwarder_,
address royaltyReceiver_
) ERC2771Context(forwarder_) {
require(xenCrypto_ != address(0), "bad address");
require(burnRates_.length == tokenLimits_.length && burnRates_.length > 0, "params mismatch");
_tokenId = _NOT_USED;
_original = address(this);
_deployer = msg.sender;
_royaltyReceiver = royaltyReceiver_ == address(0) ? msg.sender : royaltyReceiver_;
startBlockNumber = startBlockNumber_;
genesisTs = block.timestamp;
xenCrypto = XENCrypto(xenCrypto_);
specialClassesBurnRates = burnRates_;
specialClassesTokenLimits = tokenLimits_;
specialClassesCounters = new uint256[](tokenLimits_.length);
for (uint256 i = 2; i < specialClassesBurnRates.length - 1; i++) {
specialClassesCounters[i] = specialClassesTokenLimits[i + 1] + 1;
}
specialClassesCounters[specialClassesBurnRates.length - 1] = 1;
}
/**
@dev Call Reentrancy Guard
*/
modifier nonReentrant() {
require(_tokenId == _NOT_USED, "XENFT: Reentrancy detected");
_tokenId = _USED;
_;
_tokenId = _NOT_USED;
}
/**
@dev Start of Operations Guard
*/
modifier notBeforeStart() {
require(block.number > startBlockNumber, "XENFT: Not active yet");
_;
}
// INTERFACES & STANDARDS
// IERC165 IMPLEMENTATION
/**
@dev confirms support for IERC-165, IERC-721, IERC2981, IERC2771 and IBurnRedeemable interfaces
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) {
return
interfaceId == type(IBurnRedeemable).interfaceId ||
interfaceId == type(IERC2981).interfaceId ||
interfaceId == type(IERC2771).interfaceId ||
super.supportsInterface(interfaceId);
}
// ERC2771 IMPLEMENTATION
/**
@dev use ERC2771Context implementation of _msgSender()
*/
function _msgSender() internal view virtual override(Context, ERC2771Context) returns (address) {
return ERC2771Context._msgSender();
}
/**
@dev use ERC2771Context implementation of _msgData()
*/
function _msgData() internal view virtual override(Context, ERC2771Context) returns (bytes calldata) {
return ERC2771Context._msgData();
}
// OWNABLE IMPLEMENTATION
/**
@dev public getter to check for deployer / owner (Opensea, etc.)
*/
function owner() external view returns (address) {
return _deployer;
}
// ERC-721 METADATA IMPLEMENTATION
/**
@dev compliance with ERC-721 standard (NFT); returns NFT metadata, including SVG-encoded image
*/
function tokenURI(uint256 tokenId) public view override returns (string memory) {
uint256 count = vmuCount[tokenId];
uint256 info = mintInfo[tokenId];
uint256 burned = xenBurned[tokenId];
require(count > 0);
bytes memory dataURI = abi.encodePacked(
"{",
'"name": "XEN Torrent #',
tokenId.toString(),
'",',
'"description": "XENFT: XEN Crypto Minting Torrent",',
'"image": "',
"data:image/svg+xml;base64,",
Base64.encode(Metadata.svgData(tokenId, count, info, address(xenCrypto), burned)),
'",',
'"attributes": ',
Metadata.attributes(count, burned, info),
"}"
);
return string(abi.encodePacked("data:application/json;base64,", Base64.encode(dataURI)));
}
// IMPLEMENTATION OF XENProxying INTERFACE
// FUNCTIONS IN PROXY COPY CONTRACTS (VMUs), CALLING ORIGINAL XEN CRYPTO CONTRACT
/**
@dev function callable only in proxy contracts from the original one => XENCrypto.claimRank(term)
*/
function callClaimRank(uint256 term) external {
require(msg.sender == _original, "XEN Proxy: unauthorized");
bytes memory callData = abi.encodeWithSignature("claimRank(uint256)", term);
(bool success, ) = address(xenCrypto).call(callData);
require(success, "call failed");
}
/**
@dev function callable only in proxy contracts from the original one => XENCrypto.claimMintRewardAndShare()
*/
function callClaimMintReward(address to) external {
require(msg.sender == _original, "XEN Proxy: unauthorized");
bytes memory callData = abi.encodeWithSignature("claimMintRewardAndShare(address,uint256)", to, uint256(100));
(bool success, ) = address(xenCrypto).call(callData);
require(success, "call failed");
}
/**
@dev function callable only in proxy contracts from the original one => destroys the proxy contract
*/
function powerDown() external {
require(msg.sender == _original, "XEN Proxy: unauthorized");
selfdestruct(payable(address(0)));
}
// OVERRIDING OF ERC-721 IMPLEMENTATION
// ENFORCEMENT OF TRANSFER BLACKOUT PERIOD
/**
@dev overrides OZ ERC-721 before transfer hook to check if there's no blackout period
*/
function _beforeTokenTransfer(
address from,
address,
uint256 tokenId
) internal virtual override {
if (from != address(0)) {
uint256 maturityTs = mintInfo[tokenId].getMaturityTs();
uint256 delta = maturityTs > block.timestamp ? maturityTs - block.timestamp : block.timestamp - maturityTs;
require(delta > BLACKOUT_TERM, "XENFT: transfer prohibited in blackout period");
}
}
/**
@dev overrides OZ ERC-721 after transfer hook to allow token enumeration for owner
*/
function _afterTokenTransfer(
address from,
address to,
uint256 tokenId
) internal virtual override {
_ownedTokens[from].removeItem(tokenId);
_ownedTokens[to].addItem(tokenId);
}
// IBurnRedeemable IMPLEMENTATION
/**
@dev implements IBurnRedeemable interface for burning XEN and completing Bulk Mint for limited series
*/
function onTokenBurned(address user, uint256 burned) external {
require(_tokenId != _NOT_USED, "XENFT: illegal callback state");
require(msg.sender == address(xenCrypto), "XENFT: illegal callback caller");
_ownedTokens[user].addItem(_tokenId);
xenBurned[_tokenId] = burned;
_safeMint(user, _tokenId);
emit StartTorrent(user, vmuCount[_tokenId], mintInfo[_tokenId].getTerm());
_tokenId = _NOT_USED;
}
// IBurnableToken IMPLEMENTATION
/**
@dev burns XENTorrent XENFT which can be used by connected contracts services
*/
function burn(address user, uint256 tokenId) public notBeforeStart nonReentrant {
require(
IERC165(_msgSender()).supportsInterface(type(IBurnRedeemable).interfaceId),
"XENFT burn: not a supported contract"
);
require(user != address(0), "XENFT burn: illegal owner address");
require(tokenId > 0, "XENFT burn: illegal tokenId");
require(_isApprovedOrOwner(_msgSender(), tokenId), "XENFT burn: not an approved operator");
require(ownerOf(tokenId) == user, "XENFT burn: user is not tokenId owner");
_ownedTokens[user].removeItem(tokenId);
_burn(tokenId);
IBurnRedeemable(_msgSender()).onTokenBurned(user, tokenId);
}
// OVERRIDING ERC-721 IMPLEMENTATION TO ALLOW OPENSEA ROYALTIES ENFORCEMENT PROTOCOL
/**
@dev implements `setApprovalForAll` with additional approved Operator checking
*/
function setApprovalForAll(address operator, bool approved) public override onlyAllowedOperatorApproval(operator) {
super.setApprovalForAll(operator, approved);
}
/**
@dev implements `approve` with additional approved Operator checking
*/
function approve(address operator, uint256 tokenId) public override onlyAllowedOperatorApproval(operator) {
super.approve(operator, tokenId);
}
/**
@dev implements `transferFrom` with additional approved Operator checking
*/
function transferFrom(
address from,
address to,
uint256 tokenId
) public override onlyAllowedOperator(from) {
super.transferFrom(from, to, tokenId);
}
/**
@dev implements `safeTransferFrom` with additional approved Operator checking
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId
) public override onlyAllowedOperator(from) {
super.safeTransferFrom(from, to, tokenId);
}
/**
@dev implements `safeTransferFrom` with additional approved Operator checking
*/
function safeTransferFrom(
address from,
address to,
uint256 tokenId,
bytes memory data
) public override onlyAllowedOperator(from) {
super.safeTransferFrom(from, to, tokenId, data);
}
// SUPPORT FOR ERC2771 META-TRANSACTIONS
/**
@dev Implements setting a `Trusted Forwarder` for meta-txs. Settable only once
*/
function addForwarder(address trustedForwarder) external {
require(msg.sender == _deployer, "XENFT: not an deployer");
require(_trustedForwarder == address(0), "XENFT: Forwarder is already set");
_trustedForwarder = trustedForwarder;
}
// SUPPORT FOR ERC2981 ROYALTY INFO
/**
@dev Implements getting Royalty Info by supported operators. ROYALTY_BP is expressed in basis points
*/
function royaltyInfo(uint256, uint256 salePrice) external view returns (address receiver, uint256 royaltyAmount) {
receiver = _royaltyReceiver;
royaltyAmount = (salePrice * ROYALTY_BP) / 10_000;
}
// XEN TORRENT PRIVATE / INTERNAL HELPERS
/**
@dev Sets specified XENFT as redeemed
*/
function _setRedeemed(uint256 tokenId) private {
mintInfo[tokenId] = mintInfo[tokenId] | uint256(1);
}
/**
@dev Determines power group index for Collector Category
*/
function _powerGroup(uint256 vmus, uint256 term) private pure returns (uint256) {
return (vmus * term) / POWER_GROUP_SIZE;
}
/**
@dev calculates Collector Class index
*/
function _classIdx(uint256 count, uint256 term) private pure returns (uint256 index) {
if (_powerGroup(count, term) > 7) return 7;
return _powerGroup(count, term);
}
/**
@dev internal helper to determine special class tier based on XEN to be burned
*/
function _specialTier(uint256 burning) private view returns (uint256) {
for (uint256 i = specialClassesBurnRates.length - 1; i > 0; i--) {
if (specialClassesBurnRates[i] == 0) {
return 0;
}
if (burning > specialClassesBurnRates[i] - 1) {
return i;
}
}
return 0;
}
/**
@dev internal helper to collect params and encode MintInfo
*/
function _mintInfo(
address proxy,
uint256 count,
uint256 term,
uint256 burning,
uint256 tokenId
) private view returns (uint256) {
bool apex = isApex(tokenId);
uint256 _class = _classIdx(count, term);
if (apex) _class = uint8(7 + _specialTier(burning)) | 0x80; // Apex Class
if (burning > 0 && !apex) _class = uint8(8) | 0x40; // Limited Class
(, , uint256 maturityTs, uint256 rank, uint256 amp, uint256 eaa) = xenCrypto.userMints(proxy);
return MintInfo.encodeMintInfo(term, maturityTs, rank, amp, eaa, _class, false);
}
/**
@dev internal torrent interface. initiates Bulk Mint (Torrent) Operation
*/
function _bulkClaimRank(
uint256 count,
uint256 term,
uint256 tokenId,
uint256 burning
) private {
bytes memory bytecode = bytes.concat(
bytes20(0x3D602d80600A3D3981F3363d3d373d3D3D363d73),
bytes20(address(this)),
bytes15(0x5af43d82803e903d91602b57fd5bf3)
);
bytes memory callData = abi.encodeWithSignature("callClaimRank(uint256)", term);
address proxy;
bool succeeded;
for (uint256 i = 1; i < count + 1; i++) {
bytes32 salt = keccak256(abi.encodePacked(i, tokenId));
assembly {
proxy := create2(0, add(bytecode, 0x20), mload(bytecode), salt)
succeeded := call(gas(), proxy, 0, add(callData, 0x20), mload(callData), 0, 0)
}
require(succeeded, "XENFT: Error while claiming rank");
if (i == 1) {
mintInfo[tokenId] = _mintInfo(proxy, count, term, burning, tokenId);
}
}
vmuCount[tokenId] = count;
}
/**
@dev internal helper to claim tokenId (limited / ordinary)
*/
function _getTokenId(uint256 count, uint256 burning) private returns (uint256) {
// burn possibility has already been verified
uint256 tier = _specialTier(burning);
if (tier == 1) {
require(count > SPECIAL_CATEGORIES_VMU_THRESHOLD, "XENFT: under req VMU count");
require(block.timestamp < genesisTs + LIMITED_CATEGORY_TIME_THRESHOLD, "XENFT: limited time expired");
return tokenIdCounter++;
}
if (tier > 1) {
require(_msgSender() == tx.origin, "XENFT: only EOA allowed for this category");
require(count > SPECIAL_CATEGORIES_VMU_THRESHOLD, "XENFT: under req VMU count");
require(specialClassesCounters[tier] < specialClassesTokenLimits[tier] + 1, "XENFT: class sold out");
return specialClassesCounters[tier]++;
}
return tokenIdCounter++;
}
// PUBLIC GETTERS
/**
@dev public getter for tokens owned by address
*/
function ownedTokens() external view returns (uint256[] memory) {
return _ownedTokens[_msgSender()];
}
/**
@dev determines if tokenId corresponds to Limited Category
*/
function isApex(uint256 tokenId) public pure returns (bool apex) {
apex = tokenId < COMMON_CATEGORY_COUNTER;
}
// PUBLIC TRANSACTIONAL INTERFACE
/**
@dev public XEN Torrent interface
initiates Bulk Mint (Torrent) Operation (Common Category)
*/
function bulkClaimRank(uint256 count, uint256 term) public notBeforeStart returns (uint256 tokenId) {
require(_tokenId == _NOT_USED, "XENFT: reentrancy detected");
require(count > 0, "XENFT: Illegal count");
require(term > 0, "XENFT: Illegal term");
_tokenId = _getTokenId(count, 0);
_bulkClaimRank(count, term, _tokenId, 0);
_ownedTokens[_msgSender()].addItem(_tokenId);
_safeMint(_msgSender(), _tokenId);
emit StartTorrent(_msgSender(), count, term);
tokenId = _tokenId;
_tokenId = _NOT_USED;
}
/**
@dev public torrent interface. initiates Bulk Mint (Torrent) Operation (Special Category)
*/
function bulkClaimRankLimited(
uint256 count,
uint256 term,
uint256 burning
) public notBeforeStart returns (uint256) {
require(_tokenId == _NOT_USED, "XENFT: reentrancy detected");
require(count > 0, "XENFT: Illegal count");
require(term > 0, "XENFT: Illegal term");
require(burning > specialClassesBurnRates[1] - 1, "XENFT: not enough burn amount");
uint256 balance = IERC20(xenCrypto).balanceOf(_msgSender());
require(balance > burning - 1, "XENFT: not enough XEN balance");
uint256 approved = IERC20(xenCrypto).allowance(_msgSender(), address(this));
require(approved > burning - 1, "XENFT: not enough XEN balance approved for burn");
_tokenId = _getTokenId(count, burning);
_bulkClaimRank(count, term, _tokenId, burning);
IBurnableToken(xenCrypto).burn(_msgSender(), burning);
return _tokenId;
}
/**
@dev public torrent interface. initiates Mint Reward claim and collection and terminates Torrent Operation
*/
function bulkClaimMintReward(uint256 tokenId, address to) external notBeforeStart nonReentrant {
require(ownerOf(tokenId) == _msgSender(), "XENFT: Incorrect owner");
require(to != address(0), "XENFT: Illegal address");
require(!mintInfo[tokenId].getRedeemed(), "XENFT: Already redeemed");
bytes memory bytecode = bytes.concat(
bytes20(0x3D602d80600A3D3981F3363d3d373d3D3D363d73),
bytes20(address(this)),
bytes15(0x5af43d82803e903d91602b57fd5bf3)
);
uint256 end = vmuCount[tokenId] + 1;
bytes memory callData = abi.encodeWithSignature("callClaimMintReward(address)", to);
bytes memory callData1 = abi.encodeWithSignature("powerDown()");
for (uint256 i = 1; i < end; i++) {
bytes32 salt = keccak256(abi.encodePacked(i, tokenId));
bool succeeded;
bytes32 hash = keccak256(abi.encodePacked(hex"ff", address(this), salt, keccak256(bytecode)));
address proxy = address(uint160(uint256(hash)));
assembly {
succeeded := call(gas(), proxy, 0, add(callData, 0x20), mload(callData), 0, 0)
}
require(succeeded, "XENFT: Error while claiming rewards");
assembly {
succeeded := call(gas(), proxy, 0, add(callData1, 0x20), mload(callData1), 0, 0)
}
require(succeeded, "XENFT: Error while powering down");
}
_setRedeemed(tokenId);
emit EndTorrent(_msgSender(), tokenId, to);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
/*
Extra XEN quotes:
"When you realize nothing is lacking, the whole world belongs to you." - Lao Tzu
"Each morning, we are born again. What we do today is what matters most." - Buddha
"If you are depressed, you are living in the past." - Lao Tzu
"In true dialogue, both sides are willing to change." - Thich Nhat Hanh
"The spirit of the individual is determined by his domination thought habits." - Bruce Lee
"Be the path. Do not seek it." - Yara Tschallener
"Bow to no one but your own divinity." - Satya
"With insight there is hope for awareness, and with awareness there can be change." - Tom Kenyon
"The opposite of depression isn't happiness, it is purpose." - Derek Sivers
"If you can't, you must." - Tony Robbins
“When you are grateful, fear disappears and abundance appears.” - Lao Tzu
“It is in your moments of decision that your destiny is shaped.” - Tony Robbins
"Surmounting difficulty is the crucible that forms character." - Tony Robbins
"Three things cannot be long hidden: the sun, the moon, and the truth." - Buddha
"What you are is what you have been. What you’ll be is what you do now." - Buddha
"The best way to take care of our future is to take care of the present moment." - Thich Nhat Hanh
*/
/**
@dev a library to supply a XEN string data based on params
*/
library StringData {
uint256 public constant QUOTES_COUNT = 12;
uint256 public constant QUOTE_LENGTH = 66;
bytes public constant QUOTES =
bytes(
'"If you realize you have enough, you are truly rich." - Lao Tzu '
'"The real meditation is how you live your life." - Jon Kabat-Zinn '
'"To know that you do not know is the best." - Lao Tzu '
'"An over-sharpened sword cannot last long." - Lao Tzu '
'"When you accept yourself, the whole world accepts you." - Lao Tzu'
'"Music in the soul can be heard by the universe." - Lao Tzu '
'"As soon as you have made a thought, laugh at it." - Lao Tzu '
'"The further one goes, the less one knows." - Lao Tzu '
'"Stop thinking, and end your problems." - Lao Tzu '
'"Reliability is the foundation of commitment." - Unknown '
'"Your past does not equal your future." - Tony Robbins '
'"Be the path. Do not seek it." - Yara Tschallener '
);
uint256 public constant CLASSES_COUNT = 14;
uint256 public constant CLASSES_NAME_LENGTH = 10;
bytes public constant CLASSES =
bytes(
"Ruby "
"Opal "
"Topaz "
"Emerald "
"Aquamarine"
"Sapphire "
"Amethyst "
"Xenturion "
"Limited "
"Rare "
"Epic "
"Legendary "
"Exotic "
"Xunicorn "
);
/**
@dev Solidity doesn't yet support slicing of byte arrays anywhere outside of calldata,
therefore we make a hack by supplying our local constant packed string array as calldata
*/
function getQuote(bytes calldata quotes, uint256 index) external pure returns (string memory) {
if (index > QUOTES_COUNT - 1) return string(quotes[0:QUOTE_LENGTH]);
return string(quotes[index * QUOTE_LENGTH:(index + 1) * QUOTE_LENGTH]);
}
function getClassName(bytes calldata names, uint256 index) external pure returns (string memory) {
if (index < CLASSES_COUNT) return string(names[index * CLASSES_NAME_LENGTH:(index + 1) * CLASSES_NAME_LENGTH]);
return "";
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "@openzeppelin/contracts/utils/Strings.sol";
import "./DateTime.sol";
import "./StringData.sol";
import "./FormattedStrings.sol";
/*
@dev Library to create SVG image for XENFT metadata
@dependency depends on DataTime.sol and StringData.sol libraries
*/
library SVG {
// Type to encode all data params for SVG image generation
struct SvgParams {
string symbol;
address xenAddress;
uint256 tokenId;
uint256 term;
uint256 rank;
uint256 count;
uint256 maturityTs;
uint256 amp;
uint256 eaa;
uint256 xenBurned;
bool redeemed;
string series;
}
// Type to encode SVG gradient stop color on HSL color scale
struct Color {
uint256 h;
uint256 s;
uint256 l;
uint256 a;
uint256 off;
}
// Type to encode SVG gradient
struct Gradient {
Color[] colors;
uint256 id;
uint256[4] coords;
}
using DateTime for uint256;
using Strings for uint256;
using FormattedStrings for uint256;
using Strings for address;
string private constant _STYLE =
"<style> "
".base {fill: #ededed;font-family:Montserrat,arial,sans-serif;font-size:30px;font-weight:400;} "
".series {text-transform: uppercase} "
".logo {font-size:200px;font-weight:100;} "
".meta {font-size:12px;} "
".small {font-size:8px;} "
".burn {font-weight:500;font-size:16px;} }"
"</style>";
string private constant _COLLECTOR =
"<g>"
"<path "
'stroke="#ededed" '
'fill="none" '
'transform="translate(265,418)" '
'd="m 0 0 L -20 -30 L -12.5 -38.5 l 6.5 7 L 0 -38.5 L 6.56 -31.32 L 12.5 -38.5 L 20 -30 L 0 0 L -7.345 -29.955 L 0 -38.5 L 7.67 -30.04 L 0 0 Z M 0 0 L -20.055 -29.955 l 7.555 -8.545 l 24.965 -0.015 L 20 -30 L -20.055 -29.955"/>'
"</g>";
string private constant _LIMITED =
"<g> "
'<path fill="#ededed" '
'transform="scale(0.4) translate(600, 940)" '
'd="M66,38.09q.06.9.18,1.71v.05c1,7.08,4.63,11.39,9.59,13.81,5.18,2.53,11.83,3.09,18.48,2.61,1.49-.11,3-.27,4.39-.47l1.59-.2c4.78-.61,11.47-1.48,13.35-5.06,1.16-2.2,1-5,0-8a38.85,38.85,0,0,0-6.89-11.73A32.24,32.24,0,0,0,95,21.46,21.2,21.2,0,0,0,82.3,20a23.53,23.53,0,0,0-12.75,7,15.66,15.66,0,0,0-2.35,3.46h0a20.83,20.83,0,0,0-1,2.83l-.06.2,0,.12A12,12,0,0,0,66,37.9l0,.19Zm26.9-3.63a5.51,5.51,0,0,1,2.53-4.39,14.19,14.19,0,0,0-5.77-.59h-.16l.06.51a5.57,5.57,0,0,0,2.89,4.22,4.92,4.92,0,0,0,.45.24ZM88.62,28l.94-.09a13.8,13.8,0,0,1,8,1.43,7.88,7.88,0,0,1,3.92,6.19l0,.43a.78.78,0,0,1-.66.84A19.23,19.23,0,0,1,98,37a12.92,12.92,0,0,1-6.31-1.44A7.08,7.08,0,0,1,88,30.23a10.85,10.85,0,0,1-.1-1.44.8.8,0,0,1,.69-.78ZM14.15,10c-.06-5.86,3.44-8.49,8-9.49C26.26-.44,31.24.16,34.73.7A111.14,111.14,0,0,1,56.55,6.4a130.26,130.26,0,0,1,22,10.8,26.25,26.25,0,0,1,3-.78,24.72,24.72,0,0,1,14.83,1.69,36,36,0,0,1,13.09,10.42,42.42,42.42,0,0,1,7.54,12.92c1.25,3.81,1.45,7.6-.23,10.79-2.77,5.25-10.56,6.27-16.12,7l-1.23.16a54.53,54.53,0,0,1-2.81,12.06A108.62,108.62,0,0,1,91.3,84v25.29a9.67,9.67,0,0,1,9.25,10.49c0,.41,0,.81,0,1.18a1.84,1.84,0,0,1-1.84,1.81H86.12a8.8,8.8,0,0,1-5.1-1.56,10.82,10.82,0,0,1-3.35-4,2.13,2.13,0,0,1-.2-.46L73.53,103q-2.73,2.13-5.76,4.16c-1.2.8-2.43,1.59-3.69,2.35l.6.16a8.28,8.28,0,0,1,5.07,4,15.38,15.38,0,0,1,1.71,7.11V121a1.83,1.83,0,0,1-1.83,1.83h-53c-2.58.09-4.47-.52-5.75-1.73A6.49,6.49,0,0,1,9.11,116v-11.2a42.61,42.61,0,0,1-6.34-11A38.79,38.79,0,0,1,1.11,70.29,37,37,0,0,1,13.6,50.54l.1-.09a41.08,41.08,0,0,1,11-6.38c7.39-2.9,17.93-2.77,26-2.68,5.21.06,9.34.11,10.19-.49a4.8,4.8,0,0,0,1-.91,5.11,5.11,0,0,0,.56-.84c0-.26,0-.52-.07-.78a16,16,0,0,1-.06-4.2,98.51,98.51,0,0,0-18.76-3.68c-7.48-.83-15.44-1.19-23.47-1.41l-1.35,0c-2.59,0-4.86,0-7.46-1.67A9,9,0,0,1,8,23.68a9.67,9.67,0,0,1-.91-5A10.91,10.91,0,0,1,8.49,14a8.74,8.74,0,0,1,3.37-3.29A8.2,8.2,0,0,1,14.15,10ZM69.14,22a54.75,54.75,0,0,1,4.94-3.24,124.88,124.88,0,0,0-18.8-9A106.89,106.89,0,0,0,34.17,4.31C31,3.81,26.44,3.25,22.89,4c-2.55.56-4.59,1.92-5,4.79a134.49,134.49,0,0,1,26.3,3.8,115.69,115.69,0,0,1,25,9.4ZM64,28.65c.21-.44.42-.86.66-1.28a15.26,15.26,0,0,1,1.73-2.47,146.24,146.24,0,0,0-14.92-6.2,97.69,97.69,0,0,0-15.34-4A123.57,123.57,0,0,0,21.07,13.2c-3.39-.08-6.3.08-7.47.72a5.21,5.21,0,0,0-2,1.94,7.3,7.3,0,0,0-1,3.12,6.1,6.1,0,0,0,.55,3.11,5.43,5.43,0,0,0,2,2.21c1.73,1.09,3.5,1.1,5.51,1.12h1.43c8.16.23,16.23.59,23.78,1.42a103.41,103.41,0,0,1,19.22,3.76,17.84,17.84,0,0,1,.85-2Zm-.76,15.06-.21.16c-1.82,1.3-6.48,1.24-12.35,1.17C42.91,45,32.79,44.83,26,47.47a37.41,37.41,0,0,0-10,5.81l-.1.08A33.44,33.44,0,0,0,4.66,71.17a35.14,35.14,0,0,0,1.5,21.32A39.47,39.47,0,0,0,12.35,103a1.82,1.82,0,0,1,.42,1.16v12a3.05,3.05,0,0,0,.68,2.37,4.28,4.28,0,0,0,3.16.73H67.68a10,10,0,0,0-1.11-3.69,4.7,4.7,0,0,0-2.87-2.32,15.08,15.08,0,0,0-4.4-.38h-26a1.83,1.83,0,0,1-.15-3.65c5.73-.72,10.35-2.74,13.57-6.25,3.06-3.34,4.91-8.1,5.33-14.45v-.13A18.88,18.88,0,0,0,46.35,75a20.22,20.22,0,0,0-7.41-4.42,23.54,23.54,0,0,0-8.52-1.25c-4.7.19-9.11,1.83-12,4.83a1.83,1.83,0,0,1-2.65-2.52c3.53-3.71,8.86-5.73,14.47-6a27.05,27.05,0,0,1,9.85,1.44,24,24,0,0,1,8.74,5.23,22.48,22.48,0,0,1,6.85,15.82v.08a2.17,2.17,0,0,1,0,.36c-.47,7.25-2.66,12.77-6.3,16.75a21.24,21.24,0,0,1-4.62,3.77H57.35q4.44-2.39,8.39-5c2.68-1.79,5.22-3.69,7.63-5.67a1.82,1.82,0,0,1,2.57.24,1.69,1.69,0,0,1,.35.66L81,115.62a7,7,0,0,0,2.16,2.62,5.06,5.06,0,0,0,3,.9H96.88a6.56,6.56,0,0,0-1.68-4.38,7.19,7.19,0,0,0-4.74-1.83c-.36,0-.69,0-1,0a1.83,1.83,0,0,1-1.83-1.83V83.6a1.75,1.75,0,0,1,.23-.88,105.11,105.11,0,0,0,5.34-12.46,52,52,0,0,0,2.55-10.44l-1.23.1c-7.23.52-14.52-.12-20.34-3A20,20,0,0,1,63.26,43.71Z"/>'
"</g>";
string private constant _APEX =
'<g transform="scale(0.5) translate(533, 790)">'
'<circle r="39" stroke="#ededed" fill="transparent"/>'
'<path fill="#ededed" '
'd="M0,38 a38,38 0 0 1 0,-76 a19,19 0 0 1 0,38 a19,19 0 0 0 0,38 z m -5 -57 a 5,5 0 1,0 10,0 a 5,5 0 1,0 -10,0 z" '
'fill-rule="evenodd"/>'
'<path fill="#ededed" '
'd="m -5, 19 a 5,5 0 1,0 10,0 a 5,5 0 1,0 -10,0"/>'
"</g>";
string private constant _LOGO =
'<path fill="#ededed" '
'd="M122.7,227.1 l-4.8,0l55.8,-74l0,3.2l-51.8,-69.2l5,0l48.8,65.4l-1.2,0l48.8,-65.4l4.8,0l-51.2,68.4l0,-1.6l55.2,73.2l-5,0l-52.8,-70.2l1.2,0l-52.8,70.2z" '
'vector-effect="non-scaling-stroke" />';
/**
@dev internal helper to create HSL-encoded color prop for SVG tags
*/
function colorHSL(Color memory c) internal pure returns (bytes memory) {
return abi.encodePacked("hsl(", c.h.toString(), ", ", c.s.toString(), "%, ", c.l.toString(), "%)");
}
/**
@dev internal helper to create `stop` SVG tag
*/
function colorStop(Color memory c) internal pure returns (bytes memory) {
return
abi.encodePacked(
'<stop stop-color="',
colorHSL(c),
'" stop-opacity="',
c.a.toString(),
'" offset="',
c.off.toString(),
'%"/>'
);
}
/**
@dev internal helper to encode position for `Gradient` SVG tag
*/
function pos(uint256[4] memory coords) internal pure returns (bytes memory) {
return
abi.encodePacked(
'x1="',
coords[0].toString(),
'%" '
'y1="',
coords[1].toString(),
'%" '
'x2="',
coords[2].toString(),
'%" '
'y2="',
coords[3].toString(),
'%" '
);
}
/**
@dev internal helper to create `Gradient` SVG tag
*/
function linearGradient(
Color[] memory colors,
uint256 id,
uint256[4] memory coords
) internal pure returns (bytes memory) {
string memory stops = "";
for (uint256 i = 0; i < colors.length; i++) {
if (colors[i].h != 0) {
stops = string.concat(stops, string(colorStop(colors[i])));
}
}
return
abi.encodePacked(
"<linearGradient ",
pos(coords),
'id="g',
id.toString(),
'">',
stops,
"</linearGradient>"
);
}
/**
@dev internal helper to create `Defs` SVG tag
*/
function defs(Gradient memory grad) internal pure returns (bytes memory) {
return abi.encodePacked("<defs>", linearGradient(grad.colors, 0, grad.coords), "</defs>");
}
/**
@dev internal helper to create `Rect` SVG tag
*/
function rect(uint256 id) internal pure returns (bytes memory) {
return
abi.encodePacked(
"<rect "
'width="100%" '
'height="100%" '
'fill="url(#g',
id.toString(),
')" '
'rx="10px" '
'ry="10px" '
'stroke-linejoin="round" '
"/>"
);
}
/**
@dev internal helper to create border `Rect` SVG tag
*/
function border() internal pure returns (string memory) {
return
"<rect "
'width="94%" '
'height="96%" '
'fill="transparent" '
'rx="10px" '
'ry="10px" '
'stroke-linejoin="round" '
'x="3%" '
'y="2%" '
'stroke-dasharray="1,6" '
'stroke="white" '
"/>";
}
/**
@dev internal helper to create group `G` SVG tag
*/
function g(uint256 gradientsCount) internal pure returns (bytes memory) {
string memory background = "";
for (uint256 i = 0; i < gradientsCount; i++) {
background = string.concat(background, string(rect(i)));
}
return abi.encodePacked("<g>", background, border(), "</g>");
}
/**
@dev internal helper to create XEN logo line pattern with 2 SVG `lines`
*/
function logo() internal pure returns (bytes memory) {
return abi.encodePacked();
}
/**
@dev internal helper to create `Text` SVG tag with XEN Crypto contract data
*/
function contractData(string memory symbol, address xenAddress) internal pure returns (bytes memory) {
return
abi.encodePacked(
"<text "
'x="50%" '
'y="5%" '
'class="base small" '
'dominant-baseline="middle" '
'text-anchor="middle">',
symbol,
unicode"・",
xenAddress.toHexString(),
"</text>"
);
}
/**
@dev internal helper to create cRank range string
*/
function rankAndCount(uint256 rank, uint256 count) internal pure returns (bytes memory) {
if (count == 1) return abi.encodePacked(rank.toString());
return abi.encodePacked(rank.toString(), "..", (rank + count - 1).toString());
}
/**
@dev internal helper to create 1st part of metadata section of SVG
*/
function meta1(
uint256 tokenId,
uint256 count,
uint256 eaa,
string memory series,
uint256 xenBurned
) internal pure returns (bytes memory) {
bytes memory part1 = abi.encodePacked(
"<text "
'x="50%" '
'y="50%" '
'class="base " '
'dominant-baseline="middle" '
'text-anchor="middle">'
"XEN CRYPTO"
"</text>"
"<text "
'x="50%" '
'y="56%" '
'class="base burn" '
'text-anchor="middle" '
'dominant-baseline="middle"> ',
xenBurned > 0 ? string.concat((xenBurned / 10**18).toFormattedString(), " X") : "",
"</text>"
"<text "
'x="18%" '
'y="62%" '
'class="base meta" '
'dominant-baseline="middle"> '
"#",
tokenId.toString(),
"</text>"
"<text "
'x="82%" '
'y="62%" '
'class="base meta series" '
'dominant-baseline="middle" '
'text-anchor="end" >',
series,
"</text>"
);
bytes memory part2 = abi.encodePacked(
"<text "
'x="18%" '
'y="68%" '
'class="base meta" '
'dominant-baseline="middle" >'
"VMU: ",
count.toString(),
"</text>"
"<text "
'x="18%" '
'y="72%" '
'class="base meta" '
'dominant-baseline="middle" >'
"EAA: ",
(eaa / 10).toString(),
"%"
"</text>"
);
return abi.encodePacked(part1, part2);
}
/**
@dev internal helper to create 2nd part of metadata section of SVG
*/
function meta2(
uint256 maturityTs,
uint256 amp,
uint256 term,
uint256 rank,
uint256 count
) internal pure returns (bytes memory) {
bytes memory part3 = abi.encodePacked(
"<text "
'x="18%" '
'y="76%" '
'class="base meta" '
'dominant-baseline="middle" >'
"AMP: ",
amp.toString(),
"</text>"
"<text "
'x="18%" '
'y="80%" '
'class="base meta" '
'dominant-baseline="middle" >'
"Term: ",
term.toString()
);
bytes memory part4 = abi.encodePacked(
" days"
"</text>"
"<text "
'x="18%" '
'y="84%" '
'class="base meta" '
'dominant-baseline="middle" >'
"cRank: ",
rankAndCount(rank, count),
"</text>"
"<text "
'x="18%" '
'y="88%" '
'class="base meta" '
'dominant-baseline="middle" >'
"Maturity: ",
maturityTs.asString(),
"</text>"
);
return abi.encodePacked(part3, part4);
}
/**
@dev internal helper to create `Text` SVG tag for XEN quote
*/
function quote(uint256 idx) internal pure returns (bytes memory) {
return
abi.encodePacked(
"<text "
'x="50%" '
'y="95%" '
'class="base small" '
'dominant-baseline="middle" '
'text-anchor="middle" >',
StringData.getQuote(StringData.QUOTES, idx),
"</text>"
);
}
/**
@dev internal helper to generate `Redeemed` stamp
*/
function stamp(bool redeemed) internal pure returns (bytes memory) {
if (!redeemed) return "";
return
abi.encodePacked(
"<rect "
'x="50%" '
'y="77.5%" '
'width="100" '
'height="40" '
'stroke="black" '
'stroke-width="1" '
'fill="none" '
'rx="5px" '
'ry="5px" '
'transform="translate(-50,-20) '
'rotate(-20,0,400)" />',
"<text "
'x="50%" '
'y="77.5%" '
'stroke="black" '
'class="base meta" '
'dominant-baseline="middle" '
'text-anchor="middle" '
'transform="translate(0,0) rotate(-20,-45,380)" >'
"Redeemed"
"</text>"
);
}
/**
@dev main internal helper to create SVG file representing XENFT
*/
function image(
SvgParams memory params,
Gradient[] memory gradients,
uint256 idx,
bool apex,
bool limited
) internal pure returns (bytes memory) {
string memory mark = limited ? _LIMITED : apex ? _APEX : _COLLECTOR;
bytes memory graphics = abi.encodePacked(defs(gradients[0]), _STYLE, g(gradients.length), _LOGO, mark);
bytes memory metadata = abi.encodePacked(
contractData(params.symbol, params.xenAddress),
meta1(params.tokenId, params.count, params.eaa, params.series, params.xenBurned),
meta2(params.maturityTs, params.amp, params.term, params.rank, params.count),
quote(idx),
stamp(params.redeemed)
);
return
abi.encodePacked(
"<svg "
'xmlns="http://www.w3.org/2000/svg" '
'preserveAspectRatio="xMinYMin meet" '
'viewBox="0 0 350 566">',
graphics,
metadata,
"</svg>"
);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
// mapping: NFT tokenId => MintInfo (used in tokenURI generation)
// MintInfo encoded as:
// term (uint16)
// | maturityTs (uint64)
// | rank (uint128)
// | amp (uint16)
// | eaa (uint16)
// | class (uint8):
// [7] isApex
// [6] isLimited
// [0-5] powerGroupIdx
// | redeemed (uint8)
library MintInfo {
/**
@dev helper to convert Bool to U256 type and make compiler happy
*/
function toU256(bool x) internal pure returns (uint256 r) {
assembly {
r := x
}
}
/**
@dev encodes MintInfo record from its props
*/
function encodeMintInfo(
uint256 term,
uint256 maturityTs,
uint256 rank,
uint256 amp,
uint256 eaa,
uint256 class_,
bool redeemed
) public pure returns (uint256 info) {
info = info | (toU256(redeemed) & 0xFF);
info = info | ((class_ & 0xFF) << 8);
info = info | ((eaa & 0xFFFF) << 16);
info = info | ((amp & 0xFFFF) << 32);
info = info | ((rank & 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF) << 48);
info = info | ((maturityTs & 0xFFFFFFFFFFFFFFFF) << 176);
info = info | ((term & 0xFFFF) << 240);
}
/**
@dev decodes MintInfo record and extracts all of its props
*/
function decodeMintInfo(uint256 info)
public
pure
returns (
uint256 term,
uint256 maturityTs,
uint256 rank,
uint256 amp,
uint256 eaa,
uint256 class,
bool apex,
bool limited,
bool redeemed
)
{
term = uint16(info >> 240);
maturityTs = uint64(info >> 176);
rank = uint128(info >> 48);
amp = uint16(info >> 32);
eaa = uint16(info >> 16);
class = uint8(info >> 8) & 0x3F;
apex = (uint8(info >> 8) & 0x80) > 0;
limited = (uint8(info >> 8) & 0x40) > 0;
redeemed = uint8(info) == 1;
}
/**
@dev extracts `term` prop from encoded MintInfo
*/
function getTerm(uint256 info) public pure returns (uint256 term) {
(term, , , , , , , , ) = decodeMintInfo(info);
}
/**
@dev extracts `maturityTs` prop from encoded MintInfo
*/
function getMaturityTs(uint256 info) public pure returns (uint256 maturityTs) {
(, maturityTs, , , , , , , ) = decodeMintInfo(info);
}
/**
@dev extracts `rank` prop from encoded MintInfo
*/
function getRank(uint256 info) public pure returns (uint256 rank) {
(, , rank, , , , , , ) = decodeMintInfo(info);
}
/**
@dev extracts `AMP` prop from encoded MintInfo
*/
function getAMP(uint256 info) public pure returns (uint256 amp) {
(, , , amp, , , , , ) = decodeMintInfo(info);
}
/**
@dev extracts `EAA` prop from encoded MintInfo
*/
function getEAA(uint256 info) public pure returns (uint256 eaa) {
(, , , , eaa, , , , ) = decodeMintInfo(info);
}
/**
@dev extracts `redeemed` prop from encoded MintInfo
*/
function getClass(uint256 info)
public
pure
returns (
uint256 class_,
bool apex,
bool limited
)
{
(, , , , , class_, apex, limited, ) = decodeMintInfo(info);
}
/**
@dev extracts `redeemed` prop from encoded MintInfo
*/
function getRedeemed(uint256 info) public pure returns (bool redeemed) {
(, , , , , , , , redeemed) = decodeMintInfo(info);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "@openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "./MintInfo.sol";
import "./DateTime.sol";
import "./FormattedStrings.sol";
import "./SVG.sol";
/**
@dev Library contains methods to generate on-chain NFT metadata
*/
library Metadata {
using DateTime for uint256;
using MintInfo for uint256;
using Strings for uint256;
uint256 public constant POWER_GROUP_SIZE = 7_500;
uint256 public constant MAX_POWER = 52_500;
uint256 public constant COLORS_FULL_SCALE = 300;
uint256 public constant SPECIAL_LUMINOSITY = 45;
uint256 public constant BASE_SATURATION = 75;
uint256 public constant BASE_LUMINOSITY = 38;
uint256 public constant GROUP_SATURATION = 100;
uint256 public constant GROUP_LUMINOSITY = 50;
uint256 public constant DEFAULT_OPACITY = 1;
uint256 public constant NO_COLOR = 360;
// PRIVATE HELPERS
// The following pure methods returning arrays are workaround to use array constants,
// not yet available in Solidity
function _powerGroupColors() private pure returns (uint256[8] memory) {
return [uint256(360), 1, 30, 60, 120, 180, 240, 300];
}
function _huesApex() private pure returns (uint256[3] memory) {
return [uint256(169), 210, 305];
}
function _huesLimited() private pure returns (uint256[3] memory) {
return [uint256(263), 0, 42];
}
function _stopOffsets() private pure returns (uint256[3] memory) {
return [uint256(10), 50, 90];
}
function _gradColorsRegular() private pure returns (uint256[4] memory) {
return [uint256(150), 150, 20, 20];
}
function _gradColorsBlack() private pure returns (uint256[4] memory) {
return [uint256(100), 100, 20, 20];
}
function _gradColorsSpecial() private pure returns (uint256[4] memory) {
return [uint256(100), 100, 0, 0];
}
/**
@dev private helper to determine XENFT group index by its power
(power = count of VMUs * mint term in days)
*/
function _powerGroup(uint256 vmus, uint256 term) private pure returns (uint256) {
return (vmus * term) / POWER_GROUP_SIZE;
}
/**
@dev private helper to generate SVG gradients for special XENFT categories
*/
function _specialClassGradients(bool rare) private pure returns (SVG.Gradient[] memory gradients) {
uint256[3] memory specialColors = rare ? _huesApex() : _huesLimited();
SVG.Color[] memory colors = new SVG.Color[](3);
for (uint256 i = 0; i < colors.length; i++) {
colors[i] = SVG.Color({
h: specialColors[i],
s: BASE_SATURATION,
l: SPECIAL_LUMINOSITY,
a: DEFAULT_OPACITY,
off: _stopOffsets()[i]
});
}
gradients = new SVG.Gradient[](1);
gradients[0] = SVG.Gradient({colors: colors, id: 0, coords: _gradColorsSpecial()});
}
/**
@dev private helper to generate SVG gradients for common XENFT category
*/
function _commonCategoryGradients(uint256 vmus, uint256 term)
private
pure
returns (SVG.Gradient[] memory gradients)
{
SVG.Color[] memory colors = new SVG.Color[](2);
uint256 powerHue = term * vmus > MAX_POWER ? NO_COLOR : 1 + (term * vmus * COLORS_FULL_SCALE) / MAX_POWER;
// group
uint256 groupHue = _powerGroupColors()[_powerGroup(vmus, term) > 7 ? 7 : _powerGroup(vmus, term)];
colors[0] = SVG.Color({
h: groupHue,
s: groupHue == NO_COLOR ? 0 : GROUP_SATURATION,
l: groupHue == NO_COLOR ? 0 : GROUP_LUMINOSITY,
a: DEFAULT_OPACITY,
off: _stopOffsets()[0]
});
// power
colors[1] = SVG.Color({
h: powerHue,
s: powerHue == NO_COLOR ? 0 : BASE_SATURATION,
l: powerHue == NO_COLOR ? 0 : BASE_LUMINOSITY,
a: DEFAULT_OPACITY,
off: _stopOffsets()[2]
});
gradients = new SVG.Gradient[](1);
gradients[0] = SVG.Gradient({
colors: colors,
id: 0,
coords: groupHue == NO_COLOR ? _gradColorsBlack() : _gradColorsRegular()
});
}
// PUBLIC INTERFACE
/**
@dev public interface to generate SVG image based on XENFT params
*/
function svgData(
uint256 tokenId,
uint256 count,
uint256 info,
address token,
uint256 burned
) external view returns (bytes memory) {
string memory symbol = IERC20Metadata(token).symbol();
(uint256 classIds, bool rare, bool limited) = info.getClass();
SVG.SvgParams memory params = SVG.SvgParams({
symbol: symbol,
xenAddress: token,
tokenId: tokenId,
term: info.getTerm(),
rank: info.getRank(),
count: count,
maturityTs: info.getMaturityTs(),
amp: info.getAMP(),
eaa: info.getEAA(),
xenBurned: burned,
series: StringData.getClassName(StringData.CLASSES, classIds),
redeemed: info.getRedeemed()
});
uint256 quoteIdx = uint256(keccak256(abi.encode(info))) % StringData.QUOTES_COUNT;
if (rare || limited) {
return SVG.image(params, _specialClassGradients(rare), quoteIdx, rare, limited);
}
return SVG.image(params, _commonCategoryGradients(count, info.getTerm()), quoteIdx, rare, limited);
}
function _attr1(
uint256 count,
uint256 rank,
uint256 class_
) private pure returns (bytes memory) {
return
abi.encodePacked(
'{"trait_type":"Class","value":"',
StringData.getClassName(StringData.CLASSES, class_),
'"},'
'{"trait_type":"VMUs","value":"',
count.toString(),
'"},'
'{"trait_type":"cRank","value":"',
rank.toString(),
'"},'
);
}
function _attr2(
uint256 amp,
uint256 eaa,
uint256 maturityTs
) private pure returns (bytes memory) {
(uint256 year, string memory month) = DateTime.yearAndMonth(maturityTs);
return
abi.encodePacked(
'{"trait_type":"AMP","value":"',
amp.toString(),
'"},'
'{"trait_type":"EAA (%)","value":"',
(eaa / 10).toString(),
'"},'
'{"trait_type":"Maturity Year","value":"',
year.toString(),
'"},'
'{"trait_type":"Maturity Month","value":"',
month,
'"},'
);
}
function _attr3(
uint256 maturityTs,
uint256 term,
uint256 burned
) private pure returns (bytes memory) {
return
abi.encodePacked(
'{"trait_type":"Maturity DateTime","value":"',
maturityTs.asString(),
'"},'
'{"trait_type":"Term","value":"',
term.toString(),
'"},'
'{"trait_type":"XEN Burned","value":"',
(burned / 10**18).toString(),
'"},'
);
}
function _attr4(bool apex, bool limited) private pure returns (bytes memory) {
string memory category = "Collector";
if (limited) category = "Limited";
if (apex) category = "Apex";
return abi.encodePacked('{"trait_type":"Category","value":"', category, '"}');
}
/**
@dev private helper to construct attributes portion of NFT metadata
*/
function attributes(
uint256 count,
uint256 burned,
uint256 mintInfo
) external pure returns (bytes memory) {
(
uint256 term,
uint256 maturityTs,
uint256 rank,
uint256 amp,
uint256 eaa,
uint256 series,
bool apex,
bool limited,
) = MintInfo.decodeMintInfo(mintInfo);
return
abi.encodePacked(
"[",
_attr1(count, rank, series),
_attr2(amp, eaa, maturityTs),
_attr3(maturityTs, term, burned),
_attr4(apex, limited),
"]"
);
}
function formattedString(uint256 n) public pure returns (string memory) {
return FormattedStrings.toFormattedString(n);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
library FormattedStrings {
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
Base on OpenZeppelin `toString` method from `String` library
*/
function toFormattedString(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;
}
uint256 pos;
uint256 comas = digits / 3;
digits = digits + (digits % 3 == 0 ? comas - 1 : comas);
bytes memory buffer = new bytes(digits);
while (value != 0) {
digits -= 1;
if (pos == 3) {
buffer[digits] = ",";
pos = 0;
} else {
buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
value /= 10;
pos++;
}
}
return string(buffer);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (metatx/ERC2771Context.sol)
pragma solidity ^0.8.10;
import "@openzeppelin/contracts/utils/Context.sol";
/**
* @dev Context variant with ERC2771 support.
*/
abstract contract ERC2771Context is Context {
/// @custom:oz-upgrades-unsafe-allow state-variable-immutable
// one-time settable var
address internal _trustedForwarder;
/// @custom:oz-upgrades-unsafe-allow constructor
constructor(address trustedForwarder) {
_trustedForwarder = trustedForwarder;
}
function isTrustedForwarder(address forwarder) public view virtual returns (bool) {
return forwarder == _trustedForwarder;
}
function _msgSender() internal view virtual override returns (address sender) {
if (isTrustedForwarder(msg.sender)) {
// The assembly code is more direct than the Solidity version using `abi.decode`.
/// @solidity memory-safe-assembly
assembly {
sender := shr(96, calldataload(sub(calldatasize(), 20)))
}
} else {
return super._msgSender();
}
}
function _msgData() internal view virtual override returns (bytes calldata) {
if (isTrustedForwarder(msg.sender)) {
return msg.data[:msg.data.length - 20];
} else {
return super._msgData();
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "@openzeppelin/contracts/utils/Strings.sol";
import "./BokkyPooBahsDateTimeLibrary.sol";
/*
@dev Library to convert epoch timestamp to a human-readable Date-Time string
@dependency uses BokkyPooBahsDateTimeLibrary.sol library internally
*/
library DateTime {
using Strings for uint256;
bytes public constant MONTHS = bytes("JanFebMarAprMayJunJulAugSepOctNovDec");
/**
* @dev returns month as short (3-letter) string
*/
function monthAsString(uint256 idx) internal pure returns (string memory) {
require(idx > 0, "bad idx");
bytes memory str = new bytes(3);
uint256 offset = (idx - 1) * 3;
str[0] = bytes1(MONTHS[offset]);
str[1] = bytes1(MONTHS[offset + 1]);
str[2] = bytes1(MONTHS[offset + 2]);
return string(str);
}
/**
* @dev returns string representation of number left-padded for 2 symbols
*/
function asPaddedString(uint256 n) internal pure returns (string memory) {
if (n == 0) return "00";
if (n < 10) return string.concat("0", n.toString());
return n.toString();
}
/**
* @dev returns string of format 'Jan 01, 2022 18:00 UTC' for a given timestamp
*/
function asString(uint256 ts) external pure returns (string memory) {
(uint256 year, uint256 month, uint256 day, uint256 hour, uint256 minute, ) = BokkyPooBahsDateTimeLibrary
.timestampToDateTime(ts);
return
string(
abi.encodePacked(
monthAsString(month),
" ",
day.toString(),
", ",
year.toString(),
" ",
asPaddedString(hour),
":",
asPaddedString(minute),
" UTC"
)
);
}
/**
* @dev returns (year, month as string) components of a date by timestamp
*/
function yearAndMonth(uint256 ts) external pure returns (uint256, string memory) {
(uint256 year, uint256 month, , , , ) = BokkyPooBahsDateTimeLibrary.timestampToDateTime(ts);
return (year, monthAsString(month));
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
// ----------------------------------------------------------------------------
// BokkyPooBah's DateTime Library v1.01
//
// A gas-efficient Solidity date and time library
//
// https://github.com/bokkypoobah/BokkyPooBahsDateTimeLibrary
//
// Tested date range 1970/01/01 to 2345/12/31
//
// Conventions:
// Unit | Range | Notes
// :-------- |:-------------:|:-----
// timestamp | >= 0 | Unix timestamp, number of seconds since 1970/01/01 00:00:00 UTC
// year | 1970 ... 2345 |
// month | 1 ... 12 |
// day | 1 ... 31 |
// hour | 0 ... 23 |
// minute | 0 ... 59 |
// second | 0 ... 59 |
// dayOfWeek | 1 ... 7 | 1 = Monday, ..., 7 = Sunday
//
//
// Enjoy. (c) BokkyPooBah / Bok Consulting Pty Ltd 2018-2019. The MIT Licence.
// ----------------------------------------------------------------------------
library BokkyPooBahsDateTimeLibrary {
uint256 constant _SECONDS_PER_DAY = 24 * 60 * 60;
uint256 constant _SECONDS_PER_HOUR = 60 * 60;
uint256 constant _SECONDS_PER_MINUTE = 60;
int256 constant _OFFSET19700101 = 2440588;
uint256 constant _DOW_FRI = 5;
uint256 constant _DOW_SAT = 6;
// ------------------------------------------------------------------------
// Calculate the number of days from 1970/01/01 to year/month/day using
// the date conversion algorithm from
// https://aa.usno.navy.mil/faq/JD_formula.html
// and subtracting the offset 2440588 so that 1970/01/01 is day 0
//
// days = day
// - 32075
// + 1461 * (year + 4800 + (month - 14) / 12) / 4
// + 367 * (month - 2 - (month - 14) / 12 * 12) / 12
// - 3 * ((year + 4900 + (month - 14) / 12) / 100) / 4
// - offset
// ------------------------------------------------------------------------
function _daysFromDate(
uint256 year,
uint256 month,
uint256 day
) private pure returns (uint256 _days) {
require(year >= 1970);
int256 _year = int256(year);
int256 _month = int256(month);
int256 _day = int256(day);
int256 __days = _day -
32075 +
(1461 * (_year + 4800 + (_month - 14) / 12)) /
4 +
(367 * (_month - 2 - ((_month - 14) / 12) * 12)) /
12 -
(3 * ((_year + 4900 + (_month - 14) / 12) / 100)) /
4 -
_OFFSET19700101;
_days = uint256(__days);
}
// ------------------------------------------------------------------------
// Calculate year/month/day from the number of days since 1970/01/01 using
// the date conversion algorithm from
// http://aa.usno.navy.mil/faq/docs/JD_Formula.php
// and adding the offset 2440588 so that 1970/01/01 is day 0
//
// int L = days + 68569 + offset
// int N = 4 * L / 146097
// L = L - (146097 * N + 3) / 4
// year = 4000 * (L + 1) / 1461001
// L = L - 1461 * year / 4 + 31
// month = 80 * L / 2447
// dd = L - 2447 * month / 80
// L = month / 11
// month = month + 2 - 12 * L
// year = 100 * (N - 49) + year + L
// ------------------------------------------------------------------------
function _daysToDate(uint256 _days)
private
pure
returns (
uint256 year,
uint256 month,
uint256 day
)
{
int256 __days = int256(_days);
int256 L = __days + 68569 + _OFFSET19700101;
int256 N = (4 * L) / 146097;
L = L - (146097 * N + 3) / 4;
int256 _year = (4000 * (L + 1)) / 1461001;
L = L - (1461 * _year) / 4 + 31;
int256 _month = (80 * L) / 2447;
int256 _day = L - (2447 * _month) / 80;
L = _month / 11;
_month = _month + 2 - 12 * L;
_year = 100 * (N - 49) + _year + L;
year = uint256(_year);
month = uint256(_month);
day = uint256(_day);
}
function timestampFromDate(
uint256 year,
uint256 month,
uint256 day
) internal pure returns (uint256 timestamp) {
timestamp = _daysFromDate(year, month, day) * _SECONDS_PER_DAY;
}
function timestampFromDateTime(
uint256 year,
uint256 month,
uint256 day,
uint256 hour,
uint256 minute,
uint256 second
) internal pure returns (uint256 timestamp) {
timestamp =
_daysFromDate(year, month, day) *
_SECONDS_PER_DAY +
hour *
_SECONDS_PER_HOUR +
minute *
_SECONDS_PER_MINUTE +
second;
}
function timestampToDate(uint256 timestamp)
internal
pure
returns (
uint256 year,
uint256 month,
uint256 day
)
{
(year, month, day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
}
function timestampToDateTime(uint256 timestamp)
internal
pure
returns (
uint256 year,
uint256 month,
uint256 day,
uint256 hour,
uint256 minute,
uint256 second
)
{
(year, month, day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
uint256 secs = timestamp % _SECONDS_PER_DAY;
hour = secs / _SECONDS_PER_HOUR;
secs = secs % _SECONDS_PER_HOUR;
minute = secs / _SECONDS_PER_MINUTE;
second = secs % _SECONDS_PER_MINUTE;
}
function isValidDate(
uint256 year,
uint256 month,
uint256 day
) internal pure returns (bool valid) {
if (year >= 1970 && month > 0 && month <= 12) {
uint256 daysInMonth = _getDaysInMonth(year, month);
if (day > 0 && day <= daysInMonth) {
valid = true;
}
}
}
function isValidDateTime(
uint256 year,
uint256 month,
uint256 day,
uint256 hour,
uint256 minute,
uint256 second
) internal pure returns (bool valid) {
if (isValidDate(year, month, day)) {
if (hour < 24 && minute < 60 && second < 60) {
valid = true;
}
}
}
function isLeapYear(uint256 timestamp) internal pure returns (bool leapYear) {
(uint256 year, , ) = _daysToDate(timestamp / _SECONDS_PER_DAY);
leapYear = _isLeapYear(year);
}
function _isLeapYear(uint256 year) private pure returns (bool leapYear) {
leapYear = ((year % 4 == 0) && (year % 100 != 0)) || (year % 400 == 0);
}
function isWeekDay(uint256 timestamp) internal pure returns (bool weekDay) {
weekDay = getDayOfWeek(timestamp) <= _DOW_FRI;
}
function isWeekEnd(uint256 timestamp) internal pure returns (bool weekEnd) {
weekEnd = getDayOfWeek(timestamp) >= _DOW_SAT;
}
function getDaysInMonth(uint256 timestamp) internal pure returns (uint256 daysInMonth) {
(uint256 year, uint256 month, ) = _daysToDate(timestamp / _SECONDS_PER_DAY);
daysInMonth = _getDaysInMonth(year, month);
}
function _getDaysInMonth(uint256 year, uint256 month) private pure returns (uint256 daysInMonth) {
if (month == 1 || month == 3 || month == 5 || month == 7 || month == 8 || month == 10 || month == 12) {
daysInMonth = 31;
} else if (month != 2) {
daysInMonth = 30;
} else {
daysInMonth = _isLeapYear(year) ? 29 : 28;
}
}
// 1 = Monday, 7 = Sunday
function getDayOfWeek(uint256 timestamp) internal pure returns (uint256 dayOfWeek) {
uint256 _days = timestamp / _SECONDS_PER_DAY;
dayOfWeek = ((_days + 3) % 7) + 1;
}
function getYear(uint256 timestamp) internal pure returns (uint256 year) {
(year, , ) = _daysToDate(timestamp / _SECONDS_PER_DAY);
}
function getMonth(uint256 timestamp) internal pure returns (uint256 month) {
(, month, ) = _daysToDate(timestamp / _SECONDS_PER_DAY);
}
function getDay(uint256 timestamp) internal pure returns (uint256 day) {
(, , day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
}
function getHour(uint256 timestamp) internal pure returns (uint256 hour) {
uint256 secs = timestamp % _SECONDS_PER_DAY;
hour = secs / _SECONDS_PER_HOUR;
}
function getMinute(uint256 timestamp) internal pure returns (uint256 minute) {
uint256 secs = timestamp % _SECONDS_PER_HOUR;
minute = secs / _SECONDS_PER_MINUTE;
}
function getSecond(uint256 timestamp) internal pure returns (uint256 second) {
second = timestamp % _SECONDS_PER_MINUTE;
}
function addYears(uint256 timestamp, uint256 _years) internal pure returns (uint256 newTimestamp) {
(uint256 year, uint256 month, uint256 day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
year += _years;
uint256 daysInMonth = _getDaysInMonth(year, month);
if (day > daysInMonth) {
day = daysInMonth;
}
newTimestamp = _daysFromDate(year, month, day) * _SECONDS_PER_DAY + (timestamp % _SECONDS_PER_DAY);
require(newTimestamp >= timestamp);
}
function addMonths(uint256 timestamp, uint256 _months) internal pure returns (uint256 newTimestamp) {
(uint256 year, uint256 month, uint256 day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
month += _months;
year += (month - 1) / 12;
month = ((month - 1) % 12) + 1;
uint256 daysInMonth = _getDaysInMonth(year, month);
if (day > daysInMonth) {
day = daysInMonth;
}
newTimestamp = _daysFromDate(year, month, day) * _SECONDS_PER_DAY + (timestamp % _SECONDS_PER_DAY);
require(newTimestamp >= timestamp);
}
function addDays(uint256 timestamp, uint256 _days) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp + _days * _SECONDS_PER_DAY;
require(newTimestamp >= timestamp);
}
function addHours(uint256 timestamp, uint256 _hours) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp + _hours * _SECONDS_PER_HOUR;
require(newTimestamp >= timestamp);
}
function addMinutes(uint256 timestamp, uint256 _minutes) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp + _minutes * _SECONDS_PER_MINUTE;
require(newTimestamp >= timestamp);
}
function addSeconds(uint256 timestamp, uint256 _seconds) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp + _seconds;
require(newTimestamp >= timestamp);
}
function subYears(uint256 timestamp, uint256 _years) internal pure returns (uint256 newTimestamp) {
(uint256 year, uint256 month, uint256 day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
year -= _years;
uint256 daysInMonth = _getDaysInMonth(year, month);
if (day > daysInMonth) {
day = daysInMonth;
}
newTimestamp = _daysFromDate(year, month, day) * _SECONDS_PER_DAY + (timestamp % _SECONDS_PER_DAY);
require(newTimestamp <= timestamp);
}
function subMonths(uint256 timestamp, uint256 _months) internal pure returns (uint256 newTimestamp) {
(uint256 year, uint256 month, uint256 day) = _daysToDate(timestamp / _SECONDS_PER_DAY);
uint256 yearMonth = year * 12 + (month - 1) - _months;
year = yearMonth / 12;
month = (yearMonth % 12) + 1;
uint256 daysInMonth = _getDaysInMonth(year, month);
if (day > daysInMonth) {
day = daysInMonth;
}
newTimestamp = _daysFromDate(year, month, day) * _SECONDS_PER_DAY + (timestamp % _SECONDS_PER_DAY);
require(newTimestamp <= timestamp);
}
function subDays(uint256 timestamp, uint256 _days) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp - _days * _SECONDS_PER_DAY;
require(newTimestamp <= timestamp);
}
function subHours(uint256 timestamp, uint256 _hours) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp - _hours * _SECONDS_PER_HOUR;
require(newTimestamp <= timestamp);
}
function subMinutes(uint256 timestamp, uint256 _minutes) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp - _minutes * _SECONDS_PER_MINUTE;
require(newTimestamp <= timestamp);
}
function subSeconds(uint256 timestamp, uint256 _seconds) internal pure returns (uint256 newTimestamp) {
newTimestamp = timestamp - _seconds;
require(newTimestamp <= timestamp);
}
function diffYears(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _years) {
require(fromTimestamp <= toTimestamp);
(uint256 fromYear, , ) = _daysToDate(fromTimestamp / _SECONDS_PER_DAY);
(uint256 toYear, , ) = _daysToDate(toTimestamp / _SECONDS_PER_DAY);
_years = toYear - fromYear;
}
function diffMonths(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _months) {
require(fromTimestamp <= toTimestamp);
(uint256 fromYear, uint256 fromMonth, ) = _daysToDate(fromTimestamp / _SECONDS_PER_DAY);
(uint256 toYear, uint256 toMonth, ) = _daysToDate(toTimestamp / _SECONDS_PER_DAY);
_months = toYear * 12 + toMonth - fromYear * 12 - fromMonth;
}
function diffDays(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _days) {
require(fromTimestamp <= toTimestamp);
_days = (toTimestamp - fromTimestamp) / _SECONDS_PER_DAY;
}
function diffHours(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _hours) {
require(fromTimestamp <= toTimestamp);
_hours = (toTimestamp - fromTimestamp) / _SECONDS_PER_HOUR;
}
function diffMinutes(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _minutes) {
require(fromTimestamp <= toTimestamp);
_minutes = (toTimestamp - fromTimestamp) / _SECONDS_PER_MINUTE;
}
function diffSeconds(uint256 fromTimestamp, uint256 toTimestamp) internal pure returns (uint256 _seconds) {
require(fromTimestamp <= toTimestamp);
_seconds = toTimestamp - fromTimestamp;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
library Array {
function idx(uint256[] memory arr, uint256 item) internal pure returns (uint256 i) {
for (i = 1; i <= arr.length; i++) {
if (arr[i - 1] == item) {
return i;
}
}
i = 0;
}
function addItem(uint256[] storage arr, uint256 item) internal {
if (idx(arr, item) == 0) {
arr.push(item);
}
}
function removeItem(uint256[] storage arr, uint256 item) internal {
uint256 i = idx(arr, item);
if (i > 0) {
arr[i - 1] = arr[arr.length - 1];
arr.pop();
}
}
function contains(uint256[] memory container, uint256[] memory items) internal pure returns (bool) {
if (items.length == 0) return true;
for (uint256 i = 0; i < items.length; i++) {
bool itemIsContained = false;
for (uint256 j = 0; j < container.length; j++) {
itemIsContained = items[i] == container[j];
}
if (!itemIsContained) return false;
}
return true;
}
function asSingletonArray(uint256 element) internal pure returns (uint256[] memory) {
uint256[] memory array = new uint256[](1);
array[0] = element;
return array;
}
function hasDuplicatesOrZeros(uint256[] memory array) internal pure returns (bool) {
for (uint256 i = 0; i < array.length; i++) {
if (array[i] == 0) return true;
for (uint256 j = 0; j < array.length; j++) {
if (array[i] == array[j] && i != j) return true;
}
}
return false;
}
function hasRoguesOrZeros(uint256[] memory array) internal pure returns (bool) {
uint256 _first = array[0];
for (uint256 i = 0; i < array.length; i++) {
if (array[i] == 0 || array[i] != _first) return true;
}
return false;
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IXENTorrent {
event StartTorrent(address indexed user, uint256 count, uint256 term);
event EndTorrent(address indexed user, uint256 tokenId, address to);
function bulkClaimRank(uint256 count, uint256 term) external returns (uint256);
function bulkClaimMintReward(uint256 tokenId, address to) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IXENProxying {
function callClaimRank(uint256 term) external;
function callClaimMintReward(address to) external;
function powerDown() external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IERC2771 {
function isTrustedForwarder(address forwarder) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;
import {IOperatorFilterRegistry} from "./IOperatorFilterRegistry.sol";
/**
* @title OperatorFilterer
* @notice Abstract contract whose constructor automatically registers and optionally subscribes to or copies another
* registrant's entries in the OperatorFilterRegistry.
* @dev This smart contract is meant to be inherited by token contracts so they can use the following:
* - `onlyAllowedOperator` modifier for `transferFrom` and `safeTransferFrom` methods.
* - `onlyAllowedOperatorApproval` modifier for `approve` and `setApprovalForAll` methods.
*/
abstract contract OperatorFilterer {
error OperatorNotAllowed(address operator);
IOperatorFilterRegistry public constant OPERATOR_FILTER_REGISTRY =
IOperatorFilterRegistry(0x000000000000AAeB6D7670E522A718067333cd4E);
constructor(address subscriptionOrRegistrantToCopy, bool subscribe) {
// If an inheriting token contract is deployed to a network without the registry deployed, the modifier
// will not revert, but the contract will need to be registered with the registry once it is deployed in
// order for the modifier to filter addresses.
if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
if (subscribe) {
OPERATOR_FILTER_REGISTRY.registerAndSubscribe(address(this), subscriptionOrRegistrantToCopy);
} else {
if (subscriptionOrRegistrantToCopy != address(0)) {
OPERATOR_FILTER_REGISTRY.registerAndCopyEntries(address(this), subscriptionOrRegistrantToCopy);
} else {
OPERATOR_FILTER_REGISTRY.register(address(this));
}
}
}
}
modifier onlyAllowedOperator(address from) virtual {
// Allow spending tokens from addresses with balance
// Note that this still allows listings and marketplaces with escrow to transfer tokens if transferred
// from an EOA.
if (from != msg.sender) {
_checkFilterOperator(msg.sender);
}
_;
}
modifier onlyAllowedOperatorApproval(address operator) virtual {
_checkFilterOperator(operator);
_;
}
function _checkFilterOperator(address operator) internal view virtual {
// Check registry code length to facilitate testing in environments without a deployed registry.
if (address(OPERATOR_FILTER_REGISTRY).code.length > 0) {
if (!OPERATOR_FILTER_REGISTRY.isOperatorAllowed(address(this), operator)) {
revert OperatorNotAllowed(operator);
}
}
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;
interface IOperatorFilterRegistry {
function isOperatorAllowed(address registrant, address operator) external view returns (bool);
function register(address registrant) external;
function registerAndSubscribe(address registrant, address subscription) external;
function registerAndCopyEntries(address registrant, address registrantToCopy) external;
function unregister(address addr) external;
function updateOperator(address registrant, address operator, bool filtered) external;
function updateOperators(address registrant, address[] calldata operators, bool filtered) external;
function updateCodeHash(address registrant, bytes32 codehash, bool filtered) external;
function updateCodeHashes(address registrant, bytes32[] calldata codeHashes, bool filtered) external;
function subscribe(address registrant, address registrantToSubscribe) external;
function unsubscribe(address registrant, bool copyExistingEntries) external;
function subscriptionOf(address addr) external returns (address registrant);
function subscribers(address registrant) external returns (address[] memory);
function subscriberAt(address registrant, uint256 index) external returns (address);
function copyEntriesOf(address registrant, address registrantToCopy) external;
function isOperatorFiltered(address registrant, address operator) external returns (bool);
function isCodeHashOfFiltered(address registrant, address operatorWithCode) external returns (bool);
function isCodeHashFiltered(address registrant, bytes32 codeHash) external returns (bool);
function filteredOperators(address addr) external returns (address[] memory);
function filteredCodeHashes(address addr) external returns (bytes32[] memory);
function filteredOperatorAt(address registrant, uint256 index) external returns (address);
function filteredCodeHashAt(address registrant, uint256 index) external returns (bytes32);
function isRegistered(address addr) external returns (bool);
function codeHashOf(address addr) external returns (bytes32);
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.13;
import {OperatorFilterer} from "./OperatorFilterer.sol";
/**
* @title DefaultOperatorFilterer
* @notice Inherits from OperatorFilterer and automatically subscribes to the default OpenSea subscription.
*/
abstract contract DefaultOperatorFilterer is OperatorFilterer {
address constant DEFAULT_SUBSCRIPTION = address(0x3cc6CddA760b79bAfa08dF41ECFA224f810dCeB6);
constructor() OperatorFilterer(DEFAULT_SUBSCRIPTION, true) {}
}// SPDX-License-Identifier: BSD-4-Clause /* * ABDK Math 64.64 Smart Contract Library. Copyright © 2019 by ABDK Consulting. * Author: Mikhail Vladimirov <[email protected]> */ pragma solidity ^0.8.0; /** * Smart contract library of mathematical functions operating with signed * 64.64-bit fixed point numbers. Signed 64.64-bit fixed point number is * basically a simple fraction whose numerator is signed 128-bit integer and * denominator is 2^64. As long as denominator is always the same, there is no * need to store it, thus in Solidity signed 64.64-bit fixed point numbers are * represented by int128 type holding only the numerator. */ library ABDKMath64x64 { /* * Minimum value signed 64.64-bit fixed point number may have. */ int128 private constant MIN_64x64 = -0x80000000000000000000000000000000; /* * Maximum value signed 64.64-bit fixed point number may have. */ int128 private constant MAX_64x64 = 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF; /** * Convert signed 256-bit integer number into signed 64.64-bit fixed point * number. Revert on overflow. * * @param x signed 256-bit integer number * @return signed 64.64-bit fixed point number */ function fromInt (int256 x) internal pure returns (int128) { unchecked { require (x >= -0x8000000000000000 && x <= 0x7FFFFFFFFFFFFFFF); return int128 (x << 64); } } /** * Convert signed 64.64 fixed point number into signed 64-bit integer number * rounding down. * * @param x signed 64.64-bit fixed point number * @return signed 64-bit integer number */ function toInt (int128 x) internal pure returns (int64) { unchecked { return int64 (x >> 64); } } /** * Convert unsigned 256-bit integer number into signed 64.64-bit fixed point * number. Revert on overflow. * * @param x unsigned 256-bit integer number * @return signed 64.64-bit fixed point number */ function fromUInt (uint256 x) internal pure returns (int128) { unchecked { require (x <= 0x7FFFFFFFFFFFFFFF); return int128 (int256 (x << 64)); } } /** * Convert signed 64.64 fixed point number into unsigned 64-bit integer * number rounding down. Revert on underflow. * * @param x signed 64.64-bit fixed point number * @return unsigned 64-bit integer number */ function toUInt (int128 x) internal pure returns (uint64) { unchecked { require (x >= 0); return uint64 (uint128 (x >> 64)); } } /** * Convert signed 128.128 fixed point number into signed 64.64-bit fixed point * number rounding down. Revert on overflow. * * @param x signed 128.128-bin fixed point number * @return signed 64.64-bit fixed point number */ function from128x128 (int256 x) internal pure returns (int128) { unchecked { int256 result = x >> 64; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Convert signed 64.64 fixed point number into signed 128.128 fixed point * number. * * @param x signed 64.64-bit fixed point number * @return signed 128.128 fixed point number */ function to128x128 (int128 x) internal pure returns (int256) { unchecked { return int256 (x) << 64; } } /** * Calculate x + y. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function add (int128 x, int128 y) internal pure returns (int128) { unchecked { int256 result = int256(x) + y; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate x - y. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function sub (int128 x, int128 y) internal pure returns (int128) { unchecked { int256 result = int256(x) - y; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate x * y rounding down. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function mul (int128 x, int128 y) internal pure returns (int128) { unchecked { int256 result = int256(x) * y >> 64; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate x * y rounding towards zero, where x is signed 64.64 fixed point * number and y is signed 256-bit integer number. Revert on overflow. * * @param x signed 64.64 fixed point number * @param y signed 256-bit integer number * @return signed 256-bit integer number */ function muli (int128 x, int256 y) internal pure returns (int256) { unchecked { if (x == MIN_64x64) { require (y >= -0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF && y <= 0x1000000000000000000000000000000000000000000000000); return -y << 63; } else { bool negativeResult = false; if (x < 0) { x = -x; negativeResult = true; } if (y < 0) { y = -y; // We rely on overflow behavior here negativeResult = !negativeResult; } uint256 absoluteResult = mulu (x, uint256 (y)); if (negativeResult) { require (absoluteResult <= 0x8000000000000000000000000000000000000000000000000000000000000000); return -int256 (absoluteResult); // We rely on overflow behavior here } else { require (absoluteResult <= 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); return int256 (absoluteResult); } } } } /** * Calculate x * y rounding down, where x is signed 64.64 fixed point number * and y is unsigned 256-bit integer number. Revert on overflow. * * @param x signed 64.64 fixed point number * @param y unsigned 256-bit integer number * @return unsigned 256-bit integer number */ function mulu (int128 x, uint256 y) internal pure returns (uint256) { unchecked { if (y == 0) return 0; require (x >= 0); uint256 lo = (uint256 (int256 (x)) * (y & 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF)) >> 64; uint256 hi = uint256 (int256 (x)) * (y >> 128); require (hi <= 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); hi <<= 64; require (hi <= 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF - lo); return hi + lo; } } /** * Calculate x / y rounding towards zero. Revert on overflow or when y is * zero. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function div (int128 x, int128 y) internal pure returns (int128) { unchecked { require (y != 0); int256 result = (int256 (x) << 64) / y; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate x / y rounding towards zero, where x and y are signed 256-bit * integer numbers. Revert on overflow or when y is zero. * * @param x signed 256-bit integer number * @param y signed 256-bit integer number * @return signed 64.64-bit fixed point number */ function divi (int256 x, int256 y) internal pure returns (int128) { unchecked { require (y != 0); bool negativeResult = false; if (x < 0) { x = -x; // We rely on overflow behavior here negativeResult = true; } if (y < 0) { y = -y; // We rely on overflow behavior here negativeResult = !negativeResult; } uint128 absoluteResult = divuu (uint256 (x), uint256 (y)); if (negativeResult) { require (absoluteResult <= 0x80000000000000000000000000000000); return -int128 (absoluteResult); // We rely on overflow behavior here } else { require (absoluteResult <= 0x7FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); return int128 (absoluteResult); // We rely on overflow behavior here } } } /** * Calculate x / y rounding towards zero, where x and y are unsigned 256-bit * integer numbers. Revert on overflow or when y is zero. * * @param x unsigned 256-bit integer number * @param y unsigned 256-bit integer number * @return signed 64.64-bit fixed point number */ function divu (uint256 x, uint256 y) internal pure returns (int128) { unchecked { require (y != 0); uint128 result = divuu (x, y); require (result <= uint128 (MAX_64x64)); return int128 (result); } } /** * Calculate -x. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function neg (int128 x) internal pure returns (int128) { unchecked { require (x != MIN_64x64); return -x; } } /** * Calculate |x|. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function abs (int128 x) internal pure returns (int128) { unchecked { require (x != MIN_64x64); return x < 0 ? -x : x; } } /** * Calculate 1 / x rounding towards zero. Revert on overflow or when x is * zero. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function inv (int128 x) internal pure returns (int128) { unchecked { require (x != 0); int256 result = int256 (0x100000000000000000000000000000000) / x; require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate arithmetics average of x and y, i.e. (x + y) / 2 rounding down. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function avg (int128 x, int128 y) internal pure returns (int128) { unchecked { return int128 ((int256 (x) + int256 (y)) >> 1); } } /** * Calculate geometric average of x and y, i.e. sqrt (x * y) rounding down. * Revert on overflow or in case x * y is negative. * * @param x signed 64.64-bit fixed point number * @param y signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function gavg (int128 x, int128 y) internal pure returns (int128) { unchecked { int256 m = int256 (x) * int256 (y); require (m >= 0); require (m < 0x4000000000000000000000000000000000000000000000000000000000000000); return int128 (sqrtu (uint256 (m))); } } /** * Calculate x^y assuming 0^0 is 1, where x is signed 64.64 fixed point number * and y is unsigned 256-bit integer number. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @param y uint256 value * @return signed 64.64-bit fixed point number */ function pow (int128 x, uint256 y) internal pure returns (int128) { unchecked { bool negative = x < 0 && y & 1 == 1; uint256 absX = uint128 (x < 0 ? -x : x); uint256 absResult; absResult = 0x100000000000000000000000000000000; if (absX <= 0x10000000000000000) { absX <<= 63; while (y != 0) { if (y & 0x1 != 0) { absResult = absResult * absX >> 127; } absX = absX * absX >> 127; if (y & 0x2 != 0) { absResult = absResult * absX >> 127; } absX = absX * absX >> 127; if (y & 0x4 != 0) { absResult = absResult * absX >> 127; } absX = absX * absX >> 127; if (y & 0x8 != 0) { absResult = absResult * absX >> 127; } absX = absX * absX >> 127; y >>= 4; } absResult >>= 64; } else { uint256 absXShift = 63; if (absX < 0x1000000000000000000000000) { absX <<= 32; absXShift -= 32; } if (absX < 0x10000000000000000000000000000) { absX <<= 16; absXShift -= 16; } if (absX < 0x1000000000000000000000000000000) { absX <<= 8; absXShift -= 8; } if (absX < 0x10000000000000000000000000000000) { absX <<= 4; absXShift -= 4; } if (absX < 0x40000000000000000000000000000000) { absX <<= 2; absXShift -= 2; } if (absX < 0x80000000000000000000000000000000) { absX <<= 1; absXShift -= 1; } uint256 resultShift = 0; while (y != 0) { require (absXShift < 64); if (y & 0x1 != 0) { absResult = absResult * absX >> 127; resultShift += absXShift; if (absResult > 0x100000000000000000000000000000000) { absResult >>= 1; resultShift += 1; } } absX = absX * absX >> 127; absXShift <<= 1; if (absX >= 0x100000000000000000000000000000000) { absX >>= 1; absXShift += 1; } y >>= 1; } require (resultShift < 64); absResult >>= 64 - resultShift; } int256 result = negative ? -int256 (absResult) : int256 (absResult); require (result >= MIN_64x64 && result <= MAX_64x64); return int128 (result); } } /** * Calculate sqrt (x) rounding down. Revert if x < 0. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function sqrt (int128 x) internal pure returns (int128) { unchecked { require (x >= 0); return int128 (sqrtu (uint256 (int256 (x)) << 64)); } } /** * Calculate binary logarithm of x. Revert if x <= 0. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function log_2 (int128 x) internal pure returns (int128) { unchecked { require (x > 0); int256 msb = 0; int256 xc = x; if (xc >= 0x10000000000000000) { xc >>= 64; msb += 64; } if (xc >= 0x100000000) { xc >>= 32; msb += 32; } if (xc >= 0x10000) { xc >>= 16; msb += 16; } if (xc >= 0x100) { xc >>= 8; msb += 8; } if (xc >= 0x10) { xc >>= 4; msb += 4; } if (xc >= 0x4) { xc >>= 2; msb += 2; } if (xc >= 0x2) msb += 1; // No need to shift xc anymore int256 result = msb - 64 << 64; uint256 ux = uint256 (int256 (x)) << uint256 (127 - msb); for (int256 bit = 0x8000000000000000; bit > 0; bit >>= 1) { ux *= ux; uint256 b = ux >> 255; ux >>= 127 + b; result += bit * int256 (b); } return int128 (result); } } /** * Calculate natural logarithm of x. Revert if x <= 0. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function ln (int128 x) internal pure returns (int128) { unchecked { require (x > 0); return int128 (int256 ( uint256 (int256 (log_2 (x))) * 0xB17217F7D1CF79ABC9E3B39803F2F6AF >> 128)); } } /** * Calculate binary exponent of x. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function exp_2 (int128 x) internal pure returns (int128) { unchecked { require (x < 0x400000000000000000); // Overflow if (x < -0x400000000000000000) return 0; // Underflow uint256 result = 0x80000000000000000000000000000000; if (x & 0x8000000000000000 > 0) result = result * 0x16A09E667F3BCC908B2FB1366EA957D3E >> 128; if (x & 0x4000000000000000 > 0) result = result * 0x1306FE0A31B7152DE8D5A46305C85EDEC >> 128; if (x & 0x2000000000000000 > 0) result = result * 0x1172B83C7D517ADCDF7C8C50EB14A791F >> 128; if (x & 0x1000000000000000 > 0) result = result * 0x10B5586CF9890F6298B92B71842A98363 >> 128; if (x & 0x800000000000000 > 0) result = result * 0x1059B0D31585743AE7C548EB68CA417FD >> 128; if (x & 0x400000000000000 > 0) result = result * 0x102C9A3E778060EE6F7CACA4F7A29BDE8 >> 128; if (x & 0x200000000000000 > 0) result = result * 0x10163DA9FB33356D84A66AE336DCDFA3F >> 128; if (x & 0x100000000000000 > 0) result = result * 0x100B1AFA5ABCBED6129AB13EC11DC9543 >> 128; if (x & 0x80000000000000 > 0) result = result * 0x10058C86DA1C09EA1FF19D294CF2F679B >> 128; if (x & 0x40000000000000 > 0) result = result * 0x1002C605E2E8CEC506D21BFC89A23A00F >> 128; if (x & 0x20000000000000 > 0) result = result * 0x100162F3904051FA128BCA9C55C31E5DF >> 128; if (x & 0x10000000000000 > 0) result = result * 0x1000B175EFFDC76BA38E31671CA939725 >> 128; if (x & 0x8000000000000 > 0) result = result * 0x100058BA01FB9F96D6CACD4B180917C3D >> 128; if (x & 0x4000000000000 > 0) result = result * 0x10002C5CC37DA9491D0985C348C68E7B3 >> 128; if (x & 0x2000000000000 > 0) result = result * 0x1000162E525EE054754457D5995292026 >> 128; if (x & 0x1000000000000 > 0) result = result * 0x10000B17255775C040618BF4A4ADE83FC >> 128; if (x & 0x800000000000 > 0) result = result * 0x1000058B91B5BC9AE2EED81E9B7D4CFAB >> 128; if (x & 0x400000000000 > 0) result = result * 0x100002C5C89D5EC6CA4D7C8ACC017B7C9 >> 128; if (x & 0x200000000000 > 0) result = result * 0x10000162E43F4F831060E02D839A9D16D >> 128; if (x & 0x100000000000 > 0) result = result * 0x100000B1721BCFC99D9F890EA06911763 >> 128; if (x & 0x80000000000 > 0) result = result * 0x10000058B90CF1E6D97F9CA14DBCC1628 >> 128; if (x & 0x40000000000 > 0) result = result * 0x1000002C5C863B73F016468F6BAC5CA2B >> 128; if (x & 0x20000000000 > 0) result = result * 0x100000162E430E5A18F6119E3C02282A5 >> 128; if (x & 0x10000000000 > 0) result = result * 0x1000000B1721835514B86E6D96EFD1BFE >> 128; if (x & 0x8000000000 > 0) result = result * 0x100000058B90C0B48C6BE5DF846C5B2EF >> 128; if (x & 0x4000000000 > 0) result = result * 0x10000002C5C8601CC6B9E94213C72737A >> 128; if (x & 0x2000000000 > 0) result = result * 0x1000000162E42FFF037DF38AA2B219F06 >> 128; if (x & 0x1000000000 > 0) result = result * 0x10000000B17217FBA9C739AA5819F44F9 >> 128; if (x & 0x800000000 > 0) result = result * 0x1000000058B90BFCDEE5ACD3C1CEDC823 >> 128; if (x & 0x400000000 > 0) result = result * 0x100000002C5C85FE31F35A6A30DA1BE50 >> 128; if (x & 0x200000000 > 0) result = result * 0x10000000162E42FF0999CE3541B9FFFCF >> 128; if (x & 0x100000000 > 0) result = result * 0x100000000B17217F80F4EF5AADDA45554 >> 128; if (x & 0x80000000 > 0) result = result * 0x10000000058B90BFBF8479BD5A81B51AD >> 128; if (x & 0x40000000 > 0) result = result * 0x1000000002C5C85FDF84BD62AE30A74CC >> 128; if (x & 0x20000000 > 0) result = result * 0x100000000162E42FEFB2FED257559BDAA >> 128; if (x & 0x10000000 > 0) result = result * 0x1000000000B17217F7D5A7716BBA4A9AE >> 128; if (x & 0x8000000 > 0) result = result * 0x100000000058B90BFBE9DDBAC5E109CCE >> 128; if (x & 0x4000000 > 0) result = result * 0x10000000002C5C85FDF4B15DE6F17EB0D >> 128; if (x & 0x2000000 > 0) result = result * 0x1000000000162E42FEFA494F1478FDE05 >> 128; if (x & 0x1000000 > 0) result = result * 0x10000000000B17217F7D20CF927C8E94C >> 128; if (x & 0x800000 > 0) result = result * 0x1000000000058B90BFBE8F71CB4E4B33D >> 128; if (x & 0x400000 > 0) result = result * 0x100000000002C5C85FDF477B662B26945 >> 128; if (x & 0x200000 > 0) result = result * 0x10000000000162E42FEFA3AE53369388C >> 128; if (x & 0x100000 > 0) result = result * 0x100000000000B17217F7D1D351A389D40 >> 128; if (x & 0x80000 > 0) result = result * 0x10000000000058B90BFBE8E8B2D3D4EDE >> 128; if (x & 0x40000 > 0) result = result * 0x1000000000002C5C85FDF4741BEA6E77E >> 128; if (x & 0x20000 > 0) result = result * 0x100000000000162E42FEFA39FE95583C2 >> 128; if (x & 0x10000 > 0) result = result * 0x1000000000000B17217F7D1CFB72B45E1 >> 128; if (x & 0x8000 > 0) result = result * 0x100000000000058B90BFBE8E7CC35C3F0 >> 128; if (x & 0x4000 > 0) result = result * 0x10000000000002C5C85FDF473E242EA38 >> 128; if (x & 0x2000 > 0) result = result * 0x1000000000000162E42FEFA39F02B772C >> 128; if (x & 0x1000 > 0) result = result * 0x10000000000000B17217F7D1CF7D83C1A >> 128; if (x & 0x800 > 0) result = result * 0x1000000000000058B90BFBE8E7BDCBE2E >> 128; if (x & 0x400 > 0) result = result * 0x100000000000002C5C85FDF473DEA871F >> 128; if (x & 0x200 > 0) result = result * 0x10000000000000162E42FEFA39EF44D91 >> 128; if (x & 0x100 > 0) result = result * 0x100000000000000B17217F7D1CF79E949 >> 128; if (x & 0x80 > 0) result = result * 0x10000000000000058B90BFBE8E7BCE544 >> 128; if (x & 0x40 > 0) result = result * 0x1000000000000002C5C85FDF473DE6ECA >> 128; if (x & 0x20 > 0) result = result * 0x100000000000000162E42FEFA39EF366F >> 128; if (x & 0x10 > 0) result = result * 0x1000000000000000B17217F7D1CF79AFA >> 128; if (x & 0x8 > 0) result = result * 0x100000000000000058B90BFBE8E7BCD6D >> 128; if (x & 0x4 > 0) result = result * 0x10000000000000002C5C85FDF473DE6B2 >> 128; if (x & 0x2 > 0) result = result * 0x1000000000000000162E42FEFA39EF358 >> 128; if (x & 0x1 > 0) result = result * 0x10000000000000000B17217F7D1CF79AB >> 128; result >>= uint256 (int256 (63 - (x >> 64))); require (result <= uint256 (int256 (MAX_64x64))); return int128 (int256 (result)); } } /** * Calculate natural exponent of x. Revert on overflow. * * @param x signed 64.64-bit fixed point number * @return signed 64.64-bit fixed point number */ function exp (int128 x) internal pure returns (int128) { unchecked { require (x < 0x400000000000000000); // Overflow if (x < -0x400000000000000000) return 0; // Underflow return exp_2 ( int128 (int256 (x) * 0x171547652B82FE1777D0FFDA0D23A7D12 >> 128)); } } /** * Calculate x / y rounding towards zero, where x and y are unsigned 256-bit * integer numbers. Revert on overflow or when y is zero. * * @param x unsigned 256-bit integer number * @param y unsigned 256-bit integer number * @return unsigned 64.64-bit fixed point number */ function divuu (uint256 x, uint256 y) private pure returns (uint128) { unchecked { require (y != 0); uint256 result; if (x <= 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF) result = (x << 64) / y; else { uint256 msb = 192; uint256 xc = x >> 192; if (xc >= 0x100000000) { xc >>= 32; msb += 32; } if (xc >= 0x10000) { xc >>= 16; msb += 16; } if (xc >= 0x100) { xc >>= 8; msb += 8; } if (xc >= 0x10) { xc >>= 4; msb += 4; } if (xc >= 0x4) { xc >>= 2; msb += 2; } if (xc >= 0x2) msb += 1; // No need to shift xc anymore result = (x << 255 - msb) / ((y - 1 >> msb - 191) + 1); require (result <= 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); uint256 hi = result * (y >> 128); uint256 lo = result * (y & 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); uint256 xh = x >> 192; uint256 xl = x << 64; if (xl < lo) xh -= 1; xl -= lo; // We rely on overflow behavior here lo = hi << 128; if (xl < lo) xh -= 1; xl -= lo; // We rely on overflow behavior here assert (xh == hi >> 128); result += xl / y; } require (result <= 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF); return uint128 (result); } } /** * Calculate sqrt (x) rounding down, where x is unsigned 256-bit integer * number. * * @param x unsigned 256-bit integer number * @return unsigned 128-bit integer number */ function sqrtu (uint256 x) private pure returns (uint128) { unchecked { if (x == 0) return 0; else { uint256 xx = x; uint256 r = 1; if (xx >= 0x100000000000000000000000000000000) { xx >>= 128; r <<= 64; } if (xx >= 0x10000000000000000) { xx >>= 64; r <<= 32; } if (xx >= 0x100000000) { xx >>= 32; r <<= 16; } if (xx >= 0x10000) { xx >>= 16; r <<= 8; } if (xx >= 0x100) { xx >>= 8; r <<= 4; } if (xx >= 0x10) { xx >>= 4; r <<= 2; } if (xx >= 0x4) { r <<= 1; } r = (r + x / r) >> 1; r = (r + x / r) >> 1; r = (r + x / r) >> 1; r = (r + x / r) >> 1; r = (r + x / r) >> 1; r = (r + x / r) >> 1; r = (r + x / r) >> 1; // Seven iterations should be enough uint256 r1 = x / r; return uint128 (r < r1 ? r : r1); } } } }
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts 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 (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/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 (last updated v4.7.0) (utils/Base64.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides a set of functions to operate with Base64 strings.
*
* _Available since v4.5._
*/
library Base64 {
/**
* @dev Base64 Encoding/Decoding Table
*/
string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
/**
* @dev Converts a `bytes` to its Bytes64 `string` representation.
*/
function encode(bytes memory data) internal pure returns (string memory) {
/**
* Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
* https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
*/
if (data.length == 0) return "";
// Loads the table into memory
string memory table = _TABLE;
// Encoding takes 3 bytes chunks of binary data from `bytes` data parameter
// and split into 4 numbers of 6 bits.
// The final Base64 length should be `bytes` data length multiplied by 4/3 rounded up
// - `data.length + 2` -> Round up
// - `/ 3` -> Number of 3-bytes chunks
// - `4 *` -> 4 characters for each chunk
string memory result = new string(4 * ((data.length + 2) / 3));
/// @solidity memory-safe-assembly
assembly {
// Prepare the lookup table (skip the first "length" byte)
let tablePtr := add(table, 1)
// Prepare result pointer, jump over length
let resultPtr := add(result, 32)
// Run over the input, 3 bytes at a time
for {
let dataPtr := data
let endPtr := add(data, mload(data))
} lt(dataPtr, endPtr) {
} {
// Advance 3 bytes
dataPtr := add(dataPtr, 3)
let input := mload(dataPtr)
// To write each character, shift the 3 bytes (18 bits) chunk
// 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
// and apply logical AND with 0x3F which is the number of
// the previous character in the ASCII table prior to the Base64 Table
// The result is then added to the table to get the character to write,
// and finally write it in the result pointer but with a left shift
// of 256 (1 byte) - 8 (1 ASCII char) = 248 bits
mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
}
// When data `bytes` is not exactly 3 bytes long
// it is padded with `=` characters at the end
switch mod(mload(data), 3)
case 1 {
mstore8(sub(resultPtr, 1), 0x3d)
mstore8(sub(resultPtr, 2), 0x3d)
}
case 2 {
mstore8(sub(resultPtr, 1), 0x3d)
}
}
return result;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.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 functionCall(target, data, "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");
require(isContract(target), "Address: call to non-contract");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResult(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) {
require(isContract(target), "Address: static call to non-contract");
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResult(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) {
require(isContract(target), "Address: delegate call to non-contract");
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResult(success, returndata, errorMessage);
}
/**
* @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason 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 {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (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.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 (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.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 nor 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 nor 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 nor 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.
*
* 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
_approve(address(0), 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
_approve(address(0), 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 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20Metadata is IERC20 {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}// 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 (last updated v4.7.0) (token/ERC20/ERC20.sol)
pragma solidity ^0.8.0;
import "./IERC20.sol";
import "./extensions/IERC20Metadata.sol";
import "../../utils/Context.sol";
/**
* @dev Implementation of the {IERC20} interface.
*
* This implementation is agnostic to the way tokens are created. This means
* that a supply mechanism has to be added in a derived contract using {_mint}.
* For a generic mechanism see {ERC20PresetMinterPauser}.
*
* TIP: For a detailed writeup see our guide
* https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[How
* to implement supply mechanisms].
*
* We have followed general OpenZeppelin Contracts guidelines: functions revert
* instead returning `false` on failure. This behavior is nonetheless
* conventional and does not conflict with the expectations of ERC20
* applications.
*
* Additionally, an {Approval} event is emitted on calls to {transferFrom}.
* This allows applications to reconstruct the allowance for all accounts just
* by listening to said events. Other implementations of the EIP may not emit
* these events, as it isn't required by the specification.
*
* Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
* functions have been added to mitigate the well-known issues around setting
* allowances. See {IERC20-approve}.
*/
contract ERC20 is Context, IERC20, IERC20Metadata {
mapping(address => uint256) private _balances;
mapping(address => mapping(address => uint256)) private _allowances;
uint256 private _totalSupply;
string private _name;
string private _symbol;
/**
* @dev Sets the values for {name} and {symbol}.
*
* The default value of {decimals} is 18. To select a different value for
* {decimals} you should overload it.
*
* All two of these values are immutable: they can only be set once during
* construction.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev Returns the name of the token.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev Returns the symbol of the token, usually a shorter version of the
* name.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev Returns the number of decimals used to get its user representation.
* For example, if `decimals` equals `2`, a balance of `505` tokens should
* be displayed to a user as `5.05` (`505 / 10 ** 2`).
*
* Tokens usually opt for a value of 18, imitating the relationship between
* Ether and Wei. This is the value {ERC20} uses, unless this function is
* overridden;
*
* NOTE: This information is only used for _display_ purposes: it in
* no way affects any of the arithmetic of the contract, including
* {IERC20-balanceOf} and {IERC20-transfer}.
*/
function decimals() public view virtual override returns (uint8) {
return 18;
}
/**
* @dev See {IERC20-totalSupply}.
*/
function totalSupply() public view virtual override returns (uint256) {
return _totalSupply;
}
/**
* @dev See {IERC20-balanceOf}.
*/
function balanceOf(address account) public view virtual override returns (uint256) {
return _balances[account];
}
/**
* @dev See {IERC20-transfer}.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - the caller must have a balance of at least `amount`.
*/
function transfer(address to, uint256 amount) public virtual override returns (bool) {
address owner = _msgSender();
_transfer(owner, to, amount);
return true;
}
/**
* @dev See {IERC20-allowance}.
*/
function allowance(address owner, address spender) public view virtual override returns (uint256) {
return _allowances[owner][spender];
}
/**
* @dev See {IERC20-approve}.
*
* NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
* `transferFrom`. This is semantically equivalent to an infinite approval.
*
* Requirements:
*
* - `spender` cannot be the zero address.
*/
function approve(address spender, uint256 amount) public virtual override returns (bool) {
address owner = _msgSender();
_approve(owner, spender, amount);
return true;
}
/**
* @dev See {IERC20-transferFrom}.
*
* Emits an {Approval} event indicating the updated allowance. This is not
* required by the EIP. See the note at the beginning of {ERC20}.
*
* NOTE: Does not update the allowance if the current allowance
* is the maximum `uint256`.
*
* Requirements:
*
* - `from` and `to` cannot be the zero address.
* - `from` must have a balance of at least `amount`.
* - the caller must have allowance for ``from``'s tokens of at least
* `amount`.
*/
function transferFrom(
address from,
address to,
uint256 amount
) public virtual override returns (bool) {
address spender = _msgSender();
_spendAllowance(from, spender, amount);
_transfer(from, to, amount);
return true;
}
/**
* @dev Atomically increases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
*/
function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
address owner = _msgSender();
_approve(owner, spender, allowance(owner, spender) + addedValue);
return true;
}
/**
* @dev Atomically decreases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `spender` must have allowance for the caller of at least
* `subtractedValue`.
*/
function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
address owner = _msgSender();
uint256 currentAllowance = allowance(owner, spender);
require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
unchecked {
_approve(owner, spender, currentAllowance - subtractedValue);
}
return true;
}
/**
* @dev Moves `amount` of tokens from `from` to `to`.
*
* This internal function is equivalent to {transfer}, and can be used to
* e.g. implement automatic token fees, slashing mechanisms, etc.
*
* Emits a {Transfer} event.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `from` must have a balance of at least `amount`.
*/
function _transfer(
address from,
address to,
uint256 amount
) internal virtual {
require(from != address(0), "ERC20: transfer from the zero address");
require(to != address(0), "ERC20: transfer to the zero address");
_beforeTokenTransfer(from, to, amount);
uint256 fromBalance = _balances[from];
require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
unchecked {
_balances[from] = fromBalance - amount;
}
_balances[to] += amount;
emit Transfer(from, to, amount);
_afterTokenTransfer(from, to, amount);
}
/** @dev Creates `amount` tokens and assigns them to `account`, increasing
* the total supply.
*
* Emits a {Transfer} event with `from` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function _mint(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: mint to the zero address");
_beforeTokenTransfer(address(0), account, amount);
_totalSupply += amount;
_balances[account] += amount;
emit Transfer(address(0), account, amount);
_afterTokenTransfer(address(0), account, amount);
}
/**
* @dev Destroys `amount` tokens from `account`, reducing the
* total supply.
*
* Emits a {Transfer} event with `to` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
* - `account` must have at least `amount` tokens.
*/
function _burn(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: burn from the zero address");
_beforeTokenTransfer(account, address(0), amount);
uint256 accountBalance = _balances[account];
require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
unchecked {
_balances[account] = accountBalance - amount;
}
_totalSupply -= amount;
emit Transfer(account, address(0), amount);
_afterTokenTransfer(account, address(0), amount);
}
/**
* @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
*
* This internal function is equivalent to `approve`, and can be used to
* e.g. set automatic allowances for certain subsystems, etc.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `owner` cannot be the zero address.
* - `spender` cannot be the zero address.
*/
function _approve(
address owner,
address spender,
uint256 amount
) internal virtual {
require(owner != address(0), "ERC20: approve from the zero address");
require(spender != address(0), "ERC20: approve to the zero address");
_allowances[owner][spender] = amount;
emit Approval(owner, spender, amount);
}
/**
* @dev Updates `owner` s allowance for `spender` based on spent `amount`.
*
* Does not update the allowance amount in case of infinite allowance.
* Revert if not enough allowance is available.
*
* Might emit an {Approval} event.
*/
function _spendAllowance(
address owner,
address spender,
uint256 amount
) internal virtual {
uint256 currentAllowance = allowance(owner, spender);
if (currentAllowance != type(uint256).max) {
require(currentAllowance >= amount, "ERC20: insufficient allowance");
unchecked {
_approve(owner, spender, currentAllowance - amount);
}
}
}
/**
* @dev Hook that is called before any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* will be transferred to `to`.
* - when `from` is zero, `amount` tokens will be minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens 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 amount
) 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, `amount` of ``from``'s tokens
* has been transferred to `to`.
* - when `from` is zero, `amount` tokens have been minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens have been 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 _afterTokenTransfer(
address from,
address to,
uint256 amount
) internal virtual {}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (interfaces/IERC2981.sol)
pragma solidity ^0.8.0;
import "../utils/introspection/IERC165.sol";
/**
* @dev Interface for the NFT Royalty Standard.
*
* A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
* support for royalty payments across all NFT marketplaces and ecosystem participants.
*
* _Available since v4.5._
*/
interface IERC2981 is IERC165 {
/**
* @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
* exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
*/
function royaltyInfo(uint256 tokenId, uint256 salePrice)
external
view
returns (address receiver, uint256 royaltyAmount);
}// SPDX-License-Identifier: MIT // OpenZeppelin Contracts v4.4.1 (interfaces/IERC165.sol) pragma solidity ^0.8.0; import "../utils/introspection/IERC165.sol";
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IStakingToken {
event Staked(address indexed user, uint256 amount, uint256 term);
event Withdrawn(address indexed user, uint256 amount, uint256 reward);
function stake(uint256 amount, uint256 term) external;
function withdraw() external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IRankedMintingToken {
event RankClaimed(address indexed user, uint256 term, uint256 rank);
event MintClaimed(address indexed user, uint256 rewardAmount);
function claimRank(uint256 term) external;
function claimMintReward() external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IBurnableToken {
function burn(address user, uint256 amount) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
interface IBurnRedeemable {
event Redeemed(
address indexed user,
address indexed xenContract,
address indexed tokenContract,
uint256 xenAmount,
uint256 tokenAmount
);
function onTokenBurned(address user, uint256 amount) external;
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "./Math.sol";
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/interfaces/IERC165.sol";
import "abdk-libraries-solidity/ABDKMath64x64.sol";
import "./interfaces/IStakingToken.sol";
import "./interfaces/IRankedMintingToken.sol";
import "./interfaces/IBurnableToken.sol";
import "./interfaces/IBurnRedeemable.sol";
contract XENCrypto is Context, IRankedMintingToken, IStakingToken, IBurnableToken, ERC20("XEN Crypto", "XEN") {
using Math for uint256;
using ABDKMath64x64 for int128;
using ABDKMath64x64 for uint256;
// INTERNAL TYPE TO DESCRIBE A XEN MINT INFO
struct MintInfo {
address user;
uint256 term;
uint256 maturityTs;
uint256 rank;
uint256 amplifier;
uint256 eaaRate;
}
// INTERNAL TYPE TO DESCRIBE A XEN STAKE
struct StakeInfo {
uint256 term;
uint256 maturityTs;
uint256 amount;
uint256 apy;
}
// PUBLIC CONSTANTS
uint256 public constant SECONDS_IN_DAY = 3_600 * 24;
uint256 public constant DAYS_IN_YEAR = 365;
uint256 public constant GENESIS_RANK = 1;
uint256 public constant MIN_TERM = 1 * SECONDS_IN_DAY - 1;
uint256 public constant MAX_TERM_START = 100 * SECONDS_IN_DAY;
uint256 public constant MAX_TERM_END = 1_000 * SECONDS_IN_DAY;
uint256 public constant TERM_AMPLIFIER = 15;
uint256 public constant TERM_AMPLIFIER_THRESHOLD = 5_000;
uint256 public constant REWARD_AMPLIFIER_START = 3_000;
uint256 public constant REWARD_AMPLIFIER_END = 1;
uint256 public constant EAA_PM_START = 100;
uint256 public constant EAA_PM_STEP = 1;
uint256 public constant EAA_RANK_STEP = 100_000;
uint256 public constant WITHDRAWAL_WINDOW_DAYS = 7;
uint256 public constant MAX_PENALTY_PCT = 99;
uint256 public constant XEN_MIN_STAKE = 0;
uint256 public constant XEN_MIN_BURN = 0;
uint256 public constant XEN_APY_START = 20;
uint256 public constant XEN_APY_DAYS_STEP = 90;
uint256 public constant XEN_APY_END = 2;
string public constant AUTHORS = "@MrJackLevin @lbelyaev faircrypto.org";
// PUBLIC STATE, READABLE VIA NAMESAKE GETTERS
uint256 public immutable genesisTs;
uint256 public globalRank = GENESIS_RANK;
uint256 public activeMinters;
uint256 public activeStakes;
uint256 public totalXenStaked;
// user address => XEN mint info
mapping(address => MintInfo) public userMints;
// user address => XEN stake info
mapping(address => StakeInfo) public userStakes;
// user address => XEN burn amount
mapping(address => uint256) public userBurns;
// CONSTRUCTOR
constructor() {
genesisTs = block.timestamp;
}
// PRIVATE METHODS
/**
* @dev calculates current MaxTerm based on Global Rank
* (if Global Rank crosses over TERM_AMPLIFIER_THRESHOLD)
*/
function _calculateMaxTerm() private view returns (uint256) {
if (globalRank > TERM_AMPLIFIER_THRESHOLD) {
uint256 delta = globalRank.fromUInt().log_2().mul(TERM_AMPLIFIER.fromUInt()).toUInt();
uint256 newMax = MAX_TERM_START + delta * SECONDS_IN_DAY;
return Math.min(newMax, MAX_TERM_END);
}
return MAX_TERM_START;
}
/**
* @dev calculates Withdrawal Penalty depending on lateness
*/
function _penalty(uint256 secsLate) private pure returns (uint256) {
// =MIN(2^(daysLate+3)/window-1,99)
uint256 daysLate = secsLate / SECONDS_IN_DAY;
if (daysLate > WITHDRAWAL_WINDOW_DAYS - 1) return MAX_PENALTY_PCT;
uint256 penalty = (uint256(1) << (daysLate + 3)) / WITHDRAWAL_WINDOW_DAYS - 1;
return Math.min(penalty, MAX_PENALTY_PCT);
}
/**
* @dev calculates net Mint Reward (adjusted for Penalty)
*/
function _calculateMintReward(
uint256 cRank,
uint256 term,
uint256 maturityTs,
uint256 amplifier,
uint256 eeaRate
) private view returns (uint256) {
uint256 secsLate = block.timestamp - maturityTs;
uint256 penalty = _penalty(secsLate);
uint256 rankDelta = Math.max(globalRank - cRank, 2);
uint256 EAA = (1_000 + eeaRate);
uint256 reward = getGrossReward(rankDelta, amplifier, term, EAA);
return (reward * (100 - penalty)) / 100;
}
/**
* @dev cleans up User Mint storage (gets some Gas credit;))
*/
function _cleanUpUserMint() private {
delete userMints[_msgSender()];
activeMinters--;
}
/**
* @dev calculates XEN Stake Reward
*/
function _calculateStakeReward(
uint256 amount,
uint256 term,
uint256 maturityTs,
uint256 apy
) private view returns (uint256) {
if (block.timestamp > maturityTs) {
uint256 rate = (apy * term * 1_000_000) / DAYS_IN_YEAR;
return (amount * rate) / 100_000_000;
}
return 0;
}
/**
* @dev calculates Reward Amplifier
*/
function _calculateRewardAmplifier() private view returns (uint256) {
uint256 amplifierDecrease = (block.timestamp - genesisTs) / SECONDS_IN_DAY;
if (amplifierDecrease < REWARD_AMPLIFIER_START) {
return Math.max(REWARD_AMPLIFIER_START - amplifierDecrease, REWARD_AMPLIFIER_END);
} else {
return REWARD_AMPLIFIER_END;
}
}
/**
* @dev calculates Early Adopter Amplifier Rate (in 1/000ths)
* actual EAA is (1_000 + EAAR) / 1_000
*/
function _calculateEAARate() private view returns (uint256) {
uint256 decrease = (EAA_PM_STEP * globalRank) / EAA_RANK_STEP;
if (decrease > EAA_PM_START) return 0;
return EAA_PM_START - decrease;
}
/**
* @dev calculates APY (in %)
*/
function _calculateAPY() private view returns (uint256) {
uint256 decrease = (block.timestamp - genesisTs) / (SECONDS_IN_DAY * XEN_APY_DAYS_STEP);
if (XEN_APY_START - XEN_APY_END < decrease) return XEN_APY_END;
return XEN_APY_START - decrease;
}
/**
* @dev creates User Stake
*/
function _createStake(uint256 amount, uint256 term) private {
userStakes[_msgSender()] = StakeInfo({
term: term,
maturityTs: block.timestamp + term * SECONDS_IN_DAY,
amount: amount,
apy: _calculateAPY()
});
activeStakes++;
totalXenStaked += amount;
}
// PUBLIC CONVENIENCE GETTERS
/**
* @dev calculates gross Mint Reward
*/
function getGrossReward(
uint256 rankDelta,
uint256 amplifier,
uint256 term,
uint256 eaa
) public pure returns (uint256) {
int128 log128 = rankDelta.fromUInt().log_2();
int128 reward128 = log128.mul(amplifier.fromUInt()).mul(term.fromUInt()).mul(eaa.fromUInt());
return reward128.div(uint256(1_000).fromUInt()).toUInt();
}
/**
* @dev returns User Mint object associated with User account address
*/
function getUserMint() external view returns (MintInfo memory) {
return userMints[_msgSender()];
}
/**
* @dev returns XEN Stake object associated with User account address
*/
function getUserStake() external view returns (StakeInfo memory) {
return userStakes[_msgSender()];
}
/**
* @dev returns current AMP
*/
function getCurrentAMP() external view returns (uint256) {
return _calculateRewardAmplifier();
}
/**
* @dev returns current EAA Rate
*/
function getCurrentEAAR() external view returns (uint256) {
return _calculateEAARate();
}
/**
* @dev returns current APY
*/
function getCurrentAPY() external view returns (uint256) {
return _calculateAPY();
}
/**
* @dev returns current MaxTerm
*/
function getCurrentMaxTerm() external view returns (uint256) {
return _calculateMaxTerm();
}
// PUBLIC STATE-CHANGING METHODS
/**
* @dev accepts User cRank claim provided all checks pass (incl. no current claim exists)
*/
function claimRank(uint256 term) external {
uint256 termSec = term * SECONDS_IN_DAY;
require(termSec > MIN_TERM, "CRank: Term less than min");
require(termSec < _calculateMaxTerm() + 1, "CRank: Term more than current max term");
require(userMints[_msgSender()].rank == 0, "CRank: Mint already in progress");
// create and store new MintInfo
MintInfo memory mintInfo = MintInfo({
user: _msgSender(),
term: term,
maturityTs: block.timestamp + termSec,
rank: globalRank,
amplifier: _calculateRewardAmplifier(),
eaaRate: _calculateEAARate()
});
userMints[_msgSender()] = mintInfo;
activeMinters++;
emit RankClaimed(_msgSender(), term, globalRank++);
}
/**
* @dev ends minting upon maturity (and within permitted Withdrawal Time Window), gets minted XEN
*/
function claimMintReward() external {
MintInfo memory mintInfo = userMints[_msgSender()];
require(mintInfo.rank > 0, "CRank: No mint exists");
require(block.timestamp > mintInfo.maturityTs, "CRank: Mint maturity not reached");
// calculate reward and mint tokens
uint256 rewardAmount = _calculateMintReward(
mintInfo.rank,
mintInfo.term,
mintInfo.maturityTs,
mintInfo.amplifier,
mintInfo.eaaRate
) * 1 ether;
_mint(_msgSender(), rewardAmount);
_cleanUpUserMint();
emit MintClaimed(_msgSender(), rewardAmount);
}
/**
* @dev ends minting upon maturity (and within permitted Withdrawal time Window)
* mints XEN coins and splits them between User and designated other address
*/
function claimMintRewardAndShare(address other, uint256 pct) external {
MintInfo memory mintInfo = userMints[_msgSender()];
require(other != address(0), "CRank: Cannot share with zero address");
require(pct > 0, "CRank: Cannot share zero percent");
require(pct < 101, "CRank: Cannot share 100+ percent");
require(mintInfo.rank > 0, "CRank: No mint exists");
require(block.timestamp > mintInfo.maturityTs, "CRank: Mint maturity not reached");
// calculate reward
uint256 rewardAmount = _calculateMintReward(
mintInfo.rank,
mintInfo.term,
mintInfo.maturityTs,
mintInfo.amplifier,
mintInfo.eaaRate
) * 1 ether;
uint256 sharedReward = (rewardAmount * pct) / 100;
uint256 ownReward = rewardAmount - sharedReward;
// mint reward tokens
_mint(_msgSender(), ownReward);
_mint(other, sharedReward);
_cleanUpUserMint();
emit MintClaimed(_msgSender(), rewardAmount);
}
/**
* @dev ends minting upon maturity (and within permitted Withdrawal time Window)
* mints XEN coins and stakes 'pct' of it for 'term'
*/
function claimMintRewardAndStake(uint256 pct, uint256 term) external {
MintInfo memory mintInfo = userMints[_msgSender()];
// require(pct > 0, "CRank: Cannot share zero percent");
require(pct < 101, "CRank: Cannot share >100 percent");
require(mintInfo.rank > 0, "CRank: No mint exists");
require(block.timestamp > mintInfo.maturityTs, "CRank: Mint maturity not reached");
// calculate reward
uint256 rewardAmount = _calculateMintReward(
mintInfo.rank,
mintInfo.term,
mintInfo.maturityTs,
mintInfo.amplifier,
mintInfo.eaaRate
) * 1 ether;
uint256 stakedReward = (rewardAmount * pct) / 100;
uint256 ownReward = rewardAmount - stakedReward;
// mint reward tokens part
_mint(_msgSender(), ownReward);
_cleanUpUserMint();
emit MintClaimed(_msgSender(), rewardAmount);
// nothing to burn since we haven't minted this part yet
// stake extra tokens part
require(stakedReward > XEN_MIN_STAKE, "XEN: Below min stake");
require(term * SECONDS_IN_DAY > MIN_TERM, "XEN: Below min stake term");
require(term * SECONDS_IN_DAY < MAX_TERM_END + 1, "XEN: Above max stake term");
require(userStakes[_msgSender()].amount == 0, "XEN: stake exists");
_createStake(stakedReward, term);
emit Staked(_msgSender(), stakedReward, term);
}
/**
* @dev initiates XEN Stake in amount for a term (days)
*/
function stake(uint256 amount, uint256 term) external {
require(balanceOf(_msgSender()) >= amount, "XEN: not enough balance");
require(amount > XEN_MIN_STAKE, "XEN: Below min stake");
require(term * SECONDS_IN_DAY > MIN_TERM, "XEN: Below min stake term");
require(term * SECONDS_IN_DAY < MAX_TERM_END + 1, "XEN: Above max stake term");
require(userStakes[_msgSender()].amount == 0, "XEN: stake exists");
// burn staked XEN
_burn(_msgSender(), amount);
// create XEN Stake
_createStake(amount, term);
emit Staked(_msgSender(), amount, term);
}
/**
* @dev ends XEN Stake and gets reward if the Stake is mature
*/
function withdraw() external {
StakeInfo memory userStake = userStakes[_msgSender()];
require(userStake.amount > 0, "XEN: no stake exists");
uint256 xenReward = _calculateStakeReward(
userStake.amount,
userStake.term,
userStake.maturityTs,
userStake.apy
);
activeStakes--;
totalXenStaked -= userStake.amount;
// mint staked XEN (+ reward)
_mint(_msgSender(), userStake.amount + xenReward);
emit Withdrawn(_msgSender(), userStake.amount, xenReward);
delete userStakes[_msgSender()];
}
/**
* @dev burns XEN tokens and creates Proof-Of-Burn record to be used by connected DeFi services
*/
function burn(address user, uint256 amount) public {
require(amount > XEN_MIN_BURN, "Burn: Below min limit");
require(
IERC165(_msgSender()).supportsInterface(type(IBurnRedeemable).interfaceId),
"Burn: not a supported contract"
);
_spendAllowance(user, _msgSender(), amount);
_burn(user, amount);
userBurns[user] += amount;
IBurnRedeemable(_msgSender()).onTokenBurned(user, amount);
}
}// SPDX-License-Identifier: MIT
pragma solidity ^0.8.10;
import "abdk-libraries-solidity/ABDKMath64x64.sol";
library Math {
function min(uint256 a, uint256 b) external pure returns (uint256) {
if (a > b) return b;
return a;
}
function max(uint256 a, uint256 b) external pure returns (uint256) {
if (a > b) return a;
return b;
}
function logX64(uint256 x) external pure returns (int128) {
return ABDKMath64x64.log_2(ABDKMath64x64.fromUInt(x));
}
}{
"remappings": [],
"optimizer": {
"enabled": true,
"runs": 20
},
"evmVersion": "london",
"libraries": {
"/contracts/libs/MintInfo.sol": {
"MintInfo": "0xC739d01beb34E380461BBa9ef8ed1a44874382Be"
},
"/contracts/libs/Metadata.sol": {
"Metadata": "0x1Ac17FFB8456525BfF46870bba7Ed8772ba063a5"
}
},
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"devdoc",
"userdoc",
"metadata",
"abi"
]
}
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[{"internalType":"address","name":"xenCrypto_","type":"address"},{"internalType":"uint256[]","name":"burnRates_","type":"uint256[]"},{"internalType":"uint256[]","name":"tokenLimits_","type":"uint256[]"},{"internalType":"uint256","name":"startBlockNumber_","type":"uint256"},{"internalType":"address","name":"forwarder_","type":"address"},{"internalType":"address","name":"royaltyReceiver_","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"OperatorNotAllowed","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":"address","name":"user","type":"address"},{"indexed":false,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"address","name":"to","type":"address"}],"name":"EndTorrent","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":true,"internalType":"address","name":"xenContract","type":"address"},{"indexed":true,"internalType":"address","name":"tokenContract","type":"address"},{"indexed":false,"internalType":"uint256","name":"xenAmount","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"tokenAmount","type":"uint256"}],"name":"Redeemed","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":false,"internalType":"uint256","name":"count","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"term","type":"uint256"}],"name":"StartTorrent","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":"AUTHORS","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"BLACKOUT_TERM","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"COMMON_CATEGORY_COUNTER","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"LIMITED_CATEGORY_TIME_THRESHOLD","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"OPERATOR_FILTER_REGISTRY","outputs":[{"internalType":"contract IOperatorFilterRegistry","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"POWER_GROUP_SIZE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ROYALTY_BP","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"SPECIAL_CATEGORIES_VMU_THRESHOLD","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"trustedForwarder","type":"address"}],"name":"addForwarder","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","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"},{"internalType":"address","name":"to","type":"address"}],"name":"bulkClaimMintReward","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"count","type":"uint256"},{"internalType":"uint256","name":"term","type":"uint256"}],"name":"bulkClaimRank","outputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"count","type":"uint256"},{"internalType":"uint256","name":"term","type":"uint256"},{"internalType":"uint256","name":"burning","type":"uint256"}],"name":"bulkClaimRankLimited","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"}],"name":"callClaimMintReward","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"term","type":"uint256"}],"name":"callClaimRank","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"genesisTs","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"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":"tokenId","type":"uint256"}],"name":"isApex","outputs":[{"internalType":"bool","name":"apex","type":"bool"}],"stateMutability":"pure","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":"forwarder","type":"address"}],"name":"isTrustedForwarder","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"mintInfo","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"burned","type":"uint256"}],"name":"onTokenBurned","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"ownedTokens","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"powerDown","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"royaltyAmount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"specialClassesBurnRates","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"specialClassesCounters","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"specialClassesTokenLimits","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"startBlockNumber","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"tokenIdCounter","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":[{"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":"","type":"uint256"}],"name":"vmuCount","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"","type":"uint256"}],"name":"xenBurned","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"xenCrypto","outputs":[{"internalType":"contract XENCrypto","name":"","type":"address"}],"stateMutability":"view","type":"function"}]Contract Creation Code
6101406040526127116007553480156200001857600080fd5b5060405162004789380380620047898339810160408190526200003b9162000594565b604080518082018252600b81526a16115388151bdc9c995b9d60aa1b602080830191909152825180840190935260048352631611539560e21b908301529083733cc6cdda760b79bafa08df41ecfa224f810dceb660016daaeb6d7670e522a718067333cd4e3b15620001d65780156200012457604051633e9f1edf60e11b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e90637d3e3dbe906044015b600060405180830381600087803b1580156200010557600080fd5b505af11580156200011a573d6000803e3d6000fd5b50505050620001d6565b6001600160a01b03821615620001755760405163a0af290360e01b81523060048201526001600160a01b03831660248201526daaeb6d7670e522a718067333cd4e9063a0af290390604401620000ea565b604051632210724360e11b81523060048201526daaeb6d7670e522a718067333cd4e90634420e48690602401600060405180830381600087803b158015620001bc57600080fd5b505af1158015620001d1573d6000803e3d6000fd5b505050505b5050600080546001600160a01b0319166001600160a01b03929092169190911790556001620002068382620006ce565b506002620002158282620006ce565b5050506001600160a01b038616620002625760405162461bcd60e51b815260206004820152600b60248201526a626164206164647265737360a81b60448201526064015b60405180910390fd5b8351855114801562000275575060008551115b620002b55760405162461bcd60e51b815260206004820152600f60248201526e0e0c2e4c2dae640dad2e6dac2e8c6d608b1b604482015260640162000259565b600019600e553060e05233610100526001600160a01b03811615620002db5780620002dd565b335b6001600160a01b039081166101205260c08490524260a052861660805284516200030f90600890602088019062000456565b5083516200032590600990602087019062000456565b5083516001600160401b03811115620003425762000342620004da565b6040519080825280602002602001820160405280156200036c578160200160208202803683370190505b5080516200038391600a9160209091019062000456565b5060025b6008546200039890600190620007b0565b81101562000412576009620003af826001620007cc565b81548110620003c257620003c2620007e2565b90600052602060002001546001620003db9190620007cc565b600a8281548110620003f157620003f1620007e2565b600091825260209091200155806200040981620007f8565b91505062000387565b50600854600190600a9062000429908390620007b0565b815481106200043c576200043c620007e2565b906000526020600020018190555050505050505062000814565b82805482825590600052602060002090810192821562000494579160200282015b828111156200049457825182559160200191906001019062000477565b50620004a2929150620004a6565b5090565b5b80821115620004a25760008155600101620004a7565b80516001600160a01b0381168114620004d557600080fd5b919050565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126200050257600080fd5b815160206001600160401b0380831115620005215762000521620004da565b8260051b604051601f19603f83011681018181108482111715620005495762000549620004da565b6040529384528581018301938381019250878511156200056857600080fd5b83870191505b8482101562000589578151835291830191908301906200056e565b979650505050505050565b60008060008060008060c08789031215620005ae57600080fd5b620005b987620004bd565b60208801519096506001600160401b0380821115620005d757600080fd5b620005e58a838b01620004f0565b96506040890151915080821115620005fc57600080fd5b506200060b89828a01620004f0565b945050606087015192506200062360808801620004bd565b91506200063360a08801620004bd565b90509295509295509295565b600181811c908216806200065457607f821691505b6020821081036200067557634e487b7160e01b600052602260045260246000fd5b50919050565b601f821115620006c957600081815260208120601f850160051c81016020861015620006a45750805b601f850160051c820191505b81811015620006c557828155600101620006b0565b5050505b505050565b81516001600160401b03811115620006ea57620006ea620004da565b6200070281620006fb84546200063f565b846200067b565b602080601f8311600181146200073a5760008415620007215750858301515b600019600386901b1c1916600185901b178555620006c5565b600085815260208120601f198616915b828110156200076b578886015182559484019460019091019084016200074a565b50858210156200078a5787850151600019600388901b60f8161c191681555b5050505050600190811b01905550565b634e487b7160e01b600052601160045260246000fd5b81810381811115620007c657620007c66200079a565b92915050565b80820180821115620007c657620007c66200079a565b634e487b7160e01b600052603260045260246000fd5b6000600182016200080d576200080d6200079a565b5060010190565b60805160a05160c05160e0516101005161012051613eb5620008d4600039600061090201526000818161045d0152610f460152600081816105de0152818161111e015261173001526000818161035e0152818161096d015281816111700152818161181c015261198601526000818161056301526121190152600081816104130152818161067401528181610a8a01528181610b7b01528181610ca201528181610d92015281816115a0015281816117be0152612d000152613eb56000f3fe608060405234801561001057600080fd5b506004361061021f5760003560e01c806370a082311161012c57806370a08231146103fb57806371141a581461040e57806374a1dff21461043557806389776eb0146104485780638da5cb5b1461045b578063928dd2a71461048157806395d89b411461048957806398bdf6f5146104915780639dc29fac1461049a578063a126ad1e146104ad578063a1a53fa1146104b7578063a22cb465146104d7578063b88d4fde146104ea578063ba3ec741146104fd578063bd33303314610505578063c87b56dd14610525578063d0d5f5b414610538578063df0030ef1461054b578063e3af6d0a1461055e578063e985e9c514610585578063ecef920114610598578063ee8743d7146105ab578063f5878b9b146105c057600080fd5b806301bb41161461022457806301ffc9a714610239578063044db8ba1461026157806306fdde0314610277578063081812fc1461028c578063095ea7b3146102ac57806319cba6b4146102bf57806323b872dd146102d45780632a55205a146102e757806341b169f31461030857806341f434341461031157806342842e0e14610326578063443aa53314610339578063498a4c2d146103595780634d4b2be41461038057806353b18de414610389578063543746b11461039c57806355ee08ba146103af578063572b6c05146103b75780635c41d2fe146103ca5780636352211e146103dd578063700107af146103f0575b600080fd5b6102376102323660046133b6565b6105d3565b005b61024c6102473660046133e5565b610726565b60405190151581526020015b60405180910390f35b61026960fa81565b604051908152602001610258565b61027f610787565b6040516102589190613452565b61029f61029a3660046133b6565b610819565b6040516102589190613465565b6102376102ba36600461348e565b610840565b6102c7610854565b60405161025891906134ba565b6102376102e23660046134fe565b6108d5565b6102fa6102f536600461353f565b610900565b604051610258929190613561565b610269611d4c81565b61029f6daaeb6d7670e522a718067333cd4e81565b6102376103343660046134fe565b610944565b6102696103473660046133b6565b600d6020526000908152604090205481565b6102697f000000000000000000000000000000000000000000000000000000000000000081565b61026961271181565b61026961039736600461357a565b610969565b6102376103aa36600461348e565b610d34565b610269606381565b61024c6103c53660046135a6565b610f27565b6102376103d83660046135a6565b610f3b565b61029f6103eb3660046133b6565b611027565b6102696301e1338081565b6102696104093660046135a6565b61105c565b61029f7f000000000000000000000000000000000000000000000000000000000000000081565b6102696104433660046133b6565b6110e2565b6102696104563660046133b6565b611103565b7f000000000000000000000000000000000000000000000000000000000000000061029f565b610237611113565b61027f61115f565b61026960075481565b6102376104a836600461348e565b61116e565b61026962093a8081565b6102696104c53660046133b6565b600b6020526000908152604090205481565b6102376104e53660046135d1565b6114db565b6102376104f8366004613677565b6114ef565b61027f61151c565b6102696105133660046133b6565b600c6020526000908152604090205481565b61027f6105333660046133b6565b611538565b6102696105463660046133b6565b611715565b6102376105593660046135a6565b611725565b6102697f000000000000000000000000000000000000000000000000000000000000000081565b61024c610593366004613725565b6117ea565b6102696105a636600461353f565b611818565b61024c6105b93660046133b6565b6127111190565b6102376105ce366004613753565b611984565b336001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016146106245760405162461bcd60e51b815260040161061b90613778565b60405180910390fd5b60008160405160240161063991815260200190565b60408051601f198184030181529181526020820180516001600160e01b0316639ff054df60e01b179052519091506000906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906106a09084906137c5565b6000604051808303816000865af19150503d80600081146106dd576040519150601f19603f3d011682016040523d82523d6000602084013e6106e2565b606091505b50509050806107215760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161061b565b505050565b60006001600160e01b0319821663543746b160e01b148061075757506001600160e01b0319821663152a902d60e11b145b8061077257506001600160e01b0319821663572b6c0560e01b145b80610781575061078182611e3b565b92915050565b606060018054610796906137e1565b80601f01602080910402602001604051908101604052809291908181526020018280546107c2906137e1565b801561080f5780601f106107e45761010080835404028352916020019161080f565b820191906000526020600020905b8154815290600101906020018083116107f257829003601f168201915b5050505050905090565b600061082482611e8b565b506000908152600560205260409020546001600160a01b031690565b8161084a81611eb3565b6107218383611f5b565b6060600f600061086261207d565b6001600160a01b03166001600160a01b0316815260200190815260200160002080548060200260200160405190810160405280929190818152602001828054801561080f57602002820191906000526020600020905b8154815260200190600101908083116108b8575050505050905090565b826001600160a01b03811633146108ef576108ef33611eb3565b6108fa84848461208c565b50505050565b7f0000000000000000000000000000000000000000000000000000000000000000600061271061093160fa85613831565b61093b919061385e565b90509250929050565b826001600160a01b038116331461095e5761095e33611eb3565b6108fa8484846120be565b60007f000000000000000000000000000000000000000000000000000000000000000043116109aa5760405162461bcd60e51b815260040161061b90613872565b600019600e54146109cd5760405162461bcd60e51b815260040161061b906138a1565b600084116109ed5760405162461bcd60e51b815260040161061b906138d5565b60008311610a0d5760405162461bcd60e51b815260040161061b90613903565b60016008600181548110610a2357610a23613930565b9060005260206000200154610a389190613946565b8211610a865760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a206e6f7420656e6f756768206275726e20616d6f756e74000000604482015260640161061b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b03166370a08231610abf61207d565b6040518263ffffffff1660e01b8152600401610adb9190613465565b602060405180830381865afa158015610af8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b1c9190613959565b9050610b29600184613946565b8111610b775760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a206e6f7420656e6f7567682058454e2062616c616e6365000000604482015260640161061b565b60007f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663dd62ed3e610bb061207d565b306040518363ffffffff1660e01b8152600401610bce929190613972565b602060405180830381865afa158015610beb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c0f9190613959565b9050610c1c600185613946565b8111610c825760405162461bcd60e51b815260206004820152602f60248201527f58454e46543a206e6f7420656e6f7567682058454e2062616c616e636520617060448201526e383937bb32b2103337b910313ab93760891b606482015260840161061b565b610c8c86856120d9565b600e81905550610ca08686600e5487612311565b7f00000000000000000000000000000000000000000000000000000000000000006001600160a01b0316639dc29fac610cd761207d565b866040518363ffffffff1660e01b8152600401610cf5929190613561565b600060405180830381600087803b158015610d0f57600080fd5b505af1158015610d23573d6000803e3d6000fd5b5050600e5498975050505050505050565b600019600e5403610d875760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a20696c6c6567616c2063616c6c6261636b207374617465000000604482015260640161061b565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610dff5760405162461bcd60e51b815260206004820152601e60248201527f58454e46543a20696c6c6567616c2063616c6c6261636b2063616c6c65720000604482015260640161061b565b600e546001600160a01b0383166000908152600f60205260409020610e23916124a9565b600e80546000908152600c6020526040902082905554610e44908390612523565b600e546000908152600b6020908152604080832054600d9092529182902054915163346ba94160e01b815260048101929092526001600160a01b038416917ffbb2077593b3594fd0ac359a2d898268191a74843aaf1ba3f517b5514a1b0711919073c739d01beb34e380461bba9ef8ed1a44874382be9063346ba94190602401602060405180830381865af4158015610ee1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f059190613959565b6040805192835260208301919091520160405180910390a25050600019600e55565b6000546001600160a01b0391821691161490565b336001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001614610fac5760405162461bcd60e51b81526020600482015260166024820152752c22a7232a1d103737ba1030b7103232b83637bcb2b960511b604482015260640161061b565b6000546001600160a01b0316156110055760405162461bcd60e51b815260206004820152601f60248201527f58454e46543a20466f7277617264657220697320616c72656164792073657400604482015260640161061b565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b6000818152600360205260408120546001600160a01b0316806107815760405162461bcd60e51b815260040161061b9061398c565b60006001600160a01b0382166110c65760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b606482015260840161061b565b506001600160a01b031660009081526004602052604090205490565b600981815481106110f257600080fd5b600091825260209091200154905081565b600a81815481106110f257600080fd5b336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161461115b5760405162461bcd60e51b815260040161061b90613778565b6000ff5b606060028054610796906137e1565b7f000000000000000000000000000000000000000000000000000000000000000043116111ad5760405162461bcd60e51b815260040161061b90613872565b600019600e54146111d05760405162461bcd60e51b815260040161061b906139be565b6111dd6001600019613946565b600e556111e861207d565b6040516301ffc9a760e01b815263543746b160e01b60048201526001600160a01b0391909116906301ffc9a790602401602060405180830381865afa158015611235573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061125991906139f2565b6112b15760405162461bcd60e51b8152602060048201526024808201527f58454e4654206275726e3a206e6f74206120737570706f7274656420636f6e746044820152631c9858dd60e21b606482015260840161061b565b6001600160a01b0382166113115760405162461bcd60e51b815260206004820152602160248201527f58454e4654206275726e3a20696c6c6567616c206f776e6572206164647265736044820152607360f81b606482015260840161061b565b6000811161135f5760405162461bcd60e51b815260206004820152601b60248201527a161153919508189d5c9b8e881a5b1b1959d85b081d1bdad95b9259602a1b604482015260640161061b565b61137061136a61207d565b8261253d565b6113c85760405162461bcd60e51b8152602060048201526024808201527f58454e4654206275726e3a206e6f7420616e20617070726f766564206f70657260448201526330ba37b960e11b606482015260840161061b565b816001600160a01b03166113db82611027565b6001600160a01b03161461143f5760405162461bcd60e51b815260206004820152602560248201527f58454e4654206275726e3a2075736572206973206e6f7420746f6b656e49642060448201526437bbb732b960d91b606482015260840161061b565b6001600160a01b0382166000908152600f60205260409020611461908261259c565b61146a81612681565b61147261207d565b6001600160a01b031663543746b183836040518363ffffffff1660e01b815260040161149f929190613561565b600060405180830381600087803b1580156114b957600080fd5b505af11580156114cd573d6000803e3d6000fd5b5050600019600e5550505050565b816114e581611eb3565b610721838361271e565b836001600160a01b03811633146115095761150933611eb3565b61151585858585612730565b5050505050565b604051806060016040528060258152602001613e5b6025913981565b6000818152600b6020908152604080832054600d835281842054600c90935292205460609291908261156957600080fd5b600061157486612769565b604051631b9345fd60e01b81526004810188905260248101869052604481018590526001600160a01b037f00000000000000000000000000000000000000000000000000000000000000001660648201526084810184905261163990731ac17ffb8456525bff46870bba7ed8772ba063a590631b9345fd9060a401600060405180830381865af415801561160c573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526116349190810190613a0f565b612869565b604051633c4a25e960e21b8152600481018790526024810185905260448101869052731ac17ffb8456525bff46870bba7ed8772ba063a59063f12897a490606401600060405180830381865af4158015611697573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526116bf9190810190613a0f565b6040516020016116d193929190613a85565b60405160208183030381529060405290506116eb81612869565b6040516020016116fb9190613ba3565b604051602081830303815290604052945050505050919050565b600881815481106110f257600080fd5b336001600160a01b037f0000000000000000000000000000000000000000000000000000000000000000161461176d5760405162461bcd60e51b815260040161061b90613778565b6000816064604051602401611783929190613561565b60408051601f198184030181529181526020820180516001600160e01b0316631c56030560e01b179052519091506000906001600160a01b037f000000000000000000000000000000000000000000000000000000000000000016906106a09084906137c5565b6001600160a01b03918216600090815260066020908152604080832093909416825291909152205460ff1690565b60007f000000000000000000000000000000000000000000000000000000000000000043116118595760405162461bcd60e51b815260040161061b90613872565b600019600e541461187c5760405162461bcd60e51b815260040161061b906138a1565b6000831161189c5760405162461bcd60e51b815260040161061b906138d5565b600082116118bc5760405162461bcd60e51b815260040161061b90613903565b6118c78360006120d9565b600e819055506118dc8383600e546000612311565b61190d600e54600f60006118ee61207d565b6001600160a01b031681526020810191909152604001600020906124a9565b61192061191861207d565b600e54612523565b61192861207d565b6001600160a01b03167ffbb2077593b3594fd0ac359a2d898268191a74843aaf1ba3f517b5514a1b0711848460405161196b929190918252602082015260400190565b60405180910390a25050600e8054600019909155919050565b7f000000000000000000000000000000000000000000000000000000000000000043116119c35760405162461bcd60e51b815260040161061b90613872565b600019600e54146119e65760405162461bcd60e51b815260040161061b906139be565b6119f36001600019613946565b600e556119fe61207d565b6001600160a01b0316611a1083611027565b6001600160a01b031614611a5f5760405162461bcd60e51b81526020600482015260166024820152752c22a7232a1d1024b731b7b93932b1ba1037bbb732b960511b604482015260640161061b565b6001600160a01b038116611aae5760405162461bcd60e51b815260206004820152601660248201527558454e46543a20496c6c6567616c206164647265737360501b604482015260640161061b565b6000828152600d60205260409081902054905163e90cdc8960e01b8152600481019190915273c739d01beb34e380461bba9ef8ed1a44874382be9063e90cdc8990602401602060405180830381865af4158015611b0f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b3391906139f2565b15611b7a5760405162461bcd60e51b815260206004820152601760248201527616115391950e88105b1c9958591e481c995919595b5959604a1b604482015260640161061b565b604051600090611bbe90733d602d80600a3d3981f3363d3d373d3d3d363d7360601b903060601b906e5af43d82803e903d91602b57fd5bf360881b90602001613be8565b60408051601f198184030181529181526000858152600b6020529081205491925090611beb906001613c16565b9050600083604051602401611c009190613465565b60408051601f19818403018152918152602080830180516001600160e01b0390811663df0030ef60e01b1790915282516004815260248101909352908201805190911663928dd2a760e01b17905290915060015b83811015611dbb576040805160208082018490528183018a90528251808303840181526060808401855281519183019190912089518a8401206001600160f81b031960808601523090921b6001600160601b03191660818501526095840181905260b5808501929092528451808503909201825260d5909301909352825192810192909220855191926000928291849182918a0182855af1925082611d475760405162461bcd60e51b815260206004820152602360248201527f58454e46543a204572726f72207768696c6520636c61696d696e67207265776160448201526272647360e81b606482015260840161061b565b6000808751602089016000855af1925082611da45760405162461bcd60e51b815260206004820181905260248201527f58454e46543a204572726f72207768696c6520706f776572696e6720646f776e604482015260640161061b565b505050508080611db390613c29565b915050611c54565b506000868152600d6020526040902080546001179055611dd961207d565b6001600160a01b03167f7ae39cb5fb0bebb7775f35a0009e0c94f59c2e40c8967af20842619edac4694d8787604051611e259291909182526001600160a01b0316602082015260400190565b60405180910390a25050600019600e5550505050565b60006001600160e01b031982166380ac58cd60e01b1480611e6c57506001600160e01b03198216635b5e139f60e01b145b8061078157506301ffc9a760e01b6001600160e01b0319831614610781565b611e94816129bb565b611eb05760405162461bcd60e51b815260040161061b9061398c565b50565b6daaeb6d7670e522a718067333cd4e3b15611eb057604051633185c44d60e21b81526daaeb6d7670e522a718067333cd4e9063c617113490611efb9030908590600401613972565b602060405180830381865afa158015611f18573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f3c91906139f2565b611eb05780604051633b79c77360e21b815260040161061b9190613465565b6000611f6682611027565b9050806001600160a01b0316836001600160a01b031603611fd35760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b606482015260840161061b565b806001600160a01b0316611fe561207d565b6001600160a01b0316148061200157506120018161059361207d565b6120735760405162461bcd60e51b815260206004820152603e60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206e6f7220617070726f76656420666f7220616c6c0000606482015260840161061b565b61072183836129d8565b6000612087612a46565b905090565b61209761136a61207d565b6120b35760405162461bcd60e51b815260040161061b90613c42565b610721838383612a68565b610721838383604051806020016040528060008152506114ef565b6000806120e583612c03565b9050806001036121a5576063841161210f5760405162461bcd60e51b815260040161061b90613c90565b61213d6301e133807f0000000000000000000000000000000000000000000000000000000000000000613c16565b42106121895760405162461bcd60e51b815260206004820152601b60248201527a16115391950e881b1a5b5a5d1959081d1a5b5948195e1c1a5c9959602a1b604482015260640161061b565b6007805490600061219983613c29565b91905055915050610781565b60018111156122f557326121b761207d565b6001600160a01b03161461221f5760405162461bcd60e51b815260206004820152602960248201527f58454e46543a206f6e6c7920454f4120616c6c6f77656420666f7220746869736044820152682063617465676f727960b81b606482015260840161061b565b6063841161223f5760405162461bcd60e51b815260040161061b90613c90565b6009818154811061225257612252613930565b906000526020600020015460016122699190613c16565b600a828154811061227c5761227c613930565b9060005260206000200154106122cc5760405162461bcd60e51b815260206004820152601560248201527416115391950e8818db185cdcc81cdbdb19081bdd5d605a1b604482015260640161061b565b600a81815481106122df576122df613930565b6000918252602082200180549161219983613c29565b6007805490600061230583613c29565b90915550949350505050565b60405160009061235590733d602d80600a3d3981f3363d3d373d3d3d363d7360601b903060601b906e5af43d82803e903d91602b57fd5bf360881b90602001613be8565b604051602081830303815290604052905060008460405160240161237b91815260200190565b60408051601f198184030181529190526020810180516001600160e01b031662dda08b60e11b179052905060008060015b6123b7896001613c16565b81101561248e576040805160208101839052908101889052600090606001604051602081830303815290604052805190602001209050808651602088016000f593506000808651602088016000885af19250826124565760405162461bcd60e51b815260206004820181905260248201527f58454e46543a204572726f72207768696c6520636c61696d696e672072616e6b604482015260640161061b565b8160010361247b5761246b848b8b8a8c612ca0565b6000898152600d60205260409020555b508061248681613c29565b9150506123ac565b50505060009384525050600b60205250604090209190915550565b612502828054806020026020016040519081016040528092919081815260200182805480156124f757602002820191906000526020600020905b8154815260200190600101908083116124e3575b505050505082612e57565b60000361251f578154600181018355600083815260209020018190555b5050565b61251f828260405180602001604052806000815250612e9f565b60008061254983611027565b9050806001600160a01b0316846001600160a01b03161480612570575061257081856117ea565b806125945750836001600160a01b031661258984610819565b6001600160a01b0316145b949350505050565b60006125f7838054806020026020016040519081016040528092919081815260200182805480156125ec57602002820191906000526020600020905b8154815260200190600101908083116125d8575b505050505083612e57565b90508015610721578254839061260f90600190613946565b8154811061261f5761261f613930565b9060005260206000200154836001836126389190613946565b8154811061264857612648613930565b90600052602060002001819055508280548061266657612666613cc4565b60019003818190600052602060002001600090559055505050565b600061268c82611027565b905061269a81600084612ed2565b6126a56000836129d8565b6001600160a01b03811660009081526004602052604081208054600192906126ce908490613946565b909155505060008281526003602052604080822080546001600160a01b0319169055518391906001600160a01b03841690600080516020613e3b833981519152908390a461251f81600084612ff3565b61251f61272961207d565b8383613037565b61274161273b61207d565b8361253d565b61275d5760405162461bcd60e51b815260040161061b90613c42565b6108fa84848484613101565b6060816000036127905750506040805180820190915260018152600360fc1b602082015290565b8160005b81156127ba57806127a481613c29565b91506127b39050600a8361385e565b9150612794565b6000816001600160401b038111156127d4576127d461360a565b6040519080825280601f01601f1916602001820160405280156127fe576020820181803683370190505b5090505b841561259457612813600183613946565b9150612820600a86613cda565b61282b906030613c16565b60f81b81838151811061284057612840613930565b60200101906001600160f81b031916908160001a905350612862600a8661385e565b9450612802565b6060815160000361288857505060408051602081019091526000815290565b6000604051806060016040528060408152602001613dfb60409139905060006003845160026128b79190613c16565b6128c1919061385e565b6128cc906004613831565b6001600160401b038111156128e3576128e361360a565b6040519080825280601f01601f19166020018201604052801561290d576020820181803683370190505b509050600182016020820185865187015b80821015612979576003820191508151603f8160121c168501518453600184019350603f81600c1c168501518453600184019350603f8160061c168501518453600184019350603f811685015184535060018301925061291e565b505060038651066001811461299557600281146129a8576129b0565b603d6001830353603d60028303536129b0565b603d60018303535b509195945050505050565b6000908152600360205260409020546001600160a01b0316151590565b600081815260056020526040902080546001600160a01b0319166001600160a01b0384169081179091558190612a0d82611027565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000612a5133610f27565b15612a63575060131936013560601c90565b503390565b826001600160a01b0316612a7b82611027565b6001600160a01b031614612adf5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b606482015260840161061b565b6001600160a01b038216612b415760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b606482015260840161061b565b612b4c838383612ed2565b612b576000826129d8565b6001600160a01b0383166000908152600460205260408120805460019290612b80908490613946565b90915550506001600160a01b0382166000908152600460205260408120805460019290612bae908490613c16565b909155505060008181526003602052604080822080546001600160a01b0319166001600160a01b038681169182179092559151849391871691600080516020613e3b83398151915291a4610721838383612ff3565b6008546000908190612c1790600190613946565b90505b8015612c975760088181548110612c3357612c33613930565b9060005260206000200154600003612c4e5750600092915050565b600160088281548110612c6357612c63613930565b9060005260206000200154612c789190613946565b831115612c855792915050565b80612c8f81613cee565b915050612c1a565b50600092915050565b600080612cae836127111190565b90506000612cbc8787613134565b90508115612ce157612ccd85612c03565b612cd8906007613c16565b60801760ff1690505b600085118015612cef575081155b15612cf8575060485b6000806000807f00000000000000000000000000000000000000000000000000000000000000006001600160a01b031663df2823318d6040518263ffffffff1660e01b8152600401612d4a9190613465565b60c060405180830381865afa158015612d67573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612d8b9190613d05565b9550955095509550505073c739d01beb34e380461bba9ef8ed1a44874382be63906029d98b868686868b60006040518863ffffffff1660e01b8152600401612e069796959493929190968752602087019590955260408601939093526060850191909152608084015260a0830152151560c082015260e00190565b602060405180830381865af4158015612e23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e479190613959565b9c9b505050505050505050505050565b60015b82518111612c97578183612e6f600184613946565b81518110612e7f57612e7f613930565b602002602001015103156107815780612e9781613c29565b915050612e5a565b612ea98383613161565b612eb66000848484613295565b6107215760405162461bcd60e51b815260040161061b90613d58565b6001600160a01b03831615610721576000818152600d602052604080822054905163125fb94760e11b8152600481019190915273c739d01beb34e380461bba9ef8ed1a44874382be906324bf728e90602401602060405180830381865af4158015612f41573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f659190613959565b90506000428211612f7f57612f7a8242613946565b612f89565b612f894283613946565b905062093a8081116115155760405162461bcd60e51b815260206004820152602d60248201527f58454e46543a207472616e736665722070726f6869626974656420696e20626c60448201526c1858dadbdd5d081c195c9a5bd9609a1b606482015260840161061b565b6001600160a01b0383166000908152600f60205260409020613015908261259c565b6001600160a01b0382166000908152600f6020526040902061072190826124a9565b816001600160a01b0316836001600160a01b0316036130945760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b604482015260640161061b565b6001600160a01b03838116600081815260066020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b61310c848484612a68565b61311884848484613295565b6108fa5760405162461bcd60e51b815260040161061b90613d58565b60006007613142848461339d565b111561315057506007610781565b61315a838361339d565b9392505050565b6001600160a01b0382166131b75760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f2061646472657373604482015260640161061b565b6131c0816129bb565b1561320c5760405162461bcd60e51b815260206004820152601c60248201527b115490cdcc8c4e881d1bdad95b88185b1c9958591e481b5a5b9d195960221b604482015260640161061b565b61321860008383612ed2565b6001600160a01b0382166000908152600460205260408120805460019290613241908490613c16565b909155505060008181526003602052604080822080546001600160a01b0319166001600160a01b0386169081179091559051839290600080516020613e3b833981519152908290a461251f60008383612ff3565b60006001600160a01b0384163b1561339257836001600160a01b031663150b7a026132be61207d565b8786866040518563ffffffff1660e01b81526004016132e09493929190613daa565b6020604051808303816000875af192505050801561331b575060408051601f3d908101601f1916820190925261331891810190613ddd565b60015b613378573d808015613349576040519150601f19603f3d011682016040523d82523d6000602084013e61334e565b606091505b5080516000036133705760405162461bcd60e51b815260040161061b90613d58565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050612594565b506001949350505050565b6000611d4c6133ac8385613831565b61315a919061385e565b6000602082840312156133c857600080fd5b5035919050565b6001600160e01b031981168114611eb057600080fd5b6000602082840312156133f757600080fd5b813561315a816133cf565b60005b8381101561341d578181015183820152602001613405565b50506000910152565b6000815180845261343e816020860160208601613402565b601f01601f19169290920160200192915050565b60208152600061315a6020830184613426565b6001600160a01b0391909116815260200190565b6001600160a01b0381168114611eb057600080fd5b600080604083850312156134a157600080fd5b82356134ac81613479565b946020939093013593505050565b6020808252825182820181905260009190848201906040850190845b818110156134f2578351835292840192918401916001016134d6565b50909695505050505050565b60008060006060848603121561351357600080fd5b833561351e81613479565b9250602084013561352e81613479565b929592945050506040919091013590565b6000806040838503121561355257600080fd5b50508035926020909101359150565b6001600160a01b03929092168252602082015260400190565b60008060006060848603121561358f57600080fd5b505081359360208301359350604090920135919050565b6000602082840312156135b857600080fd5b813561315a81613479565b8015158114611eb057600080fd5b600080604083850312156135e457600080fd5b82356135ef81613479565b915060208301356135ff816135c3565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156136485761364861360a565b604052919050565b60006001600160401b038211156136695761366961360a565b50601f01601f191660200190565b6000806000806080858703121561368d57600080fd5b843561369881613479565b935060208501356136a881613479565b92506040850135915060608501356001600160401b038111156136ca57600080fd5b8501601f810187136136db57600080fd5b80356136ee6136e982613650565b613620565b81815288602083850101111561370357600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b6000806040838503121561373857600080fd5b823561374381613479565b915060208301356135ff81613479565b6000806040838503121561376657600080fd5b8235915060208301356135ff81613479565b60208082526017908201527616115388141c9bde1e4e881d5b985d5d1a1bdc9a5e9959604a1b604082015260600190565b600081516137bb818560208601613402565b9290920192915050565b600082516137d7818460208701613402565b9190910192915050565b600181811c908216806137f557607f821691505b60208210810361381557634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176107815761078161381b565b634e487b7160e01b600052601260045260246000fd5b60008261386d5761386d613848565b500490565b60208082526015908201527416115391950e88139bdd081858dd1a5d99481e595d605a1b604082015260600190565b6020808252601a908201527916115391950e881c99595b9d1c985b98de4819195d1958dd195960321b604082015260600190565b60208082526014908201527316115391950e88125b1b1959d85b0818dbdd5b9d60621b604082015260600190565b60208082526013908201527258454e46543a20496c6c6567616c207465726d60681b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b818103818111156107815761078161381b565b60006020828403121561396b57600080fd5b5051919050565b6001600160a01b0392831681529116602082015260400190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b6020808252601a908201527916115391950e881499595b9d1c985b98de4819195d1958dd195960321b604082015260600190565b600060208284031215613a0457600080fd5b815161315a816135c3565b600060208284031215613a2157600080fd5b81516001600160401b03811115613a3757600080fd5b8201601f81018413613a4857600080fd5b8051613a566136e982613650565b818152856020838501011115613a6b57600080fd5b613a7c826020830160208601613402565b95945050505050565b607b60f81b815275226e616d65223a202258454e20546f7272656e74202360501b60018201528351600090613ac1816017850160208901613402565b61088b60f21b60179184019182018190527f226465736372697074696f6e223a202258454e46543a2058454e2043727970746019830152721bc8135a5b9d1a5b99c8151bdc9c995b9d088b606a1b6039830152691134b6b0b3b2911d101160b11b604c8301527919185d184e9a5b5859d94bdcdd99cade1b5b0ed8985cd94d8d0b60321b60568301528551613b5d816070850160208a01613402565b60709201918201526d01130ba3a3934b13aba32b9911d160951b6072820152613b99613b8c60808301866137a9565b607d60f81b815260010190565b9695505050505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c000000815260008251613bdb81601d850160208701613402565b91909101601d0192915050565b6001600160601b031993841681529190921660148201526001600160881b0319909116602882015260370190565b808201808211156107815761078161381b565b600060018201613c3b57613c3b61381b565b5060010190565b6020808252602e908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526d1c881b9bdc88185c1c1c9bdd995960921b606082015260800190565b6020808252601a908201527916115391950e881d5b99195c881c995c481593554818dbdd5b9d60321b604082015260600190565b634e487b7160e01b600052603160045260246000fd5b600082613ce957613ce9613848565b500690565b600081613cfd57613cfd61381b565b506000190190565b60008060008060008060c08789031215613d1e57600080fd5b8651613d2981613479565b6020880151604089015160608a015160808b015160a0909b0151939c929b509099909850965090945092505050565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090613b9990830184613426565b600060208284031215613def57600080fd5b815161315a816133cf56fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef404d724a61636b4c6576696e20406c62656c79616576206661697263727970746f2e6f7267a2646970667358221220900a6e3ce3545819bd9f522b427e40c33ce4b2890964e701e3a093f650d07a6464736f6c6343000811003300000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb800000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000000f8b9f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003903b9cfa1680ed9663ecec7d3412305bebe326f00000000000000000000000000000000000000000000000000000000000000070000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000cecb8f27f4200f3a0000000000000000000000000000000000000000000000019d971e4fe8401e740000000000000000000000000000000000000000000000033b2e3c9fd0803ce800000000000000000000000000000000000000000000000813f3978f8940984400000000000000000000000000000000000000000000001027e72f1f128130880000000000000000000000000000000000000000000000204fce5e3e25026110000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000017700000000000000000000000000000000000000000000000000000000000000bb800000000000000000000000000000000000000000000000000000000000003e80000000000000000000000000000000000000000000000000000000000000064
Deployed Bytecode
0x608060405234801561001057600080fd5b506004361061021f5760003560e01c806370a082311161012c57806370a08231146103fb57806371141a581461040e57806374a1dff21461043557806389776eb0146104485780638da5cb5b1461045b578063928dd2a71461048157806395d89b411461048957806398bdf6f5146104915780639dc29fac1461049a578063a126ad1e146104ad578063a1a53fa1146104b7578063a22cb465146104d7578063b88d4fde146104ea578063ba3ec741146104fd578063bd33303314610505578063c87b56dd14610525578063d0d5f5b414610538578063df0030ef1461054b578063e3af6d0a1461055e578063e985e9c514610585578063ecef920114610598578063ee8743d7146105ab578063f5878b9b146105c057600080fd5b806301bb41161461022457806301ffc9a714610239578063044db8ba1461026157806306fdde0314610277578063081812fc1461028c578063095ea7b3146102ac57806319cba6b4146102bf57806323b872dd146102d45780632a55205a146102e757806341b169f31461030857806341f434341461031157806342842e0e14610326578063443aa53314610339578063498a4c2d146103595780634d4b2be41461038057806353b18de414610389578063543746b11461039c57806355ee08ba146103af578063572b6c05146103b75780635c41d2fe146103ca5780636352211e146103dd578063700107af146103f0575b600080fd5b6102376102323660046133b6565b6105d3565b005b61024c6102473660046133e5565b610726565b60405190151581526020015b60405180910390f35b61026960fa81565b604051908152602001610258565b61027f610787565b6040516102589190613452565b61029f61029a3660046133b6565b610819565b6040516102589190613465565b6102376102ba36600461348e565b610840565b6102c7610854565b60405161025891906134ba565b6102376102e23660046134fe565b6108d5565b6102fa6102f536600461353f565b610900565b604051610258929190613561565b610269611d4c81565b61029f6daaeb6d7670e522a718067333cd4e81565b6102376103343660046134fe565b610944565b6102696103473660046133b6565b600d6020526000908152604090205481565b6102697f0000000000000000000000000000000000000000000000000000000000f8b9f081565b61026961271181565b61026961039736600461357a565b610969565b6102376103aa36600461348e565b610d34565b610269606381565b61024c6103c53660046135a6565b610f27565b6102376103d83660046135a6565b610f3b565b61029f6103eb3660046133b6565b611027565b6102696301e1338081565b6102696104093660046135a6565b61105c565b61029f7f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb881565b6102696104433660046133b6565b6110e2565b6102696104563660046133b6565b611103565b7f000000000000000000000000c73fc08c931efe3fce850c09278472e8a81c2e0561029f565b610237611113565b61027f61115f565b61026960075481565b6102376104a836600461348e565b61116e565b61026962093a8081565b6102696104c53660046133b6565b600b6020526000908152604090205481565b6102376104e53660046135d1565b6114db565b6102376104f8366004613677565b6114ef565b61027f61151c565b6102696105133660046133b6565b600c6020526000908152604090205481565b61027f6105333660046133b6565b611538565b6102696105463660046133b6565b611715565b6102376105593660046135a6565b611725565b6102697f0000000000000000000000000000000000000000000000000000000063ae743381565b61024c610593366004613725565b6117ea565b6102696105a636600461353f565b611818565b61024c6105b93660046133b6565b6127111190565b6102376105ce366004613753565b611984565b336001600160a01b037f0000000000000000000000000a252663dbcc0b073063d6420a40319e438cfa5916146106245760405162461bcd60e51b815260040161061b90613778565b60405180910390fd5b60008160405160240161063991815260200190565b60408051601f198184030181529181526020820180516001600160e01b0316639ff054df60e01b179052519091506000906001600160a01b037f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb816906106a09084906137c5565b6000604051808303816000865af19150503d80600081146106dd576040519150601f19603f3d011682016040523d82523d6000602084013e6106e2565b606091505b50509050806107215760405162461bcd60e51b815260206004820152600b60248201526a18d85b1b0819985a5b195960aa1b604482015260640161061b565b505050565b60006001600160e01b0319821663543746b160e01b148061075757506001600160e01b0319821663152a902d60e11b145b8061077257506001600160e01b0319821663572b6c0560e01b145b80610781575061078182611e3b565b92915050565b606060018054610796906137e1565b80601f01602080910402602001604051908101604052809291908181526020018280546107c2906137e1565b801561080f5780601f106107e45761010080835404028352916020019161080f565b820191906000526020600020905b8154815290600101906020018083116107f257829003601f168201915b5050505050905090565b600061082482611e8b565b506000908152600560205260409020546001600160a01b031690565b8161084a81611eb3565b6107218383611f5b565b6060600f600061086261207d565b6001600160a01b03166001600160a01b0316815260200190815260200160002080548060200260200160405190810160405280929190818152602001828054801561080f57602002820191906000526020600020905b8154815260200190600101908083116108b8575050505050905090565b826001600160a01b03811633146108ef576108ef33611eb3565b6108fa84848461208c565b50505050565b7f0000000000000000000000003903b9cfa1680ed9663ecec7d3412305bebe326f600061271061093160fa85613831565b61093b919061385e565b90509250929050565b826001600160a01b038116331461095e5761095e33611eb3565b6108fa8484846120be565b60007f0000000000000000000000000000000000000000000000000000000000f8b9f043116109aa5760405162461bcd60e51b815260040161061b90613872565b600019600e54146109cd5760405162461bcd60e51b815260040161061b906138a1565b600084116109ed5760405162461bcd60e51b815260040161061b906138d5565b60008311610a0d5760405162461bcd60e51b815260040161061b90613903565b60016008600181548110610a2357610a23613930565b9060005260206000200154610a389190613946565b8211610a865760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a206e6f7420656e6f756768206275726e20616d6f756e74000000604482015260640161061b565b60007f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb86001600160a01b03166370a08231610abf61207d565b6040518263ffffffff1660e01b8152600401610adb9190613465565b602060405180830381865afa158015610af8573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610b1c9190613959565b9050610b29600184613946565b8111610b775760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a206e6f7420656e6f7567682058454e2062616c616e6365000000604482015260640161061b565b60007f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb86001600160a01b031663dd62ed3e610bb061207d565b306040518363ffffffff1660e01b8152600401610bce929190613972565b602060405180830381865afa158015610beb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c0f9190613959565b9050610c1c600185613946565b8111610c825760405162461bcd60e51b815260206004820152602f60248201527f58454e46543a206e6f7420656e6f7567682058454e2062616c616e636520617060448201526e383937bb32b2103337b910313ab93760891b606482015260840161061b565b610c8c86856120d9565b600e81905550610ca08686600e5487612311565b7f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb86001600160a01b0316639dc29fac610cd761207d565b866040518363ffffffff1660e01b8152600401610cf5929190613561565b600060405180830381600087803b158015610d0f57600080fd5b505af1158015610d23573d6000803e3d6000fd5b5050600e5498975050505050505050565b600019600e5403610d875760405162461bcd60e51b815260206004820152601d60248201527f58454e46543a20696c6c6567616c2063616c6c6261636b207374617465000000604482015260640161061b565b336001600160a01b037f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb81614610dff5760405162461bcd60e51b815260206004820152601e60248201527f58454e46543a20696c6c6567616c2063616c6c6261636b2063616c6c65720000604482015260640161061b565b600e546001600160a01b0383166000908152600f60205260409020610e23916124a9565b600e80546000908152600c6020526040902082905554610e44908390612523565b600e546000908152600b6020908152604080832054600d9092529182902054915163346ba94160e01b815260048101929092526001600160a01b038416917ffbb2077593b3594fd0ac359a2d898268191a74843aaf1ba3f517b5514a1b0711919073c739d01beb34e380461bba9ef8ed1a44874382be9063346ba94190602401602060405180830381865af4158015610ee1573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f059190613959565b6040805192835260208301919091520160405180910390a25050600019600e55565b6000546001600160a01b0391821691161490565b336001600160a01b037f000000000000000000000000c73fc08c931efe3fce850c09278472e8a81c2e051614610fac5760405162461bcd60e51b81526020600482015260166024820152752c22a7232a1d103737ba1030b7103232b83637bcb2b960511b604482015260640161061b565b6000546001600160a01b0316156110055760405162461bcd60e51b815260206004820152601f60248201527f58454e46543a20466f7277617264657220697320616c72656164792073657400604482015260640161061b565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b6000818152600360205260408120546001600160a01b0316806107815760405162461bcd60e51b815260040161061b9061398c565b60006001600160a01b0382166110c65760405162461bcd60e51b815260206004820152602960248201527f4552433732313a2061646472657373207a65726f206973206e6f7420612076616044820152683634b21037bbb732b960b91b606482015260840161061b565b506001600160a01b031660009081526004602052604090205490565b600981815481106110f257600080fd5b600091825260209091200154905081565b600a81815481106110f257600080fd5b336001600160a01b037f0000000000000000000000000a252663dbcc0b073063d6420a40319e438cfa59161461115b5760405162461bcd60e51b815260040161061b90613778565b6000ff5b606060028054610796906137e1565b7f0000000000000000000000000000000000000000000000000000000000f8b9f043116111ad5760405162461bcd60e51b815260040161061b90613872565b600019600e54146111d05760405162461bcd60e51b815260040161061b906139be565b6111dd6001600019613946565b600e556111e861207d565b6040516301ffc9a760e01b815263543746b160e01b60048201526001600160a01b0391909116906301ffc9a790602401602060405180830381865afa158015611235573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061125991906139f2565b6112b15760405162461bcd60e51b8152602060048201526024808201527f58454e4654206275726e3a206e6f74206120737570706f7274656420636f6e746044820152631c9858dd60e21b606482015260840161061b565b6001600160a01b0382166113115760405162461bcd60e51b815260206004820152602160248201527f58454e4654206275726e3a20696c6c6567616c206f776e6572206164647265736044820152607360f81b606482015260840161061b565b6000811161135f5760405162461bcd60e51b815260206004820152601b60248201527a161153919508189d5c9b8e881a5b1b1959d85b081d1bdad95b9259602a1b604482015260640161061b565b61137061136a61207d565b8261253d565b6113c85760405162461bcd60e51b8152602060048201526024808201527f58454e4654206275726e3a206e6f7420616e20617070726f766564206f70657260448201526330ba37b960e11b606482015260840161061b565b816001600160a01b03166113db82611027565b6001600160a01b03161461143f5760405162461bcd60e51b815260206004820152602560248201527f58454e4654206275726e3a2075736572206973206e6f7420746f6b656e49642060448201526437bbb732b960d91b606482015260840161061b565b6001600160a01b0382166000908152600f60205260409020611461908261259c565b61146a81612681565b61147261207d565b6001600160a01b031663543746b183836040518363ffffffff1660e01b815260040161149f929190613561565b600060405180830381600087803b1580156114b957600080fd5b505af11580156114cd573d6000803e3d6000fd5b5050600019600e5550505050565b816114e581611eb3565b610721838361271e565b836001600160a01b03811633146115095761150933611eb3565b61151585858585612730565b5050505050565b604051806060016040528060258152602001613e5b6025913981565b6000818152600b6020908152604080832054600d835281842054600c90935292205460609291908261156957600080fd5b600061157486612769565b604051631b9345fd60e01b81526004810188905260248101869052604481018590526001600160a01b037f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb81660648201526084810184905261163990731ac17ffb8456525bff46870bba7ed8772ba063a590631b9345fd9060a401600060405180830381865af415801561160c573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526116349190810190613a0f565b612869565b604051633c4a25e960e21b8152600481018790526024810185905260448101869052731ac17ffb8456525bff46870bba7ed8772ba063a59063f12897a490606401600060405180830381865af4158015611697573d6000803e3d6000fd5b505050506040513d6000823e601f3d908101601f191682016040526116bf9190810190613a0f565b6040516020016116d193929190613a85565b60405160208183030381529060405290506116eb81612869565b6040516020016116fb9190613ba3565b604051602081830303815290604052945050505050919050565b600881815481106110f257600080fd5b336001600160a01b037f0000000000000000000000000a252663dbcc0b073063d6420a40319e438cfa59161461176d5760405162461bcd60e51b815260040161061b90613778565b6000816064604051602401611783929190613561565b60408051601f198184030181529181526020820180516001600160e01b0316631c56030560e01b179052519091506000906001600160a01b037f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb816906106a09084906137c5565b6001600160a01b03918216600090815260066020908152604080832093909416825291909152205460ff1690565b60007f0000000000000000000000000000000000000000000000000000000000f8b9f043116118595760405162461bcd60e51b815260040161061b90613872565b600019600e541461187c5760405162461bcd60e51b815260040161061b906138a1565b6000831161189c5760405162461bcd60e51b815260040161061b906138d5565b600082116118bc5760405162461bcd60e51b815260040161061b90613903565b6118c78360006120d9565b600e819055506118dc8383600e546000612311565b61190d600e54600f60006118ee61207d565b6001600160a01b031681526020810191909152604001600020906124a9565b61192061191861207d565b600e54612523565b61192861207d565b6001600160a01b03167ffbb2077593b3594fd0ac359a2d898268191a74843aaf1ba3f517b5514a1b0711848460405161196b929190918252602082015260400190565b60405180910390a25050600e8054600019909155919050565b7f0000000000000000000000000000000000000000000000000000000000f8b9f043116119c35760405162461bcd60e51b815260040161061b90613872565b600019600e54146119e65760405162461bcd60e51b815260040161061b906139be565b6119f36001600019613946565b600e556119fe61207d565b6001600160a01b0316611a1083611027565b6001600160a01b031614611a5f5760405162461bcd60e51b81526020600482015260166024820152752c22a7232a1d1024b731b7b93932b1ba1037bbb732b960511b604482015260640161061b565b6001600160a01b038116611aae5760405162461bcd60e51b815260206004820152601660248201527558454e46543a20496c6c6567616c206164647265737360501b604482015260640161061b565b6000828152600d60205260409081902054905163e90cdc8960e01b8152600481019190915273c739d01beb34e380461bba9ef8ed1a44874382be9063e90cdc8990602401602060405180830381865af4158015611b0f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b3391906139f2565b15611b7a5760405162461bcd60e51b815260206004820152601760248201527616115391950e88105b1c9958591e481c995919595b5959604a1b604482015260640161061b565b604051600090611bbe90733d602d80600a3d3981f3363d3d373d3d3d363d7360601b903060601b906e5af43d82803e903d91602b57fd5bf360881b90602001613be8565b60408051601f198184030181529181526000858152600b6020529081205491925090611beb906001613c16565b9050600083604051602401611c009190613465565b60408051601f19818403018152918152602080830180516001600160e01b0390811663df0030ef60e01b1790915282516004815260248101909352908201805190911663928dd2a760e01b17905290915060015b83811015611dbb576040805160208082018490528183018a90528251808303840181526060808401855281519183019190912089518a8401206001600160f81b031960808601523090921b6001600160601b03191660818501526095840181905260b5808501929092528451808503909201825260d5909301909352825192810192909220855191926000928291849182918a0182855af1925082611d475760405162461bcd60e51b815260206004820152602360248201527f58454e46543a204572726f72207768696c6520636c61696d696e67207265776160448201526272647360e81b606482015260840161061b565b6000808751602089016000855af1925082611da45760405162461bcd60e51b815260206004820181905260248201527f58454e46543a204572726f72207768696c6520706f776572696e6720646f776e604482015260640161061b565b505050508080611db390613c29565b915050611c54565b506000868152600d6020526040902080546001179055611dd961207d565b6001600160a01b03167f7ae39cb5fb0bebb7775f35a0009e0c94f59c2e40c8967af20842619edac4694d8787604051611e259291909182526001600160a01b0316602082015260400190565b60405180910390a25050600019600e5550505050565b60006001600160e01b031982166380ac58cd60e01b1480611e6c57506001600160e01b03198216635b5e139f60e01b145b8061078157506301ffc9a760e01b6001600160e01b0319831614610781565b611e94816129bb565b611eb05760405162461bcd60e51b815260040161061b9061398c565b50565b6daaeb6d7670e522a718067333cd4e3b15611eb057604051633185c44d60e21b81526daaeb6d7670e522a718067333cd4e9063c617113490611efb9030908590600401613972565b602060405180830381865afa158015611f18573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f3c91906139f2565b611eb05780604051633b79c77360e21b815260040161061b9190613465565b6000611f6682611027565b9050806001600160a01b0316836001600160a01b031603611fd35760405162461bcd60e51b815260206004820152602160248201527f4552433732313a20617070726f76616c20746f2063757272656e74206f776e656044820152603960f91b606482015260840161061b565b806001600160a01b0316611fe561207d565b6001600160a01b0316148061200157506120018161059361207d565b6120735760405162461bcd60e51b815260206004820152603e60248201527f4552433732313a20617070726f76652063616c6c6572206973206e6f7420746f60448201527f6b656e206f776e6572206e6f7220617070726f76656420666f7220616c6c0000606482015260840161061b565b61072183836129d8565b6000612087612a46565b905090565b61209761136a61207d565b6120b35760405162461bcd60e51b815260040161061b90613c42565b610721838383612a68565b610721838383604051806020016040528060008152506114ef565b6000806120e583612c03565b9050806001036121a5576063841161210f5760405162461bcd60e51b815260040161061b90613c90565b61213d6301e133807f0000000000000000000000000000000000000000000000000000000063ae7433613c16565b42106121895760405162461bcd60e51b815260206004820152601b60248201527a16115391950e881b1a5b5a5d1959081d1a5b5948195e1c1a5c9959602a1b604482015260640161061b565b6007805490600061219983613c29565b91905055915050610781565b60018111156122f557326121b761207d565b6001600160a01b03161461221f5760405162461bcd60e51b815260206004820152602960248201527f58454e46543a206f6e6c7920454f4120616c6c6f77656420666f7220746869736044820152682063617465676f727960b81b606482015260840161061b565b6063841161223f5760405162461bcd60e51b815260040161061b90613c90565b6009818154811061225257612252613930565b906000526020600020015460016122699190613c16565b600a828154811061227c5761227c613930565b9060005260206000200154106122cc5760405162461bcd60e51b815260206004820152601560248201527416115391950e8818db185cdcc81cdbdb19081bdd5d605a1b604482015260640161061b565b600a81815481106122df576122df613930565b6000918252602082200180549161219983613c29565b6007805490600061230583613c29565b90915550949350505050565b60405160009061235590733d602d80600a3d3981f3363d3d373d3d3d363d7360601b903060601b906e5af43d82803e903d91602b57fd5bf360881b90602001613be8565b604051602081830303815290604052905060008460405160240161237b91815260200190565b60408051601f198184030181529190526020810180516001600160e01b031662dda08b60e11b179052905060008060015b6123b7896001613c16565b81101561248e576040805160208101839052908101889052600090606001604051602081830303815290604052805190602001209050808651602088016000f593506000808651602088016000885af19250826124565760405162461bcd60e51b815260206004820181905260248201527f58454e46543a204572726f72207768696c6520636c61696d696e672072616e6b604482015260640161061b565b8160010361247b5761246b848b8b8a8c612ca0565b6000898152600d60205260409020555b508061248681613c29565b9150506123ac565b50505060009384525050600b60205250604090209190915550565b612502828054806020026020016040519081016040528092919081815260200182805480156124f757602002820191906000526020600020905b8154815260200190600101908083116124e3575b505050505082612e57565b60000361251f578154600181018355600083815260209020018190555b5050565b61251f828260405180602001604052806000815250612e9f565b60008061254983611027565b9050806001600160a01b0316846001600160a01b03161480612570575061257081856117ea565b806125945750836001600160a01b031661258984610819565b6001600160a01b0316145b949350505050565b60006125f7838054806020026020016040519081016040528092919081815260200182805480156125ec57602002820191906000526020600020905b8154815260200190600101908083116125d8575b505050505083612e57565b90508015610721578254839061260f90600190613946565b8154811061261f5761261f613930565b9060005260206000200154836001836126389190613946565b8154811061264857612648613930565b90600052602060002001819055508280548061266657612666613cc4565b60019003818190600052602060002001600090559055505050565b600061268c82611027565b905061269a81600084612ed2565b6126a56000836129d8565b6001600160a01b03811660009081526004602052604081208054600192906126ce908490613946565b909155505060008281526003602052604080822080546001600160a01b0319169055518391906001600160a01b03841690600080516020613e3b833981519152908390a461251f81600084612ff3565b61251f61272961207d565b8383613037565b61274161273b61207d565b8361253d565b61275d5760405162461bcd60e51b815260040161061b90613c42565b6108fa84848484613101565b6060816000036127905750506040805180820190915260018152600360fc1b602082015290565b8160005b81156127ba57806127a481613c29565b91506127b39050600a8361385e565b9150612794565b6000816001600160401b038111156127d4576127d461360a565b6040519080825280601f01601f1916602001820160405280156127fe576020820181803683370190505b5090505b841561259457612813600183613946565b9150612820600a86613cda565b61282b906030613c16565b60f81b81838151811061284057612840613930565b60200101906001600160f81b031916908160001a905350612862600a8661385e565b9450612802565b6060815160000361288857505060408051602081019091526000815290565b6000604051806060016040528060408152602001613dfb60409139905060006003845160026128b79190613c16565b6128c1919061385e565b6128cc906004613831565b6001600160401b038111156128e3576128e361360a565b6040519080825280601f01601f19166020018201604052801561290d576020820181803683370190505b509050600182016020820185865187015b80821015612979576003820191508151603f8160121c168501518453600184019350603f81600c1c168501518453600184019350603f8160061c168501518453600184019350603f811685015184535060018301925061291e565b505060038651066001811461299557600281146129a8576129b0565b603d6001830353603d60028303536129b0565b603d60018303535b509195945050505050565b6000908152600360205260409020546001600160a01b0316151590565b600081815260056020526040902080546001600160a01b0319166001600160a01b0384169081179091558190612a0d82611027565b6001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45050565b6000612a5133610f27565b15612a63575060131936013560601c90565b503390565b826001600160a01b0316612a7b82611027565b6001600160a01b031614612adf5760405162461bcd60e51b815260206004820152602560248201527f4552433732313a207472616e736665722066726f6d20696e636f72726563742060448201526437bbb732b960d91b606482015260840161061b565b6001600160a01b038216612b415760405162461bcd60e51b8152602060048201526024808201527f4552433732313a207472616e7366657220746f20746865207a65726f206164646044820152637265737360e01b606482015260840161061b565b612b4c838383612ed2565b612b576000826129d8565b6001600160a01b0383166000908152600460205260408120805460019290612b80908490613946565b90915550506001600160a01b0382166000908152600460205260408120805460019290612bae908490613c16565b909155505060008181526003602052604080822080546001600160a01b0319166001600160a01b038681169182179092559151849391871691600080516020613e3b83398151915291a4610721838383612ff3565b6008546000908190612c1790600190613946565b90505b8015612c975760088181548110612c3357612c33613930565b9060005260206000200154600003612c4e5750600092915050565b600160088281548110612c6357612c63613930565b9060005260206000200154612c789190613946565b831115612c855792915050565b80612c8f81613cee565b915050612c1a565b50600092915050565b600080612cae836127111190565b90506000612cbc8787613134565b90508115612ce157612ccd85612c03565b612cd8906007613c16565b60801760ff1690505b600085118015612cef575081155b15612cf8575060485b6000806000807f00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb86001600160a01b031663df2823318d6040518263ffffffff1660e01b8152600401612d4a9190613465565b60c060405180830381865afa158015612d67573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612d8b9190613d05565b9550955095509550505073c739d01beb34e380461bba9ef8ed1a44874382be63906029d98b868686868b60006040518863ffffffff1660e01b8152600401612e069796959493929190968752602087019590955260408601939093526060850191909152608084015260a0830152151560c082015260e00190565b602060405180830381865af4158015612e23573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612e479190613959565b9c9b505050505050505050505050565b60015b82518111612c97578183612e6f600184613946565b81518110612e7f57612e7f613930565b602002602001015103156107815780612e9781613c29565b915050612e5a565b612ea98383613161565b612eb66000848484613295565b6107215760405162461bcd60e51b815260040161061b90613d58565b6001600160a01b03831615610721576000818152600d602052604080822054905163125fb94760e11b8152600481019190915273c739d01beb34e380461bba9ef8ed1a44874382be906324bf728e90602401602060405180830381865af4158015612f41573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f659190613959565b90506000428211612f7f57612f7a8242613946565b612f89565b612f894283613946565b905062093a8081116115155760405162461bcd60e51b815260206004820152602d60248201527f58454e46543a207472616e736665722070726f6869626974656420696e20626c60448201526c1858dadbdd5d081c195c9a5bd9609a1b606482015260840161061b565b6001600160a01b0383166000908152600f60205260409020613015908261259c565b6001600160a01b0382166000908152600f6020526040902061072190826124a9565b816001600160a01b0316836001600160a01b0316036130945760405162461bcd60e51b815260206004820152601960248201527822a9219b99189d1030b8383937bb32903a379031b0b63632b960391b604482015260640161061b565b6001600160a01b03838116600081815260066020908152604080832094871680845294825291829020805460ff191686151590811790915591519182527f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31910160405180910390a3505050565b61310c848484612a68565b61311884848484613295565b6108fa5760405162461bcd60e51b815260040161061b90613d58565b60006007613142848461339d565b111561315057506007610781565b61315a838361339d565b9392505050565b6001600160a01b0382166131b75760405162461bcd60e51b815260206004820181905260248201527f4552433732313a206d696e7420746f20746865207a65726f2061646472657373604482015260640161061b565b6131c0816129bb565b1561320c5760405162461bcd60e51b815260206004820152601c60248201527b115490cdcc8c4e881d1bdad95b88185b1c9958591e481b5a5b9d195960221b604482015260640161061b565b61321860008383612ed2565b6001600160a01b0382166000908152600460205260408120805460019290613241908490613c16565b909155505060008181526003602052604080822080546001600160a01b0319166001600160a01b0386169081179091559051839290600080516020613e3b833981519152908290a461251f60008383612ff3565b60006001600160a01b0384163b1561339257836001600160a01b031663150b7a026132be61207d565b8786866040518563ffffffff1660e01b81526004016132e09493929190613daa565b6020604051808303816000875af192505050801561331b575060408051601f3d908101601f1916820190925261331891810190613ddd565b60015b613378573d808015613349576040519150601f19603f3d011682016040523d82523d6000602084013e61334e565b606091505b5080516000036133705760405162461bcd60e51b815260040161061b90613d58565b805181602001fd5b6001600160e01b031916630a85bd0160e11b149050612594565b506001949350505050565b6000611d4c6133ac8385613831565b61315a919061385e565b6000602082840312156133c857600080fd5b5035919050565b6001600160e01b031981168114611eb057600080fd5b6000602082840312156133f757600080fd5b813561315a816133cf565b60005b8381101561341d578181015183820152602001613405565b50506000910152565b6000815180845261343e816020860160208601613402565b601f01601f19169290920160200192915050565b60208152600061315a6020830184613426565b6001600160a01b0391909116815260200190565b6001600160a01b0381168114611eb057600080fd5b600080604083850312156134a157600080fd5b82356134ac81613479565b946020939093013593505050565b6020808252825182820181905260009190848201906040850190845b818110156134f2578351835292840192918401916001016134d6565b50909695505050505050565b60008060006060848603121561351357600080fd5b833561351e81613479565b9250602084013561352e81613479565b929592945050506040919091013590565b6000806040838503121561355257600080fd5b50508035926020909101359150565b6001600160a01b03929092168252602082015260400190565b60008060006060848603121561358f57600080fd5b505081359360208301359350604090920135919050565b6000602082840312156135b857600080fd5b813561315a81613479565b8015158114611eb057600080fd5b600080604083850312156135e457600080fd5b82356135ef81613479565b915060208301356135ff816135c3565b809150509250929050565b634e487b7160e01b600052604160045260246000fd5b604051601f8201601f191681016001600160401b03811182821017156136485761364861360a565b604052919050565b60006001600160401b038211156136695761366961360a565b50601f01601f191660200190565b6000806000806080858703121561368d57600080fd5b843561369881613479565b935060208501356136a881613479565b92506040850135915060608501356001600160401b038111156136ca57600080fd5b8501601f810187136136db57600080fd5b80356136ee6136e982613650565b613620565b81815288602083850101111561370357600080fd5b8160208401602083013760006020838301015280935050505092959194509250565b6000806040838503121561373857600080fd5b823561374381613479565b915060208301356135ff81613479565b6000806040838503121561376657600080fd5b8235915060208301356135ff81613479565b60208082526017908201527616115388141c9bde1e4e881d5b985d5d1a1bdc9a5e9959604a1b604082015260600190565b600081516137bb818560208601613402565b9290920192915050565b600082516137d7818460208701613402565b9190910192915050565b600181811c908216806137f557607f821691505b60208210810361381557634e487b7160e01b600052602260045260246000fd5b50919050565b634e487b7160e01b600052601160045260246000fd5b80820281158282048414176107815761078161381b565b634e487b7160e01b600052601260045260246000fd5b60008261386d5761386d613848565b500490565b60208082526015908201527416115391950e88139bdd081858dd1a5d99481e595d605a1b604082015260600190565b6020808252601a908201527916115391950e881c99595b9d1c985b98de4819195d1958dd195960321b604082015260600190565b60208082526014908201527316115391950e88125b1b1959d85b0818dbdd5b9d60621b604082015260600190565b60208082526013908201527258454e46543a20496c6c6567616c207465726d60681b604082015260600190565b634e487b7160e01b600052603260045260246000fd5b818103818111156107815761078161381b565b60006020828403121561396b57600080fd5b5051919050565b6001600160a01b0392831681529116602082015260400190565b602080825260189082015277115490cdcc8c4e881a5b9d985b1a59081d1bdad95b88125160421b604082015260600190565b6020808252601a908201527916115391950e881499595b9d1c985b98de4819195d1958dd195960321b604082015260600190565b600060208284031215613a0457600080fd5b815161315a816135c3565b600060208284031215613a2157600080fd5b81516001600160401b03811115613a3757600080fd5b8201601f81018413613a4857600080fd5b8051613a566136e982613650565b818152856020838501011115613a6b57600080fd5b613a7c826020830160208601613402565b95945050505050565b607b60f81b815275226e616d65223a202258454e20546f7272656e74202360501b60018201528351600090613ac1816017850160208901613402565b61088b60f21b60179184019182018190527f226465736372697074696f6e223a202258454e46543a2058454e2043727970746019830152721bc8135a5b9d1a5b99c8151bdc9c995b9d088b606a1b6039830152691134b6b0b3b2911d101160b11b604c8301527919185d184e9a5b5859d94bdcdd99cade1b5b0ed8985cd94d8d0b60321b60568301528551613b5d816070850160208a01613402565b60709201918201526d01130ba3a3934b13aba32b9911d160951b6072820152613b99613b8c60808301866137a9565b607d60f81b815260010190565b9695505050505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c000000815260008251613bdb81601d850160208701613402565b91909101601d0192915050565b6001600160601b031993841681529190921660148201526001600160881b0319909116602882015260370190565b808201808211156107815761078161381b565b600060018201613c3b57613c3b61381b565b5060010190565b6020808252602e908201527f4552433732313a2063616c6c6572206973206e6f7420746f6b656e206f776e6560408201526d1c881b9bdc88185c1c1c9bdd995960921b606082015260800190565b6020808252601a908201527916115391950e881d5b99195c881c995c481593554818dbdd5b9d60321b604082015260600190565b634e487b7160e01b600052603160045260246000fd5b600082613ce957613ce9613848565b500690565b600081613cfd57613cfd61381b565b506000190190565b60008060008060008060c08789031215613d1e57600080fd5b8651613d2981613479565b6020880151604089015160608a015160808b015160a0909b0151939c929b509099909850965090945092505050565b60208082526032908201527f4552433732313a207472616e7366657220746f206e6f6e20455243373231526560408201527131b2b4bb32b91034b6b83632b6b2b73a32b960711b606082015260800190565b6001600160a01b0385811682528416602082015260408101839052608060608201819052600090613b9990830184613426565b600060208284031215613def57600080fd5b815161315a816133cf56fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef404d724a61636b4c6576696e20406c62656c79616576206661697263727970746f2e6f7267a2646970667358221220900a6e3ce3545819bd9f522b427e40c33ce4b2890964e701e3a093f650d07a6464736f6c63430008110033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb800000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000000f8b9f000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003903b9cfa1680ed9663ecec7d3412305bebe326f00000000000000000000000000000000000000000000000000000000000000070000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000cecb8f27f4200f3a0000000000000000000000000000000000000000000000019d971e4fe8401e740000000000000000000000000000000000000000000000033b2e3c9fd0803ce800000000000000000000000000000000000000000000000813f3978f8940984400000000000000000000000000000000000000000000001027e72f1f128130880000000000000000000000000000000000000000000000204fce5e3e25026110000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000017700000000000000000000000000000000000000000000000000000000000000bb800000000000000000000000000000000000000000000000000000000000003e80000000000000000000000000000000000000000000000000000000000000064
-----Decoded View---------------
Arg [0] : xenCrypto_ (address): 0x06450dEe7FD2Fb8E39061434BAbCFC05599a6Fb8
Arg [1] : burnRates_ (uint256[]): 0,250000000000000000000000000,500000000000000000000000000,1000000000000000000000000000,2500000000000000000000000000,5000000000000000000000000000,10000000000000000000000000000
Arg [2] : tokenLimits_ (uint256[]): 0,0,10000,6000,3000,1000,100
Arg [3] : startBlockNumber_ (uint256): 16300528
Arg [4] : forwarder_ (address): 0x0000000000000000000000000000000000000000
Arg [5] : royaltyReceiver_ (address): 0x3903b9Cfa1680ed9663eCec7d3412305bEBE326f
-----Encoded View---------------
22 Constructor Arguments found :
Arg [0] : 00000000000000000000000006450dee7fd2fb8e39061434babcfc05599a6fb8
Arg [1] : 00000000000000000000000000000000000000000000000000000000000000c0
Arg [2] : 00000000000000000000000000000000000000000000000000000000000001c0
Arg [3] : 0000000000000000000000000000000000000000000000000000000000f8b9f0
Arg [4] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [5] : 0000000000000000000000003903b9cfa1680ed9663ecec7d3412305bebe326f
Arg [6] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [7] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [8] : 000000000000000000000000000000000000000000cecb8f27f4200f3a000000
Arg [9] : 0000000000000000000000000000000000000000019d971e4fe8401e74000000
Arg [10] : 0000000000000000000000000000000000000000033b2e3c9fd0803ce8000000
Arg [11] : 00000000000000000000000000000000000000000813f3978f89409844000000
Arg [12] : 00000000000000000000000000000000000000001027e72f1f12813088000000
Arg [13] : 0000000000000000000000000000000000000000204fce5e3e25026110000000
Arg [14] : 0000000000000000000000000000000000000000000000000000000000000007
Arg [15] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [16] : 0000000000000000000000000000000000000000000000000000000000000000
Arg [17] : 0000000000000000000000000000000000000000000000000000000000002710
Arg [18] : 0000000000000000000000000000000000000000000000000000000000001770
Arg [19] : 0000000000000000000000000000000000000000000000000000000000000bb8
Arg [20] : 00000000000000000000000000000000000000000000000000000000000003e8
Arg [21] : 0000000000000000000000000000000000000000000000000000000000000064
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.