/universal-resolver

Universal Resolver implementation and drivers.

Primary LanguageJavaApache License 2.0Apache-2.0

DIF Logo

Universal Resolver

A Universal Resolver is an identifier resolver that works with any decentralized identifier system, including Decentralized Identifiers (DIDs).

See this blog post and this webinar for an introduction.

See https://uniresolver.io/ for a publicly hosted instance of a Universal Resolver.

Quick Start

You can deploy the Universal Resolver on your local machine by cloning this Github repository, and using docker-compose to build and run the Universal Resolver as well as its drivers.

Before running docker-compose, please place a valid Personal Access Token for GitHub in file resolver/java/settings.xml, as explained here Creating a personal access token for the command line. Only the scope read:packages is required.

git clone https://github.com/decentralized-identity/universal-resolver
cd universal-resolver/
docker-compose -f docker-compose.yml pull
docker-compose -f docker-compose.yml up

You should then be able to resolve identifiers locally using simple curl requests as follows:

curl -X GET http://localhost:8080/1.0/identifiers/did:sov:WRfXPg8dantKVubE3HX8pw
curl -X GET http://localhost:8080/1.0/identifiers/did:btcr:xz35-jznz-q6mr-7q6
curl -X GET http://localhost:8080/1.0/identifiers/did:v1:test:nym:3AEJTDMSxDDQpyUftjuoeZ2Bazp4Bswj1ce7FJGybCUu
curl -X GET http://localhost:8080/1.0/identifiers/did:ipid:QmYA7p467t4BGgBL4NmyHtsXMoPrYH9b3kSG6dbgFYskJm
curl -X GET http://localhost:8080/1.0/identifiers/did:web:uport.me
curl -X GET http://localhost:8080/1.0/identifiers/did:ethr:0x3b0BC51Ab9De1e5B7B6E34E5b960285805C41736
curl -X GET http://localhost:8080/1.0/identifiers/did:nacl:Md8JiMIwsapml_FtQ2ngnGftNP5UmVCAUuhnLyAsPxI
curl -X GET http://localhost:8080/1.0/identifiers/did:jolo:e76fb4b4900e43891f613066b9afca366c6d22f7d87fc9f78a91515be24dfb21
curl -X GET http://localhost:8080/1.0/identifiers/did:stack:v0:16EMaNw3pkn3v6f2BgnSSs53zAKH4Q8YJg-0
curl -X GET http://localhost:8080/1.0/identifiers/did:erc725:ropsten:2F2B37C890824242Cb9B0FE5614fA2221B79901E
curl -X GET http://localhost:8080/1.0/identifiers/did:hcr:0f674e7e-4b49-4898-85f6-96176c1e30de
curl -X GET http://localhost:8080/1.0/identifiers/did:neoid:priv:b4eeeb80d20bfb38b23001d0659ce0c1d96be0aa
curl -X GET http://localhost:8080/1.0/identifiers/did:elem:EiAS3mqC4OLMKOwcz3ItIL7XfWduPT7q3Fa4vHgiCfSG2A
curl -X GET http://localhost:8080/1.0/identifiers/did:github:gjgd
curl -X GET http://localhost:8080/1.0/identifiers/did:ccp:ceNobbK6Me9F5zwyE3MKY88QZLw
curl -X GET http://localhost:8080/1.0/identifiers/did:work:2UUHQCd4psvkPLZGnWY33L
curl -X GET http://localhost:8080/1.0/identifiers/did:ont:AN5g6gz9EoQ3sCNu7514GEghZurrktCMiH
curl -X GET http://localhost:8080/1.0/identifiers/did:kilt:5GFs8gCumJcZDDWof5ETFqDFEsNwCsVJUj2bX7y4xBLxN5qT
curl -X GET http://localhost:8080/1.0/identifiers/did:evan:testcore:0x126E901F6F408f5E260d95c62E7c73D9B60fd734

If this doesn't work, see Troubleshooting.

Drivers

Are you developing a DID method and Universal Resolver driver? Click Driver Development for instructions.

Driver Name Driver Version DID Spec Version DID Method Spec Version Docker Image
did-btcr 0.1-SNAPSHOT 1.0 WD 0.1 universalresolver/driver-did-btcr
did-sov 0.1-SNAPSHOT 1.0 WD 0.1 universalresolver/driver-did-sov
did-erc725 0.1-SNAPSHOT 1.0 WD 0.1 universalresolver/driver-did-erc725
did-stack 0.1 1.0 WD (missing) universalresolver/driver-did-stack
did-dom 0.1-SNAPSHOT 1.0 WD (missing) universalresolver/driver-did-dom
did-uport 1.3.1 1.0 WD 1.0 uport/uni-resolver-driver-did-uport
did-v1 1.0 WD 1.0
did-ipid 1.0 WD 0.1
did-jolo 0.1 1.0 WD 0.1 jolocomgmbh/jolocom-did-driver
did-hacera 0.1 1.0 WD (missing) hacera/hacera-did-driver
did-elem 0.1 1.0 WD (missing)
did-seraphid 0.1 1.0 WD (missing) swisscomblockchainag/seraph-id-did-driver
did-github 0.1 1.0 WD (missing)
did-ccp 0.1-SNAPSHOT 1.0 WD 0.1 hello2mao/driver-did-ccp
did-work 0.1 1.0 WD 1.0 didwork/work-did-driver
did-ont 0.1 1.0 WD 1.0 ontio/ontid-driver
did-kilt 1.0.1 1.0 WD 1.0 kiltprotocol/kilt-did-driver
did-evan 0.1 1.0 WD 0.9 evannetwork/evan-did-driver

More Information

About

Decentralized Identity Foundation - http://identity.foundation/


Supported by NLnet and NGI0 PET, which is made possible with financial support from the European Commission's Next Generation Internet programme.