Note

This documentation is work in progress and web3.js 1.0 stable is not yet released! You can find the current documentation for web3 0.x.x at github.com/ethereum/wiki/wiki/JavaScript-API.

web3.eth.ens

The web3.eth.ens functions let you interacting with Ens.

import Web3 from 'web3';
import {Ens} from 'web3-eth-ens';
import {Accounts} from 'web3-eth-accounts';

// "Web3.givenProvider" will be set if in an Ethereum supported browser.
const eth = new Ens(
    Web3.givenProvider || 'ws://some.local-or-remote.node:8546',
    new Accounts(Web3.givenProvider || 'ws://some.local-or-remote.node:8546', options),
    options
);


// or using the web3 umbrella package

const web3 = new Web3(Web3.givenProvider || 'ws://some.local-or-remote.node:8546', options);

// -> web3.eth.ens

---

registry

web3.eth.ens.registry;

Returns the network specific Ens registry.

Returns

Registry - The current Ens registry.

Example

web3.eth.ens.registry;
> {
    ens: Ens,
    contract: Contract,
    owner: Function(name),
    resolve: Function(name)
}

---

resolver

web3.eth.ens.resolver(name);

Returns the resolver contract to an Ethereum address.

Returns

Resolver - The Ens resolver for this name.

Example

web3.eth.ens.resolver('ethereum.eth').then((contract) => {
    console.log(contract);
});
> Contract<Resolver>

---

supportsInterface

web3.eth.ens.supportsInterface(ENSName, interfaceId);

Checks if the current resolver does support the desired interface.

Parameters

1. ENSName - String: The Ens name to resolve.
2. interfaceId - String: A defined ENS interfaceId.

Returns

Boolean - Returns true if the given interfaceId is supported by the resolver.

Example

web3.eth.ens.supportsInterface('ethereum.eth', '0xbc1c58d1').then((supportsInterface) => {
    console.log(supportsInterface);
})
> true

---

getAddress

web3.eth.ens.getAddress(ENSName);

Resolves an Ens name to an Ethereum address.

Parameters

1. ENSName - String: The Ens name to resolve.

Returns

String - The Ethereum address of the given name.

Example

web3.eth.ens.getAddress('ethereum.eth').then((address) => {
    console.log(address);
})
> 0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359

---

setAddress

web3.eth.ens.setAddress(ENSName, address, options);

Sets the address of an Ens name in his resolver.

Parameters

1. ENSName - String: The Ens name.
2. address - String: The address to set.

3. options - Object: The options used for sending.

   • from - String: The address the transaction should be sent from.
   • gasPrice - String (optional): The gas price in wei to use for this transaction.
   • gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an AddrChanged event.

Example

web3.eth.ens.setAddress(
    'ethereum.eth',
    '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
         console.log(result.events);
});
> AddrChanged(...)

// Or using the event emitter

