The development of kakarot-ssj is halted for now. This repository - an Ethereum Virtual Machine (EVM) emulator on Starknet - is frozen, mainly to halt creation of new issues and pull requests. It is MIT licensed, not audited.
Table of Contents
Kakarot is an (zk)-Ethereum Virtual Machine implementation written in Cairo. Kakarot is Ethereum compatible, i.e. all existing smart contracts, developer tools and wallets work out-of-the-box on Kakarot. It's been open source from day one. Soon available on Starknet L2 and Appchains.
🚧 It is a work in progress, and it is not ready for production.
This repository is a Cairo rewrite of the CairoZero version of Kakarot zkEVM.
-
Install Scarb. To make sure your version always matches the one used by Kakarot, you can install Scarb via asdf.
-
Install Starknet Foundry. We also recommend installing it via asdf.
-
Install the Cairo Profiler to profile your Cairo code.
-
Install Bun to run the JavaScript scripts.
-
Fork the repository and clone your fork (
git clone https://github.com/<YOUR_USERNAME>/kakarot-ssj) -
Run
make installto install the git hooks. -
Add your environment variables to
.env(see.env.examplefor an example).- Get your Github token here
scarb buildscarb testThe project uses trunk for everything except cairo files. If you don't have it installed already, you can do:
curl https://get.trunk.io -fsSL | bashthen
trunk check --fixVS Code users, don't miss the VS Code trunk plugin.
For cairo files, run:
scarb fmtSee the open issues for a list of proposed features (and known issues).
- Top Feature Requests (Add your votes using the 👍 reaction)
- Top Bugs (Add your votes using the 👍 reaction)
- Newest Bugs
Reach out to the maintainer at one of the following places:
If you want to say thank you or/and support active development of Kakarot:
- Add a GitHub Star to the project.
- Tweet about Kakarot.
- Write interesting articles about the project on Dev.to, Medium, Mirror or your personal blog.
Together, we can make Kakarot better!
First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contribution you make will benefit everybody else and is greatly appreciated.
Please read our contribution guidelines, and thank you for being involved!
For a full list of all authors and contributors, see the contributors page.
Kakarot follows good practices of security, but 100% security cannot be assured. Kakarot is provided "as is" without any warranty. Use at your own risk.
For more information and to report security issues, please refer to our security documentation.
This project is licensed under the MIT license.
See LICENSE for more information.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!