Implement Soroban Persistent Storage TTL Renewal and Expiry Tests

[grantfox-oss]

Package: packages/contracts

Complexity: High

Problem

Soroban persistent and instance storage entries have ledger time-to-live behavior. Long-lived market, stake, entitlement, admin, and configuration records can become unavailable if contracts do not apply a deliberate renewal policy. The repository has many contract crates, but no shared, tested TTL policy is documented for critical state.

Goal

Define and implement a consistent TTL renewal policy for critical BACKit contract state, with tests proving active and claimable records remain available for their required lifecycle.

Acceptance criteria

• Inventory instance, persistent, and temporary storage across the core call_registry, outcome_manager, prediction_market, and prediction_market_futures crates.
• Classify records by required retention window, including active markets, unresolved outcomes, unclaimed payouts/refunds, configuration, and terminal historical data.
• Add shared TTL thresholds and extension values with documented ledger/time assumptions; avoid unexplained magic numbers.
• Renew TTL on appropriate read/write lifecycle operations without allowing arbitrary callers to create unbounded storage growth.
• Ensure claimable payout/refund state remains live through its documented claim window.
• Define the behavior for already-expired or archived non-critical history instead of silently recreating incorrect state.
• Emit no misleading business event solely because TTL was renewed.
• Tests advance ledger sequence near and beyond thresholds and cover renewal, non-renewal, terminal state, and claim-window boundaries.
• Tests demonstrate one user's activity cannot indefinitely renew unrelated users' records.
• Document estimated rent/resource implications and the rationale for each retention class.
• Keep public contract behavior backward-compatible unless an unavoidable change is separately documented for maintainer approval.
• No frontend or backend changes are included.

Technical pointers

• packages/contracts/shared
• packages/contracts/call_registry/src/storage.rs
• packages/contracts/outcome_manager/src/storage.rs
• packages/contracts/prediction_market/src/storage.rs
• packages/contracts/prediction_market_futures/src/lib.rs

Out of scope

• An off-chain archival/indexing service
• Contract deployment or migration execution
• TTL work for every experimental contract crate

---

[Cybermaxi7]

Hi Maintainer, can i handle this?

[grantfox-oss]

🦊 GrantFox — @Cybermaxi7 has been assigned to this issue as part of the Third Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #568)
2. Your PR will be reviewed by the degenspot maintainers

Good luck! Track your progress on GrantFox.

[davieslennox0]

Let me help resolve this issue.
It's the best I can do

[davieslennox0]

Let me help resolve this issue, delivery is same day.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Third Campaign campaign!

@Cybermaxi7's PR #570 was approved and merged by @PeterOche.

🏆 @Cybermaxi7: You earned 40 FoxPoints for this contribution! Your current tier: Builder (1,745 total points). Track your full progress on GrantFox.

👏 Great work, @Cybermaxi7! Keep contributing to degenspot.