Skip to content

Mainnet VS Testnet

alxspiker edited this page Jul 31, 2025 · 4 revisions

πŸ”„ Mainnet vs Testnet: Environment Guide

Choose the right Pi Network environment for your development needs

Understanding Pi Mainnet and Testnet for optimal app development and deployment

🎯 Quick Comparison

πŸš€ 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 ⚠️ Irreversible & permanent βœ… Reversible & safe for testing
User Access KYC'ed Pioneers only All developers and testers
Best For Production apps, real transactions Development, testing, prototyping

🌟 Pi Mainnet Deep Dive

⛓️ 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

πŸ—ΊοΈ Mainnet Roadmap

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

πŸ§ͺ Pi Testnet Deep Dive

πŸ”¬ 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

✨ Testnet Advantages

🎯 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

πŸ› οΈ Development Environments

🏠 Sandbox (Local Development)

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

πŸ’³ Pi Wallet Integration

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

πŸš€ Choosing Your Environment

πŸ“‹ Decision Matrix

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

⚑ Migration Path

Recommended Development Flow:

  1. 🏠 Sandbox - Initial development and local testing
  2. πŸ§ͺ Testnet - Integration testing with test Pi
  3. 🌟 Mainnet - Production deployment with real Pi

Key Transition Points:

  • Thorough testing completion
  • Security audit and validation
  • User experience optimization
  • Performance benchmarking

πŸ“š Additional Resources


🎯 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.

* See Pi Wallet page for details: [Pi Wallet](What-is-PiWallet%3F)

Important Links

🧭 Pi Developer Navigation

πŸš€ Getting Started


πŸ“– Core References


πŸ› οΈ Implementation Guides


🌟 Platform Features


βš™οΈ Environment & Deployment


πŸ“œ Legal & Compliance


πŸ“‘ Resources & Whitepapers


πŸ’‘ Need help? Join our Discord community!

Clone this wiki locally