docs: examples cleanup + integrate restructure (Unigraph SQL, Subgraph as legacy)

.changeset/unigraph-schema-rename.md

@@ -0,0 +1,6 @@
+---
+"@ensnode/ensnode-sdk": patch
+"@ensnode/ensdb-sdk": patch
+---
+
+`@ensnode/ensnode-sdk`: add new Omnigraph example queries. `@ensnode/ensdb-sdk`: rename the internal `ensv2.schema.ts` to `unigraph.schema.ts` to match the "Unigraph" terminology (no exported symbols change).

docs/ensnode.io/astro.config.mjs

@@ -37,13 +37,22 @@ export default defineConfig({
     "/ensnode": "/docs/integrate",
     "/ensnode/deploying/railway": "/docs/services/ensrainbow/deploying/railway",
     "/ensnode/concepts/what-is-the-ens-subgraph":
-      "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-    "/docs/reference/what-is-the-ens-subgraph":
-      "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-    "/docs/reference/querying-best-practices":
-      "/docs/reference/subgraph-legacy/querying-best-practices",
+      "/docs/integrate/subgraph/what-is-the-ens-subgraph",
+    "/docs/reference/what-is-the-ens-subgraph": "/docs/integrate/subgraph/what-is-the-ens-subgraph",
+    "/docs/reference/querying-best-practices": "/docs/integrate/subgraph/querying-best-practices",
     "/docs/reference/subgraph-compatibility-tooling":
-      "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling",
+      "/docs/integrate/subgraph/subgraph-compatibility-tooling",
+    "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph":
+      "/docs/integrate/subgraph/what-is-the-ens-subgraph",
+    "/docs/reference/subgraph-legacy/subgraph-api": "/docs/integrate/subgraph/subgraph-api",
+    "/docs/reference/subgraph-legacy/querying-best-practices":
+      "/docs/integrate/subgraph/querying-best-practices",
+    "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling":
+      "/docs/integrate/subgraph/subgraph-compatibility-tooling",
+    "/docs/reference/subgraph-legacy/with-ensjs": "/docs/integrate/subgraph/with-ensjs",
+    "/docs/reference/subgraph-legacy/with-viem": "/docs/integrate/subgraph/with-viem",
+    "/docs/reference/subgraph-legacy/subgraph-dependents":
+      "/docs/integrate/subgraph/subgraph-dependents",
     "/ensadmin": "/docs/services/ensadmin",
     "/ensapi": "/docs/services/ensapi",
     "/ensdb": "/docs/services/ensdb",

docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts

@@ -20,7 +20,7 @@ export const integrateSidebarTopic = {
       collapsed: false,
       badge: {
         text: "NEW",
-        variant: "tip",
+        variant: "success",
       },
       items: [
         {
@@ -91,6 +91,46 @@ export const integrateSidebarTopic = {
         },
       ],
     },
+    {
+      label: "ENS Unigraph SQL",
+      collapsed: false,
+      badge: {
+        text: "NEW",
+        variant: "success",
+      },
+      items: [
+        {
+          label: "Overview",
+          link: "/docs/integrate/unigraph",
+        },
+        {
+          label: "Examples",
+          collapsed: true,
+          items: [
+            {
+              label: "Overview",
+              link: "/docs/integrate/unigraph/examples",
+            },
+            {
+              label: "Domain by Name",
+              link: "/docs/integrate/unigraph/examples/domain-by-name",
+            },
+            {
+              label: "Account Domains",
+              link: "/docs/integrate/unigraph/examples/account-domains",
+            },
+            {
+              label: "Indexing Status",
+              link: "/docs/integrate/unigraph/examples/indexing-status",
+            },
+          ],
+        },
+        {
+          label: "Schema Reference",
+          link: "/docs/integrate/unigraph/schema-reference",
+        },
+      ],
+    },
     {
       label: "Integration Options",
       collapsed: false,
@@ -100,30 +140,30 @@ export const integrateSidebarTopic = {
           link: "/docs/integrate/integration-options",
         },
         {
-          label: "enskit (React)",
+          label: "enssdk (TypeScript)",
           collapsed: false,
           items: [
             {
               label: "Overview",
-              link: "/docs/integrate/integration-options/enskit",
+              link: "/docs/integrate/integration-options/enssdk",
             },
             {
               label: "Interactive example ⚡",
-              link: "/docs/integrate/integration-options/enskit/example",
+              link: "/docs/integrate/integration-options/enssdk/example",
             },
           ],
         },
         {
-          label: "enssdk (TypeScript)",
+          label: "enskit (React)",
           collapsed: false,
           items: [
             {
               label: "Overview",
-              link: "/docs/integrate/integration-options/enssdk",
+              link: "/docs/integrate/integration-options/enskit",
             },
             {
               label: "Interactive example ⚡",
-              link: "/docs/integrate/integration-options/enssdk/example",
+              link: "/docs/integrate/integration-options/enskit/example",
             },
           ],
         },
@@ -153,6 +193,44 @@ export const integrateSidebarTopic = {
         },
       ],
     },
+    {
+      label: "ENS Subgraph",
+      collapsed: true,
+      badge: {
+        text: "LEGACY",
+        variant: "danger",
+      },
+      items: [
+        {
+          label: "Overview",
+          link: "/docs/integrate/subgraph/what-is-the-ens-subgraph",
+        },
+        {
+          label: "Subgraph API",
+          link: "/docs/integrate/subgraph/subgraph-api",
+        },
+        {
+          label: "Querying Best Practices",
+          link: "/docs/integrate/subgraph/querying-best-practices",
+        },
+        {
+          label: "Subgraph Compatibility Tooling",
+          link: "/docs/integrate/subgraph/subgraph-compatibility-tooling",
+        },
+        {
+          label: "With ENSjs",
+          link: "/docs/integrate/subgraph/with-ensjs",
+        },
+        {
+          label: "With Viem",
+          link: "/docs/integrate/subgraph/with-viem",
+        },
+        {
+          label: "Subgraph Dependents",
+          link: "/docs/integrate/subgraph/subgraph-dependents",
+        },
+      ],
+    },
     {
       label: "AI / LLM Tooling",
       link: "/docs/integrate/ai-llm",

docs/ensnode.io/config/integrations/starlight/sidebar-topics/reference.ts

@@ -11,40 +11,6 @@ export const referenceSidebarTopic = {
       label: "Terminology",
       link: "/docs/reference/terminology",
     },
-    {
-      label: "Subgraph API (Legacy)",
-      collapsed: true,
-      items: [
-        {
-          label: "What is the ENS Subgraph?",
-          link: "/docs/reference/subgraph-legacy/what-is-the-ens-subgraph",
-        },
-        {
-          label: "Subgraph API",
-          link: "/docs/reference/subgraph-legacy/subgraph-api",
-        },
-        {
-          label: "Querying Best Practices",
-          link: "/docs/reference/subgraph-legacy/querying-best-practices",
-        },
-        {
-          label: "Subgraph Compatibility Tooling",
-          link: "/docs/reference/subgraph-legacy/subgraph-compatibility-tooling",
-        },
-        {
-          label: "With ENSjs",
-          link: "/docs/reference/subgraph-legacy/with-ensjs",
-        },
-        {
-          label: "With Viem",
-          link: "/docs/reference/subgraph-legacy/with-viem",
-        },
-        {
-          label: "Subgraph Dependents",
-          link: "/docs/reference/subgraph-legacy/subgraph-dependents",
-        },
-      ],
-    },
     {
       label: "Contributing",
       collapsed: false,

docs/ensnode.io/src/content.config.ts

@@ -3,17 +3,6 @@ import { z } from "astro/zod";
 import { docsLoader } from "@astrojs/starlight/loaders";
 import { docsSchema } from "@astrojs/starlight/schema";
 
-import { exampleQuerySchema, savedQueries } from "./data/ens-v1-examples-queries";
-
-const examples = defineCollection({
-  loader: () =>
-    savedQueries.map((query) => ({
-      ...query,
-      id: query.id,
-    })),
-  schema: exampleQuerySchema,
-});
-
 export const collections = {
   docs: defineCollection({
     loader: docsLoader(),
@@ -24,5 +13,4 @@ export const collections = {
       }),
     }),
   }),
-  examples,
 };

docs/ensnode.io/src/content/docs/docs/integrate/ensv2-readiness.mdx

@@ -16,7 +16,7 @@ import { LinkCard, Aside } from "@astrojs/starlight/components";
 Full access to ENS data formerly required two separate data fetching strategies working in parallel:
 
 1. **ENS resolution** — RPC calls with CCIP-read support for offchain data (e.g. via a popular package such as `viem` or `wagmi`) to perform forward or reverse ENS resolution.
-2. **Indexed ENS data** — the [ENS Subgraph](/docs/reference/subgraph-legacy/what-is-the-ens-subgraph) for indexed ENS data, such as discovering names owned by an address and all other ENS state outside of ENS resolutions.
+2. **Indexed ENS data** — the [ENS Subgraph](/docs/integrate/subgraph/what-is-the-ens-subgraph) for indexed ENS data, such as discovering names owned by an address and all other ENS state outside of ENS resolutions.
 
 Neither system alone was complete.
 - ENS resolution gives you resolver records, but no access to all the other state about ENS! ENS Resolutions as exposed through popular libraries such as `viem` and `wagmi` are also painfully "close to the metal", putting the burden on app developers to learn and carefully implement complex details about interpreting raw values returned by the ENS protocol.