resolution-cli

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

Quick Start

Download binaries from release pages

Find binary on releases page

Installation using go

go get -u github.com/unstoppabledomains/resolution-cli/resolution

Build and install from sources

go build -o ./cli ./resolution
mv ./cli /usr/local/bin/resolution

Run

resolution --help

Ethereum Provider

UNS 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.

L1

Options for defining a custom Ethereum provider:

• RESOLUTION_ETHEREUM_PROVIDER_URL env variable to specify the provider URL
• RESOLUTION_ETHEREUM_NETWORK_ID env variable to specify the network type (mainnet or rinkeby)
• --ethereum-provider-url flag to specify the provider URL
• --ethereum-network-id flag to specify the network type (mainnet or rinkeby)

The CLI prioritizes the --ethereum-provider-url and --ethereum-network-id flags

L2

Options for defining a custom Polygon L2 provider:

• RESOLUTION_ETHEREUM_L2_PROVIDER_URL env variable to specify the provider URL
• RESOLUTION_ETHEREUM_L2_NETWORK_ID env variable to specify the network type (polygon or matic)
• --ethereum-l2-provider-url flag to specify the provider URL
• --ethereum-l2-network-id flag to specify the network type (polygon or matic)

The CLI prioritizes the --ethereum-l2-provider-url and --ethereum-l2-network-id flags

Zilliqa Provider

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_URL env variable

• --zilliqa-provider-url flag

The CLI prioritizes the --zilliqa-provider-url flag

Resolve a Domain

Address

Resolve single address from ticker symbol

resolution resolve addr ETH -d brad.crypto

IPFS

Resolve ipfs hash

resolution resolve ipfs-hash -d brad.zil

All

Resolve all known records

resolution resolve -d brad.zil

Raw records

Resolve records from exact record keys. See supported records reference here

resolution resolve records crypto.ETH.adddress crypto.BTC.address -d brad.crypto

Output format

CLI provides JSON output or quoted string in case of single return value

Network support

CLI supports Ethereum, Polygon, and Zilliqa mainnet only.

Contributions

Contributions are more than welcome. The easiest way to contribute is through GitHub issues and pull requests.

Development

Run end-to-end tests

bash run-e2e-test.sh

Build binaries for Windows, MacOS and Linux

bash build-binaries.sh

Find the binaries in ./build directory

Note: Each new release should include these binaries attached

Free advertising for integrated apps

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.

Get help

Join our discord community and ask questions.