Bitcoin Core with opcodes for MATT

This repository is a fork of bitcoin-matt docker image that expect a volume to be mounted for the Bitcoin data directory, to being able to side load the bitcoin.conf at runtime instead of being shipped inside the container at buildtime.

Bitcoin + MATT Docker Container

This repository contains a Dockerfile to build and run a custom version of Bitcoin, based on the branch matt from the repository https://github.com/Merkleize/bitcoin.

It contains the same opcodes as the bitcoin-inquisition repo, plus the following opcodes on taproot:

• OP_CHECKCONTRACTVERIFY
• OP_CAT
• OP_CHECKSIGFROMSTACK
• OP_INTERNALKEY

See merkle.fun for more information.

Features

• Lightweight image based on Ubuntu 20.04.
• Compiled with wallet support (no legacy wallet), and no GUI
• Exposes ports 18443 and 18444.
• Uses a custom bitcoin.conf file.

Build the Docker Image

docker build -t bitcoin_matt .

Pull from Docker hub

docker pull bigspider/bitcoin_matt

Run the Docker Container

Before running the Docker container, ensure that you have a Bitcoin data directory on your host machine. This directory should contain your bitcoin.conf file and will be used to persist data across container restarts.

docker run -d -p 18443:18443 -v /path/to/your/bitcoin/data:/root/.bitcoin bigspider/bitcoin_matt

Replace /path/to/your/bitcoin/data with the actual path to your Bitcoin data directory on your host machine. This will mount the directory into the container at /root/.bitcoin.

Exposing port 18443 allows interacting with it using bitcoin-cli -regtest as normal, as long as a recent version of bitcoin-cli is in the path.

Alternatively, once the container is running, one can access a terminal in it with:

docker exec -it <container_id> /bin/bash

or run a command directly, for example:

docker exec <container_id> bitcoin-cli -regtest getblockcount

Configuration

A custom bitcoin.conf is copied to /root/.bitcoin/bitcoin.conf within the container.

The rpc user/pass are rpcuser and rpcpass, and some settings to enable mining transactions with zero fee are added for simplicity.

Contributions

If you'd like to contribute or make changes to this Docker image, feel free to open a pull request or raise an issue in this repository.

Disclaimer

Only use on regtest!