Nimiq Network Interim Token

0xcfb98637bcae43c13323eaa1731ced2b716962fd Copy

ERC20

This contract is an ERC20 token.

Name Nimiq Network Interim Token

Symbol NET

Decimals 18

Total Supply 10,500,000 NET

About

Stats

Public Functions 13

Event Types 5

Code Size 13,510 bytes

Events (5)

Approval Event

Parameters

_owner	address
_spender	address
_value	uint256

LogCreateNET Event

Parameters

_to	address
_value	uint256

LogRedeemNET Event

Parameters

_to	address
_value	uint256
_nimiqAddress	bytes32

LogRefund Event

Parameters

_to	address
_value	uint256

Transfer Event

Parameters

_from	address
_to	address
_value	uint256

Constants (9)

name Constant

string

Nimiq Network Interim Token

symbol Constant

string

NET

decimals Constant

uint256

TOKEN_FIRST_EXCHANGE_RATE Constant

uint256

175

TOKEN_SECOND_EXCHANGE_RATE Constant

uint256

125

TOKEN_CREATION_CAP Constant

uint256

10.5 * UNKNOWN VALUE * UNKNOWN VALUE

ETH_RECEIVED_CAP Constant

uint256

60 * UNKNOWN VALUE * UNKNOWN VALUE

ETH_RECEIVED_MIN Constant

uint256

5 * UNKNOWN VALUE * UNKNOWN VALUE

TOKEN_MIN Constant

uint256

1 * UNKNOWN VALUE

State Variables (12)

version Variable

string

ethFundDeposit Variable

address

state Variable

ContractState

fundingStartBlock Variable

uint256

fundingEndBlock Variable

uint256

exchangeRateChangesBlock Variable

uint256

totalReceivedEth Variable

uint256

totalSupply Variable

uint256

savedState Variable

ContractState

Internal Variable

ethBalances Variable

mapping(address => uint256)

Internal Variable

balances Variable

mapping(address => uint256)

Internal Variable

allowed Variable

mapping(address => mapping(address => uint256))

Internal Variable

Functions Expand All Collapse All

balanceOf

Parameters

Name	Type
_owner	address

Properties

Visibility public

Mutability constant

Source Code

function balanceOf(address _owner) constant returns (uint256 balance) {
  return balances[_owner];
}

transfer

Parameters

Name	Type
_to	address
_value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

isFinalized checks for the following:

state must be equal to ContractState.Finalized

onlyPayloadSize checks for the following:

the number of values in undefined must be equal to 2 * 32 + 4

Source Code

function transfer(address _to, uint256 _value)
  isFinalized // Only allow token transfer after the fundraising has ended
  onlyPayloadSize(2)
  returns (bool success)
{
  return super.transfer(_to, _value);
}

transferFrom

Parameters

Name	Type
_from	address
_to	address
_value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

isFinalized checks for the following:

state must be equal to ContractState.Finalized

onlyPayloadSize checks for the following:

the number of values in undefined must be equal to 2 * 32 + 4

Source Code

function transferFrom(
  address _from,
  address _to,
  uint256 _value
)
  isFinalized // Only allow token transfer after the fundraising has ended
  onlyPayloadSize(3)
  returns (bool success)
{
  return super.transferFrom(_from, _to, _value);
}

approve

Parameters

Name	Type
_spender	address
_value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

onlyPayloadSize checks for the following:

the number of values in undefined must be equal to 2 * 32 + 4

Source Code

function approve(address _spender, uint256 _value)
  onlyPayloadSize(2)
  returns (bool success)
{
  allowed[msg.sender][_spender] = _value;
  Approval(msg.sender, _spender, _value);
  return true;
}

allowance

Parameters

Name	Type
_owner	address
_spender	address

Properties

Visibility public

Mutability constant

Modifiers

onlyPayloadSize checks for the following:

the number of values in undefined must be equal to 2 * 32 + 4

Source Code

function allowance(address _owner, address _spender)
  constant
  onlyPayloadSize(2)
  returns (uint256 remaining)
{
  return allowed[_owner][_spender];
}

createTokens

Parameters

This function has no parameters.

Properties

Visibility public

Mutability payable

Modifiers

isFundraising checks for the following:

state must be equal to ContractState.Fundraising

Requirements

fundingStartBlock must be less than or equal to block.number

fundingEndBlock must be greater than or equal to block.number

msg.value must be greater than 0

checkedReceivedEth must be less than or equal to ETH_RECEIVED_CAP

tokens must be greater than or equal to TOKEN_MIN

checkedSupply must be less than or equal to TOKEN_CREATION_CAP

Source Code

