Externalize and validate environment configuration in config/env with fail-fast checks

[thlpkee20-wq]

Description

src/config/env.ts centralizes environment configuration, but several modules read process.env directly (for example STELLAR_SERVER_SECRET in src/services/stellarSubmissionService.ts, API_VERSION_PREFIX and PORT in src/index.ts). Centralize all configuration access through a validated env schema that fails fast at startup when required secrets are missing, and document each variable.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review
• Relevant code: src/config/env.ts, src/services/stellarSubmissionService.ts, src/index.ts
• Missing required secrets must abort startup with a redacted, actionable error

Suggested execution

• Fork the repo and create a branch
• git checkout -b feat/env-config-fail-fast
• Implement changes
  • Define a Zod env schema in src/config/env.ts covering JWT, Stellar, DB, CORS vars
  • Replace direct process.env reads in submission service and index with the validated env
  • Add a documented table of required/optional variables
• Validate security and correctness assumptions

Test and commit

• Run tests
  • npm test
• Cover edge cases
  • Missing secret aborts, invalid URL rejected, defaults applied, secrets never logged
• Include test output and notes

Example commit message

feat: validate and centralize environment configuration

Guidelines

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours

[Eniola3321]

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

please can i work on the issue

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

[drips-wave]

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

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