Add projected prize pool balance and share price for real-time frontend display

[bboud2]

Problem

The frontend reports stale prize pool and share price values. These are derived from cached variables (, ) that only update when syncWithYieldSource() runs — which happens on deposits/withdrawals, admin-triggered syncs, or startDraw(). Between syncs, the yield source keeps accruing value but the displayed numbers don't change.

Solution

Two read-only view functions that query the yield source live and project what sync would do — no state mutation, no new storage, no entitlements. Minimal audit blast radius.

getProjectedPrizePoolBalance()

• Excess yield: runs calculateDistribution() on the unsync'd difference, adds the prize portion to allocatedPrizeYield
• Deficit: applies the waterfall (protocol fee → prize → rewards), reduces projected prize by only the prize-portion of the deficit
• Below threshold: returns current synced value

getProjectedSharePrice()

• Excess yield: adds the rewards portion (after virtual-share dust) to totalAssets, computes projected price with virtual offset
• Deficit: subtracts only the rewards-portion of the deficit (after protocol/prize absorb first)
• Below threshold: returns current getSharePrice()

Refactor

getProjectedUserBalance() now delegates to getProjectedSharePrice() instead of duplicating the projection math. Behavior identical — verified by all existing ProjectedBalance_test.cdc tests passing unchanged.

Files Changed

File	Change
cadence/contracts/PrizeLinkedAccounts.cdc	+2 Pool view functions, +2 contract-level wrappers, refactored getProjectedUserBalance
cadence/scripts/prize-linked-accounts/get_projected_prize_pool_balance.cdc	Production query script
cadence/scripts/prize-linked-accounts/get_projected_share_price.cdc	Production query script
cadence/scripts/test/get_projected_prize_pool_balance.cdc	Test query script
cadence/scripts/test/get_projected_share_price.cdc	Test query script
cadence/tests/test_helpers.cdc	+2 test helper wrappers
cadence/tests/ProjectedPrizePoolAndSharePrice_test.cdc	11 new tests

Test Results

New tests (11/11 pass):

• Projected equals synced when no unsync'd yield (both functions)
• Projected reflects unsync'd yield (both functions)
• Projected reflects deficit (both functions)
• Deficit absorbed by protocol fee doesn't affect prize pool / share price
• Below-threshold returns synced values
• Projected user balance still correct after refactor
• Projected prize pool with direct funding

Existing tests: All ProjectedBalance_test.cdc tests (7/7) pass — refactor is safe. Full suite passes (one pre-existing flaky randomness test in TWABAdversarialDeposit_test.cdc is unrelated and passes in isolation).

Frontend Migration

Current (stale)	Replacement (real-time)
get_pool_stats.cdc → prizePoolBalance	get_projected_prize_pool_balance.cdc → projectedPrizePoolBalance
get_pool_stats.cdc → sharePrice	get_projected_share_price.cdc → projectedSharePrice
get_pool_balance.cdc → totalBalance	get_projected_balance.cdc → projectedBalance (already existed)

Both scripts return the projected and synced values so the frontend can compare or transition gradually.