Skip to content

Conversation

@vasyafromrussia
Copy link
Collaborator

@vasyafromrussia vasyafromrussia commented Sep 25, 2025

Tiered Score Based Jars & Boosters

1. Tiered Score Based Product

Tiered Score Based Product (previously Step Jars v3) utilizes a dynamic, activity-driven yield system without fixed guaranteed rates.

Difference from Regular Score Based Jars

  • Regular Score Based Jars: Calculate daily APY based on activity with a uniform maximum yield cap for all users.
  • Tiered Score Based Jars: The maximum yield cap (Tier) varies depending on the user's subscription status.

Mechanism

  • Activity to APY: Users' daily physical activity is converted into a Score, which is then converted into a daily APY percentage.
  • Capping Logic: There is no lower threshold to start earning; however, the Product has a strict Cap. If a user's Score corresponds to an APY higher than their tier's Cap (e.g., Score equals 30% but Cap is 20%), the effective yield is limited to the Cap (20%).

2. Boosters

Boosters are consumable items that add a fixed percentage to the daily APY calculation.

Behavior

  • Additive Yield: Boosters increase the calculated daily APY additively (e.g., Calculated APY + Booster %).
  • Global Limit: The jar enforces a global maximum total yield limit (e.g., 100%) for the combined total of the jar's yield and boosters.
  • Properties: Each booster has a specific percentage value and a duration in days.
  • Activation: Users activate boosters manually. The effect to the Score for the current calendar day.
  • Exclusivity: Only one booster can be active at a time. Users cannot swap or queue boosters while one is active.
  • Expiration: Boosters burn automatically on the final day, reverting the APY to the standard calculation.
  • Compatibility: Boosters apply only to Tiered Score Based Jars.

Boosters' properties are described off-chain, and their lifecycle is managed by Oracle that applies boosted Scores daily.

3. Subscription Logic

The user's subscription status determines the Cap applied to their daily yield in Tiered Score Based Jars.

Tiered Caps:

  • Free Tiers: The APY derived from activity is capped at a lower percentage (e.g., 10%).
  • Premium / Max Tiers: The APY derived from activity is capped at a higher percentage (e.g., 20%), allowing users to utilize a higher Score.

Cancellation

If a subscription is cancelled, the jar's Cap reverts to the lower (Free) tier limit on the end of the day when the subscription was canceled (managed by Oracle).

@vasyafromrussia vasyafromrussia force-pushed the feat/F-309-tiered-scores branch from 63a3cb0 to 84f4ef6 Compare October 10, 2025 17:17
@vasyafromrussia vasyafromrussia force-pushed the feat/F-309-tiered-scores branch from 8dc1b7b to 4c95c57 Compare October 13, 2025 17:22
@vasyafromrussia vasyafromrussia marked this pull request as ready for review October 13, 2025 18:46
@vasyafromrussia vasyafromrussia force-pushed the feat/F-309-tiered-scores branch from ae980b0 to 75e5f8e Compare October 20, 2025 12:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants