# clocktower

clocktower is a python package implementing efficient strategies for executing adaptive timing side
channel attacks. the goal is to use statistics to guide public input guesses in order to reveal the
secret with a given level of statistical significance in a minimum number of rounds. the current
strategy already significantly outperforms the naive non-adaptive strategy, and thus can be used as
a framework for mounting attacks

## howto

currently the model is that a correct guess will result in a longer time taken to execute, and all
incorrect guesses will take the same (lower) time to execute  
more abstraction is planned for different target models

```
import clocktower

# default input space: 0-255
# default significance level: 0.01
mgr = clocktower.ClocktowerManager()

# when next_guess() returns None, the algoritm has a statistically significant answer
while (guess := mgr.next_guess()) is not None:
    # execute the guess and get the result
    timing_value = run_attack(guess)
    mgr.update(guess, timing_value)

print(mgr.get_best_guess())
```