@ensdomains/ensjs 4.1.1 → 5.0.0-alpha.0

package/dist/actions/public/getAddressRecord.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 DecodeAddressResultErrorType, type DecodeAddressResultParameters, type DecodeAddressResultReturnType, type GetAddressParametersErrorType, type GetAddressParametersParameters } from '../../utils/coders/getAddress.js';
+import { type ResolveNameDataErrorType } from './resolveNameData.js';
+export type GetAddressRecordParameters<coin extends string | number | undefined = undefined> = Prettify<GetAddressParametersParameters<coin> & DecodeAddressResultParameters<coin> & {
+    /** Batch gateway URLs to use for resolving CCIP-read requests. */
+    gatewayUrls?: string[];
+}>;
+export type GetAddressRecordReturnType<coin extends string | number | undefined = undefined> = DecodeAddressResultReturnType<coin>;
+export type GetAddressRecordErrorType = ResolveNameDataErrorType | EncodeFunctionDataErrorType | GetAddressParametersErrorType | DecodeAddressResultErrorType;
+/**
+ * Gets an address record for a name and specified coin
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAddressRecordParameters}
+ * @returns Coin value object, or `null` if not found. {@link GetAddressRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAddressRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAddressRecord(client, { name: 'ens.eth', coin: 'ETH' })
+ * // { id: 60, name: 'ETH , value: '0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7' }
+ */
+export declare function getAddressRecord<chain extends Chain, coin extends string | number | undefined = undefined>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { gatewayUrls, strict, name, bypassFormat, coin, }: GetAddressRecordParameters<coin>): Promise<GetAddressRecordReturnType<coin>>;
+//# sourceMappingURL=getAddressRecord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAddressRecord.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getAddressRecord.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,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAElC,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EAEpC,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,0BAA0B,CACpC,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,IAClD,QAAQ,CACV,8BAA8B,CAAC,IAAI,CAAC,GAClC,6BAA6B,CAAC,IAAI,CAAC,GAAG;IACpC,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CACJ,CAAA;AAED,MAAM,MAAM,0BAA0B,CACpC,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,IAClD,6BAA6B,CAAC,IAAI,CAAC,CAAA;AAEvC,MAAM,MAAM,yBAAyB,GACjC,wBAAwB,GACxB,2BAA2B,GAC3B,6BAA6B,GAC7B,4BAA4B,CAAA;AAEhC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,SAAS,KAAK,EACnB,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,EAEpD,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EACE,WAAW,EACX,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,IAAI,GACL,EAAE,0BAA0B,CAAC,IAAI,CAAC,GAClC,OAAO,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAgB3C"}

package/dist/actions/public/getAddressRecord.js

