web(env): add NEXT_PUBLIC_SOROBAN_RPC_HEADER environment variable support

[pragmaticAweds]

Summary

Cannot pass authentication headers to private RPC endpoints.

Where

apps/web/src/lib/env.ts:40-55

Why this is a real bug, not just lint noise

1. Affects user experience, functionality, or performance in production.
2. Needs to be addressed to ensure robustness across all supported devices and Stellar network states.

Fix

Support optional RPC headers via environment variable.

Acceptance criteria

• Issue is resolved in apps/web/src/lib/env.ts:40-55.
• No regression introduced in existing test suites.

[ZEMAD0N26]

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

Please assign!

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

[wenxiaojie1]

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

I reviewed the current env schema and confirmed that NEXT_PUBLIC_SOROBAN_RPC_URL is exposed but there is no corresponding way to configure authentication headers for a private RPC endpoint. I can add a validated optional public RPC-header setting, keep the default behavior unchanged when it is absent, and add focused tests covering configured and unconfigured environments so existing public RPC users do not regress.

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

[OluwapelumiElisha]

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

Hello,

I would like to work on this issue.

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

[drips-wave]

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

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

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @OluwapelumiElisha as part of the Stellar Wave Program's 7th Wave 🥳

Moderator's reason: [Auto-assessed] The contributor successfully implemented the requested NEXT_PUBLIC_SOROBAN_RPC_HEADER environment variable, including robust parsing for JSON, Key:Value, and raw token formats. The PR is high quality, featuring comprehensive unit tests for both the environment validation and the header parsing logic, and there has been no maintainer response across any of the four channels since the PR was opened.

😎 @OluwapelumiElisha: You earned 400 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.