Skip to main content

Side-Channel Analysis Library

Project description

PyPI Documentation Status Matrix room JOSS paper

The Side-Channel Analysis Library (SCALib) is a Python library that contains state-of-the-art tools for side-channel security evaluation.

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.

Install

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).

Local build

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.

Usage

See API documentation, example and real-world usages.

Alternatives

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.

Versioning policy

SCALib uses semantic versioning, see the CHANGELOG for breaking changes and novelties.

About us

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 and Issues

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.

Citation

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}
}

License

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 info@simple-crypto.dev.

Acknowledgements

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).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scalib-0.6.4.tar.gz (1.5 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

scalib-0.6.4-cp310-abi3-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.10+Windows x86-64

scalib-0.6.4-cp310-abi3-manylinux_2_28_x86_64.whl (3.2 MB view details)

Uploaded CPython 3.10+manylinux: glibc 2.28+ x86-64

scalib-0.6.4-cp310-abi3-macosx_11_0_arm64.whl (2.0 MB view details)

Uploaded CPython 3.10+macOS 11.0+ ARM64

scalib-0.6.4-cp310-abi3-macosx_10_12_x86_64.whl (2.3 MB view details)

Uploaded CPython 3.10+macOS 10.12+ x86-64

File details

Details for the file scalib-0.6.4.tar.gz.

File metadata

  • Download URL: scalib-0.6.4.tar.gz
  • Upload date:
  • Size: 1.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for scalib-0.6.4.tar.gz
Algorithm Hash digest
SHA256 2890c493cda6ca83d6140b506fcf3e6f68b56ea61be63198b2b78ae25cf0c19f
MD5 3f2a47823e7194d6d7605b2eb284c9e0
BLAKE2b-256 9c1b1f017f5ba484ad85bc38c72a45d0d5a635d83e65f8bc330c9919593407c3

See more details on using hashes here.

Provenance

The following attestation bundles were made for scalib-0.6.4.tar.gz:

Publisher: ci.yml on simple-crypto/SCALib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scalib-0.6.4-cp310-abi3-win_amd64.whl.

File metadata

  • Download URL: scalib-0.6.4-cp310-abi3-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.10+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for scalib-0.6.4-cp310-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 1868a0743e3da3b7cbbcf97f1c2eaa0c2cbf62688b22657bc9774cff4616bcf3
MD5 62f6d0e2e298cad94fb89de54ba29a92
BLAKE2b-256 0bdf2fed2a377530fe3b2e5f8877bb9eeb10f5276655e9bf3914fb432baf6dbe

See more details on using hashes here.

Provenance

The following attestation bundles were made for scalib-0.6.4-cp310-abi3-win_amd64.whl:

Publisher: ci.yml on simple-crypto/SCALib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scalib-0.6.4-cp310-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for scalib-0.6.4-cp310-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 0310c31730039841fadf7580863ca8bafdf5637374e4b70247c508e6e13a5bf0
MD5 b62905f6ade0f1ccc624764b55d9caad
BLAKE2b-256 67a7451df7ca554092e171fc61663d296fb7ff1d567fb93645864be857b4a3d0

See more details on using hashes here.

Provenance

The following attestation bundles were made for scalib-0.6.4-cp310-abi3-manylinux_2_28_x86_64.whl:

Publisher: ci.yml on simple-crypto/SCALib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scalib-0.6.4-cp310-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for scalib-0.6.4-cp310-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 53ae3f0c99fe5b9ef312e5ea01ac5a39068ce244adadfd2c071e378f8e308af1
MD5 a505cbf468ebeac626672fa8307db45c
BLAKE2b-256 9341deacc5e995c0097168ba32bf42f419fa42689c8fa8f491969799cb65d3df

See more details on using hashes here.

Provenance

The following attestation bundles were made for scalib-0.6.4-cp310-abi3-macosx_11_0_arm64.whl:

Publisher: ci.yml on simple-crypto/SCALib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scalib-0.6.4-cp310-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for scalib-0.6.4-cp310-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 ae3f2fe570adfda9027467ba3cfe3bed00da3fe2dc193fc5d6a2b0100c8b4645
MD5 69d4a9b5590f2590e96320d6ecd78e59
BLAKE2b-256 505af70f11596140f9d67d5d7c96c66cacb81fdef6d77050ad702ec5c7062fae

See more details on using hashes here.

Provenance

The following attestation bundles were made for scalib-0.6.4-cp310-abi3-macosx_10_12_x86_64.whl:

Publisher: ci.yml on simple-crypto/SCALib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page