Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

DIF Logo

Universal Registrar

The Universal Registrar creates/updates/deactivates Decentralized Identifiers (DIDs) across many different DID methods, based on the W3C DID Core 1.0 and DID Registration specifications.

See for a publicly hosted instance of a Universal Registrar. See Docker Hub for images.

Quick Start

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

git clone
cd universal-registrar/
docker-compose -f docker-compose.yml pull
docker-compose -f docker-compose.yml up

You should then be able to create/update/deactivate identifiers locally using simple curl requests as follows:

curl -X POST 'http://localhost:9080/1.0/create?method=v1' -d '{"options":{"ledger":"test","keytype": "ed25519"}}'
curl -X POST 'http://localhost:9080/1.0/create?method=sov' -d '{"options":{"network":"danube"}}'
curl -X POST 'http://localhost:9080/1.0/create?method=btcr' -d '{"options":{"chain":"TESTNET"}}'
curl -X POST 'http://localhost:9080/1.0/create?method=key' -d '{"options":{"keyType": "Ed25519VerificationKey2018"}}'
curl -X POST 'http://localhost:9080/1.0/create?method=ion' -d '{}'
curl -X POST 'http://localhost:9080/1.0/create?method=web' -d '{}'
curl -X POST 'http://localhost:9080/1.0/create?method=ebsi' -d '{"secret":{"token":"ey......"}}'

If this doesn't work, see Troubleshooting.


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

Driver Name Driver Version DID Method Spec Version Docker Image or URL
did-btcr 0.1-SNAPSHOT 0.1 universalregistrar/driver-did-btcr
did-sov 0.1-SNAPSHOT 0.1 universalregistrar/driver-did-sov
did-v1 0.1-SNAPSHOT 0.1 universalregistrar/driver-did-v1
did-key 1.0.0 0.7 universalregistrar/driver-did-key
did-ion 1.0.0 0.0 universalregistrar/driver-did-ion
did-web 1.0.0 0.0 universalregistrar/driver-did-web
did-ebsi 1.0.0 (missing) universalregistrar/driver-did-ebsi

More Information


Decentralized Identity Foundation -

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