Improve ENS Unigraph examples

Author: tk-o

docs/ensnode.io/src/content/docs/docs/integrate/unigraph/examples/domain-events.mdx

@@ -14,7 +14,7 @@ import { exampleDomainEvents } from "@data/unigraph-examples/domain-events";
 Performing SQL queries on the ENS Unigraph requires that you have the `unigraph` plugin activated in your ENSNode instance. [Learn more](/docs/services/ensindexer/usage/configuration)
 :::
 
-Fetch recent events for a Domain by its canonical name. This example joins the `events`, `domain_events`, and `domains` tables to retrieve domain events associated with the `vitalik.eth` name. See [Connect](/docs/integrate/unigraph/examples) for setup.
+Fetch recent events for a Domain by its canonical name. This example joins the `events`, `domain_events`, and `domains` tables to retrieve domain events associated with the `wrapnation.eth` name. See [Connect](/docs/integrate/unigraph/examples) for setup.
 
 :::note[Canonical fields]
 Canonical fields are populated on every Domain reachable from the canonical root, across both ENSv1 and ENSv2 — query them uniformly without branching by `type`. In SQL, these columns are `canonical_name`, `canonical_path`, `canonical_node`, and `canonical_depth`; in `ensdb-sdk`, the corresponding fields are `canonicalName`, `canonicalPath`, `canonicalNode`, and `canonicalDepth`.

docs/ensnode.io/src/data/unigraph-examples/account-domains.ts

@@ -19,7 +19,7 @@ export const exampleAccountDomains = {
 FROM "ensindexer_0".domains d
 WHERE d.canonical = true
 AND d.owner_id = '0xffffffffff52d316b7bd028358089bc8066b8f80'
-ORDER BY d.canonical_name
+ORDER BY d.__canonical_name_prefix ASC
 LIMIT 10;`,
     result: [
       {
@@ -119,7 +119,7 @@ const accountDomains = await ensDb
       eq(ensIndexerSchema.domain.canonical, true),
     ),
   )
-  .orderBy(asc(ensIndexerSchema.domain.canonicalName))
+  .orderBy(asc(ensIndexerSchema.domain.__canonicalNamePrefix))
   .limit(limit);
 
 console.log(accountDomains);`,

docs/ensnode.io/src/data/unigraph-examples/domains-fuzzy-search-by-name.ts

@@ -16,7 +16,7 @@ export const exampleDomainsFuzzySearchByName = {
     similarity(canonical_name, 'reverse') as name_similarity,
     id
 FROM "ensindexer_0".domains
-WHERE __canonicalNamePrefix % 'reverse'
+WHERE __canonical_name_prefix % 'reverse'
 AND canonical = true
 ORDER BY name_similarity DESC
 LIMIT 5;
@@ -52,7 +52,7 @@ LIMIT 5;
   sdk: {
     codeSnippet: `import { and, eq, sql } from "drizzle-orm";
 
-const q = "vitalik";
+const q = "reverse";
 const limit = 5;
 
 const domains = await ensDb

docs/ensnode.io/src/data/unigraph-examples/subdomains-by-parent-name.ts

@@ -22,7 +22,7 @@ SELECT
 FROM "ensindexer_0".domains d
 JOIN parent p ON d.registry_id = p.subregistry_id
 WHERE d.canonical = true
-ORDER BY d.canonical_name
+ORDER BY d.__canonical_name_prefix ASC
 LIMIT 5;
 `,
     result: [

docs/ensnode.io/src/data/unigraph-examples/utils.ts

@@ -1,2 +1,29 @@
-export const outputSource = (source: "V2 Sepolia" | "Alpha" | "Alpha Sepolia") =>
-  `Output matches a point in time snapshot of ENSDb result from our "${source}" <a href="/docs/hosted-instances">Hosted ENSNode instance</a>. Live output depends on the configuration of your ENSNode instance and also changes that may have happened in ENS since this point in time snapshot example response was captured.`;
+export const EnsNodeInstances = {
+  V2Sepolia: "V2 Sepolia",
+  Alpha: "Alpha",
+  AlphaSepolia: "Alpha Sepolia",
+  Mainnet: "Mainnet",
+  Sepolia: "Sepolia",
+} as const;
+
+export type EnsNodeInstance = (typeof EnsNodeInstances)[keyof typeof EnsNodeInstances];
+
+export const outputSource = (ensNodeInstance: EnsNodeInstance) =>
+  `Output matches a point in time snapshot of ENSDb result from our <a href="${ensNodeInstanceDocUrl(ensNodeInstance)}">${ensNodeInstance} Hosted ENSNode instance</a>. Live output depends on the configuration of your ENSNode instance and also changes that may have happened in ENS since this point in time snapshot example response was captured.`;
+
+const ensNodeInstanceDocUrl = (instance: EnsNodeInstance) => {
+  const hostedInstancesPath = "/docs/hosted-instances#ensnode-";
+
+  switch (instance) {
+    case EnsNodeInstances.V2Sepolia:
+      return `${hostedInstancesPath}v2-sepolia`;
+    case EnsNodeInstances.Alpha:
+      return `${hostedInstancesPath}alpha`;
+    case EnsNodeInstances.AlphaSepolia:
+      return `${hostedInstancesPath}alpha-sepolia`;
+    case EnsNodeInstances.Mainnet:
+      return `${hostedInstancesPath}mainnet`;
+    case EnsNodeInstances.Sepolia:
+      return `${hostedInstancesPath}sepolia`;
+  }
+};

docs/ensnode.io/src/styles/starlight.css

@@ -928,3 +928,14 @@ starlight-tabs ul[role="tablist"] {
   padding: 0.125rem 0.375rem;
   font-size: var(--sl-text-code-sm);
 }
+
+.static-example p a {
+  color: var(--sl-color-text-accent);
+  text-decoration: underline;
+  text-underline-offset: 4px;
+  transition: text-underline-offset 0.2s ease-in-out;
+
+  &:hover {
+    text-underline-offset: 2px;
+  }
+}