smartcontractkit / smartcontractkit/documentation

[Enhancement]: Document EIP-55 checksum requirement for Atlas SVR solver_getSolverOperationResult query API

Open
#3,764 0 comments 0 reactions 1 assignee View on GitHub

@QingyangKong is already working on this.

Since May 11, 2026.

enhancement triage
Dominant language
MDX
Stars
526
Forks
478
Avg merge
1d 9h
Merged PRs (30d)
75

Description

What would you like us to improve?

The Atlas SVR searcher onboarding page documents a query API for tracing solver operation results:

In practice, addresses passed to this API (e.g. solverOperationFrom) must be in EIP-55 checksum format. If you pass an all-lowercase or otherwise non-checksummed address, the lookup will silently fail and the API returns:

"solver operation not found"

even when the solver operation was actually received and processed. This error is also the same one returned when the operation arrives too late, which makes it very confusing to debug — solvers can spend significant time investigating timing/auction issues that don't actually exist.

The docs should:

Add a callout in the Tracing Solver Operation Results section stating that all addresses must be EIP-55 checksummed, with a link to https://eips.ethereum.org/EIPS/eip-55.

Add a new bullet to Common Mistakes titled something like "Querying the API without an EIP-55 checksummed address" explaining that this produces a misleading "solver operation not found" response.

How important it is?

Medium-high importance for any team integrating with Atlas SVR as a searcher. The failure mode is silent and the error message points searchers in the wrong direction (toward auction timing or signature issues rather than address formatting), so this can cost meaningful integration time. The fix is a small documentation change with no code impact.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.