USD Coin

0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 Copy

ERC20

This contract is an ERC20 token.

Name USD Coin

Symbol USDC

Decimals 6

Total Supply 25,604,211,611 USDC

About

USD Coin (USDC) is a cryptocurrency and operates on the Ethereum platform. USD Coin has a current supply of 26,373,978,760.0296. The last known price of USD Coin is 1.00013148 USD and is down -0.02 over the last 24 hours. It is currently trading on 970 active market(s) with $1,940,822,887.60 traded over the last 24 hours. More information can be found at https://www.centre.io/usdc.

Stats

Public Functions 37

Event Types 17

Code Size 77,645 bytes

Events (17)

Approval Event

Parameters

owner	address
spender	address
value	uint256

AuthorizationCanceled Event

Parameters

authorizer	address
nonce	bytes32

AuthorizationUsed Event

Parameters

authorizer	address
nonce	bytes32

Blacklisted Event

Parameters

_account

address

BlacklisterChanged Event

Parameters

newBlacklister

address

Burn Event

Parameters

burner	address
amount	uint256

MasterMinterChanged Event

Parameters

newMasterMinter

address

Mint Event

Parameters

minter	address
to	address
amount	uint256

MinterConfigured Event

Parameters

minter	address
minterAllowedAmount	uint256

MinterRemoved Event

Parameters

oldMinter

address

OwnershipTransferred Event

Parameters

previousOwner	address
newOwner	address

Pause Event

Parameters

PauserChanged Event

Parameters

newAddress

address

RescuerChanged Event

Parameters

newRescuer

address

Transfer Event

Parameters

from	address
to	address
value	uint256

UnBlacklisted Event

Parameters

_account

address

Unpause Event

Parameters

Constants (4)

TRANSFER_WITH_AUTHORIZATION_TYPEHASH Constant

bytes32

0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267

RECEIVE_WITH_AUTHORIZATION_TYPEHASH Constant

bytes32

0xd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8

CANCEL_AUTHORIZATION_TYPEHASH Constant

bytes32

0x158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a1597429

PERMIT_TYPEHASH Constant

bytes32

0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9

State Variables (21)

name Variable

string

symbol Variable

string

decimals Variable

uint8

currency Variable

string

masterMinter Variable

address

pauser Variable

address

paused Variable

bool

blacklister Variable

address

DOMAIN_SEPARATOR Variable

bytes32

_initializedVersion Variable

uint8

Internal Variable

initialized Variable

bool

Internal Variable

balances Variable

mapping(address => uint256)

Internal Variable

allowed Variable

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

Internal Variable

totalSupply_ Variable

uint256

Internal Variable

minters Variable

mapping(address => bool)

Internal Variable

minterAllowed Variable

mapping(address => uint256)

Internal Variable

_owner Variable

address

Internal Variable

blacklisted Variable

mapping(address => bool)

Internal Variable

_rescuer Variable

address

Internal Variable

_authorizationStates Variable

mapping(address => mapping(bytes32 => bool))

Internal Variable

_permitNonces Variable

mapping(address => uint256)

Internal Variable

Functions Expand All Collapse All

nonces

Parameters

Name	Type
owner	address

Properties

Visibility public

Mutability view

Source Code

function nonces(address owner) external view returns (uint256) {
  return _permitNonces[owner];
}

authorizationState

Parameters

Name	Type
authorizer	address
nonce	bytes32

Properties

Visibility public

Mutability view

Source Code

function authorizationState(address authorizer, bytes32 nonce)
  external
  view
  returns (bool)
{
  return _authorizationStates[authorizer][nonce];
}

owner

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

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

transferOwnership

Parameters

Name	Type
newOwner	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

_owner must be equal to the sender's address

Requirements

newOwner must not be equal to UNKNOWN VALUE

Source Code

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

rescuer

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function rescuer() external view returns (address) {
  return _rescuer;
}

rescueERC20

Parameters

Name	Type
tokenContract	IERC20
to	address
amount	uint256

Properties

Visibility public

Mutability transaction

Modifiers

onlyRescuer checks for the following:

_rescuer must be equal to the sender's address

Source Code

function rescueERC20(
  IERC20 tokenContract,
  address to,
  uint256 amount
) external onlyRescuer {
  tokenContract.safeTransfer(to, amount);
}

updateRescuer

Parameters

