# lfdt-paladin/zeto architecture

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

- Interactive diagram: https://gitdiagram.com/lfdt-paladin/zeto
- Repository: https://github.com/lfdt-paladin/zeto

## Overview

Zeto is a toolkit for privacy-preserving EVM fungible and non-fungible tokens. Its central workflow is to generate a zero-knowledge proof with the JavaScript library and circuits, then use a token contract that enforces the selected privacy properties; the Go SDK and recommended Paladin runtime support client interaction. The graph also preserves the documented token-pattern variants and SDK capabilities. Solidity contract implementations are not present in the supplied tree, so deployment modules stand in for that subsystem; links between major subprojects reflect README statements.

Main entry points: [`zkp/js/index.js`](https://github.com/lfdt-paladin/zeto/blob/main/zkp/js/index.js) (JavaScript proof library), [`solidity/ignition/modules`](https://github.com/lfdt-paladin/zeto/tree/main/solidity/ignition/modules) (Token deployment modules), [`go-sdk/src`](https://github.com/lfdt-paladin/zeto/tree/main/go-sdk/src) (Go SDK), [`solidity/scripts/tokens`](https://github.com/lfdt-paladin/zeto/tree/main/solidity/scripts/tokens) (Token deployment examples)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proofs["Proof generation"]
  node_jslib["JavaScript proof library<br/>[index.js]"]
  node_jsutil["Proof utilities<br/>[util.js]"]
  node_circuits["ZK circuits"]
end

subgraph group_contracts["Token contracts"]
  node_tokenmodules["Token deployment modules"]
  node_deployscripts["Token deployment examples"]
end

subgraph group_clients["Client tooling"]
  node_gosdk["Go SDK"]
end

subgraph group_runtime["Client runtime"]
  node_paladin["Paladin client runtime"]
end

node_user(("Token integrator"))
node_evm(("EVM network"))

node_user -->|"generates proofs"| node_jslib
node_jslib -->|"loads circuits"| node_circuits
node_jslib -->|"uses utilities"| node_jsutil
node_user -->|"deploys tokens"| node_tokenmodules
node_deployscripts -.->|"provides examples"| node_tokenmodules
node_user -->|"interacts via SDK"| node_gosdk
node_paladin -->|"submits transactions"| node_evm
node_paladin -->|"targets contracts"| node_tokenmodules
node_paladin -.->|"shares client role"| node_gosdk

click node_jslib "https://github.com/lfdt-paladin/zeto/blob/main/zkp/js/index.js"
click node_jsutil "https://github.com/lfdt-paladin/zeto/blob/main/zkp/js/lib/util.js"
click node_circuits "https://github.com/lfdt-paladin/zeto/tree/main/zkp/circuits"
click node_tokenmodules "https://github.com/lfdt-paladin/zeto/tree/main/solidity/ignition/modules"
click node_deployscripts "https://github.com/lfdt-paladin/zeto/tree/main/solidity/scripts/tokens"
click node_gosdk "https://github.com/lfdt-paladin/zeto/tree/main/go-sdk/src"

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_jslib,node_jsutil,node_circuits toneBlue
class node_tokenmodules,node_deployscripts toneAmber
class node_gosdk toneMint
class node_paladin toneRose
class node_user,node_evm toneIndigo
```

## Components

### Proof generation

- [JavaScript proof library](https://github.com/lfdt-paladin/zeto/blob/main/zkp/js/index.js): `zkp/js/index.js`
- [Proof utilities](https://github.com/lfdt-paladin/zeto/blob/main/zkp/js/lib/util.js): `zkp/js/lib/util.js`
- [ZK circuits](https://github.com/lfdt-paladin/zeto/tree/main/zkp/circuits): `zkp/circuits`

### Token contracts

- [Token deployment modules](https://github.com/lfdt-paladin/zeto/tree/main/solidity/ignition/modules): `solidity/ignition/modules`
- [Token deployment examples](https://github.com/lfdt-paladin/zeto/tree/main/solidity/scripts/tokens): `solidity/scripts/tokens`

### Client tooling

- [Go SDK](https://github.com/lfdt-paladin/zeto/tree/main/go-sdk/src): `go-sdk/src`

### Client runtime

- **Paladin client runtime**

### Other components

- **Token integrator**
- **EVM network**

## Connections

- Token integrator → JavaScript proof library: generates proofs
- JavaScript proof library → ZK circuits: loads circuits
- JavaScript proof library → Proof utilities: uses utilities (evidence: `zkp/js/index.js`)
- Token integrator → Token deployment modules: deploys tokens
- Token deployment examples → Token deployment modules: provides examples (evidence: `solidity/scripts/tokens/Zeto_AnonEnc.ts`)
- Token integrator → Go SDK: interacts via SDK
- Paladin client runtime → EVM network: submits transactions
- Paladin client runtime → Token deployment modules: targets contracts
- Paladin client runtime → Go SDK: shares client role
