Ultra Token

0xd13c7342e1ef687c5ad21b27c2b65d772cab5c8c Copy

ERC20

This contract is an ERC20 token.

Name Ultra Token

Symbol UOS

Decimals 4

Total Supply 1,000,000,000 UOS

About

Ultra (UOS) is a cryptocurrency and operates on the Ethereum platform. Ultra has a current supply of 1,000,000,000 with 282,789,762.3439 in circulation. The last known price of Ultra is 0.50661333 USD and is up 0.54 over the last 24 hours. It is currently trading on 17 active market(s) with $1,783,331.17 traded over the last 24 hours. More information can be found at https://ultra.io/.

Stats

Public Functions 35

Event Types 12

Code Size 31,176 bytes

Library Use

Uses SafeMath for uint256.

Events (12)

Approval Event

Parameters

owner	address
spender	address
value	uint256

Claim Event

Parameters

claimer	address
claimed	uint256

ImportBalance Event

Parameters

buyers	address[]
tokens	uint256[]
contractName	string

OwnershipTransferred Event

Parameters

previousOwner	address
newOwner	address

Paused Event

Parameters

account

address

PauserAdded Event

Parameters

account

address

PauserRemoved Event

Parameters

account

address

SetKey Event

Parameters

buyer	address
EOSKey	string

SetUpdateApproval Event

Parameters

buyer	address
isApproved	bool

SetVestingContract Event

Parameters

contractName	string
basisPoints	uint256[]
startMonth	uint256

Transfer Event

Parameters

from	address
to	address
value	uint256

Unpaused Event

Parameters

account

address

Structs (2)

VestingContract Struct

Members

basisPoints	uint256[]
startMonth	uint256
endMonth	uint256

BuyerInfo Struct

Members

total	uint256
claimed	uint256
contractName	string

State Variables (15)

_name Variable

string

Internal Variable

_symbol Variable

string

Internal Variable

_decimals Variable

uint8

Internal Variable

_deployTime Variable

uint256

Internal Variable

_month Variable

uint256

Internal Variable

_vestingContracts Variable

mapping(string => VestingContract)

Internal Variable

_buyerInfos Variable

mapping(address => BuyerInfo)

Internal Variable

_keys Variable

mapping(address => string)

Internal Variable

_updateApproval Variable

mapping(address => bool)

Internal Variable

_balances Variable

mapping(address => uint256)

Internal Variable

_allowances Variable

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

Internal Variable

_totalSupply Variable

uint256

Internal Variable

_paused Variable

bool

Internal Variable

_pausers Variable

Roles.Role

Internal Variable

_owner Variable

address

Internal Variable

Functions Expand All Collapse All

owner

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function owner() public view returns (address) {
  return _owner;
}

isOwner

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function isOwner() public view returns (bool) {
  return msg.sender == _owner;
}

renounceOwnership

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

null

Source Code

function renounceOwnership() public onlyOwner {
  emit OwnershipTransferred(_owner, address(0));
  _owner = address(0);
}

transferOwnership

Parameters

Name	Type
newOwner	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

null

Requirements

newOwner must not be equal to UNKNOWN VALUE

Source Code

function transferOwnership(address newOwner) public onlyOwner {
  _transferOwnership(newOwner);
}

isPauser

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Source Code

function isPauser(address account) public view returns (bool) {
  return _pausers.has(account);
}

addPauser

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyPauser checks for the following:

null

Source Code

function addPauser(address account) public onlyPauser {
  _addPauser(account);
}

renouncePauser

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Source Code

function renouncePauser() public {
  _removePauser(msg.sender);
}

paused

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function paused() public view returns (bool) {
  return _paused;
}

pause

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyPauser checks for the following:

null

whenNotPaused checks for the following:

_paused must not be true

Source Code

function pause() public onlyPauser whenNotPaused {
  _paused = true;
  emit Paused(msg.sender);
}

unpause

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyPauser checks for the following:

null

