View source on GitHub →

Mobile App Deployment Test Results

Date: 2025-12-16 Gateway: http://10.8.10.40:30080 Environment: K3s Homelab Cluster

Deployment Status ✅

ICN Daemon

  • Status: Running (1/1 pods ready)
  • Image: icn:497ba66db799cef91092c8ac71b0f1bfb0f41c07
  • Deployment Strategy: Recreate (fixed database lock issues)
  • Health Check: ✅ Responding at /v1/health

Services Exposed

  • Gateway API: http://10.8.10.40:30080 (NodePort 30080)
  • Prometheus Metrics: Port 9100
  • QUIC P2P: Port 7777/UDP (NodePort 30777)
  • RPC: Port 5601/TCP (NodePort 30601)

API Endpoint Tests ✅

Core Health

  • ✅ GET /v1/health - Returns {"status":"ok","version":"0.1.0"}
  • ✅ GET /v1/sdis/health - Returns {"service":"sdis","status":"ok","version":"1.0"}

Authentication Flow

  • ✅ POST /v1/auth/challenge - Challenge-response mechanism working
    • Requires: {"did": "did:icn:..."}
    • Returns: {"nonce": "...", "expires_in": 300}
  • ✅ POST /v1/auth/verify - JWT token generation working
    • Requires: DID, signature, nonce, scopes, coop_id
    • Returns: JWT token

SDIS Enrollment (Tested Successfully)

  • ✅ POST /v1/sdis/enrollment/start - Enrollment initiation working
    • Test Result: Created enrollment f809f551-51df-433e-812d-d076e127a773
    • Verification Code: VERIFY-8000
    • Successfully generates ephemeral credentials

Protected Endpoints (Require Authentication)

  • ✅ /v1/ledger/{coop_id}/balance/{did} - Returns 401 without auth (correct)
  • ✅ /v1/ledger/{coop_id}/history/{did} - Returns 401 without auth (correct)
  • ✅ /v1/ledger/{coop_id}/pay - Returns 401 without auth (correct)
  • ✅ /v1/gov/domains - Returns 401 without auth (correct)
  • ✅ /v1/gov/proposals - Returns 401 without auth (correct)

All protected endpoints are properly secured and require JWT authentication.

Mobile App Configuration ✅

CoopWallet (React Native)

Location: /home/matt/projects/icn/sdk/react-native/examples/CoopWallet

Configuration (src/config.ts):

export const GATEWAY_URL = 'http://10.8.10.40:30080';  // ✅ Correctly configured

Features:

  • ✅ Secure Authentication (Ed25519 keys in device secure storage)
  • ✅ Balance Display (real-time updates)
  • ✅ Send Payments (mutual credit transfers)
  • ✅ QR Payments (scan-to-pay and receive)
  • ✅ Governance (view and vote on proposals)
  • ✅ SDIS Enrollment (device verification flow)

Supported Platforms:

  • iOS (Expo/React Native)
  • Android (Expo/React Native)
  • Web (PWA via Expo)

User Flows Supported

1. SDIS Enrollment (Simple Device Verification)

  1. User opens CoopWallet
  2. Selects "Join Cooperative"
  3. Enters identity name and coop ID
  4. App calls /v1/sdis/enrollment/start
  5. Receives verification code
  6. Shows QR code for Level 1 verification
  7. Steward scans QR and vouches
  8. Level 2 verification completes
  9. DID and credentials stored securely

2. Existing Identity Login

  1. User has existing DID/keystore
  2. Enters gateway URL and coop ID
  3. App generates challenge via /v1/auth/challenge
  4. Signs challenge with stored private key
  5. Submits signature via /v1/auth/verify
  6. Receives JWT token
  7. Token stored securely for subsequent requests

3. Send Payment

  1. Authenticated user navigates to "Send"
  2. Enters recipient DID (or scans QR)
  3. Enters amount and optional memo
  4. App calls /v1/ledger/{coop_id}/pay
  5. Transaction confirmed
  6. Balance updated in real-time

4. Receive Payment (QR Code)

  1. User navigates to "Receive"
  2. App generates QR code with their DID
  3. Optionally specifies suggested amount
  4. Payer scans QR code
  5. Payment details pre-filled
  6. Receiver gets real-time notification

5. Governance Voting

  1. User navigates to "Governance"
  2. App fetches proposals via /v1/gov/proposals
  3. User views proposal details
  4. Casts vote (for/against/abstain)
  5. App submits via /v1/gov/vote
  6. Vote recorded and tallied

Running the Mobile App

Development Mode (Expo)

cd /home/matt/projects/icn/sdk/react-native/examples/CoopWallet
npm install  # If not already done
npm start    # Starts Expo dev server

Then:

  • iOS: Press i or scan QR with Expo Go
  • Android: Press a or scan QR with Expo Go
  • Web: Press w to open in browser

Production Build

# iOS
eas build --platform ios

# Android
eas build --platform android

Test Scripts Available

Basic Endpoint Test

/home/matt/projects/icn/scripts/test-mobile-app-endpoints.sh

Tests all mobile app API endpoints without authentication.

SDIS Enrollment Test

/home/matt/projects/icn/scripts/test-sdis-enrollment.sh

Tests complete SDIS enrollment flow (working successfully).

Full E2E Test (with authentication)

/home/matt/projects/icn/scripts/test-mobile-app-e2e.sh

Tests full authentication flow and protected endpoints.

Known Issues / Notes

✅ Resolved

  • Database lock conflicts in K3s deployment → Fixed with Recreate strategy
  • Metrics test failures → Fixed test to not depend on middleware behavior
  • CI test failures → All tests passing (1134+ tests)

📝 Current State

  • Pilot UI: Not running (image not present, but not needed for mobile app)
  • WebSocket: Returns 401 (requires auth token first, which is correct)
  • SDIS QR Verification: Enrollment works, QR-based Level 1 verification ready for steward testing

🎯 Ready for Testing

The mobile app backend is fully operational and ready for:

  1. ✅ SDIS enrollment testing
  2. ✅ Mobile app authentication
  3. ✅ Payment transactions
  4. ✅ Governance voting
  5. ✅ Real-time updates via WebSocket (after authentication)

Next Steps for Mobile Testing

  1. Start CoopWallet:

    cd /home/matt/projects/icn/sdk/react-native/examples/CoopWallet
npm start

  2. Test SDIS Enrollment Flow:

  3. Test Authenticated Features:

    • View balance
    • Send test payment
    • View transaction history
    • Browse governance proposals
    • Cast votes

  4. Test Real-Time Updates:

    • Open app on two devices
    • Send payment from one to the other
    • Verify real-time balance updates

Summary

🎉 All systems operational!

  • ✅ Gateway API responding correctly
  • ✅ Authentication flow working
  • ✅ SDIS enrollment system operational
  • ✅ All protected endpoints properly secured
  • ✅ Mobile app correctly configured
  • ✅ Ready for end-user testing

The ICN mobile app infrastructure is fully deployed and ready for pilot testing!

← Back to Docs