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://resolver.identity.foundation/ for a stable version or https://dev.uniresolver.io/ for a test 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.

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:did.actor:alice
curl -X GET http://localhost:8080/1.0/identifiers/did:web:did.actor:bob
curl -X GET http://localhost:8080/1.0/identifiers/did:web:did.actor:mike
curl -X GET http://localhost:8080/1.0/identifiers/did:ethr:mainnet:0x3b0BC51Ab9De1e5B7B6E34E5b960285805C41736
curl -X GET http://localhost:8080/1.0/identifiers/did:ethr:0x4:0x3b0BC51Ab9De1e5B7B6E34E5b960285805C41736
curl -X GET http://localhost:8080/1.0/identifiers/did:ethr:0x02b97c30de767f084ce3080168ee293053ba33b235d7116a3263d29f1450936b71
curl -X GET http://localhost:8080/1.0/identifiers/did:ethr:0x1e:0x02b97c30de767f084ce3080168ee293053ba33b235d7116a3263d29f1450936b71
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:5CqJa4Ct7oMeMESzehTiN9fwYdGLd7tqeirRMpGDh2XxYYyx
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:EiBLTZcCj6u_XsufSuLVh2zbPEREjDcu8bnPgs0XyKkfPQ
curl -X GET http://localhost:8080/1.0/identifiers/did:sirius:2VhYrbauc2cCx9ZpCp5wrDtK7HKf7jrsvgoKBD4KgK
curl -X GET http://localhost:8080/1.0/identifiers/did:mpg:7PGGnRdvKKFftSXU3Jw75Vk5npfg
curl -X GET http://localhost:8080/1.0/identifiers/did:trust:cert.EiDi8NEZVyvqmHeWRB5kUagWo3sDSQlCtl1nZ1vVgLdozw
curl -X GET http://localhost:8080/1.0/identifiers/did:io:0x476c81C27036D05cB5ebfe30ae58C23351a61C4A
curl -X GET http://localhost:8080/1.0/identifiers/did:bba:t:45e6df15dc0a7d91dcccd24fda3b52c3983a214fb0eed0938321c11ec99403cf
curl -X GET http://localhost:8080/1.0/identifiers/did:cy:2nnn7H7RJLLhFPoGyzxPCLzuhrzJ
curl -X GET http://localhost:8080/1.0/identifiers/did:bid:6cc796b8d6e2fbebc9b3cf9e
curl -X GET http://localhost:8080/1.0/identifiers/did:schema:public-ipfs:json-schema:Qma2beXKwZeiUXcaRaQKwbBV1TqyiJnsMTYExUTdQue43J
curl -X GET http://localhost:8080/1.0/identifiers/did:ion:EiClkZMDxPKqC9c-umQfTkR8vvZ9JPhl_xLDI9Nfk38w5w
curl -X GET http://localhost:8080/1.0/identifiers/did:ace:0xf81c16a78b257c10fddf87ed4324d433317169a005ddf36a3a1ba937ba9788e3
curl -X GET http://localhost:8080/1.0/identifiers/did:gatc:2xtSori9UQZdTqzxrkp7zqKM4Kj5B4C7
curl -X GET http://localhost:8080/1.0/identifiers/did:icon:01:64aa0a2a479cb47afbf2d18d6f9f216bcdcbecdda27ccba3
curl -X GET http://localhost:8080/1.0/identifiers/did:vaa:3wJVWDQWtDFx27FqvSqyo5xsTsxC
curl -X GET http://localhost:8080/1.0/identifiers/did:unisot:1EjHm7VtgsqNzCkvA8XRgGXZ1UKo1txSM4
curl -X GET http://localhost:8080/1.0/identifiers/did:bitxhub:appchain001:0xc7F999b83Af6DF9e67d0a37Ee7e900bF38b3D013
curl -X GET http://localhost:8080/1.0/identifiers/did:sol:ygGfLvAyuRymPNv2fJDK1ZMpdy59m8cV5dak6A8uHKa
curl -X GET http://localhost:8080/1.0/identifiers/did:lit:AEZ87t1bi5bRxmVh3ksMUi
curl -X GET http://localhost:8080/1.0/identifiers/did:infra:coov:PUB_K1_8PwG7of5B8p9Mpaw6XzeyYtSWJyeSXVtxZhPHQC5eZxZCkqiLU

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-ethr	2.0.8	1.0 WD	4.0.0	uport/uni-resolver-driver-did-uport
did-web	2.0.8	1.0 WD	3.0.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.2.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.5	1.0 WD	0.1	trustbloc/driver-did-trustbloc
did-sirius	0.0.1	1.0 WD	0.2	proximax-enterprise/tsjs-did-sirius-id-driver
did-trust	0.1	1.0 WD	0.1	bjwswang/driver-did-trust
did-io	0.1.0	1.0 WD	(missing)	iotex/uni-resolver-driver-did-io
did-bba	0.2.2	1.0 WD	1.0	blobaa/bba-did-driver
[did-cy]	0.1.0	1.0 WD
did-bid	1.0.0	1.0 WD	1.0.1	teleinfo/driver-did-bid
did-schema	0.1.1	1.0 WD	0.1	51nodes/schema-registry-did-resolver
did-ion	0.8.1	1.0 WD	0.1	identityfoundation/driver-did-ion
did-ace	1.0	1.0 WD	(missing)	aceblock/ace-did-driver
did-gatc	1.0.0	1.0 WD	1.0 WD	gatacaid/universal-resolver-driver
did-icon-zzeung	0.1.2	1.0 WD	1.0 WD	amuyu/driver-did-icon
did-vaa	1.0.0	1.0 WD	1.0 WD	caict/driver-did-vaa
did-unisot	1.0.0	1.0 WD	1.0.0	unisot/unisot-did-driver
did-bitxhub	1.0.0	1.0.0 WD	(missing)	meshplus/driver-did-bitxhub
did-sol	1.0.0	1.0 WD	1.0.0	identitydotcom/driver-did-sol
did-lit	0.1.0	1.0 WD	0.1.0	ibct/driver-did-lit
did-infra	0.1.0	1.0 WD	1.0.0	infrablockchain/infra-did-resolver

More Information

• Driver Development
• Continuous Integration and Delivery
• Development System
• 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.