Overview

The “Token Hold ERC-20” loyalty rule allows admins to reward users based on their ERC-20 holdings across supported blockchain networks. The rule enables the aggregation of token balances across multiple collections and defines a structured reward system based on holding requirements.

Rule Configuration Fields

Contract Address

  • Collection Contract Address: Enter one or more contract addresses representing the collections.

  • Network: Select the blockchain network where the contract is deployed.

  • Add New Collection: Allows adding multiple erc20 collections for token aggregation.

  • Important Note: Token holdings from different erc20 collections will be aggregated to determine total holdings when more than one collection is added.

Reward

  • Type of Reward: Choose between “Points” or “Multiplier”.

  • Points: Users will get the defined no of points based on their holdings.

  • Multiplier: Users will get the multiplier of the defined range based on their holdings.

  • Reward Per Token: Toggle on to reward users per token held.

  • Required Hold Tokens Range: Define a range of tokens that need to be held for eligibility.

  • Points to Reward: Define the number of points assigned for the specified holding range.

  • Add New Range: Allows defining multiple token holding ranges with corresponding rewards.

  • Only reward existing users: If enabled this will limit rewards to users already in the loyalty program instead of all eligible wallets.

Update Cadence

The Update Cadence field is crucial as it defines:

  1. Reward Frequency: Determines how often the user will receive rewards (e.g., Daily, Weekly, Monthly).

  2. Holding Verification: Specifies when the system will check the token holdings to determine eligibility.

  3. Relation to Start Time: The first verification of token holdings and reward distribution will begin at the defined Start Time. Subsequent verifications and rewards will follow the selected cadence (e.g., if the cadence is set to “Daily,” the system will check and reward holdings every 24 hours from the Start Time).

Custom Settings

  • Skip the multiplier for this rule

Call to Action (Optional)

This will show a call to action in our loyalty rule.

  • Link: Provide a URL for users to take further action.

  • Button Text: Define the button label.