Skip to content

Latest commit

 

History

History
49 lines (29 loc) · 1.49 KB

README.md

File metadata and controls

49 lines (29 loc) · 1.49 KB

Trailing Finality Layer Simulator

This is an experimental simulator for research into a potential Trailing Finality Layer for Zcash.

Note the caveats: experimental, simulator, research, potential.

Instructions

  1. Install poetry:

    sudo apt install python3-poetry
    

    or see poetry's installation docs if not on Debian/Ubuntu.

  2. Install dependencies:

    poetry install
    
  3. Run the demo (currently just an example of message passing):

    poetry run demo
    

Documentation

Design documentation is under the doc/ directory:

You can also generate API documentation by running ./gendoc.sh. This assumes that you have run poetry install as shown above. The starting point for the generated documentation is <apidoc/simtfl.html>.

Contributing

Please use ./check.sh before submitting a PR. This currently runs flake8, pyanalyze, and the unit tests locally.

You can use ./check.sh -k <substring> to run flake8, pyanalyze, and then only tests with names matching the given substring. This will not suppress output to stdout or stderr (but ./check.sh -bk <substring> will).

To see other options for running unit tests, use poetry run python -m unittest -h.

License

This software is provided under the terms of the MIT License.