Ethfinex Nectar Token

0xcc80c051057b774cd75067dc48f8987c4eb97a5e Copy

ERC20

This contract is an ERC20 token.

Name Ethfinex Nectar Token

Symbol NEC

Decimals 18

Total Supply 618,133,330 NEC

About

Nectar (NEC) is a cryptocurrency and operates on the Ethereum platform. Nectar has a current supply of 618,133,330.107871 with 0 in circulation. The last known price of Nectar is 0.05104487 USD and is up 0.97 over the last 24 hours. It is currently trading on 4 active market(s) with $6,667.20 traded over the last 24 hours. More information can be found at https://nectar.community/.

Stats

Public Functions 22

Event Types 5

Code Size 30,475 bytes

Events (5)

Approval Event

Parameters

_owner	address
_spender	address
_amount	uint256

Burned Event

Parameters

who	address
_amount	uint256

ClaimedTokens Event

Parameters

_token	address
_controller	address
_amount	uint

NewCloneToken Event

Parameters

_cloneToken	address
_snapshotBlock	uint

Transfer Event

Parameters

_from	address
_to	address
_amount	uint256

Constants (1)

MAX_UINT Constant

uint

UNKNOWN VALUE - 1

State Variables (15)

burningEnabled Variable

bool

name Variable

string

decimals Variable

uint8

symbol Variable

string

version Variable

string

parentToken Variable

address

parentSnapShotBlock Variable

uint

creationBlock Variable

uint

transfersEnabled Variable

bool

tokenFactory Variable

address

controller Variable

address

balances Variable

mapping(address => Checkpoint[])

Internal Variable

allowed Variable

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

Internal Variable

totalSupplyHistory Variable

Checkpoint[]

Internal Variable

totalPledgedFeesHistory Variable

Checkpoint[]

Internal Variable

Functions Expand All Collapse All

changeController

Parameters

Name	Type
_newController	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Source Code

function changeController(address _newController) public onlyController {
  controller = _newController;
}

transfer

Parameters

Name	Type
_to	address
_amount	uint256

Properties

Visibility public

Mutability transaction

Requirements

transfersEnabled must be true

parentSnapShotBlock must be less than block.number

previousBalanceFrom must be greater than or equal to _amount

previousBalanceTo must be less than or equal to previousBalanceTo + _amount

Source Code

function transfer(address _to, uint256 _amount) public returns (bool success) {
  require(transfersEnabled);
  doTransfer(msg.sender, _to, _amount);
  return true;
}

transferFrom

Parameters

Name	Type
_from	address
_to	address
_amount	uint256

Properties

Visibility public

Mutability transaction

Requirements

parentSnapShotBlock must be less than block.number

previousBalanceFrom must be greater than or equal to _amount

previousBalanceTo must be less than or equal to previousBalanceTo + _amount

Source Code

function transferFrom(
  address _from,
  address _to,
  uint256 _amount
) public returns (bool success) {
  // The controller of this contract can move tokens around at will,
  //  this is important to recognize! Confirm that you trust the
  //  controller of this contract, which in most situations should be
  //  another open source smart contract or 0x0
  if (msg.sender != controller) {
    require(transfersEnabled);

    // The standard ERC 20 transferFrom functionality
    if (allowed[_from][msg.sender] < MAX_UINT) {
      require(allowed[_from][msg.sender] >= _amount);
      allowed[_from][msg.sender] -= _amount;
    }
  }
  doTransfer(_from, _to, _amount);
  return true;
}

balanceOf

Parameters

Name	Type
_owner	address

Properties

Visibility public

Mutability constant

Source Code

function balanceOf(address _owner) public constant returns (uint256 balance) {
  return balanceOfAt(_owner, block.number);
}

approve

Parameters

Name	Type
_spender	address
_amount	uint256

Properties

Visibility public

Mutability transaction

Requirements

transfersEnabled must be true

One or more of the following:

Source Code

