# dns.getOffchainResolver

> For the complete documentation index, see [llms.txt](https://ensforge.com/llms.txt).

Reads the gasless DNS resolver a DNS name sets in an ENS1 TXT record. Options, result, errors and examples for dns.getOffchainResolver.

Source: https://ensforge.com/docs/reference/sdk/dns/get-offchain-resolver

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/dns/getOffchainResolver/index.ts#L56" batchable />

Reads the gasless DNS resolver a DNS name sets in an `ENS1` TXT record.

## When to use [#when-to-use]

Use to check a gasless DNS setup, which resolves without importing the name.

## Details [#details]

- Reads the TXT records of the name itself through the DNSSEC gateway, without verifying
  them on-chain.
- Picks the record the DNS TLD resolver uses: the first `ENS1 <resolver> [context]` record whose
  resolver is an address, or an ENS name with an address record. A record split into several
  strings (DNS splits values over 255 bytes) is read whole.
- `null` when the name has no such record.

## Signature [#signature]

```ts
function getOffchainResolver(
  client: Like,
  options: getOffchainResolver.Options,
): Promise<getOffchainResolver.ReturnType>
```

Call it as `ens.dns.getOffchainResolver(options)` on a client, or `Actions.dns.getOffchainResolver(client, options)`.

`dns.getOffchainResolver.request(options)` builds a deferred read for `Actions.batch`. See [Look up many at once](/docs/sdk/look-up-many-at-once).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | DNS name. Normalized automatically. |
| `gatewayUrls` | `readonly string[]` |  | DNSSEC gateways to use instead of the deployment's. |

Also takes the [read options](/docs/reference/sdk/client#read-options).

## Returns [#returns]

Resolves to `OffchainResolver | null`. The resolver and context, or `null`.

| Field | Type | Description |
| --- | --- | --- |
| `resolver` | `string` | Resolver address or ENS name the record points to. |
| `context` | `string \| null` | Extra data passed to the resolver, or `null`. |

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME) | names that are not DNS names. |
| [`GatewayError`](/docs/reference/errors/gateway-error) | [`GATEWAY_REQUEST_FAILED`](/docs/reference/errors/GATEWAY_REQUEST_FAILED), [`GATEWAY_RESPONSE_INVALID`](/docs/reference/errors/GATEWAY_RESPONSE_INVALID) | the DNSSEC gateway fails. |
| [`UnsupportedError`](/docs/reference/errors/unsupported-error) | [`UNSUPPORTED_ON_DEPLOYMENT`](/docs/reference/errors/UNSUPPORTED_ON_DEPLOYMENT) | without a DNSSEC gateway or `gatewayUrls`. |
| [`NetworkError`](/docs/reference/errors/network-error) | [`RPC_REQUEST_FAILED`](/docs/reference/errors/RPC_REQUEST_FAILED), [`RPC_TIMEOUT`](/docs/reference/errors/RPC_TIMEOUT), [`RATE_LIMITED`](/docs/reference/errors/RATE_LIMITED) | the RPC request fails. |

It can also fail with the errors every read can (`Errors.CommonError`: `ConfigError`, `ContractRevertError`, `InternalError`, `NetworkError`).

See [How errors work](/docs/sdk/errors-explained).

## Examples [#examples]

<Tabs groupId="api" items={["Client","Standalone","Effect"]} persist>
<Tab>
```ts title="Reading a gasless DNS resolver"
const offchain = await ens.dns.getOffchainResolver({ name: "example.com" })
```
</Tab>

<Tab>
```ts title="Reading a gasless DNS resolver with a standalone call"
import { Actions } from "@ensforge/sdk"

const offchain = await Actions.dns.getOffchainResolver(publicClient, { name: "example.com" })
```
</Tab>

<Tab>
```ts title="Reading a gasless DNS resolver in an Effect program"
import { Actions } from "@ensforge/sdk/effect"

const offchain = yield* Actions.dns.getOffchainResolver(ens, { name: "example.com" })
```
</Tab>
</Tabs>

## See also [#see-also]

- [`record.get`](/docs/reference/sdk/record/get) to resolve its records