What is PiWallet? - alxspiker/Pi-Network-Developer-Docs GitHub Wiki

๐Ÿ’ณ What is PiWallet?

Your secure, non-custodial gateway to the Pi Network blockchain

Manage Pi cryptocurrency safely with advanced security and seamless integration

๐ŸŽฏ Overview

๐Ÿ” PiWallet is your personal, secure interface to the Pi Network blockchain ecosystem

What PiWallet Provides:

  • ๐Ÿ›ก๏ธ Non-Custodial Security - You control your private keys completely
  • ๐ŸŒ Multi-Network Support - Seamlessly switch between Mainnet and Testnet
  • ๐Ÿ”’ Advanced Authentication - Biometric and passphrase protection
  • โšก Developer-Friendly - Perfect for app testing and integration

๐Ÿ”‘ Core Principles

Your Keys, Your Control:

  • โœ… Non-Custodial Design - Pi servers never access your passphrase
  • โœ… Personal Ownership - Complete control over your cryptocurrency
  • โœ… Privacy Protection - Your financial data stays private
  • โœ… Security First - Industry-standard encryption and protection

โœจ Key Features & Capabilities

๐ŸŽฏ Feature ๐Ÿ“ Description ๐Ÿ’ก Benefit
Network Switching Toggle between Mainnet and Testnet Easy development and production management
Biometric Auth Face/fingerprint unlock on supported devices Convenient yet secure access
Multi-Blockchain Generate addresses across different networks Future-proof asset management
Testnet Faucet Free Test Pi for development Risk-free app testing environment

๐Ÿ”„ Environment Management

Seamless Network Switching:

  • ๐ŸŒŸ Pi Mainnet - Real Pi transactions with actual value
  • ๐Ÿงช Pi Testnet - Safe testing with Test Pi (no value)
  • โšก Instant Toggle - Switch environments within the same wallet
  • ๐Ÿ›ก๏ธ Isolated Balances - Separate accounting for each network

๐Ÿš€ Getting Started with PiWallet

๐Ÿ“‹ Prerequisites

Mainnet Wallet Requirements

For Real Pi Transactions:

  • โœ… KYC Verification - Approved Know Your Customer status
  • โœ… Pi Network Account - Active Pi mining account
  • โœ… Minimum Balance - Maintain required balance for validity
  • โœ… Security Setup - Strong passphrase and backup plan
Testnet Wallet (Development)

For Testing & Development:

  • โœ… Developer Account - Basic Pi Network registration
  • โœ… Pi Browser Access - Available through Pi Browser
  • โœ… No KYC Required - Immediate access for testing
  • ๐Ÿ†“ Free Test Pi - Via built-in faucet system

๐Ÿ”ง Wallet Creation Process

Step-by-Step Setup:

  1. Access PiWallet - Open through Pi Browser
  2. Follow Setup Wizard - Guided creation process
  3. Generate Passphrase - Secure word sequence creation
  4. Backup Securely - Store passphrase safely offline
  5. Enable Biometrics - Optional convenient access (if supported)
  6. Fund Wallet - Add Pi or get Test Pi from faucet

๐Ÿ›ก๏ธ Security Best Practices

๐Ÿ” Passphrase Protection

โš ๏ธ Critical: Your passphrase is like your bank password - treat it with extreme care!

Essential Security Rules:

  • ๐Ÿšซ Never Share - Don't give your passphrase to anyone
  • ๐Ÿ’พ Backup Offline - Store securely away from internet
  • ๐Ÿ“ Write Down - Physical backup is most secure
  • ๐Ÿ”’ Use Biometrics - When available for convenience
  • ๐Ÿ›ก๏ธ Regular Checks - Verify backup accessibility periodically

๐Ÿ”’ Advanced Security Features

Built-in Protection:

  • ๐Ÿ›ก๏ธ Encryption - Military-grade passphrase encryption
  • ๐Ÿ” Local Storage - Keys never leave your device
  • ๐Ÿ‘ค Biometric Lock - Face/fingerprint authentication
  • โฐ Auto-Lock - Automatic timeout protection

๐Ÿ› ๏ธ Developer Integration

๐Ÿงช Testing Environment

Testnet Faucet Benefits:

  • ๐Ÿ†“ Free Test Pi - No cost for development testing
  • โšก Instant Access - Immediate funding for testing
  • ๐Ÿ”„ Unlimited Usage - Test as much as needed
  • ๐Ÿ›ก๏ธ Risk-Free - No real value at stake

Perfect For:

  • ๐Ÿ“ฑ App development and testing
  • ๐Ÿ”ง Payment flow validation
  • ๐ŸŽฏ User experience optimization
  • ๐Ÿ“Š Performance benchmarking

๐ŸŒŸ Production Deployment

Mainnet Integration:

  • ๐Ÿ’ฐ Real Transactions - Actual Pi cryptocurrency value
  • ๐Ÿ” KYC Users Only - Verified Pioneer transactions
  • โšก Seamless UX - Same wallet, real value
  • ๐Ÿ“ˆ Economic Activity - Drive real ecosystem growth

๐ŸŽฏ Future Roadmap

Coming Soon:

  • ๐Ÿ’ผ Developer Wallets - Enhanced development features
  • ๐ŸŒ Cross-Chain Support - Additional blockchain networks
  • ๐Ÿ“Š Analytics Dashboard - Transaction insights and reporting
  • ๐Ÿ”ง Advanced APIs - Deeper integration capabilities

๐Ÿ“š Resources & Support

๐ŸŽฅ Learning Materials

๐Ÿ†˜ Getting Help

  • Community Support - Developer community assistance
  • Examples - Working integration samples
  • Developer Portal - Official documentation and tools

๐Ÿš€ Ready to Integrate PiWallet?

Start with Testnet for safe development, then deploy to Mainnet for real Pi transactions!

๐ŸŽฏ Next Steps: Check out our Examples for working PiWallet integration code.

โš ๏ธ **GitHub.com Fallback** โš ๏ธ