This repo contains the Jupyter notebooks for Optech's Schnorr/Taproot workshops.
For the purposes of demonstrating the features of schnorr and taproot to the Bitcoin developer community, we have developed an extended Python library on top of Pieter Wuille's Taproot Bitcoin Core branch, which provides Python classes and methods to build more sophisticated Taproot transactions and various schnorr signature schemes for preliminary evaluation.
Our Taproot/Schnorr library is an extension of the Bitcoin python test framework, located in the dedicated Optech Bitcoin Taproot Branch.
Note: This Library is intended for demonstrative and educational purposes only.
Do not run test instances of bitcoind on the same machine that you store your Bitcoin private keys. These notebooks shouldn't interfere with your standard bitcoin data directory directory, but why risk it?
It will be useful to have some background on schnorr and taproot before running through the exercises in this repository.
- bip-schnorr: This technical document proposes a standard for 64-byte Schnorr signatures over the elliptic curve secp256k1.
- Taproot, and Schnorr, and SIGHASH_NOINPUT, oh my!: video about Taproot, Schnorr, and SIGHASH_NOINPUT by Pieter Wuille, author of the Schnorr/Taproot proposal. (Note: since the video SIGHASH_NOINPUT is no longer grouped with the taproot/schnorr soft fork proposal)
- Optech Executive Briefing The Next Softfork: Optech's video presentation of the next proposed soft fork.
- bip-taproot: This technical document proposes a new SegWit version 1 output type, with spending rules based on Taproot, Schnorr signatures, and Merkle branches.
- bip-tapscript: This technical document specifies the semantics of the initial scripting system under bip-taproot.
- Bitcoin Optech’s Overview of the Taproot & Tapscript proposed BIPs: Summary of bip-taproot and bip-tapscript.
These workbooks require a bitcoind built from the Optech Taproot
V0.1 branch which
supports schnorr and taproot.
Clone the bitcoinops/bitcoin repository in a separate directory from this taproot-workshop repository:
$ git clone https://github.com/bitcoinops/bitcoin
Note the path where you cloned the bitcoinops/bitcoin repository.
Checkout the Optech taproot branch, which is tagged as Taproot_V0.1.1:
$ git checkout Taproot_V0.1.1
Build the Optech Taproot branch of bitcoind locally. See the build documentation
(build-xxxx.md) in the Bitcoin Core repository docs
directory for additional
documentation on building bitcoind on
Unix,
macOS, or
Windows.
Verify you have python3 installed:
$ python3 --version
If not, you should install Python 3.
Linux:
$ sudo apt-get install python3
macOS (using homebrew):
$ brew install python3
Windows:
- Install using binary from python.org as appropriate for your system
This workshop uses some Python dependencies, particularly jupyter-notebook. To
keep dependencies local to the project, you should create and activate a
virtual environment. You can skip this step if you're happy to install the
dependencies globally:
$ python3 -m venv .venv && source .venv/bin/activate
Install dependencies:
$ pip3 install -r requirements.txt
Ensure Jupyter Notebook is installed:
$ jupyter notebook --version
Jupyter notebook is a handy tool which allow us to run python code directly in an interactive document like this one. The workshop materials are built directly with jupyter .ipynb files, which you can open once you have jupyter installed.
Start Jupyter notebook to see exercises:
$ jupyter notebook
Jupyter will start a notebook server in your terminal, and provide a link for your browser from which you can interact with notebook files. If your browser doesn't automatically open the notebook file explorer, click on the link provided by jupyter notebook server in the terminal.
- Click on the
0.1-test-notebook.ipynbnotebook. - Verify that
0.1-test-notebook.ipynbpasses all checks.
Stop the current running Jupyter session using Control-C in the terminal.
After you have finished your Jupyter session, you can deactivate the Python virtual environment with:
$ deactivate