Skip to content

add records resolution#1974

Open
sevenzing wants to merge 19 commits into
mainfrom
ll/omnigraph-resolution-api
Open

add records resolution#1974
sevenzing wants to merge 19 commits into
mainfrom
ll/omnigraph-resolution-api

Conversation

@sevenzing
Copy link
Copy Markdown
Member

@sevenzing sevenzing commented Apr 21, 2026

Summary

  • Add Domain.records to Omnigraph for live ENS forward resolution (texts, addresses, contenthash, pubkey, ABI, interfaces, etc.), driven by the GraphQL field selection.
  • Add Account.primaryNames for ENSIP-19 multichain primary name resolution, with optional chainIds filtering.
  • Add example queries for the new fields

Why

Omnigraph previously exposed only indexed ENS state. Resolution is important thing for ENS developers so this PR adds resolution alongside that data so GraphQL clients can fetch live records and primary names in the same query shape as the rest of the API! It's cool, is it?


Testing

  • Unit tests: build-records-selection.test.ts (GraphQL selection → ResolverRecordsSelection), validate-primary-names-chain-ids.test.ts.
  • Integration tests: domain.integration.test.ts (Domain.records for address/text and all record types), account.integration.test.ts (Account.primaryNames per-chain, all chains, and invalid chain id rejection).
  • SDK example queries added for domain-records and account-primary-names.
  • Run ensnode against devnet and tested queries in ensadmin locally 👍

Notes for Reviewer (Optional)

  • Record types to resolve are inferred from the GraphQL selection set on Domain.records (e.g. records { texts(keys: [...]) addresses(coinTypes: [...]) })
  • Both resolution fields accept disableAcceleration; acceleration is gated by request context (canAccelerate). Since we want to enable acceleration by default decided to rename old accelecate param to disableAcceleration
  • Please @shrugs take a closer look at apps/ensapi/src/omnigraph-api/lib/build-records-selection.ts. This is my first dive into graphql query world, still not an expert in this.

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

@sevenzing sevenzing requested a review from a team as a code owner April 21, 2026 17:03
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 21, 2026

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

Project Deployment Actions Updated (UTC)
admin.ensnode.io Ready Ready Preview, Comment May 21, 2026 7:19pm
enskit-react-example.ensnode.io Ready Ready Preview, Comment May 21, 2026 7:19pm
ensnode.io Ready Ready Preview, Comment May 21, 2026 7:19pm
ensrainbow.io Ready Ready Preview, Comment May 21, 2026 7:19pm

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 21, 2026

🦋 Changeset detected

Latest commit: 8acc0b2

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 22 packages
Name Type
ensapi Patch
ensindexer Patch
ensadmin Patch
ensrainbow Patch
fallback-ensapi Patch
enssdk Patch
enscli Patch
enskit Patch
ensskills Patch
@ensnode/datasources Patch
@ensnode/ensrainbow-sdk Patch
@ensnode/ensdb-sdk Patch
@ensnode/ensnode-sdk Patch
@ensnode/integration-test-env Patch
@ensnode/ponder-sdk Patch
@ensnode/ponder-subgraph Patch
@ensnode/shared-configs Patch
@docs/ensnode Patch
@docs/ensrainbow Patch
@namehash/ens-referrals Patch
@namehash/namehash-ui Patch
@ensnode/ensindexer-perf-testing Patch

Not sure what this means? Click here to learn what changesets are.

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

@sevenzing sevenzing marked this pull request as draft April 21, 2026 17:03
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 21, 2026

Review Change Stack

Warning

Rate limit exceeded

@sevenzing has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 22 minutes and 7 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: f241a876-3a6d-406b-b46f-95226022b4ae

📥 Commits

Reviewing files that changed from the base of the PR and between b1232ab and 8acc0b2.

