{"id":13582197,"url":"https://github.com/unstoppabledomains/resolution-cli","last_synced_at":"2025-07-18T11:40:41.461Z","repository":{"id":39850483,"uuid":"344660153","full_name":"unstoppabledomains/resolution-cli","owner":"unstoppabledomains","description":"CLI tool for resolving unstoppable domains","archived":false,"fork":false,"pushed_at":"2023-10-11T21:32:22.000Z","size":319,"stargazers_count":27,"open_issues_count":6,"forks_count":5,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-03-26T11:21:27.584Z","etag":null,"topics":["crypto","unstoppable-domains","zilliqa"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unstoppabledomains.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-03-05T01:35:05.000Z","updated_at":"2024-12-20T03:15:51.000Z","dependencies_parsed_at":"2024-06-19T02:07:11.557Z","dependency_job_id":null,"html_url":"https://github.com/unstoppabledomains/resolution-cli","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unstoppabledomains%2Fresolution-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unstoppabledomains","download_url":"https://codeload.github.com/unstoppabledomains/resolution-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248602302,"owners_count":21131615,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crypto","unstoppable-domains","zilliqa"],"created_at":"2024-08-01T15:02:29.248Z","updated_at":"2025-04-12T17:06:42.484Z","avatar_url":"https://github.com/unstoppabledomains.png","language":"Go","readme":"# resolution-cli\n\n![Test](https://github.com/unstoppabledomains/resolution-cli/actions/workflows/e2e-test.yml/badge.svg?branch=master)\n![Lint](https://github.com/unstoppabledomains/resolution-cli/actions/workflows/lint.yml/badge.svg?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/unstoppabledomains/resolution-cli)](https://goreportcard.com/report/github.com/unstoppabledomains/resolution-cli)\n[![GoDoc](https://godoc.org/github.com/unstoppabledomains/resolution-cli?status.svg)](https://pkg.go.dev/github.com/unstoppabledomains/resolution-cli)\n[![Unstoppable Domains Documentation](https://img.shields.io/badge/docs-unstoppabledomains.com-blue)](https://docs.unstoppabledomains.com/)\n[![Get help on Discord](https://img.shields.io/badge/Get%20help%20on-Discord-blueviolet)](https://discord.gg/b6ZVxSZ9Hn)\n\nSimple CLI tool for resolving Unstoppable domains\n\nresolution-cli is a tool for interacting with blockchain domain names. It can be used to retrieve [payment addresses](https://unstoppabledomains.com/features#Add-Crypto-Addresses), IPFS hashes for [decentralized websites](https://unstoppabledomains.com/features#Build-Website), DNS records and other [records types](https://docs.unstoppabledomains.com/domain-registry-essentials/records-reference)\n\nresolution-cli is primarily built and maintained by [Unstoppable Domains](https://unstoppabledomains.com/).\n\nresolution-cli supports decentralized domains across two zones:\n\n- Crypto Name Service (UNS)\n  - `.crypto`\n  - `.coin`\n  - `.wallet`\n  - `.bitcoin`\n  - `.x`\n  - `.888`\n  - `.nft`\n  - `.dao`\n- Zilliqa Name Service (ZNS)\n  - `.zil`\n\n# Quick Start\n\n## Download binaries from release pages\n\n[Find binary on releases page](https://github.com/unstoppabledomains/resolution-cli/releases)\n\n## Installation using go\n\n```shell\ngo get -u github.com/unstoppabledomains/resolution-cli/resolution\n```\n\n### Build and install from sources\n\n```shell\ngo build -o ./cli ./resolution\nmv ./cli /usr/local/bin/resolution\n```\n\n## Run\n\n```shell\nresolution --help\n```\n\n### Ethereum Provider\n\nUNS domains are resolved by reading from both the Ethereum mainnet and Polygon L2 network.\n\nIf L1 and L2 Ethereum JSON RPC are not defined, default Infura Ethereum Provider Urls for L1 and L2 will be used.\n\nNOTE: L1 and L2 networks must both be defined or none at all.\n\n#### L1\n\nOptions for defining a custom Ethereum provider:\n\n- `RESOLUTION_ETHEREUM_PROVIDER_URL` env variable to specify the provider URL\n- `RESOLUTION_ETHEREUM_NETWORK_ID` env variable to specify the network type (mainnet or rinkeby)\n- `--ethereum-provider-url` flag to specify the provider URL\n- `--ethereum-network-id` flag to specify the network type (mainnet or rinkeby)\n\nThe CLI prioritizes the `--ethereum-provider-url` and `--ethereum-network-id` flags\n\n#### L2\n\nOptions for defining a custom Polygon L2 provider:\n\n- `RESOLUTION_ETHEREUM_L2_PROVIDER_URL` env variable to specify the provider URL\n- `RESOLUTION_ETHEREUM_L2_NETWORK_ID` env variable to specify the network type (polygon or matic)\n- `--ethereum-l2-provider-url` flag to specify the provider URL\n- `--ethereum-l2-network-id` flag to specify the network type (polygon or matic)\n\nThe CLI prioritizes the `--ethereum-l2-provider-url` and `--ethereum-l2-network-id` flags\n\n### Zilliqa Provider\n\nIf no Ethereum JSON RPC ethereum-provider-url is defined, a default Zilliqa mainnet Provider Url will be used\n\nOptions for defining a ethereumProviderUrlFlag:\n\n- `ZILLIQA_PROVIDER_URL` env variable\n\n- `--zilliqa-provider-url` flag\n\nThe CLI prioritizes the `--zilliqa-provider-url` flag\n\n# Resolve a Domain\n\n## Address\n\nResolve single address from ticker symbol\n\n```shell\nresolution resolve addr ETH -d brad.crypto\n```\n\n## IPFS\n\nResolve ipfs hash\n\n```shell\nresolution resolve ipfs-hash -d brad.zil\n```\n\n## All\n\nResolve all known records\n\n```shell\nresolution resolve -d brad.zil\n```\n\n## Raw records\n\nResolve records from exact record keys. See supported records reference [here](https://docs.unstoppabledomains.com/domain-registry-essentials/records-reference)\n\n```shell\nresolution resolve records crypto.ETH.adddress crypto.BTC.address -d brad.crypto\n```\n\n# Output format\n\nCLI provides JSON output or quoted string in case of single return value\n\n# Network support\n\nCLI supports Ethereum, Polygon, and Zilliqa mainnet only.\n\n# Contributions\n\nContributions are more than welcome. The easiest way to contribute is through GitHub issues and pull requests.\n\n# Development\n\n## Run end-to-end tests\n\n```shell\nbash run-e2e-test.sh\n```\n\n## Build binaries for Windows, MacOS and Linux\n\n```shell\nbash build-binaries.sh\n```\n\nFind the binaries in `./build` directory\n\n**Note: Each new release should include these binaries attached**\n\n# Free advertising for integrated apps\n\nOnce your app has a working Unstoppable Domains integration, [register it here](https://unstoppabledomains.com/app-submission). Registered apps appear on the Unstoppable Domains [homepage](https://unstoppabledomains.com/) and [Applications](https://unstoppabledomains.com/apps) page — putting your app in front of tens of thousands of potential customers per day.\n\nAlso, 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.\n\n# Get help\n\n[Join our discord community](https://discord.com/invite/b6ZVxSZ9Hn) and ask questions.\n","funding_links":[],"categories":["Go"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funstoppabledomains%2Fresolution-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funstoppabledomains%2Fresolution-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funstoppabledomains%2Fresolution-cli/lists"}