Signing Keys

Import a signing key for a chain

Import an existing private key for a specific chain. Human-only, requires password re-authentication.

post/v1/agents/{agent_id}/signing-keys/{chain}/import

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/signing-keys/{chain}/import
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required
chainstring required

Request body

private_keystring required

The private key to import

format'hex' | 'base64' | 'wif'

Key format (default hex)

Response

Signing key imported

idstring uuid
agent_idstring uuid
chainstring
curvestring
public_keystring
addressstring nullable
key_versioninteger
is_activeboolean
created_atstring date-time
rotated_atstring date-time nullable
custody'server' | 'client_tss'

server — 1claw holds the whole private key and can sign alone. client_tss — 2-of-3 threshold key; its human owner holds shares 2 and 3.

owner_user_idstring uuid

client_tss only: the human who can back up, provision and restore the key.

backupobject

client_tss only (list): the key's backup state, as on treasury wallets.

Changes

No recorded changes to this operation across all 2 revisions of this API.