The Side-Channel Analysis Library (SCALib) is a Python library that contains state-of-the-art tools for side-channel security evaluation.
- Documentation: https://scalib.readthedocs.io/
- Examples: examples/
- Chat: https://matrix.to/#/#scalib:matrix.org <https://matrix.to/#/#scalib:matrix.org>
- Source code: https://github.com/simple-crypto/SCALib
- Bug reports/feature requests: https://github.com/simple-crypto/SCALib/issues/new/choose
- Contributing: https://scalib.readthedocs.io/en/stable/source/contributing.html
SCALib focuses on
- simple interface,
- state-of-the art algorithms,
- excellent performance (see benchmarks).
SCALib should be useful for any side-channel practitioner who wants to evaluate, but not necessarily attack, protected or non-protected implementations. See the documentation for the list of implemented tools.
SCALib is on PyPi! Simple install:
pip install scalib
We provide pre-built wheels for any recent python on Linux and Windows (x86). Be sure to use a recent pip. For other plateforms, this will build SCALib (see below for dependencies).
To get best performance, you want to build locally (this will optimize SCALib for your CPU).
Depdendencies:
python >= 3.10,- a C/C++ compiler for your platform,
clang,- the latest stable release of the rust toolchain.
To install from source:
git clone https://github.com/simple-crypto/SCALib pip install ./SCALib
See CONTRIBUTING.rst for advanced build configuration.
See API documentation, example and real-world usages.
If your needs are not covered by SCALib, you might be more lucky with lascar or scared.
Please also let us know your needs by opening a feature request.
SCALib uses semantic versioning, see the CHANGELOG for breaking changes and novelties.
SCALib was initiated by Olivier Bronchain and Gaëtan Cassiers during their PhD at UCLouvain. It is now developed as a project of SIMPLE-Crypto and maintained by Gaëtan Cassiers (@cassiersg).
Contributions welcome !
Please file a bug report for any issue you encounter (even bad documentation is a bug !), and let us know your suggestions (open a github issue, chat and email work too). We also welcome code contributions, see CONTRIBUTING.rst.
You can also come discuss on matrix (announcements, questions, community support, open discussion, etc.).
All code contributions are subject to the Contributor License Agreement (CLA) of SIMPLE-Crypto, which ensures a thriving future for open-source hardware security.
If you use SCALib in your research, please cite our software paper:
Cassiers et al., (2023). SCALib: A Side-Channel Analysis Library. Journal of Open Source Software, 8(86), 5196, https://doi.org/10.21105/joss.05196
Bibtex:
@article{scalib,
doi = {10.21105/joss.05196},
url = {https://doi.org/10.21105/joss.05196},
year = {2023},
publisher = {The Open Journal},
volume = {8},
number = {86},
pages = {5196},
author = {Gaëtan Cassiers and Olivier Bronchain},
title = {SCALib: A Side-Channel Analysis Library}, journal = {Journal of Open Source Software}
}
This project is licensed under GNU AFFERO GENERAL PUBLIC LICENSE, Version 3. See COPYRIGHT and COPYING for more information.
For licensing-related matters, please contact [email protected].
This work has been funded in part by the Belgian Fund for Scientific Research (F.R.S.-FNRS) through the Equipment Project SCALAB and individual researchers' grants, by the European Union (EU) and the Walloon Region through the FEDER project USERMedia (convention number 501907-379156), and by the European Union (EU) through the ERC project 724725 (acronym SWORD) and the ERC project 101096871 (acronym BRIDGE).