Skip to content

On chain interactive fault prover for Ethereum

License

Notifications You must be signed in to change notification settings

baby636-sketch/cannon

 
 

Repository files navigation

cannon


The cannon (cannon cannon cannon) is an on chain interactive dispute engine implementing EVM-equivalent fault proofs.

It's half geth, half MIPS, and whole awesome.

  • It's Go code
  • ...that runs an EVM
  • ...emulating a MIPS machine
  • ...running compiled Go code
  • ...that runs an EVM

For more information on Cannon's inner workings, check this overview.

Directory Layout

contracts -- A MIPS emulator implementation, using merkleized state and a pre-image oracle.
example   -- Example programs that can be run and proven with Cannon.
extra     -- Extra scripts and legacy contracts, deprecated.
mipsevm   -- Go tooling to test the onchain MIPS implementation, and generate proof data.
unicorn   -- Sub-module, used by mipsevm for offchain MIPS emulation.

Building

Pre-requisites: Go, Node.js, Make, and CMake.

make build
make test # verify everything works correctly

License

MIT, see LICENSE file.

Note: This code is unaudited. It in NO WAY should be used to secure any money until a lot more testing and auditing are done. I have deployed this nowhere, have advised against deploying it, and make no guarantees of security of ANY KIND.

About

On chain interactive fault prover for Ethereum

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Solidity 41.5%
  • Assembly 27.0%
  • Go 14.7%
  • JavaScript 11.2%
  • Shell 4.4%
  • Makefile 0.8%
  • Python 0.4%