diffie-hellman/README.md

Diffie-Hellman: build it, break it, argue it

The instructions and questions are on the Canvas page. This file lists what is here and how to run it.

What is what

File	Who writes it	What it is
dh.py	you, Step 1	the exchange: generate_private, public_from, shared_secret
eavesdrop.py	you, Step 2	the two brute-force searches and recover_secret
mitm.py	you, Step 3	Mallory's swap_public and relay_text
client.py	you, Stage 2	solve_a and solve_b, against the class server
params.py	given	g = 5 and p = 23, the 2048-bit group from RFC 3526, and small primes for timing
wire.py	given	a pretend network inside one Python program, with Alice, Bob, and a toy cipher
selfcheck.py	given	PASS, FAIL (with what it expected), or SKIP for each of your functions
experiments.py	given	the exchange, the timing tables, and Mallory; writes results.json
PROTOCOL.md	given	every message the class server sends and expects

Build and run

Python 3, no packages.

python3 selfcheck.py
python3 experiments.py
python3 experiments.py exchange
python3 experiments.py timing --bits 16 20 24
python3 experiments.py mitm
python3 client.py OURTEAM
python3 client.py OURTEAM A

A SKIP means a function is not written yet. A FAIL says what it expected, so start reading there.