Controllers

Un controlador es una cuenta autorizada a modificar el DID Document. Cualquier transacción de escritura sobre un DID se valida contra la lista de controladores activos.

addController

POST /api/v1/contract/addController

Añade un nuevo controlador al DID.

Cuerpo

{
  "did": "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV",
  "controller": "0x<NUEVA_EOA>",
  "from": "0x<EOA_CONTROLADOR_ACTUAL>"
}

Campo	Tipo	Required	Descripción
did	string	sí	DID al que se le añade el controlador.
controller	string	sí	DID o EOA que se va a autorizar como controlador adicional.
from	string	sí	EOA de un controlador actual que firmará la transacción.

Respuesta

200 OK con la transacción sin firmar.

Casos de uso

• Delegar la administración del DID a otra área de la organización.
• Repartir la responsabilidad entre múltiples EOAs (modelo de redundancia).
• Migrar el control hacia un HSM o un servicio de custodia.

---

revokeController

POST /api/v1/contract/revokeController

Revoca un controlador existente.

Cuerpo

{
  "did": "did:isbe:uc:z12kVar5p6bD5WCjEJcQ18Zyt8XV",
  "controller": "0x<EOA_A_REVOCAR>",
  "from": "0x<EOA_CONTROLADOR_ACTUAL>"
}

Campo	Tipo	Required	Descripción
did	string	sí	DID afectado.
controller	string	sí	Controlador a eliminar.
from	string	sí	EOA de otro controlador con permisos para firmar.

Respuesta

200 OK con la transacción sin firmar.

No te quedes sin controlador

La revocación del último controlador deja el DID bloqueado de forma irreversible: no se podrá modificar ni rotar nunca más. Antes de revocar, verifica que existe al menos otro controlador activo.