# caremiumos-dev/libxtcsecurity architecture

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

- Interactive diagram: https://gitdiagram.com/caremiumos-dev/libxtcsecurity
- Repository: https://github.com/caremiumos-dev/libxtcsecurity

## Overview

xtcSecurity is a compact Android native/JNI compatibility library. Its main workflow exposes string encryption/decryption and byte-array encryption/decryption to Java callers; a separate RSA-key entry point recovers the embedded default key through the string-decryption method. The library also exports standalone C codec helpers and logging. The graph focuses on runtime behavior; build, test, and documentation infrastructure are omitted. Relationships are limited to calls and shared definitions shown in the excerpts or README.

Main entry points: [`src/xses_request_helper.cpp`](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xses_request_helper.cpp) (String codec), [`include/xtc_security.h`](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/include/xtc_security.h) (Public API), [`src/xtc_security.cpp`](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xtc_security.cpp) (C helpers and globals), [`src/face_image_encrypt.cpp`](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/face_image_encrypt.cpp) (Face byte codec)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_java_caller(("Java caller"))
node_string_codec["String codec"]
node_rsa_key["RSA key recovery"]
node_face_codec["Face byte codec"]
node_c_helpers["C helpers and globals<br/>[xtc_security.cpp]"]
node_internal_defs["Codec definitions"]
node_public_api["Public API<br/>[xtc_security.h]"]

node_java_caller -->|"calls"| node_string_codec
node_java_caller -->|"requests key"| node_rsa_key
node_java_caller -->|"calls"| node_face_codec
node_java_caller -->|"uses API"| node_public_api
node_rsa_key -->|"invokes decrypt"| node_string_codec
node_string_codec -->|"XOR encodes"| node_c_helpers
node_string_codec -->|"XOR decodes"| node_c_helpers
node_string_codec -->|"uses maps"| node_internal_defs
node_face_codec -->|"uses key length"| node_internal_defs
node_c_helpers -->|"uses key layout"| node_internal_defs
node_public_api -->|"declares entry points"| node_string_codec
node_public_api -->|"declares entry points"| node_face_codec
node_public_api -->|"declares exports"| node_c_helpers

click node_string_codec "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xses_request_helper.cpp"
click node_rsa_key "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xses_request_helper.cpp"
click node_face_codec "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/face_image_encrypt.cpp"
click node_c_helpers "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xtc_security.cpp"
click node_internal_defs "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/security_internal.h"
click node_public_api "https://github.com/caremiumos-dev/libxtcsecurity/blob/main/include/xtc_security.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_java_caller toneIndigo
class node_string_codec,node_rsa_key,node_face_codec,node_c_helpers,node_internal_defs toneTeal
class node_public_api toneMint
```

## Components

### Other components

- **Java caller**
- [String codec](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xses_request_helper.cpp): `src/xses_request_helper.cpp`
- [RSA key recovery](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xses_request_helper.cpp): `src/xses_request_helper.cpp`
- [Face byte codec](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/face_image_encrypt.cpp): `src/face_image_encrypt.cpp`
- [C helpers and globals](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/xtc_security.cpp): `src/xtc_security.cpp`
- [Codec definitions](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/src/security_internal.h): `src/security_internal.h`
- [Public API](https://github.com/caremiumos-dev/libxtcsecurity/blob/main/include/xtc_security.h): `include/xtc_security.h`

## Connections

- Java caller → String codec: calls (evidence: `README.md`)
- Java caller → RSA key recovery: requests key (evidence: `README.md`)
- Java caller → Face byte codec: calls (evidence: `README.md`)
- Java caller → Public API: uses API (evidence: `include/xtc_security.h`)
- RSA key recovery → String codec: invokes decrypt (evidence: `src/xses_request_helper.cpp`)
- String codec → C helpers and globals: XOR encodes (evidence: `src/xses_request_helper.cpp`)
- String codec → C helpers and globals: XOR decodes (evidence: `src/xses_request_helper.cpp`)
- String codec → Codec definitions: uses maps (evidence: `src/xses_request_helper.cpp`)
- Face byte codec → Codec definitions: uses key length (evidence: `src/face_image_encrypt.cpp`)
- C helpers and globals → Codec definitions: uses key layout (evidence: `src/xtc_security.cpp`)
- Public API → String codec: declares entry points (evidence: `include/xtc_security.h`)
- Public API → Face byte codec: declares entry points (evidence: `include/xtc_security.h`)
- Public API → C helpers and globals: declares exports (evidence: `include/xtc_security.h`)
