ERC-20
Overview
Max Total Supply
10,000 FURNACE
Holders
3
Market
Onchain Market Cap
$0.00
Circulating Supply Market Cap
-
Other Info
Token Contract (WITH 18 Decimals)
Balance
9,999.999999999999986139 FURNACEValue
$0.00Loading...
Loading
Loading...
Loading
Loading...
Loading
# | Exchange | Pair | Price | 24H Volume | % Volume |
---|
Contract Source Code Verified (Exact Match)
Contract Name:
Furnace
Compiler Version
v0.8.24+commit.e11b9ed9
Contract Source Code (Solidity)
/** *Submitted for verification at Etherscan.io on 2024-02-23 */ // ..... // ..:-:.. // ..:---:.. // ..:-====:.. // ..:=======-.. // ..:=+++==+++-.. // ..:=**++==+**+-.. // ..:=##*+-::=*##*-.. // .:=%%#*-...:+#%%*-.. // .:=%%%#=:....-*%%@+:.. // ..-%@%%+:.. ..-#%@@=:. // ..-#@@%*:.. ..:+#%@%=:. // .:+@@%#-.. ..:*%@@#-.. // .:=%@@%=:.. ..:#%@@*:.. // ...... ..-#@@%*:.. ..:=%%@@+.. ...... // .:+*-:..:+%@%%=:.. ..:#%%@#:..:-+*-.. // ..:+%%*+=*%%%#:.. ..:*%%%%=+*#@#-.. // ..-*%@@%%%#*:.. ..:=##%%%@@#=:.. // ..:=*####*+:.. ..:=**####+:.. // ...:-=+++-:.. ..:=+++=-:.. // ...:::-::. ..:-:::.... // ...... ....... // In silence deep, where whispers creep, // A legend wakes from shadow's sleep. // A traveler bold, with metal cold, // Must seek the flames of tales untold. // What is this place, veiled in grace, // Where truth unwinds in fiery embrace? // https://furnace.gg/ // https://t.me/TheFurnace404 // https://twitter.com/Furnace404 // SPDX-License-Identifier: MIT pragma solidity ^0.8.21; /// @notice Simple single owner authorization mixin. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol) /// /// @dev Note: /// This implementation does NOT auto-initialize the owner to `msg.sender`. /// You MUST call the `_initializeOwner` in the constructor / initializer. /// /// While the ownable portion follows /// [EIP-173](https://eips.ethereum.org/EIPS/eip-173) for compatibility, /// the nomenclature for the 2-step ownership handover may be unique to this codebase. abstract contract Ownable { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The caller is not authorized to call the function. error Unauthorized(); /// @dev The `newOwner` cannot be the zero address. error NewOwnerIsZeroAddress(); /// @dev The `pendingOwner` does not have a valid handover request. error NoHandoverRequest(); /// @dev Cannot double-initialize. error AlreadyInitialized(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The ownership is transferred from `oldOwner` to `newOwner`. /// This event is intentionally kept the same as OpenZeppelin's Ownable to be /// compatible with indexers and [EIP-173](https://eips.ethereum.org/EIPS/eip-173), /// despite it not being as lightweight as a single argument event. event OwnershipTransferred(address indexed oldOwner, address indexed newOwner); /// @dev An ownership handover to `pendingOwner` has been requested. event OwnershipHandoverRequested(address indexed pendingOwner); /// @dev The ownership handover to `pendingOwner` has been canceled. event OwnershipHandoverCanceled(address indexed pendingOwner); /// @dev `keccak256(bytes("OwnershipTransferred(address,address)"))`. uint256 private constant _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE = 0x8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0; /// @dev `keccak256(bytes("OwnershipHandoverRequested(address)"))`. uint256 private constant _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE = 0xdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d; /// @dev `keccak256(bytes("OwnershipHandoverCanceled(address)"))`. uint256 private constant _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE = 0xfa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STORAGE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The owner slot is given by: /// `bytes32(~uint256(uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))))`. /// It is intentionally chosen to be a high value /// to avoid collision with lower slots. /// The choice of manual storage layout is to enable compatibility /// with both regular and upgradeable contracts. bytes32 internal constant _OWNER_SLOT = 0xffffffffffffffffffffffffffffffffffffffffffffffffffffffff74873927; /// The ownership handover slot of `newOwner` is given by: /// ``` /// mstore(0x00, or(shl(96, user), _HANDOVER_SLOT_SEED)) /// let handoverSlot := keccak256(0x00, 0x20) /// ``` /// It stores the expiry timestamp of the two-step ownership handover. uint256 private constant _HANDOVER_SLOT_SEED = 0x389a75e1; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Override to return true to make `_initializeOwner` prevent double-initialization. function _guardInitializeOwner() internal pure virtual returns (bool guard) {} /// @dev Initializes the owner directly without authorization guard. /// This function must be called upon initialization, /// regardless of whether the contract is upgradeable or not. /// This is to enable generalization to both regular and upgradeable contracts, /// and to save gas in case the initial owner is not the caller. /// For performance reasons, this function will not check if there /// is an existing owner. function _initializeOwner(address newOwner) internal virtual { if (_guardInitializeOwner()) { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT if sload(ownerSlot) { mstore(0x00, 0x0dc149f0) // `AlreadyInitialized()`. revert(0x1c, 0x04) } // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Store the new value. sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner)))) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner) } } else { /// @solidity memory-safe-assembly assembly { // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Store the new value. sstore(_OWNER_SLOT, newOwner) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, 0, newOwner) } } } /// @dev Sets the owner directly without authorization guard. function _setOwner(address newOwner) internal virtual { if (_guardInitializeOwner()) { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner) // Store the new value. sstore(ownerSlot, or(newOwner, shl(255, iszero(newOwner)))) } } else { /// @solidity memory-safe-assembly assembly { let ownerSlot := _OWNER_SLOT // Clean the upper 96 bits. newOwner := shr(96, shl(96, newOwner)) // Emit the {OwnershipTransferred} event. log3(0, 0, _OWNERSHIP_TRANSFERRED_EVENT_SIGNATURE, sload(ownerSlot), newOwner) // Store the new value. sstore(ownerSlot, newOwner) } } } /// @dev Throws if the sender is not the owner. function _checkOwner() internal view virtual { /// @solidity memory-safe-assembly assembly { // If the caller is not the stored owner, revert. if iszero(eq(caller(), sload(_OWNER_SLOT))) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } } } /// @dev Returns how long a two-step ownership handover is valid for in seconds. /// Override to return a different value if needed. /// Made internal to conserve bytecode. Wrap it in a public function if needed. function _ownershipHandoverValidFor() internal view virtual returns (uint64) { return 48 * 3600; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC UPDATE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Allows the owner to transfer the ownership to `newOwner`. function transferOwnership(address newOwner) public payable virtual onlyOwner { /// @solidity memory-safe-assembly assembly { if iszero(shl(96, newOwner)) { mstore(0x00, 0x7448fbae) // `NewOwnerIsZeroAddress()`. revert(0x1c, 0x04) } } _setOwner(newOwner); } /// @dev Allows the owner to renounce their ownership. function renounceOwnership() public payable virtual onlyOwner { _setOwner(address(0)); } /// @dev Request a two-step ownership handover to the caller. /// The request will automatically expire in 48 hours (172800 seconds) by default. function requestOwnershipHandover() public payable virtual { unchecked { uint256 expires = block.timestamp + _ownershipHandoverValidFor(); /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to `expires`. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, caller()) sstore(keccak256(0x0c, 0x20), expires) // Emit the {OwnershipHandoverRequested} event. log2(0, 0, _OWNERSHIP_HANDOVER_REQUESTED_EVENT_SIGNATURE, caller()) } } } /// @dev Cancels the two-step ownership handover to the caller, if any. function cancelOwnershipHandover() public payable virtual { /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to 0. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, caller()) sstore(keccak256(0x0c, 0x20), 0) // Emit the {OwnershipHandoverCanceled} event. log2(0, 0, _OWNERSHIP_HANDOVER_CANCELED_EVENT_SIGNATURE, caller()) } } /// @dev Allows the owner to complete the two-step ownership handover to `pendingOwner`. /// Reverts if there is no existing ownership handover requested by `pendingOwner`. function completeOwnershipHandover(address pendingOwner) public payable virtual onlyOwner { /// @solidity memory-safe-assembly assembly { // Compute and set the handover slot to 0. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, pendingOwner) let handoverSlot := keccak256(0x0c, 0x20) // If the handover does not exist, or has expired. if gt(timestamp(), sload(handoverSlot)) { mstore(0x00, 0x6f5e8818) // `NoHandoverRequest()`. revert(0x1c, 0x04) } // Set the handover slot to 0. sstore(handoverSlot, 0) } _setOwner(pendingOwner); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC READ FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the owner of the contract. function owner() public view virtual returns (address result) { /// @solidity memory-safe-assembly assembly { result := sload(_OWNER_SLOT) } } /// @dev Returns the expiry timestamp for the two-step ownership handover to `pendingOwner`. function ownershipHandoverExpiresAt(address pendingOwner) public view virtual returns (uint256 result) { /// @solidity memory-safe-assembly assembly { // Compute the handover slot. mstore(0x0c, _HANDOVER_SLOT_SEED) mstore(0x00, pendingOwner) // Load the handover slot. result := sload(keccak256(0x0c, 0x20)) } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* MODIFIERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Marks a function as only callable by the owner. modifier onlyOwner() virtual { _checkOwner(); _; } } /// @notice Simple single owner and multiroles authorization mixin. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/Ownable.sol) /// @dev While the ownable portion follows [EIP-173](https://eips.ethereum.org/EIPS/eip-173) /// for compatibility, the nomenclature for the 2-step ownership handover and roles /// may be unique to this codebase. abstract contract OwnableRoles is Ownable { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* EVENTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The `user`'s roles is updated to `roles`. /// Each bit of `roles` represents whether the role is set. event RolesUpdated(address indexed user, uint256 indexed roles); /// @dev `keccak256(bytes("RolesUpdated(address,uint256)"))`. uint256 private constant _ROLES_UPDATED_EVENT_SIGNATURE = 0x715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe26; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* STORAGE */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The role slot of `user` is given by: /// ``` /// mstore(0x00, or(shl(96, user), _ROLE_SLOT_SEED)) /// let roleSlot := keccak256(0x00, 0x20) /// ``` /// This automatically ignores the upper bits of the `user` in case /// they are not clean, as well as keep the `keccak256` under 32-bytes. /// /// Note: This is equivalent to `uint32(bytes4(keccak256("_OWNER_SLOT_NOT")))`. uint256 private constant _ROLE_SLOT_SEED = 0x8b78c6d8; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* INTERNAL FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Overwrite the roles directly without authorization guard. function _setRoles(address user, uint256 roles) internal virtual { /// @solidity memory-safe-assembly assembly { mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, user) // Store the new value. sstore(keccak256(0x0c, 0x20), roles) // Emit the {RolesUpdated} event. log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), roles) } } /// @dev Updates the roles directly without authorization guard. /// If `on` is true, each set bit of `roles` will be turned on, /// otherwise, each set bit of `roles` will be turned off. function _updateRoles(address user, uint256 roles, bool on) internal virtual { /// @solidity memory-safe-assembly assembly { mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, user) let roleSlot := keccak256(0x0c, 0x20) // Load the current value. let current := sload(roleSlot) // Compute the updated roles if `on` is true. let updated := or(current, roles) // Compute the updated roles if `on` is false. // Use `and` to compute the intersection of `current` and `roles`, // `xor` it with `current` to flip the bits in the intersection. if iszero(on) { updated := xor(current, and(current, roles)) } // Then, store the new value. sstore(roleSlot, updated) // Emit the {RolesUpdated} event. log3(0, 0, _ROLES_UPDATED_EVENT_SIGNATURE, shr(96, mload(0x0c)), updated) } } /// @dev Grants the roles directly without authorization guard. /// Each bit of `roles` represents the role to turn on. function _grantRoles(address user, uint256 roles) internal virtual { _updateRoles(user, roles, true); } /// @dev Removes the roles directly without authorization guard. /// Each bit of `roles` represents the role to turn off. function _removeRoles(address user, uint256 roles) internal virtual { _updateRoles(user, roles, false); } /// @dev Throws if the sender does not have any of the `roles`. function _checkRoles(uint256 roles) internal view virtual { /// @solidity memory-safe-assembly assembly { // Compute the role slot. mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, caller()) // Load the stored value, and if the `and` intersection // of the value and `roles` is zero, revert. if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } } } /// @dev Throws if the sender is not the owner, /// and does not have any of the `roles`. /// Checks for ownership first, then lazily checks for roles. function _checkOwnerOrRoles(uint256 roles) internal view virtual { /// @solidity memory-safe-assembly assembly { // If the caller is not the stored owner. // Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`. if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) { // Compute the role slot. mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, caller()) // Load the stored value, and if the `and` intersection // of the value and `roles` is zero, revert. if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } } } } /// @dev Throws if the sender does not have any of the `roles`, /// and is not the owner. /// Checks for roles first, then lazily checks for ownership. function _checkRolesOrOwner(uint256 roles) internal view virtual { /// @solidity memory-safe-assembly assembly { // Compute the role slot. mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, caller()) // Load the stored value, and if the `and` intersection // of the value and `roles` is zero, revert. if iszero(and(sload(keccak256(0x0c, 0x20)), roles)) { // If the caller is not the stored owner. // Note: `_ROLE_SLOT_SEED` is equal to `_OWNER_SLOT_NOT`. if iszero(eq(caller(), sload(not(_ROLE_SLOT_SEED)))) { mstore(0x00, 0x82b42900) // `Unauthorized()`. revert(0x1c, 0x04) } } } } /// @dev Convenience function to return a `roles` bitmap from an array of `ordinals`. /// This is meant for frontends like Etherscan, and is therefore not fully optimized. /// Not recommended to be called on-chain. /// Made internal to conserve bytecode. Wrap it in a public function if needed. function _rolesFromOrdinals(uint8[] memory ordinals) internal pure returns (uint256 roles) { /// @solidity memory-safe-assembly assembly { for { let i := shl(5, mload(ordinals)) } i { i := sub(i, 0x20) } { // We don't need to mask the values of `ordinals`, as Solidity // cleans dirty upper bits when storing variables into memory. roles := or(shl(mload(add(ordinals, i)), 1), roles) } } } /// @dev Convenience function to return an array of `ordinals` from the `roles` bitmap. /// This is meant for frontends like Etherscan, and is therefore not fully optimized. /// Not recommended to be called on-chain. /// Made internal to conserve bytecode. Wrap it in a public function if needed. function _ordinalsFromRoles(uint256 roles) internal pure returns (uint8[] memory ordinals) { /// @solidity memory-safe-assembly assembly { // Grab the pointer to the free memory. ordinals := mload(0x40) let ptr := add(ordinals, 0x20) let o := 0 // The absence of lookup tables, De Bruijn, etc., here is intentional for // smaller bytecode, as this function is not meant to be called on-chain. for { let t := roles } 1 {} { mstore(ptr, o) // `shr` 5 is equivalent to multiplying by 0x20. // Push back into the ordinals array if the bit is set. ptr := add(ptr, shl(5, and(t, 1))) o := add(o, 1) t := shr(o, roles) if iszero(t) { break } } // Store the length of `ordinals`. mstore(ordinals, shr(5, sub(ptr, add(ordinals, 0x20)))) // Allocate the memory. mstore(0x40, ptr) } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC UPDATE FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Allows the owner to grant `user` `roles`. /// If the `user` already has a role, then it will be an no-op for the role. function grantRoles(address user, uint256 roles) public payable virtual onlyOwner { _grantRoles(user, roles); } /// @dev Allows the owner to remove `user` `roles`. /// If the `user` does not have a role, then it will be an no-op for the role. function revokeRoles(address user, uint256 roles) public payable virtual onlyOwner { _removeRoles(user, roles); } /// @dev Allow the caller to remove their own roles. /// If the caller does not have a role, then it will be an no-op for the role. function renounceRoles(uint256 roles) public payable virtual { _removeRoles(msg.sender, roles); } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* PUBLIC READ FUNCTIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the roles of `user`. function rolesOf(address user) public view virtual returns (uint256 roles) { /// @solidity memory-safe-assembly assembly { // Compute the role slot. mstore(0x0c, _ROLE_SLOT_SEED) mstore(0x00, user) // Load the stored value. roles := sload(keccak256(0x0c, 0x20)) } } /// @dev Returns whether `user` has any of `roles`. function hasAnyRole(address user, uint256 roles) public view virtual returns (bool) { return rolesOf(user) & roles != 0; } /// @dev Returns whether `user` has all of `roles`. function hasAllRoles(address user, uint256 roles) public view virtual returns (bool) { return rolesOf(user) & roles == roles; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* MODIFIERS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Marks a function as only callable by an account with `roles`. modifier onlyRoles(uint256 roles) virtual { _checkRoles(roles); _; } /// @dev Marks a function as only callable by the owner or by an account /// with `roles`. Checks for ownership first, then lazily checks for roles. modifier onlyOwnerOrRoles(uint256 roles) virtual { _checkOwnerOrRoles(roles); _; } /// @dev Marks a function as only callable by an account with `roles` /// or the owner. Checks for roles first, then lazily checks for ownership. modifier onlyRolesOrOwner(uint256 roles) virtual { _checkRolesOrOwner(roles); _; } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* ROLE CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // IYKYK uint256 internal constant _ROLE_0 = 1 << 0; uint256 internal constant _ROLE_1 = 1 << 1; uint256 internal constant _ROLE_2 = 1 << 2; uint256 internal constant _ROLE_3 = 1 << 3; uint256 internal constant _ROLE_4 = 1 << 4; uint256 internal constant _ROLE_5 = 1 << 5; uint256 internal constant _ROLE_6 = 1 << 6; uint256 internal constant _ROLE_7 = 1 << 7; uint256 internal constant _ROLE_8 = 1 << 8; uint256 internal constant _ROLE_9 = 1 << 9; uint256 internal constant _ROLE_10 = 1 << 10; uint256 internal constant _ROLE_11 = 1 << 11; uint256 internal constant _ROLE_12 = 1 << 12; uint256 internal constant _ROLE_13 = 1 << 13; uint256 internal constant _ROLE_14 = 1 << 14; uint256 internal constant _ROLE_15 = 1 << 15; uint256 internal constant _ROLE_16 = 1 << 16; uint256 internal constant _ROLE_17 = 1 << 17; uint256 internal constant _ROLE_18 = 1 << 18; uint256 internal constant _ROLE_19 = 1 << 19; uint256 internal constant _ROLE_20 = 1 << 20; uint256 internal constant _ROLE_21 = 1 << 21; uint256 internal constant _ROLE_22 = 1 << 22; uint256 internal constant _ROLE_23 = 1 << 23; uint256 internal constant _ROLE_24 = 1 << 24; uint256 internal constant _ROLE_25 = 1 << 25; uint256 internal constant _ROLE_26 = 1 << 26; uint256 internal constant _ROLE_27 = 1 << 27; uint256 internal constant _ROLE_28 = 1 << 28; uint256 internal constant _ROLE_29 = 1 << 29; uint256 internal constant _ROLE_30 = 1 << 30; uint256 internal constant _ROLE_31 = 1 << 31; uint256 internal constant _ROLE_32 = 1 << 32; uint256 internal constant _ROLE_33 = 1 << 33; uint256 internal constant _ROLE_34 = 1 << 34; uint256 internal constant _ROLE_35 = 1 << 35; uint256 internal constant _ROLE_36 = 1 << 36; uint256 internal constant _ROLE_37 = 1 << 37; uint256 internal constant _ROLE_38 = 1 << 38; uint256 internal constant _ROLE_39 = 1 << 39; uint256 internal constant _ROLE_40 = 1 << 40; uint256 internal constant _ROLE_41 = 1 << 41; uint256 internal constant _ROLE_42 = 1 << 42; uint256 internal constant _ROLE_43 = 1 << 43; uint256 internal constant _ROLE_44 = 1 << 44; uint256 internal constant _ROLE_45 = 1 << 45; uint256 internal constant _ROLE_46 = 1 << 46; uint256 internal constant _ROLE_47 = 1 << 47; uint256 internal constant _ROLE_48 = 1 << 48; uint256 internal constant _ROLE_49 = 1 << 49; uint256 internal constant _ROLE_50 = 1 << 50; uint256 internal constant _ROLE_51 = 1 << 51; uint256 internal constant _ROLE_52 = 1 << 52; uint256 internal constant _ROLE_53 = 1 << 53; uint256 internal constant _ROLE_54 = 1 << 54; uint256 internal constant _ROLE_55 = 1 << 55; uint256 internal constant _ROLE_56 = 1 << 56; uint256 internal constant _ROLE_57 = 1 << 57; uint256 internal constant _ROLE_58 = 1 << 58; uint256 internal constant _ROLE_59 = 1 << 59; uint256 internal constant _ROLE_60 = 1 << 60; uint256 internal constant _ROLE_61 = 1 << 61; uint256 internal constant _ROLE_62 = 1 << 62; uint256 internal constant _ROLE_63 = 1 << 63; uint256 internal constant _ROLE_64 = 1 << 64; uint256 internal constant _ROLE_65 = 1 << 65; uint256 internal constant _ROLE_66 = 1 << 66; uint256 internal constant _ROLE_67 = 1 << 67; uint256 internal constant _ROLE_68 = 1 << 68; uint256 internal constant _ROLE_69 = 1 << 69; uint256 internal constant _ROLE_70 = 1 << 70; uint256 internal constant _ROLE_71 = 1 << 71; uint256 internal constant _ROLE_72 = 1 << 72; uint256 internal constant _ROLE_73 = 1 << 73; uint256 internal constant _ROLE_74 = 1 << 74; uint256 internal constant _ROLE_75 = 1 << 75; uint256 internal constant _ROLE_76 = 1 << 76; uint256 internal constant _ROLE_77 = 1 << 77; uint256 internal constant _ROLE_78 = 1 << 78; uint256 internal constant _ROLE_79 = 1 << 79; uint256 internal constant _ROLE_80 = 1 << 80; uint256 internal constant _ROLE_81 = 1 << 81; uint256 internal constant _ROLE_82 = 1 << 82; uint256 internal constant _ROLE_83 = 1 << 83; uint256 internal constant _ROLE_84 = 1 << 84; uint256 internal constant _ROLE_85 = 1 << 85; uint256 internal constant _ROLE_86 = 1 << 86; uint256 internal constant _ROLE_87 = 1 << 87; uint256 internal constant _ROLE_88 = 1 << 88; uint256 internal constant _ROLE_89 = 1 << 89; uint256 internal constant _ROLE_90 = 1 << 90; uint256 internal constant _ROLE_91 = 1 << 91; uint256 internal constant _ROLE_92 = 1 << 92; uint256 internal constant _ROLE_93 = 1 << 93; uint256 internal constant _ROLE_94 = 1 << 94; uint256 internal constant _ROLE_95 = 1 << 95; uint256 internal constant _ROLE_96 = 1 << 96; uint256 internal constant _ROLE_97 = 1 << 97; uint256 internal constant _ROLE_98 = 1 << 98; uint256 internal constant _ROLE_99 = 1 << 99; uint256 internal constant _ROLE_100 = 1 << 100; uint256 internal constant _ROLE_101 = 1 << 101; uint256 internal constant _ROLE_102 = 1 << 102; uint256 internal constant _ROLE_103 = 1 << 103; uint256 internal constant _ROLE_104 = 1 << 104; uint256 internal constant _ROLE_105 = 1 << 105; uint256 internal constant _ROLE_106 = 1 << 106; uint256 internal constant _ROLE_107 = 1 << 107; uint256 internal constant _ROLE_108 = 1 << 108; uint256 internal constant _ROLE_109 = 1 << 109; uint256 internal constant _ROLE_110 = 1 << 110; uint256 internal constant _ROLE_111 = 1 << 111; uint256 internal constant _ROLE_112 = 1 << 112; uint256 internal constant _ROLE_113 = 1 << 113; uint256 internal constant _ROLE_114 = 1 << 114; uint256 internal constant _ROLE_115 = 1 << 115; uint256 internal constant _ROLE_116 = 1 << 116; uint256 internal constant _ROLE_117 = 1 << 117; uint256 internal constant _ROLE_118 = 1 << 118; uint256 internal constant _ROLE_119 = 1 << 119; uint256 internal constant _ROLE_120 = 1 << 120; uint256 internal constant _ROLE_121 = 1 << 121; uint256 internal constant _ROLE_122 = 1 << 122; uint256 internal constant _ROLE_123 = 1 << 123; uint256 internal constant _ROLE_124 = 1 << 124; uint256 internal constant _ROLE_125 = 1 << 125; uint256 internal constant _ROLE_126 = 1 << 126; uint256 internal constant _ROLE_127 = 1 << 127; uint256 internal constant _ROLE_128 = 1 << 128; uint256 internal constant _ROLE_129 = 1 << 129; uint256 internal constant _ROLE_130 = 1 << 130; uint256 internal constant _ROLE_131 = 1 << 131; uint256 internal constant _ROLE_132 = 1 << 132; uint256 internal constant _ROLE_133 = 1 << 133; uint256 internal constant _ROLE_134 = 1 << 134; uint256 internal constant _ROLE_135 = 1 << 135; uint256 internal constant _ROLE_136 = 1 << 136; uint256 internal constant _ROLE_137 = 1 << 137; uint256 internal constant _ROLE_138 = 1 << 138; uint256 internal constant _ROLE_139 = 1 << 139; uint256 internal constant _ROLE_140 = 1 << 140; uint256 internal constant _ROLE_141 = 1 << 141; uint256 internal constant _ROLE_142 = 1 << 142; uint256 internal constant _ROLE_143 = 1 << 143; uint256 internal constant _ROLE_144 = 1 << 144; uint256 internal constant _ROLE_145 = 1 << 145; uint256 internal constant _ROLE_146 = 1 << 146; uint256 internal constant _ROLE_147 = 1 << 147; uint256 internal constant _ROLE_148 = 1 << 148; uint256 internal constant _ROLE_149 = 1 << 149; uint256 internal constant _ROLE_150 = 1 << 150; uint256 internal constant _ROLE_151 = 1 << 151; uint256 internal constant _ROLE_152 = 1 << 152; uint256 internal constant _ROLE_153 = 1 << 153; uint256 internal constant _ROLE_154 = 1 << 154; uint256 internal constant _ROLE_155 = 1 << 155; uint256 internal constant _ROLE_156 = 1 << 156; uint256 internal constant _ROLE_157 = 1 << 157; uint256 internal constant _ROLE_158 = 1 << 158; uint256 internal constant _ROLE_159 = 1 << 159; uint256 internal constant _ROLE_160 = 1 << 160; uint256 internal constant _ROLE_161 = 1 << 161; uint256 internal constant _ROLE_162 = 1 << 162; uint256 internal constant _ROLE_163 = 1 << 163; uint256 internal constant _ROLE_164 = 1 << 164; uint256 internal constant _ROLE_165 = 1 << 165; uint256 internal constant _ROLE_166 = 1 << 166; uint256 internal constant _ROLE_167 = 1 << 167; uint256 internal constant _ROLE_168 = 1 << 168; uint256 internal constant _ROLE_169 = 1 << 169; uint256 internal constant _ROLE_170 = 1 << 170; uint256 internal constant _ROLE_171 = 1 << 171; uint256 internal constant _ROLE_172 = 1 << 172; uint256 internal constant _ROLE_173 = 1 << 173; uint256 internal constant _ROLE_174 = 1 << 174; uint256 internal constant _ROLE_175 = 1 << 175; uint256 internal constant _ROLE_176 = 1 << 176; uint256 internal constant _ROLE_177 = 1 << 177; uint256 internal constant _ROLE_178 = 1 << 178; uint256 internal constant _ROLE_179 = 1 << 179; uint256 internal constant _ROLE_180 = 1 << 180; uint256 internal constant _ROLE_181 = 1 << 181; uint256 internal constant _ROLE_182 = 1 << 182; uint256 internal constant _ROLE_183 = 1 << 183; uint256 internal constant _ROLE_184 = 1 << 184; uint256 internal constant _ROLE_185 = 1 << 185; uint256 internal constant _ROLE_186 = 1 << 186; uint256 internal constant _ROLE_187 = 1 << 187; uint256 internal constant _ROLE_188 = 1 << 188; uint256 internal constant _ROLE_189 = 1 << 189; uint256 internal constant _ROLE_190 = 1 << 190; uint256 internal constant _ROLE_191 = 1 << 191; uint256 internal constant _ROLE_192 = 1 << 192; uint256 internal constant _ROLE_193 = 1 << 193; uint256 internal constant _ROLE_194 = 1 << 194; uint256 internal constant _ROLE_195 = 1 << 195; uint256 internal constant _ROLE_196 = 1 << 196; uint256 internal constant _ROLE_197 = 1 << 197; uint256 internal constant _ROLE_198 = 1 << 198; uint256 internal constant _ROLE_199 = 1 << 199; uint256 internal constant _ROLE_200 = 1 << 200; uint256 internal constant _ROLE_201 = 1 << 201; uint256 internal constant _ROLE_202 = 1 << 202; uint256 internal constant _ROLE_203 = 1 << 203; uint256 internal constant _ROLE_204 = 1 << 204; uint256 internal constant _ROLE_205 = 1 << 205; uint256 internal constant _ROLE_206 = 1 << 206; uint256 internal constant _ROLE_207 = 1 << 207; uint256 internal constant _ROLE_208 = 1 << 208; uint256 internal constant _ROLE_209 = 1 << 209; uint256 internal constant _ROLE_210 = 1 << 210; uint256 internal constant _ROLE_211 = 1 << 211; uint256 internal constant _ROLE_212 = 1 << 212; uint256 internal constant _ROLE_213 = 1 << 213; uint256 internal constant _ROLE_214 = 1 << 214; uint256 internal constant _ROLE_215 = 1 << 215; uint256 internal constant _ROLE_216 = 1 << 216; uint256 internal constant _ROLE_217 = 1 << 217; uint256 internal constant _ROLE_218 = 1 << 218; uint256 internal constant _ROLE_219 = 1 << 219; uint256 internal constant _ROLE_220 = 1 << 220; uint256 internal constant _ROLE_221 = 1 << 221; uint256 internal constant _ROLE_222 = 1 << 222; uint256 internal constant _ROLE_223 = 1 << 223; uint256 internal constant _ROLE_224 = 1 << 224; uint256 internal constant _ROLE_225 = 1 << 225; uint256 internal constant _ROLE_226 = 1 << 226; uint256 internal constant _ROLE_227 = 1 << 227; uint256 internal constant _ROLE_228 = 1 << 228; uint256 internal constant _ROLE_229 = 1 << 229; uint256 internal constant _ROLE_230 = 1 << 230; uint256 internal constant _ROLE_231 = 1 << 231; uint256 internal constant _ROLE_232 = 1 << 232; uint256 internal constant _ROLE_233 = 1 << 233; uint256 internal constant _ROLE_234 = 1 << 234; uint256 internal constant _ROLE_235 = 1 << 235; uint256 internal constant _ROLE_236 = 1 << 236; uint256 internal constant _ROLE_237 = 1 << 237; uint256 internal constant _ROLE_238 = 1 << 238; uint256 internal constant _ROLE_239 = 1 << 239; uint256 internal constant _ROLE_240 = 1 << 240; uint256 internal constant _ROLE_241 = 1 << 241; uint256 internal constant _ROLE_242 = 1 << 242; uint256 internal constant _ROLE_243 = 1 << 243; uint256 internal constant _ROLE_244 = 1 << 244; uint256 internal constant _ROLE_245 = 1 << 245; uint256 internal constant _ROLE_246 = 1 << 246; uint256 internal constant _ROLE_247 = 1 << 247; uint256 internal constant _ROLE_248 = 1 << 248; uint256 internal constant _ROLE_249 = 1 << 249; uint256 internal constant _ROLE_250 = 1 << 250; uint256 internal constant _ROLE_251 = 1 << 251; uint256 internal constant _ROLE_252 = 1 << 252; uint256 internal constant _ROLE_253 = 1 << 253; uint256 internal constant _ROLE_254 = 1 << 254; uint256 internal constant _ROLE_255 = 1 << 255; } /// @notice Library for converting numbers into strings and other string operations. /// @author Solady (https://github.com/vectorized/solady/blob/main/src/utils/LibString.sol) /// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/utils/LibString.sol) /// /// @dev Note: /// For performance and bytecode compactness, most of the string operations are restricted to /// byte strings (7-bit ASCII), except where otherwise specified. /// Usage of byte string operations on charsets with runes spanning two or more bytes /// can lead to undefined behavior. library LibString { /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CUSTOM ERRORS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The length of the output is too small to contain all the hex digits. error HexLengthInsufficient(); /// @dev The length of the string is more than 32 bytes. error TooBigForSmallString(); /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* CONSTANTS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev The constant returned when the `search` is not found in the string. uint256 internal constant NOT_FOUND = type(uint256).max; /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* DECIMAL OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the base 10 decimal representation of `value`. function toString(uint256 value) internal pure returns (string memory str) { /// @solidity memory-safe-assembly assembly { // The maximum value of a uint256 contains 78 digits (1 byte per digit), but // we allocate 0xa0 bytes to keep the free memory pointer 32-byte word aligned. // We will need 1 word for the trailing zeros padding, 1 word for the length, // and 3 words for a maximum of 78 digits. str := add(mload(0x40), 0x80) // Update the free memory pointer to allocate. mstore(0x40, add(str, 0x20)) // Zeroize the slot after the string. mstore(str, 0) // Cache the end of the memory to calculate the length later. let end := str let w := not(0) // Tsk. // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let temp := value } 1 {} { str := add(str, w) // `sub(str, 1)`. // Write the character to the pointer. // The ASCII index of the '0' character is 48. mstore8(str, add(48, mod(temp, 10))) // Keep dividing `temp` until zero. temp := div(temp, 10) if iszero(temp) { break } } let length := sub(end, str) // Move the pointer 32 bytes leftwards to make room for the length. str := sub(str, 0x20) // Store the length. mstore(str, length) } } /// @dev Returns the base 10 decimal representation of `value`. function toString(int256 value) internal pure returns (string memory str) { if (value >= 0) { return toString(uint256(value)); } unchecked { str = toString(~uint256(value) + 1); } /// @solidity memory-safe-assembly assembly { // We still have some spare memory space on the left, // as we have allocated 3 words (96 bytes) for up to 78 digits. let length := mload(str) // Load the string length. mstore(str, 0x2d) // Store the '-' character. str := sub(str, 1) // Move back the string pointer by a byte. mstore(str, add(length, 1)) // Update the string length. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* HEXADECIMAL OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the hexadecimal representation of `value`, /// left-padded to an input length of `length` bytes. /// The output is prefixed with "0x" encoded using 2 hexadecimal digits per byte, /// giving a total length of `length * 2 + 2` bytes. /// Reverts if `length` is too small for the output to contain all the digits. function toHexString(uint256 value, uint256 length) internal pure returns (string memory str) { str = toHexStringNoPrefix(value, length); /// @solidity memory-safe-assembly assembly { let strLength := add(mload(str), 2) // Compute the length. mstore(str, 0x3078) // Write the "0x" prefix. str := sub(str, 2) // Move the pointer. mstore(str, strLength) // Write the length. } } /// @dev Returns the hexadecimal representation of `value`, /// left-padded to an input length of `length` bytes. /// The output is prefixed with "0x" encoded using 2 hexadecimal digits per byte, /// giving a total length of `length * 2` bytes. /// Reverts if `length` is too small for the output to contain all the digits. function toHexStringNoPrefix(uint256 value, uint256 length) internal pure returns (string memory str) { /// @solidity memory-safe-assembly assembly { // We need 0x20 bytes for the trailing zeros padding, `length * 2` bytes // for the digits, 0x02 bytes for the prefix, and 0x20 bytes for the length. // We add 0x20 to the total and round down to a multiple of 0x20. // (0x20 + 0x20 + 0x02 + 0x20) = 0x62. str := add(mload(0x40), and(add(shl(1, length), 0x42), not(0x1f))) // Allocate the memory. mstore(0x40, add(str, 0x20)) // Zeroize the slot after the string. mstore(str, 0) // Cache the end to calculate the length later. let end := str // Store "0123456789abcdef" in scratch space. mstore(0x0f, 0x30313233343536373839616263646566) let start := sub(str, add(length, length)) let w := not(1) // Tsk. let temp := value // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for {} 1 {} { str := add(str, w) // `sub(str, 2)`. mstore8(add(str, 1), mload(and(temp, 15))) mstore8(str, mload(and(shr(4, temp), 15))) temp := shr(8, temp) if iszero(xor(str, start)) { break } } if temp { mstore(0x00, 0x2194895a) // `HexLengthInsufficient()`. revert(0x1c, 0x04) } // Compute the string's length. let strLength := sub(end, str) // Move the pointer and write the length. str := sub(str, 0x20) mstore(str, strLength) } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte. /// As address are 20 bytes long, the output will left-padded to have /// a length of `20 * 2 + 2` bytes. function toHexString(uint256 value) internal pure returns (string memory str) { str = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let strLength := add(mload(str), 2) // Compute the length. mstore(str, 0x3078) // Write the "0x" prefix. str := sub(str, 2) // Move the pointer. mstore(str, strLength) // Write the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x". /// The output excludes leading "0" from the `toHexString` output. /// `0x00: "0x0", 0x01: "0x1", 0x12: "0x12", 0x123: "0x123"`. function toMinimalHexString(uint256 value) internal pure returns (string memory str) { str = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let o := eq(byte(0, mload(add(str, 0x20))), 0x30) // Whether leading zero is present. let strLength := add(mload(str), 2) // Compute the length. mstore(add(str, o), 0x3078) // Write the "0x" prefix, accounting for leading zero. str := sub(add(str, o), 2) // Move the pointer, accounting for leading zero. mstore(str, sub(strLength, o)) // Write the length, accounting for leading zero. } } /// @dev Returns the hexadecimal representation of `value`. /// The output excludes leading "0" from the `toHexStringNoPrefix` output. /// `0x00: "0", 0x01: "1", 0x12: "12", 0x123: "123"`. function toMinimalHexStringNoPrefix(uint256 value) internal pure returns (string memory str) { str = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let o := eq(byte(0, mload(add(str, 0x20))), 0x30) // Whether leading zero is present. let strLength := mload(str) // Get the length. str := add(str, o) // Move the pointer, accounting for leading zero. mstore(str, sub(strLength, o)) // Write the length, accounting for leading zero. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is encoded using 2 hexadecimal digits per byte. /// As address are 20 bytes long, the output will left-padded to have /// a length of `20 * 2` bytes. function toHexStringNoPrefix(uint256 value) internal pure returns (string memory str) { /// @solidity memory-safe-assembly assembly { // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length, // 0x02 bytes for the prefix, and 0x40 bytes for the digits. // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x40) is 0xa0. str := add(mload(0x40), 0x80) // Allocate the memory. mstore(0x40, add(str, 0x20)) // Zeroize the slot after the string. mstore(str, 0) // Cache the end to calculate the length later. let end := str // Store "0123456789abcdef" in scratch space. mstore(0x0f, 0x30313233343536373839616263646566) let w := not(1) // Tsk. // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let temp := value } 1 {} { str := add(str, w) // `sub(str, 2)`. mstore8(add(str, 1), mload(and(temp, 15))) mstore8(str, mload(and(shr(4, temp), 15))) temp := shr(8, temp) if iszero(temp) { break } } // Compute the string's length. let strLength := sub(end, str) // Move the pointer and write the length. str := sub(str, 0x20) mstore(str, strLength) } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x", encoded using 2 hexadecimal digits per byte, /// and the alphabets are capitalized conditionally according to /// https://eips.ethereum.org/EIPS/eip-55 function toHexStringChecksummed(address value) internal pure returns (string memory str) { str = toHexString(value); /// @solidity memory-safe-assembly assembly { let mask := shl(6, div(not(0), 255)) // `0b010000000100000000 ...` let o := add(str, 0x22) let hashed := and(keccak256(o, 40), mul(34, mask)) // `0b10001000 ... ` let t := shl(240, 136) // `0b10001000 << 240` for { let i := 0 } 1 {} { mstore(add(i, i), mul(t, byte(i, hashed))) i := add(i, 1) if eq(i, 20) { break } } mstore(o, xor(mload(o), shr(1, and(mload(0x00), and(mload(o), mask))))) o := add(o, 0x20) mstore(o, xor(mload(o), shr(1, and(mload(0x20), and(mload(o), mask))))) } } /// @dev Returns the hexadecimal representation of `value`. /// The output is prefixed with "0x" and encoded using 2 hexadecimal digits per byte. function toHexString(address value) internal pure returns (string memory str) { str = toHexStringNoPrefix(value); /// @solidity memory-safe-assembly assembly { let strLength := add(mload(str), 2) // Compute the length. mstore(str, 0x3078) // Write the "0x" prefix. str := sub(str, 2) // Move the pointer. mstore(str, strLength) // Write the length. } } /// @dev Returns the hexadecimal representation of `value`. /// The output is encoded using 2 hexadecimal digits per byte. function toHexStringNoPrefix(address value) internal pure returns (string memory str) { /// @solidity memory-safe-assembly assembly { str := mload(0x40) // Allocate the memory. // We need 0x20 bytes for the trailing zeros padding, 0x20 bytes for the length, // 0x02 bytes for the prefix, and 0x28 bytes for the digits. // The next multiple of 0x20 above (0x20 + 0x20 + 0x02 + 0x28) is 0x80. mstore(0x40, add(str, 0x80)) // Store "0123456789abcdef" in scratch space. mstore(0x0f, 0x30313233343536373839616263646566) str := add(str, 2) mstore(str, 40) let o := add(str, 0x20) mstore(add(o, 40), 0) value := shl(96, value) // We write the string from rightmost digit to leftmost digit. // The following is essentially a do-while loop that also handles the zero case. for { let i := 0 } 1 {} { let p := add(o, add(i, i)) let temp := byte(i, value) mstore8(add(p, 1), mload(and(temp, 15))) mstore8(p, mload(shr(4, temp))) i := add(i, 1) if eq(i, 20) { break } } } } /// @dev Returns the hex encoded string from the raw bytes. /// The output is encoded using 2 hexadecimal digits per byte. function toHexString(bytes memory raw) internal pure returns (string memory str) { str = toHexStringNoPrefix(raw); /// @solidity memory-safe-assembly assembly { let strLength := add(mload(str), 2) // Compute the length. mstore(str, 0x3078) // Write the "0x" prefix. str := sub(str, 2) // Move the pointer. mstore(str, strLength) // Write the length. } } /// @dev Returns the hex encoded string from the raw bytes. /// The output is encoded using 2 hexadecimal digits per byte. function toHexStringNoPrefix(bytes memory raw) internal pure returns (string memory str) { /// @solidity memory-safe-assembly assembly { let length := mload(raw) str := add(mload(0x40), 2) // Skip 2 bytes for the optional prefix. mstore(str, add(length, length)) // Store the length of the output. // Store "0123456789abcdef" in scratch space. mstore(0x0f, 0x30313233343536373839616263646566) let o := add(str, 0x20) let end := add(raw, length) for {} iszero(eq(raw, end)) {} { raw := add(raw, 1) mstore8(add(o, 1), mload(and(mload(raw), 15))) mstore8(o, mload(and(shr(4, mload(raw)), 15))) o := add(o, 2) } mstore(o, 0) // Zeroize the slot after the string. mstore(0x40, add(o, 0x20)) // Allocate the memory. } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* RUNE STRING OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ /// @dev Returns the number of UTF characters in the string. function runeCount(string memory s) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { if mload(s) { mstore(0x00, div(not(0), 255)) mstore(0x20, 0x0202020202020202020202020202020202020202020202020303030304040506) let o := add(s, 0x20) let end := add(o, mload(s)) for { result := 1 } 1 { result := add(result, 1) } { o := add(o, byte(0, mload(shr(250, mload(o))))) if iszero(lt(o, end)) { break } } } } } /// @dev Returns if this string is a 7-bit ASCII string. /// (i.e. all characters codes are in [0..127]) function is7BitASCII(string memory s) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { let mask := shl(7, div(not(0), 255)) result := 1 let n := mload(s) if n { let o := add(s, 0x20) let end := add(o, n) let last := mload(end) mstore(end, 0) for {} 1 {} { if and(mask, mload(o)) { result := 0 break } o := add(o, 0x20) if iszero(lt(o, end)) { break } } mstore(end, last) } } } /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/ /* BYTE STRING OPERATIONS */ /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/ // For performance and bytecode compactness, byte string operations are restricted // to 7-bit ASCII strings. All offsets are byte offsets, not UTF character offsets. // Usage of byte string operations on charsets with runes spanning two or more bytes // can lead to undefined behavior. /// @dev Returns `subject` all occurrences of `search` replaced with `replacement`. function replace(string memory subject, string memory search, string memory replacement) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let subjectLength := mload(subject) let searchLength := mload(search) let replacementLength := mload(replacement) subject := add(subject, 0x20) search := add(search, 0x20) replacement := add(replacement, 0x20) result := add(mload(0x40), 0x20) let subjectEnd := add(subject, subjectLength) if iszero(gt(searchLength, subjectLength)) { let subjectSearchEnd := add(sub(subjectEnd, searchLength), 1) let h := 0 if iszero(lt(searchLength, 0x20)) { h := keccak256(search, searchLength) } let m := shl(3, sub(0x20, and(searchLength, 0x1f))) let s := mload(search) for {} 1 {} { let t := mload(subject) // Whether the first `searchLength % 32` bytes of // `subject` and `search` matches. if iszero(shr(m, xor(t, s))) { if h { if iszero(eq(keccak256(subject, searchLength), h)) { mstore(result, t) result := add(result, 1) subject := add(subject, 1) if iszero(lt(subject, subjectSearchEnd)) { break } continue } } // Copy the `replacement` one word at a time. for { let o := 0 } 1 {} { mstore(add(result, o), mload(add(replacement, o))) o := add(o, 0x20) if iszero(lt(o, replacementLength)) { break } } result := add(result, replacementLength) subject := add(subject, searchLength) if searchLength { if iszero(lt(subject, subjectSearchEnd)) { break } continue } } mstore(result, t) result := add(result, 1) subject := add(subject, 1) if iszero(lt(subject, subjectSearchEnd)) { break } } } let resultRemainder := result result := add(mload(0x40), 0x20) let k := add(sub(resultRemainder, result), sub(subjectEnd, subject)) // Copy the rest of the string one word at a time. for {} lt(subject, subjectEnd) {} { mstore(resultRemainder, mload(subject)) resultRemainder := add(resultRemainder, 0x20) subject := add(subject, 0x20) } result := sub(result, 0x20) let last := add(add(result, 0x20), k) // Zeroize the slot after the string. mstore(last, 0) mstore(0x40, add(last, 0x20)) // Allocate the memory. mstore(result, k) // Store the length. } } /// @dev Returns the byte index of the first location of `search` in `subject`, /// searching from left to right, starting from `from`. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found. function indexOf(string memory subject, string memory search, uint256 from) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { for { let subjectLength := mload(subject) } 1 {} { if iszero(mload(search)) { if iszero(gt(from, subjectLength)) { result := from break } result := subjectLength break } let searchLength := mload(search) let subjectStart := add(subject, 0x20) result := not(0) // Initialize to `NOT_FOUND`. subject := add(subjectStart, from) let end := add(sub(add(subjectStart, subjectLength), searchLength), 1) let m := shl(3, sub(0x20, and(searchLength, 0x1f))) let s := mload(add(search, 0x20)) if iszero(and(lt(subject, end), lt(from, subjectLength))) { break } if iszero(lt(searchLength, 0x20)) { for { let h := keccak256(add(search, 0x20), searchLength) } 1 {} { if iszero(shr(m, xor(mload(subject), s))) { if eq(keccak256(subject, searchLength), h) { result := sub(subject, subjectStart) break } } subject := add(subject, 1) if iszero(lt(subject, end)) { break } } break } for {} 1 {} { if iszero(shr(m, xor(mload(subject), s))) { result := sub(subject, subjectStart) break } subject := add(subject, 1) if iszero(lt(subject, end)) { break } } break } } } /// @dev Returns the byte index of the first location of `search` in `subject`, /// searching from left to right. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found. function indexOf(string memory subject, string memory search) internal pure returns (uint256 result) { result = indexOf(subject, search, 0); } /// @dev Returns the byte index of the first location of `search` in `subject`, /// searching from right to left, starting from `from`. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found. function lastIndexOf(string memory subject, string memory search, uint256 from) internal pure returns (uint256 result) { /// @solidity memory-safe-assembly assembly { for {} 1 {} { result := not(0) // Initialize to `NOT_FOUND`. let searchLength := mload(search) if gt(searchLength, mload(subject)) { break } let w := result let fromMax := sub(mload(subject), searchLength) if iszero(gt(fromMax, from)) { from := fromMax } let end := add(add(subject, 0x20), w) subject := add(add(subject, 0x20), from) if iszero(gt(subject, end)) { break } // As this function is not too often used, // we shall simply use keccak256 for smaller bytecode size. for { let h := keccak256(add(search, 0x20), searchLength) } 1 {} { if eq(keccak256(subject, searchLength), h) { result := sub(subject, add(end, 1)) break } subject := add(subject, w) // `sub(subject, 1)`. if iszero(gt(subject, end)) { break } } break } } } /// @dev Returns the byte index of the first location of `search` in `subject`, /// searching from right to left. /// Returns `NOT_FOUND` (i.e. `type(uint256).max`) if the `search` is not found. function lastIndexOf(string memory subject, string memory search) internal pure returns (uint256 result) { result = lastIndexOf(subject, search, uint256(int256(-1))); } /// @dev Returns true if `search` is found in `subject`, false otherwise. function contains(string memory subject, string memory search) internal pure returns (bool) { return indexOf(subject, search) != NOT_FOUND; } /// @dev Returns whether `subject` starts with `search`. function startsWith(string memory subject, string memory search) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { let searchLength := mload(search) // Just using keccak256 directly is actually cheaper. // forgefmt: disable-next-item result := and( iszero(gt(searchLength, mload(subject))), eq( keccak256(add(subject, 0x20), searchLength), keccak256(add(search, 0x20), searchLength) ) ) } } /// @dev Returns whether `subject` ends with `search`. function endsWith(string memory subject, string memory search) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { let searchLength := mload(search) let subjectLength := mload(subject) // Whether `search` is not longer than `subject`. let withinRange := iszero(gt(searchLength, subjectLength)) // Just using keccak256 directly is actually cheaper. // forgefmt: disable-next-item result := and( withinRange, eq( keccak256( // `subject + 0x20 + max(subjectLength - searchLength, 0)`. add(add(subject, 0x20), mul(withinRange, sub(subjectLength, searchLength))), searchLength ), keccak256(add(search, 0x20), searchLength) ) ) } } /// @dev Returns `subject` repeated `times`. function repeat(string memory subject, uint256 times) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let subjectLength := mload(subject) if iszero(or(iszero(times), iszero(subjectLength))) { subject := add(subject, 0x20) result := mload(0x40) let output := add(result, 0x20) for {} 1 {} { // Copy the `subject` one word at a time. for { let o := 0 } 1 {} { mstore(add(output, o), mload(add(subject, o))) o := add(o, 0x20) if iszero(lt(o, subjectLength)) { break } } output := add(output, subjectLength) times := sub(times, 1) if iszero(times) { break } } mstore(output, 0) // Zeroize the slot after the string. let resultLength := sub(output, add(result, 0x20)) mstore(result, resultLength) // Store the length. // Allocate the memory. mstore(0x40, add(result, add(resultLength, 0x20))) } } } /// @dev Returns a copy of `subject` sliced from `start` to `end` (exclusive). /// `start` and `end` are byte offsets. function slice(string memory subject, uint256 start, uint256 end) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let subjectLength := mload(subject) if iszero(gt(subjectLength, end)) { end := subjectLength } if iszero(gt(subjectLength, start)) { start := subjectLength } if lt(start, end) { result := mload(0x40) let resultLength := sub(end, start) mstore(result, resultLength) subject := add(subject, start) let w := not(0x1f) // Copy the `subject` one word at a time, backwards. for { let o := and(add(resultLength, 0x1f), w) } 1 {} { mstore(add(result, o), mload(add(subject, o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } // Zeroize the slot after the string. mstore(add(add(result, 0x20), resultLength), 0) // Allocate memory for the length and the bytes, // rounded up to a multiple of 32. mstore(0x40, add(result, and(add(resultLength, 0x3f), w))) } } } /// @dev Returns a copy of `subject` sliced from `start` to the end of the string. /// `start` is a byte offset. function slice(string memory subject, uint256 start) internal pure returns (string memory result) { result = slice(subject, start, uint256(int256(-1))); } /// @dev Returns all the indices of `search` in `subject`. /// The indices are byte offsets. function indicesOf(string memory subject, string memory search) internal pure returns (uint256[] memory result) { /// @solidity memory-safe-assembly assembly { let subjectLength := mload(subject) let searchLength := mload(search) if iszero(gt(searchLength, subjectLength)) { subject := add(subject, 0x20) search := add(search, 0x20) result := add(mload(0x40), 0x20) let subjectStart := subject let subjectSearchEnd := add(sub(add(subject, subjectLength), searchLength), 1) let h := 0 if iszero(lt(searchLength, 0x20)) { h := keccak256(search, searchLength) } let m := shl(3, sub(0x20, and(searchLength, 0x1f))) let s := mload(search) for {} 1 {} { let t := mload(subject) // Whether the first `searchLength % 32` bytes of // `subject` and `search` matches. if iszero(shr(m, xor(t, s))) { if h { if iszero(eq(keccak256(subject, searchLength), h)) { subject := add(subject, 1) if iszero(lt(subject, subjectSearchEnd)) { break } continue } } // Append to `result`. mstore(result, sub(subject, subjectStart)) result := add(result, 0x20) // Advance `subject` by `searchLength`. subject := add(subject, searchLength) if searchLength { if iszero(lt(subject, subjectSearchEnd)) { break } continue } } subject := add(subject, 1) if iszero(lt(subject, subjectSearchEnd)) { break } } let resultEnd := result // Assign `result` to the free memory pointer. result := mload(0x40) // Store the length of `result`. mstore(result, shr(5, sub(resultEnd, add(result, 0x20)))) // Allocate memory for result. // We allocate one more word, so this array can be recycled for {split}. mstore(0x40, add(resultEnd, 0x20)) } } } /// @dev Returns a arrays of strings based on the `delimiter` inside of the `subject` string. function split(string memory subject, string memory delimiter) internal pure returns (string[] memory result) { uint256[] memory indices = indicesOf(subject, delimiter); /// @solidity memory-safe-assembly assembly { let w := not(0x1f) let indexPtr := add(indices, 0x20) let indicesEnd := add(indexPtr, shl(5, add(mload(indices), 1))) mstore(add(indicesEnd, w), mload(subject)) mstore(indices, add(mload(indices), 1)) let prevIndex := 0 for {} 1 {} { let index := mload(indexPtr) mstore(indexPtr, 0x60) if iszero(eq(index, prevIndex)) { let element := mload(0x40) let elementLength := sub(index, prevIndex) mstore(element, elementLength) // Copy the `subject` one word at a time, backwards. for { let o := and(add(elementLength, 0x1f), w) } 1 {} { mstore(add(element, o), mload(add(add(subject, prevIndex), o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } // Zeroize the slot after the string. mstore(add(add(element, 0x20), elementLength), 0) // Allocate memory for the length and the bytes, // rounded up to a multiple of 32. mstore(0x40, add(element, and(add(elementLength, 0x3f), w))) // Store the `element` into the array. mstore(indexPtr, element) } prevIndex := add(index, mload(delimiter)) indexPtr := add(indexPtr, 0x20) if iszero(lt(indexPtr, indicesEnd)) { break } } result := indices if iszero(mload(delimiter)) { result := add(indices, 0x20) mstore(result, sub(mload(indices), 2)) } } } /// @dev Returns a concatenated string of `a` and `b`. /// Cheaper than `string.concat()` and does not de-align the free memory pointer. function concat(string memory a, string memory b) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let w := not(0x1f) result := mload(0x40) let aLength := mload(a) // Copy `a` one word at a time, backwards. for { let o := and(add(aLength, 0x20), w) } 1 {} { mstore(add(result, o), mload(add(a, o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } let bLength := mload(b) let output := add(result, aLength) // Copy `b` one word at a time, backwards. for { let o := and(add(bLength, 0x20), w) } 1 {} { mstore(add(output, o), mload(add(b, o))) o := add(o, w) // `sub(o, 0x20)`. if iszero(o) { break } } let totalLength := add(aLength, bLength) let last := add(add(result, 0x20), totalLength) // Zeroize the slot after the string. mstore(last, 0) // Stores the length. mstore(result, totalLength) // Allocate memory for the length and the bytes, // rounded up to a multiple of 32. mstore(0x40, and(add(last, 0x1f), w)) } } /// @dev Returns a copy of the string in either lowercase or UPPERCASE. /// WARNING! This function is only compatible with 7-bit ASCII strings. function toCase(string memory subject, bool toUpper) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let length := mload(subject) if length { result := add(mload(0x40), 0x20) subject := add(subject, 1) let flags := shl(add(70, shl(5, toUpper)), 0x3ffffff) let w := not(0) for { let o := length } 1 {} { o := add(o, w) let b := and(0xff, mload(add(subject, o))) mstore8(add(result, o), xor(b, and(shr(b, flags), 0x20))) if iszero(o) { break } } result := mload(0x40) mstore(result, length) // Store the length. let last := add(add(result, 0x20), length) mstore(last, 0) // Zeroize the slot after the string. mstore(0x40, add(last, 0x20)) // Allocate the memory. } } } /// @dev Returns a string from a small bytes32 string. /// `s` must be null-terminated, or behavior will be undefined. function fromSmallString(bytes32 s) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { result := mload(0x40) let n := 0 for {} byte(n, s) { n := add(n, 1) } {} // Scan for '\0'. mstore(result, n) let o := add(result, 0x20) mstore(o, s) mstore(add(o, n), 0) mstore(0x40, add(result, 0x40)) } } /// @dev Returns the small string, with all bytes after the first null byte zeroized. function normalizeSmallString(bytes32 s) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { for {} byte(result, s) { result := add(result, 1) } {} // Scan for '\0'. mstore(0x00, s) mstore(result, 0x00) result := mload(0x00) } } /// @dev Returns the string as a normalized null-terminated small string. function toSmallString(string memory s) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { result := mload(s) if iszero(lt(result, 33)) { mstore(0x00, 0xec92f9a3) // `TooBigForSmallString()`. revert(0x1c, 0x04) } result := shl(shl(3, sub(32, result)), mload(add(s, result))) } } /// @dev Returns a lowercased copy of the string. /// WARNING! This function is only compatible with 7-bit ASCII strings. function lower(string memory subject) internal pure returns (string memory result) { result = toCase(subject, false); } /// @dev Returns an UPPERCASED copy of the string. /// WARNING! This function is only compatible with 7-bit ASCII strings. function upper(string memory subject) internal pure returns (string memory result) { result = toCase(subject, true); } /// @dev Escapes the string to be used within HTML tags. function escapeHTML(string memory s) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let end := add(s, mload(s)) result := add(mload(0x40), 0x20) // Store the bytes of the packed offsets and strides into the scratch space. // `packed = (stride << 5) | offset`. Max offset is 20. Max stride is 6. mstore(0x1f, 0x900094) mstore(0x08, 0xc0000000a6ab) // Store ""&'<>" into the scratch space. mstore(0x00, shl(64, 0x2671756f743b26616d703b262333393b266c743b2667743b)) for {} iszero(eq(s, end)) {} { s := add(s, 1) let c := and(mload(s), 0xff) // Not in `["\"","'","&","<",">"]`. if iszero(and(shl(c, 1), 0x500000c400000000)) { mstore8(result, c) result := add(result, 1) continue } let t := shr(248, mload(c)) mstore(result, mload(and(t, 0x1f))) result := add(result, shr(5, t)) } let last := result mstore(last, 0) // Zeroize the slot after the string. result := mload(0x40) mstore(result, sub(last, add(result, 0x20))) // Store the length. mstore(0x40, add(last, 0x20)) // Allocate the memory. } } /// @dev Escapes the string to be used within double-quotes in a JSON. /// If `addDoubleQuotes` is true, the result will be enclosed in double-quotes. function escapeJSON(string memory s, bool addDoubleQuotes) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { let end := add(s, mload(s)) result := add(mload(0x40), 0x20) if addDoubleQuotes { mstore8(result, 34) result := add(1, result) } // Store "\\u0000" in scratch space. // Store "0123456789abcdef" in scratch space. // Also, store `{0x08:"b", 0x09:"t", 0x0a:"n", 0x0c:"f", 0x0d:"r"}`. // into the scratch space. mstore(0x15, 0x5c75303030303031323334353637383961626364656662746e006672) // Bitmask for detecting `["\"","\\"]`. let e := or(shl(0x22, 1), shl(0x5c, 1)) for {} iszero(eq(s, end)) {} { s := add(s, 1) let c := and(mload(s), 0xff) if iszero(lt(c, 0x20)) { if iszero(and(shl(c, 1), e)) { // Not in `["\"","\\"]`. mstore8(result, c) result := add(result, 1) continue } mstore8(result, 0x5c) // "\\". mstore8(add(result, 1), c) result := add(result, 2) continue } if iszero(and(shl(c, 1), 0x3700)) { // Not in `["\b","\t","\n","\f","\d"]`. mstore8(0x1d, mload(shr(4, c))) // Hex value. mstore8(0x1e, mload(and(c, 15))) // Hex value. mstore(result, mload(0x19)) // "\\u00XX". result := add(result, 6) continue } mstore8(result, 0x5c) // "\\". mstore8(add(result, 1), mload(add(c, 8))) result := add(result, 2) } if addDoubleQuotes { mstore8(result, 34) result := add(1, result) } let last := result mstore(last, 0) // Zeroize the slot after the string. result := mload(0x40) mstore(result, sub(last, add(result, 0x20))) // Store the length. mstore(0x40, add(last, 0x20)) // Allocate the memory. } } /// @dev Escapes the string to be used within double-quotes in a JSON. function escapeJSON(string memory s) internal pure returns (string memory result) { result = escapeJSON(s, false); } /// @dev Returns whether `a` equals `b`. function eq(string memory a, string memory b) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { result := eq(keccak256(add(a, 0x20), mload(a)), keccak256(add(b, 0x20), mload(b))) } } /// @dev Returns whether `a` equals `b`, where `b` is a null-terminated small string. function eqs(string memory a, bytes32 b) internal pure returns (bool result) { /// @solidity memory-safe-assembly assembly { // These should be evaluated on compile time, as far as possible. let m := not(shl(7, div(not(iszero(b)), 255))) // `0x7f7f ...`. let x := not(or(m, or(b, add(m, and(b, m))))) let r := shl(7, iszero(iszero(shr(128, x)))) r := or(r, shl(6, iszero(iszero(shr(64, shr(r, x)))))) r := or(r, shl(5, lt(0xffffffff, shr(r, x)))) r := or(r, shl(4, lt(0xffff, shr(r, x)))) r := or(r, shl(3, lt(0xff, shr(r, x)))) // forgefmt: disable-next-item result := gt(eq(mload(a), add(iszero(x), xor(31, shr(3, r)))), xor(shr(add(8, r), b), shr(add(8, r), mload(add(a, 0x20))))) } } /// @dev Packs a single string with its length into a single word. /// Returns `bytes32(0)` if the length is zero or greater than 31. function packOne(string memory a) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { // We don't need to zero right pad the string, // since this is our own custom non-standard packing scheme. result := mul( // Load the length and the bytes. mload(add(a, 0x1f)), // `length != 0 && length < 32`. Abuses underflow. // Assumes that the length is valid and within the block gas limit. lt(sub(mload(a), 1), 0x1f) ) } } /// @dev Unpacks a string packed using {packOne}. /// Returns the empty string if `packed` is `bytes32(0)`. /// If `packed` is not an output of {packOne}, the output behavior is undefined. function unpackOne(bytes32 packed) internal pure returns (string memory result) { /// @solidity memory-safe-assembly assembly { // Grab the free memory pointer. result := mload(0x40) // Allocate 2 words (1 for the length, 1 for the bytes). mstore(0x40, add(result, 0x40)) // Zeroize the length slot. mstore(result, 0) // Store the length and bytes. mstore(add(result, 0x1f), packed) // Right pad with zeroes. mstore(add(add(result, 0x20), mload(result)), 0) } } /// @dev Packs two strings with their lengths into a single word. /// Returns `bytes32(0)` if combined length is zero or greater than 30. function packTwo(string memory a, string memory b) internal pure returns (bytes32 result) { /// @solidity memory-safe-assembly assembly { let aLength := mload(a) // We don't need to zero right pad the strings, // since this is our own custom non-standard packing scheme. result := mul( // Load the length and the bytes of `a` and `b`. or( shl(shl(3, sub(0x1f, aLength)), mload(add(a, aLength))), mload(sub(add(b, 0x1e), aLength)) ), // `totalLength != 0 && totalLength < 31`. Abuses underflow. // Assumes that the lengths are valid and within the block gas limit. lt(sub(add(aLength, mload(b)), 1), 0x1e) ) } } /// @dev Unpacks strings packed using {packTwo}. /// Returns the empty strings if `packed` is `bytes32(0)`. /// If `packed` is not an output of {packTwo}, the output behavior is undefined. function unpackTwo(bytes32 packed) internal pure returns (string memory resultA, string memory resultB) { /// @solidity memory-safe-assembly assembly { // Grab the free memory pointer. resultA := mload(0x40) resultB := add(resultA, 0x40) // Allocate 2 words for each string (1 for the length, 1 for the byte). Total 4 words. mstore(0x40, add(resultB, 0x40)) // Zeroize the length slots. mstore(resultA, 0) mstore(resultB, 0) // Store the lengths and bytes. mstore(add(resultA, 0x1f), packed) mstore(add(resultB, 0x1f), mload(add(add(resultA, 0x20), mload(resultA)))) // Right pad with zeroes. mstore(add(add(resultA, 0x20), mload(resultA)), 0) mstore(add(add(resultB, 0x20), mload(resultB)), 0) } } /// @dev Directly returns `a` without copying. function directReturn(string memory a) internal pure { assembly { // Assumes that the string does not start from the scratch space. let retStart := sub(a, 0x20) let retSize := add(mload(a), 0x40) // Right pad with zeroes. Just in case the string is produced // by a method that doesn't zero right pad. mstore(add(retStart, retSize), 0) // Store the return offset. mstore(retStart, 0x20) // End the transaction, returning the string. return(retStart, retSize) } } } /// @title DN404 /// @notice DN404 is a hybrid ERC20 and ERC721 implementation that mints /// and burns NFTs based on an account's ERC20 token balance. /// /// @author vectorized.eth (@optimizoor) /// @author Quit (@0xQuit) /// @author Michael Amadi (@AmadiMichaels) /// @author cygaar (@0xCygaar) /// @author Thomas (@0xjustadev) /// @author Harrison (@PopPunkOnChain) /// /// @dev Note: /// - The ERC721 data is stored in this base DN404 contract, however a /// DN404Mirror contract ***MUST*** be deployed and linked during /// initialization. abstract contract DN404 { /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* EVENTS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Emitted when `amount` tokens is transferred from `from` to `to`. event Transfer(address indexed from, address indexed to, uint256 amount); /// @dev Emitted when `amount` tokens is approved by `owner` to be used by `spender`. event Approval(address indexed owner, address indexed spender, uint256 amount); /// @dev Emitted when `target` sets their skipNFT flag to `status`. event SkipNFTSet(address indexed target, bool status); /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* CUSTOM ERRORS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Thrown when attempting to double-initialize the contract. error DNAlreadyInitialized(); /// @dev Thrown when attempting to transfer or burn more tokens than sender's balance. error InsufficientBalance(); /// @dev Thrown when a spender attempts to transfer tokens with an insufficient allowance. error InsufficientAllowance(); /// @dev Thrown when minting an amount of tokens that would overflow the max tokens. error TotalSupplyOverflow(); /// @dev Thrown when the caller for a fallback NFT function is not the mirror contract. error SenderNotMirror(); /// @dev Thrown when attempting to transfer tokens to the zero address. error TransferToZeroAddress(); /// @dev Thrown when the mirror address provided for initialization is the zero address. error MirrorAddressIsZero(); /// @dev Thrown when the link call to the mirror contract reverts. error LinkMirrorContractFailed(); /// @dev Thrown when setting an NFT token approval /// and the caller is not the owner or an approved operator. error ApprovalCallerNotOwnerNorApproved(); /// @dev Thrown when transferring an NFT /// and the caller is not the owner or an approved operator. error TransferCallerNotOwnerNorApproved(); /// @dev Thrown when transferring an NFT and the from address is not the current owner. error TransferFromIncorrectOwner(); /// @dev Thrown when checking the owner or approved address for an non-existent NFT. error TokenDoesNotExist(); /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* CONSTANTS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Amount of token balance that is equal to one NFT. uint256 internal constant _WAD = 10 ** 18; /// @dev The maximum token ID allowed for an NFT. uint256 internal constant _MAX_TOKEN_ID = 0xffffffff; /// @dev The maximum possible token supply. uint256 internal constant _MAX_SUPPLY = 10 ** 18 * 0xffffffff - 1; /// @dev The flag to denote that the address data is initialized. uint8 internal constant _ADDRESS_DATA_INITIALIZED_FLAG = 1 << 0; /// @dev The flag to denote that the address should skip NFTs. uint8 internal constant _ADDRESS_DATA_SKIP_NFT_FLAG = 1 << 1; /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* STORAGE */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Struct containing an address's token data and settings. struct AddressData { // Auxiliary data. uint88 aux; // Flags for `initialized` and `skipNFT`. uint8 flags; // The alias for the address. Zero means absence of an alias. uint32 addressAlias; // The number of NFT tokens. uint32 ownedLength; // The token balance in wei. uint96 balance; } /// @dev A uint32 map in storage. struct Uint32Map { mapping(uint256 => uint256) map; } /// @dev Struct containing the base token contract storage. struct DN404Storage { // Current number of address aliases assigned. uint32 numAliases; // Next token ID to assign for an NFT mint. uint32 nextTokenId; // Total supply of minted NFTs. uint32 totalNFTSupply; // Total supply of tokens. uint96 totalSupply; // Mapping of a user alias number to their address. mapping(uint32 => address) aliasToAddress; // Mapping of user operator approvals for NFTs. mapping(address => mapping(address => bool)) operatorApprovals; // Mapping of NFT token approvals to approved operators. mapping(uint256 => address) tokenApprovals; // Mapping of user allowances for token spenders. mapping(address => mapping(address => uint256)) allowance; // Mapping of NFT token IDs owned by an address. mapping(address => Uint32Map) owned; // Even indices: owner aliases. Odd indices: owned indices. Uint32Map oo; // Mapping of user account AddressData mapping(address => AddressData) addressData; } /// @dev Returns a storage pointer for DN404Storage. function _getDN404Storage() internal pure virtual returns (DN404Storage storage $) { /// @solidity memory-safe-assembly assembly { // `uint72(bytes9(keccak256("DN404_STORAGE")))`. $.slot := 0xa20d6e21d0e5255308 // Truncate to 9 bytes to reduce bytecode size. } } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* INITIALIZER */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Initializes the DN404 contract with an /// `initialTokenSupply`, `initialTokenOwner` and `mirror` NFT contract address. function _initializeDN404( uint256 initialTokenSupply, address initialSupplyOwner ) internal virtual { DN404Storage storage $ = _getDN404Storage(); if ($.nextTokenId != 0) revert DNAlreadyInitialized(); $.nextTokenId = 1; if (initialTokenSupply > 0) { if (initialSupplyOwner == address(0)) revert TransferToZeroAddress(); if (initialTokenSupply > _MAX_SUPPLY) revert TotalSupplyOverflow(); $.totalSupply = uint96(initialTokenSupply); AddressData storage initialOwnerAddressData = _addressData(initialSupplyOwner); initialOwnerAddressData.balance = uint96(initialTokenSupply); emit Transfer(address(0), initialSupplyOwner, initialTokenSupply); _setSkipNFT(initialSupplyOwner, true); } } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* METADATA FUNCTIONS TO OVERRIDE */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Returns the name of the token. function name() public view virtual returns (string memory); /// @dev Returns the symbol of the token. function symbol() public view virtual returns (string memory); /// @dev Returns the Uniform Resource Identifier (URI) for token `id`. function tokenURI(uint256 id) public view virtual returns (string memory); /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* ERC20 OPERATIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Returns the decimals places of the token. Always 18. function decimals() public pure returns (uint8) { return 18; } /// @dev Returns the amount of tokens in existence. function totalSupply() public view virtual returns (uint256) { return uint256(_getDN404Storage().totalSupply); } /// @dev Returns the amount of tokens owned by `owner`. function balanceOf(address owner) public view virtual returns (uint256) { return _getDN404Storage().addressData[owner].balance; } /// @dev Returns the amount of tokens that `spender` can spend on behalf of `owner`. function allowance(address owner, address spender) public view returns (uint256) { return _getDN404Storage().allowance[owner][spender]; } /// @dev Sets `amount` as the allowance of `spender` over the caller's tokens. /// /// Emits a {Approval} event. function approve(address spender, uint256 amount) public virtual returns (bool) { DN404Storage storage $ = _getDN404Storage(); $.allowance[msg.sender][spender] = amount; emit Approval(msg.sender, spender, amount); return true; } /// @dev Transfer `amount` tokens from the caller to `to`. /// /// Will burn sender NFTs if balance after transfer is less than /// the amount required to support the current NFT balance. /// /// Will mint NFTs to `to` if the recipient's new balance supports /// additional NFTs ***AND*** the `to` address's skipNFT flag is /// set to false. /// /// Requirements: /// - `from` must at least have `amount`. /// /// Emits a {Transfer} event. function transfer(address to, uint256 amount) public virtual returns (bool) { _transfer(msg.sender, to, amount); return true; } /// @dev Transfers `amount` tokens from `from` to `to`. /// /// Note: Does not update the allowance if it is the maximum uint256 value. /// /// Will burn sender NFTs if balance after transfer is less than /// the amount required to support the current NFT balance. /// /// Will mint NFTs to `to` if the recipient's new balance supports /// additional NFTs ***AND*** the `to` address's skipNFT flag is /// set to false. /// /// Requirements: /// - `from` must at least have `amount`. /// - The caller must have at least `amount` of allowance to transfer the tokens of `from`. /// /// Emits a {Transfer} event. function transferFrom(address from, address to, uint256 amount) public virtual returns (bool) { DN404Storage storage $ = _getDN404Storage(); uint256 allowed = $.allowance[from][msg.sender]; if (allowed != type(uint256).max) { if (amount > allowed) revert InsufficientAllowance(); unchecked { $.allowance[from][msg.sender] = allowed - amount; } } _transfer(from, to, amount); return true; } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* INTERNAL MINT FUNCTIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Mints `amount` tokens to `to`, increasing the total supply. /// /// Will mint NFTs to `to` if the recipient's new balance supports /// additional NFTs ***AND*** the `to` address's skipNFT flag is /// set to false. /// /// Emits a {Transfer} event. function _mint(address to, uint256 amount) internal virtual { if (to == address(0)) revert TransferToZeroAddress(); DN404Storage storage $ = _getDN404Storage(); AddressData storage toAddressData = _addressData(to); unchecked { uint256 currentTokenSupply = uint256($.totalSupply) + amount; if (amount > _MAX_SUPPLY || currentTokenSupply > _MAX_SUPPLY) { revert TotalSupplyOverflow(); } $.totalSupply = uint96(currentTokenSupply); uint256 toBalance = toAddressData.balance + amount; toAddressData.balance = uint96(toBalance); } emit Transfer(address(0), to, amount); } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* INTERNAL BURN FUNCTIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Burns `amount` tokens from `from`, reducing the total supply. /// /// Will burn sender NFTs if balance after transfer is less than /// the amount required to support the current NFT balance. /// /// Emits a {Transfer} event. function _burn(address from, uint256 amount) internal virtual { DN404Storage storage $ = _getDN404Storage(); AddressData storage fromAddressData = _addressData(from); uint256 fromBalance = fromAddressData.balance; if (amount > fromBalance) revert InsufficientBalance(); uint256 currentTokenSupply = $.totalSupply; unchecked { fromBalance -= amount; fromAddressData.balance = uint96(fromBalance); currentTokenSupply -= amount; $.totalSupply = uint96(currentTokenSupply); } emit Transfer(from, address(0), amount); } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* INTERNAL TRANSFER FUNCTIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Moves `amount` of tokens from `from` to `to`. /// /// Will burn sender NFTs if balance after transfer is less than /// the amount required to support the current NFT balance. /// /// Will mint NFTs to `to` if the recipient's new balance supports /// additional NFTs ***AND*** the `to` address's skipNFT flag is /// set to false. /// /// Emits a {Transfer} event. function _transfer(address from, address to, uint256 amount) internal virtual { if (to == address(0)) revert TransferToZeroAddress(); AddressData storage fromAddressData = _addressData(from); AddressData storage toAddressData = _addressData(to); _TransferTemps memory t; t.fromOwnedLength = fromAddressData.ownedLength; t.toOwnedLength = toAddressData.ownedLength; t.fromBalance = fromAddressData.balance; if (amount > t.fromBalance) revert InsufficientBalance(); unchecked { t.fromBalance -= amount; fromAddressData.balance = uint96(t.fromBalance); toAddressData.balance = uint96(t.toBalance = toAddressData.balance + amount); } emit Transfer(from, to, amount); } /// @dev Transfers token `id` from `from` to `to`. /// /// Requirements: /// /// - Call must originate from the mirror contract. /// - Token `id` must exist. /// - `from` must be the owner of the token. /// - `to` cannot be the zero address. /// `msgSender` must be the owner of the token, or be approved to manage the token. /// /// Emits a {Transfer} event. function _transferFromNFT(address from, address to, uint256 id, address msgSender) internal virtual { DN404Storage storage $ = _getDN404Storage(); if (to == address(0)) revert TransferToZeroAddress(); address owner = $.aliasToAddress[_get($.oo, _ownershipIndex(id))]; if (from != owner) revert TransferFromIncorrectOwner(); if (msgSender != from) { if (!$.operatorApprovals[from][msgSender]) { if (msgSender != $.tokenApprovals[id]) { revert TransferCallerNotOwnerNorApproved(); } } } AddressData storage fromAddressData = _addressData(from); AddressData storage toAddressData = _addressData(to); fromAddressData.balance -= uint96(_WAD); unchecked { toAddressData.balance += uint96(_WAD); _set($.oo, _ownershipIndex(id), _registerAndResolveAlias(toAddressData, to)); delete $.tokenApprovals[id]; uint256 updatedId = _get($.owned[from], --fromAddressData.ownedLength); _set($.owned[from], _get($.oo, _ownedIndex(id)), uint32(updatedId)); uint256 n = toAddressData.ownedLength++; _set($.oo, _ownedIndex(updatedId), _get($.oo, _ownedIndex(id))); _set($.owned[to], n, uint32(id)); _set($.oo, _ownedIndex(id), uint32(n)); } emit Transfer(from, to, _WAD); } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* DATA HITCHHIKING FUNCTIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Returns the auxiliary data for `owner`. /// Minting, transferring, burning the tokens of `owner` will not change the auxiliary data. /// Auxiliary data can be set for any address, even if it does not have any tokens. function _getAux(address owner) internal view virtual returns (uint88) { return _getDN404Storage().addressData[owner].aux; } /// @dev Set the auxiliary data for `owner` to `value`. /// Minting, transferring, burning the tokens of `owner` will not change the auxiliary data. /// Auxiliary data can be set for any address, even if it does not have any tokens. function _setAux(address owner, uint88 value) internal virtual { _getDN404Storage().addressData[owner].aux = value; } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* SKIP NFT FUNCTIONS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Returns true if account `a` will skip NFT minting on token mints and transfers. /// Returns false if account `a` will mint NFTs on token mints and transfers. function getSkipNFT(address a) public view virtual returns (bool) { AddressData storage d = _getDN404Storage().addressData[a]; if (d.flags & _ADDRESS_DATA_INITIALIZED_FLAG == 0) return _hasCode(a); return d.flags & _ADDRESS_DATA_SKIP_NFT_FLAG != 0; } /// @dev Sets the caller's skipNFT flag to `skipNFT` /// /// Emits a {SkipNFTSet} event. function setSkipNFT(bool skipNFT) public virtual { _setSkipNFT(msg.sender, skipNFT); } /// @dev Internal function to set account `a` skipNFT flag to `state` /// /// Initializes account `a` AddressData if it is not currently initialized. /// /// Emits a {SkipNFTSet} event. function _setSkipNFT(address a, bool state) internal virtual { AddressData storage d = _addressData(a); if ((d.flags & _ADDRESS_DATA_SKIP_NFT_FLAG != 0) != state) { d.flags ^= _ADDRESS_DATA_SKIP_NFT_FLAG; } emit SkipNFTSet(a, state); } /// @dev Returns a storage data pointer for account `a` AddressData /// /// Initializes account `a` AddressData if it is not currently initialized. function _addressData(address a) internal virtual returns (AddressData storage d) { DN404Storage storage $ = _getDN404Storage(); d = $.addressData[a]; if (d.flags & _ADDRESS_DATA_INITIALIZED_FLAG == 0) { uint8 flags = _ADDRESS_DATA_INITIALIZED_FLAG; if (_hasCode(a)) flags |= _ADDRESS_DATA_SKIP_NFT_FLAG; d.flags = flags; } } /// @dev Returns the `addressAlias` of account `to`. /// /// Assigns and registers the next alias if `to` alias was not previously registered. function _registerAndResolveAlias(AddressData storage toAddressData, address to) internal virtual returns (uint32 addressAlias) { DN404Storage storage $ = _getDN404Storage(); addressAlias = toAddressData.addressAlias; if (addressAlias == 0) { addressAlias = ++$.numAliases; toAddressData.addressAlias = addressAlias; $.aliasToAddress[addressAlias] = to; } } /// @dev Returns the total NFT supply. function _totalNFTSupply() internal view virtual returns (uint256) { return _getDN404Storage().totalNFTSupply; } /// @dev Returns `owner` NFT balance. function _balanceOfNFT(address owner) internal view virtual returns (uint256) { return _getDN404Storage().addressData[owner].ownedLength; } /// @dev Returns the owner of token `id`. /// Returns the zero address instead of reverting if the token does not exist. function _ownerAt(uint256 id) internal view virtual returns (address) { DN404Storage storage $ = _getDN404Storage(); return $.aliasToAddress[_get($.oo, _ownershipIndex(id))]; } /// @dev Returns the owner of token `id`. /// /// Requirements: /// - Token `id` must exist. function _ownerOf(uint256 id) internal view virtual returns (address) { if (!_exists(id)) revert TokenDoesNotExist(); return _ownerAt(id); } /// @dev Returns if token `id` exists. function _exists(uint256 id) internal view virtual returns (bool) { return _ownerAt(id) != address(0); } /// @dev Returns the account approved to manage token `id`. /// /// Requirements: /// - Token `id` must exist. function _getApproved(uint256 id) internal view virtual returns (address) { if (!_exists(id)) revert TokenDoesNotExist(); return _getDN404Storage().tokenApprovals[id]; } /// @dev Sets `spender` as the approved account to manage token `id`, using `msgSender`. /// /// Requirements: /// - `msgSender` must be the owner or an approved operator for the token owner. function _approveNFT(address spender, uint256 id, address msgSender) internal virtual returns (address) { DN404Storage storage $ = _getDN404Storage(); address owner = $.aliasToAddress[_get($.oo, _ownershipIndex(id))]; if (msgSender != owner) { if (!$.operatorApprovals[owner][msgSender]) { revert ApprovalCallerNotOwnerNorApproved(); } } $.tokenApprovals[id] = spender; return owner; } /// @dev Approve or remove the `operator` as an operator for `msgSender`, /// without authorization checks. function _setApprovalForAll(address operator, bool approved, address msgSender) internal virtual { _getDN404Storage().operatorApprovals[msgSender][operator] = approved; } /// @dev Calls the mirror contract to link it to this contract. /// /// Reverts if the call to the mirror contract reverts. function _linkMirrorContract(address mirror) internal virtual { /// @solidity memory-safe-assembly assembly { mstore(0x00, 0x0f4599e5) // `linkMirrorContract(address)`. mstore(0x20, caller()) if iszero(and(eq(mload(0x00), 1), call(gas(), mirror, 0, 0x1c, 0x24, 0x00, 0x20))) { mstore(0x00, 0xd125259c) // `LinkMirrorContractFailed()`. revert(0x1c, 0x04) } } } /// @dev Fallback modifier to dispatch calls from the mirror NFT contract /// to internal functions in this contract. modifier dn404Fallback() virtual { DN404Storage storage $ = _getDN404Storage(); uint256 fnSelector = _calldataload(0x00) >> 224; // `isApprovedForAll(address,address)`. if (fnSelector == 0xe985e9c5) { if (msg.data.length < 0x44) revert(); address owner = address(uint160(_calldataload(0x04))); address operator = address(uint160(_calldataload(0x24))); _return($.operatorApprovals[owner][operator] ? 1 : 0); } // `ownerOf(uint256)`. if (fnSelector == 0x6352211e) { if (msg.data.length < 0x24) revert(); uint256 id = _calldataload(0x04); _return(uint160(_ownerOf(id))); } // `transferFromNFT(address,address,uint256,address)`. if (fnSelector == 0xe5eb36c8) { if (msg.data.length < 0x84) revert(); address from = address(uint160(_calldataload(0x04))); address to = address(uint160(_calldataload(0x24))); uint256 id = _calldataload(0x44); address msgSender = address(uint160(_calldataload(0x64))); _transferFromNFT(from, to, id, msgSender); _return(1); } // `setApprovalForAll(address,bool,address)`. if (fnSelector == 0x813500fc) { if (msg.data.length < 0x64) revert(); address spender = address(uint160(_calldataload(0x04))); bool status = _calldataload(0x24) != 0; address msgSender = address(uint160(_calldataload(0x44))); _setApprovalForAll(spender, status, msgSender); _return(1); } // `approveNFT(address,uint256,address)`. if (fnSelector == 0xd10b6e0c) { if (msg.data.length < 0x64) revert(); address spender = address(uint160(_calldataload(0x04))); uint256 id = _calldataload(0x24); address msgSender = address(uint160(_calldataload(0x44))); _return(uint160(_approveNFT(spender, id, msgSender))); } // `getApproved(uint256)`. if (fnSelector == 0x081812fc) { if (msg.data.length < 0x24) revert(); uint256 id = _calldataload(0x04); _return(uint160(_getApproved(id))); } // `balanceOfNFT(address)`. if (fnSelector == 0xf5b100ea) { if (msg.data.length < 0x24) revert(); address owner = address(uint160(_calldataload(0x04))); _return(_balanceOfNFT(owner)); } // `totalNFTSupply()`. if (fnSelector == 0xe2c79281) { if (msg.data.length < 0x04) revert(); _return(_totalNFTSupply()); } // `implementsDN404()`. if (fnSelector == 0xb7a94eb8) { _return(1); } _; } /// @dev Fallback function for calls from mirror NFT contract. fallback() external payable virtual dn404Fallback {} receive() external payable virtual {} /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* PRIVATE HELPERS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ /// @dev Struct containing packed log data for `Transfer` events to be /// emitted by the mirror NFT contract. struct _PackedLogs { uint256[] logs; uint256 offset; } /// @dev Initiates memory allocation for packed logs with `n` log items. function _packedLogsMalloc(uint256 n) private pure returns (_PackedLogs memory p) { /// @solidity memory-safe-assembly assembly { let logs := add(mload(0x40), 0x40) // Offset by 2 words for `_packedLogsSend`. mstore(logs, n) let offset := add(0x20, logs) mstore(0x40, add(offset, shl(5, n))) mstore(p, logs) mstore(add(0x20, p), offset) } } /// @dev Adds a packed log item to `p` with address `a`, token `id` and burn flag `burnBit`. function _packedLogsAppend(_PackedLogs memory p, address a, uint256 id, uint256 burnBit) private pure { /// @solidity memory-safe-assembly assembly { let offset := mload(add(0x20, p)) mstore(offset, or(or(shl(96, a), shl(8, id)), burnBit)) mstore(add(0x20, p), add(offset, 0x20)) } } /// @dev Calls the `mirror` NFT contract to emit Transfer events for packed logs `p`. function _packedLogsSend(_PackedLogs memory p, address mirror) private { /// @solidity memory-safe-assembly assembly { let logs := mload(p) let o := sub(logs, 0x40) // Start of calldata to send. mstore(o, 0x263c69d6) // `logTransfer(uint256[])`. mstore(add(o, 0x20), 0x20) // Offset of `logs` in the calldata to send. let n := add(0x44, shl(5, mload(logs))) // Length of calldata to send. if iszero(and(eq(mload(o), 1), call(gas(), mirror, 0, add(o, 0x1c), n, o, 0x20))) { revert(o, 0x00) } } } /// @dev Struct of temporary variables for transfers. struct _TransferTemps { uint256 nftAmountToBurn; uint256 nftAmountToMint; uint256 fromBalance; uint256 toBalance; uint256 fromOwnedLength; uint256 toOwnedLength; } /// @dev Returns if `a` has bytecode of non-zero length. function _hasCode(address a) private view returns (bool result) { /// @solidity memory-safe-assembly assembly { result := extcodesize(a) // Can handle dirty upper bits. } } /// @dev Returns the calldata value at `offset`. function _calldataload(uint256 offset) private pure returns (uint256 value) { /// @solidity memory-safe-assembly assembly { value := calldataload(offset) } } /// @dev Executes a return opcode to return `x` and end the current call frame. function _return(uint256 x) private pure { /// @solidity memory-safe-assembly assembly { mstore(0x00, x) return(0x00, 0x20) } } /// @dev Returns `max(0, x - y)`. function _zeroFloorSub(uint256 x, uint256 y) private pure returns (uint256 z) { /// @solidity memory-safe-assembly assembly { z := mul(gt(x, y), sub(x, y)) } } /// @dev Returns `i << 1`. function _ownershipIndex(uint256 i) private pure returns (uint256) { return i << 1; } /// @dev Returns `(i << 1) + 1`. function _ownedIndex(uint256 i) private pure returns (uint256) { unchecked { return (i << 1) + 1; } } /// @dev Returns the uint32 value at `index` in `map`. function _get(Uint32Map storage map, uint256 index) private view returns (uint32 result) { result = uint32(map.map[index >> 3] >> ((index & 7) << 5)); } /// @dev Updates the uint32 value at `index` in `map`. function _set(Uint32Map storage map, uint256 index, uint32 value) private { /// @solidity memory-safe-assembly assembly { mstore(0x20, map.slot) mstore(0x00, shr(3, index)) let s := keccak256(0x00, 0x40) // Storage slot. let o := shl(5, and(index, 7)) // Storage slot offset (bits). let v := sload(s) // Storage slot value. let m := 0xffffffff // Value mask. sstore(s, xor(v, shl(o, and(m, xor(shr(o, v), value))))) } } /// @dev Sets the owner alias and the owned index together. function _setOwnerAliasAndOwnedIndex( Uint32Map storage map, uint256 id, uint32 ownership, uint32 ownedIndex ) private { /// @solidity memory-safe-assembly assembly { let value := or(shl(32, ownedIndex), and(0xffffffff, ownership)) mstore(0x20, map.slot) mstore(0x00, shr(2, id)) let s := keccak256(0x00, 0x40) // Storage slot. let o := shl(6, and(id, 3)) // Storage slot offset (bits). let v := sload(s) // Storage slot value. let m := 0xffffffffffffffff // Value mask. sstore(s, xor(v, shl(o, and(m, xor(shr(o, v), value))))) } } } library DailyOutflowCounterLib { uint256 internal constant WAD_TRUNCATED = 10 ** 18 >> 40; uint256 internal constant OUTFLOW_TRUNCATED_MASK = 0xffffffffffffff; uint256 internal constant DAY_BITPOS = 56; uint256 internal constant DAY_MASK = 0x7fffffff; uint256 internal constant OUTFLOW_TRUNCATE_SHR = 40; uint256 internal constant WHITELISTED_BITPOS = 87; function update(uint88 packed, uint256 outflow) internal view returns (uint88 updated, uint256 multiple) { unchecked { if (isWhitelisted(packed)) { return (packed, 0); } uint256 currentDay = (block.timestamp / 86400) & DAY_MASK; uint256 packedDay = (uint256(packed) >> DAY_BITPOS) & DAY_MASK; uint256 totalOutflowTruncated = uint256(packed) & OUTFLOW_TRUNCATED_MASK; if (packedDay != currentDay) { totalOutflowTruncated = 0; packedDay = currentDay; } uint256 result = packedDay << DAY_BITPOS; uint256 todaysOutflowTruncated = totalOutflowTruncated + ((outflow >> OUTFLOW_TRUNCATE_SHR) & OUTFLOW_TRUNCATED_MASK); result |= todaysOutflowTruncated & OUTFLOW_TRUNCATED_MASK; updated = uint88(result); multiple = todaysOutflowTruncated / WAD_TRUNCATED; } } function isWhitelisted(uint88 packed) internal pure returns (bool) { return packed >> WHITELISTED_BITPOS != 0; } function setWhitelisted(uint88 packed, bool status) internal pure returns (uint88) { if (isWhitelisted(packed) != status) { packed ^= uint88(1 << WHITELISTED_BITPOS); } return packed; } } contract Furnace is DN404, OwnableRoles { using DailyOutflowCounterLib for *; /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* CONSTANTS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ uint256 public constant ADMIN_ROLE = _ROLE_0; /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* CUSTOM ERRORS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ error Locked(); error MaxBalanceLimitReached(); /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* STORAGE */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ string internal _name; string internal _symbol; string internal _baseURI; bool public baseURILocked; bool public nameAndSymbolLocked; bool public gasBurnFactorLocked; bool public whitelistLocked; constructor() { _construct(tx.origin); } function _construct(address initialOwner) internal { _initializeOwner(initialOwner); _setWhitelisted(initialOwner, true); _name = "Furnace 404"; _symbol = "FURNACE"; } function name() public view override returns (string memory) { return _name; } function symbol() public view override returns (string memory) { return _symbol; } function tokenURI(uint256 id) public view override returns (string memory result) { if (!_exists(id)) revert TokenDoesNotExist(); if (bytes(_baseURI).length != 0) { result = LibString.replace(_baseURI, "{id}", LibString.toString(id)); } } /*«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-«-*/ /* TRANSFERS */ /*-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»-»*/ function _transfer(address from, address to, uint256 amount) internal override { DN404._transfer(from, to, amount); } function _transferFromNFT(address from, address to, uint256 id, address msgSender) internal override { DN404._transferFromNFT(from, to, id, msgSender); } function _setWhitelisted(address target, bool status) internal { _setAux(target, _getAux(target).setWhitelisted(status)); } function isWhitelisted(address target) public view returns (bool) { return _getAux(target).isWhitelisted(); } function initialize() public onlyOwnerOrRoles(ADMIN_ROLE) { uint256 initialTokenSupply = 10000 * _WAD; address initialSupplyOwner = msg.sender; _initializeDN404(initialTokenSupply, initialSupplyOwner); _setWhitelisted(initialSupplyOwner, true); } function lockBaseURI() public onlyOwnerOrRoles(ADMIN_ROLE) { baseURILocked = true; } function setBaseURI(string calldata baseURI_) public onlyOwnerOrRoles(ADMIN_ROLE) { if (baseURILocked) revert Locked(); _baseURI = baseURI_; } }
Contract Security Audit
- No Contract Security Audit Submitted- Submit Audit Here
[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"ApprovalCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"DNAlreadyInitialized","type":"error"},{"inputs":[],"name":"InsufficientAllowance","type":"error"},{"inputs":[],"name":"InsufficientBalance","type":"error"},{"inputs":[],"name":"LinkMirrorContractFailed","type":"error"},{"inputs":[],"name":"Locked","type":"error"},{"inputs":[],"name":"MaxBalanceLimitReached","type":"error"},{"inputs":[],"name":"MirrorAddressIsZero","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"SenderNotMirror","type":"error"},{"inputs":[],"name":"TokenDoesNotExist","type":"error"},{"inputs":[],"name":"TotalSupplyOverflow","type":"error"},{"inputs":[],"name":"TransferCallerNotOwnerNorApproved","type":"error"},{"inputs":[],"name":"TransferFromIncorrectOwner","type":"error"},{"inputs":[],"name":"TransferToZeroAddress","type":"error"},{"inputs":[],"name":"Unauthorized","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverCanceled","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"pendingOwner","type":"address"}],"name":"OwnershipHandoverRequested","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"oldOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"user","type":"address"},{"indexed":true,"internalType":"uint256","name":"roles","type":"uint256"}],"name":"RolesUpdated","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"target","type":"address"},{"indexed":false,"internalType":"bool","name":"status","type":"bool"}],"name":"SkipNFTSet","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":true,"internalType":"address","name":"to","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"Transfer","type":"event"},{"stateMutability":"payable","type":"fallback"},{"inputs":[],"name":"ADMIN_ROLE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"baseURILocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"cancelOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"completeOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"gasBurnFactorLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"a","type":"address"}],"name":"getSkipNFT","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"grantRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAllRoles","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"hasAnyRole","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"initialize","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"target","type":"address"}],"name":"isWhitelisted","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"lockBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"nameAndSymbolLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"pendingOwner","type":"address"}],"name":"ownershipHandoverExpiresAt","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"renounceRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"},{"internalType":"uint256","name":"roles","type":"uint256"}],"name":"revokeRoles","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"address","name":"user","type":"address"}],"name":"rolesOf","outputs":[{"internalType":"uint256","name":"roles","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"string","name":"baseURI_","type":"string"}],"name":"setBaseURI","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"bool","name":"skipNFT","type":"bool"}],"name":"setSkipNFT","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"id","type":"uint256"}],"name":"tokenURI","outputs":[{"internalType":"string","name":"result","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"from","type":"address"},{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"newOwner","type":"address"}],"name":"transferOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"whitelistLocked","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"view","type":"function"},{"stateMutability":"payable","type":"receive"}]
Contract Creation Code
608060405234801562000010575f80fd5b506200001c3262000022565b62000300565b6200002d816200009c565b6200003a816001620000d7565b60408051808201909152600b81526a119d5c9b9858d9480d0c0d60aa1b60208201525f906200006a908262000234565b506040805180820190915260078152664655524e41434560c81b602082015260019062000098908262000234565b5050565b6001600160a01b0316638b78c6d819819055805f7f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08180a350565b6200009882620001218362000111836001600160a01b03165f90815268a20d6e21d0e525530f60205260409020546001600160581b031690565b6001600160581b03169062000161565b6001600160a01b03919091165f90815268a20d6e21d0e525530f6020526040902080546001600160581b0319166001600160581b03909216919091179055565b5f811515620001758460571c600116151590565b1515146200018f576a800000000000000000000092909218915b5090919050565b634e487b7160e01b5f52604160045260245ffd5b600181811c90821680620001bf57607f821691505b602082108103620001de57634e487b7160e01b5f52602260045260245ffd5b50919050565b601f8211156200022f57805f5260205f20601f840160051c810160208510156200020b5750805b601f840160051c820191505b818110156200022c575f815560010162000217565b50505b505050565b81516001600160401b0381111562000250576200025062000196565b6200026881620002618454620001aa565b84620001e4565b602080601f8311600181146200029e575f8415620002865750858301515b5f19600386901b1c1916600185901b178555620002f8565b5f85815260208120601f198616915b82811015620002ce57888601518255948401946001909101908401620002ad565b5085821015620002ec57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b611e1f806200030e5f395ff3fe6080604052600436106101fc575f3560e01c806353df5c7c1161010c5780638da5cb5b1161009f578063d73c1fb31161006e578063d73c1fb3146107ef578063dd62ed3e1461080f578063f04e283e1461085b578063f2fde38b1461086e578063fee81cf41461088157610203565b80638da5cb5b1461077257806395d89b411461079d578063a9059cbb146107b1578063c87b56dd146107d057610203565b806370a08231116100db57806370a08231146106f6578063715018a61461074257806375b238fc1461074a5780638129fc1c1461075e57610203565b806353df5c7c146106a257806354d1f13d146106b657806355f804b3146106be5780635d148e5c146106dd57610203565b8063256929621161018f578063313ce5671161015e578063313ce567146106015780633af32abf1461061c57806347f618a51461063b5780634a4ee7b11461065a578063514e62fc1461066d57610203565b8063256929621461058a578063274e430b146105925780632a6a935d146105b15780632de94807146105d057610203565b8063183a4f6e116101cb578063183a4f6e146105105780631c10893f146105235780631cd64df41461053657806323b872dd1461056b57610203565b806306fdde0314610463578063095ea7b31461048d578063180434a3146104bc57806318160ddd146104da57610203565b3661020357005b68a20d6e21d0e52553085f3560e01c63e985e9c581900361027857604436101561022b575f80fd5b6004356001600160a01b038181165f908152600285016020908152604080832060243594851684529091529020546102759060ff1661026a575f61026d565b60015b60ff166108b2565b50505b80636352211e036102af576024361015610290575f80fd5b6004356102ad61029f826108ba565b6001600160a01b03166108b2565b505b8063e5eb36c8036102ee5760843610156102c7575f80fd5b6004356024356044356064356102df848484846108f0565b6102e960016108b2565b505050505b8063813500fc03610359576064361015610306575f80fd5b6001600160a01b036044358181165f90815268a20d6e21d0e525530a6020908152604080832060043595861684529091529020805460ff191660243515159081179091559061035560016108b2565b5050505b8063d10b6e0c0361038c576064361015610371575f80fd5b60043560243560443561038861029f848484610902565b5050505b8063081812fc036103b55760243610156103a4575f80fd5b6004356103b361029f826109f5565b505b8063f5b100ea0361040e5760243610156103cd575f80fd5b60043561040c610407826001600160a01b03165f90815268a20d6e21d0e525530f602052604090205463ffffffff600160801b9091041690565b6108b2565b505b8063e2c792810361044c576004361015610426575f80fd5b68a20d6e21d0e52553085461044c9068010000000000000000900463ffffffff166108b2565b8063b7a94eb8036104615761046160016108b2565b005b34801561046e575f80fd5b50610477610a3f565b6040516104849190611a82565b60405180910390f35b348015610498575f80fd5b506104ac6104a7366004611ae4565b610ace565b6040519015158152602001610484565b3480156104c7575f80fd5b506003546104ac90610100900460ff1681565b3480156104e5575f80fd5b5068a20d6e21d0e525530854600160601b90046001600160601b03165b604051908152602001610484565b61046161051e366004611b0c565b610b42565b610461610531366004611ae4565b610b4f565b348015610541575f80fd5b506104ac610550366004611ae4565b638b78c6d8600c9081525f9290925260209091205481161490565b348015610576575f80fd5b506104ac610585366004611b23565b610b65565b610461610c05565b34801561059d575f80fd5b506104ac6105ac366004611b5c565b610c52565b3480156105bc575f80fd5b506104616105cb366004611b75565b610ca0565b3480156105db575f80fd5b506105026105ea366004611b5c565b638b78c6d8600c9081525f91909152602090205490565b34801561060c575f80fd5b5060405160128152602001610484565b348015610627575f80fd5b506104ac610636366004611b5c565b610caa565b348015610646575f80fd5b506003546104ac9062010000900460ff1681565b610461610668366004611ae4565b610cd7565b348015610678575f80fd5b506104ac610687366004611ae4565b638b78c6d8600c9081525f9290925260209091205416151590565b3480156106ad575f80fd5b50610461610ce9565b610461610d04565b3480156106c9575f80fd5b506104616106d8366004611b94565b610d3d565b3480156106e8575f80fd5b506003546104ac9060ff1681565b348015610701575f80fd5b50610502610710366004611b5c565b6001600160a01b03165f90815268a20d6e21d0e525530f6020526040902054600160a01b90046001600160601b031690565b610461610d79565b348015610755575f80fd5b50610502600181565b348015610769575f80fd5b50610461610d8c565b34801561077d575f80fd5b50638b78c6d819546040516001600160a01b039091168152602001610484565b3480156107a8575f80fd5b50610477610dc9565b3480156107bc575f80fd5b506104ac6107cb366004611ae4565b610dd8565b3480156107db575f80fd5b506104776107ea366004611b0c565b610ded565b3480156107fa575f80fd5b506003546104ac906301000000900460ff1681565b34801561081a575f80fd5b50610502610829366004611c00565b6001600160a01b039182165f90815268a20d6e21d0e525530c6020908152604080832093909416825291909152205490565b610461610869366004611b5c565b610ee5565b61046161087c366004611b5c565b610f1f565b34801561088c575f80fd5b5061050261089b366004611b5c565b63389a75e1600c9081525f91909152602090205490565b805f5260205ff35b5f6108c482610f45565b6108e15760405163677510db60e11b815260040160405180910390fd5b6108ea82610f61565b92915050565b6108fc84848484610fb4565b50505050565b5f68a20d6e21d0e52553088168a20d6e21d0e52553098161094e68a20d6e21d0e525530e600189901b5b600381901c5f90815260209290925260409091205460059190911b60e0161c90565b63ffffffff16815260208101919091526040015f20546001600160a01b039081169150841681146109c0576001600160a01b038082165f90815260028401602090815260408083209388168352929052205460ff166109c0576040516367d9dca160e11b815260040160405180910390fd5b5f8581526003909201602052604090912080546001600160a01b0387166001600160a01b031990911617905590509392505050565b5f6109ff82610f45565b610a1c5760405163677510db60e11b815260040160405180910390fd5b505f90815268a20d6e21d0e525530b60205260409020546001600160a01b031690565b60605f8054610a4d90611c31565b80601f0160208091040260200160405190810160405280929190818152602001828054610a7990611c31565b8015610ac45780601f10610a9b57610100808354040283529160200191610ac4565b820191905f5260205f20905b815481529060010190602001808311610aa757829003601f168201915b5050505050905090565b5f8068a20d6e21d0e5255308335f81815260048301602090815260408083206001600160a01b038a16808552908352928190208890555187815293945090927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a35060019392505050565b610b4c3382611301565b50565b610b5761130c565b610b618282611326565b5050565b6001600160a01b0383165f90815268a20d6e21d0e525530c6020908152604080832033845290915281205468a20d6e21d0e5255308905f198114610bee5780841115610bc4576040516313be252b60e01b815260040160405180910390fd5b6001600160a01b0386165f9081526004830160209081526040808320338452909152902084820390555b610bf9868686611332565b50600195945050505050565b5f6202a30067ffffffffffffffff164201905063389a75e1600c52335f52806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a250565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081208054600160581b90046001168203610c8d57823b5b9392505050565b54600160581b9004600216151592915050565b610b4c338261133d565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081205460571c60011615156108ea565b610cdf61130c565b610b618282611301565b6001610cf4816113cc565b506003805460ff19166001179055565b63389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2565b6001610d48816113cc565b60035460ff1615610d6c576040516303cb96db60e21b815260040160405180910390fd5b60026108fc838583611cc2565b610d8161130c565b610d8a5f6113fd565b565b6001610d97816113cc565b5f610dac670de0b6b3a7640000612710611d90565b905033610db9828261143a565b610dc4816001611579565b505050565b606060018054610a4d90611c31565b5f610de4338484611332565b50600192915050565b6060610df882610f45565b610e155760405163677510db60e11b815260040160405180910390fd5b60028054610e2290611c31565b159050610ee0576108ea60028054610e3990611c31565b80601f0160208091040260200160405190810160405280929190818152602001828054610e6590611c31565b8015610eb05780601f10610e8757610100808354040283529160200191610eb0565b820191905f5260205f20905b815481529060010190602001808311610e9357829003601f168201915b5050505050604051806040016040528060048152602001637b69647d60e01b815250610edb8561160f565b611651565b919050565b610eed61130c565b63389a75e1600c52805f526020600c208054421115610f1357636f5e88185f526004601cfd5b5f9055610b4c816113fd565b610f2761130c565b8060601b610f3c57637448fbae5f526004601cfd5b610b4c816113fd565b5f80610f5083610f61565b6001600160a01b0316141592915050565b5f68a20d6e21d0e525530868a20d6e21d0e525530982610f8e68a20d6e21d0e525530e600187901b61092c565b63ffffffff16815260208101919091526040015f20546001600160a01b03169392505050565b68a20d6e21d0e52553086001600160a01b038416610fe557604051633a954ecd60e21b815260040160405180910390fd5b5f816001015f610ffc8460060161092c8860011b90565b63ffffffff16815260208101919091526040015f20546001600160a01b0390811691508616811461103f5760405162a1148160e81b815260040160405180910390fd5b856001600160a01b0316836001600160a01b0316146110c1576001600160a01b038087165f90815260028401602090815260408083209387168352929052205460ff166110c1575f8481526003830160205260409020546001600160a01b038481169116146110c157604051632ce44b5f60e11b815260040160405180910390fd5b5f6110cb87611771565b90505f6110d787611771565b8254909150670de0b6b3a7640000908390601490611106908490600160a01b90046001600160601b0316611da7565b82546101009290920a6001600160601b0381810219909316918316021790915582546001600160a01b038116670de0b6b3a7640000600160a01b92839004841601909216021782555061116a60068501600188901b611165848b6117dc565b61187c565b5f86815260038581016020908152604080842080546001600160a01b03191690556001600160a01b038c168085526005808a01808552838720895463ffffffff60801b198116600160801b9182900463ffffffff9081165f1901808216909302919091178c55631fffffff9882901c9890981689528187529488205493909752909352911b60e0161c16906112179061120b6006880160018b811b0161092c565b63ffffffff168361187c565b8154600163ffffffff600160801b80840482169283019091160263ffffffff60801b199092169190911783556112696006870161125784600190811b0190565b61116560068a0160018d811b0161092c565b6001600160a01b0389165f908152600587016020526040902061128d90828a61187c565b6112a06006870160018a811b018361187c565b5050866001600160a01b0316886001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef670de0b6b3a76400006040516112ef91815260200190565b60405180910390a35050505050505050565b610b6182825f6118ae565b638b78c6d819543314610d8a576382b429005f526004601cfd5b610b61828260016118ae565b610dc4838383611905565b5f61134783611771565b8054909150600160581b900460021615158215151461138257805460ff600160581b80830482166002189091160260ff60581b199091161781555b826001600160a01b03167fb5a1de456fff688115a4f75380060c23c8532d14ff85f687cc871456d6420393836040516113bf911515815260200190565b60405180910390a2505050565b638b78c6d819543314610b4c57638b78c6d8600c52335f52806020600c205416610b4c576382b429005f526004601cfd5b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b68a20d6e21d0e52553088054640100000000900463ffffffff161561147257604051633ab534b960e21b815260040160405180910390fd5b805467ffffffff0000000019166401000000001781558215610dc4576001600160a01b0382166114b557604051633a954ecd60e21b815260040160405180910390fd5b6b0de0b6b39983494c589bffff8311156114e25760405163e5cfe95760e01b815260040160405180910390fd5b80546bffffffffffffffffffffffff60601b1916600160601b6001600160601b038516021781555f61151383611771565b80546001600160a01b03908116600160a01b6001600160601b038816021782556040518681529192508416905f907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a36108fc83600161133d565b610b61826115c7836115b4866001600160a01b03165f90815268a20d6e21d0e525530f60205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff1690611a5d565b6001600160a01b03919091165f90815268a20d6e21d0e525530f6020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff909216919091179055565b60606080604051019050602081016040525f8152805f19835b928101926030600a8206018453600a900480611628575050819003601f19909101908152919050565b60608351835183516020870196506020860195506020850194506020604051019350828701838311611721576001838203015f6020851061169157508388205b601f851660200360031b89515b8b51818118831c6117085783156116d85783888e20146116d857808a5260019c8d019c90990198848d106116d2575061171c565b5061169e565b5f5b8b8101518b8201526020018781106116da57509b87019b98860198871561170857848d106116d2575061171c565b895260019b8c019b90980197838c1061169e575b505050505b84935060206040510194508781038585030192505b80881015611751578751845260209788019790930192611736565b50505f818401908152602001604052601f19909201918252509392505050565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081208054909168a20d6e21d0e525530891600160581b900460011690036117d6576001833b156117bc576002175b825460ff909116600160581b0260ff60581b199091161782555b50919050565b8154600160601b900463ffffffff1668a20d6e21d0e52553085f82900361187557805481905f906118129063ffffffff16611dc7565b825463ffffffff8083166101009490940a848102910219909116179092558554600160601b820263ffffffff60601b199091161786555f908152600183016020526040902080546001600160a01b0386166001600160a01b031990911617905591505b5092915050565b826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b638b78c6d8600c52825f526020600c208054838117836118cf575080841681185b80835580600c5160601c7f715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe265f80a3505050505050565b6001600160a01b03821661192c57604051633a954ecd60e21b815260040160405180910390fd5b5f61193684611771565b90505f61194284611771565b90506119776040518060c001604052805f81526020015f81526020015f81526020015f81526020015f81526020015f81525090565b825463ffffffff600160801b808304821660808501528454041660a08301526001600160601b03600160a01b90910416604082018190528411156119ce57604051631e9acf1760e31b815260040160405180910390fd5b604081810180518690039081905284546001600160601b03918216600160a01b9081026001600160a01b0392831617875585548181048416890160608701819052909316029181169190911784559051858152868216918816907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3505050505050565b5f6001605784901c16151582151514611a7b57600160571b92909218915b5090919050565b5f602080835283518060208501525f5b81811015611aae57858101830151858201604001528201611a92565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b0381168114610ee0575f80fd5b5f8060408385031215611af5575f80fd5b611afe83611ace565b946020939093013593505050565b5f60208284031215611b1c575f80fd5b5035919050565b5f805f60608486031215611b35575f80fd5b611b3e84611ace565b9250611b4c60208501611ace565b9150604084013590509250925092565b5f60208284031215611b6c575f80fd5b610c8682611ace565b5f60208284031215611b85575f80fd5b81358015158114610c86575f80fd5b5f8060208385031215611ba5575f80fd5b823567ffffffffffffffff80821115611bbc575f80fd5b818501915085601f830112611bcf575f80fd5b813581811115611bdd575f80fd5b866020828501011115611bee575f80fd5b60209290920196919550909350505050565b5f8060408385031215611c11575f80fd5b611c1a83611ace565b9150611c2860208401611ace565b90509250929050565b600181811c90821680611c4557607f821691505b6020821081036117d657634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52604160045260245ffd5b601f821115610dc457805f5260205f20601f840160051c81016020851015611c9c5750805b601f840160051c820191505b81811015611cbb575f8155600101611ca8565b5050505050565b67ffffffffffffffff831115611cda57611cda611c63565b611cee83611ce88354611c31565b83611c77565b5f601f841160018114611d1f575f8515611d085750838201355b5f19600387901b1c1916600186901b178355611cbb565b5f83815260208120601f198716915b82811015611d4e5786850135825560209485019460019092019101611d2e565b5086821015611d6a575f1960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b5f52601160045260245ffd5b80820281158282048414176108ea576108ea611d7c565b6001600160601b0382811682821603908082111561187557611875611d7c565b5f63ffffffff808316818103611ddf57611ddf611d7c565b600101939250505056fea26469706673582212200307a04139256232fbc3ca8f11bbcfd5363d413ca9bb648fc3c18dac6624a7fc64736f6c63430008180033
Deployed Bytecode
0x6080604052600436106101fc575f3560e01c806353df5c7c1161010c5780638da5cb5b1161009f578063d73c1fb31161006e578063d73c1fb3146107ef578063dd62ed3e1461080f578063f04e283e1461085b578063f2fde38b1461086e578063fee81cf41461088157610203565b80638da5cb5b1461077257806395d89b411461079d578063a9059cbb146107b1578063c87b56dd146107d057610203565b806370a08231116100db57806370a08231146106f6578063715018a61461074257806375b238fc1461074a5780638129fc1c1461075e57610203565b806353df5c7c146106a257806354d1f13d146106b657806355f804b3146106be5780635d148e5c146106dd57610203565b8063256929621161018f578063313ce5671161015e578063313ce567146106015780633af32abf1461061c57806347f618a51461063b5780634a4ee7b11461065a578063514e62fc1461066d57610203565b8063256929621461058a578063274e430b146105925780632a6a935d146105b15780632de94807146105d057610203565b8063183a4f6e116101cb578063183a4f6e146105105780631c10893f146105235780631cd64df41461053657806323b872dd1461056b57610203565b806306fdde0314610463578063095ea7b31461048d578063180434a3146104bc57806318160ddd146104da57610203565b3661020357005b68a20d6e21d0e52553085f3560e01c63e985e9c581900361027857604436101561022b575f80fd5b6004356001600160a01b038181165f908152600285016020908152604080832060243594851684529091529020546102759060ff1661026a575f61026d565b60015b60ff166108b2565b50505b80636352211e036102af576024361015610290575f80fd5b6004356102ad61029f826108ba565b6001600160a01b03166108b2565b505b8063e5eb36c8036102ee5760843610156102c7575f80fd5b6004356024356044356064356102df848484846108f0565b6102e960016108b2565b505050505b8063813500fc03610359576064361015610306575f80fd5b6001600160a01b036044358181165f90815268a20d6e21d0e525530a6020908152604080832060043595861684529091529020805460ff191660243515159081179091559061035560016108b2565b5050505b8063d10b6e0c0361038c576064361015610371575f80fd5b60043560243560443561038861029f848484610902565b5050505b8063081812fc036103b55760243610156103a4575f80fd5b6004356103b361029f826109f5565b505b8063f5b100ea0361040e5760243610156103cd575f80fd5b60043561040c610407826001600160a01b03165f90815268a20d6e21d0e525530f602052604090205463ffffffff600160801b9091041690565b6108b2565b505b8063e2c792810361044c576004361015610426575f80fd5b68a20d6e21d0e52553085461044c9068010000000000000000900463ffffffff166108b2565b8063b7a94eb8036104615761046160016108b2565b005b34801561046e575f80fd5b50610477610a3f565b6040516104849190611a82565b60405180910390f35b348015610498575f80fd5b506104ac6104a7366004611ae4565b610ace565b6040519015158152602001610484565b3480156104c7575f80fd5b506003546104ac90610100900460ff1681565b3480156104e5575f80fd5b5068a20d6e21d0e525530854600160601b90046001600160601b03165b604051908152602001610484565b61046161051e366004611b0c565b610b42565b610461610531366004611ae4565b610b4f565b348015610541575f80fd5b506104ac610550366004611ae4565b638b78c6d8600c9081525f9290925260209091205481161490565b348015610576575f80fd5b506104ac610585366004611b23565b610b65565b610461610c05565b34801561059d575f80fd5b506104ac6105ac366004611b5c565b610c52565b3480156105bc575f80fd5b506104616105cb366004611b75565b610ca0565b3480156105db575f80fd5b506105026105ea366004611b5c565b638b78c6d8600c9081525f91909152602090205490565b34801561060c575f80fd5b5060405160128152602001610484565b348015610627575f80fd5b506104ac610636366004611b5c565b610caa565b348015610646575f80fd5b506003546104ac9062010000900460ff1681565b610461610668366004611ae4565b610cd7565b348015610678575f80fd5b506104ac610687366004611ae4565b638b78c6d8600c9081525f9290925260209091205416151590565b3480156106ad575f80fd5b50610461610ce9565b610461610d04565b3480156106c9575f80fd5b506104616106d8366004611b94565b610d3d565b3480156106e8575f80fd5b506003546104ac9060ff1681565b348015610701575f80fd5b50610502610710366004611b5c565b6001600160a01b03165f90815268a20d6e21d0e525530f6020526040902054600160a01b90046001600160601b031690565b610461610d79565b348015610755575f80fd5b50610502600181565b348015610769575f80fd5b50610461610d8c565b34801561077d575f80fd5b50638b78c6d819546040516001600160a01b039091168152602001610484565b3480156107a8575f80fd5b50610477610dc9565b3480156107bc575f80fd5b506104ac6107cb366004611ae4565b610dd8565b3480156107db575f80fd5b506104776107ea366004611b0c565b610ded565b3480156107fa575f80fd5b506003546104ac906301000000900460ff1681565b34801561081a575f80fd5b50610502610829366004611c00565b6001600160a01b039182165f90815268a20d6e21d0e525530c6020908152604080832093909416825291909152205490565b610461610869366004611b5c565b610ee5565b61046161087c366004611b5c565b610f1f565b34801561088c575f80fd5b5061050261089b366004611b5c565b63389a75e1600c9081525f91909152602090205490565b805f5260205ff35b5f6108c482610f45565b6108e15760405163677510db60e11b815260040160405180910390fd5b6108ea82610f61565b92915050565b6108fc84848484610fb4565b50505050565b5f68a20d6e21d0e52553088168a20d6e21d0e52553098161094e68a20d6e21d0e525530e600189901b5b600381901c5f90815260209290925260409091205460059190911b60e0161c90565b63ffffffff16815260208101919091526040015f20546001600160a01b039081169150841681146109c0576001600160a01b038082165f90815260028401602090815260408083209388168352929052205460ff166109c0576040516367d9dca160e11b815260040160405180910390fd5b5f8581526003909201602052604090912080546001600160a01b0387166001600160a01b031990911617905590509392505050565b5f6109ff82610f45565b610a1c5760405163677510db60e11b815260040160405180910390fd5b505f90815268a20d6e21d0e525530b60205260409020546001600160a01b031690565b60605f8054610a4d90611c31565b80601f0160208091040260200160405190810160405280929190818152602001828054610a7990611c31565b8015610ac45780601f10610a9b57610100808354040283529160200191610ac4565b820191905f5260205f20905b815481529060010190602001808311610aa757829003601f168201915b5050505050905090565b5f8068a20d6e21d0e5255308335f81815260048301602090815260408083206001600160a01b038a16808552908352928190208890555187815293945090927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925910160405180910390a35060019392505050565b610b4c3382611301565b50565b610b5761130c565b610b618282611326565b5050565b6001600160a01b0383165f90815268a20d6e21d0e525530c6020908152604080832033845290915281205468a20d6e21d0e5255308905f198114610bee5780841115610bc4576040516313be252b60e01b815260040160405180910390fd5b6001600160a01b0386165f9081526004830160209081526040808320338452909152902084820390555b610bf9868686611332565b50600195945050505050565b5f6202a30067ffffffffffffffff164201905063389a75e1600c52335f52806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d5f80a250565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081208054600160581b90046001168203610c8d57823b5b9392505050565b54600160581b9004600216151592915050565b610b4c338261133d565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081205460571c60011615156108ea565b610cdf61130c565b610b618282611301565b6001610cf4816113cc565b506003805460ff19166001179055565b63389a75e1600c52335f525f6020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c925f80a2565b6001610d48816113cc565b60035460ff1615610d6c576040516303cb96db60e21b815260040160405180910390fd5b60026108fc838583611cc2565b610d8161130c565b610d8a5f6113fd565b565b6001610d97816113cc565b5f610dac670de0b6b3a7640000612710611d90565b905033610db9828261143a565b610dc4816001611579565b505050565b606060018054610a4d90611c31565b5f610de4338484611332565b50600192915050565b6060610df882610f45565b610e155760405163677510db60e11b815260040160405180910390fd5b60028054610e2290611c31565b159050610ee0576108ea60028054610e3990611c31565b80601f0160208091040260200160405190810160405280929190818152602001828054610e6590611c31565b8015610eb05780601f10610e8757610100808354040283529160200191610eb0565b820191905f5260205f20905b815481529060010190602001808311610e9357829003601f168201915b5050505050604051806040016040528060048152602001637b69647d60e01b815250610edb8561160f565b611651565b919050565b610eed61130c565b63389a75e1600c52805f526020600c208054421115610f1357636f5e88185f526004601cfd5b5f9055610b4c816113fd565b610f2761130c565b8060601b610f3c57637448fbae5f526004601cfd5b610b4c816113fd565b5f80610f5083610f61565b6001600160a01b0316141592915050565b5f68a20d6e21d0e525530868a20d6e21d0e525530982610f8e68a20d6e21d0e525530e600187901b61092c565b63ffffffff16815260208101919091526040015f20546001600160a01b03169392505050565b68a20d6e21d0e52553086001600160a01b038416610fe557604051633a954ecd60e21b815260040160405180910390fd5b5f816001015f610ffc8460060161092c8860011b90565b63ffffffff16815260208101919091526040015f20546001600160a01b0390811691508616811461103f5760405162a1148160e81b815260040160405180910390fd5b856001600160a01b0316836001600160a01b0316146110c1576001600160a01b038087165f90815260028401602090815260408083209387168352929052205460ff166110c1575f8481526003830160205260409020546001600160a01b038481169116146110c157604051632ce44b5f60e11b815260040160405180910390fd5b5f6110cb87611771565b90505f6110d787611771565b8254909150670de0b6b3a7640000908390601490611106908490600160a01b90046001600160601b0316611da7565b82546101009290920a6001600160601b0381810219909316918316021790915582546001600160a01b038116670de0b6b3a7640000600160a01b92839004841601909216021782555061116a60068501600188901b611165848b6117dc565b61187c565b5f86815260038581016020908152604080842080546001600160a01b03191690556001600160a01b038c168085526005808a01808552838720895463ffffffff60801b198116600160801b9182900463ffffffff9081165f1901808216909302919091178c55631fffffff9882901c9890981689528187529488205493909752909352911b60e0161c16906112179061120b6006880160018b811b0161092c565b63ffffffff168361187c565b8154600163ffffffff600160801b80840482169283019091160263ffffffff60801b199092169190911783556112696006870161125784600190811b0190565b61116560068a0160018d811b0161092c565b6001600160a01b0389165f908152600587016020526040902061128d90828a61187c565b6112a06006870160018a811b018361187c565b5050866001600160a01b0316886001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef670de0b6b3a76400006040516112ef91815260200190565b60405180910390a35050505050505050565b610b6182825f6118ae565b638b78c6d819543314610d8a576382b429005f526004601cfd5b610b61828260016118ae565b610dc4838383611905565b5f61134783611771565b8054909150600160581b900460021615158215151461138257805460ff600160581b80830482166002189091160260ff60581b199091161781555b826001600160a01b03167fb5a1de456fff688115a4f75380060c23c8532d14ff85f687cc871456d6420393836040516113bf911515815260200190565b60405180910390a2505050565b638b78c6d819543314610b4c57638b78c6d8600c52335f52806020600c205416610b4c576382b429005f526004601cfd5b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e05f80a355565b68a20d6e21d0e52553088054640100000000900463ffffffff161561147257604051633ab534b960e21b815260040160405180910390fd5b805467ffffffff0000000019166401000000001781558215610dc4576001600160a01b0382166114b557604051633a954ecd60e21b815260040160405180910390fd5b6b0de0b6b39983494c589bffff8311156114e25760405163e5cfe95760e01b815260040160405180910390fd5b80546bffffffffffffffffffffffff60601b1916600160601b6001600160601b038516021781555f61151383611771565b80546001600160a01b03908116600160a01b6001600160601b038816021782556040518681529192508416905f907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a36108fc83600161133d565b610b61826115c7836115b4866001600160a01b03165f90815268a20d6e21d0e525530f60205260409020546affffffffffffffffffffff1690565b6affffffffffffffffffffff1690611a5d565b6001600160a01b03919091165f90815268a20d6e21d0e525530f6020526040902080546affffffffffffffffffffff19166affffffffffffffffffffff909216919091179055565b60606080604051019050602081016040525f8152805f19835b928101926030600a8206018453600a900480611628575050819003601f19909101908152919050565b60608351835183516020870196506020860195506020850194506020604051019350828701838311611721576001838203015f6020851061169157508388205b601f851660200360031b89515b8b51818118831c6117085783156116d85783888e20146116d857808a5260019c8d019c90990198848d106116d2575061171c565b5061169e565b5f5b8b8101518b8201526020018781106116da57509b87019b98860198871561170857848d106116d2575061171c565b895260019b8c019b90980197838c1061169e575b505050505b84935060206040510194508781038585030192505b80881015611751578751845260209788019790930192611736565b50505f818401908152602001604052601f19909201918252509392505050565b6001600160a01b0381165f90815268a20d6e21d0e525530f602052604081208054909168a20d6e21d0e525530891600160581b900460011690036117d6576001833b156117bc576002175b825460ff909116600160581b0260ff60581b199091161782555b50919050565b8154600160601b900463ffffffff1668a20d6e21d0e52553085f82900361187557805481905f906118129063ffffffff16611dc7565b825463ffffffff8083166101009490940a848102910219909116179092558554600160601b820263ffffffff60601b199091161786555f908152600183016020526040902080546001600160a01b0386166001600160a01b031990911617905591505b5092915050565b826020528160031c5f5260405f206007831660051b815463ffffffff8482841c188116831b8218845550505050505050565b638b78c6d8600c52825f526020600c208054838117836118cf575080841681185b80835580600c5160601c7f715ad5ce61fc9595c7b415289d59cf203f23a94fa06f04af7e489a0a76e1fe265f80a3505050505050565b6001600160a01b03821661192c57604051633a954ecd60e21b815260040160405180910390fd5b5f61193684611771565b90505f61194284611771565b90506119776040518060c001604052805f81526020015f81526020015f81526020015f81526020015f81526020015f81525090565b825463ffffffff600160801b808304821660808501528454041660a08301526001600160601b03600160a01b90910416604082018190528411156119ce57604051631e9acf1760e31b815260040160405180910390fd5b604081810180518690039081905284546001600160601b03918216600160a01b9081026001600160a01b0392831617875585548181048416890160608701819052909316029181169190911784559051858152868216918816907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9060200160405180910390a3505050505050565b5f6001605784901c16151582151514611a7b57600160571b92909218915b5090919050565b5f602080835283518060208501525f5b81811015611aae57858101830151858201604001528201611a92565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b0381168114610ee0575f80fd5b5f8060408385031215611af5575f80fd5b611afe83611ace565b946020939093013593505050565b5f60208284031215611b1c575f80fd5b5035919050565b5f805f60608486031215611b35575f80fd5b611b3e84611ace565b9250611b4c60208501611ace565b9150604084013590509250925092565b5f60208284031215611b6c575f80fd5b610c8682611ace565b5f60208284031215611b85575f80fd5b81358015158114610c86575f80fd5b5f8060208385031215611ba5575f80fd5b823567ffffffffffffffff80821115611bbc575f80fd5b818501915085601f830112611bcf575f80fd5b813581811115611bdd575f80fd5b866020828501011115611bee575f80fd5b60209290920196919550909350505050565b5f8060408385031215611c11575f80fd5b611c1a83611ace565b9150611c2860208401611ace565b90509250929050565b600181811c90821680611c4557607f821691505b6020821081036117d657634e487b7160e01b5f52602260045260245ffd5b634e487b7160e01b5f52604160045260245ffd5b601f821115610dc457805f5260205f20601f840160051c81016020851015611c9c5750805b601f840160051c820191505b81811015611cbb575f8155600101611ca8565b5050505050565b67ffffffffffffffff831115611cda57611cda611c63565b611cee83611ce88354611c31565b83611c77565b5f601f841160018114611d1f575f8515611d085750838201355b5f19600387901b1c1916600186901b178355611cbb565b5f83815260208120601f198716915b82811015611d4e5786850135825560209485019460019092019101611d2e565b5086821015611d6a575f1960f88860031b161c19848701351681555b505060018560011b0183555050505050565b634e487b7160e01b5f52601160045260245ffd5b80820281158282048414176108ea576108ea611d7c565b6001600160601b0382811682821603908082111561187557611875611d7c565b5f63ffffffff808316818103611ddf57611ddf611d7c565b600101939250505056fea26469706673582212200307a04139256232fbc3ca8f11bbcfd5363d413ca9bb648fc3c18dac6624a7fc64736f6c63430008180033
Deployed Bytecode Sourcemap
129084:3493:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;100238:20;118673:22;124741:20;118773:3;118750:26;118856:10;118842:24;;;118838:304;;118905:4;118887:8;:22;118883:36;;;118911:8;;;118883:36;118982:4;124741:20;-1:-1:-1;;;;;119085:26:0;;;118936:13;119085:26;;;:19;;;:26;;;;;;;;119053:4;124741:20;119085:36;;;;;;;;;;;119077:53;;119085:36;;:44;;119128:1;119085:44;;;119124:1;119085:44;119077:53;;:7;:53::i;:::-;118868:274;;118838:304;119188:10;119202;119188:24;119184:189;;119251:4;119233:8;:22;119229:36;;;119257:8;;;119229:36;119309:4;124741:20;119331:30;119347:12;124741:20;119347:8;:12::i;:::-;-1:-1:-1;;;;;119331:30:0;:7;:30::i;:::-;119214:159;119184:189;119451:10;119465;119451:24;119447:429;;119514:4;119496:8;:22;119492:36;;;119520:8;;;119492:36;119590:4;124741:20;119655:4;124741:20;119704:4;124741:20;119774:4;124741:20;119798:41;124741:20;;;;119798:16;:41::i;:::-;119854:10;119862:1;119854:7;:10::i;:::-;119477:399;;;;119447:429;119945:10;119959;119945:24;119941:378;;120008:4;119990:8;:22;119986:36;;;120014:8;;;119986:36;-1:-1:-1;;;;;120212:4:0;124741:20;117793:47;;;;;;;:36;:47;;;;;;;;120087:4;124741:20;117793:57;;;;;;;;;;:68;;-1:-1:-1;;117793:68:0;120137:4;124741:20;120123:24;;117793:68;;;;;;120123:24;120297:10;120305:1;120297:7;:10::i;:::-;119971:348;;;119941:378;120384:10;120398;120384:24;120380:354;;120447:4;120429:8;:22;120425:36;;;120453:8;;;120425:36;120526:4;124741:20;120575:4;124741:20;120645:4;124741:20;120669:53;120685:35;124741:20;;;120685:11;:35::i;120669:53::-;120410:324;;;120380:354;120784:10;120798;120784:24;120780:193;;120847:4;120829:8;:22;120825:36;;;120853:8;;;120825:36;120905:4;124741:20;120927:34;120943:16;124741:20;120943:12;:16::i;120927:34::-;120810:163;120780:193;121024:10;121038;121024:24;121020:209;;121087:4;121069:8;:22;121065:36;;;121093:8;;;121065:36;121164:4;124741:20;121188:29;121196:20;124741;-1:-1:-1;;;;;115609:37:0;115582:7;115609:37;;;:30;:37;;;;;:49;;-1:-1:-1;;;115609:49:0;;;;;115513:153;121196:20;121188:7;:29::i;:::-;121050:179;121020:209;121275:10;121289;121275:24;121271:136;;121338:4;121320:8;:22;121316:36;;;121344:8;;;121316:36;100238:20;115421:33;121369:26;;115421:33;;;;;121188:7;:29::i;121369:26::-;121454:10;121468;121454:24;121450:67;;121495:10;121503:1;121495:7;:10::i;:::-;118662:2874;130628:92;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;103475:275;;;;;;;;;;-1:-1:-1;103475:275:0;;;;;:::i;:::-;;:::i;:::-;;;1169:14:1;;1162:22;1144:41;;1132:2;1117:18;103475:275:0;1004:187:1;130234:31:0;;;;;;;;;;-1:-1:-1;130234:31:0;;;;;;;;;;;102752:126;;;;;;;;;;-1:-1:-1;100238:20:0;102839:30;-1:-1:-1;;;102839:30:0;;-1:-1:-1;;;;;102839:30:0;102752:126;;;1342:25:1;;;1330:2;1315:18;102752:126:0;1196:177:1;24857:111:0;;;;;;:::i;:::-;;:::i;24306:125::-;;;;;;:::i;:::-;;:::i;25934:141::-;;;;;;;;;;-1:-1:-1;25934:141:0;;;;;:::i;:::-;25512:15;25506:4;25499:29;;;26013:4;25542:18;;;;25644:4;25628:21;;;25622:28;26037:21;;:30;;25934:141;105110:512;;;;;;;;;;-1:-1:-1;105110:512:0;;;;;:::i;:::-;;:::i;10998:630::-;;;:::i;113069:282::-;;;;;;;;;;-1:-1:-1;113069:282:0;;;;;:::i;:::-;;:::i;113463:100::-;;;;;;;;;;-1:-1:-1;113463:100:0;;;;;:::i;:::-;;:::i;25306:362::-;;;;;;;;;;-1:-1:-1;25306:362:0;;;;;:::i;:::-;25512:15;25506:4;25499:29;;;25366:13;25542:18;;;;25644:4;25628:21;;25622:28;;25306:362;102611:76;;;;;;;;;;-1:-1:-1;102611:76:0;;102677:2;2507:36:1;;2495:2;2480:18;102611:76:0;2365:184:1;131877:123:0;;;;;;;;;;-1:-1:-1;131877:123:0;;;;;:::i;:::-;;:::i;130274:31::-;;;;;;;;;;-1:-1:-1;130274:31:0;;;;;;;;;;;24580:127;;;;;;:::i;:::-;;:::i;25733:136::-;;;;;;;;;;-1:-1:-1;25733:136:0;;;;;:::i;:::-;25512:15;25506:4;25499:29;;;25811:4;25542:18;;;;25644:4;25628:21;;;25622:28;25835:21;:26;;;25733:136;132303:98;;;;;;;;;;;;;:::i;11713:466::-;;;:::i;132409:165::-;;;;;;;;;;-1:-1:-1;132409:165:0;;;;;:::i;:::-;;:::i;130200:25::-;;;;;;;;;;-1:-1:-1;130200:25:0;;;;;;;;102947:143;;;;;;;;;;-1:-1:-1;102947:143:0;;;;;:::i;:::-;-1:-1:-1;;;;;103037:37:0;103010:7;103037:37;;;:30;:37;;;;;:45;-1:-1:-1;;;103037:45:0;;-1:-1:-1;;;;;103037:45:0;;102947:143;10733:102;;;:::i;129446:44::-;;;;;;;;;;;;27425:6;129446:44;;132008:287;;;;;;;;;;;;;:::i;13438:187::-;;;;;;;;;;-1:-1:-1;;;13589:18:0;13438:187;;-1:-1:-1;;;;;3315:32:1;;;3297:51;;3285:2;3270:18;13438:187:0;3151:203:1;130728:96:0;;;;;;;;;;;;;:::i;104263:150::-;;;;;;;;;;-1:-1:-1;104263:150:0;;;;;:::i;:::-;;:::i;130832:283::-;;;;;;;;;;-1:-1:-1;130832:283:0;;;;;:::i;:::-;;:::i;130314:27::-;;;;;;;;;;-1:-1:-1;130314:27:0;;;;;;;;;;;103188:151;;;;;;;;;;-1:-1:-1;103188:151:0;;;;;:::i;:::-;-1:-1:-1;;;;;103287:35:0;;;103260:7;103287:35;;;:28;:35;;;;;;;;:44;;;;;;;;;;;;;103188:151;12370:724;;;;;;:::i;:::-;;:::i;10307:358::-;;;;;;:::i;:::-;;:::i;13731:449::-;;;;;;;;;;-1:-1:-1;13731:449:0;;;;;:::i;:::-;14010:19;14004:4;13997:33;;;13854:14;14044:26;;;;14156:4;14140:21;;14134:28;;13731:449;124872:185;125005:1;124999:4;124992:15;125034:4;125028;125021:18;116125:163;116186:7;116211:11;116219:2;116211:7;:11::i;:::-;116206:44;;116231:19;;-1:-1:-1;;;116231:19:0;;;;;;;;;;;116206:44;116268:12;116277:2;116268:8;:12::i;:::-;116261:19;116125:163;-1:-1:-1;;116125:163:0:o;131534:190::-;131669:47;131692:4;131698:2;131702;131706:9;131669:22;:47::i;:::-;131534:190;;;;:::o;117009:527::-;117131:7;100238:20;117131:7;117228:16;117131:7;117245:31;117250:4;117228:16;125433:6;;;117256:19;125831:1;125822:10;;;125772:13;125814:19;;;;;;;;;;;;;125853:1;125838:16;;;;;;125814:41;;125698:166;117245:31;117228:49;;;;;;;;;;;;;-1:-1:-1;117228:49:0;;-1:-1:-1;;;;;117228:49:0;;;;-1:-1:-1;117294:18:0;;;;117290:171;;-1:-1:-1;;;;;117334:26:0;;;;;;;:19;;;:26;;;;;;;;:37;;;;;;;;;;;;117329:121;;117399:35;;-1:-1:-1;;;117399:35:0;;;;;;;;;;;117329:121;117473:20;;;;:16;;;;:20;;;;;;:30;;-1:-1:-1;;;;;117473:30:0;;-1:-1:-1;;;;;;117473:30:0;;;;;;117523:5;-1:-1:-1;117009:527:0;;;;;:::o;116597:192::-;116662:7;116687:11;116695:2;116687:7;:11::i;:::-;116682:44;;116707:19;;-1:-1:-1;;;116707:19:0;;;;;;;;;;;116682:44;-1:-1:-1;116744:37:0;;;;:33;:37;;;;;;-1:-1:-1;;;;;116744:37:0;;116597:192::o;130628:92::-;130674:13;130707:5;130700:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;130628:92;:::o;103475:275::-;103549:4;;100238:20;103634:10;103622:23;;;;:11;;;:23;;;;;;;;-1:-1:-1;;;;;103622:32:0;;;;;;;;;;;;:41;;;103681:37;1342:25:1;;;103622:11:0;;-1:-1:-1;103622:32:0;;103681:37;;1315:18:1;103681:37:0;;;;;;;-1:-1:-1;103738:4:0;;103475:275;-1:-1:-1;;;103475:275:0:o;24857:111::-;24929:31;24942:10;24954:5;24929:12;:31::i;:::-;24857:111;:::o;24306:125::-;14577:13;:11;:13::i;:::-;24399:24:::1;24411:4;24417:5;24399:11;:24::i;:::-;24306:125:::0;;:::o;105110:512::-;-1:-1:-1;;;;;105289:17:0;;105198:4;105289:17;;;:11;:17;;;;;;;;105307:10;105289:29;;;;;;;;100238:20;;-1:-1:-1;;105335:28:0;;105331:220;;105393:7;105384:6;:16;105380:52;;;105409:23;;-1:-1:-1;;;105409:23:0;;;;;;;;;;;105380:52;-1:-1:-1;;;;;105476:17:0;;;;;;:11;;;:17;;;;;;;;105494:10;105476:29;;;;;;;105508:16;;;105476:48;;105331:220;105563:27;105573:4;105579:2;105583:6;105563:9;:27::i;:::-;-1:-1:-1;105610:4:0;;105110:512;-1:-1:-1;;;;;105110:512:0:o;10998:630::-;11093:15;9923:9;11111:46;;:15;:46;11093:64;;11329:19;11323:4;11316:33;11380:8;11374:4;11367:22;11437:7;11430:4;11424;11414:21;11407:38;11586:8;11539:45;11536:1;11533;11528:67;11229:381;10998:630::o;113069:282::-;-1:-1:-1;;;;;113170:33:0;;113129:4;113170:33;;;:30;:33;;;;;113218:7;;-1:-1:-1;;;113218:7:0;;97758:6;113218:40;:45;;113214:69;;124451:14;;113272:11;113265:18;113069:282;-1:-1:-1;;;113069:282:0:o;113214:69::-;113301:7;-1:-1:-1;;;113301:7:0;;97895:6;113301:37;:42;;;113069:282;-1:-1:-1;;113069:282:0:o;113463:100::-;113523:32;113535:10;113547:7;113523:11;:32::i;131877:123::-;-1:-1:-1;;;;;112176:37:0;;131937:4;112176:37;;;:30;:37;;;;;:41;127656:2;128796:28;;;:33;;131961:31;128711:126;24580:127;14577:13;:11;:13::i;:::-;24674:25:::1;24687:4;24693:5;24674:12;:25::i;132303:98::-:0;27425:6;26764:25;26783:5;26764:18;:25::i;:::-;-1:-1:-1;132373:13:0::1;:20:::0;;-1:-1:-1;;132373:20:0::1;132389:4;132373:20;::::0;;132303:98::o;11713:466::-;11919:19;11913:4;11906:33;11966:8;11960:4;11953:22;12019:1;12012:4;12006;11996:21;11989:32;12152:8;12106:44;12103:1;12100;12095:66;11713:466::o;132409:165::-;27425:6;26764:25;26783:5;26764:18;:25::i;:::-;132506:13:::1;::::0;::::1;;132502:34;;;132528:8;;-1:-1:-1::0;;;132528:8:0::1;;;;;;;;;;;132502:34;132547:8;:19;132558:8:::0;;132547;:19:::1;:::i;10733:102::-:0;14577:13;:11;:13::i;:::-;10806:21:::1;10824:1;10806:9;:21::i;:::-;10733:102::o:0;132008:287::-;27425:6;26764:25;26783:5;26764:18;:25::i;:::-;132077:26:::1;132106:12;97374:8;132106:5;:12;:::i;:::-;132077:41:::0;-1:-1:-1;132158:10:0::1;132179:56;132077:41:::0;132158:10;132179:16:::1;:56::i;:::-;132246:41;132262:18;132282:4;132246:15;:41::i;:::-;132066:229;;132008:287:::0;:::o;130728:96::-;130776:13;130809:7;130802:14;;;;;:::i;104263:150::-;104333:4;104350:33;104360:10;104372:2;104376:6;104350:9;:33::i;:::-;-1:-1:-1;104401:4:0;104263:150;;;;:::o;130832:283::-;130892:20;130930:11;130938:2;130930:7;:11::i;:::-;130925:44;;130950:19;;-1:-1:-1;;;130950:19:0;;;;;;;;;;;130925:44;130990:8;130984:22;;;;;:::i;:::-;:27;;-1:-1:-1;130980:128:0;;131037:59;131055:8;131037:59;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;-1:-1:-1;;;131037:59:0;;;131073:22;131092:2;131073:18;:22::i;:::-;131037:17;:59::i;130980:128::-;130832:283;;;:::o;12370:724::-;14577:13;:11;:13::i;:::-;12608:19:::1;12602:4;12595:33;12655:12;12649:4;12642:26;12718:4;12712;12702:21;12826:12;12820:19;12807:11;12804:36;12801:160;;;12873:10;12867:4;12860:24;12941:4;12935;12928:18;12801:160;13040:1;13019:23:::0;;13063::::1;13073:12:::0;13063:9:::1;:23::i;10307:358::-:0;14577:13;:11;:13::i;:::-;10482:8:::1;10478:2;10474:17;10464:153;;10525:10;10519:4;10512:24;10597:4;10591;10584:18;10464:153;10638:19;10648:8;10638:9;:19::i;116340:118::-:0;116400:4;;116424:12;116433:2;116424:8;:12::i;:::-;-1:-1:-1;;;;;116424:26:0;;;;116340:118;-1:-1:-1;;116340:118:0:o;115805:199::-;115866:7;100238:20;115947:16;115866:7;115964:31;115969:4;115947:16;125433:6;;;115975:19;125348:99;115964:31;115947:49;;;;;;;;;;;;;-1:-1:-1;115947:49:0;;-1:-1:-1;;;;;115947:49:0;;115805:199;-1:-1:-1;;;115805:199:0:o;110059:1507::-;100238:20;-1:-1:-1;;;;;110253:16:0;;110249:52;;110278:23;;-1:-1:-1;;;110278:23:0;;;;;;;;;;;110249:52;110314:13;110330:1;:16;;:49;110347:31;110352:1;:4;;110358:19;110374:2;125438:1;125433:6;;125348:99;110347:31;110330:49;;;;;;;;;;;;;-1:-1:-1;110330:49:0;;-1:-1:-1;;;;;110330:49:0;;;;-1:-1:-1;110396:13:0;;;;110392:54;;110418:28;;-1:-1:-1;;;110418:28:0;;;;;;;;;;;110392:54;110476:4;-1:-1:-1;;;;;110463:17:0;:9;-1:-1:-1;;;;;110463:17:0;;110459:250;;-1:-1:-1;;;;;110502:25:0;;;;;;;:19;;;:25;;;;;;;;:36;;;;;;;;;;;;110497:201;;110576:20;;;;:16;;;:20;;;;;;-1:-1:-1;;;;;110563:33:0;;;110576:20;;110563:33;110559:124;;110628:35;;-1:-1:-1;;;110628:35:0;;;;;;;;;;;110559:124;110721:35;110759:18;110772:4;110759:12;:18::i;:::-;110721:56;;110788:33;110824:16;110837:2;110824:12;:16::i;:::-;110853:39;;110788:52;;-1:-1:-1;97374:8:0;;110853:39;;:23;;:39;;97374:8;;-1:-1:-1;;;110853:39:0;;-1:-1:-1;;;;;110853:39:0;;:::i;:::-;;;;;;;;-1:-1:-1;;;;;110853:39:0;;;;;;;;;;;;;;;110930:37;;-1:-1:-1;;;;;110930:37:0;;97374:8;-1:-1:-1;;;110930:37:0;;;;;;;;;;;;;;-1:-1:-1;110984:76:0;110989:4;;;-1:-1:-1;125433:6:0;;;111016:43;111041:13;111056:2;111016:24;:43::i;:::-;110984:4;:76::i;:::-;111082:20;;;;:16;;;;:20;;;;;;;;111075:27;;-1:-1:-1;;;;;;111075:27:0;;;-1:-1:-1;;;;;111144:13:0;;;;;:7;;;;:13;;;;;;111159:29;;-1:-1:-1;;;;111159:29:0;;-1:-1:-1;;;111159:29:0;;;;;;;;-1:-1:-1;;111159:29:0;;;;;;;;;;;;;125822:10;;;;;;;;;125814:19;;;;;;;;;111209:13;;;;;;;125838:16;;;;125814:41;111119:70;;111204:67;;111224:27;111229:4;;;-1:-1:-1;125600:6:0;;;125599:12;111235:15;125493:137;111224:27;111204:67;;111260:9;111204:4;:67::i;:::-;111300:27;;;;-1:-1:-1;;;111300:27:0;;;;;;;;;;;;-1:-1:-1;;;;111300:27:0;;;;;;;;;111342:63;111347:4;;;111353:22;111365:9;125605:1;125600:6;;;125599:12;;125493:137;111353:22;111377:27;111382:4;;;125605:1;125600:6;;;125599:12;111388:15;125493:137;111342:63;-1:-1:-1;;;;;111425:11:0;;;;;;:7;;;:11;;;;;111420:32;;111438:1;111448:2;111420:4;:32::i;:::-;111467:38;111472:4;;;125605:1;125600:6;;;125599:12;111502:1;111467:4;:38::i;:::-;110905:612;;111549:2;-1:-1:-1;;;;;111534:24:0;111543:4;-1:-1:-1;;;;;111534:24:0;;97374:8;111534:24;;;;1342:25:1;;1330:2;1315:18;;1196:177;111534:24:0;;;;;;;;110182:1384;;;;110059:1507;;;;:::o;18908:119::-;18987:32;19000:4;19006:5;19013;18987:12;:32::i;9228:364::-;-1:-1:-1;;9438:18:0;9428:8;9425:32;9415:159;;9491:10;9485:4;9478:24;9554:4;9548;9541:18;18651:117;18729:31;18742:4;18748:5;18755:4;18729:12;:31::i;131395:131::-;131485:33;131501:4;131507:2;131511:6;131485:15;:33::i;113782:289::-;113854:21;113878:15;113891:1;113878:12;:15::i;:::-;113909:7;;113854:39;;-1:-1:-1;;;;113909:7:0;;97895:6;113909:37;:42;;113908:53;;;;113904:124;;113978:38;;;-1:-1:-1;;;113978:38:0;;;;;97895:6;113978:38;;;;;-1:-1:-1;;;;113978:38:0;;;;;;113904:124;114054:1;-1:-1:-1;;;;;114043:20:0;;114057:5;114043:20;;;;1169:14:1;1162:22;1144:41;;1132:2;1117:18;;1004:187;114043:20:0;;;;;;;;113843:228;113782:289;;:::o;19846:819::-;-1:-1:-1;;20139:27:0;20129:8;20126:41;20116:531;;20244:15;20238:4;20231:29;20291:8;20285:4;20278:22;20497:5;20489:4;20483;20473:21;20467:28;20463:40;20453:179;;20541:10;20535:4;20528:24;20608:4;20602;20595:18;8054:1113;-1:-1:-1;;9021:16:0;;-1:-1:-1;;;;;8867:26:0;;;;;;8981:38;8978:1;;8970:78;9107:27;8054:1113::o;100743:861::-;100238:20;100938:13;;;;;;;:18;100934:53;;100965:22;;-1:-1:-1;;;100965:22:0;;;;;;;;;;;100934:53;101000:17;;-1:-1:-1;;101000:17:0;;;;;101034:22;;101030:567;;-1:-1:-1;;;;;101077:32:0;;101073:68;;101118:23;;-1:-1:-1;;;101118:23:0;;;;;;;;;;;101073:68;97596:25;101160:18;:32;101156:66;;;101201:21;;-1:-1:-1;;;101201:21:0;;;;;;;;;;;101156:66;101239:42;;-1:-1:-1;;;;101239:42:0;-1:-1:-1;;;;;;;;101239:42:0;;;;;;-1:-1:-1;101342:32:0;101355:18;101342:12;:32::i;:::-;101389:60;;-1:-1:-1;;;;;101389:60:0;;;-1:-1:-1;;;;;;;;101389:60:0;;;;;;101471;;1342:25:1;;;101389:60:0;;-1:-1:-1;101471:60:0;;;-1:-1:-1;;101471:60:0;;1330:2:1;1315:18;101471:60:0;;;;;;;101548:37;101560:18;101580:4;101548:11;:37::i;131732:137::-;131806:55;131814:6;131822:38;131853:6;131822:15;131830:6;-1:-1:-1;;;;;112176:37:0;112150:6;112176:37;;;:30;:37;;;;;:41;;;;112087:138;131822:15;:30;;;;:38::i;:::-;-1:-1:-1;;;;;112555:37:0;;;;;;;;:30;:37;;;;;:49;;-1:-1:-1;;112555:49:0;;;;;;;;;;;112481:131;42661:1676;42717:17;43169:4;43162;43156:11;43152:22;43145:29;;43270:4;43265:3;43261:14;43255:4;43248:28;43353:1;43348:3;43341:14;43457:3;43489:1;43485:6;43701:5;43683:410;43740:11;;;;43924:2;43938;43928:13;;43920:22;43740:11;43907:36;44032:2;44022:13;;44053:25;43683:410;44053:25;-1:-1:-1;;44123:13:0;;;-1:-1:-1;;44238:14:0;;;44300:19;;;44238:14;42661:1676;-1:-1:-1;42661:1676:0:o;60284:3410::-;60423:20;60556:7;60550:14;60604:6;60598:13;60656:11;60650:18;60708:4;60699:7;60695:18;60684:29;;60749:4;60741:6;60737:17;60727:27;;60800:4;60787:11;60783:22;60768:37;;60846:4;60839;60833:11;60829:22;60819:32;;60898:13;60889:7;60885:27;60953:13;60939:12;60936:31;60926:2004;;61047:1;61032:12;61020:10;61016:29;61012:37;61076:1;61122:4;61108:12;61105:22;61095:74;;-1:-1:-1;61136:31:0;;;61095:74;61231:4;61217:12;61213:23;61207:4;61203:34;61200:1;61196:42;61271:6;61265:13;61296:1619;61346:7;61340:14;61527:1;61524;61520:9;61517:1;61513:17;61503:1188;;61562:1;61559:441;;;61642:1;61627:12;61618:7;61608:32;61605:39;61595:378;;61681:17;;;61754:1;61801:15;;;;61742:14;;;;61860:29;;;61850:50;;61893:5;;;61850:50;61934:8;61296:1619;;61595:378;62112:1;62097:254;62181:19;;;62175:26;62159:14;;;62152:50;62244:4;62237:12;62289:24;;;62097:254;62279:45;-1:-1:-1;62454:26:0;;;;62387:30;;;;62506:162;;;;62575:16;62566:7;62563:29;62553:50;;62596:5;;;62506:162;62713:17;;62774:1;62809:15;;;;62762:14;;;;62856:29;;;61296:1619;62846:50;61296:1619;61300:2;;;;60926:2004;62969:6;62946:29;;63016:4;63009;63003:11;62999:22;62989:32;;63094:7;63082:10;63078:24;63069:6;63052:15;63048:28;63044:59;63035:68;;63181:217;63200:10;63191:7;63188:23;63181:217;;;63258:14;;63234:39;;63331:4;63365:18;;;;63310:26;;;;63181:217;;;-1:-1:-1;;63469:17:0;63465:25;;;63542:15;;;63434:4;63584:15;63578:4;63571:29;-1:-1:-1;;63422:17:0;;;63638;;;-1:-1:-1;63422:17:0;60284:3410;-1:-1:-1;;;60284:3410:0:o;114242:407::-;-1:-1:-1;;;;;114393:16:0;;114301:21;114393:16;;;:13;:16;;;;;114426:7;;114393:16;;100238:20;;-1:-1:-1;;;114426:7:0;;97758:6;114426:40;:45;;114422:220;;97758:6;124451:14;;114547:53;;;97895:6;114564:36;114547:53;114615:15;;;;;;-1:-1:-1;;;114615:15:0;-1:-1:-1;;;;114615:15:0;;;;;;114422:220;114324:325;114242:407;;;:::o;114815:469::-;115055:26;;-1:-1:-1;;;115055:26:0;;;;100238:20;114949:19;115096:17;;;115092:185;;115145:14;;115147:1;;:12;;115145:14;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;115174:41;;-1:-1:-1;;;115174:41:0;;-1:-1:-1;;;;115174:41:0;;;;;;-1:-1:-1;115230:30:0;;;-1:-1:-1;115230:16:0;;:30;;;;;:35;;-1:-1:-1;;;;;115230:35:0;;-1:-1:-1;;;;;;115230:35:0;;;;;;115145:14;-1:-1:-1;115092:185:0;114975:309;114815:469;;;;:::o;125932:542::-;126098:8;126092:4;126085:22;126141:5;126138:1;126134:13;126128:4;126121:27;126187:4;126181;126171:21;126250:1;126243:5;126239:13;126236:1;126232:21;126313:1;126307:8;126361:10;126446:5;126442:1;126439;126435:9;126431:21;126428:1;126424:29;126421:1;126417:37;126414:1;126410:45;126407:1;126400:56;;;;;125932:542;;;:::o;17527:986::-;17696:15;17690:4;17683:29;17739:4;17733;17726:18;17790:4;17784;17774:21;17870:8;17864:15;17979:5;17970:7;17967:18;18227:2;18217:62;;-1:-1:-1;18257:19:0;;;18244:33;;18217:62;18353:7;18343:8;18336:25;18487:7;18479:4;18473:11;18469:2;18465:20;18433:30;18430:1;18427;18422:73;;;;17527:986;;;:::o;108819:815::-;-1:-1:-1;;;;;108912:16:0;;108908:52;;108937:23;;-1:-1:-1;;;108937:23:0;;;;;;;;;;;108908:52;108973:35;109011:18;109024:4;109011:12;:18::i;:::-;108973:56;;109040:33;109076:16;109089:2;109076:12;:16::i;:::-;109040:52;;109105:23;-1:-1:-1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;109105:23:0;109159:27;;;-1:-1:-1;;;109159:27:0;;;;;109139:17;;;:47;109215:25;;;;109197:15;;;:43;-1:-1:-1;;;;;;;;109267:23:0;;;;109251:13;;;:39;;;109307:22;;109303:56;;;109338:21;;-1:-1:-1;;;109338:21:0;;;;;;;;;;;109303:56;109397:13;;;;:23;;;;;;;;;109435:47;;-1:-1:-1;;;;;109435:47:0;;;-1:-1:-1;;;109435:47:0;;;-1:-1:-1;;;;;109435:47:0;;;;;;109542:21;;;;;;;:30;;109528:11;;;:44;;;109497:76;;;;;;;;;;;;;109600:26;;1342:25:1;;;109600:26:0;;;;;;;;;1330:2:1;1315:18;109600:26:0;;;;;;;108897:737;;;108819:815;;;:::o;128845:230::-;128920:6;128796:28;127656:2;128796:28;;;;:33;;128943:31;;;;128939:105;;-1:-1:-1;;;128991:41:0;;;;;128939:105;-1:-1:-1;129061:6:0;;128845:230;-1:-1:-1;128845:230:0:o;14:548:1:-;126:4;155:2;184;173:9;166:21;216:6;210:13;259:6;254:2;243:9;239:18;232:34;284:1;294:140;308:6;305:1;302:13;294:140;;;403:14;;;399:23;;393:30;369:17;;;388:2;365:26;358:66;323:10;;294:140;;;298:3;483:1;478:2;469:6;458:9;454:22;450:31;443:42;553:2;546;542:7;537:2;529:6;525:15;521:29;510:9;506:45;502:54;494:62;;;;14:548;;;;:::o;567:173::-;635:20;;-1:-1:-1;;;;;684:31:1;;674:42;;664:70;;730:1;727;720:12;745:254;813:6;821;874:2;862:9;853:7;849:23;845:32;842:52;;;890:1;887;880:12;842:52;913:29;932:9;913:29;:::i;:::-;903:39;989:2;974:18;;;;961:32;;-1:-1:-1;;;745:254:1:o;1378:180::-;1437:6;1490:2;1478:9;1469:7;1465:23;1461:32;1458:52;;;1506:1;1503;1496:12;1458:52;-1:-1:-1;1529:23:1;;1378:180;-1:-1:-1;1378:180:1:o;1563:328::-;1640:6;1648;1656;1709:2;1697:9;1688:7;1684:23;1680:32;1677:52;;;1725:1;1722;1715:12;1677:52;1748:29;1767:9;1748:29;:::i;:::-;1738:39;;1796:38;1830:2;1819:9;1815:18;1796:38;:::i;:::-;1786:48;;1881:2;1870:9;1866:18;1853:32;1843:42;;1563:328;;;;;:::o;1896:186::-;1955:6;2008:2;1996:9;1987:7;1983:23;1979:32;1976:52;;;2024:1;2021;2014:12;1976:52;2047:29;2066:9;2047:29;:::i;2087:273::-;2143:6;2196:2;2184:9;2175:7;2171:23;2167:32;2164:52;;;2212:1;2209;2202:12;2164:52;2251:9;2238:23;2304:5;2297:13;2290:21;2283:5;2280:32;2270:60;;2326:1;2323;2316:12;2554:592;2625:6;2633;2686:2;2674:9;2665:7;2661:23;2657:32;2654:52;;;2702:1;2699;2692:12;2654:52;2742:9;2729:23;2771:18;2812:2;2804:6;2801:14;2798:34;;;2828:1;2825;2818:12;2798:34;2866:6;2855:9;2851:22;2841:32;;2911:7;2904:4;2900:2;2896:13;2892:27;2882:55;;2933:1;2930;2923:12;2882:55;2973:2;2960:16;2999:2;2991:6;2988:14;2985:34;;;3015:1;3012;3005:12;2985:34;3060:7;3055:2;3046:6;3042:2;3038:15;3034:24;3031:37;3028:57;;;3081:1;3078;3071:12;3028:57;3112:2;3104:11;;;;;3134:6;;-1:-1:-1;2554:592:1;;-1:-1:-1;;;;2554:592:1:o;3359:260::-;3427:6;3435;3488:2;3476:9;3467:7;3463:23;3459:32;3456:52;;;3504:1;3501;3494:12;3456:52;3527:29;3546:9;3527:29;:::i;:::-;3517:39;;3575:38;3609:2;3598:9;3594:18;3575:38;:::i;:::-;3565:48;;3359:260;;;;;:::o;3624:380::-;3703:1;3699:12;;;;3746;;;3767:61;;3821:4;3813:6;3809:17;3799:27;;3767:61;3874:2;3866:6;3863:14;3843:18;3840:38;3837:161;;3920:10;3915:3;3911:20;3908:1;3901:31;3955:4;3952:1;3945:15;3983:4;3980:1;3973:15;4009:127;4070:10;4065:3;4061:20;4058:1;4051:31;4101:4;4098:1;4091:15;4125:4;4122:1;4115:15;4267:518;4369:2;4364:3;4361:11;4358:421;;;4405:5;4402:1;4395:16;4449:4;4446:1;4436:18;4519:2;4507:10;4503:19;4500:1;4496:27;4490:4;4486:38;4555:4;4543:10;4540:20;4537:47;;;-1:-1:-1;4578:4:1;4537:47;4633:2;4628:3;4624:12;4621:1;4617:20;4611:4;4607:31;4597:41;;4688:81;4706:2;4699:5;4696:13;4688:81;;;4765:1;4751:16;;4732:1;4721:13;4688:81;;;4692:3;;4267:518;;;:::o;4961:1198::-;5085:18;5080:3;5077:27;5074:53;;;5107:18;;:::i;:::-;5136:94;5226:3;5186:38;5218:4;5212:11;5186:38;:::i;:::-;5180:4;5136:94;:::i;:::-;5256:1;5281:2;5276:3;5273:11;5298:1;5293:608;;;;5945:1;5962:3;5959:93;;;-1:-1:-1;6018:19:1;;;6005:33;5959:93;-1:-1:-1;;4918:1:1;4914:11;;;4910:24;4906:29;4896:40;4942:1;4938:11;;;4893:57;6065:78;;5266:887;;5293:608;4214:1;4207:14;;;4251:4;4238:18;;-1:-1:-1;;5329:17:1;;;5444:229;5458:7;5455:1;5452:14;5444:229;;;5547:19;;;5534:33;5519:49;;5654:4;5639:20;;;;5607:1;5595:14;;;;5474:12;5444:229;;;5448:3;5701;5692:7;5689:16;5686:159;;;5825:1;5821:6;5815:3;5809;5806:1;5802:11;5798:21;5794:34;5790:39;5777:9;5772:3;5768:19;5755:33;5751:79;5743:6;5736:95;5686:159;;;5888:1;5882:3;5879:1;5875:11;5871:19;5865:4;5858:33;5266:887;;4961:1198;;;:::o;6164:127::-;6225:10;6220:3;6216:20;6213:1;6206:31;6256:4;6253:1;6246:15;6280:4;6277:1;6270:15;6296:168;6369:9;;;6400;;6417:15;;;6411:22;;6397:37;6387:71;;6438:18;;:::i;6469:191::-;-1:-1:-1;;;;;6596:10:1;;;6584;;;6580:27;;6619:12;;;6616:38;;;6634:18;;:::i;6665:201::-;6703:3;6731:10;6776:2;6769:5;6765:14;6803:2;6794:7;6791:15;6788:41;;6809:18;;:::i;:::-;6858:1;6845:15;;6665:201;-1:-1:-1;;;6665:201:1:o
Swarm Source
ipfs://0307a04139256232fbc3ca8f11bbcfd5363d413ca9bb648fc3c18dac6624a7fc
Loading...
Loading
Loading...
Loading
[ Download: CSV Export ]
[ Download: CSV Export ]
A token is a representation of an on-chain or off-chain asset. The token page shows information such as price, total supply, holders, transfers and social links. Learn more about this page in our Knowledge Base.