What is Token Freezing?
Token freezing allows the freeze authority to temporarily prevent transfers from a specific token account. When an account is frozen, tokens cannot be sent or received, but the account and balance remain intact. Freezing is reversible - frozen accounts can be unfrozen by the freeze authority.
Key Point: Freezing affects individual token accounts, not the entire token. You can freeze specific accounts while others remain active. This allows selective control over token transfers.
Freeze Authority Explained
Freeze authority is a special permission that controls the ability to freeze and unfreeze token accounts. When you create a token, you can:
- Retain Freeze Authority: Keep the ability to freeze accounts (useful for compliance or security)
- Revoke Freeze Authority: Remove the ability to freeze accounts permanently (common for decentralised tokens)
- Set Freeze Authority: Assign freeze authority to a different address (for multi-signature or DAO control)
Learn more about token authorities and how to manage them effectively.
Buying a token rather than creating one? An active freeze authority means the project can lock your wallet. See how to check a token's freeze authority before you buy to verify it on Solscan in under a minute.
When to Use Token Freezing
Security Measures
Freeze accounts suspected of fraudulent activity or compromised wallets to prevent further damage.
Compliance Requirements
Meet regulatory requirements by freezing accounts involved in investigations or legal proceedings.
Vesting Schedules
Implement vesting by freezing accounts until specific conditions or time periods are met.
Escrow Services
Use freezing as part of escrow mechanisms, freezing tokens until conditions are satisfied.
When NOT to Use Freezing
For most decentralised tokens, especially memecoins and utility tokens, freeze authority should be revoked. Reasons include:
- Decentralisation: Freeze authority creates centralised control, which conflicts with decentralised principles
- User Trust: Users may be concerned about tokens being frozen, reducing adoption
- Exchange Listings: Some exchanges prefer or require tokens without freeze authority
- Community Confidence: Revoking freeze authority demonstrates commitment to decentralisation
Important: If you're creating a decentralised token for public use, strongly consider revoking freeze authority during creation. This builds trust and aligns with decentralised principles.
How Freezing Works
Freezing an Account
To freeze a token account, the freeze authority executes a freeze instruction targeting the specific account. This:
- Marks the account as frozen on-chain
- Prevents all transfers from that account
- Prevents receiving tokens into that account
- Does not affect the account balance (tokens remain)
- Can be reversed by unfreezing
Unfreezing an Account
The freeze authority can unfreeze an account at any time, restoring full transfer functionality. Unfreezing is immediate and requires only a transaction from the freeze authority.
Managing Freeze Authority
Revoking Freeze Authority
To permanently remove the ability to freeze accounts, revoke freeze authority. This is done by setting the freeze authority to null. Once revoked, freeze authority cannot be restored, and no accounts can be frozen or unfrozen.
If you have existing frozen accounts when you revoke freeze authority, those accounts will remain frozen permanently. Ensure all accounts are unfrozen before revoking authority if you want them to be transferable.
Transferring Freeze Authority
You can transfer freeze authority to another address, such as a multi-signature wallet or DAO. This allows decentralised control over freezing decisions while maintaining the freezing capability.
Freezing Best Practices
- Document Freezing Policy: Clearly communicate when and why freezing might occur
- Use Sparingly: Only freeze accounts when absolutely necessary for security or compliance
- Consider Revocation: For public, decentralised tokens, revoke freeze authority to build trust
- Unfreeze Promptly: Unfreeze accounts as soon as issues are resolved
- Transparency: Be transparent about freezing decisions and policies