@@ -0,0 +1,35 @@
+import { encodeFunctionData, getAction } from 'viem/utils';
+import { decodeAddressResult, getAddressParameters, } from '../../utils/coders/getAddress.js';
+import { resolveNameData, } from './resolveNameData.js';
+/**
+ * Gets an address record for a name and specified coin
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAddressRecordParameters}
+ * @returns Coin value object, or `null` if not found. {@link GetAddressRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAddressRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAddressRecord(client, { name: 'ens.eth', coin: 'ETH' })
+ * // { id: 60, name: 'ETH , value: '0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7' }
+ */
+export async function getAddressRecord(client, { gatewayUrls, strict, name, bypassFormat, coin, }) {
+    const resolveNameDataAction = getAction(client, resolveNameData, 'resolveNameData');
+    const result = await resolveNameDataAction({
+        name,
+        data: encodeFunctionData(getAddressParameters({ name, bypassFormat, coin })),
+        gatewayUrls,
+        strict,
+    });
+    if (!result)
+        return null;
+    return decodeAddressResult(result.resolvedData, { strict, coin });
+}
+//# sourceMappingURL=getAddressRecord.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAddressRecord.js","sourceRoot":"","sources":["../../../src/actions/public/getAddressRecord.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI1D,OAAO,EAIL,mBAAmB,EAGnB,oBAAoB,GACrB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAEL,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAsB7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAIpC,MAA6D,EAC7D,EACE,WAAW,EACX,MAAM,EACN,IAAI,EACJ,YAAY,EACZ,IAAI,GAC6B;IAEnC,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,CACtB,oBAAoB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CACnD;QACD,WAAW;QACX,MAAM;KACP,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,mBAAmB,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;AACnE,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { Chain, GetChainContractAddressErrorType, ReadContractErrorType } from 'viem';
+import { type RequireClientContracts } from '../../clients/chain.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import type { ErrorType } from '../../errors/utils.js';
+export type GetAvailableParameters = {
+    /** Name to check availability for, only compatible for eth 2ld */
+    name: string;
+};
+export type GetAvailableReturnType = boolean;
+export type GetAvailableErrorType = UnsupportedNameTypeError | ReadContractErrorType | GetChainContractAddressErrorType | ErrorType;
+/**
+ * Gets the availability of a name to register
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAvailableParameters}
+ * @returns Availability as boolean. {@link GetAvailableReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAvailable } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAvailable(client, { name: 'ens.eth' })
+ * // false
+ */
+export declare function getAvailable<chain extends Chain>(client: RequireClientContracts<chain, 'ensL2EthRegistrar'>, { name }: GetAvailableParameters): Promise<GetAvailableReturnType>;
+//# sourceMappingURL=getAvailable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAvailable.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getAvailable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,gCAAgC,EAChC,qBAAqB,EACtB,MAAM,MAAM,CAAA;AAGb,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,MAAM,MAAM,sBAAsB,GAAG;IACnC,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAA;AAE5C,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,qBAAqB,GACrB,gCAAgC,GAChC,SAAS,CAAA;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAAC,KAAK,SAAS,KAAK,EACpD,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,CAAC,EAC1D,EAAE,IAAI,EAAE,EAAE,sBAAsB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAuBjC"}

package/dist/actions/public/getAvailable.js

