@ensdomains/ensjs 3.3.0 → 3.4.1

package/dist/esm/utils/dns/misc.js

@@ -0,0 +1,31 @@
+export var DnsResponseStatus;
+(function (DnsResponseStatus) {
+    DnsResponseStatus[DnsResponseStatus["NOERROR"] = 0] = "NOERROR";
+    DnsResponseStatus[DnsResponseStatus["FORMERR"] = 1] = "FORMERR";
+    DnsResponseStatus[DnsResponseStatus["SERVFAIL"] = 2] = "SERVFAIL";
+    DnsResponseStatus[DnsResponseStatus["NXDOMAIN"] = 3] = "NXDOMAIN";
+    DnsResponseStatus[DnsResponseStatus["NOTIMP"] = 4] = "NOTIMP";
+    DnsResponseStatus[DnsResponseStatus["REFUSED"] = 5] = "REFUSED";
+    DnsResponseStatus[DnsResponseStatus["YXDOMAIN"] = 6] = "YXDOMAIN";
+    DnsResponseStatus[DnsResponseStatus["YXRRSET"] = 7] = "YXRRSET";
+    DnsResponseStatus[DnsResponseStatus["NXRRSET"] = 8] = "NXRRSET";
+    DnsResponseStatus[DnsResponseStatus["NOTAUTH"] = 9] = "NOTAUTH";
+    DnsResponseStatus[DnsResponseStatus["NOTZONE"] = 10] = "NOTZONE";
+    DnsResponseStatus[DnsResponseStatus["DSOTYPENI"] = 11] = "DSOTYPENI";
+    DnsResponseStatus[DnsResponseStatus["BADVERS"] = 16] = "BADVERS";
+    DnsResponseStatus[DnsResponseStatus["BADKEY"] = 17] = "BADKEY";
+    DnsResponseStatus[DnsResponseStatus["BADTIME"] = 18] = "BADTIME";
+    DnsResponseStatus[DnsResponseStatus["BADMODE"] = 19] = "BADMODE";
+    DnsResponseStatus[DnsResponseStatus["BADNAME"] = 20] = "BADNAME";
+    DnsResponseStatus[DnsResponseStatus["BADALG"] = 21] = "BADALG";
+    DnsResponseStatus[DnsResponseStatus["BADTRUNC"] = 22] = "BADTRUNC";
+    DnsResponseStatus[DnsResponseStatus["BADCOOKIE"] = 23] = "BADCOOKIE";
+})(DnsResponseStatus || (DnsResponseStatus = {}));
+export var DnsRecordType;
+(function (DnsRecordType) {
+    DnsRecordType[DnsRecordType["TXT"] = 16] = "TXT";
+    DnsRecordType[DnsRecordType["DS"] = 43] = "DS";
+    DnsRecordType[DnsRecordType["RRSIG"] = 46] = "RRSIG";
+    DnsRecordType[DnsRecordType["DNSKEY"] = 48] = "DNSKEY";
+})(DnsRecordType || (DnsRecordType = {}));
+//# sourceMappingURL=misc.js.map

package/dist/esm/utils/dns/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../../src/utils/dns/misc.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,iBAqBX;AArBD,WAAY,iBAAiB;IAC3B,+DAAW,CAAA;IACX,+DAAW,CAAA;IACX,iEAAY,CAAA;IACZ,iEAAY,CAAA;IACZ,6DAAU,CAAA;IACV,+DAAW,CAAA;IACX,iEAAY,CAAA;IACZ,+DAAW,CAAA;IACX,+DAAW,CAAA;IACX,+DAAW,CAAA;IACX,gEAAY,CAAA;IACZ,oEAAc,CAAA;IACd,gEAAY,CAAA;IACZ,8DAAW,CAAA;IACX,gEAAY,CAAA;IACZ,gEAAY,CAAA;IACZ,gEAAY,CAAA;IACZ,8DAAW,CAAA;IACX,kEAAa,CAAA;IACb,oEAAc,CAAA;AAChB,CAAC,EArBW,iBAAiB,KAAjB,iBAAiB,QAqB5B;AAED,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,gDAAQ,CAAA;IACR,8CAAO,CAAA;IACP,oDAAU,CAAA;IACV,sDAAW,CAAA;AACb,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB"}

package/dist/esm/utils/index.js