web3.eth.ens.setAddress(
    'ethereum.eth',
    '0xfB6916095ca1df60bB79Ce92cE3Ea74c37c5d359',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

// Or listen to the AddrChanged event on the resolver

web3.eth.ens.resolver('ethereum.eth').then((resolver) => {
    resolver.events.AddrChanged({fromBlock: 0}, (error, event) => {
        console.log(event);
    })
    .on('data', (event) => {
        console.log(event);
    })
    .on('changed', (event) => {
        // remove event from local database
    })
    .on('error', console.error);
});

For further information on the handling of contract events please see here contract-events_.

---

getPubkey

web3.eth.ens.getPubkey(ENSName);

Returns the X and Y coordinates of the curve point for the public key.

Parameters

1. ENSName - String: The Ens name.

Returns

Object<String, String> - The X and Y coordinates.

Example

web3.eth.ens.getPubkey('ethereum.eth').then((result) => {
    console.log(result)
});
> {
    "0": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "1": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "x": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "y": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

---

setPubkey

web3.eth.ens.setPubkey(ENSName, x, y, options);

Sets the SECP256k1 public key associated with an Ens node

Parameters

1. ENSName - String: The Ens name.
2. x - String: The X coordinate of the public key.
3. y - String: The Y coordinate of the public key.

4. options - Object: The options used for sending.

   • from - String: The address the transaction should be sent from.
   • gasPrice - String (optional): The gas price in wei to use for this transaction.
   • gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an PubkeyChanged event.

Example

web3.eth.ens.setPubkey(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
    console.log(result.events);
});
> PubkeyChanged(...)

// Or using the event emitter

web3.eth.ens.setPubkey(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

// Or listen to the PubkeyChanged event on the resolver

web3.eth.ens.resolver('ethereum.eth').then((resolver) => {
    resolver.events.PubkeyChanged({fromBlock: 0}, function(error, event) {
        console.log(event);
    })
    .on('data', (event) => {
        console.log(event);
    })
    .on('changed', (event) => {
        // remove event from local database
    })
    .on('error', console.error);
});

For further information on the handling of contract events please see here contract-events_.

---

getText

web3.eth.ens.getText(ENSName, key);

Returns the text by the given key.

Parameters

1. ENSName - String: The Ens name. 1. key - String: The key of the array.

Returns

String - The ENS name. String - The key.

Example

web3.eth.ens.getText('ethereum.eth', 'key').then((result) => {
    console.log(result);
});
> "0000000000000000000000000000000000000000000000000000000000000000"

---

setText

web3.eth.ens.setText(ENSName, key, value, options);

Sets the content hash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.

2. key - String: The key. 2. value - String: The value. 3. options - Object: The options used for sending.

• from - String: The address the transaction should be sent from.
• gasPrice - String (optional): The gas price in wei to use for this transaction.
• gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an TextChanged event.

Example

web3.eth.ens.setText(
    'ethereum.eth',
    'key',
    'value',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
         console.log(result.events);
 });
> ContentChanged(...)

// Or using the event emitter

web3.eth.ens.setText(
    'ethereum.eth',
    'key',
    'value',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

// And listen to the TextChanged event on the resolver

web3.eth.ens.resolver('ethereum.eth').then((resolver) => {
    resolver.events.TextChanged({fromBlock: 0}, (error, event) => {
        console.log(event);
    })
    .on('data', (event) => {
        console.log(event);
    })
    .on('changed', (event) => {
        // remove event from local database
    })
    .on('error', console.error);
});

For further information on the handling of contract events please see here contract-events_.

---

getContent

web3.eth.ens.getContent(ENSName);

Returns the content hash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.

Returns

String - The content hash associated with an Ens node.

Example

web3.eth.ens.getContent('ethereum.eth').then((result) => {
    console.log(result);
});
> "0x0000000000000000000000000000000000000000000000000000000000000000"

---

setContent

web3.eth.ens.setContent(ENSName, hash, options);

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. options - Object: The options used for sending.

   • from - String: The address the transaction should be sent from.
   • gasPrice - String (optional): The gas price in wei to use for this transaction.
   • gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an ContentChanged event.

Example

web3.eth.ens.setContent(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
         console.log(result.events);
 });
> ContentChanged(...)

// Or using the event emitter

web3.eth.ens.setContent(
    'ethereum.eth',
    '0x0000000000000000000000000000000000000000000000000000000000000000',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

// Or listen to the ContentChanged event on the resolver

web3.eth.ens.resolver('ethereum.eth').then((resolver) => {
    resolver.events.ContentChanged({fromBlock: 0}, (error, event) => {
        console.log(event);
    })
    .on('data', (event) => {
        console.log(event);
    })
    .on('changed', (event) => {
        // remove event from local database
    })
    .on('error', console.error);
});

For further information on the handling of contract events please see here contract-events_.

---

getMultihash

web3.eth.ens.getMultihash(ENSName);

Returns the multihash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.

Returns

String - The associated multihash.

Example

web3.eth.ens.getMultihash('ethereum.eth').then((result) => {
    console.log(result);
});
> 'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK'

---

setMultihash

web3.eth.ens.setMultihash(ENSName, hash, options);

Sets the multihash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.
2. hash - String: The multihash to set.

3. options - Object: The options used for sending.

   • from - String: The address the transaction should be sent from.
   • gasPrice - String (optional): The gas price in wei to use for this transaction.
   • gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an ``MultihashChanged``event.

Example

web3.eth.ens.setMultihash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
    console.log(result.events);
});
> MultihashChanged(...)

