@ensdomains/ensjs 4.1.2 → 5.0.0-alpha.0

package/dist/actions/dns/getDnsImportData.d.ts

@@ -0,0 +1,38 @@
+import { type Chain, type Hex } from 'viem';
+import type { RequireClientContracts } from '../../clients/chain.js';
+import { DnsNewerRecordTypeAvailableError } from '../../errors/dns.js';
+import type { Endpoint } from './types.js';
+export type GetDnsImportDataParameters = {
+    /** Name to prepare for DNS import */
+    name: string;
+    /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
+    endpoint?: Endpoint;
+};
+export type GetDnsImportDataReturnType = RrSetWithSig[];
+export type GetDnsImportDataErrorType = DnsNewerRecordTypeAvailableError | Error;
+export type RrSetWithSig = {
+    rrset: Hex;
+    sig: Hex;
+};
+/**
+ * Gets DNS import data, used for `importDnsName()`
+ * @param client - {@link Client}
+ * @param parameters - {@link GetDnsImportDataParameters}
+ * @returns DNS import data object, used for proving the value of the `_ens` TXT record
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsImportData } from '@ensdomains/ensjs/dns'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const data = await getDnsImportData(client, {
+ *   name: 'example.eth',
+ * })
+ */
+export declare function getDnsImportData<_chain extends Chain>(client: RequireClientContracts<_chain, 'ensDnssecImpl'>, { name, endpoint, }: GetDnsImportDataParameters): Promise<GetDnsImportDataReturnType>;
+//# sourceMappingURL=getDnsImportData.d.ts.map

package/dist/actions/dns/getDnsImportData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsImportData.d.ts","sourceRoot":"","sources":["../../../src/actions/dns/getDnsImportData.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,KAAK,EAGV,KAAK,GAAG,EAET,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAEpE,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,0BAA0B,GAAG;IACvC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,mGAAmG;IACnG,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,YAAY,EAAE,CAAA;AAEvD,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,GAAG,KAAK,CAAA;AAEhF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,GAAG,CAAA;IACV,GAAG,EAAE,GAAG,CAAA;CACT,CAAA;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,SAAS,KAAK,EACzD,MAAM,EAAE,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,EACvD,EACE,IAAI,EACJ,QAAiD,GAClD,EAAE,0BAA0B,GAC5B,OAAO,CAAC,0BAA0B,CAAC,CAsCrC"}

package/dist/actions/dns/getDnsImportData.js

@@ -0,0 +1,60 @@
+import { getChainContractAddress, toHex, } from 'viem';
+import { readContract } from 'viem/actions';
+import { dnssecImplVerifyRrSetSnippet } from '../../contracts/dnssecImpl.js';
+import { DnsNewerRecordTypeAvailableError } from '../../errors/dns.js';
+import { ASSERT_NO_TYPE_ERROR } from '../../types/internal.js';
+// Compares two serial numbers using RFC1982 serial number math.
+const serialNumberGt = (i1, i2) => (i1 < i2 && i2 - i1 > 0x7fffffff) || (i1 > i2 && i1 - i2 < 0x7fffffff);
+const encodeProofs = (proofs) => proofs.map((proof) => ({
+    rrset: toHex(proof.toWire(true)),
+    sig: toHex(proof.signature.data.signature),
+}));
+/**
+ * Gets DNS import data, used for `importDnsName()`
+ * @param client - {@link Client}
+ * @param parameters - {@link GetDnsImportDataParameters}
+ * @returns DNS import data object, used for proving the value of the `_ens` TXT record
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsImportData } from '@ensdomains/ensjs/dns'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const data = await getDnsImportData(client, {
+ *   name: 'example.eth',
+ * })
+ */
+export async function getDnsImportData(client, { name, endpoint = 'https://cloudflare-dns.com/dns-query', }) {
+    ASSERT_NO_TYPE_ERROR(client);
+    const { DNSProver } = await import('@ensdomains/dnsprovejs');
+    const prover = DNSProver.create(endpoint);
+    const result = (await prover.queryWithProof('TXT', `_ens.${name}`));
+    const allProofs = result.proofs.concat([result.answer]);
+    const rrsets = encodeProofs(allProofs);
+    const [onchainRrData, inception] = await readContract(client, {
+        abi: dnssecImplVerifyRrSetSnippet,
+        address: getChainContractAddress({
+            chain: client.chain,
+            contract: 'ensDnssecImpl',
+        }),
+        functionName: 'verifyRRSet',
+        args: [rrsets],
+    });
+    const lastProof = allProofs[allProofs.length - 1];
+    if (serialNumberGt(inception, lastProof.signature.data.inception))
+        throw new DnsNewerRecordTypeAvailableError({
+            typeCovered: lastProof.signature.data.typeCovered,
+            signatureName: lastProof.signature.name,
+            onchainInception: inception,
+            dnsInception: lastProof.signature.data.inception,
+        });
+    if (toHex(lastProof.toWire(false)) !== onchainRrData)
+        throw new Error('Mismatched proof data');
+    return rrsets;
+}
+//# sourceMappingURL=getDnsImportData.js.map

