Contract Source Code (Solidity)

IDE

• Blockscan IDE
• 🤖 Code ReaderBeta

More Options

• Similar
• Submit Audit
• Compare

/**
 *Submitted for verification at basescan.org on 2025-11-10
*/

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


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

pragma solidity >=0.4.16;

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

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

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

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

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

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

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

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

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


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

pragma solidity >=0.6.2;


/**
 * @dev Interface for the optional metadata functions from the ERC-20 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/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/interfaces/draft-IERC6093.sol


// OpenZeppelin Contracts (last updated v5.4.0) (interfaces/draft-IERC6093.sol)
pragma solidity >=0.8.4;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


// OpenZeppelin Contracts (last updated v5.4.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 ERC-20
 * applications.
 */
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}.
     *
     * Both 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;
    }

    /// @inheritdoc IERC20
    function totalSupply() public view virtual returns (uint256) {
        return _totalSupply;
    }

    /// @inheritdoc IERC20
    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;
    }

    /// @inheritdoc IERC20
    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}.
     *
     * Skips emitting an {Approval} event indicating an allowance update. This is not
     * required by the ERC. See {xref-ERC20-_approve-address-address-uint256-bool-}[_approve].
     *
     * 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:
     *
     * ```solidity
     * 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: @openzeppelin/contracts/access/Ownable.sol


// OpenZeppelin Contracts (last updated v5.0.0) (access/Ownable.sol)

pragma solidity ^0.8.20;


/**
 * @dev Contract module which provides a basic access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * The initial owner is set to the address provided by the deployer. This can
 * later be changed with {transferOwnership}.
 *
 * This module is used through inheritance. It will make available the modifier
 * `onlyOwner`, which can be applied to your functions to restrict their use to
 * the owner.
 */
abstract contract Ownable is Context {
    address private _owner;

    /**
     * @dev The caller account is not authorized to perform an operation.
     */
    error OwnableUnauthorizedAccount(address account);

    /**
     * @dev The owner is not a valid owner account. (eg. `address(0)`)
     */
    error OwnableInvalidOwner(address owner);

    event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Initializes the contract setting the address provided by the deployer as the initial owner.
     */
    constructor(address initialOwner) {
        if (initialOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(initialOwner);
    }

    /**
     * @dev Throws if called by any account other than the owner.
     */
    modifier onlyOwner() {
        _checkOwner();
        _;
    }

    /**
     * @dev Returns the address of the current owner.
     */
    function owner() public view virtual returns (address) {
        return _owner;
    }

    /**
     * @dev Throws if the sender is not the owner.
     */
    function _checkOwner() internal view virtual {
        if (owner() != _msgSender()) {
            revert OwnableUnauthorizedAccount(_msgSender());
        }
    }

    /**
     * @dev Leaves the contract without owner. It will not be possible to call
     * `onlyOwner` functions. Can only be called by the current owner.
     *
     * NOTE: Renouncing ownership will leave the contract without an owner,
     * thereby disabling any functionality that is only available to the owner.
     */
    function renounceOwnership() public virtual onlyOwner {
        _transferOwnership(address(0));
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Can only be called by the current owner.
     */
    function transferOwnership(address newOwner) public virtual onlyOwner {
        if (newOwner == address(0)) {
            revert OwnableInvalidOwner(address(0));
        }
        _transferOwnership(newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`).
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual {
        address oldOwner = _owner;
        _owner = newOwner;
        emit OwnershipTransferred(oldOwner, newOwner);
    }
}

// File: @openzeppelin/contracts/access/Ownable2Step.sol


// OpenZeppelin Contracts (last updated v5.1.0) (access/Ownable2Step.sol)

pragma solidity ^0.8.20;


/**
 * @dev Contract module which provides access control mechanism, where
 * there is an account (an owner) that can be granted exclusive access to
 * specific functions.
 *
 * This extension of the {Ownable} contract includes a two-step mechanism to transfer
 * ownership, where the new owner must call {acceptOwnership} in order to replace the
 * old one. This can help prevent common mistakes, such as transfers of ownership to
 * incorrect accounts, or to contracts that are unable to interact with the
 * permission system.
 *
 * The initial owner is specified at deployment time in the constructor for `Ownable`. This
 * can later be changed with {transferOwnership} and {acceptOwnership}.
 *
 * This module is used through inheritance. It will make available all functions
 * from parent (Ownable).
 */
abstract contract Ownable2Step is Ownable {
    address private _pendingOwner;

    event OwnershipTransferStarted(address indexed previousOwner, address indexed newOwner);

    /**
     * @dev Returns the address of the pending owner.
     */
    function pendingOwner() public view virtual returns (address) {
        return _pendingOwner;
    }

    /**
     * @dev Starts the ownership transfer of the contract to a new account. Replaces the pending transfer if there is one.
     * Can only be called by the current owner.
     *
     * Setting `newOwner` to the zero address is allowed; this can be used to cancel an initiated ownership transfer.
     */
    function transferOwnership(address newOwner) public virtual override onlyOwner {
        _pendingOwner = newOwner;
        emit OwnershipTransferStarted(owner(), newOwner);
    }

    /**
     * @dev Transfers ownership of the contract to a new account (`newOwner`) and deletes any pending owner.
     * Internal function without access restriction.
     */
    function _transferOwnership(address newOwner) internal virtual override {
        delete _pendingOwner;
        super._transferOwnership(newOwner);
    }

    /**
     * @dev The new owner accepts the ownership transfer.
     */
    function acceptOwnership() public virtual {
        address sender = _msgSender();
        if (pendingOwner() != sender) {
            revert OwnableUnauthorizedAccount(sender);
        }
        _transferOwnership(sender);
    }
}

// File: @openzeppelin/contracts/security/ReentrancyGuard.sol


// OpenZeppelin Contracts (last updated v4.9.0) (security/ReentrancyGuard.sol)

pragma solidity ^0.8.0;

