ERC-721
Source Code
Overview
Max Total Supply
0 SRR
Holders
1,233
Transfers
-
763 ( -82.34%)
Market
Volume (24H)
0.0005 ETH
Min Price (24H)
$0.10 @ 0.000050 ETH
Max Price (24H)
$0.14 @ 0.000070 ETH
Other Info
Token Contract
Loading...
Loading
Loading...
Loading
Loading...
Loading
| # | Exchange | Pair | Price | 24H Volume | % Volume |
|---|
Contract Name:
SuperRarer
Compiler Version
v0.8.20+commit.a1b79de6
Contract Source Code (Solidity)
/**
*Submitted for verification at Etherscan.io on 2025-04-17
*/
// File: @openzeppelin/contracts/utils/introspection/IERC165.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/IERC165.sol)
pragma solidity ^0.8.20;
/**
* @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/IERC721.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.20;
/**
* @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/IERC721Metadata.sol
// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity ^0.8.20;
/**
* @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/IERC721Receiver.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.20;
/**
* @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/interfaces/draft-IERC6093.sol
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;
/**
* @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/token/ERC721/utils/ERC721Utils.sol
// OpenZeppelin Contracts (last updated v5.3.0) (token/ERC721/utils/ERC721Utils.sol)
pragma solidity ^0.8.20;
/**
* @dev Library that provide common ERC-721 utility functions.
*
* See https://eips.ethereum.org/EIPS/eip-721[ERC-721].
*
* _Available since v5.1._
*/
library ERC721Utils {
/**
* @dev Performs an acceptance check for the provided `operator` by calling {IERC721Receiver-onERC721Received}
* on the `to` address. The `operator` is generally the address that initiated the token transfer (i.e. `msg.sender`).
*
* The acceptance call is not executed and treated as a no-op if the target address doesn't contain code (i.e. an EOA).
* Otherwise, the recipient must implement {IERC721Receiver-onERC721Received} and return the acceptance magic value to accept
* the transfer.
*/
function checkOnERC721Received(
address operator,
address from,
address to,
uint256 tokenId,
bytes memory data
) internal {
if (to.code.length > 0) {
try IERC721Receiver(to).onERC721Received(operator, from, tokenId, data) returns (bytes4 retval) {
if (retval != IERC721Receiver.onERC721Received.selector) {
// Token rejected
revert IERC721Errors.ERC721InvalidReceiver(to);
}
} catch (bytes memory reason) {
if (reason.length == 0) {
// non-IERC721Receiver implementer
revert IERC721Errors.ERC721InvalidReceiver(to);
} else {
assembly ("memory-safe") {
revert(add(32, reason), mload(reason))
}
}
}
}
}
}
// File: @openzeppelin/contracts/utils/Context.sol
// 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/utils/Panic.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol)
pragma solidity ^0.8.20;
/**
* @dev Helper library for emitting standardized panic codes.
*
* ```solidity
* contract Example {
* using Panic for uint256;
*
* // Use any of the declared internal constants
* function foo() { Panic.GENERIC.panic(); }
*
* // Alternatively
* function foo() { Panic.panic(Panic.GENERIC); }
* }
* ```
*
* Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil].
*
* _Available since v5.1._
*/
// slither-disable-next-line unused-state
library Panic {
/// @dev generic / unspecified error
uint256 internal constant GENERIC = 0x00;
/// @dev used by the assert() builtin
uint256 internal constant ASSERT = 0x01;
/// @dev arithmetic underflow or overflow
uint256 internal constant UNDER_OVERFLOW = 0x11;
/// @dev division or modulo by zero
uint256 internal constant DIVISION_BY_ZERO = 0x12;
/// @dev enum conversion error
uint256 internal constant ENUM_CONVERSION_ERROR = 0x21;
/// @dev invalid encoding in storage
uint256 internal constant STORAGE_ENCODING_ERROR = 0x22;
/// @dev empty array pop
uint256 internal constant EMPTY_ARRAY_POP = 0x31;
/// @dev array out of bounds access
uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32;
/// @dev resource error (too large allocation or too large array)
uint256 internal constant RESOURCE_ERROR = 0x41;
/// @dev calling invalid internal function
uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51;
/// @dev Reverts with a panic code. Recommended to use with
/// the internal constants with predefined codes.
function panic(uint256 code) internal pure {
assembly ("memory-safe") {
mstore(0x00, 0x4e487b71)
mstore(0x20, code)
revert(0x1c, 0x24)
}
}
}
// File: @openzeppelin/contracts/utils/math/SafeCast.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol)
// This file was procedurally generated from scripts/generate/templates/SafeCast.js.
pragma solidity ^0.8.20;
/**
* @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow
* checks.
*
* Downcasting from uint256/int256 in Solidity does not revert on overflow. This can
* easily result in undesired exploitation or bugs, since developers usually
* assume that overflows raise errors. `SafeCast` restores this intuition by
* reverting the transaction when such an operation overflows.
*
* Using this library instead of the unchecked operations eliminates an entire
* class of bugs, so it's recommended to use it always.
*/
library SafeCast {
/**
* @dev Value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value);
/**
* @dev An int value doesn't fit in an uint of `bits` size.
*/
error SafeCastOverflowedIntToUint(int256 value);
/**
* @dev Value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedIntDowncast(uint8 bits, int256 value);
/**
* @dev An uint value doesn't fit in an int of `bits` size.
*/
error SafeCastOverflowedUintToInt(uint256 value);
/**
* @dev Returns the downcasted uint248 from uint256, reverting on
* overflow (when the input is greater than largest uint248).
*
* Counterpart to Solidity's `uint248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toUint248(uint256 value) internal pure returns (uint248) {
if (value > type(uint248).max) {
revert SafeCastOverflowedUintDowncast(248, value);
}
return uint248(value);
}
/**
* @dev Returns the downcasted uint240 from uint256, reverting on
* overflow (when the input is greater than largest uint240).
*
* Counterpart to Solidity's `uint240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toUint240(uint256 value) internal pure returns (uint240) {
if (value > type(uint240).max) {
revert SafeCastOverflowedUintDowncast(240, value);
}
return uint240(value);
}
/**
* @dev Returns the downcasted uint232 from uint256, reverting on
* overflow (when the input is greater than largest uint232).
*
* Counterpart to Solidity's `uint232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toUint232(uint256 value) internal pure returns (uint232) {
if (value > type(uint232).max) {
revert SafeCastOverflowedUintDowncast(232, value);
}
return uint232(value);
}
/**
* @dev Returns the downcasted uint224 from uint256, reverting on
* overflow (when the input is greater than largest uint224).
*
* Counterpart to Solidity's `uint224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toUint224(uint256 value) internal pure returns (uint224) {
if (value > type(uint224).max) {
revert SafeCastOverflowedUintDowncast(224, value);
}
return uint224(value);
}
/**
* @dev Returns the downcasted uint216 from uint256, reverting on
* overflow (when the input is greater than largest uint216).
*
* Counterpart to Solidity's `uint216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toUint216(uint256 value) internal pure returns (uint216) {
if (value > type(uint216).max) {
revert SafeCastOverflowedUintDowncast(216, value);
}
return uint216(value);
}
/**
* @dev Returns the downcasted uint208 from uint256, reverting on
* overflow (when the input is greater than largest uint208).
*
* Counterpart to Solidity's `uint208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toUint208(uint256 value) internal pure returns (uint208) {
if (value > type(uint208).max) {
revert SafeCastOverflowedUintDowncast(208, value);
}
return uint208(value);
}
/**
* @dev Returns the downcasted uint200 from uint256, reverting on
* overflow (when the input is greater than largest uint200).
*
* Counterpart to Solidity's `uint200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toUint200(uint256 value) internal pure returns (uint200) {
if (value > type(uint200).max) {
revert SafeCastOverflowedUintDowncast(200, value);
}
return uint200(value);
}
/**
* @dev Returns the downcasted uint192 from uint256, reverting on
* overflow (when the input is greater than largest uint192).
*
* Counterpart to Solidity's `uint192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toUint192(uint256 value) internal pure returns (uint192) {
if (value > type(uint192).max) {
revert SafeCastOverflowedUintDowncast(192, value);
}
return uint192(value);
}
/**
* @dev Returns the downcasted uint184 from uint256, reverting on
* overflow (when the input is greater than largest uint184).
*
* Counterpart to Solidity's `uint184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toUint184(uint256 value) internal pure returns (uint184) {
if (value > type(uint184).max) {
revert SafeCastOverflowedUintDowncast(184, value);
}
return uint184(value);
}
/**
* @dev Returns the downcasted uint176 from uint256, reverting on
* overflow (when the input is greater than largest uint176).
*
* Counterpart to Solidity's `uint176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toUint176(uint256 value) internal pure returns (uint176) {
if (value > type(uint176).max) {
revert SafeCastOverflowedUintDowncast(176, value);
}
return uint176(value);
}
/**
* @dev Returns the downcasted uint168 from uint256, reverting on
* overflow (when the input is greater than largest uint168).
*
* Counterpart to Solidity's `uint168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toUint168(uint256 value) internal pure returns (uint168) {
if (value > type(uint168).max) {
revert SafeCastOverflowedUintDowncast(168, value);
}
return uint168(value);
}
/**
* @dev Returns the downcasted uint160 from uint256, reverting on
* overflow (when the input is greater than largest uint160).
*
* Counterpart to Solidity's `uint160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toUint160(uint256 value) internal pure returns (uint160) {
if (value > type(uint160).max) {
revert SafeCastOverflowedUintDowncast(160, value);
}
return uint160(value);
}
/**
* @dev Returns the downcasted uint152 from uint256, reverting on
* overflow (when the input is greater than largest uint152).
*
* Counterpart to Solidity's `uint152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toUint152(uint256 value) internal pure returns (uint152) {
if (value > type(uint152).max) {
revert SafeCastOverflowedUintDowncast(152, value);
}
return uint152(value);
}
/**
* @dev Returns the downcasted uint144 from uint256, reverting on
* overflow (when the input is greater than largest uint144).
*
* Counterpart to Solidity's `uint144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toUint144(uint256 value) internal pure returns (uint144) {
if (value > type(uint144).max) {
revert SafeCastOverflowedUintDowncast(144, value);
}
return uint144(value);
}
/**
* @dev Returns the downcasted uint136 from uint256, reverting on
* overflow (when the input is greater than largest uint136).
*
* Counterpart to Solidity's `uint136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toUint136(uint256 value) internal pure returns (uint136) {
if (value > type(uint136).max) {
revert SafeCastOverflowedUintDowncast(136, value);
}
return uint136(value);
}
/**
* @dev Returns the downcasted uint128 from uint256, reverting on
* overflow (when the input is greater than largest uint128).
*
* Counterpart to Solidity's `uint128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toUint128(uint256 value) internal pure returns (uint128) {
if (value > type(uint128).max) {
revert SafeCastOverflowedUintDowncast(128, value);
}
return uint128(value);
}
/**
* @dev Returns the downcasted uint120 from uint256, reverting on
* overflow (when the input is greater than largest uint120).
*
* Counterpart to Solidity's `uint120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toUint120(uint256 value) internal pure returns (uint120) {
if (value > type(uint120).max) {
revert SafeCastOverflowedUintDowncast(120, value);
}
return uint120(value);
}
/**
* @dev Returns the downcasted uint112 from uint256, reverting on
* overflow (when the input is greater than largest uint112).
*
* Counterpart to Solidity's `uint112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toUint112(uint256 value) internal pure returns (uint112) {
if (value > type(uint112).max) {
revert SafeCastOverflowedUintDowncast(112, value);
}
return uint112(value);
}
/**
* @dev Returns the downcasted uint104 from uint256, reverting on
* overflow (when the input is greater than largest uint104).
*
* Counterpart to Solidity's `uint104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toUint104(uint256 value) internal pure returns (uint104) {
if (value > type(uint104).max) {
revert SafeCastOverflowedUintDowncast(104, value);
}
return uint104(value);
}
/**
* @dev Returns the downcasted uint96 from uint256, reverting on
* overflow (when the input is greater than largest uint96).
*
* Counterpart to Solidity's `uint96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toUint96(uint256 value) internal pure returns (uint96) {
if (value > type(uint96).max) {
revert SafeCastOverflowedUintDowncast(96, value);
}
return uint96(value);
}
/**
* @dev Returns the downcasted uint88 from uint256, reverting on
* overflow (when the input is greater than largest uint88).
*
* Counterpart to Solidity's `uint88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toUint88(uint256 value) internal pure returns (uint88) {
if (value > type(uint88).max) {
revert SafeCastOverflowedUintDowncast(88, value);
}
return uint88(value);
}
/**
* @dev Returns the downcasted uint80 from uint256, reverting on
* overflow (when the input is greater than largest uint80).
*
* Counterpart to Solidity's `uint80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toUint80(uint256 value) internal pure returns (uint80) {
if (value > type(uint80).max) {
revert SafeCastOverflowedUintDowncast(80, value);
}
return uint80(value);
}
/**
* @dev Returns the downcasted uint72 from uint256, reverting on
* overflow (when the input is greater than largest uint72).
*
* Counterpart to Solidity's `uint72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toUint72(uint256 value) internal pure returns (uint72) {
if (value > type(uint72).max) {
revert SafeCastOverflowedUintDowncast(72, value);
}
return uint72(value);
}
/**
* @dev Returns the downcasted uint64 from uint256, reverting on
* overflow (when the input is greater than largest uint64).
*
* Counterpart to Solidity's `uint64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toUint64(uint256 value) internal pure returns (uint64) {
if (value > type(uint64).max) {
revert SafeCastOverflowedUintDowncast(64, value);
}
return uint64(value);
}
/**
* @dev Returns the downcasted uint56 from uint256, reverting on
* overflow (when the input is greater than largest uint56).
*
* Counterpart to Solidity's `uint56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toUint56(uint256 value) internal pure returns (uint56) {
if (value > type(uint56).max) {
revert SafeCastOverflowedUintDowncast(56, value);
}
return uint56(value);
}
/**
* @dev Returns the downcasted uint48 from uint256, reverting on
* overflow (when the input is greater than largest uint48).
*
* Counterpart to Solidity's `uint48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toUint48(uint256 value) internal pure returns (uint48) {
if (value > type(uint48).max) {
revert SafeCastOverflowedUintDowncast(48, value);
}
return uint48(value);
}
/**
* @dev Returns the downcasted uint40 from uint256, reverting on
* overflow (when the input is greater than largest uint40).
*
* Counterpart to Solidity's `uint40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toUint40(uint256 value) internal pure returns (uint40) {
if (value > type(uint40).max) {
revert SafeCastOverflowedUintDowncast(40, value);
}
return uint40(value);
}
/**
* @dev Returns the downcasted uint32 from uint256, reverting on
* overflow (when the input is greater than largest uint32).
*
* Counterpart to Solidity's `uint32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toUint32(uint256 value) internal pure returns (uint32) {
if (value > type(uint32).max) {
revert SafeCastOverflowedUintDowncast(32, value);
}
return uint32(value);
}
/**
* @dev Returns the downcasted uint24 from uint256, reverting on
* overflow (when the input is greater than largest uint24).
*
* Counterpart to Solidity's `uint24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toUint24(uint256 value) internal pure returns (uint24) {
if (value > type(uint24).max) {
revert SafeCastOverflowedUintDowncast(24, value);
}
return uint24(value);
}
/**
* @dev Returns the downcasted uint16 from uint256, reverting on
* overflow (when the input is greater than largest uint16).
*
* Counterpart to Solidity's `uint16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toUint16(uint256 value) internal pure returns (uint16) {
if (value > type(uint16).max) {
revert SafeCastOverflowedUintDowncast(16, value);
}
return uint16(value);
}
/**
* @dev Returns the downcasted uint8 from uint256, reverting on
* overflow (when the input is greater than largest uint8).
*
* Counterpart to Solidity's `uint8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toUint8(uint256 value) internal pure returns (uint8) {
if (value > type(uint8).max) {
revert SafeCastOverflowedUintDowncast(8, value);
}
return uint8(value);
}
/**
* @dev Converts a signed int256 into an unsigned uint256.
*
* Requirements:
*
* - input must be greater than or equal to 0.
*/
function toUint256(int256 value) internal pure returns (uint256) {
if (value < 0) {
revert SafeCastOverflowedIntToUint(value);
}
return uint256(value);
}
/**
* @dev Returns the downcasted int248 from int256, reverting on
* overflow (when the input is less than smallest int248 or
* greater than largest int248).
*
* Counterpart to Solidity's `int248` operator.
*
* Requirements:
*
* - input must fit into 248 bits
*/
function toInt248(int256 value) internal pure returns (int248 downcasted) {
downcasted = int248(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(248, value);
}
}
/**
* @dev Returns the downcasted int240 from int256, reverting on
* overflow (when the input is less than smallest int240 or
* greater than largest int240).
*
* Counterpart to Solidity's `int240` operator.
*
* Requirements:
*
* - input must fit into 240 bits
*/
function toInt240(int256 value) internal pure returns (int240 downcasted) {
downcasted = int240(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(240, value);
}
}
/**
* @dev Returns the downcasted int232 from int256, reverting on
* overflow (when the input is less than smallest int232 or
* greater than largest int232).
*
* Counterpart to Solidity's `int232` operator.
*
* Requirements:
*
* - input must fit into 232 bits
*/
function toInt232(int256 value) internal pure returns (int232 downcasted) {
downcasted = int232(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(232, value);
}
}
/**
* @dev Returns the downcasted int224 from int256, reverting on
* overflow (when the input is less than smallest int224 or
* greater than largest int224).
*
* Counterpart to Solidity's `int224` operator.
*
* Requirements:
*
* - input must fit into 224 bits
*/
function toInt224(int256 value) internal pure returns (int224 downcasted) {
downcasted = int224(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(224, value);
}
}
/**
* @dev Returns the downcasted int216 from int256, reverting on
* overflow (when the input is less than smallest int216 or
* greater than largest int216).
*
* Counterpart to Solidity's `int216` operator.
*
* Requirements:
*
* - input must fit into 216 bits
*/
function toInt216(int256 value) internal pure returns (int216 downcasted) {
downcasted = int216(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(216, value);
}
}
/**
* @dev Returns the downcasted int208 from int256, reverting on
* overflow (when the input is less than smallest int208 or
* greater than largest int208).
*
* Counterpart to Solidity's `int208` operator.
*
* Requirements:
*
* - input must fit into 208 bits
*/
function toInt208(int256 value) internal pure returns (int208 downcasted) {
downcasted = int208(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(208, value);
}
}
/**
* @dev Returns the downcasted int200 from int256, reverting on
* overflow (when the input is less than smallest int200 or
* greater than largest int200).
*
* Counterpart to Solidity's `int200` operator.
*
* Requirements:
*
* - input must fit into 200 bits
*/
function toInt200(int256 value) internal pure returns (int200 downcasted) {
downcasted = int200(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(200, value);
}
}
/**
* @dev Returns the downcasted int192 from int256, reverting on
* overflow (when the input is less than smallest int192 or
* greater than largest int192).
*
* Counterpart to Solidity's `int192` operator.
*
* Requirements:
*
* - input must fit into 192 bits
*/
function toInt192(int256 value) internal pure returns (int192 downcasted) {
downcasted = int192(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(192, value);
}
}
/**
* @dev Returns the downcasted int184 from int256, reverting on
* overflow (when the input is less than smallest int184 or
* greater than largest int184).
*
* Counterpart to Solidity's `int184` operator.
*
* Requirements:
*
* - input must fit into 184 bits
*/
function toInt184(int256 value) internal pure returns (int184 downcasted) {
downcasted = int184(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(184, value);
}
}
/**
* @dev Returns the downcasted int176 from int256, reverting on
* overflow (when the input is less than smallest int176 or
* greater than largest int176).
*
* Counterpart to Solidity's `int176` operator.
*
* Requirements:
*
* - input must fit into 176 bits
*/
function toInt176(int256 value) internal pure returns (int176 downcasted) {
downcasted = int176(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(176, value);
}
}
/**
* @dev Returns the downcasted int168 from int256, reverting on
* overflow (when the input is less than smallest int168 or
* greater than largest int168).
*
* Counterpart to Solidity's `int168` operator.
*
* Requirements:
*
* - input must fit into 168 bits
*/
function toInt168(int256 value) internal pure returns (int168 downcasted) {
downcasted = int168(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(168, value);
}
}
/**
* @dev Returns the downcasted int160 from int256, reverting on
* overflow (when the input is less than smallest int160 or
* greater than largest int160).
*
* Counterpart to Solidity's `int160` operator.
*
* Requirements:
*
* - input must fit into 160 bits
*/
function toInt160(int256 value) internal pure returns (int160 downcasted) {
downcasted = int160(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(160, value);
}
}
/**
* @dev Returns the downcasted int152 from int256, reverting on
* overflow (when the input is less than smallest int152 or
* greater than largest int152).
*
* Counterpart to Solidity's `int152` operator.
*
* Requirements:
*
* - input must fit into 152 bits
*/
function toInt152(int256 value) internal pure returns (int152 downcasted) {
downcasted = int152(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(152, value);
}
}
/**
* @dev Returns the downcasted int144 from int256, reverting on
* overflow (when the input is less than smallest int144 or
* greater than largest int144).
*
* Counterpart to Solidity's `int144` operator.
*
* Requirements:
*
* - input must fit into 144 bits
*/
function toInt144(int256 value) internal pure returns (int144 downcasted) {
downcasted = int144(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(144, value);
}
}
/**
* @dev Returns the downcasted int136 from int256, reverting on
* overflow (when the input is less than smallest int136 or
* greater than largest int136).
*
* Counterpart to Solidity's `int136` operator.
*
* Requirements:
*
* - input must fit into 136 bits
*/
function toInt136(int256 value) internal pure returns (int136 downcasted) {
downcasted = int136(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(136, value);
}
}
/**
* @dev Returns the downcasted int128 from int256, reverting on
* overflow (when the input is less than smallest int128 or
* greater than largest int128).
*
* Counterpart to Solidity's `int128` operator.
*
* Requirements:
*
* - input must fit into 128 bits
*/
function toInt128(int256 value) internal pure returns (int128 downcasted) {
downcasted = int128(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(128, value);
}
}
/**
* @dev Returns the downcasted int120 from int256, reverting on
* overflow (when the input is less than smallest int120 or
* greater than largest int120).
*
* Counterpart to Solidity's `int120` operator.
*
* Requirements:
*
* - input must fit into 120 bits
*/
function toInt120(int256 value) internal pure returns (int120 downcasted) {
downcasted = int120(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(120, value);
}
}
/**
* @dev Returns the downcasted int112 from int256, reverting on
* overflow (when the input is less than smallest int112 or
* greater than largest int112).
*
* Counterpart to Solidity's `int112` operator.
*
* Requirements:
*
* - input must fit into 112 bits
*/
function toInt112(int256 value) internal pure returns (int112 downcasted) {
downcasted = int112(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(112, value);
}
}
/**
* @dev Returns the downcasted int104 from int256, reverting on
* overflow (when the input is less than smallest int104 or
* greater than largest int104).
*
* Counterpart to Solidity's `int104` operator.
*
* Requirements:
*
* - input must fit into 104 bits
*/
function toInt104(int256 value) internal pure returns (int104 downcasted) {
downcasted = int104(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(104, value);
}
}
/**
* @dev Returns the downcasted int96 from int256, reverting on
* overflow (when the input is less than smallest int96 or
* greater than largest int96).
*
* Counterpart to Solidity's `int96` operator.
*
* Requirements:
*
* - input must fit into 96 bits
*/
function toInt96(int256 value) internal pure returns (int96 downcasted) {
downcasted = int96(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(96, value);
}
}
/**
* @dev Returns the downcasted int88 from int256, reverting on
* overflow (when the input is less than smallest int88 or
* greater than largest int88).
*
* Counterpart to Solidity's `int88` operator.
*
* Requirements:
*
* - input must fit into 88 bits
*/
function toInt88(int256 value) internal pure returns (int88 downcasted) {
downcasted = int88(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(88, value);
}
}
/**
* @dev Returns the downcasted int80 from int256, reverting on
* overflow (when the input is less than smallest int80 or
* greater than largest int80).
*
* Counterpart to Solidity's `int80` operator.
*
* Requirements:
*
* - input must fit into 80 bits
*/
function toInt80(int256 value) internal pure returns (int80 downcasted) {
downcasted = int80(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(80, value);
}
}
/**
* @dev Returns the downcasted int72 from int256, reverting on
* overflow (when the input is less than smallest int72 or
* greater than largest int72).
*
* Counterpart to Solidity's `int72` operator.
*
* Requirements:
*
* - input must fit into 72 bits
*/
function toInt72(int256 value) internal pure returns (int72 downcasted) {
downcasted = int72(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(72, value);
}
}
/**
* @dev Returns the downcasted int64 from int256, reverting on
* overflow (when the input is less than smallest int64 or
* greater than largest int64).
*
* Counterpart to Solidity's `int64` operator.
*
* Requirements:
*
* - input must fit into 64 bits
*/
function toInt64(int256 value) internal pure returns (int64 downcasted) {
downcasted = int64(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(64, value);
}
}
/**
* @dev Returns the downcasted int56 from int256, reverting on
* overflow (when the input is less than smallest int56 or
* greater than largest int56).
*
* Counterpart to Solidity's `int56` operator.
*
* Requirements:
*
* - input must fit into 56 bits
*/
function toInt56(int256 value) internal pure returns (int56 downcasted) {
downcasted = int56(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(56, value);
}
}
/**
* @dev Returns the downcasted int48 from int256, reverting on
* overflow (when the input is less than smallest int48 or
* greater than largest int48).
*
* Counterpart to Solidity's `int48` operator.
*
* Requirements:
*
* - input must fit into 48 bits
*/
function toInt48(int256 value) internal pure returns (int48 downcasted) {
downcasted = int48(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(48, value);
}
}
/**
* @dev Returns the downcasted int40 from int256, reverting on
* overflow (when the input is less than smallest int40 or
* greater than largest int40).
*
* Counterpart to Solidity's `int40` operator.
*
* Requirements:
*
* - input must fit into 40 bits
*/
function toInt40(int256 value) internal pure returns (int40 downcasted) {
downcasted = int40(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(40, value);
}
}
/**
* @dev Returns the downcasted int32 from int256, reverting on
* overflow (when the input is less than smallest int32 or
* greater than largest int32).
*
* Counterpart to Solidity's `int32` operator.
*
* Requirements:
*
* - input must fit into 32 bits
*/
function toInt32(int256 value) internal pure returns (int32 downcasted) {
downcasted = int32(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(32, value);
}
}
/**
* @dev Returns the downcasted int24 from int256, reverting on
* overflow (when the input is less than smallest int24 or
* greater than largest int24).
*
* Counterpart to Solidity's `int24` operator.
*
* Requirements:
*
* - input must fit into 24 bits
*/
function toInt24(int256 value) internal pure returns (int24 downcasted) {
downcasted = int24(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(24, value);
}
}
/**
* @dev Returns the downcasted int16 from int256, reverting on
* overflow (when the input is less than smallest int16 or
* greater than largest int16).
*
* Counterpart to Solidity's `int16` operator.
*
* Requirements:
*
* - input must fit into 16 bits
*/
function toInt16(int256 value) internal pure returns (int16 downcasted) {
downcasted = int16(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(16, value);
}
}
/**
* @dev Returns the downcasted int8 from int256, reverting on
* overflow (when the input is less than smallest int8 or
* greater than largest int8).
*
* Counterpart to Solidity's `int8` operator.
*
* Requirements:
*
* - input must fit into 8 bits
*/
function toInt8(int256 value) internal pure returns (int8 downcasted) {
downcasted = int8(value);
if (downcasted != value) {
revert SafeCastOverflowedIntDowncast(8, value);
}
}
/**
* @dev Converts an unsigned uint256 into a signed int256.
*
* Requirements:
*
* - input must be less than or equal to maxInt256.
*/
function toInt256(uint256 value) internal pure returns (int256) {
// Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive
if (value > uint256(type(int256).max)) {
revert SafeCastOverflowedUintToInt(value);
}
return int256(value);
}
/**
* @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump.
*/
function toUint(bool b) internal pure returns (uint256 u) {
assembly ("memory-safe") {
u := iszero(iszero(b))
}
}
}
// File: @openzeppelin/contracts/utils/math/Math.sol
// OpenZeppelin Contracts (last updated v5.3.0) (utils/math/Math.sol)
pragma solidity ^0.8.20;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Floor, // Toward negative infinity
Ceil, // Toward positive infinity
Trunc, // Toward zero
Expand // Away from zero
}
/**
* @dev Return the 512-bit addition of two uint256.
*
* The result is stored in two 256 variables such that sum = high * 2²⁵⁶ + low.
*/
function add512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
assembly ("memory-safe") {
low := add(a, b)
high := lt(low, a)
}
}
/**
* @dev Return the 512-bit multiplication of two uint256.
*
* The result is stored in two 256 variables such that product = high * 2²⁵⁶ + low.
*/
function mul512(uint256 a, uint256 b) internal pure returns (uint256 high, uint256 low) {
// 512-bit multiply [high low] = x * y. Compute the product mod 2²⁵⁶ and mod 2²⁵⁶ - 1, then use
// the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = high * 2²⁵⁶ + low.
assembly ("memory-safe") {
let mm := mulmod(a, b, not(0))
low := mul(a, b)
high := sub(sub(mm, low), lt(mm, low))
}
}
/**
* @dev Returns the addition of two unsigned integers, with a success flag (no overflow).
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a + b;
success = c >= a;
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the subtraction of two unsigned integers, with a success flag (no overflow).
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a - b;
success = c <= a;
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the multiplication of two unsigned integers, with a success flag (no overflow).
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a * b;
assembly ("memory-safe") {
// Only true when the multiplication doesn't overflow
// (c / a == b) || (a == 0)
success := or(eq(div(c, a), b), iszero(a))
}
// equivalent to: success ? c : 0
result = c * SafeCast.toUint(success);
}
}
/**
* @dev Returns the division of two unsigned integers, with a success flag (no division by zero).
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
success = b > 0;
assembly ("memory-safe") {
// The `DIV` opcode returns zero when the denominator is 0.
result := div(a, b)
}
}
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
success = b > 0;
assembly ("memory-safe") {
// The `MOD` opcode returns zero when the denominator is 0.
result := mod(a, b)
}
}
}
/**
* @dev Unsigned saturating addition, bounds to `2²⁵⁶ - 1` instead of overflowing.
*/
function saturatingAdd(uint256 a, uint256 b) internal pure returns (uint256) {
(bool success, uint256 result) = tryAdd(a, b);
return ternary(success, result, type(uint256).max);
}
/**
* @dev Unsigned saturating subtraction, bounds to zero instead of overflowing.
*/
function saturatingSub(uint256 a, uint256 b) internal pure returns (uint256) {
(, uint256 result) = trySub(a, b);
return result;
}
/**
* @dev Unsigned saturating multiplication, bounds to `2²⁵⁶ - 1` instead of overflowing.
*/
function saturatingMul(uint256 a, uint256 b) internal pure returns (uint256) {
(bool success, uint256 result) = tryMul(a, b);
return ternary(success, result, type(uint256).max);
}
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * SafeCast.toUint(condition));
}
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a < b, a, b);
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds towards infinity instead
* of rounding towards zero.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
if (b == 0) {
// Guarantee the same behavior as in a regular Solidity division.
Panic.panic(Panic.DIVISION_BY_ZERO);
}
// The following calculation ensures accurate ceiling division without overflow.
// Since a is non-zero, (a - 1) / b will not overflow.
// The largest possible result occurs when (a - 1) / b is type(uint256).max,
// but the largest value we can obtain is type(uint256).max - 1, which happens
// when a = type(uint256).max and b = 1.
unchecked {
return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
}
}
/**
* @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
* denominator == 0.
*
* Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by
* Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
(uint256 high, uint256 low) = mul512(x, y);
// Handle non-overflow cases, 256 by 256 division.
if (high == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return low / denominator;
}
// Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
if (denominator <= high) {
Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));
}
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [high low].
uint256 remainder;
assembly ("memory-safe") {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
high := sub(high, gt(remainder, low))
low := sub(low, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator.
// Always >= 1. See https://cs.stackexchange.com/q/138556/92363.
uint256 twos = denominator & (0 - denominator);
assembly ("memory-safe") {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [high low] by twos.
low := div(low, twos)
// Flip twos such that it is 2²⁵⁶ / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from high into low.
low |= high * twos;
// Invert denominator mod 2²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
// that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv ≡ 1 mod 2⁴.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also
// works in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2⁸
inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
inverse *= 2 - denominator * inverse; // inverse mod 2³²
inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2²⁵⁶. Since the preconditions guarantee that the outcome is
// less than 2²⁵⁶, this is the final result. We don't need to compute the high bits of the result and high
// is no longer required.
result = low * inverse;
return result;
}
}
/**
* @dev Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
}
/**
* @dev Calculates floor(x * y >> n) with full precision. Throws if result overflows a uint256.
*/
function mulShr(uint256 x, uint256 y, uint8 n) internal pure returns (uint256 result) {
unchecked {
(uint256 high, uint256 low) = mul512(x, y);
if (high >= 1 << n) {
Panic.panic(Panic.UNDER_OVERFLOW);
}
return (high << (256 - n)) | (low >> n);
}
}
/**
* @dev Calculates x * y >> n with full precision, following the selected rounding direction.
*/
function mulShr(uint256 x, uint256 y, uint8 n, Rounding rounding) internal pure returns (uint256) {
return mulShr(x, y, n) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, 1 << n) > 0);
}
/**
* @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
*
* If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
* If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
*
* If the input value is not inversible, 0 is returned.
*
* NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
* inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
*/
function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
unchecked {
if (n == 0) return 0;
// The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
// Used to compute integers x and y such that: ax + ny = gcd(a, n).
// When the gcd is 1, then the inverse of a modulo n exists and it's x.
// ax + ny = 1
// ax = 1 + (-y)n
// ax ≡ 1 (mod n) # x is the inverse of a modulo n
// If the remainder is 0 the gcd is n right away.
uint256 remainder = a % n;
uint256 gcd = n;
// Therefore the initial coefficients are:
// ax + ny = gcd(a, n) = n
// 0a + 1n = n
int256 x = 0;
int256 y = 1;
while (remainder != 0) {
uint256 quotient = gcd / remainder;
(gcd, remainder) = (
// The old remainder is the next gcd to try.
remainder,
// Compute the next remainder.
// Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
// where gcd is at most n (capped to type(uint256).max)
gcd - remainder * quotient
);
(x, y) = (
// Increment the coefficient of a.
y,
// Decrement the coefficient of n.
// Can overflow, but the result is casted to uint256 so that the
// next value of y is "wrapped around" to a value between 0 and n - 1.
x - y * int256(quotient)
);
}
if (gcd != 1) return 0; // No inverse exists.
return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
}
}
/**
* @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
*
* From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
* prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
* `a**(p-2)` is the modular multiplicative inverse of a in Fp.
*
* NOTE: this function does NOT check that `p` is a prime greater than `2`.
*/
function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
unchecked {
return Math.modExp(a, p - 2, p);
}
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
*
* Requirements:
* - modulus can't be zero
* - underlying staticcall to precompile must succeed
*
* IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
* sure the chain you're using it on supports the precompiled contract for modular exponentiation
* at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
* the underlying function will succeed given the lack of a revert, but the result may be incorrectly
* interpreted as 0.
*/
function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
(bool success, uint256 result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
* It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
* to operate modulo 0 or if the underlying precompile reverted.
*
* IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
* you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
* https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
* of a revert, but the result may be incorrectly interpreted as 0.
*/
function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
if (m == 0) return (false, 0);
assembly ("memory-safe") {
let ptr := mload(0x40)
// | Offset | Content | Content (Hex) |
// |-----------|------------|--------------------------------------------------------------------|
// | 0x00:0x1f | size of b | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x20:0x3f | size of e | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x40:0x5f | size of m | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x60:0x7f | value of b | 0x<.............................................................b> |
// | 0x80:0x9f | value of e | 0x<.............................................................e> |
// | 0xa0:0xbf | value of m | 0x<.............................................................m> |
mstore(ptr, 0x20)
mstore(add(ptr, 0x20), 0x20)
mstore(add(ptr, 0x40), 0x20)
mstore(add(ptr, 0x60), b)
mstore(add(ptr, 0x80), e)
mstore(add(ptr, 0xa0), m)
// Given the result < m, it's guaranteed to fit in 32 bytes,
// so we can use the memory scratch space located at offset 0.
success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
result := mload(0x00)
}
}
/**
* @dev Variant of {modExp} that supports inputs of arbitrary length.
*/
function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
(bool success, bytes memory result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Variant of {tryModExp} that supports inputs of arbitrary length.
*/
function tryModExp(
bytes memory b,
bytes memory e,
bytes memory m
) internal view returns (bool success, bytes memory result) {
if (_zeroBytes(m)) return (false, new bytes(0));
uint256 mLen = m.length;
// Encode call args in result and move the free memory pointer
result = abi.encodePacked(b.length, e.length, mLen, b, e, m);
assembly ("memory-safe") {
let dataPtr := add(result, 0x20)
// Write result on top of args to avoid allocating extra memory.
success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
// Overwrite the length.
// result.length > returndatasize() is guaranteed because returndatasize() == m.length
mstore(result, mLen)
// Set the memory pointer after the returned data.
mstore(0x40, add(dataPtr, mLen))
}
}
/**
* @dev Returns whether the provided byte array is zero.
*/
function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
for (uint256 i = 0; i < byteArray.length; ++i) {
if (byteArray[i] != 0) {
return false;
}
}
return true;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
* towards zero.
*
* This method is based on Newton's method for computing square roots; the algorithm is restricted to only
* using integer operations.
*/
function sqrt(uint256 a) internal pure returns (uint256) {
unchecked {
// Take care of easy edge cases when a == 0 or a == 1
if (a <= 1) {
return a;
}
// In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
// sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
// the current value as `ε_n = | x_n - sqrt(a) |`.
//
// For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
// of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
// bigger than any uint256.
//
// By noticing that
// `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
// we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
// to the msb function.
uint256 aa = a;
uint256 xn = 1;
if (aa >= (1 << 128)) {
aa >>= 128;
xn <<= 64;
}
if (aa >= (1 << 64)) {
aa >>= 64;
xn <<= 32;
}
if (aa >= (1 << 32)) {
aa >>= 32;
xn <<= 16;
}
if (aa >= (1 << 16)) {
aa >>= 16;
xn <<= 8;
}
if (aa >= (1 << 8)) {
aa >>= 8;
xn <<= 4;
}
if (aa >= (1 << 4)) {
aa >>= 4;
xn <<= 2;
}
if (aa >= (1 << 2)) {
xn <<= 1;
}
// We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
//
// We can refine our estimation by noticing that the middle of that interval minimizes the error.
// If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
// This is going to be our x_0 (and ε_0)
xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)
// From here, Newton's method give us:
// x_{n+1} = (x_n + a / x_n) / 2
//
// One should note that:
// x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
// = ((x_n² + a) / (2 * x_n))² - a
// = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
// = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
// = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
// = (x_n² - a)² / (2 * x_n)²
// = ((x_n² - a) / (2 * x_n))²
// ≥ 0
// Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
//
// This gives us the proof of quadratic convergence of the sequence:
// ε_{n+1} = | x_{n+1} - sqrt(a) |
// = | (x_n + a / x_n) / 2 - sqrt(a) |
// = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
// = | (x_n - sqrt(a))² / (2 * x_n) |
// = | ε_n² / (2 * x_n) |
// = ε_n² / | (2 * x_n) |
//
// For the first iteration, we have a special case where x_0 is known:
// ε_1 = ε_0² / | (2 * x_0) |
// ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
// ≤ 2**(2*e-4) / (3 * 2**(e-1))
// ≤ 2**(e-3) / 3
// ≤ 2**(e-3-log2(3))
// ≤ 2**(e-4.5)
//
// For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
// ε_{n+1} = ε_n² / | (2 * x_n) |
// ≤ (2**(e-k))² / (2 * 2**(e-1))
// ≤ 2**(2*e-2*k) / 2**e
// ≤ 2**(e-2*k)
xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5) -- special case, see above
xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9) -- general case with k = 4.5
xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18) -- general case with k = 9
xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36) -- general case with k = 18
xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72) -- general case with k = 36
xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144) -- general case with k = 72
// Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
// ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
// sqrt(a) or sqrt(a) + 1.
return xn - SafeCast.toUint(xn > a / xn);
}
}
/**
* @dev Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
}
}
/**
* @dev Return the log in base 2 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log2(uint256 x) internal pure returns (uint256 r) {
// If value has upper 128 bits set, log2 result is at least 128
r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
// If upper 64 bits of 128-bit half set, add 64 to result
r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
// If upper 32 bits of 64-bit half set, add 32 to result
r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
// If upper 16 bits of 32-bit half set, add 16 to result
r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
// If upper 8 bits of 16-bit half set, add 8 to result
r |= SafeCast.toUint((x >> r) > 0xff) << 3;
// If upper 4 bits of 8-bit half set, add 4 to result
r |= SafeCast.toUint((x >> r) > 0xf) << 2;
// Shifts value right by the current result and use it as an index into this lookup table:
//
// | x (4 bits) | index | table[index] = MSB position |
// |------------|---------|-----------------------------|
// | 0000 | 0 | table[0] = 0 |
// | 0001 | 1 | table[1] = 0 |
// | 0010 | 2 | table[2] = 1 |
// | 0011 | 3 | table[3] = 1 |
// | 0100 | 4 | table[4] = 2 |
// | 0101 | 5 | table[5] = 2 |
// | 0110 | 6 | table[6] = 2 |
// | 0111 | 7 | table[7] = 2 |
// | 1000 | 8 | table[8] = 3 |
// | 1001 | 9 | table[9] = 3 |
// | 1010 | 10 | table[10] = 3 |
// | 1011 | 11 | table[11] = 3 |
// | 1100 | 12 | table[12] = 3 |
// | 1101 | 13 | table[13] = 3 |
// | 1110 | 14 | table[14] = 3 |
// | 1111 | 15 | table[15] = 3 |
//
// The lookup table is represented as a 32-byte value with the MSB positions for 0-15 in the last 16 bytes.
assembly ("memory-safe") {
r := or(r, byte(shr(r, x), 0x0000010102020202030303030303030300000000000000000000000000000000))
}
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
}
}
/**
* @dev Return the log in base 10 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);
}
}
/**
* @dev Return the log in base 256 of a positive value rounded towards zero.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 x) internal pure returns (uint256 r) {
// If value has upper 128 bits set, log2 result is at least 128
r = SafeCast.toUint(x > 0xffffffffffffffffffffffffffffffff) << 7;
// If upper 64 bits of 128-bit half set, add 64 to result
r |= SafeCast.toUint((x >> r) > 0xffffffffffffffff) << 6;
// If upper 32 bits of 64-bit half set, add 32 to result
r |= SafeCast.toUint((x >> r) > 0xffffffff) << 5;
// If upper 16 bits of 32-bit half set, add 16 to result
r |= SafeCast.toUint((x >> r) > 0xffff) << 4;
// Add 1 if upper 8 bits of 16-bit half set, and divide accumulated result by 8
return (r >> 3) | SafeCast.toUint((x >> r) > 0xff);
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);
}
}
/**
* @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
*/
function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
return uint8(rounding) % 2 == 1;
}
}
// File: @openzeppelin/contracts/utils/math/SignedMath.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.20;
/**
* @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/Strings.sol
// OpenZeppelin Contracts (last updated v5.3.0) (utils/Strings.sol)
pragma solidity ^0.8.20;
/**
* @dev String operations.
*/
library Strings {
using SafeCast for *;
bytes16 private constant HEX_DIGITS = "0123456789abcdef";
uint8 private constant ADDRESS_LENGTH = 20;
uint256 private constant SPECIAL_CHARS_LOOKUP =
(1 << 0x08) | // backspace
(1 << 0x09) | // tab
(1 << 0x0a) | // newline
(1 << 0x0c) | // form feed
(1 << 0x0d) | // carriage return
(1 << 0x22) | // double quote
(1 << 0x5c); // backslash
/**
* @dev The `value` string doesn't fit in the specified `length`.
*/
error StringsInsufficientHexLength(uint256 value, uint256 length);
/**
* @dev The string being parsed contains characters that are not in scope of the given base.
*/
error StringsInvalidChar();
/**
* @dev The string being parsed is not a properly formatted address.
*/
error StringsInvalidAddressFormat();
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
assembly ("memory-safe") {
ptr := add(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));
}
/**
* @dev Parse a decimal string and returns the value as a `uint256`.
*
* Requirements:
* - The string must be formatted as `[0-9]*`
* - The result must fit into an `uint256` type
*/
function parseUint(string memory input) internal pure returns (uint256) {
return parseUint(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseUint-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `[0-9]*`
* - The result must fit into an `uint256` type
*/
function parseUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
(bool success, uint256 value) = tryParseUint(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseUint-string} that returns false if the parsing fails because of an invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseUint(string memory input) internal pure returns (bool success, uint256 value) {
return _tryParseUintUncheckedBounds(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseUint-string-uint256-uint256} that returns false if the parsing fails because of an invalid
* character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseUint(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, uint256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseUintUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseUint-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseUintUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, uint256 value) {
bytes memory buffer = bytes(input);
uint256 result = 0;
for (uint256 i = begin; i < end; ++i) {
uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
if (chr > 9) return (false, 0);
result *= 10;
result += chr;
}
return (true, result);
}
/**
* @dev Parse a decimal string and returns the value as a `int256`.
*
* Requirements:
* - The string must be formatted as `[-+]?[0-9]*`
* - The result must fit in an `int256` type.
*/
function parseInt(string memory input) internal pure returns (int256) {
return parseInt(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseInt-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `[-+]?[0-9]*`
* - The result must fit in an `int256` type.
*/
function parseInt(string memory input, uint256 begin, uint256 end) internal pure returns (int256) {
(bool success, int256 value) = tryParseInt(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseInt-string} that returns false if the parsing fails because of an invalid character or if
* the result does not fit in a `int256`.
*
* NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
*/
function tryParseInt(string memory input) internal pure returns (bool success, int256 value) {
return _tryParseIntUncheckedBounds(input, 0, bytes(input).length);
}
uint256 private constant ABS_MIN_INT256 = 2 ** 255;
/**
* @dev Variant of {parseInt-string-uint256-uint256} that returns false if the parsing fails because of an invalid
* character or if the result does not fit in a `int256`.
*
* NOTE: This function will revert if the absolute value of the result does not fit in a `uint256`.
*/
function tryParseInt(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, int256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseIntUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseInt-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseIntUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, int256 value) {
bytes memory buffer = bytes(input);
// Check presence of a negative sign.
bytes1 sign = begin == end ? bytes1(0) : bytes1(_unsafeReadBytesOffset(buffer, begin)); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
bool positiveSign = sign == bytes1("+");
bool negativeSign = sign == bytes1("-");
uint256 offset = (positiveSign || negativeSign).toUint();
(bool absSuccess, uint256 absValue) = tryParseUint(input, begin + offset, end);
if (absSuccess && absValue < ABS_MIN_INT256) {
return (true, negativeSign ? -int256(absValue) : int256(absValue));
} else if (absSuccess && negativeSign && absValue == ABS_MIN_INT256) {
return (true, type(int256).min);
} else return (false, 0);
}
/**
* @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as a `uint256`.
*
* Requirements:
* - The string must be formatted as `(0x)?[0-9a-fA-F]*`
* - The result must fit in an `uint256` type.
*/
function parseHexUint(string memory input) internal pure returns (uint256) {
return parseHexUint(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseHexUint-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `(0x)?[0-9a-fA-F]*`
* - The result must fit in an `uint256` type.
*/
function parseHexUint(string memory input, uint256 begin, uint256 end) internal pure returns (uint256) {
(bool success, uint256 value) = tryParseHexUint(input, begin, end);
if (!success) revert StringsInvalidChar();
return value;
}
/**
* @dev Variant of {parseHexUint-string} that returns false if the parsing fails because of an invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseHexUint(string memory input) internal pure returns (bool success, uint256 value) {
return _tryParseHexUintUncheckedBounds(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseHexUint-string-uint256-uint256} that returns false if the parsing fails because of an
* invalid character.
*
* NOTE: This function will revert if the result does not fit in a `uint256`.
*/
function tryParseHexUint(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, uint256 value) {
if (end > bytes(input).length || begin > end) return (false, 0);
return _tryParseHexUintUncheckedBounds(input, begin, end);
}
/**
* @dev Implementation of {tryParseHexUint-string-uint256-uint256} that does not check bounds. Caller should make sure that
* `begin <= end <= input.length`. Other inputs would result in undefined behavior.
*/
function _tryParseHexUintUncheckedBounds(
string memory input,
uint256 begin,
uint256 end
) private pure returns (bool success, uint256 value) {
bytes memory buffer = bytes(input);
// skip 0x prefix if present
bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(buffer, begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
uint256 offset = hasPrefix.toUint() * 2;
uint256 result = 0;
for (uint256 i = begin + offset; i < end; ++i) {
uint8 chr = _tryParseChr(bytes1(_unsafeReadBytesOffset(buffer, i)));
if (chr > 15) return (false, 0);
result *= 16;
unchecked {
// Multiplying by 16 is equivalent to a shift of 4 bits (with additional overflow check).
// This guarantees that adding a value < 16 will not cause an overflow, hence the unchecked.
result += chr;
}
}
return (true, result);
}
/**
* @dev Parse a hexadecimal string (with or without "0x" prefix), and returns the value as an `address`.
*
* Requirements:
* - The string must be formatted as `(0x)?[0-9a-fA-F]{40}`
*/
function parseAddress(string memory input) internal pure returns (address) {
return parseAddress(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseAddress-string} that parses a substring of `input` located between position `begin` (included) and
* `end` (excluded).
*
* Requirements:
* - The substring must be formatted as `(0x)?[0-9a-fA-F]{40}`
*/
function parseAddress(string memory input, uint256 begin, uint256 end) internal pure returns (address) {
(bool success, address value) = tryParseAddress(input, begin, end);
if (!success) revert StringsInvalidAddressFormat();
return value;
}
/**
* @dev Variant of {parseAddress-string} that returns false if the parsing fails because the input is not a properly
* formatted address. See {parseAddress-string} requirements.
*/
function tryParseAddress(string memory input) internal pure returns (bool success, address value) {
return tryParseAddress(input, 0, bytes(input).length);
}
/**
* @dev Variant of {parseAddress-string-uint256-uint256} that returns false if the parsing fails because input is not a properly
* formatted address. See {parseAddress-string-uint256-uint256} requirements.
*/
function tryParseAddress(
string memory input,
uint256 begin,
uint256 end
) internal pure returns (bool success, address value) {
if (end > bytes(input).length || begin > end) return (false, address(0));
bool hasPrefix = (end > begin + 1) && bytes2(_unsafeReadBytesOffset(bytes(input), begin)) == bytes2("0x"); // don't do out-of-bound (possibly unsafe) read if sub-string is empty
uint256 expectedLength = 40 + hasPrefix.toUint() * 2;
// check that input is the correct length
if (end - begin == expectedLength) {
// length guarantees that this does not overflow, and value is at most type(uint160).max
(bool s, uint256 v) = _tryParseHexUintUncheckedBounds(input, begin, end);
return (s, address(uint160(v)));
} else {
return (false, address(0));
}
}
function _tryParseChr(bytes1 chr) private pure returns (uint8) {
uint8 value = uint8(chr);
// Try to parse `chr`:
// - Case 1: [0-9]
// - Case 2: [a-f]
// - Case 3: [A-F]
// - otherwise not supported
unchecked {
if (value > 47 && value < 58) value -= 48;
else if (value > 96 && value < 103) value -= 87;
else if (value > 64 && value < 71) value -= 55;
else return type(uint8).max;
}
return value;
}
/**
* @dev Escape special characters in JSON strings. This can be useful to prevent JSON injection in NFT metadata.
*
* WARNING: This function should only be used in double quoted JSON strings. Single quotes are not escaped.
*
* NOTE: This function escapes all unicode characters, and not just the ones in ranges defined in section 2.5 of
* RFC-4627 (U+0000 to U+001F, U+0022 and U+005C). ECMAScript's `JSON.parse` does recover escaped unicode
* characters that are not in this range, but other tooling may provide different results.
*/
function escapeJSON(string memory input) internal pure returns (string memory) {
bytes memory buffer = bytes(input);
bytes memory output = new bytes(2 * buffer.length); // worst case scenario
uint256 outputLength = 0;
for (uint256 i; i < buffer.length; ++i) {
bytes1 char = bytes1(_unsafeReadBytesOffset(buffer, i));
if (((SPECIAL_CHARS_LOOKUP & (1 << uint8(char))) != 0)) {
output[outputLength++] = "\\";
if (char == 0x08) output[outputLength++] = "b";
else if (char == 0x09) output[outputLength++] = "t";
else if (char == 0x0a) output[outputLength++] = "n";
else if (char == 0x0c) output[outputLength++] = "f";
else if (char == 0x0d) output[outputLength++] = "r";
else if (char == 0x5c) output[outputLength++] = "\\";
else if (char == 0x22) {
// solhint-disable-next-line quotes
output[outputLength++] = '"';
}
} else {
output[outputLength++] = char;
}
}
// write the actual length and deallocate unused memory
assembly ("memory-safe") {
mstore(output, outputLength)
mstore(0x40, add(output, shl(5, shr(5, add(outputLength, 63)))))
}
return string(output);
}
/**
* @dev Reads a bytes32 from a bytes array without bounds checking.
*
* NOTE: making this function internal would mean it could be used with memory unsafe offset, and marking the
* assembly block as such would prevent some optimizations.
*/
function _unsafeReadBytesOffset(bytes memory buffer, uint256 offset) private pure returns (bytes32 value) {
// This is not memory safe in the general case, but all calls to this private function are within bounds.
assembly ("memory-safe") {
value := mload(add(buffer, add(0x20, offset)))
}
}
}
// File: @openzeppelin/contracts/utils/introspection/ERC165.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.sol)
pragma solidity ^0.8.20;
/**
* @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/token/ERC721/ERC721.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.20;
/**
* @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/access/Ownable.sol
// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)
pragma solidity ^0.8.20;
/**
* @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: SuperRarer.sol
pragma solidity ^0.8.20;
contract SuperRarer is ERC721, Ownable {
uint256 private _nextTokenId;
// Base URI for metadata
string private _baseTokenURI;
// Fee configuration
uint256 public mintFee = 0.001 ether; // Fee to mint (0.001 ETH)
uint256 public transactionFeePercent = 5; // 5% fee on sales
address public feeRecipient;
constructor(address initialOwner, address _feeRecipient)
ERC721("SuperRarer", "SRR")
Ownable(initialOwner)
{
_baseTokenURI = "https://your-api.com/metadata/";
feeRecipient = _feeRecipient;
}
// Set the base URI
function setBaseURI(string memory baseURI) public onlyOwner {
_baseTokenURI = baseURI;
}
// Override base URI function
function _baseURI() internal view override returns (string memory) {
return _baseTokenURI;
}
// Update fee configuration
function updateFees(uint256 _mintFee, uint256 _transactionFeePercent) public onlyOwner {
mintFee = _mintFee;
transactionFeePercent = _transactionFeePercent;
}
// Update fee recipient
function updateFeeRecipient(address _feeRecipient) public onlyOwner {
feeRecipient = _feeRecipient;
}
// Mint function - anyone can mint by paying the fee
function mint(address to) public payable returns (uint256) {
require(msg.value >= mintFee, "Insufficient payment");
uint256 tokenId = _nextTokenId++;
_safeMint(to, tokenId);
// Send the fee to the fee recipient
payable(feeRecipient).transfer(msg.value);
return tokenId;
}
// Simple transfer with payment and fee
function buyToken(uint256 tokenId) public payable {
address seller = ownerOf(tokenId);
require(msg.sender != seller, "Cannot buy your own token");
// Calculate fee amount (5% of transaction)
uint256 feeAmount = (msg.value * transactionFeePercent) / 100;
uint256 sellerAmount = msg.value - feeAmount;
// Transfer the token
_transfer(seller, msg.sender, tokenId);
// Send fee to fee recipient
payable(feeRecipient).transfer(feeAmount);
// Send remaining payment to seller
payable(seller).transfer(sellerAmount);
}
}Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
Contract ABI
API[{"inputs":[{"internalType":"address","name":"initialOwner","type":"address"},{"internalType":"address","name":"_feeRecipient","type":"address"}],"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":[{"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":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"buyToken","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"feeRecipient","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"getApproved","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"}],"name":"mint","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"mintFee","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"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":"baseURI","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes4","name":"interfaceId","type":"bytes4"}],"name":"supportsInterface","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"transactionFeePercent","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"_feeRecipient","type":"address"}],"name":"updateFeeRecipient","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"_mintFee","type":"uint256"},{"internalType":"uint256","name":"_transactionFeePercent","type":"uint256"}],"name":"updateFees","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
608060405266038d7ea4c680006009556005600a5534801562000020575f80fd5b50604051620032fb380380620032fb833981810160405281019062000046919062000314565b816040518060400160405280600a81526020017f53757065725261726572000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f5352520000000000000000000000000000000000000000000000000000000000815250815f9081620000c39190620005bd565b508060019081620000d59190620005bd565b5050505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036200014b575f6040517f1e4fbdf7000000000000000000000000000000000000000000000000000000008152600401620001429190620006b2565b60405180910390fd5b6200015c81620001ec60201b60201c565b506040518060400160405280601e81526020017f68747470733a2f2f796f75722d6170692e636f6d2f6d657461646174612f000081525060089081620001a39190620005bd565b5080600b5f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055505050620006cd565b5f60065f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160065f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f80fd5b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f620002de82620002b3565b9050919050565b620002f081620002d2565b8114620002fb575f80fd5b50565b5f815190506200030e81620002e5565b92915050565b5f80604083850312156200032d576200032c620002af565b5b5f6200033c85828601620002fe565b92505060206200034f85828601620002fe565b9150509250929050565b5f81519050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f6002820490506001821680620003d557607f821691505b602082108103620003eb57620003ea62000390565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026200044f7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8262000412565b6200045b868362000412565b95508019841693508086168417925050509392505050565b5f819050919050565b5f819050919050565b5f620004a56200049f620004998462000473565b6200047c565b62000473565b9050919050565b5f819050919050565b620004c08362000485565b620004d8620004cf82620004ac565b8484546200041e565b825550505050565b5f90565b620004ee620004e0565b620004fb818484620004b5565b505050565b5b818110156200052257620005165f82620004e4565b60018101905062000501565b5050565b601f82111562000571576200053b81620003f1565b620005468462000403565b8101602085101562000556578190505b6200056e620005658562000403565b83018262000500565b50505b505050565b5f82821c905092915050565b5f620005935f198460080262000576565b1980831691505092915050565b5f620005ad838362000582565b9150826002028217905092915050565b620005c88262000359565b67ffffffffffffffff811115620005e457620005e362000363565b5b620005f08254620003bd565b620005fd82828562000526565b5f60209050601f83116001811462000633575f84156200061e578287015190505b6200062a8582620005a0565b86555062000699565b601f1984166200064386620003f1565b5f5b828110156200066c5784890151825560018201915060208501945060208101905062000645565b868310156200068c578489015162000688601f89168262000582565b8355505b6001600288020188555050505b505050505050565b620006ac81620002d2565b82525050565b5f602082019050620006c75f830184620006a1565b92915050565b612c2080620006db5f395ff3fe60806040526004361061014a575f3560e01c80636a627842116100b5578063a22cb4651161006e578063a22cb46514610464578063b88d4fde1461048c578063c87b56dd146104b4578063e985e9c5146104f0578063f160d3691461052c578063f2fde38b146105545761014a565b80636a627842146103665780636db794371461039657806370a08231146103be578063715018a6146103fa5780638da5cb5b1461041057806395d89b411461043a5761014a565b806323b872dd1161010757806323b872dd1461026c5780632d296bf11461029457806342842e0e146102b057806346904840146102d857806355f804b3146103025780636352211e1461032a5761014a565b806301ffc9a71461014e57806306fdde031461018a578063081812fc146101b4578063095ea7b3146101f05780630c8f5e001461021857806313966db514610242575b5f80fd5b348015610159575f80fd5b50610174600480360381019061016f9190611f3a565b61057c565b6040516101819190611f7f565b60405180910390f35b348015610195575f80fd5b5061019e61065d565b6040516101ab9190612022565b60405180910390f35b3480156101bf575f80fd5b506101da60048036038101906101d59190612075565b6106ec565b6040516101e791906120df565b60405180910390f35b3480156101fb575f80fd5b5061021660048036038101906102119190612122565b610707565b005b348015610223575f80fd5b5061022c61071d565b604051610239919061216f565b60405180910390f35b34801561024d575f80fd5b50610256610723565b604051610263919061216f565b60405180910390f35b348015610277575f80fd5b50610292600480360381019061028d9190612188565b610729565b005b6102ae60048036038101906102a99190612075565b610828565b005b3480156102bb575f80fd5b506102d660048036038101906102d19190612188565b610988565b005b3480156102e3575f80fd5b506102ec6109a7565b6040516102f991906120df565b60405180910390f35b34801561030d575f80fd5b5061032860048036038101906103239190612304565b6109cc565b005b348015610335575f80fd5b50610350600480360381019061034b9190612075565b6109e7565b60405161035d91906120df565b60405180910390f35b610380600480360381019061037b919061234b565b6109f8565b60405161038d919061216f565b60405180910390f35b3480156103a1575f80fd5b506103bc60048036038101906103b79190612376565b610acf565b005b3480156103c9575f80fd5b506103e460048036038101906103df919061234b565b610ae9565b6040516103f1919061216f565b60405180910390f35b348015610405575f80fd5b5061040e610b9f565b005b34801561041b575f80fd5b50610424610bb2565b60405161043191906120df565b60405180910390f35b348015610445575f80fd5b5061044e610bda565b60405161045b9190612022565b60405180910390f35b34801561046f575f80fd5b5061048a600480360381019061048591906123de565b610c6a565b005b348015610497575f80fd5b506104b260048036038101906104ad91906124ba565b610c80565b005b3480156104bf575f80fd5b506104da60048036038101906104d59190612075565b610ca5565b6040516104e79190612022565b60405180910390f35b3480156104fb575f80fd5b506105166004803603810190610511919061253a565b610d0b565b6040516105239190611f7f565b60405180910390f35b348015610537575f80fd5b50610552600480360381019061054d919061234b565b610d99565b005b34801561055f575f80fd5b5061057a6004803603810190610575919061234b565b610de4565b005b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916148061064657507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b80610656575061065582610e68565b5b9050919050565b60605f805461066b906125a5565b80601f0160208091040260200160405190810160405280929190818152602001828054610697906125a5565b80156106e25780601f106106b9576101008083540402835291602001916106e2565b820191905f5260205f20905b8154815290600101906020018083116106c557829003601f168201915b5050505050905090565b5f6106f682610ed1565b5061070082610f57565b9050919050565b6107198282610714610f90565b610f97565b5050565b600a5481565b60095481565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610799575f6040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161079091906120df565b60405180910390fd5b5f6107ac83836107a7610f90565b610fa9565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610822578382826040517f64283d7b000000000000000000000000000000000000000000000000000000008152600401610819939291906125d5565b60405180910390fd5b50505050565b5f610832826109e7565b90508073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16036108a2576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161089990612654565b60405180910390fd5b5f6064600a54346108b3919061269f565b6108bd919061270d565b90505f81346108cc919061273d565b90506108d98333866111b4565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff166108fc8390811502906040515f60405180830381858888f1935050505015801561093d573d5f803e3d5ffd5b508273ffffffffffffffffffffffffffffffffffffffff166108fc8290811502906040515f60405180830381858888f19350505050158015610981573d5f803e3d5ffd5b5050505050565b6109a283838360405180602001604052805f815250610c80565b505050565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b6109d461131c565b80600890816109e3919061290d565b5050565b5f6109f182610ed1565b9050919050565b5f600954341015610a3e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a3590612a26565b60405180910390fd5b5f60075f815480929190610a5190612a44565b919050559050610a6183826113a3565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff166108fc3490811502906040515f60405180830381858888f19350505050158015610ac5573d5f803e3d5ffd5b5080915050919050565b610ad761131c565b8160098190555080600a819055505050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610b5a575f6040517f89c62b64000000000000000000000000000000000000000000000000000000008152600401610b5191906120df565b60405180910390fd5b60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610ba761131c565b610bb05f6113c0565b565b5f60065f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060018054610be9906125a5565b80601f0160208091040260200160405190810160405280929190818152602001828054610c15906125a5565b8015610c605780601f10610c3757610100808354040283529160200191610c60565b820191905f5260205f20905b815481529060010190602001808311610c4357829003601f168201915b5050505050905090565b610c7c610c75610f90565b8383611483565b5050565b610c8b848484610729565b610c9f610c96610f90565b858585856115ec565b50505050565b6060610cb082610ed1565b505f610cba611798565b90505f815111610cd85760405180602001604052805f815250610d03565b80610ce284611828565b604051602001610cf3929190612ac5565b6040516020818303038152906040525b915050919050565b5f60055f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b610da161131c565b80600b5f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b610dec61131c565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610e5c575f6040517f1e4fbdf7000000000000000000000000000000000000000000000000000000008152600401610e5391906120df565b60405180910390fd5b610e65816113c0565b50565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f80610edc836118f2565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610f4e57826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401610f45919061216f565b60405180910390fd5b80915050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b610fa4838383600161192b565b505050565b5f80610fb4846118f2565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614610ff557610ff4818486611aea565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611080576110345f855f8061192b565b600160035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16146110ff57600160035f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460025f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611224575f6040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161121b91906120df565b60405180910390fd5b5f61123083835f610fa9565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036112a257816040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611299919061216f565b60405180910390fd5b8373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611316578382826040517f64283d7b00000000000000000000000000000000000000000000000000000000815260040161130d939291906125d5565b60405180910390fd5b50505050565b611324610f90565b73ffffffffffffffffffffffffffffffffffffffff16611342610bb2565b73ffffffffffffffffffffffffffffffffffffffff16146113a157611365610f90565b6040517f118cdaa700000000000000000000000000000000000000000000000000000000815260040161139891906120df565b60405180910390fd5b565b6113bc828260405180602001604052805f815250611bad565b5050565b5f60065f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160065f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036114f357816040517f5b08ba180000000000000000000000000000000000000000000000000000000081526004016114ea91906120df565b60405180910390fd5b8060055f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31836040516115df9190611f7f565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611791578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b815260040161164a9493929190612b3a565b6020604051808303815f875af192505050801561168557506040513d601f19601f820116820180604052508101906116829190612b98565b60015b611706573d805f81146116b3576040519150601f19603f3d011682016040523d82523d5f602084013e6116b8565b606091505b505f8151036116fe57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016116f591906120df565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461178f57836040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161178691906120df565b60405180910390fd5b505b5050505050565b6060600880546117a7906125a5565b80601f01602080910402602001604051908101604052809291908181526020018280546117d3906125a5565b801561181e5780601f106117f55761010080835404028352916020019161181e565b820191905f5260205f20905b81548152906001019060200180831161180157829003601f168201915b5050505050905090565b60605f600161183684611bd0565b0190505f8167ffffffffffffffff811115611854576118536121e0565b5b6040519080825280601f01601f1916602001820160405280156118865781602001600182028036833780820191505090505b5090505f82602001820190505b6001156118e7578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a85816118dc576118db6126e0565b5b0494505f8503611893575b819350505050919050565b5f60025f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061196357505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15611a95575f61197284610ed1565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141580156119dc57508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156119ef57506119ed8184610d0b565b155b15611a3157826040517fa9fbf51f000000000000000000000000000000000000000000000000000000008152600401611a2891906120df565b60405180910390fd5b8115611a9357838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360045f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b611af5838383611d21565b611ba8575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1603611b6957806040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611b60919061216f565b60405180910390fd5b81816040517f177e802f000000000000000000000000000000000000000000000000000000008152600401611b9f929190612bc3565b60405180910390fd5b505050565b611bb78383611de1565b611bcb611bc2610f90565b5f8585856115ec565b505050565b5f805f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310611c2c577a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008381611c2257611c216126e0565b5b0492506040810190505b6d04ee2d6d415b85acef81000000008310611c69576d04ee2d6d415b85acef81000000008381611c5f57611c5e6126e0565b5b0492506020810190505b662386f26fc100008310611c9857662386f26fc100008381611c8e57611c8d6126e0565b5b0492506010810190505b6305f5e1008310611cc1576305f5e1008381611cb757611cb66126e0565b5b0492506008810190505b6127108310611ce6576127108381611cdc57611cdb6126e0565b5b0492506004810190505b60648310611d095760648381611cff57611cfe6126e0565b5b0492506002810190505b600a8310611d18576001810190505b80915050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015611dd857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611d995750611d988484610d0b565b5b80611dd757508273ffffffffffffffffffffffffffffffffffffffff16611dbf83610f57565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611e51575f6040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611e4891906120df565b60405180910390fd5b5f611e5d83835f610fa9565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611ecf575f6040517f73c6ac6e000000000000000000000000000000000000000000000000000000008152600401611ec691906120df565b60405180910390fd5b505050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b611f1981611ee5565b8114611f23575f80fd5b50565b5f81359050611f3481611f10565b92915050565b5f60208284031215611f4f57611f4e611edd565b5b5f611f5c84828501611f26565b91505092915050565b5f8115159050919050565b611f7981611f65565b82525050565b5f602082019050611f925f830184611f70565b92915050565b5f81519050919050565b5f82825260208201905092915050565b5f5b83811015611fcf578082015181840152602081019050611fb4565b5f8484015250505050565b5f601f19601f8301169050919050565b5f611ff482611f98565b611ffe8185611fa2565b935061200e818560208601611fb2565b61201781611fda565b840191505092915050565b5f6020820190508181035f83015261203a8184611fea565b905092915050565b5f819050919050565b61205481612042565b811461205e575f80fd5b50565b5f8135905061206f8161204b565b92915050565b5f6020828403121561208a57612089611edd565b5b5f61209784828501612061565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f6120c9826120a0565b9050919050565b6120d9816120bf565b82525050565b5f6020820190506120f25f8301846120d0565b92915050565b612101816120bf565b811461210b575f80fd5b50565b5f8135905061211c816120f8565b92915050565b5f806040838503121561213857612137611edd565b5b5f6121458582860161210e565b925050602061215685828601612061565b9150509250929050565b61216981612042565b82525050565b5f6020820190506121825f830184612160565b92915050565b5f805f6060848603121561219f5761219e611edd565b5b5f6121ac8682870161210e565b93505060206121bd8682870161210e565b92505060406121ce86828701612061565b9150509250925092565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b61221682611fda565b810181811067ffffffffffffffff82111715612235576122346121e0565b5b80604052505050565b5f612247611ed4565b9050612253828261220d565b919050565b5f67ffffffffffffffff821115612272576122716121e0565b5b61227b82611fda565b9050602081019050919050565b828183375f83830152505050565b5f6122a86122a384612258565b61223e565b9050828152602081018484840111156122c4576122c36121dc565b5b6122cf848285612288565b509392505050565b5f82601f8301126122eb576122ea6121d8565b5b81356122fb848260208601612296565b91505092915050565b5f6020828403121561231957612318611edd565b5b5f82013567ffffffffffffffff81111561233657612335611ee1565b5b612342848285016122d7565b91505092915050565b5f602082840312156123605761235f611edd565b5b5f61236d8482850161210e565b91505092915050565b5f806040838503121561238c5761238b611edd565b5b5f61239985828601612061565b92505060206123aa85828601612061565b9150509250929050565b6123bd81611f65565b81146123c7575f80fd5b50565b5f813590506123d8816123b4565b92915050565b5f80604083850312156123f4576123f3611edd565b5b5f6124018582860161210e565b9250506020612412858286016123ca565b9150509250929050565b5f67ffffffffffffffff821115612436576124356121e0565b5b61243f82611fda565b9050602081019050919050565b5f61245e6124598461241c565b61223e565b90508281526020810184848401111561247a576124796121dc565b5b612485848285612288565b509392505050565b5f82601f8301126124a1576124a06121d8565b5b81356124b184826020860161244c565b91505092915050565b5f805f80608085870312156124d2576124d1611edd565b5b5f6124df8782880161210e565b94505060206124f08782880161210e565b935050604061250187828801612061565b925050606085013567ffffffffffffffff81111561252257612521611ee1565b5b61252e8782880161248d565b91505092959194509250565b5f80604083850312156125505761254f611edd565b5b5f61255d8582860161210e565b925050602061256e8582860161210e565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806125bc57607f821691505b6020821081036125cf576125ce612578565b5b50919050565b5f6060820190506125e85f8301866120d0565b6125f56020830185612160565b61260260408301846120d0565b949350505050565b7f43616e6e6f742062757920796f7572206f776e20746f6b656e000000000000005f82015250565b5f61263e601983611fa2565b91506126498261260a565b602082019050919050565b5f6020820190508181035f83015261266b81612632565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f6126a982612042565b91506126b483612042565b92508282026126c281612042565b915082820484148315176126d9576126d8612672565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f61271782612042565b915061272283612042565b925082612732576127316126e0565b5b828204905092915050565b5f61274782612042565b915061275283612042565b925082820390508181111561276a57612769612672565b5b92915050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026127cc7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82612791565b6127d68683612791565b95508019841693508086168417925050509392505050565b5f819050919050565b5f61281161280c61280784612042565b6127ee565b612042565b9050919050565b5f819050919050565b61282a836127f7565b61283e61283682612818565b84845461279d565b825550505050565b5f90565b612852612846565b61285d818484612821565b505050565b5b81811015612880576128755f8261284a565b600181019050612863565b5050565b601f8211156128c55761289681612770565b61289f84612782565b810160208510156128ae578190505b6128c26128ba85612782565b830182612862565b50505b505050565b5f82821c905092915050565b5f6128e55f19846008026128ca565b1980831691505092915050565b5f6128fd83836128d6565b9150826002028217905092915050565b61291682611f98565b67ffffffffffffffff81111561292f5761292e6121e0565b5b61293982546125a5565b612944828285612884565b5f60209050601f831160018114612975575f8415612963578287015190505b61296d85826128f2565b8655506129d4565b601f19841661298386612770565b5f5b828110156129aa57848901518255600182019150602085019450602081019050612985565b868310156129c757848901516129c3601f8916826128d6565b8355505b6001600288020188555050505b505050505050565b7f496e73756666696369656e74207061796d656e740000000000000000000000005f82015250565b5f612a10601483611fa2565b9150612a1b826129dc565b602082019050919050565b5f6020820190508181035f830152612a3d81612a04565b9050919050565b5f612a4e82612042565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8203612a8057612a7f612672565b5b600182019050919050565b5f81905092915050565b5f612a9f82611f98565b612aa98185612a8b565b9350612ab9818560208601611fb2565b80840191505092915050565b5f612ad08285612a95565b9150612adc8284612a95565b91508190509392505050565b5f81519050919050565b5f82825260208201905092915050565b5f612b0c82612ae8565b612b168185612af2565b9350612b26818560208601611fb2565b612b2f81611fda565b840191505092915050565b5f608082019050612b4d5f8301876120d0565b612b5a60208301866120d0565b612b676040830185612160565b8181036060830152612b798184612b02565b905095945050505050565b5f81519050612b9281611f10565b92915050565b5f60208284031215612bad57612bac611edd565b5b5f612bba84828501612b84565b91505092915050565b5f604082019050612bd65f8301856120d0565b612be36020830184612160565b939250505056fea26469706673582212206645d5227750587ad06022b778531eb315fecd3fae48a4730b1f384ff8b4dc4864736f6c6343000814003300000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e700000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e7
Deployed Bytecode
0x60806040526004361061014a575f3560e01c80636a627842116100b5578063a22cb4651161006e578063a22cb46514610464578063b88d4fde1461048c578063c87b56dd146104b4578063e985e9c5146104f0578063f160d3691461052c578063f2fde38b146105545761014a565b80636a627842146103665780636db794371461039657806370a08231146103be578063715018a6146103fa5780638da5cb5b1461041057806395d89b411461043a5761014a565b806323b872dd1161010757806323b872dd1461026c5780632d296bf11461029457806342842e0e146102b057806346904840146102d857806355f804b3146103025780636352211e1461032a5761014a565b806301ffc9a71461014e57806306fdde031461018a578063081812fc146101b4578063095ea7b3146101f05780630c8f5e001461021857806313966db514610242575b5f80fd5b348015610159575f80fd5b50610174600480360381019061016f9190611f3a565b61057c565b6040516101819190611f7f565b60405180910390f35b348015610195575f80fd5b5061019e61065d565b6040516101ab9190612022565b60405180910390f35b3480156101bf575f80fd5b506101da60048036038101906101d59190612075565b6106ec565b6040516101e791906120df565b60405180910390f35b3480156101fb575f80fd5b5061021660048036038101906102119190612122565b610707565b005b348015610223575f80fd5b5061022c61071d565b604051610239919061216f565b60405180910390f35b34801561024d575f80fd5b50610256610723565b604051610263919061216f565b60405180910390f35b348015610277575f80fd5b50610292600480360381019061028d9190612188565b610729565b005b6102ae60048036038101906102a99190612075565b610828565b005b3480156102bb575f80fd5b506102d660048036038101906102d19190612188565b610988565b005b3480156102e3575f80fd5b506102ec6109a7565b6040516102f991906120df565b60405180910390f35b34801561030d575f80fd5b5061032860048036038101906103239190612304565b6109cc565b005b348015610335575f80fd5b50610350600480360381019061034b9190612075565b6109e7565b60405161035d91906120df565b60405180910390f35b610380600480360381019061037b919061234b565b6109f8565b60405161038d919061216f565b60405180910390f35b3480156103a1575f80fd5b506103bc60048036038101906103b79190612376565b610acf565b005b3480156103c9575f80fd5b506103e460048036038101906103df919061234b565b610ae9565b6040516103f1919061216f565b60405180910390f35b348015610405575f80fd5b5061040e610b9f565b005b34801561041b575f80fd5b50610424610bb2565b60405161043191906120df565b60405180910390f35b348015610445575f80fd5b5061044e610bda565b60405161045b9190612022565b60405180910390f35b34801561046f575f80fd5b5061048a600480360381019061048591906123de565b610c6a565b005b348015610497575f80fd5b506104b260048036038101906104ad91906124ba565b610c80565b005b3480156104bf575f80fd5b506104da60048036038101906104d59190612075565b610ca5565b6040516104e79190612022565b60405180910390f35b3480156104fb575f80fd5b506105166004803603810190610511919061253a565b610d0b565b6040516105239190611f7f565b60405180910390f35b348015610537575f80fd5b50610552600480360381019061054d919061234b565b610d99565b005b34801561055f575f80fd5b5061057a6004803603810190610575919061234b565b610de4565b005b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916148061064657507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b80610656575061065582610e68565b5b9050919050565b60605f805461066b906125a5565b80601f0160208091040260200160405190810160405280929190818152602001828054610697906125a5565b80156106e25780601f106106b9576101008083540402835291602001916106e2565b820191905f5260205f20905b8154815290600101906020018083116106c557829003601f168201915b5050505050905090565b5f6106f682610ed1565b5061070082610f57565b9050919050565b6107198282610714610f90565b610f97565b5050565b600a5481565b60095481565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610799575f6040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161079091906120df565b60405180910390fd5b5f6107ac83836107a7610f90565b610fa9565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614610822578382826040517f64283d7b000000000000000000000000000000000000000000000000000000008152600401610819939291906125d5565b60405180910390fd5b50505050565b5f610832826109e7565b90508073ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff16036108a2576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161089990612654565b60405180910390fd5b5f6064600a54346108b3919061269f565b6108bd919061270d565b90505f81346108cc919061273d565b90506108d98333866111b4565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff166108fc8390811502906040515f60405180830381858888f1935050505015801561093d573d5f803e3d5ffd5b508273ffffffffffffffffffffffffffffffffffffffff166108fc8290811502906040515f60405180830381858888f19350505050158015610981573d5f803e3d5ffd5b5050505050565b6109a283838360405180602001604052805f815250610c80565b505050565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b6109d461131c565b80600890816109e3919061290d565b5050565b5f6109f182610ed1565b9050919050565b5f600954341015610a3e576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610a3590612a26565b60405180910390fd5b5f60075f815480929190610a5190612a44565b919050559050610a6183826113a3565b600b5f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff166108fc3490811502906040515f60405180830381858888f19350505050158015610ac5573d5f803e3d5ffd5b5080915050919050565b610ad761131c565b8160098190555080600a819055505050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610b5a575f6040517f89c62b64000000000000000000000000000000000000000000000000000000008152600401610b5191906120df565b60405180910390fd5b60035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b610ba761131c565b610bb05f6113c0565b565b5f60065f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060018054610be9906125a5565b80601f0160208091040260200160405190810160405280929190818152602001828054610c15906125a5565b8015610c605780601f10610c3757610100808354040283529160200191610c60565b820191905f5260205f20905b815481529060010190602001808311610c4357829003601f168201915b5050505050905090565b610c7c610c75610f90565b8383611483565b5050565b610c8b848484610729565b610c9f610c96610f90565b858585856115ec565b50505050565b6060610cb082610ed1565b505f610cba611798565b90505f815111610cd85760405180602001604052805f815250610d03565b80610ce284611828565b604051602001610cf3929190612ac5565b6040516020818303038152906040525b915050919050565b5f60055f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b610da161131c565b80600b5f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050565b610dec61131c565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610e5c575f6040517f1e4fbdf7000000000000000000000000000000000000000000000000000000008152600401610e5391906120df565b60405180910390fd5b610e65816113c0565b50565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f80610edc836118f2565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1603610f4e57826040517f7e273289000000000000000000000000000000000000000000000000000000008152600401610f45919061216f565b60405180910390fd5b80915050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b610fa4838383600161192b565b505050565b5f80610fb4846118f2565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614610ff557610ff4818486611aea565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611080576110345f855f8061192b565b600160035f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16146110ff57600160035f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460025f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611224575f6040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161121b91906120df565b60405180910390fd5b5f61123083835f610fa9565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036112a257816040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611299919061216f565b60405180910390fd5b8373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611316578382826040517f64283d7b00000000000000000000000000000000000000000000000000000000815260040161130d939291906125d5565b60405180910390fd5b50505050565b611324610f90565b73ffffffffffffffffffffffffffffffffffffffff16611342610bb2565b73ffffffffffffffffffffffffffffffffffffffff16146113a157611365610f90565b6040517f118cdaa700000000000000000000000000000000000000000000000000000000815260040161139891906120df565b60405180910390fd5b565b6113bc828260405180602001604052805f815250611bad565b5050565b5f60065f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160065f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff16036114f357816040517f5b08ba180000000000000000000000000000000000000000000000000000000081526004016114ea91906120df565b60405180910390fd5b8060055f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31836040516115df9190611f7f565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611791578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b815260040161164a9493929190612b3a565b6020604051808303815f875af192505050801561168557506040513d601f19601f820116820180604052508101906116829190612b98565b60015b611706573d805f81146116b3576040519150601f19603f3d011682016040523d82523d5f602084013e6116b8565b606091505b505f8151036116fe57836040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016116f591906120df565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161461178f57836040517f64a0ae9200000000000000000000000000000000000000000000000000000000815260040161178691906120df565b60405180910390fd5b505b5050505050565b6060600880546117a7906125a5565b80601f01602080910402602001604051908101604052809291908181526020018280546117d3906125a5565b801561181e5780601f106117f55761010080835404028352916020019161181e565b820191905f5260205f20905b81548152906001019060200180831161180157829003601f168201915b5050505050905090565b60605f600161183684611bd0565b0190505f8167ffffffffffffffff811115611854576118536121e0565b5b6040519080825280601f01601f1916602001820160405280156118865781602001600182028036833780820191505090505b5090505f82602001820190505b6001156118e7578080600190039150507f3031323334353637383961626364656600000000000000000000000000000000600a86061a8153600a85816118dc576118db6126e0565b5b0494505f8503611893575b819350505050919050565b5f60025f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061196357505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15611a95575f61197284610ed1565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141580156119dc57508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156119ef57506119ed8184610d0b565b155b15611a3157826040517fa9fbf51f000000000000000000000000000000000000000000000000000000008152600401611a2891906120df565b60405180910390fd5b8115611a9357838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360045f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b611af5838383611d21565b611ba8575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1603611b6957806040517f7e273289000000000000000000000000000000000000000000000000000000008152600401611b60919061216f565b60405180910390fd5b81816040517f177e802f000000000000000000000000000000000000000000000000000000008152600401611b9f929190612bc3565b60405180910390fd5b505050565b611bb78383611de1565b611bcb611bc2610f90565b5f8585856115ec565b505050565b5f805f90507a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008310611c2c577a184f03e93ff9f4daa797ed6e38ed64bf6a1f0100000000000000008381611c2257611c216126e0565b5b0492506040810190505b6d04ee2d6d415b85acef81000000008310611c69576d04ee2d6d415b85acef81000000008381611c5f57611c5e6126e0565b5b0492506020810190505b662386f26fc100008310611c9857662386f26fc100008381611c8e57611c8d6126e0565b5b0492506010810190505b6305f5e1008310611cc1576305f5e1008381611cb757611cb66126e0565b5b0492506008810190505b6127108310611ce6576127108381611cdc57611cdb6126e0565b5b0492506004810190505b60648310611d095760648381611cff57611cfe6126e0565b5b0492506002810190505b600a8310611d18576001810190505b80915050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015611dd857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480611d995750611d988484610d0b565b5b80611dd757508273ffffffffffffffffffffffffffffffffffffffff16611dbf83610f57565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611e51575f6040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611e4891906120df565b60405180910390fd5b5f611e5d83835f610fa9565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611ecf575f6040517f73c6ac6e000000000000000000000000000000000000000000000000000000008152600401611ec691906120df565b60405180910390fd5b505050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b611f1981611ee5565b8114611f23575f80fd5b50565b5f81359050611f3481611f10565b92915050565b5f60208284031215611f4f57611f4e611edd565b5b5f611f5c84828501611f26565b91505092915050565b5f8115159050919050565b611f7981611f65565b82525050565b5f602082019050611f925f830184611f70565b92915050565b5f81519050919050565b5f82825260208201905092915050565b5f5b83811015611fcf578082015181840152602081019050611fb4565b5f8484015250505050565b5f601f19601f8301169050919050565b5f611ff482611f98565b611ffe8185611fa2565b935061200e818560208601611fb2565b61201781611fda565b840191505092915050565b5f6020820190508181035f83015261203a8184611fea565b905092915050565b5f819050919050565b61205481612042565b811461205e575f80fd5b50565b5f8135905061206f8161204b565b92915050565b5f6020828403121561208a57612089611edd565b5b5f61209784828501612061565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f6120c9826120a0565b9050919050565b6120d9816120bf565b82525050565b5f6020820190506120f25f8301846120d0565b92915050565b612101816120bf565b811461210b575f80fd5b50565b5f8135905061211c816120f8565b92915050565b5f806040838503121561213857612137611edd565b5b5f6121458582860161210e565b925050602061215685828601612061565b9150509250929050565b61216981612042565b82525050565b5f6020820190506121825f830184612160565b92915050565b5f805f6060848603121561219f5761219e611edd565b5b5f6121ac8682870161210e565b93505060206121bd8682870161210e565b92505060406121ce86828701612061565b9150509250925092565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b61221682611fda565b810181811067ffffffffffffffff82111715612235576122346121e0565b5b80604052505050565b5f612247611ed4565b9050612253828261220d565b919050565b5f67ffffffffffffffff821115612272576122716121e0565b5b61227b82611fda565b9050602081019050919050565b828183375f83830152505050565b5f6122a86122a384612258565b61223e565b9050828152602081018484840111156122c4576122c36121dc565b5b6122cf848285612288565b509392505050565b5f82601f8301126122eb576122ea6121d8565b5b81356122fb848260208601612296565b91505092915050565b5f6020828403121561231957612318611edd565b5b5f82013567ffffffffffffffff81111561233657612335611ee1565b5b612342848285016122d7565b91505092915050565b5f602082840312156123605761235f611edd565b5b5f61236d8482850161210e565b91505092915050565b5f806040838503121561238c5761238b611edd565b5b5f61239985828601612061565b92505060206123aa85828601612061565b9150509250929050565b6123bd81611f65565b81146123c7575f80fd5b50565b5f813590506123d8816123b4565b92915050565b5f80604083850312156123f4576123f3611edd565b5b5f6124018582860161210e565b9250506020612412858286016123ca565b9150509250929050565b5f67ffffffffffffffff821115612436576124356121e0565b5b61243f82611fda565b9050602081019050919050565b5f61245e6124598461241c565b61223e565b90508281526020810184848401111561247a576124796121dc565b5b612485848285612288565b509392505050565b5f82601f8301126124a1576124a06121d8565b5b81356124b184826020860161244c565b91505092915050565b5f805f80608085870312156124d2576124d1611edd565b5b5f6124df8782880161210e565b94505060206124f08782880161210e565b935050604061250187828801612061565b925050606085013567ffffffffffffffff81111561252257612521611ee1565b5b61252e8782880161248d565b91505092959194509250565b5f80604083850312156125505761254f611edd565b5b5f61255d8582860161210e565b925050602061256e8582860161210e565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806125bc57607f821691505b6020821081036125cf576125ce612578565b5b50919050565b5f6060820190506125e85f8301866120d0565b6125f56020830185612160565b61260260408301846120d0565b949350505050565b7f43616e6e6f742062757920796f7572206f776e20746f6b656e000000000000005f82015250565b5f61263e601983611fa2565b91506126498261260a565b602082019050919050565b5f6020820190508181035f83015261266b81612632565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f6126a982612042565b91506126b483612042565b92508282026126c281612042565b915082820484148315176126d9576126d8612672565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f61271782612042565b915061272283612042565b925082612732576127316126e0565b5b828204905092915050565b5f61274782612042565b915061275283612042565b925082820390508181111561276a57612769612672565b5b92915050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f600883026127cc7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff82612791565b6127d68683612791565b95508019841693508086168417925050509392505050565b5f819050919050565b5f61281161280c61280784612042565b6127ee565b612042565b9050919050565b5f819050919050565b61282a836127f7565b61283e61283682612818565b84845461279d565b825550505050565b5f90565b612852612846565b61285d818484612821565b505050565b5b81811015612880576128755f8261284a565b600181019050612863565b5050565b601f8211156128c55761289681612770565b61289f84612782565b810160208510156128ae578190505b6128c26128ba85612782565b830182612862565b50505b505050565b5f82821c905092915050565b5f6128e55f19846008026128ca565b1980831691505092915050565b5f6128fd83836128d6565b9150826002028217905092915050565b61291682611f98565b67ffffffffffffffff81111561292f5761292e6121e0565b5b61293982546125a5565b612944828285612884565b5f60209050601f831160018114612975575f8415612963578287015190505b61296d85826128f2565b8655506129d4565b601f19841661298386612770565b5f5b828110156129aa57848901518255600182019150602085019450602081019050612985565b868310156129c757848901516129c3601f8916826128d6565b8355505b6001600288020188555050505b505050505050565b7f496e73756666696369656e74207061796d656e740000000000000000000000005f82015250565b5f612a10601483611fa2565b9150612a1b826129dc565b602082019050919050565b5f6020820190508181035f830152612a3d81612a04565b9050919050565b5f612a4e82612042565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8203612a8057612a7f612672565b5b600182019050919050565b5f81905092915050565b5f612a9f82611f98565b612aa98185612a8b565b9350612ab9818560208601611fb2565b80840191505092915050565b5f612ad08285612a95565b9150612adc8284612a95565b91508190509392505050565b5f81519050919050565b5f82825260208201905092915050565b5f612b0c82612ae8565b612b168185612af2565b9350612b26818560208601611fb2565b612b2f81611fda565b840191505092915050565b5f608082019050612b4d5f8301876120d0565b612b5a60208301866120d0565b612b676040830185612160565b8181036060830152612b798184612b02565b905095945050505050565b5f81519050612b9281611f10565b92915050565b5f60208284031215612bad57612bac611edd565b5b5f612bba84828501612b84565b91505092915050565b5f604082019050612bd65f8301856120d0565b612be36020830184612160565b939250505056fea26469706673582212206645d5227750587ad06022b778531eb315fecd3fae48a4730b1f384ff8b4dc4864736f6c63430008140033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
00000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e700000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e7
-----Decoded View---------------
Arg [0] : initialOwner (address): 0x05dF3e4b689124697b24e95bE2f5604eB24791e7
Arg [1] : _feeRecipient (address): 0x05dF3e4b689124697b24e95bE2f5604eB24791e7
-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 00000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e7
Arg [1] : 00000000000000000000000005df3e4b689124697b24e95be2f5604eb24791e7
Deployed Bytecode Sourcemap
131597:2392:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;113047:305;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;113878:91;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;115050:158;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;114869:115;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;131852:40;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;131781:36;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;115719:588;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;133331:655;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;116378:134;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;131918:27;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;132223:102;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;113691:120;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;132918:360;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;132515:181;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;113416:213;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;130700:103;;;;;;;;;;;;;:::i;:::-;;130025:87;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;114038:95;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;115280:146;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;116583:236;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;114204:260;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;115497:155;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;132737:115;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;130958:220;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;113047:305;113149:4;113201:25;113186:40;;;:11;:40;;;;:105;;;;113258:33;113243:48;;;:11;:48;;;;113186:105;:158;;;;113308:36;113332:11;113308:23;:36::i;:::-;113186:158;113166:178;;113047:305;;;:::o;113878:91::-;113923:13;113956:5;113949:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;113878:91;:::o;115050:158::-;115117:7;115137:22;115151:7;115137:13;:22::i;:::-;;115179:21;115192:7;115179:12;:21::i;:::-;115172:28;;115050:158;;;:::o;114869:115::-;114941:35;114950:2;114954:7;114963:12;:10;:12::i;:::-;114941:8;:35::i;:::-;114869:115;;:::o;131852:40::-;;;;:::o;131781:36::-;;;;:::o;115719:588::-;115828:1;115814:16;;:2;:16;;;115810:89;;115884:1;115854:33;;;;;;;;;;;:::i;:::-;;;;;;;;115810:89;116120:21;116144:34;116152:2;116156:7;116165:12;:10;:12::i;:::-;116144:7;:34::i;:::-;116120:58;;116210:4;116193:21;;:13;:21;;;116189:111;;116259:4;116265:7;116274:13;116238:50;;;;;;;;;;;;;:::i;:::-;;;;;;;;116189:111;115799:508;115719:588;;;:::o;133331:655::-;133392:14;133409:16;133417:7;133409;:16::i;:::-;133392:33;;133458:6;133444:20;;:10;:20;;;133436:58;;;;;;;;;;;;:::i;:::-;;;;;;;;;133568:17;133626:3;133601:21;;133589:9;:33;;;;:::i;:::-;133588:41;;;;:::i;:::-;133568:61;;133640:20;133675:9;133663;:21;;;;:::i;:::-;133640:44;;133736:38;133746:6;133754:10;133766:7;133736:9;:38::i;:::-;133841:12;;;;;;;;;;;133833:30;;:41;133864:9;133833:41;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;133948:6;133940:24;;:38;133965:12;133940:38;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;133381:605;;;133331:655;:::o;116378:134::-;116465:39;116482:4;116488:2;116492:7;116465:39;;;;;;;;;;;;:16;:39::i;:::-;116378:134;;;:::o;131918:27::-;;;;;;;;;;;;;:::o;132223:102::-;129911:13;:11;:13::i;:::-;132310:7:::1;132294:13;:23;;;;;;:::i;:::-;;132223:102:::0;:::o;113691:120::-;113754:7;113781:22;113795:7;113781:13;:22::i;:::-;113774:29;;113691:120;;;:::o;132918:360::-;132968:7;133009;;132996:9;:20;;132988:53;;;;;;;;;;;;:::i;:::-;;;;;;;;;133062:15;133080:12;;:14;;;;;;;;;:::i;:::-;;;;;133062:32;;133105:22;133115:2;133119:7;133105:9;:22::i;:::-;133202:12;;;;;;;;;;;133194:30;;:41;133225:9;133194:41;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;133263:7;133256:14;;;132918:360;;;:::o;132515:181::-;129911:13;:11;:13::i;:::-;132623:8:::1;132613:7;:18;;;;132666:22;132642:21;:46;;;;132515:181:::0;;:::o;113416:213::-;113479:7;113520:1;113503:19;;:5;:19;;;113499:89;;113573:1;113546:30;;;;;;;;;;;:::i;:::-;;;;;;;;113499:89;113605:9;:16;113615:5;113605:16;;;;;;;;;;;;;;;;113598:23;;113416:213;;;:::o;130700:103::-;129911:13;:11;:13::i;:::-;130765:30:::1;130792:1;130765:18;:30::i;:::-;130700:103::o:0;130025:87::-;130071:7;130098:6;;;;;;;;;;;130091:13;;130025:87;:::o;114038:95::-;114085:13;114118:7;114111:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;114038:95;:::o;115280:146::-;115366:52;115385:12;:10;:12::i;:::-;115399:8;115409;115366:18;:52::i;:::-;115280:146;;:::o;116583:236::-;116697:31;116710:4;116716:2;116720:7;116697:12;:31::i;:::-;116739:72;116773:12;:10;:12::i;:::-;116787:4;116793:2;116797:7;116806:4;116739:33;:72::i;:::-;116583:236;;;;:::o;114204:260::-;114268:13;114294:22;114308:7;114294:13;:22::i;:::-;;114329:21;114353:10;:8;:10::i;:::-;114329:34;;114405:1;114387:7;114381:21;:25;:75;;;;;;;;;;;;;;;;;114423:7;114432:18;:7;:16;:18::i;:::-;114409:42;;;;;;;;;:::i;:::-;;;;;;;;;;;;;114381:75;114374:82;;;114204:260;;;:::o;115497:155::-;115585:4;115609:18;:25;115628:5;115609:25;;;;;;;;;;;;;;;:35;115635:8;115609:35;;;;;;;;;;;;;;;;;;;;;;;;;115602:42;;115497:155;;;;:::o;132737:115::-;129911:13;:11;:13::i;:::-;132831::::1;132816:12;;:28;;;;;;;;;;;;;;;;;;132737:115:::0;:::o;130958:220::-;129911:13;:11;:13::i;:::-;131063:1:::1;131043:22;;:8;:22;;::::0;131039:93:::1;;131117:1;131089:31;;;;;;;;;;;:::i;:::-;;;;;;;;131039:93;131142:28;131161:8;131142:18;:28::i;:::-;130958:220:::0;:::o;111645:148::-;111721:4;111760:25;111745:40;;;:11;:40;;;;111738:47;;111645:148;;;:::o;128101:247::-;128164:7;128184:13;128200:17;128209:7;128200:8;:17::i;:::-;128184:33;;128249:1;128232:19;;:5;:19;;;128228:90;;128298:7;128275:31;;;;;;;;;;;:::i;:::-;;;;;;;;128228:90;128335:5;128328:12;;;128101:247;;;:::o;117582:129::-;117652:7;117679:15;:24;117695:7;117679:24;;;;;;;;;;;;;;;;;;;;;117672:31;;117582:129;;;:::o;17177:98::-;17230:7;17257:10;17250:17;;17177:98;:::o;126333:122::-;126414:33;126423:2;126427:7;126436:4;126442;126414:8;:33::i;:::-;126333:122;;;:::o;120543:824::-;120629:7;120649:12;120664:17;120673:7;120664:8;:17::i;:::-;120649:32;;120760:1;120744:18;;:4;:18;;;120740:88;;120779:37;120796:4;120802;120808:7;120779:16;:37::i;:::-;120740:88;120891:1;120875:18;;:4;:18;;;120871:263;;120993:48;121010:1;121014:7;121031:1;121035:5;120993:8;:48::i;:::-;121106:1;121087:9;:15;121097:4;121087:15;;;;;;;;;;;;;;;;:20;;;;;;;;;;;120871:263;121164:1;121150:16;;:2;:16;;;121146:111;;121229:1;121212:9;:13;121222:2;121212:13;;;;;;;;;;;;;;;;:18;;;;;;;;;;;121146:111;121288:2;121269:7;:16;121277:7;121269:16;;;;;;;;;;;;:21;;;;;;;;;;;;;;;;;;121327:7;121323:2;121308:27;;121317:4;121308:27;;;;;;;;;;;;121355:4;121348:11;;;120543:824;;;;;:::o;123848:470::-;123948:1;123934:16;;:2;:16;;;123930:89;;124004:1;123974:33;;;;;;;;;;;:::i;:::-;;;;;;;;123930:89;124029:21;124053:32;124061:2;124065:7;124082:1;124053:7;:32::i;:::-;124029:56;;124125:1;124100:27;;:13;:27;;;124096:215;;124174:7;124151:31;;;;;;;;;;;:::i;:::-;;;;;;;;124096:215;124221:4;124204:21;;:13;:21;;;124200:111;;124270:4;124276:7;124285:13;124249:50;;;;;;;;;;;;;:::i;:::-;;;;;;;;124200:111;123919:399;123848:470;;;:::o;130190:166::-;130261:12;:10;:12::i;:::-;130250:23;;:7;:5;:7::i;:::-;:23;;;130246:103;;130324:12;:10;:12::i;:::-;130297:40;;;;;;;;;;;:::i;:::-;;;;;;;;130246:103;130190:166::o;122401:102::-;122469:26;122479:2;122483:7;122469:26;;;;;;;;;;;;:9;:26::i;:::-;122401:102;;:::o;131338:191::-;131412:16;131431:6;;;;;;;;;;;131412:25;;131457:8;131448:6;;:17;;;;;;;;;;;;;;;;;;131512:8;131481:40;;131502:8;131481:40;;;;;;;;;;;;131401:128;131338:191;:::o;127540:318::-;127668:1;127648:22;;:8;:22;;;127644:93;;127716:8;127694:31;;;;;;;;;;;:::i;:::-;;;;;;;;127644:93;127785:8;127747:18;:25;127766:5;127747:25;;;;;;;;;;;;;;;:35;127773:8;127747:35;;;;;;;;;;;;;;;;:46;;;;;;;;;;;;;;;;;;127831:8;127809:41;;127824:5;127809:41;;;127841:8;127809:41;;;;;;:::i;:::-;;;;;;;;127540:318;;;:::o;15527:948::-;15731:1;15714:2;:14;;;:18;15710:758;;;15769:2;15753:36;;;15790:8;15800:4;15806:7;15815:4;15753:67;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;15749:708;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;16133:1;16116:6;:13;:18;16112:330;;16258:2;16222:39;;;;;;;;;;;:::i;:::-;;;;;;;;16112:330;16392:6;16386:13;16377:6;16373:2;16369:15;16362:38;15749:708;15878:41;;;15868:51;;;:6;:51;;;;15864:185;;16026:2;15990:39;;;;;;;;;;;:::i;:::-;;;;;;;;15864:185;15821:243;15710:758;15527:948;;;;;:::o;132368:106::-;132420:13;132453;132446:20;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;132368:106;:::o;92445:650::-;92501:13;92552:14;92589:1;92569:17;92580:5;92569:10;:17::i;:::-;:21;92552:38;;92605:20;92639:6;92628:18;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;92605:41;;92661:11;92758:6;92754:2;92750:15;92742:6;92738:28;92731:35;;92795:254;92802:4;92795:254;;;92827:5;;;;;;;;92933:10;92928:2;92921:5;92917:14;92912:32;92907:3;92899:46;92991:2;92982:11;;;;;;:::i;:::-;;;;;93025:1;93016:5;:10;92795:254;93012:21;92795:254;93070:6;93063:13;;;;;92445:650;;;:::o;117344:117::-;117410:7;117437;:16;117445:7;117437:16;;;;;;;;;;;;;;;;;;;;;117430:23;;117344:117;;;:::o;126643:678::-;126805:9;:31;;;;126834:1;126818:18;;:4;:18;;;;126805:31;126801:471;;;126853:13;126869:22;126883:7;126869:13;:22::i;:::-;126853:38;;127038:1;127022:18;;:4;:18;;;;:35;;;;;127053:4;127044:13;;:5;:13;;;;127022:35;:69;;;;;127062:29;127079:5;127086:4;127062:16;:29::i;:::-;127061:30;127022:69;127018:144;;;127141:4;127119:27;;;;;;;;;;;:::i;:::-;;;;;;;;127018:144;127182:9;127178:83;;;127237:7;127233:2;127217:28;;127226:5;127217:28;;;;;;;;;;;;127178:83;126838:434;126801:471;127311:2;127284:15;:24;127300:7;127284:24;;;;;;;;;;;;:29;;;;;;;;;;;;;;;;;;126643:678;;;;:::o;118750:376::-;118863:38;118877:5;118884:7;118893;118863:13;:38::i;:::-;118858:261;;118939:1;118922:19;;:5;:19;;;118918:190;;118992:7;118969:31;;;;;;;;;;;:::i;:::-;;;;;;;;118918:190;119075:7;119084;119048:44;;;;;;;;;;;;:::i;:::-;;;;;;;;118858:261;118750:376;;;:::o;122730:210::-;122825:18;122831:2;122835:7;122825:5;:18::i;:::-;122854:78;122888:12;:10;:12::i;:::-;122910:1;122914:2;122918:7;122927:4;122854:33;:78::i;:::-;122730:210;;;:::o;85456:948::-;85509:7;85529:14;85546:1;85529:18;;85596:8;85587:5;:17;85583:106;;85634:8;85625:17;;;;;;:::i;:::-;;;;;85671:2;85661:12;;;;85583:106;85716:8;85707:5;:17;85703:106;;85754:8;85745:17;;;;;;:::i;:::-;;;;;85791:2;85781:12;;;;85703:106;85836:8;85827:5;:17;85823:106;;85874:8;85865:17;;;;;;:::i;:::-;;;;;85911:2;85901:12;;;;85823:106;85956:7;85947:5;:16;85943:103;;85993:7;85984:16;;;;;;:::i;:::-;;;;;86029:1;86019:11;;;;85943:103;86073:7;86064:5;:16;86060:103;;86110:7;86101:16;;;;;;:::i;:::-;;;;;86146:1;86136:11;;;;86060:103;86190:7;86181:5;:16;86177:103;;86227:7;86218:16;;;;;;:::i;:::-;;;;;86263:1;86253:11;;;;86177:103;86307:7;86298:5;:16;86294:68;;86345:1;86335:11;;;;86294:68;86390:6;86383:13;;;85456:948;;;:::o;118031:276::-;118134:4;118190:1;118171:21;;:7;:21;;;;:128;;;;;118219:7;118210:16;;:5;:16;;;:52;;;;118230:32;118247:5;118254:7;118230:16;:32::i;:::-;118210:52;:88;;;;118291:7;118266:32;;:21;118279:7;118266:12;:21::i;:::-;:32;;;118210:88;118171:128;118151:148;;118031:276;;;;;:::o;121703:335::-;121785:1;121771:16;;:2;:16;;;121767:89;;121841:1;121811:33;;;;;;;;;;;:::i;:::-;;;;;;;;121767:89;121866:21;121890:32;121898:2;121902:7;121919:1;121890:7;:32::i;:::-;121866:56;;121962:1;121937:27;;:13;:27;;;121933:98;;122016:1;121988:31;;;;;;;;;;;:::i;:::-;;;;;;;;121933:98;121756:282;121703: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:246::-;1879:1;1889:113;1903:6;1900:1;1897:13;1889:113;;;1988:1;1983:3;1979:11;1973:18;1969:1;1964:3;1960:11;1953:39;1925:2;1922:1;1918:10;1913:15;;1889:113;;;2036:1;2027:6;2022:3;2018:16;2011:27;1860:184;1798:246;;;:::o;2050:102::-;2091:6;2142:2;2138:7;2133:2;2126:5;2122:14;2118:28;2108:38;;2050:102;;;:::o;2158:377::-;2246:3;2274:39;2307:5;2274:39;:::i;:::-;2329:71;2393:6;2388:3;2329:71;:::i;:::-;2322:78;;2409:65;2467:6;2462:3;2455:4;2448:5;2444:16;2409:65;:::i;:::-;2499:29;2521:6;2499:29;:::i;:::-;2494:3;2490:39;2483:46;;2250:285;2158:377;;;;:::o;2541:313::-;2654:4;2692:2;2681:9;2677:18;2669:26;;2741:9;2735:4;2731:20;2727:1;2716:9;2712:17;2705:47;2769:78;2842:4;2833:6;2769:78;:::i;:::-;2761:86;;2541:313;;;;:::o;2860:77::-;2897:7;2926:5;2915:16;;2860:77;;;:::o;2943:122::-;3016:24;3034:5;3016:24;:::i;:::-;3009:5;3006:35;2996:63;;3055:1;3052;3045:12;2996:63;2943:122;:::o;3071:139::-;3117:5;3155:6;3142:20;3133:29;;3171:33;3198:5;3171:33;:::i;:::-;3071:139;;;;:::o;3216:329::-;3275:6;3324:2;3312:9;3303:7;3299:23;3295:32;3292:119;;;3330:79;;:::i;:::-;3292:119;3450:1;3475:53;3520:7;3511:6;3500:9;3496:22;3475:53;:::i;:::-;3465:63;;3421:117;3216:329;;;;:::o;3551:126::-;3588:7;3628:42;3621:5;3617:54;3606:65;;3551:126;;;:::o;3683:96::-;3720:7;3749:24;3767:5;3749:24;:::i;:::-;3738:35;;3683:96;;;:::o;3785:118::-;3872:24;3890:5;3872:24;:::i;:::-;3867:3;3860:37;3785:118;;:::o;3909:222::-;4002:4;4040:2;4029:9;4025:18;4017:26;;4053:71;4121:1;4110:9;4106:17;4097:6;4053:71;:::i;:::-;3909:222;;;;:::o;4137:122::-;4210:24;4228:5;4210:24;:::i;:::-;4203:5;4200:35;4190:63;;4249:1;4246;4239:12;4190:63;4137:122;:::o;4265:139::-;4311:5;4349:6;4336:20;4327:29;;4365:33;4392:5;4365:33;:::i;:::-;4265:139;;;;:::o;4410:474::-;4478:6;4486;4535:2;4523:9;4514:7;4510:23;4506:32;4503:119;;;4541:79;;:::i;:::-;4503:119;4661:1;4686:53;4731:7;4722:6;4711:9;4707:22;4686:53;:::i;:::-;4676:63;;4632:117;4788:2;4814:53;4859:7;4850:6;4839:9;4835:22;4814:53;:::i;:::-;4804:63;;4759:118;4410:474;;;;;:::o;4890:118::-;4977:24;4995:5;4977:24;:::i;:::-;4972:3;4965:37;4890:118;;:::o;5014:222::-;5107:4;5145:2;5134:9;5130:18;5122:26;;5158:71;5226:1;5215:9;5211:17;5202:6;5158:71;:::i;:::-;5014:222;;;;:::o;5242:619::-;5319:6;5327;5335;5384:2;5372:9;5363:7;5359:23;5355:32;5352:119;;;5390:79;;:::i;:::-;5352:119;5510:1;5535:53;5580:7;5571:6;5560:9;5556:22;5535:53;:::i;:::-;5525:63;;5481:117;5637:2;5663:53;5708:7;5699:6;5688:9;5684:22;5663:53;:::i;:::-;5653:63;;5608:118;5765:2;5791:53;5836:7;5827:6;5816:9;5812:22;5791:53;:::i;:::-;5781:63;;5736:118;5242:619;;;;;:::o;5867:117::-;5976:1;5973;5966:12;5990:117;6099:1;6096;6089:12;6113:180;6161:77;6158:1;6151:88;6258:4;6255:1;6248:15;6282:4;6279:1;6272:15;6299:281;6382:27;6404:4;6382:27;:::i;:::-;6374:6;6370:40;6512:6;6500:10;6497:22;6476:18;6464:10;6461:34;6458:62;6455:88;;;6523:18;;:::i;:::-;6455:88;6563:10;6559:2;6552:22;6342:238;6299:281;;:::o;6586:129::-;6620:6;6647:20;;:::i;:::-;6637:30;;6676:33;6704:4;6696:6;6676:33;:::i;:::-;6586:129;;;:::o;6721:308::-;6783:4;6873:18;6865:6;6862:30;6859:56;;;6895:18;;:::i;:::-;6859:56;6933:29;6955:6;6933:29;:::i;:::-;6925:37;;7017:4;7011;7007:15;6999:23;;6721:308;;;:::o;7035:146::-;7132:6;7127:3;7122;7109:30;7173:1;7164:6;7159:3;7155:16;7148:27;7035:146;;;:::o;7187:425::-;7265:5;7290:66;7306:49;7348:6;7306:49;:::i;:::-;7290:66;:::i;:::-;7281:75;;7379:6;7372:5;7365:21;7417:4;7410:5;7406:16;7455:3;7446:6;7441:3;7437:16;7434:25;7431:112;;;7462:79;;:::i;:::-;7431:112;7552:54;7599:6;7594:3;7589;7552:54;:::i;:::-;7271:341;7187:425;;;;;:::o;7632:340::-;7688:5;7737:3;7730:4;7722:6;7718:17;7714:27;7704:122;;7745:79;;:::i;:::-;7704:122;7862:6;7849:20;7887:79;7962:3;7954:6;7947:4;7939:6;7935:17;7887:79;:::i;:::-;7878:88;;7694:278;7632:340;;;;:::o;7978:509::-;8047:6;8096:2;8084:9;8075:7;8071:23;8067:32;8064:119;;;8102:79;;:::i;:::-;8064:119;8250:1;8239:9;8235:17;8222:31;8280:18;8272:6;8269:30;8266:117;;;8302:79;;:::i;:::-;8266:117;8407:63;8462:7;8453:6;8442:9;8438:22;8407:63;:::i;:::-;8397:73;;8193:287;7978:509;;;;:::o;8493:329::-;8552:6;8601:2;8589:9;8580:7;8576:23;8572:32;8569:119;;;8607:79;;:::i;:::-;8569:119;8727:1;8752:53;8797:7;8788:6;8777:9;8773:22;8752:53;:::i;:::-;8742:63;;8698:117;8493:329;;;;:::o;8828:474::-;8896:6;8904;8953:2;8941:9;8932:7;8928:23;8924:32;8921:119;;;8959:79;;:::i;:::-;8921:119;9079:1;9104:53;9149:7;9140:6;9129:9;9125:22;9104:53;:::i;:::-;9094:63;;9050:117;9206:2;9232:53;9277:7;9268:6;9257:9;9253:22;9232:53;:::i;:::-;9222:63;;9177:118;8828:474;;;;;:::o;9308:116::-;9378:21;9393:5;9378:21;:::i;:::-;9371:5;9368:32;9358:60;;9414:1;9411;9404:12;9358:60;9308:116;:::o;9430:133::-;9473:5;9511:6;9498:20;9489:29;;9527:30;9551:5;9527:30;:::i;:::-;9430:133;;;;:::o;9569:468::-;9634:6;9642;9691:2;9679:9;9670:7;9666:23;9662:32;9659:119;;;9697:79;;:::i;:::-;9659:119;9817:1;9842:53;9887:7;9878:6;9867:9;9863:22;9842:53;:::i;:::-;9832:63;;9788:117;9944:2;9970:50;10012:7;10003:6;9992:9;9988:22;9970:50;:::i;:::-;9960:60;;9915:115;9569:468;;;;;:::o;10043:307::-;10104:4;10194:18;10186:6;10183:30;10180:56;;;10216:18;;:::i;:::-;10180:56;10254:29;10276:6;10254:29;:::i;:::-;10246:37;;10338:4;10332;10328:15;10320:23;;10043:307;;;:::o;10356:423::-;10433:5;10458:65;10474:48;10515:6;10474:48;:::i;:::-;10458:65;:::i;:::-;10449:74;;10546:6;10539:5;10532:21;10584:4;10577:5;10573:16;10622:3;10613:6;10608:3;10604:16;10601:25;10598:112;;;10629:79;;:::i;:::-;10598:112;10719:54;10766:6;10761:3;10756;10719:54;:::i;:::-;10439:340;10356:423;;;;;:::o;10798:338::-;10853:5;10902:3;10895:4;10887:6;10883:17;10879:27;10869:122;;10910:79;;:::i;:::-;10869:122;11027:6;11014:20;11052:78;11126:3;11118:6;11111:4;11103:6;11099:17;11052:78;:::i;:::-;11043:87;;10859:277;10798:338;;;;:::o;11142:943::-;11237:6;11245;11253;11261;11310:3;11298:9;11289:7;11285:23;11281:33;11278:120;;;11317:79;;:::i;:::-;11278:120;11437:1;11462:53;11507:7;11498:6;11487:9;11483:22;11462:53;:::i;:::-;11452:63;;11408:117;11564:2;11590:53;11635:7;11626:6;11615:9;11611:22;11590:53;:::i;:::-;11580:63;;11535:118;11692:2;11718:53;11763:7;11754:6;11743:9;11739:22;11718:53;:::i;:::-;11708:63;;11663:118;11848:2;11837:9;11833:18;11820:32;11879:18;11871:6;11868:30;11865:117;;;11901:79;;:::i;:::-;11865:117;12006:62;12060:7;12051:6;12040:9;12036:22;12006:62;:::i;:::-;11996:72;;11791:287;11142:943;;;;;;;:::o;12091:474::-;12159:6;12167;12216:2;12204:9;12195:7;12191:23;12187:32;12184:119;;;12222:79;;:::i;:::-;12184:119;12342:1;12367:53;12412:7;12403:6;12392:9;12388:22;12367:53;:::i;:::-;12357:63;;12313:117;12469:2;12495:53;12540:7;12531:6;12520:9;12516:22;12495:53;:::i;:::-;12485:63;;12440:118;12091:474;;;;;:::o;12571:180::-;12619:77;12616:1;12609:88;12716:4;12713:1;12706:15;12740:4;12737:1;12730:15;12757:320;12801:6;12838:1;12832:4;12828:12;12818:22;;12885:1;12879:4;12875:12;12906:18;12896:81;;12962:4;12954:6;12950:17;12940:27;;12896:81;13024:2;13016:6;13013:14;12993:18;12990:38;12987:84;;13043:18;;:::i;:::-;12987:84;12808:269;12757:320;;;:::o;13083:442::-;13232:4;13270:2;13259:9;13255:18;13247:26;;13283:71;13351:1;13340:9;13336:17;13327:6;13283:71;:::i;:::-;13364:72;13432:2;13421:9;13417:18;13408:6;13364:72;:::i;:::-;13446;13514:2;13503:9;13499:18;13490:6;13446:72;:::i;:::-;13083:442;;;;;;:::o;13531:175::-;13671:27;13667:1;13659:6;13655:14;13648:51;13531:175;:::o;13712:366::-;13854:3;13875:67;13939:2;13934:3;13875:67;:::i;:::-;13868:74;;13951:93;14040:3;13951:93;:::i;:::-;14069:2;14064:3;14060:12;14053:19;;13712:366;;;:::o;14084:419::-;14250:4;14288:2;14277:9;14273:18;14265:26;;14337:9;14331:4;14327:20;14323:1;14312:9;14308:17;14301:47;14365:131;14491:4;14365:131;:::i;:::-;14357:139;;14084:419;;;:::o;14509:180::-;14557:77;14554:1;14547:88;14654:4;14651:1;14644:15;14678:4;14675:1;14668:15;14695:410;14735:7;14758:20;14776:1;14758:20;:::i;:::-;14753:25;;14792:20;14810:1;14792:20;:::i;:::-;14787:25;;14847:1;14844;14840:9;14869:30;14887:11;14869:30;:::i;:::-;14858:41;;15048:1;15039:7;15035:15;15032:1;15029:22;15009:1;15002:9;14982:83;14959:139;;15078:18;;:::i;:::-;14959:139;14743:362;14695:410;;;;:::o;15111:180::-;15159:77;15156:1;15149:88;15256:4;15253:1;15246:15;15280:4;15277:1;15270:15;15297:185;15337:1;15354:20;15372:1;15354:20;:::i;:::-;15349:25;;15388:20;15406:1;15388:20;:::i;:::-;15383:25;;15427:1;15417:35;;15432:18;;:::i;:::-;15417:35;15474:1;15471;15467:9;15462:14;;15297:185;;;;:::o;15488:194::-;15528:4;15548:20;15566:1;15548:20;:::i;:::-;15543:25;;15582:20;15600:1;15582:20;:::i;:::-;15577:25;;15626:1;15623;15619:9;15611:17;;15650:1;15644:4;15641:11;15638:37;;;15655:18;;:::i;:::-;15638:37;15488:194;;;;:::o;15688:141::-;15737:4;15760:3;15752:11;;15783:3;15780:1;15773:14;15817:4;15814:1;15804:18;15796:26;;15688:141;;;:::o;15835:93::-;15872:6;15919:2;15914;15907:5;15903:14;15899:23;15889:33;;15835:93;;;:::o;15934:107::-;15978:8;16028:5;16022:4;16018:16;15997:37;;15934:107;;;;:::o;16047:393::-;16116:6;16166:1;16154:10;16150:18;16189:97;16219:66;16208:9;16189:97;:::i;:::-;16307:39;16337:8;16326:9;16307:39;:::i;:::-;16295:51;;16379:4;16375:9;16368:5;16364:21;16355:30;;16428:4;16418:8;16414:19;16407:5;16404:30;16394:40;;16123:317;;16047:393;;;;;:::o;16446:60::-;16474:3;16495:5;16488:12;;16446:60;;;:::o;16512:142::-;16562:9;16595:53;16613:34;16622:24;16640:5;16622:24;:::i;:::-;16613:34;:::i;:::-;16595:53;:::i;:::-;16582:66;;16512:142;;;:::o;16660:75::-;16703:3;16724:5;16717:12;;16660:75;;;:::o;16741:269::-;16851:39;16882:7;16851:39;:::i;:::-;16912:91;16961:41;16985:16;16961:41;:::i;:::-;16953:6;16946:4;16940:11;16912:91;:::i;:::-;16906:4;16899:105;16817:193;16741:269;;;:::o;17016:73::-;17061:3;17016:73;:::o;17095:189::-;17172:32;;:::i;:::-;17213:65;17271:6;17263;17257:4;17213:65;:::i;:::-;17148:136;17095:189;;:::o;17290:186::-;17350:120;17367:3;17360:5;17357:14;17350:120;;;17421:39;17458:1;17451:5;17421:39;:::i;:::-;17394:1;17387:5;17383:13;17374:22;;17350:120;;;17290:186;;:::o;17482:543::-;17583:2;17578:3;17575:11;17572:446;;;17617:38;17649:5;17617:38;:::i;:::-;17701:29;17719:10;17701:29;:::i;:::-;17691:8;17687:44;17884:2;17872:10;17869:18;17866:49;;;17905:8;17890:23;;17866:49;17928:80;17984:22;18002:3;17984:22;:::i;:::-;17974:8;17970:37;17957:11;17928:80;:::i;:::-;17587:431;;17572:446;17482:543;;;:::o;18031:117::-;18085:8;18135:5;18129:4;18125:16;18104:37;;18031:117;;;;:::o;18154:169::-;18198:6;18231:51;18279:1;18275:6;18267:5;18264:1;18260:13;18231:51;:::i;:::-;18227:56;18312:4;18306;18302:15;18292:25;;18205:118;18154:169;;;;:::o;18328:295::-;18404:4;18550:29;18575:3;18569:4;18550:29;:::i;:::-;18542:37;;18612:3;18609:1;18605:11;18599:4;18596:21;18588:29;;18328:295;;;;:::o;18628:1395::-;18745:37;18778:3;18745:37;:::i;:::-;18847:18;18839:6;18836:30;18833:56;;;18869:18;;:::i;:::-;18833:56;18913:38;18945:4;18939:11;18913:38;:::i;:::-;18998:67;19058:6;19050;19044:4;18998:67;:::i;:::-;19092:1;19116:4;19103:17;;19148:2;19140:6;19137:14;19165:1;19160:618;;;;19822:1;19839:6;19836:77;;;19888:9;19883:3;19879:19;19873:26;19864:35;;19836:77;19939:67;19999:6;19992:5;19939:67;:::i;:::-;19933:4;19926:81;19795:222;19130:887;;19160:618;19212:4;19208:9;19200:6;19196:22;19246:37;19278:4;19246:37;:::i;:::-;19305:1;19319:208;19333:7;19330:1;19327:14;19319:208;;;19412:9;19407:3;19403:19;19397:26;19389:6;19382:42;19463:1;19455:6;19451:14;19441:24;;19510:2;19499:9;19495:18;19482:31;;19356:4;19353:1;19349:12;19344:17;;19319:208;;;19555:6;19546:7;19543:19;19540:179;;;19613:9;19608:3;19604:19;19598:26;19656:48;19698:4;19690:6;19686:17;19675:9;19656:48;:::i;:::-;19648:6;19641:64;19563:156;19540:179;19765:1;19761;19753:6;19749:14;19745:22;19739:4;19732:36;19167:611;;;19130:887;;18720:1303;;;18628:1395;;:::o;20029:170::-;20169:22;20165:1;20157:6;20153:14;20146:46;20029:170;:::o;20205:366::-;20347:3;20368:67;20432:2;20427:3;20368:67;:::i;:::-;20361:74;;20444:93;20533:3;20444:93;:::i;:::-;20562:2;20557:3;20553:12;20546:19;;20205:366;;;:::o;20577:419::-;20743:4;20781:2;20770:9;20766:18;20758:26;;20830:9;20824:4;20820:20;20816:1;20805:9;20801:17;20794:47;20858:131;20984:4;20858:131;:::i;:::-;20850:139;;20577:419;;;:::o;21002:233::-;21041:3;21064:24;21082:5;21064:24;:::i;:::-;21055:33;;21110:66;21103:5;21100:77;21097:103;;21180:18;;:::i;:::-;21097:103;21227:1;21220:5;21216:13;21209:20;;21002:233;;;:::o;21241:148::-;21343:11;21380:3;21365:18;;21241:148;;;;:::o;21395:390::-;21501:3;21529:39;21562:5;21529:39;:::i;:::-;21584:89;21666:6;21661:3;21584:89;:::i;:::-;21577:96;;21682:65;21740:6;21735:3;21728:4;21721:5;21717:16;21682:65;:::i;:::-;21772:6;21767:3;21763:16;21756:23;;21505:280;21395:390;;;;:::o;21791:435::-;21971:3;21993:95;22084:3;22075:6;21993:95;:::i;:::-;21986:102;;22105:95;22196:3;22187:6;22105:95;:::i;:::-;22098:102;;22217:3;22210:10;;21791:435;;;;;:::o;22232:98::-;22283:6;22317:5;22311:12;22301:22;;22232:98;;;:::o;22336:168::-;22419:11;22453:6;22448:3;22441:19;22493:4;22488:3;22484:14;22469:29;;22336:168;;;;:::o;22510:373::-;22596:3;22624:38;22656:5;22624:38;:::i;:::-;22678:70;22741:6;22736:3;22678:70;:::i;:::-;22671:77;;22757:65;22815:6;22810:3;22803:4;22796:5;22792:16;22757:65;:::i;:::-;22847:29;22869:6;22847:29;:::i;:::-;22842:3;22838:39;22831:46;;22600:283;22510:373;;;;:::o;22889:640::-;23084:4;23122:3;23111:9;23107:19;23099:27;;23136:71;23204:1;23193:9;23189:17;23180:6;23136:71;:::i;:::-;23217:72;23285:2;23274:9;23270:18;23261:6;23217:72;:::i;:::-;23299;23367:2;23356:9;23352:18;23343:6;23299:72;:::i;:::-;23418:9;23412:4;23408:20;23403:2;23392:9;23388:18;23381:48;23446:76;23517:4;23508:6;23446:76;:::i;:::-;23438:84;;22889:640;;;;;;;:::o;23535:141::-;23591:5;23622:6;23616:13;23607:22;;23638:32;23664:5;23638:32;:::i;:::-;23535:141;;;;:::o;23682:349::-;23751:6;23800:2;23788:9;23779:7;23775:23;23771:32;23768:119;;;23806:79;;:::i;:::-;23768:119;23926:1;23951:63;24006:7;23997:6;23986:9;23982:22;23951:63;:::i;:::-;23941:73;;23897:127;23682:349;;;;:::o;24037:332::-;24158:4;24196:2;24185:9;24181:18;24173:26;;24209:71;24277:1;24266:9;24262:17;24253:6;24209:71;:::i;:::-;24290:72;24358:2;24347:9;24343:18;24334:6;24290:72;:::i;:::-;24037:332;;;;;:::o
Swarm Source
ipfs://6645d5227750587ad06022b778531eb315fecd3fae48a4730b1f384ff8b4dc48
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.