Name	Type
newRescuer	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

_owner must be equal to the sender's address

Requirements

newRescuer must not be equal to UNKNOWN VALUE

Source Code

function updateRescuer(address newRescuer) external onlyOwner {
  require(
    newRescuer != address(0),
    "Rescuable: new rescuer is the zero address"
  );
  _rescuer = newRescuer;
  emit RescuerChanged(newRescuer);
}

isBlacklisted

Parameters

Name	Type
_account	address

Properties

Visibility public

Mutability view

Source Code

function isBlacklisted(address _account) external view returns (bool) {
  return blacklisted[_account];
}

blacklist

Parameters

Name	Type
_account	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyBlacklister checks for the following:

blacklister must be equal to the sender's address

Source Code

function blacklist(address _account) external onlyBlacklister {
  blacklisted[_account] = true;
  emit Blacklisted(_account);
}

unBlacklist

Parameters

Name	Type
_account	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyBlacklister checks for the following:

blacklister must be equal to the sender's address

Source Code

function unBlacklist(address _account) external onlyBlacklister {
  blacklisted[_account] = false;
  emit UnBlacklisted(_account);
}

updateBlacklister

Parameters

Name	Type
_newBlacklister	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

_owner must be equal to the sender's address

Requirements

_newBlacklister must not be equal to UNKNOWN VALUE

Source Code

function updateBlacklister(address _newBlacklister) external onlyOwner {
  require(
    _newBlacklister != address(0),
    "Blacklistable: new blacklister is the zero address"
  );
  blacklister = _newBlacklister;
  emit BlacklisterChanged(blacklister);
}

pause

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyPauser checks for the following:

pauser must be equal to the sender's address

Source Code

function pause() external onlyPauser {
  paused = true;
  emit Pause();
}

unpause

Parameters

This function has no parameters.

Properties

Visibility public

Mutability transaction

Modifiers

onlyPauser checks for the following:

pauser must be equal to the sender's address

Source Code

function unpause() external onlyPauser {
  paused = false;
  emit Unpause();
}

updatePauser

Parameters

Name	Type
_newPauser	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

_owner must be equal to the sender's address

Requirements

_newPauser must not be equal to UNKNOWN VALUE

Source Code

function updatePauser(address _newPauser) external onlyOwner {
  require(_newPauser != address(0), "Pausable: new pauser is the zero address");
  pauser = _newPauser;
  emit PauserChanged(pauser);
}

initialize

Parameters

Name	Type
tokenName	string
tokenSymbol	string
tokenCurrency	string
tokenDecimals	uint8
newMasterMinter	address
newPauser	address
newBlacklister	address
newOwner	address

Properties

Visibility public

Mutability transaction

Requirements

initialized must not be true

newMasterMinter must not be equal to UNKNOWN VALUE

newPauser must not be equal to UNKNOWN VALUE

newBlacklister must not be equal to UNKNOWN VALUE

newOwner must not be equal to UNKNOWN VALUE

Source Code

function initialize(
  string memory tokenName,
  string memory tokenSymbol,
  string memory tokenCurrency,
  uint8 tokenDecimals,
  address newMasterMinter,
  address newPauser,
  address newBlacklister,
  address newOwner
) public {
  require(!initialized, "FiatToken: contract is already initialized");
  require(
    newMasterMinter != address(0),
    "FiatToken: new masterMinter is the zero address"
  );
  require(newPauser != address(0), "FiatToken: new pauser is the zero address");
  require(
    newBlacklister != address(0),
    "FiatToken: new blacklister is the zero address"
  );
  require(newOwner != address(0), "FiatToken: new owner is the zero address");

  name = tokenName;
  symbol = tokenSymbol;
  currency = tokenCurrency;
  decimals = tokenDecimals;
  masterMinter = newMasterMinter;
  pauser = newPauser;
  blacklister = newBlacklister;
  setOwner(newOwner);
  initialized = true;
}

mint

Parameters

Name	Type
_to	address
_amount	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

onlyMinters checks for the following:

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

_to must not be equal to UNKNOWN VALUE

_amount must be greater than 0

_amount must be less than or equal to mintingAllowedAmount

Source Code