@@ -1,3 +1,5 @@
+export { getDnsTxtRecords, } from './dns/getDnsTxtRecords.js';
+export { DnsRecordType, DnsResponseStatus, } from './dns/misc.js';
 export { contentTypeToEncodeAs, encodeAbi, encodeAsToContentType, } from './encoders/encodeAbi.js';
 export { encodeClearRecords } from './encoders/encodeClearRecords.js';
 export { encodeSetAbi, } from './encoders/encodeSetAbi.js';

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,qBAAqB,GAItB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EACL,YAAY,GAGb,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,oBAAoB,GAGrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,WAAW,GAQZ,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GAGnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EACL,QAAQ,EACR,KAAK,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,QAAQ,GAWT,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,GAIb,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,aAAa,EACb,UAAU,EACV,YAAY,GAEb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,UAAU,EACV,cAAc,EACd,uBAAuB,GACxB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAGjB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,aAAa,EACb,iBAAiB,GAIlB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,qBAAqB,EACrB,SAAS,EACT,qBAAqB,GAItB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EACL,YAAY,GAGb,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,oBAAoB,GAGrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,EACL,aAAa,GAGd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,qBAAqB,GACtB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,uBAAuB,EACvB,eAAe,EACf,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,WAAW,GAQZ,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GAGnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,uBAAuB,GAExB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,EACL,QAAQ,EACR,KAAK,EACL,eAAe,EACf,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,QAAQ,GAWT,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,GAIb,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,aAAa,EACb,UAAU,EACV,YAAY,GAEb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,UAAU,EACV,cAAc,EACd,uBAAuB,GACxB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAA"}

package/dist/types/contracts/consts.d.ts

