yutongp / universal-resolver

Universal Resolver implementation and drivers.

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:z6Mkmpe2DyE4NsDiAb58d75hpi1BjqbH6wYMschUkjWDEEuR
curl -X GET http://localhost:8080/1.0/identifiers/did:key:z6Mkfriq1MqLBoPWecGoDLjguo1sB9brj6wT3qZ5BxkKpuP6
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
curl -X GET http://localhost:8080/1.0/identifiers/did:echo:1.1.25.0
curl -X GET http://localhost:8080/1.0/identifiers/did:factom:testnet:6aa7d4afe4932885b5b6e93accb5f4f6c14bd1827733e05e3324ae392c0b2764
curl -X GET http://localhost:8080/1.0/identifiers/did:dock:5FXqofpV7dsuki925U1dSzDvBuQbaci5yWTQGVWRQ7bdQP5p
curl -X GET http://localhost:8080/1.0/identifiers/did:abt:z116ygT18P67xBp3scBtZLU6xVoDy268bgnY
curl -X GET http://localhost:8080/1.0/identifiers/did:trustbloc:testnet.trustbloc.dev:EiCiHVdJsCySvw2JHHGnpIxege4UF0Zuu1Y6Nd5n1FIBVw

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-abt	0.1-SNAPSHOT	1.0 WD	0.1	arcblock/driver-did-abt
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	0.1	1.0 WD	1.0	veresone/uni-resolver-did-v1-driver
did-key	0.1	1.0 WD	0.7	veresone/uni-resolver-did-v1-driver
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.2	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
did-echo	0.0.1	1.0 WD	1.0	echoprotocol/uni-resolver-driver-did-echo
did-factom	0.1-SNAPSHOT	1.0 WD	1.0	sphereon/driver-did-factom
did-key	1.0.0	1.0 WD	0.7	universalresolver/driver-did-key
did-dock	0.1.0	1.0 WD	0.1	docknetwork/dock-did-driver
did-trustbloc	0.1.3	1.0 WD	0.1	trustbloc/driver-did-trustbloc

More Information

• Driver Development
• Continuous Integration and Delivery
• Development System
• Creating Releases
• Branching Strategy
• Design Goals
• Troubleshooting
• Java Components

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.