Ring Yield
Holders

The hold-time score

Each note counts its amount times the hours it stayed unspent in the week, times an age factor. The pot is shared in proportion to the scores.

Engraved hourglass with laurel and wheat

The rule

note score = amount × hours unspent this week × age factor
ring score = sum of its note scores
payout     = week's pot × ring score / sum of all ring scores

A spent note stops counting at its spend slot, and a new note starts at 1.0. Splitting a bag changes nothing, because the score is linear in the amount and each note keeps its own age.

Age factor

0 full weeks1.00×
1 full weeks1.25×
2 full weeks1.50×
3 full weeks1.75×
4 full weeks2.00×

1.0 for a new note, then +0.25 for each full week already held at the start of the week, up to 2.0.

Worked example

Hold RingBagHoursAgeScore
A1,0001682.00×336,000
B4,000841.00×336,000
C2,0001681.50×504,000

With a pot of 1 hSOL for the holders, A and B receive about 0.2857 hSOL each and C about 0.4286 hSOL. A held a quarter of B's bag and gets the same, because it held all week and for longer.

How it is measured

Note creation slots come from fetchTransactionSlots; spend slots come from the nullifier lookups the sync already makes (getShieldedTransactionsByNullifiers). The keeper syncs each enrolled hold Ring every hour.