@ensdomains/ensjs 4.0.3-alpha.12 → 4.1.1

package/dist/functions/subgraph/filters.js

@@ -0,0 +1,108 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+import { P, match } from 'ts-pattern';
+import { GRACE_PERIOD_SECONDS } from '../../utils/consts.js';
+export const getExpiryDateOrderFilter = ({ orderDirection, lastDomain, }) => {
+    let lastExpiryDate = lastDomain.expiryDate?.value
+        ? lastDomain.expiryDate.value / 1000
+        : 0;
+    if (lastDomain.parentName === 'eth')
+        lastExpiryDate += GRACE_PERIOD_SECONDS;
+    return match({
+        lastExpiryDate,
+        orderDirection,
+    })
+        .with({
+        lastExpiryDate: P.number.lte(0),
+        orderDirection: 'asc',
+    }, () => ({
+        and: [{ expiryDate: null }, { id_gt: lastDomain.id }],
+    }))
+        .with({
+        lastExpiryDate: P.number,
+        orderDirection: 'asc',
+    }, () => ({
+        or: [
+            {
+                and: [
+                    {
+                        expiryDate_gte: `${lastExpiryDate}`,
+                    },
+                    { id_gt: lastDomain.id },
+                ],
+            },
+            {
+                expiryDate_gt: `${lastExpiryDate}`,
+            },
+            {
+                expiryDate: null,
+            },
+        ],
+    }))
+        .with({
+        lastExpiryDate: P.number.lte(0),
+        orderDirection: 'desc',
+    }, () => ({
+        or: [
+            {
+                and: [{ expiryDate: null }, { id_lt: lastDomain.id }],
+            },
+            {
+                expiryDate_gt: 0,
+            },
+        ],
+    }))
+        .with({
+        lastExpiryDate: P.number,
+        orderDirection: 'desc',
+    }, () => ({
+        or: [
+            {
+                and: [
+                    { expiryDate_lte: `${lastExpiryDate}` },
+                    { id_lt: lastDomain.id },
+                ],
+            },
+            {
+                expiryDate_lt: `${lastExpiryDate}`,
+            },
+        ],
+    }))
+        .exhaustive();
+};
+export const getCreatedAtOrderFilter = ({ orderDirection, lastDomain, }) => match({
+    orderDirection,
+})
+    .with({
+    orderDirection: 'asc',
+}, () => ({
+    or: [
+        {
+            and: [
+                {
+                    createdAt_gte: `${lastDomain.createdAt.value / 1000}`,
+                    id_gt: lastDomain.id,
+                },
+            ],
+        },
+        {
+            createdAt_gt: `${lastDomain.createdAt.value / 1000}`,
+        },
+    ],
+}))
+    .with({
+    orderDirection: 'desc',
+}, () => ({
+    or: [
+        {
+            and: [
+                { createdAt_lte: `${lastDomain.createdAt.value / 1000}` },
+                { id_lt: lastDomain.id },
+            ],
+        },
+        {
+            createdAt_lt: `${lastDomain.createdAt.value / 1000}`,
+        },
+    ],
+}))
+    .exhaustive();
+//# sourceMappingURL=filters.js.map

package/dist/functions/subgraph/filters.js.map

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

package/dist/functions/subgraph/fragments.d.ts

@@ -0,0 +1,40 @@
+import type { Address, Hex } from 'viem';
+export declare const domainDetailsWithoutParentFragment: string;
+export declare const domainDetailsFragment: string;
+export type SubgraphDomainFragment = {
+    id: Hex;
+    labelName: string | null;
+    labelhash: Hex;
+    name: string;
+    isMigrated: boolean;
+    parent?: {
+        name: string;
+    };
+    createdAt: string;
+    resolvedAddress?: {
+        id: Address;
+    };
+    owner: {
+        id: Address;
+    };
+    registrant?: {
+        id: Address;
+    };
+    wrappedOwner?: {
+        id: Address;
+    };
+};
+export declare const registrationDetailsFragment: string;
+export type SubgraphRegistrationFragment = {
+    registrationDate: string;
+    expiryDate: string;
+};
+export declare const wrappedDomainDetailsFragment: string;
+export type SubgraphWrappedDomainFragment = {
+    expiryDate: string;
+    fuses: string;
+};
+export type SubgraphDomain = SubgraphDomainFragment & {
+    registration?: SubgraphRegistrationFragment;
+    wrappedDomain?: SubgraphWrappedDomainFragment;
+};