whenPaused checks for the following:

_paused must be true

Source Code

function unpause() public onlyPauser whenPaused {
  _paused = false;
  emit Unpaused(msg.sender);
}

totalSupply

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function totalSupply() public view returns (uint256) {
  return _totalSupply;
}

balanceOf

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Source Code

function balanceOf(address account) public view returns (uint256) {
  return _balances[account];
}

transfer

Parameters

Name	Type
to	address
value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the sender's address must not be equal to UNKNOWN VALUE

recipient must not be equal to UNKNOWN VALUE

Source Code

function transfer(address to, uint256 value)
  public
  whenNotPaused
  returns (bool)
{
  return super.transfer(to, value);
}

allowance

Parameters

Name	Type
owner	address
spender	address

Properties

Visibility public

Mutability view

Source Code

function allowance(address owner, address spender)
  public
  view
  returns (uint256)
{
  return _allowances[owner][spender];
}

approve

Parameters

Name	Type
spender	address
value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the sender's address must not be equal to UNKNOWN VALUE

spender must not be equal to UNKNOWN VALUE

Source Code

function approve(address spender, uint256 value)
  public
  whenNotPaused
  returns (bool)
{
  return super.approve(spender, value);
}

transferFrom

Parameters

Name	Type
from	address
to	address
value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the sender's address must not be equal to UNKNOWN VALUE

recipient must not be equal to UNKNOWN VALUE

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function transferFrom(
  address from,
  address to,
  uint256 value
) public whenNotPaused returns (bool) {
  return super.transferFrom(from, to, value);
}

increaseAllowance

Parameters

Name	Type
spender	address
addedValue	uint256

Properties

Visibility public

Mutability transaction

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function increaseAllowance(address spender, uint256 addedValue)
  public
  returns (bool)
{
  _approve(
    msg.sender,
    spender,
    _allowances[msg.sender][spender].add(addedValue)
  );
  return true;
}

decreaseAllowance

Parameters

Name	Type
spender	address
subtractedValue	uint256

Properties

Visibility public

Mutability transaction

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function decreaseAllowance(address spender, uint256 subtractedValue)
  public
  returns (bool)
{
  _approve(
    msg.sender,
    spender,
    _allowances[msg.sender][spender].sub(subtractedValue)
  );
  return true;
}

increaseAllowance

Parameters

Name	Type
spender	address
addedValue	uint

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function increaseAllowance(address spender, uint256 addedValue)
  public
  whenNotPaused
  returns (bool)
{
  return super.increaseAllowance(spender, addedValue);
}

decreaseAllowance

Parameters

Name	Type
spender	address
subtractedValue	uint

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function decreaseAllowance(address spender, uint256 subtractedValue)
  public
  whenNotPaused
  returns (bool)
{
  return super.decreaseAllowance(spender, subtractedValue);
}

name

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function name() public view returns (string memory) {
  return _name;
}

symbol

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function symbol() public view returns (string memory) {
  return _symbol;
}

decimals

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function decimals() public view returns (uint8) {
  return _decimals;
}

deployTime

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function deployTime() public view returns (uint256) {
  return _deployTime;
}

buyerInformation

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function buyerInformation()
  public
  view
  returns (
    uint256,
    uint256,
    string memory
  )
{
  BuyerInfo storage buyerInfo = _buyerInfos[msg.sender];
  return (buyerInfo.total, buyerInfo.claimed, buyerInfo.contractName);
}

nextVestingDate

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Requirements

buyerInfo.total must be greater than 0

Source Code

function nextVestingDate() public view returns (uint256) {
  BuyerInfo storage buyerInfo = _buyerInfos[msg.sender];
  require(buyerInfo.total > 0, "Buyer does not exist");
  VestingContract storage vestingContract = _vestingContracts[
    buyerInfo.contractName
  ];
  uint256 currentMonth = block.timestamp.sub(_deployTime).div(_month);
  if (currentMonth < vestingContract.startMonth) {
    return _deployTime.add(vestingContract.startMonth.mul(_month));
  } else if (currentMonth >= vestingContract.endMonth) {
    return _deployTime.add(vestingContract.endMonth.mul(_month));
  } else {
    return _deployTime.add(currentMonth.add(1).mul(_month));
  }
}

