Skip to content

JoinMarket NG Logo

JoinMarket NG

JoinMarket NG is a modern implementation of the JoinMarket CoinJoin protocol.

It is wire-compatible with the reference JoinMarket network and can run as:

  • Taker (jm-taker) to initiate CoinJoin transactions
  • Maker (jm-maker) to provide liquidity and earn fees

Start Here

  1. Installation
  2. Wallet guide
  3. Taker guide or Maker guide

Quick Start

Install (Linux/macOS):

curl -sSL https://raw.githubusercontent.com/joinmarket-ng/joinmarket-ng/main/install.sh | bash
source ~/.joinmarket-ng/activate.sh

Configure your backend in ~/.joinmarket-ng/config.toml:

[bitcoin]
backend_type = "descriptor_wallet"  # or "neutrino"
rpc_url = "http://127.0.0.1:8332"
rpc_user = "your_rpc_user"
rpc_password = "your_rpc_password"

Create a wallet and inspect addresses:

jm-wallet generate
jm-wallet info

Run a CoinJoin (taker) or start making offers (maker):

jm-taker coinjoin --amount 1000000 --destination INTERNAL
# or
jm-maker start

Key Docs

Community