⛔ Files ignored due to path filters (2)
  • packages/enssdk/src/omnigraph/generated/introspection.ts is excluded by !**/generated/**
  • packages/enssdk/src/omnigraph/generated/schema.graphql is excluded by !**/generated/**
📒 Files selected for processing (4)
  • apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts
  • apps/ensapi/src/omnigraph-api/schema/account.ts
  • apps/ensapi/src/omnigraph-api/schema/scalars.ts
  • packages/enskit/src/react/omnigraph/_lib/cache-exchange.ts
📝 Walkthrough

Walkthrough

This PR adds two new ENS resolution fields to the Omnigraph API: Domain.records for forward ENS resolution and Account.primaryNames for ENSIP-19 multichain primary names. The implementation includes GraphQL schema types, selection parsing logic, context refactoring to support acceleration controls, integration tests, and supporting infrastructure updates.

Changes

Omnigraph Resolution API Integration

Layer / File(s) Summary
InterfaceId scalar and builder registration
apps/ensapi/src/omnigraph-api/schema/scalars.ts, apps/ensapi/src/omnigraph-api/builder.ts, packages/enssdk/src/omnigraph/graphql.ts
New InterfaceId GraphQL scalar with validation pipeline; registered in Pothos builder scalars and enssdk omnigraph type mappings.
Context factory and runtime middleware setup
apps/ensapi/src/omnigraph-api/context.ts, apps/ensapi/src/omnigraph-api/builder.ts, apps/ensapi/src/omnigraph-api/yoga.ts, apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts, apps/ensapi/src/omnigraph-api/lib/find-domains/find-domains-resolver.ts
Context refactored to factory pattern receiving server-context with canAccelerate flag; Yoga and handler updated to use factory and wire realtime/acceleration middlewares.
Resolved records GraphQL object refs
apps/ensapi/src/omnigraph-api/schema/resolution.ts
Seven GraphQL object types for resolution outputs: PrimaryNameByChain, ResolvedTextRecord, ResolvedAddressRecord, ResolvedPubkeyRecord, ResolvedAbiRecord, ResolvedInterfaceRecord, and ResolvedRecords aggregate with parametric list fields.
Records selection configuration and lookup
apps/ensapi/src/omnigraph-api/lib/resolution/records-selection-config.ts
Field metadata and lookup maps for simple (boolean) and parametric (argument-driven) selection keys; helpers to resolve field descriptors by name.
Records selection parsing from GraphQL info
apps/ensapi/src/omnigraph-api/lib/resolution/build-records-selection.ts, apps/ensapi/src/omnigraph-api/lib/resolution/build-records-selection.test.ts
Extracts ResolverRecordsSelection from GraphQLResolveInfo, merges field nodes, validates non-empty; comprehensive test coverage for all selection patterns.
Domain.records GraphQL resolver and field wiring
apps/ensapi/src/omnigraph-api/schema/domain.ts, apps/ensapi/src/omnigraph-api/schema.ts
Nullable Domain.records field returns resolved ENS records via resolveForward under runWithTrace; imports resolution schema into main schema module.
Domain.records integration tests
apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts
Tests for address/text record resolution by coin type and key; validates against devnet fixture values.
Account.primaryNames GraphQL resolver
apps/ensapi/src/omnigraph-api/schema/account.ts
Field resolves ENSIP-19 primary names with optional chainIds and disableAcceleration arguments; uses resolvePrimaryNames under tracing with acceleration controls.
Account.primaryNames integration tests
apps/ensapi/src/omnigraph-api/schema/account.integration.test.ts
Tests for single/multi-chain queries and GraphQL validation of empty/invalid chainIds.
Cache configuration, tooling, and changeset
packages/enskit/src/react/omnigraph/_lib/cache-exchange.ts, package.json, packages/integration-test-env/package.json, .changeset/omnigraph-resolution-api.md
Mark new types as embedded in graphcache; add seed:devnet scripts; document patch release.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related issues

  • Omnigraph: Integrate Resolution APIs #1802: This PR directly implements the Omnigraph resolution API proposed in the issue, adding Domain.records and Account.primaryNames fields with GraphQL-driven selection parsing, forward resolution, and multichain primary-name support.

Possibly related PRs

  • namehash/ensnode#2163: Both update cache-exchange to mark newly introduced omnigraph entity types (PrimaryNameByChain, ResolvedAbiRecord, ResolvedAddressRecord, etc.) as embedded/non-keyable.
  • namehash/ensnode#1867: Updates enskit omnigraph cache rules to treat the new resolved record types added in this PR as embedded entities.
  • namehash/ensnode#1994: Modifies Account.primaryNames integration test devnet fixtures to align with the new field behavior introduced in this PR.

Poem

🐰 Fresh records hop from ENS names so bright,
Addresses and texts in chains alight,
Parsing selections from GraphQL's sight,
With middleman acceleration in flight,
The API now resolves day and night!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 38.89% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'add records resolution' directly describes the main feature addition but is somewhat terse and could be more specific about the scope.
Description check ✅ Passed The description follows the template well with Summary, Why, Testing, Notes, and a completed Pre-Review Checklist covering all required sections comprehensively.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ll/omnigraph-resolution-api

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

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

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 21, 2026

Greptile Summary

This PR adds live ENS forward resolution to Omnigraph via Domain.records (texts, addresses, contenthash, pubkey, ABI, ERC-165 interfaces, etc.) and ENSIP-19 multichain primary name resolution via Account.primaryNames, with record types inferred from the GraphQL field selection at request time.

  • buildRecordsSelectionFromResolveInfo translates the client's records { ... } sub-selection into a flat ResolverRecordsSelection that drives resolveForward; canAccelerate is wired from a new middleware into the Yoga context so acceleration can be toggled per-request.
  • New Pothos object types (ResolvedRecords, PrimaryNameByChain, and sub-record types) and the InterfaceId scalar are registered; the introspection snapshot and generated schema are updated to match.

Confidence Score: 4/5

Safe to merge with the aliased parametric field overwrite addressed; all other new paths are well-tested and the context/middleware wiring is correct.

The alias-overwrite issue in build-records-selection.ts is a real data correctness bug: when a client queries the same parametric field twice via GraphQL aliases, the second call to applyToRecordsSelection overwrites the first, only one set of records is fetched, and the losing alias silently returns null. Everything else — the new Pothos types, the scalar, the context refactor, the middleware wiring, and the primary names resolver — looks solid.

apps/ensapi/src/omnigraph-api/lib/resolution/build-records-selection.ts — the parametric field loop needs to merge (union/append) args when the same field appears more than once rather than blindly overwriting.

Important Files Changed

Filename Overview
apps/ensapi/src/omnigraph-api/lib/resolution/build-records-selection.ts Translates a GraphQL selection set into a ResolverRecordsSelection; has a correctness issue where aliased parametric fields (texts, addresses, abi, interfaces) overwrite each other's selection, silently returning null for earlier aliases.
apps/ensapi/src/omnigraph-api/lib/resolution/records-selection-config.ts Defines simple and parametric field configs mapping GraphQL fields to ResolverRecordsSelection keys; clean and well-structured.
apps/ensapi/src/omnigraph-api/schema/domain.ts Adds Domain.records resolver using canonicalName + buildRecordsSelectionFromResolveInfo + resolveForward; correctly gates on canonicalName being present.
apps/ensapi/src/omnigraph-api/schema/account.ts Adds Account.primaryNames resolver with ENSIP-19 multichain support; correctly converts Object.entries string keys to numbers via Number(chainId).
apps/ensapi/src/omnigraph-api/schema/resolution.ts New Pothos object types for ResolvedRecords, PrimaryNameByChain, and all sub-record types; field resolvers correctly delegate to pre-resolved result dictionary lookups.
apps/ensapi/src/omnigraph-api/context.ts Adds canAccelerate from middleware to the GraphQL context; clean refactor of context function to accept server context.
apps/ensapi/src/omnigraph-api/schema/scalars.ts Adds InterfaceId scalar with validation via isInterfaceId and lowercasing transform; well-implemented.
docker/envs/.env.docker.devnet Removes RPC_URL_1 (chain 1 mainnet RPC) from devnet env; correct since devnet uses chain 31337 (RPC_URL_31337 remains).

Sequence Diagram

sequenceDiagram
    participant Client
    participant YogaResolver as Domain.records Resolver
    participant BuildSelection as buildRecordsSelectionFromResolveInfo
    participant ResolveForward as resolveForward
    participant ResolvedRecordsFields as ResolvedRecords Fields

    Client->>YogaResolver: "query { domain { records { texts(keys:[...]) addresses(coinTypes:[...]) } } }"
    YogaResolver->>YogaResolver: check domain.canonicalName (null → return null)
    YogaResolver->>BuildSelection: info (fieldNodes + variableValues)
    BuildSelection->>BuildSelection: collectFieldNodes (expand fragments)
    BuildSelection->>BuildSelection: applyToRecordsSelection per parametric field
    BuildSelection-->>YogaResolver: "ResolverRecordsSelection { texts:[...], addresses:[...] }"
    YogaResolver->>ResolveForward: "name, selection, { accelerate, canAccelerate }"
    ResolveForward-->>YogaResolver: ResolverRecordsResponseBase
    YogaResolver-->>ResolvedRecordsFields: Partial ResolverRecordsResponseBase
    ResolvedRecordsFields-->>Client: "{ texts:[{key,value}], addresses:[{coinType,address}] }"
Loading

Reviews (7): Last reviewed commit: "Merge branch 'main' into ll/omnigraph-re..." | Re-trigger Greptile

Comment thread apps/ensapi/src/omnigraph-api/schema/domain.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/resolution.ts Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/ensapi/src/omnigraph-api/schema/domain.ts`:
- Around line 224-249: Domain.records currently lacks an accelerate arg and
always calls resolveForward with accelerate: false; add a GraphQL arg
"accelerate" to the Domain.records field (the field defined at records: t.field)
and forward its value along with context.canAccelerate into resolveForward
(i.e., call resolveForward(name, {...}, { accelerate: args.accelerate,
canAccelerate: context.canAccelerate })). Also wire up the acceleration
middleware chain to the omnigraph-api router by applying
makeIsRealtimeMiddleware, indexingStatusMiddleware and canAccelerateMiddleware
(same order used in resolution-api) and update the omnigraph-api context factory
to accept the initial context param that contains canAccelerate from the
middleware so context.canAccelerate is available in the resolver; keep
getDomainInterpretedName usage unchanged.

In `@apps/ensapi/src/omnigraph-api/schema/resolution.ts`:
- Around line 16-18: Update the description string for the texts field in
resolution.ts to fix the malformed example; locate the texts: t.stringList({ ...
}) declaration and replace the example snippet "Text record keys to resolve
(e.g. `avatar`, `description`, `com.)." with a correctly punctuated example such
as "Text record keys to resolve (e.g. `avatar`, `description`, `com`)." ensuring
matching backticks and proper parentheses/period placement.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 909769d3-67ea-4cf4-873d-e0d220e4bdd9

📥 Commits

Reviewing files that changed from the base of the PR and between d9ab6b0 and eae25f6.

⛔ Files ignored due to path filters (1)
  • packages/enssdk/src/omnigraph/generated/schema.graphql is excluded by !**/generated/**
📒 Files selected for processing (4)
  • apps/ensapi/src/omnigraph-api/schema.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.ts
  • apps/ensapi/src/omnigraph-api/schema/resolution.ts

Comment thread apps/ensapi/src/omnigraph-api/schema/domain.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/resolution.ts Outdated
Copy link
Copy Markdown
Member

@shrugs shrugs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So i mentioned this in the original issue, which is that i'm not sure we want to allow people to query the trace and other meta information, like whether it was accelerated or not via the graphql api because i'm not convinced the ergonomics of it makes sense. but if you find a format that feels good, we can totally do so. For example, we could make the signature

query GetRecords {
  domain(by: { name: "eth" }) {
    resolve([accelerate: True]) {
      records { # equivalent to a ResolverRecordsSelection
        name
        texts(keys: ["description"]) { key value }
        addresses(coinType: [60]) { coinType address }
      }
      acceleration { requested attempted }
      trace
    }
  }
}

query GetPrimaryNames {
  account(by: { address: "0xabcd" }) {
    resolve(accelerate: False) {
      primaryNames(coinTypes: [60]) { coinType name }
      acceleration { requested attempted }
      trace
    }
  }
}

then that feels good; let's do that! then the pattern is clear; Domain.resolve.records and Account.resolve.primaryNames — feels good to me!


Note that within enskit, we need to update the cache client to mark these fields as EMBEDDED_DATA because they don't have a global key. Also, feel free to update the example app to render these records. So maybe add a new component that fetches a name's records by Domain.id or (name from the params, whatever) and then plug it into the name page.


Overall, this is definitely the correct direction and the data loader usage is correct. Let's move that helper into its own library.


to access the pothos context type, let's

  1. define a type Context = ReturnType<typeof createContext> in apps/ensapi/src/omnigraph-api/context.ts
  2. use that everywhere we currently use context: ReturnType<typeof createContext>
  3. make sure the helper you extracted here uses said type as well.

no need to alias it to graphqlContext; within the omnigraph graphql server module, "context" is always the graphql context

Comment thread apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/domain.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/resolution.ts Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

♻️ Duplicate comments (1)
apps/ensapi/src/omnigraph-api/schema/domain.ts (1)

185-201: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Domain.records still ignores the acceleration contract.

Line 197 hardcodes accelerate: false, canAccelerate: false, so clients cannot use the documented default accelerated path (accelerate default true) and context capability is bypassed.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/ensapi/src/omnigraph-api/schema/domain.ts` around lines 185 - 201, The
Domain.records resolver currently hardcodes acceleration by calling
resolveForward(name, selection, { accelerate: false, canAccelerate: false }),
which prevents using the default accelerated path and ignores context
capabilities; update the resolve function in the records field to stop forcing
those flags — either omit the options so resolveForward uses its defaults
(allowing accelerate default true) or explicitly pass accelerate from args and
canAccelerate from the GraphQL context (e.g., use _args.accelerate ?? true and
_context.canAccelerate) when invoking resolveForward so acceleration behavior
respects client requests and context capability checks.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/ensapi/src/omnigraph-api/lib/build-records-selection.ts`:
- Around line 45-48: The code currently uses only the first
GraphQLResolveInfo.fieldNodes element (fieldNode) when building the selection
and thus drops merged selections; update the build logic in
build-records-selection (where fieldNode is referenced) to merge all
info.fieldNodes by iterating over info.fieldNodes, collecting each
node.selectionSet?.selections and concatenating them into a single combined
selection array (or combined selectionSet), then use that combined selectionSet
for further processing; if no selection sets are present across all nodes, still
throw the existing GraphQLError with EMPTY_RECORDS_SELECTION_MESSAGE.

In `@apps/ensapi/src/omnigraph-api/schema/account.ts`:
- Around line 75-95: The Account.primaryNames field currently accepts chainIds
and forces acceleration off; change its args to match the contract (accept
optional accelerate?: boolean and coinTypes?: ["CoinType"] or appropriate type)
and stop hard-disabling acceleration: call resolvePrimaryNames(account.id,
/*pass coinTypes or equivalent*/ coinTypes ?? undefined, { accelerate:
accelerate ?? context.canAccelerate, canAccelerate: context.canAccelerate })
instead of {accelerate:false, canAccelerate:false}; keep input validation
(replace or adapt validatePrimaryNamesChainIds to validate the new
coinTypes/args if necessary) and ensure runWithTrace still wraps the
resolvePrimaryNames call.

