Wallets

API endpoints to create local and public DIDs

A Decentralized Identifier (DID) comes in different flavours. We are using 2 types of DIDs in the sideos ecosystem:

1. Private DID. For a private DID our implementation follows the did:key Method (https://w3c-ccg.github.io/did-method-key/) is a DID that is locally generated in a wallet and not anchored on a public registry. There is no link to a public blockchain or repository. On mobile phones this method is preferred for privacy and technical reasons.

2. Public DID. For a public DID our implementation follows the did:sideos Method (https://github.com/sideos/sideos-did-method) of a blockchain anchored DID. We are blockchain agnostic and have 2 DLT connectors implemented: Tezos and Ethereum smart contracts mapping sideos DIDs to the respective DID Document on chain or in the IPFS respectively. Public DIDs are for Issuers and Verifiers who want to be resolvable on a public registry for trust-related reasons.

DIDs are created when a wallet is set up and there is no reason to explicitely create a DID by yourself. Still, there may be scenarios where you want to build a local system, e.g. insite an IoT device, where the DID should be pre-build. In that scenario you would call the endpoint for creating a local DID.

If you want to manage sub-wallets in a multi-tenant system of an issuer or verifier, you can create a new public DID by calling the API endpoint to create a public DID. You can chose if the DID should be anchored on a blockchain or not.

Create a Local DID

To create a local DID you call the endpoint with an empty data set. The response gives you the new DID and the respective public key material. The private key is securely stored in the platform database and can be provisioned in a secure channel. We currently do this on demand.

Create a local DID

Create a local DID based on the key material provided

POSThttps://juno.sideos.io/v3/createlocaldid

Authorization

ApiKeyAuth

Response

200400403500

response is a wallet object including the DID and keys.

Body

application/json

errorstring

Example: "false,"

didstring (did)

Example: "did:key:v004:z6MkrL41Eo41aHPhrdEAatCqYc7TiU3PHso5fLyNE7sfbkfQ"

pubkeyobject

responseobject

Request

JavaScriptCurl

const response = await fetch('https://juno.sideos.io/v3/createlocaldid', {
    method: 'POST',
    headers: {},
});
const data = await response.json();

Response

{
  "error": "false,",
  "did": "did:key:v004:z6MkrL41Eo41aHPhrdEAatCqYc7TiU3PHso5fLyNE7sfbkfQ",
  "pubkey": {
    "crv": "Ed25519",
    "d": "text",
    "x": "RvdvCO9qwwB-xeWG4YzbEae4g8iZlIBi5U5hO1CHUPQ",
    "kty": "OKP",
    "use": "sig"
  },
  "response": {
    "acknowledged": true,
    "insertedId": "65db292432889eff535dee66",
    "pubkey": {
      "crv": "Ed25519",
      "d": "text",
      "x": "RvdvCO9qwwB-xeWG4YzbEae4g8iZlIBi5U5hO1CHUPQ",
      "kty": "OKP",
      "use": "sig"
    }
  }
}

Create a Public DID

To create a public DID which can be optionally anchored on the blockchain you call the endpoint with a name for the wallet and a boolean value. If the value for anchored is true, the DID method is did:sideos and the DID document is written to the Tezoz blockchain. We also support Ethereum and privacy-preserved zero-knowledge networks MINA and Aleo on customer demand. In the case of anchoring on Ethereum the DID document is stored on the IPFS. If the value for anchored is false we create a private DID did:private.

The wallet is stored and managed in the platform as a cloud wallet.

Create a public DID

Create a public DID hold in a cloud wallet as a sub-tenant of your sideos account. The DID can be optionally anchored on a Blockchain (Tezoz, Ethereum). You need to be a admin of a multi-tenant account.

POSThttps://juno.sideos.io/v3/createpublicdid

Authorization

ApiKeyAuth

Body

application/json

namestring

the name of the wallet. Must be unique.

Example: "ACME Wallet"

anchoredboolean

Example: true

Response

200400403422500

Wallet created

Body

application/json

didstring

Example: "did:sideos:V002:z6MkjEHR5a1Eii2DYwds5mFZ2Bgpuq4h7EQoawKBm9BFsmSj"

tokenstring

Request

JavaScriptCurl

const response = await fetch('https://juno.sideos.io/v3/createpublicdid', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "did": "did:sideos:V002:z6MkjEHR5a1Eii2DYwds5mFZ2Bgpuq4h7EQoawKBm9BFsmSj",
  "token": "text"
}