@@ -0,0 +1,49 @@
+import { readContract } from 'viem/actions';
+import { getAction } from 'viem/utils';
+import { getChainContractAddress, } from '../../clients/chain.js';
+import { l2EthRegistrarAvailableSnippet } from '../../contracts/l2EthRegistrar.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import { ASSERT_NO_TYPE_ERROR } from '../../types/internal.js';
+import { getNameType } from '../../utils/name/getNameType.js';
+/**
+ * Gets the availability of a name to register
+ * @param client - {@link Client}
+ * @param parameters - {@link GetAvailableParameters}
+ * @returns Availability as boolean. {@link GetAvailableReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getAvailable } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getAvailable(client, { name: 'ens.eth' })
+ * // false
+ */
+export async function getAvailable(client, { name }) {
+    const labels = name.split('.');
+    const nameType = getNameType(name);
+    ASSERT_NO_TYPE_ERROR(client);
+    if (nameType !== 'eth-2ld')
+        throw new UnsupportedNameTypeError({
+            nameType,
+            supportedNameTypes: ['eth-2ld'],
+            details: 'Currently only eth-2ld names can be checked for availability',
+        });
+    const readContractAction = getAction(client, readContract, 'readContract');
+    const result = await readContractAction({
+        address: getChainContractAddress({
+            chain: client.chain,
+            contract: 'ensL2EthRegistrar',
+        }),
+        abi: l2EthRegistrarAvailableSnippet,
+        functionName: 'available',
+        args: [labels[0]],
+    });
+    return result;
+}
+//# sourceMappingURL=getAvailable.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getAvailable.js","sourceRoot":"","sources":["../../../src/actions/public/getAvailable.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EACL,uBAAuB,GAExB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAA;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAe7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAA0D,EAC1D,EAAE,IAAI,EAA0B;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAClC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,QAAQ,KAAK,SAAS;QACxB,MAAM,IAAI,wBAAwB,CAAC;YACjC,QAAQ;YACR,kBAAkB,EAAE,CAAC,SAAS,CAAC;YAC/B,OAAO,EAAE,8DAA8D;SACxE,CAAC,CAAA;IAEJ,MAAM,kBAAkB,GAAG,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,CAAC,CAAA;IAE1E,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,OAAO,EAAE,uBAAuB,CAAC;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,mBAAmB;SAC9B,CAAC;QACF,GAAG,EAAE,8BAA8B;QACnC,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KAClB,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/actions/public/getContentHashRecord.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 DecodeContentHashResultErrorType, type GetContentHashErrorType, type GetContentHashParameters, type GetContentHashReturnType } from '../../utils/coders/getContentHash.js';
+import { type ResolveNameDataErrorType } from './resolveNameData.js';
+export type GetContentHashRecordParameters = Prettify<GetContentHashParameters & {
+    /** Batch gateway URLs to use for resolving CCIP-read requests. */
+    gatewayUrls?: string[];
+}>;
+export type GetContentHashRecordReturnType = GetContentHashReturnType;
+export type GetContentHashRecordErrorType = GetContentHashErrorType | ResolveNameDataErrorType | EncodeFunctionDataErrorType | DecodeContentHashResultErrorType;
+/**
+ * Gets the content hash record for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetContentHashRecordParameters}
+ * @returns Content hash object, or `null` if not found. {@link GetContentHashRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getContentHashRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getContentHashRecord(client, { name: 'ens.eth' })
+ * // { protocolType: 'ipfs', decoded: 'k51qzi5uqu5djdczd6zw0grmo23j2vkj9uzvujencg15s5rlkq0ss4ivll8wqw' }
+ */
+export declare function getContentHashRecord<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { gatewayUrls, name, strict }: GetContentHashRecordParameters): Promise<GetContentHashRecordReturnType>;
+//# sourceMappingURL=getContentHashRecord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getContentHashRecord.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getContentHashRecord.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,gCAAgC,EAErC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAE9B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CACnD,wBAAwB,GAAG;IACzB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,CACF,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG,wBAAwB,CAAA;AAErE,MAAM,MAAM,6BAA6B,GACrC,uBAAuB,GACvB,wBAAwB,GACxB,2BAA2B,GAC3B,gCAAgC,CAAA;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,SAAS,KAAK,EAC5D,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,8BAA8B,GAC5D,OAAO,CAAC,8BAA8B,CAAC,CAczC"}

package/dist/actions/public/getContentHashRecord.js

@@ -0,0 +1,35 @@
+import { encodeFunctionData, getAction } from 'viem/utils';
+import { decodeContentHashResult, getContentHashParameters, } from '../../utils/coders/getContentHash.js';
+import { resolveNameData, } from './resolveNameData.js';
+/**
+ * Gets the content hash record for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetContentHashRecordParameters}
+ * @returns Content hash object, or `null` if not found. {@link GetContentHashRecordReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getContentHashRecord } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getContentHashRecord(client, { name: 'ens.eth' })
+ * // { protocolType: 'ipfs', decoded: 'k51qzi5uqu5djdczd6zw0grmo23j2vkj9uzvujencg15s5rlkq0ss4ivll8wqw' }
+ */
+export async function getContentHashRecord(client, { gatewayUrls, name, strict }) {
+    const resolveNameDataAction = getAction(client, resolveNameData, 'resolveNameData');
+    const result = await resolveNameDataAction({
+        name,
+        data: encodeFunctionData(getContentHashParameters({ name })),
+        gatewayUrls,
+        strict,
+    });
+    if (!result)
+        return null;
+    return decodeContentHashResult(result.resolvedData, { strict });
+}
+//# sourceMappingURL=getContentHashRecord.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getContentHashRecord.js","sourceRoot":"","sources":["../../../src/actions/public/getContentHashRecord.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI1D,OAAO,EAEL,uBAAuB,EAIvB,wBAAwB,GACzB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EAEL,eAAe,GAChB,MAAM,sBAAsB,CAAA;AAiB7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA6D,EAC7D,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAkC;IAE7D,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,wBAAwB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,WAAW;QACX,MAAM;KACP,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IACxB,OAAO,uBAAuB,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;AACjE,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { Chain } from 'viem';
+import type { RequireClientContracts } from '../../clients/chain.js';
+import type { ErrorType } from '../../errors/utils.js';
+import type { Prettify } from '../../types/index.js';
+import { type GetTextRecordErrorType, type GetTextRecordParameters } from './getTextRecord.js';
+export type GetCredentialsParameters = Prettify<Omit<GetTextRecordParameters, 'key'>>;
+export type GetCredentialsReturnType = ExternalCredential[] | null;
+export type GetCredentialsErrorType = GetTextRecordErrorType | ErrorType;
+export type ExternalCredential = {
+    url: string;
+};
+/**
+ * Gets credentials for a name.
+ * @param client - {@link Client}
+ * @param parameters - {@link GetCredentialsParameters}
+ * @returns Credentials, or null if none are found. {@link GetCredentialsReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getCredentials } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getCredentials(client, { name: 'ens.eth' })
+ * // [{ url: 'https://example.com' }]
+ */
+export declare function getCredentials<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { gatewayUrls, strict, name }: GetCredentialsParameters): Promise<GetCredentialsReturnType>;
+//# sourceMappingURL=getCredentials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCredentials.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getCredentials.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAE7B,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAC7C,IAAI,CAAC,uBAAuB,EAAE,KAAK,CAAC,CACrC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAA;AAElE,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,SAAS,CAAA;AAExE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAWD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,KAAK,SAAS,KAAK,EACtD,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,wBAAwB,GACtD,OAAO,CAAC,wBAAwB,CAAC,CAWnC"}

package/dist/actions/public/getCredentials.js

@@ -0,0 +1,41 @@
+import { getTextRecord, } from './getTextRecord.js';
+const parseCredentials = (credentials) => {
+    const externalCredentials = [];
+    for (const credential of credentials) {
+        if (URL.canParse(credential))
+            externalCredentials.push({ url: credential });
+    }
+    return externalCredentials;
+};
+/**
+ * Gets credentials for a name.
+ * @param client - {@link Client}
+ * @param parameters - {@link GetCredentialsParameters}
+ * @returns Credentials, or null if none are found. {@link GetCredentialsReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getCredentials } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getCredentials(client, { name: 'ens.eth' })
+ * // [{ url: 'https://example.com' }]
+ */
+export async function getCredentials(client, { gatewayUrls, strict, name }) {
+    const result = await getTextRecord(client, {
+        name,
+        key: 'verifications',
+        gatewayUrls,
+        strict,
+    });
+    if (!result)
+        return null;
+    const credential = JSON.parse(result);
+    return parseCredentials(credential);
+}
+//# sourceMappingURL=getCredentials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCredentials.js","sourceRoot":"","sources":["../../../src/actions/public/getCredentials.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,aAAa,GACd,MAAM,oBAAoB,CAAA;AAc3B,MAAM,gBAAgB,GAAG,CAAC,WAAqB,EAAE,EAAE;IACjD,MAAM,mBAAmB,GAAyB,EAAE,CAAA;IACpD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,mBAAmB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED,OAAO,mBAAmB,CAAA;AAC5B,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAA6D,EAC7D,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAA4B;IAEvD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;QACzC,IAAI;QACJ,GAAG,EAAE,eAAe;QACpB,WAAW;QACX,MAAM;KACP,CAAC,CAAA;IACF,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAa,CAAA;IACjD,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAA;AACrC,CAAC"}

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

@@ -0,0 +1,45 @@
+import { type Chain, type GetChainContractAddressErrorType, type LabelhashErrorType, type MulticallErrorType, type NamehashErrorType } from 'viem';
+import { type RequireClientContracts } from '../../clients/chain.js';
+import type { Prettify } from '../../types/index.js';
+type ContractOption = 'registrar' | 'nameWrapper' | 'l2Registrar';
+type ExpiryStatus = 'active' | 'expired' | 'gracePeriod';
+export type GetExpiryParameters = Prettify<{
+    /** Name to get expiry for */
+    name: string;
+    /** Optional specific contract to use to get expiry */
+    contract?: ContractOption;
+}>;
+export type GetExpiryReturnType = Prettify<{
+    /** Expiry value */
+    expiry: bigint;
+    /** Grace period value (in seconds) */
+    gracePeriod: number;
+    /** Status of name */
+    status: ExpiryStatus;
+} | null>;
+export type GetExpiryErrorType = MulticallErrorType | GetChainContractAddressErrorType | NamehashErrorType | LabelhashErrorType;
+/**
+ * Gets the expiry for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetExpiryParameters}
+ * @returns Expiry object, or `null` if no expiry. {@link GetExpiryReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getExpiry } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getExpiry(client, { name: 'ens.eth' })
+ * // { expiry: { date: Date, value: 1913933217n }, gracePeriod: 7776000, status: 'active' }
+ *
+ * // Using L2 registrar
+ * const l2Result = await getExpiry(client, { name: 'example.eth', contract: 'l2Registrar' })
+ */
+export declare function getExpiry<chain extends Chain>(client: RequireClientContracts<chain, 'ensNameWrapper' | 'ensBaseRegistrarImplementation' | 'ensRegistry' | 'multicall3'>, { name, contract: contractOption }: GetExpiryParameters): Promise<GetExpiryReturnType>;
+export {};
+//# sourceMappingURL=getExpiry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getExpiry.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getExpiry.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,gCAAgC,EACrC,KAAK,kBAAkB,EAEvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAEvB,MAAM,MAAM,CAAA;AAGb,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAA;AAS/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAKpD,KAAK,cAAc,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAA;AACjE,KAAK,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA;AAExD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,qBAAqB;IACrB,MAAM,EAAE,YAAY,CAAA;CACrB,GAAG,IAAI,CAAC,CAAA;AAET,MAAM,MAAM,kBAAkB,GAC1B,kBAAkB,GAClB,gCAAgC,GAChC,iBAAiB,GACjB,kBAAkB,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAAC,KAAK,SAAS,KAAK,EACjD,MAAM,EAAE,sBAAsB,CAC5B,KAAK,EACH,gBAAgB,GAChB,gCAAgC,GAChC,aAAa,GACb,YAAY,CACf,EACD,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,mBAAmB,GACtD,OAAO,CAAC,mBAAmB,CAAC,CAsI9B"}

package/dist/actions/public/getExpiry.js

@@ -0,0 +1,156 @@
+import { labelhash, namehash, } from 'viem';
+import { multicall } from 'viem/actions';
+import { getAction } from 'viem/utils';
+import { getChainContractAddress, } from '../../clients/chain.js';
+import { baseRegistrarGracePeriodSnippet, baseRegistrarNameExpiresSnippet, } from '../../contracts/baseRegistrar.js';
+import { multicallGetCurrentBlockTimestampSnippet } from '../../contracts/multicall.js';
+import { nameWrapperGetDataSnippet } from '../../contracts/nameWrapper.js';
+import { registryOwnerSnippet } from '../../contracts/registry.js';
+import { UnsupportedNameTypeError } from '../../errors/general.js';
+import { getNameType } from '../../utils/name/getNameType.js';
+import { checkIsDotEth } from '../../utils/name/validation.js';
+/**
+ * Gets the expiry for a name
+ * @param client - {@link Client}
+ * @param parameters - {@link GetExpiryParameters}
+ * @returns Expiry object, or `null` if no expiry. {@link GetExpiryReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getExpiry } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getExpiry(client, { name: 'ens.eth' })
+ * // { expiry: { date: Date, value: 1913933217n }, gracePeriod: 7776000, status: 'active' }
+ *
+ * // Using L2 registrar
+ * const l2Result = await getExpiry(client, { name: 'example.eth', contract: 'l2Registrar' })
+ */
+export async function getExpiry(client, { name, contract: contractOption }) {
+    const chain = client.chain;
+    const labels = name.split('.');
+    const contract = (() => {
+        if (contractOption) {
+            if ((contractOption === 'registrar' || contractOption === 'l2Registrar') &&
+                !checkIsDotEth(labels))
+                throw new UnsupportedNameTypeError({
+                    nameType: getNameType(name),
+                    supportedNameTypes: ['eth-2ld', 'tld'],
+                    details: 'Only the expiry of eth-2ld names can be fetched when using the registrar or l2Registrar contract',
+                });
+            return contractOption;
+        }
+        if (checkIsDotEth(labels))
+            return 'registrar';
+        return 'nameWrapper';
+    })();
+    const multicallAction = getAction(client, multicall, 'multicall');
+    const getCurrentBlockTimestampParameters = {
+        address: getChainContractAddress({
+            chain,
+            contract: 'multicall3',
+        }),
+        abi: multicallGetCurrentBlockTimestampSnippet,
+        functionName: 'getCurrentBlockTimestamp',
+    };
+    const [currentBlockTimestamp, expiry, gracePeriod] = await (async () => {
+        if (contract === 'nameWrapper') {
+            const [timestamp_, [, , expiry_]] = await multicallAction({
+                contracts: [
+                    getCurrentBlockTimestampParameters,
+                    {
+                        address: getChainContractAddress({
+                            chain,
+                            contract: 'ensNameWrapper',
+                        }),
+                        abi: nameWrapperGetDataSnippet,
+                        functionName: 'getData',
+                        args: [BigInt(namehash(name))],
+                    },
+                ],
+                allowFailure: false,
+            });
+            return [timestamp_, expiry_, 0n];
+        }
+        if (contract === 'l2Registrar') {
+            // For L2 registrars, we get the registry owner which should be the L2 registrar
+            // and query it for expiry information
+            const [timestamp_, registryOwner] = await multicallAction({
+                contracts: [
+                    getCurrentBlockTimestampParameters,
+                    {
+                        address: getChainContractAddress({
+                            chain,
+                            contract: 'ensRegistry',
+                        }),
+                        abi: registryOwnerSnippet,
+                        functionName: 'owner',
+                        args: [namehash(name)],
+                    },
+                ],
+                allowFailure: false,
+            });
+            // Now query the registry owner (L2 registrar) for expiry information
+            const [nameExpiry, gracePeriodValue] = await multicallAction({
+                contracts: [
+                    {
+                        address: registryOwner,
+                        abi: baseRegistrarNameExpiresSnippet,
+                        functionName: 'nameExpires',
+                        args: [BigInt(labelhash(labels[0]))],
+                    },
+                    {
+                        address: registryOwner,
+                        abi: baseRegistrarGracePeriodSnippet,
+                        functionName: 'GRACE_PERIOD',
+                    },
+                ],
+                allowFailure: false,
+            });
+            return [timestamp_, nameExpiry, gracePeriodValue];
+        }
+        return await multicallAction({
+            contracts: [
+                getCurrentBlockTimestampParameters,
+                {
+                    address: getChainContractAddress({
+                        chain,
+                        contract: 'ensBaseRegistrarImplementation',
+                    }),
+                    abi: baseRegistrarNameExpiresSnippet,
+                    functionName: 'nameExpires',
+                    args: [BigInt(labelhash(labels[0]))],
+                },
+                {
+                    address: getChainContractAddress({
+                        chain,
+                        contract: 'ensBaseRegistrarImplementation',
+                    }),
+                    abi: baseRegistrarGracePeriodSnippet,
+                    functionName: 'GRACE_PERIOD',
+                },
+            ],
+            allowFailure: false,
+        });
+    })();
+    if (expiry === 0n)
+        return null;
+    const status = (() => {
+        if (currentBlockTimestamp > expiry + gracePeriod)
+            return 'expired';
+        if (currentBlockTimestamp > expiry)
+            return 'gracePeriod';
+        return 'active';
+    })();
+    return {
+        expiry,
+        gracePeriod: Number(gracePeriod),
+        status,
+    };
+}
+//# sourceMappingURL=getExpiry.js.map

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

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

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

