Getting Your First Tokens Tutorial
This tutorial explains how ReserveBTC's Oracle-based system works and how you can get synthetic tokens automatically minted based on your Bitcoin holdings.
Prerequisites Checklist
Required Setup
- EVM wallet connected (MetaMask)
- MegaETH Testnet configured
- Test ETH for gas fees
- Bitcoin wallet with BIP-322 support
What You Need
- Bitcoin address with balance
- Completed address verification
- Understanding of token types
- ~5 minutes of time
📝 Not ready yet? Check out our Wallet Setup Guide and Verification Process first.
Step 1: Choose Your Token Type
ReserveBTC offers two types of synthetic tokens. Choose based on your intended use case:
rBTC-SYNTH (Soulbound)
Best for: Personal DeFi use, yield farming, lending protocols where transfers aren't needed
wrBTC (Transferable)
Best for: Trading, advanced DeFi strategies, liquidity provision, any use case requiring transfers
Step 2: Oracle-Based Token Management
ReserveBTC uses an Oracle-based system where tokens are automatically minted and burned based on your Bitcoin balance changes. You don't manually mint tokens.
Complete Address Verification
Prove ownership of your Bitcoin address through the web interface.
- Go to app.reservebtc.io
- Connect your EVM wallet (MetaMask)
- Enter your Bitcoin address
- Complete BIP-322 signature verification
Oracle Registration
After verification, Oracle server adds your address to monitoring list.
💡 Automated Process: The Oracle server (oracle-server.js) automatically starts monitoring your Bitcoin address every 5 minutes.
Automatic Balance Monitoring
Oracle monitors your Bitcoin address and detects balance changes.
What Oracle Tracks:
- • Current Bitcoin balance via BlockCypher API
- • Balance changes (deltas) from last sync
- • Transaction confirmations
- • Last sync timestamp
- • Fee calculations for sync operations
Automatic Token Operations
When balance changes are detected, Oracle automatically calls sync() function.
Automatic Operations:
- • Positive delta: Mint rBTC-SYNTH tokens
- • Negative delta: Burn rBTC-SYNTH tokens
- • No user interaction required
- • Oracle pays gas fees
- • 1:1 backing ratio maintained
- • Transaction recorded on-chain
- • Oracle updates user records
- • Balance sync initiated
✅ Success! Your MetaMask will show the transaction confirmation, and you'll receive your synthetic tokens within seconds.
Step 3: Add Tokens to Your Wallet
To see your newly minted tokens in MetaMask, you need to add the token contracts.
rBTC-SYNTH Token
wrBTC Token
Manual Token Addition
- Open MetaMask and go to "Assets" tab
- Scroll down and click "Import tokens"
- Select "Custom token" tab
- Paste the token contract address
- Symbol and decimals should auto-fill
- Click "Add Custom Token"
- Click "Import tokens" to confirm
Step 4: Verify Successful Mint
Confirm that your minting was successful by checking multiple indicators:
Token Balance
Check MetaMask for new token balance
Transaction Hash
Verify on MegaETH explorer
Oracle Status
Check dashboard for sync status
What's Next?
Congratulations! You've successfully minted your first ReserveBTC synthetic tokens. Here are some things you can do next:
Using Your Tokens
- 🔄 Hold and watch auto-sync with your Bitcoin
- 🏦 Deposit into lending protocols
- 🌾 Participate in yield farming
- 💱 Trade wrBTC on DEXes (if minted)
- 🏗️ Use in complex DeFi strategies
- 📊 Monitor performance and yields
💡 Pro Tips
- • Monitor your Oracle dashboard to see balance synchronization in real-time
- • Your tokens will automatically adjust when your Bitcoin balance changes
- • Keep small amount of ETH for gas fees if you plan to make transactions
- • Consider minting both token types for maximum flexibility
Common Issues During First Mint
❌ "Insufficient Gas Fee"
Solution: Get more test ETH from MegaETH developers. You need at least 0.001 ETH for gas fees.
❌ "Address Not Verified"
Solution: Complete the verification process first. See our Verification Guide.
❌ "Transaction Failed"
Solution: Check network connection, increase gas limit, or try again. Contact support if issue persists.