Generate a new distributed key

POST 
//v1/node/dks

Generate a new distributed key

Request

application/json

Body

required

Request parameters

peerIdentities string[]required

Names or hex encoded public keys of trusted peers to run DKG on.

threshold int32required

Possible values: >= 1

Should be =< len(PeerPublicIdentities)

timeoutMS int32required

Possible values: >= 1

Timeout in milliseconds.

Responses

200

DK shares info

application/json

Schema

Schema

address stringrequired

New generated shared address.

peerIdentities string[]required

Identities of the nodes sharing the key. (Hex)

peerIndex int32required

Possible values: >= 1

publicKey stringrequired

Used public key. (Hex)

publicKeyShares string[]required

Public key shares for all the peers. (Hex)

threshold int32required

Possible values: >= 1

Example (from schema)

{
  "publicKeyShares": [
    "publicKeyShares",
    "publicKeyShares"
  ],
  "address": "address",
  "peerIdentities": [
    "peerIdentities",
    "peerIdentities"
  ],
  "threshold": 1,
  "publicKey": "publicKey",
  "peerIndex": 1
}

401

Unauthorized (Wrong permissions, missing token)

application/json

Schema

Schema

error stringrequired
missingPermission stringrequired

Example (from schema)

{
  "error": "string",
  "missingPermission": "string"
}

Authorization: Authorization

name: Authorizationtype: apiKeydescription: JWT Tokenin: header

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L -X POST '/v1/node/dks' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: <API_KEY_VALUE>' \
--data-raw '{
  "peerIdentities": [
    "peerIdentities",
    "peerIdentities"
  ],
  "timeoutMS": 1,
  "threshold": 1
}'

Request Collapse all

Base URL

Auth

Authorization

Body required

{
  "peerIdentities": [
    "peerIdentities",
    "peerIdentities"
  ],
  "timeoutMS": 1,
  "threshold": 1
}

ResponseClear

Click the Send API Request button above and see the response here!