GithubHelp home page GithubHelp logo

decryptofy / scarr Goto Github PK

View Code? Open in Web Editor NEW
54.0 4.0 8.0 157 KB

SCARR is a Side-Channel Analysis (SCA) framework

License: Mozilla Public License 2.0

Python 100.00%
cryptanalysis hardware-security reverse-engineering side-channel-analysis

scarr's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

scarr's Issues

Provide VScode instructions as an alternative getting started method.

I have familiarity with VScode, but not with using Jupyter Notebook. I think this may be the case for many OSU students. In my brief experience running jupyter notebook through the browser is a good deal slower with a less intuitive interface. I would like to put together a tutorial for using VScode and running the first jupyter notebook on it (0_scarr_start_here_V2.ipynb) for true beginners like me.

Please let me know if there's any feedback you would like to provide for this suggestion (even if it is that this isn't a good enough idea).
Thank you!

Elaboration of CONTRIBUTING.md and Contributor Guide

Hello! The purpose of this issue is to request expansion of the documentation in the contributor’s guide to formalize it. The “Contributing Process” is clearly stated as TBD, but it would be helpful to potentially add more specificity to the contributor’s guide, perhaps via a more extensive description of how to contribute to each of the following: development, documentation, feature requests, patches, bug reporting, and user support. It may be even more helpful to include links to pull requests and successful prior instances of each form of contribution for future contributors to look to for guidance. Below is one possible way to begin adding more detail to the Contributor’s Guide:
Contributor Guide

Another idea to improve this documentation through the same lens is to include a “Steps to a Successful Developer Contribution” section. I have seen some large and successful open-source projects include one as part of their documentation for contributors. The idea below could potentially be a starting point to introduce this:
Contributing Process

I plan to follow up on this suggestion in the coming weeks with pull requests that will outline specific, actionable, and more thorough changes for others to review and refine.

Typos and Grammar in ARCHITECTURE.md

I found a few typos and grammatical improvements that could be made in this file.

Ex:
Possessive singular of class:

This directory contains the TraceHandler class which is the file handler of SCARR. This class' main responsibilities are to compute information (i.e. indices/ranges for each batch) required for batching and pass back batches of data that the container class requests.

Sentence structure and missing commas:

This directory contains all available engines that SCARR currently supports. Engines are the main compute class of SCARR. Their main role is to contain the batch-wise algorthims that SCARR uses to compute results. Currently SCARR supports two kinds of Engines, leakage detection (i.e. SNR) and key extraction (i.e. CPA). The first is used as a metric to determine if an implementation is attackable. While the second is an attack to draw cryptographic keys out of said implementation. Any Engine reliant on metadata (i.e. ciphertext, keys, plaintext) for its computation requires the use of a member of the model_values class which passes back values based on said metadata and most times a model of some kind (i.e. Hamming Weight).

Is it alright if I make these changes and fix a couple other minor typos?

Link to "Contributing (inbound-outbound)" in README.md table of contents does not work.

Steps to reproduce:

  1. Navigate to https://github.com/decryptofy/scarr
  2. Scroll down to Table of Contents
  3. Click "Contributing (inbound = outbound)"
  4. Expected behavior: URL is updated in browser and browser navigates to contribution section of README.md
    Actual behavior: URL is updated but navigation does not occur

Before click:
image

After click:
image

OS: Windows 11
Browser: Chrome Version 125.0.6422.76 (Official Build) (64-bit)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.