// Or using the event emitter

web3.eth.ens.setMultihash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

For further information on the handling of contract events please see here contract-events_.

---

getContenthash

web3.eth.ens.getContenthash(ENSName);

Returns the contenthash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.

Returns

String - The associated contenthash.

Example

web3.eth.ens.getContenthash('ethereum.eth').then((result) => {
    console.log(result);
});
> 'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK'

---

setContenthash

web3.eth.ens.setContenthash(ENSName, hash, options);

Sets the contenthash associated with an Ens node.

Parameters

1. ENSName - String: The Ens name.
2. hash - String: The contenthash to set.

3. options - Object: The options used for sending.

   • from - String: The address the transaction should be sent from.
   • gasPrice - String (optional): The gas price in wei to use for this transaction.
   • gas - Number (optional): The maximum gas provided for this transaction (gas limit).

Emits an ``ContenthashChanged``event.

Example

web3.eth.ens.setContenthash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
).then((result) => {
    console.log(result.events);
});
> ContenthashChanged(...)

// Or using the event emitter

web3.eth.ens.setContenthash(
    'ethereum.eth',
    'QmXpSwxdmgWaYrgMUzuDWCnjsZo5RxphE3oW7VhTMSCoKK',
    {
        from: '0x9CC9a2c777605Af16872E0997b3Aeb91d96D5D8c'
    }
)
.on('transactionHash', (hash) => {
    ...
})
.on('confirmation', (confirmationNumber, receipt) => {
    ...
})
.on('receipt', (receipt) => {
    ...
})
.on('error', console.error);

For further information on the handling of contract events please see here contract-events_.

---

Ens events

The Ens API provides the possibility for listening to all Ens related events.

Known resolver events

1. AddrChanged - AddrChanged(node bytes32, a address)

2. ContentChanged - ContentChanged(node bytes32, hash bytes32) 4. NameChanged - NameChanged(node bytes32, name string) 5. ABIChanged - ABIChanged(node bytes32, contentType uint256) 6. PubkeyChanged - PubkeyChanged(node bytes32, x bytes32, y bytes32) 6. TextChanged - TextChanged(bytes32 indexed node, string indexedKey, string key) 6. ContenthashChanged - ContenthashChanged(bytes32 indexed node, bytes hash)

Example

web3.eth.ens.resolver('ethereum.eth').then((resolver) => {
    resolver.events.AddrChanged({fromBlock: 0}, (error, event) => {
        console.log(event);
    })
    .on('data', (event) => {
        console.log(event);
    })
    .on('changed', (event) => {
        // remove event from local database
    })
    .on('error', console.error);
});
> {
    returnValues: {
        node: '0x123456789...',
        a: '0x123456789...',
    },
    raw: {
        data: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
        topics: [
            '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
            '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385'
        ]
    },
    event: 'AddrChanged',
    signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    logIndex: 0,
    transactionIndex: 0,
    transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    blockHash: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    blockNumber: 1234,
    address: '0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe'
}

Known registry events

1. Transfer - Transfer(node bytes32, owner address)

2. NewOwner - NewOwner(node bytes32, label bytes32, owner address) 4. NewResolver - NewResolver(node bytes32, resolver address) 5. NewTTL - NewTTL(node bytes32, ttl uint64)

Example

web3.eth.ens.resistry.then((registry) => {
    registry.events.Transfer({fromBlock: 0}, (error, event) => {
          console.log(event);
      })
      .on('data', (event) => {
          console.log(event);
      })
      .on('changed', (event) => {
          // remove event from local database
      })
      .on('error', console.error);
});
> {
    returnValues: {
        node: '0x123456789...',
        owner: '0x123456789...',
    },
    raw: {
        data: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
        topics: [
            '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
            '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385'
        ]
    },
    event: 'Transfer',
    signature: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    logIndex: 0,
    transactionIndex: 0,
    transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    blockHash: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    blockNumber: 1234,
    address: '0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe'
}

For further information on the handling of contract events please see here contract-events_.

---