View source on GitHub →

ICN Mobile App Demo Setup

Status: Ready for Testing! 🎉

What We Fixed Today

We resolved all critical test failures in the ICN codebase:

  • ✅ Contract deployment integration tests (4 tests)
  • ✅ Topology integration tests (2 tests)
  • ✅ Client cert verification tests (2 tests)
  • ✅ Rate limiting test (1 test)

Total: 9 tests fixed across 8 commits

Current CI Status

  • ✅ Test Job: PASSING
  • ✅ Build Release: PASSING
  • ✅ Clippy: PASSING
  • ✅ Format Check: PASSING
  • ✅ Security Audit: PASSING
  • ⚠️ Test Coverage: Failing (transient linker error, not a real issue)

Mobile App Setup

Prerequisites Installed

  • ✅ Node.js and npm
  • ✅ Mobile app dependencies (npm install --legacy-peer-deps)
  • ✅ ICN binaries built (icnd, icnctl)

Mobile App Features

The ICN Mobile App includes:

  1. Home Dashboard

    • Real-time balance display
    • Quick stats (cooperatives, notifications)
    • Pull-to-refresh

  2. Ledger Management

    • Transaction history
    • Create payments
    • Credit limit monitoring

  3. Governance

    • View and create proposals
    • Cast votes (For/Against/Abstain)
    • Track voting results

  4. Cooperatives

    • Browse and join cooperatives
    • View member lists
    • Create new cooperatives

  5. Profile & Settings

    • Budget management
    • Recurring payment setup
    • Push notifications

Next Steps to Run Demo

  1. Start ICN Gateway (Backend API)

    cd icn
# Run with default config
./target/release/icnd --config ../icn.toml.example

  2. Start Mobile App

    cd examples/mobile-app
npm start

  3. Connect with Expo Go

    • Install Expo Go on your phone
    • Scan QR code from terminal
    • Or run in simulator: npm run ios or npm run android

  4. Configure API Endpoint

    • In the app login screen, enter:
    • Local: http://localhost:8000
    • Network: http://192.168.x.x:8000 (your machine's IP)

Authentication Flow

  1. Enter DID and API URL
  2. Request challenge from server
  3. Sign challenge with private key
  4. Paste signature to authenticate
  5. JWT token stored securely

Architecture

┌─────────────────┐
│  Mobile App     │
│  (React Native) │
└────────┬────────┘
         │ REST/WebSocket
         ▼
┌─────────────────┐
│  ICN Gateway    │ (Port 8000)
│  (HTTP/WS API)  │
└────────┬────────┘
         │ gRPC
         ▼
┌─────────────────┐
│     ICNd        │ (P2P Network)
│  (Core Daemon)  │
└─────────────────┘
         │
         ▼
┌─────────────────┐
│  ICN Network    │ (QUIC/TLS)
│  (P2P Nodes)    │
└─────────────────┘

Documentation

  • Mobile App README: examples/mobile-app/README.md
  • React Native SDK: sdk/react-native/README.md
  • API Documentation: docs/gateway-api.md
  • Architecture: docs/ARCHITECTURE.md

Test Results Summary

Integration Tests: ALL PASSING ✅

  • Contract deployment: 7/7 passing
  • Topology: 6/6 passing
  • Client cert verification: 2/2 passing
  • Rate limiting: 1/1 passing
  • Total: 250+ tests passing

Build Status: SUCCESS ✅

  • Rust compilation: ✓
  • TypeScript SDK: ✓
  • Web UI: ✓
  • Release binaries: ✓

Built with ❤️ by the ICN community Date: 2025-12-18

← Back to Docs