Godiddy Docs

Appearance

Universal Registrar ​

The Universal Registrar enables the creation/update/deactivation of many different types ("methods") of Decentralized Identifiers (DIDs), using a common interface. This interface is defined by the DID Registration specification.

It can operate in two modes:

IMPORTANT

In some cases, DID operations require multiple steps before a DID operation can be completed. In such cases, the Universal Registrar returns a jobId field, which represents the state of a longer-running job that can be continued with subsequent API calls.

API Reference ​

See https://api.godiddy.com/#tag/Universal-Registrar.

Create a DID ​

When creating DIDs, the input is a DID create request object, and the output is a DID create status object.

Using did:indy ​

Supported options:

  • network: The network on which to create the DID (possible values: sovrin, sovrin:builder, sovrin:staging, danube, idunion, idunion:test, indicio, indicio:test, indicio:demo)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=indy" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ]
       },
       "options": {
         "network": "danube"
       },
       "secret": { }
     }'

Using did:ion ​

Supported options:

  • network: The network on which to create the DID (possible values: mainnet, testnet)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=ion" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ],
         "verificationMethod": [ ]
       },
       "options": {
         "network": "testnet"
       },
       "secret": { }
     }'

Using did:cheqd ​

Supported options:

  • network: The network on which to create the DID (possible values: mainnet, testnet)
  • idGenerator: The mechanism for generating the method-specific identifier (possible values: uuid, indy)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=cheqd" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ]
       },
       "options": {
         "network": "testnet"
       },
       "secret": { }
     }'

Using did:ebsi ​

Supported secrets:

  • VerifiableAuthorisationToOnboard: A VerifiableAuthorisationToOnboard credential from an EBSI onboarding service
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=ebsi" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ],
         "verificationMethod": [ ]
       },
       "options": {
       },
       "secret": {
         "VerifiableAuthorisationToOnboard": "eyJhbGc..."
       }
     }'

Using did:web ​

Supported options:

  • host: The host on which to create the DID (default value: did-web.godiddy.com)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=web" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "id": "did:web:did-web.godiddy.com:test:mydid2",
         "verificationMethod": [{
           "id": "did:web:did-web.godiddy.com:test:mydid2#key1",
           "type": "Ed25519VerificationKey2018",
           "controller": "did:web:did-web.godiddy.com:test:mydid2",
           "publicKeyBase58": "39Kg3QRbz1ttsniqEP7BT812sJVJz8y1eNtka1y7hKS7"
         }]
       },
       "options": { },
       "secret":  { }
     }'

Using did:key ​

Supported options:

  • keyType: The type of key to create (possible values: Ed25519, secp256k1, P-256)
  • jwkJcsPub: Whether to use the jwk_jcs-pub multicodec format, as required e.g. by EBSI DIDs for natural persons (possible values: true, false)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=key" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ]
       },
       "options": {
         "keyType": "Ed25519",
         "jwkJcsPub": false
       },
       "secret": { }
     }'

Using did:ethr ​

Supported options:

  • network: The Ethereum network on which to create the DID (possible values: mainnet, goerli, sepolia)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=ethr" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "verificationMethod": [{
           "id": "#controllerKey",
           "type": "EcdsaSecp256k1VerificationKey2019",
           "publicKeyHex": "1fd922544dc866ea9f191a0b86c41de1344f02c008a0ece86573a404e8c2a158"
         }]
       },
       "options": {
         "network": "goerli"
       },
       "secret":  { }
     }'

Using did:pkh ​

Supported options:

  • namespace: The namespace according to CAIP-2 (possible values: eip155)
  • chainId or network: The reference part of the chain ID according to CAIP-2 (example values: 1, 5, also see https://chainid.network/)
bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=pkh" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "verificationMethod": [{
           "id": "#blockchainAccountIdKey",
           "type": "EcdsaSecp256k1VerificationKey2019",
           "publicKeyHex": "1fd922544dc866ea9f191a0b86c41de1344f02c008a0ece86573a404e8c2a158"
         }]
       },
       "options": {
         "namespace": "eip155",
         "chainId": "5"
       },
       "secret":  { }
     }'

Using did:v1 ​

bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=v1" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ]
       },
       "options": { },
       "secret": { }
     }'

Using did:ling ​

bash
curl -H "Authorization: Bearer b082c420-df67-4b06-899c-b7c51d75fba0" \
     -X POST "https://api.godiddy.com/1.0.0/universal-registrar/create?method=ling" \
     -H "Content-Type: application/json" \
     -d '{
       "didDocument": {
         "@context": ["https//www.w3.org/ns/did/v1"],
         "service": [ ]
       },
       "options": { },
       "secret": { }
     }'