Test Token Faucet
The GTX DEX Test Token Faucet provides developers and users with test tokens needed for development, testing, and experimentation across multiple testnets including GTX devnet and Base Sepolia.Overview
The faucet system allows users to request test tokens with built-in rate limiting and balance management:- Multiple Token Support - Request various test tokens
- Cooldown Periods - Prevents spam and ensures fair distribution
- Balance Tracking - Monitor both user and faucet balances
- Request History - Track all previous token requests
- Automatic Distribution - Instant token delivery upon request
Development Testing
Get tokens for smart contract testing and development
Trading Practice
Practice trading strategies with test tokens
Integration Testing
Test API integrations and trading functionality
UI/UX Testing
Test frontend interfaces and user workflows
Available Test Tokens
The faucet provides the following test tokens on GTX devnet:Core Trading Tokens
| Token | Symbol | Address | Decimals | Amount per Request |
|---|---|---|---|---|
| Mock USD Coin | MUSDC | 0xC004...CffF | 6 | 1,000 MUSDC |
| Mock Wrapped Ethereum | mWETH | 0xbb66...e99 | 18 | 5 mWETH |
| Mock Wrapped Bitcoin | mWBTC | 0xdDbe...A293 | 8 | 0.1 mWBTC |
| Mock Chainlink | LINK | 0x24b1...D901E | 18 | 100 LINK |
| Mock Pepe | PEPE | 0x7FB2...D147874 | 18 | 1,000,000 PEPE |
Token addresses are shortened for display. Full addresses are available in the smart contracts documentation.
Using the Faucet
Step-by-Step Guide
1
Connect Wallet
Connect your wallet to the GTX devnet
2
Select Token
Choose which test token you want to request from the dropdown
3
Check Cooldown
Verify you’re not in cooldown period from previous requests
4
Request Tokens
Click “Request Tokens” to submit your request
5
Confirm Transaction
Approve the transaction in your wallet
6
Receive Tokens
Tokens are automatically transferred to your wallet
Faucet Interface Features
Token Selection
Token Selection
Smart Token Picker
- Visual display of available tokens
- Real-time balance information
- Token symbol and contract address
- Amount per request clearly shown
Balance Tracking
Balance Tracking
Real-time Balance Display
- Your current token balance
- Faucet remaining balance
- Last request timestamp
- Next eligible request time
Request History
Request History
Transaction Tracking
- Complete history of your requests
- Transaction hashes and timestamps
- Request status and amounts
- Explorer links for verification
Rate Limiting & Cooldowns
Cooldown System
The faucet implements cooldown periods to ensure fair distribution:- Cooldown Rules
- Cooldown Status
Request Limitations
- Cooldown Period: 1 hour between requests per address
- Daily Limit: Maximum requests per 24-hour period
- Token Specific: Cooldowns apply per token type
- Fair Distribution: Prevents spam and hoarding
Integration Examples
API Integration
Use the GTX DEX API to programmatically request test tokens:Automated Testing Setup
Test Environment Setup
Integration Testing
Development Best Practices
Test Token Management
1
Plan Token Needs
Determine which tokens and amounts you need for testing
2
Respect Cooldowns
Space out requests according to cooldown periods
3
Monitor Balances
Track both personal and faucet balances to avoid waste
4
Use Efficiently
Don’t request more tokens than needed for testing
Testing Workflows
Smart Contract Testing
Smart Contract Testing
Contract Development Workflow
- Deploy contracts to testnet
- Request test tokens for contract addresses
- Test token transfers and interactions
- Verify balance changes and events
- Test edge cases and error conditions
Frontend Testing
Frontend Testing
UI/UX Testing Process
- Request tokens for test accounts
- Test wallet connection flows
- Verify balance displays and updates
- Test trading and swap interfaces
- Validate transaction confirmations
API Integration Testing
API Integration Testing
Backend Integration
- Request tokens for API testing
- Test balance queries and updates
- Verify transaction monitoring
- Test error handling and retries
- Validate data synchronization
Troubleshooting
Common Issues
| Issue | Cause | Solution |
|---|---|---|
| Cooldown Active | Recent request made | Wait for cooldown period to expire |
| Insufficient Faucet Balance | Faucet needs refilling | Try different token or wait for refill |
| Transaction Failed | Network congestion | Retry with higher gas price |
| Wrong Network | Connected to mainnet | Switch to GTX devnet |
Error Handling
Network Configuration
To use the faucet, ensure your wallet is connected to GTX devnet:The test token faucet is essential for development and testing on GTX DEX. Use it responsibly and respect cooldown periods to ensure fair access for all developers.
