Keymaster API

warning

This feature is currently in the experimental stage of development. Do not use it in production environments or presume it is secure. Expect breaking changes.

• General
  • getCheck if the API is ready
  • getList all registries
  • postCreate an asset
• Wallet
  • getLoad wallet
  • putSave wallet
  • postCreate a new wallet
  • postBackup wallet
  • postRecover wallet
  • postCheck wallet
  • postFix wallet
  • getGet decrypted mnemonic
  • postRotate keys
  • postEncrypt a message
  • postDecrypt a message
  • postAdd a signature
  • postVerify a signature
• Identity
  • getGet current ID
  • putSet current ID
  • getList all IDs
  • postCreate a new ID
  • getResolve an ID
  • delRemove an ID
  • postBackup an ID
  • postRecover an DID
• Name
  • getList all names
  • postAdd a new name
  • getResolve a name to DID
  • delRemove a name
• Challenge
  • getCreate an empty challenge
  • postCreate a custom challenge
  • postCreate a response to a challenge
  • postVerify a response
• Group
  • postCreate a new group
  • getGet a group
  • postAdd a member to a group
  • postRemove a member from a group
  • postTest if a member is in a group
• Credential
  • postCreate a credential
  • postBind a credential
  • getList all held credentials
  • postAccept a credential
  • getGet a credential
  • delRemove a credential
  • postPublish a credential
  • postUnpublish a credential
  • getList all issued credentials
  • getGet an issued credential
  • postUpdate an issued credential
  • delRevoke an issued credential
• Poll
  • postCreate a poll
  • getView a poll
  • postVote in a poll
  • putUpdate a poll
  • postPublish a poll
  • delUnpublish a poll
• Schemas
  • postCreate a template
  • postCreate new schema
  • getList schemas
  • getGet a schema
  • putUpdate a schema
  • postTest if id is a valid schema

API docs by Redocly

Keymaster API (1.0.0)

Download OpenAPI specification:Download

API for managing wallets, identities, credentials, and more

General

General API routes

Check if the API is ready

Responses

https://keychain.org/ready

Response samples

• 200

Content type

application/json

"ready"

List all registries

Responses

https://keychain.org/registries

Response samples

• 200

Content type

application/json

[

• "local",
• "hyperswarm",
• "TESS"

]

Create an asset

Request Body schema: application/json

required

asset

object

Responses

https://keychain.org/asset/create

Request samples

• Payload

Content type

application/json

{

• "asset": { }

}

Response samples

• 200

Content type

application/json

{ }

Wallet

Wallet management routes

Load wallet

Responses

https://keychain.org/wallet

Response samples

• 200

Content type

application/json

{

• "seed": {

  • "mnemonic": "string",
  • "hdkey": {

    • "xpriv": "string",
    • "xpub": "string"

    }

  },
• "counter": 2,
• "ids": {

  • "example-id": {

    • "did": "did:test:string",
    • "account": 1,
    • "index": 0

    }

  },
• "names": {

  • "example-name-1": "did:string",
  • "example-name-2": "did:string",
  • "example-name-3": "did:string"

  },
• "current": "example-id"

}

Save wallet

Request Body schema: application/json

required

wallet

object

Responses

https://keychain.org/wallet

Request samples

• Payload

Content type

application/json

{

• "wallet": { }

}

Response samples

• 200

Content type

application/json

{ }

Create a new wallet

Request Body schema: application/json

required

mnemonic	string
overwrite	boolean

Responses

https://keychain.org/wallet/new

Request samples

• Payload

Content type

application/json

{

• "mnemonic": "string",
• "overwrite": true

}

Response samples

• 200

Content type

application/json

{ }

Backup wallet

Responses

https://keychain.org/wallet/backup

Response samples

• 200

Content type

application/json

{ }

Recover wallet

Responses

https://keychain.org/wallet/recover

Response samples

• 200

Content type

application/json

{ }

Check wallet

Responses

https://keychain.org/wallet/check

Response samples

• 200

Content type

application/json

{ }

Fix wallet

Responses

https://keychain.org/wallet/fix

Response samples

