# cavernastudio/sdk_verna architecture

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

- Interactive diagram: https://gitdiagram.com/cavernastudio/sdk_verna
- Repository: https://github.com/cavernastudio/sdk_verna

## Overview

MEGA SDK is a client-access engine for encrypted cloud storage, exposed through a public API and language bindings. The principal workflow is an application invoking SDK operations, which manage account and cloud-node state and perform encrypted transfers; optional folder synchronization adds local-to-cloud reconciliation. The graph also preserves documented platform bindings and the graphics-worker capability. Source excerpts do not show the full request, encryption, or sync call paths, so those links are omitted rather than inferred.

Main entry points: [`include/megaapi.h`](https://github.com/cavernastudio/sdk_verna/blob/master/include/megaapi.h) (Public API), [`include/mega/megaclient.h`](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/megaclient.h) (MEGA client), [`src/nodemanager.cpp`](https://github.com/cavernastudio/sdk_verna/blob/master/src/nodemanager.cpp) (Node manager), [`bindings/qt/QTMegaApiManager.cpp`](https://github.com/cavernastudio/sdk_verna/blob/master/bindings/qt/QTMegaApiManager.cpp) (Qt API manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["SDK interfaces"]
  node_public_api["Public API<br/>[megaapi.h]"]
  node_cpp_core["Low-level SDK<br/>[mega.h]"]
  node_ios["iOS bindings<br/>[MEGASdk.h]"]
  node_java["Java bindings<br/>[MegaApiJava.java]"]
  node_qt["Qt API manager"]
end

subgraph group_engine["Cloud client engine"]
  node_client["MEGA client<br/>[megaclient.h]"]
  node_account["Account state<br/>[account.h]"]
  node_node_manager["Node manager<br/>[nodemanager.cpp]"]
  node_node_model["Cloud nodes<br/>[node.h]"]
  node_database[("SDK database<br/>[db.h]")]
  node_network["HTTP and commands<br/>[http.h]"]
end

subgraph group_data["Files and sync"]
  node_transfers["File transfers<br/>[transfer.h]"]
  node_ws_upload["WebSocket uploads"]
  node_sync["Folder sync<br/>[sync.h]"]
  node_file_service["File service"]
end

subgraph group_integrations["Platform services"]
  node_fuse["FUSE service"]
  node_gfx_worker["Graphics worker<br/>[main.cpp]"]
  node_gfx_processor["Request processor<br/>[processor.h]"]
end

node_application(("Client application"))

node_application -->|"calls"| node_public_api
node_public_api -->|"exposes"| node_cpp_core
node_client -->|"uses"| node_account
node_client -->|"uses"| node_node_manager
node_node_manager -->|"manages"| node_node_model
node_qt -->|"creates"| node_public_api
node_gfx_worker -->|"constructs"| node_gfx_processor
node_sync -.->|"uploads"| node_transfers
node_fuse -.->|"uses"| node_file_service

click node_public_api "https://github.com/cavernastudio/sdk_verna/blob/master/include/megaapi.h"
click node_cpp_core "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega.h"
click node_ios "https://github.com/cavernastudio/sdk_verna/blob/master/bindings/ios/include/MEGASdk.h"
click node_java "https://github.com/cavernastudio/sdk_verna/blob/master/bindings/java/nz/mega/sdk/MegaApiJava.java"
click node_qt "https://github.com/cavernastudio/sdk_verna/blob/master/bindings/qt/QTMegaApiManager.cpp"
click node_client "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/megaclient.h"
click node_account "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/account.h"
click node_node_manager "https://github.com/cavernastudio/sdk_verna/blob/master/src/nodemanager.cpp"
click node_node_model "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/node.h"
click node_database "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/db.h"
click node_network "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/http.h"
click node_transfers "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/transfer.h"
click node_ws_upload "https://github.com/cavernastudio/sdk_verna/blob/master/src/transfer/ws/wsupload_engine.cpp"
click node_sync "https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/sync.h"
click node_file_service "https://github.com/cavernastudio/sdk_verna/blob/master/src/file_service/file_service_context.cpp"
click node_fuse "https://github.com/cavernastudio/sdk_verna/blob/master/src/fuse/supported/platform/service_context.cpp"
click node_gfx_worker "https://github.com/cavernastudio/sdk_verna/blob/master/tools/gfxworker/src/main.cpp"
click node_gfx_processor "https://github.com/cavernastudio/sdk_verna/blob/master/tools/gfxworker/src/processor.h"

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_public_api,node_cpp_core,node_ios,node_java,node_qt,node_application toneBlue
class node_client,node_account,node_node_manager,node_node_model,node_database,node_network toneAmber
class node_transfers,node_ws_upload,node_sync,node_file_service toneMint
class node_fuse,node_gfx_worker,node_gfx_processor toneRose
```

## Components

### SDK interfaces

- [Public API](https://github.com/cavernastudio/sdk_verna/blob/master/include/megaapi.h): `include/megaapi.h`
- [Low-level SDK](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega.h): `include/mega.h`
- [iOS bindings](https://github.com/cavernastudio/sdk_verna/blob/master/bindings/ios/include/MEGASdk.h): `bindings/ios/include/MEGASdk.h`
- [Java bindings](https://github.com/cavernastudio/sdk_verna/blob/master/bindings/java/nz/mega/sdk/MegaApiJava.java): `bindings/java/nz/mega/sdk/MegaApiJava.java`
- [Qt API manager](https://github.com/cavernastudio/sdk_verna/blob/master/bindings/qt/QTMegaApiManager.cpp): `bindings/qt/QTMegaApiManager.cpp`

### Cloud client engine

- [MEGA client](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/megaclient.h): `include/mega/megaclient.h`
- [Account state](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/account.h): `include/mega/account.h`
- [Node manager](https://github.com/cavernastudio/sdk_verna/blob/master/src/nodemanager.cpp): `src/nodemanager.cpp`
- [Cloud nodes](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/node.h): `include/mega/node.h`
- [SDK database](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/db.h): `include/mega/db.h`
- [HTTP and commands](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/http.h): `include/mega/http.h`

### Files and sync

- [File transfers](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/transfer.h): `include/mega/transfer.h`
- [WebSocket uploads](https://github.com/cavernastudio/sdk_verna/blob/master/src/transfer/ws/wsupload_engine.cpp): `src/transfer/ws/wsupload_engine.cpp`
- [Folder sync](https://github.com/cavernastudio/sdk_verna/blob/master/include/mega/sync.h): `include/mega/sync.h`
- [File service](https://github.com/cavernastudio/sdk_verna/blob/master/src/file_service/file_service_context.cpp): `src/file_service/file_service_context.cpp`

### Platform services

- [FUSE service](https://github.com/cavernastudio/sdk_verna/blob/master/src/fuse/supported/platform/service_context.cpp): `src/fuse/supported/platform/service_context.cpp`
- [Graphics worker](https://github.com/cavernastudio/sdk_verna/blob/master/tools/gfxworker/src/main.cpp): `tools/gfxworker/src/main.cpp`
- [Request processor](https://github.com/cavernastudio/sdk_verna/blob/master/tools/gfxworker/src/processor.h): `tools/gfxworker/src/processor.h`

### Other components

- **Client application**

## Connections

- Client application → Public API: calls
- Public API → Low-level SDK: exposes
- MEGA client → Account state: uses (evidence: `include/mega/megaclient.h`)
- MEGA client → Node manager: uses (evidence: `include/mega/megaclient.h`)
- Node manager → Cloud nodes: manages
- Qt API manager → Public API: creates (evidence: `bindings/qt/QTMegaApiManager.cpp`)
- Graphics worker → Request processor: constructs (evidence: `tools/gfxworker/src/main.cpp`)
- Folder sync → File transfers: uploads
- FUSE service → File service: uses
