Reward users for holding specific tokens over time.

This system allows you to allocate points to users based on the amount of tokens they hold and the duration of holding. It’s designed to incentivize long-term token holding and engagement.

Points are calculated continuously based on token balances. Any changes in configuration will affect point accrual from that moment forward.

​
How It Works

  1. The system tracks token transfer events for specified token contracts.
  2. User balances are updated based on these transfer events.
  3. Points are calculated daily for each user based on their token balance and the configured points per day.
  4. The calculation takes into account partial days, allowing for precise point allocation even for short holding periods.
  5. Points are aggregated over time, providing a cumulative reward for long-term token holders.

​
Configuration Fields

​
Usage Tips

  • Set appropriate start_timestamp and end_timestamp to align with specific campaigns or seasons.
  • Adjust points_per_day to balance rewards across different tokens or to emphasize certain holdings.
  • Ensure token_decimals is set correctly to accurately calculate token balances.
  • Use is_active to temporarily pause point accrual without deleting the configuration.

​
FAQ

Points are calculated based on the exact holding duration, including partial days. The system uses the precise timestamp of transfers to compute holding periods down to the second.

This configuration will reward users with 0.1 points per DAI token held per day on the Ethereum mainnet. The tracking period is not limited by start or end timestamps, meaning it will continue indefinitely until changed or deactivated.

For Blockchain EventsAchievements