How to Get Testnet Tokens
Last updated
Was this helpful?
Last updated
Was this helpful?
Testnet tokens are a great way to experiment with Stellar wallets and blockchain operations without risking real assets. This guide explains how to obtain testnet tokens, their purpose, and how to use them effectively.
Testnet tokens are virtual assets used on Stellar's test network (testnet) to:
Test wallet setups.
Experiment with sending and receiving payments.
Learn Stellar operations like creating trustlines or setting up smart contracts.
Risk-Free Learning: No monetary value; perfect for practice.
Development Testing: Test your applications or smart contracts before deploying on the mainnet.
Community Access: Many developers and testers rely on the testnet for Stellar experiments.
Go to the Stellar Laboratory:
Paste your Public Key into the faucet's input field.
Click "Request Lumens":
You’ll receive a transaction confirmation.
Check your wallet to confirm receipt of 10,000 XLM test tokens.
Install the Stellar CLI:
Install the stellar-core
or stellar-horizon
command-line tool (refer to Stellar documentation).
Request Tokens:
Run the following command:
Replace <Your Public Key>
with your Stellar wallet address.
Verify Balance:
Use the CLI or a Stellar wallet to check your testnet account balance.
Set the Trustline: Ensure you've established a trustline for USDC on your Stellar testnet account. Issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
Visit the Circle USDC Faucet:
Select Stellar and Request USDC:
Use the dropdown menu to select "Stellar".
Paste your Stellar testnet address.
Click on "Get Tokens" to receive testnet USDC.
Send tokens between test accounts.
Experiment with memo fields, transaction fees, and multi-signature setups.
Trustlines: Use testnet tokens to create trustlines for custom assets.
Asset Issuance: Test issuing and trading custom assets.
Smart Contracts: Experiment with Stellar's pre-signed transactions to simulate smart contracts.
Use your testnet wallet with Stellar-based dApps like Trustless Work to test integrations.
Most Stellar wallets allow you to switch between the mainnet and testnet. Here's how:
Open your wallet settings.
Look for the "Network" option.
Switch from Mainnet to Testnet.
Save your settings and restart the wallet if required.
Freighter Wallet:
Click on Settings > Network > Testnet.
Rabet Wallet:
Select "Network" in the main menu and toggle to Testnet.
Albedo Wallet:
Adjust the network via the settings or during the transaction prompt.
Testnet Tokens Have No Value:
These tokens are strictly for testing and cannot be transferred to the mainnet.
Testnet Environment Resets:
The Stellar testnet resets periodically, clearing all test accounts and balances.
Always re-create your accounts and re-fund them when the testnet resets.
Avoid Sharing Secret Keys:
Even in a test environment, keep your Secret Key secure to mimic best practices for the mainnet.
Ensure you’ve used the correct Public Key.
Try another method (e.g., Stellar Faucet vs. Laboratory).
Wait for a few minutes as the testnet might experience delays.
Make sure your wallet supports Stellar’s testnet.
Check for updates or consider using a wallet that supports testnet, like Freighter or Rabet.
Without the Secret Key, you cannot access your testnet account. Treat it as you would a real wallet key.
By following this guide, you can confidently explore Stellar’s testnet and test a variety of operations risk-free.
Go to .