Architecture

The public API accepts client requests; the internal API carries threshold protocol messages between peers. Each node has its own database and seal provider. Features and cryptographic platforms are selected when building the artifact.

Main path

Client
  -> public API
  -> authentication and permissions
  -> intent materialization
  -> authority and key policy checks
  -> audit gate
  -> key/session manager
  -> mono or threshold cryptographic operation
  -> proof/result

For threshold operations, the coordinator starts the session, but peers validate the same operation before contributing.

Runtime parts

Part Responsibility
Public API External HTTP API for clients and operators
Internal API Peer-to-peer protocol calls inside a cluster
Auth layer Client authentication, internal peer authentication, permission checks
Authority layer Converts command data into governed intent and policy checks
Key lifecycle DKG, import, refresh, rotate, destroy, generation tracking
Session managers Coordinate signing, DKG, destroy, and feature-specific multi-step operations
Audit layer Records security-relevant decisions and can block operations if required sinks fail
Storage Local key share state, metadata, authorities, audit state, and side data

Approvers, WebAuthn enrollment, configuration discovery and the permitted identity catalog are core APIs. Registry writes require every current member; ordinary threshold signing still requires only its configured quorum. Registered references resolve from each peer's local copy of the registry.

Features

Features add command types, endpoints, or seal providers:

Feature Adds
digital-assets:evm EVM transaction intent support
digital-assets:bitcoin Bitcoin transaction intent support
digital-assets:tron Tron transaction intent and composition
digital-assets:xrp XRP transaction intent and composition
digital-assets:solana Solana transaction intent and composition
agentic-payments AP2 and MC VI mandate signing and composition
authority-x509 Certificate issuance intent support
ecies ECIES encryption and threshold decryption
seal-aws AWS KMS seal provider
seal-gcloud Google Cloud KMS seal provider

If a feature is not included in the artifact, its endpoints or command types are unavailable.

Platforms

Platforms supply cryptographic algorithms and are selected separately from features.

Platform Adds
ecc SECP256K1, P256, ED25519, ECC signing protocols, ECC key derivation, ECIES support
pqc MLDSA44, MLDSA65, MLDSA87, ML-DSA DKG, ML-DSA signing

Features that depend on a platform require that platform explicitly. Digital assets, agentic payments, X.509, and ECIES require ecc.

Mono and threshold

Mode Crypto control point Operational meaning
mono One local node Same policy controls, no distributed key custody
threshold Quorum of peers Key use requires enough peers to accept and participate

In threshold mode, fewer than t peers cannot sign alone. Peers need matching authority and policy state to enforce the same rules, and enough healthy peers to complete an operation.

Integration boundary

The executing system must verify the expected key, signature, and command before acting. It must also enforce the action's expiry and replay rules. If the same action can run through an API that skips verification, TKeeper cannot enforce policy on that path.