Repository navigation
Add shade.api_base override support #6
Description
Description
Teams running a self-hosted Shade backend or a staging environment at a custom URL need to override the default API base without changing the environment enum. shade.api_base should provide an escape hatch that takes precedence over the URL resolved from Environment.
Proposed Steps
- Add
api_base: Optional[str] = NonetoShadeClientandconfig.py. - In the HTTP client URL builder, prefer
api_basewhen set, otherwise fall back to theEnvironment-resolved URL. - Trim trailing slashes on the provided value.
- Document that this is intended for development/testing only.
Acceptance Criteria
shade.api_base = "https://staging.shadeprotocol.io"routes all requests to that host.ShadeClient(api_base="http://localhost:8000")routes that client's requests locally.- When
api_baseis set,Environmentstill controls the Stellar network passphrase. - Trailing slashes in the provided URL are normalized.
Activity
xx7412421-cloud commentedon Jun 21, 2026
I'd like to take this on if assignment is available. I can keep it scoped to the API base override, trailing-slash normalization, tests, and docs.
Tijesunimi004 commentedon Jun 25, 2026
I have experience with Open Source and would like to work on this issue
grantfox-oss commentedon Jun 25, 2026
🦊 GrantFox — @Tijesunimi004 has been assigned to this issue as part of the Official Campaign campaign!
Next steps:
Closes #6)Good luck! Track your progress on GrantFox.
grantfox-oss commentedon Jun 26, 2026
🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!
@Tijesunimi004's PR #29 was approved and merged by @codebestia.
🏆 @Tijesunimi004: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (258 total points). Track your full progress on GrantFox.
👏 Great work, @Tijesunimi004! Keep contributing to ShadeProtocol.