https://github.com/massmux/nutshell-docker

Nutshell Cashu Docker setup with PostgreSQL
https://github.com/massmux/nutshell-docker

cashu chaumian ecash lightning nutshell

Last synced: 19 days ago
JSON representation

Nutshell Cashu Docker setup with PostgreSQL

• Host: GitHub
• URL: https://github.com/massmux/nutshell-docker
• Owner: massmux
• Created: 2023-11-01T14:10:52.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-02-17T06:24:05.000Z (11 months ago)
• Last Synced: 2024-11-09T10:13:29.234Z (2 months ago)
• Topics: cashu, chaumian, ecash, lightning, nutshell
• Language: Dockerfile
• Homepage:
• Size: 10.7 KB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Cashu Nutshell Docker

**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](https://github.com/cashubtc/nutshell) by Calle

Cashu is an Ecash implementation based on David Wagner's variant of Chaumian blinding ([protocol specs](https://github.com/cashubtc/nuts)). Token logic based on [minicash](https://github.com/phyro/minicash) ([description](https://gist.github.com/phyro/935badc682057f418842c72961cf096c)) which implements a [Blind Diffie-Hellman Key Exchange](https://cypherpunks.venona.com/date/1996/03/msg01848.html) scheme written down [here](https://gist.github.com/RubenSomsen/be7a4760dd4596d06963d67baf140406). The database mechanics in Cashu Nutshell and the Lightning backend uses parts from [LNbits](https://github.com/lnbits/lnbits-legend).

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.

## Install and run

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

```