Skip to content

FactomProject/universal-resolver

 
 

Repository files navigation

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.

About

Universal Resolver implementation and drivers.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 94.6%
  • Dockerfile 3.5%
  • Smarty 1.6%
  • Other 0.3%