package/dist/actions/dns/getDnsImportData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsImportData.js","sourceRoot":"","sources":["../../../src/actions/dns/getDnsImportData.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,uBAAuB,EAEvB,KAAK,GACN,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAA;AAC5E,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAmB9D,gEAAgE;AAChE,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAU,EAAW,EAAE,CACzD,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,CAAA;AAExE,MAAM,YAAY,GAAG,CACnB,MAA4D,EAC5C,EAAE,CAClB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;CAC3C,CAAC,CAAC,CAAA;AAEL;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAuD,EACvD,EACE,IAAI,EACJ,QAAQ,GAAG,sCAAsC,GACtB;IAE7B,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC5B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzC,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CACzC,KAAK,EACL,QAAQ,IAAI,EAAE,CACf,CAAgC,CAAA;IAEjC,MAAM,SAAS,GACb,MAAM,CAAC,MACR,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IAEzB,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IAEtC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE;QAC5D,GAAG,EAAE,4BAA4B;QACjC,OAAO,EAAE,uBAAuB,CAAC;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,eAAe;SAC1B,CAAC;QACF,YAAY,EAAE,aAAa;QAC3B,IAAI,EAAE,CAAC,MAAM,CAAC;KACf,CAAC,CAAA;IAEF,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;IACjD,IAAI,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/D,MAAM,IAAI,gCAAgC,CAAC;YACzC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW;YACjD,aAAa,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI;YACvC,gBAAgB,EAAE,SAAS;YAC3B,YAAY,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS;SACjD,CAAC,CAAA;IAEJ,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,aAAa;QAClD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAE1C,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/actions/dns/getDnsOffchainData.d.ts

@@ -0,0 +1,40 @@
+import { type Address, type Chain } from 'viem';
+import type { RequireClientContracts } from '../../clients/chain.js';
+import { DnsDnssecVerificationFailedError, DnsDnssecWildcardExpansionError, DnsInvalidTxtRecordError, DnsNoTxtRecordError, DnsResponseStatusError } from '../../errors/dns.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import type { Endpoint } from './types.js';
+export type GetDnsOffchainDataParameters = {
+    /** Name to get the offchain data for */
+    name: string;
+    /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
+    endpoint?: Endpoint;
+    /** Whether or not to throw errors */
+    strict?: boolean;
+};
+export type GetDnsOffchainDataReturnType = {
+    resolverAddress: Address;
+    extraData: string | null;
+} | null;
+export type GetDnsOffchainDataErrorType = DnsDnssecVerificationFailedError | DnsDnssecWildcardExpansionError | DnsInvalidTxtRecordError | DnsNoTxtRecordError | DnsResponseStatusError | UnsupportedNameTypeError | Error;
+/**
+ * Gets the DNS offchain data for a name, via DNS record lookup
+ * @param client - {@link Client}
+ * @param parameters - {@link GetDnsOffchainDataParameters}
+ * @returns Resolver address and extra data, or null. {@link GetDnsOffchainDataReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsOffchainData } from '@ensdomains/ensjs/dns'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const data = await getDnsOffchainData(client, {
+ *   name: 'ethleaderboard.xyz',
+ * })
+ */
+export declare function getDnsOffchainData<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { name, endpoint, strict }: GetDnsOffchainDataParameters): Promise<GetDnsOffchainDataReturnType>;
+//# sourceMappingURL=getDnsOffchainData.d.ts.map

package/dist/actions/dns/getDnsOffchainData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsOffchainData.d.ts","sourceRoot":"","sources":["../../../src/actions/dns/getDnsOffchainData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,MAAM,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,EACL,gCAAgC,EAChC,+BAA+B,EAC/B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AASlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,4BAA4B,GAAG;IACzC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,mGAAmG;IACnG,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,eAAe,EAAE,OAAO,CAAA;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,GAAG,IAAI,CAAA;AAER,MAAM,MAAM,2BAA2B,GACnC,gCAAgC,GAChC,+BAA+B,GAC/B,wBAAwB,GACxB,mBAAmB,GACnB,sBAAsB,GACtB,wBAAwB,GACxB,KAAK,CAAA;AA8CT;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,SAAS,KAAK,EAC1D,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,4BAA4B,GACvD,OAAO,CAAC,4BAA4B,CAAC,CA0DvC"}

package/dist/actions/dns/getDnsOffchainData.js

