Whitelist
The whitelist feature enables token issuers to explicitly grant access to specific addresses for holding and transferring tokens. This feature is only available for private tokens (tokens created with is_private = true).
How It Works
Default State: No addresses can use the token
After Whitelisting: Only approved addresses can receive and send the token
Authority: Only the token's master authority can manage the whitelist
Use Cases
Security Tokens: Restrict access to accredited investors only
Private Sales: Control participation in token sales
Enterprise Tokens: Limit usage to verified business partners
Membership Tokens: Grant access to exclusive community members
Key Points
Only whitelisted addresses can interact with the token
Non-whitelisted addresses cannot:
Receive tokens (transfers will fail)
Send tokens (blocked at protocol level)
View or interact with token functions
Whitelist status can be revoked at any time
All whitelist changes are recorded on-chain
Common Scenarios
KYC/AML Compliance
Private tokens often require Know Your Customer (KYC) verification before whitelisting, ensuring only verified users can participate.
Phased Access
Projects can gradually whitelist addresses for controlled token distribution phases (private sale → public sale → general access).
Geographic Restrictions
Whitelist only addresses from permitted jurisdictions to comply with regional regulations.
Important Notes
Private Tokens Only: Cannot use whitelist on public tokens
Strict Access Control: No exceptions for non-whitelisted addresses
Planning Required: Must whitelist addresses before they can receive tokens
Operational Overhead: Requires active management as new users join
Whitelist request for managing token whitelists
POST /v1/tokens/manage_whitelist HTTP/1.1
Host: api.testnet.1money.network
Content-Type: application/json
Accept: */*
Content-Length: 384
{
"action": "Add",
"address": "0x9E1E9688A44D058fF181Ed64ddFAFbBE5CC742Ab",
"chain_id": 1212101,
"nonce": 0,
"recent_checkpoint": 100,
"recent_epoch": 1,
"token": "0x6ADE9688A44D058fF181Ed64ddFAFbBE5CC742Ac",
"signature": {
"r": "72956732934625920503481762689501378577921804342307439094906376029324416116949",
"s": "29902520081700531224291681396692026253288382272435451874524203378285409371412",
"v": "1"
}
}{
"hash": "0xf55f9525be94633b56f954d3252d52b8ef42f5fd5f9491b243708471c15cc40c"
}Last updated