A full-stack revenue share dApp for GNG token holders

Client
GNG
Services
Full-stack dApp development, smart contract development, backend development
Industry
Web3, DeFi, Community
GNG revenue share dApp cover image

Overview

A token depository and payout system built to support holder alignment.

GNG needed a full-stack decentralized application that could give token holders a clear way to deposit their tokens into a depository and participate in revenue share distribution rounds.

The system was designed around a simple idea. Holders could lock tokens into the depository, and when a revenue share round was created, eligible claim amounts were calculated based on the dividend fee per token and the amount each holder had deposited.

This created a more structured incentive layer for the community while supporting the project’s goal of reducing sell pressure by rewarding holders who kept their tokens deposited in the system.

Challenges

The payout logic needed to be transparent, controlled, and safe to claim.

The project needed more than a basic staking-style interface. The payout model was tied to actual profit distribution logic, not fixed interest, fixed yield, or APY mechanics. That meant the system had to support variable distribution rounds where each holder’s share could be calculated off-chain and claimed on-chain with proof.

The smart contract also needed to manage token deposits and withdrawals securely, track total deposits, prevent reentrancy, and make sure users could only claim the exact payout they were eligible for during an active round.

On the application side, users needed a clean dashboard to connect their wallet, view deposited balances, deposit or withdraw tokens, and claim their available share without needing to understand the underlying Merkle proof system.

Solutions

We built a full-stack dApp with token deposits, Merkle-based claims, and admin-controlled payout rounds.

The solution included a Solidity smart contract for the core token depository and payout logic, a React frontend for the user dashboard, Firebase for supporting data workflows, and JavaScript backend functionality for round preparation and claim data handling.

Users could deposit GNG tokens into the contract, withdraw available deposited tokens, and claim their calculated share when a distribution round was live. The contract used Merkle proof verification so each user could claim only the amount assigned to their wallet for that round.

Admin controls were added for setting claim roots, opening new distribution rounds, pausing claims, finalizing rounds, and recovering unclaimed funds after a round ended. The contract also emitted events for deposits, withdrawals, claim rounds, root updates, status changes, and successful holder claims.

The frontend turned the contract into a usable product experience, giving holders a direct interface for participating in the depository and claiming their share without manually interacting with the contract.

The payout flow was mapped around token deposits, active distribution rounds, holder share calculations, and claim verification.

A Solidity contract was built to manage deposits, withdrawals, round creation, Merkle root updates, claim status, and verified holder payouts.

Merkle proofs were used so holder claim amounts could be calculated off-chain while still being securely verified on-chain during each round.

A React interface was built so users could connect their wallet, view balances, deposit tokens, withdraw tokens, and claim available payouts.

Firebase and JavaScript backend logic supported the operational side of the application, including data handling for user-facing claim and distribution workflows.

Technologies I used

React

Solidity

Firebase

Tailwind CSS

JavaScript

Results

381K

The system distributed 77.23 ETH in holder payouts, estimated using Ethereum's all-time high price.

4,749

The platform processed thousands of successful transactions across deposits, withdrawals, and payout claims.

100%

Merkle-verified claims tied each payout to an approved wallet and exact claim amount, preventing unauthorized or duplicate claims.

Ready to make your move? Let's map your next project together over a free discovery call.