Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta
• Remix IDE

More Options

• Similar
• Sol2Uml
• Submit Audit
• Compare

/**
 *Submitted for verification at Etherscan.io on 2024-03-18
*/

// File: third_party/arbitrum/ICustomToken.sol



/*
 * Copyright 2020, Offchain Labs, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

// solhint-disable-next-line compiler-version
pragma solidity >=0.6.9 <0.9.0;

interface ArbitrumEnabledToken {
    /// @notice should return `0xb1` if token is enabled for arbitrum gateways
    /// @dev Previous implmentation used to return `uint8(0xa4b1)`, however that causes compile time error in Solidity 0.8. due to type mismatch.
    ///      In current version `uint8(0xb1)` shall be returned, which results in no change as that's the same value as truncated `uint8(0xa4b1)`.
    function isArbitrumEnabled() external view returns (uint8);
}

/**
 * @title Minimum expected interface for L1 custom token (see TestCustomTokenL1.sol for an example implementation)
 */
interface ICustomToken is ArbitrumEnabledToken {
    /**
     * @notice Should make an external call to EthERC20Bridge.registerCustomL2Token
     */
    function registerTokenOnL2(
        address l2CustomTokenAddress,
        uint256 maxSubmissionCostForCustomBridge,
        uint256 maxSubmissionCostForRouter,
        uint256 maxGasForCustomBridge,
        uint256 maxGasForRouter,
        uint256 gasPriceBid,
        uint256 valueForGateway,
        uint256 valueForRouter,
        address creditBackAddress
    ) external payable;

    function transferFrom(
        address sender,
        address recipient,
        uint256 amount
    ) external returns (bool);

    function balanceOf(address account) external view returns (uint256);
}

interface L1MintableToken is ICustomToken {
    function bridgeMint(address account, uint256 amount) external;
}

interface L1ReverseToken is L1MintableToken {
    function bridgeBurn(address account, uint256 amount) external;
}
// File: @openzeppelin/contracts/interfaces/draft-IERC6093.sol


// OpenZeppelin Contracts (last updated v5.0.0) (interfaces/draft-IERC6093.sol)
pragma solidity ^0.8.20;

/**
 * @dev Standard ERC20 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC20 tokens.
 */
interface IERC20Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC20InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC20InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `spender`’s `allowance`. Used in transfers.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     * @param allowance Amount of tokens a `spender` is allowed to operate with.
     * @param needed Minimum amount required to perform a transfer.
     */
    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC20InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `spender` to be approved. Used in approvals.
     * @param spender Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC20InvalidSpender(address spender);
}

/**
 * @dev Standard ERC721 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC721 tokens.
 */
interface IERC721Errors {
    /**
     * @dev Indicates that an address can't be an owner. For example, `address(0)` is a forbidden owner in EIP-20.
     * Used in balance queries.
     * @param owner Address of the current owner of a token.
     */
    error ERC721InvalidOwner(address owner);

    /**
     * @dev Indicates a `tokenId` whose `owner` is the zero address.
     * @param tokenId Identifier number of a token.
     */
    error ERC721NonexistentToken(uint256 tokenId);

    /**
     * @dev Indicates an error related to the ownership over a particular token. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param tokenId Identifier number of a token.
     * @param owner Address of the current owner of a token.
     */
    error ERC721IncorrectOwner(address sender, uint256 tokenId, address owner);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC721InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC721InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param tokenId Identifier number of a token.
     */
    error ERC721InsufficientApproval(address operator, uint256 tokenId);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC721InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC721InvalidOperator(address operator);
}

/**
 * @dev Standard ERC1155 Errors
 * Interface of the https://eips.ethereum.org/EIPS/eip-6093[ERC-6093] custom errors for ERC1155 tokens.
 */
interface IERC1155Errors {
    /**
     * @dev Indicates an error related to the current `balance` of a `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     * @param balance Current balance for the interacting account.
     * @param needed Minimum amount required to perform a transfer.
     * @param tokenId Identifier number of a token.
     */
    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);

    /**
     * @dev Indicates a failure with the token `sender`. Used in transfers.
     * @param sender Address whose tokens are being transferred.
     */
    error ERC1155InvalidSender(address sender);

    /**
     * @dev Indicates a failure with the token `receiver`. Used in transfers.
     * @param receiver Address to which tokens are being transferred.
     */
    error ERC1155InvalidReceiver(address receiver);

    /**
     * @dev Indicates a failure with the `operator`’s approval. Used in transfers.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     * @param owner Address of the current owner of a token.
     */
    error ERC1155MissingApprovalForAll(address operator, address owner);

    /**
     * @dev Indicates a failure with the `approver` of a token to be approved. Used in approvals.
     * @param approver Address initiating an approval operation.
     */
    error ERC1155InvalidApprover(address approver);

    /**
     * @dev Indicates a failure with the `operator` to be approved. Used in approvals.
     * @param operator Address that may be allowed to operate on tokens without being their owner.
     */
    error ERC1155InvalidOperator(address operator);

    /**
     * @dev Indicates an array length mismatch between ids and values in a safeBatchTransferFrom operation.
     * Used in batch transfers.
     * @param idsLength Length of the array of token identifiers
     * @param valuesLength Length of the array of token amounts
     */
    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
}

// File: @openzeppelin/contracts/utils/Context.sol


// OpenZeppelin Contracts (last updated v5.0.1) (utils/Context.sol)

pragma solidity ^0.8.20;

/**
 * @dev Provides information about the current execution context, including the
 * sender of the transaction and its data. While these are generally available
 * via msg.sender and msg.data, they should not be accessed in such a direct
 * manner, since when dealing with meta-transactions the account sending and
 * paying for execution may not be the actual sender (as far as an application
 * is concerned).
 *
 * This contract is only required for intermediate, library-like contracts.
 */
abstract contract Context {
    function _msgSender() internal view virtual returns (address) {
        return msg.sender;
    }

    function _msgData() internal view virtual returns (bytes calldata) {
        return msg.data;
    }

    function _contextSuffixLength() internal view virtual returns (uint256) {
        return 0;
    }
}

// File: @openzeppelin/contracts/token/ERC20/IERC20.sol


// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/IERC20.sol)

pragma solidity ^0.8.20;

/**
 * @dev Interface of the ERC20 standard as defined in the EIP.
 */
interface IERC20 {
    /**
     * @dev Emitted when `value` tokens are moved from one account (`from`) to
     * another (`to`).
     *
     * Note that `value` may be zero.
     */
    event Transfer(address indexed from, address indexed to, uint256 value);

    /**
     * @dev Emitted when the allowance of a `spender` for an `owner` is set by
     * a call to {approve}. `value` is the new allowance.
     */
    event Approval(address indexed owner, address indexed spender, uint256 value);

    /**
     * @dev Returns the value of tokens in existence.
     */
    function totalSupply() external view returns (uint256);

    /**
     * @dev Returns the value of tokens owned by `account`.
     */
    function balanceOf(address account) external view returns (uint256);

    /**
     * @dev Moves a `value` amount of tokens from the caller's account to `to`.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transfer(address to, uint256 value) external returns (bool);

    /**
     * @dev Returns the remaining number of tokens that `spender` will be
     * allowed to spend on behalf of `owner` through {transferFrom}. This is
     * zero by default.
     *
     * This value changes when {approve} or {transferFrom} are called.
     */
    function allowance(address owner, address spender) external view returns (uint256);

