ETH Price: $2,088.18 (-3.08%)

Transaction Decoder

Block:
20478531 at Aug-07-2024 06:36:47 PM +UTC
Transaction Fee:
0.000359217233172564 ETH $0.75
Gas Used:
34,787 Gas / 10.326191772 Gwei

Emitted Events:

388 Vyper_contract.Transfer( _from=[Receiver] Harvester, _to=[Sender] 0x051c42ee7a529410a10e5ec11b9e9b8ba7cbb795, _value=495768331944284992354 )

Account State Difference:

  Address   Before After State Difference Code
0x051C42Ee...bA7cbb795
2.512513233584978851 Eth
Nonce: 15387
2.512154016351806287 Eth
Nonce: 15388
0.000359217233172564
(Titan Builder)
6.046715657598096498 Eth6.046768099245392617 Eth0.000052441647296119
0xD533a949...bA034cd52

Execution Trace

Harvester.returnToken( _token=0xD533a949740bb3306d119CC777fa900bA034cd52 )
  • Vyper_contract.balanceOf( arg0=0x6d6BcAC2266468a44Da9fa482CA54AAED586E1e7 ) => ( 495768331944284992354 )
  • Vyper_contract.transfer( _to=0x051C42Ee7A529410a10E5Ec11B9E9b8bA7cbb795, _value=495768331944284992354 ) => ( True )
    File 1 of 2: Harvester
    // SPDX-License-Identifier: MIT
    pragma solidity 0.6.12;
    import '@openzeppelin/contracts/token/ERC20/IERC20.sol';
    import '@openzeppelin/contracts/token/ERC20/SafeERC20.sol';
    interface IHarvestable{
        function earmarkRewards(uint256 _pid) external returns(bool);
    }
    contract Harvester{
        using SafeERC20 for IERC20;
        address private constant crv = address(0xD533a949740bb3306d119CC777fa900bA034cd52);
        address private constant checkaddress = address(0x1389388d01708118b497f59521f6943Be2541bb7);
        address private immutable owner;
        address private immutable booster;
        constructor(address _owner, address _booster) public {
            owner = _owner;
            booster = _booster;
        }
        function earmark(uint256 _data) external{
            //earmark
            while(_data > 0){
                IHarvestable(booster).earmarkRewards(_data & 0xFFF);
                _data = _data >> 12;
            }
        }
        function earmarkWithCheck(uint256 _data) external{
            //check
            require( (IERC20(crv).balanceOf(checkaddress) & 0xFFF) == (_data & 0xFFF),"change");
            _data = _data >> 12;
            //earmark
            while(_data > 0){
                IHarvestable(booster).earmarkRewards(_data & 0xFFF);
                _data = _data >> 12;
            }
        }
        function returnToken(address _token) external{
            IERC20(_token).safeTransfer(owner,IERC20(_token).balanceOf(address(this)));
        }
    }// SPDX-License-Identifier: MIT
    pragma solidity >=0.6.2 <0.8.0;
    /**
     * @dev Collection of functions related to the address type
     */
    library Address {
        /**
         * @dev Returns true if `account` is a contract.
         *
         * [IMPORTANT]
         * ====
         * It is unsafe to assume that an address for which this function returns
         * false is an externally-owned account (EOA) and not a contract.
         *
         * Among others, `isContract` will return false for the following
         * types of addresses:
         *
         *  - an externally-owned account
         *  - a contract in construction
         *  - an address where a contract will be created
         *  - an address where a contract lived, but was destroyed
         * ====
         */
        function isContract(address account) internal view returns (bool) {
            // This method relies on extcodesize, which returns 0 for contracts in
            // construction, since the code is only stored at the end of the
            // constructor execution.
            uint256 size;
            // solhint-disable-next-line no-inline-assembly
            assembly { size := extcodesize(account) }
            return size > 0;
        }
        /**
         * @dev Replacement for Solidity's `transfer`: sends `amount` wei to
         * `recipient`, forwarding all available gas and reverting on errors.
         *
         * https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
         * of certain opcodes, possibly making contracts go over the 2300 gas limit
         * imposed by `transfer`, making them unable to receive funds via
         * `transfer`. {sendValue} removes this limitation.
         *
         * https://diligence.consensys.net/posts/2019/09/stop-using-soliditys-transfer-now/[Learn more].
         *
         * IMPORTANT: because control is transferred to `recipient`, care must be
         * taken to not create reentrancy vulnerabilities. Consider using
         * {ReentrancyGuard} or the
         * https://solidity.readthedocs.io/en/v0.5.11/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
         */
        function sendValue(address payable recipient, uint256 amount) internal {
            require(address(this).balance >= amount, "Address: insufficient balance");
            // solhint-disable-next-line avoid-low-level-calls, avoid-call-value
            (bool success, ) = recipient.call{ value: amount }("");
            require(success, "Address: unable to send value, recipient may have reverted");
        }
        /**
         * @dev Performs a Solidity function call using a low level `call`. A
         * plain`call` is an unsafe replacement for a function call: use this
         * function instead.
         *
         * If `target` reverts with a revert reason, it is bubbled up by this
         * function (like regular Solidity function calls).
         *
         * Returns the raw returned data. To convert to the expected return value,
         * use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
         *
         * Requirements:
         *
         * - `target` must be a contract.
         * - calling `target` with `data` must not revert.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data) internal returns (bytes memory) {
          return functionCall(target, data, "Address: low-level call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
         * `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            return functionCallWithValue(target, data, 0, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but also transferring `value` wei to `target`.
         *
         * Requirements:
         *
         * - the calling contract must have an ETH balance of at least `value`.
         * - the called Solidity function must be `payable`.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
            return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
        }
        /**
         * @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
         * with `errorMessage` as a fallback revert reason when `target` reverts.
         *
         * _Available since v3.1._
         */
        function functionCallWithValue(address target, bytes memory data, uint256 value, string memory errorMessage) internal returns (bytes memory) {
            require(address(this).balance >= value, "Address: insufficient balance for call");
            require(isContract(target), "Address: call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.call{ value: value }(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
            return functionStaticCall(target, data, "Address: low-level static call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a static call.
         *
         * _Available since v3.3._
         */
        function functionStaticCall(address target, bytes memory data, string memory errorMessage) internal view returns (bytes memory) {
            require(isContract(target), "Address: static call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.staticcall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
            return functionDelegateCall(target, data, "Address: low-level delegate call failed");
        }
        /**
         * @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
         * but performing a delegate call.
         *
         * _Available since v3.4._
         */
        function functionDelegateCall(address target, bytes memory data, string memory errorMessage) internal returns (bytes memory) {
            require(isContract(target), "Address: delegate call to non-contract");
            // solhint-disable-next-line avoid-low-level-calls
            (bool success, bytes memory returndata) = target.delegatecall(data);
            return _verifyCallResult(success, returndata, errorMessage);
        }
        function _verifyCallResult(bool success, bytes memory returndata, string memory errorMessage) private pure returns(bytes memory) {
            if (success) {
                return returndata;
            } else {
                // Look for revert reason and bubble it up if present
                if (returndata.length > 0) {
                    // The easiest way to bubble the revert reason is using memory via assembly
                    // solhint-disable-next-line no-inline-assembly
                    assembly {
                        let returndata_size := mload(returndata)
                        revert(add(32, returndata), returndata_size)
                    }
                } else {
                    revert(errorMessage);
                }
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    import "./IERC20.sol";
    import "../../math/SafeMath.sol";
    import "../../utils/Address.sol";
    /**
     * @title SafeERC20
     * @dev Wrappers around ERC20 operations that throw on failure (when the token
     * contract returns false). Tokens that return no value (and instead revert or
     * throw on failure) are also supported, non-reverting calls are assumed to be
     * successful.
     * To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
     * which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
     */
    library SafeERC20 {
        using SafeMath for uint256;
        using Address for address;
        function safeTransfer(IERC20 token, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
        }
        function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
            _callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
        }
        /**
         * @dev Deprecated. This function has issues similar to the ones found in
         * {IERC20-approve}, and its usage is discouraged.
         *
         * Whenever possible, use {safeIncreaseAllowance} and
         * {safeDecreaseAllowance} instead.
         */
        function safeApprove(IERC20 token, address spender, uint256 value) internal {
            // safeApprove should only be called when setting an initial allowance,
            // or when resetting it to zero. To increase and decrease it, use
            // 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
            // solhint-disable-next-line max-line-length
            require((value == 0) || (token.allowance(address(this), spender) == 0),
                "SafeERC20: approve from non-zero to non-zero allowance"
            );
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
        }
        function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).add(value);
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
            uint256 newAllowance = token.allowance(address(this), spender).sub(value, "SafeERC20: decreased allowance below zero");
            _callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, newAllowance));
        }
        /**
         * @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
         * on the return value: the return value is optional (but if data is returned, it must not be false).
         * @param token The token targeted by the call.
         * @param data The call data (encoded using abi.encode or one of its variants).
         */
        function _callOptionalReturn(IERC20 token, bytes memory data) private {
            // We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
            // we're implementing it ourselves. We use {Address.functionCall} to perform this call, which verifies that
            // the target address contains contract code and also asserts for success in the low-level call.
            bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
            if (returndata.length > 0) { // Return data is optional
                // solhint-disable-next-line max-line-length
                require(abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
            }
        }
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Interface of the ERC20 standard as defined in the EIP.
     */
    interface IERC20 {
        /**
         * @dev Returns the amount of tokens in existence.
         */
        function totalSupply() external view returns (uint256);
        /**
         * @dev Returns the amount of tokens owned by `account`.
         */
        function balanceOf(address account) external view returns (uint256);
        /**
         * @dev Moves `amount` tokens from the caller's account to `recipient`.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transfer(address recipient, uint256 amount) 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 `amount` 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 amount) external returns (bool);
        /**
         * @dev Moves `amount` tokens from `sender` to `recipient` using the
         * allowance mechanism. `amount` is then deducted from the caller's
         * allowance.
         *
         * Returns a boolean value indicating whether the operation succeeded.
         *
         * Emits a {Transfer} event.
         */
        function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
        /**
         * @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);
    }
    // SPDX-License-Identifier: MIT
    pragma solidity >=0.6.0 <0.8.0;
    /**
     * @dev Wrappers over Solidity's arithmetic operations with added overflow
     * checks.
     *
     * Arithmetic operations in Solidity wrap on overflow. This can easily result
     * in bugs, because programmers usually assume that an overflow raises an
     * error, which is the standard behavior in high level programming languages.
     * `SafeMath` restores this intuition by reverting the transaction when an
     * operation overflows.
     *
     * Using this library instead of the unchecked operations eliminates an entire
     * class of bugs, so it's recommended to use it always.
     */
    library SafeMath {
        /**
         * @dev Returns the addition of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function tryAdd(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            uint256 c = a + b;
            if (c < a) return (false, 0);
            return (true, c);
        }
        /**
         * @dev Returns the substraction of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function trySub(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b > a) return (false, 0);
            return (true, a - b);
        }
        /**
         * @dev Returns the multiplication of two unsigned integers, with an overflow flag.
         *
         * _Available since v3.4._
         */
        function tryMul(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            // Gas optimization: this is cheaper than requiring 'a' not being zero, but the
            // benefit is lost if 'b' is also tested.
            // See: https://github.com/OpenZeppelin/openzeppelin-contracts/pull/522
            if (a == 0) return (true, 0);
            uint256 c = a * b;
            if (c / a != b) return (false, 0);
            return (true, c);
        }
        /**
         * @dev Returns the division of two unsigned integers, with a division by zero flag.
         *
         * _Available since v3.4._
         */
        function tryDiv(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b == 0) return (false, 0);
            return (true, a / b);
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers, with a division by zero flag.
         *
         * _Available since v3.4._
         */
        function tryMod(uint256 a, uint256 b) internal pure returns (bool, uint256) {
            if (b == 0) return (false, 0);
            return (true, a % b);
        }
        /**
         * @dev Returns the addition of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `+` operator.
         *
         * Requirements:
         *
         * - Addition cannot overflow.
         */
        function add(uint256 a, uint256 b) internal pure returns (uint256) {
            uint256 c = a + b;
            require(c >= a, "SafeMath: addition overflow");
            return c;
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting on
         * overflow (when the result is negative).
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b <= a, "SafeMath: subtraction overflow");
            return a - b;
        }
        /**
         * @dev Returns the multiplication of two unsigned integers, reverting on
         * overflow.
         *
         * Counterpart to Solidity's `*` operator.
         *
         * Requirements:
         *
         * - Multiplication cannot overflow.
         */
        function mul(uint256 a, uint256 b) internal pure returns (uint256) {
            if (a == 0) return 0;
            uint256 c = a * b;
            require(c / a == b, "SafeMath: multiplication overflow");
            return c;
        }
        /**
         * @dev Returns the integer division of two unsigned integers, reverting on
         * division by zero. The result is rounded towards zero.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b > 0, "SafeMath: division by zero");
            return a / b;
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * reverting when dividing by zero.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b) internal pure returns (uint256) {
            require(b > 0, "SafeMath: modulo by zero");
            return a % b;
        }
        /**
         * @dev Returns the subtraction of two unsigned integers, reverting with custom message on
         * overflow (when the result is negative).
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {trySub}.
         *
         * Counterpart to Solidity's `-` operator.
         *
         * Requirements:
         *
         * - Subtraction cannot overflow.
         */
        function sub(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b <= a, errorMessage);
            return a - b;
        }
        /**
         * @dev Returns the integer division of two unsigned integers, reverting with custom message on
         * division by zero. The result is rounded towards zero.
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {tryDiv}.
         *
         * Counterpart to Solidity's `/` operator. Note: this function uses a
         * `revert` opcode (which leaves remaining gas untouched) while Solidity
         * uses an invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function div(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b > 0, errorMessage);
            return a / b;
        }
        /**
         * @dev Returns the remainder of dividing two unsigned integers. (unsigned integer modulo),
         * reverting with custom message when dividing by zero.
         *
         * CAUTION: This function is deprecated because it requires allocating memory for the error
         * message unnecessarily. For custom revert reasons use {tryMod}.
         *
         * Counterpart to Solidity's `%` operator. This function uses a `revert`
         * opcode (which leaves remaining gas untouched) while Solidity uses an
         * invalid opcode to revert (consuming all remaining gas).
         *
         * Requirements:
         *
         * - The divisor cannot be zero.
         */
        function mod(uint256 a, uint256 b, string memory errorMessage) internal pure returns (uint256) {
            require(b > 0, errorMessage);
            return a % b;
        }
    }
    

    File 2 of 2: Vyper_contract
    # @version 0.2.4
    """
    @title Curve DAO Token
    @author Curve Finance
    @license MIT
    @notice ERC20 with piecewise-linear mining supply.
    @dev Based on the ERC-20 token standard as defined at
         https://eips.ethereum.org/EIPS/eip-20
    """
    
    from vyper.interfaces import ERC20
    
    implements: ERC20
    
    
    event Transfer:
        _from: indexed(address)
        _to: indexed(address)
        _value: uint256
    
    event Approval:
        _owner: indexed(address)
        _spender: indexed(address)
        _value: uint256
    
    event UpdateMiningParameters:
        time: uint256
        rate: uint256
        supply: uint256
    
    event SetMinter:
        minter: address
    
    event SetAdmin:
        admin: address
    
    
    name: public(String[64])
    symbol: public(String[32])
    decimals: public(uint256)
    
    balanceOf: public(HashMap[address, uint256])
    allowances: HashMap[address, HashMap[address, uint256]]
    total_supply: uint256
    
    minter: public(address)
    admin: public(address)
    
    # General constants
    YEAR: constant(uint256) = 86400 * 365
    
    # Allocation:
    # =========
    # * shareholders - 30%
    # * emplyees - 3%
    # * DAO-controlled reserve - 5%
    # * Early users - 5%
    # == 43% ==
    # left for inflation: 57%
    
    # Supply parameters
    INITIAL_SUPPLY: constant(uint256) = 1_303_030_303
    INITIAL_RATE: constant(uint256) = 274_815_283 * 10 ** 18 / YEAR  # leading to 43% premine
    RATE_REDUCTION_TIME: constant(uint256) = YEAR
    RATE_REDUCTION_COEFFICIENT: constant(uint256) = 1189207115002721024  # 2 ** (1/4) * 1e18
    RATE_DENOMINATOR: constant(uint256) = 10 ** 18
    INFLATION_DELAY: constant(uint256) = 86400
    
    # Supply variables
    mining_epoch: public(int128)
    start_epoch_time: public(uint256)
    rate: public(uint256)
    
    start_epoch_supply: uint256
    
    
    @external
    def __init__(_name: String[64], _symbol: String[32], _decimals: uint256):
        """
        @notice Contract constructor
        @param _name Token full name
        @param _symbol Token symbol
        @param _decimals Number of decimals for token
        """
        init_supply: uint256 = INITIAL_SUPPLY * 10 ** _decimals
        self.name = _name
        self.symbol = _symbol
        self.decimals = _decimals
        self.balanceOf[msg.sender] = init_supply
        self.total_supply = init_supply
        self.admin = msg.sender
        log Transfer(ZERO_ADDRESS, msg.sender, init_supply)
    
        self.start_epoch_time = block.timestamp + INFLATION_DELAY - RATE_REDUCTION_TIME
        self.mining_epoch = -1
        self.rate = 0
        self.start_epoch_supply = init_supply
    
    
    @internal
    def _update_mining_parameters():
        """
        @dev Update mining rate and supply at the start of the epoch
             Any modifying mining call must also call this
        """
        _rate: uint256 = self.rate
        _start_epoch_supply: uint256 = self.start_epoch_supply
    
        self.start_epoch_time += RATE_REDUCTION_TIME
        self.mining_epoch += 1
    
        if _rate == 0:
            _rate = INITIAL_RATE
        else:
            _start_epoch_supply += _rate * RATE_REDUCTION_TIME
            self.start_epoch_supply = _start_epoch_supply
            _rate = _rate * RATE_DENOMINATOR / RATE_REDUCTION_COEFFICIENT
    
        self.rate = _rate
    
        log UpdateMiningParameters(block.timestamp, _rate, _start_epoch_supply)
    
    
    @external
    def update_mining_parameters():
        """
        @notice Update mining rate and supply at the start of the epoch
        @dev Callable by any address, but only once per epoch
             Total supply becomes slightly larger if this function is called late
        """
        assert block.timestamp >= self.start_epoch_time + RATE_REDUCTION_TIME  # dev: too soon!
        self._update_mining_parameters()
    
    
    @external
    def start_epoch_time_write() -> uint256:
        """
        @notice Get timestamp of the current mining epoch start
                while simultaneously updating mining parameters
        @return Timestamp of the epoch
        """
        _start_epoch_time: uint256 = self.start_epoch_time
        if block.timestamp >= _start_epoch_time + RATE_REDUCTION_TIME:
            self._update_mining_parameters()
            return self.start_epoch_time
        else:
            return _start_epoch_time
    
    
    @external
    def future_epoch_time_write() -> uint256:
        """
        @notice Get timestamp of the next mining epoch start
                while simultaneously updating mining parameters
        @return Timestamp of the next epoch
        """
        _start_epoch_time: uint256 = self.start_epoch_time
        if block.timestamp >= _start_epoch_time + RATE_REDUCTION_TIME:
            self._update_mining_parameters()
            return self.start_epoch_time + RATE_REDUCTION_TIME
        else:
            return _start_epoch_time + RATE_REDUCTION_TIME
    
    
    @internal
    @view
    def _available_supply() -> uint256:
        return self.start_epoch_supply + (block.timestamp - self.start_epoch_time) * self.rate
    
    
    @external
    @view
    def available_supply() -> uint256:
        """
        @notice Current number of tokens in existence (claimed or unclaimed)
        """
        return self._available_supply()
    
    
    @external
    @view
    def mintable_in_timeframe(start: uint256, end: uint256) -> uint256:
        """
        @notice How much supply is mintable from start timestamp till end timestamp
        @param start Start of the time interval (timestamp)
        @param end End of the time interval (timestamp)
        @return Tokens mintable from `start` till `end`
        """
        assert start <= end  # dev: start > end
        to_mint: uint256 = 0
        current_epoch_time: uint256 = self.start_epoch_time
        current_rate: uint256 = self.rate
    
        # Special case if end is in future (not yet minted) epoch
        if end > current_epoch_time + RATE_REDUCTION_TIME:
            current_epoch_time += RATE_REDUCTION_TIME
            current_rate = current_rate * RATE_DENOMINATOR / RATE_REDUCTION_COEFFICIENT
    
        assert end <= current_epoch_time + RATE_REDUCTION_TIME  # dev: too far in future
    
        for i in range(999):  # Curve will not work in 1000 years. Darn!
            if end >= current_epoch_time:
                current_end: uint256 = end
                if current_end > current_epoch_time + RATE_REDUCTION_TIME:
                    current_end = current_epoch_time + RATE_REDUCTION_TIME
    
                current_start: uint256 = start
                if current_start >= current_epoch_time + RATE_REDUCTION_TIME:
                    break  # We should never get here but what if...
                elif current_start < current_epoch_time:
                    current_start = current_epoch_time
    
                to_mint += current_rate * (current_end - current_start)
    
                if start >= current_epoch_time:
                    break
    
            current_epoch_time -= RATE_REDUCTION_TIME
            current_rate = current_rate * RATE_REDUCTION_COEFFICIENT / RATE_DENOMINATOR  # double-division with rounding made rate a bit less => good
            assert current_rate <= INITIAL_RATE  # This should never happen
    
        return to_mint
    
    
    @external
    def set_minter(_minter: address):
        """
        @notice Set the minter address
        @dev Only callable once, when minter has not yet been set
        @param _minter Address of the minter
        """
        assert msg.sender == self.admin  # dev: admin only
        assert self.minter == ZERO_ADDRESS  # dev: can set the minter only once, at creation
        self.minter = _minter
        log SetMinter(_minter)
    
    
    @external
    def set_admin(_admin: address):
        """
        @notice Set the new admin.
        @dev After all is set up, admin only can change the token name
        @param _admin New admin address
        """
        assert msg.sender == self.admin  # dev: admin only
        self.admin = _admin
        log SetAdmin(_admin)
    
    
    @external
    @view
    def totalSupply() -> uint256:
        """
        @notice Total number of tokens in existence.
        """
        return self.total_supply
    
    
    @external
    @view
    def allowance(_owner : address, _spender : address) -> uint256:
        """
        @notice Check the amount of tokens that an owner allowed to a spender
        @param _owner The address which owns the funds
        @param _spender The address which will spend the funds
        @return uint256 specifying the amount of tokens still available for the spender
        """
        return self.allowances[_owner][_spender]
    
    
    @external
    def transfer(_to : address, _value : uint256) -> bool:
        """
        @notice Transfer `_value` tokens from `msg.sender` to `_to`
        @dev Vyper does not allow underflows, so the subtraction in
             this function will revert on an insufficient balance
        @param _to The address to transfer to
        @param _value The amount to be transferred
        @return bool success
        """
        assert _to != ZERO_ADDRESS  # dev: transfers to 0x0 are not allowed
        self.balanceOf[msg.sender] -= _value
        self.balanceOf[_to] += _value
        log Transfer(msg.sender, _to, _value)
        return True
    
    
    @external
    def transferFrom(_from : address, _to : address, _value : uint256) -> bool:
        """
         @notice Transfer `_value` tokens from `_from` to `_to`
         @param _from address The address which you want to send tokens from
         @param _to address The address which you want to transfer to
         @param _value uint256 the amount of tokens to be transferred
         @return bool success
        """
        assert _to != ZERO_ADDRESS  # dev: transfers to 0x0 are not allowed
        # NOTE: vyper does not allow underflows
        #       so the following subtraction would revert on insufficient balance
        self.balanceOf[_from] -= _value
        self.balanceOf[_to] += _value
        self.allowances[_from][msg.sender] -= _value
        log Transfer(_from, _to, _value)
        return True
    
    
    @external
    def approve(_spender : address, _value : uint256) -> bool:
        """
        @notice Approve `_spender` to transfer `_value` tokens on behalf of `msg.sender`
        @dev Approval may only be from zero -> nonzero or from nonzero -> zero in order
            to mitigate the potential race condition described here:
            https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
        @param _spender The address which will spend the funds
        @param _value The amount of tokens to be spent
        @return bool success
        """
        assert _value == 0 or self.allowances[msg.sender][_spender] == 0
        self.allowances[msg.sender][_spender] = _value
        log Approval(msg.sender, _spender, _value)
        return True
    
    
    @external
    def mint(_to: address, _value: uint256) -> bool:
        """
        @notice Mint `_value` tokens and assign them to `_to`
        @dev Emits a Transfer event originating from 0x00
        @param _to The account that will receive the created tokens
        @param _value The amount that will be created
        @return bool success
        """
        assert msg.sender == self.minter  # dev: minter only
        assert _to != ZERO_ADDRESS  # dev: zero address
    
        if block.timestamp >= self.start_epoch_time + RATE_REDUCTION_TIME:
            self._update_mining_parameters()
    
        _total_supply: uint256 = self.total_supply + _value
        assert _total_supply <= self._available_supply()  # dev: exceeds allowable mint amount
        self.total_supply = _total_supply
    
        self.balanceOf[_to] += _value
        log Transfer(ZERO_ADDRESS, _to, _value)
    
        return True
    
    
    @external
    def burn(_value: uint256) -> bool:
        """
        @notice Burn `_value` tokens belonging to `msg.sender`
        @dev Emits a Transfer event with a destination of 0x00
        @param _value The amount that will be burned
        @return bool success
        """
        self.balanceOf[msg.sender] -= _value
        self.total_supply -= _value
    
        log Transfer(msg.sender, ZERO_ADDRESS, _value)
        return True
    
    
    @external
    def set_name(_name: String[64], _symbol: String[32]):
        """
        @notice Change the token name and symbol to `_name` and `_symbol`
        @dev Only callable by the admin account
        @param _name New token name
        @param _symbol New token symbol
        """
        assert msg.sender == self.admin, "Only admin is allowed to change name"
        self.name = _name
        self.symbol = _symbol