function approve(address _spender, uint256 _amount)
  public
  returns (bool success)
{
  require(transfersEnabled);

  // To change the approve amount you first have to reduce the addresses`
  //  allowance to zero by calling `approve(_spender,0)` if it is not
  //  already 0 to mitigate the race condition described here:
  //  https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
  require((_amount == 0) || (allowed[msg.sender][_spender] == 0));

  // Alerts the token controller of the approve function call
  if (isContract(controller)) {
    require(
      TokenController(controller).onApprove(msg.sender, _spender, _amount)
    );
  }

  allowed[msg.sender][_spender] = _amount;
  Approval(msg.sender, _spender, _amount);
  return true;
}

allowance

Parameters

Name	Type
_owner	address
_spender	address

Properties

Visibility public

Mutability constant

Source Code

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

approveAndCall

Parameters

Name	Type
_spender	address
_amount	uint256
_extraData	bytes

Properties

Visibility public

Mutability transaction

Requirements

null

Source Code

function approveAndCall(
  address _spender,
  uint256 _amount,
  bytes _extraData
) public returns (bool success) {
  require(approve(_spender, _amount));

  ApproveAndCallFallBack(_spender).receiveApproval(
    msg.sender,
    _amount,
    this,
    _extraData
  );

  return true;
}

totalSupply

Parameters

This function has no parameters.

Properties

Visibility public

Mutability constant

Source Code

function totalSupply() public constant returns (uint256) {
  return totalSupplyAt(block.number);
}

balanceOfAt

Parameters

Name	Type
_owner	address
_blockNumber	uint

Properties

Visibility public

Mutability constant

Source Code

function balanceOfAt(address _owner, uint256 _blockNumber)
  public
  constant
  returns (uint256)
{
  // These next few lines are used when the balance of the token is
  //  requested before a check point was ever created for this token, it
  //  requires that the `parentToken.balanceOfAt` be queried at the
  //  genesis block for that token as this contains initial balance of
  //  this token
  if (
    (balances[_owner].length == 0) ||
    (balances[_owner][0].fromBlock > _blockNumber)
  ) {
    if (address(parentToken) != 0) {
      return
        parentToken.balanceOfAt(_owner, min(_blockNumber, parentSnapShotBlock));
    } else {
      // Has no parent
      return 0;
    }

    // This will return the expected balance during normal situations
  } else {
    return getValueAt(balances[_owner], _blockNumber);
  }
}

totalSupplyAt

Parameters

Name	Type
_blockNumber	uint

Properties

Visibility public

Mutability constant

Source Code

function totalSupplyAt(uint256 _blockNumber) public constant returns (uint256) {
  // These next few lines are used when the totalSupply of the token is
  //  requested before a check point was ever created for this token, it
  //  requires that the `parentToken.totalSupplyAt` be queried at the
  //  genesis block for this token as that contains totalSupply of this
  //  token at this block number.
  if (
    (totalSupplyHistory.length == 0) ||
    (totalSupplyHistory[0].fromBlock > _blockNumber)
  ) {
    if (address(parentToken) != 0) {
      return parentToken.totalSupplyAt(min(_blockNumber, parentSnapShotBlock));
    } else {
      return 0;
    }

    // This will return the expected totalSupply during normal situations
  } else {
    return getValueAt(totalSupplyHistory, _blockNumber);
  }
}

totalPledgedFees

Parameters

This function has no parameters.

Properties

Visibility public

Mutability constant

Source Code

function totalPledgedFees() public constant returns (uint256) {
  return totalPledgedFeesAt(block.number);
}

totalPledgedFeesAt

Parameters

Name	Type
_blockNumber	uint

Properties

Visibility public

Mutability constant

Source Code

