ECC TUTORIAL -- how to use
===========================

WHAT IS THIS?

An interactive, local web app that teaches elliptic curve cryptography (ECC) --
7 chapters, 29 figures, most of them live, editable examples you can change
and re-run yourself, right in the browser. It covers the same ground a textbook
chapter on ECC would: Diffie-Hellman, elliptic curve arithmetic, ECC protocols
(ECDH, ECIES, ECDSA, EdDSA), choosing safe curve parameters, and further topics
(integer factorization with elliptic curves, post-quantum key agreement).

Available in English and German -- switch anytime with the EN/DE button in the
top bar of any page.

WHAT'S IN HERE?

- index.html, ch1.html ... ch7.html   the pages (open index.html first)
- server.py                           the local server that powers the examples
- content/en/, content/de/            the chapter text, in both languages
- everything else (*.py, *.js, *.css, data/)  supporting files the app needs;
  you don't need to open or edit these yourself

REQUIREMENTS

- SageMath (https://www.sagemath.org/), installed and on your PATH
- A web browser
- An internet connection, only to load two small display libraries (for math
  formulas and text formatting) -- nothing you type into the app is ever sent
  anywhere; every calculation happens on your own machine

HOW TO USE IT

1. Open a terminal in this folder.

2. Start the server in the terminal:

       python3 server.py

3. Open this address in your browser:

       http://localhost:8765/

4. Start reading at Chapter 1, or jump anywhere using the Table of Contents on
   the front page. Every figure has its own controls (sliders, number fields,
   buttons) -- change them and the result recomputes immediately.

To stop the app, go back to the terminal and press Ctrl+C.

---
Free usage. Open Source with Apache 2 license. By Bernhard Esslinger & the CrypTool team, Sep 2026

The development of the programs was initiated by Maike Massierer in 2011; they happen to align quite closely with Chapter 9 of the forthcoming second edition of the CrypTool book (Artech House, 2027) as well as with Chapter 9 of the soon-to-be-published "Textbook of Applied Cryptography" by Alfred Menezes, Paul van Oorschot, and Bart Preneel (https://sites.google.com/view/textbook-appliedcrypto/home).
