Skip to content

elnosh/gonuts

Repository files navigation

Disclaimer: The author is NOT a cryptographer and this work has not been reviewed. This means that there is very likely a fatal flaw somewhere. Cashu is still experimental and not production-ready.

Don't be reckless: This project is in early development, it does however work with real sats! Always use amounts you don't mind losing.

gonuts

Cashu wallet and mint implementation in Go.

Cashu is a free and open-source Chaumian ecash system built for Bitcoin. You can read more about it here.

Supported NUTs

Implemented NUTs:

Installation

With Go installed, you can run the following command to install the wallet:

go install github.com/elnosh/gonuts/cmd/nutw@latest

To setup a mint for the wallet, create a .env file at ~/.gonuts/wallet/.env and setup your preferred mint.

Using the wallet

Check balance

nutw balance

Create a Lightning invoice to receive ecash

nutw mint 100

This will get an invoice from the mint which you can then pay and use to mint new ecash.

invoice: lnbc100n1pja0w9pdqqx...

Redeem the ecash after paying the invoice

nutw mint --invoice lnbc100n1pja0w9pdqqx...

Send tokens

nutw send 21

This will generate a Cashu token that looks like this:

cashuAeyJ0b2tlbiI6W3sibW...

This is the ecash that you can then send to anyone.

Receive tokens

nutw receive cashuAeyJ0b2tlbiI6W3...

Request the mint to pay a Lightning invoice

nutw pay lnbc100n1pju35fedqqsp52xt3...

Development

Requirements

Wallet

  • cd cmd/nutw
  • create .env file and fill in the values
  • go build -v -o nutw nutw.go

Run mint

  • cd cmd/mint

  • you'll need to setup a lightning regtest environment with something like Polar and fill in the values in the .env file

  • go build -v -o mint mint.go

  • ./mint

Contribute

All contributions are welcome.

If you want to contribute, please open an Issue or a PR.