/**
 * @dev Contract module that helps prevent reentrant calls to a function.
 *
 * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
 * available, which can be applied to functions to make sure there are no nested
 * (reentrant) calls to them.
 *
 * Note that because there is a single `nonReentrant` guard, functions marked as
 * `nonReentrant` may not call one another. This can be worked around by making
 * those functions `private`, and then adding `external` `nonReentrant` entry
 * points to them.
 *
 * TIP: If you would like to learn more about reentrancy and alternative ways
 * to protect against it, check out our blog post
 * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
 */
abstract contract ReentrancyGuard {
    // Booleans are more expensive than uint256 or any type that takes up a full
    // word because each write operation emits an extra SLOAD to first read the
    // slot's contents, replace the bits taken up by the boolean, and then write
    // back. This is the compiler's defense against contract upgrades and
    // pointer aliasing, and it cannot be disabled.

    // The values being non-zero value makes deployment a bit more expensive,
    // but in exchange the refund on every call to nonReentrant will be lower in
    // amount. Since refunds are capped to a percentage of the total
    // transaction's gas, it is best to keep them low in cases like this one, to
    // increase the likelihood of the full refund coming into effect.
    uint256 private constant _NOT_ENTERED = 1;
    uint256 private constant _ENTERED = 2;

    uint256 private _status;

    constructor() {
        _status = _NOT_ENTERED;
    }

    /**
     * @dev Prevents a contract from calling itself, directly or indirectly.
     * Calling a `nonReentrant` function from another `nonReentrant`
     * function is not supported. It is possible to prevent this from happening
     * by making the `nonReentrant` function external, and making it call a
     * `private` function that does the actual work.
     */
    modifier nonReentrant() {
        _nonReentrantBefore();
        _;
        _nonReentrantAfter();
    }

    function _nonReentrantBefore() private {
        // On the first call to nonReentrant, _status will be _NOT_ENTERED
        require(_status != _ENTERED, "ReentrancyGuard: reentrant call");

        // Any calls to nonReentrant after this point will fail
        _status = _ENTERED;
    }

    function _nonReentrantAfter() private {
        // By storing the original value once again, a refund is triggered (see
        // https://eips.ethereum.org/EIPS/eip-2200)
        _status = _NOT_ENTERED;
    }

    /**
     * @dev Returns true if the reentrancy guard is currently set to "entered", which indicates there is a
     * `nonReentrant` function in the call stack.
     */
    function _reentrancyGuardEntered() internal view returns (bool) {
        return _status == _ENTERED;
    }
}

// File: contracts/BOIL.sol


pragma solidity ^0.8.19;




/**
 * @title BoilToken (BOIL) - Simple ERC20 Token
 * @dev Clean ERC-20 implementation for energy-focused project
 * - Total Supply: 25,000,000,000 BOIL (25 milyar)
 * - Decimals: 18 (sama seperti ETH)
 * - Features: Basic transfer, owner burn only
 */
contract BoilToken is ERC20, Ownable2Step, ReentrancyGuard {
    
    // Constants
    uint256 public constant INITIAL_SUPPLY = 25_000_000_000 * 10**18; // 25 milyar token
    
    // Events
    event TokensBurned(address indexed from, uint256 amount);
    event TokensBurnedWithReason(address indexed from, uint256 amount, string reason);
    
    constructor() ERC20("BoilToken", "BOIL") Ownable(msg.sender) {
        _mint(msg.sender, INITIAL_SUPPLY);
    }

    // ============ TRANSFER FUNCTIONS WITH SECURITY ============
    
    /**
     * @dev Transfer dengan proteksi reentrancy
     */
    function transfer(address to, uint256 amount) 
        public 
        override 
        nonReentrant 
        returns (bool) 
    {
        return super.transfer(to, amount);
    }

    /**
     * @dev TransferFrom dengan proteksi reentrancy
     */
    function transferFrom(address from, address to, uint256 amount) 
        public 
        override 
        nonReentrant 
        returns (bool) 
    {
        return super.transferFrom(from, to, amount);
    }

    // ============ BURNING FUNCTIONS (OWNER ONLY) ============
    
    /**
     * @dev Owner burn token dari balance sendiri
     */
    function burn(uint256 amount) public onlyOwner nonReentrant {
        require(balanceOf(owner()) >= amount, "BoilToken: insufficient owner balance");
        
        _burn(owner(), amount);
        emit TokensBurned(owner(), amount);
    }

    /**
     * @dev Owner burn token dari balance sendiri dengan alasan
     */
    function burnWithReason(uint256 amount, string calldata reason) 
        public 
        onlyOwner 
        nonReentrant 
    {
        require(balanceOf(owner()) >= amount, "BoilToken: insufficient owner balance");
        require(bytes(reason).length > 0, "BoilToken: reason required");
        
        _burn(owner(), amount);
        emit TokensBurnedWithReason(owner(), amount, reason);
    }

    // ============ SECURITY FUNCTIONS ============
    
    /**
     * @dev Disable renouncing ownership untuk keamanan
     */
    function renounceOwnership() public pure override {
        revert("BoilToken: ownership cannot be renounced");
    }

    // ============ VIEW FUNCTIONS ============
    
    /**
     * @dev Get contract basic info
     */
    function getTokenInfo() external view returns (
        string memory name_,
        string memory symbol_,
        uint8 decimals_,
        uint256 totalSupply_,
        address owner_
    ) {
        return (
            name(),
            symbol(),
            decimals(),
            totalSupply(),
            owner()
        );
    }

    /**
     * @dev Check ownership transfer status
     */
    function getOwnershipStatus() external view returns (
        address currentOwner,
        address pending
    ) {
        return (owner(), pendingOwner());
    }
}

