Cosigners

Cosigners fazem parte da camada de segurança e assinatura da Hotwallets. Eles participam de operações sensíveis ligadas a chaves e transações.

Listar cosigners

Endpoint: GET /admin/cosigners

Serve para

Listar cosigners registrados, status de conexão e se estão 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"
}

Observações

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

Excluir um cosigner

Endpoint: DELETE /admin/cosigners/:id

Serve para

Excluir um cosigner.

Autenticação

Exige token de admin.