Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Similar
• Submit Audit
• Compare

/**
 *Submitted for verification at Arbiscan.io on 2024-10-25
*/

// SPDX-License-Identifier: AGPL-3.0
pragma solidity ^0.8.19 ^0.8.4;

// lib/solady/src/auth/EnumerableRoles.sol

/// @notice Enumerable multiroles authorization mixin.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/auth/EnumerableRoles.sol)
///
/// @dev Note:
/// This implementation is agnostic to the Ownable that the contract inherits from.
/// It performs a self-staticcall to the `owner()` function to determine the owner.
/// This is useful for situations where the contract inherits from
/// OpenZeppelin's Ownable, such as in LayerZero's OApp contracts.
///
/// This implementation performs a self-staticcall to `MAX_ROLE()` to determine
/// the maximum role that can be set/unset. If the inheriting contract does not
/// have `MAX_ROLE()`, then any role can be set/unset.
///
/// This implementation allows for any uint256 role,
/// it does NOT take in a bitmask of roles.
/// This is to accommodate teams that are allergic to bitwise flags.
///
/// By default, the `owner()` is the only account that is authorized to set roles.
/// This behavior can be changed via overrides.
///
/// This implementation is compatible with any Ownable.
/// This implementation is NOT compatible with OwnableRoles.
abstract contract EnumerableRoles {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           EVENTS                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The status of `role` for `holder` has been set to `active`.
    event RoleSet(address indexed holder, uint256 indexed role, bool indexed active);

    /// @dev `keccak256(bytes("RoleSet(address,uint256,bool)"))`.
    uint256 private constant _ROLE_SET_EVENT_SIGNATURE =
        0xaddc47d7e02c95c00ec667676636d772a589ffbf0663cfd7cd4dd3d4758201b8;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       CUSTOM ERRORS                        */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The index is out of bounds of the role holders array.
    error RoleHoldersIndexOutOfBounds();

    /// @dev Cannot set the role of the zero address.
    error RoleHolderIsZeroAddress();

    /// @dev The role has exceeded the maximum role.
    error InvalidRole();

    /// @dev Unauthorized to perform the action.
    error EnumerableRolesUnauthorized();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          STORAGE                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The storage layout of the holders enumerable mapping is given by:
    /// ```
    ///     mstore(0x18, holder)
    ///     mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
    ///     mstore(0x00, role)
    ///     let rootSlot := keccak256(0x00, 0x24)
    ///     let positionSlot := keccak256(0x00, 0x38)
    ///     let holderSlot := add(rootSlot, sload(positionSlot))
    ///     let holderInStorage := shr(96, sload(holderSlot))
    ///     let length := shr(160, shl(160, sload(rootSlot)))
    /// ```
    uint256 private constant _ENUMERABLE_ROLES_SLOT_SEED = 0xee9853bb;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  PUBLIC UPDATE FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Sets the status of `role` of `holder` to `active`.
    function setRole(address holder, uint256 role, bool active) public payable virtual {
        _authorizeSetRole(holder, role, active);
        _setRole(holder, role, active);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                   PUBLIC READ FUNCTIONS                    */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns if `holder` has active `role`.
    function hasRole(address holder, uint256 role) public view virtual returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x18, holder)
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            mstore(0x00, role)
            result := iszero(iszero(sload(keccak256(0x00, 0x38))))
        }
    }

    /// @dev Returns an array of the holders of `role`.
    function roleHolders(uint256 role) public view virtual returns (address[] memory result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := mload(0x40)
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            mstore(0x00, role)
            let rootSlot := keccak256(0x00, 0x24)
            let rootPacked := sload(rootSlot)
            let n := shr(160, shl(160, rootPacked))
            let o := add(0x20, result)
            mstore(o, shr(96, rootPacked))
            for { let i := 1 } lt(i, n) { i := add(i, 1) } {
                mstore(add(o, shl(5, i)), shr(96, sload(add(rootSlot, i))))
            }
            mstore(result, n)
            mstore(0x40, add(o, shl(5, n)))
        }
    }

    /// @dev Returns the total number of holders of `role`.
    function roleHolderCount(uint256 role) public view virtual returns (uint256 result) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            mstore(0x00, role)
            result := shr(160, shl(160, sload(keccak256(0x00, 0x24))))
        }
    }

    /// @dev Returns the holder of `role` at the index `i`.
    function roleHolderAt(uint256 role, uint256 i) public view virtual returns (address result) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            mstore(0x00, role)
            let rootSlot := keccak256(0x00, 0x24)
            let rootPacked := sload(rootSlot)
            if iszero(lt(i, shr(160, shl(160, rootPacked)))) {
                mstore(0x00, 0x5694da8e) // `RoleHoldersIndexOutOfBounds()`.
                revert(0x1c, 0x04)
            }
            result := shr(96, rootPacked)
            if i { result := shr(96, sload(add(rootSlot, i))) }
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     INTERNAL FUNCTIONS                     */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Set the role for holder directly without authorization guard.
    function _setRole(address holder, uint256 role, bool active) internal virtual {
        _validateRole(role);
        /// @solidity memory-safe-assembly
        assembly {
            let holder_ := shl(96, holder)
            if iszero(holder_) {
                mstore(0x00, 0x82550143) // `RoleHolderIsZeroAddress()`.
                revert(0x1c, 0x04)
            }
            mstore(0x18, holder)
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            mstore(0x00, role)
            let rootSlot := keccak256(0x00, 0x24)
            let n := shr(160, shl(160, sload(rootSlot)))
            let positionSlot := keccak256(0x00, 0x38)
            let position := sload(positionSlot)
            for {} 1 {} {
                if iszero(active) {
                    if iszero(position) { break }
                    let nSub := sub(n, 1)
                    if iszero(eq(sub(position, 1), nSub)) {
                        let lastHolder_ := shl(96, shr(96, sload(add(rootSlot, nSub))))
                        sstore(add(rootSlot, sub(position, 1)), lastHolder_)
                        sstore(add(rootSlot, nSub), 0)
                        mstore(0x24, lastHolder_)
                        sstore(keccak256(0x00, 0x38), position)
                    }
                    sstore(rootSlot, or(shl(96, shr(96, sload(rootSlot))), nSub))
                    sstore(positionSlot, 0)
                    break
                }
                if iszero(position) {
                    sstore(add(rootSlot, n), holder_)
                    sstore(positionSlot, add(n, 1))
                    sstore(rootSlot, add(sload(rootSlot), 1))
                }
                break
            }
            // forgefmt: disable-next-item
            log4(0x00, 0x00, _ROLE_SET_EVENT_SIGNATURE, shr(96, holder_), role, iszero(iszero(active)))
        }
    }

    /// @dev Requires the role is not greater than `MAX_ROLE()`.
    /// If `MAX_ROLE()` is not implemented, this is an no-op.
    function _validateRole(uint256 role) internal view virtual {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, 0xd24f19d5) // `MAX_ROLE()`.
            if and(
                and(gt(role, mload(0x00)), gt(returndatasize(), 0x1f)),
                staticcall(gas(), address(), 0x1c, 0x04, 0x00, 0x20)
            ) {
                mstore(0x00, 0xd954416a) // `InvalidRole()`.
                revert(0x1c, 0x04)
            }
        }
    }

    /// @dev Checks that the caller is authorized to set the role.
    function _authorizeSetRole(address holder, uint256 role, bool active) internal virtual {
        if (!_senderIsContractOwner()) _revertEnumerableRolesUnauthorized();
        // Silence compiler warning on unused variables.
        (holder, role, active) = (holder, role, active);
    }

    /// @dev Returns if `holder` has any roles in `encodedRoles`.
    /// `encodedRoles` is `abi.encode(SAMPLE_ROLE_0, SAMPLE_ROLE_1, ...)`.
    function _hasAnyRoles(address holder, bytes memory encodedRoles)
        internal
        view
        virtual
        returns (bool result)
    {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x18, holder)
            mstore(0x04, _ENUMERABLE_ROLES_SLOT_SEED)
            let end := add(encodedRoles, shl(5, shr(5, mload(encodedRoles))))
            for {} lt(result, lt(encodedRoles, end)) {} {
                encodedRoles := add(0x20, encodedRoles)
                mstore(0x00, mload(encodedRoles))
                result := sload(keccak256(0x00, 0x38))
            }
            result := iszero(iszero(result))
        }
    }

    /// @dev Throws if the sender does not have any roles in `encodedRoles`.
    function _checkRoles(bytes memory encodedRoles) internal view virtual {
        if (!_hasAnyRoles(msg.sender, encodedRoles)) _revertEnumerableRolesUnauthorized();
    }

    /// @dev Throws if the sender does not have any roles in `encodedRoles`.
    function _checkOwnerOrRoles(bytes memory encodedRoles) internal view virtual {
        if (!_senderIsContractOwner()) _checkRoles(encodedRoles);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         MODIFIERS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Marks a function as only callable by an account with any role in `encodedRoles`.
    /// `encodedRoles` is `abi.encode(SAMPLE_ROLE_0, SAMPLE_ROLE_1, ...)`.
    modifier onlyRoles(bytes memory encodedRoles) virtual {
        _checkRoles(encodedRoles);
        _;
    }

    /// @dev Marks a function as only callable by the owner or
    /// by an account with any role in `encodedRoles`.
    /// Checks for ownership first, then checks for roles.
    /// `encodedRoles` is `abi.encode(SAMPLE_ROLE_0, SAMPLE_ROLE_1, ...)`.
    modifier onlyOwnerOrRoles(bytes memory encodedRoles) virtual {
        _checkOwnerOrRoles(encodedRoles);
        _;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                      PRIVATE HELPERS                       */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns if the `msg.sender` is equal to `owner()` on this contract.
    /// If the contract does not have `owner()` implemented, returns false.
    function _senderIsContractOwner() private view returns (bool result) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, 0x8da5cb5b) // `owner()`.
            result :=
                and(
                    and(eq(caller(), mload(0x00)), gt(returndatasize(), 0x1f)),
                    staticcall(gas(), address(), 0x1c, 0x04, 0x00, 0x20)
                )
        }
    }

    /// @dev Reverts with `EnumerableRolesUnauthorized()`.
    function _revertEnumerableRolesUnauthorized() private pure {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x00, 0x99152cca) // `EnumerableRolesUnauthorized()`.
            revert(0x1c, 0x04)
        }
    }
}

