Simple CLI tool for resolving Unstoppable domains
resolution-cli is a tool for interacting with blockchain domain names. It can be used to retrieve payment addresses, IPFS hashes for decentralized websites, DNS records and other records types
resolution-cli is primarily built and maintained by Unstoppable Domains.
resolution-cli supports decentralized domains across two zones:
- Crypto Name Service (UNS)
.crypto.coin.wallet.bitcoin.x.888.nft.dao
- Zilliqa Name Service (ZNS)
.zil
go get -u github.com/unstoppabledomains/resolution-cli/resolutiongo build -o ./cli ./resolution
mv ./cli /usr/local/bin/resolutionresolution --helpUNS domains are resolved by reading from both the Ethereum mainnet and Polygon L2 network.
If L1 and L2 Ethereum JSON RPC are not defined, default Infura Ethereum Provider Urls for L1 and L2 will be used.
NOTE: L1 and L2 networks must both be defined or none at all.
Options for defining a custom Ethereum provider:
RESOLUTION_ETHEREUM_PROVIDER_URLenv variable to specify the provider URLRESOLUTION_ETHEREUM_NETWORK_IDenv variable to specify the network type (mainnet or rinkeby)--ethereum-provider-urlflag to specify the provider URL--ethereum-network-idflag to specify the network type (mainnet or rinkeby)
The CLI prioritizes the --ethereum-provider-url and --ethereum-network-id flags
Options for defining a custom Polygon L2 provider:
RESOLUTION_ETHEREUM_L2_PROVIDER_URLenv variable to specify the provider URLRESOLUTION_ETHEREUM_L2_NETWORK_IDenv variable to specify the network type (polygon or matic)--ethereum-l2-provider-urlflag to specify the provider URL--ethereum-l2-network-idflag to specify the network type (polygon or matic)
The CLI prioritizes the --ethereum-l2-provider-url and --ethereum-l2-network-id flags
If no Ethereum JSON RPC ethereum-provider-url is defined, a default Zilliqa mainnet Provider Url will be used
Options for defining a ethereumProviderUrlFlag:
-
ZILLIQA_PROVIDER_URLenv variable -
--zilliqa-provider-urlflag
The CLI prioritizes the --zilliqa-provider-url flag
Resolve single address from ticker symbol
resolution resolve addr ETH -d brad.cryptoResolve ipfs hash
resolution resolve ipfs-hash -d brad.zilResolve all known records
resolution resolve -d brad.zilResolve records from exact record keys. See supported records reference here
resolution resolve records crypto.ETH.adddress crypto.BTC.address -d brad.cryptoCLI provides JSON output or quoted string in case of single return value
CLI supports Ethereum, Polygon, and Zilliqa mainnet only.
Contributions are more than welcome. The easiest way to contribute is through GitHub issues and pull requests.
bash run-e2e-test.shbash build-binaries.shFind the binaries in ./build directory
Note: Each new release should include these binaries attached
Once your app has a working Unstoppable Domains integration, register it here. Registered apps appear on the Unstoppable Domains homepage and Applications page — putting your app in front of tens of thousands of potential customers per day.
Also, every week we select a newly-integrated app to feature in the Unstoppable Update newsletter. This newsletter is delivered to straight into the inbox of ~100,000 crypto fanatics — all of whom could be new customers to grow your business.
Join our discord community and ask questions 67B4 .