package/dist/functions/subgraph/fragments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.js","sourceRoot":"","sources":["../../../src/functions/subgraph/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAGrC,MAAM,CAAC,MAAM,kCAAkC,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;CAqBpD,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA;;;;;;;IAOpC,kCAAkC;CACrC,CAAA;AA0BD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAA;;;;;CAK7C,CAAA;AAOD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAA;;;;;CAK9C,CAAA"}

package/dist/functions/subgraph/getDecodedName.d.ts

@@ -0,0 +1,29 @@
+import type { ClientWithEns } from '../../contracts/consts.js';
+export type GetDecodedNameParameters = {
+    /** Name with unknown labels */
+    name: string;
+    /** Allow a name with unknown labels to be returned */
+    allowIncomplete?: boolean;
+};
+export type GetDecodedNameReturnType = string | null;
+/**
+ * Gets the full name for a name with unknown labels from the subgraph.
+ * @param client - {@link ClientWithEns}
+ * @param parameters - {@link GetDecodedNameParameters}
+ * @returns Full name, or null if name was could not be filled. {@link GetDecodedNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDecodedName } from '@ensdomains/ensjs/subgraph'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getDecodedName(client, { name: '[5cee339e13375638553bdf5a6e36ba80fb9f6a4f0783680884d92b558aa471da].eth' })
+ * // ens.eth
+ */
+declare const getDecodedName: (client: ClientWithEns, { name, allowIncomplete }: GetDecodedNameParameters) => Promise<GetDecodedNameReturnType>;
+export default getDecodedName;

package/dist/functions/subgraph/getDecodedName.js

@@ -0,0 +1,84 @@
+import { gql } from 'graphql-request';
+import { checkIsDecrypted, decodeLabelhash, isEncodedLabelhash, } from '../../utils/labels.js';
+import { namehash } from '../../utils/normalise.js';
+import { createSubgraphClient } from './client.js';
+/**
+ * Gets the full name for a name with unknown labels from the subgraph.
+ * @param client - {@link ClientWithEns}
+ * @param parameters - {@link GetDecodedNameParameters}
+ * @returns Full name, or null if name was could not be filled. {@link GetDecodedNameReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getDecodedName } from '@ensdomains/ensjs/subgraph'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getDecodedName(client, { name: '[5cee339e13375638553bdf5a6e36ba80fb9f6a4f0783680884d92b558aa471da].eth' })
+ * // ens.eth
+ */
+const getDecodedName = async (client, { name, allowIncomplete }) => {
+    if (checkIsDecrypted(name))
+        return name;
+    // try to fetch the name from an existing Domain entity
+    // also try to fetch the label names from any Domain entities that have a corresponding labelhash
+    const labels = name.split('.');
+    const subgraphClient = createSubgraphClient({ client });
+    let labelsQuery = '';
+    for (let i = 0; i < labels.length; i += 1) {
+        const label = labels[i];
+        if (isEncodedLabelhash(label)) {
+            labelsQuery += gql `
+        labels${i}: domains(first: 1, where: { labelhash: "${decodeLabelhash(label).toLowerCase()}", labelName_not: null }) {
+          labelName
+        }
+      `;
+        }
+    }
+    const decodedNameQuery = gql `
+    query decodedName($id: String!) {
+      namehashLookup: domain(id: $id) {
+        name
+      }
+      ${labelsQuery}
+    }
+  `;
+    const decodedNameResult = await subgraphClient.request(decodedNameQuery, {
+        id: namehash(name),
+    });
+    if (!decodedNameResult)
+        return null;
+    const attemptedDecodedLabels = [...labels];
+    const { namehashLookup: { name: namehashLookupResult } = { name: undefined }, ...labelResults } = decodedNameResult;
+    if (namehashLookupResult) {
+        const namehashLookupLabels = namehashLookupResult.split('.');
+        for (let i = 0; i < namehashLookupLabels.length; i += 1) {
+            const label = namehashLookupLabels[i];
+            if (!isEncodedLabelhash(label)) {
+                attemptedDecodedLabels[i] = label;
+            }
+        }
+        const joinedResult = attemptedDecodedLabels.join('.');
+        if (checkIsDecrypted(joinedResult))
+            return joinedResult;
+    }
+    if (Object.keys(labelResults).length !== 0) {
+        for (const [key, value] of Object.entries(labelResults)) {
+            if (value.length && value[0].labelName) {
+                attemptedDecodedLabels[Number.parseInt(key.replace('labels', ''))] =
+                    value[0].labelName;
+            }
+        }
+    }
+    const joinedResult = attemptedDecodedLabels.join('.');
+    if (checkIsDecrypted(joinedResult) || allowIncomplete)
+        return joinedResult;
+    // name is not decrypted
+    return null;
+};
+export default getDecodedName;
+//# sourceMappingURL=getDecodedName.js.map