@@ -0,0 +1,104 @@
+import { isAddress } from 'viem';
+import { DnsDnssecVerificationFailedError, DnsDnssecWildcardExpansionError, DnsInvalidTxtRecordError, DnsNoTxtRecordError, DnsResponseStatusError, } from '../../errors/dns.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import { getDnsTxtRecords } from '../../utils/dns/getDnsTxtRecords.js';
+import { DnsRecordType, DnsResponseStatus, } from '../../utils/dns/misc.js';
+import { getNameType } from '../../utils/name/getNameType.js';
+import { getAddressRecord } from '../public/getAddressRecord.js';
+async function checkValidEnsTxtRecord(client, record) {
+    if (record.type !== DnsRecordType.TXT)
+        return null;
+    if (!record.data.startsWith('"ENS1 '))
+        return null;
+    const unwrappedRecordData = record.data.replace(/^"(.*)"$/g, '$1');
+    const resolverAndExtraData = unwrappedRecordData.slice(5);
+    const splitIndex = resolverAndExtraData.indexOf(' ');
+    const resolverNameOrAddress = splitIndex === -1
+        ? resolverAndExtraData
+        : resolverAndExtraData.slice(0, splitIndex);
+    const extraData = splitIndex === -1 ? null : resolverAndExtraData.slice(splitIndex + 1);
+    if (isAddress(resolverNameOrAddress))
+        return { isValid: true, resolverAddress: resolverNameOrAddress, extraData };
+    const resolverAddress = await getAddressRecord(client, {
+        name: resolverNameOrAddress,
+        // force no ccip-read, since dnsregistrar doesn't allow resolvers with ccip-read addresses
+        gatewayUrls: [],
+    }).catch(() => null); // if ccip-read is attempted, an error will be thrown. we can just ignore it
+    if (resolverAddress)
+        return {
+            isValid: true,
+            resolverAddress: resolverAddress.value,
+            extraData,
+        };
+    return { isValid: false, recordData: unwrappedRecordData };
+}
+/**
+ * Gets the DNS offchain data for a name, via DNS record lookup
+ * @param client - {@link Client}
+ * @param parameters - {@link GetDnsOffchainDataParameters}
+ * @returns Resolver address and extra data, or null. {@link GetDnsOffchainDataReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsOffchainData } from '@ensdomains/ensjs/dns'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const data = await getDnsOffchainData(client, {
+ *   name: 'ethleaderboard.xyz',
+ * })
+ */
+export async function getDnsOffchainData(client, { name, endpoint, strict }) {
+    const nameType = getNameType(name);
+    if (nameType !== 'other-2ld' && nameType !== 'other-subname')
+        throw new UnsupportedNameTypeError({
+            nameType,
+            supportedNameTypes: ['other-2ld', 'other-subname'],
+        });
+    try {
+        const response = await getDnsTxtRecords({ name, endpoint });
+        if (response.Status !== DnsResponseStatus.NOERROR)
+            throw new DnsResponseStatusError({
+                responseStatus: DnsResponseStatus[response.Status],
+            });
+        if (response.AD === false)
+            throw new DnsDnssecVerificationFailedError({ record: undefined });
+        if (!response.Answer?.length)
+            throw new DnsNoTxtRecordError();
+        const labels = name.split('.');
+        const rrsigRecord = response.Answer.find((record) => {
+            if (record.type !== DnsRecordType.RRSIG)
+                return false;
+            if (record.name !== name)
+                return false;
+            if (!record.data.startsWith('TXT'))
+                return false;
+            const [, , labelCount] = record.data.split(' ');
+            // mismatching label count implies wildcard expansion, which is not supported
+            return Number(labelCount) === labels.length;
+        });
+        if (!rrsigRecord)
+            throw new DnsDnssecWildcardExpansionError();
+        const ensTxtRecords = await Promise.all(response.Answer.map((record) => checkValidEnsTxtRecord(client, record)));
+        const validRecord = ensTxtRecords.find((record) => record?.isValid === true);
+        if (validRecord)
+            return {
+                resolverAddress: validRecord.resolverAddress,
+                extraData: validRecord.extraData,
+            };
+        const invalidRecord = ensTxtRecords.find((record) => record?.isValid === false);
+        if (invalidRecord)
+            throw new DnsInvalidTxtRecordError({ record: invalidRecord.recordData });
+        throw new DnsNoTxtRecordError();
+    }
+    catch (error) {
+        if (!strict)
+            return null;
+        throw error;
+    }
+}
+//# sourceMappingURL=getDnsOffchainData.js.map

package/dist/actions/dns/getDnsOffchainData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsOffchainData.js","sourceRoot":"","sources":["../../../src/actions/dns/getDnsOffchainData.ts"],"names":[],"mappings":"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"}

package/dist/actions/dns/getDnsOwner.d.ts

