# michaeltchuangllc/algokit-walletsdk-kmp architecture

> Architecture diagram of the GitHub repository michaeltchuangllc/algokit-walletsdk-kmp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/michaeltchuangllc/algokit-walletsdk-kmp
- Repository: https://github.com/michaeltchuangllc/algokit-walletsdk-kmp

## Overview

AlgoKit Wallet SDK is a multiplatform wallet library: apps embed its UI layer, which uses the headless core for wallet operations. The principal flow is app-driven account onboarding or recovery, followed by account use and transaction signing; Liquid Auth adds peer connection and Liquid Stream session billing. The README also documents passkeys, settings, QR workflows, and Algorand transactions. Several feature paths are represented from the tree and README, but their internal calls were not sampled, so those links are omitted or marked unverified.

Main entry points: [`wallet-sdk-ui`](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui) (Wallet UI SDK), [`wallet-sdk-core`](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core) (Wallet Core), [`wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.kt`](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.kt) (Peer Connection), [`wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt`](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt) (Block Billing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Embedded Wallet UI"]
  node_ui_sdk["Wallet UI SDK"]
  node_demo["Demo Wallet"]
  node_settings["Theme and Locale"]
end

subgraph group_accounts["Accounts and Signing"]
  node_account["Account Onboarding"]
  node_algo["Algorand Transactions"]
  node_passkeys["Passkey Credentials"]
  node_passkey_service["Passkey Provider"]
end

subgraph group_auth["Authentication and Streaming"]
  node_liquid_auth["Liquid Auth"]
  node_offer["Offer View Model"]
  node_connection["Peer Connection"]
  node_signal["Signaling Service<br/>[SignalService.kt]"]
  node_stream["Liquid Stream"]
  node_billing["Block Billing"]
  node_mpp["MPP Payment Operations<br/>[MppPayments.kt]"]
  node_vault["Escrow Session Vault"]
end

subgraph group_platform["Platform Foundations"]
  node_core["Wallet Core"]
  node_encryption["Key Encryption"]
  node_cache[("Persistent Cache")]
end

node_app(("Wallet App"))
node_algorand{{"Algorand Network"}}
node_peer(("Remote Peer"))

node_app -->|"embeds"| node_ui_sdk
node_app -->|"uses"| node_core
node_demo -->|"demonstrates"| node_ui_sdk
node_ui_sdk -->|"uses"| node_core
node_core -->|"uses SDKs"| node_algorand
node_ui_sdk -.->|"provides"| node_settings
node_core -.->|"supports"| node_account
node_account -.->|"enables signing"| node_algo
node_ui_sdk -.->|"exposes"| node_passkey_service
node_passkey_service -->|"handles credentials"| node_passkeys
node_ui_sdk -.->|"provides"| node_liquid_auth
node_liquid_auth -.->|"offers sessions"| node_offer
node_connection -->|"uses"| node_signal
node_connection -.->|"connects"| node_peer
node_connection -->|"starts billing"| node_billing
node_stream -->|"manages payments"| node_billing
node_billing -.->|"settles vouchers"| node_mpp
node_mpp -->|"operates vault"| node_vault
node_core -.->|"provides"| node_encryption
node_core -.->|"provides"| node_cache

click node_ui_sdk "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui"
click node_demo "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/sharedDemoApp"
click node_settings "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/settings"
click node_account "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/account"
click node_algo "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/algosdk/transaction/builders"
click node_passkeys "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/passkeys"
click node_passkey_service "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/passkeys/PasskeyProviderService.kt"
click node_liquid_auth "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth"
click node_offer "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/viewmodels/LiquidAuthOfferViewModel.kt"
click node_connection "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.kt"
click node_signal "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/liquidAuth/auth/connect/SignalService.kt"
click node_stream "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidStream/domain/manager/MppPaymentViewerManager.kt"
click node_billing "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt"
click node_mpp "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/utils/MppPayments.kt"
click node_vault "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/smartcontract/EscrowSessionVaultHybridManagerClient.kt"
click node_core "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core"
click node_encryption "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/encryption"
click node_cache "https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/foundation/cache"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui_sdk,node_demo,node_settings toneBlue
class node_account,node_algo,node_passkeys,node_passkey_service toneAmber
class node_liquid_auth,node_offer,node_connection,node_signal,node_stream,node_billing,node_mpp,node_vault toneMint
class node_core,node_encryption,node_cache toneRose
class node_app,node_algorand,node_peer toneIndigo
```

## Components

### Embedded Wallet UI

- [Wallet UI SDK](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui): `wallet-sdk-ui`
- [Demo Wallet](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/sharedDemoApp): `sharedDemoApp`
- [Theme and Locale](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/settings): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/settings`

### Accounts and Signing

- [Account Onboarding](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/account): `wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/account`
- [Algorand Transactions](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/algosdk/transaction/builders): `wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/algosdk/transaction/builders`
- [Passkey Credentials](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/passkeys): `wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/passkeys`
- [Passkey Provider](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/passkeys/PasskeyProviderService.kt): `wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/passkeys/PasskeyProviderService.kt`

### Authentication and Streaming

- [Liquid Auth](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth`
- [Offer View Model](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/viewmodels/LiquidAuthOfferViewModel.kt): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/viewmodels/LiquidAuthOfferViewModel.kt`
- [Peer Connection](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.kt): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.kt`
- [Signaling Service](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/liquidAuth/auth/connect/SignalService.kt): `wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/liquidAuth/auth/connect/SignalService.kt`
- [Liquid Stream](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidStream/domain/manager/MppPaymentViewerManager.kt): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidStream/domain/manager/MppPaymentViewerManager.kt`
- [Block Billing](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt): `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt`
- [MPP Payment Operations](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/utils/MppPayments.kt): `wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/utils/MppPayments.kt`
- [Escrow Session Vault](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/blob/main/wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/smartcontract/EscrowSessionVaultHybridManagerClient.kt): `wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/smartcontract/EscrowSessionVaultHybridManagerClient.kt`

### Platform Foundations

- [Wallet Core](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core): `wallet-sdk-core`
- [Key Encryption](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/encryption): `wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/encryption`
- [Persistent Cache](https://github.com/michaeltchuangllc/algokit-walletsdk-kmp/tree/main/wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/foundation/cache): `wallet-sdk-core/src/androidMain/kotlin/com/michaeltchuang/walletsdk/core/foundation/cache`

### Other components

- **Wallet App**
- **Algorand Network**
- **Remote Peer**

## Connections

- Wallet App → Wallet UI SDK: embeds (evidence: `README.md`)
- Wallet App → Wallet Core: uses (evidence: `README.md`)
- Demo Wallet → Wallet UI SDK: demonstrates (evidence: `README.md`)
- Wallet UI SDK → Wallet Core: uses (evidence: `README.md`)
- Wallet Core → Algorand Network: uses SDKs (evidence: `README.md`)
- Wallet UI SDK → Theme and Locale: provides
- Wallet Core → Account Onboarding: supports (evidence: `wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/transaction/signmanager/TransactionSignManager.kt`)
- Account Onboarding → Algorand Transactions: enables signing
- Wallet UI SDK → Passkey Provider: exposes (evidence: `wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/passkeys/PasskeyProviderService.kt`)
- Passkey Provider → Passkey Credentials: handles credentials (evidence: `wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/passkeys/PasskeyProviderService.kt`)
- Wallet UI SDK → Liquid Auth: provides (evidence: `wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.android.kt`)
- Liquid Auth → Offer View Model: offers sessions (evidence: `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt`)
- Peer Connection → Signaling Service: uses (evidence: `wallet-sdk-ui/src/androidMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.android.kt`)
- Peer Connection → Remote Peer: connects
- Peer Connection → Block Billing: starts billing (evidence: `wallet-sdk-ui/src/iosMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/service/LiquidAuthConnectionManager.ios.kt`)
- Liquid Stream → Block Billing: manages payments (evidence: `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidStream/domain/manager/MppPaymentViewerManager.kt`)
- Block Billing → MPP Payment Operations: settles vouchers (evidence: `wallet-sdk-ui/src/commonMain/kotlin/com/michaeltchuang/walletsdk/ui/liquidAuth/utils/LiquidStreamBlockConsumptionManager.kt`)
- MPP Payment Operations → Escrow Session Vault: operates vault (evidence: `wallet-sdk-core/src/commonMain/kotlin/com/michaeltchuang/walletsdk/core/railmpp/utils/MppPayments.kt`)
- Wallet Core → Key Encryption: provides
- Wallet Core → Persistent Cache: provides
