# tangem/tangem-app-android architecture

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

- Interactive diagram: https://gitdiagram.com/tangem/tangem-app-android
- Repository: https://github.com/tangem/tangem-app-android

## Overview

Tangem is an Android crypto-wallet application. The likely user workflow starts in the app, loads wallet state, and then lets the user manage assets or initiate wallet operations. The tree also shows distinct product areas for receiving assets, staking, WalletConnect, Tangem Pay, and Polymarket. Source excerpts confirm selected storage, response, API-configuration, and review-manager behavior; most feature implementations and their runtime wiring were not sampled, so those relationships are left unverified rather than inferred.

Main entry points: [`features/wallet/impl`](https://github.com/tangem/tangem-app-android/tree/master/features/wallet/impl) (Wallet experience), [`data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt`](https://github.com/tangem/tangem-app-android/blob/master/data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt) (Wallet managers), [`app/src/main/java/com/tangem/tap/MainActivity.kt`](https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/MainActivity.kt) (Main activity), [`core/local/src/main/kotlin/com/tangem/datasource/local/preferences/AppPreferencesStore.kt`](https://github.com/tangem/tangem-app-android/blob/master/core/local/src/main/kotlin/com/tangem/datasource/local/preferences/AppPreferencesStore.kt) (App preferences)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_entry["Android entry"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
end

subgraph group_wallet["Wallet and assets"]
  node_wallet_feature["Wallet experience"]
  node_wallet_manager["Wallet managers"]
  node_asset_loader["Asset loading<br/>[AssetLoader.kt]"]
  node_token_details["Token details"]
  node_manage_tokens["Token management"]
end

subgraph group_operations["Wallet operations"]
  node_receive["Receive assets"]
  node_send["Send assets"]
  node_staking["Staking"]
  node_walletconnect["WalletConnect flow"]
  node_wc_request["WC request service"]
  node_wc_respond["WC response service"]
end

subgraph group_services["Product services"]
  node_tangempay["Tangem Pay"]
  node_pay_storage[("Pay storage")]
  node_visa_tokens[("Visa auth storage")]
  node_polymarket[("Polymarket storage")]
  node_gasless["Gasless API config"]
end

subgraph group_platform["Shared platform"]
  node_preferences[("App preferences")]
  node_wallet_id["Wallet identity<br/>[UserWalletId.kt]"]
  node_review["Store review"]
  node_review_service["Review interface<br/>[ReviewManager.kt]"]
end

node_user(("Wallet user"))
node_external_wallet(("Connected wallet app"))
node_gasless_service{{"Gasless transaction service"}}

node_user -.->|"opens"| node_activity
node_entry -.->|"starts"| node_activity
node_activity -.->|"shows"| node_wallet_feature
node_wallet_feature -.->|"loads wallet"| node_wallet_manager
node_wallet_manager -.->|"loads assets"| node_asset_loader
node_wallet_feature -.->|"opens details"| node_token_details
node_wallet_feature -.->|"manages tokens"| node_manage_tokens
node_wallet_feature -.->|"starts receive"| node_receive
node_wallet_feature -.->|"starts send"| node_send
node_wallet_feature -.->|"opens staking"| node_staking
node_wallet_feature -.->|"opens connection"| node_walletconnect
node_walletconnect -.->|"handles requests"| node_wc_request
node_wc_respond -.->|"responds via SDK"| node_external_wallet
node_tangempay -.->|"stores Pay state"| node_pay_storage
node_pay_storage -->|"reads and writes"| node_preferences
node_visa_tokens -.->|"stores preferences"| node_preferences
node_polymarket -->|"configures persistence"| node_preferences
node_wallet_manager -.->|"uses identity"| node_wallet_id
node_gasless -.->|"configures API"| node_gasless_service
node_review -->|"implements"| node_review_service

click node_entry "https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/ApplicationEntryPoint.kt"
click node_activity "https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/MainActivity.kt"
click node_wallet_feature "https://github.com/tangem/tangem-app-android/tree/master/features/wallet/impl"
click node_wallet_manager "https://github.com/tangem/tangem-app-android/blob/master/data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt"
click node_asset_loader "https://github.com/tangem/tangem-app-android/blob/master/core/datasource/src/main/java/com/tangem/datasource/asset/loader/AssetLoader.kt"
click node_token_details "https://github.com/tangem/tangem-app-android/blob/master/features/tokendetails/impl/src/main/kotlin/com/tangem/feature/tokendetails/presentation/tokendetails/state/TokenDetailsStateController.kt"
click node_manage_tokens "https://github.com/tangem/tangem-app-android/blob/master/features/manage-tokens/impl/src/main/kotlin/com/tangem/features/managetokens/utils/list/ManageTokensListManager.kt"
click node_receive "https://github.com/tangem/tangem-app-android/blob/master/features/token-recieve/impl/src/main/java/com/tangem/features/tokenreceive/route/TokenReceiveRoutes.kt"
click node_send "https://github.com/tangem/tangem-app-android/tree/master/features/send/impl"
click node_staking "https://github.com/tangem/tangem-app-android/blob/master/features/staking/impl/src/main/java/com/tangem/features/staking/impl/presentation/state/StakingStateController.kt"
click node_walletconnect "https://github.com/tangem/tangem-app-android/blob/master/features/walletconnect/impl/src/main/kotlin/com/tangem/features/walletconnect/transaction/routes/WcTransactionRoutes.kt"
click node_wc_request "https://github.com/tangem/tangem-app-android/blob/master/domain/wallet-connect/src/main/kotlin/com/tangem/domain/walletconnect/WcRequestService.kt"
click node_wc_respond "https://github.com/tangem/tangem-app-android/blob/master/data/wallet-connect/src/main/kotlin/com/tangem/data/walletconnect/respond/DefaultWcRespondService.kt"
click node_tangempay "https://github.com/tangem/tangem-app-android/tree/master/features/tangempay"
click node_pay_storage "https://github.com/tangem/tangem-app-android/blob/master/data/visa/src/main/kotlin/com/tangem/data/pay/store/DefaultTangemPayStorage.kt"
click node_visa_tokens "https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/data/DefaultVisaAuthTokenStorage.kt"
click node_polymarket "https://github.com/tangem/tangem-app-android/blob/master/data/polymarket/src/main/java/com/tangem/data/polymarket/di/PolymarketStorageModule.kt"
click node_gasless "https://github.com/tangem/tangem-app-android/blob/master/grow/datasource/src/main/kotlin/com/tangem/grow/datasource/config/GaslessTxService.kt"
click node_preferences "https://github.com/tangem/tangem-app-android/blob/master/core/local/src/main/kotlin/com/tangem/datasource/local/preferences/AppPreferencesStore.kt"
click node_wallet_id "https://github.com/tangem/tangem-app-android/blob/master/domain/models/src/main/kotlin/com/tangem/domain/models/wallet/UserWalletId.kt"
click node_review "https://github.com/tangem/tangem-app-android/blob/master/app/src/google/java/com/tangem/tap/GoogleReviewManager.kt"
click node_review_service "https://github.com/tangem/tangem-app-android/blob/master/core/navigation/src/main/java/com/tangem/core/navigation/review/ReviewManager.kt"

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_entry,node_activity,node_user toneBlue
class node_wallet_feature,node_wallet_manager,node_asset_loader,node_token_details,node_manage_tokens toneAmber
class node_receive,node_send,node_staking,node_walletconnect,node_wc_request,node_wc_respond toneMint
class node_tangempay,node_pay_storage,node_visa_tokens,node_polymarket,node_gasless toneRose
class node_preferences,node_wallet_id,node_review,node_review_service,node_external_wallet,node_gasless_service toneIndigo
```

## Components

### App shell

- [Android entry](https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/ApplicationEntryPoint.kt): `app/src/main/java/com/tangem/tap/ApplicationEntryPoint.kt`
- [Main activity](https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/MainActivity.kt): `app/src/main/java/com/tangem/tap/MainActivity.kt`

### Wallet and assets

- [Wallet experience](https://github.com/tangem/tangem-app-android/tree/master/features/wallet/impl): `features/wallet/impl`
- [Wallet managers](https://github.com/tangem/tangem-app-android/blob/master/data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt): `data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt`
- [Asset loading](https://github.com/tangem/tangem-app-android/blob/master/core/datasource/src/main/java/com/tangem/datasource/asset/loader/AssetLoader.kt): `core/datasource/src/main/java/com/tangem/datasource/asset/loader/AssetLoader.kt`
- [Token details](https://github.com/tangem/tangem-app-android/blob/master/features/tokendetails/impl/src/main/kotlin/com/tangem/feature/tokendetails/presentation/tokendetails/state/TokenDetailsStateController.kt): `features/tokendetails/impl/src/main/kotlin/com/tangem/feature/tokendetails/presentation/tokendetails/state/TokenDetailsStateController.kt`
- [Token management](https://github.com/tangem/tangem-app-android/blob/master/features/manage-tokens/impl/src/main/kotlin/com/tangem/features/managetokens/utils/list/ManageTokensListManager.kt): `features/manage-tokens/impl/src/main/kotlin/com/tangem/features/managetokens/utils/list/ManageTokensListManager.kt`

### Wallet operations

- [Receive assets](https://github.com/tangem/tangem-app-android/blob/master/features/token-recieve/impl/src/main/java/com/tangem/features/tokenreceive/route/TokenReceiveRoutes.kt): `features/token-recieve/impl/src/main/java/com/tangem/features/tokenreceive/route/TokenReceiveRoutes.kt`
- [Send assets](https://github.com/tangem/tangem-app-android/tree/master/features/send/impl): `features/send/impl`
- [Staking](https://github.com/tangem/tangem-app-android/blob/master/features/staking/impl/src/main/java/com/tangem/features/staking/impl/presentation/state/StakingStateController.kt): `features/staking/impl/src/main/java/com/tangem/features/staking/impl/presentation/state/StakingStateController.kt`
- [WalletConnect flow](https://github.com/tangem/tangem-app-android/blob/master/features/walletconnect/impl/src/main/kotlin/com/tangem/features/walletconnect/transaction/routes/WcTransactionRoutes.kt): `features/walletconnect/impl/src/main/kotlin/com/tangem/features/walletconnect/transaction/routes/WcTransactionRoutes.kt`
- [WC request service](https://github.com/tangem/tangem-app-android/blob/master/domain/wallet-connect/src/main/kotlin/com/tangem/domain/walletconnect/WcRequestService.kt): `domain/wallet-connect/src/main/kotlin/com/tangem/domain/walletconnect/WcRequestService.kt`
- [WC response service](https://github.com/tangem/tangem-app-android/blob/master/data/wallet-connect/src/main/kotlin/com/tangem/data/walletconnect/respond/DefaultWcRespondService.kt): `data/wallet-connect/src/main/kotlin/com/tangem/data/walletconnect/respond/DefaultWcRespondService.kt`

### Product services

- [Tangem Pay](https://github.com/tangem/tangem-app-android/tree/master/features/tangempay): `features/tangempay`
- [Pay storage](https://github.com/tangem/tangem-app-android/blob/master/data/visa/src/main/kotlin/com/tangem/data/pay/store/DefaultTangemPayStorage.kt): `data/visa/src/main/kotlin/com/tangem/data/pay/store/DefaultTangemPayStorage.kt`
- [Visa auth storage](https://github.com/tangem/tangem-app-android/blob/master/app/src/main/java/com/tangem/tap/data/DefaultVisaAuthTokenStorage.kt): `app/src/main/java/com/tangem/tap/data/DefaultVisaAuthTokenStorage.kt`
- [Polymarket storage](https://github.com/tangem/tangem-app-android/blob/master/data/polymarket/src/main/java/com/tangem/data/polymarket/di/PolymarketStorageModule.kt): `data/polymarket/src/main/java/com/tangem/data/polymarket/di/PolymarketStorageModule.kt`
- [Gasless API config](https://github.com/tangem/tangem-app-android/blob/master/grow/datasource/src/main/kotlin/com/tangem/grow/datasource/config/GaslessTxService.kt): `grow/datasource/src/main/kotlin/com/tangem/grow/datasource/config/GaslessTxService.kt`

### Shared platform

- [App preferences](https://github.com/tangem/tangem-app-android/blob/master/core/local/src/main/kotlin/com/tangem/datasource/local/preferences/AppPreferencesStore.kt): `core/local/src/main/kotlin/com/tangem/datasource/local/preferences/AppPreferencesStore.kt`
- [Wallet identity](https://github.com/tangem/tangem-app-android/blob/master/domain/models/src/main/kotlin/com/tangem/domain/models/wallet/UserWalletId.kt): `domain/models/src/main/kotlin/com/tangem/domain/models/wallet/UserWalletId.kt`
- [Store review](https://github.com/tangem/tangem-app-android/blob/master/app/src/google/java/com/tangem/tap/GoogleReviewManager.kt): `app/src/google/java/com/tangem/tap/GoogleReviewManager.kt`
- [Review interface](https://github.com/tangem/tangem-app-android/blob/master/core/navigation/src/main/java/com/tangem/core/navigation/review/ReviewManager.kt): `core/navigation/src/main/java/com/tangem/core/navigation/review/ReviewManager.kt`

### Other components

- **Wallet user**
- **Connected wallet app**
- **Gasless transaction service**

## Connections

- Wallet user → Main activity: opens
- Android entry → Main activity: starts
- Main activity → Wallet experience: shows
- Wallet experience → Wallet managers: loads wallet
- Wallet managers → Asset loading: loads assets (evidence: `data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt`)
- Wallet experience → Token details: opens details
- Wallet experience → Token management: manages tokens
- Wallet experience → Receive assets: starts receive
- Wallet experience → Send assets: starts send
- Wallet experience → Staking: opens staking
- Wallet experience → WalletConnect flow: opens connection
- WalletConnect flow → WC request service: handles requests
- WC response service → Connected wallet app: responds via SDK
- Tangem Pay → Pay storage: stores Pay state
- Pay storage → App preferences: reads and writes (evidence: `data/visa/src/main/kotlin/com/tangem/data/pay/store/DefaultTangemPayStorage.kt`)
- Visa auth storage → App preferences: stores preferences
- Polymarket storage → App preferences: configures persistence (evidence: `data/polymarket/src/main/java/com/tangem/data/polymarket/di/PolymarketStorageModule.kt`)
- Wallet managers → Wallet identity: uses identity (evidence: `data/wallet-manager/src/main/java/com/tangem/data/walletmanager/DefaultWalletManagersFacade.kt`)
- Gasless API config → Gasless transaction service: configures API
- Store review → Review interface: implements (evidence: `app/src/google/java/com/tangem/tap/GoogleReviewManager.kt`)
