Signing Keys

Provision a signing key for a chain

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

Request

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

Path parameters

agent_idstring uuid required

Request body

chain'ethereum' | 'bitcoin' | 'solana' | 'xrp' | 'cardano' | 'tron' | 'midnight' required

midnight is Preprod-only and requires the midnight-signer sidecar. Note it can be provisioned but not rotated or imported: derivation happens in the sidecar, so there is no local keygen and no raw private key to import. Both of those endpoints refuse it before consuming an approval.

Response

Signing key created

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.