-
Notifications
You must be signed in to change notification settings - Fork 1
Mainnet VS Testnet
Understanding Pi Mainnet and Testnet for optimal app development and deployment
π Choose your development path based on your needs
| π― Aspect | π Pi Mainnet | π§ͺ Pi Testnet |
|---|---|---|
| Purpose | Live blockchain for real Pi transactions | Safe testing environment for development |
| Cryptocurrency | β Real Pi with actual value | π§ͺ Test Pi (test-Ο) with no value |
| Transactions | β Reversible & safe for testing | |
| User Access | KYC'ed Pioneers only | All developers and testers |
| Best For | Production apps, real transactions | Development, testing, prototyping |
βοΈ The live Pi blockchain powering real cryptocurrency transactions
Key Characteristics:
- π Live Blockchain - Operational Pi Network with real value
- π KYC Required - Only verified Pioneers can participate
- π° Real Pi Transactions - Actual cryptocurrency with economic value
- π‘οΈ Permanent Records - All transactions are irreversible
Current Phase: Firewalled Mainnet (Enclosed Network)
- π Launched: December 28, 2021
- π Status: Live but protected environment
- β Available: Pioneer-to-Pioneer and Pioneer-to-App transactions
- π« Restricted: No external blockchain connectivity or exchanges
Firewalled Mainnet Features
What's Available:
- β Real Pi transactions within Pi Network
- β Pi app integration and payments
- β Pi Wallet functionality
- β Pi Browser access for KYC'ed users
Current Limitations:
- β No external blockchain connectivity
- β No crypto exchange integration
- β Access limited to Pi Wallet and Pi Browser
- β Only Core Team Nodes operational
Future Phase: Open Mainnet (Open Network)
- π Coming: When ecosystem reaches maturity
- π Features: Full external connectivity
- ποΈ Infrastructure: Community-run nodes
- π APIs: Un-firewalled for broader integration
Open Mainnet Planned Features
Enhanced Capabilities:
- β External wallet connectivity
- β Cross-blockchain interactions
- β Crypto exchange integration
- β Pioneer-operated nodes
- β Community node participation
- β Open API access
Prerequisites:
- π Enclosed Network ecosystem maturity
- π Significant KYC completion progress
- π‘οΈ Security validation and testing
π¬ Safe testing environment for perfecting your Pi applications
Perfect For:
- π οΈ App Development - Build and test without risk
- π§ Feature Testing - Validate functionality safely
- π Learning - Understand Pi integration patterns
- π Pre-Launch Validation - Ensure quality before Mainnet
| π― Benefit | π Description | π‘ Use Case |
|---|---|---|
| Risk-Free Testing | No real Pi at stake | Experiment freely without financial consequences |
| Reversible Transactions | Mistakes can be undone | Learn from errors without permanent impact |
| Open Access | No KYC requirements | Immediate development start |
| Community Nodes | Decentralized testing environment | Real-world network simulation |
Purpose: Isolated local testing with Pi Testnet integration
Setup Requirements:
- β Registered URL in Developer Portal
- β Local development server
- β Pi SDK with sandbox configuration
Configuration:
// Sandbox setup
Pi.init({
version: "2.0",
sandbox: true // Enable sandbox mode
});Benefits:
- π§ Rapid Development - Instant feedback loop
- π‘οΈ Complete Isolation - No network dependencies
- π Debugging Tools - Full development environment
- β‘ Fast Iteration - Quick testing cycles
Cross-Environment Support:
- β Mainnet Wallet - Real Pi transactions for KYC'ed users
- β Testnet Wallet - Test Pi for development and testing
- π Environment Switching - Easy transition between networks
Start with Testnet if:
- π New to Pi Network development
- π§ͺ Building and testing features
- π Learning Pi SDK and APIs
- π§ Prototyping and experimenting
Move to Mainnet when:
- β App is thoroughly tested
- π₯ Ready for real user transactions
- π Confident in app stability
- π° Prepared for real Pi value
Recommended Development Flow:
- π Sandbox - Initial development and local testing
- π§ͺ Testnet - Integration testing with test Pi
- π Mainnet - Production deployment with real Pi
Key Transition Points:
- Thorough testing completion
- Security audit and validation
- User experience optimization
- Performance benchmarking
- SDK Reference - Complete setup instructions for all environments
- Pi Browser Detection - Hybrid app architecture for broader reach
- Examples - Working code samples for both environments
- Payments Overview - Transaction handling across networks
π― Pro Tip: Always start development on Testnet, perfect your app, then deploy to Mainnet for real-world impact!
π Learn More: Check out our complete setup guide for step-by-step instructions.
Important Links
- Pi Network Whitepaper (Roadmap Chapter): https://pinetwork-official.medium.com/pi-whitepaper-chapters-mainnet-token-model-mining-and-roadmap-19f4a6774e71
- π Home - Complete developer handbook
- π Community Support - Get help from Pi developers
- π Authorization - Authentication & security patterns
- π API Reference - Complete REST API documentation
- β‘ SDK Reference - JavaScript SDK comprehensive guide
- π Data Types - Object structures & schemas
- π Pi Browser Detection - Build hybrid Web2/Web3 apps
- π Migration Guide - Upgrade to hybrid architecture
- π» Code Examples - Production-ready samples & templates
- π What is PiNet? - Cross-platform app accessibility
- π³ What is PiWallet? - Pi Network wallet integration
- π° Payments Overview - Transaction handling guide
- π¬ Chat Rooms for Apps - Community engagement features
- π Mainnet vs. Testnet - Environment selection guide
- π Developer Terms - Terms of service
- βοΈ Social Chain ToS - Platform terms
- π Whitepaper - Pi Network foundations