Source Code
Overview
ETH Balance
0 ETH
More Info
ContractCreator
TokenTracker
Multichain Info
N/A
Latest 17 internal transactions
Parent Transaction Hash | Block | From | To | |||
---|---|---|---|---|---|---|
4853978 | 11 hrs ago | 0 ETH | ||||
4853978 | 11 hrs ago | 0 ETH | ||||
4853978 | 11 hrs ago | 0 ETH | ||||
4853978 | 11 hrs ago | 0 ETH | ||||
4853978 | 11 hrs ago | 0 ETH | ||||
4853978 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853925 | 11 hrs ago | 0 ETH | ||||
4853776 | 11 hrs ago | 0 ETH | ||||
4853776 | 11 hrs ago | 0 ETH | ||||
4853776 | 11 hrs ago | 0 ETH | ||||
4853586 | 11 hrs ago | 0 ETH | ||||
4853586 | 11 hrs ago | Contract Creation | 0 ETH |
Loading...
Loading
This contract may be a proxy contract. Click on More Options and select Is this a proxy? to confirm and enable the "Read as Proxy" & "Write as Proxy" tabs.
Contract Source Code Verified (Exact Match)
Contract Name:
Token
Compiler Version
v0.8.28+commit.7893614a
ZkSolc Version
v1.5.7
Optimization Enabled:
Yes with Mode 3
Other Settings:
paris EvmVersion
Contract Source Code (Solidity Standard Json-Input format)
// SPDX-License-Identifier: MIT pragma solidity ^0.8.22; import {ERC1155} from "@openzeppelin/contracts/token/ERC1155/ERC1155.sol"; import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol"; contract Token is ERC1155, Ownable { mapping(uint256 => string) private _tokenURIs; // URIs for token IDs mapping(uint256 => uint256) private _totalSupply; // Total supply for each token ID constructor(address initialOwner) ERC1155("") Ownable(initialOwner) {} function uri(uint256 id) public view override returns (string memory) { string memory tokenURI = _tokenURIs[id]; require(bytes(tokenURI).length > 0, "URI not set for this token ID"); return tokenURI; } function setTokenURI(uint256 id, string memory newuri) public onlyOwner { _tokenURIs[id] = newuri; } function mint( address account, uint256 id, uint256 amount, bytes memory data ) public onlyOwner { _mint(account, id, amount, data); _totalSupply[id] += amount; // Update total supply } function mintBatch( address to, uint256[] memory ids, uint256[] memory amounts, bytes memory data ) public onlyOwner { for (uint256 i = 0; i < ids.length; i++) { _totalSupply[ids[i]] += amounts[i]; // Update total supply for each token ID } _mintBatch(to, ids, amounts, data); } function totalSupply(uint256 id) public view returns (uint256) { return _totalSupply[id]; } function burn( address account, uint256 id, uint256 amount ) public onlyOwner { require(_totalSupply[id] >= amount, "Burn exceeds total supply"); _burn(account, id, amount); _totalSupply[id] -= amount; // Update total supply } function burnBatch( address account, uint256[] memory ids, uint256[] memory amounts ) public onlyOwner { for (uint256 i = 0; i < ids.length; i++) { require(_totalSupply[ids[i]] >= amounts[i], "Burn exceeds total supply"); _totalSupply[ids[i]] -= amounts[i]; // Update total supply for each token ID } _burnBatch(account, ids, amounts); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/ERC1155.sol) pragma solidity ^0.8.20; import {IERC1155} from "./IERC1155.sol"; import {IERC1155MetadataURI} from "./extensions/IERC1155MetadataURI.sol"; import {ERC1155Utils} from "./utils/ERC1155Utils.sol"; import {Context} from "../../utils/Context.sol"; import {IERC165, ERC165} from "../../utils/introspection/ERC165.sol"; import {Arrays} from "../../utils/Arrays.sol"; import {IERC1155Errors} from "../../interfaces/draft-IERC6093.sol"; /** * @dev Implementation of the basic standard multi-token. * See https://eips.ethereum.org/EIPS/eip-1155 * Originally based on code by Enjin: https://github.com/enjin/erc-1155 */ abstract contract ERC1155 is Context, ERC165, IERC1155, IERC1155MetadataURI, IERC1155Errors { using Arrays for uint256[]; using Arrays for address[]; mapping(uint256 id => mapping(address account => uint256)) private _balances; mapping(address account => mapping(address operator => bool)) private _operatorApprovals; // Used as the URI for all token types by relying on ID substitution, e.g. https://token-cdn-domain/{id}.json string private _uri; /** * @dev See {_setURI}. */ constructor(string memory uri_) { _setURI(uri_); } /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) { return interfaceId == type(IERC1155).interfaceId || interfaceId == type(IERC1155MetadataURI).interfaceId || super.supportsInterface(interfaceId); } /** * @dev See {IERC1155MetadataURI-uri}. * * This implementation returns the same URI for *all* token types. It relies * on the token type ID substitution mechanism * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the ERC]. * * Clients calling this function must replace the `\{id\}` substring with the * actual token type ID. */ function uri(uint256 /* id */) public view virtual returns (string memory) { return _uri; } /** * @dev See {IERC1155-balanceOf}. */ function balanceOf(address account, uint256 id) public view virtual returns (uint256) { return _balances[id][account]; } /** * @dev See {IERC1155-balanceOfBatch}. * * Requirements: * * - `accounts` and `ids` must have the same length. */ function balanceOfBatch( address[] memory accounts, uint256[] memory ids ) public view virtual returns (uint256[] memory) { if (accounts.length != ids.length) { revert ERC1155InvalidArrayLength(ids.length, accounts.length); } uint256[] memory batchBalances = new uint256[](accounts.length); for (uint256 i = 0; i < accounts.length; ++i) { batchBalances[i] = balanceOf(accounts.unsafeMemoryAccess(i), ids.unsafeMemoryAccess(i)); } return batchBalances; } /** * @dev See {IERC1155-setApprovalForAll}. */ function setApprovalForAll(address operator, bool approved) public virtual { _setApprovalForAll(_msgSender(), operator, approved); } /** * @dev See {IERC1155-isApprovedForAll}. */ function isApprovedForAll(address account, address operator) public view virtual returns (bool) { return _operatorApprovals[account][operator]; } /** * @dev See {IERC1155-safeTransferFrom}. */ function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) public virtual { address sender = _msgSender(); if (from != sender && !isApprovedForAll(from, sender)) { revert ERC1155MissingApprovalForAll(sender, from); } _safeTransferFrom(from, to, id, value, data); } /** * @dev See {IERC1155-safeBatchTransferFrom}. */ function safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) public virtual { address sender = _msgSender(); if (from != sender && !isApprovedForAll(from, sender)) { revert ERC1155MissingApprovalForAll(sender, from); } _safeBatchTransferFrom(from, to, ids, values, data); } /** * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`. Will mint (or burn) if `from` * (or `to`) is the zero address. * * Emits a {TransferSingle} event if the arrays contain one element, and {TransferBatch} otherwise. * * Requirements: * * - If `to` refers to a smart contract, it must implement either {IERC1155Receiver-onERC1155Received} * or {IERC1155Receiver-onERC1155BatchReceived} and return the acceptance magic value. * - `ids` and `values` must have the same length. * * NOTE: The ERC-1155 acceptance check is not performed in this function. See {_updateWithAcceptanceCheck} instead. */ function _update(address from, address to, uint256[] memory ids, uint256[] memory values) internal virtual { if (ids.length != values.length) { revert ERC1155InvalidArrayLength(ids.length, values.length); } address operator = _msgSender(); for (uint256 i = 0; i < ids.length; ++i) { uint256 id = ids.unsafeMemoryAccess(i); uint256 value = values.unsafeMemoryAccess(i); if (from != address(0)) { uint256 fromBalance = _balances[id][from]; if (fromBalance < value) { revert ERC1155InsufficientBalance(from, fromBalance, value, id); } unchecked { // Overflow not possible: value <= fromBalance _balances[id][from] = fromBalance - value; } } if (to != address(0)) { _balances[id][to] += value; } } if (ids.length == 1) { uint256 id = ids.unsafeMemoryAccess(0); uint256 value = values.unsafeMemoryAccess(0); emit TransferSingle(operator, from, to, id, value); } else { emit TransferBatch(operator, from, to, ids, values); } } /** * @dev Version of {_update} that performs the token acceptance check by calling * {IERC1155Receiver-onERC1155Received} or {IERC1155Receiver-onERC1155BatchReceived} on the receiver address if it * contains code (eg. is a smart contract at the moment of execution). * * IMPORTANT: Overriding this function is discouraged because it poses a reentrancy risk from the receiver. So any * update to the contract state after this function would break the check-effect-interaction pattern. Consider * overriding {_update} instead. */ function _updateWithAcceptanceCheck( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) internal virtual { _update(from, to, ids, values); if (to != address(0)) { address operator = _msgSender(); if (ids.length == 1) { uint256 id = ids.unsafeMemoryAccess(0); uint256 value = values.unsafeMemoryAccess(0); ERC1155Utils.checkOnERC1155Received(operator, from, to, id, value, data); } else { ERC1155Utils.checkOnERC1155BatchReceived(operator, from, to, ids, values, data); } } } /** * @dev Transfers a `value` tokens of token type `id` from `from` to `to`. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - `from` must have a balance of tokens of type `id` of at least `value` amount. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function _safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(from, to, ids, values, data); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_safeTransferFrom}. * * Emits a {TransferBatch} event. * * Requirements: * * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. * - `ids` and `values` must have the same length. */ function _safeBatchTransferFrom( address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } _updateWithAcceptanceCheck(from, to, ids, values, data); } /** * @dev Sets a new URI for all token types, by relying on the token type ID * substitution mechanism * https://eips.ethereum.org/EIPS/eip-1155#metadata[defined in the ERC]. * * By this mechanism, any occurrence of the `\{id\}` substring in either the * URI or any of the values in the JSON file at said URI will be replaced by * clients with the token type ID. * * For example, the `https://token-cdn-domain/\{id\}.json` URI would be * interpreted by clients as * `https://token-cdn-domain/000000000000000000000000000000000000000000000000000000000004cce0.json` * for token type ID 0x4cce0. * * See {uri}. * * Because these URIs cannot be meaningfully represented by the {URI} event, * this function emits no events. */ function _setURI(string memory newuri) internal virtual { _uri = newuri; } /** * @dev Creates a `value` amount of tokens of type `id`, and assigns them to `to`. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function _mint(address to, uint256 id, uint256 value, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(address(0), to, ids, values, data); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_mint}. * * Emits a {TransferBatch} event. * * Requirements: * * - `ids` and `values` must have the same length. * - `to` cannot be the zero address. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. */ function _mintBatch(address to, uint256[] memory ids, uint256[] memory values, bytes memory data) internal { if (to == address(0)) { revert ERC1155InvalidReceiver(address(0)); } _updateWithAcceptanceCheck(address(0), to, ids, values, data); } /** * @dev Destroys a `value` amount of tokens of type `id` from `from` * * Emits a {TransferSingle} event. * * Requirements: * * - `from` cannot be the zero address. * - `from` must have at least `value` amount of tokens of type `id`. */ function _burn(address from, uint256 id, uint256 value) internal { if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } (uint256[] memory ids, uint256[] memory values) = _asSingletonArrays(id, value); _updateWithAcceptanceCheck(from, address(0), ids, values, ""); } /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {_burn}. * * Emits a {TransferBatch} event. * * Requirements: * * - `from` cannot be the zero address. * - `from` must have at least `value` amount of tokens of type `id`. * - `ids` and `values` must have the same length. */ function _burnBatch(address from, uint256[] memory ids, uint256[] memory values) internal { if (from == address(0)) { revert ERC1155InvalidSender(address(0)); } _updateWithAcceptanceCheck(from, address(0), ids, values, ""); } /** * @dev Approve `operator` to operate on all of `owner` tokens * * Emits an {ApprovalForAll} event. * * Requirements: * * - `operator` cannot be the zero address. */ function _setApprovalForAll(address owner, address operator, bool approved) internal virtual { if (operator == address(0)) { revert ERC1155InvalidOperator(address(0)); } _operatorApprovals[owner][operator] = approved; emit ApprovalForAll(owner, operator, approved); } /** * @dev Creates an array in memory with only one value for each of the elements provided. */ function _asSingletonArrays( uint256 element1, uint256 element2 ) private pure returns (uint256[] memory array1, uint256[] memory array2) { assembly ("memory-safe") { // Load the free memory pointer array1 := mload(0x40) // Set array length to 1 mstore(array1, 1) // Store the single element at the next word after the length (where content starts) mstore(add(array1, 0x20), element1) // Repeat for next array locating it right after the first array array2 := add(array1, 0x40) mstore(array2, 1) mstore(add(array2, 0x20), element2) // Update the free memory pointer by pointing after the second array mstore(0x40, add(array2, 0x40)) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol) pragma solidity ^0.8.20; import {Context} from "../utils/Context.sol"; /** * @dev Contract module which provides a basic access control mechanism, where * there is an account (an owner) that can be granted exclusive access to * specific functions. * * The initial owner is set to the address provided by the deployer. This can * later be changed with {transferOwnership}. * * This module is used through inheritance. It will make available the modifier * `onlyOwner`, which can be applied to your functions to restrict their use to * the owner. */ abstract contract Ownable is Context { address private _owner; /** * @dev The caller account is not authorized to perform an operation. */ error OwnableUnauthorizedAccount(address account); /** * @dev The owner is not a valid owner account. (eg. `address(0)`) */ error OwnableInvalidOwner(address owner); event OwnershipTransferred(address indexed previousOwner, address indexed newOwner); /** * @dev Initializes the contract setting the address provided by the deployer as the initial owner. */ constructor(address initialOwner) { if (initialOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(initialOwner); } /** * @dev Throws if called by any account other than the owner. */ modifier onlyOwner() { _checkOwner(); _; } /** * @dev Returns the address of the current owner. */ function owner() public view virtual returns (address) { return _owner; } /** * @dev Throws if the sender is not the owner. */ function _checkOwner() internal view virtual { if (owner() != _msgSender()) { revert OwnableUnauthorizedAccount(_msgSender()); } } /** * @dev Leaves the contract without owner. It will not be possible to call * `onlyOwner` functions. Can only be called by the current owner. * * NOTE: Renouncing ownership will leave the contract without an owner, * thereby disabling any functionality that is only available to the owner. */ function renounceOwnership() public virtual onlyOwner { _transferOwnership(address(0)); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Can only be called by the current owner. */ function transferOwnership(address newOwner) public virtual onlyOwner { if (newOwner == address(0)) { revert OwnableInvalidOwner(address(0)); } _transferOwnership(newOwner); } /** * @dev Transfers ownership of the contract to a new account (`newOwner`). * Internal function without access restriction. */ function _transferOwnership(address newOwner) internal virtual { address oldOwner = _owner; _owner = newOwner; emit OwnershipTransferred(oldOwner, newOwner); } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol) pragma solidity ^0.8.20; /** * @dev Provides information about the current execution context, including the * sender of the transaction and its data. While these are generally available * via msg.sender and msg.data, they should not be accessed in such a direct * manner, since when dealing with meta-transactions the account sending and * paying for execution may not be the actual sender (as far as an application * is concerned). * * This contract is only required for intermediate, library-like contracts. */ abstract contract Context { function _msgSender() internal view virtual returns (address) { return msg.sender; } function _msgData() internal view virtual returns (bytes calldata) { return msg.data; } function _contextSuffixLength() internal view virtual returns (uint256) { return 0; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Arrays.sol) // This file was procedurally generated from scripts/generate/templates/Arrays.js. pragma solidity ^0.8.20; import {Comparators} from "./Comparators.sol"; import {SlotDerivation} from "./SlotDerivation.sol"; import {StorageSlot} from "./StorageSlot.sol"; import {Math} from "./math/Math.sol"; /** * @dev Collection of functions related to array types. */ library Arrays { using SlotDerivation for bytes32; using StorageSlot for bytes32; /** * @dev Sort an array of uint256 (in memory) following the provided comparator function. * * This function does the sorting "in place", meaning that it overrides the input. The object is returned for * convenience, but that returned value can be discarded safely if the caller has a memory pointer to the array. * * NOTE: this function's cost is `O(n · log(n))` in average and `O(n²)` in the worst case, with n the length of the * array. Using it in view functions that are executed through `eth_call` is safe, but one should be very careful * when executing this as part of a transaction. If the array being sorted is too large, the sort operation may * consume more gas than is available in a block, leading to potential DoS. * * IMPORTANT: Consider memory side-effects when using custom comparator functions that access memory in an unsafe way. */ function sort( uint256[] memory array, function(uint256, uint256) pure returns (bool) comp ) internal pure returns (uint256[] memory) { _quickSort(_begin(array), _end(array), comp); return array; } /** * @dev Variant of {sort} that sorts an array of uint256 in increasing order. */ function sort(uint256[] memory array) internal pure returns (uint256[] memory) { sort(array, Comparators.lt); return array; } /** * @dev Sort an array of address (in memory) following the provided comparator function. * * This function does the sorting "in place", meaning that it overrides the input. The object is returned for * convenience, but that returned value can be discarded safely if the caller has a memory pointer to the array. * * NOTE: this function's cost is `O(n · log(n))` in average and `O(n²)` in the worst case, with n the length of the * array. Using it in view functions that are executed through `eth_call` is safe, but one should be very careful * when executing this as part of a transaction. If the array being sorted is too large, the sort operation may * consume more gas than is available in a block, leading to potential DoS. * * IMPORTANT: Consider memory side-effects when using custom comparator functions that access memory in an unsafe way. */ function sort( address[] memory array, function(address, address) pure returns (bool) comp ) internal pure returns (address[] memory) { sort(_castToUint256Array(array), _castToUint256Comp(comp)); return array; } /** * @dev Variant of {sort} that sorts an array of address in increasing order. */ function sort(address[] memory array) internal pure returns (address[] memory) { sort(_castToUint256Array(array), Comparators.lt); return array; } /** * @dev Sort an array of bytes32 (in memory) following the provided comparator function. * * This function does the sorting "in place", meaning that it overrides the input. The object is returned for * convenience, but that returned value can be discarded safely if the caller has a memory pointer to the array. * * NOTE: this function's cost is `O(n · log(n))` in average and `O(n²)` in the worst case, with n the length of the * array. Using it in view functions that are executed through `eth_call` is safe, but one should be very careful * when executing this as part of a transaction. If the array being sorted is too large, the sort operation may * consume more gas than is available in a block, leading to potential DoS. * * IMPORTANT: Consider memory side-effects when using custom comparator functions that access memory in an unsafe way. */ function sort( bytes32[] memory array, function(bytes32, bytes32) pure returns (bool) comp ) internal pure returns (bytes32[] memory) { sort(_castToUint256Array(array), _castToUint256Comp(comp)); return array; } /** * @dev Variant of {sort} that sorts an array of bytes32 in increasing order. */ function sort(bytes32[] memory array) internal pure returns (bytes32[] memory) { sort(_castToUint256Array(array), Comparators.lt); return array; } /** * @dev Performs a quick sort of a segment of memory. The segment sorted starts at `begin` (inclusive), and stops * at end (exclusive). Sorting follows the `comp` comparator. * * Invariant: `begin <= end`. This is the case when initially called by {sort} and is preserved in subcalls. * * IMPORTANT: Memory locations between `begin` and `end` are not validated/zeroed. This function should * be used only if the limits are within a memory array. */ function _quickSort(uint256 begin, uint256 end, function(uint256, uint256) pure returns (bool) comp) private pure { unchecked { if (end - begin < 0x40) return; // Use first element as pivot uint256 pivot = _mload(begin); // Position where the pivot should be at the end of the loop uint256 pos = begin; for (uint256 it = begin + 0x20; it < end; it += 0x20) { if (comp(_mload(it), pivot)) { // If the value stored at the iterator's position comes before the pivot, we increment the // position of the pivot and move the value there. pos += 0x20; _swap(pos, it); } } _swap(begin, pos); // Swap pivot into place _quickSort(begin, pos, comp); // Sort the left side of the pivot _quickSort(pos + 0x20, end, comp); // Sort the right side of the pivot } } /** * @dev Pointer to the memory location of the first element of `array`. */ function _begin(uint256[] memory array) private pure returns (uint256 ptr) { assembly ("memory-safe") { ptr := add(array, 0x20) } } /** * @dev Pointer to the memory location of the first memory word (32bytes) after `array`. This is the memory word * that comes just after the last element of the array. */ function _end(uint256[] memory array) private pure returns (uint256 ptr) { unchecked { return _begin(array) + array.length * 0x20; } } /** * @dev Load memory word (as a uint256) at location `ptr`. */ function _mload(uint256 ptr) private pure returns (uint256 value) { assembly { value := mload(ptr) } } /** * @dev Swaps the elements memory location `ptr1` and `ptr2`. */ function _swap(uint256 ptr1, uint256 ptr2) private pure { assembly { let value1 := mload(ptr1) let value2 := mload(ptr2) mstore(ptr1, value2) mstore(ptr2, value1) } } /// @dev Helper: low level cast address memory array to uint256 memory array function _castToUint256Array(address[] memory input) private pure returns (uint256[] memory output) { assembly { output := input } } /// @dev Helper: low level cast bytes32 memory array to uint256 memory array function _castToUint256Array(bytes32[] memory input) private pure returns (uint256[] memory output) { assembly { output := input } } /// @dev Helper: low level cast address comp function to uint256 comp function function _castToUint256Comp( function(address, address) pure returns (bool) input ) private pure returns (function(uint256, uint256) pure returns (bool) output) { assembly { output := input } } /// @dev Helper: low level cast bytes32 comp function to uint256 comp function function _castToUint256Comp( function(bytes32, bytes32) pure returns (bool) input ) private pure returns (function(uint256, uint256) pure returns (bool) output) { assembly { output := input } } /** * @dev Searches a sorted `array` and returns the first index that contains * a value greater or equal to `element`. If no such index exists (i.e. all * values in the array are strictly less than `element`), the array length is * returned. Time complexity O(log n). * * NOTE: The `array` is expected to be sorted in ascending order, and to * contain no repeated elements. * * IMPORTANT: Deprecated. This implementation behaves as {lowerBound} but lacks * support for repeated elements in the array. The {lowerBound} function should * be used instead. */ function findUpperBound(uint256[] storage array, uint256 element) internal view returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeAccess(array, mid).value > element) { high = mid; } else { low = mid + 1; } } // At this point `low` is the exclusive upper bound. We will return the inclusive upper bound. if (low > 0 && unsafeAccess(array, low - 1).value == element) { return low - 1; } else { return low; } } /** * @dev Searches an `array` sorted in ascending order and returns the first * index that contains a value greater or equal than `element`. If no such index * exists (i.e. all values in the array are strictly less than `element`), the array * length is returned. Time complexity O(log n). * * See C++'s https://en.cppreference.com/w/cpp/algorithm/lower_bound[lower_bound]. */ function lowerBound(uint256[] storage array, uint256 element) internal view returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeAccess(array, mid).value < element) { // this cannot overflow because mid < high unchecked { low = mid + 1; } } else { high = mid; } } return low; } /** * @dev Searches an `array` sorted in ascending order and returns the first * index that contains a value strictly greater than `element`. If no such index * exists (i.e. all values in the array are strictly less than `element`), the array * length is returned. Time complexity O(log n). * * See C++'s https://en.cppreference.com/w/cpp/algorithm/upper_bound[upper_bound]. */ function upperBound(uint256[] storage array, uint256 element) internal view returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeAccess(array, mid).value > element) { high = mid; } else { // this cannot overflow because mid < high unchecked { low = mid + 1; } } } return low; } /** * @dev Same as {lowerBound}, but with an array in memory. */ function lowerBoundMemory(uint256[] memory array, uint256 element) internal pure returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeMemoryAccess(array, mid) < element) { // this cannot overflow because mid < high unchecked { low = mid + 1; } } else { high = mid; } } return low; } /** * @dev Same as {upperBound}, but with an array in memory. */ function upperBoundMemory(uint256[] memory array, uint256 element) internal pure returns (uint256) { uint256 low = 0; uint256 high = array.length; if (high == 0) { return 0; } while (low < high) { uint256 mid = Math.average(low, high); // Note that mid will always be strictly less than high (i.e. it will be a valid array index) // because Math.average rounds towards zero (it does integer division with truncation). if (unsafeMemoryAccess(array, mid) > element) { high = mid; } else { // this cannot overflow because mid < high unchecked { low = mid + 1; } } } return low; } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(address[] storage arr, uint256 pos) internal pure returns (StorageSlot.AddressSlot storage) { bytes32 slot; assembly ("memory-safe") { slot := arr.slot } return slot.deriveArray().offset(pos).getAddressSlot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(bytes32[] storage arr, uint256 pos) internal pure returns (StorageSlot.Bytes32Slot storage) { bytes32 slot; assembly ("memory-safe") { slot := arr.slot } return slot.deriveArray().offset(pos).getBytes32Slot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeAccess(uint256[] storage arr, uint256 pos) internal pure returns (StorageSlot.Uint256Slot storage) { bytes32 slot; assembly ("memory-safe") { slot := arr.slot } return slot.deriveArray().offset(pos).getUint256Slot(); } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeMemoryAccess(address[] memory arr, uint256 pos) internal pure returns (address res) { assembly { res := mload(add(add(arr, 0x20), mul(pos, 0x20))) } } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeMemoryAccess(bytes32[] memory arr, uint256 pos) internal pure returns (bytes32 res) { assembly { res := mload(add(add(arr, 0x20), mul(pos, 0x20))) } } /** * @dev Access an array in an "unsafe" way. Skips solidity "index-out-of-range" check. * * WARNING: Only use if you are certain `pos` is lower than the array length. */ function unsafeMemoryAccess(uint256[] memory arr, uint256 pos) internal pure returns (uint256 res) { assembly { res := mload(add(add(arr, 0x20), mul(pos, 0x20))) } } /** * @dev Helper to set the length of an dynamic array. Directly writing to `.length` is forbidden. * * WARNING: this does not clear elements if length is reduced, of initialize elements if length is increased. */ function unsafeSetLength(address[] storage array, uint256 len) internal { assembly ("memory-safe") { sstore(array.slot, len) } } /** * @dev Helper to set the length of an dynamic array. Directly writing to `.length` is forbidden. * * WARNING: this does not clear elements if length is reduced, of initialize elements if length is increased. */ function unsafeSetLength(bytes32[] storage array, uint256 len) internal { assembly ("memory-safe") { sstore(array.slot, len) } } /** * @dev Helper to set the length of an dynamic array. Directly writing to `.length` is forbidden. * * WARNING: this does not clear elements if length is reduced, of initialize elements if length is increased. */ function unsafeSetLength(uint256[] storage array, uint256 len) internal { assembly ("memory-safe") { sstore(array.slot, len) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/introspection/ERC165.sol) pragma solidity ^0.8.20; import {IERC165} from "./IERC165.sol"; /** * @dev Implementation of the {IERC165} interface. * * Contracts that want to implement ERC-165 should inherit from this contract and override {supportsInterface} to check * for the additional interface id that will be supported. For example: * * ```solidity * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) { * return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId); * } * ``` */ abstract contract ERC165 is IERC165 { /** * @dev See {IERC165-supportsInterface}. */ function supportsInterface(bytes4 interfaceId) public view virtual returns (bool) { return interfaceId == type(IERC165).interfaceId; } }
// SPDX-License-Identifier: MIT // 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); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/IERC1155.sol) pragma solidity ^0.8.20; import {IERC165} from "../../utils/introspection/IERC165.sol"; /** * @dev Required interface of an ERC-1155 compliant contract, as defined in the * https://eips.ethereum.org/EIPS/eip-1155[ERC]. */ interface IERC1155 is IERC165 { /** * @dev Emitted when `value` amount of tokens of type `id` are transferred from `from` to `to` by `operator`. */ event TransferSingle(address indexed operator, address indexed from, address indexed to, uint256 id, uint256 value); /** * @dev Equivalent to multiple {TransferSingle} events, where `operator`, `from` and `to` are the same for all * transfers. */ event TransferBatch( address indexed operator, address indexed from, address indexed to, uint256[] ids, uint256[] values ); /** * @dev Emitted when `account` grants or revokes permission to `operator` to transfer their tokens, according to * `approved`. */ event ApprovalForAll(address indexed account, address indexed operator, bool approved); /** * @dev Emitted when the URI for token type `id` changes to `value`, if it is a non-programmatic URI. * * If an {URI} event was emitted for `id`, the standard * https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[guarantees] that `value` will equal the value * returned by {IERC1155MetadataURI-uri}. */ event URI(string value, uint256 indexed id); /** * @dev Returns the value of tokens of token type `id` owned by `account`. */ function balanceOf(address account, uint256 id) external view returns (uint256); /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {balanceOf}. * * Requirements: * * - `accounts` and `ids` must have the same length. */ function balanceOfBatch( address[] calldata accounts, uint256[] calldata ids ) external view returns (uint256[] memory); /** * @dev Grants or revokes permission to `operator` to transfer the caller's tokens, according to `approved`, * * Emits an {ApprovalForAll} event. * * Requirements: * * - `operator` cannot be the zero address. */ function setApprovalForAll(address operator, bool approved) external; /** * @dev Returns true if `operator` is approved to transfer ``account``'s tokens. * * See {setApprovalForAll}. */ function isApprovedForAll(address account, address operator) external view returns (bool); /** * @dev Transfers a `value` amount of tokens of type `id` from `from` to `to`. * * WARNING: This function can potentially allow a reentrancy attack when transferring tokens * to an untrusted contract, when invoking {onERC1155Received} on the receiver. * Ensure to follow the checks-effects-interactions pattern and consider employing * reentrancy guards when interacting with untrusted contracts. * * Emits a {TransferSingle} event. * * Requirements: * * - `to` cannot be the zero address. * - If the caller is not `from`, it must have been approved to spend ``from``'s tokens via {setApprovalForAll}. * - `from` must have a balance of tokens of type `id` of at least `value` amount. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155Received} and return the * acceptance magic value. */ function safeTransferFrom(address from, address to, uint256 id, uint256 value, bytes calldata data) external; /** * @dev xref:ROOT:erc1155.adoc#batch-operations[Batched] version of {safeTransferFrom}. * * WARNING: This function can potentially allow a reentrancy attack when transferring tokens * to an untrusted contract, when invoking {onERC1155BatchReceived} on the receiver. * Ensure to follow the checks-effects-interactions pattern and consider employing * reentrancy guards when interacting with untrusted contracts. * * Emits either a {TransferSingle} or a {TransferBatch} event, depending on the length of the array arguments. * * Requirements: * * - `ids` and `values` must have the same length. * - If `to` refers to a smart contract, it must implement {IERC1155Receiver-onERC1155BatchReceived} and return the * acceptance magic value. */ function safeBatchTransferFrom( address from, address to, uint256[] calldata ids, uint256[] calldata values, bytes calldata data ) external; }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/utils/ERC1155Utils.sol) pragma solidity ^0.8.20; import {IERC1155Receiver} from "../IERC1155Receiver.sol"; import {IERC1155Errors} from "../../../interfaces/draft-IERC6093.sol"; /** * @dev Library that provide common ERC-1155 utility functions. * * See https://eips.ethereum.org/EIPS/eip-1155[ERC-1155]. * * _Available since v5.1._ */ library ERC1155Utils { /** * @dev Performs an acceptance check for the provided `operator` by calling {IERC1155-onERC1155Received} * 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 {IERC1155Receiver-onERC1155Received} and return the acceptance magic value to accept * the transfer. */ function checkOnERC1155Received( address operator, address from, address to, uint256 id, uint256 value, bytes memory data ) internal { if (to.code.length > 0) { try IERC1155Receiver(to).onERC1155Received(operator, from, id, value, data) returns (bytes4 response) { if (response != IERC1155Receiver.onERC1155Received.selector) { // Tokens rejected revert IERC1155Errors.ERC1155InvalidReceiver(to); } } catch (bytes memory reason) { if (reason.length == 0) { // non-IERC1155Receiver implementer revert IERC1155Errors.ERC1155InvalidReceiver(to); } else { assembly ("memory-safe") { revert(add(32, reason), mload(reason)) } } } } } /** * @dev Performs a batch acceptance check for the provided `operator` by calling {IERC1155-onERC1155BatchReceived} * 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 {IERC1155Receiver-onERC1155Received} and return the acceptance magic value to accept * the transfer. */ function checkOnERC1155BatchReceived( address operator, address from, address to, uint256[] memory ids, uint256[] memory values, bytes memory data ) internal { if (to.code.length > 0) { try IERC1155Receiver(to).onERC1155BatchReceived(operator, from, ids, values, data) returns ( bytes4 response ) { if (response != IERC1155Receiver.onERC1155BatchReceived.selector) { // Tokens rejected revert IERC1155Errors.ERC1155InvalidReceiver(to); } } catch (bytes memory reason) { if (reason.length == 0) { // non-IERC1155Receiver implementer revert IERC1155Errors.ERC1155InvalidReceiver(to); } else { assembly ("memory-safe") { revert(add(32, reason), mload(reason)) } } } } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/extensions/IERC1155MetadataURI.sol) pragma solidity ^0.8.20; import {IERC1155} from "../IERC1155.sol"; /** * @dev Interface of the optional ERC1155MetadataExtension interface, as defined * in the https://eips.ethereum.org/EIPS/eip-1155#metadata-extensions[ERC]. */ interface IERC1155MetadataURI is IERC1155 { /** * @dev Returns the URI for token type `id`. * * If the `\{id\}` substring is present in the URI, it must be replaced by * clients with the actual token type ID. */ function uri(uint256 id) external view returns (string memory); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/SlotDerivation.sol) // This file was procedurally generated from scripts/generate/templates/SlotDerivation.js. pragma solidity ^0.8.20; /** * @dev Library for computing storage (and transient storage) locations from namespaces and deriving slots * corresponding to standard patterns. The derivation method for array and mapping matches the storage layout used by * the solidity language / compiler. * * See https://docs.soliditylang.org/en/v0.8.20/internals/layout_in_storage.html#mappings-and-dynamic-arrays[Solidity docs for mappings and dynamic arrays.]. * * Example usage: * ```solidity * contract Example { * // Add the library methods * using StorageSlot for bytes32; * using SlotDerivation for bytes32; * * // Declare a namespace * string private constant _NAMESPACE = "<namespace>" // eg. OpenZeppelin.Slot * * function setValueInNamespace(uint256 key, address newValue) internal { * _NAMESPACE.erc7201Slot().deriveMapping(key).getAddressSlot().value = newValue; * } * * function getValueInNamespace(uint256 key) internal view returns (address) { * return _NAMESPACE.erc7201Slot().deriveMapping(key).getAddressSlot().value; * } * } * ``` * * TIP: Consider using this library along with {StorageSlot}. * * NOTE: This library provides a way to manipulate storage locations in a non-standard way. Tooling for checking * upgrade safety will ignore the slots accessed through this library. * * _Available since v5.1._ */ library SlotDerivation { /** * @dev Derive an ERC-7201 slot from a string (namespace). */ function erc7201Slot(string memory namespace) internal pure returns (bytes32 slot) { assembly ("memory-safe") { mstore(0x00, sub(keccak256(add(namespace, 0x20), mload(namespace)), 1)) slot := and(keccak256(0x00, 0x20), not(0xff)) } } /** * @dev Add an offset to a slot to get the n-th element of a structure or an array. */ function offset(bytes32 slot, uint256 pos) internal pure returns (bytes32 result) { unchecked { return bytes32(uint256(slot) + pos); } } /** * @dev Derive the location of the first element in an array from the slot where the length is stored. */ function deriveArray(bytes32 slot) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, slot) result := keccak256(0x00, 0x20) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, address key) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, and(key, shr(96, not(0)))) mstore(0x20, slot) result := keccak256(0x00, 0x40) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, bool key) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, iszero(iszero(key))) mstore(0x20, slot) result := keccak256(0x00, 0x40) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, bytes32 key) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, key) mstore(0x20, slot) result := keccak256(0x00, 0x40) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, uint256 key) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, key) mstore(0x20, slot) result := keccak256(0x00, 0x40) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, int256 key) internal pure returns (bytes32 result) { assembly ("memory-safe") { mstore(0x00, key) mstore(0x20, slot) result := keccak256(0x00, 0x40) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, string memory key) internal pure returns (bytes32 result) { assembly ("memory-safe") { let length := mload(key) let begin := add(key, 0x20) let end := add(begin, length) let cache := mload(end) mstore(end, slot) result := keccak256(begin, add(length, 0x20)) mstore(end, cache) } } /** * @dev Derive the location of a mapping element from the key. */ function deriveMapping(bytes32 slot, bytes memory key) internal pure returns (bytes32 result) { assembly ("memory-safe") { let length := mload(key) let begin := add(key, 0x20) let end := add(begin, length) let cache := mload(end) mstore(end, slot) result := keccak256(begin, add(length, 0x20)) mstore(end, cache) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Comparators.sol) pragma solidity ^0.8.20; /** * @dev Provides a set of functions to compare values. * * _Available since v5.1._ */ library Comparators { function lt(uint256 a, uint256 b) internal pure returns (bool) { return a < b; } function gt(uint256 a, uint256 b) internal pure returns (bool) { return a > b; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/StorageSlot.sol) // This file was procedurally generated from scripts/generate/templates/StorageSlot.js. pragma solidity ^0.8.20; /** * @dev Library for reading and writing primitive types to specific storage slots. * * Storage slots are often used to avoid storage conflict when dealing with upgradeable contracts. * This library helps with reading and writing to such slots without the need for inline assembly. * * The functions in this library return Slot structs that contain a `value` member that can be used to read or write. * * Example usage to set ERC-1967 implementation slot: * ```solidity * contract ERC1967 { * // Define the slot. Alternatively, use the SlotDerivation library to derive the slot. * bytes32 internal constant _IMPLEMENTATION_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc; * * function _getImplementation() internal view returns (address) { * return StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value; * } * * function _setImplementation(address newImplementation) internal { * require(newImplementation.code.length > 0); * StorageSlot.getAddressSlot(_IMPLEMENTATION_SLOT).value = newImplementation; * } * } * ``` * * TIP: Consider using this library along with {SlotDerivation}. */ library StorageSlot { struct AddressSlot { address value; } struct BooleanSlot { bool value; } struct Bytes32Slot { bytes32 value; } struct Uint256Slot { uint256 value; } struct Int256Slot { int256 value; } struct StringSlot { string value; } struct BytesSlot { bytes value; } /** * @dev Returns an `AddressSlot` with member `value` located at `slot`. */ function getAddressSlot(bytes32 slot) internal pure returns (AddressSlot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns a `BooleanSlot` with member `value` located at `slot`. */ function getBooleanSlot(bytes32 slot) internal pure returns (BooleanSlot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns a `Bytes32Slot` with member `value` located at `slot`. */ function getBytes32Slot(bytes32 slot) internal pure returns (Bytes32Slot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns a `Uint256Slot` with member `value` located at `slot`. */ function getUint256Slot(bytes32 slot) internal pure returns (Uint256Slot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns a `Int256Slot` with member `value` located at `slot`. */ function getInt256Slot(bytes32 slot) internal pure returns (Int256Slot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns a `StringSlot` with member `value` located at `slot`. */ function getStringSlot(bytes32 slot) internal pure returns (StringSlot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns an `StringSlot` representation of the string storage pointer `store`. */ function getStringSlot(string storage store) internal pure returns (StringSlot storage r) { assembly ("memory-safe") { r.slot := store.slot } } /** * @dev Returns a `BytesSlot` with member `value` located at `slot`. */ function getBytesSlot(bytes32 slot) internal pure returns (BytesSlot storage r) { assembly ("memory-safe") { r.slot := slot } } /** * @dev Returns an `BytesSlot` representation of the bytes storage pointer `store`. */ function getBytesSlot(bytes storage store) internal pure returns (BytesSlot storage r) { assembly ("memory-safe") { r.slot := store.slot } } }
// SPDX-License-Identifier: MIT // 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); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/math/Math.sol) pragma solidity ^0.8.20; import {Panic} from "../Panic.sol"; import {SafeCast} from "./SafeCast.sol"; /** * @dev Standard math utilities missing in the Solidity language. */ library Math { enum Rounding { Floor, // Toward negative infinity Ceil, // Toward positive infinity Trunc, // Toward zero Expand // Away from zero } /** * @dev 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; } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (token/ERC1155/IERC1155Receiver.sol) pragma solidity ^0.8.20; import {IERC165} from "../../utils/introspection/IERC165.sol"; /** * @dev Interface that must be implemented by smart contracts in order to receive * ERC-1155 token transfers. */ interface IERC1155Receiver is IERC165 { /** * @dev Handles the receipt of a single ERC-1155 token type. This function is * called at the end of a `safeTransferFrom` after the balance has been updated. * * NOTE: To accept the transfer, this must return * `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` * (i.e. 0xf23a6e61, or its own function selector). * * @param operator The address which initiated the transfer (i.e. msg.sender) * @param from The address which previously owned the token * @param id The ID of the token being transferred * @param value The amount of tokens being transferred * @param data Additional data with no specified format * @return `bytes4(keccak256("onERC1155Received(address,address,uint256,uint256,bytes)"))` if transfer is allowed */ function onERC1155Received( address operator, address from, uint256 id, uint256 value, bytes calldata data ) external returns (bytes4); /** * @dev Handles the receipt of a multiple ERC-1155 token types. This function * is called at the end of a `safeBatchTransferFrom` after the balances have * been updated. * * NOTE: To accept the transfer(s), this must return * `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` * (i.e. 0xbc197c81, or its own function selector). * * @param operator The address which initiated the batch transfer (i.e. msg.sender) * @param from The address which previously owned the token * @param ids An array containing ids of each token being transferred (order and length must match values array) * @param values An array containing amounts of each token being transferred (order and length must match ids array) * @param data Additional data with no specified format * @return `bytes4(keccak256("onERC1155BatchReceived(address,address,uint256[],uint256[],bytes)"))` if transfer is allowed */ function onERC1155BatchReceived( address operator, address from, uint256[] calldata ids, uint256[] calldata values, bytes calldata data ) external returns (bytes4); }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/Panic.sol) pragma solidity ^0.8.20; /** * @dev Helper library for emitting standardized panic codes. * * ```solidity * contract Example { * using Panic for uint256; * * // Use any of the declared internal constants * function foo() { Panic.GENERIC.panic(); } * * // Alternatively * function foo() { Panic.panic(Panic.GENERIC); } * } * ``` * * Follows the list from https://github.com/ethereum/solidity/blob/v0.8.24/libsolutil/ErrorCodes.h[libsolutil]. * * _Available since v5.1._ */ // slither-disable-next-line unused-state library Panic { /// @dev generic / unspecified error uint256 internal constant GENERIC = 0x00; /// @dev used by the assert() builtin uint256 internal constant ASSERT = 0x01; /// @dev arithmetic underflow or overflow uint256 internal constant UNDER_OVERFLOW = 0x11; /// @dev division or modulo by zero uint256 internal constant DIVISION_BY_ZERO = 0x12; /// @dev enum conversion error uint256 internal constant ENUM_CONVERSION_ERROR = 0x21; /// @dev invalid encoding in storage uint256 internal constant STORAGE_ENCODING_ERROR = 0x22; /// @dev empty array pop uint256 internal constant EMPTY_ARRAY_POP = 0x31; /// @dev array out of bounds access uint256 internal constant ARRAY_OUT_OF_BOUNDS = 0x32; /// @dev resource error (too large allocation or too large array) uint256 internal constant RESOURCE_ERROR = 0x41; /// @dev calling invalid internal function uint256 internal constant INVALID_INTERNAL_FUNCTION = 0x51; /// @dev Reverts with a panic code. Recommended to use with /// the internal constants with predefined codes. function panic(uint256 code) internal pure { assembly ("memory-safe") { mstore(0x00, 0x4e487b71) mstore(0x20, code) revert(0x1c, 0x24) } } }
// SPDX-License-Identifier: MIT // OpenZeppelin Contracts (last updated v5.1.0) (utils/math/SafeCast.sol) // This file was procedurally generated from scripts/generate/templates/SafeCast.js. pragma solidity ^0.8.20; /** * @dev Wrappers over Solidity's uintXX/intXX/bool casting operators with added overflow * checks. * * Downcasting from uint256/int256 in Solidity does not revert on overflow. This can * easily result in undesired exploitation or bugs, since developers usually * assume that overflows raise errors. `SafeCast` restores this intuition by * reverting the transaction when such an operation overflows. * * Using this library instead of the unchecked operations eliminates an entire * class of bugs, so it's recommended to use it always. */ library SafeCast { /** * @dev Value doesn't fit in an uint of `bits` size. */ error SafeCastOverflowedUintDowncast(uint8 bits, uint256 value); /** * @dev An int value doesn't fit in an uint of `bits` size. */ error SafeCastOverflowedIntToUint(int256 value); /** * @dev Value doesn't fit in an int of `bits` size. */ error SafeCastOverflowedIntDowncast(uint8 bits, int256 value); /** * @dev An uint value doesn't fit in an int of `bits` size. */ error SafeCastOverflowedUintToInt(uint256 value); /** * @dev Returns the downcasted uint248 from uint256, reverting on * overflow (when the input is greater than largest uint248). * * Counterpart to Solidity's `uint248` operator. * * Requirements: * * - input must fit into 248 bits */ function toUint248(uint256 value) internal pure returns (uint248) { if (value > type(uint248).max) { revert SafeCastOverflowedUintDowncast(248, value); } return uint248(value); } /** * @dev Returns the downcasted uint240 from uint256, reverting on * overflow (when the input is greater than largest uint240). * * Counterpart to Solidity's `uint240` operator. * * Requirements: * * - input must fit into 240 bits */ function toUint240(uint256 value) internal pure returns (uint240) { if (value > type(uint240).max) { revert SafeCastOverflowedUintDowncast(240, value); } return uint240(value); } /** * @dev Returns the downcasted uint232 from uint256, reverting on * overflow (when the input is greater than largest uint232). * * Counterpart to Solidity's `uint232` operator. * * Requirements: * * - input must fit into 232 bits */ function toUint232(uint256 value) internal pure returns (uint232) { if (value > type(uint232).max) { revert SafeCastOverflowedUintDowncast(232, value); } return uint232(value); } /** * @dev Returns the downcasted uint224 from uint256, reverting on * overflow (when the input is greater than largest uint224). * * Counterpart to Solidity's `uint224` operator. * * Requirements: * * - input must fit into 224 bits */ function toUint224(uint256 value) internal pure returns (uint224) { if (value > type(uint224).max) { revert SafeCastOverflowedUintDowncast(224, value); } return uint224(value); } /** * @dev Returns the downcasted uint216 from uint256, reverting on * overflow (when the input is greater than largest uint216). * * Counterpart to Solidity's `uint216` operator. * * Requirements: * * - input must fit into 216 bits */ function toUint216(uint256 value) internal pure returns (uint216) { if (value > type(uint216).max) { revert SafeCastOverflowedUintDowncast(216, value); } return uint216(value); } /** * @dev Returns the downcasted uint208 from uint256, reverting on * overflow (when the input is greater than largest uint208). * * Counterpart to Solidity's `uint208` operator. * * Requirements: * * - input must fit into 208 bits */ function toUint208(uint256 value) internal pure returns (uint208) { if (value > type(uint208).max) { revert SafeCastOverflowedUintDowncast(208, value); } return uint208(value); } /** * @dev Returns the downcasted uint200 from uint256, reverting on * overflow (when the input is greater than largest uint200). * * Counterpart to Solidity's `uint200` operator. * * Requirements: * * - input must fit into 200 bits */ function toUint200(uint256 value) internal pure returns (uint200) { if (value > type(uint200).max) { revert SafeCastOverflowedUintDowncast(200, value); } return uint200(value); } /** * @dev Returns the downcasted uint192 from uint256, reverting on * overflow (when the input is greater than largest uint192). * * Counterpart to Solidity's `uint192` operator. * * Requirements: * * - input must fit into 192 bits */ function toUint192(uint256 value) internal pure returns (uint192) { if (value > type(uint192).max) { revert SafeCastOverflowedUintDowncast(192, value); } return uint192(value); } /** * @dev Returns the downcasted uint184 from uint256, reverting on * overflow (when the input is greater than largest uint184). * * Counterpart to Solidity's `uint184` operator. * * Requirements: * * - input must fit into 184 bits */ function toUint184(uint256 value) internal pure returns (uint184) { if (value > type(uint184).max) { revert SafeCastOverflowedUintDowncast(184, value); } return uint184(value); } /** * @dev Returns the downcasted uint176 from uint256, reverting on * overflow (when the input is greater than largest uint176). * * Counterpart to Solidity's `uint176` operator. * * Requirements: * * - input must fit into 176 bits */ function toUint176(uint256 value) internal pure returns (uint176) { if (value > type(uint176).max) { revert SafeCastOverflowedUintDowncast(176, value); } return uint176(value); } /** * @dev Returns the downcasted uint168 from uint256, reverting on * overflow (when the input is greater than largest uint168). * * Counterpart to Solidity's `uint168` operator. * * Requirements: * * - input must fit into 168 bits */ function toUint168(uint256 value) internal pure returns (uint168) { if (value > type(uint168).max) { revert SafeCastOverflowedUintDowncast(168, value); } return uint168(value); } /** * @dev Returns the downcasted uint160 from uint256, reverting on * overflow (when the input is greater than largest uint160). * * Counterpart to Solidity's `uint160` operator. * * Requirements: * * - input must fit into 160 bits */ function toUint160(uint256 value) internal pure returns (uint160) { if (value > type(uint160).max) { revert SafeCastOverflowedUintDowncast(160, value); } return uint160(value); } /** * @dev Returns the downcasted uint152 from uint256, reverting on * overflow (when the input is greater than largest uint152). * * Counterpart to Solidity's `uint152` operator. * * Requirements: * * - input must fit into 152 bits */ function toUint152(uint256 value) internal pure returns (uint152) { if (value > type(uint152).max) { revert SafeCastOverflowedUintDowncast(152, value); } return uint152(value); } /** * @dev Returns the downcasted uint144 from uint256, reverting on * overflow (when the input is greater than largest uint144). * * Counterpart to Solidity's `uint144` operator. * * Requirements: * * - input must fit into 144 bits */ function toUint144(uint256 value) internal pure returns (uint144) { if (value > type(uint144).max) { revert SafeCastOverflowedUintDowncast(144, value); } return uint144(value); } /** * @dev Returns the downcasted uint136 from uint256, reverting on * overflow (when the input is greater than largest uint136). * * Counterpart to Solidity's `uint136` operator. * * Requirements: * * - input must fit into 136 bits */ function toUint136(uint256 value) internal pure returns (uint136) { if (value > type(uint136).max) { revert SafeCastOverflowedUintDowncast(136, value); } return uint136(value); } /** * @dev Returns the downcasted uint128 from uint256, reverting on * overflow (when the input is greater than largest uint128). * * Counterpart to Solidity's `uint128` operator. * * Requirements: * * - input must fit into 128 bits */ function toUint128(uint256 value) internal pure returns (uint128) { if (value > type(uint128).max) { revert SafeCastOverflowedUintDowncast(128, value); } return uint128(value); } /** * @dev Returns the downcasted uint120 from uint256, reverting on * overflow (when the input is greater than largest uint120). * * Counterpart to Solidity's `uint120` operator. * * Requirements: * * - input must fit into 120 bits */ function toUint120(uint256 value) internal pure returns (uint120) { if (value > type(uint120).max) { revert SafeCastOverflowedUintDowncast(120, value); } return uint120(value); } /** * @dev Returns the downcasted uint112 from uint256, reverting on * overflow (when the input is greater than largest uint112). * * Counterpart to Solidity's `uint112` operator. * * Requirements: * * - input must fit into 112 bits */ function toUint112(uint256 value) internal pure returns (uint112) { if (value > type(uint112).max) { revert SafeCastOverflowedUintDowncast(112, value); } return uint112(value); } /** * @dev Returns the downcasted uint104 from uint256, reverting on * overflow (when the input is greater than largest uint104). * * Counterpart to Solidity's `uint104` operator. * * Requirements: * * - input must fit into 104 bits */ function toUint104(uint256 value) internal pure returns (uint104) { if (value > type(uint104).max) { revert SafeCastOverflowedUintDowncast(104, value); } return uint104(value); } /** * @dev Returns the downcasted uint96 from uint256, reverting on * overflow (when the input is greater than largest uint96). * * Counterpart to Solidity's `uint96` operator. * * Requirements: * * - input must fit into 96 bits */ function toUint96(uint256 value) internal pure returns (uint96) { if (value > type(uint96).max) { revert SafeCastOverflowedUintDowncast(96, value); } return uint96(value); } /** * @dev Returns the downcasted uint88 from uint256, reverting on * overflow (when the input is greater than largest uint88). * * Counterpart to Solidity's `uint88` operator. * * Requirements: * * - input must fit into 88 bits */ function toUint88(uint256 value) internal pure returns (uint88) { if (value > type(uint88).max) { revert SafeCastOverflowedUintDowncast(88, value); } return uint88(value); } /** * @dev Returns the downcasted uint80 from uint256, reverting on * overflow (when the input is greater than largest uint80). * * Counterpart to Solidity's `uint80` operator. * * Requirements: * * - input must fit into 80 bits */ function toUint80(uint256 value) internal pure returns (uint80) { if (value > type(uint80).max) { revert SafeCastOverflowedUintDowncast(80, value); } return uint80(value); } /** * @dev Returns the downcasted uint72 from uint256, reverting on * overflow (when the input is greater than largest uint72). * * Counterpart to Solidity's `uint72` operator. * * Requirements: * * - input must fit into 72 bits */ function toUint72(uint256 value) internal pure returns (uint72) { if (value > type(uint72).max) { revert SafeCastOverflowedUintDowncast(72, value); } return uint72(value); } /** * @dev Returns the downcasted uint64 from uint256, reverting on * overflow (when the input is greater than largest uint64). * * Counterpart to Solidity's `uint64` operator. * * Requirements: * * - input must fit into 64 bits */ function toUint64(uint256 value) internal pure returns (uint64) { if (value > type(uint64).max) { revert SafeCastOverflowedUintDowncast(64, value); } return uint64(value); } /** * @dev Returns the downcasted uint56 from uint256, reverting on * overflow (when the input is greater than largest uint56). * * Counterpart to Solidity's `uint56` operator. * * Requirements: * * - input must fit into 56 bits */ function toUint56(uint256 value) internal pure returns (uint56) { if (value > type(uint56).max) { revert SafeCastOverflowedUintDowncast(56, value); } return uint56(value); } /** * @dev Returns the downcasted uint48 from uint256, reverting on * overflow (when the input is greater than largest uint48). * * Counterpart to Solidity's `uint48` operator. * * Requirements: * * - input must fit into 48 bits */ function toUint48(uint256 value) internal pure returns (uint48) { if (value > type(uint48).max) { revert SafeCastOverflowedUintDowncast(48, value); } return uint48(value); } /** * @dev Returns the downcasted uint40 from uint256, reverting on * overflow (when the input is greater than largest uint40). * * Counterpart to Solidity's `uint40` operator. * * Requirements: * * - input must fit into 40 bits */ function toUint40(uint256 value) internal pure returns (uint40) { if (value > type(uint40).max) { revert SafeCastOverflowedUintDowncast(40, value); } return uint40(value); } /** * @dev Returns the downcasted uint32 from uint256, reverting on * overflow (when the input is greater than largest uint32). * * Counterpart to Solidity's `uint32` operator. * * Requirements: * * - input must fit into 32 bits */ function toUint32(uint256 value) internal pure returns (uint32) { if (value > type(uint32).max) { revert SafeCastOverflowedUintDowncast(32, value); } return uint32(value); } /** * @dev Returns the downcasted uint24 from uint256, reverting on * overflow (when the input is greater than largest uint24). * * Counterpart to Solidity's `uint24` operator. * * Requirements: * * - input must fit into 24 bits */ function toUint24(uint256 value) internal pure returns (uint24) { if (value > type(uint24).max) { revert SafeCastOverflowedUintDowncast(24, value); } return uint24(value); } /** * @dev Returns the downcasted uint16 from uint256, reverting on * overflow (when the input is greater than largest uint16). * * Counterpart to Solidity's `uint16` operator. * * Requirements: * * - input must fit into 16 bits */ function toUint16(uint256 value) internal pure returns (uint16) { if (value > type(uint16).max) { revert SafeCastOverflowedUintDowncast(16, value); } return uint16(value); } /** * @dev Returns the downcasted uint8 from uint256, reverting on * overflow (when the input is greater than largest uint8). * * Counterpart to Solidity's `uint8` operator. * * Requirements: * * - input must fit into 8 bits */ function toUint8(uint256 value) internal pure returns (uint8) { if (value > type(uint8).max) { revert SafeCastOverflowedUintDowncast(8, value); } return uint8(value); } /** * @dev Converts a signed int256 into an unsigned uint256. * * Requirements: * * - input must be greater than or equal to 0. */ function toUint256(int256 value) internal pure returns (uint256) { if (value < 0) { revert SafeCastOverflowedIntToUint(value); } return uint256(value); } /** * @dev Returns the downcasted int248 from int256, reverting on * overflow (when the input is less than smallest int248 or * greater than largest int248). * * Counterpart to Solidity's `int248` operator. * * Requirements: * * - input must fit into 248 bits */ function toInt248(int256 value) internal pure returns (int248 downcasted) { downcasted = int248(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(248, value); } } /** * @dev Returns the downcasted int240 from int256, reverting on * overflow (when the input is less than smallest int240 or * greater than largest int240). * * Counterpart to Solidity's `int240` operator. * * Requirements: * * - input must fit into 240 bits */ function toInt240(int256 value) internal pure returns (int240 downcasted) { downcasted = int240(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(240, value); } } /** * @dev Returns the downcasted int232 from int256, reverting on * overflow (when the input is less than smallest int232 or * greater than largest int232). * * Counterpart to Solidity's `int232` operator. * * Requirements: * * - input must fit into 232 bits */ function toInt232(int256 value) internal pure returns (int232 downcasted) { downcasted = int232(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(232, value); } } /** * @dev Returns the downcasted int224 from int256, reverting on * overflow (when the input is less than smallest int224 or * greater than largest int224). * * Counterpart to Solidity's `int224` operator. * * Requirements: * * - input must fit into 224 bits */ function toInt224(int256 value) internal pure returns (int224 downcasted) { downcasted = int224(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(224, value); } } /** * @dev Returns the downcasted int216 from int256, reverting on * overflow (when the input is less than smallest int216 or * greater than largest int216). * * Counterpart to Solidity's `int216` operator. * * Requirements: * * - input must fit into 216 bits */ function toInt216(int256 value) internal pure returns (int216 downcasted) { downcasted = int216(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(216, value); } } /** * @dev Returns the downcasted int208 from int256, reverting on * overflow (when the input is less than smallest int208 or * greater than largest int208). * * Counterpart to Solidity's `int208` operator. * * Requirements: * * - input must fit into 208 bits */ function toInt208(int256 value) internal pure returns (int208 downcasted) { downcasted = int208(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(208, value); } } /** * @dev Returns the downcasted int200 from int256, reverting on * overflow (when the input is less than smallest int200 or * greater than largest int200). * * Counterpart to Solidity's `int200` operator. * * Requirements: * * - input must fit into 200 bits */ function toInt200(int256 value) internal pure returns (int200 downcasted) { downcasted = int200(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(200, value); } } /** * @dev Returns the downcasted int192 from int256, reverting on * overflow (when the input is less than smallest int192 or * greater than largest int192). * * Counterpart to Solidity's `int192` operator. * * Requirements: * * - input must fit into 192 bits */ function toInt192(int256 value) internal pure returns (int192 downcasted) { downcasted = int192(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(192, value); } } /** * @dev Returns the downcasted int184 from int256, reverting on * overflow (when the input is less than smallest int184 or * greater than largest int184). * * Counterpart to Solidity's `int184` operator. * * Requirements: * * - input must fit into 184 bits */ function toInt184(int256 value) internal pure returns (int184 downcasted) { downcasted = int184(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(184, value); } } /** * @dev Returns the downcasted int176 from int256, reverting on * overflow (when the input is less than smallest int176 or * greater than largest int176). * * Counterpart to Solidity's `int176` operator. * * Requirements: * * - input must fit into 176 bits */ function toInt176(int256 value) internal pure returns (int176 downcasted) { downcasted = int176(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(176, value); } } /** * @dev Returns the downcasted int168 from int256, reverting on * overflow (when the input is less than smallest int168 or * greater than largest int168). * * Counterpart to Solidity's `int168` operator. * * Requirements: * * - input must fit into 168 bits */ function toInt168(int256 value) internal pure returns (int168 downcasted) { downcasted = int168(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(168, value); } } /** * @dev Returns the downcasted int160 from int256, reverting on * overflow (when the input is less than smallest int160 or * greater than largest int160). * * Counterpart to Solidity's `int160` operator. * * Requirements: * * - input must fit into 160 bits */ function toInt160(int256 value) internal pure returns (int160 downcasted) { downcasted = int160(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(160, value); } } /** * @dev Returns the downcasted int152 from int256, reverting on * overflow (when the input is less than smallest int152 or * greater than largest int152). * * Counterpart to Solidity's `int152` operator. * * Requirements: * * - input must fit into 152 bits */ function toInt152(int256 value) internal pure returns (int152 downcasted) { downcasted = int152(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(152, value); } } /** * @dev Returns the downcasted int144 from int256, reverting on * overflow (when the input is less than smallest int144 or * greater than largest int144). * * Counterpart to Solidity's `int144` operator. * * Requirements: * * - input must fit into 144 bits */ function toInt144(int256 value) internal pure returns (int144 downcasted) { downcasted = int144(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(144, value); } } /** * @dev Returns the downcasted int136 from int256, reverting on * overflow (when the input is less than smallest int136 or * greater than largest int136). * * Counterpart to Solidity's `int136` operator. * * Requirements: * * - input must fit into 136 bits */ function toInt136(int256 value) internal pure returns (int136 downcasted) { downcasted = int136(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(136, value); } } /** * @dev Returns the downcasted int128 from int256, reverting on * overflow (when the input is less than smallest int128 or * greater than largest int128). * * Counterpart to Solidity's `int128` operator. * * Requirements: * * - input must fit into 128 bits */ function toInt128(int256 value) internal pure returns (int128 downcasted) { downcasted = int128(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(128, value); } } /** * @dev Returns the downcasted int120 from int256, reverting on * overflow (when the input is less than smallest int120 or * greater than largest int120). * * Counterpart to Solidity's `int120` operator. * * Requirements: * * - input must fit into 120 bits */ function toInt120(int256 value) internal pure returns (int120 downcasted) { downcasted = int120(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(120, value); } } /** * @dev Returns the downcasted int112 from int256, reverting on * overflow (when the input is less than smallest int112 or * greater than largest int112). * * Counterpart to Solidity's `int112` operator. * * Requirements: * * - input must fit into 112 bits */ function toInt112(int256 value) internal pure returns (int112 downcasted) { downcasted = int112(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(112, value); } } /** * @dev Returns the downcasted int104 from int256, reverting on * overflow (when the input is less than smallest int104 or * greater than largest int104). * * Counterpart to Solidity's `int104` operator. * * Requirements: * * - input must fit into 104 bits */ function toInt104(int256 value) internal pure returns (int104 downcasted) { downcasted = int104(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(104, value); } } /** * @dev Returns the downcasted int96 from int256, reverting on * overflow (when the input is less than smallest int96 or * greater than largest int96). * * Counterpart to Solidity's `int96` operator. * * Requirements: * * - input must fit into 96 bits */ function toInt96(int256 value) internal pure returns (int96 downcasted) { downcasted = int96(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(96, value); } } /** * @dev Returns the downcasted int88 from int256, reverting on * overflow (when the input is less than smallest int88 or * greater than largest int88). * * Counterpart to Solidity's `int88` operator. * * Requirements: * * - input must fit into 88 bits */ function toInt88(int256 value) internal pure returns (int88 downcasted) { downcasted = int88(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(88, value); } } /** * @dev Returns the downcasted int80 from int256, reverting on * overflow (when the input is less than smallest int80 or * greater than largest int80). * * Counterpart to Solidity's `int80` operator. * * Requirements: * * - input must fit into 80 bits */ function toInt80(int256 value) internal pure returns (int80 downcasted) { downcasted = int80(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(80, value); } } /** * @dev Returns the downcasted int72 from int256, reverting on * overflow (when the input is less than smallest int72 or * greater than largest int72). * * Counterpart to Solidity's `int72` operator. * * Requirements: * * - input must fit into 72 bits */ function toInt72(int256 value) internal pure returns (int72 downcasted) { downcasted = int72(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(72, value); } } /** * @dev Returns the downcasted int64 from int256, reverting on * overflow (when the input is less than smallest int64 or * greater than largest int64). * * Counterpart to Solidity's `int64` operator. * * Requirements: * * - input must fit into 64 bits */ function toInt64(int256 value) internal pure returns (int64 downcasted) { downcasted = int64(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(64, value); } } /** * @dev Returns the downcasted int56 from int256, reverting on * overflow (when the input is less than smallest int56 or * greater than largest int56). * * Counterpart to Solidity's `int56` operator. * * Requirements: * * - input must fit into 56 bits */ function toInt56(int256 value) internal pure returns (int56 downcasted) { downcasted = int56(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(56, value); } } /** * @dev Returns the downcasted int48 from int256, reverting on * overflow (when the input is less than smallest int48 or * greater than largest int48). * * Counterpart to Solidity's `int48` operator. * * Requirements: * * - input must fit into 48 bits */ function toInt48(int256 value) internal pure returns (int48 downcasted) { downcasted = int48(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(48, value); } } /** * @dev Returns the downcasted int40 from int256, reverting on * overflow (when the input is less than smallest int40 or * greater than largest int40). * * Counterpart to Solidity's `int40` operator. * * Requirements: * * - input must fit into 40 bits */ function toInt40(int256 value) internal pure returns (int40 downcasted) { downcasted = int40(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(40, value); } } /** * @dev Returns the downcasted int32 from int256, reverting on * overflow (when the input is less than smallest int32 or * greater than largest int32). * * Counterpart to Solidity's `int32` operator. * * Requirements: * * - input must fit into 32 bits */ function toInt32(int256 value) internal pure returns (int32 downcasted) { downcasted = int32(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(32, value); } } /** * @dev Returns the downcasted int24 from int256, reverting on * overflow (when the input is less than smallest int24 or * greater than largest int24). * * Counterpart to Solidity's `int24` operator. * * Requirements: * * - input must fit into 24 bits */ function toInt24(int256 value) internal pure returns (int24 downcasted) { downcasted = int24(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(24, value); } } /** * @dev Returns the downcasted int16 from int256, reverting on * overflow (when the input is less than smallest int16 or * greater than largest int16). * * Counterpart to Solidity's `int16` operator. * * Requirements: * * - input must fit into 16 bits */ function toInt16(int256 value) internal pure returns (int16 downcasted) { downcasted = int16(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(16, value); } } /** * @dev Returns the downcasted int8 from int256, reverting on * overflow (when the input is less than smallest int8 or * greater than largest int8). * * Counterpart to Solidity's `int8` operator. * * Requirements: * * - input must fit into 8 bits */ function toInt8(int256 value) internal pure returns (int8 downcasted) { downcasted = int8(value); if (downcasted != value) { revert SafeCastOverflowedIntDowncast(8, value); } } /** * @dev Converts an unsigned uint256 into a signed int256. * * Requirements: * * - input must be less than or equal to maxInt256. */ function toInt256(uint256 value) internal pure returns (int256) { // Note: Unsafe cast below is okay because `type(int256).max` is guaranteed to be positive if (value > uint256(type(int256).max)) { revert SafeCastOverflowedUintToInt(value); } return int256(value); } /** * @dev Cast a boolean (false or true) to a uint256 (0 or 1) with no jump. */ function toUint(bool b) internal pure returns (uint256 u) { assembly ("memory-safe") { u := iszero(iszero(b)) } } }
{ "evmVersion": "paris", "optimizer": { "enabled": true, "mode": "3" }, "outputSelection": { "*": { "*": [ "abi", "metadata" ], "": [ "ast" ] } }, "detectMissingLibraries": false, "forceEVMLA": false, "enableEraVMExtensions": false, "libraries": {} }
[{"inputs":[{"internalType":"address","name":"initialOwner","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"},{"internalType":"uint256","name":"tokenId","type":"uint256"}],"name":"ERC1155InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC1155InvalidApprover","type":"error"},{"inputs":[{"internalType":"uint256","name":"idsLength","type":"uint256"},{"internalType":"uint256","name":"valuesLength","type":"uint256"}],"name":"ERC1155InvalidArrayLength","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"}],"name":"ERC1155InvalidOperator","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC1155InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC1155InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"address","name":"owner","type":"address"}],"name":"ERC1155MissingApprovalForAll","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":"account","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":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"indexed":false,"internalType":"uint256[]","name":"values","type":"uint256[]"}],"name":"TransferBatch","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"operator","type":"address"},{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"id","type":"uint256"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"TransferSingle","type":"event"},{"anonymous":false,"inputs":[{"indexed":false,"internalType":"string","name":"value","type":"string"},{"indexed":true,"internalType":"uint256","name":"id","type":"uint256"}],"name":"URI","type":"event"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address[]","name":"accounts","type":"address[]"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"}],"name":"balanceOfBatch","outputs":[{"internalType":"uint256[]","name":"","type":"uint256[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"}],"name":"burnBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"address","name":"operator","type":"address"}],"name":"isApprovedForAll","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"amounts","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"mintBatch","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256[]","name":"ids","type":"uint256[]"},{"internalType":"uint256[]","name":"values","type":"uint256[]"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeBatchTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"bytes","name":"data","type":"bytes"}],"name":"safeTransferFrom","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"operator","type":"address"},{"internalType":"bool","name":"approved","type":"bool"}],"name":"setApprovalForAll","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"},{"internalType":"string","name":"newuri","type":"string"}],"name":"setTokenURI","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":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"uri","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"}]
Contract Creation Code
9c4d535b0000000000000000000000000000000000000000000000000000000000000000010003cdbce1555dd80ae7151c93b67c187f7f63f7599a62c17921ae9a2c1342000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000200000000000000000000000003d77d34fc6f50da4c8cd322d70bfe0a580d70b40
Deployed Bytecode
0x0001000000000002000c0000000000020000008004000039000000400040043f000000600310027000000380033001970000000100200190000000470000c13d000000040030008c000000690000413d000000000201043b000000e0022002700000038b0020009c0000006b0000a13d0000038c0020009c000000900000a13d0000038d0020009c000002700000a13d0000038e0020009c000003ec0000613d0000038f0020009c0000043c0000613d000003900020009c000000690000c13d000000640030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000c00000002001d000003830020009c000000690000213d0000004402100370000000000202043b0000002401100370000000000301043b0000000301000039000000000101041a00000383041001970000000001000411000000000014004b000006330000c13d000200000004001d000400000002001d000300000003001d000000000030043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000101041a0000000402000029000000000021004b0000068f0000813d000000400100043d0000004402100039000003b603000041000000000032043500000024021000390000001903000039000006840000013d0000000002000416000000000002004b000000690000c13d0000001f0230003900000381022001970000008002200039000000400020043f0000001f0530018f00000382063001980000008002600039000000570000613d000000000701034f000000007807043c0000000004840436000000000024004b000000530000c13d000000000005004b000000640000613d000000000161034f0000000304500210000000000502043300000000054501cf000000000545022f000000000101043b0000010004400089000000000141022f00000000014101cf000000000151019f0000000000120435000000200030008c000000690000413d000000800200043d000003830020009c000000870000a13d000000000100001900000dfc00010430000003980020009c0000013e0000213d0000039e0020009c0000028e0000213d000003a10020009c0000045b0000613d000003a20020009c000000690000c13d000000240030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000401100370000000000201043b000003be00200198000000690000c13d0000000101000039000003bf02200197000003c00020009c0000057f0000613d000003c10020009c0000057f0000613d000003c20020009c000000000100c019000000800010043f000003b00100004100000dfb0001042e000000400100043d000003840010009c000002430000a13d000003bb01000041000000000010043f0000004101000039000000040010043f000003a40100004100000dfc00010430000003930020009c000002560000213d000003960020009c000004750000613d000003970020009c000000690000c13d000000840030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000a00000002001d000003830020009c000000690000213d0000004402100370000000000202043b000600000002001d0000002402100370000000000202043b000500000002001d0000006402100370000000000402043b000003a60040009c000000690000213d0000002302400039000000000032004b000000690000813d0000000405400039000000000251034f000000000202043b000003a60020009c0000008a0000213d0000001f07200039000003c3077001970000003f07700039000003c307700197000003ad0070009c0000008a0000213d00000024044000390000008007700039000000400070043f000000800020043f0000000004420019000000000034004b000000690000213d0000002003500039000000000331034f000003c3042001980000001f0520018f000000a001400039000000cb0000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000000c70000c13d000000000005004b000000d80000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a00120003900000000000104350000000301000039000000000101041a00000383021001970000000001000411000000000012004b000006330000c13d000400000002001d0000000a0000006b0000043a0000613d000000400300043d00000060023000390000000601000029000800000002001d000000000012043500000001010000390000000004130436000000400230003900000000001204350000000501000029000700000004001d00000000001404350000008001300039000000400010043f000300000002001d0000000002020433000900000003001d0000000003030433000000000023004b000007550000c13d000000000003004b000007ba0000c13d0000004002000039000000000221043600000009030000290000000004030433000000400310003900000000004304350000006003100039000000000004004b0000010a0000613d000000000500001900000009060000290000002006600039000000000706043300000000037304360000000105500039000000000045004b000001040000413d00000000041300490000000000420435000000030200002900000000040204330000000002430436000000000004004b000001190000613d000000000300001900000003050000290000002005500039000000000605043300000000026204360000000103300039000000000043004b000001130000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab04000041000000040500002900000000060000190000000a070000290dfa0df00000040f0000000100200190000000690000613d00000009010000290000000001010433000000010010008c000008640000c13d00000008010000290000000005010433000000070100002900000000040104330000008006000039000000040100002900000000020000190000000a030000290dfa0d030000040f0000086b0000013d000003990020009c000003230000213d0000039c0020009c0000048d0000613d0000039d0020009c000000690000c13d000000a40030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000c00000002001d000003830020009c000000690000213d0000002402100370000000000202043b000600000002001d000003830020009c000000690000213d0000004402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b000000690000813d0000000404200039000000000441034f000000000504043b000003a60050009c0000008a0000213d00000005045002100000003f06400039000003b406600197000003ad0060009c0000008a0000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000690000213d000000000005004b000001750000613d0000008005000039000000000621034f000000000606043b000000200550003900000000006504350000002002200039000000000042004b0000016e0000413d0000006402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b0000000005000019000003b505008041000003b504400197000000000004004b0000000006000019000003b506004041000003b50040009c000000000605c019000000000006004b000000690000c13d0000000404200039000000000441034f000000000404043b000003a60040009c0000008a0000213d00000005054002100000003f06500039000003b406600197000000400700043d0000000006670019000300000007001d000000000076004b00000000070000390000000107004039000003a60060009c0000008a0000213d00000001007001900000008a0000c13d000000400060043f00000003060000290000000006460436000500000006001d00000024022000390000000005250019000000000035004b000000690000213d000000000004004b000001a90000613d0000000304000029000000000621034f000000000606043b000000200440003900000000006404350000002002200039000000000052004b000001a20000413d0000008402100370000000000402043b000003a60040009c000000690000213d0000002302400039000000000032004b0000000005000019000003b505008041000003b502200197000000000002004b0000000006000019000003b506004041000003b50020009c000000000605c019000000000006004b000000690000c13d0000000405400039000000000251034f000000000202043b000003a60020009c0000008a0000213d0000001f07200039000003c3077001970000003f07700039000003c307700197000000400800043d0000000007780019000200000008001d000000000087004b00000000080000390000000108004039000003a60070009c0000008a0000213d00000001008001900000008a0000c13d0000002408400039000000400070043f000000020400002900000000042404360000000007820019000000000037004b000000690000213d0000002003500039000000000331034f000003c3052001980000001f0620018f0000000001540019000001df0000613d000000000703034f0000000008040019000000007907043c0000000008980436000000000018004b000001db0000c13d000000000006004b000001ec0000613d000000000353034f0000000305600210000000000601043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f0000000000310435000000000124001900000000000104350000000c01000029000903830010019b0000000001000411000000090010006b000009710000c13d0000000601000029000403830010019c0000043a0000613d000000090000006b000006910000613d00000003010000290000000001010433000000800200043d000000000012004b0000071b0000c13d000000000002004b000009a20000c13d000000400100043d000000400200003900000000022104360000004003100039000000800400043d00000000004304350000006003100039000000000004004b000002100000613d000000800500003900000000060000190000002005500039000000000705043300000000037304360000000106600039000000000046004b0000020a0000413d00000000041300490000000000420435000000030200002900000000040204330000000002430436000000000004004b0000021f0000613d000000000300001900000003050000290000002005500039000000000605043300000000026204360000000103300039000000000043004b000002190000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab040000410000000005000411000000090600002900000004070000290dfa0df00000040f0000000100200190000000690000613d000000800100043d000000010010008c00000a1e0000c13d00000005010000290000000005010433000000a00400043d00000000010004110000000c02000029000000060300002900000002060000290dfa0d030000040f000000000100001900000dfb0001042e0000002003100039000000400030043f00000000000104350000000201000039000000000301041a000000010430019000000001033002700000007f0330618f0000001f0030008c00000000050000390000000105002039000000000054004b000003d80000613d000003bb01000041000000000010043f0000002201000039000000040010043f000003a40100004100000dfc00010430000003940020009c000005690000613d000003950020009c000000690000c13d000000440030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000c00000002001d000003830020009c000000690000213d0000002401100370000000000201043b000000000002004b0000000001000039000000010100c039000b00000002001d000000000012004b000000690000c13d0000000c0000006b000006380000c13d000003b301000041000003e80000013d000003910020009c000005720000613d000003920020009c000000690000c13d000000440030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000003830020009c000000690000213d0000002401100370000000000101043b000c00000001001d000003830010009c000000690000213d000000000020043f0000000101000039000000200010043f00000040010000390dfa0ddf0000040f0000000c020000290dfa0a2f0000040f000000000101041a000000ff001001900000000001000039000000010100c0390000046e0000013d0000039f0020009c000005820000613d000003a00020009c000000690000c13d000000440030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b0000002404100370000000000504043b000003a60050009c000000690000213d0000002304500039000000000034004b000000690000813d0000000406500039000000000461034f000000000404043b000003a60040009c0000008a0000213d0000001f07400039000003c3077001970000003f07700039000003c307700197000003ad0070009c0000008a0000213d00000024055000390000008007700039000000400070043f000000800040043f0000000005540019000000000035004b000000690000213d0000002003600039000000000331034f000003c3054001980000001f0640018f000000a001500039000002be0000613d000000a007000039000000000803034f000000008908043c0000000007970436000000000017004b000002ba0000c13d000000000006004b000002cb0000613d000000000353034f0000000305600210000000000601043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f0000000000310435000000a00140003900000000000104350000000301000039000000000101041a00000383031001970000000001000411000000000013004b000006330000c13d000000000020043f0000000401000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000800200043d000c00000002001d000003a60020009c0000008a0000213d000b00000001001d000000000101041a000000010010019000000001021002700000007f0220618f000a00000002001d0000001f0020008c00000000020000390000000102002039000000000121013f0000000100100190000002500000c13d0000000a01000029000000200010008c0000030f0000413d0000000b01000029000000000010043f0000000001000414000003800010009c0000038001008041000000c001100210000003b1011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d0000000c030000290000001f023000390000000502200270000000200030008c0000000002004019000000000301043b0000000a010000290000001f01100039000000050110027000000000011300190000000002230019000000000012004b0000030f0000813d000000000002041b0000000102200039000000000012004b0000030b0000413d0000000c010000290000001f0010008c000008000000a13d0000000b01000029000000000010043f0000000001000414000003800010009c0000038001008041000000c001100210000003b1011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000200200008a0000000c02200180000000000101043b000008bc0000c13d000000a003000039000008ca0000013d0000039a0020009c000005c10000613d0000039b0020009c000000690000c13d000000640030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000500000002001d000003830020009c000000690000213d0000002402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b000000690000813d0000000404200039000000000441034f000000000504043b000003a60050009c0000008a0000213d00000005045002100000003f06400039000003b406600197000003ad0060009c0000008a0000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000690000213d000000000005004b000003530000613d0000008005000039000000000621034f000000000606043b000000200550003900000000006504350000002002200039000000000042004b0000034c0000413d0000004402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b0000000005000019000003b505008041000003b504400197000000000004004b0000000006000019000003b506004041000003b50040009c000000000605c019000000000006004b000000690000c13d0000000404200039000000000441034f000000000404043b000003a60040009c0000008a0000213d00000005054002100000003f06500039000003b406600197000000400700043d0000000006670019000800000007001d000000000076004b00000000070000390000000107004039000003a60060009c0000008a0000213d00000001007001900000008a0000c13d000000400060043f00000008060000290000000006460436000900000006001d00000024022000390000000005250019000000000035004b000000690000213d000000000004004b000003870000613d0000000803000029000000000421034f000000000404043b000000200330003900000000004304350000002002200039000000000052004b000003800000413d0000000301000039000000000101041a000403830010019b0000000001000411000000040010006b000006330000c13d000000800100043d000000000001004b000008800000c13d0000000501000029000c03830010019c000006910000613d000000400100043d000003840010009c0000008a0000213d0000002002100039000000400020043f000000000001043500000008010000290000000001010433000000800200043d000000000012004b0000071b0000c13d000000000002004b000009140000c13d000000400100043d000000400200003900000000022104360000004003100039000000800400043d00000000004304350000006003100039000000000004004b000003b10000613d000000800500003900000000060000190000002005500039000000000705043300000000037304360000000106600039000000000046004b000003ab0000413d00000000041300490000000000420435000000080200002900000000040204330000000002430436000000000004004b000003c00000613d000000000300001900000008060000290000002006600039000000000506043300000000025204360000000103300039000000000043004b000003ba0000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab0400004100000004050000290000000c0600002900000000070000190dfa0df00000040f0000000100200190000000690000613d0000048b0000013d0000038306200197000000200030008c000003e40000413d000000000010043f00000385020000410000001f033000390000000503300270000003860330009a000000000002041b0000000102200039000000000032004b000003e00000413d000000000001041b000000000006004b000006190000c13d000003ac01000041000000000010043f000000040000043f000003a40100004100000dfc00010430000000a40030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000c00000002001d000003830020009c000000690000213d0000002402100370000000000202043b000b00000002001d000003830020009c000000690000213d0000006402100370000000000202043b000a00000002001d0000004402100370000000000202043b000900000002001d0000008402100370000000000402043b000003a60040009c000000690000213d0000002302400039000000000032004b000000690000813d0000000405400039000000000251034f000000000202043b000003a60020009c0000008a0000213d0000001f07200039000003c3077001970000003f07700039000003c307700197000003ad0070009c0000008a0000213d00000024044000390000008007700039000000400070043f000000800020043f0000000004420019000000000034004b000000690000213d0000002003500039000000000331034f000003c3042001980000001f0520018f000000a001400039000004260000613d000000a006000039000000000703034f000000007807043c0000000006860436000000000016004b000004220000c13d000000000005004b000004330000613d000000000343034f0000000304500210000000000501043300000000054501cf000000000545022f000000000303043b0000010004400089000000000343022f00000000034301cf000000000353019f0000000000310435000000a001200039000000000001043500000000020004110000000c0020006b000007210000c13d0000000b0000006b000007480000c13d000003bc01000041000003e80000013d000000240030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000401100370000000000601043b000003830060009c000000690000213d0000000303000039000000000103041a00000383051001970000000002000411000000000025004b0000062e0000c13d000000000006004b000003e70000613d0000038701100197000000000161019f000000000013041b0000000001000414000003800010009c0000038001008041000000c00110021000000388011001c70000800d0200003900000389040000410dfa0df00000040f0000000100200190000000690000613d0000048b0000013d000000440030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000c00000002001d000003830020009c000000690000213d0000002401100370000000000101043b000000000010043f000000200000043f00000040010000390dfa0ddf0000040f0000000c020000290dfa0a2f0000040f000000000101041a000000400200043d0000000000120435000003800020009c00000380020080410000004001200210000003af011001c700000dfb0001042e0000000001000416000000000001004b000000690000c13d0000000303000039000000000103041a00000383051001970000000002000411000000000025004b0000062e0000c13d0000038701100197000000000013041b0000000001000414000003800010009c0000038001008041000000c00110021000000388011001c70000800d02000039000003890400004100000000060000190dfa0df00000040f0000000100200190000000690000613d000000000100001900000dfb0001042e000000840030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000800000002001d000003830020009c000000690000213d0000002402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b000000690000813d0000000404200039000000000441034f000000000504043b000003a60050009c0000008a0000213d00000005045002100000003f06400039000003b406600197000003ad0060009c0000008a0000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000690000213d000000000005004b000004b90000613d0000008005000039000000000621034f000000000606043b000000200550003900000000006504350000002002200039000000000042004b000004b20000413d0000004402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b0000000005000019000003b505008041000003b504400197000000000004004b0000000006000019000003b506004041000003b50040009c000000000605c019000000000006004b000000690000c13d0000000404200039000000000441034f000000000404043b000003a60040009c0000008a0000213d00000005054002100000003f06500039000003b406600197000000400700043d0000000006670019000a00000007001d000000000076004b00000000070000390000000107004039000003a60060009c0000008a0000213d00000001007001900000008a0000c13d000000400060043f0000000a060000290000000006460436000900000006001d00000024022000390000000005250019000000000035004b000000690000213d000000000004004b000004ed0000613d0000000a04000029000000000621034f000000000606043b000000200440003900000000006404350000002002200039000000000052004b000004e60000413d0000006402100370000000000402043b000003a60040009c000000690000213d0000002302400039000000000032004b0000000005000019000003b505008041000003b502200197000000000002004b0000000006000019000003b506004041000003b50020009c000000000605c019000000000006004b000000690000c13d0000000405400039000000000251034f000000000202043b000003a60020009c0000008a0000213d0000001f07200039000003c3077001970000003f07700039000003c307700197000000400800043d0000000007780019000700000008001d000000000087004b00000000080000390000000108004039000003a60070009c0000008a0000213d00000001008001900000008a0000c13d0000002408400039000000400070043f000000070400002900000000042404360000000007820019000000000037004b000000690000213d0000002003500039000000000331034f000003c3052001980000001f0620018f0000000001540019000005230000613d000000000703034f0000000008040019000000007907043c0000000008980436000000000018004b0000051f0000c13d000000000006004b000005300000613d000000000353034f0000000305600210000000000601043300000000065601cf000000000656022f000000000303043b0000010005500089000000000353022f00000000035301cf000000000363019f0000000000310435000000000124001900000000000104350000000301000039000000000101041a00000383021001970000000001000411000000000012004b000006330000c13d000000800100043d000000000001004b0000055f0000613d00000000020000190000000a010000290000000001010433000000000021004b0000090e0000a13d000c00000002001d000000050120021000000009021000290000000002020433000b00000002001d000000a0011000390000000001010433000000000010043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a0000000b03000029000000000032001a000007150000413d0000000002320019000000000021041b0000000c020000290000000102200039000000800100043d000000000012004b0000053c0000413d000000080100002900000383001001980000043a0000613d000000800200003900000008010000290000000a0300002900000007040000290dfa0a3f0000040f000000000100001900000dfb0001042e0000000001000416000000000001004b000000690000c13d0000000301000039000000000101041a0000038301100197000000800010043f000003b00100004100000dfb0001042e000000240030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000401100370000000000101043b000000000010043f0000000501000039000000200010043f00000040010000390dfa0ddf0000040f000000000101041a000000800010043f000003b00100004100000dfb0001042e000000240030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000401100370000000000101043b000000000010043f0000000401000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a000000010320019000000001062002700000007f0660618f0000001f0060008c00000000040000390000000104002039000000000442013f0000000100400190000002500000c13d000000400500043d0000000008650436000000000003004b0000066c0000613d000a00000006001d000b00000005001d000c00000008001d000000000010043f0000000001000414000003800010009c0000038001008041000000c001100210000003b1011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d0000000a06000029000000000006004b00000000020000190000000c080000290000000b05000029000006710000613d000000000101043b00000000020000190000000003280019000000000401041a000000000043043500000001011000390000002002200039000000000062004b000005b90000413d000006710000013d000000440030008c000000690000413d0000000002000416000000000002004b000000690000c13d0000000402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b000000690000813d0000000404200039000000000441034f000000000504043b000003a60050009c0000008a0000213d00000005045002100000003f06400039000003b406600197000003ad0060009c0000008a0000213d0000008006600039000000400060043f000000800050043f00000024022000390000000004240019000000000034004b000000690000213d000000000005004b000005e90000613d000000a005000039000000000621034f000000000606043b000003830060009c000000690000213d00000000056504360000002002200039000000000042004b000005e10000413d0000002402100370000000000202043b000003a60020009c000000690000213d0000002304200039000000000034004b0000000005000019000003b505008041000003b504400197000000000004004b0000000006000019000003b506004041000003b50040009c000000000605c019000000000006004b000000690000c13d0000000404200039000000000441034f000000000504043b000003a60050009c0000008a0000213d00000005065002100000003f04600039000003b407400197000000400400043d0000000007740019000000000047004b00000000080000390000000108004039000003a60070009c0000008a0000213d00000001008001900000008a0000c13d000000400070043f0000000007540436000900000007001d00000024022000390000000006260019000000000036004b000000690000213d000000000005004b0000080b0000c13d000000800400043d000000000004004b00000000050000190000000002000019000008190000613d0000084c0000013d0000000303000039000000000103041a0000038702100197000000000262019f000000000023041b00000000020004140000038305100197000003800020009c0000038002008041000000c00120021000000388011001c70000800d0200003900000389040000410dfa0df00000040f0000000100200190000000690000613d0000002001000039000001000010044300000120000004430000038a0100004100000dfb0001042e000003a301000041000000000010043f000000040020043f000003a40100004100000dfc00010430000003a302000041000000000020043f000000040010043f000003a40100004100000dfc000104300000000001000411000000000010043f0000000101000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a000003c4022001970000000b03000029000000000232019f000000000021041b000000400100043d0000000000310435000003800010009c000003800100804100000040011002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003b1011001c70000800d020000390000000303000039000003b20400004100000000050004110000000c060000290dfa0df00000040f0000000100200190000000690000613d0000048b0000013d000003c4012001970000000000180435000000000006004b000000200200003900000000020060390000003f01200039000003c3031001970000000001530019000000000031004b00000000030000390000000103004039000003a60010009c0000008a0000213d00000001003001900000008a0000c13d000000400010043f0000000003050433000000000003004b000006930000c13d0000004402100039000003bd03000041000000000032043500000024021000390000001d030000390000000000320435000003b7020000410000000000210435000000040210003900000020030000390000000000320435000003800010009c00000380010080410000004001100210000003b8011001c700000dfc000104300000000c0000006b000006b00000c13d000003ba01000041000003e80000013d00000020030000390000000003310436000000000405043300000000004304350000004003100039000000000004004b000006a20000613d000000000500001900000000063500190000000007580019000000000707043300000000007604350000002005500039000000000045004b0000069b0000413d0000001f05400039000003c3025001970000000004430019000000000004043500000000021200490000000002320019000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f00000dfb0001042e000000400400043d0000006001400039000700000001001d000000000021043500000001010000390000000002140436000000400340003900000000001304350000000301000029000600000002001d00000000001204350000008001400039000000400010043f000000a002400039000003a60020009c0000008a0000213d000000000012004b0000008a0000413d000000400020043f0000000000010435000100000003001d0000000001030433000500000004001d0000000002040433000000000012004b0000071b0000c13d000000000002004b0000075b0000c13d000000400100043d0000004002000039000000000221043600000005030000290000000004030433000000400310003900000000004304350000006003100039000000000004004b000006de0000613d000000000500001900000005070000290000002007700039000000000607043300000000036304360000000105500039000000000045004b000006d80000413d00000000041300490000000000420435000000010200002900000000040204330000000002430436000000000004004b000006ed0000613d000000000300001900000001060000290000002006600039000000000506043300000000025204360000000103300039000000000043004b000006e70000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab0400004100000002050000290000000c0600002900000000070000190dfa0df00000040f0000000100200190000000690000613d0000000301000029000000000010043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a000000040220006c0000087d0000813d000003bb01000041000000000010043f0000001101000039000000040010043f000003a40100004100000dfc00010430000003a703000041000000000030043f000000040020043f000000240010043f000003a80100004100000dfc000104300000000c01000029000000000010043f0000000101000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b00000000020004110000038302200197000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000101041a000000ff00100190000004380000c13d000003ae01000041000000000010043f0000000001000411000000040010043f0000000c01000029000000240010043f000003a80100004100000dfc000104300000000c0000006b000006910000613d00000009010000290000000a020000290dfa0bf80000040f0000000003010019000000000402001900000080050000390000000c010000290000000b020000290dfa0af10000040f000000000100001900000dfb0001042e000003a701000041000000000010043f000000040030043f000000240020043f000003a80100004100000dfc000104300000000002000019000900000002001d0000000501200210000000060210002900000007011000290000000001010433000a00000001001d0000000001020433000b00000001001d000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000301041a0000000a040000290008000000430053000008520000413d0000000b01000029000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000802000029000000000021041b0000000902000029000000010220003900000005010000290000000001010433000000000012004b0000075c0000413d000000010010008c000006cc0000c13d0000000601000029000000000101043300000007020000290000000002020433000000400300043d000000200430003900000000002404350000000000130435000003800030009c000003800300804100000040013002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d020000390000000403000039000003a904000041000006fe0000013d00008010040000390000000003000019000c00000003001d0000000501300210000000070210002900000008011000290000000001010433000b00000001001d0000000001020433000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700000000020400190dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000a02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d0000801004000039000000000101043b000000000201041a0000000b03000029000000000032001a000007150000413d0000000002320019000000000021041b0000000c03000029000000010330003900000009010000290000000002010433000000000023004b000007bc0000413d000000400100043d000000010020008c000000f90000c13d0000000702000029000000000202043300000008030000290000000003030433000000200410003900000000003404350000000000210435000003800010009c000003800100804100000040011002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d020000390000000403000039000003a9040000410000012a0000013d0000000c0000006b0000000001000019000008040000613d000000a00100043d0000000c040000290000000302400210000003c50220027f000003c502200167000000000221016f0000000101400210000008d70000013d0000000005040019000000000721034f000000000707043b000000200550003900000000007504350000002002200039000000000062004b0000080c0000413d0000000002040433000000800400043d000000000024004b0000084b0000c13d000003a60020009c0000008a0000213d00000005042002100000003f05400039000003b906500197000000400500043d000800000005001d0000000005560019000000000065004b00000000060000390000000106004039000003a60050009c0000008a0000213d00000001006001900000008a0000c13d000000400050043f00000008050000290000000002250436000700000002001d0000001f0240018f000000000004004b000008340000613d000000000131034f00000007034000290000000704000029000000001501043c0000000004540436000000000034004b000008300000c13d000000000002004b000000800100043d000000000001004b000008dc0000c13d000000400100043d000000200200003900000000022104360000000803000029000000000303043300000000003204350000004002100039000000000003004b000008490000613d000000000400001900000008060000290000002006600039000000000506043300000000025204360000000104400039000000000034004b000008430000413d0000000002120049000006a80000013d0000000005020019000003a701000041000000000010043f000000040050043f000000240040043f000003a80100004100000dfc00010430000000400200043d000900000002001d000003aa01000041000000000012043500000004012000390000000c020000290000000b050000290dfa0c050000040f00000009020000290000000001210049000003800010009c00000380010080410000006001100210000003800020009c00000380020080410000004002200210000000000121019f00000dfc000104300000008006000039000000040100002900000000020000190000000a03000029000000090400002900000003050000290dfa0c0f0000040f0000000501000029000000000010043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a000000060020002a000007150000413d0000000602200029000000000021041b000000000100001900000dfb0001042e0000000002000019000c00000002001d0000000501200210000b00000001001d000000a001100039000a00000001001d0000000001010433000000000010043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000080200002900000000020204330000000c03000029000000000032004b0000090e0000a13d0000000b0400002900000009024000290000000002020433000000000101043b000000000101041a000000000021004b000000400000413d000b00000002001d000000800100043d000000000031004b0000090e0000a13d0000000a010000290000000001010433000000000010043f0000000501000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a0000000b0220006c000007150000413d000000000021041b0000000c020000290000000102200039000000800100043d000000000012004b000008810000413d000003900000013d000000010320008a0000000503300270000000000331001900000020040000390000000103300039000000000504001900000080044000390000000004040433000000000041041b00000020045000390000000101100039000000000031004b000008c10000c13d000000a0035000390000000c0020006c000008d40000813d0000000c020000290000000302200210000000f80220018f000003c50220027f000003c5022001670000000003030433000000000223016f000000000021041b00000001010000390000000c020000290000000102200210000000000112019f0000000b02000029000000000012041b000000000100001900000dfb0001042e00008010020000390000000004000019000b00000004001d000000050340021000000009013000290000000001010433000a00000003001d000000a0033000390000000003030433000c00000003001d000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c70dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c020000290000038302200197000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000080200002900000000020204330000000b04000029000000000042004b0000090e0000a13d0000000a050000290000000702500029000000000101043b000000000101041a00000000001204350000000104400039000000800100043d000000000014004b0000801002000039000008de0000413d000008380000013d000003bb01000041000000000010043f0000003201000039000000040010043f000003a40100004100000dfc000104300000000002000019000700000002001d000000050120021000000009021000290000000002020433000a00000002001d000000a0011000390000000001010433000b00000001001d000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000301041a0000000a040000290006000000430053000009980000413d0000000b01000029000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000c02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000602000029000000000021041b00000007020000290000000102200039000000800100043d000000000012004b000009150000413d000000010010008c000003a00000c13d00000009010000290000000001010433000000400200043d0000002003200039000000a00400043d00000000001304350000000000420435000003800020009c000003800200804100000040012002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d020000390000000403000039000003a904000041000003d10000013d0000000901000029000000000010043f0000000101000039000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b00000000020004110000038302200197000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000101041a000000ff00100190000001f30000c13d000003ae01000041000000000010043f0000000001000411000000040010043f0000000901000029000000240010043f000003a80100004100000dfc00010430000000400200043d000c00000002001d000003aa010000410000000000120435000000040120003900000005020000290000000b050000290dfa0c050000040f0000000c020000290000085b0000013d0000000002000019000800000002001d000000050120021000000005021000290000000002020433000a00000002001d000000a0011000390000000001010433000b00000001001d000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000301041a0007000a0030007400000a270000413d0000000b01000029000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000702000029000000000021041b0000000b01000029000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b0000000402000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f0000000100200190000000690000613d000000000101043b000000000201041a0000000a03000029000000000032001a000007150000413d0000000002320019000000000021041b00000008020000290000000102200039000000800100043d000000000012004b000009a30000413d000000010010008c000001ff0000c13d00000005010000290000000001010433000000400200043d0000002003200039000000a00400043d00000000001304350000000000420435000003800020009c000003800200804100000040012002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d020000390000000403000039000003a904000041000002300000013d000000800400003900000000010004110000000c020000290000000603000029000000030500002900000002060000290dfa0c0f0000040f000000000100001900000dfb0001042e000000400200043d000900000002001d000003aa01000041000000000012043500000004012000390000000c020000290000000a04000029000008580000013d0000038302200197000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000a3d0000613d000000000101043b000000000001042d000000000100001900000dfc000104300009000000000002000200000004001d0000000045030434000600000004001d0000000064020434000500000006001d000000000054004b00000ae50000c13d000100000001001d000703830010019b000000000004004b000300000003001d000400000002001d00000a970000613d000000070000006b00000a7e0000613d00008010050000390000000001000019000900000001001d0000000501100210000000050210002900000006011000290000000001010433000800000001001d0000000001020433000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700000000020500190dfa0df50000040f000000010020019000000ae30000613d000000000101043b0000000702000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000ae30000613d0000801005000039000000000101043b000000000201041a0000000803000029000000000032001a00000aeb0000413d0000000002320019000000000021041b0000000901000029000000010110003900000004020000290000000004020433000000000041004b00000a510000413d000000010040008c000000030300002900000a970000c13d0000000501000029000000000101043300000006020000290000000002020433000000400300043d000000200430003900000000002404350000000000130435000003800030009c000003800300804100000040013002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d0200003900000004030000390000000005000411000003a90400004100000ac80000013d000000400100043d000000400400003900000000094104360000000004020433000000400510003900000000004504350000006008100039000000000004004b00000aa80000613d000000000500001900000000060200190000002006600039000000000706043300000000087804360000000105500039000000000045004b00000aa20000413d00000000050004110000000004180049000000000049043500000000040304330000000002480436000000000004004b00000ab70000613d000000000800001900000000060300190000002006600039000000000706043300000000027204360000000108800039000000000048004b00000ab10000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab04000041000000000600001900000007070000290dfa0df00000040f000000010020019000000ae30000613d000000070000006b00000ae20000613d000000000100041100000004040000290000000002040433000000010020008c00000add0000c13d00000006020000290000000005020433000000050200002900000000040204330000000002000019000000010300002900000002060000290dfa0d030000040f000000000001042d00000000020000190000000103000029000000030500002900000002060000290dfa0c0f0000040f000000000001042d000000000100001900000dfc00010430000003a703000041000000000030043f000000040040043f000000240050043f000003a80100004100000dfc00010430000003bb01000041000000000010043f0000001101000039000000040010043f000003a40100004100000dfc00010430000d000000000002000200000005001d0000000065040434000500000006001d000600000003001d0000000036030434000400000003001d000000000056004b00000bec0000c13d000903830020019b000d03830010019b000000000006004b000300000001001d000100000002001d000800000004001d00000b8b0000613d0000801005000039000000000200001900000b0a0000013d000000060100002900000000010104330000000b020000290000000102200039000000000012004b00000b730000813d000b00000002001d0000000501200210000000040210002900000005011000290000000001010433000c00000001001d00000000020204330000000d0000006b00000b4f0000613d000a00000002001d000000000020043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700000000020500190dfa0df50000040f000000010020019000000bd70000613d000000000101043b0000000d02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000bd70000613d000000000101043b000000000301041a0007000c0030007400000bd90000413d0000000a01000029000000000010043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000bd70000613d000000000101043b0000000d02000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000bd70000613d000000000101043b0000000702000029000000000021041b000000080400002900008010050000390000000a02000029000000090000006b00000b040000613d000000000020043f000000200000043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700000000020500190dfa0df50000040f000000010020019000000bd70000613d000000000101043b0000000902000029000000000020043f000000200010043f0000000001000414000003800010009c0000038001008041000000c001100210000003a5011001c700008010020000390dfa0df50000040f000000010020019000000bd70000613d000000000101043b000000000201041a0000000c03000029000000000032001a00000bf20000413d0000000002320019000000000021041b0000000804000029000080100500003900000b040000013d000000010010008c00000b8b0000c13d0000000401000029000000000101043300000005020000290000000002020433000000400300043d000000200430003900000000002404350000000000130435000003800030009c000003800300804100000040013002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f000003a5011001c70000800d0200003900000004030000390000000005000411000003a90400004100000bbc0000013d000000400100043d0000004002000039000000000221043600000006060000290000000008060433000000400310003900000000008304350000006003100039000000000008004b00000b9c0000613d00000000050000190000002006600039000000000706043300000000037304360000000105500039000000000085004b00000b960000413d00000000050004110000000006130049000000000062043500000000080404330000000002830436000000000008004b00000bab0000613d000000000300001900000000060400190000002006600039000000000706043300000000027204360000000103300039000000000083004b00000ba50000413d0000000002120049000003800020009c00000380020080410000006002200210000003800010009c00000380010080410000004001100210000000000112019f0000000002000414000003800020009c0000038002008041000000c002200210000000000121019f00000388011001c70000800d020000390000000403000039000003ab040000410000000d0600002900000009070000290dfa0df00000040f000000010020019000000bd70000613d000000090000006b00000bd60000613d000000000100041100000006040000290000000002040433000000010020008c00000bd10000c13d00000005020000290000000005020433000000040200002900000000040204330000000302000029000000010300002900000002060000290dfa0d030000040f000000000001042d00000003020000290000000103000029000000080500002900000002060000290dfa0c0f0000040f000000000001042d000000000100001900000dfc00010430000000400200043d000d00000002001d000003aa010000410000000000120435000000040120003900000003020000290000000c040000290000000a050000290dfa0c050000040f0000000d020000290000000001210049000003800010009c00000380010080410000006001100210000003800020009c00000380020080410000004002200210000000000121019f00000dfc00010430000003a703000041000000000030043f000000040060043f000000240050043f000003a80100004100000dfc00010430000003bb01000041000000000010043f0000001101000039000000040010043f000003a40100004100000dfc00010430000000400300043d000000600430003900000000002404350000002002300039000000000012043500000001010000390000000000130435000000400230003900000000001204350000008001300039000000400010043f0000000001030019000000000001042d000000600610003900000000005604350000004005100039000000000045043500000020041000390000000000340435000003830220019700000000002104350000008001100039000000000001042d0008000000000002000500000006001d000400000005001d000300000004001d000100000002001d000200000001001d000003c6010000410000000000100443000600000003001d00000004003004430000000001000414000003800010009c0000038001008041000000c001100210000003c7011001c700008002020000390dfa0df50000040f000000010020019000000cc00000613d000000000101043b000000000001004b00000cbd0000613d000000400b00043d0000004401b00039000000a0020000390000000000210435000000010100002900000383011001970000002402b000390000000000120435000003c80100004100000000001b0435000000020100002900000383021001970000000401b00039000000000021043500000003070000290000000003070433000000a402b000390000000000320435000000c402b00039000000000003004b00000c430000613d000000000400001900000004060000290000002007700039000000000507043300000000025204360000000104400039000000000034004b00000c3c0000413d00000c440000013d000000040600002900000000031200490000006404b00039000000000034043500000000030604330000000002320436000000000003004b00000c520000613d00000000040000190000002006600039000000000506043300000000025204360000000104400039000000000034004b00000c4c0000413d00000000011200490000008403b000390000000000130435000000050100002900000000430104340000000001320436000000000003004b00000c620000613d000000000200001900000000051200190000000006240019000000000606043300000000006504350000002002200039000000000032004b00000c5b0000413d00000000023100190000000000020435000000000500041400000006020000290000038302200197000000040020008c00000c710000c13d0000000005000415000000080550008a00000005055002100000000003000031000000200030008c0000002004000039000000000403401900000ca80000013d0000001f03300039000003c3033001970000000003b300490000000001130019000003800010009c000003800100804100000060011002100000038000b0009c000003800300004100000000030b40190000004003300210000000000131019f000003800050009c0000038005008041000000c003500210000000000131019f000500000002001d00060000000b001d0dfa0df00000040f000000060b00002900000060031002700000038003300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900000c940000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000c900000c13d000000000006004b00000ca10000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f0000000005000415000000070550008a0000000505500210000000010020019000000cc10000613d00000005020000290000001f01400039000000600410018f0000000001b40019000000000041004b00000000040000390000000104004039000003a60010009c00000cf50000213d000000010040019000000cf50000c13d000000400010043f0000001f0030008c00000cbe0000a13d00000000010b0433000003be0010019800000cbe0000c13d0000000503500270000000000301001f000003bf01100197000003c80010009c00000cf00000c13d000000000001042d000000000100001900000dfc00010430000000000001042f000000000003004b00000cc60000c13d0000006002000039000000800400003900000cec0000013d0000001f0230003900000381022001970000003f02200039000003c904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000003a60040009c00000cf50000213d000000010050019000000cf50000c13d000000400040043f0000001f0530018f00000000043204360000038206300198000000000364001900000cdf0000613d000000000701034f0000000008040019000000007907043c0000000008980436000000000038004b00000cdb0000c13d000000000005004b00000cec0000613d000000000161034f0000000305500210000000000603043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001304350000000001020433000000000001004b000000050200002900000cfb0000c13d000003bc01000041000000000010043f000000040020043f000003a40100004100000dfc00010430000003bb01000041000000000010043f0000004101000039000000040010043f000003a40100004100000dfc00010430000003800040009c00000380040080410000004002400210000003800010009c00000380010080410000006001100210000000000121019f00000dfc000104300008000000000002000500000006001d000100000005001d000300000004001d000200000002001d000400000001001d000003c6010000410000000000100443000600000003001d00000004003004430000000001000414000003800010009c0000038001008041000000c001100210000003c7011001c700008002020000390dfa0df50000040f000000010020019000000d9b0000613d000000000101043b000000000001004b00000d980000613d000000400b00043d0000008401b00039000000a00200003900000000002104350000006401b00039000000010200002900000000002104350000004401b0003900000003020000290000000000210435000000020100002900000383011001970000002402b000390000000000120435000003ca0100004100000000001b0435000000040100002900000383011001970000000402b00039000000000012043500000005010000290000000032010434000000a401b000390000000000210435000000c401b00039000000000002004b00000d3c0000613d000000000400001900000000051400190000000006430019000000000606043300000000006504350000002004400039000000000024004b00000d350000413d00000000032100190000000000030435000000000300041400000006040000290000038306400197000000040060008c00000d4b0000c13d0000000005000415000000080550008a00000005055002100000000003000031000000200030008c0000002004000039000000000403401900000d830000013d0000001f02200039000003c3022001970000000002b200490000000001120019000003800010009c000003800100804100000060011002100000038000b0009c000003800200004100000000020b40190000004002200210000000000121019f000003800030009c0000038003008041000000c002300210000000000121019f000500000006001d000000000206001900060000000b001d0dfa0df00000040f000000060b00002900000060031002700000038003300197000000200030008c000000200400003900000000040340190000001f0640018f000000200740019000000000057b001900000d6f0000613d000000000801034f00000000090b0019000000008a08043c0000000009a90436000000000059004b00000d6b0000c13d000000000006004b00000d7c0000613d000000000771034f0000000306600210000000000805043300000000086801cf000000000868022f000000000707043b0000010006600089000000000767022f00000000066701cf000000000686019f0000000000650435000000000003001f0000000005000415000000070550008a0000000505500210000000010020019000000d9c0000613d00000005060000290000001f01400039000000600210018f0000000001b20019000000000021004b00000000020000390000000102004039000003a60010009c00000dd00000213d000000010020019000000dd00000c13d000000400010043f0000001f0030008c00000d990000a13d00000000010b0433000003be0010019800000d990000c13d0000000502500270000000000201001f000003bf01100197000003ca0010009c00000dcb0000c13d000000000001042d000000000100001900000dfc00010430000000000001042f000000000003004b00000da10000c13d0000006002000039000000800400003900000dc70000013d0000001f0230003900000381022001970000003f02200039000003c904200197000000400200043d0000000004420019000000000024004b00000000050000390000000105004039000003a60040009c00000dd00000213d000000010050019000000dd00000c13d000000400040043f0000001f0530018f00000000043204360000038206300198000000000364001900000dba0000613d000000000701034f0000000008040019000000007907043c0000000008980436000000000038004b00000db60000c13d000000000005004b00000dc70000613d000000000161034f0000000305500210000000000603043300000000065601cf000000000656022f000000000101043b0000010005500089000000000151022f00000000015101cf000000000161019f00000000001304350000000001020433000000000001004b000000050600002900000dd60000c13d000003bc01000041000000000010043f000000040060043f000003a40100004100000dfc00010430000003bb01000041000000000010043f0000004101000039000000040010043f000003a40100004100000dfc00010430000003800040009c00000380040080410000004002400210000003800010009c00000380010080410000006001100210000000000121019f00000dfc00010430000000000001042f000003800010009c000003800100804100000060011002100000000002000414000003800020009c0000038002008041000000c002200210000000000112019f00000388011001c700008010020000390dfa0df50000040f000000010020019000000dee0000613d000000000101043b000000000001042d000000000100001900000dfc0001043000000df3002104210000000102000039000000000001042d0000000002000019000000000001042d00000df8002104230000000102000039000000000001042d0000000002000019000000000001042d00000dfa0000043200000dfb0001042e00000dfc0001043000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffff00000000000000000000000000000000000000000000000000000001ffffffe000000000000000000000000000000000000000000000000000000000ffffffe0000000000000000000000000ffffffffffffffffffffffffffffffffffffffff000000000000000000000000000000000000000000000000ffffffffffffffdf405787fa12a823e0f2b7631cc41b3ba8828b3321ca811111fa75cd3aa3bb5acebfa87805ed57dc1f0d489ce33be4c4577d74ccde357eeeee058a32c55c44a532ffffffffffffffffffffffff000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000008be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0000000020000000000000000000000000000004000000100000000000000000000000000000000000000000000000000000000000000000000000000715018a500000000000000000000000000000000000000000000000000000000bd85b03800000000000000000000000000000000000000000000000000000000f242432900000000000000000000000000000000000000000000000000000000f242432a00000000000000000000000000000000000000000000000000000000f2fde38b00000000000000000000000000000000000000000000000000000000f5298aca00000000000000000000000000000000000000000000000000000000bd85b03900000000000000000000000000000000000000000000000000000000e985e9c5000000000000000000000000000000000000000000000000000000008da5cb5a000000000000000000000000000000000000000000000000000000008da5cb5b00000000000000000000000000000000000000000000000000000000a22cb46500000000000000000000000000000000000000000000000000000000715018a600000000000000000000000000000000000000000000000000000000731133e9000000000000000000000000000000000000000000000000000000001f7fdff9000000000000000000000000000000000000000000000000000000004e1273f3000000000000000000000000000000000000000000000000000000004e1273f4000000000000000000000000000000000000000000000000000000006b20c454000000000000000000000000000000000000000000000000000000001f7fdffa000000000000000000000000000000000000000000000000000000002eb2c2d6000000000000000000000000000000000000000000000000000000000e89341b000000000000000000000000000000000000000000000000000000000e89341c00000000000000000000000000000000000000000000000000000000162094c40000000000000000000000000000000000000000000000000000000000fdd58e0000000000000000000000000000000000000000000000000000000001ffc9a7118cdaa70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000240000000000000000000000000200000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffffff5b059991000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000044000000000000000000000000c3d58168c5ae7397731d063d5bbf3d657854427343f4c083240f7aacaa2d0f6203dee4c5000000000000000000000000000000000000000000000000000000004a39dc06d4c0dbc64b70af90fd698a233a518aa5d07e595d983b8c0526c8f7fb1e4fbdf700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ffffffffffffff7fe237d9220000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020000000800000000000000000020000000000000000000000000000000000002000000000000000000000000017307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31ced3e100000000000000000000000000000000000000000000000000000000007fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe080000000000000000000000000000000000000000000000000000000000000004275726e206578636565647320746f74616c20737570706c790000000000000008c379a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006400000000000000000000000000000000000000000000000000000000000000000000003fffffffffffffffe001a83514000000000000000000000000000000000000000000000000000000004e487b710000000000000000000000000000000000000000000000000000000057f447ce00000000000000000000000000000000000000000000000000000000555249206e6f742073657420666f72207468697320746f6b656e20494400000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000001ffc9a7000000000000000000000000000000000000000000000000000000000e89341c00000000000000000000000000000000000000000000000000000000d9b67a2600000000000000000000000000000000000000000000000000000000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1806aa1896bbf26568e884a7374b41e002500962caba6a15023a8d90e8508b830200000200000000000000000000000000000024000000000000000000000000bc197c810000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003ffffffe0f23a6e610000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000009c5484c30aaec20ad0314a817634f5d1a5bc2ecaa0dd980c52bc568e3dd0b2b7
Constructor Arguments (ABI-Encoded and is the last bytes of the Contract Creation Code above)
0000000000000000000000003d77d34fc6f50da4c8cd322d70bfe0a580d70b40
-----Decoded View---------------
Arg [0] : initialOwner (address): 0x3d77d34FC6F50dA4c8cD322d70Bfe0a580d70b40
-----Encoded View---------------
1 Constructor Arguments found :
Arg [0] : 0000000000000000000000003d77d34fc6f50da4c8cd322d70bfe0a580d70b40
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ 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.