• n0-space/whirlpool-server — Whirlpool CoinJoin Coordinator
  • Metadata
  • Purpose
  • Architecture
  • Key Features
  • Pool Configuration
  • Relevance to Kapnet

§n0-space/whirlpool-server — Whirlpool CoinJoin Coordinator

§Metadata

• Source: https://github.com/n0-space/whirlpool-server (fork of Samourai-Wallet/whirlpool-server)
• License: AGPL-3.0 (Copyright Samourai Wallet)
• Language: Java (Maven build)
• Size: 1.7MB
• Files: 175

§Purpose

Server/coordinator for Whirlpool CoinJoin protocol. Manages pool mixing, participant matching, transaction construction, and blockchain verification.

§Architecture

whirlpool-server/
  src/
    main/java/
      whirlpool/server/        — Server core
      whirlpool/server/api/    — REST API
      whirlpool/server/pool/   — Pool management
      whirlpool/server/tx/     — Tx construction
      whirlpool/server/model/  — Data models
    test/java/                 — Unit tests
  pom.xml                      — Maven build
  README-install.md            — Installation guide

§Key Features

• Pool management (denomination, fee configuration)
• TX0 fee management
• UTXO verification via Bitcoin RPC
• Participant matching for CoinJoin rounds
• Blinded credential verification
• REST API for client communication

§Pool Configuration

server.pools[x].denomination: amount in satoshis
server.pools[x].miner-fee-min: minimum miner-fee
server.pools[x].maxer-fee-max: maximum miner-fee
server.pools[x].miner-fee-cap: soft cap recommendation
server.pools[x].fee-value: server fee per tx0
server.pools[x].fee-accept: alternate fee values

§Relevance to Kapnet

• Run private Whirlpool coordinator for Kapnet treasury
• Treasury UTXOs mixed before distribution
• Integration: kapnet-treasury → whirlpool-server → CoinJoin payouts
• License: AGPL-3.0 (must share source if modified + served)