Sui is a next-generation blockchain platform designed for building scalable decentralized applications. For developers looking to experiment, deploy, and interact with smart contracts on Sui’s test environments, SUI test tokens are essential. These tokens allow you to simulate real-world transactions without using actual funds. Since the Sui Mainnet does not support faucets, test tokens are only available on Devnet and Testnet through the Sui faucet—a developer tool that distributes free tokens for testing purposes.
This guide walks you through everything you need to know about acquiring SUI test tokens using various methods, including Discord, wallets, cURL commands, and the TypeScript SDK. Whether you're just starting out or optimizing your development workflow, this resource ensures you stay equipped with the tools and knowledge needed to build confidently on Sui.
Prerequisites: Set Up Your Sui Wallet Address
Before requesting test tokens, you must have a valid Sui wallet address capable of receiving SUI. If you don’t already have one, you can create a new address by following the official setup process in the Sui developer documentation.
Ensure your wallet is configured for either Devnet or Testnet, as mainnet addresses cannot receive faucet-disbursed tokens. Once your address is ready, you’re all set to proceed with any of the token request methods outlined below.
Request Test SUI Tokens via Discord
One of the most accessible ways to get test tokens is through the official Sui Discord community. This method is beginner-friendly and widely used by developers worldwide.
Steps to Request Tokens on Discord:
Join the Sui Discord server.
- Note: New Discord accounts may require a few days to pass verification before gaining full access.
Navigate to the appropriate faucet channel:
- For Devnet: Visit
#devnet-faucet - For Testnet: Use
#testnet-faucet
- For Devnet: Visit
Submit your request by sending the following message in the channel:
!faucet <your-wallet-address>
Replace <your-wallet-address> with your actual Sui address (e.g., 0x1a2b3c...). The faucet bot will process your request and send test tokens directly to your wallet within seconds.
This method is ideal for quick testing and learning, especially for those who prefer interactive platforms over command-line tools.
Use the Sui Wallet App to Claim Test Tokens
The Sui Wallet application provides a built-in option to request testnet tokens without leaving the interface. This streamlined approach enhances user experience and reduces dependency on external tools.
To request tokens:
- Open the Sui Wallet app.
- Ensure you're connected to Testnet or Devnet.
- Look for the “Get SUI” or “Request Tokens” feature within the app interface.
- Follow the prompts and enter your wallet address if required.
This method is perfect for mobile users and developers who prioritize simplicity and security within a trusted environment.
Get SUI Test Tokens Using cURL Commands
For advanced users comfortable with terminal operations, using cURL offers direct communication with the Sui faucet server—an efficient way to automate requests during development.
Basic cURL Command for Devnet:
curl --location --request POST 'https://faucet.devnet.sui.io/gas' \
--header 'Content-Type: application/json' \
--data-raw '{
"FixedAmountRequest": {
"recipient": "your-wallet-address-here"
}
}'Replace your-wallet-address-here with your actual Sui address (e.g., 0x5f7e6...).
Local Network Configuration
If you're running a local Sui network (e.g., via sui-test-validator or sui-faucet), adjust the endpoint accordingly:
- For
sui-faucet:http://127.0.0.1:5003/gas - For
sui-test-validator:http://127.0.0.1:9123/gas
Update the URL in the cURL command to match your local setup. This enables seamless integration when testing custom configurations or private chains.
This method supports automation scripts and CI/CD pipelines, making it ideal for teams working on large-scale dApp development.
Request Tokens Programmatically with TypeScript SDK
Developers building tools or integrating faucet functionality into their apps can leverage the Sui TypeScript SDK, which includes a dedicated module for requesting test tokens.
Example Code Snippet:
import { requestSuiFromFaucetV0, getFaucetHost } from '@mysten/sui.js/faucet';
// Request tokens from Devnet faucet
await requestSuiFromFaucetV0({
host: getFaucetHost('devnet'), // or 'testnet'
recipient: 'your-wallet-address-here',
});This approach allows developers to embed faucet requests directly into testing frameworks, onboarding flows, or developer dashboards—enhancing usability and reducing manual steps.
It's particularly useful for teams creating educational platforms, hackathon toolkits, or internal dev environments where automated funding is crucial.
Testing on a Local Sui Network
When developing in isolated environments, such as local networks, you can run your own local faucet instance. This gives full control over token distribution and gas limits during debugging and performance testing.
To set up a local faucet:
- Launch a local Sui validator using
sui-test-validator. - Interact with the local faucet endpoint (
http://127.0.0.1:9123/gas) via cURL or SDK. - Distribute tokens to multiple test addresses programmatically.
For detailed instructions, refer to the official guide on connecting to a local Sui network.
This method is recommended for advanced use cases like stress-testing contracts, simulating multi-user scenarios, or auditing gas consumption patterns.
Frequently Asked Questions (FAQ)
Q: Can I get free SUI tokens on Mainnet?
A: No. The Sui Mainnet does not have a faucet. Free test tokens are only available on Devnet and Testnet for development purposes.
Q: How often can I request test tokens from the faucet?
A: The faucet allows periodic requests, but excessive usage may trigger rate limiting. It's intended for development, not accumulation.
Q: Are there any restrictions on using testnet tokens?
A: Test tokens have no monetary value and can only be used within their respective test networks (Devnet/Testnet). They cannot be transferred to Mainnet.
Q: What should I do if I don’t receive tokens after requesting?
A: Double-check your wallet address for errors. Ensure you’re using the correct network (Devnet/Testnet). If issues persist, try again later or reach out in the Sui Discord support channels.
Q: Is it safe to share my wallet address publicly for faucet requests?
A: Yes. Sharing your public wallet address is safe and necessary for receiving tokens. Never share your private key or recovery phrase.
Q: Can I use these methods for other blockchains?
A: While similar concepts exist (like Ethereum’s Goerli faucet), each blockchain has its own infrastructure. Always consult official documentation for accurate procedures.
With multiple options available—from Discord commands to programmatic SDK integrations—you can choose the best method based on your technical level and development needs.
Whether you're launching your first smart contract or scaling a decentralized application, having reliable access to test tokens accelerates innovation on the Sui blockchain.
Ready to take your blockchain projects further? Explore more tools and resources to support your journey in Web3 development.