package/dist/functions/subgraph/getDecodedName.js.map

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

package/dist/functions/subgraph/getNameHistory.d.ts

@@ -0,0 +1,53 @@
+import type { ClientWithEns } from '../../contracts/consts.js';
+import type { BaseResolverEvent, ContenthashChanged, DomainEvent, MulticoinAddrChanged, RegistrationEvent, ResolverEvent } from './events.js';
+export type GetNameHistoryParameters = {
+    /** Name to get history for */
+    name: string;
+};
+type FlattenedEvent<TEvent extends {}> = {
+    [K in keyof TEvent]: TEvent[K] extends {
+        id: string;
+    } ? string : TEvent[K];
+};
+type ReturnDomainEvent = FlattenedEvent<DomainEvent>;
+type ReturnRegistrationEvent = FlattenedEvent<RegistrationEvent>;
+type ReturnResolverEvent = FlattenedEvent<Exclude<ResolverEvent, MulticoinAddrChanged | ContenthashChanged> | (BaseResolverEvent & {
+    type: 'MulticoinAddrChanged';
+    coinType: string;
+    coinName: string | null;
+    decoded: boolean;
+    addr: string | null;
+}) | (BaseResolverEvent & {
+    type: 'ContenthashChanged';
+    decoded: boolean;
+    contentHash: string | null;
+    protocolType: string | null;
+})>;
+export type GetNameHistoryReturnType = {
+    /** Array of domain events */
+    domainEvents: ReturnDomainEvent[];
+    /** Array of registration events */
+    registrationEvents: ReturnRegistrationEvent[] | null;
+    /** Array of resolver events */
+    resolverEvents: ReturnResolverEvent[] | null;
+} | null;
+/**
+ * Gets the history of a name from the subgraph.
+ * @param client - {@link ClientWithEns}
+ * @param parameters - {@link GetNameHistoryParameters}
+ * @returns History object, or null if name could not be found. {@link GetNameHistoryReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getNameHistory } from '@ensdomains/ensjs/subgraph'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getNameHistory(client, { name: 'ens.eth' })
+ */
+declare const getNameHistory: (client: ClientWithEns, { name }: GetNameHistoryParameters) => Promise<GetNameHistoryReturnType>;
+export default getNameHistory;

package/dist/functions/subgraph/getNameHistory.js

