# ejaraapp/trustdart architecture

> Architecture diagram of the GitHub repository ejaraapp/trustdart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ejaraapp/trustdart
- Repository: https://github.com/ejaraapp/trustdart

## Overview

##### Project type and purpose
- This is a Flutter “plugin” package (trustdart) that provides a Dart API for local wallet operations (key management, address derivation, transaction signing) by bridging into the TrustWallet Core native library via method channels. It does not provide on-chain querying or broadcast functionality.

##### File structure
- Top-level directories:
- android/ – Kotlin plugin code, Gradle config
- ios/ – Swift/Objective-C plugin code, CocoaPods spec
- lib/ – Dart side of the plugin (trustdart.dart)
- example/ – A sample Flutter app showing usage on Android/iOS
- .github/ – CI workflows for code scanning
- Plugin entrypoint (TrustdartPlugin.kt, SwiftTrustdartPlugin.swift)
- WalletHandler, Coin classes per blockchain
- Interfaces (protocols) and utility classes

##### README for additional insights
- Confirms focus on local operations only
- Uses Flutter method channels to call into the native layer
- Roadmap mentions adding more coins and Bitcoin signing

a. Main components
- Consumer: Example Flutter app (UI layer)
- Dart plugin API: lib/trustdart.dart
- Platform channel (MethodChannel)
- Android native plugin module
- iOS native plugin module
- Underlying TrustWallet Core (C++/prebuilt library)
- CI/CD: GitHub Actions, Sonar scan (optional external)
b. Relationships and interactions
1. App UI calls Dart API
2. Dart API invokes MethodChannel
3. MethodChannel routes call to native plugin on each platform
4. Native plugin (WalletHandler → Coin modules → Core) executes cryptographic operations
5. Native returns result via MethodChannel back to Dart
c. Architectural patterns/design principles
- Platform Channels for cross-language boundary
- Plugin modularization by coin (extensibility)
- Clear separation of concerns: UI vs. API vs. native implementation
d. Key technologies/frameworks
- Flutter & Dart
- Android: Kotlin, Gradle, TrustWallet Core .aar
- iOS: Swift/ObjC, CocoaPods, TrustWallet Core .framework
- GitHub Actions / Sonar

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Consumer Layer
    ExampleApp["Example Flutter App UI"]:::flutter
    click ExampleApp "https://github.com/ejaraapp/trustdart/blob/main/example/lib/main.dart"

    %% Dart Layer
    DartAPI["Dart Plugin API\n(trustdart.dart)"]:::flutter
    click DartAPI "https://github.com/ejaraapp/trustdart/blob/main/lib/trustdart.dart"

    MethodChannel["Platform Channel\n(MethodChannel)"]:::flutter
    click MethodChannel "https://github.com/ejaraapp/trustdart/blob/main/lib/trustdart.dart"

    %% Native Layers
    subgraph "Android Native" 
        direction TB
        AndroidPlugin["TrustdartPlugin.kt"]:::android
        click AndroidPlugin "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/TrustdartPlugin.kt"

        WalletHandlerA["WalletHandler.kt"]:::android
        click WalletHandlerA "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/WalletHandler.kt"

        CoinInterfaceA["CoinInterface.kt"]:::android
        click CoinInterfaceA "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/interfaces/CoinInterface.kt"

        subgraph "Utils"
            direction TB
            ExtA["Extension.kt"]:::android
            click ExtA "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/utils/Extension.kt"
            ErrA["WalletError.kt"]:::android
            click ErrA "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/utils/WalletError.kt"
        end

        subgraph "Coins"
            direction TB
            ADA_A["ADA.kt"]:::android
            click ADA_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/ADA.kt"
            BNB_A["BNB.kt"]:::android
            click BNB_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/BNB.kt"
            BTC_A["BTC.kt"]:::android
            click BTC_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/BTC.kt"
            DOGE_A["DOGE.kt"]:::android
            click DOGE_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/DOGE.kt"
            ETH_A["ETH.kt"]:::android
            click ETH_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/ETH.kt"
            NEAR_A["NEAR.kt"]:::android
            click NEAR_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/NEAR.kt"
            SOL_A["SOL.kt"]:::android
            click SOL_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/SOL.kt"
            TRX_A["TRX.kt"]:::android
            click TRX_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/TRX.kt"
            XLM_A["XLM.kt"]:::android
            click XLM_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/XLM.kt"
            XRP_A["XRP.kt"]:::android
            click XRP_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/XRP.kt"
            XTZ_A["XTZ.kt"]:::android
            click XTZ_A "https://github.com/ejaraapp/trustdart/blob/main/android/src/main/kotlin/africa/ejara/trustdart/coins/XTZ.kt"
        end

    end

    subgraph "iOS Native"
        direction TB
        iOSPlugin["SwiftTrustdartPlugin.swift"]:::ios
        click iOSPlugin "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/SwiftTrustdartPlugin.swift"

        ObjCHeader["TrustdartPlugin.h"]:::ios
        click ObjCHeader "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/TrustdartPlugin.h"
        ObjCImpl["TrustdartPlugin.m"]:::ios
        click ObjCImpl "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/TrustdartPlugin.m"

        WalletHandlerI["WalletHandler.swift"]:::ios
        click WalletHandlerI "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/WalletHandler.swift"

        CoinProtocolI["CoinProtocol.swift"]:::ios
        click CoinProtocolI "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/protocols/CoinProtocol.swift"

        subgraph "Utils"
            direction TB
            UtilsI["Utils.swift"]:::ios
            click UtilsI "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/utils/Utils.swift"
            ErrI["WalletError.swift"]:::ios
            click ErrI "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/utils/WalletError.swift"
        end

        subgraph "Coins"
            direction TB
            ADA_I["ADA.swift"]:::ios
            click ADA_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/ADA.swift"
            BNB_I["BNB.swift"]:::ios
            click BNB_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/BNB.swift"
            BTC_I["BTC.swift"]:::ios
            click BTC_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/BTC.swift"
            DOGE_I["DOGE.swift"]:::ios
            click DOGE_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/DOGE.swift"
            ETH_I["ETH.swift"]:::ios
            click ETH_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/ETH.swift"
            NEAR_I["NEAR.swift"]:::ios
            click NEAR_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/NEAR.swift"
            SOL_I["SOL.swift"]:::ios
            click SOL_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/SOL.swift"
            TRX_I["TRX.swift"]:::ios
            click TRX_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/TRX.swift"
            XLM_I["XLM.swift"]:::ios
            click XLM_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/XLM.swift"
            XRP_I["XRP.swift"]:::ios
            click XRP_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/XRP.swift"
            XTZ_I["XTZ.swift"]:::ios
            click XTZ_I "https://github.com/ejaraapp/trustdart/blob/main/ios/Classes/coins/XTZ.swift"
        end

    end

    %% External Libraries
    TrustCore["TrustWallet Core\n(C++ Prebuilt)"]:::external
    CI["CI/CD\n(.github & Sonar)"]:::external
    click CI "https://github.com/ejaraapp/trustdart/blob/main/.github/workflows/codescan.yml"

    %% Connections
    ExampleApp -->|"calls API"| DartAPI
    DartAPI -->|"invokes"| MethodChannel
    MethodChannel -->|"routes to Android"| AndroidPlugin
    MethodChannel -->|"routes to iOS"| iOSPlugin

    AndroidPlugin --> WalletHandlerA
    WalletHandlerA --> CoinInterfaceA
    CoinInterfaceA -->|"implements"| ADA_A
    CoinInterfaceA --> BNB_A
    CoinInterfaceA --> BTC_A
    CoinInterfaceA --> DOGE_A
    CoinInterfaceA --> ETH_A
    CoinInterfaceA --> NEAR_A
    CoinInterfaceA --> SOL_A
    CoinInterfaceA --> TRX_A
    CoinInterfaceA --> XLM_A
    CoinInterfaceA --> XRP_A
    CoinInterfaceA --> XTZ_A
    WalletHandlerA --> ExtA
    WalletHandlerA --> ErrA
    ADA_A --> TrustCore
    BNB_A --> TrustCore
    BTC_A --> TrustCore
    DOGE_A --> TrustCore
    ETH_A --> TrustCore
    NEAR_A --> TrustCore
    SOL_A --> TrustCore
    TRX_A --> TrustCore
    XLM_A --> TrustCore
    XRP_A --> TrustCore
    XTZ_A --> TrustCore
    TrustCore -->|"returns result"| AndroidPlugin

    iOSPlugin --> WalletHandlerI
    WalletHandlerI --> CoinProtocolI
    CoinProtocolI --> ADA_I
    CoinProtocolI --> BNB_I
    CoinProtocolI --> BTC_I
    CoinProtocolI --> DOGE_I
    CoinProtocolI --> ETH_I
    CoinProtocolI --> NEAR_I
    CoinProtocolI --> SOL_I
    CoinProtocolI --> TRX_I
    CoinProtocolI --> XLM_I
    CoinProtocolI --> XRP_I
    CoinProtocolI --> XTZ_I
    WalletHandlerI --> UtilsI
    WalletHandlerI --> ErrI
    ADA_I --> TrustCore
    BNB_I --> TrustCore
    BTC_I --> TrustCore
    DOGE_I --> TrustCore
    ETH_I --> TrustCore
    NEAR_I --> TrustCore
    SOL_I --> TrustCore
    TRX_I --> TrustCore
    XLM_I --> TrustCore
    XRP_I --> TrustCore
    XTZ_I --> TrustCore
    TrustCore -->|"returns result"| iOSPlugin

    CI --- DartAPI

    %% Styles
    classDef flutter fill:#AED6F1,stroke:#21618C,color:#1B2631
    classDef android fill:#ABEBC6,stroke:#196F3D,color:#1B2631
    classDef ios fill:#F9E79F,stroke:#9A7D0A,color:#1B2631
    classDef external fill:#E5E8E8,stroke:#566573,color:#1B2631
```
