feat: support QuickNode RPC provider

.changeset/forty-coins-lose.md

@@ -0,0 +1,6 @@
+---
+"ensapi": minor
+"ensindexer": minor
+---
+
+Enable QuickNode RPC provider support with `QUICKNODE_API_KEY` and `QUICKNODE_ENDPOINT_NAME` environment variables.

.changeset/smooth-lines-vanish.md

@@ -0,0 +1,5 @@
+---
+"@ensnode/ensnode-sdk": minor
+---
+
+Add QuickNode RPC provider support for auto-generated chain RPC URLs.

.github/workflows/deploy_ensnode_blue_green.yml

@@ -33,24 +33,6 @@ jobs:
       RAILWAY_PROJECT_ID: ${{ secrets.RAILWAY_PROJECT_ID }}
       RAILWAY_ENVIRONMENT_ID: ${{ secrets.RAILWAY_ENVIRONMENT_ID}}
       RAILWAY_TEAM_TOKEN: ${{ secrets.RAILWAY_TEAM_TOKEN }}
-      # Terraform related envs
-
-      # AWS_REGION is required for aws-actions/configure-aws-credentials@v4
-      # Terraform keeps it's state inside S3 bucket. This bucket needs to be created before running Terraform apply.
-      # AWS_REGION should be the same as Terraform S3 bucket state region.
-      AWS_REGION: us-east-1
-      TF_VAR_ensnode_version: ${{ inputs.tag }}
-      TF_VAR_ensindexer_label_set_id: ${{ vars.LABEL_SET_ID }}
-      TF_VAR_ensindexer_label_set_version: ${{ vars.LABEL_SET_VERSION }}
-      TF_VAR_ensrainbow_label_set_id: ${{ vars.LABEL_SET_ID }}
-      TF_VAR_ensrainbow_label_set_version: ${{ vars.LABEL_SET_VERSION }}
-      TF_VAR_db_schema_version: ${{ vars.DB_SCHEMA_VERSION }}
-      TF_VAR_anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
-      # For now only one Terraform environment is active. In future this will be calculated based on workflow input.
-      TF_VAR_render_environment: "yellow"
-      TF_VAR_render_api_key: ${{ secrets.RENDER_API_KEY }}
-      TF_VAR_render_owner_id: ${{ secrets.RENDER_OWNER_ID }}
-      TF_VAR_alchemy_api_key: ${{ secrets.ALCHEMY_API_KEY }}
 
     steps:
       - name: Checkout repository

.github/workflows/deploy_ensnode_yellow.yml

@@ -39,6 +39,8 @@ jobs:
       TF_VAR_render_api_key: ${{ secrets.RENDER_API_KEY }}
       TF_VAR_render_owner_id: ${{ secrets.RENDER_OWNER_ID }}
       TF_VAR_alchemy_api_key: ${{ secrets.ALCHEMY_API_KEY }}
+      TF_VAR_quicknode_api_key: ${{ secrets.QUICKNODE_API_KEY }}
+      TF_VAR_quicknode_endpoint_name: ${{ secrets.QUICKNODE_ENDPOINT_NAME}}
 
     steps:
       - name: Checkout repository

.github/workflows/test_ci.yml

@@ -113,6 +113,8 @@ jobs:
           ENSRAINBOW_URL: https://api.ensrainbow.io
           ENSINDEXER_URL: http://localhost:42069
           ALCHEMY_API_KEY: ${{ secrets.ALCHEMY_API_KEY }}
+          QUICKNODE_API_KEY: ${{ secrets.QUICKNODE_API_KEY }}
+          QUICKNODE_ENDPOINT_NAME: ${{ secrets.QUICKNODE_ENDPOINT_NAME}}
           # healthcheck script env variables
           HEALTH_CHECK_TIMEOUT: 60
         run: ./.github/scripts/run_ensindexer_healthcheck.sh

apps/ensapi/.env.local.example