// lib/solady/src/auth/Ownable.sol

/// @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();
        _;
    }
}

// lib/solady/src/tokens/ERC20.sol

/// @notice Simple ERC20 + EIP-2612 implementation.
/// @author Solady (https://github.com/vectorized/solady/blob/main/src/tokens/ERC20.sol)
/// @author Modified from Solmate (https://github.com/transmissions11/solmate/blob/main/src/tokens/ERC20.sol)
/// @author Modified from OpenZeppelin (https://github.com/OpenZeppelin/openzeppelin-contracts/blob/master/contracts/token/ERC20/ERC20.sol)
///
/// @dev Note:
/// - The ERC20 standard allows minting and transferring to and from the zero address,
///   minting and transferring zero tokens, as well as self-approvals.
///   For performance, this implementation WILL NOT revert for such actions.
///   Please add any checks with overrides if desired.
/// - The `permit` function uses the ecrecover precompile (0x1).
///
/// If you are overriding:
/// - NEVER violate the ERC20 invariant:
///   the total sum of all balances must be equal to `totalSupply()`.
/// - Check that the overridden function is actually used in the function you want to
///   change the behavior of. Much of the code has been manually inlined for performance.
abstract contract ERC20 {
    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       CUSTOM ERRORS                        */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The total supply has overflowed.
    error TotalSupplyOverflow();

    /// @dev The allowance has overflowed.
    error AllowanceOverflow();

    /// @dev The allowance has underflowed.
    error AllowanceUnderflow();

    /// @dev Insufficient balance.
    error InsufficientBalance();

    /// @dev Insufficient allowance.
    error InsufficientAllowance();

    /// @dev The permit is invalid.
    error InvalidPermit();

    /// @dev The permit has expired.
    error PermitExpired();

    /// @dev The allowance of Permit2 is fixed at infinity.
    error Permit2AllowanceIsFixedAtInfinity();

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           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 `keccak256(bytes("Transfer(address,address,uint256)"))`.
    uint256 private constant _TRANSFER_EVENT_SIGNATURE =
        0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef;

    /// @dev `keccak256(bytes("Approval(address,address,uint256)"))`.
    uint256 private constant _APPROVAL_EVENT_SIGNATURE =
        0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          STORAGE                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev The storage slot for the total supply.
    uint256 private constant _TOTAL_SUPPLY_SLOT = 0x05345cdf77eb68f44c;

    /// @dev The balance slot of `owner` is given by:
    /// ```
    ///     mstore(0x0c, _BALANCE_SLOT_SEED)
    ///     mstore(0x00, owner)
    ///     let balanceSlot := keccak256(0x0c, 0x20)
    /// ```
    uint256 private constant _BALANCE_SLOT_SEED = 0x87a211a2;

    /// @dev The allowance slot of (`owner`, `spender`) is given by:
    /// ```
    ///     mstore(0x20, spender)
    ///     mstore(0x0c, _ALLOWANCE_SLOT_SEED)
    ///     mstore(0x00, owner)
    ///     let allowanceSlot := keccak256(0x0c, 0x34)
    /// ```
    uint256 private constant _ALLOWANCE_SLOT_SEED = 0x7f5e9f20;

    /// @dev The nonce slot of `owner` is given by:
    /// ```
    ///     mstore(0x0c, _NONCES_SLOT_SEED)
    ///     mstore(0x00, owner)
    ///     let nonceSlot := keccak256(0x0c, 0x20)
    /// ```
    uint256 private constant _NONCES_SLOT_SEED = 0x38377508;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                         CONSTANTS                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev `(_NONCES_SLOT_SEED << 16) | 0x1901`.
    uint256 private constant _NONCES_SLOT_SEED_WITH_SIGNATURE_PREFIX = 0x383775081901;

    /// @dev `keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")`.
    bytes32 private constant _DOMAIN_TYPEHASH =
        0x8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f;

    /// @dev `keccak256("1")`.
    /// If you need to use a different version, override `_versionHash`.
    bytes32 private constant _DEFAULT_VERSION_HASH =
        0xc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc6;

    /// @dev `keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)")`.
    bytes32 private constant _PERMIT_TYPEHASH =
        0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;

    /// @dev The canonical Permit2 address.
    /// For signature-based allowance granting for single transaction ERC20 `transferFrom`.
    /// To enable, override `_givePermit2InfiniteAllowance()`.
    /// [Github](https://github.com/Uniswap/permit2)
    /// [Etherscan](https://etherscan.io/address/0x000000000022D473030F116dDEE9F6B43aC78BA3)
    address internal constant _PERMIT2 = 0x000000000022D473030F116dDEE9F6B43aC78BA3;

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                       ERC20 METADATA                       */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @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 decimals places of the token.
    function decimals() public view virtual returns (uint8) {
        return 18;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                           ERC20                            */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns the amount of tokens in existence.
    function totalSupply() public view virtual returns (uint256 result) {
        /// @solidity memory-safe-assembly
        assembly {
            result := sload(_TOTAL_SUPPLY_SLOT)
        }
    }

    /// @dev Returns the amount of tokens owned by `owner`.
    function balanceOf(address owner) public view virtual returns (uint256 result) {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x0c, _BALANCE_SLOT_SEED)
            mstore(0x00, owner)
            result := sload(keccak256(0x0c, 0x20))
        }
    }

    /// @dev Returns the amount of tokens that `spender` can spend on behalf of `owner`.
    function allowance(address owner, address spender)
        public
        view
        virtual
        returns (uint256 result)
    {
        if (_givePermit2InfiniteAllowance()) {
            if (spender == _PERMIT2) return type(uint256).max;
        }
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x20, spender)
            mstore(0x0c, _ALLOWANCE_SLOT_SEED)
            mstore(0x00, owner)
            result := sload(keccak256(0x0c, 0x34))
        }
    }

    /// @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) {
        if (_givePermit2InfiniteAllowance()) {
            /// @solidity memory-safe-assembly
            assembly {
                // If `spender == _PERMIT2 && amount != type(uint256).max`.
                if iszero(or(xor(shr(96, shl(96, spender)), _PERMIT2), iszero(not(amount)))) {
                    mstore(0x00, 0x3f68539a) // `Permit2AllowanceIsFixedAtInfinity()`.
                    revert(0x1c, 0x04)
                }
            }
        }
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the allowance slot and store the amount.
            mstore(0x20, spender)
            mstore(0x0c, _ALLOWANCE_SLOT_SEED)
            mstore(0x00, caller())
            sstore(keccak256(0x0c, 0x34), amount)
            // Emit the {Approval} event.
            mstore(0x00, amount)
            log3(0x00, 0x20, _APPROVAL_EVENT_SIGNATURE, caller(), shr(96, mload(0x2c)))
        }
        return true;
    }

    /// @dev Transfer `amount` tokens from the caller to `to`.
    ///
    /// Requirements:
    /// - `from` must at least have `amount`.
    ///
    /// Emits a {Transfer} event.
    function transfer(address to, uint256 amount) public virtual returns (bool) {
        _beforeTokenTransfer(msg.sender, to, amount);
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the balance slot and load its value.
            mstore(0x0c, _BALANCE_SLOT_SEED)
            mstore(0x00, caller())
            let fromBalanceSlot := keccak256(0x0c, 0x20)
            let fromBalance := sload(fromBalanceSlot)
            // Revert if insufficient balance.
            if gt(amount, fromBalance) {
                mstore(0x00, 0xf4d678b8) // `InsufficientBalance()`.
                revert(0x1c, 0x04)
            }
            // Subtract and store the updated balance.
            sstore(fromBalanceSlot, sub(fromBalance, amount))
            // Compute the balance slot of `to`.
            mstore(0x00, to)
            let toBalanceSlot := keccak256(0x0c, 0x20)
            // Add and store the updated balance of `to`.
            // Will not overflow because the sum of all user balances
            // cannot exceed the maximum uint256 value.
            sstore(toBalanceSlot, add(sload(toBalanceSlot), amount))
            // Emit the {Transfer} event.
            mstore(0x20, amount)
            log3(0x20, 0x20, _TRANSFER_EVENT_SIGNATURE, caller(), shr(96, mload(0x0c)))
        }
        _afterTokenTransfer(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.
    ///
    /// 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) {
        _beforeTokenTransfer(from, to, amount);
        // Code duplication is for zero-cost abstraction if possible.
        if (_givePermit2InfiniteAllowance()) {
            /// @solidity memory-safe-assembly
            assembly {
                let from_ := shl(96, from)
                if iszero(eq(caller(), _PERMIT2)) {
                    // Compute the allowance slot and load its value.
                    mstore(0x20, caller())
                    mstore(0x0c, or(from_, _ALLOWANCE_SLOT_SEED))
                    let allowanceSlot := keccak256(0x0c, 0x34)
                    let allowance_ := sload(allowanceSlot)
                    // If the allowance is not the maximum uint256 value.
                    if not(allowance_) {
                        // Revert if the amount to be transferred exceeds the allowance.
                        if gt(amount, allowance_) {
                            mstore(0x00, 0x13be252b) // `InsufficientAllowance()`.
                            revert(0x1c, 0x04)
                        }
                        // Subtract and store the updated allowance.
                        sstore(allowanceSlot, sub(allowance_, amount))
                    }
                }
                // Compute the balance slot and load its value.
                mstore(0x0c, or(from_, _BALANCE_SLOT_SEED))
                let fromBalanceSlot := keccak256(0x0c, 0x20)
                let fromBalance := sload(fromBalanceSlot)
                // Revert if insufficient balance.
                if gt(amount, fromBalance) {
                    mstore(0x00, 0xf4d678b8) // `InsufficientBalance()`.
                    revert(0x1c, 0x04)
                }
                // Subtract and store the updated balance.
                sstore(fromBalanceSlot, sub(fromBalance, amount))
                // Compute the balance slot of `to`.
                mstore(0x00, to)
                let toBalanceSlot := keccak256(0x0c, 0x20)
                // Add and store the updated balance of `to`.
                // Will not overflow because the sum of all user balances
                // cannot exceed the maximum uint256 value.
                sstore(toBalanceSlot, add(sload(toBalanceSlot), amount))
                // Emit the {Transfer} event.
                mstore(0x20, amount)
                log3(0x20, 0x20, _TRANSFER_EVENT_SIGNATURE, shr(96, from_), shr(96, mload(0x0c)))
            }
        } else {
            /// @solidity memory-safe-assembly
            assembly {
                let from_ := shl(96, from)
                // Compute the allowance slot and load its value.
                mstore(0x20, caller())
                mstore(0x0c, or(from_, _ALLOWANCE_SLOT_SEED))
                let allowanceSlot := keccak256(0x0c, 0x34)
                let allowance_ := sload(allowanceSlot)
                // If the allowance is not the maximum uint256 value.
                if not(allowance_) {
                    // Revert if the amount to be transferred exceeds the allowance.
                    if gt(amount, allowance_) {
                        mstore(0x00, 0x13be252b) // `InsufficientAllowance()`.
                        revert(0x1c, 0x04)
                    }
                    // Subtract and store the updated allowance.
                    sstore(allowanceSlot, sub(allowance_, amount))
                }
                // Compute the balance slot and load its value.
                mstore(0x0c, or(from_, _BALANCE_SLOT_SEED))
                let fromBalanceSlot := keccak256(0x0c, 0x20)
                let fromBalance := sload(fromBalanceSlot)
                // Revert if insufficient balance.
                if gt(amount, fromBalance) {
                    mstore(0x00, 0xf4d678b8) // `InsufficientBalance()`.
                    revert(0x1c, 0x04)
                }
                // Subtract and store the updated balance.
                sstore(fromBalanceSlot, sub(fromBalance, amount))
                // Compute the balance slot of `to`.
                mstore(0x00, to)
                let toBalanceSlot := keccak256(0x0c, 0x20)
                // Add and store the updated balance of `to`.
                // Will not overflow because the sum of all user balances
                // cannot exceed the maximum uint256 value.
                sstore(toBalanceSlot, add(sload(toBalanceSlot), amount))
                // Emit the {Transfer} event.
                mstore(0x20, amount)
                log3(0x20, 0x20, _TRANSFER_EVENT_SIGNATURE, shr(96, from_), shr(96, mload(0x0c)))
            }
        }
        _afterTokenTransfer(from, to, amount);
        return true;
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          EIP-2612                          */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev For more performance, override to return the constant value
    /// of `keccak256(bytes(name()))` if `name()` will never change.
    function _constantNameHash() internal view virtual returns (bytes32 result) {}

    /// @dev If you need a different value, override this function.
    function _versionHash() internal view virtual returns (bytes32 result) {
        result = _DEFAULT_VERSION_HASH;
    }

    /// @dev For inheriting contracts to increment the nonce.
    function _incrementNonce(address owner) internal virtual {
        /// @solidity memory-safe-assembly
        assembly {
            mstore(0x0c, _NONCES_SLOT_SEED)
            mstore(0x00, owner)
            let nonceSlot := keccak256(0x0c, 0x20)
            sstore(nonceSlot, add(1, sload(nonceSlot)))
        }
    }

    /// @dev Returns the current nonce for `owner`.
    /// This value is used to compute the signature for EIP-2612 permit.
    function nonces(address owner) public view virtual returns (uint256 result) {
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the nonce slot and load its value.
            mstore(0x0c, _NONCES_SLOT_SEED)
            mstore(0x00, owner)
            result := sload(keccak256(0x0c, 0x20))
        }
    }

    /// @dev Sets `value` as the allowance of `spender` over the tokens of `owner`,
    /// authorized by a signed approval by `owner`.
    ///
    /// Emits a {Approval} event.
    function permit(
        address owner,
        address spender,
        uint256 value,
        uint256 deadline,
        uint8 v,
        bytes32 r,
        bytes32 s
    ) public virtual {
        if (_givePermit2InfiniteAllowance()) {
            /// @solidity memory-safe-assembly
            assembly {
                // If `spender == _PERMIT2 && value != type(uint256).max`.
                if iszero(or(xor(shr(96, shl(96, spender)), _PERMIT2), iszero(not(value)))) {
                    mstore(0x00, 0x3f68539a) // `Permit2AllowanceIsFixedAtInfinity()`.
                    revert(0x1c, 0x04)
                }
            }
        }
        bytes32 nameHash = _constantNameHash();
        //  We simply calculate it on-the-fly to allow for cases where the `name` may change.
        if (nameHash == bytes32(0)) nameHash = keccak256(bytes(name()));
        bytes32 versionHash = _versionHash();
        /// @solidity memory-safe-assembly
        assembly {
            // Revert if the block timestamp is greater than `deadline`.
            if gt(timestamp(), deadline) {
                mstore(0x00, 0x1a15a3cc) // `PermitExpired()`.
                revert(0x1c, 0x04)
            }
            let m := mload(0x40) // Grab the free memory pointer.
            // Clean the upper 96 bits.
            owner := shr(96, shl(96, owner))
            spender := shr(96, shl(96, spender))
            // Compute the nonce slot and load its value.
            mstore(0x0e, _NONCES_SLOT_SEED_WITH_SIGNATURE_PREFIX)
            mstore(0x00, owner)
            let nonceSlot := keccak256(0x0c, 0x20)
            let nonceValue := sload(nonceSlot)
            // Prepare the domain separator.
            mstore(m, _DOMAIN_TYPEHASH)
            mstore(add(m, 0x20), nameHash)
            mstore(add(m, 0x40), versionHash)
            mstore(add(m, 0x60), chainid())
            mstore(add(m, 0x80), address())
            mstore(0x2e, keccak256(m, 0xa0))
            // Prepare the struct hash.
            mstore(m, _PERMIT_TYPEHASH)
            mstore(add(m, 0x20), owner)
            mstore(add(m, 0x40), spender)
            mstore(add(m, 0x60), value)
            mstore(add(m, 0x80), nonceValue)
            mstore(add(m, 0xa0), deadline)
            mstore(0x4e, keccak256(m, 0xc0))
            // Prepare the ecrecover calldata.
            mstore(0x00, keccak256(0x2c, 0x42))
            mstore(0x20, and(0xff, v))
            mstore(0x40, r)
            mstore(0x60, s)
            let t := staticcall(gas(), 1, 0x00, 0x80, 0x20, 0x20)
            // If the ecrecover fails, the returndatasize will be 0x00,
            // `owner` will be checked if it equals the hash at 0x00,
            // which evaluates to false (i.e. 0), and we will revert.
            // If the ecrecover succeeds, the returndatasize will be 0x20,
            // `owner` will be compared against the returned address at 0x20.
            if iszero(eq(mload(returndatasize()), owner)) {
                mstore(0x00, 0xddafbaef) // `InvalidPermit()`.
                revert(0x1c, 0x04)
            }
            // Increment and store the updated nonce.
            sstore(nonceSlot, add(nonceValue, t)) // `t` is 1 if ecrecover succeeds.
            // Compute the allowance slot and store the value.
            // The `owner` is already at slot 0x20.
            mstore(0x40, or(shl(160, _ALLOWANCE_SLOT_SEED), spender))
            sstore(keccak256(0x2c, 0x34), value)
            // Emit the {Approval} event.
            log3(add(m, 0x60), 0x20, _APPROVAL_EVENT_SIGNATURE, owner, spender)
            mstore(0x40, m) // Restore the free memory pointer.
            mstore(0x60, 0) // Restore the zero pointer.
        }
    }

    /// @dev Returns the EIP-712 domain separator for the EIP-2612 permit.
    function DOMAIN_SEPARATOR() public view virtual returns (bytes32 result) {
        bytes32 nameHash = _constantNameHash();
        //  We simply calculate it on-the-fly to allow for cases where the `name` may change.
        if (nameHash == bytes32(0)) nameHash = keccak256(bytes(name()));
        bytes32 versionHash = _versionHash();
        /// @solidity memory-safe-assembly
        assembly {
            let m := mload(0x40) // Grab the free memory pointer.
            mstore(m, _DOMAIN_TYPEHASH)
            mstore(add(m, 0x20), nameHash)
            mstore(add(m, 0x40), versionHash)
            mstore(add(m, 0x60), chainid())
            mstore(add(m, 0x80), address())
            result := keccak256(m, 0xa0)
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  INTERNAL MINT FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Mints `amount` tokens to `to`, increasing the total supply.
    ///
    /// Emits a {Transfer} event.
    function _mint(address to, uint256 amount) internal virtual {
        _beforeTokenTransfer(address(0), to, amount);
        /// @solidity memory-safe-assembly
        assembly {
            let totalSupplyBefore := sload(_TOTAL_SUPPLY_SLOT)
            let totalSupplyAfter := add(totalSupplyBefore, amount)
            // Revert if the total supply overflows.
            if lt(totalSupplyAfter, totalSupplyBefore) {
                mstore(0x00, 0xe5cfe957) // `TotalSupplyOverflow()`.
                revert(0x1c, 0x04)
            }
            // Store the updated total supply.
            sstore(_TOTAL_SUPPLY_SLOT, totalSupplyAfter)
            // Compute the balance slot and load its value.
            mstore(0x0c, _BALANCE_SLOT_SEED)
            mstore(0x00, to)
            let toBalanceSlot := keccak256(0x0c, 0x20)
            // Add and store the updated balance.
            sstore(toBalanceSlot, add(sload(toBalanceSlot), amount))
            // Emit the {Transfer} event.
            mstore(0x20, amount)
            log3(0x20, 0x20, _TRANSFER_EVENT_SIGNATURE, 0, shr(96, mload(0x0c)))
        }
        _afterTokenTransfer(address(0), to, amount);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                  INTERNAL BURN FUNCTIONS                   */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Burns `amount` tokens from `from`, reducing the total supply.
    ///
    /// Emits a {Transfer} event.
    function _burn(address from, uint256 amount) internal virtual {
        _beforeTokenTransfer(from, address(0), amount);
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the balance slot and load its value.
            mstore(0x0c, _BALANCE_SLOT_SEED)
            mstore(0x00, from)
            let fromBalanceSlot := keccak256(0x0c, 0x20)
            let fromBalance := sload(fromBalanceSlot)
            // Revert if insufficient balance.
            if gt(amount, fromBalance) {
                mstore(0x00, 0xf4d678b8) // `InsufficientBalance()`.
                revert(0x1c, 0x04)
            }
            // Subtract and store the updated balance.
            sstore(fromBalanceSlot, sub(fromBalance, amount))
            // Subtract and store the updated total supply.
            sstore(_TOTAL_SUPPLY_SLOT, sub(sload(_TOTAL_SUPPLY_SLOT), amount))
            // Emit the {Transfer} event.
            mstore(0x00, amount)
            log3(0x00, 0x20, _TRANSFER_EVENT_SIGNATURE, shr(96, shl(96, from)), 0)
        }
        _afterTokenTransfer(from, address(0), amount);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                INTERNAL TRANSFER FUNCTIONS                 */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Moves `amount` of tokens from `from` to `to`.
    function _transfer(address from, address to, uint256 amount) internal virtual {
        _beforeTokenTransfer(from, to, amount);
        /// @solidity memory-safe-assembly
        assembly {
            let from_ := shl(96, from)
            // Compute the balance slot and load its value.
            mstore(0x0c, or(from_, _BALANCE_SLOT_SEED))
            let fromBalanceSlot := keccak256(0x0c, 0x20)
            let fromBalance := sload(fromBalanceSlot)
            // Revert if insufficient balance.
            if gt(amount, fromBalance) {
                mstore(0x00, 0xf4d678b8) // `InsufficientBalance()`.
                revert(0x1c, 0x04)
            }
            // Subtract and store the updated balance.
            sstore(fromBalanceSlot, sub(fromBalance, amount))
            // Compute the balance slot of `to`.
            mstore(0x00, to)
            let toBalanceSlot := keccak256(0x0c, 0x20)
            // Add and store the updated balance of `to`.
            // Will not overflow because the sum of all user balances
            // cannot exceed the maximum uint256 value.
            sstore(toBalanceSlot, add(sload(toBalanceSlot), amount))
            // Emit the {Transfer} event.
            mstore(0x20, amount)
            log3(0x20, 0x20, _TRANSFER_EVENT_SIGNATURE, shr(96, from_), shr(96, mload(0x0c)))
        }
        _afterTokenTransfer(from, to, amount);
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                INTERNAL ALLOWANCE FUNCTIONS                */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Updates the allowance of `owner` for `spender` based on spent `amount`.
    function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {
        if (_givePermit2InfiniteAllowance()) {
            if (spender == _PERMIT2) return; // Do nothing, as allowance is infinite.
        }
        /// @solidity memory-safe-assembly
        assembly {
            // Compute the allowance slot and load its value.
            mstore(0x20, spender)
            mstore(0x0c, _ALLOWANCE_SLOT_SEED)
            mstore(0x00, owner)
            let allowanceSlot := keccak256(0x0c, 0x34)
            let allowance_ := sload(allowanceSlot)
            // If the allowance is not the maximum uint256 value.
            if not(allowance_) {
                // Revert if the amount to be transferred exceeds the allowance.
                if gt(amount, allowance_) {
                    mstore(0x00, 0x13be252b) // `InsufficientAllowance()`.
                    revert(0x1c, 0x04)
                }
                // Subtract and store the updated allowance.
                sstore(allowanceSlot, sub(allowance_, amount))
            }
        }
    }

    /// @dev Sets `amount` as the allowance of `spender` over the tokens of `owner`.
    ///
    /// Emits a {Approval} event.
    function _approve(address owner, address spender, uint256 amount) internal virtual {
        if (_givePermit2InfiniteAllowance()) {
            /// @solidity memory-safe-assembly
            assembly {
                // If `spender == _PERMIT2 && amount != type(uint256).max`.
                if iszero(or(xor(shr(96, shl(96, spender)), _PERMIT2), iszero(not(amount)))) {
                    mstore(0x00, 0x3f68539a) // `Permit2AllowanceIsFixedAtInfinity()`.
                    revert(0x1c, 0x04)
                }
            }
        }
        /// @solidity memory-safe-assembly
        assembly {
            let owner_ := shl(96, owner)
            // Compute the allowance slot and store the amount.
            mstore(0x20, spender)
            mstore(0x0c, or(owner_, _ALLOWANCE_SLOT_SEED))
            sstore(keccak256(0x0c, 0x34), amount)
            // Emit the {Approval} event.
            mstore(0x00, amount)
            log3(0x00, 0x20, _APPROVAL_EVENT_SIGNATURE, shr(96, owner_), shr(96, mload(0x2c)))
        }
    }

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                     HOOKS TO OVERRIDE                      */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Hook that is called before any transfer of tokens.
    /// This includes minting and burning.
    function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}

    /// @dev Hook that is called after any transfer of tokens.
    /// This includes minting and burning.
    function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}

    /*´:°•.°+.*•´.*:˚.°*.˚•´.°:°•.°•.*•´.*:˚.°*.˚•´.°:°•.°+.*•´.*:*/
    /*                          PERMIT2                           */
    /*.•°:°.´+˚.*°.˚:*.´•*.+°.•°:´*.´•*.•°.•°:°.´:•˚°.*°.˚:*.´+°.•*/

    /// @dev Returns whether to fix the Permit2 contract's allowance at infinity.
    ///
    /// This value should be kept constant after contract initialization,
    /// or else the actual allowance values may not match with the {Approval} events.
    /// For best performance, return a compile-time constant for zero-cost abstraction.
    function _givePermit2InfiniteAllowance() internal view virtual returns (bool) {
        return false;
    }
}

// src/OogaBuck.sol

contract OogaBuck is ERC20, Ownable, EnumerableRoles {
    error NonTransferrable();
    uint256 public constant MINTER_ROLE = 1;
    uint256 public constant BURNER_ROLE = 2;

    constructor(address _owner) {
        _initializeOwner(_owner);
    }

    function name() public pure override returns (string memory) {
        return "Ooga Buck";
    }

    function symbol() public pure override returns (string memory) {
        return "OOGABUCK";
    }

    function mint(
        address to,
        uint256 amount
    ) external onlyRoles(abi.encode(MINTER_ROLE)) {
        _mint(to, amount);
    }

    function burn(
        address to,
        uint256 amount
    ) external onlyRoles(abi.encode(BURNER_ROLE)) {
        _burn(to, amount);
    }

    function _beforeTokenTransfer(
        address from,
        address to,
        uint256
    ) internal pure override {
        // Makes the tokens only burnable and mintable
        if (from != address(0) && to != address(0)) {
            revert NonTransferrable();
        }
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[{"internalType":"address","name":"_owner","type":"address"}],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"AllowanceOverflow","type":"error"},{"inputs":[],"name":"AllowanceUnderflow","type":"error"},{"inputs":[],"name":"AlreadyInitialized","type":"error"},{"inputs":[],"name":"EnumerableRolesUnauthorized","type":"error"},{"inputs":[],"name":"InsufficientAllowance","type":"error"},{"inputs":[],"name":"InsufficientBalance","type":"error"},{"inputs":[],"name":"InvalidPermit","type":"error"},{"inputs":[],"name":"InvalidRole","type":"error"},{"inputs":[],"name":"NewOwnerIsZeroAddress","type":"error"},{"inputs":[],"name":"NoHandoverRequest","type":"error"},{"inputs":[],"name":"NonTransferrable","type":"error"},{"inputs":[],"name":"Permit2AllowanceIsFixedAtInfinity","type":"error"},{"inputs":[],"name":"PermitExpired","type":"error"},{"inputs":[],"name":"RoleHolderIsZeroAddress","type":"error"},{"inputs":[],"name":"RoleHoldersIndexOutOfBounds","type":"error"},{"inputs":[],"name":"TotalSupplyOverflow","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":"holder","type":"address"},{"indexed":true,"internalType":"uint256","name":"role","type":"uint256"},{"indexed":true,"internalType":"bool","name":"active","type":"bool"}],"name":"RoleSet","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"},{"inputs":[],"name":"BURNER_ROLE","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"DOMAIN_SEPARATOR","outputs":[{"internalType":"bytes32","name":"result","type":"bytes32"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"MINTER_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":"result","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":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","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":"view","type":"function"},{"inputs":[{"internalType":"address","name":"holder","type":"address"},{"internalType":"uint256","name":"role","type":"uint256"}],"name":"hasRole","outputs":[{"internalType":"bool","name":"result","type":"bool"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"mint","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"nonces","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"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":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"},{"internalType":"uint256","name":"deadline","type":"uint256"},{"internalType":"uint8","name":"v","type":"uint8"},{"internalType":"bytes32","name":"r","type":"bytes32"},{"internalType":"bytes32","name":"s","type":"bytes32"}],"name":"permit","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"requestOwnershipHandover","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[{"internalType":"uint256","name":"role","type":"uint256"},{"internalType":"uint256","name":"i","type":"uint256"}],"name":"roleHolderAt","outputs":[{"internalType":"address","name":"result","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"role","type":"uint256"}],"name":"roleHolderCount","outputs":[{"internalType":"uint256","name":"result","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"role","type":"uint256"}],"name":"roleHolders","outputs":[{"internalType":"address[]","name":"result","type":"address[]"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"holder","type":"address"},{"internalType":"uint256","name":"role","type":"uint256"},{"internalType":"bool","name":"active","type":"bool"}],"name":"setRole","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"pure","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"result","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"}]

0x6080604052348015600f57600080fd5b50604051611206380380611206833981016040819052602c916074565b6033816038565b5060a2565b6001600160a01b0316638b78c6d8198190558060007f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e08180a350565b600060208284031215608557600080fd5b81516001600160a01b0381168114609b57600080fd5b9392505050565b611155806100b16000396000f3fe6080604052600436106101b75760003560e01c8063715018a6116100ec578063d505accf1161008a578063e3b3ac4311610064578063e3b3ac43146104fe578063f04e283e1461051e578063f2fde38b14610531578063fee81cf41461054457600080fd5b8063d505accf14610493578063d5391393146104b3578063dd62ed3e146104c857600080fd5b80638da5cb5b116100c65780638da5cb5b146103f557806395d89b41146104225780639dc29fac14610453578063a9059cbb1461047357600080fd5b8063715018a61461038d5780637ecebe001461039557806384cc10c5146103c857600080fd5b80633644e5151161015957806354d1f13d1161013357806354d1f13d146103075780635978cd291461030f5780635c97f4a21461032257806370a082311461035a57600080fd5b80633644e5151461029957806340c10f19146102ae578063492ba875146102ce57600080fd5b806323b872dd1161019557806323b872dd1461023e578063256929621461025e578063282c51f314610268578063313ce5671461027d57600080fd5b806306fdde03146101bc578063095ea7b3146101e757806318160ddd14610217575b600080fd5b3480156101c857600080fd5b506101d1610577565b6040516101de9190610e9a565b60405180910390f35b3480156101f357600080fd5b50610207610202366004610f04565b61059a565b60405190151581526020016101de565b34801561022357600080fd5b506805345cdf77eb68f44c545b6040519081526020016101de565b34801561024a57600080fd5b50610207610259366004610f2e565b6105ed565b6102666106a2565b005b34801561027457600080fd5b50610230600281565b34801561028957600080fd5b50604051601281526020016101de565b3480156102a557600080fd5b506102306106f2565b3480156102ba57600080fd5b506102666102c9366004610f04565b61076f565b3480156102da57600080fd5b506102306102e9366004610f6b565b63ee9853bb600452600090815260249020546001600160601b031690565b6102666107a2565b61026661031d366004610f84565b6107de565b34801561032e57600080fd5b5061020761033d366004610f04565b60189190915263ee9853bb60045260009081526038902054151590565b34801561036657600080fd5b50610230610375366004610fc9565b6387a211a2600c908152600091909152602090205490565b6102666107f4565b3480156103a157600080fd5b506102306103b0366004610fc9565b6338377508600c908152600091909152602090205490565b3480156103d457600080fd5b506103e86103e3366004610f6b565b610808565b6040516101de9190610feb565b34801561040157600080fd5b50638b78c6d819545b6040516001600160a01b0390911681526020016101de565b34801561042e57600080fd5b506040805180820190915260088152674f4f47414255434b60c01b60208201526101d1565b34801561045f57600080fd5b5061026661046e366004610f04565b61086e565b34801561047f57600080fd5b5061020761048e366004610f04565b61089c565b34801561049f57600080fd5b506102666104ae366004611037565b610910565b3480156104bf57600080fd5b50610230600181565b3480156104d457600080fd5b506102306104e33660046110aa565b602052637f5e9f20600c908152600091909152603490205490565b34801561050a57600080fd5b5061040a6105193660046110dd565b610a9b565b61026661052c366004610fc9565b610ae8565b61026661053f366004610fc9565b610b28565b34801561055057600080fd5b5061023061055f366004610fc9565b63389a75e1600c908152600091909152602090205490565b6040805180820190915260098152684f6f6761204275636b60b81b602082015290565b600082602052637f5e9f20600c5233600052816034600c205581600052602c5160601c337f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560206000a350600192915050565b60006105fa848484610b4f565b8360601b33602052637f5e9f208117600c526034600c2080548019156106365780851115610630576313be252b6000526004601cfd5b84810382555b50506387a211a28117600c526020600c2080548085111561065f5763f4d678b86000526004601cfd5b84810382555050836000526020600c208381540181555082602052600c5160601c8160601c600080516020611100833981519152602080a3505060019392505050565b60006202a30067ffffffffffffffff164201905063389a75e1600c5233600052806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d600080a250565b6000806106fd610577565b805190602001209050604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f815260208101929092527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc69082015246606082015230608082015260a09020919050565b60408051600160208201520160405160208183030381529060405261079381610b8d565b61079d8383610ba3565b505050565b63389a75e1600c523360005260006020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92600080a2565b6107e9838383610c1c565b61079d838383610c30565b6107fc610d28565b6108066000610d43565b565b60405163ee9853bb6004526000828152602490208054606081901c602084019081526001916001600160601b0316905b81831015610859578284015460601c8360051b820152600183019250610838565b8185528160051b810160405250505050919050565b60408051600260208201520160405160208183030381529060405261089281610b8d565b61079d8383610d81565b60006108a9338484610b4f565b6387a211a2600c52336000526020600c208054808411156108d25763f4d678b86000526004601cfd5b83810382555050826000526020600c208281540181555081602052600c5160601c33600080516020611100833981519152602080a350600192915050565b600061091a610577565b8051906020012090507fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc64286101561095a57631a15a3cc6000526004601cfd5b6040518960601b60601c99508860601b60601c985065383775081901600e52896000526020600c2080547f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f835284602084015283604084015246606084015230608084015260a08320602e527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c983528b60208401528a60408401528960608401528060808401528860a084015260c08320604e526042602c206000528760ff1660205286604052856060526020806080600060015afa8c3d5114610a465763ddafbaef6000526004601cfd5b0190556303faf4f960a51b89176040526034602c20889055888a7f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925602060608501a36040525050600060605250505050505050565b63ee9853bb60045260008281526024812080546001600160601b0381168410610acc57635694da8e6000526004601cfd5b60601c91508215610ae1578281015460601c91505b5092915050565b610af0610d28565b63389a75e1600c52806000526020600c208054421115610b1857636f5e88186000526004601cfd5b60009055610b2581610d43565b50565b610b30610d28565b8060601b610b4657637448fbae6000526004601cfd5b610b2581610d43565b6001600160a01b03831615801590610b6f57506001600160a01b03821615155b1561079d5760405163bf9e1a7560e01b815260040160405180910390fd5b610b973382610df2565b610b2557610b25610e36565b610baf60008383610b4f565b6805345cdf77eb68f44c5481810181811015610bd35763e5cfe9576000526004601cfd5b806805345cdf77eb68f44c5550506387a211a2600c52816000526020600c208181540181555080602052600c5160601c6000600080516020611100833981519152602080a35050565b610c24610e44565b61079d5761079d610e36565b610c3982610e69565b8260601b80610c505763825501436000526004601cfd5b8360185263ee9853bb600452826000526024600020805460a01b60a01c6038600020805485610cd9578015610cf15760018303806001830314610cbc5784810180546bffffffffffffffffffffffff191683870160001901819055600091829055602452603890208290555b84546bffffffffffffffffffffffff191617845560008255610cf1565b80610cf1578483850155600183018255600184540184555b50505050811515838260601c7faddc47d7e02c95c00ec667676636d772a589ffbf0663cfd7cd4dd3d4758201b8600080a450505050565b638b78c6d819543314610806576382b429006000526004601cfd5b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a355565b610d8d82600083610b4f565b6387a211a2600c52816000526020600c20805480831115610db65763f4d678b86000526004601cfd5b82900390556805345cdf77eb68f44c8054829003905560008181526001600160a01b038316600080516020611100833981519152602083a35050565b60008260185263ee9853bb600452815160051c60051b82015b808310821015610e2d5782602001925082516000526038600020549150610e0b565b50151592915050565b6399152cca6000526004601cfd5b6000638da5cb5b600052602060006004601c305afa601f3d1160005133141616905090565b63d24f19d5600052602060006004601c305afa601f3d116000518311161615610b255763d954416a6000526004601cfd5b602081526000825180602084015260005b81811015610ec85760208186018101516040868401015201610eab565b506000604082850101526040601f19601f83011684010191505092915050565b80356001600160a01b0381168114610eff57600080fd5b919050565b60008060408385031215610f1757600080fd5b610f2083610ee8565b946020939093013593505050565b600080600060608486031215610f4357600080fd5b610f4c84610ee8565b9250610f5a60208501610ee8565b929592945050506040919091013590565b600060208284031215610f7d57600080fd5b5035919050565b600080600060608486031215610f9957600080fd5b610fa284610ee8565b92506020840135915060408401358015158114610fbe57600080fd5b809150509250925092565b600060208284031215610fdb57600080fd5b610fe482610ee8565b9392505050565b602080825282518282018190526000918401906040840190835b8181101561102c5783516001600160a01b0316835260209384019390920191600101611005565b509095945050505050565b600080600080600080600060e0888a03121561105257600080fd5b61105b88610ee8565b965061106960208901610ee8565b95506040880135945060608801359350608088013560ff8116811461108d57600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156110bd57600080fd5b6110c683610ee8565b91506110d460208401610ee8565b90509250929050565b600080604083850312156110f057600080fd5b5050803592602090910135915056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212206c76584701cb087041fa4d91f984eea18ccfc70cb6ec5493f7939be29d249ebb64736f6c634300081b003300000000000000000000000089f69aea6529d46da0543de29f9a6743a2022b89

0x6080604052600436106101b75760003560e01c8063715018a6116100ec578063d505accf1161008a578063e3b3ac4311610064578063e3b3ac43146104fe578063f04e283e1461051e578063f2fde38b14610531578063fee81cf41461054457600080fd5b8063d505accf14610493578063d5391393146104b3578063dd62ed3e146104c857600080fd5b80638da5cb5b116100c65780638da5cb5b146103f557806395d89b41146104225780639dc29fac14610453578063a9059cbb1461047357600080fd5b8063715018a61461038d5780637ecebe001461039557806384cc10c5146103c857600080fd5b80633644e5151161015957806354d1f13d1161013357806354d1f13d146103075780635978cd291461030f5780635c97f4a21461032257806370a082311461035a57600080fd5b80633644e5151461029957806340c10f19146102ae578063492ba875146102ce57600080fd5b806323b872dd1161019557806323b872dd1461023e578063256929621461025e578063282c51f314610268578063313ce5671461027d57600080fd5b806306fdde03146101bc578063095ea7b3146101e757806318160ddd14610217575b600080fd5b3480156101c857600080fd5b506101d1610577565b6040516101de9190610e9a565b60405180910390f35b3480156101f357600080fd5b50610207610202366004610f04565b61059a565b60405190151581526020016101de565b34801561022357600080fd5b506805345cdf77eb68f44c545b6040519081526020016101de565b34801561024a57600080fd5b50610207610259366004610f2e565b6105ed565b6102666106a2565b005b34801561027457600080fd5b50610230600281565b34801561028957600080fd5b50604051601281526020016101de565b3480156102a557600080fd5b506102306106f2565b3480156102ba57600080fd5b506102666102c9366004610f04565b61076f565b3480156102da57600080fd5b506102306102e9366004610f6b565b63ee9853bb600452600090815260249020546001600160601b031690565b6102666107a2565b61026661031d366004610f84565b6107de565b34801561032e57600080fd5b5061020761033d366004610f04565b60189190915263ee9853bb60045260009081526038902054151590565b34801561036657600080fd5b50610230610375366004610fc9565b6387a211a2600c908152600091909152602090205490565b6102666107f4565b3480156103a157600080fd5b506102306103b0366004610fc9565b6338377508600c908152600091909152602090205490565b3480156103d457600080fd5b506103e86103e3366004610f6b565b610808565b6040516101de9190610feb565b34801561040157600080fd5b50638b78c6d819545b6040516001600160a01b0390911681526020016101de565b34801561042e57600080fd5b506040805180820190915260088152674f4f47414255434b60c01b60208201526101d1565b34801561045f57600080fd5b5061026661046e366004610f04565b61086e565b34801561047f57600080fd5b5061020761048e366004610f04565b61089c565b34801561049f57600080fd5b506102666104ae366004611037565b610910565b3480156104bf57600080fd5b50610230600181565b3480156104d457600080fd5b506102306104e33660046110aa565b602052637f5e9f20600c908152600091909152603490205490565b34801561050a57600080fd5b5061040a6105193660046110dd565b610a9b565b61026661052c366004610fc9565b610ae8565b61026661053f366004610fc9565b610b28565b34801561055057600080fd5b5061023061055f366004610fc9565b63389a75e1600c908152600091909152602090205490565b6040805180820190915260098152684f6f6761204275636b60b81b602082015290565b600082602052637f5e9f20600c5233600052816034600c205581600052602c5160601c337f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92560206000a350600192915050565b60006105fa848484610b4f565b8360601b33602052637f5e9f208117600c526034600c2080548019156106365780851115610630576313be252b6000526004601cfd5b84810382555b50506387a211a28117600c526020600c2080548085111561065f5763f4d678b86000526004601cfd5b84810382555050836000526020600c208381540181555082602052600c5160601c8160601c600080516020611100833981519152602080a3505060019392505050565b60006202a30067ffffffffffffffff164201905063389a75e1600c5233600052806020600c2055337fdbf36a107da19e49527a7176a1babf963b4b0ff8cde35ee35d6cd8f1f9ac7e1d600080a250565b6000806106fd610577565b805190602001209050604080517f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f815260208101929092527fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc69082015246606082015230608082015260a09020919050565b60408051600160208201520160405160208183030381529060405261079381610b8d565b61079d8383610ba3565b505050565b63389a75e1600c523360005260006020600c2055337ffa7b8eab7da67f412cc9575ed43464468f9bfbae89d1675917346ca6d8fe3c92600080a2565b6107e9838383610c1c565b61079d838383610c30565b6107fc610d28565b6108066000610d43565b565b60405163ee9853bb6004526000828152602490208054606081901c602084019081526001916001600160601b0316905b81831015610859578284015460601c8360051b820152600183019250610838565b8185528160051b810160405250505050919050565b60408051600260208201520160405160208183030381529060405261089281610b8d565b61079d8383610d81565b60006108a9338484610b4f565b6387a211a2600c52336000526020600c208054808411156108d25763f4d678b86000526004601cfd5b83810382555050826000526020600c208281540181555081602052600c5160601c33600080516020611100833981519152602080a350600192915050565b600061091a610577565b8051906020012090507fc89efdaa54c0f20c7adf612882df0950f5a951637e0307cdcb4c672f298b8bc64286101561095a57631a15a3cc6000526004601cfd5b6040518960601b60601c99508860601b60601c985065383775081901600e52896000526020600c2080547f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f835284602084015283604084015246606084015230608084015260a08320602e527f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c983528b60208401528a60408401528960608401528060808401528860a084015260c08320604e526042602c206000528760ff1660205286604052856060526020806080600060015afa8c3d5114610a465763ddafbaef6000526004601cfd5b0190556303faf4f960a51b89176040526034602c20889055888a7f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925602060608501a36040525050600060605250505050505050565b63ee9853bb60045260008281526024812080546001600160601b0381168410610acc57635694da8e6000526004601cfd5b60601c91508215610ae1578281015460601c91505b5092915050565b610af0610d28565b63389a75e1600c52806000526020600c208054421115610b1857636f5e88186000526004601cfd5b60009055610b2581610d43565b50565b610b30610d28565b8060601b610b4657637448fbae6000526004601cfd5b610b2581610d43565b6001600160a01b03831615801590610b6f57506001600160a01b03821615155b1561079d5760405163bf9e1a7560e01b815260040160405180910390fd5b610b973382610df2565b610b2557610b25610e36565b610baf60008383610b4f565b6805345cdf77eb68f44c5481810181811015610bd35763e5cfe9576000526004601cfd5b806805345cdf77eb68f44c5550506387a211a2600c52816000526020600c208181540181555080602052600c5160601c6000600080516020611100833981519152602080a35050565b610c24610e44565b61079d5761079d610e36565b610c3982610e69565b8260601b80610c505763825501436000526004601cfd5b8360185263ee9853bb600452826000526024600020805460a01b60a01c6038600020805485610cd9578015610cf15760018303806001830314610cbc5784810180546bffffffffffffffffffffffff191683870160001901819055600091829055602452603890208290555b84546bffffffffffffffffffffffff191617845560008255610cf1565b80610cf1578483850155600183018255600184540184555b50505050811515838260601c7faddc47d7e02c95c00ec667676636d772a589ffbf0663cfd7cd4dd3d4758201b8600080a450505050565b638b78c6d819543314610806576382b429006000526004601cfd5b638b78c6d81980546001600160a01b039092169182907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0600080a355565b610d8d82600083610b4f565b6387a211a2600c52816000526020600c20805480831115610db65763f4d678b86000526004601cfd5b82900390556805345cdf77eb68f44c8054829003905560008181526001600160a01b038316600080516020611100833981519152602083a35050565b60008260185263ee9853bb600452815160051c60051b82015b808310821015610e2d5782602001925082516000526038600020549150610e0b565b50151592915050565b6399152cca6000526004601cfd5b6000638da5cb5b600052602060006004601c305afa601f3d1160005133141616905090565b63d24f19d5600052602060006004601c305afa601f3d116000518311161615610b255763d954416a6000526004601cfd5b602081526000825180602084015260005b81811015610ec85760208186018101516040868401015201610eab565b506000604082850101526040601f19601f83011684010191505092915050565b80356001600160a01b0381168114610eff57600080fd5b919050565b60008060408385031215610f1757600080fd5b610f2083610ee8565b946020939093013593505050565b600080600060608486031215610f4357600080fd5b610f4c84610ee8565b9250610f5a60208501610ee8565b929592945050506040919091013590565b600060208284031215610f7d57600080fd5b5035919050565b600080600060608486031215610f9957600080fd5b610fa284610ee8565b92506020840135915060408401358015158114610fbe57600080fd5b809150509250925092565b600060208284031215610fdb57600080fd5b610fe482610ee8565b9392505050565b602080825282518282018190526000918401906040840190835b8181101561102c5783516001600160a01b0316835260209384019390920191600101611005565b509095945050505050565b600080600080600080600060e0888a03121561105257600080fd5b61105b88610ee8565b965061106960208901610ee8565b95506040880135945060608801359350608088013560ff8116811461108d57600080fd5b9699959850939692959460a0840135945060c09093013592915050565b600080604083850312156110bd57600080fd5b6110c683610ee8565b91506110d460208401610ee8565b90509250929050565b600080604083850312156110f057600080fd5b5050803592602090910135915056feddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3efa26469706673582212206c76584701cb087041fa4d91f984eea18ccfc70cb6ec5493f7939be29d249ebb64736f6c634300081b0033

58037:1082:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;58301:98;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;34606:1052;;;;;;;;;;-1:-1:-1;34606:1052:0;;;;;:::i;:::-;;:::i;:::-;;;1194:14:1;;1187:22;1169:41;;1157:2;1142:18;34606:1052:0;1029:187:1;33299:200:0;;;;;;;;;;-1:-1:-1;33462:18:0;33456:25;33299:200;;;1367:25:1;;;1355:2;1340:18;33299:200:0;1221:177:1;37667:4843:0;;;;;;;;;;-1:-1:-1;37667:4843:0;;;;;:::i;:::-;;:::i;22649:630::-;;;:::i;:::-;;58174:39;;;;;;;;;;;;58212:1;58174:39;;32863:84;;;;;;;;;;-1:-1:-1;32863:84:0;;32937:2;1924:36:1;;1912:2;1897:18;32863:84:0;1782:184:1;48175:752:0;;;;;;;;;;;;;:::i;58514:147::-;;;;;;;;;;-1:-1:-1;58514:147:0;;;;;:::i;:::-;;:::i;5646:326::-;;;;;;;;;;-1:-1:-1;5646:326:0;;;;;:::i;:::-;5822:27;5816:4;5809:41;5714:14;5864:18;;;5946:4;5930:21;;5924:28;-1:-1:-1;;;;;5906:48:0;;5646:326;23364:466;;;:::i;3862:182::-;;;;;;:::i;:::-;;:::i;4392:361::-;;;;;;;;;;-1:-1:-1;4392:361:0;;;;;:::i;:::-;4567:4;4560:20;;;;4607:27;4601:4;4594:41;4468:11;4649:18;;;4727:4;4711:21;;4705:28;4698:36;4691:44;;4392:361;33568:293;;;;;;;;;;-1:-1:-1;33568:293:0;;;;;:::i;:::-;33739:18;33733:4;33726:32;;;33631:14;33772:19;;;;33837:4;33821:21;;33815:28;;33568:293;22384:102;;;:::i;43757:348::-;;;;;;;;;;-1:-1:-1;43757:348:0;;;;;:::i;:::-;43984:17;43978:4;43971:31;;;43817:14;44016:19;;;;44081:4;44065:21;;44059:28;;43757:348;4818:759;;;;;;;;;;-1:-1:-1;4818:759:0;;;;;:::i;:::-;;:::i;:::-;;;;;;;:::i;25089:187::-;;;;;;;;;;-1:-1:-1;;;25240:18:0;25089:187;;;-1:-1:-1;;;;;3855:32:1;;;3837:51;;3825:2;3810:18;25089:187:0;3691:203:1;58407:99:0;;;;;;;;;;-1:-1:-1;58481:17:0;;;;;;;;;;;;-1:-1:-1;;;58481:17:0;;;;58407:99;;58669:147;;;;;;;;;;-1:-1:-1;58669:147:0;;;;;:::i;:::-;;:::i;35853:1435::-;;;;;;;;;;-1:-1:-1;35853:1435:0;;;;;:::i;:::-;;:::i;44295:3796::-;;;;;;;;;;-1:-1:-1;44295:3796:0;;;;;:::i;:::-;;:::i;58128:39::-;;;;;;;;;;;;58166:1;58128:39;;33959:511;;;;;;;;;;-1:-1:-1;33959:511:0;;;;;:::i;:::-;34305:4;34298:21;34346:20;34340:4;34333:34;;;34388:4;34381:19;;;;34446:4;34430:21;;34424:28;;33959:511;6041:661;;;;;;;;;;-1:-1:-1;6041:661:0;;;;;:::i;:::-;;:::i;24021:724::-;;;;;;:::i;:::-;;:::i;21958:358::-;;;;;;:::i;:::-;;:::i;25382:449::-;;;;;;;;;;-1:-1:-1;25382:449:0;;;;;:::i;:::-;25661:19;25655:4;25648:33;;;25505:14;25695:26;;;;25807:4;25791:21;;25785:28;;25382:449;58301:98;58373:18;;;;;;;;;;;;-1:-1:-1;;;58373:18:0;;;;;58301:98::o;34606:1052::-;34680:4;35309:7;35303:4;35296:21;35344:20;35338:4;35331:34;35392:8;35386:4;35379:22;35445:6;35438:4;35432;35422:21;35415:37;35522:6;35516:4;35509:20;35611:4;35605:11;35601:2;35597:20;35587:8;35560:25;35554:4;35548;35543:75;-1:-1:-1;35646:4:0;34606:1052;;;;:::o;37667:4843::-;37755:4;37772:38;37793:4;37799:2;37803:6;37772:20;:38::i;:::-;40362:4;40358:2;40354:13;40465:8;40459:4;40452:22;40515:20;40508:5;40505:31;40499:4;40492:45;40592:4;40586;40576:21;40639:13;40633:20;40749:10;40745:15;40742:455;;;40884:10;40876:6;40873:22;40870:174;;;40936:10;40930:4;40923:24;41016:4;41010;41003:18;40870:174;41170:6;41158:10;41154:23;41139:13;41132:46;40742:455;;;41303:18;41296:5;41293:29;41287:4;41280:43;41380:4;41374;41364:21;41428:15;41422:22;41528:11;41520:6;41517:23;41514:161;;;41577:10;41571:4;41564:24;41651:4;41645;41638:18;41514:161;41794:6;41781:11;41777:24;41760:15;41753:49;;;41887:2;41881:4;41874:16;41945:4;41939;41929:21;42215:6;42199:13;42193:20;42189:33;42174:13;42167:56;;42301:6;42295:4;42288:20;42400:4;42394:11;42390:2;42386:20;42378:5;42374:2;42370:14;-1:-1:-1;;;;;;;;;;;42337:4:0;42331;42326:81;;-1:-1:-1;42498:4:0;37667:4843;;;;;:::o;22649:630::-;22744:15;21574:9;22762:46;;:15;:46;22744:64;;22980:19;22974:4;22967:33;23031:8;23025:4;23018:22;23088:7;23081:4;23075;23065:21;23058:38;23237:8;23190:45;23187:1;23184;23179:67;22880:381;22649:630::o;48175:752::-;48232:14;;48458:6;:4;:6::i;:::-;48442:24;;;;;;48431:35;;48607:4;48601:11;;48669:16;48659:27;;48714:4;48707:12;;48700:30;;;;31536:66;48751:12;;;48744:33;48812:9;48805:4;48798:12;;48791:31;48857:9;48850:4;48843:12;;48836:31;48904:4;48891:18;;;;-1:-1:-1;48175:752:0:o;58514:147::-;58600:23;;;58166:1;58600:23;;;1367:25:1;1340:18;58600:23:0;;;;;;;;;;;;11826:25;11838:12;11826:11;:25::i;:::-;58636:17:::1;58642:2;58646:6;58636:5;:17::i;:::-;58514:147:::0;;;:::o;23364:466::-;23570:19;23564:4;23557:33;23617:8;23611:4;23604:22;23670:1;23663:4;23657;23647:21;23640:32;23803:8;23757:44;23754:1;23751;23746:66;23364:466::o;3862:182::-;3956:39;3974:6;3982:4;3988:6;3956:17;:39::i;:::-;4006:30;4015:6;4023:4;4029:6;4006:8;:30::i;22384:102::-;26228:13;:11;:13::i;:::-;22457:21:::1;22475:1;22457:9;:21::i;:::-;22384:102::o:0;4818:759::-;5002:4;4996:11;5034:27;5028:4;5021:41;5083:4;5076:18;;;5140:4;5124:21;;5177:15;;4882:23;5309:19;;;-1:-1:-1;5268:17:0;;5299:30;;;5358:1;;-1:-1:-1;;;;;5215:30:0;;5343:140;5368:1;5365;5362:8;5343:140;;;5463:1;5453:8;5449:16;5443:23;5439:2;5435:32;5430:1;5427;5423:9;5420:1;5416:17;5409:59;5385:1;5382;5378:9;5373:14;;5343:140;;;5512:1;5504:6;5497:17;5555:1;5552;5548:9;5545:1;5541:17;5535:4;5528:31;;;;;4818:759;;;:::o;58669:147::-;58755:23;;;58212:1;58755:23;;;1367:25:1;1340:18;58755:23:0;;;;;;;;;;;;11826:25;11838:12;11826:11;:25::i;:::-;58791:17:::1;58797:2;58801:6;58791:5;:17::i;35853:1435::-:0;35923:4;35940:44;35961:10;35973:2;35977:6;35940:20;:44::i;:::-;36137:18;36131:4;36124:32;36183:8;36177:4;36170:22;36245:4;36239;36229:21;36289:15;36283:22;36381:11;36373:6;36370:23;36367:149;;;36426:10;36420:4;36413:24;36496:4;36490;36483:18;36367:149;36627:6;36614:11;36610:24;36593:15;36586:49;;;36712:2;36706:4;36699:16;36766:4;36760;36750:21;37020:6;37004:13;36998:20;36994:33;36979:13;36972:56;;37098:6;37092:4;37085:20;37187:4;37181:11;37177:2;37173:20;37163:8;-1:-1:-1;;;;;;;;;;;37130:4:0;37124;37119:75;-1:-1:-1;37276:4:0;35853:1435;;;;:::o;44295:3796::-;44967:16;45166:6;:4;:6::i;:::-;45150:24;;;;;;45139:35;;31536:66;45380:11;45377:25;-1:-1:-1;45374:145:0;;;45435:10;45429:4;45422:24;45499:4;45493;45486:18;45374:145;45548:4;45542:11;45666:5;45662:2;45658:14;45654:2;45650:23;45641:32;;45714:7;45710:2;45706:16;45702:2;45698:25;45687:36;;45809:39;45803:4;45796:53;45876:5;45870:4;45863:19;45929:4;45923;45913:21;45972:9;45966:16;46052;46049:1;46042:27;46104:8;46097:4;46094:1;46090:12;46083:30;46148:11;46141:4;46138:1;46134:12;46127:33;46195:9;46188:4;46185:1;46181:12;46174:31;46240:9;46233:4;46230:1;46226:12;46219:31;46290:4;46287:1;46277:18;46271:4;46264:32;46361:16;46358:1;46351:27;46413:5;46406:4;46403:1;46399:12;46392:27;46454:7;46447:4;46444:1;46440:12;46433:29;46497:5;46490:4;46487:1;46483:12;46476:27;46538:10;46531:4;46528:1;46524:12;46517:32;46584:8;46577:4;46574:1;46570:12;46563:30;46633:4;46630:1;46620:18;46614:4;46607:32;46730:4;46724;46714:21;46708:4;46701:35;46773:1;46767:4;46763:12;46757:4;46750:26;46803:1;46797:4;46790:15;46832:1;46826:4;46819:15;46896:4;46890;46884;46878;46875:1;46868:5;46857:44;47323:5;47304:16;47298:23;47295:34;47285:162;;47363:10;47357:4;47350:24;47427:4;47421;47414:18;47285:162;47534:18;47516:37;;-1:-1:-1;;;47732:43:0;;47726:4;47719:57;47813:4;47807;47797:21;47790:36;;;47767:7;47935:5;47908:25;-1:-1:-1;47895:4:0;47888:12;;47883:67;47971:4;47964:15;-1:-1:-1;;48042:1:0;48036:4;48029:15;-1:-1:-1;;;;;;;44295:3796:0:o;6041:661::-;6225:27;6219:4;6212:41;6117:14;6267:18;;;6331:4;6315:21;;6368:15;;-1:-1:-1;;;;;6413:30:0;;6407:37;;6397:179;;6478:10;6472:4;6465:24;6556:4;6550;6543:18;6397:179;6604:2;6600:19;;-1:-1:-1;6633:51:0;;;;6678:1;6668:8;6664:16;6658:23;6654:2;6650:32;6640:42;;6633:51;;6041:661;;;;:::o;24021:724::-;26228:13;:11;:13::i;:::-;24259:19:::1;24253:4;24246:33;24306:12;24300:4;24293:26;24369:4;24363;24353:21;24477:12;24471:19;24458:11;24455:36;24452:160;;;24524:10;24518:4;24511:24;24592:4;24586;24579:18;24452:160;24691:1;24670:23:::0;;24714::::1;24724:12:::0;24714:9:::1;:23::i;:::-;24021:724:::0;:::o;21958:358::-;26228:13;:11;:13::i;:::-;22133:8:::1;22129:2;22125:17;22115:153;;22176:10;22170:4;22163:24;22248:4;22242;22235:18;22115:153;22289:19;22299:8;22289:9;:19::i;58824:292::-:0;-1:-1:-1;;;;;59017:18:0;;;;;;:38;;-1:-1:-1;;;;;;59039:16:0;;;;59017:38;59013:96;;;59079:18;;-1:-1:-1;;;59079:18:0;;;;;;;;;;;10887:170;10973:38;10986:10;10998:12;10973;:38::i;:::-;10968:81;;11013:36;:34;:36::i;49340:1196::-;49411:44;49440:1;49444:2;49448:6;49411:20;:44::i;:::-;49565:18;49559:25;49645:6;49626:17;49622:30;49744:17;49726:16;49723:39;49720:165;;;49795:10;49789:4;49782:24;49865:4;49859;49852:18;49720:165;49974:16;49954:18;49947:44;;;50079:18;50073:4;50066:32;50125:2;50119:4;50112:16;50179:4;50173;50163:21;50297:6;50281:13;50275:20;50271:33;50256:13;50249:56;;50375:6;50369:4;50362:20;50457:4;50451:11;50447:2;50443:20;50440:1;-1:-1:-1;;;;;;;;;;;50407:4:0;50401;50396:68;49340:1196;;:::o;9676:289::-;9779:24;:22;:24::i;:::-;9774:67;;9805:36;:34;:36::i;7073:1899::-;7162:19;7176:4;7162:13;:19::i;:::-;7283:6;7279:2;7275:15;7314:7;7304:145;;7355:10;7349:4;7342:24;7429:4;7423;7416:18;7304:145;7476:6;7470:4;7463:20;7510:27;7504:4;7497:41;7565:4;7559;7552:18;7616:4;7610;7600:21;7668:8;7662:15;7657:3;7653:25;7648:3;7644:35;7729:4;7723;7713:21;7770:12;7764:19;7838:6;7828:710;;7879:8;7869:29;7891:5;7869:29;7939:1;7936;7932:9;7994:4;7990:1;7980:8;7976:16;7973:26;7963:401;;8069:19;;;8063:26;;-1:-1:-1;;8047:44:0;8124:31;;;-1:-1:-1;;8124:31:0;8117:52;;;8223:1;8195:30;;;;8258:4;8251:25;8325:4;8309:21;;8302:39;;;7963:401;8422:15;;-1:-1:-1;;8406:33:0;8403:43;8386:61;;-1:-1:-1;8469:23:0;;8514:5;;7828:710;8566:8;8556:211;;8624:7;8620:1;8610:8;8606:16;8599:33;8682:1;8679;8675:9;8661:12;8654:31;8745:1;8734:8;8728:15;8724:23;8714:8;8707:41;8556:211;7801:2;;;;8945:6;8938:14;8931:22;8925:4;8915:7;8911:2;8907:16;8880:25;8874:4;8868;8863:91;;7073:1899;;;:::o;20879:364::-;-1:-1:-1;;21089:18:0;21079:8;21076:32;21066:159;;21142:10;21136:4;21129:24;21205:4;21199;21192:18;19705:1113;-1:-1:-1;;20672:16:0;;-1:-1:-1;;;;;20518:26:0;;;;;;20632:38;20629:1;;20621:78;20758:27;19705:1113::o;50951:1142::-;51024:46;51045:4;51059:1;51063:6;51024:20;:46::i;:::-;51223:18;51217:4;51210:32;51269:4;51263;51256:18;51327:4;51321;51311:21;51371:15;51365:22;51463:11;51455:6;51452:23;51449:149;;;51508:10;51502:4;51495:24;51578:4;51572;51565:18;51449:149;51692:24;;;51668:49;;51829:18;51823:25;;51819:38;;;51792:66;;-1:-1:-1;51915:20:0;;;-1:-1:-1;;;;;51993:22:0;;-1:-1:-1;;;;;;;;;;;51960:4:0;-1:-1:-1;51949:70:0;49340:1196;;:::o;10116:685::-;10248:11;10358:6;10352:4;10345:20;10392:27;10386:4;10379:41;10483:12;10477:19;10474:1;10470:27;10467:1;10463:35;10449:12;10445:54;10513:224;10548:3;10534:12;10531:21;10523:6;10520:33;10513:224;;;10602:12;10596:4;10592:23;10576:39;;10652:12;10646:19;10640:4;10633:33;10716:4;10710;10700:21;10694:28;10684:38;;10513:224;;;-1:-1:-1;10768:14:0;10761:22;;10116:685;-1:-1:-1;;10116:685:0:o;13204:248::-;13355:10;13349:4;13342:24;13429:4;13423;13416:18;12713:423;12769:11;12874:10;12868:4;12861:24;13094:4;13088;13082;13076;13065:9;13058:5;13047:52;13018:4;13000:16;12997:26;12989:4;12983:11;12973:8;12970:25;12966:58;12940:178;12913:205;;12713:423;:::o;9109:491::-;9260:10;9254:4;9247:24;9447:4;9441;9435;9429;9418:9;9411:5;9400:52;9375:4;9357:16;9354:26;9346:4;9340:11;9334:4;9331:21;9327:54;9305:162;9302:280;;;9500:10;9494:4;9487:24;9562:4;9556;9549:18;14:527:1;163:2;152:9;145:21;126:4;195:6;189:13;238:6;233:2;222:9;218:18;211:34;263:1;273:140;287:6;284:1;281:13;273:140;;;398:2;382:14;;;378:23;;372:30;367:2;348:17;;;344:26;337:66;302:10;273:140;;;277:3;462:1;457:2;448:6;437:9;433:22;429:31;422:42;532:2;525;521:7;516:2;508:6;504:15;500:29;489:9;485:45;481:54;473:62;;;14:527;;;;:::o;546:173::-;614:20;;-1:-1:-1;;;;;663:31:1;;653:42;;643:70;;709:1;706;699:12;643:70;546:173;;;:::o;724:300::-;792:6;800;853:2;841:9;832:7;828:23;824:32;821:52;;;869:1;866;859:12;821:52;892:29;911:9;892:29;:::i;:::-;882:39;990:2;975:18;;;;962:32;;-1:-1:-1;;;724:300:1:o;1403:374::-;1480:6;1488;1496;1549:2;1537:9;1528:7;1524:23;1520:32;1517:52;;;1565:1;1562;1555:12;1517:52;1588:29;1607:9;1588:29;:::i;:::-;1578:39;;1636:38;1670:2;1659:9;1655:18;1636:38;:::i;:::-;1403:374;;1626:48;;-1:-1:-1;;;1743:2:1;1728:18;;;;1715:32;;1403:374::o;2153:226::-;2212:6;2265:2;2253:9;2244:7;2240:23;2236:32;2233:52;;;2281:1;2278;2271:12;2233:52;-1:-1:-1;2326:23:1;;2153:226;-1:-1:-1;2153:226:1:o;2384:469::-;2458:6;2466;2474;2527:2;2515:9;2506:7;2502:23;2498:32;2495:52;;;2543:1;2540;2533:12;2495:52;2566:29;2585:9;2566:29;:::i;:::-;2556:39;-1:-1:-1;2664:2:1;2649:18;;2636:32;;-1:-1:-1;2744:2:1;2729:18;;2716:32;2786:15;;2779:23;2767:36;;2757:64;;2817:1;2814;2807:12;2757:64;2840:7;2830:17;;;2384:469;;;;;:::o;2858:186::-;2917:6;2970:2;2958:9;2949:7;2945:23;2941:32;2938:52;;;2986:1;2983;2976:12;2938:52;3009:29;3028:9;3009:29;:::i;:::-;2999:39;2858:186;-1:-1:-1;;;2858:186:1:o;3049:637::-;3239:2;3251:21;;;3321:13;;3224:18;;;3343:22;;;3191:4;;3422:15;;;3396:2;3381:18;;;3191:4;3465:195;3479:6;3476:1;3473:13;3465:195;;;3544:13;;-1:-1:-1;;;;;3540:39:1;3528:52;;3609:2;3635:15;;;;3600:12;;;;3576:1;3494:9;3465:195;;;-1:-1:-1;3677:3:1;;3049:637;-1:-1:-1;;;;;3049:637:1:o;3899:903::-;4010:6;4018;4026;4034;4042;4050;4058;4111:3;4099:9;4090:7;4086:23;4082:33;4079:53;;;4128:1;4125;4118:12;4079:53;4151:29;4170:9;4151:29;:::i;:::-;4141:39;;4199:38;4233:2;4222:9;4218:18;4199:38;:::i;:::-;4189:48;-1:-1:-1;4306:2:1;4291:18;;4278:32;;-1:-1:-1;4407:2:1;4392:18;;4379:32;;-1:-1:-1;4489:3:1;4474:19;;4461:33;4538:4;4525:18;;4513:31;;4503:59;;4558:1;4555;4548:12;4503:59;3899:903;;;;-1:-1:-1;3899:903:1;;;;4581:7;4661:3;4646:19;;4633:33;;-1:-1:-1;4765:3:1;4750:19;;;4737:33;;3899:903;-1:-1:-1;;3899:903:1:o;4807:260::-;4875:6;4883;4936:2;4924:9;4915:7;4911:23;4907:32;4904:52;;;4952:1;4949;4942:12;4904:52;4975:29;4994:9;4975:29;:::i;:::-;4965:39;;5023:38;5057:2;5046:9;5042:18;5023:38;:::i;:::-;5013:48;;4807:260;;;;;:::o;5072:346::-;5140:6;5148;5201:2;5189:9;5180:7;5176:23;5172:32;5169:52;;;5217:1;5214;5207:12;5169:52;-1:-1:-1;;5262:23:1;;;5382:2;5367:18;;;5354:32;;-1:-1:-1;5072:346:1:o

ipfs://6c76584701cb087041fa4d91f984eea18ccfc70cb6ec5493f7939be29d249ebb