Issuers
Last updated
Last updated
Robust, role-based issuance and compliance features are offered on the 1Money Network.
This guide covers:
Token access types (public vs. private)
Authority hierarchy and permissions (to assign and revoke priviledges)
Token operations (mint, burn, pause, blacklist, whitelist, metadata updates)
Using the API for authority management
A are provided to manage and automate Issuance.
When creating a Token, Issuers must choose between:
Public Token: Accessible to all network participants, except those blacklisted by the issuer.
Private Token: Restricted to whitelisted addresses only.
The master_authority is the root of the permission hierarchy and has complete control over the token capabilities for the token. It can:
Grant and revoke all other authority types
Mint tokens without allowance restrictions
The Authority system follows a hierarchical structure with the master_authority at the top:
The Master Authority wallet can be secured using MPC solutions for multi party signing workflows available on most Custodian platforms.
The Master Authority serves as the "super admin" for managing rights to other sub-authorities for a given Token.
The master_authority can assign or revoke the following roles:
master_mint_burn_authority
1
Grant/revoke minting/burning privileges, set mint limits (cannot mint directly)
mint_burn_authorities
20
Mint tokens (up to allowance), burn tokens from any account (cannot grant privileges)
pause_authorities
5
Pause/unpause all token operations
black_list_authorities
5
Blacklist addresses (preventing them from sending/receiving tokens)
white_list_authorities
5
Whitelist addresses (allowing them to send/receive private tokens)
metadata_update_authorities
5
Update token name, URI, and additional metadata
Only the master_authority and mint_burn_authorities can mint tokens.
master_authority: Unlimited minting
mint_burn_authorities: Minting up to assigned allowance
Both can burn tokens from any account.
Only black_list_authorities can blacklist addresses.
Blacklisted addresses cannot send or receive tokens.
Blacklisting is immediate
Only white_list_authorities can whitelist addresses.
Whitelisted addresses can participate in private token operations.
Whitelisting is immediate
Only pause_authorities can pause or unpause tokens.
Paused State: All transfers, mints, and burns are disabled. Useful for emergencies or maintenance.
Unpaused State: All token operations resume.
The master_authority retains the ability to manage authorities even when paused.
Only metadata_update_authorities can update token metadata.
Changes are effective immediately.
The token URI can point to a JSON file with additional information.
Additional metadata supports arbitrary key-value pairs.
Grant/revoke roles
master_authority
Mint tokens
master_authority, mint_burn_authorities
Burn tokens
master_authority, mint_burn_authorities
Pause/unpause
pause_authorities
Blacklist address
black_list_authorities
Whitelist address
white_list_authorities
Update metadata
metadata_update_authorities
In "action" - select either Grant or Revoke
Select the appropriate "authority_type" : MasterMintBurn, MintTokens, Pause, Burn, Blacklist, Whitelist , UpdateMetadata
Example:
When the 1Money Network Operator creates a token for an issuer, the token will be paused by default.
When a token is paused:
No transfers, mints, or burns can occur
Pausing is effective immediately
This is useful for emergency situations or scheduled maintenance
The master_authority can still grant and revoke all authority types while their token is paused.
The pause_authorities must unpause the token before it can be transferred, minted or burned.
When a token is unpaused:
Transfers, mints, or burns can occur
Unpausing is effective immediately
All token operations resume normal functionality
The transaction signer must be the token's pause_authorities to pause or unpause a token.
Similarly, to pause the token again, pause can be passed through the action parameter.
The master_mint_burn_authority has the power to grant mint_burn_authorities to specific addresses of their choosing.
mint_burn_authorities have minting privileges and can create new tokens up to their allowance limit but cannot grant minting privileges to others. They can also burn tokens from any account.
Only the master_authority and mint_burn_authorities can mint tokens.
master_authority can mint tokens without allowance restrictions, while the mint_burn_authorities can mint new tokens up to their allowance.
Only the black_list_authorities can blacklist addresses. This adds an account to the token's blacklist, preventing it from participating in token operations.
Parameters:
address: Address - The address to blacklist
Required Permissions:
The transaction signer must be in the token's black_list_authorities list
Note:
Blacklisted addresses cannot send or receive tokens
Blacklisting is effective immediately
The token account must exist and be associated with the token
Only the white_list_authorities can whitelist addresses. This allows an address to participate in token operations.
Parameters:
address: Address - The address to whitelist
Required Permissions:
The transaction signer must be in the token's white_list_authorities list
Note:
Whitelisting is effective immediately
The token account must exist and be associated with the token
This updates the token's metadata.
Note:
Metadata updates are effective immediately
The URI can point to a JSON file with additional information
Additional metadata can store arbitrary key-value pairs
The 1Money Network Operator will use the API to create the token on the issuer's behalf and grant master_authority to the issuer's specified address.
master_authority can use the API to grant or revoke authorities to specific addresses:
To unpause a token, the pause_authorities can use the API:
Use the API to set the mint_burn_authorities :
Use the API:
mint_burn_authorities can burn tokens through the API:
Use the API to blacklist addresses:
Use the API to whitelist addresses by setting the "action" to "Whitelist":
metadata_update_authorities can use the API: