Handle the 429 cooldown in the quickstart examples

[senid231]

Summary

Both quickstart examples called start_verification with no handling for
DidwwRateLimitedError, so hitting the destination cooldown (429,
destination_in_cooldown) crashed the script with an uncaught exception
instead of showing the documented recovery path.

Changes

Wrap the start_verification call in try/except DidwwRateLimitedError in
both examples/quickstart_sync.py and examples/quickstart_async.py, print
retry_after (falling back to a generic message when it is None), and
exit with status 1 — matching the existing DidwwValidationError handling
already below it in each file. The other examples (auth_modes.py,
polling.py, the callback examples) don't call start_verification, so
they needed no change.

Verification

ruff check ., ruff format --check ., mypy, pyright and pytest all
pass locally.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 35ad2d1e-4974-4e0d-9e4b-3d92039887ab

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Copilot]

Copilot review overview

🟢 Approval recommended

Both examples correctly handle the documented 429 cooldown path without affecting successful execution.

Review effort: Balanced
Findings: None

What changed in this PR

Adds graceful cooldown handling to both quickstart workflows.

Changes:

• Catch DidwwRateLimitedError during verification startup.
• Display retry guidance and exit with status 1.

File	Description
examples/​quickstart_sync.py	Handles cooldown errors in the synchronous example.
examples/​quickstart_async.py	Handles cooldown errors in the asynchronous example.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.