How pingidentity/pingone-wallet-mobile-sdk-android works
Main Components
a. Core Components:
• PingOne Wallet SDK (Central Component)
• Mobile Application Layer
• Storage Layer
• Communication Layer
• Authentication/Security Layer
b. External Services:
• PingOne Cloud Services
• Firebase Cloud Messaging (FCM)
• PingOne Mailbox Service
• PingOne Credentials Service
Architecture Breakdown
The system should be represented in layers, with the following structure:
┌─ Mobile Application Layer ─────────────────────────────────────┐
• ┌─ UI Components ─────┐ ┌─ Application Logic ──────────────┐ │
• Home Fragment │ │ - MainApplication │ │
• QR Scanner │ │ - Dependency Injection │ │
• Credential Views │ │ - View Models │ │
• ┘ └────────────────────────────────┘ │
• PingOne Wallet SDK Layer ───────────────────────────────────┤
• ┌─ Core SDK ──────────┐ ┌─ Wallet Helper ───────────────┐ │
• Client Builder │ │ - Credential Management │ │
• Wallet Client │ │ - Pairing Management │ │
• Event Handlers │ │ - Presentation Management │ │
• ┘ └────────────────────────────────┘ │
• Storage Layer ───────────────────────────────────────────────┤
• ┌─ Secure Storage ────┐ ┌─ Data Repository ─────────────┐ │
• Credential Store │ │ - Credential Management │ │
• Key Management │ │ - Data Access Layer │ │
• ┘ └────────────────────────────────┘ │
• Communication Layer ──────────────────────────────────────────┤
• ┌─ Network Services ──┐ ┌─ Push Notifications ──────────┐ │
• API Client │ │ - FCM Integration │ │
• Request Handling │ │ - Notification Service │ │
• ┘ └────────────────────────────────┘ │
• ┘
┌─ External Services ────────────────────────────────────────────┐
• ┌─ PingOne Cloud ─────┐ ┌─ Firebase ──────────────────────┐ │
• Credentials API │ │ - Cloud Messaging │ │
• Mailbox Service │ └────────────────────────────────┘ │
• ┘ │
• ┘
Data Flow Indicators
• Credential issuance flow
• Credential presentation flow
• Pairing flow
• Push notification flow
Important Elements to Highlight
a. Security Features:
• End-to-end encryption
• Secure storage
• Authentication mechanisms
b. Integration Points:
• FCM integration
• PingOne services integration
• App link handling
c. Key Processes:
• Wallet initialization
• Credential management
• Pairing process
• Presentation handling
Additional Notes
• Version information
• Security compliance requirements
• Error handling paths
• Optional components (like ApplicationUiHandler)
Implementation Details
• The DI structure (di folder)
• The UI components (ui folder)
• The wallet helper implementation
• The notification handling system
Remember to include notes about the asynchronous nature of many operations and how they're handled through RxJava observables, as evidenced in the code structure.