Implement JWT token refresh mechanism

[DeFiVC]

What

The API issues JWT tokens with a 24-hour expiry but lacks a refresh token mechanism, requiring users to re-authenticate when tokens expire.

Why

• 24-hour tokens force users to reconnect their wallet frequently
• No way to extend sessions without full re-authentication
• Poor user experience for active users

Scope

Implement refresh token flow:

1. Issue refresh token alongside access token
2. Add /auth/refresh endpoint
3. Frontend stores and uses refresh tokens

Acceptance Criteria

• Refresh token issued with access token (longer expiry, e.g., 7 days)
• POST /auth/refresh endpoint accepts refresh token and returns new access token
• Refresh tokens are single-use (rotation)
• Frontend handles token refresh automatically
• Expired access tokens are transparently refreshed

Technical Context

• API files: src/modules/auth/, src/config/index.ts
• Frontend files: src/lib/api/auth.ts (has refreshToken function), src/lib/api/client.ts
• Current: Only access token with 24h expiry
• Database: May need refresh_tokens table

[fj555]

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

Hey Maintainer, I would love to resolve this issue. kindly assign me. Thanks

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

[ahmedkabeer930-rgb]

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

Hi, I’ve carefully reviewed the issue details and understand the requirements. I’m confident I can deliver a clean, efficient solution that meets the acceptance criteria. Kindly consider assigning this task to me.

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

[badmusdare4]

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

Hi Team, allow me handle this issue. ETA 2 hours

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

[Tobi-8]

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

please maintainer , assign me to this issue. I have looked through your description, and i have had experience in this type of issue.
kindly assign

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

[nasirudeenbadirudeen87-cloud]

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

Hi Maintainer,i have reviewed the issue in detail. Full stack background with solid experience relevant to this task. No blockers on my end — I'm ready to submit a PR shortly. Please assign.

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

[starboytiimz]

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

🟢🟢🟢Hi maintainer can i be assigned this issue please?

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

[Cyber-Mitch]

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

i want to work on this issue, i will complete it as fast as possible

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

[drips-wave]

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

🧑‍💻 @Cyber-Mitch: 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!

@Cyber-Mitch's PR #454 was approved and merged by @DeFiVC.

🏆 @Cyber-Mitch: You earned 35 FoxPoints for this contribution! Your current tier: Builder (1,006 total points). Track your full progress on GrantFox.

👏 Great work, @Cyber-Mitch! Keep contributing to ChainLearnOfficial.