function mint(address _to, uint256 _amount)
  external
  whenNotPaused
  onlyMinters
  notBlacklisted(msg.sender)
  notBlacklisted(_to)
  returns (bool)
{
  require(_to != address(0), "FiatToken: mint to the zero address");
  require(_amount > 0, "FiatToken: mint amount not greater than 0");

  uint256 mintingAllowedAmount = minterAllowed[msg.sender];
  require(
    _amount <= mintingAllowedAmount,
    "FiatToken: mint amount exceeds minterAllowance"
  );

  totalSupply_ = totalSupply_.add(_amount);
  balances[_to] = balances[_to].add(_amount);
  minterAllowed[msg.sender] = mintingAllowedAmount.sub(_amount);
  emit Mint(msg.sender, _to, _amount);
  emit Transfer(address(0), _to, _amount);
  return true;
}

minterAllowance

Parameters

Name	Type
minter	address

Properties

Visibility public

Mutability view

Source Code

function minterAllowance(address minter) external view returns (uint256) {
  return minterAllowed[minter];
}

isMinter

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Source Code

function isMinter(address account) external view returns (bool) {
  return minters[account];
}

allowance

Parameters

Name	Type
owner	address
spender	address

Properties

Visibility public

Mutability view

Source Code

function allowance(address owner, address spender)
  external
  view
  override
  returns (uint256)
{
  return allowed[owner][spender];
}

totalSupply

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function totalSupply() external view override returns (uint256) {
  return totalSupply_;
}

balanceOf

Parameters

Name	Type
account	address

Properties

Visibility public

Mutability view

Source Code

function balanceOf(address account) external view override returns (uint256) {
  return balances[account];
}

approve

Parameters

Name	Type
spender	address
value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address 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)
  external
  override
  whenNotPaused
  notBlacklisted(msg.sender)
  notBlacklisted(spender)
  returns (bool)
{
  _approve(msg.sender, spender, value);
  return true;
}

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

value must be less than or equal to allowed for from for the sender's address

from must not be equal to UNKNOWN VALUE

to must not be equal to UNKNOWN VALUE

value must be less than or equal to balances for from

Source Code

function transferFrom(
  address from,
  address to,
  uint256 value
)
  external
  override
  whenNotPaused
  notBlacklisted(msg.sender)
  notBlacklisted(from)
  notBlacklisted(to)
  returns (bool)
{
  require(
    value <= allowed[from][msg.sender],
    "ERC20: transfer amount exceeds allowance"
  );
  _transfer(from, to, value);
  allowed[from][msg.sender] = allowed[from][msg.sender].sub(value);
  return true;
}

transfer

Parameters

Name	Type
to	address
value	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

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

to must not be equal to UNKNOWN VALUE

value must be less than or equal to balances for the sender's address

Source Code

function transfer(address to, uint256 value)
  external
  override
  whenNotPaused
  notBlacklisted(msg.sender)
  notBlacklisted(to)
  returns (bool)
{
  _transfer(msg.sender, to, value);
  return true;
}

configureMinter

Parameters

Name	Type
minter	address
minterAllowedAmount	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

onlyMasterMinter checks for the following:

masterMinter must be equal to the sender's address

Source Code

function configureMinter(address minter, uint256 minterAllowedAmount)
  external
  whenNotPaused
  onlyMasterMinter
  returns (bool)
{
  minters[minter] = true;
  minterAllowed[minter] = minterAllowedAmount;
  emit MinterConfigured(minter, minterAllowedAmount);
  return true;
}

removeMinter

Parameters

Name	Type
minter	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyMasterMinter checks for the following:

masterMinter must be equal to the sender's address

Source Code

function removeMinter(address minter) external onlyMasterMinter returns (bool) {
  minters[minter] = false;
  minterAllowed[minter] = 0;
  emit MinterRemoved(minter);
  return true;
}

burn

Parameters

Name	Type
_amount	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

onlyMinters checks for the following:

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

_amount must be greater than 0

balance must be greater than or equal to _amount

Source Code

function burn(uint256 _amount)
  external
  whenNotPaused
  onlyMinters
  notBlacklisted(msg.sender)
{
  uint256 balance = balances[msg.sender];
  require(_amount > 0, "FiatToken: burn amount not greater than 0");
  require(balance >= _amount, "FiatToken: burn amount exceeds balance");

  totalSupply_ = totalSupply_.sub(_amount);
  balances[msg.sender] = balance.sub(_amount);
  emit Burn(msg.sender, _amount);
  emit Transfer(msg.sender, address(0), _amount);
}

