@ensnode/ensnode-sdk 1.16.0 → 1.17.0

package/dist/internal.cjs

@@ -61,6 +61,7 @@ __export(internal_exports, {
   interpretAddressRecordValue: () => interpretAddressRecordValue,
   interpretContenthashValue: () => interpretContenthashValue,
   interpretDnszonehashValue: () => interpretDnszonehashValue,
+  interpretMetadataKey: () => interpretMetadataKey,
   interpretNameRecordValue: () => interpretNameRecordValue,
   interpretPubkeyValue: () => interpretPubkeyValue,
   interpretTextRecordKey: () => interpretTextRecordKey,
@@ -3214,6 +3215,27 @@ var fixtures = {
   rawAddresses,
   textRecords: testEthTextRecords
 };
+var efpSeedTargets = {
+  /** ADD + ADD_TAG("block") + ADD_TAG("block") -> tags === ["block"] (dedup). */
+  dedup: (0, import_enssdk8.asNormalizedAddress)(`0x${"d1".repeat(20)}`),
+  /** ADD + ADD_TAG("vip") + REMOVE + ADD -> record present, tags === [] (embed cascade + fresh). */
+  cascade: (0, import_enssdk8.asNormalizedAddress)(`0x${"ca".repeat(20)}`),
+  /** ADD + REMOVE(target + junk) -> record gone (canonical 22-byte keying). */
+  junk: (0, import_enssdk8.asNormalizedAddress)(`0x${"1c".repeat(20)}`),
+  /** Anchors a list whose `user` role must survive a storage-location re-point away and back. */
+  durable: (0, import_enssdk8.asNormalizedAddress)(`0x${"d0".repeat(20)}`),
+  /** Followed plainly by the validated {@link efpFollowActorAddress} list — a real follow. */
+  followPlain: (0, import_enssdk8.asNormalizedAddress)(`0x${"f0".repeat(20)}`),
+  /** Followed but `block`-tagged by that list — excluded from `following` / `followers`. */
+  followBlocked: (0, import_enssdk8.asNormalizedAddress)(`0x${"fb".repeat(20)}`)
+};
+var efpSeedRoleUser = (0, import_enssdk8.asNormalizedAddress)(`0x${"ab".repeat(20)}`);
+var efpSeedActorAddress = (0, import_enssdk8.asNormalizedAddress)(
+  "0x976ea74026e726554db657fa54763abd0c3a0aa9"
+);
+var efpFollowActorAddress = (0, import_enssdk8.asNormalizedAddress)(
+  "0x14dc79964da2c08b23698b3d3cc7ca32193d9955"
+);
 var contenthashFixtures = {
   // CIDv0 input — decodes back to CIDv1
   ipfs: getRawContenthash("ipfs", "QmRAQB6YaCyidP37UdDnjFY5vQuiBrcqdyoW1CuDgwxkD4"),
@@ -3263,6 +3285,7 @@ var SEPOLIA_V2_ACCOUNT_WITH_V1_AND_V2 = (0, import_enssdk9.toNormalizedAddress)(
 var DEVNET_NAME_WITH_OWNED_RESOLVER = (0, import_enssdk9.asInterpretedName)("example.eth");
 var SEPOLIA_V2_NAME = (0, import_enssdk9.asInterpretedName)("roppp.eth");
 var VITALIK_NAME = (0, import_enssdk9.asInterpretedName)("vitalik.eth");
+var DPERRI_DNS_NAME = (0, import_enssdk9.asInterpretedName)("dperri.com");
 var GREG_NAME = (0, import_enssdk9.asInterpretedName)("gregskril.eth");
 var GREG_ADDRESS = (0, import_enssdk9.toNormalizedAddress)("0x179a862703a4adfb29896552df9e307980d19285");
 var OFFCHAIN_NAME = (0, import_enssdk9.asInterpretedName)("patricio.onpoap.eth");
@@ -3316,7 +3339,9 @@ var GRAPHQL_API_EXAMPLE_QUERIES = [
     }
 
     # Also load the count of ENSv1 and ENSv2 domains owned by the account
-    # to see if they have domains they should upgrade to ENSv2
+    # to see if they have domains they should upgrade to ENSv2.
+    # For simplicity this example query doesn't include additional logic
+    # to filter out domains that have expired.
     v1DomainsCount: domains(where: { version: ENSv1 }) { totalCount }
     v2DomainsCount: domains(where: { version: ENSv2 }) { totalCount }
   }
@@ -3745,11 +3770,16 @@ query AccountPrimaryNames($address: Address!) {
   account(by: { address: $address }) {
     address
     resolve {
+      # Reverse resolution: given this address + a chain, get the primary
+      # name the address has set for that chain.
+      # primaryName returns the result for a single chain (here, Optimism).
+      # (onePrimaryName / twoPrimaryNames are just GraphQL aliases.)
       onePrimaryName: primaryName(by: { chainName: OPTIMISM }) {
         chainName
         name { interpreted beautified }
       }
 
+      # primaryNames returns one result per requested chain, in a single call.
       twoPrimaryNames: primaryNames(where: { chainNames: [ETHEREUM, BASE] }) {
         chainName
         name { interpreted beautified }
@@ -3931,19 +3961,20 @@ query AccountResolverPermissions($address: Address!) {
 query DomainResolver($name: InterpretedName!) {
   domain(by: { name: $name }) {
     resolver {
+      # the Resolver explicitly assigned to this Domain
       assigned {
-        contract {
-          address
-        }
-        events(first: 5) {
-          edges { node { topics data timestamp } }
-        }
+        contract { address }
+      }
+      # the Resolver that ENS Forward Resolution (ENSIP-10) actually lands
+      # on for this Domain \u2014 i.e. its effective Resolver
+      effective {
+        contract { address }
       }
     }
   }
 }`,
     variables: {
-      default: { name: VITALIK_NAME },
+      default: { name: DPERRI_DNS_NAME },
       [import_datasources5.ENSNamespaceIds.EnsTestEnv]: { name: DEVNET_NAME_WITH_OWNED_RESOLVER },
       [import_datasources5.ENSNamespaceIds.SepoliaV2]: { name: SEPOLIA_V2_NAME }
     }
@@ -4012,6 +4043,9 @@ query Namegraph {
     query: `
 query AccountMigratedNames($address: Address!) {
   account(by: { address: $address }) {
+    # Count the ENSv1 and ENSv2 domains owned by the account.
+    # For simplicity this example query doesn't include additional logic
+    # to filter out domains that have expired.
     v1DomainsCount: domains(where: { version: ENSv1 }) { totalCount }
     v2DomainsCount: domains(where: { version: ENSv2 }) { totalCount }
   }
@@ -4510,6 +4544,10 @@ function interpretTextRecordKey(key) {
   if (key === "") return null;
   return key;
 }
+function interpretMetadataKey(key) {
+  if (hasNullByte(key)) return null;
+  return key;
+}
 function interpretTextRecordValue(value) {
   if (hasNullByte(value)) return null;
   if (value === "") return null;