NMR Ethereum Smart Contract

Numeraire (NMR) is an ERC-20 token used for staking and burning.

NMR is the native token of the Erasure Protocol.

See documentation for more information.

Security Contact: security@numer.ai

Validated Metrics

NMR circulating supply Etherscan token tracker Coingecko token tracker DeFiPulse token tracker

Deployed Contracts

| Contract | Address | | ------------------- | --------------------------------------------------------------------------------------------------------------------- | | NumeraireBackend | 0x1776e1f26f98b1a5df9cd347953a26dd3cb46671 | | NumeraireDelegateV1 | 0xF32e4724946d4e288B3042d504919CE68C4Fda9c | | NumeraireDelegateV2 | 0x3548718A49EE7cd348e50290D446D9F1A1f9C59E | | NumeraireDelegateV3 | 0x29F709e42C95C604BA76E73316d325077f8eB7b2 | | UpgradeDelegate | 0x3361F79f0819fD5feaA37bea44C8a33d98b2A1cd | | Relay | 0xB17dF4a656505570aD994D023F632D48De04eDF2 |

Security Audits

| Audit | Provider | Date | | ----------------------------------------------- | --------------------------------------------- | ---------- | | NMR Token | New Alchemy | May 2017 | | NMR Code Fix | New Alchemy | April 2018 | | NMR 2.0 | Trail of Bits | July 2019 |

Whitepapers

| Project | Authors | Date | | ------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------- | | Numerai | Richard Craib, Geoffrey Bradway, Xander Dunn, Joey Krug | February 2017 | | Erasure Quant | Richard Craib, James Geary, Jason Paryani | August 2019 | | Erasure Bay | Stephane Gosselin, Jonathan Sidego | March 2020 |

Specification

ERC-20

function approve(address spender, uint256 value);
function transfer(address to, uint256 value);
function transferFrom(address from, address to, uint256 _value);
function totalSupply(); function balanceOf(address _owner); function allowance(address owner, address spender);
event Transfer(address indexed from, address indexed to, uint256 _value); event Approval(address indexed owner, address indexed spender, uint256 _value);

Refer to ERC-20 standard for detailed specification.

Note: NMR deviates from ERC-20 in the implementation of the approve() function to prevent the ERC-20 approve race condition.

The approve() function is limited to changing the allowance from zero or to zero.

In order to change the allowance from a non-zero value to a different non-zero value in a single transaction. The user must use the changeApproval() function.

function changeApproval(address spender, uint256 oldValue, uint256 _newValue);

Sets the approval to a new value while checking that the previous approval value is what we expected.

• _spender is the address of the contract.
• _oldValue is the current amount the contract is allowed to spend.
• _newValue is the new amount to allow the contract to spend.

Burning

The mint() and numeraiTransfer() functions have been repurposed from their initial use in order to support native token burns as implemented in OpenZeppelin's ERC20Burnable.

Note: The caller must check the return values of these functions as they return false on failure.

/**
 * @dev Destoys amount tokens from msg.sender, reducing the total supply.
 *
 * Emits a Transfer event with to set to the zero address.
 *
 * Requirements:
 * - account must have at least amount tokens.
 */
function mint(uint256 _value);
   => function burn(uint256 amount);
/**  * @dev Destoys amount tokens from account.amount is then deducted  * from the caller's allowance.  *  * Emits an Approval event indicating the updated allowance.  * Emits a Transfer event with to set to the zero address.  *  * Requirements:  * - account must have at least amount tokens.  * - account must have approved msg.sender with allowance of at least amount tokens.  */ function numeraiTransfer(address to, uint256 value);    => function burnFrom(address account, uint256 amount);

Custody for Numerai Tournament

Numerai performs custody of the token for participants in the Numerai Tournament. This removes participation barriers as users no longer need to pay for gas or manage their own private keys. The withdraw() function can be used by Numerai to transfer tokens from the first 1 million accounts (0x00...00000000 to 0x00...000F4240).

function withdraw(address from, address to, uint256 _value);

Deprecated Features

All other contract methods belong to the following features which have been disabled as a part of the NMR 2.0 upgrade.

• Multisignature
• Emergency Stops
• Minting
• Upgradeability

Known Addresses

• The Numerai Treasury is a multisig wallet for cold-storage of out-of-circulation tokens.
• The Numerai Hot Wallet is used to reward participants in the Numerai tournaments.