@@ -0,0 +1,27 @@
+import { type Address } from 'viem';
+import { DnsDnssecVerificationFailedError, DnsInvalidAddressChecksumError, DnsInvalidTxtRecordError, DnsNoTxtRecordError, DnsResponseStatusError } from '../../errors/dns.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import type { Endpoint } from './types.js';
+export type GetDnsOwnerParameters = {
+    /** Name to get the owner for */
+    name: string;
+    /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
+    endpoint?: Endpoint;
+    /** Whether or not to throw errors */
+    strict?: boolean;
+};
+export type GetDnsOwnerReturnType = Address | null;
+export type GetDnsOwnerErrorType = DnsDnssecVerificationFailedError | DnsInvalidAddressChecksumError | DnsInvalidTxtRecordError | DnsNoTxtRecordError | DnsResponseStatusError | UnsupportedNameTypeError | Error;
+/**
+ * Gets the DNS owner of a name, via DNS record lookup
+ * @param parameters - {@link GetDnsOwnerParameters}
+ * @returns Address of DNS owner. {@link GetDnsOwnerReturnType}
+ *
+ * @example
+ * import { getDnsOwner } from '@ensdomains/ensjs/dns'
+ *
+ * const owner = await getDnsOwner({ name: 'ens.domains' })
+ * // '0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5'
+ */
+export declare function getDnsOwner({ name, endpoint, strict, }: GetDnsOwnerParameters): Promise<GetDnsOwnerReturnType>;
+//# sourceMappingURL=getDnsOwner.d.ts.map

package/dist/actions/dns/getDnsOwner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsOwner.d.ts","sourceRoot":"","sources":["../../../src/actions/dns/getDnsOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,MAAM,CAAA;AAC/C,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,MAAM,qBAAqB,GAAG;IAClC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,mGAAmG;IACnG,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,IAAI,CAAA;AAElD,MAAM,MAAM,oBAAoB,GAC5B,gCAAgC,GAChC,8BAA8B,GAC9B,wBAAwB,GACxB,mBAAmB,GACnB,sBAAsB,GACtB,wBAAwB,GACxB,KAAK,CAAA;AAET;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,EAChC,IAAI,EACJ,QAAQ,EACR,MAAM,GACP,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA8CxD"}

package/dist/actions/dns/getDnsOwner.js

@@ -0,0 +1,53 @@
+import { getAddress } from 'viem';
+import { DnsDnssecVerificationFailedError, DnsInvalidAddressChecksumError, DnsInvalidTxtRecordError, DnsNoTxtRecordError, DnsResponseStatusError, } from '../../errors/dns.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import { getDnsTxtRecords } from '../../utils/dns/getDnsTxtRecords.js';
+import { DnsRecordType, DnsResponseStatus } from '../../utils/dns/misc.js';
+import { getNameType } from '../../utils/name/getNameType.js';
+/**
+ * Gets the DNS owner of a name, via DNS record lookup
+ * @param parameters - {@link GetDnsOwnerParameters}
+ * @returns Address of DNS owner. {@link GetDnsOwnerReturnType}
+ *
+ * @example
+ * import { getDnsOwner } from '@ensdomains/ensjs/dns'
+ *
+ * const owner = await getDnsOwner({ name: 'ens.domains' })
+ * // '0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5'
+ */
+export async function getDnsOwner({ name, endpoint, strict, }) {
+    const nameType = getNameType(name);
+    if (nameType !== 'other-2ld')
+        throw new UnsupportedNameTypeError({
+            nameType,
+            supportedNameTypes: ['other-2ld'],
+        });
+    try {
+        const response = await getDnsTxtRecords({ name: `_ens.${name}`, endpoint });
+        if (response.Status !== DnsResponseStatus.NOERROR)
+            throw new DnsResponseStatusError({
+                responseStatus: DnsResponseStatus[response.Status],
+            });
+        const addressRecord = response.Answer?.find((record) => record.type === DnsRecordType.TXT);
+        const unwrappedAddressRecord = addressRecord?.data?.replace(/^"(.*)"$/g, '$1');
+        if (response.AD === false)
+            throw new DnsDnssecVerificationFailedError({
+                record: unwrappedAddressRecord,
+            });
+        if (!addressRecord?.data)
+            throw new DnsNoTxtRecordError();
+        if (!unwrappedAddressRecord?.match(/^a=0x[a-fA-F0-9]{40}$/g))
+            throw new DnsInvalidTxtRecordError({ record: unwrappedAddressRecord });
+        const address = unwrappedAddressRecord?.slice(2);
+        const checksumAddress = getAddress(address);
+        if (address !== checksumAddress)
+            throw new DnsInvalidAddressChecksumError({ address });
+        return checksumAddress;
+    }
+    catch (error) {
+        if (!strict)
+            return null;
+        throw error;
+    }
+}
+//# sourceMappingURL=getDnsOwner.js.map