setVestingContract

Parameters

Name	Type
contractName	string
basisPoints	uint256[]
startMonth	uint256

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

null

whenNotPaused checks for the following:

_paused must not be true

Requirements

the number of values in undefined must be equal to 0

totalBPs must be equal to 10000

Source Code

function setVestingContract(
  string memory contractName,
  uint256[] memory basisPoints,
  uint256 startMonth
) public onlyOwner whenNotPaused returns (bool) {
  VestingContract storage vestingContract = _vestingContracts[contractName];
  require(
    vestingContract.basisPoints.length == 0,
    "can't change an existing contract"
  );
  uint256 totalBPs = 0;
  for (uint256 i = 0; i < basisPoints.length; i++) {
    totalBPs = totalBPs.add(basisPoints[i]);
  }
  require(totalBPs == 10000, "invalid basis points array"); // this also ensures array length is not zero

  vestingContract.basisPoints = basisPoints;
  vestingContract.startMonth = startMonth;
  vestingContract.endMonth = startMonth.add(basisPoints.length).sub(1);

  emit SetVestingContract(contractName, basisPoints, startMonth);
  return true;
}

importBalance

Parameters

Name	Type
buyers	address[]
tokens	uint256[]
contractName	string

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

null

whenNotPaused checks for the following:

_paused must not be true

Requirements

the number of values in buyers must be equal to the number of values in tokens

the number of values in undefined must be greater than 0

Source Code

function importBalance(
  address[] memory buyers,
  uint256[] memory tokens,
  string memory contractName
) public onlyOwner whenNotPaused returns (bool) {
  require(buyers.length == tokens.length, "buyers and balances mismatch");

  VestingContract storage vestingContract = _vestingContracts[contractName];
  require(vestingContract.basisPoints.length > 0, "contract does not exist");

  for (uint256 i = 0; i < buyers.length; i++) {
    require(tokens[i] > 0, "cannot import zero balance");
    BuyerInfo storage buyerInfo = _buyerInfos[buyers[i]];
    require(
      buyerInfo.total == 0,
      "have already imported balance for this buyer"
    );
    buyerInfo.total = tokens[i];
    buyerInfo.contractName = contractName;
  }

  emit ImportBalance(buyers, tokens, contractName);
  return true;
}

claim

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

canClaim must be greater than 0

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function claim() public whenNotPaused returns (bool) {
  uint256 canClaim = claimableToken();

  require(canClaim > 0, "No token is available to claim");

  _buyerInfos[msg.sender].claimed = _buyerInfos[msg.sender].claimed.add(
    canClaim
  );
  _transfer(address(this), msg.sender, canClaim);

  emit Claim(msg.sender, canClaim);
  return true;
}

claimableToken

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function claimableToken() public view returns (uint256) {
  BuyerInfo storage buyerInfo = _buyerInfos[msg.sender];

  if (buyerInfo.claimed < buyerInfo.total) {
    VestingContract storage vestingContract = _vestingContracts[
      buyerInfo.contractName
    ];
    uint256 currentMonth = block.timestamp.sub(_deployTime).div(_month);

    if (currentMonth < vestingContract.startMonth) {
      return uint256(0);
    }

    if (currentMonth >= vestingContract.endMonth) {
      // vest the unclaimed token all at once so there's no remainder
      return buyerInfo.total.sub(buyerInfo.claimed);
    } else {
      uint256 claimableIndex = currentMonth.sub(vestingContract.startMonth);
      uint256 canClaim = 0;
      for (uint256 i = 0; i <= claimableIndex; ++i) {
        canClaim = canClaim.add(vestingContract.basisPoints[i]);
      }
      return canClaim.mul(buyerInfo.total).div(10000).sub(buyerInfo.claimed);
    }
  }
  return uint256(0);
}

