Add unit tests for SimpleCache in src/utils/cache.ts

[meshackyaro]

Description

SimpleCache<K, V> (src/utils/cache.ts) implements TTL expiry (set/get/delete/clear/size, with per-entry and default TTLs), but has no test file exercising it — none of tests/utils.test.ts or any other test file references SimpleCache or utils/cache. Its expiry logic (Date.now() > entry.expiresAt, lazily evicting on get) is exactly the kind of time-dependent code that's easy to get subtly wrong (off-by-one on the boundary, forgetting to delete on expiry) without a test using fake timers.

Component

SDK

Difficulty

🟢 Easy

Tasks

• Add tests/cache.test.ts covering set/get round-trip, delete, clear, size
• Use Jest fake timers to test TTL expiry (both the default TTL and a per-call override) and confirm an expired entry is evicted from the underlying Map on get
• This can be done independently of the decision in the companion "wire up or remove SimpleCache" issue — tests are useful either way until that's resolved

Acceptance Criteria

• tests/cache.test.ts exists and covers expiry behavior with fake timers

Estimated Time

<1 day

[Emelie-Dev]

@Emelie-Dev has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi, I would love to work on this issue.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Emelie-Dev to this issue.

[Joyful12-tech]

@Joyful12-tech has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer! I’d like to work on this issue and deliver quality work following the requirements. Please assign it to me. Thank you!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Joyful12-tech to this issue.

[lawrencias-design]

@lawrencias-design has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Please, assign me this issue. Thank you.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @lawrencias-design to this issue.

[girly-coder01]

@girly-coder01 has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

As a full-stack blockchain developer, I have strong experience across both frontend and backend layers of Web3 applications.

I’m confident I can implement this properly and in line with the project’s standards. I’d be glad to own this task and submit a PR once we align on the approach.

Let me know your thoughts or if there are any specific requirements I should keep in mind.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @girly-coder01 to this issue.

[drips-wave]

Congratulations, @girly-coder01! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @girly-coder01: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@girly-coder01's PR #200 was approved and merged by @meshackyaro.

🏆 @girly-coder01: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (35 total points). Track your full progress on GrantFox.

👏 Great work, @girly-coder01! Keep contributing to trustflow-protocol.