Skip to content

Community Audited Donation Proofs

Notifications You must be signed in to change notification settings


Repository files navigation

Donations - Community Audited Donation Proofs

Agregate Leaderboards: USD ADA



We want to increase the credibility of published donations. This can be done in many ways, some fancy others simpler. The only bulletproof way is to make charities publish Cardano addresses so that SPOs can show that they actually sent money to that specific charity. Unfortunately this is a solution that is a very long way of. To have a standardized information pool about donations and at least enable some degree of trust and auditability in that, we created this repository.


You cannot merge on your own to this repository (even admins cannot), you need to submit a PR which will be reviewed by the CI and one member of the CardanoMDP github organization (see: Members List).


  1. Fork this repo
  2. In your fork:
    1. Create a folder named like your pool's Ticker
    2. Add your donation files image
    3. Create a donations.yml (see: example.donations.yml) If you are unfamiliar with Yaml check out this 5 minute tutorial
    4. Submit a pull request.
  3. Once a pull request is created the members of the CardanoMDP github organization will be notified
    1. If you want a specific member of that list to review your submission you can select a specific reviewer in the top left corener of the pull request view. image
  4. Make suree the CI tests pass. If the middle check in your PR is red there are errors in your donations.yml that you need to fix image Click on details to see what check went wrong (typically either a file reference is incorrect or a required field is missing).

Data Structure

This repository is meant to represent a dedicated space to each SPO. The intended folder structure is as follows

    |- donations.yml (required)
    |- donation-proof-2020-12.jpg <- You will be referencing these images. You are free to name them as you like.
    |- donation-proof-2021-01.jpg
    |- donation-proof-2021-02.jpg
    |- Some_Folder <- you can also organize your extra files in folders, just don't forget to add the folder names to the paths in donations.json


For a documented example see example.donations.yml.

For a realworld example see the SPEC folder.

Validating Donations

If you have been given write permissions to CardanoMDP/Donations you can now aprove Pull Requests. To do this, please keep the following things in mind.

  • Check that the uploaded receipts identify the name of the operator or the pool
  • Check that the dates match (timezone issue might arise here)
  • Importantly Check the reported values that are being claimed

Some other things to keep in mind are:

  • Is this receipt unique? Ideally a receipt should have some sort of official tx id
  • Is the receiving party a real charity (they should have a website and ideally some sort of bank account info)
  • Is there a possibility the operator is paying themselves?

Formating checks:

  • Ensure that ada and usd values are dot denominated 42.1 is fine, 42,1 is not!

Keeping your repository up to date with the upstream repository (CardanoMDP/Donations)

When you submit a PR, if your submitted branch isn't up to date with the CardanoMDP/Donations repository we will not be able to merge your PR. Because of that you need to make sure that your forked repo is up to date with with ours.

Two ways of doing this:

  • Using the github page of your repository
  • Using git CLI
  1. Using the github page of your repository

    1. Go to the webpage of your repository (example:
    2. Press Fetch Upstream
    3. Press Fetch and merge image
  2. Using the git CLI

    1. Clone your fork and navigate to the root of your repository
    2. Add the upstream repository git remote add upstream git://
    3. Fetch upstream git fetch upstream
    4. Merge upstream main branch with your main branch git merge upstream/main main
    5. Push the up-to-date repository to your fork git push origin