Cashu Nutshell is a Chaumian Ecash wallet and mint for Bitcoin Lightning. Cashu Nutshell is the reference implementation in Python.

This is a full docker setup for nutshell by Calle

Cashu is an Ecash implementation based on David Wagner's variant of Chaumian blinding (protocol specs). Token logic based on minicash (description) which implements a Blind Diffie-Hellman Key Exchange scheme written down here. The database mechanics in Cashu Nutshell and the Lightning backend uses parts from LNbits.

The goal of this repo is to provide a full Dockerized cashu mint, with postreSQL easy to setup and run. This is based on a Lnbits funding source that must be specified inside the .env configuration file.

This will run a nutshell system with postgreSQL included.

First step is to get image from dockerhub

docker pull massmux/nutshell:0.15.0

• configure the .env file (use the .env.example provided)
• configure the docker-compose.yml file to define postgreSQL password

Minimal parameters to configure in .env

• mint private key
• funding Lnbits wallet details
• mint description
• cashu PostgreSQL database password to match with details in docker-compose.yml

Minimal parameters to configure in docker-compose.yml

• cashu PostgreSQL database password

If needed a different version, specify the image version in docker-compose.yml

Run

cd nutshell-docker
docker-compose up -d