updateMasterMinter

Parameters

Name	Type
_newMasterMinter	address

Properties

Visibility public

Mutability transaction

Modifiers

onlyOwner checks for the following:

_owner must be equal to the sender's address

Requirements

_newMasterMinter must not be equal to UNKNOWN VALUE

Source Code

function updateMasterMinter(address _newMasterMinter) external onlyOwner {
  require(
    _newMasterMinter != address(0),
    "FiatToken: new masterMinter is the zero address"
  );
  masterMinter = _newMasterMinter;
  emit MasterMinterChanged(masterMinter);
}

initializeV2

Parameters

Name	Type
newName	string

Properties

Visibility public

Mutability transaction

Requirements

_initializedVersion must be equal to 0

initialized must be true

Source Code

function initializeV2(string calldata newName) external {
  // solhint-disable-next-line reason-string
  require(initialized && _initializedVersion == 0);
  name = newName;
  DOMAIN_SEPARATOR = EIP712.makeDomainSeparator(newName, "2");
  _initializedVersion = 1;
}

increaseAllowance

Parameters

Name	Type
spender	address
increment	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address 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 increaseAllowance(address spender, uint256 increment)
  external
  whenNotPaused
  notBlacklisted(msg.sender)
  notBlacklisted(spender)
  returns (bool)
{
  _increaseAllowance(msg.sender, spender, increment);
  return true;
}

decreaseAllowance

Parameters

Name	Type
spender	address
decrement	uint256

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address 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 decreaseAllowance(address spender, uint256 decrement)
  external
  whenNotPaused
  notBlacklisted(msg.sender)
  notBlacklisted(spender)
  returns (bool)
{
  _decreaseAllowance(msg.sender, spender, decrement);
  return true;
}

transferWithAuthorization

Parameters

Name	Type
from	address
to	address
value	uint256
validAfter	uint256
validBefore	uint256
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

now must be greater than validAfter

now must be less than validBefore

_authorizationStates for from for nonce must not be true

from must be equal to UNKNOWN VALUE

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

to must not be equal to UNKNOWN VALUE

value must be less than or equal to balances for the sender's address

Source Code

function transferWithAuthorization(
  address from,
  address to,
  uint256 value,
  uint256 validAfter,
  uint256 validBefore,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
  _transferWithAuthorization(
    from,
    to,
    value,
    validAfter,
    validBefore,
    nonce,
    v,
    r,
    s
  );
}

receiveWithAuthorization

Parameters

Name	Type
from	address
to	address
value	uint256
validAfter	uint256
validBefore	uint256
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

to must be equal to the sender's address

now must be greater than validAfter

now must be less than validBefore

_authorizationStates for from for nonce must not be true

from must be equal to UNKNOWN VALUE

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

to must not be equal to UNKNOWN VALUE

value must be less than or equal to balances for the sender's address

Source Code

function receiveWithAuthorization(
  address from,
  address to,
  uint256 value,
  uint256 validAfter,
  uint256 validBefore,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) external whenNotPaused notBlacklisted(from) notBlacklisted(to) {
  _receiveWithAuthorization(
    from,
    to,
    value,
    validAfter,
    validBefore,
    nonce,
    v,
    r,
    s
  );
}

cancelAuthorization

Parameters

Name	Type
authorizer	address
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

Requirements

_authorizationStates for from for nonce must not be true

authorizer must be equal to UNKNOWN VALUE

Source Code

function cancelAuthorization(
  address authorizer,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) external whenNotPaused {
  _cancelAuthorization(authorizer, nonce, v, r, s);
}

permit

Parameters

Name	Type
owner	address
spender	address
value	uint256
deadline	uint256
v	uint8
r	bytes32
s	bytes32

Properties

Visibility public

Mutability transaction

Modifiers

whenNotPaused checks for the following:

paused must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

notBlacklisted checks for the following:

blacklisted for the sender's address must not be true

Requirements

deadline must be greater than or equal to now

owner must be equal to UNKNOWN VALUE

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

spender must not be equal to UNKNOWN VALUE

Source Code

function permit(
  address owner,
  address spender,
  uint256 value,
  uint256 deadline,
  uint8 v,
  bytes32 r,
  bytes32 s
) external whenNotPaused notBlacklisted(owner) notBlacklisted(spender) {
  _permit(owner, spender, value, deadline, v, r, s);
}