• 200

Content type

application/json

{ }

Get decrypted mnemonic

Responses

https://keychain.org/wallet/mnemonic

Response samples

• 200

Content type

application/json

"equip vital solution badge crucial pitch excite fork favorite soldier scene tray"

Rotate keys

Responses

https://keychain.org/keys/rotate

Response samples

• 200

Content type

application/json

{ }

Encrypt a message

Request Body schema: application/json

required

msg	string
did	string

Responses

https://keychain.org/keys/encrypt

Request samples

• Payload

Content type

application/json

{

• "msg": "string",
• "did": "string"

}

Response samples

• 200

Content type

application/json

{ }

Decrypt a message

Request Body schema: application/json

required

did

string

Responses

https://keychain.org/keys/decrypt

Request samples

• Payload

Content type

application/json

{

• "did": "string"

}

Response samples

• 200

Content type

application/json

{ }

Add a signature

Request Body schema: application/json

required

contents

string

Responses

https://keychain.org/keys/sign

Request samples

• Payload

Content type

application/json

{

• "contents": "string"

}

Response samples

• 200

Content type

application/json

{ }

Verify a signature

Request Body schema: application/json

required

json

object

Responses

https://keychain.org/keys/verify

Request samples

• Payload

Content type

application/json

{

• "json": { }

}

Response samples

• 200

Content type

application/json

true

Identity

Identity management routes

Get current ID

Responses

https://keychain.org/ids/current

Response samples

• 200

Content type

application/json

"string"

Set current ID

Request Body schema: application/json

required

name

string

Responses

https://keychain.org/ids/current

Request samples

• Payload

Content type

application/json

{

• "name": "string"

}

Response samples

• 200

Content type

application/json

"string"

List all IDs

Responses

https://keychain.org/ids

Response samples

• 200

Content type

application/json

[

• { }

]

Create a new ID

Request Body schema: application/json

required

name	string
registry	string

Responses

https://keychain.org/ids/new

Request samples

• Payload

Content type

application/json

{

• "name": "string",
• "registry": "string"

}

Response samples

• 200

Content type

application/json

{ }

Resolve an ID

path Parameters

id required

string

Responses

https://keychain.org/ids/{id}

Response samples

• 200

Content type

application/json

{

• "@context": "https://w3id.org/did-resolution/v1",
• "didDocument": {

  • "@context": [

    • "https://www.w3.org/ns/did/v1"

    ],
  • "id": "did:test:string",
  • "verificationMethod": [

    • {

      • "id": "#key-1",
      • "controller": "did:test:string",
      • "type": "string",
      • "publicKeyJwk": {

        • "kty": "EC",
        • "crv": "secp256k1",
        • "x": "string",
        • "y": "string"

        }

      }

    ],
  • "authentication": [

    • "#key-1"

    ]

  },
• "didDocumentMetadata": {

  • "created": "2024-07-26T19:27:03.379Z",
  • "version": 1,
  • "confirmed": true

  },
• "didDocumentData": { },
• "mdip": {

  • "version": 1,
  • "type": "string",
  • "registry": "TESS"

  }

}

Remove an ID

path Parameters

id required

string

Responses

https://keychain.org/ids/{id}

Response samples

• 200

Content type

application/json

{ }

Backup an ID

path Parameters

id required

string

Responses

https://keychain.org/ids/{id}/backup

Response samples

• 200

Content type

application/json

{ }

Recover an DID

path Parameters

did required

string

Request Body schema: application/json

required

did

string

Responses

https://keychain.org/ids/{did}/recover

Request samples

• Payload

Content type

application/json

{

• "did": "string"

}

Response samples

• 200

Content type

application/json

{ }

Name

Name management routes

List all names

Responses

https://keychain.org/names

Response samples

• 200

Content type

application/json

[

• "string"

]

Add a new name

Request Body schema: application/json

required

name	string
did	string

Responses

https://keychain.org/names

Request samples

• Payload

Content type

application/json

{

• "name": "string",
• "did": "string"

}

Response samples

• 200

Content type

application/json

{ }

Resolve a name to DID

path Parameters