package/dist/actions/dns/getDnsOwner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsOwner.js","sourceRoot":"","sources":["../../../src/actions/dns/getDnsOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,UAAU,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EACL,gCAAgC,EAChC,8BAA8B,EAC9B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAuB7D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAChC,IAAI,EACJ,QAAQ,EACR,MAAM,GACgB;IACtB,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAElC,IAAI,QAAQ,KAAK,WAAW;QAC1B,MAAM,IAAI,wBAAwB,CAAC;YACjC,QAAQ;YACR,kBAAkB,EAAE,CAAC,WAAW,CAAC;SAClC,CAAC,CAAA;IAEJ,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;QAE3E,IAAI,QAAQ,CAAC,MAAM,KAAK,iBAAiB,CAAC,OAAO;YAC/C,MAAM,IAAI,sBAAsB,CAAC;gBAC/B,cAAc,EAAE,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC;aACnD,CAAC,CAAA;QAEJ,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CACzC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,GAAG,CAC9C,CAAA;QACD,MAAM,sBAAsB,GAAG,aAAa,EAAE,IAAI,EAAE,OAAO,CACzD,WAAW,EACX,IAAI,CACL,CAAA;QAED,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK;YACvB,MAAM,IAAI,gCAAgC,CAAC;gBACzC,MAAM,EAAE,sBAAsB;aAC/B,CAAC,CAAA;QAEJ,IAAI,CAAC,aAAa,EAAE,IAAI;YAAE,MAAM,IAAI,mBAAmB,EAAE,CAAA;QAEzD,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,wBAAwB,CAAC;YAC1D,MAAM,IAAI,wBAAwB,CAAC,EAAE,MAAM,EAAE,sBAAuB,EAAE,CAAC,CAAA;QAEzE,MAAM,OAAO,GAAG,sBAAsB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;QAChD,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;QAE3C,IAAI,OAAO,KAAK,eAAe;YAC7B,MAAM,IAAI,8BAA8B,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;QAEvD,OAAO,eAAe,CAAA;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QACxB,MAAM,KAAK,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/actions/dns/importDnsName.d.ts

@@ -0,0 +1,64 @@
+import { type Account, type Address, type Client, type Hash, type Transport } from 'viem';
+import type { ChainWithEns } from '../../clients/chain.js';
+import { AdditionalParameterSpecifiedError } from '../../errors/general.js';
+import type { Prettify, SimpleTransactionRequest, WriteTransactionParameters } from '../../types/index.js';
+import type { GetDnsImportDataReturnType } from './getDnsImportData.js';
+type BaseImportDnsNameDataParameters = {
+    /** Name to import */
+    name: string;
+    /** Data returned from `getDnsImportData()` */
+    dnsImportData: GetDnsImportDataReturnType;
+    /** Address to claim the name for */
+    address?: Address;
+    /** Address of the resolver to use (default: `ensPublicResolver`) */
+    resolverAddress?: Address;
+};
+type NoResolverImportDnsNameDataParameters = {
+    address?: never;
+    resolverAddress?: never;
+};
+type ResolverImportDnsNameDataParameters = {
+    address: Address;
+    resolverAddress?: Address;
+};
+export type ImportDnsNameDataParameters = BaseImportDnsNameDataParameters & (NoResolverImportDnsNameDataParameters | ResolverImportDnsNameDataParameters);
+export type ImportDnsNameDataReturnType = SimpleTransactionRequest;
+export type ImportDnsNameParameters<TChain extends ChainWithEns, TAccount extends Account | undefined, TChainOverride extends ChainWithEns | undefined> = Prettify<ImportDnsNameDataParameters & WriteTransactionParameters<TChain, TAccount, TChainOverride>>;
+export type ImportDnsNameReturnType = Hash;
+export type ImportDnsNameErrorType = AdditionalParameterSpecifiedError | Error;
+export declare const makeFunctionData: <TChain extends ChainWithEns, TAccount extends Account | undefined>(wallet: Client<Transport, TChain, TAccount>, { name, dnsImportData, address, resolverAddress, }: ImportDnsNameDataParameters) => ImportDnsNameDataReturnType;
+/**
+ * Creates a transaction to import a DNS name to ENS.
+ * @param wallet - {@link ClientWithAccount}
+ * @param parameters - {@link ImportDnsNameParameters}
+ * @returns A transaction hash. {@link ImportDnsNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, createWalletClient, http, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsImportData, importDnsName } from '@ensdomains/ensjs/dns'
+ *
+ * const mainnetWithEns = addEnsContracts(mainnet)
+ * const client = createPublicClient({
+ *   chain: mainnetWithEns,
+ *   transport: http(),
+ * })
+ * const wallet = createWalletClient({
+ *   chain: mainnetWithEns,
+ *   transport: custom(window.ethereum),
+ * })
+ * const dnsImportData = await getDnsImportData(client, {
+ *   name: 'example.com',
+ * })
+ * const hash = await importDnsName(wallet, {
+ *   name: 'example.com',
+ *   dnsImportData,
+ * })
+ */
+export declare function importDnsName<TChain extends ChainWithEns, TAccount extends Account | undefined, TChainOverride extends ChainWithEns | undefined = ChainWithEns>(wallet: Client<Transport, TChain, TAccount>, { name, address, dnsImportData, resolverAddress, ...txArgs }: ImportDnsNameParameters<TChain, TAccount, TChainOverride>): Promise<ImportDnsNameReturnType>;
+export declare namespace importDnsName {
+    var makeFunctionData: <TChain extends ChainWithEns, TAccount extends Account | undefined>(wallet: Client<Transport, TChain, TAccount>, { name, dnsImportData, address, resolverAddress, }: ImportDnsNameDataParameters) => ImportDnsNameDataReturnType;
+}
+export {};
+//# sourceMappingURL=importDnsName.d.ts.map

