# engrstate/aether-remix architecture

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

- Interactive diagram: https://gitdiagram.com/engrstate/aether-remix
- Repository: https://github.com/engrstate/aether-remix

## Overview

AetherFlow is an Android multi-chain wallet and automation app. Users configure wallets and RPC providers, define guarded transfer or sweep rules, and monitor activity through its dashboard and activity views. The documented architecture separates Compose UI/MVVM, persistence and security, chain-specific adapters, and automation. The tree identifies the relevant modules, but no application source excerpts were provided; therefore implementation-level calls are not asserted, and documented capabilities are represented with evidence-limited links.

Main entry points: [`app/src/main/java/com/example/ui/viewmodel/AetherViewModel.kt`](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/viewmodel/AetherViewModel.kt) (App state), [`app/src/main/java/com/example/ui/screens/providers/ProvidersScreen.kt`](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/providers/ProvidersScreen.kt) (Provider controls), [`app/src/main/java/com/example/data/repository/AetherRepository.kt`](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/repository/AetherRepository.kt) (Aether repository), [`app/src/main/java/com/example/domain/automation/AutomationEngine.kt`](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/domain/automation/AutomationEngine.kt) (Rule automation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_main["App entry<br/>[MainActivity.kt]"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
  node_wallet_ui["Wallet management"]
  node_activity_ui["Activity monitor<br/>[ActivityScreen.kt]"]
  node_provider_ui["Provider controls<br/>[ProvidersScreen.kt]"]
  node_security_ui["Security controls<br/>[SecurityScreen.kt]"]
  node_settings_ui["Settings and demo"]
  node_emergency["Emergency stop"]
  node_viewmodel["App state<br/>[AetherViewModel.kt]"]
end

subgraph group_wallet_data["Wallet data and security"]
  node_repository["Aether repository"]
  node_wallet_models["Wallet and chain models"]
  node_room[("Local database<br/>[AppDatabase.kt]")]
  node_keystore["KeyStore vault<br/>[KeystoreManager.kt]"]
end

subgraph group_chain_runtime["Chain and automation"]
  node_automation["Rule automation"]
  node_adapter_registry["Adapter registry<br/>[AdapterRegistry.kt]"]
  node_chain_adapters["Chain adapters"]
end

subgraph group_infrastructure["Provider infrastructure"]
  node_provider_data["RPC provider data<br/>[ProviderDao.kt]"]
end

node_user(("Wallet operator"))
node_rpc_nodes{{"RPC node services"}}

node_user -.->|"opens app"| node_main
node_main -.->|"shows dashboard"| node_dashboard
node_user -.->|"configures wallets"| node_wallet_ui
node_user -->|"configures nodes"| node_provider_ui
node_user -->|"sets mode"| node_settings_ui
node_user -->|"sets policies"| node_security_ui
node_user -->|"stops automation"| node_emergency
node_user -->|"inspects activity"| node_activity_ui
node_dashboard -.->|"observes state"| node_viewmodel
node_wallet_ui -.->|"updates state"| node_viewmodel
node_activity_ui -.->|"observes state"| node_viewmodel
node_provider_ui -.->|"updates state"| node_viewmodel
node_viewmodel -.->|"delegates data"| node_repository
node_repository -.->|"persists data"| node_room
node_repository -.->|"uses models"| node_wallet_models
node_security_ui -.->|"secures credentials"| node_keystore
node_automation -.->|"selects adapter"| node_adapter_registry
node_adapter_registry -->|"dispatches chain work"| node_chain_adapters
node_provider_ui -.->|"manages endpoints"| node_provider_data
node_provider_data -->|"configures connections"| node_rpc_nodes
node_automation -.->|"uses chain endpoints"| node_rpc_nodes

click node_main "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/MainActivity.kt"
click node_dashboard "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/dashboard/DashboardScreen.kt"
click node_wallet_ui "https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/ui/screens/wallets"
click node_activity_ui "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/activity/ActivityScreen.kt"
click node_provider_ui "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/providers/ProvidersScreen.kt"
click node_security_ui "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/security/SecurityScreen.kt"
click node_settings_ui "https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/ui/screens/settings"
click node_emergency "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/components/EmergencyStopDialog.kt"
click node_viewmodel "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/viewmodel/AetherViewModel.kt"
click node_repository "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/repository/AetherRepository.kt"
click node_wallet_models "https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/data/model"
click node_room "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/local/AppDatabase.kt"
click node_keystore "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/security/KeystoreManager.kt"
click node_automation "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/domain/automation/AutomationEngine.kt"
click node_adapter_registry "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/domain/adapters/AdapterRegistry.kt"
click node_chain_adapters "https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/domain/adapters"
click node_provider_data "https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/local/ProviderDao.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_main,node_dashboard,node_wallet_ui,node_activity_ui,node_provider_ui,node_security_ui,node_settings_ui,node_emergency,node_viewmodel toneBlue
class node_repository,node_wallet_models,node_room,node_keystore toneAmber
class node_automation,node_adapter_registry,node_chain_adapters toneMint
class node_provider_data toneRose
class node_user,node_rpc_nodes toneIndigo
```

## Components

### User experience

- [App entry](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/MainActivity.kt): `app/src/main/java/com/example/MainActivity.kt`
- [Dashboard](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/dashboard/DashboardScreen.kt): `app/src/main/java/com/example/ui/screens/dashboard/DashboardScreen.kt`
- [Wallet management](https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/ui/screens/wallets): `app/src/main/java/com/example/ui/screens/wallets`
- [Activity monitor](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/activity/ActivityScreen.kt): `app/src/main/java/com/example/ui/screens/activity/ActivityScreen.kt`
- [Provider controls](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/providers/ProvidersScreen.kt): `app/src/main/java/com/example/ui/screens/providers/ProvidersScreen.kt`
- [Security controls](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/screens/security/SecurityScreen.kt): `app/src/main/java/com/example/ui/screens/security/SecurityScreen.kt`
- [Settings and demo](https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/ui/screens/settings): `app/src/main/java/com/example/ui/screens/settings`
- [Emergency stop](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/components/EmergencyStopDialog.kt): `app/src/main/java/com/example/ui/components/EmergencyStopDialog.kt`
- [App state](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/ui/viewmodel/AetherViewModel.kt): `app/src/main/java/com/example/ui/viewmodel/AetherViewModel.kt`

### Wallet data and security

- [Aether repository](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/repository/AetherRepository.kt): `app/src/main/java/com/example/data/repository/AetherRepository.kt`
- [Wallet and chain models](https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/data/model): `app/src/main/java/com/example/data/model`
- [Local database](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/local/AppDatabase.kt): `app/src/main/java/com/example/data/local/AppDatabase.kt`
- [KeyStore vault](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/security/KeystoreManager.kt): `app/src/main/java/com/example/data/security/KeystoreManager.kt`

### Chain and automation

- [Rule automation](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/domain/automation/AutomationEngine.kt): `app/src/main/java/com/example/domain/automation/AutomationEngine.kt`
- [Adapter registry](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/domain/adapters/AdapterRegistry.kt): `app/src/main/java/com/example/domain/adapters/AdapterRegistry.kt`
- [Chain adapters](https://github.com/engrstate/aether-remix/tree/main/app/src/main/java/com/example/domain/adapters): `app/src/main/java/com/example/domain/adapters`

### Provider infrastructure

- [RPC provider data](https://github.com/engrstate/aether-remix/blob/main/app/src/main/java/com/example/data/local/ProviderDao.kt): `app/src/main/java/com/example/data/local/ProviderDao.kt`

### Other components

- **Wallet operator**
- **RPC node services**

## Connections

- Wallet operator → App entry: opens app
- App entry → Dashboard: shows dashboard
- Wallet operator → Wallet management: configures wallets
- Wallet operator → Provider controls: configures nodes (evidence: `README.md`)
- Wallet operator → Settings and demo: sets mode (evidence: `README.md`)
- Wallet operator → Security controls: sets policies (evidence: `README.md`)
- Wallet operator → Emergency stop: stops automation (evidence: `README.md`)
- Wallet operator → Activity monitor: inspects activity (evidence: `README.md`)
- Dashboard → App state: observes state
- Wallet management → App state: updates state
- Activity monitor → App state: observes state
- Provider controls → App state: updates state
- App state → Aether repository: delegates data
- Aether repository → Local database: persists data
- Aether repository → Wallet and chain models: uses models
- Security controls → KeyStore vault: secures credentials
- Rule automation → Adapter registry: selects adapter
- Adapter registry → Chain adapters: dispatches chain work (evidence: `README.md`)
- Provider controls → RPC provider data: manages endpoints
- RPC provider data → RPC node services: configures connections (evidence: `README.md`)
- Rule automation → RPC node services: uses chain endpoints
