Repository navigation
Implement rate-limit handling #11
Description
Description
When the API returns HTTP 429, the SDK should parse the Retry-After header (seconds) and either automatically wait and retry (if within max_retries) or raise RateLimitError with the wait time attached. The caller should never need to implement their own 429 backoff.
Proposed Steps
- In the response parser, detect HTTP 429 before raising a generic error.
- Parse
Retry-Afterheader (integer seconds) and attach it to theRateLimitError. - If auto-retry is enabled and
max_retriesis not exhausted, sleep forretry_afterseconds then retry. - In the async client, use
asyncio.sleepinstead oftime.sleep.
Acceptance Criteria
- A 429 response raises
RateLimitErrorwith aretry_afterattribute. - When retrying, the client waits at least
Retry-Afterseconds before the next attempt. - If
Retry-Afteris absent, the client falls back to exponential backoff. - Async client uses non-blocking sleep.
Activity
bukkybyte commentedon Jun 20, 2026
Allow me work on this and dwliver PR within 2 days
grantfox-oss commentedon Jun 21, 2026
🦊 GrantFox — @bukkybyte has been assigned to this issue as part of the Official Campaign campaign!
Next steps:
Closes #11)Good luck! Track your progress on GrantFox.
feat(http): implement rate-limit handling with auto-retry (ShadeProto…
feat(http): implement rate-limit handling with auto-retry (ShadeProto…
feat(http): implement rate-limit handling with auto-retry (ShadeProto…
feat(http): implement rate-limit handling with auto-retry (ShadeProto…
feat(http): implement rate-limit handling with auto-retry (#11)
Merge pull request #24 from bukkybyte/feature/11-rate-limit-handling
grantfox-oss commentedon Jun 24, 2026
🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!
@bukkybyte's PR #24 was approved and merged by @codebestia.
🏆 @bukkybyte: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (506 total points). Track your full progress on GrantFox.
👏 Great work, @bukkybyte! Keep contributing to ShadeProtocol.