Adds /operators?withDomains endpoint. Updates readme to document new endpoints

Author: jim-toth

README.md

@@ -228,3 +228,53 @@ Example response:
 ```
 
 This endpoint is used for geolocation and network analysis of all known relays.
+
+# Operators
+Fetch a list of relay operator addresses
+- **GET** `/operators` => `string[]`
+
+Example response:
+```json
+[
+    "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
+    "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
+    "0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
+    ... more results
+]
+```
+
+# Operators with Anyone Domains
+Fetch a list of relay operators and any domains they own
+- **GET** `/operators?withDomains=true`
+
+Response:
+```json
+[
+    {
+        "address": string,
+        "domains": {
+            tokenId: string,
+            name: string,
+            owner: string | undefined,
+            tld: string
+        }[]
+    }
+]
+```
+
+# Anyone Domains
+Fetch a list of .anyone domains
+- **GET** `/anyone-domains`
+Response:
+
+```json
+[
+    {
+        "tokenId": string,
+        "name": string,
+        "owner": string | undefined,
+        "tld": string
+    },
+    ... more results
+]
+```

src/app.ts

@@ -299,7 +299,20 @@ class HexInfo {
 
 app.get('/operators', async (req, res) => {
     try {
+        const withDomains = req
+            .query
+            .withDomains as string | undefined === 'true';
         const operators = await operatorRegistryService.getOperators();
+        if (withDomains) {
+            const anyoneDomains = await unstoppableDomainsService
+                .getAnyoneDomains();
+            const operatorsWithDomains = operators.map(operator => ({
+                address: operator,
+                domains: anyoneDomains
+                    .filter(domain => domain.owner === operator)
+            }));
+            return res.json(operatorsWithDomains);
+        }
         return res.json(operators);
     } catch (error) {
         console.error(error);
@@ -309,7 +322,8 @@ app.get('/operators', async (req, res) => {
 
 app.get('/anyone-domains', async (req, res) => {
     try {
-        const anyoneDomains = await unstoppableDomainsService.getAnyoneDomains();
+        const anyoneDomains = await unstoppableDomainsService
+            .getAnyoneDomains();
         return res.json(anyoneDomains);
     } catch (error) {
         console.error(error);