# shrec/ultrafastsecp256k1 architecture

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

- Interactive diagram: https://gitdiagram.com/shrec/ultrafastsecp256k1
- Repository: https://github.com/shrec/ultrafastsecp256k1

## Overview

UltrafastSecp256k1 is a multi-backend secp256k1 cryptography engine, exposed through language bindings and compatibility APIs. The principal workflow is an application request entering a binding or shim, reaching the CPU cryptographic operations, and returning a result; GPU verification is an optional backend path. The repository also presents reproducible audit evidence as a product capability. Several subsystem links are documented in the README, but many implementation files were not sampled, so uncertain calls are omitted rather than inferred.

Main entry points: [`bindings/c_api/ultrafast_secp256k1.cpp`](https://github.com/shrec/ultrafastsecp256k1/blob/main/bindings/c_api/ultrafast_secp256k1.cpp) (C API), [`src/cpu/include/secp256k1/point.hpp`](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/point.hpp) (Point arithmetic), [`src/cpu/include/secp256k1/ecdsa.hpp`](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ecdsa.hpp) (ECDSA), [`compat/libsecp256k1_shim/src/shim_context.cpp`](https://github.com/shrec/ultrafastsecp256k1/blob/main/compat/libsecp256k1_shim/src/shim_context.cpp) (secp256k1 shim)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Integration surfaces"]
  node_c_api["C API"]
  node_language_bindings["Language bindings"]
  node_secp_shim["secp256k1 shim<br/>[shim_context.cpp]"]
  node_bitcoin_bridge["libbitcoin bridge"]
end

subgraph group_crypto["CPU cryptography"]
  node_field_ops["Field arithmetic<br/>[field.hpp]"]
  node_scalar_ops["Scalar arithmetic<br/>[scalar.hpp]"]
  node_point_ops["Point arithmetic<br/>[point.hpp]"]
  node_ct_point["Constant-time points<br/>[point.hpp]"]
  node_ct_sign["Constant-time signing<br/>[sign.hpp]"]
  node_ecdsa["ECDSA<br/>[ecdsa.hpp]"]
  node_schnorr["Schnorr<br/>[schnorr.hpp]"]
  node_batch_verify["Batch verification<br/>[batch_verify.hpp]"]
  node_recovery["Signature recovery<br/>[recovery.hpp]"]
  node_sha256["SHA-256<br/>[sha256.hpp]"]
  node_taproot["Taproot<br/>[taproot.hpp]"]
  node_secure_erase["Secure erasure<br/>[secure_erase.hpp]"]
end

subgraph group_acceleration["GPU acceleration"]
  node_gpu_hook["GPU verify dispatch"]
  node_gpu_backend["GPU backends<br/>[gpu_backend.hpp]"]
end

subgraph group_assurance["Audit evidence"]
  node_audit_runner["Audit runner"]
  node_audit_evidence["Audit evidence"]
end

node_application(("Application"))

node_application -->|"calls"| node_c_api
node_application -->|"integrates through"| node_language_bindings
node_application -.->|"may use"| node_secp_shim
node_application -.->|"may integrate through"| node_bitcoin_bridge
node_c_api -->|"uses"| node_scalar_ops
node_c_api -->|"uses"| node_point_ops
node_c_api -->|"uses"| node_field_ops
node_c_api -->|"uses"| node_ecdsa
node_c_api -->|"uses"| node_schnorr
node_c_api -->|"uses"| node_recovery
node_c_api -->|"uses"| node_sha256
node_c_api -->|"uses"| node_taproot
node_point_ops -->|"uses"| node_field_ops
node_point_ops -->|"uses"| node_scalar_ops
node_ecdsa -->|"uses"| node_scalar_ops
node_ecdsa -->|"uses"| node_point_ops
node_schnorr -->|"uses"| node_scalar_ops
node_schnorr -->|"uses"| node_point_ops
node_batch_verify -->|"uses"| node_ecdsa
node_batch_verify -->|"uses"| node_schnorr
node_recovery -->|"uses"| node_ecdsa
node_recovery -->|"uses"| node_point_ops
node_taproot -->|"uses"| node_point_ops
node_ct_sign -->|"uses"| node_ct_point
node_ct_sign -->|"provides signing"| node_ecdsa
node_ct_point -->|"uses"| node_point_ops
node_gpu_hook -->|"registers hook for"| node_batch_verify
node_gpu_hook -->|"dispatches to"| node_gpu_backend
node_gpu_hook -->|"falls back to CPU"| node_batch_verify
node_secp_shim -->|"uses"| node_scalar_ops
node_secp_shim -->|"uses"| node_point_ops
node_secp_shim -->|"uses"| node_ct_point
node_secp_shim -->|"uses"| node_ct_sign
node_audit_runner -.->|"produces"| node_audit_evidence

click node_c_api "https://github.com/shrec/ultrafastsecp256k1/blob/main/bindings/c_api/ultrafast_secp256k1.cpp"
click node_language_bindings "https://github.com/shrec/ultrafastsecp256k1/tree/main/bindings"
click node_secp_shim "https://github.com/shrec/ultrafastsecp256k1/blob/main/compat/libsecp256k1_shim/src/shim_context.cpp"
click node_bitcoin_bridge "https://github.com/shrec/ultrafastsecp256k1/blob/main/compat/libbitcoin_bridge/src/ufsecp_libbitcoin.cpp"
click node_field_ops "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/field.hpp"
click node_scalar_ops "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/scalar.hpp"
click node_point_ops "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/point.hpp"
click node_ct_point "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ct/point.hpp"
click node_ct_sign "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ct/sign.hpp"
click node_ecdsa "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ecdsa.hpp"
click node_schnorr "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/schnorr.hpp"
click node_batch_verify "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/batch_verify.hpp"
click node_recovery "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/recovery.hpp"
click node_sha256 "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/sha256.hpp"
click node_taproot "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/taproot.hpp"
click node_secure_erase "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/detail/secure_erase.hpp"
click node_gpu_hook "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/gpu/src/gpu_engine_hook.cpp"
click node_gpu_backend "https://github.com/shrec/ultrafastsecp256k1/blob/main/src/gpu/include/gpu_backend.hpp"
click node_audit_runner "https://github.com/shrec/ultrafastsecp256k1/blob/main/audit/unified_audit_runner.cpp"
click node_audit_evidence "https://github.com/shrec/ultrafastsecp256k1/tree/main/audit"

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_c_api,node_language_bindings,node_secp_shim,node_bitcoin_bridge toneBlue
class node_field_ops,node_scalar_ops,node_point_ops,node_ct_point,node_ct_sign,node_ecdsa,node_schnorr,node_batch_verify,node_recovery,node_sha256,node_taproot,node_secure_erase toneAmber
class node_gpu_hook,node_gpu_backend toneMint
class node_audit_runner,node_audit_evidence toneRose
class node_application toneIndigo
```

## Components

### Integration surfaces

- [C API](https://github.com/shrec/ultrafastsecp256k1/blob/main/bindings/c_api/ultrafast_secp256k1.cpp): `bindings/c_api/ultrafast_secp256k1.cpp`
- [Language bindings](https://github.com/shrec/ultrafastsecp256k1/tree/main/bindings): `bindings`
- [secp256k1 shim](https://github.com/shrec/ultrafastsecp256k1/blob/main/compat/libsecp256k1_shim/src/shim_context.cpp): `compat/libsecp256k1_shim/src/shim_context.cpp`
- [libbitcoin bridge](https://github.com/shrec/ultrafastsecp256k1/blob/main/compat/libbitcoin_bridge/src/ufsecp_libbitcoin.cpp): `compat/libbitcoin_bridge/src/ufsecp_libbitcoin.cpp`

### CPU cryptography

- [Field arithmetic](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/field.hpp): `src/cpu/include/secp256k1/field.hpp`
- [Scalar arithmetic](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/scalar.hpp): `src/cpu/include/secp256k1/scalar.hpp`
- [Point arithmetic](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/point.hpp): `src/cpu/include/secp256k1/point.hpp`
- [Constant-time points](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ct/point.hpp): `src/cpu/include/secp256k1/ct/point.hpp`
- [Constant-time signing](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ct/sign.hpp): `src/cpu/include/secp256k1/ct/sign.hpp`
- [ECDSA](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/ecdsa.hpp): `src/cpu/include/secp256k1/ecdsa.hpp`
- [Schnorr](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/schnorr.hpp): `src/cpu/include/secp256k1/schnorr.hpp`
- [Batch verification](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/batch_verify.hpp): `src/cpu/include/secp256k1/batch_verify.hpp`
- [Signature recovery](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/recovery.hpp): `src/cpu/include/secp256k1/recovery.hpp`
- [SHA-256](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/sha256.hpp): `src/cpu/include/secp256k1/sha256.hpp`
- [Taproot](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/taproot.hpp): `src/cpu/include/secp256k1/taproot.hpp`
- [Secure erasure](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/cpu/include/secp256k1/detail/secure_erase.hpp): `src/cpu/include/secp256k1/detail/secure_erase.hpp`

### GPU acceleration

- [GPU verify dispatch](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/gpu/src/gpu_engine_hook.cpp): `src/gpu/src/gpu_engine_hook.cpp`
- [GPU backends](https://github.com/shrec/ultrafastsecp256k1/blob/main/src/gpu/include/gpu_backend.hpp): `src/gpu/include/gpu_backend.hpp`

### Audit evidence

- [Audit runner](https://github.com/shrec/ultrafastsecp256k1/blob/main/audit/unified_audit_runner.cpp): `audit/unified_audit_runner.cpp`
- [Audit evidence](https://github.com/shrec/ultrafastsecp256k1/tree/main/audit): `audit`

### Other components

- **Application**

## Connections

- Application → C API: calls (evidence: `README.md`)
- Application → Language bindings: integrates through (evidence: `README.md`)
- Application → secp256k1 shim: may use (evidence: `README.md`)
- Application → libbitcoin bridge: may integrate through (evidence: `README.md`)
- C API → Scalar arithmetic: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → Point arithmetic: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → Field arithmetic: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → ECDSA: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → Schnorr: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → Signature recovery: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → SHA-256: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- C API → Taproot: uses (evidence: `bindings/c_api/ultrafast_secp256k1.cpp`)
- Point arithmetic → Field arithmetic: uses (evidence: `src/cpu/include/secp256k1/point.hpp`)
- Point arithmetic → Scalar arithmetic: uses (evidence: `src/cpu/include/secp256k1/point.hpp`)
- ECDSA → Scalar arithmetic: uses (evidence: `src/cpu/include/secp256k1/ecdsa.hpp`)
- ECDSA → Point arithmetic: uses (evidence: `src/cpu/include/secp256k1/ecdsa.hpp`)
- Schnorr → Scalar arithmetic: uses (evidence: `src/cpu/include/secp256k1/schnorr.hpp`)
- Schnorr → Point arithmetic: uses (evidence: `src/cpu/include/secp256k1/schnorr.hpp`)
- Batch verification → ECDSA: uses (evidence: `src/cpu/include/secp256k1/batch_verify.hpp`)
- Batch verification → Schnorr: uses (evidence: `src/cpu/include/secp256k1/batch_verify.hpp`)
- Signature recovery → ECDSA: uses (evidence: `src/cpu/include/secp256k1/recovery.hpp`)
- Signature recovery → Point arithmetic: uses (evidence: `src/cpu/include/secp256k1/recovery.hpp`)
- Taproot → Point arithmetic: uses (evidence: `src/cpu/include/secp256k1/taproot.hpp`)
- Constant-time signing → Constant-time points: uses (evidence: `src/cpu/include/secp256k1/ct/sign.hpp`)
- Constant-time signing → ECDSA: provides signing (evidence: `src/cpu/include/secp256k1/ct/sign.hpp`)
- Constant-time points → Point arithmetic: uses (evidence: `src/cpu/include/secp256k1/ct/point.hpp`)
- GPU verify dispatch → Batch verification: registers hook for (evidence: `src/gpu/src/gpu_engine_hook.cpp`)
- GPU verify dispatch → GPU backends: dispatches to (evidence: `src/gpu/src/gpu_engine_hook.cpp`)
- GPU verify dispatch → Batch verification: falls back to CPU (evidence: `src/gpu/src/gpu_engine_hook.cpp`)
- secp256k1 shim → Scalar arithmetic: uses (evidence: `compat/libsecp256k1_shim/src/shim_context.cpp`)
- secp256k1 shim → Point arithmetic: uses (evidence: `compat/libsecp256k1_shim/src/shim_context.cpp`)
- secp256k1 shim → Constant-time points: uses (evidence: `compat/libsecp256k1_shim/src/shim_context.cpp`)
- secp256k1 shim → Constant-time signing: uses (evidence: `compat/libsecp256k1_shim/src/shim_context.cpp`)
- Audit runner → Audit evidence: produces