@@ -36,17 +36,25 @@ DATABASE_URL=postgresql://dbuser:abcd1234@localhost:5432/my_database
 # The following environment variables are supported:
 # - ALCHEMY_API_KEY — if set, an Alchemy RPC URL will be provided for each of the chains it supports
 # - DRPC_API_KEY — if set, an DRPC RPC URL will be provided for each of the chains it supports
+# - QUICKNODE_API_KEY & QUICKNODE_ENDPOINT_NAME — if both set, an QuickNode RPC URL will be provided
+#   for each of the chains it supports. Please note that:
+#   - Only multi-chain QuickNode endpoints are supported.
+#     https://www.quicknode.com/guides/quicknode-products/how-to-use-multichain-endpoint
+#   - QuickNode platform does not support Linea Sepolia RPC (as of 2025-12-03).
+#     https://www.quicknode.com/docs/linea
 # - RPC_URL_${chainId} — specific, per-chain RPC settings (see below).
 #
 # If RPC_URL_${chainId} is specified, it will take precedence over the automatic RPC URLs from
-# Alchemy or DRPC. It must be a comma-separated list of HTTP/HTTPS RPC endpoints. If multiple
+# Alchemy, DRPC, or QuickNode. It must be a comma-separated list of HTTP/HTTPS RPC endpoints. If multiple
 # HTTP RPC endpoints are provided for a single chain, they will be used in order, falling back if
 # RPC errors are encountered. If multiple automatic RPC environment variables are specified, they
-# will be used in the following order: Alchemy > DRPC.
+# will be used in the following order: Alchemy > DRPC > QuickNode.
 #
 # Automatic:
 # ALCHEMY_API_KEY=xyz
 # DRPC_API_KEY=xyz
+# QUICKNODE_API_KEY=your-api-key
+# QUICKNODE_ENDPOINT_NAME=your-endpoint-name
 #
 # Chain-Specific:
 # RPC_URL_1=https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY

apps/ensindexer/.env.local.example

@@ -22,11 +22,24 @@
 # The following environment variables are supported:
 # - ALCHEMY_API_KEY — if set, Alchemy RPC URLs (HTTP & WS) will be provided for each of the chains it supports
 # - DRPC_API_KEY — if set, an DRPC RPC URL (HTTP) will be provided for each of the chains it supports
+# - QUICKNODE_API_KEY & QUICKNODE_ENDPOINT_NAME — if both set, an QuickNode RPC URL will be provided
+#   for each of the chains it supports. Please note that:
+#   - Only multi-chain QuickNode endpoints are supported.
+#     https://www.quicknode.com/guides/quicknode-products/how-to-use-multichain-endpoint
+#   - QuickNode platform does not support Linea Sepolia RPC (as of 2025-12-03).
+#     https://www.quicknode.com/docs/linea
 # - RPC_URL_${chainId} — specific, per-chain RPC settings (see below).
 #
 # If RPC_URL_${chainId} is specified, that value will take precedence over the automatic RPC URLs
-# from Alchemy or DRPC. If both Alchemy and DRPC API Keys are specified, ENSIndexer will provide
-# both to Ponder, which will balance requests between them (see below).
+# from Alchemy, DRPC, or QuickNode. ENSIndexer will provide all available
+# RPC URLs across configured RPC providers to Ponder, which will balance
+# requests between them (see below).
+
+# Automatic:
+# ALCHEMY_API_KEY=xyz
+# DRPC_API_KEY=xyz
+# QUICKNODE_API_KEY=your-api-key
+# QUICKNODE_ENDPOINT_NAME=your-endpoint-name
 #
 # For chain-specific RPC configuration, use the RPC_URL_{chainId} environment variable.
 # Its value is a comma-separated list of one or more HTTP RPC URLs and at most one WebSocket RPC URL.
@@ -56,64 +69,64 @@
 # Ethereum Mainnet
 # - required if the configured namespace is mainnet
 # - required by plugins: subgraph, protocol-acceleration, registrars, tokenscope
