Hotwallets

Cosigners

Esta secao descreve os cosigners, que fazem parte da camada de seguranca e assinatura da Hotwallets. Eles participam de operacoes sensiveis ligadas a chaves e transacoes, ajudando a distribuir confianca e reforcar o modelo de custodia da plataforma.

Listar cosigners

Endpoint: GET /admin/cosigners

Serve para

Listar cosigners registrados, status de conexão e se estao em uso por master keys.

Autenticação

Exige token de admin.

Retorno

Array de cosigners enriquecidos.

Campos principais por item:

  • id
  • nodeId
  • sshPublicKey
  • callbackUrl
  • registrationStatus
  • createdAt
  • updatedAt
  • sessionId
  • online
  • connectionStatus
  • connectedAt
  • disconnectedAt
  • inUseByMasterKey

Cadastrar um cosigner

Endpoint: POST /admin/cosigners

Serve para

Cadastrar um cosigner.

Autenticação

Exige token de admin.

Body

{
  "nodeId": "demo-cosigner-01",
  "sshPublicKey": "ssh-ed25519 AAAA...",
  "callbackUrl": "https://worker.example/callback",
  "status": "active"
}

Atualizar um cosigner

Endpoint: PATCH /admin/cosigners/:id

Serve para

Atualizar um cosigner.

Autenticação

Exige token de admin.

Body

Todos os campos são opcionais.

{
  "callbackUrl": "https://worker.example/new-callback",
  "status": "active"
}

Observacoes

  • Se o cosigner estiver em uso por uma master key, a API pode bloquear a alteracao com 409 Conflict.

Excluir um cosigner

Endpoint: DELETE /admin/cosigners/:id

Serve para

Excluir um cosigner.

Autenticação

Exige token de admin.