initializeV2_1

Parameters

Name	Type
lostAndFound	address

Properties

Visibility public

Mutability transaction

Requirements

_initializedVersion must be equal to 1

Source Code

function initializeV2_1(address lostAndFound) external {
  // solhint-disable-next-line reason-string
  require(_initializedVersion == 1);

  uint256 lockedAmount = balances[address(this)];
  if (lockedAmount > 0) {
    _transfer(address(this), lostAndFound, lockedAmount);
  }
  blacklisted[address(this)] = true;

  _initializedVersion = 2;
}

version

Parameters

This function has no parameters.

Properties

Visibility public

Mutability view

Source Code

function version() external view returns (string memory) {
  return "2";
}

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 FiatTokenV2._increaseAllowance

Parameters

Name	Type
owner	address
spender	address
increment	uint256

Properties

Visibility internal

Mutability transaction

Requirements

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

spender must not be equal to UNKNOWN VALUE

Source Code

function _increaseAllowance(
  address owner,
  address spender,
  uint256 increment
) internal override {
  _approve(owner, spender, allowed[owner][spender].add(increment));
}

internal FiatTokenV2._decreaseAllowance

Parameters

Name	Type
owner	address
spender	address
decrement	uint256

Properties

Visibility internal

Mutability transaction

Requirements

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

spender must not be equal to UNKNOWN VALUE

Source Code

function _decreaseAllowance(
  address owner,
  address spender,
  uint256 decrement
) internal override {
  _approve(
    owner,
    spender,
    allowed[owner][spender].sub(
      decrement,
      "ERC20: decreased allowance below zero"
    )
  );
}

internal FiatTokenV1._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

spender must not be equal to UNKNOWN VALUE

Source Code

function _approve(
  address owner,
  address spender,
  uint256 value
) internal override {
  require(owner != address(0), "ERC20: approve from the zero address");
  require(spender != address(0), "ERC20: approve to the zero address");
  allowed[owner][spender] = value;
  emit Approval(owner, spender, value);
}

internal FiatTokenV1._transfer

Parameters

Name	Type
from	address
to	address
value	uint256

Properties

Visibility internal

Mutability transaction

Requirements

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

to must not be equal to UNKNOWN VALUE

value must be less than or equal to balances for the sender's address

Source Code

function _transfer(
  address from,
  address to,
  uint256 value
) internal override {
  require(from != address(0), "ERC20: transfer from the zero address");
  require(to != address(0), "ERC20: transfer to the zero address");
  require(value <= balances[from], "ERC20: transfer amount exceeds balance");

  balances[from] = balances[from].sub(value);
  balances[to] = balances[to].add(value);
  emit Transfer(from, to, value);
}

internal AbstractFiatTokenV1._approve

Parameters

Name	Type
owner	address
spender	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _approve(
  address owner,
  address spender,
  uint256 value
) internal virtual;

internal AbstractFiatTokenV1._transfer

Parameters

Name	Type
from	address
to	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _transfer(
  address from,
  address to,
  uint256 value
) internal virtual;

internal Ownable.setOwner

Parameters

Name	Type
newOwner	address

Properties

Visibility internal

Mutability transaction

Source Code

function setOwner(address newOwner) internal {
  _owner = newOwner;
}

internal Ownable.setOwner

Parameters

Name	Type
newOwner	address

Properties

Visibility internal

Mutability transaction

Source Code

function setOwner(address newOwner) internal {
  _owner = newOwner;
}

internal Ownable.setOwner

Parameters

Name	Type
newOwner	address

Properties

Visibility internal

Mutability transaction

Source Code

function setOwner(address newOwner) internal {
  _owner = newOwner;
}

internal Ownable.setOwner

Parameters

Name	Type
newOwner	address

Properties

Visibility internal

Mutability transaction

Source Code

function setOwner(address newOwner) internal {
  _owner = newOwner;
}

internal EIP3009._transferWithAuthorization

Parameters

Name	Type
from	address
to	address
value	uint256
validAfter	uint256
validBefore	uint256
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility internal

Mutability transaction

Requirements

now must be greater than validAfter

now must be less than validBefore

_authorizationStates for from for nonce must not be true

from must be equal to UNKNOWN VALUE

Source Code

