Zcash Protocol Specification

Build dependencies on Debian-based systems include, at least:

apt-get install texlive texlive-science texlive-fonts-extra \
  texlive-generic-recommended texlive-bibtex-extra biber latexmk perl awk

Building

Use:

• make nufour to make the draft specification for NU4 (nufour.pdf);
• make heartwood to make the specification for Heartwood (protocol.pdf);
• make blossom to make the specification for the Blossom upgrade (blossom.pdf);
• make sapling to make the specification for the Overwinter and Sapling upgrades (sapling.pdf);
• make sprout to make a version of the specification that does not include Overwinter or Sapling (sprout.pdf).

make all is equivalent to make nufour heartwood blossom sapling sprout.

By default these use latexmk. If you have trouble getting latexmk to work, you can instead use make nolatexmk-sapling, etc. That is not the preferred way of building because it may not run pdflatex enough times.

It is also possible to use the incremental (-pvc) mode of latexmk to automatically rebuild when changes in the source files are detected, by adding EXTRAOPT=-pvc to the make command line. In this case the updated PDF files will be in the aux/ directory. Manual intervention is still needed when there are LaTeX errors.

Alternative TeX engines

There is experimental support for building the specification using LuaTeX or XeTeX; see the comments at the top of the Makefile. However, this will currently produce poor output. A warning is included below the Abstract to indicate this.