• 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"},{"inputs":[{"internalType":"address","name":"owner","type":"address"}],"name":"OwnableInvalidOwner","type":"error"},{"inputs":[{"internalType":"address","name":"account","type":"address"}],"name":"OwnableUnauthorizedAccount","type":"error"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"owner","type":"address"},{"indexed":true,"internalType":"address","name":"spender","type":"address"},{"indexed":false,"internalType":"uint256","name":"value","type":"uint256"}],"name":"Approval","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferStarted","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"previousOwner","type":"address"},{"indexed":true,"internalType":"address","name":"newOwner","type":"address"}],"name":"OwnershipTransferred","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"}],"name":"TokensBurned","type":"event"},{"anonymous":false,"inputs":[{"indexed":true,"internalType":"address","name":"from","type":"address"},{"indexed":false,"internalType":"uint256","name":"amount","type":"uint256"},{"indexed":false,"internalType":"string","name":"reason","type":"string"}],"name":"TokensBurnedWithReason","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":[],"name":"INITIAL_SUPPLY","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"acceptOwnership","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"address","name":"owner","type":"address"},{"internalType":"address","name":"spender","type":"address"}],"name":"allowance","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"},{"inputs":[{"internalType":"address","name":"spender","type":"address"},{"internalType":"uint256","name":"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":[{"internalType":"uint256","name":"amount","type":"uint256"}],"name":"burn","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[{"internalType":"uint256","name":"amount","type":"uint256"},{"internalType":"string","name":"reason","type":"string"}],"name":"burnWithReason","outputs":[],"stateMutability":"nonpayable","type":"function"},{"inputs":[],"name":"decimals","outputs":[{"internalType":"uint8","name":"","type":"uint8"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getOwnershipStatus","outputs":[{"internalType":"address","name":"currentOwner","type":"address"},{"internalType":"address","name":"pending","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"getTokenInfo","outputs":[{"internalType":"string","name":"name_","type":"string"},{"internalType":"string","name":"symbol_","type":"string"},{"internalType":"uint8","name":"decimals_","type":"uint8"},{"internalType":"uint256","name":"totalSupply_","type":"uint256"},{"internalType":"address","name":"owner_","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"name","outputs":[{"internalType":"string","name":"","type":"string"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"owner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"pendingOwner","outputs":[{"internalType":"address","name":"","type":"address"}],"stateMutability":"view","type":"function"},{"inputs":[],"name":"renounceOwnership","outputs":[],"stateMutability":"pure","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":"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":"nonpayable","type":"function"}]

608060405234801561000f575f80fd5b5033604051806040016040528060098152602001682137b4b62a37b5b2b760b91b815250604051806040016040528060048152602001631093d25360e21b815250816003908161005f919061032a565b50600461006c828261032a565b5050506001600160a01b03811661009d57604051631e4fbdf760e01b81525f60048201526024015b60405180910390fd5b6100a6816100c7565b5060016007556100c2336b50c783eb9b5c85f2a80000006100e3565b610409565b600680546001600160a01b03191690556100e08161011b565b50565b6001600160a01b03821661010c5760405163ec442f0560e01b81525f6004820152602401610094565b6101175f838361016c565b5050565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b6001600160a01b038316610196578060025f82825461018b91906103e4565b909155506102069050565b6001600160a01b0383165f90815260208190526040902054818110156101e85760405163391434e360e21b81526001600160a01b03851660048201526024810182905260448101839052606401610094565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b03821661022257600280548290039055610240565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8360405161028591815260200190565b60405180910390a3505050565b634e487b7160e01b5f52604160045260245ffd5b600181811c908216806102ba57607f821691505b6020821081036102d857634e487b7160e01b5f52602260045260245ffd5b50919050565b601f82111561032557805f5260205f20601f840160051c810160208510156103035750805b601f840160051c820191505b81811015610322575f815560010161030f565b50505b505050565b81516001600160401b0381111561034357610343610292565b6103578161035184546102a6565b846102de565b6020601f821160018114610389575f83156103725750848201515b5f19600385901b1c1916600184901b178455610322565b5f84815260208120601f198516915b828110156103b85787850151825560209485019460019092019101610398565b50848210156103d557868401515f19600387901b60f8161c191681555b50505050600190811b01905550565b8082018082111561040357634e487b7160e01b5f52601160045260245ffd5b92915050565b610e39806104165f395ff3fe608060405234801561000f575f80fd5b506004361061011c575f3560e01c806370a08231116100a9578063a9059cbb1161006e578063a9059cbb1461025d578063abb1dc4414610270578063dd62ed3e14610289578063e30c3978146102c1578063f2fde38b146102d2575f80fd5b806370a08231146101f8578063715018a61461022057806379ba5097146102285780638da5cb5b1461023057806395d89b4114610255575f80fd5b8063197a6dc0116100ef578063197a6dc01461018857806323b872dd146101b05780632ff2e9dc146101c3578063313ce567146101d657806342966c68146101e5575f80fd5b806306fdde0314610120578063091273a71461013e578063095ea7b31461015357806318160ddd14610176575b5f80fd5b6101286102e5565b6040516101359190610b7d565b60405180910390f35b61015161014c366004610b8f565b610375565b005b610166610161366004610c21565b610489565b6040519015158152602001610135565b6002545b604051908152602001610135565b6101906104a2565b604080516001600160a01b03938416815292909116602083015201610135565b6101666101be366004610c49565b6104ca565b61017a6b50c783eb9b5c85f2a800000081565b60405160128152602001610135565b6101516101f3366004610c83565b6104f1565b61017a610206366004610c9a565b6001600160a01b03165f9081526020819052604090205490565b6101516105ab565b610151610604565b6005546001600160a01b03165b6040516001600160a01b039091168152602001610135565b610128610645565b61016661026b366004610c21565b610654565b610278610673565b604051610135959493929190610cb3565b61017a610297366004610d01565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205490565b6006546001600160a01b031661023d565b6101516102e0366004610c9a565b6106ab565b6060600380546102f490610d32565b80601f016020809104026020016040519081016040528092919081815260200182805461032090610d32565b801561036b5780601f106103425761010080835404028352916020019161036b565b820191905f5260205f20905b81548152906001019060200180831161034e57829003601f168201915b5050505050905090565b61037d61071c565b61038561074b565b8261039b6102066005546001600160a01b031690565b10156103c25760405162461bcd60e51b81526004016103b990610d6a565b60405180910390fd5b8061040f5760405162461bcd60e51b815260206004820152601a60248201527f426f696c546f6b656e3a20726561736f6e20726571756972656400000000000060448201526064016103b9565b61042a6104246005546001600160a01b031690565b846107a4565b6005546001600160a01b03166001600160a01b03167ff89cc44bd84d34274f4d7224b51ac205d2978d1923e02ee5d7da18cdb504921884848460405161047293929190610daf565b60405180910390a26104846001600755565b505050565b5f336104968185856107dc565b60019150505b92915050565b5f806104b66005546001600160a01b031690565b6006546001600160a01b0316915091509091565b5f6104d361074b565b6104de8484846107e9565b90506104ea6001600755565b9392505050565b6104f961071c565b61050161074b565b806105176102066005546001600160a01b031690565b10156105355760405162461bcd60e51b81526004016103b990610d6a565b61055061054a6005546001600160a01b031690565b826107a4565b6005546001600160a01b03166001600160a01b03167ffd38818f5291bf0bb3a2a48aadc06ba8757865d1dabd804585338aab3009dcb68260405161059691815260200190565b60405180910390a26105a86001600755565b50565b60405162461bcd60e51b815260206004820152602860248201527f426f696c546f6b656e3a206f776e6572736869702063616e6e6f742062652072604482015267195b9bdd5b98d95960c21b60648201526084016103b9565b60065433906001600160a01b0316811461063c5760405163118cdaa760e01b81526001600160a01b03821660048201526024016103b9565b6105a88161080c565b6060600480546102f490610d32565b5f61065d61074b565b6106678383610825565b905061049c6001600755565b6060805f805f6106816102e5565b610689610645565b60126002546005546001600160a01b0316945094509450945094509091929394565b6106b361071c565b600680546001600160a01b0383166001600160a01b031990911681179091556106e46005546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6005546001600160a01b031633146107495760405163118cdaa760e01b81523360048201526024016103b9565b565b60026007540361079d5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c0060448201526064016103b9565b6002600755565b6001600160a01b0382166107cd57604051634b637e8f60e11b81525f60048201526024016103b9565b6107d8825f83610832565b5050565b6104848383836001610958565b5f336107f6858285610a2b565b610801858585610aa1565b506001949350505050565b600680546001600160a01b03191690556105a881610afe565b5f33610496818585610aa1565b6001600160a01b03831661085c578060025f8282546108519190610de4565b909155506108cc9050565b6001600160a01b0383165f90815260208190526040902054818110156108ae5760405163391434e360e21b81526001600160a01b038516600482015260248101829052604481018390526064016103b9565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b0382166108e857600280548290039055610906565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8360405161094b91815260200190565b60405180910390a3505050565b6001600160a01b0384166109815760405163e602df0560e01b81525f60048201526024016103b9565b6001600160a01b0383166109aa57604051634a1406b160e11b81525f60048201526024016103b9565b6001600160a01b038085165f9081526001602090815260408083209387168352929052208290558015610a2557826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92584604051610a1c91815260200190565b60405180910390a35b50505050565b6001600160a01b038381165f908152600160209081526040808320938616835292905220545f19811015610a255781811015610a9357604051637dc7a0d960e11b81526001600160a01b038416600482015260248101829052604481018390526064016103b9565b610a2584848484035f610958565b6001600160a01b038316610aca57604051634b637e8f60e11b81525f60048201526024016103b9565b6001600160a01b038216610af35760405163ec442f0560e01b81525f60048201526024016103b9565b610484838383610832565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b5f81518084528060208401602086015e5f602082860101526020601f19601f83011685010191505092915050565b602081525f6104ea6020830184610b4f565b5f805f60408486031215610ba1575f80fd5b83359250602084013567ffffffffffffffff811115610bbe575f80fd5b8401601f81018613610bce575f80fd5b803567ffffffffffffffff811115610be4575f80fd5b866020828401011115610bf5575f80fd5b939660209190910195509293505050565b80356001600160a01b0381168114610c1c575f80fd5b919050565b5f8060408385031215610c32575f80fd5b610c3b83610c06565b946020939093013593505050565b5f805f60608486031215610c5b575f80fd5b610c6484610c06565b9250610c7260208501610c06565b929592945050506040919091013590565b5f60208284031215610c93575f80fd5b5035919050565b5f60208284031215610caa575f80fd5b6104ea82610c06565b60a081525f610cc560a0830188610b4f565b8281036020840152610cd78188610b4f565b60ff969096166040840152505060608101929092526001600160a01b031660809091015292915050565b5f8060408385031215610d12575f80fd5b610d1b83610c06565b9150610d2960208401610c06565b90509250929050565b600181811c90821680610d4657607f821691505b602082108103610d6457634e487b7160e01b5f52602260045260245ffd5b50919050565b60208082526025908201527f426f696c546f6b656e3a20696e73756666696369656e74206f776e65722062616040820152646c616e636560d81b606082015260800190565b83815260406020820152816040820152818360608301375f818301606090810191909152601f909201601f1916010192915050565b8082018082111561049c57634e487b7160e01b5f52601160045260245ffdfea2646970667358221220b3b8a95a7dd948a4f351ef2cfd1507d645fb026eb09bf22a08c1b751c591fcef64736f6c634300081a0033

0x608060405234801561000f575f80fd5b506004361061011c575f3560e01c806370a08231116100a9578063a9059cbb1161006e578063a9059cbb1461025d578063abb1dc4414610270578063dd62ed3e14610289578063e30c3978146102c1578063f2fde38b146102d2575f80fd5b806370a08231146101f8578063715018a61461022057806379ba5097146102285780638da5cb5b1461023057806395d89b4114610255575f80fd5b8063197a6dc0116100ef578063197a6dc01461018857806323b872dd146101b05780632ff2e9dc146101c3578063313ce567146101d657806342966c68146101e5575f80fd5b806306fdde0314610120578063091273a71461013e578063095ea7b31461015357806318160ddd14610176575b5f80fd5b6101286102e5565b6040516101359190610b7d565b60405180910390f35b61015161014c366004610b8f565b610375565b005b610166610161366004610c21565b610489565b6040519015158152602001610135565b6002545b604051908152602001610135565b6101906104a2565b604080516001600160a01b03938416815292909116602083015201610135565b6101666101be366004610c49565b6104ca565b61017a6b50c783eb9b5c85f2a800000081565b60405160128152602001610135565b6101516101f3366004610c83565b6104f1565b61017a610206366004610c9a565b6001600160a01b03165f9081526020819052604090205490565b6101516105ab565b610151610604565b6005546001600160a01b03165b6040516001600160a01b039091168152602001610135565b610128610645565b61016661026b366004610c21565b610654565b610278610673565b604051610135959493929190610cb3565b61017a610297366004610d01565b6001600160a01b039182165f90815260016020908152604080832093909416825291909152205490565b6006546001600160a01b031661023d565b6101516102e0366004610c9a565b6106ab565b6060600380546102f490610d32565b80601f016020809104026020016040519081016040528092919081815260200182805461032090610d32565b801561036b5780601f106103425761010080835404028352916020019161036b565b820191905f5260205f20905b81548152906001019060200180831161034e57829003601f168201915b5050505050905090565b61037d61071c565b61038561074b565b8261039b6102066005546001600160a01b031690565b10156103c25760405162461bcd60e51b81526004016103b990610d6a565b60405180910390fd5b8061040f5760405162461bcd60e51b815260206004820152601a60248201527f426f696c546f6b656e3a20726561736f6e20726571756972656400000000000060448201526064016103b9565b61042a6104246005546001600160a01b031690565b846107a4565b6005546001600160a01b03166001600160a01b03167ff89cc44bd84d34274f4d7224b51ac205d2978d1923e02ee5d7da18cdb504921884848460405161047293929190610daf565b60405180910390a26104846001600755565b505050565b5f336104968185856107dc565b60019150505b92915050565b5f806104b66005546001600160a01b031690565b6006546001600160a01b0316915091509091565b5f6104d361074b565b6104de8484846107e9565b90506104ea6001600755565b9392505050565b6104f961071c565b61050161074b565b806105176102066005546001600160a01b031690565b10156105355760405162461bcd60e51b81526004016103b990610d6a565b61055061054a6005546001600160a01b031690565b826107a4565b6005546001600160a01b03166001600160a01b03167ffd38818f5291bf0bb3a2a48aadc06ba8757865d1dabd804585338aab3009dcb68260405161059691815260200190565b60405180910390a26105a86001600755565b50565b60405162461bcd60e51b815260206004820152602860248201527f426f696c546f6b656e3a206f776e6572736869702063616e6e6f742062652072604482015267195b9bdd5b98d95960c21b60648201526084016103b9565b60065433906001600160a01b0316811461063c5760405163118cdaa760e01b81526001600160a01b03821660048201526024016103b9565b6105a88161080c565b6060600480546102f490610d32565b5f61065d61074b565b6106678383610825565b905061049c6001600755565b6060805f805f6106816102e5565b610689610645565b60126002546005546001600160a01b0316945094509450945094509091929394565b6106b361071c565b600680546001600160a01b0383166001600160a01b031990911681179091556106e46005546001600160a01b031690565b6001600160a01b03167f38d16b8cac22d99fc7c124b9cd0de2d3fa1faef420bfe791d8c362d765e2270060405160405180910390a350565b6005546001600160a01b031633146107495760405163118cdaa760e01b81523360048201526024016103b9565b565b60026007540361079d5760405162461bcd60e51b815260206004820152601f60248201527f5265656e7472616e637947756172643a207265656e7472616e742063616c6c0060448201526064016103b9565b6002600755565b6001600160a01b0382166107cd57604051634b637e8f60e11b81525f60048201526024016103b9565b6107d8825f83610832565b5050565b6104848383836001610958565b5f336107f6858285610a2b565b610801858585610aa1565b506001949350505050565b600680546001600160a01b03191690556105a881610afe565b5f33610496818585610aa1565b6001600160a01b03831661085c578060025f8282546108519190610de4565b909155506108cc9050565b6001600160a01b0383165f90815260208190526040902054818110156108ae5760405163391434e360e21b81526001600160a01b038516600482015260248101829052604481018390526064016103b9565b6001600160a01b0384165f9081526020819052604090209082900390555b6001600160a01b0382166108e857600280548290039055610906565b6001600160a01b0382165f9081526020819052604090208054820190555b816001600160a01b0316836001600160a01b03167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8360405161094b91815260200190565b60405180910390a3505050565b6001600160a01b0384166109815760405163e602df0560e01b81525f60048201526024016103b9565b6001600160a01b0383166109aa57604051634a1406b160e11b81525f60048201526024016103b9565b6001600160a01b038085165f9081526001602090815260408083209387168352929052208290558015610a2557826001600160a01b0316846001600160a01b03167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92584604051610a1c91815260200190565b60405180910390a35b50505050565b6001600160a01b038381165f908152600160209081526040808320938616835292905220545f19811015610a255781811015610a9357604051637dc7a0d960e11b81526001600160a01b038416600482015260248101829052604481018390526064016103b9565b610a2584848484035f610958565b6001600160a01b038316610aca57604051634b637e8f60e11b81525f60048201526024016103b9565b6001600160a01b038216610af35760405163ec442f0560e01b81525f60048201526024016103b9565b610484838383610832565b600580546001600160a01b038381166001600160a01b0319831681179093556040519116919082907f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e0905f90a35050565b5f81518084528060208401602086015e5f602082860101526020601f19601f83011685010191505092915050565b602081525f6104ea6020830184610b4f565b5f805f60408486031215610ba1575f80fd5b83359250602084013567ffffffffffffffff811115610bbe575f80fd5b8401601f81018613610bce575f80fd5b803567ffffffffffffffff811115610be4575f80fd5b866020828401011115610bf5575f80fd5b939660209190910195509293505050565b80356001600160a01b0381168114610c1c575f80fd5b919050565b5f8060408385031215610c32575f80fd5b610c3b83610c06565b946020939093013593505050565b5f805f60608486031215610c5b575f80fd5b610c6484610c06565b9250610c7260208501610c06565b929592945050506040919091013590565b5f60208284031215610c93575f80fd5b5035919050565b5f60208284031215610caa575f80fd5b6104ea82610c06565b60a081525f610cc560a0830188610b4f565b8281036020840152610cd78188610b4f565b60ff969096166040840152505060608101929092526001600160a01b031660809091015292915050565b5f8060408385031215610d12575f80fd5b610d1b83610c06565b9150610d2960208401610c06565b90509250929050565b600181811c90821680610d4657607f821691505b602082108103610d6457634e487b7160e01b5f52602260045260245ffd5b50919050565b60208082526025908201527f426f696c546f6b656e3a20696e73756666696369656e74206f776e65722062616040820152646c616e636560d81b606082015260800190565b83815260406020820152816040820152818360608301375f818301606090810191909152601f909201601f1916010192915050565b8082018082111561049c57634e487b7160e01b5f52601160045260245ffdfea2646970667358221220b3b8a95a7dd948a4f351ef2cfd1507d645fb026eb09bf22a08c1b751c591fcef64736f6c634300081a0033

31563:2968:0:-:0;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;12986:91;;;:::i;:::-;;;;;;;:::i;:::-;;;;;;;;33149:407;;;;;;:::i;:::-;;:::i;:::-;;15196:190;;;;;;:::i;:::-;;:::i;:::-;;;1887:14:1;;1880:22;1862:41;;1850:2;1835:18;15196:190:0;1722:187:1;14059:99:0;14138:12;;14059:99;;;2060:25:1;;;2048:2;2033:18;14059:99:0;1914:177:1;34360:168:0;;;:::i;:::-;;;;-1:-1:-1;;;;;2288:32:1;;;2270:51;;2357:32;;;;2352:2;2337:18;;2330:60;2243:18;34360:168:0;2096:300:1;32449:216:0;;;;;;:::i;:::-;;:::i;31653:64::-;;31694:23;31653:64;;13939:84;;;14013:2;2922:36:1;;2910:2;2895:18;13939:84:0;2780:184:1;32813:245:0;;;;;;:::i;:::-;;:::i;14194:118::-;;;;;;:::i;:::-;-1:-1:-1;;;;;14286:18:0;14259:7;14286:18;;;;;;;;;;;;14194:118;33698:119;;;:::i;27753:235::-;;;:::i;23950:87::-;24023:6;;-1:-1:-1;;;;;24023:6:0;23950:87;;;-1:-1:-1;;;;;3555:32:1;;;3537:51;;3525:2;3510:18;23950:87:0;3391:203:1;13196:95:0;;;:::i;32182:188::-;;;;;;:::i;:::-;;:::i;33935:354::-;;;:::i;:::-;;;;;;;;;;;:::i;14735:142::-;;;;;;:::i;:::-;-1:-1:-1;;;;;14842:18:0;;;14815:7;14842:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;;;;14735:142;26714:101;26794:13;;-1:-1:-1;;;;;26794:13:0;26714:101;;27141:181;;;;;;:::i;:::-;;:::i;12986:91::-;13031:13;13064:5;13057:12;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;:::i;:::-;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;12986:91;:::o;33149:407::-;23836:13;:11;:13::i;:::-;30340:21:::1;:19;:21::i;:::-;33320:6:::2;33298:18;33308:7;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;;23950:87;33298:18:::2;:28;;33290:78;;;;-1:-1:-1::0;;;33290:78:0::2;;;;;;;:::i;:::-;;;;;;;;;33387:24:::0;33379:63:::2;;;::::0;-1:-1:-1;;;33379:63:0;;5494:2:1;33379:63:0::2;::::0;::::2;5476:21:1::0;5533:2;5513:18;;;5506:30;5572:28;5552:18;;;5545:56;5618:18;;33379:63:0::2;5292:350:1::0;33379:63:0::2;33463:22;33469:7;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;;23950:87;33469:7:::2;33478:6;33463:5;:22::i;:::-;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;-1:-1:-1;;;;;33501:47:0::2;;33533:6;33541;;33501:47;;;;;;;;:::i;:::-;;;;;;;;30384:20:::1;29778:1:::0;30904:7;:22;30721:213;30384:20:::1;33149:407:::0;;;:::o;15196:190::-;15269:4;4385:10;15325:31;4385:10;15341:7;15350:5;15325:8;:31::i;:::-;15374:4;15367:11;;;15196:190;;;;;:::o;34360:168::-;34423:20;34454:15;34496:7;24023:6;;-1:-1:-1;;;;;24023:6:0;;23950:87;34496:7;26794:13;;-1:-1:-1;;;;;26794:13:0;34488:32;;;;34360:168;;:::o;32449:216::-;32591:4;30340:21;:19;:21::i;:::-;32621:36:::1;32640:4;32646:2;32650:6;32621:18;:36::i;:::-;32614:43;;30384:20:::0;29778:1;30904:7;:22;30721:213;30384:20;32449:216;;;;;:::o;32813:245::-;23836:13;:11;:13::i;:::-;30340:21:::1;:19;:21::i;:::-;32914:6:::2;32892:18;32902:7;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;;23950:87;32892:18:::2;:28;;32884:78;;;;-1:-1:-1::0;;;32884:78:0::2;;;;;;;:::i;:::-;32983:22;32989:7;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;;23950:87;32989:7:::2;32998:6;32983:5;:22::i;:::-;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;-1:-1:-1;;;;;33021:29:0::2;;33043:6;33021:29;;;;2060:25:1::0;;2048:2;2033:18;;1914:177;33021:29:0::2;;;;;;;;30384:20:::1;29778:1:::0;30904:7;:22;30721:213;30384:20:::1;32813:245:::0;:::o;33698:119::-;33759:50;;-1:-1:-1;;;33759:50:0;;6315:2:1;33759:50:0;;;6297:21:1;6354:2;6334:18;;;6327:30;6393:34;6373:18;;;6366:62;-1:-1:-1;;;6444:18:1;;;6437:38;6492:19;;33759:50:0;6113:404:1;27753:235:0;26794:13;;4385:10;;-1:-1:-1;;;;;26794:13:0;27850:24;;27846:98;;27898:34;;-1:-1:-1;;;27898:34:0;;-1:-1:-1;;;;;3555:32:1;;27898:34:0;;;3537:51:1;3510:18;;27898:34:0;3391:203:1;27846:98:0;27954:26;27973:6;27954:18;:26::i;13196:95::-;13243:13;13276:7;13269:14;;;;;:::i;32182:188::-;32306:4;30340:21;:19;:21::i;:::-;32336:26:::1;32351:2;32355:6;32336:14;:26::i;:::-;32329:33;;30384:20:::0;29778:1;30904:7;:22;30721:213;33935:354;33992:19;34022:21;34054:15;34080:20;34111:14;34166:6;:4;:6::i;:::-;34187:8;:6;:8::i;:::-;14013:2;14138:12;;24023:6;;-1:-1:-1;;;;;24023:6:0;34144:137;;;;;;;;;;33935:354;;;;;:::o;27141:181::-;23836:13;:11;:13::i;:::-;27231::::1;:24:::0;;-1:-1:-1;;;;;27231:24:0;::::1;-1:-1:-1::0;;;;;;27231:24:0;;::::1;::::0;::::1;::::0;;;27296:7:::1;24023:6:::0;;-1:-1:-1;;;;;24023:6:0;;23950:87;27296:7:::1;-1:-1:-1::0;;;;;27271:43:0::1;;;;;;;;;;;27141:181:::0;:::o;24115:166::-;24023:6;;-1:-1:-1;;;;;24023:6:0;4385:10;24175:23;24171:103;;24222:40;;-1:-1:-1;;;24222:40:0;;4385:10;24222:40;;;3537:51:1;3510:18;;24222:40:0;3391:203:1;24171:103:0;24115:166::o;30420:293::-;29822:1;30554:7;;:19;30546:63;;;;-1:-1:-1;;;30546:63:0;;6724:2:1;30546:63:0;;;6706:21:1;6763:2;6743:18;;;6736:30;6802:33;6782:18;;;6775:61;6853:18;;30546:63:0;6522:355:1;30546:63:0;29822:1;30687:7;:18;30420:293::o;19291:211::-;-1:-1:-1;;;;;19362:21:0;;19358:91;;19407:30;;-1:-1:-1;;;19407:30:0;;19434:1;19407:30;;;3537:51:1;3510:18;;19407:30:0;3391:203:1;19358:91:0;19459:35;19467:7;19484:1;19488:5;19459:7;:35::i;:::-;19291:211;;:::o;20055:130::-;20140:37;20149:5;20156:7;20165:5;20172:4;20140:8;:37::i;15996:249::-;16083:4;4385:10;16141:37;16157:4;4385:10;16172:5;16141:15;:37::i;:::-;16189:26;16199:4;16205:2;16209:5;16189:9;:26::i;:::-;-1:-1:-1;16233:4:0;;15996:249;-1:-1:-1;;;;15996:249:0:o;27512:156::-;27602:13;27595:20;;-1:-1:-1;;;;;;27595:20:0;;;27626:34;27651:8;27626:24;:34::i;14517:182::-;14586:4;4385:10;14642:27;4385:10;14659:2;14663:5;14642:9;:27::i;17262:1135::-;-1:-1:-1;;;;;17352:18:0;;17348:552;;17506:5;17490:12;;:21;;;;;;;:::i;:::-;;;;-1:-1:-1;17348:552:0;;-1:-1:-1;17348:552:0;;-1:-1:-1;;;;;17566:15:0;;17544:19;17566:15;;;;;;;;;;;17600:19;;;17596:117;;;17647:50;;-1:-1:-1;;;17647:50:0;;-1:-1:-1;;;;;7329:32:1;;17647:50:0;;;7311:51:1;7378:18;;;7371:34;;;7421:18;;;7414:34;;;7284:18;;17647:50:0;7109:345:1;17596:117:0;-1:-1:-1;;;;;17836:15:0;;:9;:15;;;;;;;;;;17854:19;;;;17836:37;;17348:552;-1:-1:-1;;;;;17916:16:0;;17912:435;;18082:12;:21;;;;;;;17912:435;;;-1:-1:-1;;;;;18298:13:0;;:9;:13;;;;;;;;;;:22;;;;;;17912:435;18379:2;-1:-1:-1;;;;;18364:25:0;18373:4;-1:-1:-1;;;;;18364:25:0;;18383:5;18364:25;;;;2060::1;;2048:2;2033:18;;1914:177;18364:25:0;;;;;;;;17262:1135;;;:::o;21052:443::-;-1:-1:-1;;;;;21165:19:0;;21161:91;;21208:32;;-1:-1:-1;;;21208:32:0;;21237:1;21208:32;;;3537:51:1;3510:18;;21208:32:0;3391:203:1;21161:91:0;-1:-1:-1;;;;;21266:21:0;;21262:92;;21311:31;;-1:-1:-1;;;21311:31:0;;21339:1;21311:31;;;3537:51:1;3510:18;;21311:31:0;3391:203:1;21262:92:0;-1:-1:-1;;;;;21364:18:0;;;;;;;:11;:18;;;;;;;;:27;;;;;;;;;:35;;;21410:78;;;;21461:7;-1:-1:-1;;;;;21445:31:0;21454:5;-1:-1:-1;;;;;21445:31:0;;21470:5;21445:31;;;;2060:25:1;;2048:2;2033:18;;1914:177;21445:31:0;;;;;;;;21410:78;21052:443;;;;:::o;21787:486::-;-1:-1:-1;;;;;14842:18:0;;;21887:24;14842:18;;;:11;:18;;;;;;;;:27;;;;;;;;;;-1:-1:-1;;21954:36:0;;21950:316;;;22030:5;22011:16;:24;22007:132;;;22063:60;;-1:-1:-1;;;22063:60:0;;-1:-1:-1;;;;;7329:32:1;;22063:60:0;;;7311:51:1;7378:18;;;7371:34;;;7421:18;;;7414:34;;;7284:18;;22063:60:0;7109:345:1;22007:132:0;22182:57;22191:5;22198:7;22226:5;22207:16;:24;22233:5;22182:8;:57::i;16630:308::-;-1:-1:-1;;;;;16714:18:0;;16710:88;;16756:30;;-1:-1:-1;;;16756:30:0;;16783:1;16756:30;;;3537:51:1;3510:18;;16756:30:0;3391:203:1;16710:88:0;-1:-1:-1;;;;;16812:16:0;;16808:88;;16852:32;;-1:-1:-1;;;16852:32:0;;16881:1;16852:32;;;3537:51:1;3510:18;;16852:32:0;3391:203:1;16808:88:0;16906:24;16914:4;16920:2;16924:5;16906:7;:24::i;25263:191::-;25356:6;;;-1:-1:-1;;;;;25373:17:0;;;-1:-1:-1;;;;;;25373:17:0;;;;;;;25406:40;;25356:6;;;25373:17;25356:6;;25406:40;;25337:16;;25406:40;25326:128;25263:191;:::o;14:289:1:-;56:3;94:5;88:12;121:6;116:3;109:19;177:6;170:4;163:5;159:16;152:4;147:3;143:14;137:47;229:1;222:4;213:6;208:3;204:16;200:27;193:38;292:4;285:2;281:7;276:2;268:6;264:15;260:29;255:3;251:39;247:50;240:57;;;14:289;;;;:::o;308:220::-;457:2;446:9;439:21;420:4;477:45;518:2;507:9;503:18;495:6;477:45;:::i;533:701::-;613:6;621;629;682:2;670:9;661:7;657:23;653:32;650:52;;;698:1;695;688:12;650:52;743:23;;;-1:-1:-1;841:2:1;826:18;;813:32;868:18;857:30;;854:50;;;900:1;897;890:12;854:50;923:22;;976:4;968:13;;964:27;-1:-1:-1;954:55:1;;1005:1;1002;995:12;954:55;1045:2;1032:16;1071:18;1063:6;1060:30;1057:50;;;1103:1;1100;1093:12;1057:50;1148:7;1143:2;1134:6;1130:2;1126:15;1122:24;1119:37;1116:57;;;1169:1;1166;1159:12;1116:57;533:701;;1200:2;1192:11;;;;;-1:-1:-1;1222:6:1;;-1:-1:-1;;;533:701:1:o;1239:173::-;1307:20;;-1:-1:-1;;;;;1356:31:1;;1346:42;;1336:70;;1402:1;1399;1392:12;1336:70;1239:173;;;:::o;1417:300::-;1485:6;1493;1546:2;1534:9;1525:7;1521:23;1517:32;1514:52;;;1562:1;1559;1552:12;1514:52;1585:29;1604:9;1585:29;:::i;:::-;1575:39;1683:2;1668:18;;;;1655:32;;-1:-1:-1;;;1417:300:1:o;2401:374::-;2478:6;2486;2494;2547:2;2535:9;2526:7;2522:23;2518:32;2515:52;;;2563:1;2560;2553:12;2515:52;2586:29;2605:9;2586:29;:::i;:::-;2576:39;;2634:38;2668:2;2657:9;2653:18;2634:38;:::i;:::-;2401:374;;2624:48;;-1:-1:-1;;;2741:2:1;2726:18;;;;2713:32;;2401:374::o;2969:226::-;3028:6;3081:2;3069:9;3060:7;3056:23;3052:32;3049:52;;;3097:1;3094;3087:12;3049:52;-1:-1:-1;3142:23:1;;2969:226;-1:-1:-1;2969:226:1:o;3200:186::-;3259:6;3312:2;3300:9;3291:7;3287:23;3283:32;3280:52;;;3328:1;3325;3318:12;3280:52;3351:29;3370:9;3351:29;:::i;3599:632::-;3876:3;3865:9;3858:22;3839:4;3903:46;3944:3;3933:9;3929:19;3921:6;3903:46;:::i;:::-;3997:9;3989:6;3985:22;3980:2;3969:9;3965:18;3958:50;4025:33;4051:6;4043;4025:33;:::i;:::-;4106:4;4094:17;;;;4089:2;4074:18;;4067:45;-1:-1:-1;;4143:2:1;4128:18;;4121:34;;;;-1:-1:-1;;;;;4192:32:1;4186:3;4171:19;;;4164:61;4017:41;3599:632;-1:-1:-1;;3599:632:1:o;4236:260::-;4304:6;4312;4365:2;4353:9;4344:7;4340:23;4336:32;4333:52;;;4381:1;4378;4371:12;4333:52;4404:29;4423:9;4404:29;:::i;:::-;4394:39;;4452:38;4486:2;4475:9;4471:18;4452:38;:::i;:::-;4442:48;;4236:260;;;;;:::o;4501:380::-;4580:1;4576:12;;;;4623;;;4644:61;;4698:4;4690:6;4686:17;4676:27;;4644:61;4751:2;4743:6;4740:14;4720:18;4717:38;4714:161;;4797:10;4792:3;4788:20;4785:1;4778:31;4832:4;4829:1;4822:15;4860:4;4857:1;4850:15;4714:161;;4501:380;;;:::o;4886:401::-;5088:2;5070:21;;;5127:2;5107:18;;;5100:30;5166:34;5161:2;5146:18;;5139:62;-1:-1:-1;;;5232:2:1;5217:18;;5210:35;5277:3;5262:19;;4886:401::o;5647:461::-;5834:6;5823:9;5816:25;5877:2;5872;5861:9;5857:18;5850:30;5916:6;5911:2;5900:9;5896:18;5889:34;5973:6;5965;5960:2;5949:9;5945:18;5932:48;6029:1;6000:22;;;6024:2;5996:31;;;5989:42;;;;6092:2;6071:15;;;-1:-1:-1;;6067:29:1;6052:45;6048:54;;5647:461;-1:-1:-1;;5647:461:1:o;6882:222::-;6947:9;;;6968:10;;;6965:133;;;7020:10;7015:3;7011:20;7008:1;7001:31;7055:4;7052:1;7045:15;7083:4;7080:1;7073:15

ipfs://b3b8a95a7dd948a4f351ef2cfd1507d645fb026eb09bf22a08c1b751c591fcef