Files
tea3-py/README.md
T
2026-07-07 14:14:02 +02:00

1.9 KiB

tea3-py

install

python -m venv .venv
source .venv/bin/activate
pip install -e .

run tests

pip install pytest
pytest

run linear and differential bias empirical tests

in the venv

tea3-linear-bias
tea3-differential-bias

derive lookup tables

lookup-tables

run sagemath script

deactivate the venv first, then with sagemath installed:

./run_sage.sh

Modes are:

Mode Explanation
1. Classic inspection run n steps
2. Advanced inspection with forced 0 or 1 bits run n steps but with bits forced to 0 or 1
3. Exhaustive variable-change search -
4. S box analysis -
5. Variable XOR XOR chosen bits inside a register and check the evolution during n steps
6. F31, F32 analysis -
7. Exhaustive XOR search XOR bits inside a register, returns the best combination (least number of monomials)
8. Cube attack search offline part of the cube attack (a precomputed model can be used)
9. Precompute and save model precompute n steps and save the model
10. Load model load a saved model

n steps can be precomputed and then loaded for the offline part of the cube attack with the menu entry 9 and 10.