name required

string

Responses

https://keychain.org/names/{name}

Response samples

• 200

Content type

application/json

{

• "@context": "https://w3id.org/did-resolution/v1",
• "didDocument": {

  • "@context": [

    • "https://www.w3.org/ns/did/v1"

    ],
  • "id": "did:test:string",
  • "controller": "did:test:string"

  },
• "didDocumentMetadata": {

  • "created": "2024-07-26T19:53:44.468Z",
  • "version": 2,
  • "confirmed": true,
  • "updated": "2024-07-26T19:56:36.636Z"

  },
• "didDocumentData": {

  • "name": "string",
  • "members": [

    • "did:test:string"

    ]

  },
• "mdip": {

  • "version": 1,
  • "type": "string",
  • "registry": "string"

  }

}

Remove a name

path Parameters

name required

string

Responses

https://keychain.org/names/{name}

Response samples

• 200

Content type

application/json

{ }

Challenge

Challenge and response routes

Create an empty challenge

Responses

https://keychain.org/challenge

Response samples

• 200

Content type

application/json

"did:string"

Create a custom challenge

Request Body schema: application/json

required

object

Responses

https://keychain.org/challenge

Request samples

• Payload

Content type

application/json

{ }

Response samples

• 200

Content type

application/json

{ }

Create a response to a challenge

Request Body schema: application/json

required

challenge

object

Responses

https://keychain.org/response

Request samples

• Payload

Content type

application/json

{

• "challenge": { }

}

Response samples

• 200

Content type

application/json

{ }

Verify a response

Request Body schema: application/json

required

response	object
challenge	object

Responses

https://keychain.org/response/verify

Request samples

• Payload

Content type

application/json

{

• "response": { },
• "challenge": { }

}

Response samples

• 200

Content type

application/json

{ }

Group

Group management routes

Create a new group

Request Body schema: application/json

required

name	string
registry	string

Responses

https://keychain.org/groups

Request samples

• Payload

Content type

application/json

{

• "name": "string",
• "registry": "string"

}

Response samples

• 200

Content type

application/json

{ }

Get a group

path Parameters

name required

string

Responses

https://keychain.org/groups/{name}

Response samples

• 200

Content type

application/json

{

• "name": "string",
• "members": [

  • "did:string"

  ]

}

Add a member to a group

path Parameters

name required

string

Request Body schema: application/json

required

member

string

Responses

https://keychain.org/groups/{name}/add

Request samples

• Payload

Content type

application/json

{

• "member": "string"

}

Response samples

• 200

Content type

application/json

{ }

Remove a member from a group

path Parameters

name required

string

Request Body schema: application/json

required

member

string

Responses

https://keychain.org/groups/{name}/remove

Request samples

• Payload

Content type

application/json

{

• "member": "string"

}

Response samples

• 200

Content type

application/json

{ }

Test if a member is in a group

path Parameters

name required

string

Request Body schema: application/json

required

member

string

Responses

https://keychain.org/groups/{name}/test

Request samples

• Payload

Content type

application/json

{

• "member": "string"

}

Response samples

• 200

Content type

application/json

true

Credential

Credential management routes

Create a credential

Request Body schema: application/json

required

schema

object

Responses

https://keychain.org/credentials/new

Request samples

• Payload

Content type

application/json

{

• "schema": { }

}

Response samples

• 200

Content type

application/json

{ }

Bind a credential

Request Body schema: application/json

required

schema	object
subject	object

Responses

https://keychain.org/credentials/bind

Request samples

• Payload

Content type

application/json

{

• "schema": { },
• "subject": { }

}

Response samples

• 200

Content type

application/json

{ }

List all held credentials

Responses

https://keychain.org/credentials/held

Response samples

• 200

Content type

application/json

[

• { }

]

Accept a credential

Request Body schema: application/json

required

did

string

Responses

https://keychain.org/credentials/held

Request samples

• Payload

Content type

application/json

{

• "did": "string"

}

Response samples

• 200

Content type

application/json

{ }

Get a credential

path Parameters

did required

string

Responses

https://keychain.org/credentials/held/{did}

