Add support for ENS contenthash methods

docs/web3-eth-ens.rst

@@ -938,6 +938,134 @@ For further information on the handling of contract events please see :ref:`here
 
 ------------------------------------------------------------------------------
 
+getContenthash
+=====================
+
+.. code-block:: javascript
+
+    web3.eth.ens.getContenthash(ENSName [, callback]);
+
+Returns the content hash object associated with an ENS node.
+
+----------
+Parameters
+----------
+
+1. ``ENSName`` - ``String``: The ENS name.
+2. ``callback`` - ``Function``: (optional) Optional callback
+
+-------
+Returns
+-------
+
+``Promise<Object>`` - The content hash object associated with an ENS node.
+
+-------
+Example
+-------
+
+.. code-block:: javascript
+
+    web3.eth.ens.getContenthash('ethereum.eth').then(function (result) {
+        console.log(result);
+    });
+    > {
+        "protocolType": "ipfs",
+        "decoded": "QmaEBknbGT4bTQiQoe2VNgBJbRfygQGktnaW5TbuKixjYL"
+    }
+
+------------------------------------------------------------------------------
+
+setContenthash
+=====================
+
+.. code-block:: javascript
+
+    web3.eth.ens.setContenthash(ENSName, hash [, txConfig ] [, callback]);
+
+Sets the content hash associated with an ENS node.
+
+----------
+Parameters
+----------
+
+1. ``ENSName`` - ``String``: The ENS name.
+2. ``hash`` - ``String``: The content hash to set.
+3. ``txConfig`` - ``Object``: (optional) The transaction options as described ::ref::`here <eth-sendtransaction>`
+4. ``callback`` - ``Function``: (optional) Optional callback
+
+Emits a ``ContenthashChanged`` event.
+
+Supports the following protocols as valid ``hash`` inputs:
+
+1. ``ipfs://``   - example: ipfs://QmaEBknbGT4bTQiQoe2VNgBJbRfygQGktnaW5TbuKixjYL
+2. ``/ipfs/``    - example: /ipfs/QmaEBknbGT4bTQiQoe2VNgBJbRfygQGktnaW5TbuKixjYL
+3. ``bzz://``    - example: bzz://d1de9994b4d039f6548d191eb26786769f580809256b4685ef316805265ea162
+4. ``onion://``  - example: onion://3g2upl4pq6kufc4m
+5. ``onion3://`` - exmaple: onion3://p53lf57qovyuvwsc6xnrppyply3vtqm7l6pcobkmyqsiofyeznfu5uqd
+
+-------
+Returns
+-------
+
+``PromiEvent<TransactionReceipt | TransactionRevertInstructionError>``
+
+-------
+Example
+-------
+
+.. code-block:: javascript
+
+    web3.eth.ens.setContenthash(
+        'ethereum.eth',
+        'ipfs://QmaEBknbGT4bTQiQoe2VNgBJbRfygQGktnaW5TbuKixjYL',
+        {
+            from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
+        }
+    ).then(function (result) {
+             console.log(result.events);
+     });
+    > ContenthashChanged(...)
+
+    // Or using the event emitter
+
+    web3.eth.ens.setContenthash(
+        'ethereum.eth',
+        'ipfs://QmaEBknbGT4bTQiQoe2VNgBJbRfygQGktnaW5TbuKixjYL',
+        {
+            from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
+        }
+    )
+    .on('transactionHash', function(hash){
+        ...
+    })
+    .on('confirmation', function(confirmationNumber, receipt){
+        ...
+    })
+    .on('receipt', function(receipt){
+        ...
+    })
+    .on('error', console.error);
+
+    // Or listen to the ContenthashChanged event on the resolver
+
+    web3.eth.ens.resolver('ethereum.eth').then(function (resolver) {
+        resolver.events.ContenthashChanged({fromBlock: 0}, function(error, event) {
+            console.log(event);
+        })
+        .on('data', function(event){
+            console.log(event);
+        })
+        .on('changed', function(event){
+            // remove event from local database
+        })
+        .on('error', console.error);
+    });
+
+
+For further information on the handling of contract events please see :ref:`here <contract-events>`.
+
+
 getMultihash
 =====================
 

package.json

@@ -97,7 +97,7 @@
         "@babel/core": "^7.6.4",
         "@babel/preset-env": "^7.6.3",
         "@ensdomains/ens": "^0.4.0",
-        "@ensdomains/resolver": "^0.1.13",
+        "@ensdomains/resolver": "^0.2.4",
         "@types/bignumber.js": "^4.0.2",
         "@types/bn.js": "^4.11.5",
         "@types/node": "^12.6.1",

packages/web3-core-helpers/src/errors.js

@@ -106,5 +106,8 @@ module.exports = {
     },
     TransactionOutOfGasError: function(receipt) {
         return this.TransactionError('Transaction ran out of gas. Please provide more gas:\n' + JSON.stringify(receipt, null, 2), receipt);
+    },
+    ResolverMethodMissingError: function(address, name) {
+        return new Error('The resolver at ' + address + 'does not implement requested method: "' + name + '".');
     }
 };

packages/web3-core-helpers/types/index.d.ts

@@ -80,6 +80,7 @@ export class errors {
     static ContractCodeNotStoredError(receipt: object): TransactionError
     static TransactionRevertedWithoutReasonError(receipt: object): TransactionError
     static TransactionOutOfGasError(receipt: object): TransactionError
+    static ResolverMethodMissingError(address: string, name: string): Error
 }
 
 export class WebsocketProviderBase {

packages/web3-core-helpers/types/tests/errors-test.ts

@@ -76,3 +76,6 @@ errors.TransactionRevertedWithoutReasonError({});
 
 // $ExpectType TransactionError
 errors.TransactionOutOfGasError({});
+
+// $ExpectType Error
+errors.ResolverMethodMissingError('0x0000000000000000000000000000000000000001', 'content');