function _transferWithAuthorization(
  address from,
  address to,
  uint256 value,
  uint256 validAfter,
  uint256 validBefore,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) internal {
  _requireValidAuthorization(from, nonce, validAfter, validBefore);

  bytes memory data = abi.encode(
    TRANSFER_WITH_AUTHORIZATION_TYPEHASH,
    from,
    to,
    value,
    validAfter,
    validBefore,
    nonce
  );
  require(
    EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
    "FiatTokenV2: invalid signature"
  );

  _markAuthorizationAsUsed(from, nonce);
  _transfer(from, to, value);
}

internal EIP3009._receiveWithAuthorization

Parameters

Name	Type
from	address
to	address
value	uint256
validAfter	uint256
validBefore	uint256
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility internal

Mutability transaction

Requirements

to must be equal to the sender's address

now must be greater than validAfter

now must be less than validBefore

_authorizationStates for from for nonce must not be true

from must be equal to UNKNOWN VALUE

Source Code

function _receiveWithAuthorization(
  address from,
  address to,
  uint256 value,
  uint256 validAfter,
  uint256 validBefore,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) internal {
  require(to == msg.sender, "FiatTokenV2: caller must be the payee");
  _requireValidAuthorization(from, nonce, validAfter, validBefore);

  bytes memory data = abi.encode(
    RECEIVE_WITH_AUTHORIZATION_TYPEHASH,
    from,
    to,
    value,
    validAfter,
    validBefore,
    nonce
  );
  require(
    EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == from,
    "FiatTokenV2: invalid signature"
  );

  _markAuthorizationAsUsed(from, nonce);
  _transfer(from, to, value);
}

internal EIP3009._cancelAuthorization

Parameters

Name	Type
authorizer	address
nonce	bytes32
v	uint8
r	bytes32
s	bytes32

Properties

Visibility internal

Mutability transaction

Requirements

_authorizationStates for from for nonce must not be true

authorizer must be equal to UNKNOWN VALUE

Source Code

function _cancelAuthorization(
  address authorizer,
  bytes32 nonce,
  uint8 v,
  bytes32 r,
  bytes32 s
) internal {
  _requireUnusedAuthorization(authorizer, nonce);

  bytes memory data = abi.encode(
    CANCEL_AUTHORIZATION_TYPEHASH,
    authorizer,
    nonce
  );
  require(
    EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == authorizer,
    "FiatTokenV2: invalid signature"
  );

  _authorizationStates[authorizer][nonce] = true;
  emit AuthorizationCanceled(authorizer, nonce);
}

internal EIP3009._requireUnusedAuthorization

Parameters

Name	Type
authorizer	address
nonce	bytes32

Properties

Visibility private

Mutability view

Requirements

_authorizationStates for from for nonce must not be true

Source Code

function _requireUnusedAuthorization(address authorizer, bytes32 nonce)
  private
  view
{
  require(
    !_authorizationStates[authorizer][nonce],
    "FiatTokenV2: authorization is used or canceled"
  );
}

internal EIP3009._requireValidAuthorization

Parameters

Name	Type
authorizer	address
nonce	bytes32
validAfter	uint256
validBefore	uint256

Properties

Visibility private

Mutability view

Requirements

now must be greater than validAfter

now must be less than validBefore

_authorizationStates for from for nonce must not be true

Source Code

function _requireValidAuthorization(
  address authorizer,
  bytes32 nonce,
  uint256 validAfter,
  uint256 validBefore
) private view {
  require(now > validAfter, "FiatTokenV2: authorization is not yet valid");
  require(now < validBefore, "FiatTokenV2: authorization is expired");
  _requireUnusedAuthorization(authorizer, nonce);
}

internal EIP3009._markAuthorizationAsUsed

Parameters

Name	Type
authorizer	address
nonce	bytes32

Properties

Visibility private

Mutability transaction

Source Code

function _markAuthorizationAsUsed(address authorizer, bytes32 nonce) private {
  _authorizationStates[authorizer][nonce] = true;
  emit AuthorizationUsed(authorizer, nonce);
}

internal AbstractFiatTokenV2._increaseAllowance

Parameters

Name	Type
owner	address
spender	address
increment	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _increaseAllowance(
  address owner,
  address spender,
  uint256 increment
) internal virtual;

internal AbstractFiatTokenV2._decreaseAllowance

Parameters

