Proposal 3487321221 on xGov platform
Pull request in the Crypto Ecosystems repository
The Rewards Suite marks the ASA Stats team’s most significant milestone so far in transitioning to a fully open-sourced 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 blockchain community.
While blockchain ecosystems excel at automating rewards for tangible activities like staking and yield farming, qualitative contributions—such as bug reports, feature requests, ecosystem research, social promotion, and community support—often remain underserved. These efforts are vital for project growth, yet they are frequently handled through manual, subjective processes like giveaways or lotteries. Such ad-hoc methods introduce operational overhead, breed perceived favoritism, and can erode community confidence.
The Rewards Suite bridges this gap by providing a unified, auditable workflow that connects community engagement directly to development tooling and on-chain reward distribution. By integrating a project’s active social media channels (Discord, X, Reddit, and Telegram) with industry-standard issue trackers (GitHub, GitLab, and Bitbucket), the platform ensures every contribution is tracked from suggestion to payout. This infrastructure turns community energy into verifiable project growth by creating a transparent link between a specific contribution and its on-chain reward.
How It Works
The platform automates the journey from a community suggestion to a verified payout:
- Suggestion Capture: Community members suggest contributions by mentioning a bot or username on supported social platforms. The engine’s trackers automatically capture these mentions and generate contribution candidates in the system.
- Review and Validation: Administrators review these auto-generated candidates via a dashboard. Approving a valid suggestion automatically triggers the creation of an issue in a linked tracker.
- Resolution and Allocation: Once the development team addresses the issue in GitHub, GitLab, or Bitbucket, the system allocates the reward on-chain.
- Claiming: Contributors authenticate via wallet connection (supporting Pera, Defly, and Lute) to claim their earned rewards directly from the smart contract.
Why It Is Useful
The Rewards Suite is a production-ready, turnkey solution that demonstrates immediate practical utility rather than experimental or speculative concepts. It is designed as a reusable “public good” that any organization can deploy to manage its own merit-based incentive programs.
The project’s utility is reinforced by high engineering standards and real-world validation:
- Reference Implementation: The suite is already the functional layer for the ASA Stats project at https://rewards.asastats.com, where it has successfully recorded over 1,450 contributions across 43 reward cycles.
- Uncompromising Code Quality: Security and reliability are guaranteed by 100% unit test coverage across the backend, frontend, and smart contract code, all of which are enforced via strict GitHub CI/CD workflows.
- Ease of Adoption: The project includes Ansible-based provisioning scripts validated via the Molecule testing platform, allowing any project to easily deploy and self-host its own secure instance on a private server.
- Automated Transparency: The website features a dedicated section that generates transparency reports directly from smart contract allocation data, providing a verifiable public audit for all distributed rewards.
Engineering Standards & Technical Architecture
The Rewards Suite is engineered as a turnkey CI/CD infrastructure designed for high reliability and ease of deployment. Instead of a basic prototype, the project ships with a production-grade codebase validated by a massive suite of automated tests:
- Backend & Frontend Rigor: The Python (Django) backend includes 2,200 unit tests, achieving 100% code coverage, while the frontend (TypeScript/JavaScript) features 235 unit tests, also maintaining 100% coverage.
- Blockchain Reliability: Security is reinforced with 145 smart contract unit tests and 20 comprehensive blockchain integration tests that run on every commit.
- Wallet Integration: The project features an industry-standard integration with TxnLab’s Use-Wallet library. This implementation utilizes a Python (Django) backend with a frontend leveraging vanilla JavaScript, facilitated through a Vite server. As a first-of-its-kind proof-of-concept, this architecture is ready to be forked and implemented by other developers seeking a robust Django-to-Vite integration.
- Social Listening Dashboard: The root page of the application serves a dual purpose as a Social Listening dashboard, providing real-time visibility into community engagement and contribution metrics.
- DevOps & Provisioning: Deployment is handled via Ansible-based provisioning scripts. These scripts are thoroughly validated using the Molecule testing platform to ensure successful CI/CD flows and reliable provisioning on any user’s private infrastructure.
- Framework Alignment: An ansible-lint GitHub action is integrated into the workflow to ensure all provisioning code remains in sync with Red Hat’s long-term standards for the framework.
This combination of 100% test coverage and automated deployment tools ensures that the Rewards Suite provides a secure, auditable, and easily maintainable foundation for any project in the ecosystem.
About the Team
Ivica Paleka – Founder & Lead Developer
Ivica is the architect of the ASA Stats project and a lead developer with over 25 years of experience building high-reliability software. A specialist in Python and Django, he has successfully delivered numerous production-grade applications, including the Hopemeet match engine and the Algorand provisioning repository. For the Rewards Suite, Ivica oversees the overall system architecture, smart contract development, and infrastructure setup. His commitment to Test-Driven Development (TDD) and CI/CD is the driving force behind the project’s 100% unit test coverage.,
Eduard Ravnic – Full-Stack & Mobile Developer
Eduard is a technical expert specializing in multi-platform development using Laravel, Vue.js, and React Native. In addition to managing the ASA Stats mobile application and community support, he is a co-author of the comprehensive Rewards Suite technical documentation. His background includes designing microservices and building cross-platform tools, bringing a versatile full-stack perspective to the Rewards Suite frontend and user interface.
David Farrior – Rewards System Administrator
David is a co-creator of the ASA Stats rewards infrastructure and has served as its primary administrator for the past three years. He possesses deep operational knowledge of the “Suggestion → Issue → Reward” workflow and has been instrumental in managing the engagement of the project’s 174 unique contributors.
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.
Metrics
The software is currently validated through a live reference deployment with the following performance metrics:
- Total reward cycles: 43
- Unique contributors: 185
- Total contributions processed: 1,472
- Total rewards distributed: 67M ASASTATS