ipld-eth-server/documentation/ens_questions.md

Run lightSync, starting at the blockheight the ENS registry was published at. ./vulcanize lightSync --config=./environments/<config.toml> --starting-block-number=3327417

1. What is the label hash of this domain? Q. Does this mean for a given namehash of "a.b.c" where we don't know what "c" is find keccak256(c)? Do we know the parent domain and/or owner address?

   1. Watch NewOwner(bytes32 indexed node, bytes32 indexed label, address owner) events of the ENS Registry contract and filter for the parent node and/or owner address to narrow search ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewOwner
   2. For each node + label pair we find emitted, calculate the keccak256(abi.encodePacked(node, label)) and see if it matches our domain's namehash
   3. If it does, keccak256(label) is our label hash

2. What is the parent domain of this domain?

   1. Watch NewOwner(bytes32 indexed node, bytes32 indexed label, address owner) events of the ENS Registry contract ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewOwner
   2. If we know our label, filter for it and collect the node (parent domain namehash) that was emitted with it
   3. If we don't know our label I believe we need to take a similar aqpproach as in section 1 where we try every keccak256(abi.encodePacked(node, label)) until we find the namehash for our domain
   4. Call the Registry's resolver(bytes32 node) method for the parent node to find the parent domain's Resolver
   5. Call its Resolver's name(bytes32 node) method for the parent node to find the parent domain's name

3. What are the subdomains of this domain?

   1. Watch NewOwner(bytes32 indexed node, bytes32 indexed label, address owner) events of the ENS Registry contract ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewOwner
   2. Filter for our node (domain) and collect all the labels emitted with it
   3. Calculate subdomain hashes: subnode = keccak256(abi.encodePacked(node, label))
   4. Call the Registry's resolver(bytes32 node) method for a subnode to find the subdomain's Resolver
   5. Call its Resolver's name(bytes32 node) method for a subnode to find the subdomain's name

4. What domains does this address own?

   1. Watch NewOwner(bytes32 indexed node, bytes32 indexed label, address owner) and Transfer(bytes32 indexed node, address owner) events of the ENS Registry contract and filter for the address ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-eevents=NewOwner --contract-events=Transfer --event-filter-addresses=<address>
   2. Collect node and label values; calculate subnodes = keccak256(abi.encodePacked(node, label))
   3. Aggregate nodes and subnodes into a list and check which of these they still own at a given blockheight by iterating over the list and calling the Registry's owner(bytes32 node) method
   4. Call the Registry's resolver(bytes32 node) method for a node to find the domain's Resolver
   5. Call its Resolver's name(bytes32 node) method for the node to find the domain's name

5. What names point to this address? Q. Is this in terms of which ENS nodes point to a given Resolver address? E.g. All nodes where the ENS records[node].resolver == address? Or is this in terms of Resolver records? E.g. All the records[node].names where the Resolver records[node].addr == address

   1. In the former case, watch NewResolver(bytes32 indexed node, address resolver) events of the Registry and filter for the account address ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewResolver --event-filter-addresses=<address>
   2. Generate a list of nodes that have pointed to this resolver address
   3. Check which of these still point at the address by iterating over the list and calling the Registry's resolver(bytes32 node) method
   4. In the latter case, watch AddrChanged(bytes32 indexed node, address a) events of the Resolver and filter for the account address ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3648359 --contract-address=0x1da022710dF5002339274AaDEe8D58218e9D6AB5 --contract-events=AddrChanged --event-filter-addresses=<address>
   5. Generate our list of nodes that have pointed towards our address
   6. Check which of these they still own at a given blockheight by iterating over the list and calling the Resolver's addr(bytes32 node) method
   7. We can then fetch the string names of these nodes using the Resolver's name(bytes32 node) method.

Currently the only filtering that can be done during event watching is for addresses and the only methods that can be polled in an automated fashion are ones that take only address-type arguments (of which there are less than three) and return a single value. For the sake of answering these questions it would be really helpful if we could also perform []byte filtering on the events and automate polling of events that take []byte-type arguments. I am currently working on adding this in, and once it is in you would be able to automate more of the steps in these processes.

E.g. you will be able to run ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewOwner --contract-events=Transfer --event-args=<address> --contract-methods=owner To automate the process in question 4 through step 3 (it will collect node []byte values emitted from the events it watches and then use those to call the owner method, persisting the results)

Or ./vulcanize lightOmniWacther --config=./environments/<config.toml> --starting-block-number=3327417 --contract-address=0x314159265dD8dbb310642f98f50C066173C1259b --contract-events=NewOwner --event-args=<bytes-to-filter-for> To provide automated filtering for node []byte values in question 3.