function totalPledgedFeesAt(uint256 _blockNumber)
  public
  constant
  returns (uint256)
{
  // These next few lines are used when the totalPledgedFees of the token is
  //  requested before a check point was ever created for this token, it
  //  requires that the `parentToken.totalPledgedFeesAt` be queried at the
  //  genesis block for this token as that contains totalPledgedFees of this
  //  token at this block number.
  if (
    (totalPledgedFeesHistory.length == 0) ||
    (totalPledgedFeesHistory[0].fromBlock > _blockNumber)
  ) {
    if (address(parentToken) != 0) {
      return
        parentToken.totalPledgedFeesAt(min(_blockNumber, parentSnapShotBlock));
    } else {
      return 0;
    }

    // This will return the expected totalPledgedFees during normal situations
  } else {
    return getValueAt(totalPledgedFeesHistory, _blockNumber);
  }
}

pledgeFees

Parameters

Name	Type
_value	uint

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Requirements

curTotalFees must be less than or equal to curTotalFees + _value

Source Code

function pledgeFees(uint256 _value) public onlyController returns (bool) {
  uint256 curTotalFees = totalPledgedFees();
  require(curTotalFees + _value >= curTotalFees); // Check for overflow
  updateValueAtNow(totalPledgedFeesHistory, curTotalFees + _value);
  return true;
}

reducePledgedFees

Parameters

Name	Type
_value	uint

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Requirements

curTotalFees must be greater than or equal to _value

Source Code

function reducePledgedFees(uint256 _value)
  public
  onlyController
  returns (bool)
{
  uint256 curTotalFees = totalPledgedFees();
  require(curTotalFees >= _value);
  updateValueAtNow(totalPledgedFeesHistory, curTotalFees - _value);
  return true;
}

createCloneToken

Parameters

Name	Type
_cloneTokenName	string
_cloneDecimalUnits	uint8
_cloneTokenSymbol	string
_snapshotBlock	uint
_transfersEnabled	bool

Properties

Visibility public

Mutability transaction

Source Code

function createCloneToken(
  string _cloneTokenName,
  uint8 _cloneDecimalUnits,
  string _cloneTokenSymbol,
  uint256 _snapshotBlock,
  bool _transfersEnabled
) public returns (address) {
  if (_snapshotBlock == 0) _snapshotBlock = block.number;
  MiniMeToken cloneToken = tokenFactory.createCloneToken(
    this,
    _snapshotBlock,
    _cloneTokenName,
    _cloneDecimalUnits,
    _cloneTokenSymbol,
    _transfersEnabled
  );

  cloneToken.changeController(msg.sender);

  // An event to make the token easy to find on the blockchain
  NewCloneToken(address(cloneToken), _snapshotBlock);
  return address(cloneToken);
}

generateTokens

Parameters

Name	Type
_owner	address
_amount	uint

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Requirements

curTotalSupply must be less than or equal to curTotalSupply + _amount

previousBalanceTo must be less than or equal to previousBalanceTo + _amount

Source Code

function generateTokens(address _owner, uint256 _amount)
  public
  onlyController
  returns (bool)
{
  uint256 curTotalSupply = totalSupply();
  require(curTotalSupply + _amount >= curTotalSupply); // Check for overflow
  uint256 previousBalanceTo = balanceOf(_owner);
  require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
  updateValueAtNow(totalSupplyHistory, curTotalSupply + _amount);
  updateValueAtNow(balances[_owner], previousBalanceTo + _amount);
  Transfer(0, _owner, _amount);
  return true;
}

destroyTokens

Parameters

Name	Type
_owner	address
_amount	uint

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Requirements

curTotalSupply must be greater than or equal to _amount

previousBalanceFrom must be greater than or equal to _amount

Source Code

function destroyTokens(address _owner, uint256 _amount)
  public
  onlyController
  returns (bool)
{
  uint256 curTotalSupply = totalSupply();
  require(curTotalSupply >= _amount);
  uint256 previousBalanceFrom = balanceOf(_owner);
  require(previousBalanceFrom >= _amount);
  updateValueAtNow(totalSupplyHistory, curTotalSupply - _amount);
  updateValueAtNow(balances[_owner], previousBalanceFrom - _amount);
  Transfer(_owner, 0, _amount);
  return true;
}

