# dot-asm/cryptogams architecture

> Architecture diagram of the GitHub repository dot-asm/cryptogams, 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/dot-asm/cryptogams
- Repository: https://github.com/dot-asm/cryptogams

## Overview

CRYPTOGAMS is a distribution of architecture-specific cryptographic assembly generators and implementations, rather than a complete end-user crypto application. Its documented workflow is an engineer invoking a script with an ABI/OS flavour and output filename to generate assembly; some x86_64 scripts also inspect CC to choose AVX code. The tree shows algorithm families including AES, ChaCha, Poly1305, SHA, Keccak, GHASH and X25519. Source excerpts are limited to an ARM architecture header and a SHA-1 helper, so internal generator-to-implementation calls are not asserted.

Main entry points: [`arm`](https://github.com/dot-asm/cryptogams/tree/master/arm) (ARM crypto generators), [`x86`](https://github.com/dot-asm/cryptogams/tree/master/x86) (x86 crypto generators), [`x86_64`](https://github.com/dot-asm/cryptogams/tree/master/x86_64) (x86-64 crypto generators), [`ppc`](https://github.com/dot-asm/cryptogams/tree/master/ppc) (PowerPC generators)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_arm["ARM generators"]
  node_armgen["ARM crypto generators"]
end

subgraph group_x86["x86 generators"]
  node_x86gen["x86 crypto generators"]
  node_x64gen["x86-64 crypto generators"]
end

subgraph group_other["Other ISA generators"]
  node_ppcgen["PowerPC generators"]
  node_mipsgen["MIPS generators"]
  node_riscvgen["RISC-V generators"]
  node_ia64gen["IA-64 implementations"]
  node_s390gen["s390x generators"]
  node_sparcgen["SPARC generator"]
  node_cilgen["CIL generator"]
end

subgraph group_wasm["WebAssembly"]
  node_wasmimpl["Poly1305 module"]
end

subgraph group_interface["C interface"]
  node_sha1api["SHA-1 context API<br/>[sha1.h]"]
end

node_engineer(("Engineer"))
node_output["Assembly output"]

node_engineer -->|"invokes script"| node_armgen
node_engineer -->|"invokes script"| node_x86gen
node_engineer -->|"invokes script"| node_x64gen
node_engineer -->|"invokes script"| node_ppcgen
node_engineer -->|"invokes script"| node_mipsgen
node_engineer -->|"invokes script"| node_riscvgen
node_engineer -->|"invokes script"| node_ia64gen
node_engineer -->|"invokes script"| node_s390gen
node_engineer -->|"invokes script"| node_sparcgen
node_engineer -->|"invokes script"| node_cilgen
node_armgen -->|"generates assembly"| node_output
node_x86gen -->|"generates assembly"| node_output
node_x64gen -->|"generates assembly"| node_output
node_ppcgen -->|"generates assembly"| node_output
node_mipsgen -->|"generates assembly"| node_output
node_riscvgen -->|"generates assembly"| node_output
node_sparcgen -->|"generates assembly"| node_output
node_cilgen -->|"generates assembly"| node_output

click node_armgen "https://github.com/dot-asm/cryptogams/tree/master/arm"
click node_x86gen "https://github.com/dot-asm/cryptogams/tree/master/x86"
click node_x64gen "https://github.com/dot-asm/cryptogams/tree/master/x86_64"
click node_ppcgen "https://github.com/dot-asm/cryptogams/tree/master/ppc"
click node_mipsgen "https://github.com/dot-asm/cryptogams/tree/master/mips"
click node_riscvgen "https://github.com/dot-asm/cryptogams/tree/master/riscv"
click node_ia64gen "https://github.com/dot-asm/cryptogams/tree/master/ia64"
click node_s390gen "https://github.com/dot-asm/cryptogams/tree/master/s390x"
click node_sparcgen "https://github.com/dot-asm/cryptogams/tree/master/sparcv9"
click node_cilgen "https://github.com/dot-asm/cryptogams/tree/master/cil"
click node_wasmimpl "https://github.com/dot-asm/cryptogams/blob/master/webasm/poly1305_global.wat"
click node_sha1api "https://github.com/dot-asm/cryptogams/blob/master/c/sha1.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_armgen toneBlue
class node_x86gen,node_x64gen toneAmber
class node_ppcgen,node_mipsgen,node_riscvgen,node_ia64gen,node_s390gen,node_sparcgen,node_cilgen toneMint
class node_wasmimpl toneRose
class node_sha1api,node_engineer,node_output toneIndigo
```

## Components

### ARM generators

- [ARM crypto generators](https://github.com/dot-asm/cryptogams/tree/master/arm): `arm`

### x86 generators

- [x86 crypto generators](https://github.com/dot-asm/cryptogams/tree/master/x86): `x86`
- [x86-64 crypto generators](https://github.com/dot-asm/cryptogams/tree/master/x86_64): `x86_64`

### Other ISA generators

- [PowerPC generators](https://github.com/dot-asm/cryptogams/tree/master/ppc): `ppc`
- [MIPS generators](https://github.com/dot-asm/cryptogams/tree/master/mips): `mips`
- [RISC-V generators](https://github.com/dot-asm/cryptogams/tree/master/riscv): `riscv`
- [IA-64 implementations](https://github.com/dot-asm/cryptogams/tree/master/ia64): `ia64`
- [s390x generators](https://github.com/dot-asm/cryptogams/tree/master/s390x): `s390x`
- [SPARC generator](https://github.com/dot-asm/cryptogams/tree/master/sparcv9): `sparcv9`
- [CIL generator](https://github.com/dot-asm/cryptogams/tree/master/cil): `cil`

### WebAssembly

- [Poly1305 module](https://github.com/dot-asm/cryptogams/blob/master/webasm/poly1305_global.wat): `webasm/poly1305_global.wat`

### C interface

- [SHA-1 context API](https://github.com/dot-asm/cryptogams/blob/master/c/sha1.h): `c/sha1.h`

### Other components

- **Engineer**
- **Assembly output**

## Connections

- Engineer → ARM crypto generators: invokes script (evidence: `README.md`)
- Engineer → x86 crypto generators: invokes script (evidence: `README.md`)
- Engineer → x86-64 crypto generators: invokes script (evidence: `README.md`)
- Engineer → PowerPC generators: invokes script (evidence: `README.md`)
- Engineer → MIPS generators: invokes script (evidence: `README.md`)
- Engineer → RISC-V generators: invokes script (evidence: `README.md`)
- Engineer → IA-64 implementations: invokes script (evidence: `README.md`)
- Engineer → s390x generators: invokes script (evidence: `README.md`)
- Engineer → SPARC generator: invokes script (evidence: `README.md`)
- Engineer → CIL generator: invokes script (evidence: `README.md`)
- ARM crypto generators → Assembly output: generates assembly (evidence: `README.md`)
- x86 crypto generators → Assembly output: generates assembly (evidence: `README.md`)
- x86-64 crypto generators → Assembly output: generates assembly (evidence: `README.md`)
- PowerPC generators → Assembly output: generates assembly (evidence: `README.md`)
- MIPS generators → Assembly output: generates assembly (evidence: `README.md`)
- RISC-V generators → Assembly output: generates assembly (evidence: `README.md`)
- SPARC generator → Assembly output: generates assembly (evidence: `README.md`)
- CIL generator → Assembly output: generates assembly (evidence: `README.md`)
