refactor(ensapi): apply operation result pattern

[Copilot]

Lite PR

Summary

• Returning response from an route handler in ENSApi can be now streamlined with resultIntoHttpResponse function, that produces a HTTP Response object based on the provided operation result.
• Operation result pattern has been applied to responses returned by:
  • Generic response handlers (i.e. onError, notFound)
  • GET /amirealtime endpoint
    • See related AmIRealtimeResult result type
  • Registrar Actions API endpoints
    • See related RegistrarActionsResult result type
    • This API is one of "Explore APIs", which means we need to include the minIndexingCursor (as per Move accurateAsOf field into generic response data model / middleware #1512). We use AbstractResultOkTimestamped type to achieve that.
      • See related builder functions : buildResultOk and buildResultOkTimestamped
• Added type-safe way to define routes descriptions for a given API
  • See buildRouteResponsesDescription function
• Extended RESULT_CODE_SERVER_ERROR_CODES with ResultCodes.ServiceUnavailable
  • See related buildResultServiceUnavailable builder function and ResultServer type.

---

Why

• This change integrates the result pattern that was introduced to ENSNode SDK in order to standardize ENSNode response data model.
• "Explore APIs" are required to include minIndexingCursor field in their response data model to indicate to which point in time the response data is guaranteed to be up to.
• Documentation for a HTTP endpoint should include all possible HTTP response codes and their meaning.

---

Testing

• Ran all typechecks and testing suites.
• Tested /amirealtime and /api/registrar-actions endpoints locally, simulating conditions where both, ok and error results were returned from ENSApi.

---

Notes for Reviewer (Optional)

• This PR is a demonstration of a particular design for making Registrar Actions API to use the result pattern from ENSNode SDK. The implementation may change depending on the feedback.

---

Pre-Review Checklist (Blocking)

• This PR does not introduce significant changes and is low-risk to review quickly.
  • Note: This PR changes the output data model, but also the PR is meant to be a design artifact. The significant changes introduced in this PR will be documented on the top-level PR feat(ensnode-sdk): define a generic Result type #1539 before PR 1539 is ready for review.
• Relevant changesets are included (or are not required)
  • Note: changesets will be added within the top level PR feat(ensnode-sdk): define a generic Result type #1539 .

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 50e5f6b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

3 Skipped Deployments

Project	Deployment	Review	Updated (UTC)
admin.ensnode.io	Skipped		Jan 19, 2026 9:29am
ensnode.io	Skipped		Jan 19, 2026 9:29am
ensrainbow.io	Skipped		Jan 19, 2026 9:29am

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch copilot/sub-pr-1545

---

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