Source Code
Overview
APE Balance
0 APEMore Info
ContractCreator
TokenTracker
Latest 1 from a total of 1 transactions
| Transaction Hash |
Method
|
Block
|
From
|
To
|
|||||
|---|---|---|---|---|---|---|---|---|---|
| Mint Random Batc... | 16445538 | 18 days ago | IN | 0 APE | 0.00005988 |
Loading...
Loading
Contract Name:
OCSpikiesRandom
Compiler Version
v0.8.20+commit.a1b79de6
Contract Source Code (Solidity)
/**
*Submitted for verification at curtis.apescan.io on 2025-03-09
*/
// SPDX-License-Identifier: MIT
// 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.1.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 {IERC721-onERC721Received}
* on the `to` address. The `operator` is generally the address that initiated the token transfer (i.e. `msg.sender`).
*
* The acceptance call is not executed and treated as a no-op if the target address doesn't contain code (i.e. an EOA).
* Otherwise, the recipient must implement {IERC721Receiver-onERC721Received} and return the acceptance magic value to accept
* the transfer.
*/
function checkOnERC721Received(
address operator,
address from,
address to,
uint256 tokenId,
bytes memory data
) internal {
if (to.code.length > 0) {
try IERC721Receiver(to).onERC721Received(operator, from, tokenId, data) returns (bytes4 retval) {
if (retval != IERC721Receiver.onERC721Received.selector) {
// Token rejected
revert IERC721Errors.ERC721InvalidReceiver(to);
}
} catch (bytes memory reason) {
if (reason.length == 0) {
// non-IERC721Receiver implementer
revert IERC721Errors.ERC721InvalidReceiver(to);
} else {
assembly ("memory-safe") {
revert(add(32, reason), mload(reason))
}
}
}
}
}
}
// File: @openzeppelin/contracts/utils/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.1.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 Returns the addition of two unsigned integers, with an success flag (no overflow).
*/
function tryAdd(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
uint256 c = a + b;
if (c < a) return (false, 0);
return (true, c);
}
}
/**
* @dev Returns the subtraction of two unsigned integers, with an success flag (no overflow).
*/
function trySub(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b > a) return (false, 0);
return (true, a - b);
}
}
/**
* @dev Returns the multiplication of two unsigned integers, with an success flag (no overflow).
*/
function tryMul(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
// Gas optimization: this is cheaper than requiring 'a' not being zero, but the
// benefit is lost if 'b' is also tested.
// See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
if (a == 0) return (true, 0);
uint256 c = a * b;
if (c / a != b) return (false, 0);
return (true, c);
}
}
/**
* @dev Returns the division of two unsigned integers, with a success flag (no division by zero).
*/
function tryDiv(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b == 0) return (false, 0);
return (true, a / b);
}
}
/**
* @dev Returns the remainder of dividing two unsigned integers, with a success flag (no division by zero).
*/
function tryMod(uint256 a, uint256 b) internal pure returns (bool success, uint256 result) {
unchecked {
if (b == 0) return (false, 0);
return (true, a % b);
}
}
/**
* @dev Branchless ternary evaluation for `a ? b : c`. Gas costs are constant.
*
* IMPORTANT: This function may reduce bytecode size and consume less gas when used standalone.
* However, the compiler may optimize Solidity ternary operations (i.e. `a ? b : c`) to only compute
* one branch when needed, making this function more expensive.
*/
function ternary(bool condition, uint256 a, uint256 b) internal pure returns (uint256) {
unchecked {
// branchless ternary works because:
// b ^ (a ^ b) == a
// b ^ 0 == b
return b ^ ((a ^ b) * SafeCast.toUint(condition));
}
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a > b, a, b);
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return ternary(a < b, a, b);
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds towards infinity instead
* of rounding towards zero.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
if (b == 0) {
// Guarantee the same behavior as in a regular Solidity division.
Panic.panic(Panic.DIVISION_BY_ZERO);
}
// The following calculation ensures accurate ceiling division without overflow.
// Since a is non-zero, (a - 1) / b will not overflow.
// The largest possible result occurs when (a - 1) / b is type(uint256).max,
// but the largest value we can obtain is type(uint256).max - 1, which happens
// when a = type(uint256).max and b = 1.
unchecked {
return SafeCast.toUint(a > 0) * ((a - 1) / b + 1);
}
}
/**
* @dev Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or
* denominator == 0.
*
* Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv) with further edits by
* Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2²⁵⁶ and mod 2²⁵⁶ - 1, then use
// the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2²⁵⁶ + prod0.
uint256 prod0 = x * y; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2²⁵⁶. Also prevents denominator == 0.
if (denominator <= prod1) {
Panic.panic(ternary(denominator == 0, Panic.DIVISION_BY_ZERO, Panic.UNDER_OVERFLOW));
}
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator.
// Always >= 1. See https://cs.stackexchange.com/q/138556/92363.
uint256 twos = denominator & (0 - denominator);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2²⁵⁶ / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2²⁵⁶. Now that denominator is an odd number, it has an inverse modulo 2²⁵⁶ such
// that denominator * inv ≡ 1 mod 2²⁵⁶. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv ≡ 1 mod 2⁴.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also
// works in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2⁸
inverse *= 2 - denominator * inverse; // inverse mod 2¹⁶
inverse *= 2 - denominator * inverse; // inverse mod 2³²
inverse *= 2 - denominator * inverse; // inverse mod 2⁶⁴
inverse *= 2 - denominator * inverse; // inverse mod 2¹²⁸
inverse *= 2 - denominator * inverse; // inverse mod 2²⁵⁶
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2²⁵⁶. Since the preconditions guarantee that the outcome is
// less than 2²⁵⁶, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @dev Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
return mulDiv(x, y, denominator) + SafeCast.toUint(unsignedRoundsUp(rounding) && mulmod(x, y, denominator) > 0);
}
/**
* @dev Calculate the modular multiplicative inverse of a number in Z/nZ.
*
* If n is a prime, then Z/nZ is a field. In that case all elements are inversible, except 0.
* If n is not a prime, then Z/nZ is not a field, and some elements might not be inversible.
*
* If the input value is not inversible, 0 is returned.
*
* NOTE: If you know for sure that n is (big) a prime, it may be cheaper to use Fermat's little theorem and get the
* inverse using `Math.modExp(a, n - 2, n)`. See {invModPrime}.
*/
function invMod(uint256 a, uint256 n) internal pure returns (uint256) {
unchecked {
if (n == 0) return 0;
// The inverse modulo is calculated using the Extended Euclidean Algorithm (iterative version)
// Used to compute integers x and y such that: ax + ny = gcd(a, n).
// When the gcd is 1, then the inverse of a modulo n exists and it's x.
// ax + ny = 1
// ax = 1 + (-y)n
// ax ≡ 1 (mod n) # x is the inverse of a modulo n
// If the remainder is 0 the gcd is n right away.
uint256 remainder = a % n;
uint256 gcd = n;
// Therefore the initial coefficients are:
// ax + ny = gcd(a, n) = n
// 0a + 1n = n
int256 x = 0;
int256 y = 1;
while (remainder != 0) {
uint256 quotient = gcd / remainder;
(gcd, remainder) = (
// The old remainder is the next gcd to try.
remainder,
// Compute the next remainder.
// Can't overflow given that (a % gcd) * (gcd // (a % gcd)) <= gcd
// where gcd is at most n (capped to type(uint256).max)
gcd - remainder * quotient
);
(x, y) = (
// Increment the coefficient of a.
y,
// Decrement the coefficient of n.
// Can overflow, but the result is casted to uint256 so that the
// next value of y is "wrapped around" to a value between 0 and n - 1.
x - y * int256(quotient)
);
}
if (gcd != 1) return 0; // No inverse exists.
return ternary(x < 0, n - uint256(-x), uint256(x)); // Wrap the result if it's negative.
}
}
/**
* @dev Variant of {invMod}. More efficient, but only works if `p` is known to be a prime greater than `2`.
*
* From https://en.wikipedia.org/wiki/Fermat%27s_little_theorem[Fermat's little theorem], we know that if p is
* prime, then `a**(p-1) ≡ 1 mod p`. As a consequence, we have `a * a**(p-2) ≡ 1 mod p`, which means that
* `a**(p-2)` is the modular multiplicative inverse of a in Fp.
*
* NOTE: this function does NOT check that `p` is a prime greater than `2`.
*/
function invModPrime(uint256 a, uint256 p) internal view returns (uint256) {
unchecked {
return Math.modExp(a, p - 2, p);
}
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m)
*
* Requirements:
* - modulus can't be zero
* - underlying staticcall to precompile must succeed
*
* IMPORTANT: The result is only valid if the underlying call succeeds. When using this function, make
* sure the chain you're using it on supports the precompiled contract for modular exponentiation
* at address 0x05 as specified in https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise,
* the underlying function will succeed given the lack of a revert, but the result may be incorrectly
* interpreted as 0.
*/
function modExp(uint256 b, uint256 e, uint256 m) internal view returns (uint256) {
(bool success, uint256 result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Returns the modular exponentiation of the specified base, exponent and modulus (b ** e % m).
* It includes a success flag indicating if the operation succeeded. Operation will be marked as failed if trying
* to operate modulo 0 or if the underlying precompile reverted.
*
* IMPORTANT: The result is only valid if the success flag is true. When using this function, make sure the chain
* you're using it on supports the precompiled contract for modular exponentiation at address 0x05 as specified in
* https://eips.ethereum.org/EIPS/eip-198[EIP-198]. Otherwise, the underlying function will succeed given the lack
* of a revert, but the result may be incorrectly interpreted as 0.
*/
function tryModExp(uint256 b, uint256 e, uint256 m) internal view returns (bool success, uint256 result) {
if (m == 0) return (false, 0);
assembly ("memory-safe") {
let ptr := mload(0x40)
// | Offset | Content | Content (Hex) |
// |-----------|------------|--------------------------------------------------------------------|
// | 0x00:0x1f | size of b | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x20:0x3f | size of e | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x40:0x5f | size of m | 0x0000000000000000000000000000000000000000000000000000000000000020 |
// | 0x60:0x7f | value of b | 0x<.............................................................b> |
// | 0x80:0x9f | value of e | 0x<.............................................................e> |
// | 0xa0:0xbf | value of m | 0x<.............................................................m> |
mstore(ptr, 0x20)
mstore(add(ptr, 0x20), 0x20)
mstore(add(ptr, 0x40), 0x20)
mstore(add(ptr, 0x60), b)
mstore(add(ptr, 0x80), e)
mstore(add(ptr, 0xa0), m)
// Given the result < m, it's guaranteed to fit in 32 bytes,
// so we can use the memory scratch space located at offset 0.
success := staticcall(gas(), 0x05, ptr, 0xc0, 0x00, 0x20)
result := mload(0x00)
}
}
/**
* @dev Variant of {modExp} that supports inputs of arbitrary length.
*/
function modExp(bytes memory b, bytes memory e, bytes memory m) internal view returns (bytes memory) {
(bool success, bytes memory result) = tryModExp(b, e, m);
if (!success) {
Panic.panic(Panic.DIVISION_BY_ZERO);
}
return result;
}
/**
* @dev Variant of {tryModExp} that supports inputs of arbitrary length.
*/
function tryModExp(
bytes memory b,
bytes memory e,
bytes memory m
) internal view returns (bool success, bytes memory result) {
if (_zeroBytes(m)) return (false, new bytes(0));
uint256 mLen = m.length;
// Encode call args in result and move the free memory pointer
result = abi.encodePacked(b.length, e.length, mLen, b, e, m);
assembly ("memory-safe") {
let dataPtr := add(result, 0x20)
// Write result on top of args to avoid allocating extra memory.
success := staticcall(gas(), 0x05, dataPtr, mload(result), dataPtr, mLen)
// Overwrite the length.
// result.length > returndatasize() is guaranteed because returndatasize() == m.length
mstore(result, mLen)
// Set the memory pointer after the returned data.
mstore(0x40, add(dataPtr, mLen))
}
}
/**
* @dev Returns whether the provided byte array is zero.
*/
function _zeroBytes(bytes memory byteArray) private pure returns (bool) {
for (uint256 i = 0; i < byteArray.length; ++i) {
if (byteArray[i] != 0) {
return false;
}
}
return true;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded
* towards zero.
*
* This method is based on Newton's method for computing square roots; the algorithm is restricted to only
* using integer operations.
*/
function sqrt(uint256 a) internal pure returns (uint256) {
unchecked {
// Take care of easy edge cases when a == 0 or a == 1
if (a <= 1) {
return a;
}
// In this function, we use Newton's method to get a root of `f(x) := x² - a`. It involves building a
// sequence x_n that converges toward sqrt(a). For each iteration x_n, we also define the error between
// the current value as `ε_n = | x_n - sqrt(a) |`.
//
// For our first estimation, we consider `e` the smallest power of 2 which is bigger than the square root
// of the target. (i.e. `2**(e-1) ≤ sqrt(a) < 2**e`). We know that `e ≤ 128` because `(2¹²⁸)² = 2²⁵⁶` is
// bigger than any uint256.
//
// By noticing that
// `2**(e-1) ≤ sqrt(a) < 2**e → (2**(e-1))² ≤ a < (2**e)² → 2**(2*e-2) ≤ a < 2**(2*e)`
// we can deduce that `e - 1` is `log2(a) / 2`. We can thus compute `x_n = 2**(e-1)` using a method similar
// to the msb function.
uint256 aa = a;
uint256 xn = 1;
if (aa >= (1 << 128)) {
aa >>= 128;
xn <<= 64;
}
if (aa >= (1 << 64)) {
aa >>= 64;
xn <<= 32;
}
if (aa >= (1 << 32)) {
aa >>= 32;
xn <<= 16;
}
if (aa >= (1 << 16)) {
aa >>= 16;
xn <<= 8;
}
if (aa >= (1 << 8)) {
aa >>= 8;
xn <<= 4;
}
if (aa >= (1 << 4)) {
aa >>= 4;
xn <<= 2;
}
if (aa >= (1 << 2)) {
xn <<= 1;
}
// We now have x_n such that `x_n = 2**(e-1) ≤ sqrt(a) < 2**e = 2 * x_n`. This implies ε_n ≤ 2**(e-1).
//
// We can refine our estimation by noticing that the middle of that interval minimizes the error.
// If we move x_n to equal 2**(e-1) + 2**(e-2), then we reduce the error to ε_n ≤ 2**(e-2).
// This is going to be our x_0 (and ε_0)
xn = (3 * xn) >> 1; // ε_0 := | x_0 - sqrt(a) | ≤ 2**(e-2)
// From here, Newton's method give us:
// x_{n+1} = (x_n + a / x_n) / 2
//
// One should note that:
// x_{n+1}² - a = ((x_n + a / x_n) / 2)² - a
// = ((x_n² + a) / (2 * x_n))² - a
// = (x_n⁴ + 2 * a * x_n² + a²) / (4 * x_n²) - a
// = (x_n⁴ + 2 * a * x_n² + a² - 4 * a * x_n²) / (4 * x_n²)
// = (x_n⁴ - 2 * a * x_n² + a²) / (4 * x_n²)
// = (x_n² - a)² / (2 * x_n)²
// = ((x_n² - a) / (2 * x_n))²
// ≥ 0
// Which proves that for all n ≥ 1, sqrt(a) ≤ x_n
//
// This gives us the proof of quadratic convergence of the sequence:
// ε_{n+1} = | x_{n+1} - sqrt(a) |
// = | (x_n + a / x_n) / 2 - sqrt(a) |
// = | (x_n² + a - 2*x_n*sqrt(a)) / (2 * x_n) |
// = | (x_n - sqrt(a))² / (2 * x_n) |
// = | ε_n² / (2 * x_n) |
// = ε_n² / | (2 * x_n) |
//
// For the first iteration, we have a special case where x_0 is known:
// ε_1 = ε_0² / | (2 * x_0) |
// ≤ (2**(e-2))² / (2 * (2**(e-1) + 2**(e-2)))
// ≤ 2**(2*e-4) / (3 * 2**(e-1))
// ≤ 2**(e-3) / 3
// ≤ 2**(e-3-log2(3))
// ≤ 2**(e-4.5)
//
// For the following iterations, we use the fact that, 2**(e-1) ≤ sqrt(a) ≤ x_n:
// ε_{n+1} = ε_n² / | (2 * x_n) |
// ≤ (2**(e-k))² / (2 * 2**(e-1))
// ≤ 2**(2*e-2*k) / 2**e
// ≤ 2**(e-2*k)
xn = (xn + a / xn) >> 1; // ε_1 := | x_1 - sqrt(a) | ≤ 2**(e-4.5) -- special case, see above
xn = (xn + a / xn) >> 1; // ε_2 := | x_2 - sqrt(a) | ≤ 2**(e-9) -- general case with k = 4.5
xn = (xn + a / xn) >> 1; // ε_3 := | x_3 - sqrt(a) | ≤ 2**(e-18) -- general case with k = 9
xn = (xn + a / xn) >> 1; // ε_4 := | x_4 - sqrt(a) | ≤ 2**(e-36) -- general case with k = 18
xn = (xn + a / xn) >> 1; // ε_5 := | x_5 - sqrt(a) | ≤ 2**(e-72) -- general case with k = 36
xn = (xn + a / xn) >> 1; // ε_6 := | x_6 - sqrt(a) | ≤ 2**(e-144) -- general case with k = 72
// Because e ≤ 128 (as discussed during the first estimation phase), we know have reached a precision
// ε_6 ≤ 2**(e-144) < 1. Given we're operating on integers, then we can ensure that xn is now either
// sqrt(a) or sqrt(a) + 1.
return xn - SafeCast.toUint(xn > a / xn);
}
}
/**
* @dev Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && result * result < a);
}
}
/**
* @dev Return the log in base 2 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
uint256 exp;
unchecked {
exp = 128 * SafeCast.toUint(value > (1 << 128) - 1);
value >>= exp;
result += exp;
exp = 64 * SafeCast.toUint(value > (1 << 64) - 1);
value >>= exp;
result += exp;
exp = 32 * SafeCast.toUint(value > (1 << 32) - 1);
value >>= exp;
result += exp;
exp = 16 * SafeCast.toUint(value > (1 << 16) - 1);
value >>= exp;
result += exp;
exp = 8 * SafeCast.toUint(value > (1 << 8) - 1);
value >>= exp;
result += exp;
exp = 4 * SafeCast.toUint(value > (1 << 4) - 1);
value >>= exp;
result += exp;
exp = 2 * SafeCast.toUint(value > (1 << 2) - 1);
value >>= exp;
result += exp;
result += SafeCast.toUint(value > 1);
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << result < value);
}
}
/**
* @dev Return the log in base 10 of a positive value rounded towards zero.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 10 ** result < value);
}
}
/**
* @dev Return the log in base 256 of a positive value rounded towards zero.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
uint256 isGt;
unchecked {
isGt = SafeCast.toUint(value > (1 << 128) - 1);
value >>= isGt * 128;
result += isGt * 16;
isGt = SafeCast.toUint(value > (1 << 64) - 1);
value >>= isGt * 64;
result += isGt * 8;
isGt = SafeCast.toUint(value > (1 << 32) - 1);
value >>= isGt * 32;
result += isGt * 4;
isGt = SafeCast.toUint(value > (1 << 16) - 1);
value >>= isGt * 16;
result += isGt * 2;
result += SafeCast.toUint(value > (1 << 8) - 1);
}
return result;
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + SafeCast.toUint(unsignedRoundsUp(rounding) && 1 << (result << 3) < value);
}
}
/**
* @dev Returns whether a provided rounding mode is considered rounding up for unsigned integers.
*/
function unsignedRoundsUp(Rounding rounding) internal pure returns (bool) {
return uint8(rounding) % 2 == 1;
}
}
// File: @openzeppelin/contracts/utils/math/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.2.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;
/**
* @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} 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} 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} 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} 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} 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 guaratees 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} 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} 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} 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 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/utils/Base64.sol
// OpenZeppelin Contracts (last updated v5.1.0) (utils/Base64.sol)
pragma solidity ^0.8.20;
/**
* @dev Provides a set of functions to operate with Base64 strings.
*/
library Base64 {
/**
* @dev Base64 Encoding/Decoding Table
* See sections 4 and 5 of https://datatracker.ietf.org/doc/html/rfc4648
*/
string internal constant _TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
string internal constant _TABLE_URL = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
/**
* @dev Converts a `bytes` to its Bytes64 `string` representation.
*/
function encode(bytes memory data) internal pure returns (string memory) {
return _encode(data, _TABLE, true);
}
/**
* @dev Converts a `bytes` to its Bytes64Url `string` representation.
* Output is not padded with `=` as specified in https://www.rfc-editor.org/rfc/rfc4648[rfc4648].
*/
function encodeURL(bytes memory data) internal pure returns (string memory) {
return _encode(data, _TABLE_URL, false);
}
/**
* @dev Internal table-agnostic conversion
*/
function _encode(bytes memory data, string memory table, bool withPadding) private pure returns (string memory) {
/**
* Inspired by Brecht Devos (Brechtpd) implementation - MIT licence
* https://github.com/Brechtpd/base64/blob/e78d9fd951e7b0977ddca77d92dc85183770daf4/base64.sol
*/
if (data.length == 0) return "";
// If padding is enabled, the final length should be `bytes` data length divided by 3 rounded up and then
// multiplied by 4 so that it leaves room for padding the last chunk
// - `data.length + 2` -> Prepare for division rounding up
// - `/ 3` -> Number of 3-bytes chunks (rounded up)
// - `4 *` -> 4 characters for each chunk
// This is equivalent to: 4 * Math.ceil(data.length / 3)
//
// If padding is disabled, the final length should be `bytes` data length multiplied by 4/3 rounded up as
// opposed to when padding is required to fill the last chunk.
// - `4 * data.length` -> 4 characters for each chunk
// - ` + 2` -> Prepare for division rounding up
// - `/ 3` -> Number of 3-bytes chunks (rounded up)
// This is equivalent to: Math.ceil((4 * data.length) / 3)
uint256 resultLength = withPadding ? 4 * ((data.length + 2) / 3) : (4 * data.length + 2) / 3;
string memory result = new string(resultLength);
assembly ("memory-safe") {
// Prepare the lookup table (skip the first "length" byte)
let tablePtr := add(table, 1)
// Prepare result pointer, jump over length
let resultPtr := add(result, 0x20)
let dataPtr := data
let endPtr := add(data, mload(data))
// In some cases, the last iteration will read bytes after the end of the data. We cache the value, and
// set it to zero to make sure no dirty bytes are read in that section.
let afterPtr := add(endPtr, 0x20)
let afterCache := mload(afterPtr)
mstore(afterPtr, 0x00)
// Run over the input, 3 bytes at a time
for {
} lt(dataPtr, endPtr) {
} {
// Advance 3 bytes
dataPtr := add(dataPtr, 3)
let input := mload(dataPtr)
// To write each character, shift the 3 byte (24 bits) chunk
// 4 times in blocks of 6 bits for each character (18, 12, 6, 0)
// and apply logical AND with 0x3F to bitmask the least significant 6 bits.
// Use this as an index into the lookup table, mload an entire word
// so the desired character is in the least significant byte, and
// mstore8 this least significant byte into the result and continue.
mstore8(resultPtr, mload(add(tablePtr, and(shr(18, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(12, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(shr(6, input), 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
mstore8(resultPtr, mload(add(tablePtr, and(input, 0x3F))))
resultPtr := add(resultPtr, 1) // Advance
}
// Reset the value that was cached
mstore(afterPtr, afterCache)
if withPadding {
// When data `bytes` is not exactly 3 bytes long
// it is padded with `=` characters at the end
switch mod(mload(data), 3)
case 1 {
mstore8(sub(resultPtr, 1), 0x3d)
mstore8(sub(resultPtr, 2), 0x3d)
}
case 2 {
mstore8(sub(resultPtr, 1), 0x3d)
}
}
}
return result;
}
}
// File: @openzeppelin/contracts/interfaces/IERC2981.sol
// OpenZeppelin Contracts (last updated v5.1.0) (interfaces/IERC2981.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface for the NFT Royalty Standard.
*
* A standardized way to retrieve royalty payment information for non-fungible tokens (NFTs) to enable universal
* support for royalty payments across all NFT marketplaces and ecosystem participants.
*/
interface IERC2981 is IERC165 {
/**
* @dev Returns how much royalty is owed and to whom, based on a sale price that may be denominated in any unit of
* exchange. The royalty amount is denominated and should be paid in that same unit of exchange.
*
* NOTE: ERC-2981 allows setting the royalty to 100% of the price. In that case all the price would be sent to the
* royalty receiver and 0 tokens to the seller. Contracts dealing with royalty should consider empty transfers.
*/
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) external view returns (address receiver, uint256 royaltyAmount);
}
// File: @openzeppelin/contracts/token/common/ERC2981.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/common/ERC2981.sol)
pragma solidity ^0.8.20;
/**
* @dev Implementation of the NFT Royalty Standard, a standardized way to retrieve royalty payment information.
*
* Royalty information can be specified globally for all token ids via {_setDefaultRoyalty}, and/or individually for
* specific token ids via {_setTokenRoyalty}. The latter takes precedence over the first.
*
* Royalty is specified as a fraction of sale price. {_feeDenominator} is overridable but defaults to 10000, meaning the
* fee is specified in basis points by default.
*
* IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
* https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the ERC. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*/
abstract contract ERC2981 is IERC2981, ERC165 {
struct RoyaltyInfo {
address receiver;
uint96 royaltyFraction;
}
RoyaltyInfo private _defaultRoyaltyInfo;
mapping(uint256 tokenId => RoyaltyInfo) private _tokenRoyaltyInfo;
/**
* @dev The default royalty set is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidDefaultRoyalty(uint256 numerator, uint256 denominator);
/**
* @dev The default royalty receiver is invalid.
*/
error ERC2981InvalidDefaultRoyaltyReceiver(address receiver);
/**
* @dev The royalty set for an specific `tokenId` is invalid (eg. (numerator / denominator) >= 1).
*/
error ERC2981InvalidTokenRoyalty(uint256 tokenId, uint256 numerator, uint256 denominator);
/**
* @dev The royalty receiver for `tokenId` is invalid.
*/
error ERC2981InvalidTokenRoyaltyReceiver(uint256 tokenId, address receiver);
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC165) returns (bool) {
return interfaceId == type(IERC2981).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @inheritdoc IERC2981
*/
function royaltyInfo(
uint256 tokenId,
uint256 salePrice
) public view virtual returns (address receiver, uint256 amount) {
RoyaltyInfo storage _royaltyInfo = _tokenRoyaltyInfo[tokenId];
address royaltyReceiver = _royaltyInfo.receiver;
uint96 royaltyFraction = _royaltyInfo.royaltyFraction;
if (royaltyReceiver == address(0)) {
royaltyReceiver = _defaultRoyaltyInfo.receiver;
royaltyFraction = _defaultRoyaltyInfo.royaltyFraction;
}
uint256 royaltyAmount = (salePrice * royaltyFraction) / _feeDenominator();
return (royaltyReceiver, royaltyAmount);
}
/**
* @dev The denominator with which to interpret the fee set in {_setTokenRoyalty} and {_setDefaultRoyalty} as a
* fraction of the sale price. Defaults to 10000 so fees are expressed in basis points, but may be customized by an
* override.
*/
function _feeDenominator() internal pure virtual returns (uint96) {
return 10000;
}
/**
* @dev Sets the royalty information that all ids in this contract will default to.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setDefaultRoyalty(address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidDefaultRoyalty(feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidDefaultRoyaltyReceiver(address(0));
}
_defaultRoyaltyInfo = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Removes default royalty information.
*/
function _deleteDefaultRoyalty() internal virtual {
delete _defaultRoyaltyInfo;
}
/**
* @dev Sets the royalty information for a specific token id, overriding the global default.
*
* Requirements:
*
* - `receiver` cannot be the zero address.
* - `feeNumerator` cannot be greater than the fee denominator.
*/
function _setTokenRoyalty(uint256 tokenId, address receiver, uint96 feeNumerator) internal virtual {
uint256 denominator = _feeDenominator();
if (feeNumerator > denominator) {
// Royalty fee will exceed the sale price
revert ERC2981InvalidTokenRoyalty(tokenId, feeNumerator, denominator);
}
if (receiver == address(0)) {
revert ERC2981InvalidTokenRoyaltyReceiver(tokenId, address(0));
}
_tokenRoyaltyInfo[tokenId] = RoyaltyInfo(receiver, feeNumerator);
}
/**
* @dev Resets royalty information for the token id back to the global default.
*/
function _resetTokenRoyalty(uint256 tokenId) internal virtual {
delete _tokenRoyaltyInfo[tokenId];
}
}
// File: @openzeppelin/contracts/token/ERC721/extensions/ERC721Royalty.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC721/extensions/ERC721Royalty.sol)
pragma solidity ^0.8.20;
/**
* @dev Extension of ERC-721 with the ERC-2981 NFT Royalty Standard, a standardized way to retrieve royalty payment
* information.
*
* Royalty information can be specified globally for all token ids via {ERC2981-_setDefaultRoyalty}, and/or individually
* for specific token ids via {ERC2981-_setTokenRoyalty}. The latter takes precedence over the first.
*
* IMPORTANT: ERC-2981 only specifies a way to signal royalty information and does not enforce its payment. See
* https://eips.ethereum.org/EIPS/eip-2981#optional-royalty-payments[Rationale] in the ERC. Marketplaces are expected to
* voluntarily pay royalties together with sales, but note that this standard is not yet widely supported.
*/
abstract contract ERC721Royalty is ERC2981, ERC721 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC721, ERC2981) returns (bool) {
return super.supportsInterface(interfaceId);
}
}
// 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: @openzeppelin/contracts/token/ERC20/IERC20.sol
// OpenZeppelin Contracts (last updated v5.1.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.20;
/**
* @dev Interface of the ERC-20 standard as defined in the ERC.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the value of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the value of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves a `value` amount of tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 value) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets a `value` amount of tokens as the allowance of `spender` over the
* caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 value) external returns (bool);
/**
* @dev Moves a `value` amount of tokens from `from` to `to` using the
* allowance mechanism. `value` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 value) external returns (bool);
}
// File: contracts/OCSpikiesRandom.sol
pragma solidity ^0.8.20;
interface ISpikiesDataSource {
function getLayerSVG(uint8 layerId, uint256 traitId) external view returns (string memory);
function getLayerTrait(uint8 layerId, uint256 traitId) external view returns (string memory);
function getLayerCount(uint8 layerId) external pure returns (uint256);
}
contract OCSpikiesRandom is ERC721, ERC721Royalty, Ownable {
ISpikiesDataSource public dataSource;
uint256 public totalSupply;
uint256 public constant MAX_SUPPLY = 5555; // Max 5,555 NFTs
uint256 public constant MAX_BATCH_SIZE = 505;
struct Traits {
uint256 eyes;
uint256 heads;
uint256 mouths;
}
mapping(uint256 => Traits) public tokenTraits;
mapping(bytes32 => bool) public usedCombinations;
mapping(address => uint256) public nonces;
constructor(address _dataSource, address royaltyReceiver)
ERC721("OCSpikies", "OCS")
Ownable(msg.sender)
{
dataSource = ISpikiesDataSource(_dataSource);
_setDefaultRoyalty(royaltyReceiver, 690);
}
function mintRandom(address to) external onlyOwner returns (uint256) {
require(totalSupply < MAX_SUPPLY, "Max supply reached");
nonces[msg.sender]++;
uint256 attempt = 0;
bool found = false;
uint256 eyesTraitId;
uint256 headsTraitId;
uint256 mouthsTraitId;
while (!found && attempt < 10) {
uint256 seed = uint256(keccak256(abi.encodePacked(blockhash(block.number - 1), msg.sender, nonces[msg.sender], attempt)));
uint256 eyesSeed = uint256(keccak256(abi.encodePacked(seed, "eyes")));
uint256 headsSeed = uint256(keccak256(abi.encodePacked(seed, "heads")));
uint256 mouthsSeed = uint256(keccak256(abi.encodePacked(seed, "mouths")));
eyesTraitId = eyesSeed % 143;
headsTraitId = headsSeed % 86;
mouthsTraitId = mouthsSeed % 13;
bytes32 comboHash = keccak256(abi.encodePacked(eyesTraitId, headsTraitId, mouthsTraitId));
if (!usedCombinations[comboHash]) {
usedCombinations[comboHash] = true;
found = true;
} else {
attempt++;
}
}
require(found, "No unique combination found after 10 attempts");
totalSupply++;
uint256 tokenId = totalSupply;
tokenTraits[tokenId] = Traits(eyesTraitId, headsTraitId, mouthsTraitId);
_mint(to, tokenId);
return tokenId;
}
//Batch minting subroutine
function mintRandomBatch(address to, uint256 quantity) external onlyOwner returns (uint256[] memory) {
require(quantity > 0 && quantity <= MAX_BATCH_SIZE, "Quantity must be between 1 and 505");
require(totalSupply + quantity <= MAX_SUPPLY, "Batch mint would exceed max supply");
uint256[] memory tokenIds = new uint256[](quantity);
for (uint256 i = 0; i < quantity; i++) {
nonces[msg.sender]++;
uint256 attempt = 0;
bool found = false;
uint256 eyesTraitId;
uint256 headsTraitId;
uint256 mouthsTraitId;
while (!found && attempt < 10) {
uint256 seed = uint256(keccak256(abi.encodePacked(blockhash(block.number - 1), msg.sender, nonces[msg.sender], attempt)));
uint256 eyesSeed = uint256(keccak256(abi.encodePacked(seed, "eyes")));
uint256 headsSeed = uint256(keccak256(abi.encodePacked(seed, "heads")));
uint256 mouthsSeed = uint256(keccak256(abi.encodePacked(seed, "mouths")));
eyesTraitId = eyesSeed % 143;
headsTraitId = headsSeed % 86;
mouthsTraitId = mouthsSeed % 13;
bytes32 comboHash = keccak256(abi.encodePacked(eyesTraitId, headsTraitId, mouthsTraitId));
if (!usedCombinations[comboHash]) {
usedCombinations[comboHash] = true;
found = true;
} else {
attempt++;
}
}
require(found, "No unique combination found after 10 attempts");
totalSupply++;
uint256 tokenId = totalSupply;
tokenTraits[tokenId] = Traits(eyesTraitId, headsTraitId, mouthsTraitId);
_mint(to, tokenId);
tokenIds[i] = tokenId;
}
return tokenIds;
}
function tokenURI(uint256 tokenId) public view override returns (string memory) {
ownerOf(tokenId); // Reverts if token doesn't exist
Traits memory traits = tokenTraits[tokenId];
uint256 bgTraitId = 0;
uint256 eyesTraitId = traits.eyes;
uint256 headsTraitId = traits.heads;
uint256 mouthsTraitId = traits.mouths;
string memory svg = _buildSVG(bgTraitId, eyesTraitId, headsTraitId, mouthsTraitId);
string memory traitsJson = _buildTraits(bgTraitId, eyesTraitId, headsTraitId, mouthsTraitId);
string memory json = string(abi.encodePacked(
'{"name":"Spiky #', toString(tokenId), '",',
'"description":"An on-chain implementation of Spikies NFT on ApeChain",',
'"image":"data:image/svg+xml;base64,', Base64.encode(bytes(svg)), '",',
'"attributes":[', traitsJson, ']}'
));
return string(abi.encodePacked("data:application/json;base64,", Base64.encode(bytes(json))));
}
function _buildSVG(
uint256 bgTraitId,
uint256 eyesTraitId,
uint256 headsTraitId,
uint256 mouthsTraitId
) internal view returns (string memory) {
string memory bgSVG = dataSource.getLayerSVG(0, bgTraitId);
string memory mouthsSVG = dataSource.getLayerSVG(5, mouthsTraitId);
string memory eyesSVG = dataSource.getLayerSVG(3, eyesTraitId);
string memory headsSVG = dataSource.getLayerSVG(4, headsTraitId);
return string(abi.encodePacked(
'<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512">',
bgSVG,
mouthsSVG,
eyesSVG,
headsSVG,
'</svg>'
));
}
function _buildTraits(
uint256 bgTraitId,
uint256 eyesTraitId,
uint256 headsTraitId,
uint256 mouthsTraitId
) internal view returns (string memory) {
string memory traits = dataSource.getLayerTrait(0, bgTraitId);
traits = string(abi.encodePacked(traits, ",", dataSource.getLayerTrait(3, eyesTraitId)));
traits = string(abi.encodePacked(traits, ",", dataSource.getLayerTrait(4, headsTraitId)));
traits = string(abi.encodePacked(traits, ",", dataSource.getLayerTrait(5, mouthsTraitId)));
return traits;
}
function toString(uint256 value) internal pure returns (string memory) {
if (value == 0) return "0";
uint256 temp = value;
uint256 digits;
while (temp != 0) {
digits++;
temp /= 10;
}
bytes memory buffer = new bytes(digits);
while (value != 0) {
digits--;
buffer[digits] = bytes1(uint8(48 + (value % 10)));
value /= 10;
}
return string(buffer);
}
// Function to withdraw ERC20 tokens
function withdrawERC20(address tokenAddress) external onlyOwner {
IERC20 token = IERC20(tokenAddress);
uint256 balance = token.balanceOf(address(this));
require(balance > 0, "No tokens to withdraw");
token.transfer(owner(), balance);
}
// Function to withdraw balance
function withdrawETH() external onlyOwner {
uint256 balance = address(this).balance;
require(balance > 0, "No ETH to withdraw");
payable(owner()).transfer(balance);
}
// Override required by ERC721Royalty and ERC721 to support multiple inheritance
function supportsInterface(bytes4 interfaceId)
public
view
virtual
override(ERC721, ERC721Royalty)
returns (bool)
{
return super.supportsInterface(interfaceId);
}
}Contract ABI
API[{"inputs":[{"internalType":"address","name":"_dataSource","type":"address"},{"internalType":"address","name":"royaltyReceiver","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidDefaultRoyalty","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidDefaultRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"numerator","type":"uint256"},{"internalType":"uint256","name":"denominator","type":"uint256"}],"name":"ERC2981InvalidTokenRoyalty","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC2981InvalidTokenRoyaltyReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"address","name":"owner","type":"address"}],"name":"ERC721IncorrectOwner","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721InsufficientApproval","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC721InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"ERC721InvalidOperator","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"ERC721InvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC721InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC721InvalidSender","type":"error"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC721NonexistentToken","type":"error"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"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":[],"name":"MAX_BATCH_SIZE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MAX_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"approve","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"dataSource","outputs":[{"internalType":"contract ISpikiesDataSource","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":"mintRandom","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"quantity","type":"uint256"}],"name":"mintRandomBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ownerOf","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"uint256","name":"salePrice","type":"uint256"}],"name":"royaltyInfo","outputs":[{"internalType":"address","name":"receiver","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"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":"","type":"uint256"}],"name":"tokenTraits","outputs":[{"internalType":"uint256","name":"eyes","type":"uint256"},{"internalType":"uint256","name":"heads","type":"uint256"},{"internalType":"uint256","name":"mouths","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"transferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bytes32","name":"","type":"bytes32"}],"name":"usedCombinations","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"tokenAddress","type":"address"}],"name":"withdrawERC20","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"withdrawETH","outputs":[],"stateMutability":"nonpayable","type":"function"}]Contract Creation Code
608060405234801562000010575f80fd5b5060405162004e6938038062004e69833981810160405281019062000036919062000483565b336040518060400160405280600981526020017f4f435370696b69657300000000000000000000000000000000000000000000008152506040518060400160405280600381526020017f4f435300000000000000000000000000000000000000000000000000000000008152508160029081620000b491906200072c565b508060039081620000c691906200072c565b5050505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16036200013c575f6040517f1e4fbdf700000000000000000000000000000000000000000000000000000000815260040162000133919062000821565b60405180910390fd5b6200014d81620001aa60201b60201c565b508160095f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550620001a2816102b26200026d60201b60201c565b5050620008c7565b5f60085f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160085f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f6200027e6200041560201b60201c565b6bffffffffffffffffffffffff16905080826bffffffffffffffffffffffff161115620002e65781816040517f6f483d09000000000000000000000000000000000000000000000000000000008152600401620002dd9291906200089c565b60405180910390fd5b5f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160362000359575f6040517fb6d9900a00000000000000000000000000000000000000000000000000000000815260040162000350919062000821565b60405180910390fd5b60405180604001604052808473ffffffffffffffffffffffffffffffffffffffff168152602001836bffffffffffffffffffffffff168152505f80820151815f015f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506020820151815f0160146101000a8154816bffffffffffffffffffffffff02191690836bffffffffffffffffffffffff160217905550905050505050565b5f612710905090565b5f80fd5b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f6200044d8262000422565b9050919050565b6200045f8162000441565b81146200046a575f80fd5b50565b5f815190506200047d8162000454565b92915050565b5f80604083850312156200049c576200049b6200041e565b5b5f620004ab858286016200046d565b9250506020620004be858286016200046d565b9150509250929050565b5f81519050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806200054457607f821691505b6020821081036200055a5762000559620004ff565b5b50919050565b5f819050815f5260205f209050919050565b5f6020601f8301049050919050565b5f82821b905092915050565b5f60088302620005be7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8262000581565b620005ca868362000581565b95508019841693508086168417925050509392505050565b5f819050919050565b5f819050919050565b5f620006146200060e6200060884620005e2565b620005eb565b620005e2565b9050919050565b5f819050919050565b6200062f83620005f4565b620006476200063e826200061b565b8484546200058d565b825550505050565b5f90565b6200065d6200064f565b6200066a81848462000624565b505050565b5b818110156200069157620006855f8262000653565b60018101905062000670565b5050565b601f821115620006e057620006aa8162000560565b620006b58462000572565b81016020851015620006c5578190505b620006dd620006d48562000572565b8301826200066f565b50505b505050565b5f82821c905092915050565b5f620007025f1984600802620006e5565b1980831691505092915050565b5f6200071c8383620006f1565b9150826002028217905092915050565b6200073782620004c8565b67ffffffffffffffff811115620007535762000752620004d2565b5b6200075f82546200052c565b6200076c82828562000695565b5f60209050601f831160018114620007a2575f84156200078d578287015190505b6200079985826200070f565b86555062000808565b601f198416620007b28662000560565b5f5b82811015620007db57848901518255600182019150602085019450602081019050620007b4565b86831015620007fb5784890151620007f7601f891682620006f1565b8355505b6001600288020188555050505b505050505050565b6200081b8162000441565b82525050565b5f602082019050620008365f83018462000810565b92915050565b5f6bffffffffffffffffffffffff82169050919050565b5f620008736200086d62000867846200083c565b620005eb565b620005e2565b9050919050565b620008858162000853565b82525050565b6200089681620005e2565b82525050565b5f604082019050620008b15f8301856200087a565b620008c060208301846200088b565b9392505050565b61459480620008d55f395ff3fe608060405234801561000f575f80fd5b50600436106101c2575f3560e01c80637ecebe00116100f7578063d023f37e11610095578063e086e5ec1161006f578063e086e5ec14610541578063e985e9c51461054b578063f2fde38b1461057b578063f4f3b20014610597576101c2565b8063d023f37e146104af578063d1cea4ec146104df578063e05c57bf1461050f576101c2565b8063a22cb465116100d1578063a22cb46514610429578063b88d4fde14610445578063c87b56dd14610461578063cfdbf25414610491576101c2565b80637ecebe00146103bd5780638da5cb5b146103ed57806395d89b411461040b576101c2565b80632a55205a1161016457806349bc4aed1161013e57806349bc4aed146103235780636352211e1461035357806370a0823114610383578063715018a6146103b3576101c2565b80632a55205a146102b857806332cb6b0c146102e957806342842e0e14610307576101c2565b8063095ea7b3116101a0578063095ea7b31461024457806318160ddd146102605780631b076edc1461027e57806323b872dd1461029c576101c2565b806301ffc9a7146101c657806306fdde03146101f6578063081812fc14610214575b5f80fd5b6101e060048036038101906101db9190612d30565b6105b3565b6040516101ed9190612d75565b60405180910390f35b6101fe6105c4565b60405161020b9190612e18565b60405180910390f35b61022e60048036038101906102299190612e6b565b610654565b60405161023b9190612ed5565b60405180910390f35b61025e60048036038101906102599190612f18565b61066f565b005b610268610685565b6040516102759190612f65565b60405180910390f35b61028661068b565b6040516102939190612fd9565b60405180910390f35b6102b660048036038101906102b19190612ff2565b6106b0565b005b6102d260048036038101906102cd9190613042565b6107af565b6040516102e0929190613080565b60405180910390f35b6102f16108cf565b6040516102fe9190612f65565b60405180910390f35b610321600480360381019061031c9190612ff2565b6108d5565b005b61033d600480360381019061033891906130da565b6108f4565b60405161034a9190612d75565b60405180910390f35b61036d60048036038101906103689190612e6b565b610911565b60405161037a9190612ed5565b60405180910390f35b61039d60048036038101906103989190613105565b610922565b6040516103aa9190612f65565b60405180910390f35b6103bb6109d8565b005b6103d760048036038101906103d29190613105565b6109eb565b6040516103e49190612f65565b60405180910390f35b6103f5610a00565b6040516104029190612ed5565b60405180910390f35b610413610a28565b6040516104209190612e18565b60405180910390f35b610443600480360381019061043e919061315a565b610ab8565b005b61045f600480360381019061045a91906132c4565b610ace565b005b61047b60048036038101906104769190612e6b565b610af3565b6040516104889190612e18565b60405180910390f35b610499610bdf565b6040516104a69190612f65565b60405180910390f35b6104c960048036038101906104c49190612f18565b610be5565b6040516104d691906133fb565b60405180910390f35b6104f960048036038101906104f49190613105565b611010565b6040516105069190612f65565b60405180910390f35b61052960048036038101906105249190612e6b565b611352565b6040516105389392919061341b565b60405180910390f35b610549611378565b005b61056560048036038101906105609190613450565b611414565b6040516105729190612d75565b60405180910390f35b61059560048036038101906105909190613105565b6114a2565b005b6105b160048036038101906105ac9190613105565b611526565b005b5f6105bd82611677565b9050919050565b6060600280546105d3906134bb565b80601f01602080910402602001604051908101604052809291908181526020018280546105ff906134bb565b801561064a5780601f106106215761010080835404028352916020019161064a565b820191905f5260205f20905b81548152906001019060200180831161062d57829003601f168201915b5050505050905090565b5f61065e82611688565b506106688261170e565b9050919050565b610681828261067c611747565b61174e565b5050565b600a5481565b60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610720575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016107179190612ed5565b60405180910390fd5b5f610733838361072e611747565b611760565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146107a9578382826040517f64283d7b0000000000000000000000000000000000000000000000000000000081526004016107a0939291906134eb565b60405180910390fd5b50505050565b5f805f60015f8681526020019081526020015f2090505f815f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690505f825f0160149054906101000a90046bffffffffffffffffffffffff1690505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610881575f80015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1691505f800160149054906101000a90046bffffffffffffffffffffffff1690505b5f61088a61196b565b6bffffffffffffffffffffffff16826bffffffffffffffffffffffff16886108b2919061354d565b6108bc91906135bb565b9050828195509550505050509250929050565b6115b381565b6108ef83838360405180602001604052805f815250610ace565b505050565b600c602052805f5260405f205f915054906101000a900460ff1681565b5f61091b82611688565b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610993575f6040517f89c62b6400000000000000000000000000000000000000000000000000000000815260040161098a9190612ed5565b60405180910390fd5b60055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b6109e0611974565b6109e95f6119fb565b565b600d602052805f5260405f205f915090505481565b5f60085f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060038054610a37906134bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610a63906134bb565b8015610aae5780601f10610a8557610100808354040283529160200191610aae565b820191905f5260205f20905b815481529060010190602001808311610a9157829003601f168201915b5050505050905090565b610aca610ac3611747565b8383611abe565b5050565b610ad98484846106b0565b610aed610ae4611747565b85858585611c27565b50505050565b6060610afe82610911565b505f600b5f8481526020019081526020015f206040518060600160405290815f82015481526020016001820154815260200160028201548152505090505f80825f015190505f836020015190505f846040015190505f610b6085858585611dd3565b90505f610b6f86868686612090565b90505f610b7b8a612385565b610b84846124dd565b83604051602001610b9793929190613853565b6040516020818303038152906040529050610bb1816124dd565b604051602001610bc1919061391a565b60405160208183030381529060405298505050505050505050919050565b6101f981565b6060610bef611974565b5f82118015610c0057506101f98211155b610c3f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c36906139ab565b60405180910390fd5b6115b382600a54610c5091906139c9565b1115610c91576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c8890613a6c565b60405180910390fd5b5f8267ffffffffffffffff811115610cac57610cab6131a0565b5b604051908082528060200260200182016040528015610cda5781602001602082028036833780820191505090505b5090505f5b8381101561100557600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f815480929190610d3490613a8a565b91905055505f805f805f5b83158015610d4d5750600a85105b15610f1a575f600143610d609190613ad1565b4033600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205488604051602001610db49493929190613b89565b604051602081830303815290604052805190602001205f1c90505f81604051602001610de09190613c20565b604051602081830303815290604052805190602001205f1c90505f82604051602001610e0c9190613c8f565b604051602081830303815290604052805190602001205f1c90505f83604051602001610e389190613cfe565b604051602081830303815290604052805190602001205f1c9050608f83610e5f9190613d23565b9650605682610e6e9190613d23565b9550600d81610e7d9190613d23565b94505f878787604051602001610e9593929190613d53565b604051602081830303815290604052805190602001209050600c5f8281526020019081526020015f205f9054906101000a900460ff16610f01576001600c5f8381526020019081526020015f205f6101000a81548160ff02191690831515021790555060019850610f10565b8980610f0c90613a8a565b9a50505b5050505050610d3f565b83610f5a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f5190613dff565b60405180910390fd5b600a5f815480929190610f6c90613a8a565b91905055505f600a549050604051806060016040528085815260200184815260200183815250600b5f8381526020019081526020015f205f820151815f01556020820151816001015560408201518160020155905050610fcc8b8261250a565b80888881518110610fe057610fdf613e1d565b5b6020026020010181815250505050505050508080610ffd90613a8a565b915050610cdf565b508091505092915050565b5f611019611974565b6115b3600a541061105f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161105690613e94565b60405180910390fd5b600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8154809291906110ac90613a8a565b91905055505f805f805f5b831580156110c55750600a85105b15611292575f6001436110d89190613ad1565b4033600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20548860405160200161112c9493929190613b89565b604051602081830303815290604052805190602001205f1c90505f816040516020016111589190613c20565b604051602081830303815290604052805190602001205f1c90505f826040516020016111849190613c8f565b604051602081830303815290604052805190602001205f1c90505f836040516020016111b09190613cfe565b604051602081830303815290604052805190602001205f1c9050608f836111d79190613d23565b96506056826111e69190613d23565b9550600d816111f59190613d23565b94505f87878760405160200161120d93929190613d53565b604051602081830303815290604052805190602001209050600c5f8281526020019081526020015f205f9054906101000a900460ff16611279576001600c5f8381526020019081526020015f205f6101000a81548160ff02191690831515021790555060019850611288565b898061128490613a8a565b9a50505b50505050506110b7565b836112d2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112c990613dff565b60405180910390fd5b600a5f8154809291906112e490613a8a565b91905055505f600a549050604051806060016040528085815260200184815260200183815250600b5f8381526020019081526020015f205f820151815f01556020820151816001015560408201518160020155905050611344888261250a565b809650505050505050919050565b600b602052805f5260405f205f91509050805f0154908060010154908060020154905083565b611380611974565b5f4790505f81116113c6576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113bd90613efc565b60405180910390fd5b6113ce610a00565b73ffffffffffffffffffffffffffffffffffffffff166108fc8290811502906040515f60405180830381858888f19350505050158015611410573d5f803e3d5ffd5b5050565b5f60075f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b6114aa611974565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361151a575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016115119190612ed5565b60405180910390fd5b611523816119fb565b50565b61152e611974565b5f8190505f8173ffffffffffffffffffffffffffffffffffffffff166370a08231306040518263ffffffff1660e01b815260040161156c9190612ed5565b602060405180830381865afa158015611587573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115ab9190613f2e565b90505f81116115ef576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016115e690613fa3565b60405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff1663a9059cbb611613610a00565b836040518363ffffffff1660e01b8152600401611631929190613080565b6020604051808303815f875af115801561164d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116719190613fd5565b50505050565b5f611681826125fd565b9050919050565b5f80611693836126de565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361170557826040517f7e2732890000000000000000000000000000000000000000000000000000000081526004016116fc9190612f65565b60405180910390fd5b80915050919050565b5f60065f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b61175b8383836001612717565b505050565b5f8061176b846126de565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16146117ac576117ab8184866128d6565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611837576117eb5f855f80612717565b600160055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16146118b657600160055f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460045f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f612710905090565b61197c611747565b73ffffffffffffffffffffffffffffffffffffffff1661199a610a00565b73ffffffffffffffffffffffffffffffffffffffff16146119f9576119bd611747565b6040517f118cdaa70000000000000000000000000000000000000000000000000000000081526004016119f09190612ed5565b60405180910390fd5b565b5f60085f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160085f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611b2e57816040517f5b08ba18000000000000000000000000000000000000000000000000000000008152600401611b259190612ed5565b60405180910390fd5b8060075f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3183604051611c1a9190612d75565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611dcc578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b8152600401611c859493929190614052565b6020604051808303815f875af1925050508015611cc057506040513d601f19601f82011682018060405250810190611cbd91906140b0565b60015b611d41573d805f8114611cee576040519150601f19603f3d011682016040523d82523d5f602084013e611cf3565b606091505b505f815103611d3957836040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611d309190612ed5565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614611dca57836040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611dc19190612ed5565b60405180910390fd5b505b5050505050565b60605f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384855f886040518363ffffffff1660e01b8152600401611e32929190614120565b5f60405180830381865afa158015611e4c573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611e7491906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856005866040518363ffffffff1660e01b8152600401611ed4929190614265565b5f60405180830381865afa158015611eee573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611f1691906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856003896040518363ffffffff1660e01b8152600401611f769291906142c5565b5f60405180830381865afa158015611f90573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611fb891906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856004896040518363ffffffff1660e01b8152600401612018929190614325565b5f60405180830381865afa158015612032573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061205a91906141e5565b905083838383604051602001612073949392919061442c565b604051602081830303815290604052945050505050949350505050565b60605f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b85f886040518363ffffffff1660e01b81526004016120ef929190614120565b5f60405180830381865afa158015612109573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061213191906141e5565b90508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86003886040518363ffffffff1660e01b81526004016121919291906142c5565b5f60405180830381865afa1580156121ab573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f820116820180604052508101906121d391906141e5565b6040516020016121e49291906144c9565b60405160208183030381529060405290508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86004876040518363ffffffff1660e01b8152600401612253929190614325565b5f60405180830381865afa15801561226d573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061229591906141e5565b6040516020016122a69291906144c9565b60405160208183030381529060405290508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86005866040518363ffffffff1660e01b8152600401612315929190614265565b5f60405180830381865afa15801561232f573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061235791906141e5565b6040516020016123689291906144c9565b604051602081830303815290604052905080915050949350505050565b60605f82036123cb576040518060400160405280600181526020017f300000000000000000000000000000000000000000000000000000000000000081525090506124d8565b5f8290505f5b5f82146123fa5780806123e390613a8a565b915050600a826123f391906135bb565b91506123d1565b5f8167ffffffffffffffff811115612415576124146131a0565b5b6040519080825280601f01601f1916602001820160405280156124475781602001600182028036833780820191505090505b5090505b5f85146124d157818061245d906144f7565b925050600a8561246d9190613d23565b603061247991906139c9565b60f81b81838151811061248f5761248e613e1d565b5b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff191690815f1a905350600a856124ca91906135bb565b945061244b565b8093505050505b919050565b60606125038260405180606001604052806040815260200161451f604091396001612999565b9050919050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff160361257a575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016125719190612ed5565b60405180910390fd5b5f61258683835f611760565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146125f8575f6040517f73c6ac6e0000000000000000000000000000000000000000000000000000000081526004016125ef9190612ed5565b60405180910390fd5b505050565b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806126c757507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806126d757506126d682612b28565b5b9050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061274f57505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15612881575f61275e84611688565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141580156127c857508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156127db57506127d98184611414565b155b1561281d57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016128149190612ed5565b60405180910390fd5b811561287f57838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360065f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b6128e1838383612ba1565b612994575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160361295557806040517f7e27328900000000000000000000000000000000000000000000000000000000815260040161294c9190612f65565b60405180910390fd5b81816040517f177e802f00000000000000000000000000000000000000000000000000000000815260040161298b929190613080565b60405180910390fd5b505050565b60605f8451036129b95760405180602001604052805f8152509050612b21565b5f826129ea5760036002865160046129d1919061354d565b6129db91906139c9565b6129e591906135bb565b612a11565b6003600286516129fa91906139c9565b612a0491906135bb565b6004612a10919061354d565b5b90505f8167ffffffffffffffff811115612a2e57612a2d6131a0565b5b6040519080825280601f01601f191660200182016040528015612a605781602001600182028036833780820191505090505b509050600185016020820187885189016020810180515f82525b82841015612ad5576003840193508351603f8160121c168701518653600186019550603f81600c1c168701518653600186019550603f8160061c168701518653600186019550603f8116870151865360018601955050612a7a565b8082528915612b155760038c510660018114612af85760028114612b0b57612b13565b603d6001870353603d6002870353612b13565b603d60018703535b505b50505050505080925050505b9392505050565b5f7f2a55205a000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161480612b9a5750612b9982612c61565b5b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015612c5857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480612c195750612c188484611414565b5b80612c5757508273ffffffffffffffffffffffffffffffffffffffff16612c3f8361170e565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612d0f81612cdb565b8114612d19575f80fd5b50565b5f81359050612d2a81612d06565b92915050565b5f60208284031215612d4557612d44612cd3565b5b5f612d5284828501612d1c565b91505092915050565b5f8115159050919050565b612d6f81612d5b565b82525050565b5f602082019050612d885f830184612d66565b92915050565b5f81519050919050565b5f82825260208201905092915050565b5f5b83811015612dc5578082015181840152602081019050612daa565b5f8484015250505050565b5f601f19601f8301169050919050565b5f612dea82612d8e565b612df48185612d98565b9350612e04818560208601612da8565b612e0d81612dd0565b840191505092915050565b5f6020820190508181035f830152612e308184612de0565b905092915050565b5f819050919050565b612e4a81612e38565b8114612e54575f80fd5b50565b5f81359050612e6581612e41565b92915050565b5f60208284031215612e8057612e7f612cd3565b5b5f612e8d84828501612e57565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f612ebf82612e96565b9050919050565b612ecf81612eb5565b82525050565b5f602082019050612ee85f830184612ec6565b92915050565b612ef781612eb5565b8114612f01575f80fd5b50565b5f81359050612f1281612eee565b92915050565b5f8060408385031215612f2e57612f2d612cd3565b5b5f612f3b85828601612f04565b9250506020612f4c85828601612e57565b9150509250929050565b612f5f81612e38565b82525050565b5f602082019050612f785f830184612f56565b92915050565b5f819050919050565b5f612fa1612f9c612f9784612e96565b612f7e565b612e96565b9050919050565b5f612fb282612f87565b9050919050565b5f612fc382612fa8565b9050919050565b612fd381612fb9565b82525050565b5f602082019050612fec5f830184612fca565b92915050565b5f805f6060848603121561300957613008612cd3565b5b5f61301686828701612f04565b935050602061302786828701612f04565b925050604061303886828701612e57565b9150509250925092565b5f806040838503121561305857613057612cd3565b5b5f61306585828601612e57565b925050602061307685828601612e57565b9150509250929050565b5f6040820190506130935f830185612ec6565b6130a06020830184612f56565b9392505050565b5f819050919050565b6130b9816130a7565b81146130c3575f80fd5b50565b5f813590506130d4816130b0565b92915050565b5f602082840312156130ef576130ee612cd3565b5b5f6130fc848285016130c6565b91505092915050565b5f6020828403121561311a57613119612cd3565b5b5f61312784828501612f04565b91505092915050565b61313981612d5b565b8114613143575f80fd5b50565b5f8135905061315481613130565b92915050565b5f80604083850312156131705761316f612cd3565b5b5f61317d85828601612f04565b925050602061318e85828601613146565b9150509250929050565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b6131d682612dd0565b810181811067ffffffffffffffff821117156131f5576131f46131a0565b5b80604052505050565b5f613207612cca565b905061321382826131cd565b919050565b5f67ffffffffffffffff821115613232576132316131a0565b5b61323b82612dd0565b9050602081019050919050565b828183375f83830152505050565b5f61326861326384613218565b6131fe565b9050828152602081018484840111156132845761328361319c565b5b61328f848285613248565b509392505050565b5f82601f8301126132ab576132aa613198565b5b81356132bb848260208601613256565b91505092915050565b5f805f80608085870312156132dc576132db612cd3565b5b5f6132e987828801612f04565b94505060206132fa87828801612f04565b935050604061330b87828801612e57565b925050606085013567ffffffffffffffff81111561332c5761332b612cd7565b5b61333887828801613297565b91505092959194509250565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b61337681612e38565b82525050565b5f613387838361336d565b60208301905092915050565b5f602082019050919050565b5f6133a982613344565b6133b3818561334e565b93506133be8361335e565b805f5b838110156133ee5781516133d5888261337c565b97506133e083613393565b9250506001810190506133c1565b5085935050505092915050565b5f6020820190508181035f830152613413818461339f565b905092915050565b5f60608201905061342e5f830186612f56565b61343b6020830185612f56565b6134486040830184612f56565b949350505050565b5f806040838503121561346657613465612cd3565b5b5f61347385828601612f04565b925050602061348485828601612f04565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806134d257607f821691505b6020821081036134e5576134e461348e565b5b50919050565b5f6060820190506134fe5f830186612ec6565b61350b6020830185612f56565b6135186040830184612ec6565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61355782612e38565b915061356283612e38565b925082820261357081612e38565b9150828204841483151761358757613586613520565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f6135c582612e38565b91506135d083612e38565b9250826135e0576135df61358e565b5b828204905092915050565b5f81905092915050565b7f7b226e616d65223a225370696b792023000000000000000000000000000000005f82015250565b5f6136296010836135eb565b9150613634826135f5565b601082019050919050565b5f61364982612d8e565b61365381856135eb565b9350613663818560208601612da8565b80840191505092915050565b7f222c0000000000000000000000000000000000000000000000000000000000005f82015250565b5f6136a36002836135eb565b91506136ae8261366f565b600282019050919050565b7f226465736372697074696f6e223a22416e206f6e2d636861696e20696d706c655f8201527f6d656e746174696f6e206f66205370696b696573204e4654206f6e204170654360208201527f6861696e222c0000000000000000000000000000000000000000000000000000604082015250565b5f6137396046836135eb565b9150613744826136b9565b604682019050919050565b7f22696d616765223a22646174613a696d6167652f7376672b786d6c3b626173655f8201527f36342c0000000000000000000000000000000000000000000000000000000000602082015250565b5f6137a96023836135eb565b91506137b48261374f565b602382019050919050565b7f2261747472696275746573223a5b0000000000000000000000000000000000005f82015250565b5f6137f3600e836135eb565b91506137fe826137bf565b600e82019050919050565b7f5d7d0000000000000000000000000000000000000000000000000000000000005f82015250565b5f61383d6002836135eb565b915061384882613809565b600282019050919050565b5f61385d8261361d565b9150613869828661363f565b915061387482613697565b915061387f8261372d565b915061388a8261379d565b9150613896828561363f565b91506138a182613697565b91506138ac826137e7565b91506138b8828461363f565b91506138c382613831565b9150819050949350505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000005f82015250565b5f613904601d836135eb565b915061390f826138d0565b601d82019050919050565b5f613924826138f8565b9150613930828461363f565b915081905092915050565b7f5175616e74697479206d757374206265206265747765656e203120616e6420355f8201527f3035000000000000000000000000000000000000000000000000000000000000602082015250565b5f613995602283612d98565b91506139a08261393b565b604082019050919050565b5f6020820190508181035f8301526139c281613989565b9050919050565b5f6139d382612e38565b91506139de83612e38565b92508282019050808211156139f6576139f5613520565b5b92915050565b7f4261746368206d696e7420776f756c6420657863656564206d617820737570705f8201527f6c79000000000000000000000000000000000000000000000000000000000000602082015250565b5f613a56602283612d98565b9150613a61826139fc565b604082019050919050565b5f6020820190508181035f830152613a8381613a4a565b9050919050565b5f613a9482612e38565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8203613ac657613ac5613520565b5b600182019050919050565b5f613adb82612e38565b9150613ae683612e38565b9250828203905081811115613afe57613afd613520565b5b92915050565b5f819050919050565b613b1e613b19826130a7565b613b04565b82525050565b5f8160601b9050919050565b5f613b3a82613b24565b9050919050565b5f613b4b82613b30565b9050919050565b613b63613b5e82612eb5565b613b41565b82525050565b5f819050919050565b613b83613b7e82612e38565b613b69565b82525050565b5f613b948287613b0d565b602082019150613ba48286613b52565b601482019150613bb48285613b72565b602082019150613bc48284613b72565b60208201915081905095945050505050565b7f65796573000000000000000000000000000000000000000000000000000000005f82015250565b5f613c0a6004836135eb565b9150613c1582613bd6565b600482019050919050565b5f613c2b8284613b72565b602082019150613c3a82613bfe565b915081905092915050565b7f68656164730000000000000000000000000000000000000000000000000000005f82015250565b5f613c796005836135eb565b9150613c8482613c45565b600582019050919050565b5f613c9a8284613b72565b602082019150613ca982613c6d565b915081905092915050565b7f6d6f7574687300000000000000000000000000000000000000000000000000005f82015250565b5f613ce86006836135eb565b9150613cf382613cb4565b600682019050919050565b5f613d098284613b72565b602082019150613d1882613cdc565b915081905092915050565b5f613d2d82612e38565b9150613d3883612e38565b925082613d4857613d4761358e565b5b828206905092915050565b5f613d5e8286613b72565b602082019150613d6e8285613b72565b602082019150613d7e8284613b72565b602082019150819050949350505050565b7f4e6f20756e6971756520636f6d62696e6174696f6e20666f756e6420616674655f8201527f7220313020617474656d70747300000000000000000000000000000000000000602082015250565b5f613de9602d83612d98565b9150613df482613d8f565b604082019050919050565b5f6020820190508181035f830152613e1681613ddd565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b7f4d617820737570706c79207265616368656400000000000000000000000000005f82015250565b5f613e7e601283612d98565b9150613e8982613e4a565b602082019050919050565b5f6020820190508181035f830152613eab81613e72565b9050919050565b7f4e6f2045544820746f20776974686472617700000000000000000000000000005f82015250565b5f613ee6601283612d98565b9150613ef182613eb2565b602082019050919050565b5f6020820190508181035f830152613f1381613eda565b9050919050565b5f81519050613f2881612e41565b92915050565b5f60208284031215613f4357613f42612cd3565b5b5f613f5084828501613f1a565b91505092915050565b7f4e6f20746f6b656e7320746f20776974686472617700000000000000000000005f82015250565b5f613f8d601583612d98565b9150613f9882613f59565b602082019050919050565b5f6020820190508181035f830152613fba81613f81565b9050919050565b5f81519050613fcf81613130565b92915050565b5f60208284031215613fea57613fe9612cd3565b5b5f613ff784828501613fc1565b91505092915050565b5f81519050919050565b5f82825260208201905092915050565b5f61402482614000565b61402e818561400a565b935061403e818560208601612da8565b61404781612dd0565b840191505092915050565b5f6080820190506140655f830187612ec6565b6140726020830186612ec6565b61407f6040830185612f56565b8181036060830152614091818461401a565b905095945050505050565b5f815190506140aa81612d06565b92915050565b5f602082840312156140c5576140c4612cd3565b5b5f6140d28482850161409c565b91505092915050565b5f819050919050565b5f60ff82169050919050565b5f61410a614105614100846140db565b612f7e565b6140e4565b9050919050565b61411a816140f0565b82525050565b5f6040820190506141335f830185614111565b6141406020830184612f56565b9392505050565b5f67ffffffffffffffff821115614161576141606131a0565b5b61416a82612dd0565b9050602081019050919050565b5f61418961418484614147565b6131fe565b9050828152602081018484840111156141a5576141a461319c565b5b6141b0848285612da8565b509392505050565b5f82601f8301126141cc576141cb613198565b5b81516141dc848260208601614177565b91505092915050565b5f602082840312156141fa576141f9612cd3565b5b5f82015167ffffffffffffffff81111561421757614216612cd7565b5b614223848285016141b8565b91505092915050565b5f819050919050565b5f61424f61424a6142458461422c565b612f7e565b6140e4565b9050919050565b61425f81614235565b82525050565b5f6040820190506142785f830185614256565b6142856020830184612f56565b9392505050565b5f819050919050565b5f6142af6142aa6142a58461428c565b612f7e565b6140e4565b9050919050565b6142bf81614295565b82525050565b5f6040820190506142d85f8301856142b6565b6142e56020830184612f56565b9392505050565b5f819050919050565b5f61430f61430a614305846142ec565b612f7e565b6140e4565b9050919050565b61431f816142f5565b82525050565b5f6040820190506143385f830185614316565b6143456020830184612f56565b9392505050565b7f3c73766720786d6c6e733d22687474703a2f2f7777772e77332e6f72672f32305f8201527f30302f737667222077696474683d2235313222206865696768743d223531322260208201527f2076696577426f783d223020302035313220353132223e000000000000000000604082015250565b5f6143cc6057836135eb565b91506143d78261434c565b605782019050919050565b7f3c2f7376673e00000000000000000000000000000000000000000000000000005f82015250565b5f6144166006836135eb565b9150614421826143e2565b600682019050919050565b5f614436826143c0565b9150614442828761363f565b915061444e828661363f565b915061445a828561363f565b9150614466828461363f565b91506144718261440a565b915081905095945050505050565b7f2c000000000000000000000000000000000000000000000000000000000000005f82015250565b5f6144b36001836135eb565b91506144be8261447f565b600182019050919050565b5f6144d4828561363f565b91506144df826144a7565b91506144eb828461363f565b91508190509392505050565b5f61450182612e38565b91505f820361451357614512613520565b5b60018203905091905056fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa264697066735822122034fb87717819fe715bfbac2526fb8d71a865322b43948ceef4940de0a0b54a5d64736f6c634300081400330000000000000000000000003bf8631260bded87b6097ca92b9ab16ceef598b9000000000000000000000000a3097f1df53cc1d55e0ba7f2299811fe4940e24d
Deployed Bytecode
0x608060405234801561000f575f80fd5b50600436106101c2575f3560e01c80637ecebe00116100f7578063d023f37e11610095578063e086e5ec1161006f578063e086e5ec14610541578063e985e9c51461054b578063f2fde38b1461057b578063f4f3b20014610597576101c2565b8063d023f37e146104af578063d1cea4ec146104df578063e05c57bf1461050f576101c2565b8063a22cb465116100d1578063a22cb46514610429578063b88d4fde14610445578063c87b56dd14610461578063cfdbf25414610491576101c2565b80637ecebe00146103bd5780638da5cb5b146103ed57806395d89b411461040b576101c2565b80632a55205a1161016457806349bc4aed1161013e57806349bc4aed146103235780636352211e1461035357806370a0823114610383578063715018a6146103b3576101c2565b80632a55205a146102b857806332cb6b0c146102e957806342842e0e14610307576101c2565b8063095ea7b3116101a0578063095ea7b31461024457806318160ddd146102605780631b076edc1461027e57806323b872dd1461029c576101c2565b806301ffc9a7146101c657806306fdde03146101f6578063081812fc14610214575b5f80fd5b6101e060048036038101906101db9190612d30565b6105b3565b6040516101ed9190612d75565b60405180910390f35b6101fe6105c4565b60405161020b9190612e18565b60405180910390f35b61022e60048036038101906102299190612e6b565b610654565b60405161023b9190612ed5565b60405180910390f35b61025e60048036038101906102599190612f18565b61066f565b005b610268610685565b6040516102759190612f65565b60405180910390f35b61028661068b565b6040516102939190612fd9565b60405180910390f35b6102b660048036038101906102b19190612ff2565b6106b0565b005b6102d260048036038101906102cd9190613042565b6107af565b6040516102e0929190613080565b60405180910390f35b6102f16108cf565b6040516102fe9190612f65565b60405180910390f35b610321600480360381019061031c9190612ff2565b6108d5565b005b61033d600480360381019061033891906130da565b6108f4565b60405161034a9190612d75565b60405180910390f35b61036d60048036038101906103689190612e6b565b610911565b60405161037a9190612ed5565b60405180910390f35b61039d60048036038101906103989190613105565b610922565b6040516103aa9190612f65565b60405180910390f35b6103bb6109d8565b005b6103d760048036038101906103d29190613105565b6109eb565b6040516103e49190612f65565b60405180910390f35b6103f5610a00565b6040516104029190612ed5565b60405180910390f35b610413610a28565b6040516104209190612e18565b60405180910390f35b610443600480360381019061043e919061315a565b610ab8565b005b61045f600480360381019061045a91906132c4565b610ace565b005b61047b60048036038101906104769190612e6b565b610af3565b6040516104889190612e18565b60405180910390f35b610499610bdf565b6040516104a69190612f65565b60405180910390f35b6104c960048036038101906104c49190612f18565b610be5565b6040516104d691906133fb565b60405180910390f35b6104f960048036038101906104f49190613105565b611010565b6040516105069190612f65565b60405180910390f35b61052960048036038101906105249190612e6b565b611352565b6040516105389392919061341b565b60405180910390f35b610549611378565b005b61056560048036038101906105609190613450565b611414565b6040516105729190612d75565b60405180910390f35b61059560048036038101906105909190613105565b6114a2565b005b6105b160048036038101906105ac9190613105565b611526565b005b5f6105bd82611677565b9050919050565b6060600280546105d3906134bb565b80601f01602080910402602001604051908101604052809291908181526020018280546105ff906134bb565b801561064a5780601f106106215761010080835404028352916020019161064a565b820191905f5260205f20905b81548152906001019060200180831161062d57829003601f168201915b5050505050905090565b5f61065e82611688565b506106688261170e565b9050919050565b610681828261067c611747565b61174e565b5050565b600a5481565b60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1681565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610720575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016107179190612ed5565b60405180910390fd5b5f610733838361072e611747565b611760565b90508373ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146107a9578382826040517f64283d7b0000000000000000000000000000000000000000000000000000000081526004016107a0939291906134eb565b60405180910390fd5b50505050565b5f805f60015f8681526020019081526020015f2090505f815f015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690505f825f0160149054906101000a90046bffffffffffffffffffffffff1690505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610881575f80015f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1691505f800160149054906101000a90046bffffffffffffffffffffffff1690505b5f61088a61196b565b6bffffffffffffffffffffffff16826bffffffffffffffffffffffff16886108b2919061354d565b6108bc91906135bb565b9050828195509550505050509250929050565b6115b381565b6108ef83838360405180602001604052805f815250610ace565b505050565b600c602052805f5260405f205f915054906101000a900460ff1681565b5f61091b82611688565b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603610993575f6040517f89c62b6400000000000000000000000000000000000000000000000000000000815260040161098a9190612ed5565b60405180910390fd5b60055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20549050919050565b6109e0611974565b6109e95f6119fb565b565b600d602052805f5260405f205f915090505481565b5f60085f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff16905090565b606060038054610a37906134bb565b80601f0160208091040260200160405190810160405280929190818152602001828054610a63906134bb565b8015610aae5780601f10610a8557610100808354040283529160200191610aae565b820191905f5260205f20905b815481529060010190602001808311610a9157829003601f168201915b5050505050905090565b610aca610ac3611747565b8383611abe565b5050565b610ad98484846106b0565b610aed610ae4611747565b85858585611c27565b50505050565b6060610afe82610911565b505f600b5f8481526020019081526020015f206040518060600160405290815f82015481526020016001820154815260200160028201548152505090505f80825f015190505f836020015190505f846040015190505f610b6085858585611dd3565b90505f610b6f86868686612090565b90505f610b7b8a612385565b610b84846124dd565b83604051602001610b9793929190613853565b6040516020818303038152906040529050610bb1816124dd565b604051602001610bc1919061391a565b60405160208183030381529060405298505050505050505050919050565b6101f981565b6060610bef611974565b5f82118015610c0057506101f98211155b610c3f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c36906139ab565b60405180910390fd5b6115b382600a54610c5091906139c9565b1115610c91576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610c8890613a6c565b60405180910390fd5b5f8267ffffffffffffffff811115610cac57610cab6131a0565b5b604051908082528060200260200182016040528015610cda5781602001602082028036833780820191505090505b5090505f5b8381101561100557600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f815480929190610d3490613a8a565b91905055505f805f805f5b83158015610d4d5750600a85105b15610f1a575f600143610d609190613ad1565b4033600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205488604051602001610db49493929190613b89565b604051602081830303815290604052805190602001205f1c90505f81604051602001610de09190613c20565b604051602081830303815290604052805190602001205f1c90505f82604051602001610e0c9190613c8f565b604051602081830303815290604052805190602001205f1c90505f83604051602001610e389190613cfe565b604051602081830303815290604052805190602001205f1c9050608f83610e5f9190613d23565b9650605682610e6e9190613d23565b9550600d81610e7d9190613d23565b94505f878787604051602001610e9593929190613d53565b604051602081830303815290604052805190602001209050600c5f8281526020019081526020015f205f9054906101000a900460ff16610f01576001600c5f8381526020019081526020015f205f6101000a81548160ff02191690831515021790555060019850610f10565b8980610f0c90613a8a565b9a50505b5050505050610d3f565b83610f5a576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401610f5190613dff565b60405180910390fd5b600a5f815480929190610f6c90613a8a565b91905055505f600a549050604051806060016040528085815260200184815260200183815250600b5f8381526020019081526020015f205f820151815f01556020820151816001015560408201518160020155905050610fcc8b8261250a565b80888881518110610fe057610fdf613e1d565b5b6020026020010181815250505050505050508080610ffd90613a8a565b915050610cdf565b508091505092915050565b5f611019611974565b6115b3600a541061105f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040161105690613e94565b60405180910390fd5b600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8154809291906110ac90613a8a565b91905055505f805f805f5b831580156110c55750600a85105b15611292575f6001436110d89190613ad1565b4033600d5f3373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f20548860405160200161112c9493929190613b89565b604051602081830303815290604052805190602001205f1c90505f816040516020016111589190613c20565b604051602081830303815290604052805190602001205f1c90505f826040516020016111849190613c8f565b604051602081830303815290604052805190602001205f1c90505f836040516020016111b09190613cfe565b604051602081830303815290604052805190602001205f1c9050608f836111d79190613d23565b96506056826111e69190613d23565b9550600d816111f59190613d23565b94505f87878760405160200161120d93929190613d53565b604051602081830303815290604052805190602001209050600c5f8281526020019081526020015f205f9054906101000a900460ff16611279576001600c5f8381526020019081526020015f205f6101000a81548160ff02191690831515021790555060019850611288565b898061128490613a8a565b9a50505b50505050506110b7565b836112d2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016112c990613dff565b60405180910390fd5b600a5f8154809291906112e490613a8a565b91905055505f600a549050604051806060016040528085815260200184815260200183815250600b5f8381526020019081526020015f205f820151815f01556020820151816001015560408201518160020155905050611344888261250a565b809650505050505050919050565b600b602052805f5260405f205f91509050805f0154908060010154908060020154905083565b611380611974565b5f4790505f81116113c6576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016113bd90613efc565b60405180910390fd5b6113ce610a00565b73ffffffffffffffffffffffffffffffffffffffff166108fc8290811502906040515f60405180830381858888f19350505050158015611410573d5f803e3d5ffd5b5050565b5f60075f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f9054906101000a900460ff16905092915050565b6114aa611974565b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361151a575f6040517f1e4fbdf70000000000000000000000000000000000000000000000000000000081526004016115119190612ed5565b60405180910390fd5b611523816119fb565b50565b61152e611974565b5f8190505f8173ffffffffffffffffffffffffffffffffffffffff166370a08231306040518263ffffffff1660e01b815260040161156c9190612ed5565b602060405180830381865afa158015611587573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115ab9190613f2e565b90505f81116115ef576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004016115e690613fa3565b60405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff1663a9059cbb611613610a00565b836040518363ffffffff1660e01b8152600401611631929190613080565b6020604051808303815f875af115801561164d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906116719190613fd5565b50505050565b5f611681826125fd565b9050919050565b5f80611693836126de565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff160361170557826040517f7e2732890000000000000000000000000000000000000000000000000000000081526004016116fc9190612f65565b60405180910390fd5b80915050919050565b5f60065f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b5f33905090565b61175b8383836001612717565b505050565b5f8061176b846126de565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16146117ac576117ab8184866128d6565b5b5f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611837576117eb5f855f80612717565b600160055f8373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825403925050819055505b5f73ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff16146118b657600160055f8773ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f82825401925050819055505b8460045f8681526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff160217905550838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef60405160405180910390a4809150509392505050565b5f612710905090565b61197c611747565b73ffffffffffffffffffffffffffffffffffffffff1661199a610a00565b73ffffffffffffffffffffffffffffffffffffffff16146119f9576119bd611747565b6040517f118cdaa70000000000000000000000000000000000000000000000000000000081526004016119f09190612ed5565b60405180910390fd5b565b5f60085f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1690508160085f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055508173ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff167f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e060405160405180910390a35050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1603611b2e57816040517f5b08ba18000000000000000000000000000000000000000000000000000000008152600401611b259190612ed5565b60405180910390fd5b8060075f8573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f8473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020015f205f6101000a81548160ff0219169083151502179055508173ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff167f17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c3183604051611c1a9190612d75565b60405180910390a3505050565b5f8373ffffffffffffffffffffffffffffffffffffffff163b1115611dcc578273ffffffffffffffffffffffffffffffffffffffff1663150b7a02868685856040518563ffffffff1660e01b8152600401611c859493929190614052565b6020604051808303815f875af1925050508015611cc057506040513d601f19601f82011682018060405250810190611cbd91906140b0565b60015b611d41573d805f8114611cee576040519150601f19603f3d011682016040523d82523d5f602084013e611cf3565b606091505b505f815103611d3957836040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611d309190612ed5565b60405180910390fd5b805181602001fd5b63150b7a0260e01b7bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916817bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614611dca57836040517f64a0ae92000000000000000000000000000000000000000000000000000000008152600401611dc19190612ed5565b60405180910390fd5b505b5050505050565b60605f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384855f886040518363ffffffff1660e01b8152600401611e32929190614120565b5f60405180830381865afa158015611e4c573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611e7491906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856005866040518363ffffffff1660e01b8152600401611ed4929190614265565b5f60405180830381865afa158015611eee573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611f1691906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856003896040518363ffffffff1660e01b8152600401611f769291906142c5565b5f60405180830381865afa158015611f90573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f82011682018060405250810190611fb891906141e5565b90505f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16634ae384856004896040518363ffffffff1660e01b8152600401612018929190614325565b5f60405180830381865afa158015612032573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061205a91906141e5565b905083838383604051602001612073949392919061442c565b604051602081830303815290604052945050505050949350505050565b60605f60095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b85f886040518363ffffffff1660e01b81526004016120ef929190614120565b5f60405180830381865afa158015612109573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061213191906141e5565b90508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86003886040518363ffffffff1660e01b81526004016121919291906142c5565b5f60405180830381865afa1580156121ab573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f820116820180604052508101906121d391906141e5565b6040516020016121e49291906144c9565b60405160208183030381529060405290508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86004876040518363ffffffff1660e01b8152600401612253929190614325565b5f60405180830381865afa15801561226d573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061229591906141e5565b6040516020016122a69291906144c9565b60405160208183030381529060405290508060095f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663ed6284b86005866040518363ffffffff1660e01b8152600401612315929190614265565b5f60405180830381865afa15801561232f573d5f803e3d5ffd5b505050506040513d5f823e3d601f19601f8201168201806040525081019061235791906141e5565b6040516020016123689291906144c9565b604051602081830303815290604052905080915050949350505050565b60605f82036123cb576040518060400160405280600181526020017f300000000000000000000000000000000000000000000000000000000000000081525090506124d8565b5f8290505f5b5f82146123fa5780806123e390613a8a565b915050600a826123f391906135bb565b91506123d1565b5f8167ffffffffffffffff811115612415576124146131a0565b5b6040519080825280601f01601f1916602001820160405280156124475781602001600182028036833780820191505090505b5090505b5f85146124d157818061245d906144f7565b925050600a8561246d9190613d23565b603061247991906139c9565b60f81b81838151811061248f5761248e613e1d565b5b60200101907effffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff191690815f1a905350600a856124ca91906135bb565b945061244b565b8093505050505b919050565b60606125038260405180606001604052806040815260200161451f604091396001612999565b9050919050565b5f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff160361257a575f6040517f64a0ae920000000000000000000000000000000000000000000000000000000081526004016125719190612ed5565b60405180910390fd5b5f61258683835f611760565b90505f73ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff16146125f8575f6040517f73c6ac6e0000000000000000000000000000000000000000000000000000000081526004016125ef9190612ed5565b60405180910390fd5b505050565b5f7f80ac58cd000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff191614806126c757507f5b5e139f000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916145b806126d757506126d682612b28565b5b9050919050565b5f60045f8381526020019081526020015f205f9054906101000a900473ffffffffffffffffffffffffffffffffffffffff169050919050565b808061274f57505f73ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff1614155b15612881575f61275e84611688565b90505f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff16141580156127c857508273ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614155b80156127db57506127d98184611414565b155b1561281d57826040517fa9fbf51f0000000000000000000000000000000000000000000000000000000081526004016128149190612ed5565b60405180910390fd5b811561287f57838573ffffffffffffffffffffffffffffffffffffffff168273ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560405160405180910390a45b505b8360065f8581526020019081526020015f205f6101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff16021790555050505050565b6128e1838383612ba1565b612994575f73ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff160361295557806040517f7e27328900000000000000000000000000000000000000000000000000000000815260040161294c9190612f65565b60405180910390fd5b81816040517f177e802f00000000000000000000000000000000000000000000000000000000815260040161298b929190613080565b60405180910390fd5b505050565b60605f8451036129b95760405180602001604052805f8152509050612b21565b5f826129ea5760036002865160046129d1919061354d565b6129db91906139c9565b6129e591906135bb565b612a11565b6003600286516129fa91906139c9565b612a0491906135bb565b6004612a10919061354d565b5b90505f8167ffffffffffffffff811115612a2e57612a2d6131a0565b5b6040519080825280601f01601f191660200182016040528015612a605781602001600182028036833780820191505090505b509050600185016020820187885189016020810180515f82525b82841015612ad5576003840193508351603f8160121c168701518653600186019550603f81600c1c168701518653600186019550603f8160061c168701518653600186019550603f8116870151865360018601955050612a7a565b8082528915612b155760038c510660018114612af85760028114612b0b57612b13565b603d6001870353603d6002870353612b13565b603d60018703535b505b50505050505080925050505b9392505050565b5f7f2a55205a000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff19161480612b9a5750612b9982612c61565b5b9050919050565b5f8073ffffffffffffffffffffffffffffffffffffffff168373ffffffffffffffffffffffffffffffffffffffff1614158015612c5857508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff161480612c195750612c188484611414565b5b80612c5757508273ffffffffffffffffffffffffffffffffffffffff16612c3f8361170e565b73ffffffffffffffffffffffffffffffffffffffff16145b5b90509392505050565b5f7f01ffc9a7000000000000000000000000000000000000000000000000000000007bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916827bffffffffffffffffffffffffffffffffffffffffffffffffffffffff1916149050919050565b5f604051905090565b5f80fd5b5f80fd5b5f7fffffffff0000000000000000000000000000000000000000000000000000000082169050919050565b612d0f81612cdb565b8114612d19575f80fd5b50565b5f81359050612d2a81612d06565b92915050565b5f60208284031215612d4557612d44612cd3565b5b5f612d5284828501612d1c565b91505092915050565b5f8115159050919050565b612d6f81612d5b565b82525050565b5f602082019050612d885f830184612d66565b92915050565b5f81519050919050565b5f82825260208201905092915050565b5f5b83811015612dc5578082015181840152602081019050612daa565b5f8484015250505050565b5f601f19601f8301169050919050565b5f612dea82612d8e565b612df48185612d98565b9350612e04818560208601612da8565b612e0d81612dd0565b840191505092915050565b5f6020820190508181035f830152612e308184612de0565b905092915050565b5f819050919050565b612e4a81612e38565b8114612e54575f80fd5b50565b5f81359050612e6581612e41565b92915050565b5f60208284031215612e8057612e7f612cd3565b5b5f612e8d84828501612e57565b91505092915050565b5f73ffffffffffffffffffffffffffffffffffffffff82169050919050565b5f612ebf82612e96565b9050919050565b612ecf81612eb5565b82525050565b5f602082019050612ee85f830184612ec6565b92915050565b612ef781612eb5565b8114612f01575f80fd5b50565b5f81359050612f1281612eee565b92915050565b5f8060408385031215612f2e57612f2d612cd3565b5b5f612f3b85828601612f04565b9250506020612f4c85828601612e57565b9150509250929050565b612f5f81612e38565b82525050565b5f602082019050612f785f830184612f56565b92915050565b5f819050919050565b5f612fa1612f9c612f9784612e96565b612f7e565b612e96565b9050919050565b5f612fb282612f87565b9050919050565b5f612fc382612fa8565b9050919050565b612fd381612fb9565b82525050565b5f602082019050612fec5f830184612fca565b92915050565b5f805f6060848603121561300957613008612cd3565b5b5f61301686828701612f04565b935050602061302786828701612f04565b925050604061303886828701612e57565b9150509250925092565b5f806040838503121561305857613057612cd3565b5b5f61306585828601612e57565b925050602061307685828601612e57565b9150509250929050565b5f6040820190506130935f830185612ec6565b6130a06020830184612f56565b9392505050565b5f819050919050565b6130b9816130a7565b81146130c3575f80fd5b50565b5f813590506130d4816130b0565b92915050565b5f602082840312156130ef576130ee612cd3565b5b5f6130fc848285016130c6565b91505092915050565b5f6020828403121561311a57613119612cd3565b5b5f61312784828501612f04565b91505092915050565b61313981612d5b565b8114613143575f80fd5b50565b5f8135905061315481613130565b92915050565b5f80604083850312156131705761316f612cd3565b5b5f61317d85828601612f04565b925050602061318e85828601613146565b9150509250929050565b5f80fd5b5f80fd5b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b6131d682612dd0565b810181811067ffffffffffffffff821117156131f5576131f46131a0565b5b80604052505050565b5f613207612cca565b905061321382826131cd565b919050565b5f67ffffffffffffffff821115613232576132316131a0565b5b61323b82612dd0565b9050602081019050919050565b828183375f83830152505050565b5f61326861326384613218565b6131fe565b9050828152602081018484840111156132845761328361319c565b5b61328f848285613248565b509392505050565b5f82601f8301126132ab576132aa613198565b5b81356132bb848260208601613256565b91505092915050565b5f805f80608085870312156132dc576132db612cd3565b5b5f6132e987828801612f04565b94505060206132fa87828801612f04565b935050604061330b87828801612e57565b925050606085013567ffffffffffffffff81111561332c5761332b612cd7565b5b61333887828801613297565b91505092959194509250565b5f81519050919050565b5f82825260208201905092915050565b5f819050602082019050919050565b61337681612e38565b82525050565b5f613387838361336d565b60208301905092915050565b5f602082019050919050565b5f6133a982613344565b6133b3818561334e565b93506133be8361335e565b805f5b838110156133ee5781516133d5888261337c565b97506133e083613393565b9250506001810190506133c1565b5085935050505092915050565b5f6020820190508181035f830152613413818461339f565b905092915050565b5f60608201905061342e5f830186612f56565b61343b6020830185612f56565b6134486040830184612f56565b949350505050565b5f806040838503121561346657613465612cd3565b5b5f61347385828601612f04565b925050602061348485828601612f04565b9150509250929050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b5f60028204905060018216806134d257607f821691505b6020821081036134e5576134e461348e565b5b50919050565b5f6060820190506134fe5f830186612ec6565b61350b6020830185612f56565b6135186040830184612ec6565b949350505050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b5f61355782612e38565b915061356283612e38565b925082820261357081612e38565b9150828204841483151761358757613586613520565b5b5092915050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b5f6135c582612e38565b91506135d083612e38565b9250826135e0576135df61358e565b5b828204905092915050565b5f81905092915050565b7f7b226e616d65223a225370696b792023000000000000000000000000000000005f82015250565b5f6136296010836135eb565b9150613634826135f5565b601082019050919050565b5f61364982612d8e565b61365381856135eb565b9350613663818560208601612da8565b80840191505092915050565b7f222c0000000000000000000000000000000000000000000000000000000000005f82015250565b5f6136a36002836135eb565b91506136ae8261366f565b600282019050919050565b7f226465736372697074696f6e223a22416e206f6e2d636861696e20696d706c655f8201527f6d656e746174696f6e206f66205370696b696573204e4654206f6e204170654360208201527f6861696e222c0000000000000000000000000000000000000000000000000000604082015250565b5f6137396046836135eb565b9150613744826136b9565b604682019050919050565b7f22696d616765223a22646174613a696d6167652f7376672b786d6c3b626173655f8201527f36342c0000000000000000000000000000000000000000000000000000000000602082015250565b5f6137a96023836135eb565b91506137b48261374f565b602382019050919050565b7f2261747472696275746573223a5b0000000000000000000000000000000000005f82015250565b5f6137f3600e836135eb565b91506137fe826137bf565b600e82019050919050565b7f5d7d0000000000000000000000000000000000000000000000000000000000005f82015250565b5f61383d6002836135eb565b915061384882613809565b600282019050919050565b5f61385d8261361d565b9150613869828661363f565b915061387482613697565b915061387f8261372d565b915061388a8261379d565b9150613896828561363f565b91506138a182613697565b91506138ac826137e7565b91506138b8828461363f565b91506138c382613831565b9150819050949350505050565b7f646174613a6170706c69636174696f6e2f6a736f6e3b6261736536342c0000005f82015250565b5f613904601d836135eb565b915061390f826138d0565b601d82019050919050565b5f613924826138f8565b9150613930828461363f565b915081905092915050565b7f5175616e74697479206d757374206265206265747765656e203120616e6420355f8201527f3035000000000000000000000000000000000000000000000000000000000000602082015250565b5f613995602283612d98565b91506139a08261393b565b604082019050919050565b5f6020820190508181035f8301526139c281613989565b9050919050565b5f6139d382612e38565b91506139de83612e38565b92508282019050808211156139f6576139f5613520565b5b92915050565b7f4261746368206d696e7420776f756c6420657863656564206d617820737570705f8201527f6c79000000000000000000000000000000000000000000000000000000000000602082015250565b5f613a56602283612d98565b9150613a61826139fc565b604082019050919050565b5f6020820190508181035f830152613a8381613a4a565b9050919050565b5f613a9482612e38565b91507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8203613ac657613ac5613520565b5b600182019050919050565b5f613adb82612e38565b9150613ae683612e38565b9250828203905081811115613afe57613afd613520565b5b92915050565b5f819050919050565b613b1e613b19826130a7565b613b04565b82525050565b5f8160601b9050919050565b5f613b3a82613b24565b9050919050565b5f613b4b82613b30565b9050919050565b613b63613b5e82612eb5565b613b41565b82525050565b5f819050919050565b613b83613b7e82612e38565b613b69565b82525050565b5f613b948287613b0d565b602082019150613ba48286613b52565b601482019150613bb48285613b72565b602082019150613bc48284613b72565b60208201915081905095945050505050565b7f65796573000000000000000000000000000000000000000000000000000000005f82015250565b5f613c0a6004836135eb565b9150613c1582613bd6565b600482019050919050565b5f613c2b8284613b72565b602082019150613c3a82613bfe565b915081905092915050565b7f68656164730000000000000000000000000000000000000000000000000000005f82015250565b5f613c796005836135eb565b9150613c8482613c45565b600582019050919050565b5f613c9a8284613b72565b602082019150613ca982613c6d565b915081905092915050565b7f6d6f7574687300000000000000000000000000000000000000000000000000005f82015250565b5f613ce86006836135eb565b9150613cf382613cb4565b600682019050919050565b5f613d098284613b72565b602082019150613d1882613cdc565b915081905092915050565b5f613d2d82612e38565b9150613d3883612e38565b925082613d4857613d4761358e565b5b828206905092915050565b5f613d5e8286613b72565b602082019150613d6e8285613b72565b602082019150613d7e8284613b72565b602082019150819050949350505050565b7f4e6f20756e6971756520636f6d62696e6174696f6e20666f756e6420616674655f8201527f7220313020617474656d70747300000000000000000000000000000000000000602082015250565b5f613de9602d83612d98565b9150613df482613d8f565b604082019050919050565b5f6020820190508181035f830152613e1681613ddd565b9050919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52603260045260245ffd5b7f4d617820737570706c79207265616368656400000000000000000000000000005f82015250565b5f613e7e601283612d98565b9150613e8982613e4a565b602082019050919050565b5f6020820190508181035f830152613eab81613e72565b9050919050565b7f4e6f2045544820746f20776974686472617700000000000000000000000000005f82015250565b5f613ee6601283612d98565b9150613ef182613eb2565b602082019050919050565b5f6020820190508181035f830152613f1381613eda565b9050919050565b5f81519050613f2881612e41565b92915050565b5f60208284031215613f4357613f42612cd3565b5b5f613f5084828501613f1a565b91505092915050565b7f4e6f20746f6b656e7320746f20776974686472617700000000000000000000005f82015250565b5f613f8d601583612d98565b9150613f9882613f59565b602082019050919050565b5f6020820190508181035f830152613fba81613f81565b9050919050565b5f81519050613fcf81613130565b92915050565b5f60208284031215613fea57613fe9612cd3565b5b5f613ff784828501613fc1565b91505092915050565b5f81519050919050565b5f82825260208201905092915050565b5f61402482614000565b61402e818561400a565b935061403e818560208601612da8565b61404781612dd0565b840191505092915050565b5f6080820190506140655f830187612ec6565b6140726020830186612ec6565b61407f6040830185612f56565b8181036060830152614091818461401a565b905095945050505050565b5f815190506140aa81612d06565b92915050565b5f602082840312156140c5576140c4612cd3565b5b5f6140d28482850161409c565b91505092915050565b5f819050919050565b5f60ff82169050919050565b5f61410a614105614100846140db565b612f7e565b6140e4565b9050919050565b61411a816140f0565b82525050565b5f6040820190506141335f830185614111565b6141406020830184612f56565b9392505050565b5f67ffffffffffffffff821115614161576141606131a0565b5b61416a82612dd0565b9050602081019050919050565b5f61418961418484614147565b6131fe565b9050828152602081018484840111156141a5576141a461319c565b5b6141b0848285612da8565b509392505050565b5f82601f8301126141cc576141cb613198565b5b81516141dc848260208601614177565b91505092915050565b5f602082840312156141fa576141f9612cd3565b5b5f82015167ffffffffffffffff81111561421757614216612cd7565b5b614223848285016141b8565b91505092915050565b5f819050919050565b5f61424f61424a6142458461422c565b612f7e565b6140e4565b9050919050565b61425f81614235565b82525050565b5f6040820190506142785f830185614256565b6142856020830184612f56565b9392505050565b5f819050919050565b5f6142af6142aa6142a58461428c565b612f7e565b6140e4565b9050919050565b6142bf81614295565b82525050565b5f6040820190506142d85f8301856142b6565b6142e56020830184612f56565b9392505050565b5f819050919050565b5f61430f61430a614305846142ec565b612f7e565b6140e4565b9050919050565b61431f816142f5565b82525050565b5f6040820190506143385f830185614316565b6143456020830184612f56565b9392505050565b7f3c73766720786d6c6e733d22687474703a2f2f7777772e77332e6f72672f32305f8201527f30302f737667222077696474683d2235313222206865696768743d223531322260208201527f2076696577426f783d223020302035313220353132223e000000000000000000604082015250565b5f6143cc6057836135eb565b91506143d78261434c565b605782019050919050565b7f3c2f7376673e00000000000000000000000000000000000000000000000000005f82015250565b5f6144166006836135eb565b9150614421826143e2565b600682019050919050565b5f614436826143c0565b9150614442828761363f565b915061444e828661363f565b915061445a828561363f565b9150614466828461363f565b91506144718261440a565b915081905095945050505050565b7f2c000000000000000000000000000000000000000000000000000000000000005f82015250565b5f6144b36001836135eb565b91506144be8261447f565b600182019050919050565b5f6144d4828561363f565b91506144df826144a7565b91506144eb828461363f565b91508190509392505050565b5f61450182612e38565b91505f820361451357614512613520565b5b60018203905091905056fe4142434445464748494a4b4c4d4e4f505152535455565758595a6162636465666768696a6b6c6d6e6f707172737475767778797a303132333435363738392b2fa264697066735822122034fb87717819fe715bfbac2526fb8d71a865322b43948ceef4940de0a0b54a5d64736f6c63430008140033
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
0000000000000000000000003bf8631260bded87b6097ca92b9ab16ceef598b9000000000000000000000000a3097f1df53cc1d55e0ba7f2299811fe4940e24d
-----Decoded View---------------
Arg [0] : _dataSource (address): 0x3bF8631260bDED87b6097cA92B9AB16CeEf598B9
Arg [1] : royaltyReceiver (address): 0xA3097F1dF53cc1d55E0Ba7F2299811fE4940e24D
-----Encoded View---------------
2 Constructor Arguments found :
Arg [0] : 0000000000000000000000003bf8631260bded87b6097ca92b9ab16ceef598b9
Arg [1] : 000000000000000000000000a3097f1df53cc1d55e0ba7f2299811fe4940e24d
Deployed Bytecode Sourcemap
141567:8030:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;149362:232;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;107514:91;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;108686:158;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;108505:115;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;141676:26;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;141633:36;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;109355:588;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;130802:673;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;;:::i;:::-;;;;;;;;141709:41;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;110014:134;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;141983:48;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;107327:120;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;107052:213;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;137451:103;;;:::i;:::-;;142038:41;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;136776:87;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;107674:95;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;108916:146;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;110219:236;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;145812:1019;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;141775:44;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;143884:1920;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;142348:1486;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;141931:45;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;;;:::i;:::-;;;;;;;;149070:198;;;:::i;:::-;;109133:155;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;137709:220;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;148749:276;;;;;;;;;;;;;:::i;:::-;;:::i;:::-;;149362:232;149520:4;149550:36;149574:11;149550:23;:36::i;:::-;149543:43;;149362:232;;;:::o;107514:91::-;107559:13;107592:5;107585:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;107514:91;:::o;108686:158::-;108753:7;108773:22;108787:7;108773:13;:22::i;:::-;;108815:21;108828:7;108815:12;:21::i;:::-;108808:28;;108686:158;;;:::o;108505:115::-;108577:35;108586:2;108590:7;108599:12;:10;:12::i;:::-;108577:8;:35::i;:::-;108505:115;;:::o;141676:26::-;;;;:::o;141633:36::-;;;;;;;;;;;;;:::o;109355:588::-;109464:1;109450:16;;:2;:16;;;109446:89;;109520:1;109490:33;;;;;;;;;;;:::i;:::-;;;;;;;;109446:89;109756:21;109780:34;109788:2;109792:7;109801:12;:10;:12::i;:::-;109780:7;:34::i;:::-;109756:58;;109846:4;109829:21;;:13;:21;;;109825:111;;109895:4;109901:7;109910:13;109874:50;;;;;;;;;;;;;:::i;:::-;;;;;;;;109825:111;109435:508;109355:588;;;:::o;130802:673::-;130913:16;130931:14;130958:32;130993:17;:26;131011:7;130993:26;;;;;;;;;;;130958:61;;131030:23;131056:12;:21;;;;;;;;;;;;131030:47;;131088:22;131113:12;:28;;;;;;;;;;;;131088:53;;131185:1;131158:29;;:15;:29;;;131154:176;;131222:19;:28;;;;;;;;;;;;131204:46;;131283:19;:35;;;;;;;;;;;;131265:53;;131154:176;131342:21;131398:17;:15;:17::i;:::-;131366:49;;131379:15;131367:27;;:9;:27;;;;:::i;:::-;131366:49;;;;:::i;:::-;131342:73;;131436:15;131453:13;131428:39;;;;;;;;130802:673;;;;;:::o;141709:41::-;141746:4;141709:41;:::o;110014:134::-;110101:39;110118:4;110124:2;110128:7;110101:39;;;;;;;;;;;;:16;:39::i;:::-;110014:134;;;:::o;141983:48::-;;;;;;;;;;;;;;;;;;;;;;:::o;107327:120::-;107390:7;107417:22;107431:7;107417:13;:22::i;:::-;107410:29;;107327:120;;;:::o;107052:213::-;107115:7;107156:1;107139:19;;:5;:19;;;107135:89;;107209:1;107182:30;;;;;;;;;;;:::i;:::-;;;;;;;;107135:89;107241:9;:16;107251:5;107241:16;;;;;;;;;;;;;;;;107234:23;;107052:213;;;:::o;137451:103::-;136662:13;:11;:13::i;:::-;137516:30:::1;137543:1;137516:18;:30::i;:::-;137451:103::o:0;142038:41::-;;;;;;;;;;;;;;;;;:::o;136776:87::-;136822:7;136849:6;;;;;;;;;;;136842:13;;136776:87;:::o;107674:95::-;107721:13;107754:7;107747:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;107674:95;:::o;108916:146::-;109002:52;109021:12;:10;:12::i;:::-;109035:8;109045;109002:18;:52::i;:::-;108916:146;;:::o;110219:236::-;110333:31;110346:4;110352:2;110356:7;110333:12;:31::i;:::-;110375:72;110409:12;:10;:12::i;:::-;110423:4;110429:2;110433:7;110442:4;110375:33;:72::i;:::-;110219:236;;;;:::o;145812:1019::-;145877:13;145903:16;145911:7;145903;:16::i;:::-;;145964:20;145987:11;:20;145999:7;145987:20;;;;;;;;;;;145964:43;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;146018:17;146051:19;146073:6;:11;;;146051:33;;146095:20;146118:6;:12;;;146095:35;;146141:21;146165:6;:13;;;146141:37;;146189:17;146209:62;146219:9;146230:11;146243:12;146257:13;146209:9;:62::i;:::-;146189:82;;146282:24;146309:65;146322:9;146333:11;146346:12;146360:13;146309:12;:65::i;:::-;146282:92;;146385:18;146464:17;146473:7;146464:8;:17::i;:::-;146628:25;146648:3;146628:13;:25::i;:::-;146692:10;146413:306;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;146385:335;;146795:26;146815:4;146795:13;:26::i;:::-;146745:77;;;;;;;;:::i;:::-;;;;;;;;;;;;;146731:92;;;;;;;;;;145812:1019;;;:::o;141775:44::-;141816:3;141775:44;:::o;143884:1920::-;143967:16;136662:13;:11;:13::i;:::-;144015:1:::1;144004:8;:12;:42;;;;;141816:3;144020:8;:26;;144004:42;143996:89;;;;;;;;;;;;:::i;:::-;;;;;;;;;141746:4;144118:8;144104:11;;:22;;;;:::i;:::-;:36;;144096:83;;;;;;;;;;;;:::i;:::-;;;;;;;;;144192:25;144234:8;144220:23;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;144192:51;;144261:9;144256:1513;144280:8;144276:1;:12;144256:1513;;;144310:6;:18;144317:10;144310:18;;;;;;;;;;;;;;;;:20;;;;;;;;;:::i;:::-;;;;;;144345:15;144379:10:::0;144412:19:::1;144446:20:::0;144481:21:::1;144519:932;144527:5;144526:6;:22;;;;;144546:2;144536:7;:12;144526:22;144519:932;;;144569:12;144644:1;144629:12;:16;;;;:::i;:::-;144619:27;144648:10;144660:6;:18;144667:10;144660:18;;;;;;;;;;;;;;;;144680:7;144602:86;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;144592:97;;;;;;144584:106;;144569:121;;144709:16;144763:4;144746:30;;;;;;;;:::i;:::-;;;;;;;;;;;;;144736:41;;;;;;144728:50;;144709:69;;144797:17;144852:4;144835:31;;;;;;;;:::i;:::-;;;;;;;;;;;;;144825:42;;;;;;144817:51;;144797:71;;144887:18;144943:4;144926:32;;;;;;;;:::i;:::-;;;;;;;;;;;;;144916:43;;;;;;144908:52;;144887:73;;145004:3;144993:8;:14;;;;:::i;:::-;144979:28;;145053:2;145041:9;:14;;;;:::i;:::-;145026:29;;145103:2;145090:10;:15;;;;:::i;:::-;145074:31;;145124:17;145171:11;145184:12;145198:13;145154:58;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;145144:69;;;;;;145124:89;;145237:16;:27;145254:9;145237:27;;;;;;;;;;;;;;;;;;;;;145232:204;;145319:4;145289:16;:27;145306:9;145289:27;;;;;;;;;;;;:34;;;;;;;;;;;;;;;;;;145354:4;145346:12;;145232:204;;;145407:9;;;;;:::i;:::-;;;;145232:204;144550:901;;;;;144519:932;;;145473:5;145465:63;;;;;;;;;;;;:::i;:::-;;;;;;;;;145545:11;;:13;;;;;;;;;:::i;:::-;;;;;;145573:15;145591:11;;145573:29;;145640:48;;;;;;;;145647:11;145640:48;;;;145660:12;145640:48;;;;145674:13;145640:48;;::::0;145617:11:::1;:20;145629:7;145617:20;;;;;;;;;;;:71;;;;;;;;;;;;;;;;;;;;;;;;;;;145703:18;145709:2;145713:7;145703:5;:18::i;:::-;145750:7;145736:8;145745:1;145736:11;;;;;;;;:::i;:::-;;;;;;;:21;;;::::0;::::1;144295:1474;;;;;;144290:3;;;;;:::i;:::-;;;;144256:1513;;;;145788:8;145781:15;;;143884:1920:::0;;;;:::o;142348:1486::-;142408:7;136662:13;:11;:13::i;:::-;141746:4:::1;142436:11;;:24;142428:55;;;;;;;;;;;;:::i;:::-;;;;;;;;;142494:6;:18;142501:10;142494:18;;;;;;;;;;;;;;;;:20;;;;;;;;;:::i;:::-;;;;;;142525:15;142555:10:::0;142584:19:::1;142614:20:::0;142645:21:::1;142679:872;142687:5;142686:6;:22;;;;;142706:2;142696:7;:12;142686:22;142679:872;;;142725:12;142800:1;142785:12;:16;;;;:::i;:::-;142775:27;142804:10;142816:6;:18;142823:10;142816:18;;;;;;;;;;;;;;;;142836:7;142758:86;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;142748:97;;;;;;142740:106;;142725:121;;142861:16;142915:4;142898:30;;;;;;;;:::i;:::-;;;;;;;;;;;;;142888:41;;;;;;142880:50;;142861:69;;142945:17;143000:4;142983:31;;;;;;;;:::i;:::-;;;;;;;;;;;;;142973:42;;;;;;142965:51;;142945:71;;143031:18;143087:4;143070:32;;;;;;;;:::i;:::-;;;;;;;;;;;;;143060:43;;;;;;143052:52;;143031:73;;143144:3;143133:8;:14;;;;:::i;:::-;143119:28;;143189:2;143177:9;:14;;;;:::i;:::-;143162:29;;143235:2;143222:10;:15;;;;:::i;:::-;143206:31;;143252:17;143299:11;143312:12;143326:13;143282:58;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;143272:69;;;;;;143252:89;;143361:16;:27;143378:9;143361:27;;;;;;;;;;;;;;;;;;;;;143356:184;;143439:4;143409:16;:27;143426:9;143409:27;;;;;;;;;;;;:34;;;;;;;;;;;;;;;;;;143470:4;143462:12;;143356:184;;;143515:9;;;;;:::i;:::-;;;;143356:184;142710:841;;;;;142679:872;;;143569:5;143561:63;;;;;;;;;;;;:::i;:::-;;;;;;;;;143637:11;;:13;;;;;;;;;:::i;:::-;;;;;;143661:15;143679:11;;143661:29;;143724:48;;;;;;;;143731:11;143724:48;;;;143744:12;143724:48;;;;143758:13;143724:48;;::::0;143701:11:::1;:20;143713:7;143701:20;;;;;;;;;;;:71;;;;;;;;;;;;;;;;;;;;;;;;;;;143783:18;143789:2;143793:7;143783:5;:18::i;:::-;143819:7;143812:14;;;;;;;;142348:1486:::0;;;:::o;141931:45::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::o;149070:198::-;136662:13;:11;:13::i;:::-;149123:15:::1;149141:21;149123:39;;149191:1;149181:7;:11;149173:42;;;;;;;;;;;;:::i;:::-;;;;;;;;;149234:7;:5;:7::i;:::-;149226:25;;:34;149252:7;149226:34;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;::::0;::::1;;;;;;149112:156;149070:198::o:0;109133:155::-;109221:4;109245:18;:25;109264:5;109245:25;;;;;;;;;;;;;;;:35;109271:8;109245:35;;;;;;;;;;;;;;;;;;;;;;;;;109238:42;;109133:155;;;;:::o;137709:220::-;136662:13;:11;:13::i;:::-;137814:1:::1;137794:22;;:8;:22;;::::0;137790:93:::1;;137868:1;137840:31;;;;;;;;;;;:::i;:::-;;;;;;;;137790:93;137893:28;137912:8;137893:18;:28::i;:::-;137709:220:::0;:::o;148749:276::-;136662:13;:11;:13::i;:::-;148824:12:::1;148846;148824:35;;148870:15;148888:5;:15;;;148912:4;148888:30;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;::::0;::::1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;148870:48;;148947:1;148937:7;:11;148929:45;;;;;;;;;;;;:::i;:::-;;;;;;;;;148985:5;:14;;;149000:7;:5;:7::i;:::-;149009;148985:32;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;::::0;::::1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;148813:212;;148749:276:::0;:::o;134929:170::-;135031:4;135055:36;135079:11;135055:23;:36::i;:::-;135048:43;;134929:170;;;:::o;121737:247::-;121800:7;121820:13;121836:17;121845:7;121836:8;:17::i;:::-;121820:33;;121885:1;121868:19;;:5;:19;;;121864:90;;121934:7;121911:31;;;;;;;;;;;:::i;:::-;;;;;;;;121864:90;121971:5;121964:12;;;121737:247;;;:::o;111218:129::-;111288:7;111315:15;:24;111331:7;111315:24;;;;;;;;;;;;;;;;;;;;;111308:31;;111218:129;;;:::o;17202:98::-;17255:7;17282:10;17275:17;;17202:98;:::o;119969:122::-;120050:33;120059:2;120063:7;120072:4;120078;120050:8;:33::i;:::-;119969:122;;;:::o;114179:824::-;114265:7;114285:12;114300:17;114309:7;114300:8;:17::i;:::-;114285:32;;114396:1;114380:18;;:4;:18;;;114376:88;;114415:37;114432:4;114438;114444:7;114415:16;:37::i;:::-;114376:88;114527:1;114511:18;;:4;:18;;;114507:263;;114629:48;114646:1;114650:7;114667:1;114671:5;114629:8;:48::i;:::-;114742:1;114723:9;:15;114733:4;114723:15;;;;;;;;;;;;;;;;:20;;;;;;;;;;;114507:263;114800:1;114786:16;;:2;:16;;;114782:111;;114865:1;114848:9;:13;114858:2;114848:13;;;;;;;;;;;;;;;;:18;;;;;;;;;;;114782:111;114924:2;114905:7;:16;114913:7;114905:16;;;;;;;;;;;;:21;;;;;;;;;;;;;;;;;;114963:7;114959:2;114944:27;;114953:4;114944:27;;;;;;;;;;;;114991:4;114984:11;;;114179:824;;;;;:::o;131757:97::-;131815:6;131841:5;131834:12;;131757:97;:::o;136941:166::-;137012:12;:10;:12::i;:::-;137001:23;;:7;:5;:7::i;:::-;:23;;;136997:103;;137075:12;:10;:12::i;:::-;137048:40;;;;;;;;;;;:::i;:::-;;;;;;;;136997:103;136941:166::o;138089:191::-;138163:16;138182:6;;;;;;;;;;;138163:25;;138208:8;138199:6;;:17;;;;;;;;;;;;;;;;;;138263:8;138232:40;;138253:8;138232:40;;;;;;;;;;;;138152:128;138089:191;:::o;121176:318::-;121304:1;121284:22;;:8;:22;;;121280:93;;121352:8;121330:31;;;;;;;;;;;:::i;:::-;;;;;;;;121280:93;121421:8;121383:18;:25;121402:5;121383:25;;;;;;;;;;;;;;;:35;121409:8;121383:35;;;;;;;;;;;;;;;;:46;;;;;;;;;;;;;;;;;;121467:8;121445:41;;121460:5;121445:41;;;121477:8;121445:41;;;;;;:::i;:::-;;;;;;;;121176:318;;;:::o;15552:948::-;15756:1;15739:2;:14;;;:18;15735:758;;;15794:2;15778:36;;;15815:8;15825:4;15831:7;15840:4;15778:67;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;15774:708;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;16158:1;16141:6;:13;:18;16137:330;;16283:2;16247:39;;;;;;;;;;;:::i;:::-;;;;;;;;16137:330;16417:6;16411:13;16402:6;16398:2;16394:15;16387:38;15774:708;15903:41;;;15893:51;;;:6;:51;;;;15889:185;;16051:2;16015:39;;;;;;;;;;;:::i;:::-;;;;;;;;15889:185;15846:243;15735:758;15552:948;;;;;:::o;146839:756::-;147009:13;147035:19;147057:10;;;;;;;;;;;:22;;;147080:1;147083:9;147057:36;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147035:58;;147104:23;147130:10;;;;;;;;;;;:22;;;147153:1;147156:13;147130:40;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147104:66;;147181:21;147205:10;;;;;;;;;;;:22;;;147228:1;147231:11;147205:38;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147181:62;;147254:22;147279:10;;;;;;;;;;;:22;;;147302:1;147305:12;147279:39;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147254:64;;147478:5;147498:9;147522:7;147544:8;147343:243;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;147329:258;;;;;;146839:756;;;;;;:::o;147603:592::-;147776:13;147802:20;147825:10;;;;;;;;;;;:24;;;147850:1;147853:9;147825:38;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147802:61;;147907:6;147920:10;;;;;;;;;;;:24;;;147945:1;147948:11;147920:40;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147890:71;;;;;;;;;:::i;:::-;;;;;;;;;;;;;147874:88;;148006:6;148019:10;;;;;;;;;;;:24;;;148044:1;148047:12;148019:41;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;147989:72;;;;;;;;;:::i;:::-;;;;;;;;;;;;;147973:89;;148106:6;148119:10;;;;;;;;;;;:24;;;148144:1;148147:13;148119:42;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;148089:73;;;;;;;;;:::i;:::-;;;;;;;;;;;;;148073:90;;148181:6;148174:13;;;147603:592;;;;;;:::o;148203:496::-;148259:13;148298:1;148289:5;:10;148285:26;;148301:10;;;;;;;;;;;;;;;;;;;;;148285:26;148322:12;148337:5;148322:20;;148353:14;148378:78;148393:1;148385:4;:9;148378:78;;148411:8;;;;;:::i;:::-;;;;148442:2;148434:10;;;;;:::i;:::-;;;148378:78;;;148466:19;148498:6;148488:17;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;148466:39;;148516:144;148532:1;148523:5;:10;148516:144;;148550:8;;;;;:::i;:::-;;;;148617:2;148609:5;:10;;;;:::i;:::-;148603:2;:17;;;;:::i;:::-;148590:32;;148573:6;148580;148573:14;;;;;;;;:::i;:::-;;;;;:49;;;;;;;;;;;148646:2;148637:11;;;;;:::i;:::-;;;148516:144;;;148684:6;148670:21;;;;;148203:496;;;;:::o;122695:126::-;122753:13;122786:27;122794:4;122800:6;;;;;;;;;;;;;;;;;122808:4;122786:7;:27::i;:::-;122779:34;;122695:126;;;:::o;115339:335::-;115421:1;115407:16;;:2;:16;;;115403:89;;115477:1;115447:33;;;;;;;;;;;:::i;:::-;;;;;;;;115403:89;115502:21;115526:32;115534:2;115538:7;115555:1;115526:7;:32::i;:::-;115502:56;;115598:1;115573:27;;:13;:27;;;115569:98;;115652:1;115624:31;;;;;;;;;;;:::i;:::-;;;;;;;;115569:98;115392:282;115339:335;;:::o;106683:305::-;106785:4;106837:25;106822:40;;;:11;:40;;;;:105;;;;106894:33;106879:48;;;:11;:48;;;;106822:105;:158;;;;106944:36;106968:11;106944:23;:36::i;:::-;106822:158;106802:178;;106683:305;;;:::o;110980:117::-;111046:7;111073;:16;111081:7;111073:16;;;;;;;;;;;;;;;;;;;;;111066:23;;110980:117;;;:::o;120279:678::-;120441:9;:31;;;;120470:1;120454:18;;:4;:18;;;;120441:31;120437:471;;;120489:13;120505:22;120519:7;120505:13;:22::i;:::-;120489:38;;120674:1;120658:18;;:4;:18;;;;:35;;;;;120689:4;120680:13;;:5;:13;;;;120658:35;:69;;;;;120698:29;120715:5;120722:4;120698:16;:29::i;:::-;120697:30;120658:69;120654:144;;;120777:4;120755:27;;;;;;;;;;;:::i;:::-;;;;;;;;120654:144;120818:9;120814:83;;;120873:7;120869:2;120853:28;;120862:5;120853:28;;;;;;;;;;;;120814:83;120474:434;120437:471;120947:2;120920:15;:24;120936:7;120920:24;;;;;;;;;;;;:29;;;;;;;;;;;;;;;;;;120279:678;;;;:::o;112386:376::-;112499:38;112513:5;112520:7;112529;112499:13;:38::i;:::-;112494:261;;112575:1;112558:19;;:5;:19;;;112554:190;;112628:7;112605:31;;;;;;;;;;;:::i;:::-;;;;;;;;112554:190;112711:7;112720;112684:44;;;;;;;;;;;;:::i;:::-;;;;;;;;112494:261;112386:376;;;:::o;123233:4109::-;123330:13;123582:1;123567:4;:11;:16;123563:31;;123585:9;;;;;;;;;;;;;;;;123563:31;124547:20;124570:11;:69;;124638:1;124633;124619:4;:11;124615:1;:15;;;;:::i;:::-;:19;;;;:::i;:::-;124614:25;;;;:::i;:::-;124570:69;;;124609:1;124604;124590:4;:11;:15;;;;:::i;:::-;124589:21;;;;:::i;:::-;124584:1;:27;;;;:::i;:::-;124570:69;124547:92;;124652:20;124686:12;124675:24;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;124652:47;;124851:1;124844:5;124840:13;124955:4;124947:6;124943:17;124989:4;125037;125031:11;125025:4;125021:22;125289:4;125281:6;125277:17;125332:8;125326:15;125372:4;125362:8;125355:22;125447:1286;125482:6;125473:7;125470:19;125447:1286;;;125588:1;125579:7;125575:15;125564:26;;125627:7;125621:14;126223:4;126215:5;126211:2;126207:14;126203:25;126193:8;126189:40;126183:47;126172:9;126164:67;126277:1;126266:9;126262:17;126249:30;;126369:4;126361:5;126357:2;126353:14;126349:25;126339:8;126335:40;126329:47;126318:9;126310:67;126423:1;126412:9;126408:17;126395:30;;126514:4;126506:5;126503:1;126499:13;126495:24;126485:8;126481:39;126475:46;126464:9;126456:66;126568:1;126557:9;126553:17;126540:30;;126651:4;126644:5;126640:16;126630:8;126626:31;126620:38;126609:9;126601:58;126705:1;126694:9;126690:17;126677:30;;125509:1224;125447:1286;;;126814:10;126804:8;126797:28;126844:11;126841:457;;;127029:1;127022:4;127016:11;127012:19;127054:1;127049:135;;;;127207:1;127202:81;;;;127005:278;;127049:135;127106:4;127102:1;127091:9;127087:17;127079:32;127160:4;127156:1;127145:9;127141:17;127133:32;127049:135;;127202:81;127259:4;127255:1;127244:9;127240:17;127232:32;127005:278;;126841:457;124737:2572;;;;;;127328:6;127321:13;;;;123233:4109;;;;;;:::o;130532:215::-;130634:4;130673:26;130658:41;;;:11;:41;;;;:81;;;;130703:36;130727:11;130703:23;:36::i;:::-;130658:81;130651:88;;130532:215;;;:::o;111667:276::-;111770:4;111826:1;111807:21;;:7;:21;;;;:128;;;;;111855:7;111846:16;;:5;:16;;;:52;;;;111866:32;111883:5;111890:7;111866:16;:32::i;:::-;111846:52;:88;;;;111927:7;111902:32;;:21;111915:7;111902:12;:21::i;:::-;:32;;;111846:88;111807:128;111787:148;;111667:276;;;;;:::o;105281:148::-;105357:4;105396:25;105381:40;;;:11;:40;;;;105374:47;;105281:148;;;:::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:60::-;5270:3;5291:5;5284:12;;5242:60;;;:::o;5308:142::-;5358:9;5391:53;5409:34;5418:24;5436:5;5418:24;:::i;:::-;5409:34;:::i;:::-;5391:53;:::i;:::-;5378:66;;5308:142;;;:::o;5456:126::-;5506:9;5539:37;5570:5;5539:37;:::i;:::-;5526:50;;5456:126;;;:::o;5588:153::-;5665:9;5698:37;5729:5;5698:37;:::i;:::-;5685:50;;5588:153;;;:::o;5747:185::-;5861:64;5919:5;5861:64;:::i;:::-;5856:3;5849:77;5747:185;;:::o;5938:276::-;6058:4;6096:2;6085:9;6081:18;6073:26;;6109:98;6204:1;6193:9;6189:17;6180:6;6109:98;:::i;:::-;5938:276;;;;:::o;6220:619::-;6297:6;6305;6313;6362:2;6350:9;6341:7;6337:23;6333:32;6330:119;;;6368:79;;:::i;:::-;6330:119;6488:1;6513:53;6558:7;6549:6;6538:9;6534:22;6513:53;:::i;:::-;6503:63;;6459:117;6615:2;6641:53;6686:7;6677:6;6666:9;6662:22;6641:53;:::i;:::-;6631:63;;6586:118;6743:2;6769:53;6814:7;6805:6;6794:9;6790:22;6769:53;:::i;:::-;6759:63;;6714:118;6220:619;;;;;:::o;6845:474::-;6913:6;6921;6970:2;6958:9;6949:7;6945:23;6941:32;6938:119;;;6976:79;;:::i;:::-;6938:119;7096:1;7121:53;7166:7;7157:6;7146:9;7142:22;7121:53;:::i;:::-;7111:63;;7067:117;7223:2;7249:53;7294:7;7285:6;7274:9;7270:22;7249:53;:::i;:::-;7239:63;;7194:118;6845:474;;;;;:::o;7325:332::-;7446:4;7484:2;7473:9;7469:18;7461:26;;7497:71;7565:1;7554:9;7550:17;7541:6;7497:71;:::i;:::-;7578:72;7646:2;7635:9;7631:18;7622:6;7578:72;:::i;:::-;7325:332;;;;;:::o;7663:77::-;7700:7;7729:5;7718:16;;7663:77;;;:::o;7746:122::-;7819:24;7837:5;7819:24;:::i;:::-;7812:5;7809:35;7799:63;;7858:1;7855;7848:12;7799:63;7746:122;:::o;7874:139::-;7920:5;7958:6;7945:20;7936:29;;7974:33;8001:5;7974:33;:::i;:::-;7874:139;;;;:::o;8019:329::-;8078:6;8127:2;8115:9;8106:7;8102:23;8098:32;8095:119;;;8133:79;;:::i;:::-;8095:119;8253:1;8278:53;8323:7;8314:6;8303:9;8299:22;8278:53;:::i;:::-;8268:63;;8224:117;8019:329;;;;:::o;8354:::-;8413:6;8462:2;8450:9;8441:7;8437:23;8433:32;8430:119;;;8468:79;;:::i;:::-;8430:119;8588:1;8613:53;8658:7;8649:6;8638:9;8634:22;8613:53;:::i;:::-;8603:63;;8559:117;8354:329;;;;:::o;8689:116::-;8759:21;8774:5;8759:21;:::i;:::-;8752:5;8749:32;8739:60;;8795:1;8792;8785:12;8739:60;8689:116;:::o;8811:133::-;8854:5;8892:6;8879:20;8870:29;;8908:30;8932:5;8908:30;:::i;:::-;8811:133;;;;:::o;8950:468::-;9015:6;9023;9072:2;9060:9;9051:7;9047:23;9043:32;9040:119;;;9078:79;;:::i;:::-;9040:119;9198:1;9223:53;9268:7;9259:6;9248:9;9244:22;9223:53;:::i;:::-;9213:63;;9169:117;9325:2;9351:50;9393:7;9384:6;9373:9;9369:22;9351:50;:::i;:::-;9341:60;;9296:115;8950:468;;;;;:::o;9424:117::-;9533:1;9530;9523:12;9547:117;9656:1;9653;9646:12;9670:180;9718:77;9715:1;9708:88;9815:4;9812:1;9805:15;9839:4;9836:1;9829:15;9856:281;9939:27;9961:4;9939:27;:::i;:::-;9931:6;9927:40;10069:6;10057:10;10054:22;10033:18;10021:10;10018:34;10015:62;10012:88;;;10080:18;;:::i;:::-;10012:88;10120:10;10116:2;10109:22;9899:238;9856:281;;:::o;10143:129::-;10177:6;10204:20;;:::i;:::-;10194:30;;10233:33;10261:4;10253:6;10233:33;:::i;:::-;10143:129;;;:::o;10278:307::-;10339:4;10429:18;10421:6;10418:30;10415:56;;;10451:18;;:::i;:::-;10415:56;10489:29;10511:6;10489:29;:::i;:::-;10481:37;;10573:4;10567;10563:15;10555:23;;10278:307;;;:::o;10591:146::-;10688:6;10683:3;10678;10665:30;10729:1;10720:6;10715:3;10711:16;10704:27;10591:146;;;:::o;10743:423::-;10820:5;10845:65;10861:48;10902:6;10861:48;:::i;:::-;10845:65;:::i;:::-;10836:74;;10933:6;10926:5;10919:21;10971:4;10964:5;10960:16;11009:3;11000:6;10995:3;10991:16;10988:25;10985:112;;;11016:79;;:::i;:::-;10985:112;11106:54;11153:6;11148:3;11143;11106:54;:::i;:::-;10826:340;10743:423;;;;;:::o;11185:338::-;11240:5;11289:3;11282:4;11274:6;11270:17;11266:27;11256:122;;11297:79;;:::i;:::-;11256:122;11414:6;11401:20;11439:78;11513:3;11505:6;11498:4;11490:6;11486:17;11439:78;:::i;:::-;11430:87;;11246:277;11185:338;;;;:::o;11529:943::-;11624:6;11632;11640;11648;11697:3;11685:9;11676:7;11672:23;11668:33;11665:120;;;11704:79;;:::i;:::-;11665:120;11824:1;11849:53;11894:7;11885:6;11874:9;11870:22;11849:53;:::i;:::-;11839:63;;11795:117;11951:2;11977:53;12022:7;12013:6;12002:9;11998:22;11977:53;:::i;:::-;11967:63;;11922:118;12079:2;12105:53;12150:7;12141:6;12130:9;12126:22;12105:53;:::i;:::-;12095:63;;12050:118;12235:2;12224:9;12220:18;12207:32;12266:18;12258:6;12255:30;12252:117;;;12288:79;;:::i;:::-;12252:117;12393:62;12447:7;12438:6;12427:9;12423:22;12393:62;:::i;:::-;12383:72;;12178:287;11529:943;;;;;;;:::o;12478:114::-;12545:6;12579:5;12573:12;12563:22;;12478:114;;;:::o;12598:184::-;12697:11;12731:6;12726:3;12719:19;12771:4;12766:3;12762:14;12747:29;;12598:184;;;;:::o;12788:132::-;12855:4;12878:3;12870:11;;12908:4;12903:3;12899:14;12891:22;;12788:132;;;:::o;12926:108::-;13003:24;13021:5;13003:24;:::i;:::-;12998:3;12991:37;12926:108;;:::o;13040:179::-;13109:10;13130:46;13172:3;13164:6;13130:46;:::i;:::-;13208:4;13203:3;13199:14;13185:28;;13040:179;;;;:::o;13225:113::-;13295:4;13327;13322:3;13318:14;13310:22;;13225:113;;;:::o;13374:732::-;13493:3;13522:54;13570:5;13522:54;:::i;:::-;13592:86;13671:6;13666:3;13592:86;:::i;:::-;13585:93;;13702:56;13752:5;13702:56;:::i;:::-;13781:7;13812:1;13797:284;13822:6;13819:1;13816:13;13797:284;;;13898:6;13892:13;13925:63;13984:3;13969:13;13925:63;:::i;:::-;13918:70;;14011:60;14064:6;14011:60;:::i;:::-;14001:70;;13857:224;13844:1;13841;13837:9;13832:14;;13797:284;;;13801:14;14097:3;14090:10;;13498:608;;;13374:732;;;;:::o;14112:373::-;14255:4;14293:2;14282:9;14278:18;14270:26;;14342:9;14336:4;14332:20;14328:1;14317:9;14313:17;14306:47;14370:108;14473:4;14464:6;14370:108;:::i;:::-;14362:116;;14112:373;;;;:::o;14491:442::-;14640:4;14678:2;14667:9;14663:18;14655:26;;14691:71;14759:1;14748:9;14744:17;14735:6;14691:71;:::i;:::-;14772:72;14840:2;14829:9;14825:18;14816:6;14772:72;:::i;:::-;14854;14922:2;14911:9;14907:18;14898:6;14854:72;:::i;:::-;14491:442;;;;;;:::o;14939:474::-;15007:6;15015;15064:2;15052:9;15043:7;15039:23;15035:32;15032:119;;;15070:79;;:::i;:::-;15032:119;15190:1;15215:53;15260:7;15251:6;15240:9;15236:22;15215:53;:::i;:::-;15205:63;;15161:117;15317:2;15343:53;15388:7;15379:6;15368:9;15364:22;15343:53;:::i;:::-;15333:63;;15288:118;14939:474;;;;;:::o;15419:180::-;15467:77;15464:1;15457:88;15564:4;15561:1;15554:15;15588:4;15585:1;15578:15;15605:320;15649:6;15686:1;15680:4;15676:12;15666:22;;15733:1;15727:4;15723:12;15754:18;15744:81;;15810:4;15802:6;15798:17;15788:27;;15744:81;15872:2;15864:6;15861:14;15841:18;15838:38;15835:84;;15891:18;;:::i;:::-;15835:84;15656:269;15605:320;;;:::o;15931:442::-;16080:4;16118:2;16107:9;16103:18;16095:26;;16131:71;16199:1;16188:9;16184:17;16175:6;16131:71;:::i;:::-;16212:72;16280:2;16269:9;16265:18;16256:6;16212:72;:::i;:::-;16294;16362:2;16351:9;16347:18;16338:6;16294:72;:::i;:::-;15931:442;;;;;;:::o;16379:180::-;16427:77;16424:1;16417:88;16524:4;16521:1;16514:15;16548:4;16545:1;16538:15;16565:410;16605:7;16628:20;16646:1;16628:20;:::i;:::-;16623:25;;16662:20;16680:1;16662:20;:::i;:::-;16657:25;;16717:1;16714;16710:9;16739:30;16757:11;16739:30;:::i;:::-;16728:41;;16918:1;16909:7;16905:15;16902:1;16899:22;16879:1;16872:9;16852:83;16829:139;;16948:18;;:::i;:::-;16829:139;16613:362;16565:410;;;;:::o;16981:180::-;17029:77;17026:1;17019:88;17126:4;17123:1;17116:15;17150:4;17147:1;17140:15;17167:185;17207:1;17224:20;17242:1;17224:20;:::i;:::-;17219:25;;17258:20;17276:1;17258:20;:::i;:::-;17253:25;;17297:1;17287:35;;17302:18;;:::i;:::-;17287:35;17344:1;17341;17337:9;17332:14;;17167:185;;;;:::o;17358:148::-;17460:11;17497:3;17482:18;;17358:148;;;;:::o;17512:214::-;17652:66;17648:1;17640:6;17636:14;17629:90;17512:214;:::o;17732:402::-;17892:3;17913:85;17995:2;17990:3;17913:85;:::i;:::-;17906:92;;18007:93;18096:3;18007:93;:::i;:::-;18125:2;18120:3;18116:12;18109:19;;17732:402;;;:::o;18140:390::-;18246:3;18274:39;18307:5;18274:39;:::i;:::-;18329:89;18411:6;18406:3;18329:89;:::i;:::-;18322:96;;18427:65;18485:6;18480:3;18473:4;18466:5;18462:16;18427:65;:::i;:::-;18517:6;18512:3;18508:16;18501:23;;18250:280;18140:390;;;;:::o;18536:214::-;18676:66;18672:1;18664:6;18660:14;18653:90;18536:214;:::o;18756:400::-;18916:3;18937:84;19019:1;19014:3;18937:84;:::i;:::-;18930:91;;19030:93;19119:3;19030:93;:::i;:::-;19148:1;19143:3;19139:11;19132:18;;18756:400;;;:::o;19162:384::-;19302:66;19298:1;19290:6;19286:14;19279:90;19403:34;19398:2;19390:6;19386:15;19379:59;19472:66;19467:2;19459:6;19455:15;19448:91;19162:384;:::o;19552:402::-;19712:3;19733:85;19815:2;19810:3;19733:85;:::i;:::-;19726:92;;19827:93;19916:3;19827:93;:::i;:::-;19945:2;19940:3;19936:12;19929:19;;19552:402;;;:::o;19960:254::-;20100:66;20096:1;20088:6;20084:14;20077:90;20201:5;20196:2;20188:6;20184:15;20177:30;19960:254;:::o;20220:402::-;20380:3;20401:85;20483:2;20478:3;20401:85;:::i;:::-;20394:92;;20495:93;20584:3;20495:93;:::i;:::-;20613:2;20608:3;20604:12;20597:19;;20220:402;;;:::o;20628:214::-;20768:66;20764:1;20756:6;20752:14;20745:90;20628:214;:::o;20848:402::-;21008:3;21029:85;21111:2;21106:3;21029:85;:::i;:::-;21022:92;;21123:93;21212:3;21123:93;:::i;:::-;21241:2;21236:3;21232:12;21225:19;;20848:402;;;:::o;21256:144::-;21392:4;21388:1;21380:6;21376:14;21369:28;21256:144;:::o;21402:384::-;21562:3;21579:84;21661:1;21656:3;21579:84;:::i;:::-;21572:91;;21668:93;21757:3;21668:93;:::i;:::-;21782:1;21777:3;21773:11;21766:18;;21402:384;;;:::o;21788:2409::-;22723:3;22741:148;22885:3;22741:148;:::i;:::-;22734:155;;22902:95;22993:3;22984:6;22902:95;:::i;:::-;22895:102;;23010:148;23154:3;23010:148;:::i;:::-;23003:155;;23171:148;23315:3;23171:148;:::i;:::-;23164:155;;23332:148;23476:3;23332:148;:::i;:::-;23325:155;;23493:95;23584:3;23575:6;23493:95;:::i;:::-;23486:102;;23601:148;23745:3;23601:148;:::i;:::-;23594:155;;23762:148;23906:3;23762:148;:::i;:::-;23755:155;;23923:95;24014:3;24005:6;23923:95;:::i;:::-;23916:102;;24031:148;24175:3;24031:148;:::i;:::-;24024:155;;24192:3;24185:10;;21788:2409;;;;;;:::o;24199:171::-;24335:31;24331:1;24323:6;24319:14;24312:55;24199:171;:::o;24372:386::-;24532:3;24549:85;24631:2;24626:3;24549:85;:::i;:::-;24542:92;;24639:93;24728:3;24639:93;:::i;:::-;24753:2;24748:3;24744:12;24737:19;;24372:386;;;:::o;24760:525::-;24993:3;25011:148;25155:3;25011:148;:::i;:::-;25004:155;;25172:95;25263:3;25254:6;25172:95;:::i;:::-;25165:102;;25280:3;25273:10;;24760:525;;;;:::o;25287:209::-;25423:34;25419:1;25411:6;25407:14;25400:58;25488:4;25483:2;25475:6;25471:15;25464:29;25287:209;:::o;25498:350::-;25640:3;25657:67;25721:2;25716:3;25657:67;:::i;:::-;25650:74;;25729:93;25818:3;25729:93;:::i;:::-;25843:2;25838:3;25834:12;25827:19;;25498:350;;;:::o;25850:403::-;26016:4;26050:2;26039:9;26035:18;26027:26;;26095:9;26089:4;26085:20;26081:1;26070:9;26066:17;26059:47;26119:131;26245:4;26119:131;:::i;:::-;26111:139;;25850:403;;;:::o;26255:171::-;26295:3;26310:20;26328:1;26310:20;:::i;:::-;26305:25;;26340:20;26358:1;26340:20;:::i;:::-;26335:25;;26379:1;26376;26372:9;26365:16;;26396:3;26393:1;26390:10;26387:36;;;26403:18;;:::i;:::-;26387:36;26255:171;;;;:::o;26428:209::-;26564:34;26560:1;26552:6;26548:14;26541:58;26629:4;26624:2;26616:6;26612:15;26605:29;26428:209;:::o;26639:350::-;26781:3;26798:67;26862:2;26857:3;26798:67;:::i;:::-;26791:74;;26870:93;26959:3;26870:93;:::i;:::-;26984:2;26979:3;26975:12;26968:19;;26639:350;;;:::o;26991:403::-;27157:4;27191:2;27180:9;27176:18;27168:26;;27236:9;27230:4;27226:20;27222:1;27211:9;27207:17;27200:47;27260:131;27386:4;27260:131;:::i;:::-;27252:139;;26991:403;;;:::o;27396:217::-;27435:3;27454:24;27472:5;27454:24;:::i;:::-;27445:33;;27496:66;27489:5;27486:77;27483:103;;27566:18;;:::i;:::-;27483:103;27609:1;27602:5;27598:13;27591:20;;27396:217;;;:::o;27615:174::-;27655:4;27671:20;27689:1;27671:20;:::i;:::-;27666:25;;27701:20;27719:1;27701:20;:::i;:::-;27696:25;;27741:1;27738;27734:9;27726:17;;27761:1;27755:4;27752:11;27749:37;;;27766:18;;:::i;:::-;27749:37;27615:174;;;;:::o;27791:71::-;27830:7;27855:5;27844:16;;27791:71;;;:::o;27864:149::-;27965:45;27985:24;28003:5;27985:24;:::i;:::-;27965:45;:::i;:::-;27960:3;27953:58;27864:149;;:::o;28015:82::-;28048:8;28088:5;28084:2;28080:14;28063:31;;28015:82;;;:::o;28099:86::-;28138:7;28163:20;28177:5;28163:20;:::i;:::-;28152:31;;28099:86;;;:::o;28187:92::-;28226:7;28251:26;28271:5;28251:26;:::i;:::-;28240:37;;28187:92;;;:::o;28281:149::-;28382:45;28402:24;28420:5;28402:24;:::i;:::-;28382:45;:::i;:::-;28377:3;28370:58;28281:149;;:::o;28432:71::-;28471:7;28496:5;28485:16;;28432:71;;;:::o;28505:149::-;28606:45;28626:24;28644:5;28626:24;:::i;:::-;28606:45;:::i;:::-;28601:3;28594:58;28505:149;;:::o;28656:639::-;28852:3;28863:75;28934:3;28925:6;28863:75;:::i;:::-;28959:2;28954:3;28950:12;28943:19;;28968:75;29039:3;29030:6;28968:75;:::i;:::-;29064:2;29059:3;29055:12;29048:19;;29073:75;29144:3;29135:6;29073:75;:::i;:::-;29169:2;29164:3;29160:12;29153:19;;29178:75;29249:3;29240:6;29178:75;:::i;:::-;29274:2;29269:3;29265:12;29258:19;;29290:3;29283:10;;28656:639;;;;;;;:::o;29297:146::-;29433:6;29429:1;29421:6;29417:14;29410:30;29297:146;:::o;29445:384::-;29605:3;29622:84;29704:1;29699:3;29622:84;:::i;:::-;29615:91;;29711:93;29800:3;29711:93;:::i;:::-;29825:1;29820:3;29816:11;29809:18;;29445:384;;;:::o;29831:502::-;30044:3;30055:75;30126:3;30117:6;30055:75;:::i;:::-;30151:2;30146:3;30142:12;30135:19;;30167:148;30311:3;30167:148;:::i;:::-;30160:155;;30328:3;30321:10;;29831:502;;;;:::o;30335:147::-;30471:7;30467:1;30459:6;30455:14;30448:31;30335:147;:::o;30484:384::-;30644:3;30661:84;30743:1;30738:3;30661:84;:::i;:::-;30654:91;;30750:93;30839:3;30750:93;:::i;:::-;30864:1;30859:3;30855:11;30848:18;;30484:384;;;:::o;30870:502::-;31083:3;31094:75;31165:3;31156:6;31094:75;:::i;:::-;31190:2;31185:3;31181:12;31174:19;;31206:148;31350:3;31206:148;:::i;:::-;31199:155;;31367:3;31360:10;;30870:502;;;;:::o;31374:148::-;31510:8;31506:1;31498:6;31494:14;31487:32;31374:148;:::o;31524:384::-;31684:3;31701:84;31783:1;31778:3;31701:84;:::i;:::-;31694:91;;31790:93;31879:3;31790:93;:::i;:::-;31904:1;31899:3;31895:11;31888:18;;31524:384;;;:::o;31910:502::-;32123:3;32134:75;32205:3;32196:6;32134:75;:::i;:::-;32230:2;32225:3;32221:12;32214:19;;32246:148;32390:3;32246:148;:::i;:::-;32239:155;;32407:3;32400:10;;31910:502;;;;:::o;32414:156::-;32446:1;32459:20;32477:1;32459:20;:::i;:::-;32454:25;;32489:20;32507:1;32489:20;:::i;:::-;32484:25;;32524:1;32514:35;;32529:18;;:::i;:::-;32514:35;32566:1;32563;32559:9;32554:14;;32414:156;;;;:::o;32572:506::-;32740:3;32751:75;32822:3;32813:6;32751:75;:::i;:::-;32847:2;32842:3;32838:12;32831:19;;32856:75;32927:3;32918:6;32856:75;:::i;:::-;32952:2;32947:3;32943:12;32936:19;;32961:75;33032:3;33023:6;32961:75;:::i;:::-;33057:2;33052:3;33048:12;33041:19;;33073:3;33066:10;;32572:506;;;;;;:::o;33080:220::-;33216:34;33212:1;33204:6;33200:14;33193:58;33281:15;33276:2;33268:6;33264:15;33257:40;33080:220;:::o;33302:350::-;33444:3;33461:67;33525:2;33520:3;33461:67;:::i;:::-;33454:74;;33533:93;33622:3;33533:93;:::i;:::-;33647:2;33642:3;33638:12;33631:19;;33302:350;;;:::o;33654:403::-;33820:4;33854:2;33843:9;33839:18;33831:26;;33899:9;33893:4;33889:20;33885:1;33874:9;33870:17;33863:47;33923:131;34049:4;33923:131;:::i;:::-;33915:139;;33654:403;;;:::o;34059:164::-;34103:77;34100:1;34093:88;34196:4;34193:1;34186:15;34216:4;34213:1;34206:15;34225:160;34361:20;34357:1;34349:6;34345:14;34338:44;34225:160;:::o;34387:350::-;34529:3;34546:67;34610:2;34605:3;34546:67;:::i;:::-;34539:74;;34618:93;34707:3;34618:93;:::i;:::-;34732:2;34727:3;34723:12;34716:19;;34387:350;;;:::o;34739:403::-;34905:4;34939:2;34928:9;34924:18;34916:26;;34984:9;34978:4;34974:20;34970:1;34959:9;34955:17;34948:47;35008:131;35134:4;35008:131;:::i;:::-;35000:139;;34739:403;;;:::o;35144:160::-;35280:20;35276:1;35268:6;35264:14;35257:44;35144:160;:::o;35306:350::-;35448:3;35465:67;35529:2;35524:3;35465:67;:::i;:::-;35458:74;;35537:93;35626:3;35537:93;:::i;:::-;35651:2;35646:3;35642:12;35635:19;;35306:350;;;:::o;35658:403::-;35824:4;35858:2;35847:9;35843:18;35835:26;;35903:9;35897:4;35893:20;35889:1;35878:9;35874:17;35867:47;35927:131;36053:4;35927:131;:::i;:::-;35919:139;;35658:403;;;:::o;36063:131::-;36120:5;36147:6;36141:13;36132:22;;36159:33;36186:5;36159:33;:::i;:::-;36063:131;;;;:::o;36196:327::-;36266:6;36311:2;36299:9;36290:7;36286:23;36282:32;36279:119;;;36317:79;;:::i;:::-;36279:119;36429:1;36450:64;36506:7;36497:6;36486:9;36482:22;36450:64;:::i;:::-;36440:74;;36404:116;36196:327;;;;:::o;36525:163::-;36661:23;36657:1;36649:6;36645:14;36638:47;36525:163;:::o;36690:350::-;36832:3;36849:67;36913:2;36908:3;36849:67;:::i;:::-;36842:74;;36921:93;37010:3;36921:93;:::i;:::-;37035:2;37030:3;37026:12;37019:19;;36690:350;;;:::o;37042:403::-;37208:4;37242:2;37231:9;37227:18;37219:26;;37287:9;37281:4;37277:20;37273:1;37262:9;37258:17;37251:47;37311:131;37437:4;37311:131;:::i;:::-;37303:139;;37042:403;;;:::o;37447:125::-;37501:5;37528:6;37522:13;37513:22;;37540:30;37564:5;37540:30;:::i;:::-;37447:125;;;;:::o;37574:321::-;37641:6;37686:2;37674:9;37665:7;37661:23;37657:32;37654:119;;;37692:79;;:::i;:::-;37654:119;37804:1;37825:61;37878:7;37869:6;37858:9;37854:22;37825:61;:::i;:::-;37815:71;;37779:113;37574:321;;;;:::o;37897:90::-;37948:6;37978:5;37972:12;37962:22;;37897:90;;;:::o;37989:156::-;38072:11;38102:6;38097:3;38090:19;38138:4;38133:3;38129:14;38114:29;;37989:156;;;;:::o;38147:353::-;38233:3;38257:38;38289:5;38257:38;:::i;:::-;38307:70;38370:6;38365:3;38307:70;:::i;:::-;38300:77;;38382:65;38440:6;38435:3;38428:4;38421:5;38417:16;38382:65;:::i;:::-;38468:29;38490:6;38468:29;:::i;:::-;38463:3;38459:39;38452:46;;38237:263;38147:353;;;;:::o;38502:612::-;38697:4;38731:3;38720:9;38716:19;38708:27;;38741:71;38809:1;38798:9;38794:17;38785:6;38741:71;:::i;:::-;38818:72;38886:2;38875:9;38871:18;38862:6;38818:72;:::i;:::-;38896;38964:2;38953:9;38949:18;38940:6;38896:72;:::i;:::-;39011:9;39005:4;39001:20;38996:2;38985:9;38981:18;38974:48;39035:76;39106:4;39097:6;39035:76;:::i;:::-;39027:84;;38502:612;;;;;;;:::o;39116:129::-;39172:5;39199:6;39193:13;39184:22;;39211:32;39237:5;39211:32;:::i;:::-;39116:129;;;;:::o;39247:325::-;39316:6;39361:2;39349:9;39340:7;39336:23;39332:32;39329:119;;;39367:79;;:::i;:::-;39329:119;39479:1;39500:63;39555:7;39546:6;39535:9;39531:22;39500:63;:::i;:::-;39490:73;;39454:115;39247:325;;;;:::o;39574:77::-;39619:7;39644:5;39633:16;;39574:77;;;:::o;39653:78::-;39688:7;39724:4;39717:5;39713:16;39702:27;;39653:78;;;:::o;39733:146::-;39789:9;39818:59;39834:42;39843:32;39869:5;39843:32;:::i;:::-;39834:42;:::i;:::-;39818:59;:::i;:::-;39805:72;;39733:146;;;:::o;39881:135::-;39970:43;40007:5;39970:43;:::i;:::-;39965:3;39958:56;39881:135;;:::o;40018:328::-;40145:4;40179:2;40168:9;40164:18;40156:26;;40188:77;40262:1;40251:9;40247:17;40238:6;40188:77;:::i;:::-;40271:72;40339:2;40328:9;40324:18;40315:6;40271:72;:::i;:::-;40018:328;;;;;:::o;40348:284::-;40410:4;40492:18;40484:6;40481:30;40478:56;;;40514:18;;:::i;:::-;40478:56;40548:29;40570:6;40548:29;:::i;:::-;40540:37;;40624:4;40618;40614:15;40606:23;;40348:284;;;:::o;40634:410::-;40723:5;40744:66;40760:49;40802:6;40760:49;:::i;:::-;40744:66;:::i;:::-;40735:75;;40829:6;40822:5;40815:21;40863:4;40856:5;40852:16;40897:3;40888:6;40883:3;40879:16;40876:25;40873:112;;;40904:79;;:::i;:::-;40873:112;40990:52;41035:6;41030:3;41025;40990:52;:::i;:::-;40729:315;40634:410;;;;;:::o;41056:339::-;41123:5;41168:3;41161:4;41153:6;41149:17;41145:27;41135:122;;41176:79;;:::i;:::-;41135:122;41282:6;41276:13;41303:90;41389:3;41381:6;41374:4;41366:6;41362:17;41303:90;:::i;:::-;41294:99;;41129:266;41056:339;;;;:::o;41397:496::-;41477:6;41522:2;41510:9;41501:7;41497:23;41493:32;41490:119;;;41528:79;;:::i;:::-;41490:119;41661:1;41650:9;41646:17;41640:24;41687:18;41679:6;41676:30;41673:117;;;41709:79;;:::i;:::-;41673:117;41810:74;41876:7;41867:6;41856:9;41852:22;41810:74;:::i;:::-;41800:84;;41615:275;41397:496;;;;:::o;41895:77::-;41940:7;41965:5;41954:16;;41895:77;;;:::o;41974:146::-;42030:9;42059:59;42075:42;42084:32;42110:5;42084:32;:::i;:::-;42075:42;:::i;:::-;42059:59;:::i;:::-;42046:72;;41974:146;;;:::o;42122:135::-;42211:43;42248:5;42211:43;:::i;:::-;42206:3;42199:56;42122:135;;:::o;42259:328::-;42386:4;42420:2;42409:9;42405:18;42397:26;;42429:77;42503:1;42492:9;42488:17;42479:6;42429:77;:::i;:::-;42512:72;42580:2;42569:9;42565:18;42556:6;42512:72;:::i;:::-;42259:328;;;;;:::o;42589:77::-;42634:7;42659:5;42648:16;;42589:77;;;:::o;42668:146::-;42724:9;42753:59;42769:42;42778:32;42804:5;42778:32;:::i;:::-;42769:42;:::i;:::-;42753:59;:::i;:::-;42740:72;;42668:146;;;:::o;42816:135::-;42905:43;42942:5;42905:43;:::i;:::-;42900:3;42893:56;42816:135;;:::o;42953:328::-;43080:4;43114:2;43103:9;43099:18;43091:26;;43123:77;43197:1;43186:9;43182:17;43173:6;43123:77;:::i;:::-;43206:72;43274:2;43263:9;43259:18;43250:6;43206:72;:::i;:::-;42953:328;;;;;:::o;43283:77::-;43328:7;43353:5;43342:16;;43283:77;;;:::o;43362:146::-;43418:9;43447:59;43463:42;43472:32;43498:5;43472:32;:::i;:::-;43463:42;:::i;:::-;43447:59;:::i;:::-;43434:72;;43362:146;;;:::o;43510:135::-;43599:43;43636:5;43599:43;:::i;:::-;43594:3;43587:56;43510:135;;:::o;43647:328::-;43774:4;43808:2;43797:9;43793:18;43785:26;;43817:77;43891:1;43880:9;43876:17;43867:6;43817:77;:::i;:::-;43900:72;43968:2;43957:9;43953:18;43944:6;43900:72;:::i;:::-;43647:328;;;;;:::o;43977:400::-;44113:66;44109:1;44101:6;44097:14;44090:90;44210:66;44205:2;44197:6;44193:15;44186:91;44307:66;44302:2;44294:6;44290:15;44283:91;43977:400;:::o;44379:386::-;44539:3;44556:85;44638:2;44633:3;44556:85;:::i;:::-;44549:92;;44646:93;44735:3;44646:93;:::i;:::-;44760:2;44755:3;44751:12;44744:19;;44379:386;;;:::o;44767:148::-;44903:8;44899:1;44891:6;44887:14;44880:32;44767:148;:::o;44917:384::-;45077:3;45094:84;45176:1;45171:3;45094:84;:::i;:::-;45087:91;;45183:93;45272:3;45183:93;:::i;:::-;45297:1;45292:3;45288:11;45281:18;;44917:384;;;:::o;45303:1255::-;45781:3;45799:148;45943:3;45799:148;:::i;:::-;45792:155;;45960:95;46051:3;46042:6;45960:95;:::i;:::-;45953:102;;46068:95;46159:3;46150:6;46068:95;:::i;:::-;46061:102;;46176:95;46267:3;46258:6;46176:95;:::i;:::-;46169:102;;46284:95;46375:3;46366:6;46284:95;:::i;:::-;46277:102;;46392:148;46536:3;46392:148;:::i;:::-;46385:155;;46553:3;46546:10;;45303:1255;;;;;;;:::o;46560:143::-;46696:3;46692:1;46684:6;46680:14;46673:27;46560:143;:::o;46705:384::-;46865:3;46882:84;46964:1;46959:3;46882:84;:::i;:::-;46875:91;;46971:93;47060:3;46971:93;:::i;:::-;47085:1;47080:3;47076:11;47069:18;;46705:384;;;:::o;47091:681::-;47372:3;47390:95;47481:3;47472:6;47390:95;:::i;:::-;47383:102;;47498:148;47642:3;47498:148;:::i;:::-;47491:155;;47659:95;47750:3;47741:6;47659:95;:::i;:::-;47652:102;;47767:3;47760:10;;47091:681;;;;;:::o;47774:155::-;47813:3;47832:24;47850:5;47832:24;:::i;:::-;47823:33;;47874:4;47867:5;47864:15;47861:41;;47882:18;;:::i;:::-;47861:41;47925:1;47918:5;47914:13;47907:20;;47774:155;;;:::o
Swarm Source
ipfs://34fb87717819fe715bfbac2526fb8d71a865322b43948ceef4940de0a0b54a5d
Loading...
Loading
Loading...
Loading
Multichain Portfolio | 35 Chains
| Chain | Token | Portfolio % | Price | Amount | Value |
|---|
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
A contract address hosts a smart contract, which is a set of code stored on the blockchain that runs when predetermined conditions are met. Learn more about addresses in our Knowledge Base.