0x5fc5360d0400a0fd4f2af552add042d716f1d168
Proxy implementation: 0x68184c449e1a8f34fa18d289737129fd27b66f8f
Solidity v0.8.28+commit.7893614a
Fungible token following the ERC-20 standard.
Admin & Risk
Who can change the rules?
Detected upgradeable, mintable, pausable, ownable, and role based controls from the verified ABI.
Overview
Read Functions
Block #26,258,058 · just nowReturns the bytes32 identifier of the contract's default admin role.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | The bytes32 identifier representing DEFAULT_ADMIN_ROLE used for AccessControl permission checks.✨ AI |
EIP712 Domain Separator
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | The domain separator for EIP-712 signatures |
Return the deprecated EIP-712 domain separator hash used for legacy signature verification.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | Deprecated EIP-712 domain separator hash as a bytes32 value used by older signature schemes.✨ AI |
Get the two-byte EIP-712 version prefix used by the contract.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes2 | The bytes2 value representing the EIP-712 version prefix used in domain separator hashing.✨ AI |
Returns the remaining token allowance that owner has granted to spender.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | Address that granted the allowance.✨ AI |
| spender | address | Address allowed to spend the owner's tokens.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | A uint256 specifying the amount of tokens still available for the spender. |
Returns the address currently assigned to the deprecated asset protection role.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | Address currently assigned to the deprecated asset protection role; may be the zero address.✨ AI |
Return the USDG token balance for a given address.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| addr | address | Address whose USDG balance will be returned.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | An uint256 representing the amount owned by the passed address. |
Returns the address of the deprecated beta delegate whitelister.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address currently configured as the deprecated beta delegate whitelister.✨ AI |
Return the number of decimal places the token uses.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint8 | Number of decimal places the token uses (uint8).✨ AI |
Returns the contract's default administrator address.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address currently assigned as the contract default admin (has elevated administrative permissions).✨ AI |
Returns the configured default admin delay for time-locked admin actions.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint48 | The default admin delay in seconds as a uint48 value.✨ AI |
Returns the configured waiting period required before a default admin delay increase takes effect.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint48 | The wait period in seconds (uint48) required before a default admin delay increase takes effect.✨ AI |
Return the facet address implementing the given function selector.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| — | bytes4 |
Returns
| Name | Type | Description |
|---|---|---|
| — | address | Facet contract address that implements the provided selector, or address(0) if not found.✨ AI |
Get the facet address for a function selector
Parameters
| Name | Type | Description |
|---|---|---|
| selector | bytes4 | The function selector |
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The facet contract address |
Returns the admin role that controls a specified role.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| role | bytes32 | Target role identifier (bytes32).✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | Admin role identifier (bytes32) that can grant or revoke the given role.✨ AI |
Returns the current global transfer configuration for the token.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| referenceTime | uint40 | referenceTime: uint40 Unix timestamp (seconds) used as the reference point for maturity calculations.✨ AI |
| maturityPeriod | uint32 | maturityPeriod: uint32 duration in seconds after referenceTime that defines when transfers mature.✨ AI |
| partnerSignedRegistrationsEnabled | bool | partnerSignedRegistrationsEnabled: bool true if partner-signed registrations are allowed for transfers.✨ AI |
| __gap_remaining | bytes10 | __gap_remaining: bytes10 reserved storage gap for future upgrades; not used by contract logic.✨ AI |
| paused | bool | paused: bool true if global transfers are currently paused.✨ AI |
Check whether an address has a specific role.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| role | bytes32 | Role identifier (bytes32), typically a keccak256 hash of a role name.✨ AI |
| account | address | Address to verify membership for the role.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the account has the role, otherwise false.✨ AI |
Return the token's name.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | string | The ERC-20 token name as a UTF-8 string.✨ AI |
Returns the address of the contract owner.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address that currently has owner privileges for this contract.✨ AI |
Returns the address and scheduled activation time of the currently pending default admin.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| newAdmin | address | newAdmin: address proposed to become the contract's default admin.✨ AI |
| schedule | uint48 | schedule: uint48 value for when the pending admin becomes active (e.g. unix timestamp), or zero if none.✨ AI |
Return the pending default admin delay and the timestamp when it was scheduled.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| newDelay | uint48 | newDelay: proposed default admin delay value (uint48).✨ AI |
| schedule | uint48 | schedule: unix timestamp (uint48) when the proposed delay was scheduled.✨ AI |
Get the address proposed to become the contract owner (deprecated ownership flow).✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address proposed as the new owner, or the zero address if no proposal exists.✨ AI |
Return the ERC-1822 proxiable UUID that identifies the implementation storage slot.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | bytes32: ERC-1822 proxiable UUID identifying the storage slot used for the implementation address.✨ AI |
Returns the address that controls supply-related operations for the USDG token.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address authorized to manage or adjust the USDG token supply (supply controller).✨ AI |
Returns the deprecated supply controller address.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | address | The address of the deprecated supply controller, or the zero address if none is set.✨ AI |
Return true if the contract implements the interface specified by interfaceId.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| interfaceId | bytes4 | The 4-byte ERC-165 interface identifier to query.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the contract implements the interface id, false otherwise.✨ AI |
Returns the token's symbol (ticker) displayed in wallets and user interfaces.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | string | The token symbol as a string (e.g., "USDG"), used for display in wallets and UIs.✨ AI |
Returns the total supply of USDG tokens.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | Total number of USDG tokens, expressed in the token's smallest unit (uint256).✨ AI |
Write Functions
Accept the pending transfer of the contract's default admin role to the caller.✨ AI
Approve a spender to transfer up to a specified amount of your USDG tokens.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | Address allowed to transfer tokens from your balance.✨ AI |
| value | uint256 | Maximum number of tokens the spender is permitted to transfer.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Batch set facet functions from one or more facets
Parameters
| Name | Type | Description |
|---|---|---|
| facetCuts | tuple[] | Array of FacetCut structs (facet address + selectors per facet) |
Initiate transfer of the contract's default admin role to the specified newAdmin address.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| newAdmin | address | Address to become the new default admin.✨ AI |
Burns a specified amount of USDG tokens from the caller, decreasing their balance and total supply.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| amount | uint256 | The number of tokens to remove |
Parameters
| Name | Type | Description |
|---|---|---|
| newDelay | uint48 |
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | |
| subtractedValue | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Parameters
| Name | Type | Description |
|---|---|---|
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | success A boolean that indicates if the operation was successful. |
Decreases the total supply by burning the specified number of tokens. Can only be called by a supply controller. Function is marked virtual to aid in testing, but is never overridden on the actual token.
Parameters
| Name | Type | Description |
|---|---|---|
| value | uint256 | The number of tokens to remove |
| burnFromAddress | address | Address to burn tokens from. |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | success A boolean that indicates if the operation was successful |
Parameters
| Name | Type | Description |
|---|---|---|
| role | bytes32 | |
| account | address |
Parameters
| Name | Type | Description |
|---|---|---|
| spender | address | |
| addedValue | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Parameters
| Name | Type | Description |
|---|---|---|
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | success A boolean that indicates if the operation was successful. |
Increases the total supply by minting the specified number of tokens to the supply controller account. Function is marked virtual to aid in testing, but is never overridden on the actual token.
Parameters
| Name | Type | Description |
|---|---|---|
| value | uint256 | The number of tokens to add |
| mintToAddress | address | Address to mint tokens to. |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | success A boolean that indicates if the operation was successful |
Parameters
| Name | Type | Description |
|---|---|---|
| initialDelay | uint48 | |
| initialOwner | address | |
| pauser | address | |
| assetProtector | address | |
| facetCuts | tuple[] | |
| claimSource | address | |
| minRate | uint256 | |
| maxRate | uint256 | |
| v3Roles | tuple |
Parameters
| Name | Type | Description |
|---|---|---|
| facetCuts | tuple[] | Array of FacetCut structs mapping facet addresses to their selectors |
| claimSource | address | Address to use as claim source (where rewards come from) |
| minRate | uint256 | Minimum APR bound (10 decimals, e.g., 0 for no minimum) |
| maxRate | uint256 | Maximum APR bound (10 decimals, e.g., type(uint40).max for unlimited) |
| v3Roles | tuple | Struct containing addresses for V3 roles (multAdmin, multRateAdmin, etc.) |
Parameters
| Name | Type | Description |
|---|---|---|
| account | address | Address to mint tokens to |
| amount | uint256 | The number of tokens to add |
Parameters
| Name | Type | Description |
|---|---|---|
| role | bytes32 | |
| account | address |
Parameters
| Name | Type | Description |
|---|---|---|
| role | bytes32 | |
| account | address |
Add or update a facet function
Parameters
| Name | Type | Description |
|---|---|---|
| selector | bytes4 | The function selector |
| facetAddress | address | The facet contract address (zero to remove) |
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | |
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Parameters
| Name | Type | Description |
|---|---|---|
| from | address | |
| to | address | |
| value | uint256 |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Parameters
| Name | Type | Description |
|---|---|---|
| from | address[] | |
| to | address[] | |
| value | uint256[] |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if successful |
Parameters
| Name | Type | Description |
|---|---|---|
| newImplementation | address |
Parameters
| Name | Type | Description |
|---|---|---|
| newImplementation | address | |
| data | bytes |
Events
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| claimer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| claimer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| previousAdmin | address | ||
| newAdmin | address |
| Name | Type | Indexed | Description |
|---|---|---|---|
| owner | address | ✓ | |
| spender | address | ✓ | |
| value | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| beacon | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| executor | address | ✓ | |
| destination | address | ✓ | |
| amount | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| oldSource | address | ✓ | |
| newSource | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| newDelay | uint48 | ||
| effectSchedule | uint48 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| newAdmin | address | ✓ | |
| acceptSchedule | uint48 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| selector | bytes4 | ✓ | |
| facet | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| addr | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| addr | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| addr | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| rewards | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| version | uint8 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| multiplierId | uint32 | ✓ | |
| maturityPeriod | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| multiplierId | uint32 | ✓ | |
| apr | uint256 | ||
| timestamp | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| multiplierId | uint32 | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| multiplierId | uint32 | ✓ | |
| newRate | uint256 | ||
| scheduledTime | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| enabled | bool |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| oldClaimer | address | ✓ | |
| newClaimer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| claimer | address | ✓ | |
| multiplierId | uint32 | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| claimer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| oldDestination | address | ✓ | |
| newDestination | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| oldManager | address | ✓ | |
| newManager | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| claimer | address | ✓ | |
| oldMultiplierId | uint32 | ||
| newMultiplierId | uint32 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| minRate | uint256 | ||
| maxRate | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| oldReferenceTime | uint40 | ||
| newReferenceTime | uint40 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| proposer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| proposer | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| account | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| recipient | address | ✓ | |
| amount | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| payoutGroupId | uint32 | ✓ | |
| executor | address | ✓ | |
| destination | address | ✓ | |
| totalAmount | uint256 | ||
| accountCount | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| addr | address | ✓ | |
| payoutGroupId | uint32 | ✓ | |
| rewards | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| role | bytes32 | ✓ | |
| previousAdminRole | bytes32 | ✓ | |
| newAdminRole | bytes32 | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| role | bytes32 | ✓ | |
| account | address | ✓ | |
| sender | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| role | bytes32 | ✓ | |
| account | address | ✓ | |
| sender | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| supplyControlAddress | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| from | address | ✓ | |
| value | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| to | address | ✓ | |
| value | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| from | address | ✓ | |
| to | address | ✓ | |
| value | uint256 |
| Name | Type | Indexed | Description |
|---|---|---|---|
| addr | address | ✓ |
| Name | Type | Indexed | Description |
|---|---|---|---|
| implementation | address | ✓ |