Namegraph

Walk the root tree: root → domains → nested subdomains (depth-limited).

omnigraphenssdkenskitcurl

Run in ENSAdmin Open an interactive playground to execute this example on our sepolia-v2 ENSNode instance.

GraphQL

query Namegraph {
  root {
    id
    domains {
      edges {
        node {
          canonical { name { interpreted beautified } }

          subdomains {
            edges {
              node {
                canonical { name { interpreted beautified } }

                subdomains {
                  edges {
                    node {
                      canonical { name { interpreted beautified } }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Variables

{}

Output

{
  "data": {
    "root": {
      "id": "11155111-0x835f0b284e78cd3f358bcf6cba3b53809f09b79e",
      "domains": {
        "edges": [
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "eth",
                  "beautified": "eth"
                }
              },
              "subdomains": {
                "edges": [
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "katrenpadu.eth",
                          "beautified": "katrenpadu.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "roppp.eth",
                          "beautified": "roppp.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0mig.eth",
                          "beautified": "sfmpfv44d0mig.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0res.eth",
                          "beautified": "sfmpfv44d0res.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfvtoicv2ok.eth",
                          "beautified": "sfmpfvtoicv2ok.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "wrapnation.eth",
                          "beautified": "wrapnation.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  }
                ]
              }
            }
          },
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "reverse",
                  "beautified": "reverse"
                }
              },
              "subdomains": {
                "edges": []
              }
            }
          }
        ]
      }
    }
  }
}

Output matches a GraphQL Response snapshot; live output depends on your ENSNode instance.

Run in StackBlitz Opens an editable StackBlitz project with this snippet.

TypeScript

import { createEnsNodeClient } from "enssdk/core";
import { graphql, omnigraph } from "enssdk/omnigraph";

const client = createEnsNodeClient({
  url: process.env.ENSNODE_URL || "https://api.v2-sepolia.ensnode.io"
}).extend(omnigraph);

const NamegraphQuery = graphql(`
  query Namegraph {
    root {
      id
      domains {
        edges {
          node {
            canonical { name { interpreted beautified } }

            subdomains {
              edges {
                node {
                  canonical { name { interpreted beautified } }

                  subdomains {
                    edges {
                      node {
                        canonical { name { interpreted beautified } }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
`);

const result = await client.omnigraph.query({
  query: NamegraphQuery,
  variables: {},
});

if (result.errors) throw new Error(JSON.stringify(result.errors));
console.log(JSON.stringify(result.data, null, 2));

Output

{
  "data": {
    "root": {
      "id": "11155111-0x835f0b284e78cd3f358bcf6cba3b53809f09b79e",
      "domains": {
        "edges": [
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "eth",
                  "beautified": "eth"
                }
              },
              "subdomains": {
                "edges": [
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "katrenpadu.eth",
                          "beautified": "katrenpadu.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "roppp.eth",
                          "beautified": "roppp.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0mig.eth",
                          "beautified": "sfmpfv44d0mig.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0res.eth",
                          "beautified": "sfmpfv44d0res.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfvtoicv2ok.eth",
                          "beautified": "sfmpfvtoicv2ok.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "wrapnation.eth",
                          "beautified": "wrapnation.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  }
                ]
              }
            }
          },
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "reverse",
                  "beautified": "reverse"
                }
              },
              "subdomains": {
                "edges": []
              }
            }
          }
        ]
      }
    }
  }
}

Output matches a GraphQL Response snapshot; live output depends on your ENSNode instance.

enssdk package manager setup

npm pnpm

# 1. Create project
mkdir -p my-ens-script/src && cd my-ens-script
npm init -y && touch src/index.ts
npm pkg set type=module scripts.start="tsx src/index.ts"
# 2. Install dependencies
npm install enssdk@1.15.1 && npm install -D tsx typescript @types/node
# 3. Paste the TypeScript snippet above into src/index.ts
# 4. Run
ENSNODE_URL=https://api.v2-sepolia.ensnode.io npm start

# 1. Create project
mkdir -p my-ens-script/src && cd my-ens-script
pnpm init && touch src/index.ts
pnpm pkg set type=module scripts.start="tsx src/index.ts"
# 2. Install dependencies
pnpm add enssdk@1.15.1 && pnpm add -D tsx typescript @types/node
# 3. Paste the TypeScript snippet above into src/index.ts
# 4. Run
ENSNODE_URL=https://api.v2-sepolia.ensnode.io pnpm start

See the enssdk docs for gql.tada plugin and tsconfig setup.

Run in StackBlitz Opens an editable StackBlitz project with this snippet.

TSX (React)

import { OmnigraphProvider, useOmnigraphQuery, graphql } from "enskit/react/omnigraph";
import { createEnsNodeClient } from "enssdk/core";
import { omnigraph } from "enssdk/omnigraph";

