Skip to content
EarthTeam App Wiki

Wallet

✅ Live on Production — This feature is fully deployed with live balance data from the Solana blockchain.

Wallet

Section titled “Wallet”

The Wallet screen displays the user’s EarthTeam Stars (ETC tokens) balance on the Solana blockchain. It shows lifetime earnings, current wallet balance, member ranking badge, and a transaction ledger with categorized entries. The wallet is non-custodial — each user gets a Solana wallet generated by the backend.

Key Capabilities

Section titled “Key Capabilities”
  • Balance Display — Two side-by-side stat cards: Lifetime Earnings and Wallet Balance
  • Member Ranking — Gold/Silver/Bronze badge based on user level and Stars earned
  • Transaction Ledger — Scrollable list of transactions with icons, titles, categories, dates, and amounts
  • Transaction Categories — Impact, Action, Verification, Collaboration tags
  • Convert & Receive — Action buttons for token conversion and receiving (UI present, backend pending)
  • Pull-to-Refresh — Refresh balance and ledger data
  • Empty State — Graceful “No Wallet Yet” fallback when no public key exists
  • 30s Auto-Refresh — Wallet balance automatically refreshes every 30 seconds

User Flow

Section titled “User Flow”
  1. Open Wallet tab → see balance cards and transaction history
  2. View Lifetime Earnings vs. current Wallet Balance
  3. Check Member Ranking badge (e.g., “Gold”)
  4. Scroll through transaction ledger entries
  5. Pull down to refresh latest data
  6. Tap “Convert” or “Receive” for token actions (coming soon)

Screenshots

Section titled “Screenshots”
Wallet page design mockupWallet page alternate designWallet screen actual state

How It Works

Section titled “How It Works”

When you open the Wallet screen, the app securely fetches your EarthTeam Stars (ETC) balance and transaction history from the Solana blockchain in real time. Each user is assigned a unique digital wallet behind the scenes — you never need to manage crypto keys or addresses yourself. Your balance automatically refreshes every 30 seconds so you always see the latest data, and you can pull down at any time to force an immediate refresh. Transactions are organized by category so you can easily see how you earned your Stars through contributions, verifications, and collaborations.

Planned Enhancements

Section titled “Planned Enhancements”
  • Withdrawal Management (Sprint 2) — Add external Solana wallet, 48h cool-off, KYC for >1000 Stars
  • Organization Wallet (Sprint 2) — Primary account badge, member status, transfer flow
  • Seed Phrase Backup (Sprint 6-8) — BIP39 mnemonic, biometric setup, FaceID/TouchID
  • Treasure Chest (Future) — Spend Stars on items in the marketplace
Section titled “Related Features”