For the complete documentation index, see llms.txt. This page is also available as Markdown.

πŸ€‘Service Bonus (Tree-Based) & Daily Limits

The legacy "Binary Matching Bonus" has evolved into the tree-based Service Bonus. This payout rewards members for building a deep and active referral network while providing liquidity to the proto

Why the Transition to Tree-Based?

  • While the legacy binary structure was effective for early growth, the V2 Service Bonus uses a more scalable tree-based model. This allows the protocol to reward activity across your entire referral network without the complexity of balancing "left" and "right" legs.

The Logic of the Service Bonus

  • Every member you invite becomes a branch in your referral tree. The Service Bonus considers the total gaming and liquidity volume generated by these members and their own invitees.

    • Automated Computation: Unlike direct rewards recorded atomically by Core, the Service Bonus is computed by the protocol’s backend service and updated in your Pass NFT via the SERVICE_ROLE.

    • Monotony Principle: Once a bonus is set in your Pass, it can only increase. The contract enforces a BonusCannotDecrease rule to protect your earned rewards.

    • Transparency: All tree-based volume remains verifiable on the Polygon blockchain through individual Pass records.

V1 Legacy Linear and Binary Tree

  • Refer to the image below to see how a linear tree translates into a binary tree.

The logic of linear tree to binary tree transcription according to default sorting logic
  • The binary tree and linear tree are always displayed on your affiliate page, where you can view them as either a table or a genealogy tree.

  • We recommend using the binary tree view when building your structure, as the linear tree view is primarily helpful for identifying who is actively inviting new members and who is not.

Matching Rewards

  • Matching occurs once per cycle, where each cycle lasts 24 hours.

  • During matching, the volume of the WEAK leg is DEDUCTED from the STRONG leg, and an 8% matching bonus is paid based on the volume of the weaker leg:

    • Matching bonus is 8% from the weak leg.

    • Volume includes 100% of all stakes and 1% of all bets within your binary tree.

    • Any remaining volume on the stronger leg carries over to future cycles with no time limit, meaning any volume you generate on your weaker leg will always yield an 8% reward.

  • The depth of users and who invited them is irrelevant; only the total volume of the left and right sides matters. Simple, right!

  • The matching bonus is added to your matching bonus claim balance in the affiliate section.

Matching Bonus Claim and Limits

  • The maximum possible claim is 10% of your total staking amount or 12,000,000 BET based on the combined value of your conservative and dynamic staking.

  • There is no time limit on how long the claim balance can wait for you to claim it.

  • The maximum claim does not accumulate,

    • so you cannot claim 100% of your staking value after 10 days of waiting;

    • each day’s claim is calculated independently.

    • We are considering an automated claim feature for members with over 100 million BET in staking.

V2 Matching Bonus Claim & Sustainability Limits

To ensure the long-term sustainability of the Affiliate Fund, Service Bonus claims are subject to a daily rate-limiting mechanism tied to your "skin in the game".

The Daily Claim Formula

You can call claimBonus() once per UTC day. The amount you can claim is the lower of two values:

  1. 10% of your current principal deposit in the Liquidity Pool.

  2. The global hard cap (default: USD 12,000).

Your LP Principal

10% of Staked

Global Hard Cap

Effective Daily Limit

0 BET

0

12,000

0 (Cannot claim)

50,000 BET

5,000

12,000

5,000 BET

120,000 BET

12,000

12,000

12,000 BET

500,000 BET

50,000

12,000

12,000 BET

Key Claim Rules

  • No Accumulation: The maximum daily claim does not accumulate. If you do not claim today, you cannot claim "double" tomorrow; each day’s limit is calculated independently based on your current stake.

  • Staking Requirement: If you have zero tokens deposited in the Liquidity Pool, your daily limit is zero. You must provide liquidity to the protocol to unlock tree-based rewards.

  • Payout Source: Rewards are transferred directly from the Affiliate Fund contract to your wallet.

Legacy Migration of Matching Bonuses

The protocol ensures that all matching volume earned in V1 remains claimable in V2.

  • Claim Subtraction: The V2 fund automatically reads your V1 claim history. If your total bonus is 100,000 BET and you already claimed 40,000 BET in the old system, V2 allows you to claim the remaining 60,000 BET under the new daily limit rules.

  • V1 Freeze: Claiming legacy matching bonuses in the V1 contract has been disabled (frozen) to prevent double-claiming across systems. All tree-based rewards must now be routed through the V2 interface.

Last updated