https://github.com/c0debrain/donate

Cryptocurrency donation daemon
https://github.com/c0debrain/donate

Last synced: 6 months ago
JSON representation

Cryptocurrency donation daemon

• Host: GitHub
• URL: https://github.com/c0debrain/donate
• Owner: c0debrain
• License: agpl-3.0
• Created: 2020-01-13T23:03:58.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2020-01-13T02:34:51.000Z (almost 6 years ago)
• Last Synced: 2025-07-13T01:38:23.871Z (6 months ago)
• Homepage: https://code.dumpstack.io/tools/donate
• Size: 86.9 KB
• Stars: 0
• Watchers: 1
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
[![Donate](https://img.shields.io/badge/donate-paypal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=R8W2UQPZ5X5JE&source=url)

[![Donate](https://img.shields.io/badge/donate-bitcoin-green.svg)](https://blockchair.com/bitcoin/address/bc1q23fyuq7kmngrgqgp6yq9hk8a5q460f39m8nv87)

# 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:

0. (optional) The owner of the repository does setting up a donation daemon.

1. The owner of the repository adds [GitHub action](.github/workflows/donate.yml) (it's the easiest way to work with GitHub).

2. Someone opens an issue, then GitHub action shows cryptocurrency addresses (and updates from time to time).

3. 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).

4. GitHub Action triggers payout on donation daemon.

5. 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](https://nixos.org/nix/))

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

## Deploy

See [deploy/README.md](deploy/README.md).