# diranl/secure-printing-system architecture

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

- Interactive diagram: https://gitdiagram.com/diranl/secure-printing-system
- Repository: https://github.com/diranl/secure-printing-system

## Overview

Oblivious Printing coordinates encrypted message preparation, a server mixnet, private retrieval, and visual-cryptography printing so participating printers need not learn the message. The demonstrated entry point is Controller: it creates ElGamal keys, runs and validates the mixnet, retrieves an encrypted message, then executes, checks, and finalizes the print. The graph preserves the documented crypto and visual-printing layers. Several mixnet and visual-crypto links rely on the SOURCE INDEX rather than complete excerpts; unsampled internals are not inferred beyond those references.

Main entry points: [`SecurePrinting/src/secureprinting/Controller.java`](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Controller.java) (Controller), [`SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java) (Printer driver), [`SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java`](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java) (Crypto factory), [`SecurePrinting/src/secureprinting/Matrix.java`](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Matrix.java) (Bit matrix)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Workflow"]
  node_controller["Controller<br/>[Controller.java]"]
end

subgraph group_mixnet["Mixnet"]
  node_mixnet_runtime["Mixnet runner<br/>[Mixnet.java]"]
  node_mixnet_server["Mix server<br/>[Server.java]"]
  node_translation_table["Translation table"]
  node_cipher_message["Cipher message<br/>[CipherMessage.java]"]
  node_mix_primitives["Mix primitives"]
end

subgraph group_crypto["Cryptography"]
  node_crypto_factory["Crypto factory"]
  node_elgamal_parameters["ElGamal parameters"]
  node_elgamal_message["ElGamal messages<br/>[ElGamalMsgC.java]"]
  node_big_integer["Big integers"]
  node_key_share["Key share"]
end

subgraph group_visual["Visual printing"]
  node_visual_print["Print protocol"]
  node_printer_driver["Printer driver<br/>[PrinterDriver.java]"]
  node_printer["Printer<br/>[Printer.java]"]
  node_basis_matrix["Basis matrix<br/>[BasisMatrix.java]"]
  node_bitmap["Bitmap<br/>[Bitmap.java]"]
end

subgraph group_representation["Data representation"]
  node_matrix["Bit matrix<br/>[Matrix.java]"]
  node_parser["Input parser<br/>[Parser.java]"]
  node_commitment["Commitment<br/>[Commitment.java]"]
end

node_operator(("Operator"))

node_operator -->|"starts demo"| node_controller
node_controller -->|"creates keys"| node_crypto_factory
node_crypto_factory -->|"generates parameters"| node_elgamal_parameters
node_controller -->|"runs mix"| node_mixnet_runtime
node_controller -->|"extracts message"| node_translation_table
node_controller -->|"starts printing"| node_visual_print
node_mixnet_runtime -.->|"dispatches servers"| node_mixnet_server
node_mixnet_server -->|"uses mix tools"| node_mix_primitives
node_translation_table -->|"permutes and factors"| node_mix_primitives
node_translation_table -->|"handles ciphertexts"| node_cipher_message
node_cipher_message -->|"encrypts and decrypts"| node_crypto_factory
node_controller -->|"uses key share"| node_key_share
node_crypto_factory -->|"uses arithmetic"| node_big_integer
node_elgamal_parameters -->|"uses arithmetic"| node_big_integer
node_crypto_factory -->|"constructs messages"| node_elgamal_message
node_visual_print -->|"prints encrypted message"| node_cipher_message
node_visual_print -->|"delegates printing"| node_printer_driver
node_printer_driver -->|"uses printer"| node_printer
node_printer_driver -->|"uses basis"| node_basis_matrix
node_printer_driver -->|"uses bitmap"| node_bitmap
node_printer_driver -->|"uses matrices"| node_matrix
node_basis_matrix -->|"uses matrices"| node_matrix
node_matrix -->|"writes bitmap"| node_bitmap
node_parser -->|"produces matrices"| node_matrix
node_printer_driver -->|"uses commitment"| node_commitment
node_controller -->|"encodes selection"| node_elgamal_message

click node_controller "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Controller.java"
click node_crypto_factory "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java"
click node_elgamal_parameters "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/ElGamalParametersC.java"
click node_elgamal_message "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/ElGamalMsgC.java"
click node_big_integer "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/util/CivitasBigInteger.java"
click node_key_share "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/ElGamalKeyPairShare.java"
click node_mixnet_runtime "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/Mixnet.java"
click node_mixnet_server "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/Server.java"
click node_translation_table "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/TranslationTable.java"
click node_cipher_message "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/CipherMessage.java"
click node_mix_primitives "https://github.com/diranl/secure-printing-system/tree/master/SecurePrinting/src/secureprinting/mixnet"
click node_visual_print "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/ObliviousPrint.java"
click node_printer_driver "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java"
click node_printer "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/Printer.java"
click node_basis_matrix "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/BasisMatrix.java"
click node_bitmap "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/Bitmap.java"
click node_matrix "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Matrix.java"
click node_parser "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Parser.java"
click node_commitment "https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Commitment.java"

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_controller toneBlue
class node_mixnet_runtime,node_mixnet_server,node_translation_table,node_cipher_message,node_mix_primitives toneAmber
class node_crypto_factory,node_elgamal_parameters,node_elgamal_message,node_big_integer,node_key_share toneMint
class node_visual_print,node_printer_driver,node_printer,node_basis_matrix,node_bitmap toneRose
class node_matrix,node_parser,node_commitment,node_operator toneIndigo
```

## Components

### Workflow

- [Controller](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Controller.java): `SecurePrinting/src/secureprinting/Controller.java`

### Mixnet

- [Mixnet runner](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/Mixnet.java): `SecurePrinting/src/secureprinting/mixnet/Mixnet.java`
- [Mix server](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/Server.java): `SecurePrinting/src/secureprinting/mixnet/Server.java`
- [Translation table](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/TranslationTable.java): `SecurePrinting/src/secureprinting/mixnet/TranslationTable.java`
- [Cipher message](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/mixnet/CipherMessage.java): `SecurePrinting/src/secureprinting/mixnet/CipherMessage.java`
- [Mix primitives](https://github.com/diranl/secure-printing-system/tree/master/SecurePrinting/src/secureprinting/mixnet): `SecurePrinting/src/secureprinting/mixnet`

### Cryptography

- [Crypto factory](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java): `SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java`
- [ElGamal parameters](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/ElGamalParametersC.java): `SecurePrinting/src/civitas/crypto/concrete/ElGamalParametersC.java`
- [ElGamal messages](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/concrete/ElGamalMsgC.java): `SecurePrinting/src/civitas/crypto/concrete/ElGamalMsgC.java`
- [Big integers](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/util/CivitasBigInteger.java): `SecurePrinting/src/civitas/util/CivitasBigInteger.java`
- [Key share](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/civitas/crypto/ElGamalKeyPairShare.java): `SecurePrinting/src/civitas/crypto/ElGamalKeyPairShare.java`

### Visual printing

- [Print protocol](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/ObliviousPrint.java): `SecurePrinting/src/secureprinting/visualcrypto/ObliviousPrint.java`
- [Printer driver](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java): `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`
- [Printer](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/Printer.java): `SecurePrinting/src/secureprinting/visualcrypto/Printer.java`
- [Basis matrix](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/BasisMatrix.java): `SecurePrinting/src/secureprinting/visualcrypto/BasisMatrix.java`
- [Bitmap](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/visualcrypto/Bitmap.java): `SecurePrinting/src/secureprinting/visualcrypto/Bitmap.java`

### Data representation

- [Bit matrix](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Matrix.java): `SecurePrinting/src/secureprinting/Matrix.java`
- [Input parser](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Parser.java): `SecurePrinting/src/secureprinting/Parser.java`
- [Commitment](https://github.com/diranl/secure-printing-system/blob/master/SecurePrinting/src/secureprinting/Commitment.java): `SecurePrinting/src/secureprinting/Commitment.java`

### Other components

- **Operator**

## Connections

- Operator → Controller: starts demo (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Controller → Crypto factory: creates keys (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Crypto factory → ElGamal parameters: generates parameters (evidence: `SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java`)
- Controller → Mixnet runner: runs mix (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Controller → Translation table: extracts message (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Controller → Print protocol: starts printing (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Mixnet runner → Mix server: dispatches servers
- Mix server → Mix primitives: uses mix tools (evidence: `SecurePrinting/src/secureprinting/mixnet/Server.java`)
- Translation table → Mix primitives: permutes and factors (evidence: `SecurePrinting/src/secureprinting/mixnet/TranslationTable.java`)
- Translation table → Cipher message: handles ciphertexts (evidence: `SecurePrinting/src/secureprinting/mixnet/TranslationTable.java`)
- Cipher message → Crypto factory: encrypts and decrypts (evidence: `SecurePrinting/src/secureprinting/mixnet/CipherMessage.java`)
- Controller → Key share: uses key share (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
- Crypto factory → Big integers: uses arithmetic (evidence: `SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java`)
- ElGamal parameters → Big integers: uses arithmetic (evidence: `SecurePrinting/src/civitas/crypto/concrete/ElGamalParametersC.java`)
- Crypto factory → ElGamal messages: constructs messages (evidence: `SecurePrinting/src/civitas/crypto/concrete/CryptoFactoryC.java`)
- Print protocol → Cipher message: prints encrypted message (evidence: `SecurePrinting/src/secureprinting/visualcrypto/ObliviousPrint.java`)
- Print protocol → Printer driver: delegates printing (evidence: `SecurePrinting/src/secureprinting/visualcrypto/ObliviousPrint.java`)
- Printer driver → Printer: uses printer (evidence: `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`)
- Printer driver → Basis matrix: uses basis (evidence: `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`)
- Printer driver → Bitmap: uses bitmap (evidence: `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`)
- Printer driver → Bit matrix: uses matrices (evidence: `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`)
- Basis matrix → Bit matrix: uses matrices (evidence: `SecurePrinting/src/secureprinting/visualcrypto/BasisMatrix.java`)
- Bit matrix → Bitmap: writes bitmap (evidence: `SecurePrinting/src/secureprinting/Matrix.java`)
- Input parser → Bit matrix: produces matrices (evidence: `SecurePrinting/src/secureprinting/Parser.java`)
- Printer driver → Commitment: uses commitment (evidence: `SecurePrinting/src/secureprinting/visualcrypto/PrinterDriver.java`)
- Controller → ElGamal messages: encodes selection (evidence: `SecurePrinting/src/secureprinting/Controller.java`)
