In Solana's SPL (Solana Program Library) token program, the freeze authority is an account that has the special permission to freeze tokens in a specific token account.
What Does Freezing Mean?
When a token account is frozen, all transfers (sending or receiving) involving that account are blocked. This is useful for compliance, security, or regulatory reasons (e.g., locking tokens during an investigation or legal dispute).
Key Points About Freeze Authority:
-
Assigned at Token Mint Creation
-
When creating a new token mint (
spl-token create-token), you can optionally set a freeze authority. -
If no freeze authority is set (
--disable-freeze-authority), the mint can never freeze accounts. -
Authority Can Freeze/Thaw Accounts
-
Freeze a token account (
spl-token freeze <TOKEN_ACCOUNT>), preventing transfers. -
Thaw a frozen account (
spl-token thaw <TOKEN_ACCOUNT>), allowing transfers again. -
The freeze authority can:
-
Revocable
-
The freeze authority can be revoked (
spl-token authorize <TOKEN_MINT> --disable-freeze-authority), making the freeze status permanent (if frozen) or preventing future freezes. -
Different from Mint Authority
-
The mint authority controls token supply (minting/burning).
-
The freeze authority only controls freezing/thawing accounts.
Example CLI Commands:
# Create a new token with a freeze authority spl-token create-token --freeze-authority <AUTHORITY_PUBKEY> # Freeze a token account spl-token freeze <TOKEN_ACCOUNT_ADDRESS> # Thaw a frozen account spl-token thaw <TOKEN_ACCOUNT_ADDRESS> # Disable (revoke) freeze authority permanently spl-token authorize <TOKEN_MINT_ADDRESS> --disable-freeze-authority
Use Cases:
-
Stablecoins & Security Tokens: Compliance with regulations (e.g., freezing suspicious accounts).
-
NFT Projects: Locking tokens during disputes.
-
DeFi Protocols: Temporarily freezing funds in case of hacks.
If a token mint has no freeze authority, accounts can never be frozen. This is common for decentralized tokens where censorship resistance is a priority.