---

Duplicate comments:
In `@apps/ensapi/src/omnigraph-api/schema/domain.ts`:
- Around line 185-201: The Domain.records resolver currently hardcodes
acceleration by calling resolveForward(name, selection, { accelerate: false,
canAccelerate: false }), which prevents using the default accelerated path and
ignores context capabilities; update the resolve function in the records field
to stop forcing those flags — either omit the options so resolveForward uses its
defaults (allowing accelerate default true) or explicitly pass accelerate from
args and canAccelerate from the GraphQL context (e.g., use _args.accelerate ??
true and _context.canAccelerate) when invoking resolveForward so acceleration
behavior respects client requests and context capability checks.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: df655b88-c1d7-4207-b684-04d8bbcb87a2

📥 Commits

Reviewing files that changed from the base of the PR and between eae25f6 and 713f1ee.

📒 Files selected for processing (13)
  • apps/ensapi/src/omnigraph-api/builder.ts
  • apps/ensapi/src/omnigraph-api/lib/build-records-selection.test.ts
  • apps/ensapi/src/omnigraph-api/lib/build-records-selection.ts
  • apps/ensapi/src/omnigraph-api/lib/records-selection-config.ts
  • apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.test.ts
  • apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.ts
  • apps/ensapi/src/omnigraph-api/schema.ts
  • apps/ensapi/src/omnigraph-api/schema/account.integration.test.ts
  • apps/ensapi/src/omnigraph-api/schema/account.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.ts
  • apps/ensapi/src/omnigraph-api/schema/resolution.ts
  • apps/ensapi/src/omnigraph-api/schema/scalars.ts