register

Parameters

Name	Type
EOSKey	string

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

_paused must not be true

Requirements

the number of values in undefined must be less than or equal to 64

the number of values in undefined must be greater than 0

Source Code

function register(string memory EOSKey) public whenNotPaused returns (bool) {
  _register(EOSKey);
  return true;
}

keyOf

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function keyOf() public view returns (string memory) {
  return _keys[msg.sender];
}

setUpdateApproval

Parameters

Name	Type
buyer	address
isApproved	bool

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

null

Requirements

One or more of the following: - undefined.total must be greater than 0 - OR the result of calling balanceOf with buyer must be greater than 0

Source Code

function setUpdateApproval(address buyer, bool isApproved)
  public
  onlyOwner
  returns (bool)
{
  require(
    balanceOf(buyer) > 0 || _buyerInfos[buyer].total > 0,
    "This account has no token"
  ); // allowance will not be considered
  _updateApproval[buyer] = isApproved;

  emit SetUpdateApproval(buyer, isApproved);
  return true;
}

updateApproved

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function updateApproved() public view returns (bool) {
  return _updateApproval[msg.sender];
}

update

Parameters

Name	Type
EOSKey	string

Properties

Visibility public

Mutability transaction

Requirements

the number of values in undefined must be less than or equal to 64

the number of values in undefined must be greater than 0

Source Code

