> For the complete documentation index, see [llms.txt](https://basename.gitbook.io/bns-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://basename.gitbook.io/bns-docs/developer-guide/bns-sdk.md).

# BNS SDK

## Installation <a href="#installation" id="installation"></a>

```
npm install @basename/core
```

{% embed url="<https://www.npmjs.com/package/@basename/core>" %}

## Import SDK

```typescript
import { BNS } from '@basename/core';

// Create an instance of BNS
const bns = new BNS({
  rpcEndpoint: 'https://mainnet.base.org'
});
```

## Resolve .base name to address <a href="#domain-resolution" id="domain-resolution"></a>

```typescript
const address = await bns.getAddress('hello.base');
```

## Resolve address to .base name <a href="#reverse-resolution" id="reverse-resolution"></a>

```typescript
const name = await bns.getName('0x4fb3f133951bF1B2d52fF6CEab2c703fbB6E98cC');
```