PairDrop is an experiment in retroactive public goods funding that directly empowers Ethereum users to allocate ecosystem funds.
Retroactive public goods funding is the concept of rewarding efforts that have already yielded a public benefit. This could address the problems associated with public goods funding, such as uncertainty of future outcomes and reporting/monitoring costs.
Putting this power into the hands of a diverse range of ecosystem participants can make it easier to target areas that are overlooked by centralized allocation bodies.
Below you will find instructions on how to fork PairDrop so you can use it to distribute funding in your community.
Video walkthrough: https://youtu.be/lHeeqnbutm0
The PairDrop codebase is structured into distinct directories for the client, server, and data management:
- Client: The frontend code, built with NextJS, TypeScript, and Tailwind CSS, is contained within the
clientdirectory. - Server: The backend operations, APIs, and server logic using Node.js and MongoDB are located in the
serverdirectory. - Data: Scripts and files for handling data processing are found within the
datadirectory.
For a detailed understanding of the codebase, including the roles and contents of specific files and folders, please refer to the Codebase & Folder Structure documentation.
This organization ensures a clear separation of concerns, simplifies navigation, and supports efficient development and maintenance.
Before diving into the setup and customization of your PairDrop client, ensure you have the following prerequisites installed:
- Node.js (LTS version)
- Yarn (for dependency management)
Follow the step-by-step guide in the Setup & Deployment documentation to get your PairDrop client up and running. This guide includes instructions on installation, configuration, and deployment.
To make the PairDrop client resonate with your community's identity, refer to the Customizing the UI documentation. It provides detailed instructions on how to use the provided configuration file to adjust the UI elements, including logos, color schemes, and text.
The process of adding projects for voting is streamlined through the use of the PairDrop Server's seeder functionality. Detailed guidance on importing project data into your PairDrop client can be found in Adding Projects.
To ensure a fair and transparent voting process, the PairDrop system utilizes a voters list based on specific criteria. Learn how to generate and import this list by following the steps in Generating the Voters List.
Engage your community in the voting process with PairDrop's intuitive interface. The Voting documentation explains everything voters need to know, from logging in to casting votes on project pairs.
After the voting period ends, results can be analyzed and shared with your community. The Results document describes how to access and interpret voting outcomes, ensuring transparency and accountability.
The PairDrop server plays a crucial role in managing data, processing votes, and calculating results. It includes functionalities for importing and exporting project and voter information, along with a comprehensive API for interactions. For detailed instructions on setting up and managing the server, refer to the Server documentation.
PairDrop's innovative approach to funding relies on a sophisticated data handling and normalization process to evaluate contributions across the Ethereum ecosystem. This system ensures that funding decisions are data-driven and equitable. To learn more about how PairDrop handles data, including sourcing, normalization, and integration, see the Data documentation.
PairDrop is released under MIT License. Feel free to fork, modify, and use it in your projects.
This project has received funding from Octant, a novel platform for experiments in participatory public goods funding. We are deeply grateful for the Octant community's support.
We are also grateful for the guidance and feedback provided to us by Daniel Kronovet , the lead author of the original BudgetBox paper.