ERC-721
Source Code
Overview
Max Total Supply
0 XRHD
Holders
28,197
Market
Volume (24H)
N/A
Min Price (24H)
N/A
Max Price (24H)
N/A
Other Info
Token Contract
Balance
3 XRHDLoading...
Loading
Loading...
Loading
Loading...
Loading
Contract Name:
XrOneHeroesDrop
Compiler Version
v0.8.26+commit.8a97fa7a
Contract Source Code (Solidity)
/** *Submitted for verification at Arbiscan.io on 2024-11-21 */ // Sources flattened with hardhat v2.22.16 https://hardhat.org // SPDX-License-Identifier: MIT AND UNLICENSED // File @openzeppelin/contracts/utils/[email protected] // Original license: 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; } } // File @openzeppelin/contracts/access/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.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); } } // File @openzeppelin/contracts/interfaces/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (interfaces/draft-IERC6093.sol) /** * @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); } // File @openzeppelin/contracts/utils/introspection/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol) /** * @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); } // File @openzeppelin/contracts/token/ERC721/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721.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); } // File @openzeppelin/contracts/token/ERC721/extensions/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Metadata.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); } // File @openzeppelin/contracts/token/ERC721/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721Receiver.sol) /** * @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); } // File @openzeppelin/contracts/token/ERC721/utils/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/utils/ERC721Utils.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 {IERC721-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(32, reason), mload(reason)) } } } } } } // File @openzeppelin/contracts/utils/introspection/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.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 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) { return interfaceId == type(IERC165).interfaceId; } } // File @openzeppelin/contracts/utils/math/[email protected] // Original license: 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. /** * @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)) } } } // File @openzeppelin/contracts/utils/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol) /** * @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) } } } // File @openzeppelin/contracts/utils/math/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.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 Returns the addition of two unsigned integers, with an success flag (no overflow). */ function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) { unchecked { uint256 c = a + b; if (c < a) return (false, 0); return (true, c); } } /** * @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow). */ function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) { unchecked { if (b > a) return (false, 0); return (true, a - b); } } /** * @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow). */ function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) { unchecked { // Gas optimization: this is cheaper than requiring 'a' not being zero, but the // benefit is lost if 'b' is also tested. // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522 if (a == 0) return (true, 0); uint256 c = a * b; if (c / a != b) return (false, 0); return (true, c); } } /** * @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 { if (b == 0) return (false, 0); return (true, 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 { if (b == 0) return (false, 0); return (true, a % b); } } /** * @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 { // 512-bit multiply [prod1 prod0] = 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 = prod1 * 2²⁵⁶ + prod0. uint256 prod0 = x * y; // Least significant 256 bits of the product uint256 prod1; // Most significant 256 bits of the product assembly { let mm := mulmod(x, y, not(0)) prod1 := sub(sub(mm, prod0), lt(mm, prod0)) } // Handle non-overflow cases, 256 by 256 division. if (prod1 == 0) { // Solidity will revert if denominator == 0, unlike the div opcode on its own. // The surrounding unchecked block does not change this fact. // See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic. return prod0 / denominator; } // Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0. if (denominator <= prod1) { Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW)); } /////////////////////////////////////////////// // 512 by 256 division. /////////////////////////////////////////////// // Make division exact by subtracting the remainder from [prod1 prod0]. uint256 remainder; assembly { // Compute remainder using mulmod. remainder := mulmod(x, y, denominator) // Subtract 256 bit number from 512 bit number. prod1 := sub(prod1, gt(remainder, prod0)) prod0 := sub(prod0, remainder) } // Factor powers of two out of denominator and compute largest power of two divisor of denominator. // Always >= 1. See https://cs.stackexchange.com/q/138556/92363. uint256 twos = denominator & (0 - denominator); assembly { // Divide denominator by twos. denominator := div(denominator, twos) // Divide [prod1 prod0] by twos. prod0 := div(prod0, twos) // Flip twos such that it is 2²⁵⁶ / twos. If twos is zero, then it becomes one. twos := add(div(sub(0, twos), twos), 1) } // Shift in bits from prod1 into prod0. prod0 |= prod1 * twos; // Invert denominator mod 2²⁵⁶. 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 prod1 // is no longer required. result = prod0 * 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 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 value) internal pure returns (uint256) { uint256 result = 0; uint256 exp; unchecked { exp = 128 * SafeCast.toUint(value > (1 << 128) - 1); value >>= exp; result += exp; exp = 64 * SafeCast.toUint(value > (1 << 64) - 1); value >>= exp; result += exp; exp = 32 * SafeCast.toUint(value > (1 << 32) - 1); value >>= exp; result += exp; exp = 16 * SafeCast.toUint(value > (1 << 16) - 1); value >>= exp; result += exp; exp = 8 * SafeCast.toUint(value > (1 << 8) - 1); value >>= exp; result += exp; exp = 4 * SafeCast.toUint(value > (1 << 4) - 1); value >>= exp; result += exp; exp = 2 * SafeCast.toUint(value > (1 << 2) - 1); value >>= exp; result += exp; result += SafeCast.toUint(value > 1); } return result; } /** * @dev Return the log in base 2, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log2(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log2(value); return result + 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 value) internal pure returns (uint256) { uint256 result = 0; uint256 isGt; unchecked { isGt = SafeCast.toUint(value > (1 << 128) - 1); value >>= isGt * 128; result += isGt * 16; isGt = SafeCast.toUint(value > (1 << 64) - 1); value >>= isGt * 64; result += isGt * 8; isGt = SafeCast.toUint(value > (1 << 32) - 1); value >>= isGt * 32; result += isGt * 4; isGt = SafeCast.toUint(value > (1 << 16) - 1); value >>= isGt * 16; result += isGt * 2; result += SafeCast.toUint(value > (1 << 8) - 1); } return result; } /** * @dev Return the log in base 256, following the selected rounding direction, of a positive value. * Returns 0 if given 0. */ function log256(uint256 value, Rounding rounding) internal pure returns (uint256) { unchecked { uint256 result = log256(value); return result + 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; } } // File @openzeppelin/contracts/utils/math/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SignedMath.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); } } } // File @openzeppelin/contracts/utils/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Strings.sol) /** * @dev String operations. */ library Strings { bytes16 private constant HEX_DIGITS = "0123456789abcdef"; uint8 private constant ADDRESS_LENGTH = 20; /** * @dev The `value` string doesn't fit in the specified `length`. */ error StringsInsufficientHexLength(uint256 value, uint256 length); /** * @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(buffer, add(32, 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)); } } // File @openzeppelin/contracts/token/ERC721/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/ERC721.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_; } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == type(IERC721).interfaceId || interfaceId == type(IERC721Metadata).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721-balanceOf}. */ function balanceOf(address owner) public view virtual returns (uint256) { if (owner == address(0)) { revert ERC721InvalidOwner(address(0)); } return _balances[owner]; } /** * @dev See {IERC721-ownerOf}. */ function ownerOf(uint256 tokenId) public view virtual returns (address) { return _requireOwned(tokenId); } /** * @dev See {IERC721Metadata-name}. */ function name() public view virtual returns (string memory) { return _name; } /** * @dev See {IERC721Metadata-symbol}. */ function symbol() public view virtual returns (string memory) { return _symbol; } /** * @dev See {IERC721Metadata-tokenURI}. */ 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 ""; } /** * @dev See {IERC721-approve}. */ function approve(address to, uint256 tokenId) public virtual { _approve(to, tokenId, _msgSender()); } /** * @dev See {IERC721-getApproved}. */ function getApproved(uint256 tokenId) public view virtual returns (address) { _requireOwned(tokenId); return _getApproved(tokenId); } /** * @dev See {IERC721-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC721-isApprovedForAll}. */ function isApprovedForAll(address owner, address operator) public view virtual returns (bool) { return _operatorApprovals[owner][operator]; } /** * @dev See {IERC721-transferFrom}. */ 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); } } /** * @dev See {IERC721-safeTransferFrom}. */ function safeTransferFrom(address from, address to, uint256 tokenId) public { safeTransferFrom(from, to, tokenId, ""); } /** * @dev See {IERC721-safeTransferFrom}. */ 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; } } // File @openzeppelin/contracts/token/ERC721/extensions/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Enumerable.sol) /** * @title ERC-721 Non-Fungible Token Standard, optional enumeration extension * @dev See https://eips.ethereum.org/EIPS/eip-721 */ interface IERC721Enumerable is IERC721 { /** * @dev Returns the total amount of tokens stored by the contract. */ function totalSupply() external view returns (uint256); /** * @dev Returns a token ID owned by `owner` at a given `index` of its token list. * Use along with {balanceOf} to enumerate all of ``owner``'s tokens. */ function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256); /** * @dev Returns a token ID at a given `index` of all the tokens stored by the contract. * Use along with {totalSupply} to enumerate all tokens. */ function tokenByIndex(uint256 index) external view returns (uint256); } // File @openzeppelin/contracts/token/ERC721/extensions/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/extensions/ERC721Enumerable.sol) /** * @dev This implements an optional extension of {ERC721} defined in the ERC that adds enumerability * of all the token ids in the contract as well as all token ids owned by each account. * * CAUTION: {ERC721} extensions that implement custom `balanceOf` logic, such as {ERC721Consecutive}, * interfere with enumerability and should not be used together with {ERC721Enumerable}. */ abstract contract ERC721Enumerable is ERC721, IERC721Enumerable { mapping(address owner => mapping(uint256 index => uint256)) private _ownedTokens; mapping(uint256 tokenId => uint256) private _ownedTokensIndex; uint256[] private _allTokens; mapping(uint256 tokenId => uint256) private _allTokensIndex; /** * @dev An `owner`'s token query was out of bounds for `index`. * * NOTE: The owner being `address(0)` indicates a global out of bounds index. */ error ERC721OutOfBoundsIndex(address owner, uint256 index); /** * @dev Batch mint is not allowed. */ error ERC721EnumerableForbiddenBatchMint(); /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) { return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC721Enumerable-tokenOfOwnerByIndex}. */ function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual returns (uint256) { if (index >= balanceOf(owner)) { revert ERC721OutOfBoundsIndex(owner, index); } return _ownedTokens[owner][index]; } /** * @dev See {IERC721Enumerable-totalSupply}. */ function totalSupply() public view virtual returns (uint256) { return _allTokens.length; } /** * @dev See {IERC721Enumerable-tokenByIndex}. */ function tokenByIndex(uint256 index) public view virtual returns (uint256) { if (index >= totalSupply()) { revert ERC721OutOfBoundsIndex(address(0), index); } return _allTokens[index]; } /** * @dev See {ERC721-_update}. */ function _update(address to, uint256 tokenId, address auth) internal virtual override returns (address) { address previousOwner = super._update(to, tokenId, auth); if (previousOwner == address(0)) { _addTokenToAllTokensEnumeration(tokenId); } else if (previousOwner != to) { _removeTokenFromOwnerEnumeration(previousOwner, tokenId); } if (to == address(0)) { _removeTokenFromAllTokensEnumeration(tokenId); } else if (previousOwner != to) { _addTokenToOwnerEnumeration(to, tokenId); } return previousOwner; } /** * @dev Private function to add a token to this extension's ownership-tracking data structures. * @param to address representing the new owner of the given token ID * @param tokenId uint256 ID of the token to be added to the tokens list of the given address */ function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private { uint256 length = balanceOf(to) - 1; _ownedTokens[to][length] = tokenId; _ownedTokensIndex[tokenId] = length; } /** * @dev Private function to add a token to this extension's token tracking data structures. * @param tokenId uint256 ID of the token to be added to the tokens list */ function _addTokenToAllTokensEnumeration(uint256 tokenId) private { _allTokensIndex[tokenId] = _allTokens.length; _allTokens.push(tokenId); } /** * @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that * while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for * gas optimizations e.g. when performing a transfer operation (avoiding double writes). * This has O(1) time complexity, but alters the order of the _ownedTokens array. * @param from address representing the previous owner of the given token ID * @param tokenId uint256 ID of the token to be removed from the tokens list of the given address */ function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private { // To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = balanceOf(from); uint256 tokenIndex = _ownedTokensIndex[tokenId]; mapping(uint256 index => uint256) storage _ownedTokensByOwner = _ownedTokens[from]; // When the token to delete is the last token, the swap operation is unnecessary if (tokenIndex != lastTokenIndex) { uint256 lastTokenId = _ownedTokensByOwner[lastTokenIndex]; _ownedTokensByOwner[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index } // This also deletes the contents at the last position of the array delete _ownedTokensIndex[tokenId]; delete _ownedTokensByOwner[lastTokenIndex]; } /** * @dev Private function to remove a token from this extension's token tracking data structures. * This has O(1) time complexity, but alters the order of the _allTokens array. * @param tokenId uint256 ID of the token to be removed from the tokens list */ function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private { // To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and // then delete the last slot (swap and pop). uint256 lastTokenIndex = _allTokens.length - 1; uint256 tokenIndex = _allTokensIndex[tokenId]; // When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so // rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding // an 'if' statement (like in _removeTokenFromOwnerEnumeration) uint256 lastTokenId = _allTokens[lastTokenIndex]; _allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token _allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index // This also deletes the contents at the last position of the array delete _allTokensIndex[tokenId]; _allTokens.pop(); } /** * See {ERC721-_increaseBalance}. We need that to account tokens that were minted in batch */ function _increaseBalance(address account, uint128 amount) internal virtual override { if (amount > 0) { revert ERC721EnumerableForbiddenBatchMint(); } super._increaseBalance(account, amount); } } // File @openzeppelin/contracts/utils/[email protected] // Original license: SPDX_License_Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Base64.sol) /** * @dev Provides a set of functions to operate with Base64 strings. */ library Base64 { /** * @dev Base64 Encoding/Decoding Table * See sections 4 and 5 of https://datatracker.ietf.org/doc/html/rfc4648 */ string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"; string internal constant _TABLE_URL = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_"; /** * @dev Converts a `bytes` to its Bytes64 `string` representation. */ function encode(bytes memory data) internal pure returns (string memory) { return _encode(data, _TABLE, true); } /** * @dev Converts a `bytes` to its Bytes64Url `string` representation. * Output is not padded with `=` as specified in https://www.rfc-editor.org/rfc/rfc4648[rfc4648]. */ function encodeURL(bytes memory data) internal pure returns (string memory) { return _encode(data, _TABLE_URL, false); } /** * @dev Internal table-agnostic conversion */ function _encode(bytes memory data, string memory table, bool withPadding) private pure returns (string memory) { /** * Inspired by Brecht Devos (Brechtpd) implementation - MIT licence * https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol */ if (data.length == 0) return ""; // If padding is enabled, the final length should be `bytes` data length divided by 3 rounded up and then // multiplied by 4 so that it leaves room for padding the last chunk // - `data.length + 2` -> Prepare for division rounding up // - `/ 3` -> Number of 3-bytes chunks (rounded up) // - `4 *` -> 4 characters for each chunk // This is equivalent to: 4 * Math.ceil(data.length / 3) // // If padding is disabled, the final length should be `bytes` data length multiplied by 4/3 rounded up as // opposed to when padding is required to fill the last chunk. // - `4 * data.length` -> 4 characters for each chunk // - ` + 2` -> Prepare for division rounding up // - `/ 3` -> Number of 3-bytes chunks (rounded up) // This is equivalent to: Math.ceil((4 * data.length) / 3) uint256 resultLength = withPadding ? 4 * ((data.length + 2) / 3) : (4 * data.length + 2) / 3; string memory result = new string(resultLength); assembly ("memory-safe") { // Prepare the lookup table (skip the first "length" byte) let tablePtr := add(table, 1) // Prepare result pointer, jump over length let resultPtr := add(result, 0x20) let dataPtr := data let endPtr := add(data, mload(data)) // In some cases, the last iteration will read bytes after the end of the data. We cache the value, and // set it to zero to make sure no dirty bytes are read in that section. let afterPtr := add(endPtr, 0x20) let afterCache := mload(afterPtr) mstore(afterPtr, 0x00) // Run over the input, 3 bytes at a time for { } lt(dataPtr, endPtr) { } { // Advance 3 bytes dataPtr := add(dataPtr, 3) let input := mload(dataPtr) // To write each character, shift the 3 byte (24 bits) chunk // 4 times in blocks of 6 bits for each character (18, 12, 6, 0) // and apply logical AND with 0x3F to bitmask the least significant 6 bits. // Use this as an index into the lookup table, mload an entire word // so the desired character is in the least significant byte, and // mstore8 this least significant byte into the result and continue. mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F)))) resultPtr := add(resultPtr, 1) // Advance mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F)))) resultPtr := add(resultPtr, 1) // Advance mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F)))) resultPtr := add(resultPtr, 1) // Advance mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F)))) resultPtr := add(resultPtr, 1) // Advance } // Reset the value that was cached mstore(afterPtr, afterCache) if withPadding { // When data `bytes` is not exactly 3 bytes long // it is padded with `=` characters at the end switch mod(mload(data), 3) case 1 { mstore8(sub(resultPtr, 1), 0x3d) mstore8(sub(resultPtr, 2), 0x3d) } case 2 { mstore8(sub(resultPtr, 1), 0x3d) } } } return result; } } // File contracts/XrOneHeroesDrop.sol // Original license: SPDX_License_Identifier: UNLICENSED /// @title XR One Heroes Drop (XRHD). /// /// @dev Owners of this contract receive discounts when buying XR One Hero Nodes. /// /// @author Saltwater.Labs /// /// @custom:security-contact [email protected] contract XrOneHeroesDrop is Ownable, ERC721 { //// //// STATE //// /// Next token ID to be minted. uint256 public nextTokenId; /// Image URL for NFT metadata. string private baseImageURL; /// Animation URL for NFT metadata. string private baseAnimationURL; /// Base contract URI for NFT collection metadata. string private baseContractURI; //// //// EVENTS //// /// Emitted when the metadata for the token is updated. event MetadataUpdate(uint256 _tokenId); /// Emitted when the contract URI is updated. event ContractURIUpdated(); //// //// INIT //// /// Deploy. /// /// @param _baseImageURL The base URL for NFT image metadata. /// @param _baseAnimationURL The base URL for NFT animation metadata. /// @param _baseContractURI The base URI for NFT collection metadata. constructor( string memory _baseImageURL, string memory _baseAnimationURL, string memory _baseContractURI ) ERC721( "XR One Heroes Drop", "XRHD" ) Ownable(msg.sender) { baseImageURL = _baseImageURL; baseAnimationURL = _baseAnimationURL; baseContractURI = _baseContractURI; } //// //// ADMIN //// /// Distribute NFTs to multiple addresses. /// /// @dev Only callable by owner. /// @dev Mints three NFTs to each address. /// @dev Due to block gas limits, this function should be called in batches. /// /// @param _addresses The addresses to mint the NFTs to. function distributeXRHD( address[] memory _addresses ) external onlyOwner { uint256 addressLength = _addresses.length; uint256 currentTokenId = nextTokenId; for (uint256 i = 0; i < addressLength; i++) { _safeMint(_addresses[i], currentTokenId); _safeMint(_addresses[i], currentTokenId + 1); _safeMint(_addresses[i], currentTokenId + 2); currentTokenId += 3; } nextTokenId = currentTokenId; } /// Set the base URLs for image and animation. /// /// @dev Only callable by the owner. /// /// @param _baseImageURL The new base image URL. /// @param _baseAnimationURL The new base animation URL. function setMediaURLs( string memory _baseImageURL, string memory _baseAnimationURL ) external onlyOwner { baseImageURL = _baseImageURL; baseAnimationURL = _baseAnimationURL; emit MetadataUpdate(type(uint256).max); } /// Set the base contract URI. /// /// @dev Only callable by owner. /// /// @param _baseContractURI The new base contract URI. function setBaseContractURI( string memory _baseContractURI ) external onlyOwner { baseContractURI = _baseContractURI; emit ContractURIUpdated(); } //// //// GETTERS //// /// Check if an address owns token(s) in this collection. /// /// @param _owner The address to check. /// /// @return True if the address owns at least one token in this collection. function ownsXRHD( address _owner ) public view returns (bool) { return balanceOf(_owner) > 0; } /// Get the token URI of a given NFT. /// /// @param _tokenId The ID of the NFT. /// /// @return The token URI. function tokenURI( uint256 _tokenId ) public view virtual override returns (string memory) { require(_tokenId < nextTokenId, "ERC721Metadata: URI query for nonexistent token"); // Construct the metadata JSON string memory json = Base64.encode( bytes( string( abi.encodePacked( '{', '"description": "XR One Heroes Drop.", ', '"external_url": "https://xrone.network/heroesdrop", ', '"name": "XR One Heroes Drop #', Strings.toString(_tokenId), '", ', '"image": "', baseImageURL, '", ', '"animation_url": "', baseAnimationURL, '", ', '"attributes": []', '}' ) ) ) ); // Return the Base64-encoded JSON as a data URI return string(abi.encodePacked("data:application/json;base64,", json)); } /// Get the contract URI. /// /// @return The contract URI. function contractURI() public view returns (string memory) { return baseContractURI; } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"string","name":"_baseImageURL","type":"string"},{"internalType":"string","name":"_baseAnimationURL","type":"string"},{"internalType":"string","name":"_baseContractURI","type":"string"}],"stateMutability":"nonpayable","type":"constructor"},{"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"},{"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":[],"name":"ContractURIUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"uint256","name":"_tokenId","type":"uint256"}],"name":"MetadataUpdate","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":true,"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"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":"contractURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"_addresses","type":"address[]"}],"name":"distributeXRHD","outputs":[],"stateMutability":"nonpayable","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":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nextTokenId","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"_owner","type":"address"}],"name":"ownsXRHD","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","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":"_baseContractURI","type":"string"}],"name":"setBaseContractURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"string","name":"_baseImageURL","type":"string"},{"internalType":"string","name":"_baseAnimationURL","type":"string"}],"name":"setMediaURLs","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":[{"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"}]Contract Creation Code
608060405234801561000f575f80fd5b506040516136fb3803806136fb83398181016040528101906100319190610386565b6040518060400160405280601281526020017f5852204f6e65204865726f65732044726f7000000000000000000000000000008152506040518060400160405280600481526020017f5852484400000000000000000000000000000000000000000000000000000000815250335f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361010e575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016101059190610469565b60405180910390fd5b61011d8161017860201b60201c565b50816001908161012d919061068f565b50806002908161013d919061068f565b505050826008908161014f919061068f565b50816009908161015f919061068f565b5080600a908161016f919061068f565b5050505061075e565b5f805f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050815f806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f604051905090565b5f80fd5b5f80fd5b5f80fd5b5f80fd5b5f601f19601f8301169050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b61029882610252565b810181811067ffffffffffffffff821117156102b7576102b6610262565b5b80604052505050565b5f6102c9610239565b90506102d5828261028f565b919050565b5f67ffffffffffffffff8211156102f4576102f3610262565b5b6102fd82610252565b9050602081019050919050565b8281835e5f83830152505050565b5f61032a610325846102da565b6102c0565b9050828152602081018484840111156103465761034561024e565b5b61035184828561030a565b509392505050565b5f82601f83011261036d5761036c61024a565b5b815161037d848260208601610318565b91505092915050565b5f805f6060848603121561039d5761039c610242565b5b5f84015167ffffffffffffffff8111156103ba576103b9610246565b5b6103c686828701610359565b935050602084015167ffffffffffffffff8111156103e7576103e6610246565b5b6103f386828701610359565b925050604084015167ffffffffffffffff81111561041457610413610246565b5b61042086828701610359565b9150509250925092565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f6104538261042a565b9050919050565b61046381610449565b82525050565b5f60208201905061047c5f83018461045a565b92915050565b5f81519050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806104d057607f821691505b6020821081036104e3576104e261048c565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026105457fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261050a565b61054f868361050a565b95508019841693508086168417925050509392505050565b5f819050919050565b5f819050919050565b5f61059361058e61058984610567565b610570565b610567565b9050919050565b5f819050919050565b6105ac83610579565b6105c06105b88261059a565b848454610516565b825550505050565b5f90565b6105d46105c8565b6105df8184846105a3565b505050565b5b81811015610602576105f75f826105cc565b6001810190506105e5565b5050565b601f82111561064757610618816104e9565b610621846104fb565b81016020851015610630578190505b61064461063c856104fb565b8301826105e4565b50505b505050565b5f82821c905092915050565b5f6106675f198460080261064c565b1980831691505092915050565b5f61067f8383610658565b9150826002028217905092915050565b61069882610482565b67ffffffffffffffff8111156106b1576106b0610262565b5b6106bb82546104b9565b6106c6828285610606565b5f60209050601f8311600181146106f7575f84156106e5578287015190505b6106ef8582610674565b865550610756565b601f198416610705866104e9565b5f5b8281101561072c57848901518255600182019150602085019450602081019050610707565b868310156107495784890151610745601f891682610658565b8355505b6001600288020188555050505b505050505050565b612f908061076b5f395ff3fe608060405234801561000f575f80fd5b5060043610610140575f3560e01c806375794a3c116100b6578063b88d4fde1161007a578063b88d4fde1461035e578063c87b56dd1461037a578063ceca878f146103aa578063e8a3d485146103c6578063e985e9c5146103e4578063f2fde38b1461041457610140565b806375794a3c146102cc5780638da5cb5b146102ea57806395d89b4114610308578063a22cb46514610326578063b749d2551461034257610140565b806323b872dd1161010857806323b872dd146101fa57806342842e0e146102165780635b55b88b146102325780636352211e1461026257806370a0823114610292578063715018a6146102c257610140565b806301ffc9a71461014457806306fdde0314610174578063081812fc14610192578063095ea7b3146101c25780630cd3a538146101de575b5f80fd5b61015e60048036038101906101599190611d46565b610430565b60405161016b9190611d8b565b60405180910390f35b61017c610511565b6040516101899190611e14565b60405180910390f35b6101ac60048036038101906101a79190611e67565b6105a1565b6040516101b99190611ed1565b60405180910390f35b6101dc60048036038101906101d79190611f14565b6105bc565b005b6101f860048036038101906101f3919061207e565b6105d2565b005b610214600480360381019061020f91906120c5565b610619565b005b610230600480360381019061022b91906120c5565b610718565b005b61024c60048036038101906102479190612115565b610737565b6040516102599190611d8b565b60405180910390f35b61027c60048036038101906102779190611e67565b61074a565b6040516102899190611ed1565b60405180910390f35b6102ac60048036038101906102a79190612115565b61075b565b6040516102b9919061214f565b60405180910390f35b6102ca610811565b005b6102d4610824565b6040516102e1919061214f565b60405180910390f35b6102f261082a565b6040516102ff9190611ed1565b60405180910390f35b610310610851565b60405161031d9190611e14565b60405180910390f35b610340600480360381019061033b9190612192565b6108e1565b005b61035c60048036038101906103579190612294565b6108f7565b005b61037860048036038101906103739190612379565b6109c1565b005b610394600480360381019061038f9190611e67565b6109e6565b6040516103a19190611e14565b60405180910390f35b6103c460048036038101906103bf91906123f9565b610a8d565b005b6103ce610b10565b6040516103db9190611e14565b60405180910390f35b6103fe60048036038101906103f9919061246f565b610ba0565b60405161040b9190611d8b565b60405180910390f35b61042e60048036038101906104299190612115565b610c2e565b005b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806104fa57507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b8061050a575061050982610cb2565b5b9050919050565b606060018054610520906124da565b80601f016020809104026020016040519081016040528092919081815260200182805461054c906124da565b80156105975780601f1061056e57610100808354040283529160200191610597565b820191905f5260205f20905b81548152906001019060200180831161057a57829003601f168201915b5050505050905090565b5f6105ab82610d1b565b506105b582610da1565b9050919050565b6105ce82826105c9610dda565b610de1565b5050565b6105da610df3565b80600a90816105e991906126a7565b507fa5d4097edda6d87cb9329af83fb3712ef77eeb13738ffe43cc35a4ce305ad96260405160405180910390a150565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610689575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016106809190611ed1565b60405180910390fd5b5f61069c8383610697610dda565b610e7a565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610712578382826040517f64283d7b00000000000000000000000000000000000000000000000000000000815260040161070993929190612776565b60405180910390fd5b50505050565b61073283838360405180602001604052805f8152506109c1565b505050565b5f806107428361075b565b119050919050565b5f61075482610d1b565b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036107cc575f6040517f89c62b640000000000000000000000000000000000000000000000000000000081526004016107c39190611ed1565b60405180910390fd5b60045f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610819610df3565b6108225f611085565b565b60075481565b5f805f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060028054610860906124da565b80601f016020809104026020016040519081016040528092919081815260200182805461088c906124da565b80156108d75780601f106108ae576101008083540402835291602001916108d7565b820191905f5260205f20905b8154815290600101906020018083116108ba57829003601f168201915b5050505050905090565b6108f36108ec610dda565b8383611146565b5050565b6108ff610df3565b5f815190505f60075490505f5b828110156109b45761093884828151811061092a576109296127ab565b5b6020026020010151836112af565b61096884828151811061094e5761094d6127ab565b5b60200260200101516001846109639190612805565b6112af565b61099884828151811061097e5761097d6127ab565b5b60200260200101516002846109939190612805565b6112af565b6003826109a59190612805565b9150808060010191505061090c565b5080600781905550505050565b6109cc848484610619565b6109e06109d7610dda565b858585856112cc565b50505050565b60606007548210610a2c576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a23906128a8565b60405180910390fd5b5f610a63610a3984611478565b60086009604051602001610a4f93929190612c66565b604051602081830303815290604052611542565b905080604051602001610a769190612d59565b604051602081830303815290604052915050919050565b610a95610df3565b8160089081610aa491906126a7565b508060099081610ab491906126a7565b507ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce77fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff604051610b04919061214f565b60405180910390a15050565b6060600a8054610b1f906124da565b80601f0160208091040260200160405190810160405280929190818152602001828054610b4b906124da565b8015610b965780601f10610b6d57610100808354040283529160200191610b96565b820191905f5260205f20905b815481529060010190602001808311610b7957829003601f168201915b5050505050905090565b5f60065f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b610c36610df3565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610ca6575f6040517f1e4fbdf7000000000000000000000000000000000000000000000000000000008152600401610c9d9190611ed1565b60405180910390fd5b610caf81611085565b50565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f80610d268361156f565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610d9857826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401610d8f919061214f565b60405180910390fd5b80915050919050565b5f60055f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b610dee83838360016115a8565b505050565b610dfb610dda565b73ffffffffffffffffffffffffffffffffffffffff16610e1961082a565b73ffffffffffffffffffffffffffffffffffffffff1614610e7857610e3c610dda565b6040517f118cdaa7000000000000000000000000000000000000000000000000000000008152600401610e6f9190611ed1565b60405180910390fd5b565b5f80610e858461156f565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614610ec657610ec5818486611767565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610f5157610f055f855f806115a8565b600160045f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1614610fd057600160045f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460035f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f805f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050815f806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036111b657816040517f5b08ba180000000000000000000000000000000000000000000000000000000081526004016111ad9190611ed1565b60405180910390fd5b8060065f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31836040516112a29190611d8b565b60405180910390a3505050565b6112c8828260405180602001604052805f81525061182a565b5050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611471578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b815260040161132a9493929190612dcc565b6020604051808303815f875af192505050801561136557506040513d601f19601f820116820180604052508101906113629190612e2a565b60015b6113e6573d805f8114611393576040519150601f19603f3d011682016040523d82523d5f602084013e611398565b606091505b505f8151036113de57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016113d59190611ed1565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461146f57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016114669190611ed1565b60405180910390fd5b505b5050505050565b60605f60016114868461184d565b0190505f8167ffffffffffffffff8111156114a4576114a3611f5a565b5b6040519080825280601f01601f1916602001820160405280156114d65781602001600182028036833780820191505090505b5090505f82602001820190505b600115611537578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a858161152c5761152b612e55565b5b0494505f85036114e3575b819350505050919050565b606061156882604051806060016040528060408152602001612f1b60409139600161199e565b9050919050565b5f60035f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b80806115e057505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15611712575f6115ef84610d1b565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561165957508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b801561166c575061166a8184610ba0565b155b156116ae57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016116a59190611ed1565b60405180910390fd5b811561171057838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360055f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b611772838383611b2d565b611825575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16036117e657806040517f7e2732890000000000000000000000000000000000000000000000000000000081526004016117dd919061214f565b60405180910390fd5b81816040517f177e802f00000000000000000000000000000000000000000000000000000000815260040161181c929190612e82565b60405180910390fd5b505050565b6118348383611bed565b61184861183f610dda565b5f8585856112cc565b505050565b5f805f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f01000000000000000083106118a9577a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000838161189f5761189e612e55565b5b0492506040810190505b6d04ee2d6d415b85acef810000000083106118e6576d04ee2d6d415b85acef810000000083816118dc576118db612e55565b5b0492506020810190505b662386f26fc10000831061191557662386f26fc10000838161190b5761190a612e55565b5b0492506010810190505b6305f5e100831061193e576305f5e100838161193457611933612e55565b5b0492506008810190505b612710831061196357612710838161195957611958612e55565b5b0492506004810190505b60648310611986576064838161197c5761197b612e55565b5b0492506002810190505b600a8310611995576001810190505b80915050919050565b60605f8451036119be5760405180602001604052805f8152509050611b26565b5f826119ef5760036002865160046119d69190612ea9565b6119e09190612805565b6119ea9190612eea565b611a16565b6003600286516119ff9190612805565b611a099190612eea565b6004611a159190612ea9565b5b90505f8167ffffffffffffffff811115611a3357611a32611f5a565b5b6040519080825280601f01601f191660200182016040528015611a655781602001600182028036833780820191505090505b509050600185016020820187885189016020810180515f82525b82841015611ada576003840193508351603f8160121c168701518653600186019550603f81600c1c168701518653600186019550603f8160061c168701518653600186019550603f8116870151865360018601955050611a7f565b8082528915611b1a5760038c510660018114611afd5760028114611b1057611b18565b603d6001870353603d6002870353611b18565b603d60018703535b505b50505050505080925050505b9392505050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015611be457508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611ba55750611ba48484610ba0565b5b80611be357508273ffffffffffffffffffffffffffffffffffffffff16611bcb83610da1565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611c5d575f6040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611c549190611ed1565b60405180910390fd5b5f611c6983835f610e7a565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611cdb575f6040517f73c6ac6e000000000000000000000000000000000000000000000000000000008152600401611cd29190611ed1565b60405180910390fd5b505050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b611d2581611cf1565b8114611d2f575f80fd5b50565b5f81359050611d4081611d1c565b92915050565b5f60208284031215611d5b57611d5a611ce9565b5b5f611d6884828501611d32565b91505092915050565b5f8115159050919050565b611d8581611d71565b82525050565b5f602082019050611d9e5f830184611d7c565b92915050565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f611de682611da4565b611df08185611dae565b9350611e00818560208601611dbe565b611e0981611dcc565b840191505092915050565b5f6020820190508181035f830152611e2c8184611ddc565b905092915050565b5f819050919050565b611e4681611e34565b8114611e50575f80fd5b50565b5f81359050611e6181611e3d565b92915050565b5f60208284031215611e7c57611e7b611ce9565b5b5f611e8984828501611e53565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f611ebb82611e92565b9050919050565b611ecb81611eb1565b82525050565b5f602082019050611ee45f830184611ec2565b92915050565b611ef381611eb1565b8114611efd575f80fd5b50565b5f81359050611f0e81611eea565b92915050565b5f8060408385031215611f2a57611f29611ce9565b5b5f611f3785828601611f00565b9250506020611f4885828601611e53565b9150509250929050565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b611f9082611dcc565b810181811067ffffffffffffffff82111715611faf57611fae611f5a565b5b80604052505050565b5f611fc1611ce0565b9050611fcd8282611f87565b919050565b5f67ffffffffffffffff821115611fec57611feb611f5a565b5b611ff582611dcc565b9050602081019050919050565b828183375f83830152505050565b5f61202261201d84611fd2565b611fb8565b90508281526020810184848401111561203e5761203d611f56565b5b612049848285612002565b509392505050565b5f82601f83011261206557612064611f52565b5b8135612075848260208601612010565b91505092915050565b5f6020828403121561209357612092611ce9565b5b5f82013567ffffffffffffffff8111156120b0576120af611ced565b5b6120bc84828501612051565b91505092915050565b5f805f606084860312156120dc576120db611ce9565b5b5f6120e986828701611f00565b93505060206120fa86828701611f00565b925050604061210b86828701611e53565b9150509250925092565b5f6020828403121561212a57612129611ce9565b5b5f61213784828501611f00565b91505092915050565b61214981611e34565b82525050565b5f6020820190506121625f830184612140565b92915050565b61217181611d71565b811461217b575f80fd5b50565b5f8135905061218c81612168565b92915050565b5f80604083850312156121a8576121a7611ce9565b5b5f6121b585828601611f00565b92505060206121c68582860161217e565b9150509250929050565b5f67ffffffffffffffff8211156121ea576121e9611f5a565b5b602082029050602081019050919050565b5f80fd5b5f61221161220c846121d0565b611fb8565b90508083825260208201905060208402830185811115612234576122336121fb565b5b835b8181101561225d57806122498882611f00565b845260208401935050602081019050612236565b5050509392505050565b5f82601f83011261227b5761227a611f52565b5b813561228b8482602086016121ff565b91505092915050565b5f602082840312156122a9576122a8611ce9565b5b5f82013567ffffffffffffffff8111156122c6576122c5611ced565b5b6122d284828501612267565b91505092915050565b5f67ffffffffffffffff8211156122f5576122f4611f5a565b5b6122fe82611dcc565b9050602081019050919050565b5f61231d612318846122db565b611fb8565b90508281526020810184848401111561233957612338611f56565b5b612344848285612002565b509392505050565b5f82601f8301126123605761235f611f52565b5b813561237084826020860161230b565b91505092915050565b5f805f806080858703121561239157612390611ce9565b5b5f61239e87828801611f00565b94505060206123af87828801611f00565b93505060406123c087828801611e53565b925050606085013567ffffffffffffffff8111156123e1576123e0611ced565b5b6123ed8782880161234c565b91505092959194509250565b5f806040838503121561240f5761240e611ce9565b5b5f83013567ffffffffffffffff81111561242c5761242b611ced565b5b61243885828601612051565b925050602083013567ffffffffffffffff81111561245957612458611ced565b5b61246585828601612051565b9150509250929050565b5f806040838503121561248557612484611ce9565b5b5f61249285828601611f00565b92505060206124a385828601611f00565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806124f157607f821691505b602082108103612504576125036124ad565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026125667fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261252b565b612570868361252b565b95508019841693508086168417925050509392505050565b5f819050919050565b5f6125ab6125a66125a184611e34565b612588565b611e34565b9050919050565b5f819050919050565b6125c483612591565b6125d86125d0826125b2565b848454612537565b825550505050565b5f90565b6125ec6125e0565b6125f78184846125bb565b505050565b5b8181101561261a5761260f5f826125e4565b6001810190506125fd565b5050565b601f82111561265f576126308161250a565b6126398461251c565b81016020851015612648578190505b61265c6126548561251c565b8301826125fc565b50505b505050565b5f82821c905092915050565b5f61267f5f1984600802612664565b1980831691505092915050565b5f6126978383612670565b9150826002028217905092915050565b6126b082611da4565b67ffffffffffffffff8111156126c9576126c8611f5a565b5b6126d382546124da565b6126de82828561261e565b5f60209050601f83116001811461270f575f84156126fd578287015190505b612707858261268c565b86555061276e565b601f19841661271d8661250a565b5f5b828110156127445784890151825560018201915060208501945060208101905061271f565b86831015612761578489015161275d601f891682612670565b8355505b6001600288020188555050505b505050505050565b5f6060820190506127895f830186611ec2565b6127966020830185612140565b6127a36040830184611ec2565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61280f82611e34565b915061281a83611e34565b9250828201905080821115612832576128316127d8565b5b92915050565b7f4552433732314d657461646174613a2055524920717565727920666f72206e6f5f8201527f6e6578697374656e7420746f6b656e0000000000000000000000000000000000602082015250565b5f612892602f83611dae565b915061289d82612838565b604082019050919050565b5f6020820190508181035f8301526128bf81612886565b9050919050565b5f81905092915050565b7f7b000000000000000000000000000000000000000000000000000000000000005f82015250565b5f6129046001836128c6565b915061290f826128d0565b600182019050919050565b7f226465736372697074696f6e223a20225852204f6e65204865726f65732044725f8201527f6f702e222c200000000000000000000000000000000000000000000000000000602082015250565b5f6129746026836128c6565b915061297f8261291a565b602682019050919050565b7f2265787465726e616c5f75726c223a202268747470733a2f2f78726f6e652e6e5f8201527f6574776f726b2f6865726f657364726f70222c20000000000000000000000000602082015250565b5f6129e46034836128c6565b91506129ef8261298a565b603482019050919050565b7f226e616d65223a20225852204f6e65204865726f65732044726f7020230000005f82015250565b5f612a2e601d836128c6565b9150612a39826129fa565b601d82019050919050565b5f612a4e82611da4565b612a5881856128c6565b9350612a68818560208601611dbe565b80840191505092915050565b7f222c2000000000000000000000000000000000000000000000000000000000005f82015250565b5f612aa86003836128c6565b9150612ab382612a74565b600382019050919050565b7f22696d616765223a2022000000000000000000000000000000000000000000005f82015250565b5f612af2600a836128c6565b9150612afd82612abe565b600a82019050919050565b5f8154612b14816124da565b612b1e81866128c6565b9450600182165f8114612b385760018114612b4d57612b7f565b60ff1983168652811515820286019350612b7f565b612b568561250a565b5f5b83811015612b7757815481890152600182019150602081019050612b58565b838801955050505b50505092915050565b7f22616e696d6174696f6e5f75726c223a202200000000000000000000000000005f82015250565b5f612bbc6012836128c6565b9150612bc782612b88565b601282019050919050565b7f2261747472696275746573223a205b5d000000000000000000000000000000005f82015250565b5f612c066010836128c6565b9150612c1182612bd2565b601082019050919050565b7f7d000000000000000000000000000000000000000000000000000000000000005f82015250565b5f612c506001836128c6565b9150612c5b82612c1c565b600182019050919050565b5f612c70826128f8565b9150612c7b82612968565b9150612c86826129d8565b9150612c9182612a22565b9150612c9d8286612a44565b9150612ca882612a9c565b9150612cb382612ae6565b9150612cbf8285612b08565b9150612cca82612a9c565b9150612cd582612bb0565b9150612ce18284612b08565b9150612cec82612a9c565b9150612cf782612bfa565b9150612d0282612c44565b9150819050949350505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000005f82015250565b5f612d43601d836128c6565b9150612d4e82612d0f565b601d82019050919050565b5f612d6382612d37565b9150612d6f8284612a44565b915081905092915050565b5f81519050919050565b5f82825260208201905092915050565b5f612d9e82612d7a565b612da88185612d84565b9350612db8818560208601611dbe565b612dc181611dcc565b840191505092915050565b5f608082019050612ddf5f830187611ec2565b612dec6020830186611ec2565b612df96040830185612140565b8181036060830152612e0b8184612d94565b905095945050505050565b5f81519050612e2481611d1c565b92915050565b5f60208284031215612e3f57612e3e611ce9565b5b5f612e4c84828501612e16565b91505092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f604082019050612e955f830185611ec2565b612ea26020830184612140565b9392505050565b5f612eb382611e34565b9150612ebe83611e34565b9250828202612ecc81611e34565b91508282048414831517612ee357612ee26127d8565b5b5092915050565b5f612ef482611e34565b9150612eff83611e34565b925082612f0f57612f0e612e55565b5b82820490509291505056fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa264697066735822122082e9b99f2cd61c7b5dbc3ca3a16c7064a78280f478cee21f1448e0fc4de0f13464736f6c634300081a0033000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000005668747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f6865726f5f64726f705f78725f6e66742d6c617267652d5f302d30302d30312d32305f2e706e6700000000000000000000000000000000000000000000000000000000000000000000000000000000004768747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f4845524f2b44524f502b58522b4e46545f3130312e6d703400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004468747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f636f6e74726163744d657461646174612e6a736f6e00000000000000000000000000000000000000000000000000000000
Deployed Bytecode
0x608060405234801561000f575f80fd5b5060043610610140575f3560e01c806375794a3c116100b6578063b88d4fde1161007a578063b88d4fde1461035e578063c87b56dd1461037a578063ceca878f146103aa578063e8a3d485146103c6578063e985e9c5146103e4578063f2fde38b1461041457610140565b806375794a3c146102cc5780638da5cb5b146102ea57806395d89b4114610308578063a22cb46514610326578063b749d2551461034257610140565b806323b872dd1161010857806323b872dd146101fa57806342842e0e146102165780635b55b88b146102325780636352211e1461026257806370a0823114610292578063715018a6146102c257610140565b806301ffc9a71461014457806306fdde0314610174578063081812fc14610192578063095ea7b3146101c25780630cd3a538146101de575b5f80fd5b61015e60048036038101906101599190611d46565b610430565b60405161016b9190611d8b565b60405180910390f35b61017c610511565b6040516101899190611e14565b60405180910390f35b6101ac60048036038101906101a79190611e67565b6105a1565b6040516101b99190611ed1565b60405180910390f35b6101dc60048036038101906101d79190611f14565b6105bc565b005b6101f860048036038101906101f3919061207e565b6105d2565b005b610214600480360381019061020f91906120c5565b610619565b005b610230600480360381019061022b91906120c5565b610718565b005b61024c60048036038101906102479190612115565b610737565b6040516102599190611d8b565b60405180910390f35b61027c60048036038101906102779190611e67565b61074a565b6040516102899190611ed1565b60405180910390f35b6102ac60048036038101906102a79190612115565b61075b565b6040516102b9919061214f565b60405180910390f35b6102ca610811565b005b6102d4610824565b6040516102e1919061214f565b60405180910390f35b6102f261082a565b6040516102ff9190611ed1565b60405180910390f35b610310610851565b60405161031d9190611e14565b60405180910390f35b610340600480360381019061033b9190612192565b6108e1565b005b61035c60048036038101906103579190612294565b6108f7565b005b61037860048036038101906103739190612379565b6109c1565b005b610394600480360381019061038f9190611e67565b6109e6565b6040516103a19190611e14565b60405180910390f35b6103c460048036038101906103bf91906123f9565b610a8d565b005b6103ce610b10565b6040516103db9190611e14565b60405180910390f35b6103fe60048036038101906103f9919061246f565b610ba0565b60405161040b9190611d8b565b60405180910390f35b61042e60048036038101906104299190612115565b610c2e565b005b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806104fa57507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b8061050a575061050982610cb2565b5b9050919050565b606060018054610520906124da565b80601f016020809104026020016040519081016040528092919081815260200182805461054c906124da565b80156105975780601f1061056e57610100808354040283529160200191610597565b820191905f5260205f20905b81548152906001019060200180831161057a57829003601f168201915b5050505050905090565b5f6105ab82610d1b565b506105b582610da1565b9050919050565b6105ce82826105c9610dda565b610de1565b5050565b6105da610df3565b80600a90816105e991906126a7565b507fa5d4097edda6d87cb9329af83fb3712ef77eeb13738ffe43cc35a4ce305ad96260405160405180910390a150565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610689575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016106809190611ed1565b60405180910390fd5b5f61069c8383610697610dda565b610e7a565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610712578382826040517f64283d7b00000000000000000000000000000000000000000000000000000000815260040161070993929190612776565b60405180910390fd5b50505050565b61073283838360405180602001604052805f8152506109c1565b505050565b5f806107428361075b565b119050919050565b5f61075482610d1b565b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036107cc575f6040517f89c62b640000000000000000000000000000000000000000000000000000000081526004016107c39190611ed1565b60405180910390fd5b60045f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610819610df3565b6108225f611085565b565b60075481565b5f805f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060028054610860906124da565b80601f016020809104026020016040519081016040528092919081815260200182805461088c906124da565b80156108d75780601f106108ae576101008083540402835291602001916108d7565b820191905f5260205f20905b8154815290600101906020018083116108ba57829003601f168201915b5050505050905090565b6108f36108ec610dda565b8383611146565b5050565b6108ff610df3565b5f815190505f60075490505f5b828110156109b45761093884828151811061092a576109296127ab565b5b6020026020010151836112af565b61096884828151811061094e5761094d6127ab565b5b60200260200101516001846109639190612805565b6112af565b61099884828151811061097e5761097d6127ab565b5b60200260200101516002846109939190612805565b6112af565b6003826109a59190612805565b9150808060010191505061090c565b5080600781905550505050565b6109cc848484610619565b6109e06109d7610dda565b858585856112cc565b50505050565b60606007548210610a2c576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a23906128a8565b60405180910390fd5b5f610a63610a3984611478565b60086009604051602001610a4f93929190612c66565b604051602081830303815290604052611542565b905080604051602001610a769190612d59565b604051602081830303815290604052915050919050565b610a95610df3565b8160089081610aa491906126a7565b508060099081610ab491906126a7565b507ff8e1a15aba9398e019f0b49df1a4fde98ee17ae345cb5f6b5e2c27f5033e8ce77fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff604051610b04919061214f565b60405180910390a15050565b6060600a8054610b1f906124da565b80601f0160208091040260200160405190810160405280929190818152602001828054610b4b906124da565b8015610b965780601f10610b6d57610100808354040283529160200191610b96565b820191905f5260205f20905b815481529060010190602001808311610b7957829003601f168201915b5050505050905090565b5f60065f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b610c36610df3565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610ca6575f6040517f1e4fbdf7000000000000000000000000000000000000000000000000000000008152600401610c9d9190611ed1565b60405180910390fd5b610caf81611085565b50565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f80610d268361156f565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610d9857826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401610d8f919061214f565b60405180910390fd5b80915050919050565b5f60055f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b610dee83838360016115a8565b505050565b610dfb610dda565b73ffffffffffffffffffffffffffffffffffffffff16610e1961082a565b73ffffffffffffffffffffffffffffffffffffffff1614610e7857610e3c610dda565b6040517f118cdaa7000000000000000000000000000000000000000000000000000000008152600401610e6f9190611ed1565b60405180910390fd5b565b5f80610e858461156f565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614610ec657610ec5818486611767565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610f5157610f055f855f806115a8565b600160045f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff1614610fd057600160045f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460035f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f805f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050815f806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036111b657816040517f5b08ba180000000000000000000000000000000000000000000000000000000081526004016111ad9190611ed1565b60405180910390fd5b8060065f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31836040516112a29190611d8b565b60405180910390a3505050565b6112c8828260405180602001604052805f81525061182a565b5050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611471578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b815260040161132a9493929190612dcc565b6020604051808303815f875af192505050801561136557506040513d601f19601f820116820180604052508101906113629190612e2a565b60015b6113e6573d805f8114611393576040519150601f19603f3d011682016040523d82523d5f602084013e611398565b606091505b505f8151036113de57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016113d59190611ed1565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461146f57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016114669190611ed1565b60405180910390fd5b505b5050505050565b60605f60016114868461184d565b0190505f8167ffffffffffffffff8111156114a4576114a3611f5a565b5b6040519080825280601f01601f1916602001820160405280156114d65781602001600182028036833780820191505090505b5090505f82602001820190505b600115611537578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a858161152c5761152b612e55565b5b0494505f85036114e3575b819350505050919050565b606061156882604051806060016040528060408152602001612f1b60409139600161199e565b9050919050565b5f60035f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b80806115e057505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15611712575f6115ef84610d1b565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff161415801561165957508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b801561166c575061166a8184610ba0565b155b156116ae57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016116a59190611ed1565b60405180910390fd5b811561171057838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360055f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b611772838383611b2d565b611825575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16036117e657806040517f7e2732890000000000000000000000000000000000000000000000000000000081526004016117dd919061214f565b60405180910390fd5b81816040517f177e802f00000000000000000000000000000000000000000000000000000000815260040161181c929190612e82565b60405180910390fd5b505050565b6118348383611bed565b61184861183f610dda565b5f8585856112cc565b505050565b5f805f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f01000000000000000083106118a9577a184f03e93ff9f4daa797ed6e38ed64bf6a1f010000000000000000838161189f5761189e612e55565b5b0492506040810190505b6d04ee2d6d415b85acef810000000083106118e6576d04ee2d6d415b85acef810000000083816118dc576118db612e55565b5b0492506020810190505b662386f26fc10000831061191557662386f26fc10000838161190b5761190a612e55565b5b0492506010810190505b6305f5e100831061193e576305f5e100838161193457611933612e55565b5b0492506008810190505b612710831061196357612710838161195957611958612e55565b5b0492506004810190505b60648310611986576064838161197c5761197b612e55565b5b0492506002810190505b600a8310611995576001810190505b80915050919050565b60605f8451036119be5760405180602001604052805f8152509050611b26565b5f826119ef5760036002865160046119d69190612ea9565b6119e09190612805565b6119ea9190612eea565b611a16565b6003600286516119ff9190612805565b611a099190612eea565b6004611a159190612ea9565b5b90505f8167ffffffffffffffff811115611a3357611a32611f5a565b5b6040519080825280601f01601f191660200182016040528015611a655781602001600182028036833780820191505090505b509050600185016020820187885189016020810180515f82525b82841015611ada576003840193508351603f8160121c168701518653600186019550603f81600c1c168701518653600186019550603f8160061c168701518653600186019550603f8116870151865360018601955050611a7f565b8082528915611b1a5760038c510660018114611afd5760028114611b1057611b18565b603d6001870353603d6002870353611b18565b603d60018703535b505b50505050505080925050505b9392505050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015611be457508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611ba55750611ba48484610ba0565b5b80611be357508273ffffffffffffffffffffffffffffffffffffffff16611bcb83610da1565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611c5d575f6040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611c549190611ed1565b60405180910390fd5b5f611c6983835f610e7a565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611cdb575f6040517f73c6ac6e000000000000000000000000000000000000000000000000000000008152600401611cd29190611ed1565b60405180910390fd5b505050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b611d2581611cf1565b8114611d2f575f80fd5b50565b5f81359050611d4081611d1c565b92915050565b5f60208284031215611d5b57611d5a611ce9565b5b5f611d6884828501611d32565b91505092915050565b5f8115159050919050565b611d8581611d71565b82525050565b5f602082019050611d9e5f830184611d7c565b92915050565b5f81519050919050565b5f82825260208201905092915050565b8281835e5f83830152505050565b5f601f19601f8301169050919050565b5f611de682611da4565b611df08185611dae565b9350611e00818560208601611dbe565b611e0981611dcc565b840191505092915050565b5f6020820190508181035f830152611e2c8184611ddc565b905092915050565b5f819050919050565b611e4681611e34565b8114611e50575f80fd5b50565b5f81359050611e6181611e3d565b92915050565b5f60208284031215611e7c57611e7b611ce9565b5b5f611e8984828501611e53565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f611ebb82611e92565b9050919050565b611ecb81611eb1565b82525050565b5f602082019050611ee45f830184611ec2565b92915050565b611ef381611eb1565b8114611efd575f80fd5b50565b5f81359050611f0e81611eea565b92915050565b5f8060408385031215611f2a57611f29611ce9565b5b5f611f3785828601611f00565b9250506020611f4885828601611e53565b9150509250929050565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b611f9082611dcc565b810181811067ffffffffffffffff82111715611faf57611fae611f5a565b5b80604052505050565b5f611fc1611ce0565b9050611fcd8282611f87565b919050565b5f67ffffffffffffffff821115611fec57611feb611f5a565b5b611ff582611dcc565b9050602081019050919050565b828183375f83830152505050565b5f61202261201d84611fd2565b611fb8565b90508281526020810184848401111561203e5761203d611f56565b5b612049848285612002565b509392505050565b5f82601f83011261206557612064611f52565b5b8135612075848260208601612010565b91505092915050565b5f6020828403121561209357612092611ce9565b5b5f82013567ffffffffffffffff8111156120b0576120af611ced565b5b6120bc84828501612051565b91505092915050565b5f805f606084860312156120dc576120db611ce9565b5b5f6120e986828701611f00565b93505060206120fa86828701611f00565b925050604061210b86828701611e53565b9150509250925092565b5f6020828403121561212a57612129611ce9565b5b5f61213784828501611f00565b91505092915050565b61214981611e34565b82525050565b5f6020820190506121625f830184612140565b92915050565b61217181611d71565b811461217b575f80fd5b50565b5f8135905061218c81612168565b92915050565b5f80604083850312156121a8576121a7611ce9565b5b5f6121b585828601611f00565b92505060206121c68582860161217e565b9150509250929050565b5f67ffffffffffffffff8211156121ea576121e9611f5a565b5b602082029050602081019050919050565b5f80fd5b5f61221161220c846121d0565b611fb8565b90508083825260208201905060208402830185811115612234576122336121fb565b5b835b8181101561225d57806122498882611f00565b845260208401935050602081019050612236565b5050509392505050565b5f82601f83011261227b5761227a611f52565b5b813561228b8482602086016121ff565b91505092915050565b5f602082840312156122a9576122a8611ce9565b5b5f82013567ffffffffffffffff8111156122c6576122c5611ced565b5b6122d284828501612267565b91505092915050565b5f67ffffffffffffffff8211156122f5576122f4611f5a565b5b6122fe82611dcc565b9050602081019050919050565b5f61231d612318846122db565b611fb8565b90508281526020810184848401111561233957612338611f56565b5b612344848285612002565b509392505050565b5f82601f8301126123605761235f611f52565b5b813561237084826020860161230b565b91505092915050565b5f805f806080858703121561239157612390611ce9565b5b5f61239e87828801611f00565b94505060206123af87828801611f00565b93505060406123c087828801611e53565b925050606085013567ffffffffffffffff8111156123e1576123e0611ced565b5b6123ed8782880161234c565b91505092959194509250565b5f806040838503121561240f5761240e611ce9565b5b5f83013567ffffffffffffffff81111561242c5761242b611ced565b5b61243885828601612051565b925050602083013567ffffffffffffffff81111561245957612458611ced565b5b61246585828601612051565b9150509250929050565b5f806040838503121561248557612484611ce9565b5b5f61249285828601611f00565b92505060206124a385828601611f00565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806124f157607f821691505b602082108103612504576125036124ad565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026125667fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8261252b565b612570868361252b565b95508019841693508086168417925050509392505050565b5f819050919050565b5f6125ab6125a66125a184611e34565b612588565b611e34565b9050919050565b5f819050919050565b6125c483612591565b6125d86125d0826125b2565b848454612537565b825550505050565b5f90565b6125ec6125e0565b6125f78184846125bb565b505050565b5b8181101561261a5761260f5f826125e4565b6001810190506125fd565b5050565b601f82111561265f576126308161250a565b6126398461251c565b81016020851015612648578190505b61265c6126548561251c565b8301826125fc565b50505b505050565b5f82821c905092915050565b5f61267f5f1984600802612664565b1980831691505092915050565b5f6126978383612670565b9150826002028217905092915050565b6126b082611da4565b67ffffffffffffffff8111156126c9576126c8611f5a565b5b6126d382546124da565b6126de82828561261e565b5f60209050601f83116001811461270f575f84156126fd578287015190505b612707858261268c565b86555061276e565b601f19841661271d8661250a565b5f5b828110156127445784890151825560018201915060208501945060208101905061271f565b86831015612761578489015161275d601f891682612670565b8355505b6001600288020188555050505b505050505050565b5f6060820190506127895f830186611ec2565b6127966020830185612140565b6127a36040830184611ec2565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61280f82611e34565b915061281a83611e34565b9250828201905080821115612832576128316127d8565b5b92915050565b7f4552433732314d657461646174613a2055524920717565727920666f72206e6f5f8201527f6e6578697374656e7420746f6b656e0000000000000000000000000000000000602082015250565b5f612892602f83611dae565b915061289d82612838565b604082019050919050565b5f6020820190508181035f8301526128bf81612886565b9050919050565b5f81905092915050565b7f7b000000000000000000000000000000000000000000000000000000000000005f82015250565b5f6129046001836128c6565b915061290f826128d0565b600182019050919050565b7f226465736372697074696f6e223a20225852204f6e65204865726f65732044725f8201527f6f702e222c200000000000000000000000000000000000000000000000000000602082015250565b5f6129746026836128c6565b915061297f8261291a565b602682019050919050565b7f2265787465726e616c5f75726c223a202268747470733a2f2f78726f6e652e6e5f8201527f6574776f726b2f6865726f657364726f70222c20000000000000000000000000602082015250565b5f6129e46034836128c6565b91506129ef8261298a565b603482019050919050565b7f226e616d65223a20225852204f6e65204865726f65732044726f7020230000005f82015250565b5f612a2e601d836128c6565b9150612a39826129fa565b601d82019050919050565b5f612a4e82611da4565b612a5881856128c6565b9350612a68818560208601611dbe565b80840191505092915050565b7f222c2000000000000000000000000000000000000000000000000000000000005f82015250565b5f612aa86003836128c6565b9150612ab382612a74565b600382019050919050565b7f22696d616765223a2022000000000000000000000000000000000000000000005f82015250565b5f612af2600a836128c6565b9150612afd82612abe565b600a82019050919050565b5f8154612b14816124da565b612b1e81866128c6565b9450600182165f8114612b385760018114612b4d57612b7f565b60ff1983168652811515820286019350612b7f565b612b568561250a565b5f5b83811015612b7757815481890152600182019150602081019050612b58565b838801955050505b50505092915050565b7f22616e696d6174696f6e5f75726c223a202200000000000000000000000000005f82015250565b5f612bbc6012836128c6565b9150612bc782612b88565b601282019050919050565b7f2261747472696275746573223a205b5d000000000000000000000000000000005f82015250565b5f612c066010836128c6565b9150612c1182612bd2565b601082019050919050565b7f7d000000000000000000000000000000000000000000000000000000000000005f82015250565b5f612c506001836128c6565b9150612c5b82612c1c565b600182019050919050565b5f612c70826128f8565b9150612c7b82612968565b9150612c86826129d8565b9150612c9182612a22565b9150612c9d8286612a44565b9150612ca882612a9c565b9150612cb382612ae6565b9150612cbf8285612b08565b9150612cca82612a9c565b9150612cd582612bb0565b9150612ce18284612b08565b9150612cec82612a9c565b9150612cf782612bfa565b9150612d0282612c44565b9150819050949350505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000005f82015250565b5f612d43601d836128c6565b9150612d4e82612d0f565b601d82019050919050565b5f612d6382612d37565b9150612d6f8284612a44565b915081905092915050565b5f81519050919050565b5f82825260208201905092915050565b5f612d9e82612d7a565b612da88185612d84565b9350612db8818560208601611dbe565b612dc181611dcc565b840191505092915050565b5f608082019050612ddf5f830187611ec2565b612dec6020830186611ec2565b612df96040830185612140565b8181036060830152612e0b8184612d94565b905095945050505050565b5f81519050612e2481611d1c565b92915050565b5f60208284031215612e3f57612e3e611ce9565b5b5f612e4c84828501612e16565b91505092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f604082019050612e955f830185611ec2565b612ea26020830184612140565b9392505050565b5f612eb382611e34565b9150612ebe83611e34565b9250828202612ecc81611e34565b91508282048414831517612ee357612ee26127d8565b5b5092915050565b5f612ef482611e34565b9150612eff83611e34565b925082612f0f57612f0e612e55565b5b82820490509291505056fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa264697066735822122082e9b99f2cd61c7b5dbc3ca3a16c7064a78280f478cee21f1448e0fc4de0f13464736f6c634300081a0033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000160000000000000000000000000000000000000000000000000000000000000005668747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f6865726f5f64726f705f78725f6e66742d6c617267652d5f302d30302d30312d32305f2e706e6700000000000000000000000000000000000000000000000000000000000000000000000000000000004768747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f4845524f2b44524f502b58522b4e46545f3130312e6d703400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004468747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d312e616d617a6f6e6177732e636f6d2f636f6e74726163744d657461646174612e6a736f6e00000000000000000000000000000000000000000000000000000000
-----Decoded View---------------
Arg [0] : _baseImageURL (string): https://vadn-assets.s3.eu-west-1.amazonaws.com/hero_drop_xr_nft-large-_0-00-01-20_.png
Arg [1] : _baseAnimationURL (string): https://vadn-assets.s3.eu-west-1.amazonaws.com/HERO+DROP+XR+NFT_101.mp4
Arg [2] : _baseContractURI (string): https://vadn-assets.s3.eu-west-1.amazonaws.com/contractMetadata.json
-----Encoded View---------------
15 Constructor Arguments found :
Arg [0] : 0000000000000000000000000000000000000000000000000000000000000060
Arg [1] : 00000000000000000000000000000000000000000000000000000000000000e0
Arg [2] : 0000000000000000000000000000000000000000000000000000000000000160
Arg [3] : 0000000000000000000000000000000000000000000000000000000000000056
Arg [4] : 68747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d31
Arg [5] : 2e616d617a6f6e6177732e636f6d2f6865726f5f64726f705f78725f6e66742d
Arg [6] : 6c617267652d5f302d30302d30312d32305f2e706e6700000000000000000000
Arg [7] : 0000000000000000000000000000000000000000000000000000000000000047
Arg [8] : 68747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d31
Arg [9] : 2e616d617a6f6e6177732e636f6d2f4845524f2b44524f502b58522b4e46545f
Arg [10] : 3130312e6d703400000000000000000000000000000000000000000000000000
Arg [11] : 0000000000000000000000000000000000000000000000000000000000000044
Arg [12] : 68747470733a2f2f7661646e2d6173736574732e73332e65752d776573742d31
Arg [13] : 2e616d617a6f6e6177732e636f6d2f636f6e74726163744d657461646174612e
Arg [14] : 6a736f6e00000000000000000000000000000000000000000000000000000000
Deployed Bytecode Sourcemap
126841:5037:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;97227:305;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;98058:91;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;99230:158;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;99049:115;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;129765:207;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;99899:588;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;100558:134;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;130231:160;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;97871:120;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;97596:213;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3559:103;;;:::i;:::-;;127004:26;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;2884:87;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;98218:95;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;99460:146;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;128532:534;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;100763:236;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;130539:1119;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;129304:299;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;131743:132;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;99677:155;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;3817:220;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;97227:305;97329:4;97381:25;97366:40;;;:11;:40;;;;:105;;;;97438:33;97423:48;;;:11;:48;;;;97366:105;:158;;;;97488:36;97512:11;97488:23;:36::i;:::-;97366:158;97346:178;;97227:305;;;:::o;98058:91::-;98103:13;98136:5;98129:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;98058:91;:::o;99230:158::-;99297:7;99317:22;99331:7;99317:13;:22::i;:::-;;99359:21;99372:7;99359:12;:21::i;:::-;99352:28;;99230:158;;;:::o;99049:115::-;99121:35;99130:2;99134:7;99143:12;:10;:12::i;:::-;99121:8;:35::i;:::-;99049:115;;:::o;129765:207::-;2770:13;:11;:13::i;:::-;129912:16:::1;129894:15;:34;;;;;;:::i;:::-;;129944:20;;;;;;;;;;129765:207:::0;:::o;99899:588::-;100008:1;99994:16;;:2;:16;;;99990:89;;100064:1;100034:33;;;;;;;;;;;:::i;:::-;;;;;;;;99990:89;100300:21;100324:34;100332:2;100336:7;100345:12;:10;:12::i;:::-;100324:7;:34::i;:::-;100300:58;;100390:4;100373:21;;:13;:21;;;100369:111;;100439:4;100445:7;100454:13;100418:50;;;;;;;;;;;;;:::i;:::-;;;;;;;;100369:111;99979:508;99899:588;;;:::o;100558:134::-;100645:39;100662:4;100668:2;100672:7;100645:39;;;;;;;;;;;;:16;:39::i;:::-;100558:134;;;:::o;130231:160::-;130332:4;130382:1;130362:17;130372:6;130362:9;:17::i;:::-;:21;130355:28;;130231:160;;;:::o;97871:120::-;97934:7;97961:22;97975:7;97961:13;:22::i;:::-;97954:29;;97871:120;;;:::o;97596:213::-;97659:7;97700:1;97683:19;;:5;:19;;;97679:89;;97753:1;97726:30;;;;;;;;;;;:::i;:::-;;;;;;;;97679:89;97785:9;:16;97795:5;97785:16;;;;;;;;;;;;;;;;97778:23;;97596:213;;;:::o;3559:103::-;2770:13;:11;:13::i;:::-;3624:30:::1;3651:1;3624:18;:30::i;:::-;3559:103::o:0;127004:26::-;;;;:::o;2884:87::-;2930:7;2957:6;;;;;;;;;;;2950:13;;2884:87;:::o;98218:95::-;98265:13;98298:7;98291:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;98218:95;:::o;99460:146::-;99546:52;99565:12;:10;:12::i;:::-;99579:8;99589;99546:18;:52::i;:::-;99460:146;;:::o;128532:534::-;2770:13;:11;:13::i;:::-;128654:21:::1;128678:10;:17;128654:41;;128706:22;128731:11;;128706:36;;128760:9;128755:263;128779:13;128775:1;:17;128755:263;;;128814:40;128824:10;128835:1;128824:13;;;;;;;;:::i;:::-;;;;;;;;128839:14;128814:9;:40::i;:::-;128869:44;128879:10;128890:1;128879:13;;;;;;;;:::i;:::-;;;;;;;;128911:1;128894:14;:18;;;;:::i;:::-;128869:9;:44::i;:::-;128928;128938:10;128949:1;128938:13;;;;;;;;:::i;:::-;;;;;;;;128970:1;128953:14;:18;;;;:::i;:::-;128928:9;:44::i;:::-;129005:1;128987:19;;;;;:::i;:::-;;;128794:3;;;;;;;128755:263;;;;129044:14;129030:11;:28;;;;128643:423;;128532:534:::0;:::o;100763:236::-;100877:31;100890:4;100896:2;100900:7;100877:12;:31::i;:::-;100919:72;100953:12;:10;:12::i;:::-;100967:4;100973:2;100977:7;100986:4;100919:33;:72::i;:::-;100763:236;;;;:::o;130539:1119::-;130679:13;130730:11;;130719:8;:22;130711:82;;;;;;;;;;;;:::i;:::-;;;;;;;;;130846:18;130867:643;131202:26;131219:8;131202:16;:26::i;:::-;131276:12;131344:16;130948:517;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;130867:13;:643::i;:::-;130846:664;;131644:4;131594:55;;;;;;;;:::i;:::-;;;;;;;;;;;;;131580:70;;;130539:1119;;;:::o;129304:299::-;2770:13;:11;:13::i;:::-;129484::::1;129469:12;:28;;;;;;:::i;:::-;;129527:17;129508:16;:36;;;;;;:::i;:::-;;129562:33;129577:17;129562:33;;;;;;:::i;:::-;;;;;;;;129304:299:::0;;:::o;131743:132::-;131814:13;131852:15;131845:22;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;131743:132;:::o;99677:155::-;99765:4;99789:18;:25;99808:5;99789:25;;;;;;;;;;;;;;;:35;99815:8;99789:35;;;;;;;;;;;;;;;;;;;;;;;;;99782:42;;99677:155;;;;:::o;3817:220::-;2770:13;:11;:13::i;:::-;3922:1:::1;3902:22;;:8;:22;;::::0;3898:93:::1;;3976:1;3948:31;;;;;;;;;;;:::i;:::-;;;;;;;;3898:93;4001:28;4020:8;4001:18;:28::i;:::-;3817:220:::0;:::o;21860:148::-;21936:4;21975:25;21960:40;;;:11;:40;;;;21953:47;;21860:148;;;:::o;112281:247::-;112344:7;112364:13;112380:17;112389:7;112380:8;:17::i;:::-;112364:33;;112429:1;112412:19;;:5;:19;;;112408:90;;112478:7;112455:31;;;;;;;;;;;:::i;:::-;;;;;;;;112408:90;112515:5;112508:12;;;112281:247;;;:::o;101762:129::-;101832:7;101859:15;:24;101875:7;101859:24;;;;;;;;;;;;;;;;;;;;;101852:31;;101762:129;;;:::o;866:98::-;919:7;946:10;939:17;;866:98;:::o;110513:122::-;110594:33;110603:2;110607:7;110616:4;110622;110594:8;:33::i;:::-;110513:122;;;:::o;3049:166::-;3120:12;:10;:12::i;:::-;3109:23;;:7;:5;:7::i;:::-;:23;;;3105:103;;3183:12;:10;:12::i;:::-;3156:40;;;;;;;;;;;:::i;:::-;;;;;;;;3105:103;3049:166::o;104723:824::-;104809:7;104829:12;104844:17;104853:7;104844:8;:17::i;:::-;104829:32;;104940:1;104924:18;;:4;:18;;;104920:88;;104959:37;104976:4;104982;104988:7;104959:16;:37::i;:::-;104920:88;105071:1;105055:18;;:4;:18;;;105051:263;;105173:48;105190:1;105194:7;105211:1;105215:5;105173:8;:48::i;:::-;105286:1;105267:9;:15;105277:4;105267:15;;;;;;;;;;;;;;;;:20;;;;;;;;;;;105051:263;105344:1;105330:16;;:2;:16;;;105326:111;;105409:1;105392:9;:13;105402:2;105392:13;;;;;;;;;;;;;;;;:18;;;;;;;;;;;105326:111;105468:2;105449:7;:16;105457:7;105449:16;;;;;;;;;;;;:21;;;;;;;;;;;;;;;;;;105507:7;105503:2;105488:27;;105497:4;105488:27;;;;;;;;;;;;105535:4;105528:11;;;104723:824;;;;;:::o;4197:191::-;4271:16;4290:6;;;;;;;;;;;4271:25;;4316:8;4307:6;;:17;;;;;;;;;;;;;;;;;;4371:8;4340:40;;4361:8;4340:40;;;;;;;;;;;;4260:128;4197:191;:::o;111720:318::-;111848:1;111828:22;;:8;:22;;;111824:93;;111896:8;111874:31;;;;;;;;;;;:::i;:::-;;;;;;;;111824:93;111965:8;111927:18;:25;111946:5;111927:25;;;;;;;;;;;;;;;:35;111953:8;111927:35;;;;;;;;;;;;;;;;:46;;;;;;;;;;;;;;;;;;112011:8;111989:41;;112004:5;111989:41;;;112021:8;111989:41;;;;;;:::i;:::-;;;;;;;;111720:318;;;:::o;106581:102::-;106649:26;106659:2;106663:7;106649:26;;;;;;;;;;;;:9;:26::i;:::-;106581:102;;:::o;20094:948::-;20298:1;20281:2;:14;;;:18;20277:758;;;20336:2;20320:36;;;20357:8;20367:4;20373:7;20382:4;20320:67;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;20316:708;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;20700:1;20683:6;:13;:18;20679:330;;20825:2;20789:39;;;;;;;;;;;:::i;:::-;;;;;;;;20679:330;20959:6;20953:13;20944:6;20940:2;20936:15;20929:38;20316:708;20445:41;;;20435:51;;;:6;:51;;;;20431:185;;20593:2;20557:39;;;;;;;;;;;:::i;:::-;;;;;;;;20431:185;20388:243;20277:758;20094:948;;;;;:::o;92561:650::-;92617:13;92668:14;92705:1;92685:17;92696:5;92685:10;:17::i;:::-;:21;92668:38;;92721:20;92755:6;92744:18;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;92721:41;;92777:11;92874:6;92870:2;92866:15;92858:6;92854:28;92847:35;;92911:254;92918:4;92911:254;;;92943:5;;;;;;;;93049:10;93044:2;93037:5;93033:14;93028:32;93023:3;93015:46;93107:2;93098:11;;;;;;:::i;:::-;;;;;93141:1;93132:5;:10;92911:254;93128:21;92911:254;93186:6;93179:13;;;;;92561:650;;;:::o;121856:126::-;121914:13;121947:27;121955:4;121961:6;;;;;;;;;;;;;;;;;121969:4;121947:7;:27::i;:::-;121940:34;;121856:126;;;:::o;101524:117::-;101590:7;101617;:16;101625:7;101617:16;;;;;;;;;;;;;;;;;;;;;101610:23;;101524:117;;;:::o;110823:678::-;110985:9;:31;;;;111014:1;110998:18;;:4;:18;;;;110985:31;110981:471;;;111033:13;111049:22;111063:7;111049:13;:22::i;:::-;111033:38;;111218:1;111202:18;;:4;:18;;;;:35;;;;;111233:4;111224:13;;:5;:13;;;;111202:35;:69;;;;;111242:29;111259:5;111266:4;111242:16;:29::i;:::-;111241:30;111202:69;111198:144;;;111321:4;111299:27;;;;;;;;;;;:::i;:::-;;;;;;;;111198:144;111362:9;111358:83;;;111417:7;111413:2;111397:28;;111406:5;111397:28;;;;;;;;;;;;111358:83;111018:434;110981:471;111491:2;111464:15;:24;111480:7;111464:24;;;;;;;;;;;;:29;;;;;;;;;;;;;;;;;;110823:678;;;;:::o;102930:376::-;103043:38;103057:5;103064:7;103073;103043:13;:38::i;:::-;103038:261;;103119:1;103102:19;;:5;:19;;;103098:190;;103172:7;103149:31;;;;;;;;;;;:::i;:::-;;;;;;;;103098:190;103255:7;103264;103228:44;;;;;;;;;;;;:::i;:::-;;;;;;;;103038:261;102930:376;;;:::o;106910:210::-;107005:18;107011:2;107015:7;107005:5;:18::i;:::-;107034:78;107068:12;:10;:12::i;:::-;107090:1;107094:2;107098:7;107107:4;107034:33;:78::i;:::-;106910:210;;;:::o;86148:948::-;86201:7;86221:14;86238:1;86221:18;;86288:8;86279:5;:17;86275:106;;86326:8;86317:17;;;;;;:::i;:::-;;;;;86363:2;86353:12;;;;86275:106;86408:8;86399:5;:17;86395:106;;86446:8;86437:17;;;;;;:::i;:::-;;;;;86483:2;86473:12;;;;86395:106;86528:8;86519:5;:17;86515:106;;86566:8;86557:17;;;;;;:::i;:::-;;;;;86603:2;86593:12;;;;86515:106;86648:7;86639:5;:16;86635:103;;86685:7;86676:16;;;;;;:::i;:::-;;;;;86721:1;86711:11;;;;86635:103;86765:7;86756:5;:16;86752:103;;86802:7;86793:16;;;;;;:::i;:::-;;;;;86838:1;86828:11;;;;86752:103;86882:7;86873:5;:16;86869:103;;86919:7;86910:16;;;;;;:::i;:::-;;;;;86955:1;86945:11;;;;86869:103;86999:7;86990:5;:16;86986:68;;87037:1;87027:11;;;;86986:68;87082:6;87075:13;;;86148:948;;;:::o;122394:4109::-;122491:13;122743:1;122728:4;:11;:16;122724:31;;122746:9;;;;;;;;;;;;;;;;122724:31;123708:20;123731:11;:69;;123799:1;123794;123780:4;:11;123776:1;:15;;;;:::i;:::-;:19;;;;:::i;:::-;123775:25;;;;:::i;:::-;123731:69;;;123770:1;123765;123751:4;:11;:15;;;;:::i;:::-;123750:21;;;;:::i;:::-;123745:1;:27;;;;:::i;:::-;123731:69;123708:92;;123813:20;123847:12;123836:24;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;123813:47;;124012:1;124005:5;124001:13;124116:4;124108:6;124104:17;124150:4;124198;124192:11;124186:4;124182:22;124450:4;124442:6;124438:17;124493:8;124487:15;124533:4;124523:8;124516:22;124608:1286;124643:6;124634:7;124631:19;124608:1286;;;124749:1;124740:7;124736:15;124725:26;;124788:7;124782:14;125384:4;125376:5;125372:2;125368:14;125364:25;125354:8;125350:40;125344:47;125333:9;125325:67;125438:1;125427:9;125423:17;125410:30;;125530:4;125522:5;125518:2;125514:14;125510:25;125500:8;125496:40;125490:47;125479:9;125471:67;125584:1;125573:9;125569:17;125556:30;;125675:4;125667:5;125664:1;125660:13;125656:24;125646:8;125642:39;125636:46;125625:9;125617:66;125729:1;125718:9;125714:17;125701:30;;125812:4;125805:5;125801:16;125791:8;125787:31;125781:38;125770:9;125762:58;125866:1;125855:9;125851:17;125838:30;;124670:1224;124608:1286;;;125975:10;125965:8;125958:28;126005:11;126002:457;;;126190:1;126183:4;126177:11;126173:19;126215:1;126210:135;;;;126368:1;126363:81;;;;126166:278;;126210:135;126267:4;126263:1;126252:9;126248:17;126240:32;126321:4;126317:1;126306:9;126302:17;126294:32;126210:135;;126363:81;126420:4;126416:1;126405:9;126401:17;126393:32;126166:278;;126002:457;123898:2572;;;;;;126489:6;126482:13;;;;122394:4109;;;;;;:::o;102211:276::-;102314:4;102370:1;102351:21;;:7;:21;;;;:128;;;;;102399:7;102390:16;;:5;:16;;;:52;;;;102410:32;102427:5;102434:7;102410:16;:32::i;:::-;102390:52;:88;;;;102471:7;102446:32;;:21;102459:7;102446:12;:21::i;:::-;:32;;;102390:88;102351:128;102331:148;;102211:276;;;;;:::o;105883:335::-;105965:1;105951:16;;:2;:16;;;105947:89;;106021:1;105991:33;;;;;;;;;;;:::i;:::-;;;;;;;;105947:89;106046:21;106070:32;106078:2;106082:7;106099:1;106070:7;:32::i;:::-;106046:56;;106142:1;106117:27;;:13;:27;;;106113:98;;106196:1;106168:31;;;;;;;;;;;:::i;:::-;;;;;;;;106113:98;105936:282;105883:335;;:::o;7:75:1:-;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:99::-;1570:6;1604:5;1598:12;1588:22;;1518:99;;;:::o;1623:169::-;1707:11;1741:6;1736:3;1729:19;1781:4;1776:3;1772:14;1757:29;;1623:169;;;;:::o;1798:139::-;1887:6;1882:3;1877;1871:23;1928:1;1919:6;1914:3;1910:16;1903:27;1798:139;;;:::o;1943:102::-;1984:6;2035:2;2031:7;2026:2;2019:5;2015:14;2011:28;2001:38;;1943:102;;;:::o;2051:377::-;2139:3;2167:39;2200:5;2167:39;:::i;:::-;2222:71;2286:6;2281:3;2222:71;:::i;:::-;2215:78;;2302:65;2360:6;2355:3;2348:4;2341:5;2337:16;2302:65;:::i;:::-;2392:29;2414:6;2392:29;:::i;:::-;2387:3;2383:39;2376:46;;2143:285;2051:377;;;;:::o;2434:313::-;2547:4;2585:2;2574:9;2570:18;2562:26;;2634:9;2628:4;2624:20;2620:1;2609:9;2605:17;2598:47;2662:78;2735:4;2726:6;2662:78;:::i;:::-;2654:86;;2434:313;;;;:::o;2753:77::-;2790:7;2819:5;2808:16;;2753:77;;;:::o;2836:122::-;2909:24;2927:5;2909:24;:::i;:::-;2902:5;2899:35;2889:63;;2948:1;2945;2938:12;2889:63;2836:122;:::o;2964:139::-;3010:5;3048:6;3035:20;3026:29;;3064:33;3091:5;3064:33;:::i;:::-;2964:139;;;;:::o;3109:329::-;3168:6;3217:2;3205:9;3196:7;3192:23;3188:32;3185:119;;;3223:79;;:::i;:::-;3185:119;3343:1;3368:53;3413:7;3404:6;3393:9;3389:22;3368:53;:::i;:::-;3358:63;;3314:117;3109:329;;;;:::o;3444:126::-;3481:7;3521:42;3514:5;3510:54;3499:65;;3444:126;;;:::o;3576:96::-;3613:7;3642:24;3660:5;3642:24;:::i;:::-;3631:35;;3576:96;;;:::o;3678:118::-;3765:24;3783:5;3765:24;:::i;:::-;3760:3;3753:37;3678:118;;:::o;3802:222::-;3895:4;3933:2;3922:9;3918:18;3910:26;;3946:71;4014:1;4003:9;3999:17;3990:6;3946:71;:::i;:::-;3802:222;;;;:::o;4030:122::-;4103:24;4121:5;4103:24;:::i;:::-;4096:5;4093:35;4083:63;;4142:1;4139;4132:12;4083:63;4030:122;:::o;4158:139::-;4204:5;4242:6;4229:20;4220:29;;4258:33;4285:5;4258:33;:::i;:::-;4158:139;;;;:::o;4303:474::-;4371:6;4379;4428:2;4416:9;4407:7;4403:23;4399:32;4396:119;;;4434:79;;:::i;:::-;4396:119;4554:1;4579:53;4624:7;4615:6;4604:9;4600:22;4579:53;:::i;:::-;4569:63;;4525:117;4681:2;4707:53;4752:7;4743:6;4732:9;4728:22;4707:53;:::i;:::-;4697:63;;4652:118;4303:474;;;;;:::o;4783:117::-;4892:1;4889;4882:12;4906:117;5015:1;5012;5005:12;5029:180;5077:77;5074:1;5067:88;5174:4;5171:1;5164:15;5198:4;5195:1;5188:15;5215:281;5298:27;5320:4;5298:27;:::i;:::-;5290:6;5286:40;5428:6;5416:10;5413:22;5392:18;5380:10;5377:34;5374:62;5371:88;;;5439:18;;:::i;:::-;5371:88;5479:10;5475:2;5468:22;5258:238;5215:281;;:::o;5502:129::-;5536:6;5563:20;;:::i;:::-;5553:30;;5592:33;5620:4;5612:6;5592:33;:::i;:::-;5502:129;;;:::o;5637:308::-;5699:4;5789:18;5781:6;5778:30;5775:56;;;5811:18;;:::i;:::-;5775:56;5849:29;5871:6;5849:29;:::i;:::-;5841:37;;5933:4;5927;5923:15;5915:23;;5637:308;;;:::o;5951:148::-;6049:6;6044:3;6039;6026:30;6090:1;6081:6;6076:3;6072:16;6065:27;5951:148;;;:::o;6105:425::-;6183:5;6208:66;6224:49;6266:6;6224:49;:::i;:::-;6208:66;:::i;:::-;6199:75;;6297:6;6290:5;6283:21;6335:4;6328:5;6324:16;6373:3;6364:6;6359:3;6355:16;6352:25;6349:112;;;6380:79;;:::i;:::-;6349:112;6470:54;6517:6;6512:3;6507;6470:54;:::i;:::-;6189:341;6105:425;;;;;:::o;6550:340::-;6606:5;6655:3;6648:4;6640:6;6636:17;6632:27;6622:122;;6663:79;;:::i;:::-;6622:122;6780:6;6767:20;6805:79;6880:3;6872:6;6865:4;6857:6;6853:17;6805:79;:::i;:::-;6796:88;;6612:278;6550:340;;;;:::o;6896:509::-;6965:6;7014:2;7002:9;6993:7;6989:23;6985:32;6982:119;;;7020:79;;:::i;:::-;6982:119;7168:1;7157:9;7153:17;7140:31;7198:18;7190:6;7187:30;7184:117;;;7220:79;;:::i;:::-;7184:117;7325:63;7380:7;7371:6;7360:9;7356:22;7325:63;:::i;:::-;7315:73;;7111:287;6896:509;;;;:::o;7411:619::-;7488:6;7496;7504;7553:2;7541:9;7532:7;7528:23;7524:32;7521:119;;;7559:79;;:::i;:::-;7521:119;7679:1;7704:53;7749:7;7740:6;7729:9;7725:22;7704:53;:::i;:::-;7694:63;;7650:117;7806:2;7832:53;7877:7;7868:6;7857:9;7853:22;7832:53;:::i;:::-;7822:63;;7777:118;7934:2;7960:53;8005:7;7996:6;7985:9;7981:22;7960:53;:::i;:::-;7950:63;;7905:118;7411:619;;;;;:::o;8036:329::-;8095:6;8144:2;8132:9;8123:7;8119:23;8115:32;8112:119;;;8150:79;;:::i;:::-;8112:119;8270:1;8295:53;8340:7;8331:6;8320:9;8316:22;8295:53;:::i;:::-;8285:63;;8241:117;8036:329;;;;:::o;8371:118::-;8458:24;8476:5;8458:24;:::i;:::-;8453:3;8446:37;8371:118;;:::o;8495:222::-;8588:4;8626:2;8615:9;8611:18;8603:26;;8639:71;8707:1;8696:9;8692:17;8683:6;8639:71;:::i;:::-;8495:222;;;;:::o;8723:116::-;8793:21;8808:5;8793:21;:::i;:::-;8786:5;8783:32;8773:60;;8829:1;8826;8819:12;8773:60;8723:116;:::o;8845:133::-;8888:5;8926:6;8913:20;8904:29;;8942:30;8966:5;8942:30;:::i;:::-;8845:133;;;;:::o;8984:468::-;9049:6;9057;9106:2;9094:9;9085:7;9081:23;9077:32;9074:119;;;9112:79;;:::i;:::-;9074:119;9232:1;9257:53;9302:7;9293:6;9282:9;9278:22;9257:53;:::i;:::-;9247:63;;9203:117;9359:2;9385:50;9427:7;9418:6;9407:9;9403:22;9385:50;:::i;:::-;9375:60;;9330:115;8984:468;;;;;:::o;9458:311::-;9535:4;9625:18;9617:6;9614:30;9611:56;;;9647:18;;:::i;:::-;9611:56;9697:4;9689:6;9685:17;9677:25;;9757:4;9751;9747:15;9739:23;;9458:311;;;:::o;9775:117::-;9884:1;9881;9874:12;9915:710;10011:5;10036:81;10052:64;10109:6;10052:64;:::i;:::-;10036:81;:::i;:::-;10027:90;;10137:5;10166:6;10159:5;10152:21;10200:4;10193:5;10189:16;10182:23;;10253:4;10245:6;10241:17;10233:6;10229:30;10282:3;10274:6;10271:15;10268:122;;;10301:79;;:::i;:::-;10268:122;10416:6;10399:220;10433:6;10428:3;10425:15;10399:220;;;10508:3;10537:37;10570:3;10558:10;10537:37;:::i;:::-;10532:3;10525:50;10604:4;10599:3;10595:14;10588:21;;10475:144;10459:4;10454:3;10450:14;10443:21;;10399:220;;;10403:21;10017:608;;9915:710;;;;;:::o;10648:370::-;10719:5;10768:3;10761:4;10753:6;10749:17;10745:27;10735:122;;10776:79;;:::i;:::-;10735:122;10893:6;10880:20;10918:94;11008:3;11000:6;10993:4;10985:6;10981:17;10918:94;:::i;:::-;10909:103;;10725:293;10648:370;;;;:::o;11024:539::-;11108:6;11157:2;11145:9;11136:7;11132:23;11128:32;11125:119;;;11163:79;;:::i;:::-;11125:119;11311:1;11300:9;11296:17;11283:31;11341:18;11333:6;11330:30;11327:117;;;11363:79;;:::i;:::-;11327:117;11468:78;11538:7;11529:6;11518:9;11514:22;11468:78;:::i;:::-;11458:88;;11254:302;11024:539;;;;:::o;11569:307::-;11630:4;11720:18;11712:6;11709:30;11706:56;;;11742:18;;:::i;:::-;11706:56;11780:29;11802:6;11780:29;:::i;:::-;11772:37;;11864:4;11858;11854:15;11846:23;;11569:307;;;:::o;11882:423::-;11959:5;11984:65;12000:48;12041:6;12000:48;:::i;:::-;11984:65;:::i;:::-;11975:74;;12072:6;12065:5;12058:21;12110:4;12103:5;12099:16;12148:3;12139:6;12134:3;12130:16;12127:25;12124:112;;;12155:79;;:::i;:::-;12124:112;12245:54;12292:6;12287:3;12282;12245:54;:::i;:::-;11965:340;11882:423;;;;;:::o;12324:338::-;12379:5;12428:3;12421:4;12413:6;12409:17;12405:27;12395:122;;12436:79;;:::i;:::-;12395:122;12553:6;12540:20;12578:78;12652:3;12644:6;12637:4;12629:6;12625:17;12578:78;:::i;:::-;12569:87;;12385:277;12324:338;;;;:::o;12668:943::-;12763:6;12771;12779;12787;12836:3;12824:9;12815:7;12811:23;12807:33;12804:120;;;12843:79;;:::i;:::-;12804:120;12963:1;12988:53;13033:7;13024:6;13013:9;13009:22;12988:53;:::i;:::-;12978:63;;12934:117;13090:2;13116:53;13161:7;13152:6;13141:9;13137:22;13116:53;:::i;:::-;13106:63;;13061:118;13218:2;13244:53;13289:7;13280:6;13269:9;13265:22;13244:53;:::i;:::-;13234:63;;13189:118;13374:2;13363:9;13359:18;13346:32;13405:18;13397:6;13394:30;13391:117;;;13427:79;;:::i;:::-;13391:117;13532:62;13586:7;13577:6;13566:9;13562:22;13532:62;:::i;:::-;13522:72;;13317:287;12668:943;;;;;;;:::o;13617:834::-;13705:6;13713;13762:2;13750:9;13741:7;13737:23;13733:32;13730:119;;;13768:79;;:::i;:::-;13730:119;13916:1;13905:9;13901:17;13888:31;13946:18;13938:6;13935:30;13932:117;;;13968:79;;:::i;:::-;13932:117;14073:63;14128:7;14119:6;14108:9;14104:22;14073:63;:::i;:::-;14063:73;;13859:287;14213:2;14202:9;14198:18;14185:32;14244:18;14236:6;14233:30;14230:117;;;14266:79;;:::i;:::-;14230:117;14371:63;14426:7;14417:6;14406:9;14402:22;14371:63;:::i;:::-;14361:73;;14156:288;13617:834;;;;;:::o;14457:474::-;14525:6;14533;14582:2;14570:9;14561:7;14557:23;14553:32;14550:119;;;14588:79;;:::i;:::-;14550:119;14708:1;14733:53;14778:7;14769:6;14758:9;14754:22;14733:53;:::i;:::-;14723:63;;14679:117;14835:2;14861:53;14906:7;14897:6;14886:9;14882:22;14861:53;:::i;:::-;14851:63;;14806:118;14457:474;;;;;:::o;14937:180::-;14985:77;14982:1;14975:88;15082:4;15079:1;15072:15;15106:4;15103:1;15096:15;15123:320;15167:6;15204:1;15198:4;15194:12;15184:22;;15251:1;15245:4;15241:12;15272:18;15262:81;;15328:4;15320:6;15316:17;15306:27;;15262:81;15390:2;15382:6;15379:14;15359:18;15356:38;15353:84;;15409:18;;:::i;:::-;15353:84;15174:269;15123:320;;;:::o;15449:141::-;15498:4;15521:3;15513:11;;15544:3;15541:1;15534:14;15578:4;15575:1;15565:18;15557:26;;15449:141;;;:::o;15596:93::-;15633:6;15680:2;15675;15668:5;15664:14;15660:23;15650:33;;15596:93;;;:::o;15695:107::-;15739:8;15789:5;15783:4;15779:16;15758:37;;15695:107;;;;:::o;15808:393::-;15877:6;15927:1;15915:10;15911:18;15950:97;15980:66;15969:9;15950:97;:::i;:::-;16068:39;16098:8;16087:9;16068:39;:::i;:::-;16056:51;;16140:4;16136:9;16129:5;16125:21;16116:30;;16189:4;16179:8;16175:19;16168:5;16165:30;16155:40;;15884:317;;15808:393;;;;;:::o;16207:60::-;16235:3;16256:5;16249:12;;16207:60;;;:::o;16273:142::-;16323:9;16356:53;16374:34;16383:24;16401:5;16383:24;:::i;:::-;16374:34;:::i;:::-;16356:53;:::i;:::-;16343:66;;16273:142;;;:::o;16421:75::-;16464:3;16485:5;16478:12;;16421:75;;;:::o;16502:269::-;16612:39;16643:7;16612:39;:::i;:::-;16673:91;16722:41;16746:16;16722:41;:::i;:::-;16714:6;16707:4;16701:11;16673:91;:::i;:::-;16667:4;16660:105;16578:193;16502:269;;;:::o;16777:73::-;16822:3;16777:73;:::o;16856:189::-;16933:32;;:::i;:::-;16974:65;17032:6;17024;17018:4;16974:65;:::i;:::-;16909:136;16856:189;;:::o;17051:186::-;17111:120;17128:3;17121:5;17118:14;17111:120;;;17182:39;17219:1;17212:5;17182:39;:::i;:::-;17155:1;17148:5;17144:13;17135:22;;17111:120;;;17051:186;;:::o;17243:543::-;17344:2;17339:3;17336:11;17333:446;;;17378:38;17410:5;17378:38;:::i;:::-;17462:29;17480:10;17462:29;:::i;:::-;17452:8;17448:44;17645:2;17633:10;17630:18;17627:49;;;17666:8;17651:23;;17627:49;17689:80;17745:22;17763:3;17745:22;:::i;:::-;17735:8;17731:37;17718:11;17689:80;:::i;:::-;17348:431;;17333:446;17243:543;;;:::o;17792:117::-;17846:8;17896:5;17890:4;17886:16;17865:37;;17792:117;;;;:::o;17915:169::-;17959:6;17992:51;18040:1;18036:6;18028:5;18025:1;18021:13;17992:51;:::i;:::-;17988:56;18073:4;18067;18063:15;18053:25;;17966:118;17915:169;;;;:::o;18089:295::-;18165:4;18311:29;18336:3;18330:4;18311:29;:::i;:::-;18303:37;;18373:3;18370:1;18366:11;18360:4;18357:21;18349:29;;18089:295;;;;:::o;18389:1395::-;18506:37;18539:3;18506:37;:::i;:::-;18608:18;18600:6;18597:30;18594:56;;;18630:18;;:::i;:::-;18594:56;18674:38;18706:4;18700:11;18674:38;:::i;:::-;18759:67;18819:6;18811;18805:4;18759:67;:::i;:::-;18853:1;18877:4;18864:17;;18909:2;18901:6;18898:14;18926:1;18921:618;;;;19583:1;19600:6;19597:77;;;19649:9;19644:3;19640:19;19634:26;19625:35;;19597:77;19700:67;19760:6;19753:5;19700:67;:::i;:::-;19694:4;19687:81;19556:222;18891:887;;18921:618;18973:4;18969:9;18961:6;18957:22;19007:37;19039:4;19007:37;:::i;:::-;19066:1;19080:208;19094:7;19091:1;19088:14;19080:208;;;19173:9;19168:3;19164:19;19158:26;19150:6;19143:42;19224:1;19216:6;19212:14;19202:24;;19271:2;19260:9;19256:18;19243:31;;19117:4;19114:1;19110:12;19105:17;;19080:208;;;19316:6;19307:7;19304:19;19301:179;;;19374:9;19369:3;19365:19;19359:26;19417:48;19459:4;19451:6;19447:17;19436:9;19417:48;:::i;:::-;19409:6;19402:64;19324:156;19301:179;19526:1;19522;19514:6;19510:14;19506:22;19500:4;19493:36;18928:611;;;18891:887;;18481:1303;;;18389:1395;;:::o;19790:442::-;19939:4;19977:2;19966:9;19962:18;19954:26;;19990:71;20058:1;20047:9;20043:17;20034:6;19990:71;:::i;:::-;20071:72;20139:2;20128:9;20124:18;20115:6;20071:72;:::i;:::-;20153;20221:2;20210:9;20206:18;20197:6;20153:72;:::i;:::-;19790:442;;;;;;:::o;20238:180::-;20286:77;20283:1;20276:88;20383:4;20380:1;20373:15;20407:4;20404:1;20397:15;20424:180;20472:77;20469:1;20462:88;20569:4;20566:1;20559:15;20593:4;20590:1;20583:15;20610:191;20650:3;20669:20;20687:1;20669:20;:::i;:::-;20664:25;;20703:20;20721:1;20703:20;:::i;:::-;20698:25;;20746:1;20743;20739:9;20732:16;;20767:3;20764:1;20761:10;20758:36;;;20774:18;;:::i;:::-;20758:36;20610:191;;;;:::o;20807:234::-;20947:34;20943:1;20935:6;20931:14;20924:58;21016:17;21011:2;21003:6;20999:15;20992:42;20807:234;:::o;21047:366::-;21189:3;21210:67;21274:2;21269:3;21210:67;:::i;:::-;21203:74;;21286:93;21375:3;21286:93;:::i;:::-;21404:2;21399:3;21395:12;21388:19;;21047:366;;;:::o;21419:419::-;21585:4;21623:2;21612:9;21608:18;21600:26;;21672:9;21666:4;21662:20;21658:1;21647:9;21643:17;21636:47;21700:131;21826:4;21700:131;:::i;:::-;21692:139;;21419:419;;;:::o;21844:148::-;21946:11;21983:3;21968:18;;21844:148;;;;:::o;21998:155::-;22138:3;22134:1;22126:6;22122:14;22115:27;21998:155;:::o;22163:416::-;22323:3;22348:84;22430:1;22425:3;22348:84;:::i;:::-;22341:91;;22445:93;22534:3;22445:93;:::i;:::-;22567:1;22562:3;22558:11;22551:18;;22163:416;;;:::o;22589:327::-;22733:66;22729:1;22721:6;22717:14;22710:90;22838:66;22833:2;22825:6;22821:15;22814:91;22589:327;:::o;22926:418::-;23086:3;23111:85;23193:2;23188:3;23111:85;:::i;:::-;23104:92;;23209:93;23298:3;23209:93;:::i;:::-;23331:2;23326:3;23322:12;23315:19;;22926:418;;;:::o;23354:327::-;23498:66;23494:1;23486:6;23482:14;23475:90;23603:66;23598:2;23590:6;23586:15;23579:91;23354:327;:::o;23691:418::-;23851:3;23876:85;23958:2;23953:3;23876:85;:::i;:::-;23869:92;;23974:93;24063:3;23974:93;:::i;:::-;24096:2;24091:3;24087:12;24080:19;;23691:418;;;:::o;24119:222::-;24263:66;24259:1;24251:6;24247:14;24240:90;24119:222;:::o;24351:418::-;24511:3;24536:85;24618:2;24613:3;24536:85;:::i;:::-;24529:92;;24634:93;24723:3;24634:93;:::i;:::-;24756:2;24751:3;24747:12;24740:19;;24351:418;;;:::o;24779:410::-;24885:3;24917:39;24950:5;24917:39;:::i;:::-;24976:89;25058:6;25053:3;24976:89;:::i;:::-;24969:96;;25078:65;25136:6;25131:3;25124:4;25117:5;25113:16;25078:65;:::i;:::-;25172:6;25167:3;25163:16;25156:23;;24889:300;24779:410;;;;:::o;25199:222::-;25343:66;25339:1;25331:6;25327:14;25320:90;25199:222;:::o;25431:416::-;25591:3;25616:84;25698:1;25693:3;25616:84;:::i;:::-;25609:91;;25713:93;25802:3;25713:93;:::i;:::-;25835:1;25830:3;25826:11;25819:18;;25431:416;;;:::o;25857:222::-;26001:66;25997:1;25989:6;25985:14;25978:90;25857:222;:::o;26089:418::-;26249:3;26274:85;26356:2;26351:3;26274:85;:::i;:::-;26267:92;;26372:93;26461:3;26372:93;:::i;:::-;26494:2;26489:3;26485:12;26478:19;;26089:418;;;:::o;26545:954::-;26648:3;26689:5;26683:12;26722:36;26748:9;26722:36;:::i;:::-;26778:89;26860:6;26855:3;26778:89;:::i;:::-;26771:96;;26902:1;26891:9;26887:17;26922:1;26917:182;;;;27117:1;27112:377;;;;26880:609;;26917:182;27009:4;27005:9;26994;26990:25;26985:3;26978:38;27075:6;27068:14;27061:22;27053:6;27049:35;27044:3;27040:45;27033:52;;26917:182;;27112:377;27187:38;27219:5;27187:38;:::i;:::-;27251:1;27269:166;27283:6;27280:1;27277:13;27269:166;;;27361:7;27355:14;27351:1;27346:3;27342:11;27335:35;27415:1;27406:7;27402:15;27391:26;;27305:4;27302:1;27298:12;27293:17;;27269:166;;;27468:6;27463:3;27459:16;27452:23;;27119:370;;26880:609;;26652:847;;26545:954;;;;:::o;27509:222::-;27653:66;27649:1;27641:6;27637:14;27630:90;27509:222;:::o;27741:418::-;27901:3;27926:85;28008:2;28003:3;27926:85;:::i;:::-;27919:92;;28024:93;28113:3;28024:93;:::i;:::-;28146:2;28141:3;28137:12;28130:19;;27741:418;;;:::o;28169:222::-;28313:66;28309:1;28301:6;28297:14;28290:90;28169:222;:::o;28401:418::-;28561:3;28586:85;28668:2;28663:3;28586:85;:::i;:::-;28579:92;;28684:93;28773:3;28684:93;:::i;:::-;28806:2;28801:3;28797:12;28790:19;;28401:418;;;:::o;28829:151::-;28969:3;28965:1;28957:6;28953:14;28946:27;28829:151;:::o;28986:400::-;29146:3;29167:84;29249:1;29244:3;29167:84;:::i;:::-;29160:91;;29260:93;29349:3;29260:93;:::i;:::-;29378:1;29373:3;29369:11;29362:18;;28986:400;;;:::o;29392:3509::-;30725:3;30747:148;30891:3;30747:148;:::i;:::-;30740:155;;30912:148;31056:3;30912:148;:::i;:::-;30905:155;;31077:148;31221:3;31077:148;:::i;:::-;31070:155;;31242:148;31386:3;31242:148;:::i;:::-;31235:155;;31407:95;31498:3;31489:6;31407:95;:::i;:::-;31400:102;;31519:148;31663:3;31519:148;:::i;:::-;31512:155;;31684:148;31828:3;31684:148;:::i;:::-;31677:155;;31849:92;31937:3;31928:6;31849:92;:::i;:::-;31842:99;;31958:148;32102:3;31958:148;:::i;:::-;31951:155;;32123:148;32267:3;32123:148;:::i;:::-;32116:155;;32288:92;32376:3;32367:6;32288:92;:::i;:::-;32281:99;;32397:148;32541:3;32397:148;:::i;:::-;32390:155;;32562:148;32706:3;32562:148;:::i;:::-;32555:155;;32727:148;32871:3;32727:148;:::i;:::-;32720:155;;32892:3;32885:10;;29392:3509;;;;;;:::o;32907:179::-;33047:31;33043:1;33035:6;33031:14;33024:55;32907:179;:::o;33092:402::-;33252:3;33273:85;33355:2;33350:3;33273:85;:::i;:::-;33266:92;;33367:93;33456:3;33367:93;:::i;:::-;33485:2;33480:3;33476:12;33469:19;;33092:402;;;:::o;33500:541::-;33733:3;33755:148;33899:3;33755:148;:::i;:::-;33748:155;;33920:95;34011:3;34002:6;33920:95;:::i;:::-;33913:102;;34032:3;34025:10;;33500:541;;;;:::o;34047:98::-;34098:6;34132:5;34126:12;34116:22;;34047:98;;;:::o;34151:168::-;34234:11;34268:6;34263:3;34256:19;34308:4;34303:3;34299:14;34284:29;;34151:168;;;;:::o;34325:373::-;34411:3;34439:38;34471:5;34439:38;:::i;:::-;34493:70;34556:6;34551:3;34493:70;:::i;:::-;34486:77;;34572:65;34630:6;34625:3;34618:4;34611:5;34607:16;34572:65;:::i;:::-;34662:29;34684:6;34662:29;:::i;:::-;34657:3;34653:39;34646:46;;34415:283;34325:373;;;;:::o;34704:640::-;34899:4;34937:3;34926:9;34922:19;34914:27;;34951:71;35019:1;35008:9;35004:17;34995:6;34951:71;:::i;:::-;35032:72;35100:2;35089:9;35085:18;35076:6;35032:72;:::i;:::-;35114;35182:2;35171:9;35167:18;35158:6;35114:72;:::i;:::-;35233:9;35227:4;35223:20;35218:2;35207:9;35203:18;35196:48;35261:76;35332:4;35323:6;35261:76;:::i;:::-;35253:84;;34704:640;;;;;;;:::o;35350:141::-;35406:5;35437:6;35431:13;35422:22;;35453:32;35479:5;35453:32;:::i;:::-;35350:141;;;;:::o;35497:349::-;35566:6;35615:2;35603:9;35594:7;35590:23;35586:32;35583:119;;;35621:79;;:::i;:::-;35583:119;35741:1;35766:63;35821:7;35812:6;35801:9;35797:22;35766:63;:::i;:::-;35756:73;;35712:127;35497:349;;;;:::o;35852:180::-;35900:77;35897:1;35890:88;35997:4;35994:1;35987:15;36021:4;36018:1;36011:15;36038:332;36159:4;36197:2;36186:9;36182:18;36174:26;;36210:71;36278:1;36267:9;36263:17;36254:6;36210:71;:::i;:::-;36291:72;36359:2;36348:9;36344:18;36335:6;36291:72;:::i;:::-;36038:332;;;;;:::o;36376:410::-;36416:7;36439:20;36457:1;36439:20;:::i;:::-;36434:25;;36473:20;36491:1;36473:20;:::i;:::-;36468:25;;36528:1;36525;36521:9;36550:30;36568:11;36550:30;:::i;:::-;36539:41;;36729:1;36720:7;36716:15;36713:1;36710:22;36690:1;36683:9;36663:83;36640:139;;36759:18;;:::i;:::-;36640:139;36424:362;36376:410;;;;:::o;36792:185::-;36832:1;36849:20;36867:1;36849:20;:::i;:::-;36844:25;;36883:20;36901:1;36883:20;:::i;:::-;36878:25;;36922:1;36912:35;;36927:18;;:::i;:::-;36912:35;36969:1;36966;36962:9;36957:14;;36792:185;;;;:::o
Swarm Source
ipfs://82e9b99f2cd61c7b5dbc3ca3a16c7064a78280f478cee21f1448e0fc4de0f134
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.