BIP340 - Derive a public key from a key share - With option to use Tweak

POST 
/bip340/derive-tweak-pubkey

authorization

This API endpoint requires an API Key with at least one of the following Roles: CryptoUser | KeysManager

Returns the derived tweak public key for a key_id for a given BIP-32 non-hardened derivation path. The tweak addition argument allows for modifying the public key in a deterministic way. For more details on tweak addition, see Tweaking Keys.

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_pathstringrequired
tweakstring | nullnullable

Responses

200

application/json

Schema

Schema

pubkeystringrequired
xpubstring | nullnullable

Optional xpub in base58 format. if a tweak was provided in the request, this field will be None. if no tweak was provided, this field will contain the xpub of the derived key.

Example (from schema)

{
  "pubkey": "string"
}

400

application/json

Schema

Schema

err_msgstringrequired
err_typestringrequired

Possible values: [already_performed_keygen, api_key_not_found, bad_n_and_t_params, bad_request_params, batch_too_large, cant_delete_boot_admin, cluster_already_exists, cluster_not_found, executor_result, invalid_domain, key_not_found, key_operation_before_keygen, policy_already_exists, policy_in_use_by_keys, policy_in_use_by_users, policy_not_found, policy_validation_failed, room_creation_problem, rule_already_exists, rule_in_use, rule_not_found, rule_not_in_policy, server_share_backup_setting_disabled, server_share_backup_setting_incompatible, user_already_exists, user_has_associated_keys, user_not_found, vertex_already_exists, vertex_not_found]

Example (from schema)

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

401

application/json

Schema

Schema

err_msgstringrequired
err_typestringrequired

Possible values: [access_denied, bad_key_permission]

Example (from schema)

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

404

application/json

Schema

Schema

err_msgstringrequired
err_typestringrequired

Possible values: [not_found]

Example (from schema)

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

500

application/json

Schema

Schema

err_msgstringrequired
err_typestringrequired

Possible values: [internal_problem]

Example (from schema)

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