Add helper for converting ISO timestamp string to UTC Date object safely

[Chucks1093]

Summary

Several endpoints accept and return timestamp strings. Parsing these to Date objects is done inconsistently across the codebase. A shared helper that parses an ISO string and throws a typed error for invalid input should be used everywhere a timestamp is read from external data.

Scope

• Add parseISOTimestamp(value: string): Date helper
• Throws InvalidTimestamp error if the string is not a valid ISO 8601 date
• Returns a UTC Date object for valid input
• Add unit tests for: valid ISO string, invalid string, empty string, Unix timestamp string

Acceptance Criteria

• Valid ISO string returns correct UTC Date
• Invalid string throws InvalidTimestamp
• Empty string throws InvalidTimestamp
• Unix timestamp string throws InvalidTimestamp

ETA: 12 hours

---

Coordinate on Telegram

[aliyuHabibu]

@aliyuHabibu has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi please assign this issue to me. Thank you

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

[graceshaba93]

@graceshaba93 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainer, I can fix this issue.

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

[Okorie2000-code]

@Okorie2000-code has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi maintainer, can I work on this?

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

[chizzy192]

@chizzy192 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi please assign this issue to me. Thank you

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

[olaleyeolajide81-sketch]

@olaleyeolajide81-sketch has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would love to work on this issue

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

[drips-wave]

Congratulations, @chizzy192! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @chizzy192: 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 🌊