Response samples

• 200

Content type

application/json

{ }

Remove a credential

path Parameters

did required

string

Responses

https://keychain.org/credentials/held/{did}

Response samples

• 200

Content type

application/json

{ }

Publish a credential

path Parameters

did required

string

Request Body schema: application/json

required

reveal

boolean

Responses

https://keychain.org/credentials/held/{did}/publish

Request samples

• Payload

Content type

application/json

{

• "reveal": true

}

Response samples

• 200

Content type

application/json

{ }

Unpublish a credential

path Parameters

did required

string

Responses

https://keychain.org/credentials/held/{did}/unpublish

Response samples

• 200

Content type

application/json

{ }

List all issued credentials

Responses

https://keychain.org/credentials/issued

Response samples

• 200

Content type

application/json

[

• { }

]

Get an issued credential

path Parameters

did required

string

Request Body schema: application/json

required

credential	object
registry	string

Responses

https://keychain.org/credentials/issued/{did}

Request samples

• Payload

Content type

application/json

{

• "credential": { },
• "registry": "string"

}

Response samples

• 200

Content type

application/json

{ }

Update an issued credential

path Parameters

did required

string

Responses

https://keychain.org/credentials/issued/{did}

Response samples

• 200

Content type

application/json

{ }

Revoke an issued credential

path Parameters

did required

string

Responses

https://keychain.org/credentials/issued/{did}

Response samples

• 200

Content type

application/json

{ }

Poll

Polling endpoints

Create a poll

Request Body schema: application/json

required

poll

object

Responses

https://keychain.org/poll/new

Request samples

• Payload

Content type

application/json

{

• "poll": { }

}

Response samples

• 200

Content type

application/json

{ }

View a poll

path Parameters

poll required

string

Responses

https://keychain.org/poll/{poll}/view

Response samples

• 200

Content type

application/json

{ }

Vote in a poll

Request Body schema: application/json

required

poll	string
vote	object
spoil	boolean

Responses

https://keychain.org/poll/vote

Request samples

• Payload

Content type

application/json

{

• "poll": "string",
• "vote": { },
• "spoil": true

}

Response samples

• 200

Content type

application/json

{ }

Update a poll

Request Body schema: application/json

required

ballot

object

Responses

https://keychain.org/poll/update

Request samples

• Payload

Content type

application/json

{

• "ballot": { }

}

Response samples

• 200

Content type

application/json

{ }

Publish a poll

path Parameters

poll required

string

Request Body schema: application/json

required

reveal

boolean

Responses

https://keychain.org/poll/{poll}/publish

Request samples

• Payload

Content type

application/json

{

• "reveal": true

}

Response samples

• 200

Content type

application/json

{ }

Unpublish a poll

path Parameters

poll required

string

Responses

https://keychain.org/poll/{poll}/unpublish

Response samples

• 200

Content type

application/json

{ }

Schemas

Schema endpoints

Create a template

path Parameters

id required

string

Request Body schema: application/json

required

schema

object

Responses

https://keychain.org/schemas/{id}/template/new

Request samples

• Payload

Content type

application/json

{

• "schema": { }

}

Response samples

• 200

Content type

application/json

{ }

Create new schema

Request Body schema: application/json

required

schema

object

Responses

https://keychain.org/schemas/new

Request samples

• Payload

Content type

application/json

{

• "schema": { }

}

Response samples

• 200

Content type

application/json

{ }

List schemas

Responses

https://keychain.org/schemas

Response samples

• 200

Content type

application/json

{ }

Get a schema

path Parameters

id required

string

Responses

https://keychain.org/schemas/{id}

Response samples

• 200

Content type

application/json

{ }

Update a schema

path Parameters

id required

string

Responses

https://keychain.org/schemas/{id}

Response samples

• 200

Content type

application/json

{ }

Test if id is a valid schema

path Parameters

id required

string

Request Body schema: application/json

required

schema

object

Responses

https://keychain.org/schemas/{id}/test

Request samples

• Payload

Content type

application/json

{

• "schema": { }

}

Response samples

• 200

Content type

application/json

{ }