USDC
Optimism ERC-20 Token0x0b2c639c533813f4aa9d7837caf62653d097ff85
Proxy implementation: 0xded3b9a8dbedc2f9cb725b55d0e686a81e6d06dc
Solidity v0.6.12+commit.27d51765
Fungible token following the ERC-20 standard.
🤖
Query this contract from your AI
Reference:
usdc-optimism
0x0b2c639c533813f4aa9d7837caf62653d097ff85
Sample prompt:
“Tell me the current state of usdc-optimism”
No AI wired up yet? →
mcp.smarts.md
Admin & Risk
Who can change the rules?
Detected upgradeable, mintable, pausable, blacklistable, and ownable controls from the verified ABI.
Upgradeable
Mintable
Pausable
Blacklistable
Ownable
Current controls
- Implementation
- 0xded3b9a8dbedc2f9cb725b55d0e686a81e6d06dc ↗ Etherscan → smarts proxy
- Paused
- false
- Owner
- 0xb04ffa9bdaef530a837f73198ae9f94064c4441f ↗ Etherscan → smarts
- Master minter
- 0x70429f78c2d7d1de6f89be421bce64ba876c325b ↗ Etherscan → smarts
- Pauser
- 0xb8015408bcba72bcbb34775c81361fb496051c9b ↗ Etherscan → smarts
- Blacklister
- 0x551e855b7355c98534175879a300972856c04d7c ↗ Etherscan → smarts
- Rescuer
- 0x0000000000000000000000000000000000000000 (none)
Overview
Read Functions
24
Write Functions
31
Events
17
Read Functions
Block #152,041,521 · just now
CANCEL_AUTHORIZATION_TYPEHASH()
view
→ 0x158b0a9edf7a828aad02f63cd515c68ef2f50ba807396f6d12842833a1597429
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 |
DOMAIN_SEPARATOR()
view
→ 0x26d9c34bb1a1c312f69c53b2d93b8be20faafba63af2438c6811713c9b1f933f
Get the EIP712 Domain Separator.
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | The bytes32 EIP712 domain separator. |
PERMIT_TYPEHASH()
view
→ 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 |
RECEIVE_WITH_AUTHORIZATION_TYPEHASH()
view
→ 0xd099cc98ef71107a616c4f0f941f04c322d8e254fe26b3c6668db87aae413de8
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 |
TRANSFER_WITH_AUTHORIZATION_TYPEHASH()
view
→ 0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 |
allowance(owner: address, spender: address)
view
dev: Returns the remaining number of tokens that `spender` will be allowed to spend on behalf of `owner` through {transferFrom}. This is zero by default. This value changes when {approve} or {transferFrom} are called.
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | |
| spender | address |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
authorizationState(authorizer: address, nonce: bytes32)
view
Returns the state of an authorization
dev: Nonces are randomly generated 32-byte data unique to the authorizer's address
Parameters
| Name | Type | Description |
|---|---|---|
| authorizer | address | Authorizer's address |
| nonce | bytes32 | Nonce of the authorization |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the nonce is used |
balanceOf(account: address)
view
dev: Returns the amount of tokens owned by `account`.
Parameters
| Name | Type | Description |
|---|---|---|
| account | address |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
blacklister()
view
→ 0x551e855b7355c98534175879a300972856c04d7c
Returns
| Name | Type | Description |
|---|---|---|
| — | address |
currency()
view
→ USD
Returns
| Name | Type | Description |
|---|---|---|
| — | string |
decimals()
view
→ 6
Returns
| Name | Type | Description |
|---|---|---|
| — | uint8 |
isBlacklisted(_account: address)
view
Checks if account is blacklisted.
Parameters
| Name | Type | Description |
|---|---|---|
| _account | address | The address to check. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the account is blacklisted, false if the account is not blacklisted. |
isMinter(account: address)
view
Checks if an account is a minter.
Parameters
| Name | Type | Description |
|---|---|---|
| account | address | The address to check. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the account is a minter, false if the account is not a minter. |
masterMinter()
view
→ 0x70429f78c2d7d1de6f89be421bce64ba876c325b
Returns
| Name | Type | Description |
|---|---|---|
| — | address |
minterAllowance(minter: address)
view
Gets the minter allowance for an account.
Parameters
| Name | Type | Description |
|---|---|---|
| minter | address | The address to check. |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | The remaining minter allowance for the account. |
name()
view
→ USD Coin
Returns
| Name | Type | Description |
|---|---|---|
| — | string |
nonces(owner: address)
view
Nonces for permit
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | Token owner's address (Authorizer) |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | Next nonce |
owner()
view
→ 0xb04ffa9bdaef530a837f73198ae9f94064c4441f
dev: Tells the address of the owner
Returns
| Name | Type | Description |
|---|---|---|
| — | address | the address of the owner |
paused()
view
→ false
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
pauser()
view
→ 0xb8015408bcba72bcbb34775c81361fb496051c9b
Returns
| Name | Type | Description |
|---|---|---|
| — | address |
rescuer()
view
→ 0x0000000000000000000000000000000000000000
Returns current rescuer
Returns
| Name | Type | Description |
|---|---|---|
| — | address | Rescuer's address |
symbol()
view
→ USDC
Returns
| Name | Type | Description |
|---|---|---|
| — | string |
totalSupply()
view
→ 193,779,292 USDC
dev: Returns the amount of tokens in existence.
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 |
version()
pure
→ 2
Version string for the EIP712 domain separator
Returns
| Name | Type | Description |
|---|---|---|
| — | string | Version string |
Write Functions
approve(spender: address, value: uint256)
nonpayable
dev: Sets `amount` as the allowance of `spender` over the caller's tokens. Returns a boolean value indicating whether the operation succeeded. IMPORTANT: Beware that changing an allowance with this method brings the risk that someone may use both the old and the new allowance by unfortunate transaction ordering. One possible solution to mitigate this race condition is to first reduce the spender's allowance to 0 and set the desired value afterwards: https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729 Emits an {Approval} event.
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | |
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
blacklist(_account: address)
nonpayable
Adds account to blacklist.
Parameters
| Name | Type | Description |
|---|---|---|
| _account | address | The address to blacklist. |
burn(_amount: uint256)
nonpayable
Allows a minter to burn some of its own tokens.
dev: The caller must be a minter, must not be blacklisted, and the amount to burn should be less than or equal to the account's balance.
Parameters
| Name | Type | Description |
|---|---|---|
| _amount | uint256 | the amount of tokens to be burned. |
cancelAuthorization(authorizer: address, nonce: bytes32, v: uint8, r: bytes32, s: bytes32)
nonpayable
Attempt to cancel an authorization
dev: Works only if the authorization is not yet used. EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| authorizer | address | Authorizer's address |
| nonce | bytes32 | Nonce of the authorization |
| v | uint8 | |
| r | bytes32 | |
| s | bytes32 |
cancelAuthorization(authorizer: address, nonce: bytes32, signature: bytes)
nonpayable
Attempt to cancel an authorization
dev: Works only if the authorization is not yet used. EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| authorizer | address | Authorizer's address |
| nonce | bytes32 | Nonce of the authorization |
| signature | bytes | Signature bytes signed by an EOA wallet or a contract wallet |
configureMinter(minter: address, minterAllowedAmount: uint256)
nonpayable
Adds or updates a new minter with a mint allowance.
Parameters
| Name | Type | Description |
|---|---|---|
| minter | address | The address of the minter. |
| minterAllowedAmount | uint256 | The minting amount allowed for the minter. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the operation was successful. |
decreaseAllowance(spender: address, decrement: uint256)
nonpayable
Decrease the allowance by a given decrement
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | Spender's address |
| decrement | uint256 | Amount of decrease in allowance |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
increaseAllowance(spender: address, increment: uint256)
nonpayable
Increase the allowance by a given increment
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | Spender's address |
| increment | uint256 | Amount of increase in allowance |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
initialize(tokenName: string, tokenSymbol: string, tokenCurrency: string, tokenDecimals: uint8, newMasterMinter: address, newPauser: address, newBlacklister: address, newOwner: address)
nonpayable
Initializes the fiat token contract.
Parameters
| Name | Type | Description |
|---|---|---|
| tokenName | string | The name of the fiat token. |
| tokenSymbol | string | The symbol of the fiat token. |
| tokenCurrency | string | The fiat currency that the token represents. |
| tokenDecimals | uint8 | The number of decimals that the token uses. |
| newMasterMinter | address | The masterMinter address for the fiat token. |
| newPauser | address | The pauser address for the fiat token. |
| newBlacklister | address | The blacklister address for the fiat token. |
| newOwner | address | The owner of the fiat token. |
initializeV2(newName: string)
nonpayable
Initialize v2
Parameters
| Name | Type | Description |
|---|---|---|
| newName | string | New token name |
initializeV2_1(lostAndFound: address)
nonpayable
Initialize v2.1
Parameters
| Name | Type | Description |
|---|---|---|
| lostAndFound | address | The address to which the locked funds are sent |
initializeV2_2(accountsToBlacklist: address[], newSymbol: string)
nonpayable
Initialize v2.2
Parameters
| Name | Type | Description |
|---|---|---|
| accountsToBlacklist | address[] | A list of accounts to migrate from the old blacklist |
| newSymbol | string | New token symbol data structure to the new blacklist data structure. |
mint(_to: address, _amount: uint256)
nonpayable
Mints fiat tokens to an address.
Parameters
| Name | Type | Description |
|---|---|---|
| _to | address | The address that will receive the minted tokens. |
| _amount | uint256 | The amount of tokens to mint. Must be less than or equal to the minterAllowance of the caller. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the operation was successful. |
pause()
nonpayable
dev: called by the owner to pause, triggers stopped state
permit(owner: address, spender: address, value: uint256, deadline: uint256, signature: bytes)
nonpayable
Update allowance with a signed permit
dev: EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | Token owner's address (Authorizer) |
| spender | address | Spender's address |
| value | uint256 | Amount of allowance |
| deadline | uint256 | The time at which the signature expires (unix time), or max uint256 value to signal no expiration |
| signature | bytes | Signature bytes signed by an EOA wallet or a contract wallet |
permit(owner: address, spender: address, value: uint256, deadline: uint256, v: uint8, r: bytes32, s: bytes32)
nonpayable
Update allowance with a signed permit
dev: EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | Token owner's address (Authorizer) |
| spender | address | Spender's address |
| value | uint256 | Amount of allowance |
| deadline | uint256 | The time at which the signature expires (unix time), or max uint256 value to signal no expiration |
| v | uint8 | |
| r | bytes32 | |
| s | bytes32 |
receiveWithAuthorization(from: address, to: address, value: uint256, validAfter: uint256, validBefore: uint256, nonce: bytes32, signature: bytes)
nonpayable
Receive a transfer with a signed authorization from the payer
dev: This has an additional check to ensure that the payee's address matches the caller of this function to prevent front-running attacks. EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | Payer's address (Authorizer) |
| to | address | Payee's address |
| value | uint256 | Amount to be transferred |
| validAfter | uint256 | The time after which this is valid (unix time) |
| validBefore | uint256 | The time before which this is valid (unix time) |
| nonce | bytes32 | Unique nonce |
| signature | bytes | Signature bytes signed by an EOA wallet or a contract wallet |
receiveWithAuthorization(from: address, to: address, value: uint256, validAfter: uint256, validBefore: uint256, nonce: bytes32, v: uint8, r: bytes32, s: bytes32)
nonpayable
Receive a transfer with a signed authorization from the payer
dev: This has an additional check to ensure that the payee's address matches the caller of this function to prevent front-running attacks. EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | Payer's address (Authorizer) |
| to | address | Payee's address |
| value | uint256 | Amount to be transferred |
| validAfter | uint256 | The time after which this is valid (unix time) |
| validBefore | uint256 | The time before which this is valid (unix time) |
| nonce | bytes32 | Unique nonce |
| v | uint8 | |
| r | bytes32 | |
| s | bytes32 |
removeMinter(minter: address)
nonpayable
Removes a minter.
Parameters
| Name | Type | Description |
|---|---|---|
| minter | address | The address of the minter to remove. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the operation was successful. |
rescueERC20(tokenContract: address, to: address, amount: uint256)
nonpayable
Rescue ERC20 tokens locked up in this contract.
Parameters
| Name | Type | Description |
|---|---|---|
| tokenContract | address | ERC20 token contract address |
| to | address | Recipient address |
| amount | uint256 | Amount to withdraw |
transfer(to: address, value: uint256)
nonpayable
dev: Moves `amount` tokens from the caller's account to `recipient`. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | |
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
transferFrom(from: address, to: address, value: uint256)
nonpayable
dev: Moves `amount` tokens from `sender` to `recipient` using the allowance mechanism. `amount` is then deducted from the caller's allowance. Returns a boolean value indicating whether the operation succeeded. Emits a {Transfer} event.
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | |
| to | address | |
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool |
transferOwnership(newOwner: address)
nonpayable
dev: Allows the current owner to transfer control of the contract to a newOwner.
Parameters
| Name | Type | Description |
|---|---|---|
| newOwner | address | The address to transfer ownership to. |
transferWithAuthorization(from: address, to: address, value: uint256, validAfter: uint256, validBefore: uint256, nonce: bytes32, signature: bytes)
nonpayable
Execute a transfer with a signed authorization
dev: EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | Payer's address (Authorizer) |
| to | address | Payee's address |
| value | uint256 | Amount to be transferred |
| validAfter | uint256 | The time after which this is valid (unix time) |
| validBefore | uint256 | The time before which this is valid (unix time) |
| nonce | bytes32 | Unique nonce |
| signature | bytes | Signature bytes signed by an EOA wallet or a contract wallet |
transferWithAuthorization(from: address, to: address, value: uint256, validAfter: uint256, validBefore: uint256, nonce: bytes32, v: uint8, r: bytes32, s: bytes32)
nonpayable
Execute a transfer with a signed authorization
dev: EOA wallet signatures should be packed in the order of r, s, v.
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | Payer's address (Authorizer) |
| to | address | Payee's address |
| value | uint256 | Amount to be transferred |
| validAfter | uint256 | The time after which this is valid (unix time) |
| validBefore | uint256 | The time before which this is valid (unix time) |
| nonce | bytes32 | Unique nonce |
| v | uint8 | |
| r | bytes32 | |
| s | bytes32 |
unBlacklist(_account: address)
nonpayable
Removes account from blacklist.
Parameters
| Name | Type | Description |
|---|---|---|
| _account | address | The address to remove from the blacklist. |
unpause()
nonpayable
dev: called by the owner to unpause, returns to normal state
updateBlacklister(_newBlacklister: address)
nonpayable
Updates the blacklister address.
Parameters
| Name | Type | Description |
|---|---|---|
| _newBlacklister | address | The address of the new blacklister. |
updateMasterMinter(_newMasterMinter: address)
nonpayable
Updates the master minter address.
Parameters
| Name | Type | Description |
|---|---|---|
| _newMasterMinter | address | The address of the new master minter. |
updatePauser(_newPauser: address)
nonpayable
Updates the pauser address.
Parameters
| Name | Type | Description |
|---|---|---|
| _newPauser | address | The address of the new pauser. |
updateRescuer(newRescuer: address)
nonpayable
Updates the rescuer address.
Parameters
| Name | Type | Description |
|---|---|---|
| newRescuer | address | The address of the new rescuer. |
Events
Approval(owner: address, spender: address, value: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| owner | address | ✓ | |
| spender | address | ✓ | |
| value | uint256 |
AuthorizationCanceled(authorizer: address, nonce: bytes32)
| Name | Type | Indexed | Description |
|---|---|---|---|
| authorizer | address | ✓ | |
| nonce | bytes32 | ✓ |
AuthorizationUsed(authorizer: address, nonce: bytes32)
| Name | Type | Indexed | Description |
|---|---|---|---|
| authorizer | address | ✓ | |
| nonce | bytes32 | ✓ |
Blacklisted(_account: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| _account | address | ✓ |
BlacklisterChanged(newBlacklister: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| newBlacklister | address | ✓ |
Burn(burner: address, amount: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| burner | address | ✓ | |
| amount | uint256 |
MasterMinterChanged(newMasterMinter: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| newMasterMinter | address | ✓ |
Mint(minter: address, to: address, amount: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| minter | address | ✓ | |
| to | address | ✓ | |
| amount | uint256 |
MinterConfigured(minter: address, minterAllowedAmount: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| minter | address | ✓ | |
| minterAllowedAmount | uint256 |
MinterRemoved(oldMinter: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| oldMinter | address | ✓ |
OwnershipTransferred(previousOwner: address, newOwner: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| previousOwner | address | representing the address of the previous owner | |
| newOwner | address | representing the address of the new owner |
Pause()
PauserChanged(newAddress: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| newAddress | address | ✓ |
RescuerChanged(newRescuer: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| newRescuer | address | ✓ |
Transfer(from: address, to: address, value: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| from | address | ✓ | |
| to | address | ✓ | |
| value | uint256 |
UnBlacklisted(_account: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| _account | address | ✓ |
Unpause()