Ecdsa - Sign a message using a key share

POST 
/ecdsa/sign

Signs a message using the given key_id. The message is signed using the secret share generated in the /ecdsa/keygen operation. The signature is then returned to the caller. The message must be hashed when signing using the relevant hash (i.e. sha256 for Bitcoin or keccak256 for EVM).

Request

Header Parameters

AUTHORIZATION stringrequired

The AUTHORIZATION header must be set to the API Key of the user. The API Key is returned when a new user is created using the /admin/create-user endpoint.

application/json

Body

required

derivation_path uint32[]
extra_data string

Hex encoded extra data to be passed to the Rule Server. This data should be used to pass any additional information / external state to the Rule Server that is required to properly validate the signing request.

hash_algo HashOptionsrequired

Possible values: [sha256, keccak256, sha256d, none]

When the none hash algorithm is selected, no hashing is performed, and the message is used as-is. Therefore, the message must be 32 bytes long formatted as a hex string. The hash_algo field is case-insensitive.

key_id KeyIdrequired
msg stringrequired

The message to be signed must be hex-encoded.

room_uuid stringrequired

Responses

200

application/json

Schema

Schema

der stringrequired
r stringrequired
s stringrequired
v uint8required

Example (from schema)

{
  "der": "string",
  "r": "string",
  "s": "string",
  "v": 0
}

400

application/json

Schema

Schema

err_msg stringrequired
err_type stringrequired

Possible values: [already_performed_keygen, bad_n_and_t_params, bad_request_params, batch_too_large, executor_result, key_id_not_exists, key_operation_before_keygen, policy_in_use_by_keys, policy_in_use_by_users, policy_not_found, policy_validation_failed, room_creation_problem, rule_in_use, rule_not_found, rule_not_in_policy, unique_violation, user_id_not_exists, you_have_to_be_admin]

Example (from schema)

{
  "err_msg": "string",
  "err_type": "already_performed_keygen"
}

401

application/json

Schema

Schema

err_msg stringrequired
err_type stringrequired

Possible values: [access_denied]

Example (from schema)

{
  "err_msg": "string",
  "err_type": "access_denied"
}

404

application/json

Schema

Schema

err_msg stringrequired
err_type stringrequired

Possible values: [not_found]

Example (from schema)

{
  "err_msg": "string",
  "err_type": "not_found"
}

500

application/json

Schema

Schema

err_msg stringrequired
err_type stringrequired

Possible values: [internal_problem]

Example (from schema)

{
  "err_msg": "string",
  "err_type": "internal_problem"
}

Loading...