enableTransfers

Parameters

Name	Type
_transfersEnabled	bool

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Source Code

function enableTransfers(bool _transfersEnabled) public onlyController {
  transfersEnabled = _transfersEnabled;
}

constructor

Parameters

This function has no parameters.

Properties

Visibility public

Mutability payable

Requirements

null

Source Code

function() public payable {
  require(isContract(controller));
  require(
    TokenController(controller).proxyPayment.value(msg.value)(msg.sender)
  );
}

claimTokens

Parameters

Name	Type
_token	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Source Code

function claimTokens(address _token) public onlyController {
  if (_token == 0x0) {
    controller.transfer(this.balance);
    return;
  }

  MiniMeToken token = MiniMeToken(_token);
  uint256 balance = token.balanceOf(this);
  token.transfer(controller, balance);
  ClaimedTokens(_token, controller, balance);
}

enableBurning

Parameters

Name	Type
_burningEnabled	bool

Properties

Visibility public

Mutability transaction

Modifiers

onlyController checks for the following:

controller must be equal to the sender's address

Source Code

function enableBurning(bool _burningEnabled) public onlyController {
  burningEnabled = _burningEnabled;
}

burnAndRetrieve

Parameters

Name	Type
_tokensToBurn	uint256

Properties

Visibility public

Mutability transaction

Requirements

burningEnabled must be true

Source Code

function burnAndRetrieve(uint256 _tokensToBurn) public returns (bool success) {
  require(burningEnabled);

  var previousBalanceFrom = balanceOfAt(msg.sender, block.number);
  if (previousBalanceFrom < _tokensToBurn) {
    return false;
  }

  // Alerts the token controller of the burn function call
  // If enabled, controller will distribute fees and destroy tokens
  // Or any other logic chosen by controller
  if (isContract(controller)) {
    require(TokenController(controller).onBurn(msg.sender, _tokensToBurn));
  }

  Burned(msg.sender, _tokensToBurn);
  return true;
}

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 MiniMeToken.doTransfer

Parameters

Name	Type
_from	address
_to	address
_amount	uint

Properties

Visibility internal

Mutability transaction

Requirements

parentSnapShotBlock must be less than block.number

previousBalanceFrom must be greater than or equal to _amount

previousBalanceTo must be less than or equal to previousBalanceTo + _amount

Source Code

function doTransfer(
  address _from,
  address _to,
  uint256 _amount
) internal {
  if (_amount == 0) {
    Transfer(_from, _to, _amount); // Follow the spec to louch the event when transfer 0
    return;
  }

  require(parentSnapShotBlock < block.number);

  // Do not allow transfer to 0x0 or the token contract itself
  require((_to != 0) && (_to != address(this)));

  // If the amount being transfered is more than the balance of the
  //  account the transfer throws
  var previousBalanceFrom = balanceOfAt(_from, block.number);

  require(previousBalanceFrom >= _amount);

  // Alerts the token controller of the transfer
  if (isContract(controller)) {
    require(TokenController(controller).onTransfer(_from, _to, _amount));
  }

  // First update the balance array with the new value for the address
  //  sending the tokens
  updateValueAtNow(balances[_from], previousBalanceFrom - _amount);

  // Then update the balance array with the new value for the address
  //  receiving the tokens
  var previousBalanceTo = balanceOfAt(_to, block.number);
  require(previousBalanceTo + _amount >= previousBalanceTo); // Check for overflow
  updateValueAtNow(balances[_to], previousBalanceTo + _amount);

  // An event to make the transfer easy to find on the blockchain
  Transfer(_from, _to, _amount);
}

internal MiniMeToken.getValueAt

Parameters

Name	Type
checkpoints	Checkpoint[]
_block	uint

Properties

Visibility internal

Mutability constant

Source Code