Comment thread apps/ensapi/src/omnigraph-api/lib/build-records-selection.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/account.ts
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)
apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts (1)

551-601: 🛠️ Refactor suggestion | 🟠 Major | ⚡ Quick win

Prefer await expect(request(...)).resolves.toMatchObject(...) in these async assertions.

Please switch the two updated test cases to the preferred resolves style for consistency.

As per coding guidelines, Prefer the await expect(...).resolves.* format over await-then-expect for async assertions.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts` around lines
551 - 601, Update the two async tests ("resolves address and text records for
example.eth" and "resolves every supported record type for test.eth") to use the
await expect(...).resolves.toMatchObject(...) pattern instead of awaiting the
request and then calling expect on the result; specifically, call
request<DomainRecordsResult>(DomainRecords, {...}) and
request<DomainAllRecordsResult>(DomainRecordsAll, {...}) inside expect(...) and
append .resolves.toMatchObject(...) so the assertions are written as await
expect(request(...)).resolves.toMatchObject(...).
apps/ensapi/src/omnigraph-api/schema/resolution.ts (1)

196-246: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Parametric record resolvers should enforce argument-scoped output.

interfaces(ids), texts(keys), and addresses(coinTypes) ignore their args and return all entries in r.interfaces/r.texts/r.addresses. That breaks field-level scoping for these parametric fields and can leak supersets when selections are merged.

Proposed fix
       interfaces: t.field({
@@
-        resolve: (r) =>
-          r.interfaces
-            ? Object.entries(r.interfaces).map(([interfaceId, implementer]) => ({
-                interfaceId: interfaceId as InterfaceId,
-                implementer,
-              }))
-            : [],
+        resolve: (r, { ids }) =>
+          ids.map((interfaceId) => ({
+            interfaceId,
+            implementer: r.interfaces?.[interfaceId] ?? null,
+          })),
       }),
@@
       texts: t.field({
@@
-        resolve: (r) =>
-          r.texts ? Object.entries(r.texts).map(([key, value]) => ({ key, value })) : [],
+        resolve: (r, { keys }) =>
+          keys.map((key) => ({
+            key,
+            value: r.texts?.[key] ?? null,
+          })),
       }),
@@
       addresses: t.field({
@@
-        resolve: (r) =>
-          r.addresses
-            ? Object.entries(r.addresses).map(([coinType, address]) => ({
-                coinType: Number(coinType) as CoinType,
-                address,
-              }))
-            : [],
+        resolve: (r, { coinTypes }) =>
+          coinTypes.map((coinType) => ({
+            coinType,
+            address: r.addresses?.[coinType] ?? null,
+          })),
       }),
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/ensapi/src/omnigraph-api/schema/resolution.ts` around lines 196 - 246,
The resolvers for interfaces, texts, and addresses return all records from
r.interfaces/r.texts/r.addresses instead of restricting results to the requested
args; update the resolve functions for interfaces (field interfaces with arg
ids), texts (field texts with arg keys), and addresses (field addresses with arg
coinTypes) to iterate over the provided args (ids, keys, coinTypes) and for each
arg lookup the corresponding value in r.interfaces/r.texts/r.addresses,
returning only entries found (or an explicit null/omit if missing) and
preserving the declared return shape (InterfaceId, key/value, CoinType/address)
so the field output is scoped to the arguments.
apps/ensapi/src/omnigraph-api/lib/records-selection-config.ts (1)

