Resolution Troubleshooting Guide

Here are some of the problems you may frequently encounter when integrating crypto payments with Unstoppable Domains and how to fix them.

UnregisteredDomain or DomainNotRegisteredError

This error occurs when you try to resolve a domain that is not registered and owned by any address on the blockchain. The solution is to provide an existing domain to the resolution library or inform the user to double-check their input.

RecordNotFound Error

This error occurs when you try to resolve a domain record that does not exist, for example, resolving the Twitter handle of a domain that doesn't have one. The solution is to inform the user that they have not set the record you request.

UnspecifiedResolver Error

This error occurs when the resolution libraries cannot find a resolver contract address for the domain you're trying to resolve. The solution is to inform the user that their domain has no resolver or manually provide one for the library.

UnsupportedDomain or DomainNotSupportedError

This error occurs when you try to resolve a domain with an ending not supported by Unstoppable Domains. The solution is to provide a domain with a supported ending to the resolution instance or inform the user to double-check their input.

InvalidDomain Error

This error can pop up in the following ways depending on the resolution library: InvalidDomain, InvalidDomainAddress, invalidDomainName, and InvalidDomainNameReturnedError. It occurs when you try to resolve a domain that follows an invalid format, for example, resolving a domain name with a missing ending or does not follow standard domain naming conventions.