@@ -0,0 +1,248 @@
+import { getCoderByCoinType } from '@ensdomains/address-encoder';
+import { gql } from 'graphql-request';
+import { hexToBytes, trim } from 'viem';
+import { decodeContentHash } from '../../utils/contentHash.js';
+import { namehash } from '../../utils/normalise.js';
+import { createSubgraphClient } from './client.js';
+/**
+ * Gets the history of a name from the subgraph.
+ * @param client - {@link ClientWithEns}
+ * @param parameters - {@link GetNameHistoryParameters}
+ * @returns History object, or null if name could not be found. {@link GetNameHistoryReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getNameHistory } from '@ensdomains/ensjs/subgraph'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getNameHistory(client, { name: 'ens.eth' })
+ */
+const getNameHistory = async (client, { name }) => {
+    const subgraphClient = createSubgraphClient({ client });
+    const query = gql `
+    query getNameHistory($id: String!) {
+      domain(id: $id) {
+        events {
+          id
+          blockNumber
+          transactionID
+          type: __typename
+          ... on Transfer {
+            owner {
+              id
+            }
+          }
+          ... on NewOwner {
+            owner {
+              id
+            }
+          }
+          ... on NewResolver {
+            resolver {
+              id
+            }
+          }
+          ... on NewTTL {
+            ttl
+          }
+          ... on WrappedTransfer {
+            owner {
+              id
+            }
+          }
+          ... on NameWrapped {
+            fuses
+            expiryDate
+            owner {
+              id
+            }
+          }
+          ... on NameUnwrapped {
+            owner {
+              id
+            }
+          }
+          ... on FusesSet {
+            fuses
+          }
+          ... on ExpiryExtended {
+            expiryDate
+          }
+        }
+        registration {
+          events {
+            id
+            blockNumber
+            transactionID
+            type: __typename
+            ... on NameRegistered {
+              registrant {
+                id
+              }
+              expiryDate
+            }
+            ... on NameRenewed {
+              expiryDate
+            }
+            ... on NameTransferred {
+              newOwner {
+                id
+              }
+            }
+          }
+        }
+        resolver {
+          events {
+            id
+            blockNumber
+            transactionID
+            type: __typename
+            ... on AddrChanged {
+              addr {
+                id
+              }
+            }
+            ... on MulticoinAddrChanged {
+              coinType
+              multiaddr: addr
+            }
+            ... on NameChanged {
+              name
+            }
+            ... on AbiChanged {
+              contentType
+            }
+            ... on PubkeyChanged {
+              x
+              y
+            }
+            ... on TextChanged {
+              key
+              value
+            }
+            ... on ContenthashChanged {
+              hash
+            }
+            ... on InterfaceChanged {
+              interfaceID
+              implementer
+            }
+            ... on AuthorisationChanged {
+              owner
+              target
+              isAuthorized
+            }
+            ... on VersionChanged {
+              version
+            }
+          }
+        }
+      }
+    }
+  `;
+    const queryVars = {
+        id: namehash(name),
+    };
+    const result = await subgraphClient.request(query, queryVars);
+    if (!result.domain)
+        return null;
+    const domainEvents = result.domain.events.map((event) => {
+        switch (event.type) {
+            case 'NewResolver': {
+                return {
+                    ...event,
+                    resolver: event.resolver.id.split('-')[0],
+                };
+            }
+            case 'NewOwner':
+            case 'Transfer':
+            case 'WrappedTransfer':
+            case 'NameWrapped':
+            case 'NameUnwrapped': {
+                return {
+                    ...event,
+                    owner: event.owner.id,
+                };
+            }
+            default:
+                return event;
+        }
+    });
+    const registrationEvents = result.domain?.registration?.events.map((event) => {
+        switch (event.type) {
+            case 'NameRegistered': {
+                return {
+                    ...event,
+                    registrant: event.registrant.id,
+                };
+            }
+            case 'NameTransferred': {
+                return {
+                    ...event,
+                    newOwner: event.newOwner.id,
+                };
+            }
+            default:
+                return event;
+        }
+    });
+    const resolverEvents = result.domain?.resolver?.events.map((event) => {
+        switch (event.type) {
+            case 'AddrChanged': {
+                return {
+                    ...event,
+                    addr: event.addr.id,
+                };
+            }
+            case 'MulticoinAddrChanged': {
+                const { multiaddr, ...event_ } = event;
+                const format = getCoderByCoinType(Number.parseInt(event.coinType));
+                if (!format) {
+                    return {
+                        ...event_,
+                        coinName: null,
+                        decoded: false,
+                        addr: multiaddr,
+                    };
+                }
+                if (multiaddr === '0x' || trim(multiaddr) === '0x00') {
+                    return {
+                        ...event_,
+                        coinName: format.name,
+                        decoded: true,
+                        addr: null,
+                    };
+                }
+                return {
+                    ...event_,
+                    coinName: format.name,
+                    decoded: true,
+                    addr: format.encode(hexToBytes(multiaddr)),
+                };
+            }
+            case 'ContenthashChanged': {
+                const { decoded: contentHash, protocolType } = decodeContentHash(event.hash) || { protocolType: null, decoded: null };
+                return {
+                    ...event,
+                    decoded: contentHash !== null,
+                    contentHash,
+                    protocolType,
+                };
+            }
+            default:
+                return event;
+        }
+    });
+    return {
+        domainEvents,
+        registrationEvents: registrationEvents || null,
+        resolverEvents: resolverEvents || null,
+    };
+};
+export default getNameHistory;
+//# sourceMappingURL=getNameHistory.js.map

