# catappult/appcoins-wallet-android architecture

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

- Interactive diagram: https://gitdiagram.com/catappult/appcoins-wallet-android
- Repository: https://github.com/catappult/appcoins-wallet-android

## Overview

AppCoins Wallet is an Android wallet app. Its user-facing scope includes wallet/account management, transaction and in-app purchase flows, fiat currency conversion, backup, and notifications; the README identifies the project but does not document a detailed runtime workflow. Sampled code shows wallet services handling account creation and signing, while separate billing, conversion, and messaging components support other product stages. The graph preserves these documented-by-tree capabilities, but omits unsampled links where the source excerpts do not establish who invokes whom.

Main entry points: [`feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt`](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt) (Wallet account service), [`feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/domain/Wallet.kt`](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/domain/Wallet.kt) (Wallet models), [`feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt`](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt) (Fiat conversion), [`app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt`](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt) (Push messaging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_wallet["Wallet and identity"]
  node_wallet_app["Android wallet app<br/>[App.kt]"]
  node_wallet_service["Wallet account service"]
  node_keystore_account["Keystore accounts"]
  node_wallet_domain["Wallet models<br/>[Wallet.kt]"]
  node_wallet_service_api["Wallet service API<br/>[WalletService.kt]"]
  node_transaction_models["Transaction models"]
end

subgraph group_payments["Payments and billing"]
  node_purchase_service["In-app purchases"]
  node_billing_service["Billing service<br/>[BillingService.kt]"]
  node_bds_repository["BDS billing repository<br/>[BdsRepository.kt]"]
  node_remote_billing["Remote billing"]
end

subgraph group_currency["Currency and settings"]
  node_currency_conversion["Fiat conversion"]
  node_fiat_value["Fiat values<br/>[FiatValue.kt]"]
end

subgraph group_engagement["Notifications and engagement"]
  node_firebase_service["Push messaging"]
  node_firebase_registration["Token registration"]
  node_gamification_service["Gamification notifications"]
end

subgraph group_platform["Network and services"]
  node_ewt_auth["EWT authentication"]
  node_jwt_auth["JWT authentication"]
  node_jwt_repository["JWT repository<br/>[JwtRepository.kt]"]
end

node_user(("Wallet user"))
node_external_billing_apis{{"Billing APIs"}}
node_conversion_api{{"Conversion API"}}
node_firebase{{"Firebase messaging"}}

node_user -.->|"uses"| node_wallet_app
node_wallet_service -->|"creates"| node_wallet_domain
node_wallet_service -->|"registers token"| node_firebase_registration
node_keystore_account -->|"returns accounts"| node_wallet_domain
node_wallet_service -->|"implements"| node_wallet_service_api
node_purchase_service -->|"uses"| node_transaction_models
node_billing_service -->|"constructs"| node_bds_repository
node_bds_repository -->|"uses"| node_remote_billing
node_remote_billing -->|"requests billing data"| node_external_billing_apis
node_currency_conversion -->|"requests rates"| node_conversion_api
node_currency_conversion -->|"produces"| node_fiat_value
node_firebase_service -->|"registers token"| node_firebase_registration
node_firebase_service -->|"receives messages"| node_firebase
node_jwt_auth -->|"gets EWT"| node_ewt_auth
node_jwt_auth -->|"requests JWT"| node_jwt_repository
node_ewt_auth -->|"gets wallet address"| node_wallet_domain
node_gamification_service -->|"fetches transactions"| node_transaction_models

click node_wallet_app "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/App.kt"
click node_wallet_service "https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt"
click node_keystore_account "https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/Web3jKeystoreAccountService.java"
click node_wallet_domain "https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/domain/Wallet.kt"
click node_wallet_service_api "https://github.com/catappult/appcoins-wallet-android/blob/master/core/walletServices/src/main/java/com/appcoins/wallet/core/walletservices/WalletService.kt"
click node_transaction_models "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/entity/TransactionBuilder.java"
click node_purchase_service "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/repository/InAppPurchaseService.java"
click node_billing_service "https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/billing/src/main/java/com/appcoins/wallet/billing/BillingService.kt"
click node_bds_repository "https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/BdsRepository.kt"
click node_remote_billing "https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/RemoteRepository.kt"
click node_currency_conversion "https://github.com/catappult/appcoins-wallet-android/blob/master/feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt"
click node_fiat_value "https://github.com/catappult/appcoins-wallet-android/blob/master/feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/FiatValue.kt"
click node_firebase_service "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt"
click node_firebase_registration "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/firebase_messaging/domain/RegisterFirebaseTokenUseCaseImpl.kt"
click node_gamification_service "https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/transactions/PerkBonusAndGamificationService.kt"
click node_ewt_auth "https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/EwtAuthenticatorService.kt"
click node_jwt_auth "https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/JwtAuthenticatorService.kt"
click node_jwt_repository "https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/repository/JwtRepository.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_wallet_app,node_wallet_service,node_keystore_account,node_wallet_domain,node_wallet_service_api,node_transaction_models,node_user toneBlue
class node_purchase_service,node_billing_service,node_bds_repository,node_remote_billing toneAmber
class node_currency_conversion,node_fiat_value,node_external_billing_apis,node_conversion_api toneMint
class node_firebase_service,node_firebase_registration,node_gamification_service toneRose
class node_ewt_auth,node_jwt_auth,node_jwt_repository,node_firebase toneIndigo
```

## Components

### Wallet and identity

- [Android wallet app](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/App.kt): `app/src/main/java/com/asfoundation/wallet/App.kt`
- [Wallet account service](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt): `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt`
- [Keystore accounts](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/Web3jKeystoreAccountService.java): `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/Web3jKeystoreAccountService.java`
- [Wallet models](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/domain/Wallet.kt): `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/domain/Wallet.kt`
- [Wallet service API](https://github.com/catappult/appcoins-wallet-android/blob/master/core/walletServices/src/main/java/com/appcoins/wallet/core/walletservices/WalletService.kt): `core/walletServices/src/main/java/com/appcoins/wallet/core/walletservices/WalletService.kt`
- [Transaction models](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/entity/TransactionBuilder.java): `app/src/main/java/com/asfoundation/wallet/entity/TransactionBuilder.java`

### Payments and billing

- [In-app purchases](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/repository/InAppPurchaseService.java): `app/src/main/java/com/asfoundation/wallet/repository/InAppPurchaseService.java`
- [Billing service](https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/billing/src/main/java/com/appcoins/wallet/billing/BillingService.kt): `legacy/billing/src/main/java/com/appcoins/wallet/billing/BillingService.kt`
- [BDS billing repository](https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/BdsRepository.kt): `legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/BdsRepository.kt`
- [Remote billing](https://github.com/catappult/appcoins-wallet-android/blob/master/legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/RemoteRepository.kt): `legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/RemoteRepository.kt`

### Currency and settings

- [Fiat conversion](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt): `feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt`
- [Fiat values](https://github.com/catappult/appcoins-wallet-android/blob/master/feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/FiatValue.kt): `feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/FiatValue.kt`

### Notifications and engagement

- [Push messaging](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt): `app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt`
- [Token registration](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/firebase_messaging/domain/RegisterFirebaseTokenUseCaseImpl.kt): `app/src/main/java/com/asfoundation/wallet/firebase_messaging/domain/RegisterFirebaseTokenUseCaseImpl.kt`
- [Gamification notifications](https://github.com/catappult/appcoins-wallet-android/blob/master/app/src/main/java/com/asfoundation/wallet/transactions/PerkBonusAndGamificationService.kt): `app/src/main/java/com/asfoundation/wallet/transactions/PerkBonusAndGamificationService.kt`

### Network and services

- [EWT authentication](https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/EwtAuthenticatorService.kt): `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/EwtAuthenticatorService.kt`
- [JWT authentication](https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/JwtAuthenticatorService.kt): `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/JwtAuthenticatorService.kt`
- [JWT repository](https://github.com/catappult/appcoins-wallet-android/blob/master/core/network/base/src/main/java/com/appcoins/wallet/core/network/base/repository/JwtRepository.kt): `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/repository/JwtRepository.kt`

### Other components

- **Wallet user**
- **Billing APIs**
- **Conversion API**
- **Firebase messaging**

## Connections

- Wallet user → Android wallet app: uses (evidence: `README.md`)
- Wallet account service → Wallet models: creates (evidence: `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt`)
- Wallet account service → Token registration: registers token (evidence: `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt`)
- Keystore accounts → Wallet models: returns accounts (evidence: `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/Web3jKeystoreAccountService.java`)
- Wallet account service → Wallet service API: implements (evidence: `feature/wallet-info/data/src/main/java/com/appcoins/wallet/feature/walletInfo/data/wallet/AccountWalletService.kt`)
- In-app purchases → Transaction models: uses (evidence: `app/src/main/java/com/asfoundation/wallet/repository/InAppPurchaseService.java`)
- Billing service → BDS billing repository: constructs (evidence: `legacy/billing/src/main/java/com/appcoins/wallet/billing/BillingService.kt`)
- BDS billing repository → Remote billing: uses (evidence: `legacy/billing/src/main/java/com/appcoins/wallet/billing/BillingService.kt`)
- Remote billing → Billing APIs: requests billing data (evidence: `legacy/bdsbilling/src/main/java/com/appcoins/wallet/bdsbilling/repository/RemoteRepository.kt`)
- Fiat conversion → Conversion API: requests rates (evidence: `feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt`)
- Fiat conversion → Fiat values: produces (evidence: `feature/change-currency/data/src/main/java/com/appcoins/wallet/feature/changecurrency/data/currencies/LocalCurrencyConversionService.kt`)
- Push messaging → Token registration: registers token (evidence: `app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt`)
- Push messaging → Firebase messaging: receives messages (evidence: `app/src/main/java/com/asfoundation/wallet/firebase_messaging/WalletFirebaseMessagingService.kt`)
- JWT authentication → EWT authentication: gets EWT (evidence: `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/JwtAuthenticatorService.kt`)
- JWT authentication → JWT repository: requests JWT (evidence: `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/JwtAuthenticatorService.kt`)
- EWT authentication → Wallet models: gets wallet address (evidence: `core/network/base/src/main/java/com/appcoins/wallet/core/network/base/EwtAuthenticatorService.kt`)
- Gamification notifications → Transaction models: fetches transactions (evidence: `app/src/main/java/com/asfoundation/wallet/transactions/PerkBonusAndGamificationService.kt`)