package/dist/actions/dns/importDnsName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importDnsName.d.ts","sourceRoot":"","sources":["../../../src/actions/dns/importDnsName.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EAGX,KAAK,IAAI,EAET,KAAK,SAAS,EAEf,MAAM,MAAM,CAAA;AAGb,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAK1D,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAA;AAC3E,OAAO,KAAK,EACV,QAAQ,EACR,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAEvE,KAAK,+BAA+B,GAAG;IACrC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,aAAa,EAAE,0BAA0B,CAAA;IACzC,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,KAAK,qCAAqC,GAAG;IAC3C,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,eAAe,CAAC,EAAE,KAAK,CAAA;CACxB,CAAA;AAED,KAAK,mCAAmC,GAAG;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,+BAA+B,GACvE,CAAC,qCAAqC,GAAG,mCAAmC,CAAC,CAAA;AAE/E,MAAM,MAAM,2BAA2B,GAAG,wBAAwB,CAAA;AAElE,MAAM,MAAM,uBAAuB,CACjC,MAAM,SAAS,YAAY,EAC3B,QAAQ,SAAS,OAAO,GAAG,SAAS,EACpC,cAAc,SAAS,YAAY,GAAG,SAAS,IAC7C,QAAQ,CACV,2BAA2B,GACzB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,CAC/D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAA;AAE1C,MAAM,MAAM,sBAAsB,GAAG,iCAAiC,GAAG,KAAK,CAAA;AAE9E,eAAO,MAAM,gBAAgB,GAC3B,MAAM,SAAS,YAAY,EAC3B,QAAQ,SAAS,OAAO,GAAG,SAAS,EAEpC,QAAQ,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC3C,oDAKG,2BAA2B,KAC7B,2BAwCF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CACjC,MAAM,SAAS,YAAY,EAC3B,QAAQ,SAAS,OAAO,GAAG,SAAS,EACpC,cAAc,SAAS,YAAY,GAAG,SAAS,GAAG,YAAY,EAE9D,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC3C,EACE,IAAI,EACJ,OAAO,EACP,aAAa,EACb,eAAe,EACf,GAAG,MAAM,EACV,EAAE,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,GAC3D,OAAO,CAAC,uBAAuB,CAAC,CAYlC;yBAzBqB,aAAa;2BAjFjC,MAAM,SAAS,YAAY,EAC3B,QAAQ,SAAS,OAAO,GAAG,SAAS,UAE5B,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,sDAMxC,2BAA2B,KAC7B,2BAA2B"}

package/dist/actions/dns/importDnsName.js

