build: multi-stage builds and testing configuration

- Introduced a new `compose.yml` file for running tests in an isolated Docker environment.
- Updated `Dockerfile` to support multi-stage builds, including a dedicated test stage with Bitcoin Core.
- Enhanced `install.sh` to allow installation of dependencies only, without building JoinMarket.
- Updated documentation to include Docker usage instructions for building images and running tests.

Author: roshii

.dockerignore

@@ -1,4 +1,7 @@
 .git
 *.egg-info
+configs
 deps
-jmvenv
+jmvenv
+compose.yml
+Dockerfile

Dockerfile

@@ -1,16 +1,38 @@
-FROM debian:bookworm-slim
-
-RUN mkdir -p /jm/clientserver
+ARG BITCOIN_VERSION=29.2
+ARG PYTHON_IMAGE_TAG=3.13-slim-trixie
+FROM bitcoin/bitcoin:${BITCOIN_VERSION} AS bitcoin
+FROM python:${PYTHON_IMAGE_TAG} AS python
 WORKDIR /jm/clientserver
 
-COPY . .
-
-RUN apt-get update && apt-get install -y --no-install-recommends gnupg ca-certificates=* curl=* \
-  python3-pip=* python3=* \
-  && pip3 config set global.break-system-packages true \
-  && pip3 install 'wheel>=0.35.1' \
-  && ./install.sh --docker-install \
-  && apt-get purge -y --autoremove python3-pip \
+FROM python AS base-deps
+RUN DEBIAN_FRONTEND=noninteractive \
+  apt-get update \
+  && apt-get install -y --no-install-recommends \
+    libsecp256k1-2 \
+    libsodium23 \
+    openssl \
+    tor \
   && apt-get clean \
   && rm -rf /var/lib/apt/lists/*
 
+FROM base-deps AS builder
+COPY . .
+RUN python -m venv jmvenv \
+  && . ./jmvenv/bin/activate \
+  && pip install .[services]
+
+FROM base-deps AS base
+COPY --from=builder /jm/clientserver /jm/clientserver
+ENTRYPOINT ["./scripts/docker-entrypoint.sh"]
+
+FROM base AS test
+ARG BITCOIN_VERSION
+COPY --from=bitcoin /opt/bitcoin-${BITCOIN_VERSION}/bin /usr/local/bin/
+RUN . ./jmvenv/bin/activate \ 
+  && pip install .[test]
+
+FROM base AS obwatcher
+RUN . ./jmvenv/bin/activate && pip install matplotlib
+CMD ["python", "./scripts/obwatch/ob-watcher.py"]
+
+FROM base AS joinmarket

README.md

@@ -62,6 +62,18 @@ Alternative to this "quickstart": follow the [install guide](docs/INSTALL.md).
 * [Installation guide for Qubes+Whonix](https://github.com/qubenix/qubes-whonix-bitcoin/blob/master/1_joinmarket.md).
 * [Youtube video installation tutorial for Ubuntu](https://www.youtube.com/watch?v=zTCC86IUzWo).
 
+### Docker
+
+JoinMarket can be built and run using Docker. To build the Docker image:
+
+    docker build -t joinmarket .
+
+To run tests using Docker Compose:
+
+    docker compose up test
+
+This will run the full test suite in an isolated environment with all necessary dependencies including Bitcoin Core.
+
 ### Usage
 
 If you are new, follow and read the links in the [usage guide](docs/USAGE.md).

compose.yml

@@ -0,0 +1,43 @@
+services:
+  test:
+    image: joinmarket:test
+    build:
+      context: .
+      target: test
+      args: &build_args
+        BITCOIN_VERSION: 29.2
+        PYTHON_IMAGE_TAG: 3.13-slim-trixie
+    volumes:
+      - ./src:/jm/clientserver/src
+      - ./test:/jm/clientserver/test
+    shm_size: '2gb'
+    command: ["./test/run_tests.sh", "-v"]
+  tor:
+    image: leplusorg/tor
+    environment:
+      - SOCKS_HOSTNAME=tor
+    volumes:
+      - tor:/var/lib/tor
+  obwatcher:
+    image: joinmarket:obwatcher
+    build:
+      context: .
+      target: obwatcher
+      args: *build_args
+    command: ["python", "./scripts/obwatch/ob-watcher.py", "-H", "0.0.0.0"]
+    ports:
+      - "62601:62601"
+    configs:
+      - source: obwatch
+        target: /root/.joinmarket/joinmarket.cfg
+    volumes:
+      - tor:/var/lib/tor:ro
+    depends_on:
+      - tor
+
+configs:
+  obwatch:
+    file: ./configs/obwatch.cfg
+
+volumes:
+  tor:

configs/obwatch.cfg

@@ -0,0 +1,19 @@
+[DAEMON]
+no_daemon = 0
+
+[BLOCKCHAIN]
+blockchain_source = no-blockchain
+
+[MESSAGING:onion]
+type = onion
+socks5_host = tor
+socks5_port = 9050
+tor_control_host = tor
+tor_control_port = 9051
+onion_serving_host = 127.0.0.1
+onion_serving_port = 8080
+directory_nodes = satoshi2vcg5e2ept7tjkzlkpomkobqmgtsjzegg6wipnoajadissead.onion:5222,jmarketxf5wc4aldf3slm5u6726zsky52bqnfv6qyxe5hnafgly6yuyd.onion:5222,coinjointovy3eq5fjygdwpkbcdx63d7vd4g32mw7y553uj3kjjzkiqd.onion:5222,nakamotourflxwjnjpnrk7yc2nhkf6r62ed4gdfxmmn5f4saw5q5qoyd.onion:5222,odpwaf67rs5226uabcamvypg3y4bngzmfk7255flcdodesqhsvkptaid.onion:5222
+
+[LOGGING]
+console_log_level = INFO
+color = true

docs/INSTALL.md

@@ -265,14 +265,47 @@ There, you need to install the client code (without Joinmarket's bitcoin):
 
 #### Docker Installation
 
-The [Dockerfile](../Dockerfile) provided builds a minimal Docker image which can help in getting started with a custom Docker setup. An example of building and running the [wallet-tool.py](../scripts/wallet-tool.py) script:
+The [Dockerfile](../Dockerfile) provided builds an optimized multi-stage Docker image for JoinMarket. The build process is optimized for layer caching and includes all necessary dependencies.
 
-```
-docker build -t joinmarket-test ./
-docker run --rm -it joinmarket-test bash -c "cd scripts && python3 wallet-tool.py --help"
-```
+##### Building the Docker image
+
+To build the production image:
+
+    docker build -t joinmarket .
+
+This creates a minimal production image with JoinMarket installed.
+
+##### Running JoinMarket scripts in Docker
+
+Example of running the [wallet-tool.py](../scripts/wallet-tool.py) script:
+
+    docker run --rm -it joinmarket bash -c "source jmvenv/bin/activate && cd scripts && python wallet-tool.py --help"
+
+##### Running tests with Docker Compose
+
+The repository includes a `compose.yml` file for easy testing:
+
+    docker compose up test
+
+This will:
+
+* Build a test image that includes Bitcoin Core 29.2
+* Mount the `src` and `test` directories for development
+* Run the full test suite with all dependencies configured automatically
+* Use shared memory for improved test performance
+
+##### Building custom images
+
+The Dockerfile uses multi-stage builds with the following targets:
+
+* `joinmarket` (default) - Production image with JoinMarket installed
+* `test` - Testing image that includes Bitcoin Core binaries
+
+You can build a specific target:
+
+    docker build --target test -t joinmarket:test .
 
-A new Docker image can be built using `joinmarket-test` as a base using `FROM joinmarket-test`. See [Docker documentation](https://docs.docker.com/engine/reference/builder/) for more details.
+See [Docker documentation](https://docs.docker.com/engine/reference/builder/) for more details on multi-stage builds.
 
 #### Development (or making other changes to the code)
 

docs/TESTING.md

@@ -1,5 +1,22 @@
 ### Test instructions (for developers):
 
+#### Quick start: Running tests with Docker
+
+The easiest way to run the full test suite is using Docker Compose, which handles all dependencies automatically:
+
+    docker compose run --rm test
+
+This will:
+
+* Build a Docker image with all dependencies (Python, Bitcoin Core 29.2, miniircd)
+* Run the complete test suite in an isolated environment
+* Automatically download and set up miniircd
+* No need to install bitcoind or other dependencies on your host machine
+
+For development, the Docker setup mounts the `src` and `test` directories, so you can make changes locally and re-run tests without rebuilding the image.
+
+#### Manual setup
+
 Work in your `jmvenv` virtual environment as for all Joinmarket work. Make sure to have [bitcoind](https://bitcoin.org/en/full-node) 28.1 or newer installed. Also need miniircd installed to the root (i.e. in your `joinmarket-clientserver` directory):
 
     (jmvenv)$ cd /path/to/joinmarket-clientserver

scripts/docker-entrypoint.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+# shellcheck disable=SC1091
+source jmvenv/bin/activate
+exec "$@"