Practical overview
When it fits
Use Resolution when application code needs to translate blockchain-domain names into payment addresses or retrieve domain records, and the project's supported domains and provider configuration match the integration.
Who it is for
- Developers adding blockchain-domain lookups to an application.
- Teams building wallet or address-entry flows that accept domain names.
- Developers retrieving IPFS hashes or custom domain records.
Documented uses
- Resolve a domain and currency to a payment address.
- Retrieve an IPFS hash associated with a decentralized website.
- Read a requested custom record from a domain.
Requirements & limits
- Installation is documented through npm and Yarn.
- The library supports API-key-based UNS initialization and custom provider configurations, including provider factories for Alchemy, Infura, Web3 and ethers.
- The README says network autodetection configures UNS only; ZNS uses Zilliqa mainnet.
- Custom-record lookup is explicitly documented as not supporting ENS.
- The repository is public and identifies an MIT license.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install Resolution and configure a provider
Add the library to a project and initialize it with a documented provider configuration.
Before you start
- A project using npm or Yarn.
- An API key for the UNS API-key initialization option, or credentials and provider configuration for a custom provider.
Steps
Install @unstoppabledomains/resolution with npm or Yarn.
Initialize the library using the documented Resolution constructor.
For custom configuration, provide the required network locations and provider details; the README example includes Infura credentials and Zilliqa configuration.
Expected outcome
The project has the library installed and a Resolution instance initialized with the selected provider configuration.
Guide limitations
- The UNS API key is used only to resolve domains from UNS.
- Network and domain-system support varies by configuration; the README says ZNS uses Zilliqa mainnet.
Add a blockchain-domain address lookup
Use the documented addr method to request a payment address for a domain and currency.
Before you start
- Resolution installed and initialized with a suitable provider configuration.
Steps
Call resolution.addr with a domain and currency.
Handle the returned address and rejected lookup using a promise handler, as shown in the README.
Expected outcome
The application receives the address returned for the requested domain and currency.
Guide limitations
- The README directs developers to its supported top-level-domain list and API reference for further support details.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 10 October 2026
- Original website title
- unstoppabledomains/resolution · Official homepage title · retained in its source language