function update(string memory EOSKey) public returns (bool) {
  require(
    _updateApproval[msg.sender],
    "Need approval from ultra after contract is frozen"
  );
  _register(EOSKey);
  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 UltraToken._register

Parameters

Name	Type
EOSKey	string

Properties

Visibility internal

Mutability transaction

Requirements

the number of values in undefined must be less than or equal to 64

the number of values in undefined must be greater than 0

Source Code

function _register(string memory EOSKey) internal {
  require(
    bytes(EOSKey).length > 0 && bytes(EOSKey).length <= 64,
    "EOS public key length should be less than 64 characters"
  );
  _keys[msg.sender] = EOSKey;

  emit SetKey(msg.sender, EOSKey);
}

internal ERC20._transfer

Parameters

Name	Type
sender	address
recipient	address
amount	uint256

Properties

Visibility internal

Mutability transaction

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function _transfer(
  address sender,
  address recipient,
  uint256 amount
) internal {
  require(sender != address(0), "ERC20: transfer from the zero address");
  require(recipient != address(0), "ERC20: transfer to the zero address");

  _balances[sender] = _balances[sender].sub(amount);
  _balances[recipient] = _balances[recipient].add(amount);
  emit Transfer(sender, recipient, amount);
}

internal ERC20._mint

Parameters

Name	Type
account	address
amount	uint256

Properties

Visibility internal

Mutability transaction

Requirements

account must not be equal to UNKNOWN VALUE

Source Code

function _mint(address account, uint256 amount) internal {
  require(account != address(0), "ERC20: mint to the zero address");

  _totalSupply = _totalSupply.add(amount);
  _balances[account] = _balances[account].add(amount);
  emit Transfer(address(0), account, amount);
}

internal ERC20._burn

Parameters

Name	Type
account	address
value	uint256

Properties

Visibility internal

Mutability transaction

Requirements

account must not be equal to UNKNOWN VALUE

Source Code

function _burn(address account, uint256 value) internal {
  require(account != address(0), "ERC20: burn from the zero address");

  _totalSupply = _totalSupply.sub(value);
  _balances[account] = _balances[account].sub(value);
  emit Transfer(account, address(0), value);
}

internal ERC20._approve

Parameters

Name	Type
owner	address
spender	address
value	uint256

Properties

Visibility internal

Mutability transaction

Requirements

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function _approve(
  address owner,
  address spender,
  uint256 value
) internal {
  require(owner != address(0), "ERC20: approve from the zero address");
  require(spender != address(0), "ERC20: approve to the zero address");

  _allowances[owner][spender] = value;
  emit Approval(owner, spender, value);
}

internal ERC20._burnFrom

Parameters

Name	Type
account	address
amount	uint256

Properties

Visibility internal

Mutability transaction

Requirements

account must not be equal to UNKNOWN VALUE

the sender's address must not be equal to UNKNOWN VALUE

Source Code

function _burnFrom(address account, uint256 amount) internal {
  _burn(account, amount);
  _approve(account, msg.sender, _allowances[account][msg.sender].sub(amount));
}

internal Pausable.constructor

Parameters

This function has no parameters.

Properties

Visibility internal

Mutability transaction

Source Code

constructor() internal {
  _paused = false;
}

internal PauserRole.constructor

Parameters

This function has no parameters.

Properties

Visibility internal

Mutability transaction

Source Code

constructor() internal {
  _addPauser(msg.sender);
}

internal PauserRole._addPauser

Parameters

Name	Type
account	address

Properties

Visibility internal

Mutability transaction

Source Code

function _addPauser(address account) internal {
  _pausers.add(account);
  emit PauserAdded(account);
}

internal PauserRole._removePauser

Parameters

Name	Type
account	address

Properties

Visibility internal

Mutability transaction

Source Code

function _removePauser(address account) internal {
  _pausers.remove(account);
  emit PauserRemoved(account);
}

internal Ownable.constructor

Parameters

This function has no parameters.

Properties

Visibility internal

Mutability transaction

Source Code

constructor() internal {
  _owner = msg.sender;
  emit OwnershipTransferred(address(0), _owner);
}

internal Ownable._transferOwnership

Parameters

Name	Type
newOwner	address

Properties

Visibility internal

Mutability transaction

Requirements

newOwner must not be equal to UNKNOWN VALUE

Source Code

function _transferOwnership(address newOwner) internal {
  require(newOwner != address(0), "Ownable: new owner is the zero address");
  emit OwnershipTransferred(_owner, newOwner);
  _owner = newOwner;
}

Ultra Token

ERC20

About link description

Stats

Library Use

Events (12) keyboard_arrow_up

Approval Event

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

Claim Event

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

ImportBalance Event

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

OwnershipTransferred Event

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

Paused Event

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

PauserAdded Event

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

PauserRemoved Event

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

SetKey Event

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

SetUpdateApproval Event

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

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

Unpaused Event

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

Structs (2) keyboard_arrow_up

VestingContract Struct

Members

BuyerInfo Struct

Members

State Variables (15) keyboard_arrow_up

_name Variable

_symbol Variable

_decimals Variable

_deployTime Variable

_month Variable

_vestingContracts Variable

_buyerInfos Variable

_keys Variable

_updateApproval Variable

_balances Variable

_allowances Variable

_totalSupply Variable

_paused Variable

_pausers Variable

_owner Variable

Functions Expand All Collapse All

owner 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

isOwner 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

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

onlyOwner checks for the following:

Source Code

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

onlyOwner 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

isPauser 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

addPauser keyboard_arrow_up

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

Properties

About

Events (12)

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Structs (2)

State Variables (15)

owner

Parameters

isOwner

Parameters

renounceOwnership

Parameters

Modifiers

transferOwnership

Parameters

Modifiers

Requirements

isPauser

Parameters

addPauser

Parameters

Modifiers

renouncePauser

Parameters

paused

Parameters

pause

Parameters

Modifiers

unpause

Parameters

Modifiers

totalSupply

Parameters

balanceOf

Parameters

transfer

Parameters

Modifiers

Requirements

allowance

Parameters

approve

Parameters

Modifiers

Requirements

transferFrom

Parameters

Modifiers

Requirements

increaseAllowance

Parameters

Requirements

decreaseAllowance

Parameters

Requirements

increaseAllowance