Skip to main content

JS Kit SDK installation

Install JS Kit SDK v1 in an application that uses @solana/kit.

Install the packages​

Install the SDK and its Solana Kit peer dependency:

npm install @solana-name-service/sns-sdk-kit@^1 @solana/kit@^6.9.0

Requirements​

JS Kit SDK v1 requires Node.js 24 or newer.

Import the SDK​

The package root and category subpaths are supported. Use either style consistently with the application:

Package root
import {
  getPrimaryDomain,
  resolve,
  safeResolve,
} from "@solana-name-service/sns-sdk-kit";
Category subpaths
import { getPrimaryDomain } from "@solana-name-service/sns-sdk-kit/address";
import { resolve, safeResolve } from "@solana-name-service/sns-sdk-kit/domain";

CommonJS applications can load the same exports with require:

const { resolve, safeResolve } = require("@solana-name-service/sns-sdk-kit");

Use safeResolve when .sol resolution must require matching SRS and SNS targets after SRS-backed resolution is enabled.

RPC Configuration​

Create the typed RPC client passed to SDK operations with your Solana RPC endpoint:

import {
  createDefaultRpcTransport,
  createSolanaRpcFromTransport,
} from "@solana/kit";

const transport = createDefaultRpcTransport({
  url: "https://your-rpc-endpoint.example",
});
const rpc = createSolanaRpcFromTransport(transport);

Next​

Continue to the JS Kit SDK Quickstart to resolve a domain and query domain data.