-RPC_URL_1=
+# RPC_URL_1=
 
 # Optimism Mainnet
 # - required by plugins: threedns, protocol-acceleration, tokenscope
-RPC_URL_10=
+# RPC_URL_10=
 
 # Base Mainnet
 # - required by plugins: basenames, threedns, protocol-acceleration, registrars, tokenscope
-RPC_URL_8453=
+# RPC_URL_8453=
 
 # Arbitrum Mainnet
 # - required by plugins: protocol-acceleration
-RPC_URL_42161=
+# RPC_URL_42161=
 
 # Linea Mainnet
 # - required by plugins: lineanames, protocol-acceleration, registrars, tokenscope
-RPC_URL_59144=
+# RPC_URL_59144=
 
 # Scroll Mainnet
 # - required by plugins: protocol-acceleration
-RPC_URL_534352=
+# RPC_URL_534352=
 
 # === ENS Namespace: Sepolia ===
 # Ethereum Sepolia (public testnet)
 # - required if the configured namespace is sepolia
 # - required by plugins: subgraph, protocol-acceleration, registrars, tokenscope
-RPC_URL_11155111=
+# RPC_URL_11155111=
 
 # Base Sepolia (public testnet)
 # - required by plugins: basenames, protocol-acceleration, registrars, tokenscope
-RPC_URL_84532=
+# RPC_URL_84532=
 
 # Linea Sepolia (public testnet)
 # - required by plugins: lineanames, protocol-acceleration, registrars, tokenscope
-RPC_URL_59141=
+# RPC_URL_59141=
 
 # Optimism Sepolia (public testnet)
 # - required by plugins: protocol-acceleration, tokenscope
-RPC_URL_11155420=
+# RPC_URL_11155420=
 
 # Arbitrum Sepolia (public testnet)
 # - required by plugins: protocol-acceleration
-RPC_URL_421614=
+# RPC_URL_421614=
 
 # Scroll Sepolia (public testnet)
 # - required by plugins: protocol-acceleration
-RPC_URL_534351=
+# RPC_URL_534351=
 
 # === ENS Namespace: Holesky ===
 # Ethereum Holesky (public testnet)
 # - required if the configured namespace is holesky
 # - required by plugins: subgraph, protocol-acceleration, tokenscope
-RPC_URL_17000=
+# RPC_URL_17000=
 
 # === ENS Namespace: ens-test-env ===
 # ens-test-env (local testnet)
 # - required if the configured namespace is ens-test-env
-RPC_URL_1337=
+# RPC_URL_1337=
 
 # Database configuration
 # Required. This is a namespace for the tables that the indexer will create to store indexed data.

packages/ensnode-sdk/src/shared/config/build-rpc-urls.test.ts

@@ -1,3 +1,4 @@
+import { lineaSepolia } from "viem/chains";
 import { describe, expect, it } from "vitest";
 
 import {
@@ -8,7 +9,7 @@ import {
   getENSNamespace,
 } from "@ensnode/datasources";
 
-import { buildAlchemyBaseUrl, buildDRPCUrl } from "./build-rpc-urls";
+import { buildAlchemyBaseUrl, buildDRPCUrl, buildQuickNodeURL } from "./build-rpc-urls";
 
 const KEY = "whatever";
 
@@ -25,5 +26,15 @@ describe("build-rpc-urls", () => {
       expect(buildAlchemyBaseUrl(chainId, KEY), `Alchemy ${chainId}`).not.toBeUndefined();
       expect(buildDRPCUrl(chainId, KEY), `DRPC ${chainId}`).not.toBeUndefined();
     });
+
+    // QuickNode does not support Linea Sepolia RPC (as of 2025-12-03).
+    ALL_KNOWN_PUBLIC_CHAIN_IDS.filter((chainId) => chainId !== lineaSepolia.id).forEach(
+      (chainId) => {
+        expect(
+          buildQuickNodeURL(chainId, KEY, "endpoint-name"),
+          `QuickNode ${chainId}`,
+        ).not.toBeUndefined();
+      },
+    );
   });
 });

