Table of Contents
Defines a method of associating contract interfaces with ENS names and addresses, and of discovering those interfaces.
This EIP specifies a method for exposing interfaces associated with an ENS name or an address (typically a contract address) and allowing applications to discover those interfaces and interact with them. Interfaces can be implemented either by the target contract (if any) or by any other contract.
EIP 165 supports interface discovery - determining if the contract at a given address supports a requested interface. However, in many cases it’s useful to be able to discover functionality associated with a name or an address that is implemented by other contracts.
For example, a token contract may not itself provide any kind of ‘atomic swap’ functionality, but there may be associated contracts that do. With ENS interface discovery, the token contract can expose this metadata, informing applications where they can find that functionality.
A new profile for ENS resolvers is defined, consisting of the following method:
function interfaceImplementer(bytes32 node, bytes4 interfaceID) external view returns (address);
The EIP-165 interface ID of this interface is
Given an ENS name hash
node and an EIP-165
interfaceID, this function returns the address of an appropriate implementer of that interface. If there is no interface matching that interface ID for that node, 0 is returned.
The address returned by
interfaceImplementer MUST refer to a smart contract.
The smart contract at the returned address SHOULD implement EIP-165.
Resolvers implementing this interface MAY utilise a fallback strategy: If no matching interface was explicitly provided by the user, query the contract returned by
addr(), returning its address if the requested interface is supported by that contract, and 0 otherwise. If they do this, they MUST ensure they return 0, rather than reverting, if the target contract reverts.
This field may be used with both forward resolution and reverse resolution.
A naive approach to this problem would involve adding this method directly to the target contract. However, doing this has several shortcomings:
- Each contract must maintain its own list of interface implementations.
- Modifying this list requires access controls, which the contract may not have previously required.
- Support for this must be designed in when the contract is written, and cannot be retrofitted afterwards.
- Only one canonical list of interfaces can be supported.
Using ENS resolvers instead mitigates these shortcomings, making it possible for anyone to associate interfaces with a name, even for contracts not previously built with this in mind.
There are no backwards compatibility issues.
The PublicResolver in the ensdomains/resolvers repository implements this interface.
Copyright and related rights waived via CC0.
Please cite this document as:
Nick Johnson, "EIP-1844: ENS Interface Discovery," Ethereum Improvement Proposals, no. 1844, March 2019. [Online serial]. Available: https://eips.ethereum.org/EIPS/eip-1844.