Published May 27, 2026 | Version v1

microSCALE

  • 1. ROR icon Indian Institute of Technology Madras

Description

This repo contains necessary files to build and run microSCALE
 
### Build:
docker build -t microscale .
 
### Run a predefined program (we have included some of the test programs):
docker run microscale gift_1round
docker run microscale AES_sbox
docker run microscale PRESENT_sbox
docker run microscale ASCON_sbox
docker run microscale giftsbox
docker run microscale locality_refresh
docker run microscale full_refresh
docker run microscale dom_and
docker run microscale isw_xor

Append --order 2 to use leakage_checker2.py for second order leakage (default is --order 1):
 
### Run a custom .s file:
 
docker run -v /path/to/your_file.s:/app/programs/your_file.s microscale custom --shares 2 --variables 2 --randoms 1 --program programs/your_file.s --graph Rocket --order 1

### Example with codes inside container:
 
docker run microscale custom --shares 2 --variables 2 --randoms 1 --program programs/test_loop.s --graph Rocket --order 1

### Other codes
 
graph_maker.py - used to make MDG (microarchitecture dependency graphs)
lookup_table_maker.py - used to make opcode specific subgraphs
main.py - main microSCALE framework which does operand propagation
leakage_checker1.py - first order leakage checker
leakage_checker2.py - second order leakage checker

Files

may 27_artifact_evaluation_zenodo.zip

Files (518.4 kB)

Name Size Download all
md5:20360dd38102a3031d5673ad2ccdff82
518.4 kB Preview Download