feat(ensapi): Registrar Actions with referrals

[tk-o]

This PR includes withReferral query param in the Registrar Actions API route which allows to filter out all "logical registrar actions" records that have encodedReferrer set to null or zeroEncodedReferrer.

Suggested review order:

• packages/ensnode-sdk/src/api/types.ts: added filterType field to distinguish among available filters and their params,
• packages/ensnode-sdk/src/api/registrar-actions/filters.ts: defined helpers allowing to create a filter object for any available filter,
• apps/ensapi/src/handlers/registrar-actions-api.ts: defined array of filters with conditional logic adding filters to the request object,
• apps/ensapi/src/lib/registrar-actions/find-registrar-actions.ts: updated buildWhereClause function to be able to build Drizzle SQL objects describing selected filters,
• packages/ensnode-sdk/src/client.ts: updated registrarActions method so it can map the selected filters into Registrar Actions request object.

Example use case:

// via vanilla ENSNodeClient
const registrarActionsResponse = client.registrarActions({
  order: RegistrarActionsOrders.LatestRegistrarActions,
  itemsPerPage,
  filters: [
    registrarActionsFilter.withReferral(true),
    registrarActionsFilter.byParentNode(namehash("eth")),
  ],
});

// via React hook
const registrarActionsQuery = useRegistrarActions({
  order: RegistrarActionsOrders.LatestRegistrarActions,
  itemsPerPage,
  filters: [
    registrarActionsFilter.withReferral(true),
    registrarActionsFilter.byParentNode(namehash("eth")),
  ],
  query: {
    enabled: isRegistrarActionsApiSupported,
  },
});

[changeset-bot]

🦋 Changeset detected

Latest commit: f5778fc

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

This PR includes changesets to release 14 packages

Name	Type
@ensnode/ensnode-sdk	Minor
ensapi	Minor
ensadmin	Minor
ensindexer	Minor
ensrainbow	Minor
@ensnode/ensnode-react	Minor
@ensnode/ensrainbow-sdk	Minor
@ensnode/datasources	Minor
@ensnode/ponder-metadata	Minor
@ensnode/ensnode-schema	Minor
@ensnode/ponder-subgraph	Minor
@ensnode/shared-configs	Minor
@docs/ensnode	Minor
@docs/ensrainbow	Minor

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

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
admin.ensnode.io	Ready	Preview	Comment	Nov 24, 2025 8:14pm
ensnode.io	Ready	Preview	Comment	Nov 24, 2025 8:14pm
ensrainbow.io	Ready	Preview	Comment	Nov 24, 2025 8:14pm

[lightwalker-eth]

@tk-o Looks great! Nice work. Shared very small feedback. Please take the lead to merge and deploy a new RC (just of ENSApi maybe?) 👍

[lightwalker-eth]

Suggested change

	WithReferralIncluded: "withReferralIncluded",
	WithEncodedReferral: "withEncodedReferral",

[lightwalker-eth]

Suggested change

	export type RegistrarActionsFilterWithReferralIncluded = {
	export type RegistrarActionsFilterWithEncodedReferral = {