Resolving Names On-chain

Solidity libraries for on-chain resolution are not yet available, but PNS resolution is straightforward enough it can be done trivially without a library. First, we define some pared-down interfaces containing only the methods we need:

abstract contract PNS {
    function resolver(bytes32 node) public virtual view returns (Resolver);

abstract contract Resolver {
    function addr(bytes32 node) public virtual view returns (address);

For resolution, only the resolver function in the PNS contract is required; other methods permit looking up owners and updating PNS from within a contract that owns a name.

With these definitions, looking up a name given its node hash is straightforward:

contract MyContract {
    // Same address for Mainet, Testnet and other networks;
    PNS pns = PNS(TBD);

    function resolve(bytes32 node) public view returns(address) {
        Resolver resolver = pns.resolver(node);
        return resolver.addr(node);

While it is possible for a contract to process a human-readable name into a node hash, we highly recommend working with node hashes instead, as they are easier and more efficient to work with, and allow contracts to leave the complex work of normalizing the name to their callers outside the blockchain. Where a contract always resolves the same names, those names may be converted to a node hash and stored in the contract as a constant.

Last updated