function createTokens() external payable isFundraising {
  require(block.number >= fundingStartBlock);
  require(block.number <= fundingEndBlock);
  require(msg.value > 0);

  // First we check the ETH cap, as it's easier to calculate, return
  // the contribution if the cap has been reached already
  uint256 checkedReceivedEth = safeAdd(totalReceivedEth, msg.value);
  require(checkedReceivedEth <= ETH_RECEIVED_CAP);

  // If all is fine with the ETH cap, we continue to check the
  // minimum amount of tokens and the cap for how many tokens
  // have been generated so far
  uint256 tokens = safeMult(msg.value, getCurrentTokenPrice());
  require(tokens >= TOKEN_MIN);
  uint256 checkedSupply = safeAdd(totalSupply, tokens);
  require(checkedSupply <= TOKEN_CREATION_CAP);

  // Only when all the checks have passed, then we update the state (ethBalances,
  // totalReceivedEth, totalSupply, and balances) of the contract
  ethBalances[msg.sender] = safeAdd(ethBalances[msg.sender], msg.value);
  totalReceivedEth = checkedReceivedEth;
  totalSupply = checkedSupply;
  balances[msg.sender] += tokens; // safeAdd not needed; bad semantics to use here

  // Log the creation of this tokens
  LogCreateNET(msg.sender, tokens);
}

redeemTokens

Parameters

Name	Type
nimiqAddress	bytes32

Properties

Visibility public

Mutability transaction

Modifiers

isRedeeming checks for the following:

state must be equal to ContractState.Redeeming

Requirements

netVal must be greater than or equal to TOKEN_MIN

the result of calling undefined with ethFundDeposit, netVal must not be true

Source Code

function redeemTokens(bytes32 nimiqAddress) external isRedeeming {
  uint256 netVal = balances[msg.sender];
  require(netVal >= TOKEN_MIN); // At least TOKEN_MIN tokens have to be redeemed

  // Move the tokens of the caller to Nimiq's address
  if (!super.transfer(ethFundDeposit, netVal)) throw;

  // Log the redeeming of this tokens
  LogRedeemNET(msg.sender, netVal, nimiqAddress);
}

retrieveEth

Parameters

Name	Type
_value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

minimumReached checks for the following:

totalReceivedEth must be greater than or equal to ETH_RECEIVED_MIN

onlyOwner checks for the following:

ethFundDeposit must be equal to the sender's address

Requirements

_value must be less than or equal to this.balance

Source Code

function retrieveEth(uint256 _value) external minimumReached onlyOwner {
  require(_value <= this.balance);

  // send the eth to Nimiq Creators
  ethFundDeposit.transfer(_value);
}

finalize

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

isFundraising checks for the following:

state must be equal to ContractState.Fundraising

minimumReached checks for the following:

totalReceivedEth must be greater than or equal to ETH_RECEIVED_MIN

onlyOwner checks for the following:

ethFundDeposit must be equal to the sender's address

Requirements

One or more of the following: - totalReceivedEth must be greater than or equal to ETH_RECEIVED_CAP - OR totalSupply must be greater than or equal to TOKEN_CREATION_CAP - OR fundingEndBlock must be less than block.number

Source Code

function finalize()
  external
  isFundraising
  minimumReached
  onlyOwner // Only the owner of the ethFundDeposit address can finalize the contract
{
  require(
    block.number > fundingEndBlock ||
      totalSupply >= TOKEN_CREATION_CAP ||
      totalReceivedEth >= ETH_RECEIVED_CAP
  ); // Only allow to finalize the contract before the ending block if we already reached any of the two caps

  // Move the contract to Finalized state
  state = ContractState.Finalized;
  savedState = ContractState.Finalized;

  // Send the ETH to Nimiq Creators
  ethFundDeposit.transfer(this.balance);
}

startRedeeming

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

isFinalized checks for the following:

state must be equal to ContractState.Finalized

onlyOwner checks for the following:

ethFundDeposit must be equal to the sender's address

Source Code

function startRedeeming()
  external
  isFinalized // The redeeming period can only be started after the contract is finalized
  onlyOwner // Only the owner of the ethFundDeposit address can start the redeeming period
{
  // Move the contract to Redeeming state
  state = ContractState.Redeeming;
  savedState = ContractState.Redeeming;
}

pause

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

notPaused checks for the following:

state must not be equal to ContractState.Paused

onlyOwner checks for the following:

ethFundDeposit must be equal to the sender's address

Source Code

function pause()
  external
  notPaused // Prevent the contract getting stuck in the Paused state
  onlyOwner // Only the owner of the ethFundDeposit address can pause the contract
{
  // Move the contract to Paused state
  savedState = state;
  state = ContractState.Paused;
}

proceed

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

isPaused checks for the following:

state must be equal to ContractState.Paused

onlyOwner checks for the following:

ethFundDeposit must be equal to the sender's address

Source Code

function proceed()
  external
  isPaused
  onlyOwner // Only the owner of the ethFundDeposit address can proceed with the contract
{
  // Move the contract to the previous state
  state = savedState;
}

refund

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

isFundraisingIgnorePaused checks for the following:

One or more of the following: - state must be equal to ContractState.Fundraising

Requirements

fundingEndBlock must be less than block.number

totalReceivedEth must be less than ETH_RECEIVED_MIN

netVal must be greater than 0

ethVal must be greater than 0

Source Code