package/dist/functions/subgraph/getNameHistory.js.map

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

package/dist/functions/subgraph/getNamesForAddress.d.ts

@@ -0,0 +1,64 @@
+import type { Address } from 'viem';
+import type { ClientWithEns } from '../../contracts/consts.js';
+import { type Name } from './utils.js';
+type GetNamesForAddressOrderBy = 'expiryDate' | 'name' | 'labelName' | 'createdAt';
+type GetNamesForAddressRelation = {
+    /** Names with registrant as address (default: true) */
+    registrant?: boolean;
+    /** Names with owner as address (default: true) */
+    owner?: boolean;
+    /** Names with wrapped owner as address (default: true) */
+    wrappedOwner?: boolean;
+    /** Names with matching resolving address (default: true) */
+    resolvedAddress?: boolean;
+};
+type GetNamesForAddressFilter = GetNamesForAddressRelation & {
+    /** Search string filter for name */
+    searchString?: string;
+    /** Search string filter type (default: `labelName`) */
+    searchType?: 'labelName' | 'name';
+    /** Allows expired names to be included (default: false) */
+    allowExpired?: boolean;
+    /** Allows reverse record nodes to be included (default: false) */
+    allowReverseRecord?: boolean;
+    /** Allows deleted names to be included (default: false) */
+    allowDeleted?: boolean;
+};
+export type GetNamesForAddressParameters = {
+    /** Address to get names for */
+    address: Address;
+    /** Names to get, in relation to address */
+    filter?: GetNamesForAddressFilter;
+    /** Parameter to order names by (default: name) */
+    orderBy?: GetNamesForAddressOrderBy;
+    /** Direction to order names in (default: asc) */
+    orderDirection?: 'asc' | 'desc';
+    /** Previous page of names, used for pagination */
+    previousPage?: NameWithRelation[];
+    /** Page size (default: 100) */
+    pageSize?: number;
+};
+export type NameWithRelation = Name & {
+    relation: GetNamesForAddressRelation;
+};
+export type GetNamesForAddressReturnType = NameWithRelation[];
+/**
+ * Gets the names for an address from the subgraph.
+ * @param client - {@link ClientWithEns}
+ * @param parameters - {@link GetNamesForAddressParameters}
+ * @returns Name array. {@link GetNamesForAddressReturnType}
+ *
+ * @example
+ * import { createPublicClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { addEnsContracts } from '@ensdomains/ensjs'
+ * import { getNamesForAddress } from '@ensdomains/ensjs/subgraph'
+ *
+ * const client = createPublicClient({
+ *   chain: addEnsContracts(mainnet),
+ *   transport: http(),
+ * })
+ * const result = await getNamesForAddress(client, { address: '0xFe89cc7aBB2C4183683ab71653C4cdc9B02D44b7' })
+ */
+declare const getNamesForAddress: (client: ClientWithEns, { address, filter: _filter, orderBy, orderDirection, pageSize, previousPage, }: GetNamesForAddressParameters) => Promise<GetNamesForAddressReturnType>;
+export default getNamesForAddress;