donate

README

donate

Cryptocurrency donation daemon.

Goals:

• KISS.
• Zero-fee (the fee is voluntary as a donation to the project).
• Self-hosted.
• Multiple cryptocurrencies (so far it supports BTC but it's easy to add others).
• Multiple hosting (so far GitHub only).

How it works:

1. (optional) The owner of the repository does setting up a donation daemon.
2. The owner of the repository adds GitHub action (it's the easiest way to work with GitHub).
3. Someone opens an issue, then GitHub action shows cryptocurrency addresses (and updates from time to time).
4. Someone solves the issue, adds to commit message Fixes #N, then put to pull request his BTC address in the format BTC{address}. (later, when the support of multiple cryptocurrencies will be ready, he'll need to put addresses of all cryptocurrencies that he want to acquire).
5. GitHub Action triggers payout on donation daemon.
6. If no one acquired money then payout going to donation address (default is donating to this project).

API

Query donation address for issue:

curl -s 'https://donate.dumpstack.io/query?repo=github.com/jollheef/appvm&issue=3'

List all issues with cryptocurrency wallets (right now only BTC) address for repo:

curl -s 'https://donate.dumpstack.io/query?repo=github.com/jollheef/appvm' | json_pp

Trigger payout:

curl -s 'https://donate.dumpstack.io/pay?repo=github.com/jollheef/appvm&issue=3'

Run locally (with Nix)

nix run -f https://code.dumpstack.io/tools/donate/archive/master.tar.gz -c donate

Deploy

See deploy/README.md.