45-78: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Parametric selection assignment is currently lossy (last-write-wins).

applyToRecordsSelection overwrites texts/addresses/interfaces/abi each time. If the same parametric field appears multiple times (aliases/fragments), earlier requested values are dropped.

Proposed fix
   {
@@
     applyToRecordsSelection: (recordsSelection, args) => {
-      recordsSelection.texts = args.keys as string[];
+      const next = args.keys as string[];
+      recordsSelection.texts = [...new Set([...(recordsSelection.texts ?? []), ...next])];
     },
   },
@@
     applyToRecordsSelection: (recordsSelection, args) => {
-      recordsSelection.addresses = args.coinTypes as CoinType[];
+      const next = args.coinTypes as CoinType[];
+      recordsSelection.addresses = [
+        ...new Set([...(recordsSelection.addresses ?? []), ...next]),
+      ];
     },
   },
@@
     applyToRecordsSelection: (recordsSelection, args) => {
-      recordsSelection.abi = args.contentTypeMask as ContentType;
+      const next = args.contentTypeMask as ContentType;
+      recordsSelection.abi = ((recordsSelection.abi ?? 0n) | next) as ContentType;
     },
   },
@@
     applyToRecordsSelection: (recordsSelection, args) => {
-      recordsSelection.interfaces = args.ids as InterfaceId[];
+      const next = args.ids as InterfaceId[];
+      recordsSelection.interfaces = [
+        ...new Set([...(recordsSelection.interfaces ?? []), ...next]),
+      ];
     },
   },
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/ensapi/src/omnigraph-api/lib/records-selection-config.ts` around lines
45 - 78, The current RECORDS_SELECTION_PARAMETRIC_FIELDS entries'
applyToRecordsSelection handlers overwrite recordsSelection.texts / .addresses /
.interfaces / .abi on each call, losing earlier values; change each handler to
merge into existing values instead of replacing: for texts/addresses/interfaces,
if recordsSelection.<field> is unset assign args value, otherwise append new
items and deduplicate (preserve existing entries) so repeated param occurrences
accumulate; for abi (contentTypeMask) combine masks using bitwise OR rather than
assignment; update the applyToRecordsSelection lambdas inside
RECORDS_SELECTION_PARAMETRIC_FIELDS to perform these merge/dedupe steps when
reading args.keys, args.coinTypes, args.ids and args.contentTypeMask.
♻️ Duplicate comments (1)
apps/ensapi/src/omnigraph-api/schema/domain.ts (1)

190-207: ⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Use accelerate (default true) instead of inverse disableAcceleration for this GraphQL field.

This inverts the contract described for Domain.records and makes the API less ergonomic/consistent with the issue objectives.

Proposed fix
       args: {
-        disableAcceleration: t.arg.boolean({
+        accelerate: t.arg.boolean({
           required: false,
-          defaultValue: false,
-          description: "When true, disables protocol acceleration feature.",
+          defaultValue: true,
+          description: "Whether to use protocol acceleration when available.",
         }),
       },
-      resolve: async (domain, { disableAcceleration }, context, info) => {
+      resolve: async (domain, { accelerate }, context, info) => {
@@
         const { result } = await runWithTrace(() =>
           resolveForward(name, recordsSelection, {
-            accelerate: !disableAcceleration,
+            accelerate,
             canAccelerate: context.canAccelerate,
           }),
         );
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@apps/ensapi/src/omnigraph-api/schema/domain.ts` around lines 190 - 207, The
GraphQL field currently accepts disableAcceleration and inverts it when calling
resolveForward, which is confusing; change the argument to accelerate:
t.arg.boolean({ required: false, defaultValue: true, description: "When true,
enables protocol acceleration feature." }) (replace the disableAcceleration arg
and its description) and in the resolve function use the incoming accelerate
value directly when calling resolveForward (i.e., pass accelerate instead of
!disableAcceleration), keeping context.canAccelerate unchanged and leaving
buildRecordsSelectionFromResolveInfo(info) and resolveForward intact.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts`:
- Line 15: Add a short explanatory comment above the
MAX_REALTIME_DISTANCE_TO_ACCELERATE constant describing that the 60-second
threshold defines the realtime window used to decide whether to accelerate
processing (e.g., to use realtime data vs. batched processing), and include the
rationale or source for the value (user-experience/latency target, backend
polling interval, or a linked issue/config) so future maintainers understand why
60 seconds was chosen; update the comment near the constant declaration
MAX_REALTIME_DISTANCE_TO_ACCELERATE: Duration = 60 with this brief
justification.

In `@apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.ts`:
- Around line 6-18: Update the JSDoc for validatePrimaryNamesChainIds to state
that this function only enforces non-empty arrays and that individual ChainId
values are validated by the GraphQL scalar (so invalid chain IDs like 0 are
rejected upstream), referencing the function name validatePrimaryNamesChainIds,
the ChainId scalar, and the EMPTY_CHAIN_IDS_MESSAGE/GraphQLError behavior to
make the division of responsibility explicit for future maintainers.

---

Outside diff comments:
In `@apps/ensapi/src/omnigraph-api/lib/records-selection-config.ts`:
- Around line 45-78: The current RECORDS_SELECTION_PARAMETRIC_FIELDS entries'
applyToRecordsSelection handlers overwrite recordsSelection.texts / .addresses /
.interfaces / .abi on each call, losing earlier values; change each handler to
merge into existing values instead of replacing: for texts/addresses/interfaces,
if recordsSelection.<field> is unset assign args value, otherwise append new
items and deduplicate (preserve existing entries) so repeated param occurrences
accumulate; for abi (contentTypeMask) combine masks using bitwise OR rather than
assignment; update the applyToRecordsSelection lambdas inside
RECORDS_SELECTION_PARAMETRIC_FIELDS to perform these merge/dedupe steps when
reading args.keys, args.coinTypes, args.ids and args.contentTypeMask.

In `@apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts`:
- Around line 551-601: Update the two async tests ("resolves address and text
records for example.eth" and "resolves every supported record type for
test.eth") to use the await expect(...).resolves.toMatchObject(...) pattern
instead of awaiting the request and then calling expect on the result;
specifically, call request<DomainRecordsResult>(DomainRecords, {...}) and
request<DomainAllRecordsResult>(DomainRecordsAll, {...}) inside expect(...) and
append .resolves.toMatchObject(...) so the assertions are written as await
expect(request(...)).resolves.toMatchObject(...).

In `@apps/ensapi/src/omnigraph-api/schema/resolution.ts`:
- Around line 196-246: The resolvers for interfaces, texts, and addresses return
all records from r.interfaces/r.texts/r.addresses instead of restricting results
to the requested args; update the resolve functions for interfaces (field
interfaces with arg ids), texts (field texts with arg keys), and addresses
(field addresses with arg coinTypes) to iterate over the provided args (ids,
keys, coinTypes) and for each arg lookup the corresponding value in
r.interfaces/r.texts/r.addresses, returning only entries found (or an explicit
null/omit if missing) and preserving the declared return shape (InterfaceId,
key/value, CoinType/address) so the field output is scoped to the arguments.

---

Duplicate comments:
In `@apps/ensapi/src/omnigraph-api/schema/domain.ts`:
- Around line 190-207: The GraphQL field currently accepts disableAcceleration
and inverts it when calling resolveForward, which is confusing; change the
argument to accelerate: t.arg.boolean({ required: false, defaultValue: true,
description: "When true, enables protocol acceleration feature." }) (replace the
disableAcceleration arg and its description) and in the resolve function use the
incoming accelerate value directly when calling resolveForward (i.e., pass
accelerate instead of !disableAcceleration), keeping context.canAccelerate
unchanged and leaving buildRecordsSelectionFromResolveInfo(info) and
resolveForward intact.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: e0c05acb-eec2-4985-9af4-2595aba12a18

📥 Commits

Reviewing files that changed from the base of the PR and between 713f1ee and e1e5680.

⛔ Files ignored due to path filters (2)
  • packages/enssdk/src/omnigraph/generated/introspection.ts is excluded by !**/generated/**
  • packages/enssdk/src/omnigraph/generated/schema.graphql is excluded by !**/generated/**
📒 Files selected for processing (17)
  • apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts
  • apps/ensapi/src/omnigraph-api/builder.ts
  • apps/ensapi/src/omnigraph-api/context.ts
  • apps/ensapi/src/omnigraph-api/lib/build-records-selection.test.ts
  • apps/ensapi/src/omnigraph-api/lib/build-records-selection.ts
  • apps/ensapi/src/omnigraph-api/lib/find-domains/find-domains-resolver.ts
  • apps/ensapi/src/omnigraph-api/lib/records-selection-config.ts
  • apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.test.ts
  • apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.ts
  • apps/ensapi/src/omnigraph-api/schema/account.integration.test.ts
  • apps/ensapi/src/omnigraph-api/schema/account.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.integration.test.ts
  • apps/ensapi/src/omnigraph-api/schema/domain.ts
  • apps/ensapi/src/omnigraph-api/schema/resolution.ts
  • apps/ensapi/src/omnigraph-api/schema/scalars.ts
  • apps/ensapi/src/omnigraph-api/yoga.ts
  • packages/enssdk/src/omnigraph/graphql.ts
💤 Files with no reviewable changes (3)
  • packages/enssdk/src/omnigraph/graphql.ts
  • apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.test.ts
  • apps/ensapi/src/omnigraph-api/schema/scalars.ts

Comment thread apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts
Comment thread apps/ensapi/src/omnigraph-api/lib/validate-primary-names-chain-ids.ts Outdated
@sevenzing
Copy link
Copy Markdown
Member Author

@greptile review

Comment thread apps/ensapi/src/handlers/api/omnigraph/omnigraph-api.ts
Copy link
Copy Markdown
Member

@shrugs shrugs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I still prefer accelerate: false (with defaultValue: true) but i can see either.

I also see the value in renaming the name record, since it's famously confusing. so i support reverseName but a part of me wants it to be 1:1 with the protocol anyway.

need to mark these new entities as EMBEDDED_DATA in cache-exchange.ts since they don't have a cacheable unique id. actually i think we need to add all of those new fields, yikes. so PrimaryNameByChain, ResolvedTextRecord, ResolvedAddressRecord etc...

let's move all of these lib files into an omnigraph-api/lib/resolution/ sub folder


great work on the graphql info parsing! i figured that would be the gnarliest of the steps for this; i trust the tests for this but the implementation looks functional to me as well

Comment thread apps/ensapi/src/omnigraph-api/schema/account.integration.test.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/account.integration.test.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/account.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/account.ts
Comment thread apps/ensapi/src/omnigraph-api/schema/domain.ts
Comment thread apps/ensapi/src/omnigraph-api/schema/resolution.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/schema/scalars.ts Outdated
Comment thread apps/ensapi/src/omnigraph-api/yoga.ts Outdated
Comment thread packages/integration-test-env/src/seed-cli.ts Outdated
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 21, 2026 18:40 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io May 21, 2026 18:40 Inactive
@vercel vercel Bot temporarily deployed to Preview – ensnode.io May 21, 2026 18:40 Inactive
Comment thread apps/ensapi/src/omnigraph-api/schema/account.ts
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants