import type { Chain, EncodeFunctionDataErrorType } from 'viem' import { encodeFunctionData, getAction } from 'viem/utils' import type { RequireClientContracts } from '../../../clients/chain.js' import type { Prettify } from '../../../types/index.js' import type { ExcludeTE } from '../../../types/internal.js' import { type DecodeContentHashResultErrorType, decodeContentHashResult, type GetContentHashErrorType, type GetContentHashParameters, type GetContentHashReturnType, getContentHashParameters, } from '../../../utils/resolver/getContentHash.js' import { type ResolveNameDataErrorType, resolveNameData, } from './resolveNameData.js' export type GetContentHashRecordParameters = Prettify< GetContentHashParameters & { /** Batch gateway URLs to use for resolving CCIP-read requests. */ gatewayUrls?: string[] /** Block number to read at. CCIP-read (offchain) responses are not pinned to this block. */ blockNumber?: bigint } > 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 async function getContentHashRecord( client: RequireClientContracts, { gatewayUrls, name, strict, blockNumber }: GetContentHashRecordParameters, ): Promise { const resolveNameDataAction = getAction( client as ExcludeTE, resolveNameData, 'resolveNameData', ) const result = await resolveNameDataAction({ name, data: encodeFunctionData(getContentHashParameters({ name })), gatewayUrls, strict, blockNumber, }) if (!result) return null return decodeContentHashResult(result.resolvedData, { strict }) }