packages/ensnode-sdk/src/shared/config/build-rpc-urls.ts

@@ -108,10 +108,73 @@ export function buildDRPCUrl(chainId: ChainId, key: string): string | undefined
   }
 }
 
+/**
+ * Builds a QuickNode RPC base URL for the specified chain ID.
+ *
+ * @param chainId - The chain ID to build the RPC base URL for
+ * @param apiKey - The QuickNode API key
+ * @param endpointName - The QuickNode Endpoint name
+ * @returns The QuickNode RPC base URL, or undefined if the chain is not supported
+ *
+ * NOTE:
+ * - Only multi-chain QuickNode endpoints are supported.
+ *   https://www.quicknode.com/guides/quicknode-products/how-to-use-multichain-endpoint
+ * - QuickNode platform does not support Linea Sepolia RPC (as of 2025-12-03).
+ *   https://www.quicknode.com/docs/linea
+ *
+ * @example
+ * ```typescript
+ * const url = buildQuickNodeURL(1, "your-api-key", "your-endpoint-name");
+ * // Returns: "your-endpoint-name.quiknode.pro/your-api-key"
+ * ```
+ */
+export function buildQuickNodeURL(
+  chainId: ChainId,
+  apiKey: string,
+  endpointName: string,
+): string | undefined {
+  switch (chainId) {
+    case mainnet.id:
+      return `${endpointName}.quiknode.pro/${apiKey}`;
+    case sepolia.id:
+      return `${endpointName}.ethereum-sepolia.quiknode.pro/${apiKey}`;
+    case holesky.id:
+      return `${endpointName}.ethereum-holesky.quiknode.pro/${apiKey}`;
+    case arbitrum.id:
+      return `${endpointName}.arbitrum-mainnet.quiknode.pro/${apiKey}`;
+    case arbitrumSepolia.id:
+      return `${endpointName}.arbitrum-sepolia.quiknode.pro/${apiKey}`;
+    case base.id:
+      return `${endpointName}.base-mainnet.quiknode.pro/${apiKey}`;
+    case baseSepolia.id:
+      return `${endpointName}.base-sepolia.quiknode.pro/${apiKey}`;
+    case optimism.id:
+      return `${endpointName}.optimism.quiknode.pro/${apiKey}`;
+    case optimismSepolia.id:
+      return `${endpointName}.optimism-sepolia.quiknode.pro/${apiKey}`;
+    case linea.id:
+      return `${endpointName}.linea-mainnet.quiknode.pro/${apiKey}`;
+    case lineaSepolia.id:
+      //QuickNode platform does not provide RPC for Linea Sepolia
+      // https://www.quicknode.com/docs/linea
+      return undefined;
+    case scroll.id:
+      return `${endpointName}.scroll-mainnet.quiknode.pro/${apiKey}`;
+    case scrollSepolia.id:
+      return `${endpointName}.scroll-testnet.quiknode.pro/${apiKey}`;
+    default:
+      return undefined;
+  }
+}
+
 export function alchemySupportsChain(chainId: ChainId) {
   return buildAlchemyBaseUrl(chainId, "") !== undefined;
 }
 
 export function drpcSupportsChain(chainId: ChainId) {
   return buildDRPCUrl(chainId, "") !== undefined;
 }
+
+export function quickNodeSupportsChain(chainId: ChainId) {
+  return buildQuickNodeURL(chainId, "", "") !== undefined;
+}

packages/ensnode-sdk/src/shared/config/environments.ts

@@ -13,6 +13,8 @@ export interface RpcEnvironment {
   [x: `RPC_URL_${number}`]: ChainIdSpecificRpcEnvironmentVariable | undefined;
   ALCHEMY_API_KEY?: string;
   DRPC_API_KEY?: string;
+  QUICKNODE_API_KEY?: string;
+  QUICKNODE_ENDPOINT_NAME?: string;
 }
 
 /**