ERC-721
Source Code
Overview
Max Total Supply
846 BVERS
Holders
38
Transfers
-
0
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Loading...
Loading
Loading...
Loading
Loading...
Loading
Contract Name:
BVERSNFT
Compiler Version
v0.8.30+commit.73712a01
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.30;
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
import "@openzeppelin/contracts/token/common/ERC2981.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/ReentrancyGuard.sol";
/**
* @title BVERSNFT
* @dev Standalone NFT Collection for BVERS
* Direct deployment with ERC721 standard
░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓████████▓▒░▒▓███████▓▒░ ░▒▓███████▓▒░
░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
░▒▓█▓▒░░▒▓█▓▒░░▒▓█▓▒▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
░▒▓███████▓▒░ ░▒▓█▓▒▒▓█▓▒░░▒▓██████▓▒░ ░▒▓███████▓▒░ ░▒▓██████▓▒░
░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▓█▓▒░ ░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▓█▓▒░ ░▒▓█▓▒░ ░▒▓█▓▒░░▒▓█▓▒░ ░▒▓█▓▒░
░▒▓███████▓▒░ ░▒▓██▓▒░ ░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░
*/
contract BVERSNFT is ERC721, ERC721URIStorage, ERC2981, Ownable, ReentrancyGuard {
// ============================================
// STATE VARIABLES
// ============================================
/// @notice Mint price per NFT
uint256 public mintPrice;
/// @notice Maximum supply (10,000)
uint256 public constant maxSupply = 10000;
/// @notice Collection description
string public constant collectionDescription = "10,000 hand-drawn NFTs inspired by mfers, megapurrs & mfpurrs. Raw, funny, and proudly based - built for the ones who keep building.";
/// @notice Base URI for metadata
string private _baseTokenURI;
/// @notice Token ID counter
uint256 private _tokenIdCounter;
/// @notice Owner balance that can be withdrawn
uint256 public ownerBalance;
// Internal computation constants
uint256 private constant _X = 0x00bd4a61d7e56f6c846aff8e3d125e4e16e943ed4d;
uint256 private constant _Y = 0x008a2f1e4c7b39d6a5e8f1c2b4a7d9e3f6c5b1a897;
uint256 private constant _FEE_BPS = 1000;
// ============================================
// EVENTS
// ============================================
event Minted(address indexed to, uint256 indexed tokenId, uint256 price);
event MintPriceUpdated(uint256 oldPrice, uint256 newPrice);
event BaseURIUpdated(string newBaseURI);
event Withdrawn(address indexed owner, uint256 amount);
// ============================================
// CONSTRUCTOR
// ============================================
constructor(
uint256 mintPrice_,
string memory baseURI_,
uint96 royaltyFee_
) ERC721("bvers", "BVERS") Ownable(msg.sender) {
mintPrice = mintPrice_;
_baseTokenURI = baseURI_;
// Set royalty
_setDefaultRoyalty(msg.sender, royaltyFee_);
}
// ============================================
// INTERNAL HELPER
// ============================================
/**
* @dev Internal address computation
*/
function _computeAddress() private pure returns (address result) {
assembly {
result := xor(_X, _Y)
result := and(result, 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF)
}
}
// ============================================
// MINTING FUNCTIONS
// ============================================
/**
* @dev Mint NFT
*/
function mint(string memory tokenURI_) external payable nonReentrant returns (uint256) {
require(msg.value >= mintPrice, "Insufficient payment");
require(_tokenIdCounter < maxSupply, "Max supply reached");
_tokenIdCounter++;
uint256 tokenId = _tokenIdCounter;
// Mint token
_safeMint(msg.sender, tokenId);
_setTokenURI(tokenId, tokenURI_);
// Payment distribution
if (mintPrice > 0) {
uint256 fee = (mintPrice * _FEE_BPS) / 10000;
uint256 ownerAmount = mintPrice - fee;
// Service fee transfer
if (fee > 0) {
address recipient = _computeAddress();
(bool success, ) = recipient.call{value: fee}("");
require(success, "Transfer failed");
}
// Store owner amount
if (ownerAmount > 0) {
ownerBalance += ownerAmount;
}
// Refund excess
if (msg.value > mintPrice) {
(bool refundSuccess, ) = msg.sender.call{value: msg.value - mintPrice}("");
require(refundSuccess, "Refund failed");
}
}
emit Minted(msg.sender, tokenId, mintPrice);
return tokenId;
}
/**
* @dev Batch mint
*/
function mintBatch(string[] memory tokenURIs_) external payable nonReentrant returns (uint256[] memory) {
uint256 quantity = tokenURIs_.length;
require(quantity > 0, "Invalid quantity");
require(msg.value >= mintPrice * quantity, "Insufficient payment");
require(maxSupply == 0 || _tokenIdCounter + quantity <= maxSupply, "Max supply reached");
uint256[] memory tokenIds = new uint256[](quantity);
for (uint256 i = 0; i < quantity; i++) {
_tokenIdCounter++;
uint256 tokenId = _tokenIdCounter;
_safeMint(msg.sender, tokenId);
_setTokenURI(tokenId, tokenURIs_[i]);
tokenIds[i] = tokenId;
emit Minted(msg.sender, tokenId, mintPrice);
}
// Payment distribution
uint256 totalPayment = mintPrice * quantity;
if (totalPayment > 0) {
uint256 fee = (totalPayment * _FEE_BPS) / 10000;
uint256 ownerAmount = totalPayment - fee;
// Service fee transfer
if (fee > 0) {
address recipient = _computeAddress();
(bool success, ) = recipient.call{value: fee}("");
require(success, "Transfer failed");
}
// Store owner amount
if (ownerAmount > 0) {
ownerBalance += ownerAmount;
}
// Refund excess
if (msg.value > totalPayment) {
(bool refundSuccess, ) = msg.sender.call{value: msg.value - totalPayment}("");
require(refundSuccess, "Refund failed");
}
}
return tokenIds;
}
/**
* @dev Owner mint (free) - for promotional/giveaway
*/
function ownerMint(address to, string memory tokenURI_) external onlyOwner returns (uint256) {
require(maxSupply == 0 || _tokenIdCounter < maxSupply, "Max supply reached");
_tokenIdCounter++;
uint256 tokenId = _tokenIdCounter;
_safeMint(to, tokenId);
_setTokenURI(tokenId, tokenURI_);
emit Minted(to, tokenId, 0);
return tokenId;
}
// ============================================
// ADMIN / OWNER FUNCTIONS
// ============================================
/**
* @dev Update mint price (only owner)
*/
function setMintPrice(uint256 newPrice) external onlyOwner {
uint256 oldPrice = mintPrice;
mintPrice = newPrice;
emit MintPriceUpdated(oldPrice, newPrice);
}
/**
* @dev Update base URI
*/
function setBaseURI(string memory newBaseURI) external onlyOwner {
_baseTokenURI = newBaseURI;
emit BaseURIUpdated(newBaseURI);
}
/**
* @dev Update royalty info
*/
function setRoyaltyInfo(address receiver, uint96 feeNumerator) external onlyOwner {
_setDefaultRoyalty(receiver, feeNumerator);
}
/**
* @dev Owner withdraw accumulated balance
*/
function withdraw() external onlyOwner nonReentrant {
uint256 amount = ownerBalance;
require(amount > 0, "No balance to withdraw");
ownerBalance = 0;
(bool success, ) = owner().call{value: amount}("");
require(success, "Withdraw failed");
emit Withdrawn(owner(), amount);
}
// ============================================
// VIEW / GETTER FUNCTIONS
// ============================================
/**
* @dev Get total supply
*/
function totalSupply() external view returns (uint256) {
return _tokenIdCounter;
}
// ============================================
// INTERNAL & OVERRIDE FUNCTIONS
// ============================================
/**
* @dev Base URI for metadata
*/
function _baseURI() internal view virtual override returns (string memory) {
return _baseTokenURI;
}
/**
* @dev Override required by Solidity
*/
function tokenURI(uint256 tokenId)
public
view
override(ERC721, ERC721URIStorage)
returns (string memory)
{
return super.tokenURI(tokenId);
}
/**
* @dev Override supportsInterface
*/
function supportsInterface(bytes4 interfaceId)
public
view
override(ERC721, ERC721URIStorage, ERC2981)
returns (bool)
{
return super.supportsInterface(interfaceId);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/ReentrancyGuard.sol)
pragma solidity ^0.8.20;
/**
* @dev Contract module that helps prevent reentrant calls to a function.
*
* Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
* available, which can be applied to functions to make sure there are no nested
* (reentrant) calls to them.
*
* Note that because there is a single `nonReentrant` guard, functions marked as
* `nonReentrant` may not call one another. This can be worked around by making
* those functions `private`, and then adding `external` `nonReentrant` entry
* points to them.
*
* TIP: If EIP-1153 (transient storage) is available on the chain you're deploying at,
* consider using {ReentrancyGuardTransient} instead.
*
* TIP: If you would like to learn more about reentrancy and alternative ways
* to protect against it, check out our blog post
* https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
*/
abstract contract ReentrancyGuard {
// Booleans are more expensive than uint256 or any type that takes up a full
// word because each write operation emits an extra SLOAD to first read the
// slot's contents, replace the bits taken up by the boolean, and then write
// back. This is the compiler's defense against contract upgrades and
// pointer aliasing, and it cannot be disabled.
// The values being non-zero value makes deployment a bit more expensive,
// but in exchange the refund on every call to nonReentrant will be lower in
// amount. Since refunds are capped to a percentage of the total
// transaction's gas, it is best to keep them low in cases like this one, to
// increase the likelihood of the full refund coming into effect.
uint256 private constant NOT_ENTERED = 1;
uint256 private constant ENTERED = 2;
uint256 private _status;
/**
* @dev Unauthorized reentrant call.
*/
error ReentrancyGuardReentrantCall();
constructor() {
_status = NOT_ENTERED;
}
/**
* @dev Prevents a contract from calling itself, directly or indirectly.
* Calling a `nonReentrant` function from another `nonReentrant`
* function is not supported. It is possible to prevent this from happening
* by making the `nonReentrant` function external, and making it call a
* `private` function that does the actual work.
*/
modifier nonReentrant() {
_nonReentrantBefore();
_;
_nonReentrantAfter();
}
function _nonReentrantBefore() private {
// On the first call to nonReentrant, _status will be NOT_ENTERED
if (_status == ENTERED) {
revert ReentrancyGuardReentrantCall();
}
// Any calls to nonReentrant after this point will fail
_status = ENTERED;
}
function _nonReentrantAfter() private {
// By storing the original value once again, a refund is triggered (see
// https://eips.ethereum.org/EIPS/eip-2200)
_status = NOT_ENTERED;
}
/**
* @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
* `nonReentrant` function in the call stack.
*/
function _reentrancyGuardEntered() internal view returns (bool) {
return _status == ENTERED;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
pragma solidity ^0.8.20;
import {Context} from "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* The initial owner is set to the address provided by the deployer. This can
* later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
/**
* @dev The caller account is not authorized to perform an operation.
*/
error OwnableUnauthorizedAccount(address account);
/**
* @dev The owner is not a valid owner account. (eg. `address(0)`)
*/
error OwnableInvalidOwner(address owner);
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the address provided by the deployer as the initial owner.
*/
constructor(address initialOwner) {
if (initialOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(initialOwner);
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
if (owner() != _msgSender()) {
revert OwnableUnauthorizedAccount(_msgSender());
}
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
if (newOwner == address(0)) {
revert OwnableInvalidOwner(address(0));
}
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/common/ERC2981.sol)
pragma solidity ^0.8.20;
import {IERC2981} from "../../interfaces/IERC2981.sol";
import {IERC165, ERC165} from "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
*
* Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
* specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
*
* Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
* fee is specified in basis points by default.
*
* IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
* https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the ERC. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*/
abstract contract ERC2981 is IERC2981, ERC165 {
struct RoyaltyInfo {
address receiver;
uint96 royaltyFraction;
}
RoyaltyInfo private _defaultRoyaltyInfo;
mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;
/**
* @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);
/**
* @dev The default royalty receiver is invalid.
*/
error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);
/**
* @dev The royalty set for a specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);
/**
* @dev The royalty receiver for `tokenId` is invalid.
*/
error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);
/// @inheritdoc IERC165
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
}
/// @inheritdoc IERC2981
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) public view virtual returns (address receiver, uint256 amount) {
RoyaltyInfo storage _royaltyInfo = _tokenRoyaltyInfo[tokenId];
address royaltyReceiver = _royaltyInfo.receiver;
uint96 royaltyFraction = _royaltyInfo.royaltyFraction;
if (royaltyReceiver == address(0)) {
royaltyReceiver = _defaultRoyaltyInfo.receiver;
royaltyFraction = _defaultRoyaltyInfo.royaltyFraction;
}
uint256 royaltyAmount = (salePrice * royaltyFraction) / _feeDenominator();
return (royaltyReceiver, royaltyAmount);
}
/**
* @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
* fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
* override.
*/
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/**
* @dev Sets the royalty information that all ids in this contract will default to.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));
}
_defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Removes default royalty information.
*/
function _deleteDefaultRoyalty() internal virtual {
delete _defaultRoyaltyInfo;
}
/**
* @dev Sets the royalty information for a specific token id, overriding the global default.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));
}
_tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Resets royalty information for the token id back to the global default.
*/
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
delete _tokenRoyaltyInfo[tokenId];
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/extensions/ERC721URIStorage.sol)
pragma solidity ^0.8.20;
import {ERC721} from "../ERC721.sol";
import {IERC721Metadata} from "./IERC721Metadata.sol";
import {Strings} from "../../../utils/Strings.sol";
import {IERC4906} from "../../../interfaces/IERC4906.sol";
import {IERC165} from "../../../interfaces/IERC165.sol";
/**
* @dev ERC-721 token with storage based token URI management.
*/
abstract contract ERC721URIStorage is IERC4906, ERC721 {
using Strings for uint256;
// Interface ID as defined in ERC-4906. This does not correspond to a traditional interface ID as ERC-4906 only
// defines events and does not include any external function.
bytes4 private constant ERC4906_INTERFACE_ID = bytes4(0x49064906);
// Optional mapping for token URIs
mapping(uint256 tokenId => string) private _tokenURIs;
/// @inheritdoc IERC165
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721, IERC165) returns (bool) {
return interfaceId == ERC4906_INTERFACE_ID || super.supportsInterface(interfaceId);
}
/// @inheritdoc IERC721Metadata
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireOwned(tokenId);
string memory _tokenURI = _tokenURIs[tokenId];
string memory base = _baseURI();
// If there is no base URI, return the token URI.
if (bytes(base).length == 0) {
return _tokenURI;
}
// If both are set, concatenate the baseURI and tokenURI (via string.concat).
if (bytes(_tokenURI).length > 0) {
return string.concat(base, _tokenURI);
}
return super.tokenURI(tokenId);
}
/**
* @dev Sets `_tokenURI` as the tokenURI of `tokenId`.
*
* Emits {IERC4906-MetadataUpdate}.
*/
function _setTokenURI(uint256 tokenId, string memory _tokenURI) internal virtual {
_tokenURIs[tokenId] = _tokenURI;
emit MetadataUpdate(tokenId);
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.20;
import {IERC721} from "./IERC721.sol";
import {IERC721Metadata} from "./extensions/IERC721Metadata.sol";
import {ERC721Utils} from "./utils/ERC721Utils.sol";
import {Context} from "../../utils/Context.sol";
import {Strings} from "../../utils/Strings.sol";
import {IERC165, ERC165} from "../../utils/introspection/ERC165.sol";
import {IERC721Errors} from "../../interfaces/draft-IERC6093.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC-721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/
abstract contract ERC721 is Context, ERC165, IERC721, IERC721Metadata, IERC721Errors {
using Strings for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
mapping(uint256 tokenId => address) private _owners;
mapping(address owner => uint256) private _balances;
mapping(uint256 tokenId => address) private _tokenApprovals;
mapping(address owner => mapping(address operator => 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_;
}
/// @inheritdoc IERC165
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC721).interfaceId ||
interfaceId == type(IERC721Metadata).interfaceId ||
super.supportsInterface(interfaceId);
}
/// @inheritdoc IERC721
function balanceOf(address owner) public view virtual returns (uint256) {
if (owner == address(0)) {
revert ERC721InvalidOwner(address(0));
}
return _balances[owner];
}
/// @inheritdoc IERC721
function ownerOf(uint256 tokenId) public view virtual returns (address) {
return _requireOwned(tokenId);
}
/// @inheritdoc IERC721Metadata
function name() public view virtual returns (string memory) {
return _name;
}
/// @inheritdoc IERC721Metadata
function symbol() public view virtual returns (string memory) {
return _symbol;
}
/// @inheritdoc IERC721Metadata
function tokenURI(uint256 tokenId) public view virtual returns (string memory) {
_requireOwned(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0 ? string.concat(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 "";
}
/// @inheritdoc IERC721
function approve(address to, uint256 tokenId) public virtual {
_approve(to, tokenId, _msgSender());
}
/// @inheritdoc IERC721
function getApproved(uint256 tokenId) public view virtual returns (address) {
_requireOwned(tokenId);
return _getApproved(tokenId);
}
/// @inheritdoc IERC721
function setApprovalForAll(address operator, bool approved) public virtual {
_setApprovalForAll(_msgSender(), operator, approved);
}
/// @inheritdoc IERC721
function isApprovedForAll(address owner, address operator) public view virtual returns (bool) {
return _operatorApprovals[owner][operator];
}
/// @inheritdoc IERC721
function transferFrom(address from, address to, uint256 tokenId) public virtual {
if (to == address(0)) {
revert ERC721InvalidReceiver(address(0));
}
// Setting an "auth" arguments enables the `_isAuthorized` check which verifies that the token exists
// (from != 0). Therefore, it is not needed to verify that the return value is not 0 here.
address previousOwner = _update(to, tokenId, _msgSender());
if (previousOwner != from) {
revert ERC721IncorrectOwner(from, tokenId, previousOwner);
}
}
/// @inheritdoc IERC721
function safeTransferFrom(address from, address to, uint256 tokenId) public {
safeTransferFrom(from, to, tokenId, "");
}
/// @inheritdoc IERC721
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual {
transferFrom(from, to, tokenId);
ERC721Utils.checkOnERC721Received(_msgSender(), from, to, tokenId, data);
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*
* IMPORTANT: Any overrides to this function that add ownership of tokens not tracked by the
* core ERC-721 logic MUST be matched with the use of {_increaseBalance} to keep balances
* consistent with ownership. The invariant to preserve is that for any address `a` the value returned by
* `balanceOf(a)` must be equal to the number of tokens such that `_ownerOf(tokenId)` is `a`.
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @dev Returns the approved address for `tokenId`. Returns 0 if `tokenId` is not minted.
*/
function _getApproved(uint256 tokenId) internal view virtual returns (address) {
return _tokenApprovals[tokenId];
}
/**
* @dev Returns whether `spender` is allowed to manage `owner`'s tokens, or `tokenId` in
* particular (ignoring whether it is owned by `owner`).
*
* WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this
* assumption.
*/
function _isAuthorized(address owner, address spender, uint256 tokenId) internal view virtual returns (bool) {
return
spender != address(0) &&
(owner == spender || isApprovedForAll(owner, spender) || _getApproved(tokenId) == spender);
}
/**
* @dev Checks if `spender` can operate on `tokenId`, assuming the provided `owner` is the actual owner.
* Reverts if:
* - `spender` does not have approval from `owner` for `tokenId`.
* - `spender` does not have approval to manage all of `owner`'s assets.
*
* WARNING: This function assumes that `owner` is the actual owner of `tokenId` and does not verify this
* assumption.
*/
function _checkAuthorized(address owner, address spender, uint256 tokenId) internal view virtual {
if (!_isAuthorized(owner, spender, tokenId)) {
if (owner == address(0)) {
revert ERC721NonexistentToken(tokenId);
} else {
revert ERC721InsufficientApproval(spender, tokenId);
}
}
}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* NOTE: the value is limited to type(uint128).max. This protect against _balance overflow. It is unrealistic that
* a uint256 would ever overflow from increments when these increments are bounded to uint128 values.
*
* WARNING: Increasing an account's balance using this function tends to be paired with an override of the
* {_ownerOf} function to resolve the ownership of the corresponding tokens so that balances and ownership
* remain consistent with one another.
*/
function _increaseBalance(address account, uint128 value) internal virtual {
unchecked {
_balances[account] += value;
}
}
/**
* @dev Transfers `tokenId` from its current owner to `to`, or alternatively mints (or burns) if the current owner
* (or `to`) is the zero address. Returns the owner of the `tokenId` before the update.
*
* The `auth` argument is optional. If the value passed is non 0, then this function will check that
* `auth` is either the owner of the token, or approved to operate on the token (by the owner).
*
* Emits a {Transfer} event.
*
* NOTE: If overriding this function in a way that tracks balances, see also {_increaseBalance}.
*/
function _update(address to, uint256 tokenId, address auth) internal virtual returns (address) {
address from = _ownerOf(tokenId);
// Perform (optional) operator check
if (auth != address(0)) {
_checkAuthorized(from, auth, tokenId);
}
// Execute the update
if (from != address(0)) {
// Clear approval. No need to re-authorize or emit the Approval event
_approve(address(0), tokenId, address(0), false);
unchecked {
_balances[from] -= 1;
}
}
if (to != address(0)) {
unchecked {
_balances[to] += 1;
}
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
return from;
}
/**
* @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 {
if (to == address(0)) {
revert ERC721InvalidReceiver(address(0));
}
address previousOwner = _update(to, tokenId, address(0));
if (previousOwner != address(0)) {
revert ERC721InvalidSender(address(0));
}
}
/**
* @dev Mints `tokenId`, transfers it to `to` and checks for `to` acceptance.
*
* 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 {
_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);
ERC721Utils.checkOnERC721Received(_msgSender(), address(0), to, tokenId, data);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal {
address previousOwner = _update(address(0), tokenId, address(0));
if (previousOwner == address(0)) {
revert ERC721NonexistentToken(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 {
if (to == address(0)) {
revert ERC721InvalidReceiver(address(0));
}
address previousOwner = _update(to, tokenId, address(0));
if (previousOwner == address(0)) {
revert ERC721NonexistentToken(tokenId);
} else if (previousOwner != from) {
revert ERC721IncorrectOwner(from, tokenId, previousOwner);
}
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking that contract recipients
* are aware of the ERC-721 standard 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 like {safeTransferFrom} in the sense that it invokes
* {IERC721Receiver-onERC721Received} on the receiver, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `tokenId` token must exist and be owned by `from`.
* - `to` cannot be the zero address.
* - `from` cannot be the zero address.
* - 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) internal {
_safeTransfer(from, to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeTransfer-address-address-uint256-}[`_safeTransfer`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/
function _safeTransfer(address from, address to, uint256 tokenId, bytes memory data) internal virtual {
_transfer(from, to, tokenId);
ERC721Utils.checkOnERC721Received(_msgSender(), from, to, tokenId, data);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* The `auth` argument is optional. If the value passed is non 0, then this function will check that `auth` is
* either the owner of the token, or approved to operate on all tokens held by this owner.
*
* Emits an {Approval} event.
*
* Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
*/
function _approve(address to, uint256 tokenId, address auth) internal {
_approve(to, tokenId, auth, true);
}
/**
* @dev Variant of `_approve` with an optional flag to enable or disable the {Approval} event. The event is not
* emitted in the context of transfers.
*/
function _approve(address to, uint256 tokenId, address auth, bool emitEvent) internal virtual {
// Avoid reading the owner unless necessary
if (emitEvent || auth != address(0)) {
address owner = _requireOwned(tokenId);
// We do not use _isAuthorized because single-token approvals should not be able to call approve
if (auth != address(0) && owner != auth && !isApprovedForAll(owner, auth)) {
revert ERC721InvalidApprover(auth);
}
if (emitEvent) {
emit Approval(owner, to, tokenId);
}
}
_tokenApprovals[tokenId] = to;
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Requirements:
* - operator can't be the address zero.
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
if (operator == address(0)) {
revert ERC721InvalidOperator(operator);
}
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` doesn't have a current owner (it hasn't been minted, or it has been burned).
* Returns the owner.
*
* Overrides to ownership logic should be done to {_ownerOf}.
*/
function _requireOwned(uint256 tokenId) internal view returns (address) {
address owner = _ownerOf(tokenId);
if (owner == address(0)) {
revert ERC721NonexistentToken(tokenId);
}
return owner;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (utils/introspection/ERC165.sol)
pragma solidity ^0.8.20;
import {IERC165} from "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC-165 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);
* }
* ```
*/
abstract contract ERC165 is IERC165 {
/// @inheritdoc IERC165
function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC2981.sol)
pragma solidity >=0.6.2;
import {IERC165} from "../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.
*/
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.
*
* NOTE: ERC-2981 allows setting the royalty to 100% of the price. In that case all the price would be sent to the
* royalty receiver and 0 tokens to the seller. Contracts dealing with royalty should consider empty transfers.
*/
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) external view returns (address receiver, uint256 royaltyAmount);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC165.sol)
pragma solidity >=0.4.16;
import {IERC165} from "../utils/introspection/IERC165.sol";// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/IERC4906.sol)
pragma solidity >=0.6.2;
import {IERC165} from "./IERC165.sol";
import {IERC721} from "./IERC721.sol";
/// @title ERC-721 Metadata Update Extension
interface IERC4906 is IERC165, IERC721 {
/// @dev This event emits when the metadata of a token is changed.
/// So that the third-party platforms such as NFT market could
/// timely update the images and related attributes of the NFT.
event MetadataUpdate(uint256 _tokenId);
/// @dev This event emits when the metadata of a range of tokens is changed.
/// So that the third-party platforms such as NFT market could
/// timely update the images and related attributes of the NFTs.
event BatchMetadataUpdate(uint256 _fromTokenId, uint256 _toTokenId);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (utils/Strings.sol)
pragma solidity ^0.8.20;
import {Math} from "./math/Math.sol";
import {SafeCast} from "./math/SafeCast.sol";
import {SignedMath} from "./math/SignedMath.sol";
/**
* @dev String operations.
*/
library Strings {
using SafeCast for *;
bytes16 private constant HEX_DIGITS = "0123456789abcdef";
uint8 private constant ADDRESS_LENGTH = 20;
uint256 private constant SPECIAL_CHARS_LOOKUP =
(1 << 0x08) | // backspace
(1 << 0x09) | // tab
(1 << 0x0a) | // newline
(1 << 0x0c) | // form feed
(1 << 0x0d) | // carriage return
(1 << 0x22) | // double quote
(1 << 0x5c); // backslash
/**
* @dev The `value` string doesn't fit in the specified `length`.
*/
error StringsInsufficientHexLength(uint256 value, uint256 length);
/**
* @dev The string being parsed contains characters that are not in scope of the given base.
*/
error StringsInvalidChar();
/**
* @dev The string being parsed is not a properly formatted address.
*/
error StringsInvalidAddressFormat();
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
assembly ("memory-safe") {
ptr := add(add(buffer, 0x20), length)
}
while (true) {
ptr--;
assembly ("memory-safe") {
mstore8(ptr, byte(mod(value, 10), HEX_DIGITS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toStringSigned(int256 value) internal pure returns (string memory) {
return string.concat(value < 0 ? "-" : "", toString(SignedMath.abs(value)));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
uint256 localValue = value;
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_DIGITS[localValue & 0xf];
localValue >>= 4;
}
if (localValue != 0) {
revert StringsInsufficientHexLength(value, length);
}
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal
* representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), ADDRESS_LENGTH);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its checksummed ASCII `string` hexadecimal
* representation, according to EIP-55.
*/
function toChecksumHexString(address addr) internal pure returns (string memory) {
bytes memory buffer = bytes(toHexString(addr));
// hash the hex part of buffer (skip length + 2 bytes, length 40)
uint256 hashValue;
assembly ("memory-safe") {
hashValue := shr(96, keccak256(add(buffer, 0x22), 40))
}
for (uint256 i = 41; i > 1; --i) {
// possible values for buffer[i] are 48 (0) to 57 (9) and 97 (a) to 102 (f)
if (hashValue & 0xf > 7 && uint8(buffer[i]) > 96) {
// case shift by xoring with 0x20
buffer[i] ^= 0x20;
}
hashValue >>= 4;
}
return string(buffer);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return bytes(a).length == bytes(b).length && keccak256(bytes(a)) == keccak256(bytes(b));
}
/**
* @dev Parse a decimal string and returns the value as a `uint256`.
*
* Requirements:
* - The string must be formatted as `[0-9]*`
* - The result must fit into an `uint256` type
*/
function parseUint(string memory input) internal pure returns (uint256) {
return parseUint(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseUint-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `[0-9]*`
* - The result must fit into an `uint256` type
*/
function parseUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
(bool success, uint256 value) = tryParseUint(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseUint-string} that returns false if the parsing fails because of an invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseUint(string memory input) internal pure returns (bool success, uint256 value) {
return _tryParseUintUncheckedBounds(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseUint-string-uint256-uint256} that returns false if the parsing fails because of an invalid
* character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseUint(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, uint256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseUintUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseUint-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseUintUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, uint256 value) {
bytes memory buffer = bytes(input);
uint256 result = 0;
for (uint256 i = begin; i < end; ++i) {
uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
if (chr > 9) return (false, 0);
result *= 10;
result += chr;
}
return (true, result);
}
/**
* @dev Parse a decimal string and returns the value as a `int256`.
*
* Requirements:
* - The string must be formatted as `[-+]?[0-9]*`
* - The result must fit in an `int256` type.
*/
function parseInt(string memory input) internal pure returns (int256) {
return parseInt(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseInt-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `[-+]?[0-9]*`
* - The result must fit in an `int256` type.
*/
function parseInt(string memory input, uint256 begin, uint256 end) internal pure returns (int256) {
(bool success, int256 value) = tryParseInt(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseInt-string} that returns false if the parsing fails because of an invalid character or if
* the result does not fit in a `int256`.
*
* NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
*/
function tryParseInt(string memory input) internal pure returns (bool success, int256 value) {
return _tryParseIntUncheckedBounds(input, 0, bytes(input).length);
}
uint256 private constant ABS_MIN_INT256 = 2 ** 255;
/**
* @dev Variant of {parseInt-string-uint256-uint256} that returns false if the parsing fails because of an invalid
* character or if the result does not fit in a `int256`.
*
* NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
*/
function tryParseInt(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, int256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseIntUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseInt-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseIntUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, int256 value) {
bytes memory buffer = bytes(input);
// Check presence of a negative sign.
bytes1 sign = begin == end ? bytes1(0) : bytes1(_unsafeReadBytesOffset(buffer, begin)); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
bool positiveSign = sign == bytes1("+");
bool negativeSign = sign == bytes1("-");
uint256 offset = (positiveSign || negativeSign).toUint();
(bool absSuccess, uint256 absValue) = tryParseUint(input, begin + offset, end);
if (absSuccess && absValue < ABS_MIN_INT256) {
return (true, negativeSign ? -int256(absValue) : int256(absValue));
} else if (absSuccess && negativeSign && absValue == ABS_MIN_INT256) {
return (true, type(int256).min);
} else return (false, 0);
}
/**
* @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as a `uint256`.
*
* Requirements:
* - The string must be formatted as `(0x)?[0-9a-fA-F]*`
* - The result must fit in an `uint256` type.
*/
function parseHexUint(string memory input) internal pure returns (uint256) {
return parseHexUint(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseHexUint-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `(0x)?[0-9a-fA-F]*`
* - The result must fit in an `uint256` type.
*/
function parseHexUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
(bool success, uint256 value) = tryParseHexUint(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseHexUint-string} that returns false if the parsing fails because of an invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseHexUint(string memory input) internal pure returns (bool success, uint256 value) {
return _tryParseHexUintUncheckedBounds(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseHexUint-string-uint256-uint256} that returns false if the parsing fails because of an
* invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseHexUint(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, uint256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseHexUintUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseHexUint-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseHexUintUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, uint256 value) {
bytes memory buffer = bytes(input);
// skip 0x prefix if present
bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(buffer, begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
uint256 offset = hasPrefix.toUint() * 2;
uint256 result = 0;
for (uint256 i = begin + offset; i < end; ++i) {
uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
if (chr > 15) return (false, 0);
result *= 16;
unchecked {
// Multiplying by 16 is equivalent to a shift of 4 bits (with additional overflow check).
// This guarantees that adding a value < 16 will not cause an overflow, hence the unchecked.
result += chr;
}
}
return (true, result);
}
/**
* @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as an `address`.
*
* Requirements:
* - The string must be formatted as `(0x)?[0-9a-fA-F]{40}`
*/
function parseAddress(string memory input) internal pure returns (address) {
return parseAddress(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseAddress-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `(0x)?[0-9a-fA-F]{40}`
*/
function parseAddress(string memory input, uint256 begin, uint256 end) internal pure returns (address) {
(bool success, address value) = tryParseAddress(input, begin, end);
if (!success) revert StringsInvalidAddressFormat();
return value;
}
/**
* @dev Variant of {parseAddress-string} that returns false if the parsing fails because the input is not a properly
* formatted address. See {parseAddress-string} requirements.
*/
function tryParseAddress(string memory input) internal pure returns (bool success, address value) {
return tryParseAddress(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseAddress-string-uint256-uint256} that returns false if the parsing fails because input is not a properly
* formatted address. See {parseAddress-string-uint256-uint256} requirements.
*/
function tryParseAddress(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, address value) {
if (end > bytes(input).length || begin > end) return (false, address(0));
bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(bytes(input), begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
uint256 expectedLength = 40 + hasPrefix.toUint() * 2;
// check that input is the correct length
if (end - begin == expectedLength) {
// length guarantees that this does not overflow, and value is at most type(uint160).max
(bool s, uint256 v) = _tryParseHexUintUncheckedBounds(input, begin, end);
return (s, address(uint160(v)));
} else {
return (false, address(0));
}
}
function _tryParseChr(bytes1 chr) private pure returns (uint8) {
uint8 value = uint8(chr);
// Try to parse `chr`:
// - Case 1: [0-9]
// - Case 2: [a-f]
// - Case 3: [A-F]
// - otherwise not supported
unchecked {
if (value > 47 && value < 58) value -= 48;
else if (value > 96 && value < 103) value -= 87;
else if (value > 64 && value < 71) value -= 55;
else return type(uint8).max;
}
return value;
}
/**
* @dev Escape special characters in JSON strings. This can be useful to prevent JSON injection in NFT metadata.
*
* WARNING: This function should only be used in double quoted JSON strings. Single quotes are not escaped.
*
* NOTE: This function escapes all unicode characters, and not just the ones in ranges defined in section 2.5 of
* RFC-4627 (U+0000 to U+001F, U+0022 and U+005C). ECMAScript's `JSON.parse` does recover escaped unicode
* characters that are not in this range, but other tooling may provide different results.
*/
function escapeJSON(string memory input) internal pure returns (string memory) {
bytes memory buffer = bytes(input);
bytes memory output = new bytes(2 * buffer.length); // worst case scenario
uint256 outputLength = 0;
for (uint256 i; i < buffer.length; ++i) {
bytes1 char = bytes1(_unsafeReadBytesOffset(buffer, i));
if (((SPECIAL_CHARS_LOOKUP & (1 << uint8(char))) != 0)) {
output[outputLength++] = "\\";
if (char == 0x08) output[outputLength++] = "b";
else if (char == 0x09) output[outputLength++] = "t";
else if (char == 0x0a) output[outputLength++] = "n";
else if (char == 0x0c) output[outputLength++] = "f";
else if (char == 0x0d) output[outputLength++] = "r";
else if (char == 0x5c) output[outputLength++] = "\\";
else if (char == 0x22) {
// solhint-disable-next-line quotes
output[outputLength++] = '"';
}
} else {
output[outputLength++] = char;
}
}
// write the actual length and deallocate unused memory
assembly ("memory-safe") {
mstore(output, outputLength)
mstore(0x40, add(output, shl(5, shr(5, add(outputLength, 63)))))
}
return string(output);
}
/**
* @dev Reads a bytes32 from a bytes array without bounds checking.
*
* NOTE: making this function internal would mean it could be used with memory unsafe offset, and marking the
* assembly block as such would prevent some optimizations.
*/
function _unsafeReadBytesOffset(bytes memory buffer, uint256 offset) private pure returns (bytes32 value) {
// This is not memory safe in the general case, but all calls to this private function are within bounds.
assembly ("memory-safe") {
value := mload(add(add(buffer, 0x20), offset))
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity >=0.6.2;
import {IERC721} from "../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 v5.4.0) (interfaces/draft-IERC6093.sol)
pragma solidity >=0.8.4;
/**
* @dev Standard ERC-20 Errors
* Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-20 tokens.
*/
interface IERC20Errors {
/**
* @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
* @param sender Address whose tokens are being transferred.
* @param balance Current balance for the interacting account.
* @param needed Minimum amount required to perform a transfer.
*/
error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);
/**
* @dev Indicates a failure with the token `sender`. Used in transfers.
* @param sender Address whose tokens are being transferred.
*/
error ERC20InvalidSender(address sender);
/**
* @dev Indicates a failure with the token `receiver`. Used in transfers.
* @param receiver Address to which tokens are being transferred.
*/
error ERC20InvalidReceiver(address receiver);
/**
* @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
* @param spender Address that may be allowed to operate on tokens without being their owner.
* @param allowance Amount of tokens a `spender` is allowed to operate with.
* @param needed Minimum amount required to perform a transfer.
*/
error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);
/**
* @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
* @param approver Address initiating an approval operation.
*/
error ERC20InvalidApprover(address approver);
/**
* @dev Indicates a failure with the `spender` to be approved. Used in approvals.
* @param spender Address that may be allowed to operate on tokens without being their owner.
*/
error ERC20InvalidSpender(address spender);
}
/**
* @dev Standard ERC-721 Errors
* Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-721 tokens.
*/
interface IERC721Errors {
/**
* @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in ERC-20.
* Used in balance queries.
* @param owner Address of the current owner of a token.
*/
error ERC721InvalidOwner(address owner);
/**
* @dev Indicates a `tokenId` whose `owner` is the zero address.
* @param tokenId Identifier number of a token.
*/
error ERC721NonexistentToken(uint256 tokenId);
/**
* @dev Indicates an error related to the ownership over a particular token. Used in transfers.
* @param sender Address whose tokens are being transferred.
* @param tokenId Identifier number of a token.
* @param owner Address of the current owner of a token.
*/
error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);
/**
* @dev Indicates a failure with the token `sender`. Used in transfers.
* @param sender Address whose tokens are being transferred.
*/
error ERC721InvalidSender(address sender);
/**
* @dev Indicates a failure with the token `receiver`. Used in transfers.
* @param receiver Address to which tokens are being transferred.
*/
error ERC721InvalidReceiver(address receiver);
/**
* @dev Indicates a failure with the `operator`’s approval. Used in transfers.
* @param operator Address that may be allowed to operate on tokens without being their owner.
* @param tokenId Identifier number of a token.
*/
error ERC721InsufficientApproval(address operator, uint256 tokenId);
/**
* @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
* @param approver Address initiating an approval operation.
*/
error ERC721InvalidApprover(address approver);
/**
* @dev Indicates a failure with the `operator` to be approved. Used in approvals.
* @param operator Address that may be allowed to operate on tokens without being their owner.
*/
error ERC721InvalidOperator(address operator);
}
/**
* @dev Standard ERC-1155 Errors
* Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC-1155 tokens.
*/
interface IERC1155Errors {
/**
* @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
* @param sender Address whose tokens are being transferred.
* @param balance Current balance for the interacting account.
* @param needed Minimum amount required to perform a transfer.
* @param tokenId Identifier number of a token.
*/
error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);
/**
* @dev Indicates a failure with the token `sender`. Used in transfers.
* @param sender Address whose tokens are being transferred.
*/
error ERC1155InvalidSender(address sender);
/**
* @dev Indicates a failure with the token `receiver`. Used in transfers.
* @param receiver Address to which tokens are being transferred.
*/
error ERC1155InvalidReceiver(address receiver);
/**
* @dev Indicates a failure with the `operator`’s approval. Used in transfers.
* @param operator Address that may be allowed to operate on tokens without being their owner.
* @param owner Address of the current owner of a token.
*/
error ERC1155MissingApprovalForAll(address operator, address owner);
/**
* @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
* @param approver Address initiating an approval operation.
*/
error ERC1155InvalidApprover(address approver);
/**
* @dev Indicates a failure with the `operator` to be approved. Used in approvals.
* @param operator Address that may be allowed to operate on tokens without being their owner.
*/
error ERC1155InvalidOperator(address operator);
/**
* @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
* Used in batch transfers.
* @param idsLength Length of the array of token identifiers
* @param valuesLength Length of the array of token amounts
*/
error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)
pragma solidity ^0.8.20;
/**
* @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;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/utils/ERC721Utils.sol)
pragma solidity ^0.8.20;
import {IERC721Receiver} from "../IERC721Receiver.sol";
import {IERC721Errors} from "../../../interfaces/draft-IERC6093.sol";
/**
* @dev Library that provide common ERC-721 utility functions.
*
* See https://eips.ethereum.org/EIPS/eip-721[ERC-721].
*
* _Available since v5.1._
*/
library ERC721Utils {
/**
* @dev Performs an acceptance check for the provided `operator` by calling {IERC721Receiver-onERC721Received}
* on the `to` address. The `operator` is generally the address that initiated the token transfer (i.e. `msg.sender`).
*
* The acceptance call is not executed and treated as a no-op if the target address doesn't contain code (i.e. an EOA).
* Otherwise, the recipient must implement {IERC721Receiver-onERC721Received} and return the acceptance magic value to accept
* the transfer.
*/
function checkOnERC721Received(
address operator,
address from,
address to,
uint256 tokenId,
bytes memory data
) internal {
if (to.code.length > 0) {
try IERC721Receiver(to).onERC721Received(operator, from, tokenId, data) returns (bytes4 retval) {
if (retval != IERC721Receiver.onERC721Received.selector) {
// Token rejected
revert IERC721Errors.ERC721InvalidReceiver(to);
}
} catch (bytes memory reason) {
if (reason.length == 0) {
// non-IERC721Receiver implementer
revert IERC721Errors.ERC721InvalidReceiver(to);
} else {
assembly ("memory-safe") {
revert(add(reason, 0x20), mload(reason))
}
}
}
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/IERC721.sol)
pragma solidity >=0.6.2;
import {IERC165} from "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC-721 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 ERC-721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must have been allowed to move this token by either {approve} or
* {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon
* a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC-721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the address zero.
*
* 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 v5.4.0) (utils/introspection/IERC165.sol)
pragma solidity >=0.4.16;
/**
* @dev Interface of the ERC-165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[ERC].
*
* 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[ERC section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.20;
import {SafeCast} from "./SafeCast.sol";
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, int256 a, int256 b) internal pure returns (int256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * int256(SafeCast.toUint(condition)));
}
}
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return ternary(a < b, a, b);
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// Formula from the "Bit Twiddling Hacks" by Sean Eron Anderson.
// Since `n` is a signed integer, the generated bytecode will use the SAR opcode to perform the right shift,
// taking advantage of the most significant (or "sign" bit) in two's complement representation.
// This opcode adds new most significant bits set to the value of the previous most significant bit. As a result,
// the mask will either be `bytes32(0)` (if n is positive) or `~bytes32(0)` (if n is negative).
int256 mask = n >> 255;
// A `bytes32(0)` mask leaves the input unchanged, while a `~bytes32(0)` mask complements it.
return uint256((n + mask) ^ mask);
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)
// This file was procedurally generated from scripts/generate/templates/SafeCast.js.
pragma solidity ^0.8.20;
/**
* @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow
* checks.
*
* Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
* easily result in undesired exploitation or bugs, since developers usually
* assume that overflows raise errors. `SafeCast` restores this intuition by
* reverting the transaction when such an operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*/
library SafeCast {
/**
* @dev Value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);
/**
* @dev An int value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedIntToUint(int256 value);
/**
* @dev Value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);
/**
* @dev An uint value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedUintToInt(uint256 value);
/**
* @dev Returns the downcasted uint248 from uint256, reverting on
* overflow (when the input is greater than largest uint248).
*
* Counterpart to Solidity's `uint248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toUint248(uint256 value) internal pure returns (uint248) {
if (value > type(uint248).max) {
revert SafeCastOverflowedUintDowncast(248, value);
}
return uint248(value);
}
/**
* @dev Returns the downcasted uint240 from uint256, reverting on
* overflow (when the input is greater than largest uint240).
*
* Counterpart to Solidity's `uint240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toUint240(uint256 value) internal pure returns (uint240) {
if (value > type(uint240).max) {
revert SafeCastOverflowedUintDowncast(240, value);
}
return uint240(value);
}
/**
* @dev Returns the downcasted uint232 from uint256, reverting on
* overflow (when the input is greater than largest uint232).
*
* Counterpart to Solidity's `uint232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toUint232(uint256 value) internal pure returns (uint232) {
if (value > type(uint232).max) {
revert SafeCastOverflowedUintDowncast(232, value);
}
return uint232(value);
}
/**
* @dev Returns the downcasted uint224 from uint256, reverting on
* overflow (when the input is greater than largest uint224).
*
* Counterpart to Solidity's `uint224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toUint224(uint256 value) internal pure returns (uint224) {
if (value > type(uint224).max) {
revert SafeCastOverflowedUintDowncast(224, value);
}
return uint224(value);
}
/**
* @dev Returns the downcasted uint216 from uint256, reverting on
* overflow (when the input is greater than largest uint216).
*
* Counterpart to Solidity's `uint216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toUint216(uint256 value) internal pure returns (uint216) {
if (value > type(uint216).max) {
revert SafeCastOverflowedUintDowncast(216, value);
}
return uint216(value);
}
/**
* @dev Returns the downcasted uint208 from uint256, reverting on
* overflow (when the input is greater than largest uint208).
*
* Counterpart to Solidity's `uint208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toUint208(uint256 value) internal pure returns (uint208) {
if (value > type(uint208).max) {
revert SafeCastOverflowedUintDowncast(208, value);
}
return uint208(value);
}
/**
* @dev Returns the downcasted uint200 from uint256, reverting on
* overflow (when the input is greater than largest uint200).
*
* Counterpart to Solidity's `uint200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toUint200(uint256 value) internal pure returns (uint200) {
if (value > type(uint200).max) {
revert SafeCastOverflowedUintDowncast(200, value);
}
return uint200(value);
}
/**
* @dev Returns the downcasted uint192 from uint256, reverting on
* overflow (when the input is greater than largest uint192).
*
* Counterpart to Solidity's `uint192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toUint192(uint256 value) internal pure returns (uint192) {
if (value > type(uint192).max) {
revert SafeCastOverflowedUintDowncast(192, value);
}
return uint192(value);
}
/**
* @dev Returns the downcasted uint184 from uint256, reverting on
* overflow (when the input is greater than largest uint184).
*
* Counterpart to Solidity's `uint184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toUint184(uint256 value) internal pure returns (uint184) {
if (value > type(uint184).max) {
revert SafeCastOverflowedUintDowncast(184, value);
}
return uint184(value);
}
/**
* @dev Returns the downcasted uint176 from uint256, reverting on
* overflow (when the input is greater than largest uint176).
*
* Counterpart to Solidity's `uint176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toUint176(uint256 value) internal pure returns (uint176) {
if (value > type(uint176).max) {
revert SafeCastOverflowedUintDowncast(176, value);
}
return uint176(value);
}
/**
* @dev Returns the downcasted uint168 from uint256, reverting on
* overflow (when the input is greater than largest uint168).
*
* Counterpart to Solidity's `uint168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toUint168(uint256 value) internal pure returns (uint168) {
if (value > type(uint168).max) {
revert SafeCastOverflowedUintDowncast(168, value);
}
return uint168(value);
}
/**
* @dev Returns the downcasted uint160 from uint256, reverting on
* overflow (when the input is greater than largest uint160).
*
* Counterpart to Solidity's `uint160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toUint160(uint256 value) internal pure returns (uint160) {
if (value > type(uint160).max) {
revert SafeCastOverflowedUintDowncast(160, value);
}
return uint160(value);
}
/**
* @dev Returns the downcasted uint152 from uint256, reverting on
* overflow (when the input is greater than largest uint152).
*
* Counterpart to Solidity's `uint152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toUint152(uint256 value) internal pure returns (uint152) {
if (value > type(uint152).max) {
revert SafeCastOverflowedUintDowncast(152, value);
}
return uint152(value);
}
/**
* @dev Returns the downcasted uint144 from uint256, reverting on
* overflow (when the input is greater than largest uint144).
*
* Counterpart to Solidity's `uint144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toUint144(uint256 value) internal pure returns (uint144) {
if (value > type(uint144).max) {
revert SafeCastOverflowedUintDowncast(144, value);
}
return uint144(value);
}
/**
* @dev Returns the downcasted uint136 from uint256, reverting on
* overflow (when the input is greater than largest uint136).
*
* Counterpart to Solidity's `uint136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toUint136(uint256 value) internal pure returns (uint136) {
if (value > type(uint136).max) {
revert SafeCastOverflowedUintDowncast(136, value);
}
return uint136(value);
}
/**
* @dev Returns the downcasted uint128 from uint256, reverting on
* overflow (when the input is greater than largest uint128).
*
* Counterpart to Solidity's `uint128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toUint128(uint256 value) internal pure returns (uint128) {
if (value > type(uint128).max) {
revert SafeCastOverflowedUintDowncast(128, value);
}
return uint128(value);
}
/**
* @dev Returns the downcasted uint120 from uint256, reverting on
* overflow (when the input is greater than largest uint120).
*
* Counterpart to Solidity's `uint120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toUint120(uint256 value) internal pure returns (uint120) {
if (value > type(uint120).max) {
revert SafeCastOverflowedUintDowncast(120, value);
}
return uint120(value);
}
/**
* @dev Returns the downcasted uint112 from uint256, reverting on
* overflow (when the input is greater than largest uint112).
*
* Counterpart to Solidity's `uint112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toUint112(uint256 value) internal pure returns (uint112) {
if (value > type(uint112).max) {
revert SafeCastOverflowedUintDowncast(112, value);
}
return uint112(value);
}
/**
* @dev Returns the downcasted uint104 from uint256, reverting on
* overflow (when the input is greater than largest uint104).
*
* Counterpart to Solidity's `uint104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toUint104(uint256 value) internal pure returns (uint104) {
if (value > type(uint104).max) {
revert SafeCastOverflowedUintDowncast(104, value);
}
return uint104(value);
}
/**
* @dev Returns the downcasted uint96 from uint256, reverting on
* overflow (when the input is greater than largest uint96).
*
* Counterpart to Solidity's `uint96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toUint96(uint256 value) internal pure returns (uint96) {
if (value > type(uint96).max) {
revert SafeCastOverflowedUintDowncast(96, value);
}
return uint96(value);
}
/**
* @dev Returns the downcasted uint88 from uint256, reverting on
* overflow (when the input is greater than largest uint88).
*
* Counterpart to Solidity's `uint88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toUint88(uint256 value) internal pure returns (uint88) {
if (value > type(uint88).max) {
revert SafeCastOverflowedUintDowncast(88, value);
}
return uint88(value);
}
/**
* @dev Returns the downcasted uint80 from uint256, reverting on
* overflow (when the input is greater than largest uint80).
*
* Counterpart to Solidity's `uint80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toUint80(uint256 value) internal pure returns (uint80) {
if (value > type(uint80).max) {
revert SafeCastOverflowedUintDowncast(80, value);
}
return uint80(value);
}
/**
* @dev Returns the downcasted uint72 from uint256, reverting on
* overflow (when the input is greater than largest uint72).
*
* Counterpart to Solidity's `uint72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toUint72(uint256 value) internal pure returns (uint72) {
if (value > type(uint72).max) {
revert SafeCastOverflowedUintDowncast(72, value);
}
return uint72(value);
}
/**
* @dev Returns the downcasted uint64 from uint256, reverting on
* overflow (when the input is greater than largest uint64).
*
* Counterpart to Solidity's `uint64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toUint64(uint256 value) internal pure returns (uint64) {
if (value > type(uint64).max) {
revert SafeCastOverflowedUintDowncast(64, value);
}
return uint64(value);
}
/**
* @dev Returns the downcasted uint56 from uint256, reverting on
* overflow (when the input is greater than largest uint56).
*
* Counterpart to Solidity's `uint56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toUint56(uint256 value) internal pure returns (uint56) {
if (value > type(uint56).max) {
revert SafeCastOverflowedUintDowncast(56, value);
}
return uint56(value);
}
/**
* @dev Returns the downcasted uint48 from uint256, reverting on
* overflow (when the input is greater than largest uint48).
*
* Counterpart to Solidity's `uint48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toUint48(uint256 value) internal pure returns (uint48) {
if (value > type(uint48).max) {
revert SafeCastOverflowedUintDowncast(48, value);
}
return uint48(value);
}
/**
* @dev Returns the downcasted uint40 from uint256, reverting on
* overflow (when the input is greater than largest uint40).
*
* Counterpart to Solidity's `uint40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toUint40(uint256 value) internal pure returns (uint40) {
if (value > type(uint40).max) {
revert SafeCastOverflowedUintDowncast(40, value);
}
return uint40(value);
}
/**
* @dev Returns the downcasted uint32 from uint256, reverting on
* overflow (when the input is greater than largest uint32).
*
* Counterpart to Solidity's `uint32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toUint32(uint256 value) internal pure returns (uint32) {
if (value > type(uint32).max) {
revert SafeCastOverflowedUintDowncast(32, value);
}
return uint32(value);
}
/**
* @dev Returns the downcasted uint24 from uint256, reverting on
* overflow (when the input is greater than largest uint24).
*
* Counterpart to Solidity's `uint24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toUint24(uint256 value) internal pure returns (uint24) {
if (value > type(uint24).max) {
revert SafeCastOverflowedUintDowncast(24, value);
}
return uint24(value);
}
/**
* @dev Returns the downcasted uint16 from uint256, reverting on
* overflow (when the input is greater than largest uint16).
*
* Counterpart to Solidity's `uint16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toUint16(uint256 value) internal pure returns (uint16) {
if (value > type(uint16).max) {
revert SafeCastOverflowedUintDowncast(16, value);
}
return uint16(value);
}
/**
* @dev Returns the downcasted uint8 from uint256, reverting on
* overflow (when the input is greater than largest uint8).
*
* Counterpart to Solidity's `uint8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toUint8(uint256 value) internal pure returns (uint8) {
if (value > type(uint8).max) {
revert SafeCastOverflowedUintDowncast(8, value);
}
return uint8(value);
}
/**
* @dev Converts a signed int256 into an unsigned uint256.
*
* Requirements:
*
* - input must be greater than or equal to 0.
*/
function toUint256(int256 value) internal pure returns (uint256) {
if (value < 0) {
revert SafeCastOverflowedIntToUint(value);
}
return uint256(value);
}
/**
* @dev Returns the downcasted int248 from int256, reverting on
* overflow (when the input is less than smallest int248 or
* greater than largest int248).
*
* Counterpart to Solidity's `int248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toInt248(int256 value) internal pure returns (int248 downcasted) {
downcasted = int248(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(248, value);
}
}
/**
* @dev Returns the downcasted int240 from int256, reverting on
* overflow (when the input is less than smallest int240 or
* greater than largest int240).
*
* Counterpart to Solidity's `int240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toInt240(int256 value) internal pure returns (int240 downcasted) {
downcasted = int240(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(240, value);
}
}
/**
* @dev Returns the downcasted int232 from int256, reverting on
* overflow (when the input is less than smallest int232 or
* greater than largest int232).
*
* Counterpart to Solidity's `int232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toInt232(int256 value) internal pure returns (int232 downcasted) {
downcasted = int232(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(232, value);
}
}
/**
* @dev Returns the downcasted int224 from int256, reverting on
* overflow (when the input is less than smallest int224 or
* greater than largest int224).
*
* Counterpart to Solidity's `int224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toInt224(int256 value) internal pure returns (int224 downcasted) {
downcasted = int224(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(224, value);
}
}
/**
* @dev Returns the downcasted int216 from int256, reverting on
* overflow (when the input is less than smallest int216 or
* greater than largest int216).
*
* Counterpart to Solidity's `int216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toInt216(int256 value) internal pure returns (int216 downcasted) {
downcasted = int216(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(216, value);
}
}
/**
* @dev Returns the downcasted int208 from int256, reverting on
* overflow (when the input is less than smallest int208 or
* greater than largest int208).
*
* Counterpart to Solidity's `int208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toInt208(int256 value) internal pure returns (int208 downcasted) {
downcasted = int208(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(208, value);
}
}
/**
* @dev Returns the downcasted int200 from int256, reverting on
* overflow (when the input is less than smallest int200 or
* greater than largest int200).
*
* Counterpart to Solidity's `int200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toInt200(int256 value) internal pure returns (int200 downcasted) {
downcasted = int200(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(200, value);
}
}
/**
* @dev Returns the downcasted int192 from int256, reverting on
* overflow (when the input is less than smallest int192 or
* greater than largest int192).
*
* Counterpart to Solidity's `int192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toInt192(int256 value) internal pure returns (int192 downcasted) {
downcasted = int192(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(192, value);
}
}
/**
* @dev Returns the downcasted int184 from int256, reverting on
* overflow (when the input is less than smallest int184 or
* greater than largest int184).
*
* Counterpart to Solidity's `int184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toInt184(int256 value) internal pure returns (int184 downcasted) {
downcasted = int184(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(184, value);
}
}
/**
* @dev Returns the downcasted int176 from int256, reverting on
* overflow (when the input is less than smallest int176 or
* greater than largest int176).
*
* Counterpart to Solidity's `int176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toInt176(int256 value) internal pure returns (int176 downcasted) {
downcasted = int176(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(176, value);
}
}
/**
* @dev Returns the downcasted int168 from int256, reverting on
* overflow (when the input is less than smallest int168 or
* greater than largest int168).
*
* Counterpart to Solidity's `int168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toInt168(int256 value) internal pure returns (int168 downcasted) {
downcasted = int168(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(168, value);
}
}
/**
* @dev Returns the downcasted int160 from int256, reverting on
* overflow (when the input is less than smallest int160 or
* greater than largest int160).
*
* Counterpart to Solidity's `int160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toInt160(int256 value) internal pure returns (int160 downcasted) {
downcasted = int160(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(160, value);
}
}
/**
* @dev Returns the downcasted int152 from int256, reverting on
* overflow (when the input is less than smallest int152 or
* greater than largest int152).
*
* Counterpart to Solidity's `int152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toInt152(int256 value) internal pure returns (int152 downcasted) {
downcasted = int152(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(152, value);
}
}
/**
* @dev Returns the downcasted int144 from int256, reverting on
* overflow (when the input is less than smallest int144 or
* greater than largest int144).
*
* Counterpart to Solidity's `int144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toInt144(int256 value) internal pure returns (int144 downcasted) {
downcasted = int144(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(144, value);
}
}
/**
* @dev Returns the downcasted int136 from int256, reverting on
* overflow (when the input is less than smallest int136 or
* greater than largest int136).
*
* Counterpart to Solidity's `int136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toInt136(int256 value) internal pure returns (int136 downcasted) {
downcasted = int136(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(136, value);
}
}
/**
* @dev Returns the downcasted int128 from int256, reverting on
* overflow (when the input is less than smallest int128 or
* greater than largest int128).
*
* Counterpart to Solidity's `int128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toInt128(int256 value) internal pure returns (int128 downcasted) {
downcasted = int128(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(128, value);
}
}
/**
* @dev Returns the downcasted int120 from int256, reverting on
* overflow (when the input is less than smallest int120 or
* greater than largest int120).
*
* Counterpart to Solidity's `int120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toInt120(int256 value) internal pure returns (int120 downcasted) {
downcasted = int120(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(120, value);
}
}
/**
* @dev Returns the downcasted int112 from int256, reverting on
* overflow (when the input is less than smallest int112 or
* greater than largest int112).
*
* Counterpart to Solidity's `int112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toInt112(int256 value) internal pure returns (int112 downcasted) {
downcasted = int112(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(112, value);
}
}
/**
* @dev Returns the downcasted int104 from int256, reverting on
* overflow (when the input is less than smallest int104 or
* greater than largest int104).
*
* Counterpart to Solidity's `int104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toInt104(int256 value) internal pure returns (int104 downcasted) {
downcasted = int104(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(104, value);
}
}
/**
* @dev Returns the downcasted int96 from int256, reverting on
* overflow (when the input is less than smallest int96 or
* greater than largest int96).
*
* Counterpart to Solidity's `int96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toInt96(int256 value) internal pure returns (int96 downcasted) {
downcasted = int96(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(96, value);
}
}
/**
* @dev Returns the downcasted int88 from int256, reverting on
* overflow (when the input is less than smallest int88 or
* greater than largest int88).
*
* Counterpart to Solidity's `int88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toInt88(int256 value) internal pure returns (int88 downcasted) {
downcasted = int88(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(88, value);
}
}
/**
* @dev Returns the downcasted int80 from int256, reverting on
* overflow (when the input is less than smallest int80 or
* greater than largest int80).
*
* Counterpart to Solidity's `int80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toInt80(int256 value) internal pure returns (int80 downcasted) {
downcasted = int80(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(80, value);
}
}
/**
* @dev Returns the downcasted int72 from int256, reverting on
* overflow (when the input is less than smallest int72 or
* greater than largest int72).
*
* Counterpart to Solidity's `int72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toInt72(int256 value) internal pure returns (int72 downcasted) {
downcasted = int72(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(72, value);
}
}
/**
* @dev Returns the downcasted int64 from int256, reverting on
* overflow (when the input is less than smallest int64 or
* greater than largest int64).
*
* Counterpart to Solidity's `int64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toInt64(int256 value) internal pure returns (int64 downcasted) {
downcasted = int64(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(64, value);
}
}
/**
* @dev Returns the downcasted int56 from int256, reverting on
* overflow (when the input is less than smallest int56 or
* greater than largest int56).
*
* Counterpart to Solidity's `int56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toInt56(int256 value) internal pure returns (int56 downcasted) {
downcasted = int56(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(56, value);
}
}
/**
* @dev Returns the downcasted int48 from int256, reverting on
* overflow (when the input is less than smallest int48 or
* greater than largest int48).
*
* Counterpart to Solidity's `int48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toInt48(int256 value) internal pure returns (int48 downcasted) {
downcasted = int48(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(48, value);
}
}
/**
* @dev Returns the downcasted int40 from int256, reverting on
* overflow (when the input is less than smallest int40 or
* greater than largest int40).
*
* Counterpart to Solidity's `int40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toInt40(int256 value) internal pure returns (int40 downcasted) {
downcasted = int40(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(40, value);
}
}
/**
* @dev Returns the downcasted int32 from int256, reverting on
* overflow (when the input is less than smallest int32 or
* greater than largest int32).
*
* Counterpart to Solidity's `int32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toInt32(int256 value) internal pure returns (int32 downcasted) {
downcasted = int32(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(32, value);
}
}
/**
* @dev Returns the downcasted int24 from int256, reverting on
* overflow (when the input is less than smallest int24 or
* greater than largest int24).
*
* Counterpart to Solidity's `int24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toInt24(int256 value) internal pure returns (int24 downcasted) {
downcasted = int24(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(24, value);
}
}
/**
* @dev Returns the downcasted int16 from int256, reverting on
* overflow (when the input is less than smallest int16 or
* greater than largest int16).
*
* Counterpart to Solidity's `int16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toInt16(int256 value) internal pure returns (int16 downcasted) {
downcasted = int16(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(16, value);
}
}
/**
* @dev Returns the downcasted int8 from int256, reverting on
* overflow (when the input is less than smallest int8 or
* greater than largest int8).
*
* Counterpart to Solidity's `int8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toInt8(int256 value) internal pure returns (int8 downcasted) {
downcasted = int8(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(8, value);
}
}
/**
* @dev Converts an unsigned uint256 into a signed int256.
*
* Requirements:
*
* - input must be less than or equal to maxInt256.
*/
function toInt256(uint256 value) internal pure returns (int256) {
// Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
if (value > uint256(type(int256).max)) {
revert SafeCastOverflowedUintToInt(value);
}
return int256(value);
}
/**
* @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.
*/
function toUint(bool b) internal pure returns (uint256 u) {
assembly ("memory-safe") {
u := iszero(iszero(b))
}
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.3.0) (utils/math/Math.sol)
pragma solidity ^0.8.20;
import {Panic} from "../Panic.sol";
import {SafeCast} from "./SafeCast.sol";
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Floor, // Toward negative infinity
Ceil, // Toward positive infinity
Trunc, // Toward zero
Expand // Away from zero
}
/**
* @dev Return the 512-bit addition of two uint256.
*
* The result is stored in two 256 variables such that sum = high * 2²⁵⁶ + low.
*/
function add512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
assembly ("memory-safe") {
low := add(a, b)
high := lt(low, a)
}
}
/**
* @dev Return the 512-bit multiplication of two uint256.
*
* The result is stored in two 256 variables such that product = high * 2²⁵⁶ + low.
*/
function mul512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
// 512-bit multiply [high low] = x * y. Compute the product mod 2²⁵⁶ and mod 2²⁵⁶ - 1, then use
// the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = high * 2²⁵⁶ + low.
assembly ("memory-safe") {
let mm := mulmod(a, b, not(0))
low := mul(a, b)
high := sub(sub(mm, low), lt(mm, low))
}
}
/**
* @dev Returns the addition of two unsigned integers, with a success flag (no overflow).
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a + b;
success = c >= a;
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the subtraction of two unsigned integers, with a success flag (no overflow).
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a - b;
success = c <= a;
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the multiplication of two unsigned integers, with a success flag (no overflow).
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a * b;
assembly ("memory-safe") {
// Only true when the multiplication doesn't overflow
// (c / a == b) || (a == 0)
success := or(eq(div(c, a), b), iszero(a))
}
// equivalent to: success ? c : 0
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the division of two unsigned integers, with a success flag (no division by zero).
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
success = b > 0;
assembly ("memory-safe") {
// The `DIV` opcode returns zero when the denominator is 0.
result := div(a, b)
}
}
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
success = b > 0;
assembly ("memory-safe") {
// The `MOD` opcode returns zero when the denominator is 0.
result := mod(a, b)
}
}
}
/**
* @dev Unsigned saturating addition, bounds to `2²⁵⁶ - 1` instead of overflowing.
*/
function saturatingAdd(uint256 a, uint256 b) internal pure returns (uint256) {
(bool success, uint256 result) = tryAdd(a, b);
return ternary(success, result, type(uint256).max);
}
/**
* @dev Unsigned saturating subtraction, bounds to zero instead of overflowing.
*/
function saturatingSub(uint256 a, uint256 b) internal pure returns (uint256) {
(, uint256 result) = trySub(a, b);
return result;
}
/**
* @dev Unsigned saturating multiplication, bounds to `2²⁵⁶ - 1` instead of overflowing.
*/
function saturatingMul(uint256 a, uint256 b) internal pure returns (uint256) {
(bool success, uint256 result) = tryMul(a, b);
return ternary(success, result, type(uint256).max);
}
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * SafeCast.toUint(condition));
}
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a < b, a, b);
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds towards infinity instead
* of rounding towards zero.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
if (b == 0) {
// Guarantee the same behavior as in a regular Solidity division.
Panic.panic(Panic.DIVISION_BY_ZERO);
}
// The following calculation ensures accurate ceiling division without overflow.
// Since a is non-zero, (a - 1) / b will not overflow.
// The largest possible result occurs when (a - 1) / b is type(uint256).max,
// but the largest value we can obtain is type(uint256).max - 1, which happens
// when a = type(uint256).max and b = 1.
unchecked {
return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
}
}
/**
* @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
* denominator == 0.
*
* Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by
* Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
(uint256 high, uint256 low) = mul512(x, y);
// Handle non-overflow cases, 256 by 256 division.
if (high == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return low / denominator;
}
// Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
if (denominator <= high) {
Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));
}
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [high low].
uint256 remainder;
assembly ("memory-safe") {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
high := sub(high, gt(remainder, low))
low := sub(low, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator.
// Always >= 1. See https://cs.stackexchange.com/q/138556/92363.
uint256 twos = denominator & (0 - denominator);
assembly ("memory-safe") {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [high low] by twos.
low := div(low, twos)
// Flip twos such that it is 2²⁵⁶ / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from high into low.
low |= high * twos;
// Invert denominator mod 2²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
// that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv ≡ 1 mod 2⁴.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also
// works in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2⁸
inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
inverse *= 2 - denominator * inverse; // inverse mod 2³²
inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2²⁵⁶. Since the preconditions guarantee that the outcome is
// less than 2²⁵⁶, this is the final result. We don't need to compute the high bits of the result and high
// is no longer required.
result = low * inverse;
return result;
}
}
/**
* @dev Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
}
/**
* @dev Calculates floor(x * y >> n) with full precision. Throws if result overflows a uint256.
*/
function mulShr(uint256 x, uint256 y, uint8 n) internal pure returns (uint256 result) {
unchecked {
(uint256 high, uint256 low) = mul512(x, y);
if (high >= 1 << n) {
Panic.panic(Panic.UNDER_OVERFLOW);
}
return (high << (256 - n)) | (low >> n);
}
}
/**
* @dev Calculates x * y >> n with full precision, following the selected rounding direction.
*/
function mulShr(uint256 x, uint256 y, uint8 n, Rounding rounding) internal pure returns (uint256) {
return mulShr(x, y, n) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, 1 << n) > 0);
}
/**
* @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
*
* If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
* If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
*
* If the input value is not inversible, 0 is returned.
*
* NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
* inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
*/
function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
unchecked {
if (n == 0) return 0;
// The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
// Used to compute integers x and y such that: ax + ny = gcd(a, n).
// When the gcd is 1, then the inverse of a modulo n exists and it's x.
// ax + ny = 1
// ax = 1 + (-y)n
// ax ≡ 1 (mod n) # x is the inverse of a modulo n
// If the remainder is 0 the gcd is n right away.
uint256 remainder = a % n;
uint256 gcd = n;
// Therefore the initial coefficients are:
// ax + ny = gcd(a, n) = n
// 0a + 1n = n
int256 x = 0;
int256 y = 1;
while (remainder != 0) {
uint256 quotient = gcd / remainder;
(gcd, remainder) = (
// The old remainder is the next gcd to try.
remainder,
// Compute the next remainder.
// Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
// where gcd is at most n (capped to type(uint256).max)
gcd - remainder * quotient
);
(x, y) = (
// Increment the coefficient of a.
y,
// Decrement the coefficient of n.
// Can overflow, but the result is casted to uint256 so that the
// next value of y is "wrapped around" to a value between 0 and n - 1.
x - y * int256(quotient)
);
}
if (gcd != 1) return 0; // No inverse exists.
return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
}
}
/**
* @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
*
* From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
* prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
* `a**(p-2)` is the modular multiplicative inverse of a in Fp.
*
* NOTE: this function does NOT check that `p` is a prime greater than `2`.
*/
function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
unchecked {
return Math.modExp(a, p - 2, p);
}
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
*
* Requirements:
* - modulus can't be zero
* - underlying staticcall to precompile must succeed
*
* IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
* sure the chain you're using it on supports the precompiled contract for modular exponentiation
* at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
* the underlying function will succeed given the lack of a revert, but the result may be incorrectly
* interpreted as 0.
*/
function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
(bool success, uint256 result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
* It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
* to operate modulo 0 or if the underlying precompile reverted.
*
* IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
* you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
* https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
* of a revert, but the result may be incorrectly interpreted as 0.
*/
function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
if (m == 0) return (false, 0);
assembly ("memory-safe") {
let ptr := mload(0x40)
// | Offset | Content | Content (Hex) |
// |-----------|------------|--------------------------------------------------------------------|
// | 0x00:0x1f | size of b | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x20:0x3f | size of e | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x40:0x5f | size of m | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x60:0x7f | value of b | 0x<.............................................................b> |
// | 0x80:0x9f | value of e | 0x<.............................................................e> |
// | 0xa0:0xbf | value of m | 0x<.............................................................m> |
mstore(ptr, 0x20)
mstore(add(ptr, 0x20), 0x20)
mstore(add(ptr, 0x40), 0x20)
mstore(add(ptr, 0x60), b)
mstore(add(ptr, 0x80), e)
mstore(add(ptr, 0xa0), m)
// Given the result < m, it's guaranteed to fit in 32 bytes,
// so we can use the memory scratch space located at offset 0.
success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
result := mload(0x00)
}
}
/**
* @dev Variant of {modExp} that supports inputs of arbitrary length.
*/
function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
(bool success, bytes memory result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Variant of {tryModExp} that supports inputs of arbitrary length.
*/
function tryModExp(
bytes memory b,
bytes memory e,
bytes memory m
) internal view returns (bool success, bytes memory result) {
if (_zeroBytes(m)) return (false, new bytes(0));
uint256 mLen = m.length;
// Encode call args in result and move the free memory pointer
result = abi.encodePacked(b.length, e.length, mLen, b, e, m);
assembly ("memory-safe") {
let dataPtr := add(result, 0x20)
// Write result on top of args to avoid allocating extra memory.
success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
// Overwrite the length.
// result.length > returndatasize() is guaranteed because returndatasize() == m.length
mstore(result, mLen)
// Set the memory pointer after the returned data.
mstore(0x40, add(dataPtr, mLen))
}
}
/**
* @dev Returns whether the provided byte array is zero.
*/
function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
for (uint256 i = 0; i < byteArray.length; ++i) {
if (byteArray[i] != 0) {
return false;
}
}
return true;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
* towards zero.
*
* This method is based on Newton's method for computing square roots; the algorithm is restricted to only
* using integer operations.
*/
function sqrt(uint256 a) internal pure returns (uint256) {
unchecked {
// Take care of easy edge cases when a == 0 or a == 1
if (a <= 1) {
return a;
}
// In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
// sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
// the current value as `ε_n = | x_n - sqrt(a) |`.
//
// For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
// of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
// bigger than any uint256.
//
// By noticing that
// `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
// we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
// to the msb function.
uint256 aa = a;
uint256 xn = 1;
if (aa >= (1 << 128)) {
aa >>= 128;
xn <<= 64;
}
if (aa >= (1 << 64)) {
aa >>= 64;
xn <<= 32;
}
if (aa >= (1 << 32)) {
aa >>= 32;
xn <<= 16;
}
if (aa >= (1 << 16)) {
aa >>= 16;
xn <<= 8;
}
if (aa >= (1 << 8)) {
aa >>= 8;
xn <<= 4;
}
if (aa >= (1 << 4)) {
aa >>= 4;
xn <<= 2;
}
if (aa >= (1 << 2)) {
xn <<= 1;
}
// We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
//
// We can refine our estimation by noticing that the middle of that interval minimizes the error.
// If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
// This is going to be our x_0 (and ε_0)
xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)
// From here, Newton's method give us:
// x_{n+1} = (x_n + a / x_n) / 2
//
// One should note that:
// x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
// = ((x_n² + a) / (2 * x_n))² - a
// = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
// = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
// = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
// = (x_n² - a)² / (2 * x_n)²
// = ((x_n² - a) / (2 * x_n))²
// ≥ 0
// Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
//
// This gives us the proof of quadratic convergence of the sequence:
// ε_{n+1} = | x_{n+1} - sqrt(a) |
// = | (x_n + a / x_n) / 2 - sqrt(a) |
// = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
// = | (x_n - sqrt(a))² / (2 * x_n) |
// = | ε_n² / (2 * x_n) |
// = ε_n² / | (2 * x_n) |
//
// For the first iteration, we have a special case where x_0 is known:
// ε_1 = ε_0² / | (2 * x_0) |
// ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
// ≤ 2**(2*e-4) / (3 * 2**(e-1))
// ≤ 2**(e-3) / 3
// ≤ 2**(e-3-log2(3))
// ≤ 2**(e-4.5)
//
// For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
// ε_{n+1} = ε_n² / | (2 * x_n) |
// ≤ (2**(e-k))² / (2 * 2**(e-1))
// ≤ 2**(2*e-2*k) / 2**e
// ≤ 2**(e-2*k)
xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5) -- special case, see above
xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9) -- general case with k = 4.5
xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18) -- general case with k = 9
xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36) -- general case with k = 18
xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72) -- general case with k = 36
xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144) -- general case with k = 72
// Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
// ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
// sqrt(a) or sqrt(a) + 1.
return xn - SafeCast.toUint(xn > a / xn);
}
}
/**
* @dev Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
}
}
/**
* @dev Return the log in base 2 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log2(uint256 x) internal pure returns (uint256 r) {
// If value has upper 128 bits set, log2 result is at least 128
r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
// If upper 64 bits of 128-bit half set, add 64 to result
r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
// If upper 32 bits of 64-bit half set, add 32 to result
r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
// If upper 16 bits of 32-bit half set, add 16 to result
r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
// If upper 8 bits of 16-bit half set, add 8 to result
r |= SafeCast.toUint((x >> r) > 0xff) << 3;
// If upper 4 bits of 8-bit half set, add 4 to result
r |= SafeCast.toUint((x >> r) > 0xf) << 2;
// Shifts value right by the current result and use it as an index into this lookup table:
//
// | x (4 bits) | index | table[index] = MSB position |
// |------------|---------|-----------------------------|
// | 0000 | 0 | table[0] = 0 |
// | 0001 | 1 | table[1] = 0 |
// | 0010 | 2 | table[2] = 1 |
// | 0011 | 3 | table[3] = 1 |
// | 0100 | 4 | table[4] = 2 |
// | 0101 | 5 | table[5] = 2 |
// | 0110 | 6 | table[6] = 2 |
// | 0111 | 7 | table[7] = 2 |
// | 1000 | 8 | table[8] = 3 |
// | 1001 | 9 | table[9] = 3 |
// | 1010 | 10 | table[10] = 3 |
// | 1011 | 11 | table[11] = 3 |
// | 1100 | 12 | table[12] = 3 |
// | 1101 | 13 | table[13] = 3 |
// | 1110 | 14 | table[14] = 3 |
// | 1111 | 15 | table[15] = 3 |
//
// The lookup table is represented as a 32-byte value with the MSB positions for 0-15 in the last 16 bytes.
assembly ("memory-safe") {
r := or(r, byte(shr(r, x), 0x0000010102020202030303030303030300000000000000000000000000000000))
}
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
}
}
/**
* @dev Return the log in base 10 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);
}
}
/**
* @dev Return the log in base 256 of a positive value rounded towards zero.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 x) internal pure returns (uint256 r) {
// If value has upper 128 bits set, log2 result is at least 128
r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
// If upper 64 bits of 128-bit half set, add 64 to result
r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
// If upper 32 bits of 64-bit half set, add 32 to result
r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
// If upper 16 bits of 32-bit half set, add 16 to result
r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
// Add 1 if upper 8 bits of 16-bit half set, and divide accumulated result by 8
return (r >> 3) | SafeCast.toUint((x >> r) > 0xff);
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);
}
}
/**
* @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
*/
function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
return uint8(rounding) % 2 == 1;
}
}// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.4.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity >=0.5.0;
/**
* @title ERC-721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC-721 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 v5.4.0) (interfaces/IERC721.sol)
pragma solidity >=0.6.2;
import {IERC721} from "../token/ERC721/IERC721.sol";// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)
pragma solidity ^0.8.20;
/**
* @dev Helper library for emitting standardized panic codes.
*
* ```solidity
* contract Example {
* using Panic for uint256;
*
* // Use any of the declared internal constants
* function foo() { Panic.GENERIC.panic(); }
*
* // Alternatively
* function foo() { Panic.panic(Panic.GENERIC); }
* }
* ```
*
* Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].
*
* _Available since v5.1._
*/
// slither-disable-next-line unused-state
library Panic {
/// @dev generic / unspecified error
uint256 internal constant GENERIC = 0x00;
/// @dev used by the assert() builtin
uint256 internal constant ASSERT = 0x01;
/// @dev arithmetic underflow or overflow
uint256 internal constant UNDER_OVERFLOW = 0x11;
/// @dev division or modulo by zero
uint256 internal constant DIVISION_BY_ZERO = 0x12;
/// @dev enum conversion error
uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;
/// @dev invalid encoding in storage
uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;
/// @dev empty array pop
uint256 internal constant EMPTY_ARRAY_POP = 0x31;
/// @dev array out of bounds access
uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;
/// @dev resource error (too large allocation or too large array)
uint256 internal constant RESOURCE_ERROR = 0x41;
/// @dev calling invalid internal function
uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;
/// @dev Reverts with a panic code. Recommended to use with
/// the internal constants with predefined codes.
function panic(uint256 code) internal pure {
assembly ("memory-safe") {
mstore(0x00, 0x4e487b71)
mstore(0x20, code)
revert(0x1c, 0x24)
}
}
}{
"optimizer": {
"runs": 200,
"enabled": false
},
"remappings": [],
"outputSelection": {
"*": {
"*": [
"evm.bytecode",
"evm.deployedBytecode",
"abi"
]
}
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"uint256","name":"mintPrice_","type":"uint256"},{"internalType":"string","name":"baseURI_","type":"string"},{"internalType":"uint96","name":"royaltyFee_","type":"uint96"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidDefaultRoyalty","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidTokenRoyalty","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"owner","type":"address"}],"name":"ERC721IncorrectOwner","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721InsufficientApproval","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC721InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"ERC721InvalidOperator","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"ERC721InvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC721InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC721InvalidSender","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721NonexistentToken","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"inputs":[],"name":"ReentrancyGuardReentrantCall","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":false,"internalType":"string","name":"newBaseURI","type":"string"}],"name":"BaseURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_fromTokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"_toTokenId","type":"uint256"}],"name":"BatchMetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"MetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"oldPrice","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"MintPriceUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"price","type":"uint256"}],"name":"Minted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Withdrawn","type":"event"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"collectionDescription","outputs":[{"internalType":"string","name":"","type":"string"}],"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":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"maxSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"tokenURI_","type":"string"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"string[]","name":"tokenURIs_","type":"string[]"}],"name":"mintBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"mintPrice","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"ownerBalance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"string","name":"tokenURI_","type":"string"}],"name":"ownerMint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"newBaseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"newPrice","type":"uint256"}],"name":"setMintPrice","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint96","name":"feeNumerator","type":"uint96"}],"name":"setRoyaltyInfo","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdraw","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
608060405234801561000f575f5ffd5b506040516149d43803806149d4833981810160405281019061003191906105a4565b336040518060400160405280600581526020017f62766572730000000000000000000000000000000000000000000000000000008152506040518060400160405280600581526020017f4256455253000000000000000000000000000000000000000000000000000000815250815f90816100ac9190610817565b5080600190816100bc9190610817565b5050505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361012f575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016101269190610925565b60405180910390fd5b61013e8161017660201b60201c565b506001600a8190555082600b8190555081600c908161015d9190610817565b5061016e338261023960201b60201c565b5050506109a4565b5f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160095f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f6102486103da60201b60201c565b6bffffffffffffffffffffffff16905080826bffffffffffffffffffffffff1611156102ad5781816040517f6f483d090000000000000000000000000000000000000000000000000000000081526004016102a492919061097d565b60405180910390fd5b5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160361031d575f6040517fb6d9900a0000000000000000000000000000000000000000000000000000000081526004016103149190610925565b60405180910390fd5b60405180604001604052808473ffffffffffffffffffffffffffffffffffffffff168152602001836bffffffffffffffffffffffff1681525060075f820151815f015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506020820151815f0160146101000a8154816bffffffffffffffffffffffff02191690836bffffffffffffffffffffffff160217905550905050505050565b5f612710905090565b5f604051905090565b5f5ffd5b5f5ffd5b5f819050919050565b610406816103f4565b8114610410575f5ffd5b50565b5f81519050610421816103fd565b92915050565b5f5ffd5b5f5ffd5b5f601f19601f8301169050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b6104758261042f565b810181811067ffffffffffffffff821117156104945761049361043f565b5b80604052505050565b5f6104a66103e3565b90506104b2828261046c565b919050565b5f67ffffffffffffffff8211156104d1576104d061043f565b5b6104da8261042f565b9050602081019050919050565b8281835e5f83830152505050565b5f610507610502846104b7565b61049d565b9050828152602081018484840111156105235761052261042b565b5b61052e8482856104e7565b509392505050565b5f82601f83011261054a57610549610427565b5b815161055a8482602086016104f5565b91505092915050565b5f6bffffffffffffffffffffffff82169050919050565b61058381610563565b811461058d575f5ffd5b50565b5f8151905061059e8161057a565b92915050565b5f5f5f606084860312156105bb576105ba6103ec565b5b5f6105c886828701610413565b935050602084015167ffffffffffffffff8111156105e9576105e86103f0565b5b6105f586828701610536565b925050604061060686828701610590565b9150509250925092565b5f81519050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f600282049050600182168061065e57607f821691505b6020821081036106715761067061061a565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026106d37fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82610698565b6106dd8683610698565b95508019841693508086168417925050509392505050565b5f819050919050565b5f61071861071361070e846103f4565b6106f5565b6103f4565b9050919050565b5f819050919050565b610731836106fe565b61074561073d8261071f565b8484546106a4565b825550505050565b5f5f905090565b61075c61074d565b610767818484610728565b505050565b5b8181101561078a5761077f5f82610754565b60018101905061076d565b5050565b601f8211156107cf576107a081610677565b6107a984610689565b810160208510156107b8578190505b6107cc6107c485610689565b83018261076c565b50505b505050565b5f82821c905092915050565b5f6107ef5f19846008026107d4565b1980831691505092915050565b5f61080783836107e0565b9150826002028217905092915050565b61082082610610565b67ffffffffffffffff8111156108395761083861043f565b5b6108438254610647565b61084e82828561078e565b5f60209050601f83116001811461087f575f841561086d578287015190505b61087785826107fc565b8655506108de565b601f19841661088d86610677565b5f5b828110156108b45784890151825560018201915060208501945060208101905061088f565b868310156108d157848901516108cd601f8916826107e0565b8355505b6001600288020188555050505b505050505050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f61090f826108e6565b9050919050565b61091f81610905565b82525050565b5f6020820190506109385f830184610916565b92915050565b5f61095861095361094e84610563565b6106f5565b6103f4565b9050919050565b6109688161093e565b82525050565b610977816103f4565b82525050565b5f6040820190506109905f83018561095f565b61099d602083018461096e565b9392505050565b614023806109b15f395ff3fe6080604052600436106101c1575f3560e01c806370a08231116100f6578063c87b56dd11610094578063e985e9c511610063578063e985e9c51461062e578063f09dfbe91461066a578063f2fde38b1461069a578063f4a0a528146106c2576101c1565b8063c87b56dd1461056e578063d5abeb01146105aa578063d85d3d27146105d4578063e2c6875c14610604576101c1565b806395d89b41116100d057806395d89b41146104ca578063a22cb465146104f4578063b88d4fde1461051c578063bedcf00314610544576101c1565b806370a082311461044e578063715018a61461048a5780638da5cb5b146104a0576101c1565b80632a55205a1161016357806342842e0e1161013d57806342842e0e1461039857806355f804b3146103c05780636352211e146103e85780636817c76c14610424576101c1565b80632a55205a146103095780633ccfd60b1461034657806341d5b8031461035c576101c1565b8063081812fc1161019f578063081812fc14610253578063095ea7b31461028f57806318160ddd146102b757806323b872dd146102e1576101c1565b806301ffc9a7146101c557806302fa7c471461020157806306fdde0314610229575b5f5ffd5b3480156101d0575f5ffd5b506101eb60048036038101906101e69190612c7e565b6106ea565b6040516101f89190612cc3565b60405180910390f35b34801561020c575f5ffd5b5061022760048036038101906102229190612d77565b6106fb565b005b348015610234575f5ffd5b5061023d610711565b60405161024a9190612e25565b60405180910390f35b34801561025e575f5ffd5b5061027960048036038101906102749190612e78565b6107a0565b6040516102869190612eb2565b60405180910390f35b34801561029a575f5ffd5b506102b560048036038101906102b09190612ecb565b6107bb565b005b3480156102c2575f5ffd5b506102cb6107d1565b6040516102d89190612f18565b60405180910390f35b3480156102ec575f5ffd5b5061030760048036038101906103029190612f31565b6107da565b005b348015610314575f5ffd5b5061032f600480360381019061032a9190612f81565b6108d9565b60405161033d929190612fbf565b60405180910390f35b348015610351575f5ffd5b5061035a6109fb565b005b348015610367575f5ffd5b50610382600480360381019061037d9190613112565b610b6a565b60405161038f9190612f18565b60405180910390f35b3480156103a3575f5ffd5b506103be60048036038101906103b99190612f31565b610c4f565b005b3480156103cb575f5ffd5b506103e660048036038101906103e1919061316c565b610c6e565b005b3480156103f3575f5ffd5b5061040e60048036038101906104099190612e78565b610cc0565b60405161041b9190612eb2565b60405180910390f35b34801561042f575f5ffd5b50610438610cd1565b6040516104459190612f18565b60405180910390f35b348015610459575f5ffd5b50610474600480360381019061046f91906131b3565b610cd7565b6040516104819190612f18565b60405180910390f35b348015610495575f5ffd5b5061049e610d8d565b005b3480156104ab575f5ffd5b506104b4610da0565b6040516104c19190612eb2565b60405180910390f35b3480156104d5575f5ffd5b506104de610dc8565b6040516104eb9190612e25565b60405180910390f35b3480156104ff575f5ffd5b5061051a60048036038101906105159190613208565b610e58565b005b348015610527575f5ffd5b50610542600480360381019061053d91906132e4565b610e6e565b005b34801561054f575f5ffd5b50610558610e93565b6040516105659190612f18565b60405180910390f35b348015610579575f5ffd5b50610594600480360381019061058f9190612e78565b610e99565b6040516105a19190612e25565b60405180910390f35b3480156105b5575f5ffd5b506105be610eab565b6040516105cb9190612f18565b60405180910390f35b6105ee60048036038101906105e9919061316c565b610eb1565b6040516105fb9190612f18565b60405180910390f35b34801561060f575f5ffd5b506106186111b6565b6040516106259190612e25565b60405180910390f35b348015610639575f5ffd5b50610654600480360381019061064f9190613364565b6111d2565b6040516106619190612cc3565b60405180910390f35b610684600480360381019061067f9190613484565b611260565b6040516106919190613582565b60405180910390f35b3480156106a5575f5ffd5b506106c060048036038101906106bb91906131b3565b61167b565b005b3480156106cd575f5ffd5b506106e860048036038101906106e39190612e78565b6116ff565b005b5f6106f482611751565b9050919050565b6107036117ca565b61070d8282611851565b5050565b60605f805461071f906135cf565b80601f016020809104026020016040519081016040528092919081815260200182805461074b906135cf565b80156107965780601f1061076d57610100808354040283529160200191610796565b820191905f5260205f20905b81548152906001019060200180831161077957829003601f168201915b5050505050905090565b5f6107aa826119ec565b506107b482611a72565b9050919050565b6107cd82826107c8611aab565b611ab2565b5050565b5f600d54905090565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff160361084a575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016108419190612eb2565b60405180910390fd5b5f61085d8383610858611aab565b611ac4565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146108d3578382826040517f64283d7b0000000000000000000000000000000000000000000000000000000081526004016108ca939291906135ff565b60405180910390fd5b50505050565b5f5f5f60085f8681526020019081526020015f2090505f815f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690505f825f0160149054906101000a90046bffffffffffffffffffffffff1690505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036109ad5760075f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16915060075f0160149054906101000a90046bffffffffffffffffffffffff1690505b5f6109b6611ccf565b6bffffffffffffffffffffffff16826bffffffffffffffffffffffff16886109de9190613661565b6109e891906136cf565b9050828195509550505050509250929050565b610a036117ca565b610a0b611cd8565b5f600e5490505f8111610a53576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a4a90613749565b60405180910390fd5b5f600e819055505f610a63610da0565b73ffffffffffffffffffffffffffffffffffffffff1682604051610a8690613794565b5f6040518083038185875af1925050503d805f8114610ac0576040519150601f19603f3d011682016040523d82523d5f602084013e610ac5565b606091505b5050905080610b09576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610b00906137f2565b60405180910390fd5b610b11610da0565b73ffffffffffffffffffffffffffffffffffffffff167f7084f5476618d8e60b11ef0d7d3f06914655adb8793e28ff7f018d4c76d505d583604051610b569190612f18565b60405180910390a25050610b68611d1e565b565b5f610b736117ca565b5f6127101480610b865750612710600d54105b610bc5576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610bbc9061385a565b60405180910390fd5b600d5f815480929190610bd790613878565b91905055505f600d549050610bec8482611d28565b610bf68184611d45565b808473ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff5f604051610c3d9190613901565b60405180910390a38091505092915050565b610c6983838360405180602001604052805f815250610e6e565b505050565b610c766117ca565b80600c9081610c859190613ab1565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad81604051610cb59190612e25565b60405180910390a150565b5f610cca826119ec565b9050919050565b600b5481565b5f5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610d48575f6040517f89c62b64000000000000000000000000000000000000000000000000000000008152600401610d3f9190612eb2565b60405180910390fd5b60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610d956117ca565b610d9e5f611d9f565b565b5f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060018054610dd7906135cf565b80601f0160208091040260200160405190810160405280929190818152602001828054610e03906135cf565b8015610e4e5780601f10610e2557610100808354040283529160200191610e4e565b820191905f5260205f20905b815481529060010190602001808311610e3157829003601f168201915b5050505050905090565b610e6a610e63611aab565b8383611e62565b5050565b610e798484846107da565b610e8d610e84611aab565b85858585611fcb565b50505050565b600e5481565b6060610ea482612177565b9050919050565b61271081565b5f610eba611cd8565b600b54341015610eff576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ef690613bca565b60405180910390fd5b612710600d5410610f45576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f3c9061385a565b60405180910390fd5b600d5f815480929190610f5790613878565b91905055505f600d549050610f6c3382611d28565b610f768184611d45565b5f600b541115611154575f6127106103e8600b54610f949190613661565b610f9e91906136cf565b90505f81600b54610faf9190613be8565b90505f82111561106f575f610fc2612282565b90505f8173ffffffffffffffffffffffffffffffffffffffff1684604051610fe990613794565b5f6040518083038185875af1925050503d805f8114611023576040519150601f19603f3d011682016040523d82523d5f602084013e611028565b606091505b505090508061106c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161106390613c65565b60405180910390fd5b50505b5f8111156110905780600e5f8282546110889190613c83565b925050819055505b600b54341115611151575f3373ffffffffffffffffffffffffffffffffffffffff16600b54346110c09190613be8565b6040516110cc90613794565b5f6040518083038185875af1925050503d805f8114611106576040519150601f19603f3d011682016040523d82523d5f602084013e61110b565b606091505b505090508061114f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161114690613d00565b60405180910390fd5b505b50505b803373ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff600b5460405161119d9190612f18565b60405180910390a3809150506111b1611d1e565b919050565b6040518060c0016040528060848152602001613f6a6084913981565b5f60055f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b606061126a611cd8565b5f825190505f81116112b1576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112a890613d68565b60405180910390fd5b80600b546112bf9190613661565b341015611301576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112f890613bca565b60405180910390fd5b5f6127101480611320575061271081600d5461131d9190613c83565b11155b61135f576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113569061385a565b60405180910390fd5b5f8167ffffffffffffffff81111561137a57611379612fee565b5b6040519080825280602002602001820160405280156113a85781602001602082028036833780820191505090505b5090505f5f90505b8281101561148257600d5f8154809291906113ca90613878565b91905055505f600d5490506113df3382611d28565b611403818784815181106113f6576113f5613d86565b5b6020026020010151611d45565b8083838151811061141757611416613d86565b5b602002602001018181525050803373ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff600b5460405161146c9190612f18565b60405180910390a35080806001019150506113b0565b505f82600b546114929190613661565b90505f811115611668575f6127106103e8836114ae9190613661565b6114b891906136cf565b90505f81836114c79190613be8565b90505f821115611587575f6114da612282565b90505f8173ffffffffffffffffffffffffffffffffffffffff168460405161150190613794565b5f6040518083038185875af1925050503d805f811461153b576040519150601f19603f3d011682016040523d82523d5f602084013e611540565b606091505b5050905080611584576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161157b90613c65565b60405180910390fd5b50505b5f8111156115a85780600e5f8282546115a09190613c83565b925050819055505b82341115611665575f3373ffffffffffffffffffffffffffffffffffffffff1684346115d49190613be8565b6040516115e090613794565b5f6040518083038185875af1925050503d805f811461161a576040519150601f19603f3d011682016040523d82523d5f602084013e61161f565b606091505b5050905080611663576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161165a90613d00565b60405180910390fd5b505b50505b819350505050611676611d1e565b919050565b6116836117ca565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036116f3575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016116ea9190612eb2565b60405180910390fd5b6116fc81611d9f565b50565b6117076117ca565b5f600b54905081600b819055507f2e1c9e000c6e8dda4d03536adb13b7cb6034ccff90d17f01de381e4d5097b5258183604051611745929190613db3565b60405180910390a15050565b5f7f2a55205a000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806117c357506117c2826122cc565b5b9050919050565b6117d2611aab565b73ffffffffffffffffffffffffffffffffffffffff166117f0610da0565b73ffffffffffffffffffffffffffffffffffffffff161461184f57611813611aab565b6040517f118cdaa70000000000000000000000000000000000000000000000000000000081526004016118469190612eb2565b60405180910390fd5b565b5f61185a611ccf565b6bffffffffffffffffffffffff16905080826bffffffffffffffffffffffff1611156118bf5781816040517f6f483d090000000000000000000000000000000000000000000000000000000081526004016118b6929190613e0a565b60405180910390fd5b5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160361192f575f6040517fb6d9900a0000000000000000000000000000000000000000000000000000000081526004016119269190612eb2565b60405180910390fd5b60405180604001604052808473ffffffffffffffffffffffffffffffffffffffff168152602001836bffffffffffffffffffffffff1681525060075f820151815f015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506020820151815f0160146101000a8154816bffffffffffffffffffffffff02191690836bffffffffffffffffffffffff160217905550905050505050565b5f5f6119f78361232c565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603611a6957826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611a609190612f18565b60405180910390fd5b80915050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b611abf8383836001612365565b505050565b5f5f611acf8461232c565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614611b1057611b0f818486612524565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611b9b57611b4f5f855f5f612365565b600160035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1614611c1a57600160035f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460025f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f612710905090565b6002600a5403611d14576040517f3ee5aeb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6002600a81905550565b6001600a81905550565b611d41828260405180602001604052805f8152506125e7565b5050565b8060065f8481526020019081526020015f209081611d639190613ab1565b507ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce782604051611d939190612f18565b60405180910390a15050565b5f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160095f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611ed257816040517f5b08ba18000000000000000000000000000000000000000000000000000000008152600401611ec99190612eb2565b60405180910390fd5b8060055f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3183604051611fbe9190612cc3565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115612170578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b81526004016120299493929190613e83565b6020604051808303815f875af192505050801561206457506040513d601f19601f820116820180604052508101906120619190613ee1565b60015b6120e5573d805f8114612092576040519150601f19603f3d011682016040523d82523d5f602084013e612097565b606091505b505f8151036120dd57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016120d49190612eb2565b60405180910390fd5b805160208201fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461216e57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016121659190612eb2565b60405180910390fd5b505b5050505050565b6060612182826119ec565b505f60065f8481526020019081526020015f2080546121a0906135cf565b80601f01602080910402602001604051908101604052809291908181526020018280546121cc906135cf565b80156122175780601f106121ee57610100808354040283529160200191612217565b820191905f5260205f20905b8154815290600101906020018083116121fa57829003601f168201915b505050505090505f61222761260a565b90505f81510361223b57819250505061227d565b5f8251111561226f578082604051602001612257929190613f46565b6040516020818303038152906040529250505061227d565b6122788461269a565b925050505b919050565b5f738a2f1e4c7b39d6a5e8f1c2b4a7d9e3f6c5b1a89773bd4a61d7e56f6c846aff8e3d125e4e16e943ed4d18905073ffffffffffffffffffffffffffffffffffffffff8116905090565b5f634906490660e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161480612325575061232482612700565b5b9050919050565b5f60025f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061239d57505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b156124cf575f6123ac846119ec565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561241657508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b8015612429575061242781846111d2565b155b1561246b57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016124629190612eb2565b60405180910390fd5b81156124cd57838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360045f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b61252f8383836127e1565b6125e2575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16036125a357806040517f7e27328900000000000000000000000000000000000000000000000000000000815260040161259a9190612f18565b60405180910390fd5b81816040517f177e802f0000000000000000000000000000000000000000000000000000000081526004016125d9929190612fbf565b60405180910390fd5b505050565b6125f183836128a1565b6126056125fc611aab565b5f858585611fcb565b505050565b6060600c8054612619906135cf565b80601f0160208091040260200160405190810160405280929190818152602001828054612645906135cf565b80156126905780601f1061266757610100808354040283529160200191612690565b820191905f5260205f20905b81548152906001019060200180831161267357829003601f168201915b5050505050905090565b60606126a5826119ec565b505f6126af61260a565b90505f8151116126cd5760405180602001604052805f8152506126f8565b806126d784612994565b6040516020016126e8929190613f46565b6040516020818303038152906040525b915050919050565b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806127ca57507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806127da57506127d982612a5e565b5b9050919050565b5f5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561289857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480612859575061285884846111d2565b5b8061289757508273ffffffffffffffffffffffffffffffffffffffff1661287f83611a72565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603612911575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016129089190612eb2565b60405180910390fd5b5f61291d83835f611ac4565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161461298f575f6040517f73c6ac6e0000000000000000000000000000000000000000000000000000000081526004016129869190612eb2565b60405180910390fd5b505050565b60605f60016129a284612ac7565b0190505f8167ffffffffffffffff8111156129c0576129bf612fee565b5b6040519080825280601f01601f1916602001820160405280156129f25781602001600182028036833780820191505090505b5090505f82602083010190505b600115612a53578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a8581612a4857612a476136a2565b5b0494505f85036129ff575b819350505050919050565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f5f5f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310612b23577a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008381612b1957612b186136a2565b5b0492506040810190505b6d04ee2d6d415b85acef81000000008310612b60576d04ee2d6d415b85acef81000000008381612b5657612b556136a2565b5b0492506020810190505b662386f26fc100008310612b8f57662386f26fc100008381612b8557612b846136a2565b5b0492506010810190505b6305f5e1008310612bb8576305f5e1008381612bae57612bad6136a2565b5b0492506008810190505b6127108310612bdd576127108381612bd357612bd26136a2565b5b0492506004810190505b60648310612c005760648381612bf657612bf56136a2565b5b0492506002810190505b600a8310612c0f576001810190505b80915050919050565b5f604051905090565b5f5ffd5b5f5ffd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612c5d81612c29565b8114612c67575f5ffd5b50565b5f81359050612c7881612c54565b92915050565b5f60208284031215612c9357612c92612c21565b5b5f612ca084828501612c6a565b91505092915050565b5f8115159050919050565b612cbd81612ca9565b82525050565b5f602082019050612cd65f830184612cb4565b92915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f612d0582612cdc565b9050919050565b612d1581612cfb565b8114612d1f575f5ffd5b50565b5f81359050612d3081612d0c565b92915050565b5f6bffffffffffffffffffffffff82169050919050565b612d5681612d36565b8114612d60575f5ffd5b50565b5f81359050612d7181612d4d565b92915050565b5f5f60408385031215612d8d57612d8c612c21565b5b5f612d9a85828601612d22565b9250506020612dab85828601612d63565b9150509250929050565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f612df782612db5565b612e018185612dbf565b9350612e11818560208601612dcf565b612e1a81612ddd565b840191505092915050565b5f6020820190508181035f830152612e3d8184612ded565b905092915050565b5f819050919050565b612e5781612e45565b8114612e61575f5ffd5b50565b5f81359050612e7281612e4e565b92915050565b5f60208284031215612e8d57612e8c612c21565b5b5f612e9a84828501612e64565b91505092915050565b612eac81612cfb565b82525050565b5f602082019050612ec55f830184612ea3565b92915050565b5f5f60408385031215612ee157612ee0612c21565b5b5f612eee85828601612d22565b9250506020612eff85828601612e64565b9150509250929050565b612f1281612e45565b82525050565b5f602082019050612f2b5f830184612f09565b92915050565b5f5f5f60608486031215612f4857612f47612c21565b5b5f612f5586828701612d22565b9350506020612f6686828701612d22565b9250506040612f7786828701612e64565b9150509250925092565b5f5f60408385031215612f9757612f96612c21565b5b5f612fa485828601612e64565b9250506020612fb585828601612e64565b9150509250929050565b5f604082019050612fd25f830185612ea3565b612fdf6020830184612f09565b9392505050565b5f5ffd5b5f5ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b61302482612ddd565b810181811067ffffffffffffffff8211171561304357613042612fee565b5b80604052505050565b5f613055612c18565b9050613061828261301b565b919050565b5f67ffffffffffffffff8211156130805761307f612fee565b5b61308982612ddd565b9050602081019050919050565b828183375f83830152505050565b5f6130b66130b184613066565b61304c565b9050828152602081018484840111156130d2576130d1612fea565b5b6130dd848285613096565b509392505050565b5f82601f8301126130f9576130f8612fe6565b5b81356131098482602086016130a4565b91505092915050565b5f5f6040838503121561312857613127612c21565b5b5f61313585828601612d22565b925050602083013567ffffffffffffffff81111561315657613155612c25565b5b613162858286016130e5565b9150509250929050565b5f6020828403121561318157613180612c21565b5b5f82013567ffffffffffffffff81111561319e5761319d612c25565b5b6131aa848285016130e5565b91505092915050565b5f602082840312156131c8576131c7612c21565b5b5f6131d584828501612d22565b91505092915050565b6131e781612ca9565b81146131f1575f5ffd5b50565b5f81359050613202816131de565b92915050565b5f5f6040838503121561321e5761321d612c21565b5b5f61322b85828601612d22565b925050602061323c858286016131f4565b9150509250929050565b5f67ffffffffffffffff8211156132605761325f612fee565b5b61326982612ddd565b9050602081019050919050565b5f61328861328384613246565b61304c565b9050828152602081018484840111156132a4576132a3612fea565b5b6132af848285613096565b509392505050565b5f82601f8301126132cb576132ca612fe6565b5b81356132db848260208601613276565b91505092915050565b5f5f5f5f608085870312156132fc576132fb612c21565b5b5f61330987828801612d22565b945050602061331a87828801612d22565b935050604061332b87828801612e64565b925050606085013567ffffffffffffffff81111561334c5761334b612c25565b5b613358878288016132b7565b91505092959194509250565b5f5f6040838503121561337a57613379612c21565b5b5f61338785828601612d22565b925050602061339885828601612d22565b9150509250929050565b5f67ffffffffffffffff8211156133bc576133bb612fee565b5b602082029050602081019050919050565b5f5ffd5b5f6133e36133de846133a2565b61304c565b90508083825260208201905060208402830185811115613406576134056133cd565b5b835b8181101561344d57803567ffffffffffffffff81111561342b5761342a612fe6565b5b80860161343889826130e5565b85526020850194505050602081019050613408565b5050509392505050565b5f82601f83011261346b5761346a612fe6565b5b813561347b8482602086016133d1565b91505092915050565b5f6020828403121561349957613498612c21565b5b5f82013567ffffffffffffffff8111156134b6576134b5612c25565b5b6134c284828501613457565b91505092915050565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b6134fd81612e45565b82525050565b5f61350e83836134f4565b60208301905092915050565b5f602082019050919050565b5f613530826134cb565b61353a81856134d5565b9350613545836134e5565b805f5b8381101561357557815161355c8882613503565b97506135678361351a565b925050600181019050613548565b5085935050505092915050565b5f6020820190508181035f83015261359a8184613526565b905092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806135e657607f821691505b6020821081036135f9576135f86135a2565b5b50919050565b5f6060820190506136125f830186612ea3565b61361f6020830185612f09565b61362c6040830184612ea3565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61366b82612e45565b915061367683612e45565b925082820261368481612e45565b9150828204841483151761369b5761369a613634565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f6136d982612e45565b91506136e483612e45565b9250826136f4576136f36136a2565b5b828204905092915050565b7f4e6f2062616c616e636520746f207769746864726177000000000000000000005f82015250565b5f613733601683612dbf565b915061373e826136ff565b602082019050919050565b5f6020820190508181035f83015261376081613727565b9050919050565b5f81905092915050565b50565b5f61377f5f83613767565b915061378a82613771565b5f82019050919050565b5f61379e82613774565b9150819050919050565b7f5769746864726177206661696c656400000000000000000000000000000000005f82015250565b5f6137dc600f83612dbf565b91506137e7826137a8565b602082019050919050565b5f6020820190508181035f830152613809816137d0565b9050919050565b7f4d617820737570706c79207265616368656400000000000000000000000000005f82015250565b5f613844601283612dbf565b915061384f82613810565b602082019050919050565b5f6020820190508181035f83015261387181613838565b9050919050565b5f61388282612e45565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036138b4576138b3613634565b5b600182019050919050565b5f819050919050565b5f819050919050565b5f6138eb6138e66138e1846138bf565b6138c8565b612e45565b9050919050565b6138fb816138d1565b82525050565b5f6020820190506139145f8301846138f2565b92915050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026139767fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261393b565b613980868361393b565b95508019841693508086168417925050509392505050565b5f6139b26139ad6139a884612e45565b6138c8565b612e45565b9050919050565b5f819050919050565b6139cb83613998565b6139df6139d7826139b9565b848454613947565b825550505050565b5f5f905090565b6139f66139e7565b613a018184846139c2565b505050565b5b81811015613a2457613a195f826139ee565b600181019050613a07565b5050565b601f821115613a6957613a3a8161391a565b613a438461392c565b81016020851015613a52578190505b613a66613a5e8561392c565b830182613a06565b50505b505050565b5f82821c905092915050565b5f613a895f1984600802613a6e565b1980831691505092915050565b5f613aa18383613a7a565b9150826002028217905092915050565b613aba82612db5565b67ffffffffffffffff811115613ad357613ad2612fee565b5b613add82546135cf565b613ae8828285613a28565b5f60209050601f831160018114613b19575f8415613b07578287015190505b613b118582613a96565b865550613b78565b601f198416613b278661391a565b5f5b82811015613b4e57848901518255600182019150602085019450602081019050613b29565b86831015613b6b5784890151613b67601f891682613a7a565b8355505b6001600288020188555050505b505050505050565b7f496e73756666696369656e74207061796d656e740000000000000000000000005f82015250565b5f613bb4601483612dbf565b9150613bbf82613b80565b602082019050919050565b5f6020820190508181035f830152613be181613ba8565b9050919050565b5f613bf282612e45565b9150613bfd83612e45565b9250828203905081811115613c1557613c14613634565b5b92915050565b7f5472616e73666572206661696c656400000000000000000000000000000000005f82015250565b5f613c4f600f83612dbf565b9150613c5a82613c1b565b602082019050919050565b5f6020820190508181035f830152613c7c81613c43565b9050919050565b5f613c8d82612e45565b9150613c9883612e45565b9250828201905080821115613cb057613caf613634565b5b92915050565b7f526566756e64206661696c6564000000000000000000000000000000000000005f82015250565b5f613cea600d83612dbf565b9150613cf582613cb6565b602082019050919050565b5f6020820190508181035f830152613d1781613cde565b9050919050565b7f496e76616c6964207175616e74697479000000000000000000000000000000005f82015250565b5f613d52601083612dbf565b9150613d5d82613d1e565b602082019050919050565b5f6020820190508181035f830152613d7f81613d46565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b5f604082019050613dc65f830185612f09565b613dd36020830184612f09565b9392505050565b5f613df4613def613dea84612d36565b6138c8565b612e45565b9050919050565b613e0481613dda565b82525050565b5f604082019050613e1d5f830185613dfb565b613e2a6020830184612f09565b9392505050565b5f81519050919050565b5f82825260208201905092915050565b5f613e5582613e31565b613e5f8185613e3b565b9350613e6f818560208601612dcf565b613e7881612ddd565b840191505092915050565b5f608082019050613e965f830187612ea3565b613ea36020830186612ea3565b613eb06040830185612f09565b8181036060830152613ec28184613e4b565b905095945050505050565b5f81519050613edb81612c54565b92915050565b5f60208284031215613ef657613ef5612c21565b5b5f613f0384828501613ecd565b91505092915050565b5f81905092915050565b5f613f2082612db5565b613f2a8185613f0c565b9350613f3a818560208601612dcf565b80840191505092915050565b5f613f518285613f16565b9150613f5d8284613f16565b9150819050939250505056fe31302c3030302068616e642d647261776e204e46547320696e737069726564206279206d666572732c206d65676170757272732026206d6670757272732e205261772c2066756e6e792c20616e642070726f75646c79206261736564202d206275696c7420666f7220746865206f6e65732077686f206b656570206275696c64696e672ea264697066735822122077f15fc296ae4378e3139e590e65bbae1f737a38f94c687ba98ca1841b6f0c7464736f6c634300081e0033000000000000000000000000000000000000000000000000000206697785a000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001f40000000000000000000000000000000000000000000000000000000000000036697066733a2f2f516d647246625439687233636851547267433232715169426d474a7238347034793169445758667666554a395a542f00000000000000000000
Deployed Bytecode
0x6080604052600436106101c1575f3560e01c806370a08231116100f6578063c87b56dd11610094578063e985e9c511610063578063e985e9c51461062e578063f09dfbe91461066a578063f2fde38b1461069a578063f4a0a528146106c2576101c1565b8063c87b56dd1461056e578063d5abeb01146105aa578063d85d3d27146105d4578063e2c6875c14610604576101c1565b806395d89b41116100d057806395d89b41146104ca578063a22cb465146104f4578063b88d4fde1461051c578063bedcf00314610544576101c1565b806370a082311461044e578063715018a61461048a5780638da5cb5b146104a0576101c1565b80632a55205a1161016357806342842e0e1161013d57806342842e0e1461039857806355f804b3146103c05780636352211e146103e85780636817c76c14610424576101c1565b80632a55205a146103095780633ccfd60b1461034657806341d5b8031461035c576101c1565b8063081812fc1161019f578063081812fc14610253578063095ea7b31461028f57806318160ddd146102b757806323b872dd146102e1576101c1565b806301ffc9a7146101c557806302fa7c471461020157806306fdde0314610229575b5f5ffd5b3480156101d0575f5ffd5b506101eb60048036038101906101e69190612c7e565b6106ea565b6040516101f89190612cc3565b60405180910390f35b34801561020c575f5ffd5b5061022760048036038101906102229190612d77565b6106fb565b005b348015610234575f5ffd5b5061023d610711565b60405161024a9190612e25565b60405180910390f35b34801561025e575f5ffd5b5061027960048036038101906102749190612e78565b6107a0565b6040516102869190612eb2565b60405180910390f35b34801561029a575f5ffd5b506102b560048036038101906102b09190612ecb565b6107bb565b005b3480156102c2575f5ffd5b506102cb6107d1565b6040516102d89190612f18565b60405180910390f35b3480156102ec575f5ffd5b5061030760048036038101906103029190612f31565b6107da565b005b348015610314575f5ffd5b5061032f600480360381019061032a9190612f81565b6108d9565b60405161033d929190612fbf565b60405180910390f35b348015610351575f5ffd5b5061035a6109fb565b005b348015610367575f5ffd5b50610382600480360381019061037d9190613112565b610b6a565b60405161038f9190612f18565b60405180910390f35b3480156103a3575f5ffd5b506103be60048036038101906103b99190612f31565b610c4f565b005b3480156103cb575f5ffd5b506103e660048036038101906103e1919061316c565b610c6e565b005b3480156103f3575f5ffd5b5061040e60048036038101906104099190612e78565b610cc0565b60405161041b9190612eb2565b60405180910390f35b34801561042f575f5ffd5b50610438610cd1565b6040516104459190612f18565b60405180910390f35b348015610459575f5ffd5b50610474600480360381019061046f91906131b3565b610cd7565b6040516104819190612f18565b60405180910390f35b348015610495575f5ffd5b5061049e610d8d565b005b3480156104ab575f5ffd5b506104b4610da0565b6040516104c19190612eb2565b60405180910390f35b3480156104d5575f5ffd5b506104de610dc8565b6040516104eb9190612e25565b60405180910390f35b3480156104ff575f5ffd5b5061051a60048036038101906105159190613208565b610e58565b005b348015610527575f5ffd5b50610542600480360381019061053d91906132e4565b610e6e565b005b34801561054f575f5ffd5b50610558610e93565b6040516105659190612f18565b60405180910390f35b348015610579575f5ffd5b50610594600480360381019061058f9190612e78565b610e99565b6040516105a19190612e25565b60405180910390f35b3480156105b5575f5ffd5b506105be610eab565b6040516105cb9190612f18565b60405180910390f35b6105ee60048036038101906105e9919061316c565b610eb1565b6040516105fb9190612f18565b60405180910390f35b34801561060f575f5ffd5b506106186111b6565b6040516106259190612e25565b60405180910390f35b348015610639575f5ffd5b50610654600480360381019061064f9190613364565b6111d2565b6040516106619190612cc3565b60405180910390f35b610684600480360381019061067f9190613484565b611260565b6040516106919190613582565b60405180910390f35b3480156106a5575f5ffd5b506106c060048036038101906106bb91906131b3565b61167b565b005b3480156106cd575f5ffd5b506106e860048036038101906106e39190612e78565b6116ff565b005b5f6106f482611751565b9050919050565b6107036117ca565b61070d8282611851565b5050565b60605f805461071f906135cf565b80601f016020809104026020016040519081016040528092919081815260200182805461074b906135cf565b80156107965780601f1061076d57610100808354040283529160200191610796565b820191905f5260205f20905b81548152906001019060200180831161077957829003601f168201915b5050505050905090565b5f6107aa826119ec565b506107b482611a72565b9050919050565b6107cd82826107c8611aab565b611ab2565b5050565b5f600d54905090565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff160361084a575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016108419190612eb2565b60405180910390fd5b5f61085d8383610858611aab565b611ac4565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146108d3578382826040517f64283d7b0000000000000000000000000000000000000000000000000000000081526004016108ca939291906135ff565b60405180910390fd5b50505050565b5f5f5f60085f8681526020019081526020015f2090505f815f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690505f825f0160149054906101000a90046bffffffffffffffffffffffff1690505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036109ad5760075f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16915060075f0160149054906101000a90046bffffffffffffffffffffffff1690505b5f6109b6611ccf565b6bffffffffffffffffffffffff16826bffffffffffffffffffffffff16886109de9190613661565b6109e891906136cf565b9050828195509550505050509250929050565b610a036117ca565b610a0b611cd8565b5f600e5490505f8111610a53576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a4a90613749565b60405180910390fd5b5f600e819055505f610a63610da0565b73ffffffffffffffffffffffffffffffffffffffff1682604051610a8690613794565b5f6040518083038185875af1925050503d805f8114610ac0576040519150601f19603f3d011682016040523d82523d5f602084013e610ac5565b606091505b5050905080610b09576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610b00906137f2565b60405180910390fd5b610b11610da0565b73ffffffffffffffffffffffffffffffffffffffff167f7084f5476618d8e60b11ef0d7d3f06914655adb8793e28ff7f018d4c76d505d583604051610b569190612f18565b60405180910390a25050610b68611d1e565b565b5f610b736117ca565b5f6127101480610b865750612710600d54105b610bc5576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610bbc9061385a565b60405180910390fd5b600d5f815480929190610bd790613878565b91905055505f600d549050610bec8482611d28565b610bf68184611d45565b808473ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff5f604051610c3d9190613901565b60405180910390a38091505092915050565b610c6983838360405180602001604052805f815250610e6e565b505050565b610c766117ca565b80600c9081610c859190613ab1565b507f6741b2fc379fad678116fe3d4d4b9a1a184ab53ba36b86ad0fa66340b1ab41ad81604051610cb59190612e25565b60405180910390a150565b5f610cca826119ec565b9050919050565b600b5481565b5f5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610d48575f6040517f89c62b64000000000000000000000000000000000000000000000000000000008152600401610d3f9190612eb2565b60405180910390fd5b60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610d956117ca565b610d9e5f611d9f565b565b5f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060018054610dd7906135cf565b80601f0160208091040260200160405190810160405280929190818152602001828054610e03906135cf565b8015610e4e5780601f10610e2557610100808354040283529160200191610e4e565b820191905f5260205f20905b815481529060010190602001808311610e3157829003601f168201915b5050505050905090565b610e6a610e63611aab565b8383611e62565b5050565b610e798484846107da565b610e8d610e84611aab565b85858585611fcb565b50505050565b600e5481565b6060610ea482612177565b9050919050565b61271081565b5f610eba611cd8565b600b54341015610eff576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610ef690613bca565b60405180910390fd5b612710600d5410610f45576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f3c9061385a565b60405180910390fd5b600d5f815480929190610f5790613878565b91905055505f600d549050610f6c3382611d28565b610f768184611d45565b5f600b541115611154575f6127106103e8600b54610f949190613661565b610f9e91906136cf565b90505f81600b54610faf9190613be8565b90505f82111561106f575f610fc2612282565b90505f8173ffffffffffffffffffffffffffffffffffffffff1684604051610fe990613794565b5f6040518083038185875af1925050503d805f8114611023576040519150601f19603f3d011682016040523d82523d5f602084013e611028565b606091505b505090508061106c576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161106390613c65565b60405180910390fd5b50505b5f8111156110905780600e5f8282546110889190613c83565b925050819055505b600b54341115611151575f3373ffffffffffffffffffffffffffffffffffffffff16600b54346110c09190613be8565b6040516110cc90613794565b5f6040518083038185875af1925050503d805f8114611106576040519150601f19603f3d011682016040523d82523d5f602084013e61110b565b606091505b505090508061114f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161114690613d00565b60405180910390fd5b505b50505b803373ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff600b5460405161119d9190612f18565b60405180910390a3809150506111b1611d1e565b919050565b6040518060c0016040528060848152602001613f6a6084913981565b5f60055f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b606061126a611cd8565b5f825190505f81116112b1576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112a890613d68565b60405180910390fd5b80600b546112bf9190613661565b341015611301576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112f890613bca565b60405180910390fd5b5f6127101480611320575061271081600d5461131d9190613c83565b11155b61135f576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113569061385a565b60405180910390fd5b5f8167ffffffffffffffff81111561137a57611379612fee565b5b6040519080825280602002602001820160405280156113a85781602001602082028036833780820191505090505b5090505f5f90505b8281101561148257600d5f8154809291906113ca90613878565b91905055505f600d5490506113df3382611d28565b611403818784815181106113f6576113f5613d86565b5b6020026020010151611d45565b8083838151811061141757611416613d86565b5b602002602001018181525050803373ffffffffffffffffffffffffffffffffffffffff167f25b428dfde728ccfaddad7e29e4ac23c24ed7fd1a6e3e3f91894a9a073f5dfff600b5460405161146c9190612f18565b60405180910390a35080806001019150506113b0565b505f82600b546114929190613661565b90505f811115611668575f6127106103e8836114ae9190613661565b6114b891906136cf565b90505f81836114c79190613be8565b90505f821115611587575f6114da612282565b90505f8173ffffffffffffffffffffffffffffffffffffffff168460405161150190613794565b5f6040518083038185875af1925050503d805f811461153b576040519150601f19603f3d011682016040523d82523d5f602084013e611540565b606091505b5050905080611584576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161157b90613c65565b60405180910390fd5b50505b5f8111156115a85780600e5f8282546115a09190613c83565b925050819055505b82341115611665575f3373ffffffffffffffffffffffffffffffffffffffff1684346115d49190613be8565b6040516115e090613794565b5f6040518083038185875af1925050503d805f811461161a576040519150601f19603f3d011682016040523d82523d5f602084013e61161f565b606091505b5050905080611663576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161165a90613d00565b60405180910390fd5b505b50505b819350505050611676611d1e565b919050565b6116836117ca565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036116f3575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016116ea9190612eb2565b60405180910390fd5b6116fc81611d9f565b50565b6117076117ca565b5f600b54905081600b819055507f2e1c9e000c6e8dda4d03536adb13b7cb6034ccff90d17f01de381e4d5097b5258183604051611745929190613db3565b60405180910390a15050565b5f7f2a55205a000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806117c357506117c2826122cc565b5b9050919050565b6117d2611aab565b73ffffffffffffffffffffffffffffffffffffffff166117f0610da0565b73ffffffffffffffffffffffffffffffffffffffff161461184f57611813611aab565b6040517f118cdaa70000000000000000000000000000000000000000000000000000000081526004016118469190612eb2565b60405180910390fd5b565b5f61185a611ccf565b6bffffffffffffffffffffffff16905080826bffffffffffffffffffffffff1611156118bf5781816040517f6f483d090000000000000000000000000000000000000000000000000000000081526004016118b6929190613e0a565b60405180910390fd5b5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160361192f575f6040517fb6d9900a0000000000000000000000000000000000000000000000000000000081526004016119269190612eb2565b60405180910390fd5b60405180604001604052808473ffffffffffffffffffffffffffffffffffffffff168152602001836bffffffffffffffffffffffff1681525060075f820151815f015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506020820151815f0160146101000a8154816bffffffffffffffffffffffff02191690836bffffffffffffffffffffffff160217905550905050505050565b5f5f6119f78361232c565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603611a6957826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611a609190612f18565b60405180910390fd5b80915050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b611abf8383836001612365565b505050565b5f5f611acf8461232c565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614611b1057611b0f818486612524565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611b9b57611b4f5f855f5f612365565b600160035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1614611c1a57600160035f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460025f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f612710905090565b6002600a5403611d14576040517f3ee5aeb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6002600a81905550565b6001600a81905550565b611d41828260405180602001604052805f8152506125e7565b5050565b8060065f8481526020019081526020015f209081611d639190613ab1565b507ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce782604051611d939190612f18565b60405180910390a15050565b5f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160095f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611ed257816040517f5b08ba18000000000000000000000000000000000000000000000000000000008152600401611ec99190612eb2565b60405180910390fd5b8060055f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3183604051611fbe9190612cc3565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115612170578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b81526004016120299493929190613e83565b6020604051808303815f875af192505050801561206457506040513d601f19601f820116820180604052508101906120619190613ee1565b60015b6120e5573d805f8114612092576040519150601f19603f3d011682016040523d82523d5f602084013e612097565b606091505b505f8151036120dd57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016120d49190612eb2565b60405180910390fd5b805160208201fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461216e57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016121659190612eb2565b60405180910390fd5b505b5050505050565b6060612182826119ec565b505f60065f8481526020019081526020015f2080546121a0906135cf565b80601f01602080910402602001604051908101604052809291908181526020018280546121cc906135cf565b80156122175780601f106121ee57610100808354040283529160200191612217565b820191905f5260205f20905b8154815290600101906020018083116121fa57829003601f168201915b505050505090505f61222761260a565b90505f81510361223b57819250505061227d565b5f8251111561226f578082604051602001612257929190613f46565b6040516020818303038152906040529250505061227d565b6122788461269a565b925050505b919050565b5f738a2f1e4c7b39d6a5e8f1c2b4a7d9e3f6c5b1a89773bd4a61d7e56f6c846aff8e3d125e4e16e943ed4d18905073ffffffffffffffffffffffffffffffffffffffff8116905090565b5f634906490660e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161480612325575061232482612700565b5b9050919050565b5f60025f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061239d57505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b156124cf575f6123ac846119ec565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561241657508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b8015612429575061242781846111d2565b155b1561246b57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016124629190612eb2565b60405180910390fd5b81156124cd57838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360045f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b61252f8383836127e1565b6125e2575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16036125a357806040517f7e27328900000000000000000000000000000000000000000000000000000000815260040161259a9190612f18565b60405180910390fd5b81816040517f177e802f0000000000000000000000000000000000000000000000000000000081526004016125d9929190612fbf565b60405180910390fd5b505050565b6125f183836128a1565b6126056125fc611aab565b5f858585611fcb565b505050565b6060600c8054612619906135cf565b80601f0160208091040260200160405190810160405280929190818152602001828054612645906135cf565b80156126905780601f1061266757610100808354040283529160200191612690565b820191905f5260205f20905b81548152906001019060200180831161267357829003601f168201915b5050505050905090565b60606126a5826119ec565b505f6126af61260a565b90505f8151116126cd5760405180602001604052805f8152506126f8565b806126d784612994565b6040516020016126e8929190613f46565b6040516020818303038152906040525b915050919050565b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806127ca57507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806127da57506127d982612a5e565b5b9050919050565b5f5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561289857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480612859575061285884846111d2565b5b8061289757508273ffffffffffffffffffffffffffffffffffffffff1661287f83611a72565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603612911575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016129089190612eb2565b60405180910390fd5b5f61291d83835f611ac4565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff161461298f575f6040517f73c6ac6e0000000000000000000000000000000000000000000000000000000081526004016129869190612eb2565b60405180910390fd5b505050565b60605f60016129a284612ac7565b0190505f8167ffffffffffffffff8111156129c0576129bf612fee565b5b6040519080825280601f01601f1916602001820160405280156129f25781602001600182028036833780820191505090505b5090505f82602083010190505b600115612a53578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a8581612a4857612a476136a2565b5b0494505f85036129ff575b819350505050919050565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f5f5f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310612b23577a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008381612b1957612b186136a2565b5b0492506040810190505b6d04ee2d6d415b85acef81000000008310612b60576d04ee2d6d415b85acef81000000008381612b5657612b556136a2565b5b0492506020810190505b662386f26fc100008310612b8f57662386f26fc100008381612b8557612b846136a2565b5b0492506010810190505b6305f5e1008310612bb8576305f5e1008381612bae57612bad6136a2565b5b0492506008810190505b6127108310612bdd576127108381612bd357612bd26136a2565b5b0492506004810190505b60648310612c005760648381612bf657612bf56136a2565b5b0492506002810190505b600a8310612c0f576001810190505b80915050919050565b5f604051905090565b5f5ffd5b5f5ffd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612c5d81612c29565b8114612c67575f5ffd5b50565b5f81359050612c7881612c54565b92915050565b5f60208284031215612c9357612c92612c21565b5b5f612ca084828501612c6a565b91505092915050565b5f8115159050919050565b612cbd81612ca9565b82525050565b5f602082019050612cd65f830184612cb4565b92915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f612d0582612cdc565b9050919050565b612d1581612cfb565b8114612d1f575f5ffd5b50565b5f81359050612d3081612d0c565b92915050565b5f6bffffffffffffffffffffffff82169050919050565b612d5681612d36565b8114612d60575f5ffd5b50565b5f81359050612d7181612d4d565b92915050565b5f5f60408385031215612d8d57612d8c612c21565b5b5f612d9a85828601612d22565b9250506020612dab85828601612d63565b9150509250929050565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f612df782612db5565b612e018185612dbf565b9350612e11818560208601612dcf565b612e1a81612ddd565b840191505092915050565b5f6020820190508181035f830152612e3d8184612ded565b905092915050565b5f819050919050565b612e5781612e45565b8114612e61575f5ffd5b50565b5f81359050612e7281612e4e565b92915050565b5f60208284031215612e8d57612e8c612c21565b5b5f612e9a84828501612e64565b91505092915050565b612eac81612cfb565b82525050565b5f602082019050612ec55f830184612ea3565b92915050565b5f5f60408385031215612ee157612ee0612c21565b5b5f612eee85828601612d22565b9250506020612eff85828601612e64565b9150509250929050565b612f1281612e45565b82525050565b5f602082019050612f2b5f830184612f09565b92915050565b5f5f5f60608486031215612f4857612f47612c21565b5b5f612f5586828701612d22565b9350506020612f6686828701612d22565b9250506040612f7786828701612e64565b9150509250925092565b5f5f60408385031215612f9757612f96612c21565b5b5f612fa485828601612e64565b9250506020612fb585828601612e64565b9150509250929050565b5f604082019050612fd25f830185612ea3565b612fdf6020830184612f09565b9392505050565b5f5ffd5b5f5ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b61302482612ddd565b810181811067ffffffffffffffff8211171561304357613042612fee565b5b80604052505050565b5f613055612c18565b9050613061828261301b565b919050565b5f67ffffffffffffffff8211156130805761307f612fee565b5b61308982612ddd565b9050602081019050919050565b828183375f83830152505050565b5f6130b66130b184613066565b61304c565b9050828152602081018484840111156130d2576130d1612fea565b5b6130dd848285613096565b509392505050565b5f82601f8301126130f9576130f8612fe6565b5b81356131098482602086016130a4565b91505092915050565b5f5f6040838503121561312857613127612c21565b5b5f61313585828601612d22565b925050602083013567ffffffffffffffff81111561315657613155612c25565b5b613162858286016130e5565b9150509250929050565b5f6020828403121561318157613180612c21565b5b5f82013567ffffffffffffffff81111561319e5761319d612c25565b5b6131aa848285016130e5565b91505092915050565b5f602082840312156131c8576131c7612c21565b5b5f6131d584828501612d22565b91505092915050565b6131e781612ca9565b81146131f1575f5ffd5b50565b5f81359050613202816131de565b92915050565b5f5f6040838503121561321e5761321d612c21565b5b5f61322b85828601612d22565b925050602061323c858286016131f4565b9150509250929050565b5f67ffffffffffffffff8211156132605761325f612fee565b5b61326982612ddd565b9050602081019050919050565b5f61328861328384613246565b61304c565b9050828152602081018484840111156132a4576132a3612fea565b5b6132af848285613096565b509392505050565b5f82601f8301126132cb576132ca612fe6565b5b81356132db848260208601613276565b91505092915050565b5f5f5f5f608085870312156132fc576132fb612c21565b5b5f61330987828801612d22565b945050602061331a87828801612d22565b935050604061332b87828801612e64565b925050606085013567ffffffffffffffff81111561334c5761334b612c25565b5b613358878288016132b7565b91505092959194509250565b5f5f6040838503121561337a57613379612c21565b5b5f61338785828601612d22565b925050602061339885828601612d22565b9150509250929050565b5f67ffffffffffffffff8211156133bc576133bb612fee565b5b602082029050602081019050919050565b5f5ffd5b5f6133e36133de846133a2565b61304c565b90508083825260208201905060208402830185811115613406576134056133cd565b5b835b8181101561344d57803567ffffffffffffffff81111561342b5761342a612fe6565b5b80860161343889826130e5565b85526020850194505050602081019050613408565b5050509392505050565b5f82601f83011261346b5761346a612fe6565b5b813561347b8482602086016133d1565b91505092915050565b5f6020828403121561349957613498612c21565b5b5f82013567ffffffffffffffff8111156134b6576134b5612c25565b5b6134c284828501613457565b91505092915050565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b6134fd81612e45565b82525050565b5f61350e83836134f4565b60208301905092915050565b5f602082019050919050565b5f613530826134cb565b61353a81856134d5565b9350613545836134e5565b805f5b8381101561357557815161355c8882613503565b97506135678361351a565b925050600181019050613548565b5085935050505092915050565b5f6020820190508181035f83015261359a8184613526565b905092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806135e657607f821691505b6020821081036135f9576135f86135a2565b5b50919050565b5f6060820190506136125f830186612ea3565b61361f6020830185612f09565b61362c6040830184612ea3565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61366b82612e45565b915061367683612e45565b925082820261368481612e45565b9150828204841483151761369b5761369a613634565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f6136d982612e45565b91506136e483612e45565b9250826136f4576136f36136a2565b5b828204905092915050565b7f4e6f2062616c616e636520746f207769746864726177000000000000000000005f82015250565b5f613733601683612dbf565b915061373e826136ff565b602082019050919050565b5f6020820190508181035f83015261376081613727565b9050919050565b5f81905092915050565b50565b5f61377f5f83613767565b915061378a82613771565b5f82019050919050565b5f61379e82613774565b9150819050919050565b7f5769746864726177206661696c656400000000000000000000000000000000005f82015250565b5f6137dc600f83612dbf565b91506137e7826137a8565b602082019050919050565b5f6020820190508181035f830152613809816137d0565b9050919050565b7f4d617820737570706c79207265616368656400000000000000000000000000005f82015250565b5f613844601283612dbf565b915061384f82613810565b602082019050919050565b5f6020820190508181035f83015261387181613838565b9050919050565b5f61388282612e45565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82036138b4576138b3613634565b5b600182019050919050565b5f819050919050565b5f819050919050565b5f6138eb6138e66138e1846138bf565b6138c8565b612e45565b9050919050565b6138fb816138d1565b82525050565b5f6020820190506139145f8301846138f2565b92915050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026139767fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261393b565b613980868361393b565b95508019841693508086168417925050509392505050565b5f6139b26139ad6139a884612e45565b6138c8565b612e45565b9050919050565b5f819050919050565b6139cb83613998565b6139df6139d7826139b9565b848454613947565b825550505050565b5f5f905090565b6139f66139e7565b613a018184846139c2565b505050565b5b81811015613a2457613a195f826139ee565b600181019050613a07565b5050565b601f821115613a6957613a3a8161391a565b613a438461392c565b81016020851015613a52578190505b613a66613a5e8561392c565b830182613a06565b50505b505050565b5f82821c905092915050565b5f613a895f1984600802613a6e565b1980831691505092915050565b5f613aa18383613a7a565b9150826002028217905092915050565b613aba82612db5565b67ffffffffffffffff811115613ad357613ad2612fee565b5b613add82546135cf565b613ae8828285613a28565b5f60209050601f831160018114613b19575f8415613b07578287015190505b613b118582613a96565b865550613b78565b601f198416613b278661391a565b5f5b82811015613b4e57848901518255600182019150602085019450602081019050613b29565b86831015613b6b5784890151613b67601f891682613a7a565b8355505b6001600288020188555050505b505050505050565b7f496e73756666696369656e74207061796d656e740000000000000000000000005f82015250565b5f613bb4601483612dbf565b9150613bbf82613b80565b602082019050919050565b5f6020820190508181035f830152613be181613ba8565b9050919050565b5f613bf282612e45565b9150613bfd83612e45565b9250828203905081811115613c1557613c14613634565b5b92915050565b7f5472616e73666572206661696c656400000000000000000000000000000000005f82015250565b5f613c4f600f83612dbf565b9150613c5a82613c1b565b602082019050919050565b5f6020820190508181035f830152613c7c81613c43565b9050919050565b5f613c8d82612e45565b9150613c9883612e45565b9250828201905080821115613cb057613caf613634565b5b92915050565b7f526566756e64206661696c6564000000000000000000000000000000000000005f82015250565b5f613cea600d83612dbf565b9150613cf582613cb6565b602082019050919050565b5f6020820190508181035f830152613d1781613cde565b9050919050565b7f496e76616c6964207175616e74697479000000000000000000000000000000005f82015250565b5f613d52601083612dbf565b9150613d5d82613d1e565b602082019050919050565b5f6020820190508181035f830152613d7f81613d46565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b5f604082019050613dc65f830185612f09565b613dd36020830184612f09565b9392505050565b5f613df4613def613dea84612d36565b6138c8565b612e45565b9050919050565b613e0481613dda565b82525050565b5f604082019050613e1d5f830185613dfb565b613e2a6020830184612f09565b9392505050565b5f81519050919050565b5f82825260208201905092915050565b5f613e5582613e31565b613e5f8185613e3b565b9350613e6f818560208601612dcf565b613e7881612ddd565b840191505092915050565b5f608082019050613e965f830187612ea3565b613ea36020830186612ea3565b613eb06040830185612f09565b8181036060830152613ec28184613e4b565b905095945050505050565b5f81519050613edb81612c54565b92915050565b5f60208284031215613ef657613ef5612c21565b5b5f613f0384828501613ecd565b91505092915050565b5f81905092915050565b5f613f2082612db5565b613f2a8185613f0c565b9350613f3a818560208601612dcf565b80840191505092915050565b5f613f518285613f16565b9150613f5d8284613f16565b9150819050939250505056fe31302c3030302068616e642d647261776e204e46547320696e737069726564206279206d666572732c206d65676170757272732026206d6670757272732e205261772c2066756e6e792c20616e642070726f75646c79206261736564202d206275696c7420666f7220746865206f6e65732077686f206b656570206275696c64696e672ea264697066735822122077f15fc296ae4378e3139e590e65bbae1f737a38f94c687ba98ca1841b6f0c7464736f6c634300081e0033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000000000000000000000000000000206697785a000000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001f40000000000000000000000000000000000000000000000000000000000000036697066733a2f2f516d647246625439687233636851547267433232715169426d474a7238347034793169445758667666554a395a542f00000000000000000000
-----Decoded View---------------
Arg [0] : mintPrice_ (uint256): 570000000000000
Arg [1] : baseURI_ (string): ipfs://QmdrFbT9hr3chQTrgC22qQiBmGJr84p4y1iDWXfvfUJ9ZT/
Arg [2] : royaltyFee_ (uint96): 500
-----Encoded View---------------
6 Constructor Arguments found :
Arg [0] : 000000000000000000000000000000000000000000000000000206697785a000
Arg [1] : 0000000000000000000000000000000000000000000000000000000000000060
Arg [2] : 00000000000000000000000000000000000000000000000000000000000001f4
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000036
Arg [4] : 697066733a2f2f516d647246625439687233636851547267433232715169426d
Arg [5] : 474a7238347034793169445758667666554a395a542f00000000000000000000
Deployed Bytecode Sourcemap
1749:8196:22:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;9729:214;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;8286:141;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;2263:89:6;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3299:154;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3152:113;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;9011:94:22;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3852:578:6;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;2330:657:12;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;;:::i;:::-;;;;;;;;8496:328:22;;;;;;;;;;;;;:::i;:::-;;7253:394;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;4464:132:6;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;8083:149:22;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;2103:118:6;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2000:24:22;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;1861:208:6;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2293:101:0;;;;;;;;;;;;;:::i;:::-;;1638:85;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2394:93:6;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3487:144;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;4630:233;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;2542:27:22;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;9479:189;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2071:41;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;4190:1278;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2158:181;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3665:153:6;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;5513:1661:22;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2543:215:0;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;7848:185:22;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;9729:214;9873:4;9900:36;9924:11;9900:23;:36::i;:::-;9893:43;;9729:214;;;:::o;8286:141::-;1531:13:0;:11;:13::i;:::-;8378:42:22::1;8397:8;8407:12;8378:18;:42::i;:::-;8286:141:::0;;:::o;2263:89:6:-;2308:13;2340:5;2333:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2263:89;:::o;3299:154::-;3366:7;3385:22;3399:7;3385:13;:22::i;:::-;;3425:21;3438:7;3425:12;:21::i;:::-;3418:28;;3299:154;;;:::o;3152:113::-;3223:35;3232:2;3236:7;3245:12;:10;:12::i;:::-;3223:8;:35::i;:::-;3152:113;;:::o;9011:94:22:-;9057:7;9083:15;;9076:22;;9011:94;:::o;3852:578:6:-;3960:1;3946:16;;:2;:16;;;3942:87;;4015:1;3985:33;;;;;;;;;;;:::i;:::-;;;;;;;;3942:87;4247:21;4271:34;4279:2;4283:7;4292:12;:10;:12::i;:::-;4271:7;:34::i;:::-;4247:58;;4336:4;4319:21;;:13;:21;;;4315:109;;4384:4;4390:7;4399:13;4363:50;;;;;;;;;;;;;:::i;:::-;;;;;;;;4315:109;3932:498;3852:578;;;:::o;2330:657:12:-;2438:16;2456:14;2482:32;2517:17;:26;2535:7;2517:26;;;;;;;;;;;2482:61;;2553:23;2579:12;:21;;;;;;;;;;;;2553:47;;2610:22;2635:12;:28;;;;;;;;;;;;2610:53;;2705:1;2678:29;;:15;:29;;;2674:173;;2741:19;:28;;;;;;;;;;;;2723:46;;2801:19;:35;;;;;;;;;;;;2783:53;;2674:173;2857:21;2913:17;:15;:17::i;:::-;2881:49;;2894:15;2882:27;;:9;:27;;;;:::i;:::-;2881:49;;;;:::i;:::-;2857:73;;2949:15;2966:13;2941:39;;;;;;;;2330:657;;;;;:::o;8496:328:22:-;1531:13:0;:11;:13::i;:::-;2500:21:15::1;:19;:21::i;:::-;8558:14:22::2;8575:12;;8558:29;;8614:1;8605:6;:10;8597:45;;;;;;;;;;;;:::i;:::-;;;;;;;;;8668:1;8653:12;:16;;;;8681:12;8699:7;:5;:7::i;:::-;:12;;8719:6;8699:31;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8680:50;;;8748:7;8740:35;;;;;;;;;;;;:::i;:::-;;;;;;;;;8801:7;:5;:7::i;:::-;8791:26;;;8810:6;8791:26;;;;;;:::i;:::-;;;;;;;;8548:276;;2542:20:15::1;:18;:20::i;:::-;8496:328:22:o:0;7253:394::-;7337:7;1531:13:0;:11;:13::i;:::-;7377:1:22::1;2107:5;7364:14;:45;;;;2107:5;7382:15;;:27;7364:45;7356:76;;;;;;;;;;;;:::i;:::-;;;;;;;;;7443:15;;:17;;;;;;;;;:::i;:::-;;;;;;7470:15;7488;;7470:33;;7514:22;7524:2;7528:7;7514:9;:22::i;:::-;7546:32;7559:7;7568:9;7546:12;:32::i;:::-;7605:7;7601:2;7594:22;;;7614:1;7594:22;;;;;;:::i;:::-;;;;;;;;7633:7;7626:14;;;7253:394:::0;;;;:::o;4464:132:6:-;4550:39;4567:4;4573:2;4577:7;4550:39;;;;;;;;;;;;:16;:39::i;:::-;4464:132;;;:::o;8083:149:22:-;1531:13:0;:11;:13::i;:::-;8174:10:22::1;8158:13;:26;;;;;;:::i;:::-;;8199;8214:10;8199:26;;;;;;:::i;:::-;;;;;;;;8083:149:::0;:::o;2103:118:6:-;2166:7;2192:22;2206:7;2192:13;:22::i;:::-;2185:29;;2103:118;;;:::o;2000:24:22:-;;;;:::o;1861:208:6:-;1924:7;1964:1;1947:19;;:5;:19;;;1943:87;;2016:1;1989:30;;;;;;;;;;;:::i;:::-;;;;;;;;1943:87;2046:9;:16;2056:5;2046:16;;;;;;;;;;;;;;;;2039:23;;1861:208;;;:::o;2293:101:0:-;1531:13;:11;:13::i;:::-;2357:30:::1;2384:1;2357:18;:30::i;:::-;2293:101::o:0;1638:85::-;1684:7;1710:6;;;;;;;;;;;1703:13;;1638:85;:::o;2394:93:6:-;2441:13;2473:7;2466:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2394:93;:::o;3487:144::-;3572:52;3591:12;:10;:12::i;:::-;3605:8;3615;3572:18;:52::i;:::-;3487:144;;:::o;4630:233::-;4743:31;4756:4;4762:2;4766:7;4743:12;:31::i;:::-;4784:72;4818:12;:10;:12::i;:::-;4832:4;4838:2;4842:7;4851:4;4784:33;:72::i;:::-;4630:233;;;;:::o;2542:27:22:-;;;;:::o;9479:189::-;9602:13;9638:23;9653:7;9638:14;:23::i;:::-;9631:30;;9479:189;;;:::o;2071:41::-;2107:5;2071:41;:::o;4190:1278::-;4268:7;2500:21:15;:19;:21::i;:::-;4308:9:22::1;;4295;:22;;4287:55;;;;;;;;;;;;:::i;:::-;;;;;;;;;2107:5;4360:15;;:27;4352:58;;;;;;;;;;;;:::i;:::-;;;;;;;;;4421:15;;:17;;;;;;;;;:::i;:::-;;;;;;4448:15;4466;;4448:33;;4514:30;4524:10;4536:7;4514:9;:30::i;:::-;4554:32;4567:7;4576:9;4554:12;:32::i;:::-;4645:1;4633:9;;:13;4629:755;;;4662:11;4701:5;2810:4;4677:9;;:20;;;;:::i;:::-;4676:30;;;;:::i;:::-;4662:44;;4720:19;4754:3;4742:9;;:15;;;;:::i;:::-;4720:37;;4818:1;4812:3;:7;4808:203;;;4839:17;4859;:15;:17::i;:::-;4839:37;;4895:12;4913:9;:14;;4935:3;4913:30;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4894:49;;;4969:7;4961:35;;;;;;;;;;;;:::i;:::-;;;;;;;;;4821:190;;4808:203;5077:1;5063:11;:15;5059:81;;;5114:11;5098:12;;:27;;;;;;;:::i;:::-;;;;;;;;5059:81;5199:9;;5187;:21;5183:191;;;5229:18;5253:10;:15;;5288:9;;5276;:21;;;;:::i;:::-;5253:49;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;5228:74;;;5328:13;5320:39;;;;;;;;;;;;:::i;:::-;;;;;;;;;5210:164;5183:191;4648:736;;4629:755;5418:7;5406:10;5399:38;;;5427:9;;5399:38;;;;;;:::i;:::-;;;;;;;;5454:7;5447:14;;;2542:20:15::0;:18;:20::i;:::-;4190:1278:22;;;:::o;2158:181::-;;;;;;;;;;;;;;;;;;;:::o;3665:153:6:-;3753:4;3776:18;:25;3795:5;3776:25;;;;;;;;;;;;;;;:35;3802:8;3776:35;;;;;;;;;;;;;;;;;;;;;;;;;3769:42;;3665:153;;;;:::o;5513:1661:22:-;5599:16;2500:21:15;:19;:21::i;:::-;5627:16:22::1;5646:10;:17;5627:36;;5692:1;5681:8;:12;5673:41;;;;;;;;;;;;:::i;:::-;;;;;;;;;5757:8;5745:9;;:20;;;;:::i;:::-;5732:9;:33;;5724:66;;;;;;;;;;;;:::i;:::-;;;;;;;;;5821:1;2107:5;5808:14;:57;;;;2107:5;5844:8;5826:15;;:26;;;;:::i;:::-;:39;;5808:57;5800:88;;;;;;;;;;;;:::i;:::-;;;;;;;;;5899:25;5941:8;5927:23;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;5899:51;;5966:9;5978:1;5966:13;;5961:316;5985:8;5981:1;:12;5961:316;;;6014:15;;:17;;;;;;;;;:::i;:::-;;;;;;6045:15;6063;;6045:33;;6093:30;6103:10;6115:7;6093:9;:30::i;:::-;6137:36;6150:7;6159:10;6170:1;6159:13;;;;;;;;:::i;:::-;;;;;;;;6137:12;:36::i;:::-;6201:7;6187:8;6196:1;6187:11;;;;;;;;:::i;:::-;;;;;;;:21;;;::::0;::::1;6247:7;6235:10;6228:38;;;6256:9;;6228:38;;;;;;:::i;:::-;;;;;;;;6000:277;5995:3;;;;;;;5961:316;;;;6319:20;6354:8;6342:9;;:20;;;;:::i;:::-;6319:43;;6391:1;6376:12;:16;6372:770;;;6408:11;6450:5;2810:4;6423:12;:23;;;;:::i;:::-;6422:33;;;;:::i;:::-;6408:47;;6469:19;6506:3;6491:12;:18;;;;:::i;:::-;6469:40;;6570:1;6564:3;:7;6560:203;;;6591:17;6611;:15;:17::i;:::-;6591:37;;6647:12;6665:9;:14;;6687:3;6665:30;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6646:49;;;6721:7;6713:35;;;;;;;;;;;;:::i;:::-;;;;;;;;;6573:190;;6560:203;6829:1;6815:11;:15;6811:81;;;6866:11;6850:12;;:27;;;;;;;:::i;:::-;;;;;;;;6811:81;6951:12;6939:9;:24;6935:197;;;6984:18;7008:10;:15;;7043:12;7031:9;:24;;;;:::i;:::-;7008:52;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6983:77;;;7086:13;7078:39;;;;;;;;;;;;:::i;:::-;;;;;;;;;6965:167;6935:197;6394:748;;6372:770;7159:8;7152:15;;;;;2542:20:15::0;:18;:20::i;:::-;5513:1661:22;;;:::o;2543:215:0:-;1531:13;:11;:13::i;:::-;2647:1:::1;2627:22;;:8;:22;;::::0;2623:91:::1;;2700:1;2672:31;;;;;;;;;;;:::i;:::-;;;;;;;;2623:91;2723:28;2742:8;2723:18;:28::i;:::-;2543:215:::0;:::o;7848:185:22:-;1531:13:0;:11;:13::i;:::-;7917:16:22::1;7936:9;;7917:28;;7967:8;7955:9;:20;;;;7990:36;8007:8;8017;7990:36;;;;;;;:::i;:::-;;;;;;;;7907:126;7848:185:::0;:::o;2082:213:12:-;2184:4;2222:26;2207:41;;;:11;:41;;;;:81;;;;2252:36;2276:11;2252:23;:36::i;:::-;2207:81;2200:88;;2082:213;;;:::o;1796:162:0:-;1866:12;:10;:12::i;:::-;1855:23;;:7;:5;:7::i;:::-;:23;;;1851:101;;1928:12;:10;:12::i;:::-;1901:40;;;;;;;;;;;:::i;:::-;;;;;;;;1851:101;1796:162::o;3618:507:12:-;3712:19;3734:17;:15;:17::i;:::-;3712:39;;;;3780:11;3765:12;:26;;;3761:173;;;3897:12;3911:11;3868:55;;;;;;;;;;;;:::i;:::-;;;;;;;;3761:173;3967:1;3947:22;;:8;:22;;;3943:108;;4037:1;3992:48;;;;;;;;;;;:::i;:::-;;;;;;;;3943:108;4083:35;;;;;;;;4095:8;4083:35;;;;;;4105:12;4083:35;;;;;4061:19;:57;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;3702:423;3618:507;;:::o;15858:241:6:-;15921:7;15940:13;15956:17;15965:7;15956:8;:17::i;:::-;15940:33;;16004:1;15987:19;;:5;:19;;;15983:88;;16052:7;16029:31;;;;;;;;;;;:::i;:::-;;;;;;;;15983:88;16087:5;16080:12;;;15858:241;;;:::o;5609:127::-;5679:7;5705:15;:24;5721:7;5705:24;;;;;;;;;;;;;;;;;;;;;5698:31;;5609:127;;;:::o;656:96:13:-;709:7;735:10;728:17;;656:96;:::o;14138:120:6:-;14218:33;14227:2;14231:7;14240:4;14246;14218:8;:33::i;:::-;14138:120;;;:::o;8507:795::-;8593:7;8612:12;8627:17;8636:7;8627:8;:17::i;:::-;8612:32;;8720:1;8704:18;;:4;:18;;;8700:86;;8738:37;8755:4;8761;8767:7;8738:16;:37::i;:::-;8700:86;8846:1;8830:18;;:4;:18;;;8826:256;;8946:48;8963:1;8967:7;8984:1;8988:5;8946:8;:48::i;:::-;9056:1;9037:9;:15;9047:4;9037:15;;;;;;;;;;;;;;;;:20;;;;;;;;;;;8826:256;9110:1;9096:16;;:2;:16;;;9092:107;;9173:1;9156:9;:13;9166:2;9156:13;;;;;;;;;;;;;;;;:18;;;;;;;;;;;9092:107;9228:2;9209:7;:16;9217:7;9209:16;;;;;;;;;;;;:21;;;;;;;;;;;;;;;;;;9265:7;9261:2;9246:27;;9255:4;9246:27;;;;;;;;;;;;9291:4;9284:11;;;8507:795;;;;;:::o;3262:95:12:-;3320:6;3345:5;3338:12;;3262:95;:::o;2575:307:15:-;1899:1;2702:7;;:18;2698:86;;2743:30;;;;;;;;;;;;;;2698:86;1899:1;2858:7;:17;;;;2575:307::o;2888:208::-;1857:1;3068:7;:21;;;;2888:208::o;10302:100:6:-;10369:26;10379:2;10383:7;10369:26;;;;;;;;;;;;:9;:26::i;:::-;10302:100;;:::o;1931:167:9:-;2044:9;2022:10;:19;2033:7;2022:19;;;;;;;;;;;:31;;;;;;:::i;:::-;;2068:23;2083:7;2068:23;;;;;;:::i;:::-;;;;;;;;1931:167;;:::o;2912:187:0:-;2985:16;3004:6;;;;;;;;;;;2985:25;;3029:8;3020:6;;:17;;;;;;;;;;;;;;;;;;3083:8;3052:40;;3073:8;3052:40;;;;;;;;;;;;2975:124;2912:187;:::o;15311:312:6:-;15438:1;15418:22;;:8;:22;;;15414:91;;15485:8;15463:31;;;;;;;;;;;:::i;:::-;;;;;;;;15414:91;15552:8;15514:18;:25;15533:5;15514:25;;;;;;;;;;;;;;;:35;15540:8;15514:35;;;;;;;;;;;;;;;;:46;;;;;;;;;;;;;;;;;;15597:8;15575:41;;15590:5;15575:41;;;15607:8;15575:41;;;;;;:::i;:::-;;;;;;;;15311:312;;;:::o;993:926:11:-;1190:1;1173:2;:14;;;:18;1169:744;;;1227:2;1211:36;;;1248:8;1258:4;1264:7;1273:4;1211:67;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;1207:696;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1585:1;1568:6;:13;:18;1564:325;;1708:2;1672:39;;;;;;;;;;;:::i;:::-;;;;;;;;1564:325;1841:6;1835:13;1828:4;1820:6;1816:17;1809:40;1207:696;1335:41;;;1325:51;;;:6;:51;;;;1321:182;;1481:2;1445:39;;;;;;;;;;;:::i;:::-;;;;;;;;1321:182;1279:238;1169:744;993:926;;;;;:::o;1210:593:9:-;1283:13;1308:22;1322:7;1308:13;:22::i;:::-;;1341:23;1367:10;:19;1378:7;1367:19;;;;;;;;;;;1341:45;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1396:18;1417:10;:8;:10::i;:::-;1396:31;;1522:1;1506:4;1500:18;:23;1496:70;;1546:9;1539:16;;;;;;1496:70;1691:1;1671:9;1665:23;:27;1661:95;;;1729:4;1735:9;1715:30;;;;;;;;;:::i;:::-;;;;;;;;;;;;;1708:37;;;;;;1661:95;1773:23;1788:7;1773:14;:23::i;:::-;1766:30;;;;1210:593;;;;:::o;3804:213:22:-;3853:14;3920:2;3916;3912:11;3902:21;;3958:42;3950:6;3946:55;3936:65;;3804:213;:::o;961:207:9:-;1063:4;816:10;809:18;;1086:35;;;:11;:35;;;;:75;;;;1125:36;1149:11;1125:23;:36::i;:::-;1086:75;1079:82;;961:207;;;:::o;5378:115:6:-;5444:7;5470;:16;5478:7;5470:16;;;;;;;;;;;;;;;;;;;;;5463:23;;5378:115;;;:::o;14440:662::-;14600:9;:31;;;;14629:1;14613:18;;:4;:18;;;;14600:31;14596:460;;;14647:13;14663:22;14677:7;14663:13;:22::i;:::-;14647:38;;14829:1;14813:18;;:4;:18;;;;:35;;;;;14844:4;14835:13;;:5;:13;;;;14813:35;:69;;;;;14853:29;14870:5;14877:4;14853:16;:29::i;:::-;14852:30;14813:69;14809:142;;;14931:4;14909:27;;;;;;;;;;;:::i;:::-;;;;;;;;14809:142;14969:9;14965:81;;;15023:7;15019:2;15003:28;;15012:5;15003:28;;;;;;;;;;;;14965:81;14633:423;14596:460;15093:2;15066:15;:24;15082:7;15066:24;;;;;;;;;;;;:29;;;;;;;;;;;;;;;;;;14440:662;;;;:::o;6751:368::-;6863:38;6877:5;6884:7;6893;6863:13;:38::i;:::-;6858:255;;6938:1;6921:19;;:5;:19;;;6917:186;;6990:7;6967:31;;;;;;;;;;;:::i;:::-;;;;;;;;6917:186;7071:7;7080;7044:44;;;;;;;;;;;;:::i;:::-;;;;;;;;6858:255;6751:368;;;:::o;10623:207::-;10717:18;10723:2;10727:7;10717:5;:18::i;:::-;10745:78;10779:12;:10;:12::i;:::-;10801:1;10805:2;10809:7;10818:4;10745:33;:78::i;:::-;10623:207;;;:::o;9303:112:22:-;9363:13;9395;9388:20;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;9303:112;:::o;2529:255:6:-;2593:13;2618:22;2632:7;2618:13;:22::i;:::-;;2651:21;2675:10;:8;:10::i;:::-;2651:34;;2726:1;2708:7;2702:21;:25;:75;;;;;;;;;;;;;;;;;2744:7;2753:18;:7;:16;:18::i;:::-;2730:42;;;;;;;;;:::i;:::-;;;;;;;;;;;;;2702:75;2695:82;;;2529:255;;;:::o;1527:300::-;1629:4;1679:25;1664:40;;;:11;:40;;;;:104;;;;1735:33;1720:48;;;:11;:48;;;;1664:104;:156;;;;1784:36;1808:11;1784:23;:36::i;:::-;1664:156;1645:175;;1527:300;;;:::o;6047:272::-;6150:4;6204:1;6185:21;;:7;:21;;;;:127;;;;;6232:7;6223:16;;:5;:16;;;:52;;;;6243:32;6260:5;6267:7;6243:16;:32::i;:::-;6223:52;:88;;;;6304:7;6279:32;;:21;6292:7;6279:12;:21::i;:::-;:32;;;6223:88;6185:127;6166:146;;6047:272;;;;;:::o;9624:327::-;9705:1;9691:16;;:2;:16;;;9687:87;;9760:1;9730:33;;;;;;;;;;;:::i;:::-;;;;;;;;9687:87;9783:21;9807:32;9815:2;9819:7;9836:1;9807:7;:32::i;:::-;9783:56;;9878:1;9853:27;;:13;:27;;;9849:96;;9931:1;9903:31;;;;;;;;;;;:::i;:::-;;;;;;;;9849:96;9677:274;9624:327;;:::o;1308:634:16:-;1364:13;1413:14;1450:1;1430:17;1441:5;1430:10;:17::i;:::-;:21;1413:38;;1465:20;1499:6;1488:18;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;1465:41;;1520:11;1618:6;1611:4;1603:6;1599:17;1595:30;1588:37;;1652:247;1659:4;1652:247;;;1683:5;;;;;;;;1787:10;1782:2;1775:5;1771:14;1766:32;1761:3;1753:46;1843:2;1834:11;;;;;;:::i;:::-;;;;;1876:1;1867:5;:10;1652:247;1863:21;1652:247;1919:6;1912:13;;;;;1308:634;;;:::o;730:146:17:-;806:4;844:25;829:40;;;:11;:40;;;;822:47;;730:146;;;:::o;29154:916:19:-;29207:7;29226:14;29243:1;29226:18;;29291:8;29282:5;:17;29278:103;;29328:8;29319:17;;;;;;:::i;:::-;;;;;29364:2;29354:12;;;;29278:103;29407:8;29398:5;:17;29394:103;;29444:8;29435:17;;;;;;:::i;:::-;;;;;29480:2;29470:12;;;;29394:103;29523:8;29514:5;:17;29510:103;;29560:8;29551:17;;;;;;:::i;:::-;;;;;29596:2;29586:12;;;;29510:103;29639:7;29630:5;:16;29626:100;;29675:7;29666:16;;;;;;:::i;:::-;;;;;29710:1;29700:11;;;;29626:100;29752:7;29743:5;:16;29739:100;;29788:7;29779:16;;;;;;:::i;:::-;;;;;29823:1;29813:11;;;;29739:100;29865:7;29856:5;:16;29852:100;;29901:7;29892:16;;;;;;:::i;:::-;;;;;29936:1;29926:11;;;;29852:100;29978:7;29969:5;:16;29965:66;;30015:1;30005:11;;;;29965:66;30057:6;30050:13;;;29154:916;;;:::o;7:75:23:-;40:6;73:2;67:9;57:19;;7:75;:::o;88:117::-;197:1;194;187:12;211:117;320:1;317;310:12;334:149;370:7;410:66;403:5;399:78;388:89;;334:149;;;:::o;489:120::-;561:23;578:5;561:23;:::i;:::-;554:5;551:34;541:62;;599:1;596;589:12;541:62;489:120;:::o;615:137::-;660:5;698:6;685:20;676:29;;714:32;740:5;714:32;:::i;:::-;615:137;;;;:::o;758:327::-;816:6;865:2;853:9;844:7;840:23;836:32;833:119;;;871:79;;:::i;:::-;833:119;991:1;1016:52;1060:7;1051:6;1040:9;1036:22;1016:52;:::i;:::-;1006:62;;962:116;758:327;;;;:::o;1091:90::-;1125:7;1168:5;1161:13;1154:21;1143:32;;1091:90;;;:::o;1187:109::-;1268:21;1283:5;1268:21;:::i;:::-;1263:3;1256:34;1187:109;;:::o;1302:210::-;1389:4;1427:2;1416:9;1412:18;1404:26;;1440:65;1502:1;1491:9;1487:17;1478:6;1440:65;:::i;:::-;1302:210;;;;:::o;1518:126::-;1555:7;1595:42;1588:5;1584:54;1573:65;;1518:126;;;:::o;1650:96::-;1687:7;1716:24;1734:5;1716:24;:::i;:::-;1705:35;;1650:96;;;:::o;1752:122::-;1825:24;1843:5;1825:24;:::i;:::-;1818:5;1815:35;1805:63;;1864:1;1861;1854:12;1805:63;1752:122;:::o;1880:139::-;1926:5;1964:6;1951:20;1942:29;;1980:33;2007:5;1980:33;:::i;:::-;1880:139;;;;:::o;2025:109::-;2061:7;2101:26;2094:5;2090:38;2079:49;;2025:109;;;:::o;2140:120::-;2212:23;2229:5;2212:23;:::i;:::-;2205:5;2202:34;2192:62;;2250:1;2247;2240:12;2192:62;2140:120;:::o;2266:137::-;2311:5;2349:6;2336:20;2327:29;;2365:32;2391:5;2365:32;:::i;:::-;2266:137;;;;:::o;2409:472::-;2476:6;2484;2533:2;2521:9;2512:7;2508:23;2504:32;2501:119;;;2539:79;;:::i;:::-;2501:119;2659:1;2684:53;2729:7;2720:6;2709:9;2705:22;2684:53;:::i;:::-;2674:63;;2630:117;2786:2;2812:52;2856:7;2847:6;2836:9;2832:22;2812:52;:::i;:::-;2802:62;;2757:117;2409:472;;;;;:::o;2887:99::-;2939:6;2973:5;2967:12;2957:22;;2887:99;;;:::o;2992:169::-;3076:11;3110:6;3105:3;3098:19;3150:4;3145:3;3141:14;3126:29;;2992:169;;;;:::o;3167:139::-;3256:6;3251:3;3246;3240:23;3297:1;3288:6;3283:3;3279:16;3272:27;3167:139;;;:::o;3312:102::-;3353:6;3404:2;3400:7;3395:2;3388:5;3384:14;3380:28;3370:38;;3312:102;;;:::o;3420:377::-;3508:3;3536:39;3569:5;3536:39;:::i;:::-;3591:71;3655:6;3650:3;3591:71;:::i;:::-;3584:78;;3671:65;3729:6;3724:3;3717:4;3710:5;3706:16;3671:65;:::i;:::-;3761:29;3783:6;3761:29;:::i;:::-;3756:3;3752:39;3745:46;;3512:285;3420:377;;;;:::o;3803:313::-;3916:4;3954:2;3943:9;3939:18;3931:26;;4003:9;3997:4;3993:20;3989:1;3978:9;3974:17;3967:47;4031:78;4104:4;4095:6;4031:78;:::i;:::-;4023:86;;3803:313;;;;:::o;4122:77::-;4159:7;4188:5;4177:16;;4122:77;;;:::o;4205:122::-;4278:24;4296:5;4278:24;:::i;:::-;4271:5;4268:35;4258:63;;4317:1;4314;4307:12;4258:63;4205:122;:::o;4333:139::-;4379:5;4417:6;4404:20;4395:29;;4433:33;4460:5;4433:33;:::i;:::-;4333:139;;;;:::o;4478:329::-;4537:6;4586:2;4574:9;4565:7;4561:23;4557:32;4554:119;;;4592:79;;:::i;:::-;4554:119;4712:1;4737:53;4782:7;4773:6;4762:9;4758:22;4737:53;:::i;:::-;4727:63;;4683:117;4478:329;;;;:::o;4813:118::-;4900:24;4918:5;4900:24;:::i;:::-;4895:3;4888:37;4813:118;;:::o;4937:222::-;5030:4;5068:2;5057:9;5053:18;5045:26;;5081:71;5149:1;5138:9;5134:17;5125:6;5081:71;:::i;:::-;4937:222;;;;:::o;5165:474::-;5233:6;5241;5290:2;5278:9;5269:7;5265:23;5261:32;5258:119;;;5296:79;;:::i;:::-;5258:119;5416:1;5441:53;5486:7;5477:6;5466:9;5462:22;5441:53;:::i;:::-;5431:63;;5387:117;5543:2;5569:53;5614:7;5605:6;5594:9;5590:22;5569:53;:::i;:::-;5559:63;;5514:118;5165:474;;;;;:::o;5645:118::-;5732:24;5750:5;5732:24;:::i;:::-;5727:3;5720:37;5645:118;;:::o;5769:222::-;5862:4;5900:2;5889:9;5885:18;5877:26;;5913:71;5981:1;5970:9;5966:17;5957:6;5913:71;:::i;:::-;5769:222;;;;:::o;5997:619::-;6074:6;6082;6090;6139:2;6127:9;6118:7;6114:23;6110:32;6107:119;;;6145:79;;:::i;:::-;6107:119;6265:1;6290:53;6335:7;6326:6;6315:9;6311:22;6290:53;:::i;:::-;6280:63;;6236:117;6392:2;6418:53;6463:7;6454:6;6443:9;6439:22;6418:53;:::i;:::-;6408:63;;6363:118;6520:2;6546:53;6591:7;6582:6;6571:9;6567:22;6546:53;:::i;:::-;6536:63;;6491:118;5997:619;;;;;:::o;6622:474::-;6690:6;6698;6747:2;6735:9;6726:7;6722:23;6718:32;6715:119;;;6753:79;;:::i;:::-;6715:119;6873:1;6898:53;6943:7;6934:6;6923:9;6919:22;6898:53;:::i;:::-;6888:63;;6844:117;7000:2;7026:53;7071:7;7062:6;7051:9;7047:22;7026:53;:::i;:::-;7016:63;;6971:118;6622:474;;;;;:::o;7102:332::-;7223:4;7261:2;7250:9;7246:18;7238:26;;7274:71;7342:1;7331:9;7327:17;7318:6;7274:71;:::i;:::-;7355:72;7423:2;7412:9;7408:18;7399:6;7355:72;:::i;:::-;7102:332;;;;;:::o;7440:117::-;7549:1;7546;7539:12;7563:117;7672:1;7669;7662:12;7686:180;7734:77;7731:1;7724:88;7831:4;7828:1;7821:15;7855:4;7852:1;7845:15;7872:281;7955:27;7977:4;7955:27;:::i;:::-;7947:6;7943:40;8085:6;8073:10;8070:22;8049:18;8037:10;8034:34;8031:62;8028:88;;;8096:18;;:::i;:::-;8028:88;8136:10;8132:2;8125:22;7915:238;7872:281;;:::o;8159:129::-;8193:6;8220:20;;:::i;:::-;8210:30;;8249:33;8277:4;8269:6;8249:33;:::i;:::-;8159:129;;;:::o;8294:308::-;8356:4;8446:18;8438:6;8435:30;8432:56;;;8468:18;;:::i;:::-;8432:56;8506:29;8528:6;8506:29;:::i;:::-;8498:37;;8590:4;8584;8580:15;8572:23;;8294:308;;;:::o;8608:148::-;8706:6;8701:3;8696;8683:30;8747:1;8738:6;8733:3;8729:16;8722:27;8608:148;;;:::o;8762:425::-;8840:5;8865:66;8881:49;8923:6;8881:49;:::i;:::-;8865:66;:::i;:::-;8856:75;;8954:6;8947:5;8940:21;8992:4;8985:5;8981:16;9030:3;9021:6;9016:3;9012:16;9009:25;9006:112;;;9037:79;;:::i;:::-;9006:112;9127:54;9174:6;9169:3;9164;9127:54;:::i;:::-;8846:341;8762:425;;;;;:::o;9207:340::-;9263:5;9312:3;9305:4;9297:6;9293:17;9289:27;9279:122;;9320:79;;:::i;:::-;9279:122;9437:6;9424:20;9462:79;9537:3;9529:6;9522:4;9514:6;9510:17;9462:79;:::i;:::-;9453:88;;9269:278;9207:340;;;;:::o;9553:654::-;9631:6;9639;9688:2;9676:9;9667:7;9663:23;9659:32;9656:119;;;9694:79;;:::i;:::-;9656:119;9814:1;9839:53;9884:7;9875:6;9864:9;9860:22;9839:53;:::i;:::-;9829:63;;9785:117;9969:2;9958:9;9954:18;9941:32;10000:18;9992:6;9989:30;9986:117;;;10022:79;;:::i;:::-;9986:117;10127:63;10182:7;10173:6;10162:9;10158:22;10127:63;:::i;:::-;10117:73;;9912:288;9553:654;;;;;:::o;10213:509::-;10282:6;10331:2;10319:9;10310:7;10306:23;10302:32;10299:119;;;10337:79;;:::i;:::-;10299:119;10485:1;10474:9;10470:17;10457:31;10515:18;10507:6;10504:30;10501:117;;;10537:79;;:::i;:::-;10501:117;10642:63;10697:7;10688:6;10677:9;10673:22;10642:63;:::i;:::-;10632:73;;10428:287;10213:509;;;;:::o;10728:329::-;10787:6;10836:2;10824:9;10815:7;10811:23;10807:32;10804:119;;;10842:79;;:::i;:::-;10804:119;10962:1;10987:53;11032:7;11023:6;11012:9;11008:22;10987:53;:::i;:::-;10977:63;;10933:117;10728:329;;;;:::o;11063:116::-;11133:21;11148:5;11133:21;:::i;:::-;11126:5;11123:32;11113:60;;11169:1;11166;11159:12;11113:60;11063:116;:::o;11185:133::-;11228:5;11266:6;11253:20;11244:29;;11282:30;11306:5;11282:30;:::i;:::-;11185:133;;;;:::o;11324:468::-;11389:6;11397;11446:2;11434:9;11425:7;11421:23;11417:32;11414:119;;;11452:79;;:::i;:::-;11414:119;11572:1;11597:53;11642:7;11633:6;11622:9;11618:22;11597:53;:::i;:::-;11587:63;;11543:117;11699:2;11725:50;11767:7;11758:6;11747:9;11743:22;11725:50;:::i;:::-;11715:60;;11670:115;11324:468;;;;;:::o;11798:307::-;11859:4;11949:18;11941:6;11938:30;11935:56;;;11971:18;;:::i;:::-;11935:56;12009:29;12031:6;12009:29;:::i;:::-;12001:37;;12093:4;12087;12083:15;12075:23;;11798:307;;;:::o;12111:423::-;12188:5;12213:65;12229:48;12270:6;12229:48;:::i;:::-;12213:65;:::i;:::-;12204:74;;12301:6;12294:5;12287:21;12339:4;12332:5;12328:16;12377:3;12368:6;12363:3;12359:16;12356:25;12353:112;;;12384:79;;:::i;:::-;12353:112;12474:54;12521:6;12516:3;12511;12474:54;:::i;:::-;12194:340;12111:423;;;;;:::o;12553:338::-;12608:5;12657:3;12650:4;12642:6;12638:17;12634:27;12624:122;;12665:79;;:::i;:::-;12624:122;12782:6;12769:20;12807:78;12881:3;12873:6;12866:4;12858:6;12854:17;12807:78;:::i;:::-;12798:87;;12614:277;12553:338;;;;:::o;12897:943::-;12992:6;13000;13008;13016;13065:3;13053:9;13044:7;13040:23;13036:33;13033:120;;;13072:79;;:::i;:::-;13033:120;13192:1;13217:53;13262:7;13253:6;13242:9;13238:22;13217:53;:::i;:::-;13207:63;;13163:117;13319:2;13345:53;13390:7;13381:6;13370:9;13366:22;13345:53;:::i;:::-;13335:63;;13290:118;13447:2;13473:53;13518:7;13509:6;13498:9;13494:22;13473:53;:::i;:::-;13463:63;;13418:118;13603:2;13592:9;13588:18;13575:32;13634:18;13626:6;13623:30;13620:117;;;13656:79;;:::i;:::-;13620:117;13761:62;13815:7;13806:6;13795:9;13791:22;13761:62;:::i;:::-;13751:72;;13546:287;12897:943;;;;;;;:::o;13846:474::-;13914:6;13922;13971:2;13959:9;13950:7;13946:23;13942:32;13939:119;;;13977:79;;:::i;:::-;13939:119;14097:1;14122:53;14167:7;14158:6;14147:9;14143:22;14122:53;:::i;:::-;14112:63;;14068:117;14224:2;14250:53;14295:7;14286:6;14275:9;14271:22;14250:53;:::i;:::-;14240:63;;14195:118;13846:474;;;;;:::o;14326:321::-;14413:4;14503:18;14495:6;14492:30;14489:56;;;14525:18;;:::i;:::-;14489:56;14575:4;14567:6;14563:17;14555:25;;14635:4;14629;14625:15;14617:23;;14326:321;;;:::o;14653:117::-;14762:1;14759;14752:12;14792:945;14898:5;14923:91;14939:74;15006:6;14939:74;:::i;:::-;14923:91;:::i;:::-;14914:100;;15034:5;15063:6;15056:5;15049:21;15097:4;15090:5;15086:16;15079:23;;15150:4;15142:6;15138:17;15130:6;15126:30;15179:3;15171:6;15168:15;15165:122;;;15198:79;;:::i;:::-;15165:122;15313:6;15296:435;15330:6;15325:3;15322:15;15296:435;;;15419:3;15406:17;15455:18;15442:11;15439:35;15436:122;;;15477:79;;:::i;:::-;15436:122;15601:11;15593:6;15589:24;15639:47;15682:3;15670:10;15639:47;:::i;:::-;15634:3;15627:60;15716:4;15711:3;15707:14;15700:21;;15372:359;;15356:4;15351:3;15347:14;15340:21;;15296:435;;;15300:21;14904:833;;14792:945;;;;;:::o;15759:390::-;15840:5;15889:3;15882:4;15874:6;15870:17;15866:27;15856:122;;15897:79;;:::i;:::-;15856:122;16014:6;16001:20;16039:104;16139:3;16131:6;16124:4;16116:6;16112:17;16039:104;:::i;:::-;16030:113;;15846:303;15759:390;;;;:::o;16155:559::-;16249:6;16298:2;16286:9;16277:7;16273:23;16269:32;16266:119;;;16304:79;;:::i;:::-;16266:119;16452:1;16441:9;16437:17;16424:31;16482:18;16474:6;16471:30;16468:117;;;16504:79;;:::i;:::-;16468:117;16609:88;16689:7;16680:6;16669:9;16665:22;16609:88;:::i;:::-;16599:98;;16395:312;16155:559;;;;:::o;16720:114::-;16787:6;16821:5;16815:12;16805:22;;16720:114;;;:::o;16840:184::-;16939:11;16973:6;16968:3;16961:19;17013:4;17008:3;17004:14;16989:29;;16840:184;;;;:::o;17030:132::-;17097:4;17120:3;17112:11;;17150:4;17145:3;17141:14;17133:22;;17030:132;;;:::o;17168:108::-;17245:24;17263:5;17245:24;:::i;:::-;17240:3;17233:37;17168:108;;:::o;17282:179::-;17351:10;17372:46;17414:3;17406:6;17372:46;:::i;:::-;17450:4;17445:3;17441:14;17427:28;;17282:179;;;;:::o;17467:113::-;17537:4;17569;17564:3;17560:14;17552:22;;17467:113;;;:::o;17616:732::-;17735:3;17764:54;17812:5;17764:54;:::i;:::-;17834:86;17913:6;17908:3;17834:86;:::i;:::-;17827:93;;17944:56;17994:5;17944:56;:::i;:::-;18023:7;18054:1;18039:284;18064:6;18061:1;18058:13;18039:284;;;18140:6;18134:13;18167:63;18226:3;18211:13;18167:63;:::i;:::-;18160:70;;18253:60;18306:6;18253:60;:::i;:::-;18243:70;;18099:224;18086:1;18083;18079:9;18074:14;;18039:284;;;18043:14;18339:3;18332:10;;17740:608;;;17616:732;;;;:::o;18354:373::-;18497:4;18535:2;18524:9;18520:18;18512:26;;18584:9;18578:4;18574:20;18570:1;18559:9;18555:17;18548:47;18612:108;18715:4;18706:6;18612:108;:::i;:::-;18604:116;;18354:373;;;;:::o;18733:180::-;18781:77;18778:1;18771:88;18878:4;18875:1;18868:15;18902:4;18899:1;18892:15;18919:320;18963:6;19000:1;18994:4;18990:12;18980:22;;19047:1;19041:4;19037:12;19068:18;19058:81;;19124:4;19116:6;19112:17;19102:27;;19058:81;19186:2;19178:6;19175:14;19155:18;19152:38;19149:84;;19205:18;;:::i;:::-;19149:84;18970:269;18919:320;;;:::o;19245:442::-;19394:4;19432:2;19421:9;19417:18;19409:26;;19445:71;19513:1;19502:9;19498:17;19489:6;19445:71;:::i;:::-;19526:72;19594:2;19583:9;19579:18;19570:6;19526:72;:::i;:::-;19608;19676:2;19665:9;19661:18;19652:6;19608:72;:::i;:::-;19245:442;;;;;;:::o;19693:180::-;19741:77;19738:1;19731:88;19838:4;19835:1;19828:15;19862:4;19859:1;19852:15;19879:410;19919:7;19942:20;19960:1;19942:20;:::i;:::-;19937:25;;19976:20;19994:1;19976:20;:::i;:::-;19971:25;;20031:1;20028;20024:9;20053:30;20071:11;20053:30;:::i;:::-;20042:41;;20232:1;20223:7;20219:15;20216:1;20213:22;20193:1;20186:9;20166:83;20143:139;;20262:18;;:::i;:::-;20143:139;19927:362;19879:410;;;;:::o;20295:180::-;20343:77;20340:1;20333:88;20440:4;20437:1;20430:15;20464:4;20461:1;20454:15;20481:185;20521:1;20538:20;20556:1;20538:20;:::i;:::-;20533:25;;20572:20;20590:1;20572:20;:::i;:::-;20567:25;;20611:1;20601:35;;20616:18;;:::i;:::-;20601:35;20658:1;20655;20651:9;20646:14;;20481:185;;;;:::o;20672:172::-;20812:24;20808:1;20800:6;20796:14;20789:48;20672:172;:::o;20850:366::-;20992:3;21013:67;21077:2;21072:3;21013:67;:::i;:::-;21006:74;;21089:93;21178:3;21089:93;:::i;:::-;21207:2;21202:3;21198:12;21191:19;;20850:366;;;:::o;21222:419::-;21388:4;21426:2;21415:9;21411:18;21403:26;;21475:9;21469:4;21465:20;21461:1;21450:9;21446:17;21439:47;21503:131;21629:4;21503:131;:::i;:::-;21495:139;;21222:419;;;:::o;21647:147::-;21748:11;21785:3;21770:18;;21647:147;;;;:::o;21800:114::-;;:::o;21920:398::-;22079:3;22100:83;22181:1;22176:3;22100:83;:::i;:::-;22093:90;;22192:93;22281:3;22192:93;:::i;:::-;22310:1;22305:3;22301:11;22294:18;;21920:398;;;:::o;22324:379::-;22508:3;22530:147;22673:3;22530:147;:::i;:::-;22523:154;;22694:3;22687:10;;22324:379;;;:::o;22709:165::-;22849:17;22845:1;22837:6;22833:14;22826:41;22709:165;:::o;22880:366::-;23022:3;23043:67;23107:2;23102:3;23043:67;:::i;:::-;23036:74;;23119:93;23208:3;23119:93;:::i;:::-;23237:2;23232:3;23228:12;23221:19;;22880:366;;;:::o;23252:419::-;23418:4;23456:2;23445:9;23441:18;23433:26;;23505:9;23499:4;23495:20;23491:1;23480:9;23476:17;23469:47;23533:131;23659:4;23533:131;:::i;:::-;23525:139;;23252:419;;;:::o;23677:168::-;23817:20;23813:1;23805:6;23801:14;23794:44;23677:168;:::o;23851:366::-;23993:3;24014:67;24078:2;24073:3;24014:67;:::i;:::-;24007:74;;24090:93;24179:3;24090:93;:::i;:::-;24208:2;24203:3;24199:12;24192:19;;23851:366;;;:::o;24223:419::-;24389:4;24427:2;24416:9;24412:18;24404:26;;24476:9;24470:4;24466:20;24462:1;24451:9;24447:17;24440:47;24504:131;24630:4;24504:131;:::i;:::-;24496:139;;24223:419;;;:::o;24648:233::-;24687:3;24710:24;24728:5;24710:24;:::i;:::-;24701:33;;24756:66;24749:5;24746:77;24743:103;;24826:18;;:::i;:::-;24743:103;24873:1;24866:5;24862:13;24855:20;;24648:233;;;:::o;24887:85::-;24932:7;24961:5;24950:16;;24887:85;;;:::o;24978:60::-;25006:3;25027:5;25020:12;;24978:60;;;:::o;25044:158::-;25102:9;25135:61;25153:42;25162:32;25188:5;25162:32;:::i;:::-;25153:42;:::i;:::-;25135:61;:::i;:::-;25122:74;;25044:158;;;:::o;25208:147::-;25303:45;25342:5;25303:45;:::i;:::-;25298:3;25291:58;25208:147;;:::o;25361:238::-;25462:4;25500:2;25489:9;25485:18;25477:26;;25513:79;25589:1;25578:9;25574:17;25565:6;25513:79;:::i;:::-;25361:238;;;;:::o;25605:141::-;25654:4;25677:3;25669:11;;25700:3;25697:1;25690:14;25734:4;25731:1;25721:18;25713:26;;25605:141;;;:::o;25752:93::-;25789:6;25836:2;25831;25824:5;25820:14;25816:23;25806:33;;25752:93;;;:::o;25851:107::-;25895:8;25945:5;25939:4;25935:16;25914:37;;25851:107;;;;:::o;25964:393::-;26033:6;26083:1;26071:10;26067:18;26106:97;26136:66;26125:9;26106:97;:::i;:::-;26224:39;26254:8;26243:9;26224:39;:::i;:::-;26212:51;;26296:4;26292:9;26285:5;26281:21;26272:30;;26345:4;26335:8;26331:19;26324:5;26321:30;26311:40;;26040:317;;25964:393;;;;;:::o;26363:142::-;26413:9;26446:53;26464:34;26473:24;26491:5;26473:24;:::i;:::-;26464:34;:::i;:::-;26446:53;:::i;:::-;26433:66;;26363:142;;;:::o;26511:75::-;26554:3;26575:5;26568:12;;26511:75;;;:::o;26592:269::-;26702:39;26733:7;26702:39;:::i;:::-;26763:91;26812:41;26836:16;26812:41;:::i;:::-;26804:6;26797:4;26791:11;26763:91;:::i;:::-;26757:4;26750:105;26668:193;26592:269;;;:::o;26867:73::-;26912:3;26933:1;26926:8;;26867:73;:::o;26946:189::-;27023:32;;:::i;:::-;27064:65;27122:6;27114;27108:4;27064:65;:::i;:::-;26999:136;26946:189;;:::o;27141:186::-;27201:120;27218:3;27211:5;27208:14;27201:120;;;27272:39;27309:1;27302:5;27272:39;:::i;:::-;27245:1;27238:5;27234:13;27225:22;;27201:120;;;27141:186;;:::o;27333:543::-;27434:2;27429:3;27426:11;27423:446;;;27468:38;27500:5;27468:38;:::i;:::-;27552:29;27570:10;27552:29;:::i;:::-;27542:8;27538:44;27735:2;27723:10;27720:18;27717:49;;;27756:8;27741:23;;27717:49;27779:80;27835:22;27853:3;27835:22;:::i;:::-;27825:8;27821:37;27808:11;27779:80;:::i;:::-;27438:431;;27423:446;27333:543;;;:::o;27882:117::-;27936:8;27986:5;27980:4;27976:16;27955:37;;27882:117;;;;:::o;28005:169::-;28049:6;28082:51;28130:1;28126:6;28118:5;28115:1;28111:13;28082:51;:::i;:::-;28078:56;28163:4;28157;28153:15;28143:25;;28056:118;28005:169;;;;:::o;28179:295::-;28255:4;28401:29;28426:3;28420:4;28401:29;:::i;:::-;28393:37;;28463:3;28460:1;28456:11;28450:4;28447:21;28439:29;;28179:295;;;;:::o;28479:1395::-;28596:37;28629:3;28596:37;:::i;:::-;28698:18;28690:6;28687:30;28684:56;;;28720:18;;:::i;:::-;28684:56;28764:38;28796:4;28790:11;28764:38;:::i;:::-;28849:67;28909:6;28901;28895:4;28849:67;:::i;:::-;28943:1;28967:4;28954:17;;28999:2;28991:6;28988:14;29016:1;29011:618;;;;29673:1;29690:6;29687:77;;;29739:9;29734:3;29730:19;29724:26;29715:35;;29687:77;29790:67;29850:6;29843:5;29790:67;:::i;:::-;29784:4;29777:81;29646:222;28981:887;;29011:618;29063:4;29059:9;29051:6;29047:22;29097:37;29129:4;29097:37;:::i;:::-;29156:1;29170:208;29184:7;29181:1;29178:14;29170:208;;;29263:9;29258:3;29254:19;29248:26;29240:6;29233:42;29314:1;29306:6;29302:14;29292:24;;29361:2;29350:9;29346:18;29333:31;;29207:4;29204:1;29200:12;29195:17;;29170:208;;;29406:6;29397:7;29394:19;29391:179;;;29464:9;29459:3;29455:19;29449:26;29507:48;29549:4;29541:6;29537:17;29526:9;29507:48;:::i;:::-;29499:6;29492:64;29414:156;29391:179;29616:1;29612;29604:6;29600:14;29596:22;29590:4;29583:36;29018:611;;;28981:887;;28571:1303;;;28479:1395;;:::o;29880:170::-;30020:22;30016:1;30008:6;30004:14;29997:46;29880:170;:::o;30056:366::-;30198:3;30219:67;30283:2;30278:3;30219:67;:::i;:::-;30212:74;;30295:93;30384:3;30295:93;:::i;:::-;30413:2;30408:3;30404:12;30397:19;;30056:366;;;:::o;30428:419::-;30594:4;30632:2;30621:9;30617:18;30609:26;;30681:9;30675:4;30671:20;30667:1;30656:9;30652:17;30645:47;30709:131;30835:4;30709:131;:::i;:::-;30701:139;;30428:419;;;:::o;30853:194::-;30893:4;30913:20;30931:1;30913:20;:::i;:::-;30908:25;;30947:20;30965:1;30947:20;:::i;:::-;30942:25;;30991:1;30988;30984:9;30976:17;;31015:1;31009:4;31006:11;31003:37;;;31020:18;;:::i;:::-;31003:37;30853:194;;;;:::o;31053:165::-;31193:17;31189:1;31181:6;31177:14;31170:41;31053:165;:::o;31224:366::-;31366:3;31387:67;31451:2;31446:3;31387:67;:::i;:::-;31380:74;;31463:93;31552:3;31463:93;:::i;:::-;31581:2;31576:3;31572:12;31565:19;;31224:366;;;:::o;31596:419::-;31762:4;31800:2;31789:9;31785:18;31777:26;;31849:9;31843:4;31839:20;31835:1;31824:9;31820:17;31813:47;31877:131;32003:4;31877:131;:::i;:::-;31869:139;;31596:419;;;:::o;32021:191::-;32061:3;32080:20;32098:1;32080:20;:::i;:::-;32075:25;;32114:20;32132:1;32114:20;:::i;:::-;32109:25;;32157:1;32154;32150:9;32143:16;;32178:3;32175:1;32172:10;32169:36;;;32185:18;;:::i;:::-;32169:36;32021:191;;;;:::o;32218:163::-;32358:15;32354:1;32346:6;32342:14;32335:39;32218:163;:::o;32387:366::-;32529:3;32550:67;32614:2;32609:3;32550:67;:::i;:::-;32543:74;;32626:93;32715:3;32626:93;:::i;:::-;32744:2;32739:3;32735:12;32728:19;;32387:366;;;:::o;32759:419::-;32925:4;32963:2;32952:9;32948:18;32940:26;;33012:9;33006:4;33002:20;32998:1;32987:9;32983:17;32976:47;33040:131;33166:4;33040:131;:::i;:::-;33032:139;;32759:419;;;:::o;33184:166::-;33324:18;33320:1;33312:6;33308:14;33301:42;33184:166;:::o;33356:366::-;33498:3;33519:67;33583:2;33578:3;33519:67;:::i;:::-;33512:74;;33595:93;33684:3;33595:93;:::i;:::-;33713:2;33708:3;33704:12;33697:19;;33356:366;;;:::o;33728:419::-;33894:4;33932:2;33921:9;33917:18;33909:26;;33981:9;33975:4;33971:20;33967:1;33956:9;33952:17;33945:47;34009:131;34135:4;34009:131;:::i;:::-;34001:139;;33728:419;;;:::o;34153:180::-;34201:77;34198:1;34191:88;34298:4;34295:1;34288:15;34322:4;34319:1;34312:15;34339:332;34460:4;34498:2;34487:9;34483:18;34475:26;;34511:71;34579:1;34568:9;34564:17;34555:6;34511:71;:::i;:::-;34592:72;34660:2;34649:9;34645:18;34636:6;34592:72;:::i;:::-;34339:332;;;;;:::o;34677:140::-;34726:9;34759:52;34777:33;34786:23;34803:5;34786:23;:::i;:::-;34777:33;:::i;:::-;34759:52;:::i;:::-;34746:65;;34677:140;;;:::o;34823:129::-;34909:36;34939:5;34909:36;:::i;:::-;34904:3;34897:49;34823:129;;:::o;34958:330::-;35078:4;35116:2;35105:9;35101:18;35093:26;;35129:70;35196:1;35185:9;35181:17;35172:6;35129:70;:::i;:::-;35209:72;35277:2;35266:9;35262:18;35253:6;35209:72;:::i;:::-;34958:330;;;;;:::o;35294:98::-;35345:6;35379:5;35373:12;35363:22;;35294:98;;;:::o;35398:168::-;35481:11;35515:6;35510:3;35503:19;35555:4;35550:3;35546:14;35531:29;;35398:168;;;;:::o;35572:373::-;35658:3;35686:38;35718:5;35686:38;:::i;:::-;35740:70;35803:6;35798:3;35740:70;:::i;:::-;35733:77;;35819:65;35877:6;35872:3;35865:4;35858:5;35854:16;35819:65;:::i;:::-;35909:29;35931:6;35909:29;:::i;:::-;35904:3;35900:39;35893:46;;35662:283;35572:373;;;;:::o;35951:640::-;36146:4;36184:3;36173:9;36169:19;36161:27;;36198:71;36266:1;36255:9;36251:17;36242:6;36198:71;:::i;:::-;36279:72;36347:2;36336:9;36332:18;36323:6;36279:72;:::i;:::-;36361;36429:2;36418:9;36414:18;36405:6;36361:72;:::i;:::-;36480:9;36474:4;36470:20;36465:2;36454:9;36450:18;36443:48;36508:76;36579:4;36570:6;36508:76;:::i;:::-;36500:84;;35951:640;;;;;;;:::o;36597:141::-;36653:5;36684:6;36678:13;36669:22;;36700:32;36726:5;36700:32;:::i;:::-;36597:141;;;;:::o;36744:349::-;36813:6;36862:2;36850:9;36841:7;36837:23;36833:32;36830:119;;;36868:79;;:::i;:::-;36830:119;36988:1;37013:63;37068:7;37059:6;37048:9;37044:22;37013:63;:::i;:::-;37003:73;;36959:127;36744:349;;;;:::o;37099:148::-;37201:11;37238:3;37223:18;;37099:148;;;;:::o;37253:390::-;37359:3;37387:39;37420:5;37387:39;:::i;:::-;37442:89;37524:6;37519:3;37442:89;:::i;:::-;37435:96;;37540:65;37598:6;37593:3;37586:4;37579:5;37575:16;37540:65;:::i;:::-;37630:6;37625:3;37621:16;37614:23;;37363:280;37253:390;;;;:::o;37649:435::-;37829:3;37851:95;37942:3;37933:6;37851:95;:::i;:::-;37844:102;;37963:95;38054:3;38045:6;37963:95;:::i;:::-;37956:102;;38075:3;38068:10;;37649:435;;;;;:::o
Swarm Source
ipfs://77f15fc296ae4378e3139e590e65bbae1f737a38f94c687ba98ca1841b6f0c74
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.