In the ever-evolving ecosystem of blockchain protocols, security mechanisms and compliance tools have moved from optional extras to essential foundations. When building tokens on the Sui network, implementing a freezable feature (deny list) from day one can serve as a critical safeguard for your project's future. Sui tokens equipped with freezable capabilities provide a sophisticated security layer: the power to restrict specific addresses from buying, selling or transferring tokens, giving projects the protective infrastructure and regulatory alignment they need in today's landscape.
Why Freezable Tokens Matter on Sui
Picture this scenario: you've successfully launched your token on the Sui blockchain, only to discover certain addresses engaging in suspicious activities or market manipulation. With conventional tokens, your response options would be severely constrained. However, with a freezable Sui token implementation, you gain powerful defensive capabilities to shield your community and uphold compliance standards by selectively restricting problematic addresses from interacting with your token ecosystem.
Freezable tokens on Sui are especially valuable for:
- Projects requiring enhanced security against malicious actors.
- Protocols that need to comply with regulatory requirements.
- DAOs and communities that want to enforce governance decisions.
- Platforms seeking to protect users from compromised wallets.
In this guide, we'll walk you through creating your own token with a freezable feature on the Sui blockchain using 20lab's Sui token generator - an easy-to-use tool that eliminates the need for complex coding. You'll learn how to configure your token parameters, implement freezable capabilities, and effectively manage your token's deny list through an intuitive dashboard. Whether you're a blockchain entrepreneur, project manager, or someone new to the Sui ecosystem, this tutorial will show you how to deploy a token with security measures that can protect your project and community.
How to Create Your Sui Token with Freezable Feature
We'll be using the 20lab.app platform to create our Sui token with freezable functionality. This user-friendly Sui token generator streamlines the token creation process and makes it accessible to everyone - whether you're a developer, project owner, or just getting started in the Sui ecosystem.
Step 1: Choose Token Type and Connect Wallet
First, visit 20lab.app, navigate to the generator page and click on "Create Sui Token".
The next step is to connect your Sui wallet (e.g. Suiet wallet, Sui wallet or Stashed) to the platform. After successful connection you will automatically see your wallet address in the top right corner.
Make sure you're connected to the Sui Mainnet (or Sui Testnet if you're experimenting with your token). If you're using 20lab's token generator, you'll find the Sui network option among other blockchain choices in the platform. While 20lab supports multiple blockchains, for the purposes of this guide, we'll focus specifically on creating a token on the Sui network.
Step 2: Add General Token Information
When creating your token on the Sui blockchain, it's important to carefully configure the initial parameters that will define the characteristics of your token. Let's go through the basic configuration settings in 20lab's Sui Token Generator.
First, you'll need to set your token's name and symbol. The token name is the full name, while the symbol serves as a shorter identifier for your token. Unlike many other blockchains, Sui offers the flexibility to change both the name and symbol later if you have the treasury cap and metadata authority.
Your module name is a unique identifier that appears at the end of your Sui token address (coin type). While it doesn't need to match your token name, it must follow specific syntax rules:
- Must start with a lowercase letter.
- Can only contain lowercase letters, numbers and underscores (_).
- Cannot be changed after deployment.
If you're unsure what to use, 20lab can automatically generate a module name based on your token name.
Choose how divisible your token will be by setting the decimal places (0-9). For best compatibility within the Sui ecosystem:
- Most common values are 6 or 9 decimal places.
- Higher decimal places will limit your maximum initial supply.
- This setting is permanent and cannot be changed after deployment.
The initial supply determines how many tokens are created at launch. When setting this value, keep the following in mind:
- The maximum initial supply depends on the number of decimal places you choose.
- Lower decimal places allow for higher initial supply value.
- This will be your fixed supply unless you also enable the mintable feature.
When you create your Sui token, you'll need to specify two important wallet addresses that will control different aspects of your token. The first is the supply recipient address, which will receive all tokens created during the initial deployment. By default, this is set to your currently connected wallet address. However, if you want these tokens to go to a different wallet, you can enable the "Different supply recipient" option and specify an alternative address.
The second important address is the treasury cap, which holds administrative control over your token's restricted functions. Like the supply recipient, this defaults to your connected wallet, but you can designate a different address by enabling the "Different treasury cap" option. This address is particularly important as it will maintain control over your token's administrative functions after deployment, so choose this address carefully based on your project's governance needs.
Step 3: Freezable Feature
One of the most powerful security mechanisms you can integrate into your Sui token is the freezable feature, which gives you granular control to restrict specific addresses from interacting with their tokens. In the "Optional" features section of the generator, you'll find the "Freezable" option which should be enabled to leverage this crucial functionality.
When enabled, this feature creates two important components:
- A deny list connection which will store all frozen addresses.
- A deny cap that will have authority to add and remove addresses on this list.
Addresses added to this deny list experience immediate restrictions on transferring tokens from their balance, and importantly, at the start of the next epoch on the Sui blockchain, they will also be prevented from receiving tokens. This two-phase implementation ensures comprehensive protection while respecting Sui's consensus timing mechanisms. This capability provides a sophisticated security framework for:
- Protecting your community from malicious actors.
- Complying with legal requirements when necessary.
- Implementing governance decisions.
- Securing tokens in compromised wallets.
Step 4: Review and Deploy
Before deploying your token with the freezable feature on the Sui network, take the time to carefully review all of the configured settings on the "Summary" page. This final check is critical to ensure that your token will work as intended once deployed.
On this page you'll see all your chosen configurations:
- Token name and symbol,
- Module name,
- Initial supply and decimals,
- Supply recipient address,
- Treasury cap address,
- Freezable feature settings.
Click the "Validate" button to perform a technical review of your token configuration. This step ensures that all parameters meet Sui requirements and can help identify any potential issues prior to deployment.
If validation is successful, click "Deploy" to create your token on the Sui network. Your connected wallet will prompt you to authorize the transaction and cover the necessary gas fees. After confirming the transaction, your token will be deployed on the Sui blockchain with all specified parameters and freezable capabilities!
Managing Your Freezable Sui Token
After deploying your token on the Sui network, 20lab's dashboard provides an intuitive interface to monitor and manage your token. This comprehensive dashboard gives you full visibility and control over your token's operations, including the freezable feature.
The dashboard displays essential token information, including your token's coin type (address), current supply, token name, symbol, and decimal places. You can also review other configured parameters such as the module name (displayed at the end of your token's address) and treasury cap holder.
The "General (Sui)" section of the 20lab dashboard provides essential functions for managing your Sui token. Here you can merge your coin objects into a single one, check the balance of specific addresses, transfer and burn tokens.
A crucial capability accessible through the dashboard for tokens with freezable functionality is the comprehensive deny list management system, controlled by the deny cap holder. The "Freezable" section provides an intuitive interface to add or remove addresses from the deny list as needed and manage the address that currently holds the deny cap.
To add an address to the deny list, follow these steps:
- Navigate to the "Freezable" section of your token dashboard.
- Enter the Sui wallet address you want to restrict.
- Click "Freeze" to initiate the process.
Your connected wallet will prompt you to approve the transaction and cover the gas fees. Once the transaction is confirmed on the Sui network, the address will be added to the deny list, preventing it from transferring tokens from its balance and additionally at the start of next epoch on Sui blockchain also receiving your token.
Similarly, to remove an address from the deny list when necessary:
- In the same function change the "Status" to "Unfreeze" for the particular address.
- Click "Unfreeze" to initiate the process.
- Approve the transaction through your connected wallet.
The dashboard also allows you to monitor other token activity and manage various aspects of your token, making it a central hub for the ongoing management of your token on the Sui network.
Conclusion
Creating a token with a freezable feature on the Sui network provides powerful security tools for your project. The ability to restrict problematic addresses gives you the means to protect your community, comply with regulations, and maintain the integrity of your token ecosystem.
20lab's Token Generator simplifies the entire process, from initial configuration to ongoing management of your deny list. By removing technical barriers, it allows you to focus on what really matters - your project's security and community protection. The intuitive interface and comprehensive dashboard make token creation and security management accessible to everyone in the Sui ecosystem.
By leveraging the features of both the Sui blockchain and 20lab's platform, you'll be well-equipped to launch and manage a token with the security features necessary in today's blockchain landscape.
If you have any questions about creating or managing your Sui token with freezable capabilities, don't hesitate to reach out to us via our Telegram channel.