@@ -0,0 +1,85 @@
+import { encodeFunctionData, getChainContractAddress, toHex, } from 'viem';
+import { sendTransaction } from 'viem/actions';
+import { packetToBytes } from 'viem/ens';
+import { dnsRegistrarProveAndClaimSnippet, dnsRegistrarProveAndClaimWithResolverSnippet, } from '../../contracts/dnsRegistrar.js';
+import { AdditionalParameterSpecifiedError } from '../../errors/general.js';
+export const makeFunctionData = (wallet, { name, dnsImportData, address, resolverAddress, }) => {
+    const hexEncodedName = toHex(packetToBytes(name));
+    const dnsRegistrarAddress = getChainContractAddress({
+        chain: wallet.chain,
+        contract: 'ensDnsRegistrar',
+    });
+    if (!address) {
+        if (resolverAddress)
+            throw new AdditionalParameterSpecifiedError({
+                parameter: 'resolverAddress',
+                allowedParameters: ['name', 'dnsImportData'],
+                details: 'resolverAddress cannot be specified when claiming without an address',
+            });
+        return {
+            to: dnsRegistrarAddress,
+            data: encodeFunctionData({
+                abi: dnsRegistrarProveAndClaimSnippet,
+                functionName: 'proveAndClaim',
+                args: [hexEncodedName, dnsImportData],
+            }),
+        };
+    }
+    const resolverAddress_ = resolverAddress ||
+        getChainContractAddress({
+            chain: wallet.chain,
+            contract: 'ensPublicResolver',
+        });
+    return {
+        to: dnsRegistrarAddress,
+        data: encodeFunctionData({
+            abi: dnsRegistrarProveAndClaimWithResolverSnippet,
+            functionName: 'proveAndClaimWithResolver',
+            args: [hexEncodedName, dnsImportData, resolverAddress_, address],
+        }),
+    };
+};
+/**
+ * Creates a transaction to import a DNS name to ENS.
+ * @param wallet - {@link ClientWithAccount}
+ * @param parameters - {@link ImportDnsNameParameters}
+ * @returns A transaction hash. {@link ImportDnsNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, createWalletClient, http, custom } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDnsImportData, importDnsName } from '@ensdomains/ensjs/dns'
+ *
+ * const mainnetWithEns = addEnsContracts(mainnet)
+ * const client = createPublicClient({
+ *   chain: mainnetWithEns,
+ *   transport: http(),
+ * })
+ * const wallet = createWalletClient({
+ *   chain: mainnetWithEns,
+ *   transport: custom(window.ethereum),
+ * })
+ * const dnsImportData = await getDnsImportData(client, {
+ *   name: 'example.com',
+ * })
+ * const hash = await importDnsName(wallet, {
+ *   name: 'example.com',
+ *   dnsImportData,
+ * })
+ */
+export async function importDnsName(wallet, { name, address, dnsImportData, resolverAddress, ...txArgs }) {
+    const data = makeFunctionData(wallet, {
+        name,
+        address,
+        dnsImportData,
+        resolverAddress,
+    });
+    const writeArgs = {
+        ...data,
+        ...txArgs,
+    };
+    return sendTransaction(wallet, writeArgs);
+}
+importDnsName.makeFunctionData = makeFunctionData;
+//# sourceMappingURL=importDnsName.js.map

package/dist/actions/dns/importDnsName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"importDnsName.js","sourceRoot":"","sources":["../../../src/actions/dns/importDnsName.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,uBAAuB,EAIvB,KAAK,GACN,MAAM,MAAM,CAAA;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EACL,gCAAgC,EAChC,4CAA4C,GAC7C,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAA;AA+C3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAI9B,MAA2C,EAC3C,EACE,IAAI,EACJ,aAAa,EACb,OAAO,EACP,eAAe,GACa,EACD,EAAE;IAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;QAClD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,iBAAiB;KAC5B,CAAC,CAAA;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,eAAe;YACjB,MAAM,IAAI,iCAAiC,CAAC;gBAC1C,SAAS,EAAE,iBAAiB;gBAC5B,iBAAiB,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC;gBAC5C,OAAO,EACL,sEAAsE;aACzE,CAAC,CAAA;QACJ,OAAO;YACL,EAAE,EAAE,mBAAmB;YACvB,IAAI,EAAE,kBAAkB,CAAC;gBACvB,GAAG,EAAE,gCAAgC;gBACrC,YAAY,EAAE,eAAe;gBAC7B,IAAI,EAAE,CAAC,cAAc,EAAE,aAAa,CAAC;aACtC,CAAC;SACH,CAAA;IACH,CAAC;IAED,MAAM,gBAAgB,GACpB,eAAe;QACf,uBAAuB,CAAC;YACtB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC,CAAA;IAEJ,OAAO;QACL,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,kBAAkB,CAAC;YACvB,GAAG,EAAE,4CAA4C;YACjD,YAAY,EAAE,2BAA2B;YACzC,IAAI,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC;SACjE,CAAC;KACH,CAAA;AACH,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAKjC,MAA2C,EAC3C,EACE,IAAI,EACJ,OAAO,EACP,aAAa,EACb,eAAe,EACf,GAAG,MAAM,EACiD;IAE5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE;QACpC,IAAI;QACJ,OAAO;QACP,aAAa;QACb,eAAe;KACe,CAAC,CAAA;IACjC,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI;QACP,GAAG,MAAM;KACqD,CAAA;IAChE,OAAO,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAC3C,CAAC;AAED,aAAa,CAAC,gBAAgB,GAAG,gBAAgB,CAAA"}

package/dist/actions/dns/types.d.ts

@@ -0,0 +1,2 @@
+export type Endpoint = `https://${string}` | `http://${string}`;
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/dns/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/dns/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,WAAW,MAAM,EAAE,GAAG,UAAU,MAAM,EAAE,CAAA"}

package/dist/actions/dns/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/actions/dns/types.ts"],"names":[],"mappings":""}

package/dist/actions/public/findResolver.d.ts

@@ -0,0 +1,7 @@
+import type { Chain } from "viem";
+import type { RequireClientContracts } from "../../clients/chain.js";
+export type FindResolverParameters = {
+    name: string;
+};
+export declare function findResolver<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { name }: FindResolverParameters): Promise<void>;
+//# sourceMappingURL=findResolver.d.ts.map