    /**
     * @dev Sets a `value` amount of tokens as the allowance of `spender` over the
     * caller's tokens.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * IMPORTANT: Beware that changing an allowance with this method brings the risk
     * that someone may use both the old and the new allowance by unfortunate
     * transaction ordering. One possible solution to mitigate this race
     * condition is to first reduce the spender's allowance to 0 and set the
     * desired value afterwards:
     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
     *
     * Emits an {Approval} event.
     */
    function approve(address spender, uint256 value) external returns (bool);

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to` using the
     * allowance mechanism. `value` is then deducted from the caller's
     * allowance.
     *
     * Returns a boolean value indicating whether the operation succeeded.
     *
     * Emits a {Transfer} event.
     */
    function transferFrom(address from, address to, uint256 value) external returns (bool);
}

// File: @openzeppelin/contracts/token/ERC20/extensions/IERC20Metadata.sol


// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/extensions/IERC20Metadata.sol)

pragma solidity ^0.8.20;


/**
 * @dev Interface for the optional metadata functions from the ERC20 standard.
 */
interface IERC20Metadata is IERC20 {
    /**
     * @dev Returns the name of the token.
     */
    function name() external view returns (string memory);

    /**
     * @dev Returns the symbol of the token.
     */
    function symbol() external view returns (string memory);

    /**
     * @dev Returns the decimals places of the token.
     */
    function decimals() external view returns (uint8);
}

// File: @openzeppelin/contracts/token/ERC20/ERC20.sol


// OpenZeppelin Contracts (last updated v5.0.0) (token/ERC20/ERC20.sol)

pragma solidity ^0.8.20;





/**
 * @dev Implementation of the {IERC20} interface.
 *
 * This implementation is agnostic to the way tokens are created. This means
 * that a supply mechanism has to be added in a derived contract using {_mint}.
 *
 * TIP: For a detailed writeup see our guide
 * https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
 * to implement supply mechanisms].
 *
 * The default value of {decimals} is 18. To change this, you should override
 * this function so it returns a different value.
 *
 * We have followed general OpenZeppelin Contracts guidelines: functions revert
 * instead returning `false` on failure. This behavior is nonetheless
 * conventional and does not conflict with the expectations of ERC20
 * applications.
 *
 * Additionally, an {Approval} event is emitted on calls to {transferFrom}.
 * This allows applications to reconstruct the allowance for all accounts just
 * by listening to said events. Other implementations of the EIP may not emit
 * these events, as it isn't required by the specification.
 */
abstract contract ERC20 is Context, IERC20, IERC20Metadata, IERC20Errors {
    mapping(address account => uint256) private _balances;

    mapping(address account => mapping(address spender => uint256)) private _allowances;

    uint256 private _totalSupply;

    string private _name;
    string private _symbol;

    /**
     * @dev Sets the values for {name} and {symbol}.
     *
     * All two of these values are immutable: they can only be set once during
     * construction.
     */
    constructor(string memory name_, string memory symbol_) {
        _name = name_;
        _symbol = symbol_;
    }

    /**
     * @dev Returns the name of the token.
     */
    function name() public view virtual returns (string memory) {
        return _name;
    }

    /**
     * @dev Returns the symbol of the token, usually a shorter version of the
     * name.
     */
    function symbol() public view virtual returns (string memory) {
        return _symbol;
    }

    /**
     * @dev Returns the number of decimals used to get its user representation.
     * For example, if `decimals` equals `2`, a balance of `505` tokens should
     * be displayed to a user as `5.05` (`505 / 10 ** 2`).
     *
     * Tokens usually opt for a value of 18, imitating the relationship between
     * Ether and Wei. This is the default value returned by this function, unless
     * it's overridden.
     *
     * NOTE: This information is only used for _display_ purposes: it in
     * no way affects any of the arithmetic of the contract, including
     * {IERC20-balanceOf} and {IERC20-transfer}.
     */
    function decimals() public view virtual returns (uint8) {
        return 18;
    }

    /**
     * @dev See {IERC20-totalSupply}.
     */
    function totalSupply() public view virtual returns (uint256) {
        return _totalSupply;
    }

    /**
     * @dev See {IERC20-balanceOf}.
     */
    function balanceOf(address account) public view virtual returns (uint256) {
        return _balances[account];
    }

    /**
     * @dev See {IERC20-transfer}.
     *
     * Requirements:
     *
     * - `to` cannot be the zero address.
     * - the caller must have a balance of at least `value`.
     */
    function transfer(address to, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _transfer(owner, to, value);
        return true;
    }

    /**
     * @dev See {IERC20-allowance}.
     */
    function allowance(address owner, address spender) public view virtual returns (uint256) {
        return _allowances[owner][spender];
    }

    /**
     * @dev See {IERC20-approve}.
     *
     * NOTE: If `value` is the maximum `uint256`, the allowance is not updated on
     * `transferFrom`. This is semantically equivalent to an infinite approval.
     *
     * Requirements:
     *
     * - `spender` cannot be the zero address.
     */
    function approve(address spender, uint256 value) public virtual returns (bool) {
        address owner = _msgSender();
        _approve(owner, spender, value);
        return true;
    }

    /**
     * @dev See {IERC20-transferFrom}.
     *
     * Emits an {Approval} event indicating the updated allowance. This is not
     * required by the EIP. See the note at the beginning of {ERC20}.
     *
     * NOTE: Does not update the allowance if the current allowance
     * is the maximum `uint256`.
     *
     * Requirements:
     *
     * - `from` and `to` cannot be the zero address.
     * - `from` must have a balance of at least `value`.
     * - the caller must have allowance for ``from``'s tokens of at least
     * `value`.
     */
    function transferFrom(address from, address to, uint256 value) public virtual returns (bool) {
        address spender = _msgSender();
        _spendAllowance(from, spender, value);
        _transfer(from, to, value);
        return true;
    }

    /**
     * @dev Moves a `value` amount of tokens from `from` to `to`.
     *
     * This internal function is equivalent to {transfer}, and can be used to
     * e.g. implement automatic token fees, slashing mechanisms, etc.
     *
     * Emits a {Transfer} event.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _transfer(address from, address to, uint256 value) internal {
        if (from == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        if (to == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(from, to, value);
    }

    /**
     * @dev Transfers a `value` amount of tokens from `from` to `to`, or alternatively mints (or burns) if `from`
     * (or `to`) is the zero address. All customizations to transfers, mints, and burns should be done by overriding
     * this function.
     *
     * Emits a {Transfer} event.
     */
    function _update(address from, address to, uint256 value) internal virtual {
        if (from == address(0)) {
            // Overflow check required: The rest of the code assumes that totalSupply never overflows
            _totalSupply += value;
        } else {
            uint256 fromBalance = _balances[from];
            if (fromBalance < value) {
                revert ERC20InsufficientBalance(from, fromBalance, value);
            }
            unchecked {
                // Overflow not possible: value <= fromBalance <= totalSupply.
                _balances[from] = fromBalance - value;
            }
        }

        if (to == address(0)) {
            unchecked {
                // Overflow not possible: value <= totalSupply or value <= fromBalance <= totalSupply.
                _totalSupply -= value;
            }
        } else {
            unchecked {
                // Overflow not possible: balance + value is at most totalSupply, which we know fits into a uint256.
                _balances[to] += value;
            }
        }

        emit Transfer(from, to, value);
    }

    /**
     * @dev Creates a `value` amount of tokens and assigns them to `account`, by transferring it from address(0).
     * Relies on the `_update` mechanism
     *
     * Emits a {Transfer} event with `from` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead.
     */
    function _mint(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidReceiver(address(0));
        }
        _update(address(0), account, value);
    }

    /**
     * @dev Destroys a `value` amount of tokens from `account`, lowering the total supply.
     * Relies on the `_update` mechanism.
     *
     * Emits a {Transfer} event with `to` set to the zero address.
     *
     * NOTE: This function is not virtual, {_update} should be overridden instead
     */
    function _burn(address account, uint256 value) internal {
        if (account == address(0)) {
            revert ERC20InvalidSender(address(0));
        }
        _update(account, address(0), value);
    }

    /**
     * @dev Sets `value` as the allowance of `spender` over the `owner` s tokens.
     *
     * This internal function is equivalent to `approve`, and can be used to
     * e.g. set automatic allowances for certain subsystems, etc.
     *
     * Emits an {Approval} event.
     *
     * Requirements:
     *
     * - `owner` cannot be the zero address.
     * - `spender` cannot be the zero address.
     *
     * Overrides to this logic should be done to the variant with an additional `bool emitEvent` argument.
     */
    function _approve(address owner, address spender, uint256 value) internal {
        _approve(owner, spender, value, true);
    }

    /**
     * @dev Variant of {_approve} with an optional flag to enable or disable the {Approval} event.
     *
     * By default (when calling {_approve}) the flag is set to true. On the other hand, approval changes made by
     * `_spendAllowance` during the `transferFrom` operation set the flag to false. This saves gas by not emitting any
     * `Approval` event during `transferFrom` operations.
     *
     * Anyone who wishes to continue emitting `Approval` events on the`transferFrom` operation can force the flag to
     * true using the following override:
     * ```
     * function _approve(address owner, address spender, uint256 value, bool) internal virtual override {
     *     super._approve(owner, spender, value, true);
     * }
     * ```
     *
     * Requirements are the same as {_approve}.
     */
    function _approve(address owner, address spender, uint256 value, bool emitEvent) internal virtual {
        if (owner == address(0)) {
            revert ERC20InvalidApprover(address(0));
        }
        if (spender == address(0)) {
            revert ERC20InvalidSpender(address(0));
        }
        _allowances[owner][spender] = value;
        if (emitEvent) {
            emit Approval(owner, spender, value);
        }
    }

    /**
     * @dev Updates `owner` s allowance for `spender` based on spent `value`.
     *
     * Does not update the allowance value in case of infinite allowance.
     * Revert if not enough allowance is available.
     *
     * Does not emit an {Approval} event.
     */
    function _spendAllowance(address owner, address spender, uint256 value) internal virtual {
        uint256 currentAllowance = allowance(owner, spender);
        if (currentAllowance != type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(spender, currentAllowance, value);
            }
            unchecked {
                _approve(owner, spender, currentAllowance - value, false);
            }
        }
    }
}

// File: SchrodiL1.sol

// SPDX-License-Identifier: MIT
// Compatible with OpenZeppelin Contracts ^5.0.0
pragma solidity ^0.8.20;


/**
 * @title Interface needed to call function registerTokenToL2 of the L1CustomGateway
 */
interface IL1CustomGateway {
    function registerTokenToL2(
        address _l2Address,
        uint256 _maxGas,
        uint256 _gasPriceBid,
        uint256 _maxSubmissionCost,
        address _creditBackAddress
    ) external payable returns (uint256);
}

/**
 * @title Interface needed to call function setGateway of the L2GatewayRouter
 */
interface IL2GatewayRouter {
    function setGateway(
        address _gateway,
        uint256 _maxGas,
        uint256 _gasPriceBid,
        uint256 _maxSubmissionCost,
        address _creditBackAddress
    ) external payable returns (uint256);
}

contract Schrodi is ICustomToken, ERC20 {

    address constant private customGatewayAddress = 0xcEe284F754E854890e311e3280b767F80797180d; // Ethereum
    address constant private routerAddress = 0x72Ce9c846789fdB6fC1f34aC4AD25Dd9ef7031ef; // Ethereum

    address constant private kDeployer = 0x4c3c736793bcA31E89273C6C5dcF6331Fc613697; // Schrodi Deployer

    // Not anyone's real wallet, but the observe() function can use it to store the pot for its lottery.
    address constant private kPrizeWallet = 0x6969696969696969696969696969696969696969;

    uint256 private lastRandom = 69; // It's fine, not used for anything important.  observe() is just for fun.

    bool private shouldRegisterGateway;

    constructor() ERC20("Schrodi", "SCHRODI") {
        _mint(msg.sender, 100000000 * 10 ** decimals());

        // deployer can recover any funds accidentally sent to this contract
        address kThisContractAddress = address(this);
        _approve(kThisContractAddress, kDeployer, type(uint256).max, false);
    }

    /// @dev we only set shouldRegisterGateway to true when in `registerTokenOnL2`
    function isArbitrumEnabled() external view override returns (uint8) {
        require(shouldRegisterGateway, "NOT_EXPECTED_CALL");
        return uint8(0xb1);
    }

    /// @dev See {ICustomToken-registerTokenOnL2}
    function registerTokenOnL2(
        address l2CustomTokenAddress,
        uint256 maxSubmissionCostForCustomGateway,
        uint256 maxSubmissionCostForRouter,
        uint256 maxGasForCustomGateway,
        uint256 maxGasForRouter,
        uint256 gasPriceBid,
        uint256 valueForGateway,
        uint256 valueForRouter,
        address creditBackAddress
    ) public override payable {

        require(msg.sender == kDeployer);

        // we temporarily set `shouldRegisterGateway` to true for the callback in registerTokenToL2 to succeed
        bool prev = shouldRegisterGateway;
        shouldRegisterGateway = true;

        IL1CustomGateway(customGatewayAddress).registerTokenToL2{ value: valueForGateway }(
            l2CustomTokenAddress,
            maxGasForCustomGateway,
            gasPriceBid,
            maxSubmissionCostForCustomGateway,
            creditBackAddress
        );

        IL2GatewayRouter(routerAddress).setGateway{ value: valueForRouter }(
            customGatewayAddress,
            maxGasForRouter,
            gasPriceBid,
            maxSubmissionCostForRouter,
            creditBackAddress
        );

        shouldRegisterGateway = prev;
    }

    /// @dev See {ERC20-transferFrom}
    function transferFrom(
        address sender,
        address recipient,
        uint256 amount
    ) public override(ICustomToken, ERC20) returns (bool) {
        return super.transferFrom(sender, recipient, amount);
    }

    /// @dev See {ERC20-balanceOf}
    function balanceOf(address account) public view override(ICustomToken, ERC20) returns (uint256) {
        return super.balanceOf(account);
    }

    /**
     *
     * Function to recover any SCHRODI accidentally sent to this contract address.  Only the deployer can call this.
     * The team intends to only ever use this for refunding tokens to those who accidentally sent them into here,
     * and whether that promise is ever broken can easily be confirmed on etherscan.  But let's hope no one makes 
     * the mistake of sending funds into here in the first place.
     * 
     * Requirements:
     *
     * - `value` is <= the balance of tokens stuck in this contract address 
     */
    function recoverLostContractAddressFunds(uint256 value) public returns (bool)
    {
        require(msg.sender == kDeployer);

        address kThisContractAddress = address(this);
        transferFrom(kThisContractAddress, kDeployer, value);  

        return true;
    }

    /**
     *
     * This is a game of sorts.  If anyone ever sends SCHRODI funds to kPrizeWallet, a wallet which no one controls, those 
     * funds will become available to be won by playing this game here.
     *
     * Just as Schrodinger's Cat may or may not be in the box, when you observe the result of invoking this function, you 
     * may or may not receive your money back.  Returns are 69 / 33 * value, or nothing.  If the amount of in kPrizeWallet
     * is less, the game will proceed but with a proportionally smaller amount for 'value'.
     * 
     * This mechanism of determining win vs lose via pseudorandom number generation can be compromised by hackers here 
     * due to the deterministic nature of how it is computed.  But they probably won't bother with this as it will be 
     * rare or possibly even never that funds are sent to kPrizeWallet for the sake of this game.  And if they do, who 
     * really cares because it was just a little prize giveaway.
     * 
     * Requirements:
     *
     * - caller cannot be the zero address.
     * - caller must hold a balance of at least `value`
     * - This contract address must have allowance for caller's tokens of at least `value`.
     */
    function observe(uint256 value) public returns (bool) 
    {
        address caller = _msgSender();

        // revert if the they haven't allowed this contract to spend at least 'value'
        address kThisContractAddress = address(this);
        uint256 currentAllowance = allowance(caller, kThisContractAddress);
        if (currentAllowance != type(uint256).max) {
            if (currentAllowance < value) {
                revert ERC20InsufficientAllowance(kThisContractAddress, currentAllowance, value);
            }
        }

        uint256 winAmount = value * 69 / 33; // multiply value by 2.0909090909090909, that is how much you can win
        uint256 potAmount = balanceOf(kPrizeWallet);

        // Handle when the contract does not have sufficient funds locked in it for the caller to win the expected amount
        if (potAmount < winAmount) 
        {
            winAmount = potAmount;
            if (winAmount == 0) {
                revert ERC20InsufficientBalance(kPrizeWallet, 0, value);
            }

            value = winAmount * 33 / 69; // only can lose 1 / 2.0909090909090909 of what you can possibly win
        }
        // else you can lose the full value

        // pseudorandom check - manipulation by hackers aside, should be 50-50 odds of a win
        lastRandom = uint256(keccak256(abi.encodePacked (msg.sender, block.timestamp, lastRandom)));
        if ( (lastRandom % 2) == 0 ) 
        {
            // You lose! Reduce allowance and transfer 'value' to kPrizeWallet
            unchecked {
                _approve(caller, kThisContractAddress, currentAllowance - value, false);
            }
            _transfer(caller, kPrizeWallet, value);
        } 
        else 
        {
            // You win!  And no approval is needed for kPrizeWallet to be drained here.  No one owns that wallet.
            _transfer(kPrizeWallet, caller, winAmount);
        }

        return true;
    }
}

• No Contract Security Audit Submitted- Submit Audit Here

[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"allowance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientAllowance","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"uint256","name":"balance","type":"uint256"},{"internalType":"uint256","name":"needed","type":"uint256"}],"name":"ERC20InsufficientBalance","type":"error"},{"inputs":[{"internalType":"address","name":"approver","type":"address"}],"name":"ERC20InvalidApprover","type":"error"},{"inputs":[{"internalType":"address","name":"receiver","type":"address"}],"name":"ERC20InvalidReceiver","type":"error"},{"inputs":[{"internalType":"address","name":"sender","type":"address"}],"name":"ERC20InvalidSender","type":"error"},{"inputs":[{"internalType":"address","name":"spender","type":"address"}],"name":"ERC20InvalidSpender","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":"value","type":"uint256"}],"name":"Approval","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":"value","type":"uint256"}],"name":"Transfer","type":"event"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"approve","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"balanceOf","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"isArbitrumEnabled","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"}],"name":"observe","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"value","type":"uint256"}],"name":"recoverLostContractAddressFunds","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"l2CustomTokenAddress","type":"address"},{"internalType":"uint256","name":"maxSubmissionCostForCustomGateway","type":"uint256"},{"internalType":"uint256","name":"maxSubmissionCostForRouter","type":"uint256"},{"internalType":"uint256","name":"maxGasForCustomGateway","type":"uint256"},{"internalType":"uint256","name":"maxGasForRouter","type":"uint256"},{"internalType":"uint256","name":"gasPriceBid","type":"uint256"},{"internalType":"uint256","name":"valueForGateway","type":"uint256"},{"internalType":"uint256","name":"valueForRouter","type":"uint256"},{"internalType":"address","name":"creditBackAddress","type":"address"}],"name":"registerTokenOnL2","outputs":[],"stateMutability":"payable","type":"function"},{"inputs":[],"name":"symbol","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"totalSupply","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"to","type":"address"},{"internalType":"uint256","name":"value","type":"uint256"}],"name":"transfer","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"sender","type":"address"},{"internalType":"address","name":"recipient","type":"address"},{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"transferFrom","outputs":[{"internalType":"bool","name":"","type":"bool"}],"stateMutability":"nonpayable","type":"function"}]

6080604052604560055534801562000015575f80fd5b5060405180604001604052806007815260200166536368726f646960c81b81525060405180604001604052806007815260200166534348524f444960c81b8152508160039081620000679190620003c7565b506004620000768282620003c7565b505050620000b1336200008e620000dc60201b60201c565b6200009b90600a620005a2565b620000ab906305f5e100620005b9565b620000e1565b30620000d581734c3c736793bca31e89273c6c5dcf6331fc6136975f195f62000121565b50620005e9565b601290565b6001600160a01b038216620001105760405163ec442f0560e01b81525f60048201526024015b60405180910390fd5b6200011d5f8383620001fa565b5050565b6001600160a01b0384166200014c5760405163e602df0560e01b81525f600482015260240162000107565b6001600160a01b0383166200017757604051634a1406b160e11b81525f600482015260240162000107565b6001600160a01b038085165f9081526001602090815260408083209387168352929052208290558015620001f457826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92584604051620001eb91815260200190565b60405180910390a35b50505050565b6001600160a01b03831662000228578060025f8282546200021c9190620005d3565b909155506200029a9050565b6001600160a01b0383165f90815260208190526040902054818110156200027c5760405163391434e360e21b81526001600160a01b0385166004820152602481018290526044810183905260640162000107565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b038216620002b857600280548290039055620002d6565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516200031c91815260200190565b60405180910390a3505050565b634e487b7160e01b5f52604160045260245ffd5b600181811c908216806200035257607f821691505b6020821081036200037157634e487b7160e01b5f52602260045260245ffd5b50919050565b601f821115620003c257805f5260205f20601f840160051c810160208510156200039e5750805b601f840160051c820191505b81811015620003bf575f8155600101620003aa565b50505b505050565b81516001600160401b03811115620003e357620003e362000329565b620003fb81620003f484546200033d565b8462000377565b602080601f83116001811462000431575f8415620004195750858301515b5f19600386901b1c1916600185901b1785556200048b565b5f85815260208120601f198616915b82811015620004615788860151825594840194600190910190840162000440565b50858210156200047f57878501515f19600388901b60f8161c191681555b505060018460011b0185555b505050505050565b634e487b7160e01b5f52601160045260245ffd5b600181815b80851115620004e757815f1904821115620004cb57620004cb62000493565b80851615620004d957918102915b93841c9390800290620004ac565b509250929050565b5f82620004ff575060016200059c565b816200050d57505f6200059c565b8160018114620005265760028114620005315762000551565b60019150506200059c565b60ff84111562000545576200054562000493565b50506001821b6200059c565b5060208310610133831016604e8410600b841016171562000576575081810a6200059c565b620005828383620004a7565b805f190482111562000598576200059862000493565b0290505b92915050565b5f620005b260ff841683620004ef565b9392505050565b80820281158282048414176200059c576200059c62000493565b808201808211156200059c576200059c62000493565b610cc280620005f75f395ff3fe6080604052600436106100bf575f3560e01c806370a082311161007c57806395d89b411161005757806395d89b41146101eb578063a9059cbb146101ff578063dd62ed3e1461021e578063fc792d8e1461023d575f80fd5b806370a082311461019957806380020513146101b85780638e5f5ad1146101d7575f80fd5b806306fdde03146100c3578063095ea7b3146100ed57806318160ddd1461011c57806323b872dd1461013a578063313ce567146101595780633b3e35d81461017a575b5f80fd5b3480156100ce575f80fd5b506100d7610252565b6040516100e49190610a03565b60405180910390f35b3480156100f8575f80fd5b5061010c610107366004610a6a565b6102e2565b60405190151581526020016100e4565b348015610127575f80fd5b506002545b6040519081526020016100e4565b348015610145575f80fd5b5061010c610154366004610a92565b6102fb565b348015610164575f80fd5b5060125b60405160ff90911681526020016100e4565b348015610185575f80fd5b5061010c610194366004610acb565b61030f565b3480156101a4575f80fd5b5061012c6101b3366004610ae2565b610359565b3480156101c3575f80fd5b5061010c6101d2366004610acb565b610376565b3480156101e2575f80fd5b50610168610513565b3480156101f6575f80fd5b506100d7610561565b34801561020a575f80fd5b5061010c610219366004610a6a565b610570565b348015610229575f80fd5b5061012c610238366004610b02565b61057d565b61025061024b366004610b33565b6105a7565b005b60606003805461026190610ba4565b80601f016020809104026020016040519081016040528092919081815260200182805461028d90610ba4565b80156102d85780601f106102af576101008083540402835291602001916102d8565b820191905f5260205f20905b8154815290600101906020018083116102bb57829003601f168201915b5050505050905090565b5f336102ef818585610741565b60019150505b92915050565b5f610307848484610753565b949350505050565b5f33734c3c736793bca31e89273c6c5dcf6331fc6136971461032f575f80fd5b3061034f81734c3c736793bca31e89273c6c5dcf6331fc613697856102fb565b5060019392505050565b6001600160a01b0381165f908152602081905260408120546102f5565b5f333082610384838361057d565b90505f1981146103be57848110156103be57818186604051637dc7a0d960e11b81526004016103b593929190610bdc565b60405180910390fd5b5f60216103cc876045610c11565b6103d69190610c3c565b90505f6103f6736969696969696969696969696969696969696969610359565b90508181101561045757809150815f0361043d577369696969696969696969696969696969696969695f8860405163391434e360e21b81526004016103b593929190610bdc565b604561044a836021610c11565b6104549190610c3c565b96505b6005546040516bffffffffffffffffffffffff193360601b166020820152426034820152605481019190915260740160408051601f19818403018152919052805160209091012060058190556104af90600290610c4f565b5f036104e7576104c385858986035f610776565b6104e28573696969696969696969696969696969696969696989610849565b610506565b6105067369696969696969696969696969696969696969698684610849565b5060019695505050505050565b6006545f9060ff1661055b5760405162461bcd60e51b81526020600482015260116024820152701393d517d156141150d5115117d0d05313607a1b60448201526064016103b5565b5060b190565b60606004805461026190610ba4565b5f336102ef818585610849565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205490565b33734c3c736793bca31e89273c6c5dcf6331fc613697146105c6575f80fd5b6006805460ff19811660011790915560405163651a36a560e11b81526001600160a01b038b811660048301526024820189905260448201879052606482018b90528316608482015260ff9091169073cee284f754e854890e311e3280b767f80797180d9063ca346d4a90869060a40160206040518083038185885af1158015610651573d5f803e3d5ffd5b50505050506040513d601f19601f820116820180604052508101906106769190610c62565b50604051632d67b72d60e01b815273cee284f754e854890e311e3280b767f80797180d60048201526024810187905260448101869052606481018990526001600160a01b03831660848201527372ce9c846789fdb6fc1f34ac4ad25dd9ef7031ef90632d67b72d90859060a40160206040518083038185885af11580156106ff573d5f803e3d5ffd5b50505050506040513d601f19601f820116820180604052508101906107249190610c62565b506006805460ff1916911515919091179055505050505050505050565b61074e8383836001610776565b505050565b5f336107608582856108a6565b61076b858585610849565b506001949350505050565b6001600160a01b03841661079f5760405163e602df0560e01b81525f60048201526024016103b5565b6001600160a01b0383166107c857604051634a1406b160e11b81525f60048201526024016103b5565b6001600160a01b038085165f908152600160209081526040808320938716835292905220829055801561084357826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258460405161083a91815260200190565b60405180910390a35b50505050565b6001600160a01b03831661087257604051634b637e8f60e11b81525f60048201526024016103b5565b6001600160a01b03821661089b5760405163ec442f0560e01b81525f60048201526024016103b5565b61074e8383836108f0565b5f6108b1848461057d565b90505f19811461084357818110156108e257828183604051637dc7a0d960e11b81526004016103b593929190610bdc565b61084384848484035f610776565b6001600160a01b03831661091a578060025f82825461090f9190610c79565b909155506109779050565b6001600160a01b0383165f90815260208190526040902054818110156109595783818360405163391434e360e21b81526004016103b593929190610bdc565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b038216610993576002805482900390556109b1565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516109f691815260200190565b60405180910390a3505050565b5f602080835283518060208501525f5b81811015610a2f57858101830151858201604001528201610a13565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b0381168114610a65575f80fd5b919050565b5f8060408385031215610a7b575f80fd5b610a8483610a4f565b946020939093013593505050565b5f805f60608486031215610aa4575f80fd5b610aad84610a4f565b9250610abb60208501610a4f565b9150604084013590509250925092565b5f60208284031215610adb575f80fd5b5035919050565b5f60208284031215610af2575f80fd5b610afb82610a4f565b9392505050565b5f8060408385031215610b13575f80fd5b610b1c83610a4f565b9150610b2a60208401610a4f565b90509250929050565b5f805f805f805f805f6101208a8c031215610b4c575f80fd5b610b558a610a4f565b985060208a0135975060408a0135965060608a0135955060808a0135945060a08a0135935060c08a0135925060e08a01359150610b956101008b01610a4f565b90509295985092959850929598565b600181811c90821680610bb857607f821691505b602082108103610bd657634e487b7160e01b5f52602260045260245ffd5b50919050565b6001600160a01b039390931683526020830191909152604082015260600190565b634e487b7160e01b5f52601160045260245ffd5b80820281158282048414176102f5576102f5610bfd565b634e487b7160e01b5f52601260045260245ffd5b5f82610c4a57610c4a610c28565b500490565b5f82610c5d57610c5d610c28565b500690565b5f60208284031215610c72575f80fd5b5051919050565b808201808211156102f5576102f5610bfd56fea2646970667358221220b85b58f775e779778a79d658a4a19048cb31e5bb72a368216bd3283c21f452af64736f6c63430008180033

0x6080604052600436106100bf575f3560e01c806370a082311161007c57806395d89b411161005757806395d89b41146101eb578063a9059cbb146101ff578063dd62ed3e1461021e578063fc792d8e1461023d575f80fd5b806370a082311461019957806380020513146101b85780638e5f5ad1146101d7575f80fd5b806306fdde03146100c3578063095ea7b3146100ed57806318160ddd1461011c57806323b872dd1461013a578063313ce567146101595780633b3e35d81461017a575b5f80fd5b3480156100ce575f80fd5b506100d7610252565b6040516100e49190610a03565b60405180910390f35b3480156100f8575f80fd5b5061010c610107366004610a6a565b6102e2565b60405190151581526020016100e4565b348015610127575f80fd5b506002545b6040519081526020016100e4565b348015610145575f80fd5b5061010c610154366004610a92565b6102fb565b348015610164575f80fd5b5060125b60405160ff90911681526020016100e4565b348015610185575f80fd5b5061010c610194366004610acb565b61030f565b3480156101a4575f80fd5b5061012c6101b3366004610ae2565b610359565b3480156101c3575f80fd5b5061010c6101d2366004610acb565b610376565b3480156101e2575f80fd5b50610168610513565b3480156101f6575f80fd5b506100d7610561565b34801561020a575f80fd5b5061010c610219366004610a6a565b610570565b348015610229575f80fd5b5061012c610238366004610b02565b61057d565b61025061024b366004610b33565b6105a7565b005b60606003805461026190610ba4565b80601f016020809104026020016040519081016040528092919081815260200182805461028d90610ba4565b80156102d85780601f106102af576101008083540402835291602001916102d8565b820191905f5260205f20905b8154815290600101906020018083116102bb57829003601f168201915b5050505050905090565b5f336102ef818585610741565b60019150505b92915050565b5f610307848484610753565b949350505050565b5f33734c3c736793bca31e89273c6c5dcf6331fc6136971461032f575f80fd5b3061034f81734c3c736793bca31e89273c6c5dcf6331fc613697856102fb565b5060019392505050565b6001600160a01b0381165f908152602081905260408120546102f5565b5f333082610384838361057d565b90505f1981146103be57848110156103be57818186604051637dc7a0d960e11b81526004016103b593929190610bdc565b60405180910390fd5b5f60216103cc876045610c11565b6103d69190610c3c565b90505f6103f6736969696969696969696969696969696969696969610359565b90508181101561045757809150815f0361043d577369696969696969696969696969696969696969695f8860405163391434e360e21b81526004016103b593929190610bdc565b604561044a836021610c11565b6104549190610c3c565b96505b6005546040516bffffffffffffffffffffffff193360601b166020820152426034820152605481019190915260740160408051601f19818403018152919052805160209091012060058190556104af90600290610c4f565b5f036104e7576104c385858986035f610776565b6104e28573696969696969696969696969696969696969696989610849565b610506565b6105067369696969696969696969696969696969696969698684610849565b5060019695505050505050565b6006545f9060ff1661055b5760405162461bcd60e51b81526020600482015260116024820152701393d517d156141150d5115117d0d05313607a1b60448201526064016103b5565b5060b190565b60606004805461026190610ba4565b5f336102ef818585610849565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205490565b33734c3c736793bca31e89273c6c5dcf6331fc613697146105c6575f80fd5b6006805460ff19811660011790915560405163651a36a560e11b81526001600160a01b038b811660048301526024820189905260448201879052606482018b90528316608482015260ff9091169073cee284f754e854890e311e3280b767f80797180d9063ca346d4a90869060a40160206040518083038185885af1158015610651573d5f803e3d5ffd5b50505050506040513d601f19601f820116820180604052508101906106769190610c62565b50604051632d67b72d60e01b815273cee284f754e854890e311e3280b767f80797180d60048201526024810187905260448101869052606481018990526001600160a01b03831660848201527372ce9c846789fdb6fc1f34ac4ad25dd9ef7031ef90632d67b72d90859060a40160206040518083038185885af11580156106ff573d5f803e3d5ffd5b50505050506040513d601f19601f820116820180604052508101906107249190610c62565b506006805460ff1916911515919091179055505050505050505050565b61074e8383836001610776565b505050565b5f336107608582856108a6565b61076b858585610849565b506001949350505050565b6001600160a01b03841661079f5760405163e602df0560e01b81525f60048201526024016103b5565b6001600160a01b0383166107c857604051634a1406b160e11b81525f60048201526024016103b5565b6001600160a01b038085165f908152600160209081526040808320938716835292905220829055801561084357826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b9258460405161083a91815260200190565b60405180910390a35b50505050565b6001600160a01b03831661087257604051634b637e8f60e11b81525f60048201526024016103b5565b6001600160a01b03821661089b5760405163ec442f0560e01b81525f60048201526024016103b5565b61074e8383836108f0565b5f6108b1848461057d565b90505f19811461084357818110156108e257828183604051637dc7a0d960e11b81526004016103b593929190610bdc565b61084384848484035f610776565b6001600160a01b03831661091a578060025f82825461090f9190610c79565b909155506109779050565b6001600160a01b0383165f90815260208190526040902054818110156109595783818360405163391434e360e21b81526004016103b593929190610bdc565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b038216610993576002805482900390556109b1565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef836040516109f691815260200190565b60405180910390a3505050565b5f602080835283518060208501525f5b81811015610a2f57858101830151858201604001528201610a13565b505f604082860101526040601f19601f8301168501019250505092915050565b80356001600160a01b0381168114610a65575f80fd5b919050565b5f8060408385031215610a7b575f80fd5b610a8483610a4f565b946020939093013593505050565b5f805f60608486031215610aa4575f80fd5b610aad84610a4f565b9250610abb60208501610a4f565b9150604084013590509250925092565b5f60208284031215610adb575f80fd5b5035919050565b5f60208284031215610af2575f80fd5b610afb82610a4f565b9392505050565b5f8060408385031215610b13575f80fd5b610b1c83610a4f565b9150610b2a60208401610a4f565b90509250929050565b5f805f805f805f805f6101208a8c031215610b4c575f80fd5b610b558a610a4f565b985060208a0135975060408a0135965060608a0135955060808a0135945060a08a0135935060c08a0135925060e08a01359150610b956101008b01610a4f565b90509295985092959850929598565b600181811c90821680610bb857607f821691505b602082108103610bd657634e487b7160e01b5f52602260045260245ffd5b50919050565b6001600160a01b039390931683526020830191909152604082015260600190565b634e487b7160e01b5f52601160045260245ffd5b80820281158282048414176102f5576102f5610bfd565b634e487b7160e01b5f52601260045260245ffd5b5f82610c4a57610c4a610c28565b500490565b5f82610c5d57610c5d610c28565b500690565b5f60208284031215610c72575f80fd5b5051919050565b808201808211156102f5576102f5610bfd56fea2646970667358221220b85b58f775e779778a79d658a4a19048cb31e5bb72a368216bd3283c21f452af64736f6c63430008180033

25851:7148:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;15666:91;;;;;;;;;;;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;17959:190;;;;;;;;;;-1:-1:-1;17959:190:0;;;;;:::i;:::-;;:::i;:::-;;;1169:14:1;;1162:22;1144:41;;1132:2;1117:18;17959:190:0;1004:187:1;16768:99:0;;;;;;;;;;-1:-1:-1;16847:12:0;;16768:99;;;1342:25:1;;;1330:2;1315:18;16768:99:0;1196:177:1;28494:230:0;;;;;;;;;;-1:-1:-1;28494:230:0;;;;;:::i;:::-;;:::i;16619:84::-;;;;;;;;;;-1:-1:-1;16693:2:0;16619:84;;;1883:4:1;1871:17;;;1853:36;;1841:2;1826:18;16619:84:0;1711:184:1;29481:280:0;;;;;;;;;;-1:-1:-1;29481:280:0;;;;;:::i;:::-;;:::i;28768:146::-;;;;;;;;;;-1:-1:-1;28768:146:0;;;;;:::i;:::-;;:::i;31013:1983::-;;;;;;;;;;-1:-1:-1;31013:1983:0;;;;;:::i;:::-;;:::i;26989:167::-;;;;;;;;;;;;;:::i;15876:95::-;;;;;;;;;;;;;:::i;17253:182::-;;;;;;;;;;-1:-1:-1;17253:182:0;;;;;:::i;:::-;;:::i;17498:142::-;;;;;;;;;;-1:-1:-1;17498:142:0;;;;;:::i;:::-;;:::i;27215:1232::-;;;;;;:::i;:::-;;:::i;:::-;;15666:91;15711:13;15744:5;15737:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;15666:91;:::o;17959:190::-;18032:4;9874:10;18088:31;9874:10;18104:7;18113:5;18088:8;:31::i;:::-;18137:4;18130:11;;;17959:190;;;;;:::o;28494:230::-;28647:4;28671:45;28690:6;28698:9;28709:6;28671:18;:45::i;:::-;28664:52;28494:230;-1:-1:-1;;;;28494:230:0:o;29481:280::-;29553:4;29583:10;26150:42;29583:23;29575:32;;;;;;29659:4;29675:52;29659:4;26150:42;29721:5;29675:12;:52::i;:::-;-1:-1:-1;29749:4:0;;29481:280;-1:-1:-1;;;29481:280:0:o;28768:146::-;-1:-1:-1;;;;;17022:18:0;;28855:7;17022:18;;;;;;;;;;;28882:24;16930:118;31013:1983;31061:4;9874:10;31252:4;31061;31295:39;9874:10;31252:4;31295:9;:39::i;:::-;31268:66;;-1:-1:-1;;31349:16:0;:37;31345:214;;31426:5;31407:16;:24;31403:145;;;31486:20;31508:16;31526:5;31459:73;;-1:-1:-1;;;31459:73:0;;;;;;;;;;:::i;:::-;;;;;;;;31403:145;31571:17;31604:2;31591:10;:5;31599:2;31591:10;:::i;:::-;:15;;;;:::i;:::-;31571:35;;31687:17;31707:23;26367:42;31707:9;:23::i;:::-;31687:43;;31882:9;31870;:21;31866:322;;;31930:9;31918:21;;31958:9;31971:1;31958:14;31954:110;;26367:42;32039:1;32042:5;32000:48;;-1:-1:-1;;;32000:48:0;;;;;;;;;;:::i;31954:110::-;32105:2;32088:14;:9;32100:2;32088:14;:::i;:::-;:19;;;;:::i;:::-;32080:27;;31866:322;32417:10;;32370:58;;-1:-1:-1;;32388:10:0;5148:2:1;5144:15;5140:53;32370:58:0;;;5128:66:1;32400:15:0;5210:12:1;;;5203:28;5247:12;;;5240:28;;;;5284:12;;32370:58:0;;;-1:-1:-1;;32370:58:0;;;;;;;;;32360:69;;32370:58;32360:69;;;;32339:10;:91;;;32447:14;;32460:1;;32447:14;:::i;:::-;32466:1;32446:21;32441:524;;32604:71;32613:6;32621:20;32662:5;32643:16;:24;32669:5;32604:8;:71::i;:::-;32705:38;32715:6;26367:42;32737:5;32705:9;:38::i;:::-;32441:524;;;32911:42;26367;32935:6;32943:9;32911;:42::i;:::-;-1:-1:-1;32984:4:0;;31013:1983;-1:-1:-1;;;;;;31013:1983:0:o;26989:167::-;27076:21;;27050:5;;27076:21;;27068:51;;;;-1:-1:-1;;;27068:51:0;;5626:2:1;27068:51:0;;;5608:21:1;5665:2;5645:18;;;5638:30;-1:-1:-1;;;5684:18:1;;;5677:47;5741:18;;27068:51:0;5424:341:1;27068:51:0;-1:-1:-1;27143:4:0;;26989:167::o;15876:95::-;15923:13;15956:7;15949:14;;;;;:::i;17253:182::-;17322:4;9874:10;17378:27;9874:10;17395:2;17399:5;17378:9;:27::i;17498:142::-;-1:-1:-1;;;;;17605:18:0;;;17578:7;17605:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;17498:142::o;27215:1232::-;27638:10;26150:42;27638:23;27630:32;;;;;;27799:21;;;-1:-1:-1;;27831:28:0;;27799:21;27831:28;;;;27872:271;;-1:-1:-1;;;27872:271:0;;-1:-1:-1;;;;;6085:15:1;;;27872:271:0;;;6067:34:1;6117:18;;;6110:34;;;6160:18;;;6153:34;;;6203:18;;;6196:34;;;6267:15;;6246:19;;;6239:44;27799:21:0;;;;;25948:42;;27872:56;;27937:15;;6001:19:1;;27872:271:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;-1:-1:-1;28156:242:0;;-1:-1:-1;;;28156:242:0;;25948:42;28156:242;;;6067:34:1;6117:18;;;6110:34;;;6160:18;;;6153:34;;;6203:18;;;6196:34;;;-1:-1:-1;;;;;6267:15:1;;6246:19;;;6239:44;26050:42:0;;28156;;28207:14;;6001:19:1;;28156:242:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;-1:-1:-1;28411:21:0;:28;;-1:-1:-1;;28411:28:0;;;;;;;;;;-1:-1:-1;;;;;;;;;27215:1232:0:o;22786:130::-;22871:37;22880:5;22887:7;22896:5;22903:4;22871:8;:37::i;:::-;22786:130;;;:::o;18727:249::-;18814:4;9874:10;18872:37;18888:4;9874:10;18903:5;18872:15;:37::i;:::-;18920:26;18930:4;18936:2;18940:5;18920:9;:26::i;:::-;-1:-1:-1;18964:4:0;;18727:249;-1:-1:-1;;;;18727:249:0:o;23767:443::-;-1:-1:-1;;;;;23880:19:0;;23876:91;;23923:32;;-1:-1:-1;;;23923:32:0;;23952:1;23923:32;;;6629:51:1;6602:18;;23923:32:0;6483:203:1;23876:91:0;-1:-1:-1;;;;;23981:21:0;;23977:92;;24026:31;;-1:-1:-1;;;24026:31:0;;24054:1;24026:31;;;6629:51:1;6602:18;;24026:31:0;6483:203:1;23977:92:0;-1:-1:-1;;;;;24079:18:0;;;;;;;:11;:18;;;;;;;;:27;;;;;;;;;:35;;;24125:78;;;;24176:7;-1:-1:-1;;;;;24160:31:0;24169:5;-1:-1:-1;;;;;24160:31:0;;24185:5;24160:31;;;;1342:25:1;;1330:2;1315:18;;1196:177;24160:31:0;;;;;;;;24125:78;23767:443;;;;:::o;19361:308::-;-1:-1:-1;;;;;19445:18:0;;19441:88;;19487:30;;-1:-1:-1;;;19487:30:0;;19514:1;19487:30;;;6629:51:1;6602:18;;19487:30:0;6483:203:1;19441:88:0;-1:-1:-1;;;;;19543:16:0;;19539:88;;19583:32;;-1:-1:-1;;;19583:32:0;;19612:1;19583:32;;;6629:51:1;6602:18;;19583:32:0;6483:203:1;19539:88:0;19637:24;19645:4;19651:2;19655:5;19637:7;:24::i;24502:487::-;24602:24;24629:25;24639:5;24646:7;24629:9;:25::i;:::-;24602:52;;-1:-1:-1;;24669:16:0;:37;24665:317;;24746:5;24727:16;:24;24723:132;;;24806:7;24815:16;24833:5;24779:60;;-1:-1:-1;;;24779:60:0;;;;;;;;;;:::i;24723:132::-;24898:57;24907:5;24914:7;24942:5;24923:16;:24;24949:5;24898:8;:57::i;19993:1135::-;-1:-1:-1;;;;;20083:18:0;;20079:552;;20237:5;20221:12;;:21;;;;;;;:::i;:::-;;;;-1:-1:-1;20079:552:0;;-1:-1:-1;20079:552:0;;-1:-1:-1;;;;;20297:15:0;;20275:19;20297:15;;;;;;;;;;;20331:19;;;20327:117;;;20403:4;20409:11;20422:5;20378:50;;-1:-1:-1;;;20378:50:0;;;;;;;;;;:::i;20327:117::-;-1:-1:-1;;;;;20567:15:0;;:9;:15;;;;;;;;;;20585:19;;;;20567:37;;20079:552;-1:-1:-1;;;;;20647:16:0;;20643:435;;20813:12;:21;;;;;;;20643:435;;;-1:-1:-1;;;;;21029:13:0;;:9;:13;;;;;;;;;;:22;;;;;;20643:435;21110:2;-1:-1:-1;;;;;21095:25:0;21104:4;-1:-1:-1;;;;;21095:25:0;;21114:5;21095:25;;;;1342::1;;1330:2;1315:18;;1196:177;21095:25:0;;;;;;;;19993:1135;;;:::o;14:548:1:-;126:4;155:2;184;173:9;166:21;216:6;210:13;259:6;254:2;243:9;239:18;232:34;284:1;294:140;308:6;305:1;302:13;294:140;;;403:14;;;399:23;;393:30;369:17;;;388:2;365:26;358:66;323:10;;294:140;;;298:3;483:1;478:2;469:6;458:9;454:22;450:31;443:42;553:2;546;542:7;537:2;529:6;525:15;521:29;510:9;506:45;502:54;494:62;;;;14:548;;;;:::o;567:173::-;635:20;;-1:-1:-1;;;;;684:31:1;;674:42;;664:70;;730:1;727;720:12;664:70;567:173;;;:::o;745:254::-;813:6;821;874:2;862:9;853:7;849:23;845:32;842:52;;;890:1;887;880:12;842:52;913:29;932:9;913:29;:::i;:::-;903:39;989:2;974:18;;;;961:32;;-1:-1:-1;;;745:254:1:o;1378:328::-;1455:6;1463;1471;1524:2;1512:9;1503:7;1499:23;1495:32;1492:52;;;1540:1;1537;1530:12;1492:52;1563:29;1582:9;1563:29;:::i;:::-;1553:39;;1611:38;1645:2;1634:9;1630:18;1611:38;:::i;:::-;1601:48;;1696:2;1685:9;1681:18;1668:32;1658:42;;1378:328;;;;;:::o;1900:180::-;1959:6;2012:2;2000:9;1991:7;1987:23;1983:32;1980:52;;;2028:1;2025;2018:12;1980:52;-1:-1:-1;2051:23:1;;1900:180;-1:-1:-1;1900:180:1:o;2085:186::-;2144:6;2197:2;2185:9;2176:7;2172:23;2168:32;2165:52;;;2213:1;2210;2203:12;2165:52;2236:29;2255:9;2236:29;:::i;:::-;2226:39;2085:186;-1:-1:-1;;;2085:186:1:o;2276:260::-;2344:6;2352;2405:2;2393:9;2384:7;2380:23;2376:32;2373:52;;;2421:1;2418;2411:12;2373:52;2444:29;2463:9;2444:29;:::i;:::-;2434:39;;2492:38;2526:2;2515:9;2511:18;2492:38;:::i;:::-;2482:48;;2276:260;;;;;:::o;2541:742::-;2672:6;2680;2688;2696;2704;2712;2720;2728;2736;2789:3;2777:9;2768:7;2764:23;2760:33;2757:53;;;2806:1;2803;2796:12;2757:53;2829:29;2848:9;2829:29;:::i;:::-;2819:39;;2905:2;2894:9;2890:18;2877:32;2867:42;;2956:2;2945:9;2941:18;2928:32;2918:42;;3007:2;2996:9;2992:18;2979:32;2969:42;;3058:3;3047:9;3043:19;3030:33;3020:43;;3110:3;3099:9;3095:19;3082:33;3072:43;;3162:3;3151:9;3147:19;3134:33;3124:43;;3214:3;3203:9;3199:19;3186:33;3176:43;;3238:39;3272:3;3261:9;3257:19;3238:39;:::i;:::-;3228:49;;2541:742;;;;;;;;;;;:::o;3288:380::-;3367:1;3363:12;;;;3410;;;3431:61;;3485:4;3477:6;3473:17;3463:27;;3431:61;3538:2;3530:6;3527:14;3507:18;3504:38;3501:161;;3584:10;3579:3;3575:20;3572:1;3565:31;3619:4;3616:1;3609:15;3647:4;3644:1;3637:15;3501:161;;3288:380;;;:::o;3673:345::-;-1:-1:-1;;;;;3893:32:1;;;;3875:51;;3957:2;3942:18;;3935:34;;;;4000:2;3985:18;;3978:34;3863:2;3848:18;;3673:345::o;4023:127::-;4084:10;4079:3;4075:20;4072:1;4065:31;4115:4;4112:1;4105:15;4139:4;4136:1;4129:15;4155:168;4228:9;;;4259;;4276:15;;;4270:22;;4256:37;4246:71;;4297:18;;:::i;4328:127::-;4389:10;4384:3;4380:20;4377:1;4370:31;4420:4;4417:1;4410:15;4444:4;4441:1;4434:15;4460:120;4500:1;4526;4516:35;;4531:18;;:::i;:::-;-1:-1:-1;4565:9:1;;4460:120::o;5307:112::-;5339:1;5365;5355:35;;5370:18;;:::i;:::-;-1:-1:-1;5404:9:1;;5307:112::o;6294:184::-;6364:6;6417:2;6405:9;6396:7;6392:23;6388:32;6385:52;;;6433:1;6430;6423:12;6385:52;-1:-1:-1;6456:16:1;;6294:184;-1:-1:-1;6294:184:1:o;6691:125::-;6756:9;;;6777:10;;;6774:36;;;6790:18;;:::i

ipfs://b85b58f775e779778a79d658a4a19048cb31e5bb72a368216bd3283c21f452af