@@ -0,0 +1,62 @@
+import type { Address, Chain, GetAddressErrorType, GetChainContractAddressErrorType, ReadContractErrorType, ToHexErrorType } from 'viem';
+import type { PacketToBytesErrorType } from 'viem/ens';
+import { type RequireClientContracts } from '../../clients/chain.js';
+import type { ErrorType } from '../../errors/utils.js';
+import { type NormalizeErrorType } from '../../utils/name/normalize.js';
+type GetNameCoinTypeParameters = {
+    /** Coin type to use for reverse resolution */
+    coinType?: number;
+    chainId?: never;
+};
+type GetNameChainIdParameters = {
+    /** Chain ID to use for reverse resolution */
+    chainId?: number;
+    coinType?: never;
+};
+export type GetNameParameters = {
+    /** Address to get name for */
+    address: Address;
+    /** Whether or not to allow mismatched forward resolution */
+    allowMismatch?: boolean;
+    /** Whether or not to allow unnormalized name results (UNSAFE) */
+    allowUnnormalized?: boolean;
+    /** Whether or not to throw decoding errors */
+    strict?: boolean;
+    /** Batch gateway URLs to use for resolving CCIP-read requests. */
+    gatewayUrls?: string[];
+} & (GetNameCoinTypeParameters | GetNameChainIdParameters);
+export type GetNameReturnType = {
+    /** Primary name for address */
+    name: string;
+    /** Indicates if forward resolution for name matches address */
+    match: boolean;
+    /** Indicates if name is normalized */
+    normalized: boolean;
+    /** Resolver address for reverse node */
+    reverseResolverAddress: Address | null;
+    /** Resolver address for resolved name */
+    resolverAddress: Address | null;
+} | null;
+export type GetNameErrorType = ReadContractErrorType | GetChainContractAddressErrorType | ToHexErrorType | PacketToBytesErrorType | GetAddressErrorType | NormalizeErrorType | ErrorType;
+/**
+ * Gets the primary name for an address
+ * @param client - {@link Client}
+ * @param parameters - {@link GetNameParameters}
+ * @returns Name data object, or `null` if no primary name is set. {@link GetNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getName } from '@ensdomains/ensjs/public'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getName(client, { address: '0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5' })
+ * // { name: 'nick.eth', match: true, reverseResolverAddress: '0xa2c122be93b0074270ebee7f6b7292c7deb45047', resolverAddress: '0x4976fb03c32e5b8cfe2b6ccb31c09ba78ebaba41' }
+ */
+export declare function getName<chain extends Chain>(client: RequireClientContracts<chain, 'ensUniversalResolver'>, { address, allowUnnormalized, strict, gatewayUrls, chainId, coinType, allowMismatch, }: GetNameParameters): Promise<GetNameReturnType>;
+export {};
+//# sourceMappingURL=getName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getName.d.ts","sourceRoot":"","sources":["../../../src/actions/public/getName.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,mBAAmB,EACnB,gCAAgC,EAChC,qBAAqB,EACrB,cAAc,EACf,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAA;AAK/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAItD,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,+BAA+B,CAAA;AAGtC,KAAK,yBAAyB,GAAG;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB,GAAG,CAAC,yBAAyB,GAAG,wBAAwB,CAAC,CAAA;AAE1D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAA;IACd,sCAAsC;IACtC,UAAU,EAAE,OAAO,CAAA;IACnB,wCAAwC;IACxC,sBAAsB,EAAE,OAAO,GAAG,IAAI,CAAA;IACtC,yCAAyC;IACzC,eAAe,EAAE,OAAO,GAAG,IAAI,CAAA;CAChC,GAAG,IAAI,CAAA;AAER,MAAM,MAAM,gBAAgB,GACxB,qBAAqB,GACrB,gCAAgC,GAChC,cAAc,GACd,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,GAClB,SAAS,CAAA;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,OAAO,CAAC,KAAK,SAAS,KAAK,EAC/C,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,CAAC,EAC7D,EACE,OAAO,EACP,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,OAAO,EACP,QAAQ,EACR,aAAa,GACd,EAAE,iBAAiB,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAwD5B"}