enssdk

The foundational ENS developer library. Isomorphic, tree-shakable, with composable modules via subpath exports.

Learn more about ENSNode from the ENSNode docs.

Installation

npm install enssdk

Usage

Core Client

import { createEnsNodeClient } from "enssdk/core";

const client = createEnsNodeClient({ url: "https://api.alpha.ensnode.io" });

Omnigraph (Typed GraphQL)

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

const client = createEnsNodeClient({ url: "https://api.alpha.ensnode.io" })
  .extend(omnigraph);

const MyQuery = graphql(`
  query MyQuery($name: Name!) {
    domain(by: { name: $name }) {
      name
      registration { expiry }
    }
  }
`);

const result = await client.omnigraph.query({
  query: MyQuery,
  variables: { name: "nick.eth" },
});

Modules are composable via extend() — only import what you use.

License

Licensed under the MIT License, Copyright © 2025-present NameHash Labs.

See LICENSE for more information.