# The Rewards Suite by ASA Stats: All-in-one infrastructure for transparent contributor rewards

The Rewards Suite marks the ASA Stats team's most significant milestone to date in transitioning to a fully open-source codebase. This innovative solution is the culmination of a four-year journey of community governance and operational refinement within the ASA Stats ecosystem, evolving from an internal necessity into a production-grade infrastructure for the broader Algorand community.

The Rewards Suite is a fully open-source, production-grade infrastructure designed to automate rewards for qualitative community contributions, such as bug reports, feature requests, and social promotion. While blockchains excel at automating staking, rewarding community effort is often manual, subjective, and prone to overhead.

Our suite bridges this gap by connecting a project's active social media channels (Discord, X, Reddit, Telegram) with standard issue trackers (GitHub, GitLab, Bitbucket). This turns community energy into verifiable project growth by creating a transparent, auditable link between a specific contribution and its on-chain reward.

## HOW IT WORKS

1. **Suggestion:** Community members suggest contributions by mentioning a bot or username on social platforms.
2. **Validation:** Admins review suggestions. Valid ones automatically create an issue in a linked tracker.
3. **Allocation:** When developers resolve the issue, the system allocates the reward on-chain.
4. **Claiming:** Contributors connect their wallets (Pera, Defly, Lute) to claim earned rewards directly from the smart contract.

## WHY IT IS USEFUL

This is a production-ready, turnkey solution meant as a reusable public good for the Algorand ecosystem. It demonstrates immediate practical utility rather than experimental concepts. Automating the suggestion-to-reward cycle, it reduces administrative overhead for project leads by an estimated 50-70%, allowing teams to focus on core development.

It is already deployed as the functional layer for ASA Stats at rewards.asastats.com, with processed over 1,400 contributions across 43 reward cycles.

## ENGINEERING STANDARDS

The Rewards Suite is engineered as a turnkey CI/CD infrastructure designed for high reliability. Instead of a basic prototype, the project ships with a production-grade codebase.

- **Uncompromising Quality:** 100% unit test coverage across the Python (Django) backend (2,200 tests), JS/TS frontend (235 tests), and smart contracts (145 tests).
- **DevOps & Provisioning:** Includes Ansible-based provisioning scripts (validated via Molecule) to ensure reliable CI/CD flows and easy self-hosting on private servers.
- **Automated Transparency:** Features a dashboard that generates verifiable transparency reports directly from smart contract allocation data.
- **Wallet Integration:** Showcases an industry-standard integration with TxnLab's Use-Wallet library, facilitated through a pioneering Django-to-Vite architecture ready to be forked by other developers.

## **About the team**  
- **Ivica Paleka (Founder & Lead Developer):** Over 25 years of experience building high-reliability software. Architect of ASA Stats, specializing in Python/Django, TDD, and CI/CD.
- **Eduard Ravnic (Full-Stack & Mobile Developer):** Technical expert in multi-platform development, managing the ASA Stats mobile app and frontend UI.
- **David Farrior (Rewards System Administrator):** Co-creator and primary administrator of the ASA Stats rewards infrastructure for the past three years.

## **Additional Info**  
This proposal aligns with our core mission to transition the ASA Stats codebase to open-source, providing foundational tools for the broader Algorand ecosystem. By automating the "Suggestion → Issue → Reward" cycle, the suite reduces the administrative overhead for project leads by an estimated 50–70%, allowing teams to focus on core development.

The repository is highly customizable, supporting multiple social media providers and the three major issue tracking platforms (GitHub, GitLab, and Bitbucket). We intend to continue the development of this open-source project, adding features like liquid staking integration and additional social platform trackers based on user demand.

## **Adoption Metrics**
- Total reward cycles: 43
- Unique contributors: 185
- Total contributions processed: 1,472
- Total rewards distributed: 67M ASASTATS

Created By [PCXA...7IAE](https://xgov.algorand.co/profile/PCXATSSLZVWFV76HO3YK4FUKUKC5TAAVF5I3YTT5GPV2IZYIVHK5HQ7IAE)//3 months ago