Sui tools
Explore 20lab Sui Tools
Advanced tools to simplify your Sui token operations.Tools
Freeze/Unfreeze addresses
Blockchain
Token address
Mode
Addresses to freeze
Addresses
Upload file
Max size: 2 MB. Extensions: CSV or TXT
The freeze address tool is a security utility that lets token creators temporarily stop token transfers for specific wallet addresses. This is important for:
- Following compliance rules for regulated tokens
- Responding to suspicious activity or security threats
- Protecting compromised wallets from unauthorized transfers
- Enforcing token usage rules and community guidelines
This tool gives project teams a strong security feature to protect token holders and keep their token ecosystem safe when needed.
When an address is frozen, several restrictions are applied:
- The frozen address cannot send the specific token to any other address
- The frozen address cannot receive the specific token from any other address
- Any attempts to transfer tokens to or from the frozen address will fail
- The freeze affects only the specific token, not other assets in the wallet
The tokens remain in the frozen address and are still visible in wallet balances, but they cannot be moved until the address is unfrozen by the deny cap holder.
Only the wallet holding the Deny cap (or Deny cap V2) can freeze token addresses. This means:
- The original token creator (if they still have the deny cap)
- Any wallet that was given the deny cap
- A multisig wallet if the deny cap was transferred to it
- A governance program if freeze control has been delegated to it
Tokens created on 20lab use Deny cap V2 for enhanced freezing capabilities. If the deny cap has been revoked (permanently removed), no addresses can be frozen or unfrozen. This provides certainty to token holders when projects want to permanently disable this feature.
To freeze addresses with the 20lab freeze address tool:
- Connect the wallet that has the deny cap (or deny cap V2)
- Enter your token's address (coin type)
- Enter the wallet address you want to freeze, or upload a CSV file with multiple addresses
- Confirm the transaction to complete the freeze operation
The 20lab interface will verify you have the proper deny cap before allowing the transaction. Once confirmed, the specified addresses will be immediately frozen, preventing any transfers of that token.
Yes, the 20lab freeze address tool supports batch freezing through CSV upload:
- Prepare a CSV file with a list of wallet addresses to freeze
- Upload the CSV file through the interface
- Review the list of addresses before confirming
- Execute a single transaction to freeze all addresses in batches
For larger lists, the operation may be split into multiple transactions to fit within Sui's transaction limits. This batch processing makes it efficient to implement freezing for compliance or security purposes across many addresses at once.
Yes, any address that has been frozen can be unfrozen by the deny cap holder:
- The same 20lab tool provides an unfreeze function
- Only the current deny cap holder can perform the unfreeze operation
- Once unfrozen, normal token transfers immediately resume
- The process works for individual addresses or in batches
The ability to unfreeze addresses allows for temporary security measures that can be lifted once issues are resolved. For example, if an address was frozen due to suspicious activity, it can be unfrozen after investigation or when the legitimate owner regains control.
Address freezing serves important functions in various token scenarios:
- Security Response - Freezing addresses involved in suspicious transactions or potential hacks
- Regulatory Compliance - Implementing holds on addresses flagged by compliance systems
- Legal Requirements - Responding to valid legal orders in regulated token environments
- Anti-Fraud Measures - Temporarily freezing addresses during investigation of reported fraud
- Protocol Governance - Enforcing community-approved restrictions for protocol safety
Responsible use of the freeze functionality focuses on protecting the broader token ecosystem and users while maintaining transparency about freeze policies and procedures.
Yes, frozen addresses are detectable in several ways:
- Attempted transfers will fail with a "frozen address" error message
- Some wallets display a frozen indicator for affected tokens
- The freeze transaction is recorded on the blockchain
For transparent token management, it's considered best practice to establish clear communication channels and procedures so users understand why their address may have been frozen and how they can request unfreezing when appropriate.
No, freezing is not enabled by default on Sui tokens. The freezing capability depends on the token's configuration:
- Regulated tokens with Deny cap (or Deny cap V2) - Addresses can be frozen by the deny cap holder
- Tokens created with 20lab's freezable feature enabled - Addresses can be frozen by the deny cap holder
- Tokens with revoked Deny cap - No addresses can ever be frozen
Unlike Solana, freezing must be specifically enabled when creating a token by choosing the regulated coin option. Many decentralized projects never enable freezing to assure holders their tokens cannot be frozen. You can check if a token has an active deny cap through Sui block explorers.