Add built-in retry mechanism with exponential backoff for subgraph queries

[Lakes41]

Difficulty: Intermediate
Type: feature, resilience

Background

The SDK relies on The Graph (subgraphs) to fetch indexed on-chain data. Currently, if a query fails due to a temporary gateway timeout, the SDK instantly throws an error.

Problem

Network hiccups or subgraph syncing delays cause intermittent UI failures for downstream applications. Developers are forced to implement their own retry wrappers.

Expected outcome

The SDK's data-fetching module includes an automated retry mechanism utilizing exponential backoff to handle transient network errors gracefully.

Suggested implementation

1. Modify the internal fetch client to accept retries and retryDelay configuration parameters.
2. Implement a loop/recursion that captures 50x HTTP errors or network timeouts and retries the request.
3. Wait exponentially longer between subsequent retries (e.g., 500ms, 1s, 2s).

Acceptance criteria

• Failed queries automatically retry up to 3 times by default.
• 400 Bad Request errors are not retried.
• Unit tests mock network failures and verify the backoff timing.

Likely affected files/directories

• src/api/graphqlClient.ts

Requirements

• The retry logic must be configurable (allow developers to opt-out by setting retries to 0).

[addnad]

Hi mainaitaner, I have reviewed this issue and would love to work on it

[grantfox-oss]

🦊 GrantFox — @addnad has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #149)
2. Your PR will be reviewed by the Adamantine-guild maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@addnad's PR #160 was approved and merged by @Lakes41.

🏆 @addnad: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (83 total points). Track your full progress on GrantFox.

👏 Great work, @addnad! Keep contributing to Adamantine-guild.