Name	Type
owner	address
spender	address
decrement	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _decreaseAllowance(
  address owner,
  address spender,
  uint256 decrement
) internal virtual;

internal AbstractFiatTokenV1._approve

Parameters

Name	Type
owner	address
spender	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _approve(
  address owner,
  address spender,
  uint256 value
) internal virtual;

internal AbstractFiatTokenV1._transfer

Parameters

Name	Type
from	address
to	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _transfer(
  address from,
  address to,
  uint256 value
) internal virtual;

internal EIP2612._permit

Parameters

Name	Type
owner	address
spender	address
value	uint256
deadline	uint256
v	uint8
r	bytes32
s	bytes32

Properties

Visibility internal

Mutability transaction

Requirements

deadline must be greater than or equal to now

owner must be equal to UNKNOWN VALUE

Source Code

function _permit(
  address owner,
  address spender,
  uint256 value,
  uint256 deadline,
  uint8 v,
  bytes32 r,
  bytes32 s
) internal {
  require(deadline >= now, "FiatTokenV2: permit is expired");

  bytes memory data = abi.encode(
    PERMIT_TYPEHASH,
    owner,
    spender,
    value,
    _permitNonces[owner]++,
    deadline
  );
  require(
    EIP712.recover(DOMAIN_SEPARATOR, v, r, s, data) == owner,
    "EIP2612: invalid signature"
  );

  _approve(owner, spender, value);
}

internal AbstractFiatTokenV2._increaseAllowance

Parameters

Name	Type
owner	address
spender	address
increment	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _increaseAllowance(
  address owner,
  address spender,
  uint256 increment
) internal virtual;

internal AbstractFiatTokenV2._decreaseAllowance

Parameters

Name	Type
owner	address
spender	address
decrement	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _decreaseAllowance(
  address owner,
  address spender,
  uint256 decrement
) internal virtual;

internal AbstractFiatTokenV1._approve

Parameters

Name	Type
owner	address
spender	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _approve(
  address owner,
  address spender,
  uint256 value
) internal virtual;

internal AbstractFiatTokenV1._transfer

Parameters

Name	Type
from	address
to	address
value	uint256

Properties

Visibility internal

Mutability transaction

Source Code

function _transfer(
  address from,
  address to,
  uint256 value
) internal virtual;

USD Coin

ERC20

About link description

Stats

Events (17) keyboard_arrow_up

Approval Event

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

AuthorizationCanceled Event

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

AuthorizationUsed Event

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

Blacklisted Event

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

BlacklisterChanged Event

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

Burn Event

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

MasterMinterChanged Event

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

Mint Event

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

MinterConfigured Event

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

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

Pause Event

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

PauserChanged Event

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

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

UnBlacklisted Event

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

Unpause Event

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

Constants (4) keyboard_arrow_up

TRANSFER_WITH_AUTHORIZATION_TYPEHASH Constant

RECEIVE_WITH_AUTHORIZATION_TYPEHASH Constant

CANCEL_AUTHORIZATION_TYPEHASH Constant

PERMIT_TYPEHASH Constant

State Variables (21) keyboard_arrow_up

name Variable

symbol Variable

decimals Variable

currency Variable

masterMinter Variable

pauser Variable

paused Variable

blacklister Variable

DOMAIN_SEPARATOR Variable

_initializedVersion Variable

initialized Variable

balances Variable

allowed Variable

totalSupply_ Variable

minters Variable

minterAllowed Variable

_owner Variable

blacklisted Variable

_rescuer Variable

_authorizationStates Variable

_permitNonces Variable

Functions Expand All Collapse All

nonces 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

authorizationState 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

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

transferOwnership keyboard_arrow_up

About

Events (17)

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Constants (4)

State Variables (21)

nonces

Parameters

authorizationState

Parameters

owner

Parameters

transferOwnership

Parameters

Modifiers

Requirements

rescuer

Parameters

rescueERC20

Parameters

Modifiers

updateRescuer

Parameters

Modifiers

Requirements

isBlacklisted

Parameters

blacklist

Parameters

Modifiers

unBlacklist

Parameters

Modifiers

updateBlacklister

Parameters

Modifiers

Requirements

pause

Parameters

Modifiers

unpause

Parameters

Modifiers

updatePauser

Parameters

Modifiers

Requirements

initialize

Parameters

Requirements