const client = createEnsNodeClient({
  url: import.meta.env.VITE_ENSNODE_URL || "https://api.v2-sepolia.ensnode.io"
}).extend(omnigraph);

const NamegraphQuery = graphql(`
  query Namegraph {
    root {
      id
      domains {
        edges {
          node {
            canonical { name { interpreted beautified } }

            subdomains {
              edges {
                node {
                  canonical { name { interpreted beautified } }

                  subdomains {
                    edges {
                      node {
                        canonical { name { interpreted beautified } }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
`);

function NamegraphResult() {
  const [result] = useOmnigraphQuery({
    query: NamegraphQuery,
    variables: {},
  });
  const { data, fetching, error } = result;
  if (!data && fetching) return <p>Loading…</p>;
  if (error) return <p>Error: {error.message}</p>;
  if (!data) return <p>No data returned.</p>;
  const formatted = JSON.stringify(
    data,
    (_, value) => (typeof value === "bigint" ? value.toString() : value),
    2,
  );
  return <code>{formatted}</code>;
}

export default function App() {
  return (
    <OmnigraphProvider client={client}>
      <NamegraphResult />
    </OmnigraphProvider>
  );
}

Output

{
  "data": {
    "root": {
      "id": "11155111-0x835f0b284e78cd3f358bcf6cba3b53809f09b79e",
      "domains": {
        "edges": [
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "eth",
                  "beautified": "eth"
                }
              },
              "subdomains": {
                "edges": [
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "katrenpadu.eth",
                          "beautified": "katrenpadu.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "roppp.eth",
                          "beautified": "roppp.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0mig.eth",
                          "beautified": "sfmpfv44d0mig.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0res.eth",
                          "beautified": "sfmpfv44d0res.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfvtoicv2ok.eth",
                          "beautified": "sfmpfvtoicv2ok.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "wrapnation.eth",
                          "beautified": "wrapnation.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  }
                ]
              }
            }
          },
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "reverse",
                  "beautified": "reverse"
                }
              },
              "subdomains": {
                "edges": []
              }
            }
          }
        ]
      }
    }
  }
}

Output matches a GraphQL Response snapshot; live output depends on your ENSNode instance.

enskit package manager setup

npm pnpm

# 1. Create project
npm create vite@latest my-ens-app -- --template react-ts --no-interactive --no-immediate
cd my-ens-app
# 2. Install dependencies
npm install
npm install enskit@1.15.1 enssdk@1.15.1
# 3. Copy the TSX snippet above into src/App.tsx
# 4. Run
VITE_ENSNODE_URL=https://api.v2-sepolia.ensnode.io npm run dev

# 1. Create project
pnpm create vite@latest my-ens-app --template react-ts --no-interactive --no-immediate
cd my-ens-app
# 2. Install dependencies
pnpm install
pnpm add enskit@1.15.1 enssdk@1.15.1
# 3. Copy the TSX snippet above into src/App.tsx
# 4. Run
VITE_ENSNODE_URL=https://api.v2-sepolia.ensnode.io pnpm run dev

See the enskit docs for gql.tada plugin and provider setup.

cURL

# POST JSON to your ENSNode Omnigraph endpoint (same path enssdk uses).
curl -sS -X POST "https://api.v2-sepolia.ensnode.io/api/omnigraph" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "query": "query Namegraph { root { id domains { edges { node { canonical { name { interpreted beautified } } subdomains { edges { node { canonical { name { interpreted beautified } } subdomains { edges { node { canonical { name { interpreted beautified } } } } } } } } } } } } }",
  "variables": {}
}
EOF

Response

{
  "data": {
    "root": {
      "id": "11155111-0x835f0b284e78cd3f358bcf6cba3b53809f09b79e",
      "domains": {
        "edges": [
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "eth",
                  "beautified": "eth"
                }
              },
              "subdomains": {
                "edges": [
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "katrenpadu.eth",
                          "beautified": "katrenpadu.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "roppp.eth",
                          "beautified": "roppp.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0mig.eth",
                          "beautified": "sfmpfv44d0mig.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfv44d0res.eth",
                          "beautified": "sfmpfv44d0res.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "sfmpfvtoicv2ok.eth",
                          "beautified": "sfmpfvtoicv2ok.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  },
                  {
                    "node": {
                      "canonical": {
                        "name": {
                          "interpreted": "wrapnation.eth",
                          "beautified": "wrapnation.eth"
                        }
                      },
                      "subdomains": {
                        "edges": []
                      }
                    }
                  }
                ]
              }
            }
          },
          {
            "node": {
              "canonical": {
                "name": {
                  "interpreted": "reverse",
                  "beautified": "reverse"
                }
              },
              "subdomains": {
                "edges": []
              }
            }
          }
        ]
      }
    }
  }
}

Output matches a GraphQL Response snapshot; live output depends on your ENSNode instance.

Back to Examples