@@ -17,7 +17,7 @@ export declare const addresses: {
             readonly address: "0xa12159e5131b1eEf6B4857EEE3e1954744b5033A";
         };
         readonly ensDnsRegistrar: {
-            readonly address: "0x58774Bb8acD458A640aF0B88238369A167546ef2";
+            readonly address: "0x6BD6e91aDDFd4747baB4BD011590e463296707Aa";
         };
         readonly ensDnssecImpl: {
             readonly address: "0x0fc3152971714E5ed7723FAFa650F86A4BaF30C5";

package/dist/types/dns.d.ts

@@ -1,4 +1,5 @@
 export { default as getDnsImportData, type GetDnsImportDataParameters, type GetDnsImportDataReturnType, } from './functions/dns/getDnsImportData.js';
+export { default as getDnsOffchainData, type GetDnsOffchainDataParameters, type GetDnsOffchainDataReturnType, } from './functions/dns/getDnsOffchainData.js';
 export { default as getDnsOwner, type GetDnsOwnerParameters, type GetDnsOwnerReturnType, } from './functions/dns/getDnsOwner.js';
 export { default as importDnsName, type ImportDnsNameDataParameters, type ImportDnsNameDataReturnType, type ImportDnsNameParameters, type ImportDnsNameReturnType, } from './functions/dns/importDnsName.js';
 export type { Endpoint } from './functions/dns/types.js';

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

@@ -1 +1 @@
-{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../src/dns.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAA;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"dns.d.ts","sourceRoot":"","sources":["../../src/dns.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,IAAI,gBAAgB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,OAAO,IAAI,kBAAkB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EACL,OAAO,IAAI,WAAW,EACtB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAA;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/types/errors/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "v3.3.0";
+export declare const version = "v3.4.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/functions/dns/getDnsOffchainData.d.ts

@@ -0,0 +1,28 @@
+import { type Address, type Client, type Transport } from 'viem';
+import type { ChainWithEns } from '../../contracts/consts.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;
+/**
+ * Gets the DNS offchain data for a name, via DNS record lookup
+ * @param parameters - {@link GetDnsOffchainDataParameters}
+ * @returns Resolver address and extra data, or null. {@link GetDnsOffchainDataReturnType}
+ *
+ * @example
+ * import { getDnsOffchainData } from '@ensdomains/ensjs/dns'
+ *
+ * const owner = await getDnsOffchainData({ name: 'ethleaderboard.xyz' })
+ */
+declare const getDnsOffchainData: (client: Client<Transport, ChainWithEns>, { name, endpoint, strict }: GetDnsOffchainDataParameters) => Promise<GetDnsOffchainDataReturnType>;
+export default getDnsOffchainData;
+//# sourceMappingURL=getDnsOffchainData.d.ts.map

package/dist/types/functions/dns/getDnsOffchainData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsOffchainData.d.ts","sourceRoot":"","sources":["../../../../src/functions/dns/getDnsOffchainData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,MAAM,MAAM,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAgB7D,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;AA8CR;;;;;;;;;GASG;AACH,QAAA,MAAM,kBAAkB,WACd,OAAO,SAAS,EAAE,YAAY,CAAC,8BACX,4BAA4B,KACvD,QAAQ,4BAA4B,CA8CtC,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/types/functions/dns/getDnsOwner.d.ts

@@ -5,10 +5,10 @@ export type GetDnsOwnerParameters = {
     name: string;
     /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
     endpoint?: Endpoint;
-    /** Optional flag to allow the function to fail silently (default: `true`) */
-    allowFailure?: boolean;
+    /** Whether or not to throw errors */
+    strict?: boolean;
 };
-export type GetDnsOwnerReturnType = Address;
+export type GetDnsOwnerReturnType = Address | null;
 /**
  * Gets the DNS owner of a name, via DNS record lookup
  * @param parameters - {@link GetDnsOwnerParameters}
@@ -20,6 +20,6 @@ export type GetDnsOwnerReturnType = Address;
  * const owner = await getDnsOwner({ name: 'ens.domains' })
  * // '0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5'
  */
-declare const getDnsOwner: ({ name, endpoint, }: GetDnsOwnerParameters) => Promise<GetDnsOwnerReturnType>;
+declare const getDnsOwner: ({ name, endpoint, strict, }: GetDnsOwnerParameters) => Promise<GetDnsOwnerReturnType>;
 export default getDnsOwner;
 //# sourceMappingURL=getDnsOwner.d.ts.map

package/dist/types/functions/dns/getDnsOwner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getDnsOwner.d.ts","sourceRoot":"","sources":["../../../../src/functions/dns/getDnsOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAU/C,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,6EAA6E;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAA;AAyD3C;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW,wBAGd,qBAAqB,KAAG,QAAQ,qBAAqB,CA8CvD,CAAA;AAED,eAAe,WAAW,CAAA"}
+{"version":3,"file":"getDnsOwner.d.ts","sourceRoot":"","sources":["../../../../src/functions/dns/getDnsOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,MAAM,CAAA;AAY/C,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;;;;;;;;;;GAUG;AACH,QAAA,MAAM,WAAW,gCAId,qBAAqB,KAAG,QAAQ,qBAAqB,CA8CvD,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/types/utils/dns/getDnsTxtRecords.d.ts

@@ -0,0 +1,21 @@
+import type { Endpoint } from '../../functions/dns/types.js';
+import { type DnsResponse } from './misc.js';
+export type GetDnsTxtRecordsParameters = {
+    /** Name to get the txt records for */
+    name: string;
+    /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
+    endpoint?: Endpoint;
+};
+export type GetDnsTxtRecordsReturnType = DnsResponse;
+/**
+ * Gets the DNS record response of a name, via DNS record lookup
+ * @param parameters - {@link GetDnsTxtRecordsParameters}
+ * @returns DNS response. {@link GetDnsTxtRecordsReturnType}
+ *
+ * @example
+ * import { getDnsTxtRecords } from '@ensdomains/ensjs/utils'
+ *
+ * const owner = await getDnsTxtRecords({ name: '_ens.ens.domains' })
+ */
+export declare const getDnsTxtRecords: ({ name, endpoint, }: GetDnsTxtRecordsParameters) => Promise<GetDnsTxtRecordsReturnType>;
+//# sourceMappingURL=getDnsTxtRecords.d.ts.map

package/dist/types/utils/dns/getDnsTxtRecords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDnsTxtRecords.d.ts","sourceRoot":"","sources":["../../../../src/utils/dns/getDnsTxtRecords.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,MAAM,0BAA0B,GAAG;IACvC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,mGAAmG;IACnG,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAEpD;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,wBAG1B,0BAA0B,KAAG,QAAQ,0BAA0B,CAYjE,CAAA"}

package/dist/types/utils/dns/misc.d.ts

@@ -0,0 +1,50 @@
+export declare enum DnsResponseStatus {
+    NOERROR = 0,
+    FORMERR = 1,
+    SERVFAIL = 2,
+    NXDOMAIN = 3,
+    NOTIMP = 4,
+    REFUSED = 5,
+    YXDOMAIN = 6,
+    YXRRSET = 7,
+    NXRRSET = 8,
+    NOTAUTH = 9,
+    NOTZONE = 10,
+    DSOTYPENI = 11,
+    BADVERS = 16,
+    BADKEY = 17,
+    BADTIME = 18,
+    BADMODE = 19,
+    BADNAME = 20,
+    BADALG = 21,
+    BADTRUNC = 22,
+    BADCOOKIE = 23
+}
+export declare enum DnsRecordType {
+    TXT = 16,
+    DS = 43,
+    RRSIG = 46,
+    DNSKEY = 48
+}
+export type DnsQuestionItem = {
+    name: string;
+    type: DnsRecordType;
+};
+export type DnsResponseItem = DnsQuestionItem & {
+    TTL: number;
+    data: string;
+};
+export type DnsResponse = {
+    Status: DnsResponseStatus;
+    TC: boolean;
+    RD: boolean;
+    RA: boolean;
+    AD: boolean;
+    CD: boolean;
+    Question: DnsQuestionItem[];
+    Answer?: DnsResponseItem[];
+    Authority?: DnsResponseItem[];
+    Additional?: DnsResponseItem[];
+    Comment?: string;
+};
+//# sourceMappingURL=misc.d.ts.map

package/dist/types/utils/dns/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../../src/utils/dns/misc.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,OAAO,IAAI;IACX,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,QAAQ,IAAI;IACZ,MAAM,IAAI;IACV,OAAO,IAAI;IACX,QAAQ,IAAI;IACZ,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,IAAI;IACX,OAAO,KAAK;IACZ,SAAS,KAAK;IACd,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,MAAM,KAAK;IACX,QAAQ,KAAK;IACb,SAAS,KAAK;CACf;AAED,oBAAY,aAAa;IACvB,GAAG,KAAK;IACR,EAAE,KAAK;IACP,KAAK,KAAK;IACV,MAAM,KAAK;CACZ;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,iBAAiB,CAAA;IACzB,EAAE,EAAE,OAAO,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;IACX,EAAE,EAAE,OAAO,CAAA;IACX,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAC1B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;IAC7B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA"}

package/dist/types/utils/index.d.ts

@@ -1,3 +1,5 @@
+export { getDnsTxtRecords, type GetDnsTxtRecordsParameters, type GetDnsTxtRecordsReturnType, } from './dns/getDnsTxtRecords.js';
+export { DnsRecordType, DnsResponseStatus, type DnsQuestionItem, type DnsResponse, type DnsResponseItem, } from './dns/misc.js';
 export { contentTypeToEncodeAs, encodeAbi, encodeAsToContentType, type EncodeAbiParameters, type EncodeAbiReturnType, type EncodedAbi, } from './encoders/encodeAbi.js';
 export { encodeClearRecords } from './encoders/encodeClearRecords.js';
 export { encodeSetAbi, type EncodeSetAbiParameters, type EncodeSetAbiReturnType, } from './encoders/encodeSetAbi.js';

package/dist/types/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -16,7 +16,7 @@
   "peerDependencies": {
     "viem": "^1.16.4"
   },
-  "version": "3.3.0",
+  "version": "3.4.1",
   "files": [
     "dist/",
     "src/",

package/src/contracts/consts.ts

@@ -44,7 +44,7 @@ export const addresses = {
       address: '0xa12159e5131b1eEf6B4857EEE3e1954744b5033A',
     },
     ensDnsRegistrar: {
-      address: '0x58774Bb8acD458A640aF0B88238369A167546ef2',
+      address: '0x6BD6e91aDDFd4747baB4BD011590e463296707Aa',
     },
     ensDnssecImpl: {
       address: '0x0fc3152971714E5ed7723FAFa650F86A4BaF30C5',

package/src/dns.ts

@@ -3,6 +3,11 @@ export {
   type GetDnsImportDataParameters,
   type GetDnsImportDataReturnType,
 } from './functions/dns/getDnsImportData.js'
+export {
+  default as getDnsOffchainData,
+  type GetDnsOffchainDataParameters,
+  type GetDnsOffchainDataReturnType,
+} from './functions/dns/getDnsOffchainData.js'
 export {
   default as getDnsOwner,
   type GetDnsOwnerParameters,

package/src/errors/version.ts

@@ -1 +1 @@
-export const version = 'v3.3.0'
+export const version = 'v3.4.1'

package/src/functions/dns/getDnsOffchainData.ts

@@ -0,0 +1,139 @@
+import { isAddress, type Address, type Client, type Transport } from 'viem'
+import type { ChainWithEns } from '../../contracts/consts.js'
+import {
+  DnsDnssecVerificationFailedError,
+  DnsInvalidTxtRecordError,
+  DnsNoTxtRecordError,
+  DnsResponseStatusError,
+} from '../../errors/dns.js'
+import { UnsupportedNameTypeError } from '../../errors/general.js'
+import { getDnsTxtRecords } from '../../utils/dns/getDnsTxtRecords.js'
+import {
+  DnsRecordType,
+  DnsResponseStatus,
+  type DnsResponseItem,
+} from '../../utils/dns/misc.js'
+import { getNameType } from '../../utils/getNameType.js'
+import getAddressRecord from '../public/getAddressRecord.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
+
+type ValidTextRecord = {
+  isValid: true
+  resolverAddress: Address
+  extraData: string | null
+}
+type InvalidTextRecord = { isValid: false; recordData: string }
+
+const checkValidEnsTxtRecord = async (
+  client: Client<Transport, ChainWithEns>,
+  record: DnsResponseItem,
+): Promise<InvalidTextRecord | ValidTextRecord | null> => {
+  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 as Address,
+      extraData,
+    }
+
+  return { isValid: false, recordData: unwrappedRecordData }
+}
+
+/**
+ * Gets the DNS offchain data for a name, via DNS record lookup
+ * @param parameters - {@link GetDnsOffchainDataParameters}
+ * @returns Resolver address and extra data, or null. {@link GetDnsOffchainDataReturnType}
+ *
+ * @example
+ * import { getDnsOffchainData } from '@ensdomains/ensjs/dns'
+ *
+ * const owner = await getDnsOffchainData({ name: 'ethleaderboard.xyz' })
+ */
+const getDnsOffchainData = async (
+  client: Client<Transport, ChainWithEns>,
+  { name, endpoint, strict }: GetDnsOffchainDataParameters,
+): Promise<GetDnsOffchainDataReturnType> => {
+  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 ensTxtRecords = await Promise.all(
+      response.Answer.map((record) => checkValidEnsTxtRecord(client, record)),
+    )
+
+    const validRecord = ensTxtRecords.find(
+      (record): record is ValidTextRecord => record?.isValid === true,
+    )
+    if (validRecord)
+      return {
+        resolverAddress: validRecord.resolverAddress,
+        extraData: validRecord.extraData,
+      }
+
+    const invalidRecord = ensTxtRecords.find(
+      (record): record is InvalidTextRecord => record?.isValid === false,
+    )
+    if (invalidRecord)
+      throw new DnsInvalidTxtRecordError({ record: invalidRecord.recordData })
+
+    throw new DnsNoTxtRecordError()
+  } catch (error) {
+    if (!strict) return null
+    throw error
+  }
+}
+
+export default getDnsOffchainData

package/src/functions/dns/getDnsOwner.ts

@@ -7,6 +7,8 @@ import {
   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/getNameType.js'
 import type { Endpoint } from './types.js'
 
@@ -15,66 +17,11 @@ export type GetDnsOwnerParameters = {
   name: string
   /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
   endpoint?: Endpoint
-  /** Optional flag to allow the function to fail silently (default: `true`) */
-  allowFailure?: boolean
+  /** Whether or not to throw errors */
+  strict?: boolean
 }
 
-export type GetDnsOwnerReturnType = Address
-
-enum DnsResponseStatus {
-  NOERROR = 0,
-  FORMERR = 1,
-  SERVFAIL = 2,
-  NXDOMAIN = 3,
-  NOTIMP = 4,
-  REFUSED = 5,
-  YXDOMAIN = 6,
-  YXRRSET = 7,
-  NXRRSET = 8,
-  NOTAUTH = 9,
-  NOTZONE = 10,
-  DSOTYPENI = 11,
-  BADVERS = 16,
-  BADSIG = 16,
-  BADKEY = 17,
-  BADTIME = 18,
-  BADMODE = 19,
-  BADNAME = 20,
-  BADALG = 21,
-  BADTRUNC = 22,
-  BADCOOKIE = 23,
-}
-
-enum DnsRecordType {
-  TXT = 16,
-  DS = 43,
-  RRSIG = 46,
-  DNSKEY = 48,
-}
-
-type DnsQuestionItem = {
-  name: string
-  type: DnsRecordType
-}
-
-type DnsResponseItem = DnsQuestionItem & {
-  TTL: number
-  data: string
-}
-
-type DnsResponse = {
-  Status: DnsResponseStatus
-  TC: boolean
-  RD: boolean
-  RA: boolean
-  AD: boolean
-  CD: boolean
-  Question: DnsQuestionItem[]
-  Answer?: DnsResponseItem[]
-  Authority?: DnsResponseItem[]
-  Additional?: DnsResponseItem[]
-  Comment?: string
-}
+export type GetDnsOwnerReturnType = Address | null
 
 /**
  * Gets the DNS owner of a name, via DNS record lookup
@@ -89,7 +36,8 @@ type DnsResponse = {
  */
 const getDnsOwner = async ({
   name,
-  endpoint = 'https://cloudflare-dns.com/dns-query',
+  endpoint,
+  strict,
 }: GetDnsOwnerParameters): Promise<GetDnsOwnerReturnType> => {
   const nameType = getNameType(name)
 
@@ -99,43 +47,43 @@ const getDnsOwner = async ({
       supportedNameTypes: ['other-2ld'],
     })
 
-  const response: DnsResponse = await fetch(
-    `${endpoint}?name=_ens.${name}.&type=TXT`,
-    {
-      method: 'GET',
-      headers: {
-        accept: 'application/dns-json',
-      },
-    },
-  ).then((res) => res.json())
+  try {
+    const response = await getDnsTxtRecords({ name: `_ens.${name}`, endpoint })
 
-  if (response.Status !== DnsResponseStatus.NOERROR)
-    throw new DnsResponseStatusError({
-      responseStatus: DnsResponseStatus[response.Status],
-    })
+    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')
+    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 (response.AD === false)
+      throw new DnsDnssecVerificationFailedError({
+        record: unwrappedAddressRecord,
+      })
 
-  if (!addressRecord?.data) throw new DnsNoTxtRecordError()
+    if (!addressRecord?.data) throw new DnsNoTxtRecordError()
 
-  if (!unwrappedAddressRecord!.match(/^a=0x[a-fA-F0-9]{40}$/g))
-    throw new DnsInvalidTxtRecordError({ record: unwrappedAddressRecord! })
+    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)
+    const address = unwrappedAddressRecord!.slice(2)
+    const checksumAddress = getAddress(address)
 
-  if (address !== checksumAddress)
-    throw new DnsInvalidAddressChecksumError({ address })
+    if (address !== checksumAddress)
+      throw new DnsInvalidAddressChecksumError({ address })
 
-  return checksumAddress
+    return checksumAddress
+  } catch (error) {
+    if (!strict) return null
+    throw error
+  }
 }
 
 export default getDnsOwner

package/src/utils/dns/getDnsTxtRecords.ts

@@ -0,0 +1,38 @@
+import type { Endpoint } from '../../functions/dns/types.js'
+import { type DnsResponse } from './misc.js'
+
+export type GetDnsTxtRecordsParameters = {
+  /** Name to get the txt records for */
+  name: string
+  /** An RFC-1035 compatible DNS endpoint to use (default: `https://cloudflare-dns.com/dns-query`) */
+  endpoint?: Endpoint
+}
+
+export type GetDnsTxtRecordsReturnType = DnsResponse
+
+/**
+ * Gets the DNS record response of a name, via DNS record lookup
+ * @param parameters - {@link GetDnsTxtRecordsParameters}
+ * @returns DNS response. {@link GetDnsTxtRecordsReturnType}
+ *
+ * @example
+ * import { getDnsTxtRecords } from '@ensdomains/ensjs/utils'
+ *
+ * const owner = await getDnsTxtRecords({ name: '_ens.ens.domains' })
+ */
+export const getDnsTxtRecords = async ({
+  name,
+  endpoint = 'https://cloudflare-dns.com/dns-query',
+}: GetDnsTxtRecordsParameters): Promise<GetDnsTxtRecordsReturnType> => {
+  const response: DnsResponse = await fetch(
+    `${endpoint}?name=${name}.&type=TXT`,
+    {
+      method: 'GET',
+      headers: {
+        accept: 'application/dns-json',
+      },
+    },
+  ).then((res) => res.json())
+
+  return response
+}