function getValueAt(Checkpoint[] storage checkpoints, uint256 _block)
  internal
  constant
  returns (uint256)
{
  if (checkpoints.length == 0) return 0;

  // Shortcut for the actual value
  if (_block >= checkpoints[checkpoints.length - 1].fromBlock)
    return checkpoints[checkpoints.length - 1].value;
  if (_block < checkpoints[0].fromBlock) return 0;

  // Binary search of the value in the array
  uint256 min = 0;
  uint256 max = checkpoints.length - 1;
  while (max > min) {
    uint256 mid = (max + min + 1) / 2;
    if (checkpoints[mid].fromBlock <= _block) {
      min = mid;
    } else {
      max = mid - 1;
    }
  }
  return checkpoints[min].value;
}

internal MiniMeToken.updateValueAtNow

Parameters

Name	Type
checkpoints	Checkpoint[]
_value	uint

Properties

Visibility internal

Mutability transaction

Source Code

function updateValueAtNow(Checkpoint[] storage checkpoints, uint256 _value)
  internal
{
  if (
    (checkpoints.length == 0) ||
    (checkpoints[checkpoints.length - 1].fromBlock < block.number)
  ) {
    Checkpoint storage newCheckPoint = checkpoints[checkpoints.length++];
    newCheckPoint.fromBlock = uint128(block.number);
    newCheckPoint.value = uint128(_value);
  } else {
    Checkpoint storage oldCheckPoint = checkpoints[checkpoints.length - 1];
    oldCheckPoint.value = uint128(_value);
  }
}

internal MiniMeToken.isContract

Parameters

Name	Type
_addr	address

Properties

Visibility internal

Mutability constant

Source Code

function isContract(address _addr) internal constant returns (bool) {
  uint256 size;
  if (_addr == 0) return false;
  assembly {
    size := extcodesize(_addr)
  }
  return size > 0;
}

internal MiniMeToken.min

Parameters

Name	Type
a	uint
b	uint

Properties

Visibility internal

Mutability pure

Source Code

function min(uint256 a, uint256 b) internal pure returns (uint256) {
  return a < b ? a : b;
}

Ethfinex Nectar Token

ERC20

About link description

Stats

Events (5) keyboard_arrow_up

Approval Event

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

Burned Event

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

ClaimedTokens Event

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

NewCloneToken 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 (1) keyboard_arrow_up

MAX_UINT Constant

State Variables (15) keyboard_arrow_up

burningEnabled Variable

name Variable

decimals Variable

symbol Variable

version Variable

parentToken Variable

parentSnapShotBlock Variable

creationBlock Variable

transfersEnabled Variable

tokenFactory Variable

controller Variable

balances Variable

allowed Variable

totalSupplyHistory Variable

totalPledgedFeesHistory Variable

Functions Expand All Collapse All

changeController 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.

onlyController checks for the following:

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

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

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

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

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

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

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

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

Source Code

approveAndCall keyboard_arrow_up

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

Properties

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

totalSupply 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

balanceOfAt 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

totalSupplyAt 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

About

Events (5)

Parameters

Parameters

Parameters

Parameters

Parameters

Constants (1)

State Variables (15)

changeController

Parameters

Modifiers

transfer

Parameters

Requirements

transferFrom

Parameters

Requirements

balanceOf

Parameters

approve

Parameters

Requirements

allowance

Parameters

approveAndCall

Parameters

Requirements

totalSupply

Parameters

balanceOfAt

Parameters

totalSupplyAt

Parameters

totalPledgedFees

Parameters

totalPledgedFeesAt

Parameters

pledgeFees

Parameters

Modifiers

Requirements

reducePledgedFees

Parameters

Modifiers

Requirements

createCloneToken

Parameters

generateTokens

Parameters

Modifiers

Requirements

destroyTokens

Parameters

Modifiers

Requirements

enableTransfers

Parameters

Modifiers

constructor

Parameters

Requirements

claimTokens

Parameters

Modifiers

enableBurning

Parameters

Modifiers

burnAndRetrieve

Parameters

Requirements