function refund()
  external
  isFundraisingIgnorePaused // Refunding is only possible in the fundraising phase (no matter if paused) by definition
{
  require(block.number > fundingEndBlock); // Prevents refund until fundraising period is over
  require(totalReceivedEth < ETH_RECEIVED_MIN); // No refunds if the minimum has been reached

  uint256 netVal = balances[msg.sender];
  require(netVal > 0);
  uint256 ethVal = ethBalances[msg.sender];
  require(ethVal > 0);

  // Update the state only after all the checks have passed
  balances[msg.sender] = 0;
  ethBalances[msg.sender] = 0;
  totalSupply = safeSubtract(totalSupply, netVal); // Extra safe

  // Log this refund
  LogRefund(msg.sender, ethVal);

  // Send the contributions only after we have updated all the balances
  // If you're using a contract, make sure it works with .transfer() gas limits
  msg.sender.transfer(ethVal);
}

Internal Functions Expand All Collapse All

Internal functions are parts of the contract that can't be used directly, but instead are used by the public functions listed above.

internal NEToken.getCurrentTokenPrice

Parameters

This function has no parameters.

Properties

Visibility private

Mutability constant

Source Code

function getCurrentTokenPrice()
  private
  constant
  returns (uint256 currentPrice)
{
  if (block.number < exchangeRateChangesBlock) {
    return TOKEN_FIRST_EXCHANGE_RATE;
  } else {
    return TOKEN_SECOND_EXCHANGE_RATE;
  }
}

internal SafeMath.safeAdd

Parameters

Name	Type
x	uint256
y	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function safeAdd(uint256 x, uint256 y) internal returns (uint256) {
  uint256 z = x + y;
  assert((z >= x) && (z >= y));
  return z;
}

internal SafeMath.safeSubtract

Parameters

Name	Type
x	uint256
y	uint256

Properties

Visibility internal

Mutability transaction

Requirements

x must be greater than or equal to y

Source Code

function safeSubtract(uint256 x, uint256 y) internal returns (uint256) {
  assert(x >= y);
  uint256 z = x - y;
  return z;
}

internal SafeMath.safeMult

Parameters

Name	Type
x	uint256
y	uint256

Properties

Visibility internal

Mutability transaction

Requirements

One or more of the following:

Source Code

function safeMult(uint256 x, uint256 y) internal returns (uint256) {
  uint256 z = x * y;
  assert((x == 0) || (z / x == y));
  return z;
}

Nimiq Network Interim Token

ERC20

About

Stats

Events (5) keyboard_arrow_up

Approval Event

Parameters help Event parameters list the data that an event contains.

LogCreateNET Event

Parameters help Event parameters list the data that an event contains.

LogRedeemNET Event

Parameters help Event parameters list the data that an event contains.

LogRefund Event

Parameters help Event parameters list the data that an event contains.

Transfer Event

Parameters help Event parameters list the data that an event contains.

Constants (9) keyboard_arrow_up

name Constant

symbol Constant

decimals Constant

TOKEN_FIRST_EXCHANGE_RATE Constant

TOKEN_SECOND_EXCHANGE_RATE Constant

TOKEN_CREATION_CAP Constant

ETH_RECEIVED_CAP Constant

ETH_RECEIVED_MIN Constant

TOKEN_MIN Constant

State Variables (12) keyboard_arrow_up

version Variable

ethFundDeposit Variable

state Variable

fundingStartBlock Variable

fundingEndBlock Variable

exchangeRateChangesBlock Variable

totalReceivedEth Variable

totalSupply Variable

savedState Variable

ethBalances Variable

balances Variable

allowed Variable

Functions Expand All Collapse All

balanceOf keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Source Code

transfer keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

isFinalized checks for the following:

onlyPayloadSize checks for the following:

Source Code

transferFrom keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

isFinalized checks for the following:

onlyPayloadSize checks for the following:

Source Code

approve keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

onlyPayloadSize checks for the following:

Source Code

allowance keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

onlyPayloadSize checks for the following:

Source Code

createTokens keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

isFundraising checks for the following:

Requirements help Requirements are checks that the function makes when it runs, and give you insight on what conditions are required for the function to succeed.

Source Code

redeemTokens keyboard_arrow_up

Parameters help Function parameters list what input the function expects from the user. Each parameter must be given a value.

Properties

Modifiers help Modifiers are additions to a function that typically make various checks before the function is run.

Events (5)

Parameters

Parameters

Parameters

Parameters

Parameters

Constants (9)

State Variables (12)

balanceOf

Parameters

transfer

Parameters

Modifiers

transferFrom

Parameters

Modifiers

approve

Parameters

Modifiers

allowance

Parameters

Modifiers

createTokens

Parameters

Modifiers

Requirements

redeemTokens

Parameters

Modifiers

Requirements

retrieveEth

Parameters

Modifiers

Requirements

finalize

Parameters

Modifiers

Requirements

startRedeeming

Parameters

Modifiers

pause

Parameters

Modifiers

proceed

Parameters

Modifiers

refund

Parameters

Modifiers

Requirements

internal NEToken.getCurrentTokenPrice

Parameters

internal SafeMath.safeAdd

Parameters

internal SafeMath.safeSubtract

Parameters

Requirements

internal SafeMath.safeMult

Parameters

Requirements