# Resolver contract

Each TLD has in-built resolver (getDomainHolder) and reverse-resolver (defaultNames) functions. But in order to simplify resolving domains, there's also the PunkResolver contract, which can resolve all punk TLDs.

The benefit is that you only need to store one contract address (the PunkResolver), instead of all TLD addresses.

Resolver addresses (proxy): https://docs.punk.domains/addresses/resolver-addresses/

Contract code: https://github.com/punk-domains-2/punk-contracts/tree/main/contracts/resolver

ABI: https://github.com/punk-domains-2/punk-abi/blob/main/PunkResolverAbi.json

mapping (address => bool) public isTldDeprecated;

Resolver owner (Punk Domains governance) can deprecate or delist a TLD. This does not mean that TLD contract is not functional anymore. It's just preventing it from being resolved through the Resolver contract. Everything else regarding the TLD contract will still work as before.

address[] public factories;

The array of TLD Factory contracts that this Resolver contract supports.

Returns the default domain for an address on a given TLD.

function getDefaultDomain(address _addr, string calldata _tld) public view returns(string memory)

Input:

• _addr: the address of which you want to get a default domain
• _tld: the top-level domain in question

Output:

• The default domain name. If none, it returns an empty string.

Note that this function name is in plural!

Returns a stringified list of default domains across all TLDs (comma-separated string).

function getDefaultDomains(address _addr) public view returns(string memory)

Input:

• _addr: the address of which you want to get a default domain

Output:

• A list of default domain names (comma-separated string). If none, it returns an empty string.

Returns the address that owns a given domain.

function getDomainHolder(string calldata _domainName, string calldata _tld) public view returns(address)

Input:

• _domainName: the name part of the domain (like "tempe" in "tempe.wagmi")
• _tld: the domain extension (like ".wagmi")

Output:

• The address that owns a given domain.

Returns the custom data of a given domain.

function getDomainData(string calldata _domainName, string calldata _tld) public view returns(string memory)

Input:

• _domainName: the name part of the domain (like "tempe" in "tempe.wagmi")
• _tld: the domain extension (like ".wagmi")

Output:

• Custom data (JSON string)

Returns the metadata of a given domain. Note that metadata is base64 encoded, so you need to decode it first.

function getDomainTokenUri(string calldata _domainName, string calldata _tld) public view returns(string memory)

Input:

• _domainName: the name part of the domain (like "tempe" in "tempe.wagmi")
• _tld: the domain extension (like ".wagmi")

Output:

• Metadata (JSON string)

Returns the array of TLD factories supported by this Resolver contract.

function getFactoriesArray() public view returns(address[] memory)

Output:

• Array of factory addresses

Returns a single default domain across all TLDs (the one that comes first, but was not necessarily created first).

function getFirstDefaultDomain(address _addr) public view returns(string memory)

Input:

• _addr: the address of which you want to get a default domain

Output:

• A single domain name.

Fetch the address of a given top-level domain (unless it was marked as deprecated).

function getTldAddress(string calldata _tldName) public view returns(address)

Input:

• _tldName: top-level domain name (example: ".wagmi")

Output:

• The TLD contract address

Fetch the address of the Factory of a given top-level domain (unless the TLD was marked as deprecated).

function getTldFactoryAddress(string calldata _tldName) public view returns(address)

Input:

• _tldName: top-level domain name (example: ".wagmi")

Output:

• The TLD Factory contract address

Fetch a list of all (non-deprecated) TLDs and their addresses.

function getTlds() public view returns(string memory)

Output:

• List of all active TLDs (stringified CSV)

Resolver owner can add a factory address to the Resolver's factory array.

function addFactoryAddress(address _factoryAddress) external onlyOwner

Input:

• _factoryAddress: TLD Factory address

Resolver owner can deprecate a TLD address. This means that the Resolver contract does not support it anymore.

function addDeprecatedTldAddress(address _deprecatedTldAddress) external onlyOwner

Input:

• _deprecatedTldAddress: TLD address

Resolver owner can remove a factory address from the Resolver's factory array.

function removeFactoryAddress(uint _addrIndex) external onlyOwner

Input:

• _addrIndex: TLD Factory address index in the array

Resolver owner can remove a TLD address from being deprecated. After that, the TLD address is not deprecated anymore and can be resolved through the Resolver contract.

function removeDeprecatedTldAddress(address _deprecatedTldAddress) external onlyOwner

Input:

• _deprecatedTldAddress: TLD address