package/dist/actions/public/findResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findResolver.d.ts","sourceRoot":"","sources":["../../../src/actions/public/findResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,wBAAsB,YAAY,CAAC,KAAK,SAAS,KAAK,EACpD,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EAAE,IAAI,EAAE,EAAE,sBAAsB,iBAGjC"}

package/dist/actions/public/findResolver.js

@@ -0,0 +1,5 @@
+import { getAction } from 'viem/utils';
+export async function findResolver(client, { name }) {
+    const readContractAction = getAction;
+}
+//# sourceMappingURL=findResolver.js.map

package/dist/actions/public/findResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findResolver.js","sourceRoot":"","sources":["../../../src/actions/public/findResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAE,MAAM,YAAY,CAAC;AAOtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA6D,EAC7D,EAAE,IAAI,EAA0B;IAEhC,MAAM,kBAAkB,GAAG,SAAS,CAAA;AACtC,CAAC"}

package/dist/actions/public/getAbiRecord.d.ts

@@ -0,0 +1,32 @@
+import type { Chain, EncodeFunctionDataErrorType } from 'viem';
+import type { RequireClientContracts } from '../../clients/chain.js';
+import type { Prettify } from '../../types/index.js';
+import { type DecodeAbiResultErrorType, type DecodeAbiResultParameters, type DecodeAbiResultReturnType, type GetAbiParametersErrorType, type GetAbiParametersParameters } from '../../utils/coders/getAbi.js';
+import { type ResolveNameDataErrorType } from './resolveNameData.js';
+export type GetAbiRecordParameters = Prettify<GetAbiParametersParameters & DecodeAbiResultParameters & {
+    /** Batch gateway URLs to use for resolving CCIP-read requests. */
+    gatewayUrls?: string[];
+}>;
+export type GetAbiRecordReturnType = DecodeAbiResultReturnType | null;
+export type GetAbiRecordErrorType = ResolveNameDataErrorType | EncodeFunctionDataErrorType | GetAbiParametersErrorType | DecodeAbiResultErrorType;
+/**
+ * Gets the ABI record for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAbiRecordParameters}
+ * @returns ABI record for the name, or `null` if not found. {@link GetAbiRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAbiRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAbiRecord(client, { name: 'ens.eth' })
+ * // TODO: real example
+ */
+export declare function getAbiRecord<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { gatewayUrls, name, supportedContentTypes, strict }: GetAbiRecordParameters): Promise<GetAbiRecordReturnType>;
+//# sourceMappingURL=getAbiRecord.d.ts.map

package/dist/actions/public/getAbiRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAbiRecord.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getAbiRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,2BAA2B,EAAE,MAAM,MAAM,CAAA;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAE9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAEhC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,0BAA0B,GACxB,yBAAyB,GAAG;IAC1B,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CACJ,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,GAAG,IAAI,CAAA;AAErE,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,CAAA;AAE5B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,KAAK,SAAS,KAAK,EACpD,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAAE,EAAE,sBAAsB,GAC3E,OAAO,CAAC,sBAAsB,CAAC,CAcjC"}

package/dist/actions/public/getAbiRecord.js

@@ -0,0 +1,35 @@
+import { encodeFunctionData, getAction } from 'viem/utils';
+import { decodeAbiResult, getAbiParameters, } from '../../utils/coders/getAbi.js';
+import { resolveNameData, } from './resolveNameData.js';
+/**
+ * Gets the ABI record for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAbiRecordParameters}
+ * @returns ABI record for the name, or `null` if not found. {@link GetAbiRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAbiRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAbiRecord(client, { name: 'ens.eth' })
+ * // TODO: real example
+ */
+export async function getAbiRecord(client, { gatewayUrls, name, supportedContentTypes, strict }) {
+    const resolveNameDataAction = getAction(client, resolveNameData, 'resolveNameData');
+    const result = await resolveNameDataAction({
+        name,
+        data: encodeFunctionData(getAbiParameters({ name, supportedContentTypes })),
+        gatewayUrls,
+        strict,
+    });
+    if (!result)
+        return null;
+    return decodeAbiResult(result.resolvedData, { strict });
+}
+//# sourceMappingURL=getAbiRecord.js.map

package/dist/actions/public/getAbiRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAbiRecord.js","sourceRoot":"","sources":["../../../src/actions/public/getAbiRecord.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI1D,OAAO,EAIL,eAAe,EAGf,gBAAgB,GACjB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAEL,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAkB7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA6D,EAC7D,EAAE,WAAW,EAAE,IAAI,EAAE,qBAAqB,EAAE,MAAM,EAA0B;IAE5E,MAAM,qBAAqB,GAAG,SAAS,CACrC,MAAkC,EAClC,eAAe,EACf,iBAAiB,CAClB,CAAA;IACD,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC;QACzC,IAAI;QACJ,IAAI,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC,CAAC;QAC3E,WAAW;QACX,MAAM;KACP,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,eAAe,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AACzD,CAAC"}