VDNX
ENHablemos

Web3·5 min de lectura

Define los permisos antes de desarrollar un contrato inteligente

Los permisos de un contrato no deberían descubrirse durante la implementación. Una matriz previa permite discutir quién puede actuar, bajo qué condiciones y cómo responder a una pérdida de acceso.

Empieza por las acciones sensibles, no por los nombres de los roles

Definir permisos en un producto Web3 no consiste en decidir que habrá un administrador y empezar a programar. Primero hay que enumerar las acciones que pueden cambiar el estado o las reglas del sistema: crear o retirar elementos, actualizar parámetros, pausar una función, gestionar listas, mover fondos operativos o autorizar una nueva versión. Cada acción necesita una razón de negocio y un límite comprensible.

Ethereum explica que las funciones públicas o externas pueden recibir llamadas de cuentas ajenas al proyecto. El control de acceso debe impedir que una acción sensible quede disponible para cualquier participante. Antes de elegir una biblioteca, prepara una tabla con una fila por acción. Este trabajo revela decisiones que una interfaz bonita puede ocultar y permite discutirlas cuando todavía es posible cambiar el alcance.

Construye una matriz con seis preguntas por acción

Para cada acción, registra quién puede iniciarla, quién puede aprobarla, qué condiciones la limitan, cuánto tarda en ejecutarse, qué evento deja como evidencia y qué ocurre si la cuenta responsable no está disponible. No todas las columnas necesitan mecanismos complejos. Una operación de bajo impacto puede ser inmediata, mientras un cambio que afecta a todo el sistema puede requerir separación entre propuesta y ejecución.

La matriz debe utilizar responsabilidades del producto, no direcciones de cartera definitivas. Por ejemplo, responsable de operaciones resulta más estable que una dirección concreta durante la fase de diseño. Las cuentas, contratos multifirma o módulos de gobernanza se asignan después. Así se puede validar la lógica con personas no técnicas y mantener una relación clara entre cada necesidad y su implementación.

  • Acción y efecto observable.
  • Iniciador y aprobador.
  • Límites, condiciones o demora.
  • Evidencia emitida por el contrato.
  • Procedimiento ante pérdida o compromiso.
  • Responsable de revisar el permiso.

Elige entre propietario único y roles separados con un criterio explícito

OpenZeppelin documenta Ownable como un modelo simple en el que una cuenta realiza las tareas administrativas. Puede encajar cuando realmente existe una sola responsabilidad y el alcance es reducido. A medida que distintas personas o sistemas necesitan capacidades diferentes, el control basado en roles permite separar, por ejemplo, la pausa de emergencia de la modificación de parámetros o de la gestión de miembros.

Separar roles no aporta seguridad por sí solo si todos terminan asignados a la misma cuenta o si un administrador puede recuperarlos sin control. Aplica el principio de mínimo privilegio: cada cuenta recibe solo las acciones necesarias. Documenta también quién concede y revoca cada rol. En AccessControl, cada rol tiene otro rol administrador; esa relación forma parte del producto y no debería quedar como un detalle invisible del código.

Diseña la transferencia y la pérdida de acceso antes del despliegue

Una transferencia mal dirigida puede dejar el control en una cuenta incorrecta o incapaz de interactuar con el contrato. OpenZeppelin ofrece Ownable2Step para que el nuevo propietario tenga que aceptar la transferencia. La idea de doble confirmación ilustra una pregunta más amplia: ¿cómo se comprueba el destino antes de entregar una capacidad crítica y quién puede detener el proceso si se detecta un error?

La recuperación no debe significar añadir una llave maestra indefinida sin explicarla. Define escenarios: dispositivo perdido, miembro que abandona el equipo, firmante no disponible o cuenta comprometida. Después decide si la respuesta será sustituir un miembro de una multifirma, revocar un rol, usar una demora o ejecutar un procedimiento de emergencia previamente limitado. Si no existe recuperación, esa irreversibilidad debe ser una decisión consciente y visible.

Añade demoras solo cuando exista una respuesta durante la espera

Una demora puede separar la aprobación de una acción y su ejecución. OpenZeppelin describe TimelockController como un mecanismo que somete determinadas operaciones de mantenimiento a un plazo antes de ejecutarlas. Ese tiempo puede permitir revisar la operación o reaccionar, pero no sirve si nadie monitoriza las propuestas o si el producto no define qué puede hacer una persona afectada durante la espera.

Decide qué acciones necesitan demora, quién propone, quién ejecuta y quién puede cancelar. Evita usar el mismo plazo por comodidad para todo el sistema: cambiar un texto auxiliar y actualizar una autoridad principal no tienen el mismo impacto. La matriz debe explicar el propósito de cada espera y las consecuencias si los proponentes o ejecutores dejan de estar disponibles, porque una configuración demasiado rígida también puede bloquear operaciones legítimas.

Haz visibles los permisos en la interfaz y en la operación

El contrato puede aplicar correctamente una regla y aun así producir una experiencia confusa. Antes de solicitar una firma o transacción administrativa, la interfaz debería explicar la acción, el contrato afectado, el rol que la autoriza y si existe una demora. No presentes una firma como si fuera solo iniciar sesión cuando en realidad concede una capacidad o confirma una operación con efectos persistentes.

Ethereum recomienda emitir eventos para acciones relevantes y monitorizarlos fuera de la cadena. Define qué eventos necesita el equipo para seguir concesiones, revocaciones, pausas y cambios de autoridad. La supervisión no sustituye el control del contrato, pero ayuda a detectar un uso inesperado y reconstruir qué ocurrió. Asigna también quién recibe una alerta y qué decisión puede tomar; recopilar señales sin una respuesta prevista aporta poca continuidad.

Valida la matriz con escenarios antes de convertirla en código

Prueba la tabla con un ejemplo hipotético identificado. Imagina una membresía digital: operaciones puede emitir una membresía aprobada, soporte puede suspender temporalmente su uso, pero ninguna de esas funciones permite cambiar la autoridad principal. Un cambio estructural necesita otra aprobación y una demora. Después simula que una cuenta se pierde, un miembro deja el proyecto y se propone una dirección equivocada.

La revisión debe comprobar tanto acciones permitidas como rechazos. Ethereum destaca que las pruebas unitarias aisladas no cubren todos los riesgos; el diseño necesita casos límite y propiedades que deban mantenerse. El resultado de esta fase no es una promesa de seguridad absoluta ni una auditoría. Es una especificación más precisa para presupuestar, implementar, probar y revisar un servicio Web3 sin dejar las decisiones de control para el final.

  • ¿Cada acción sensible tiene un responsable y un límite?
  • ¿Quien concede un rol está identificado y controlado?
  • ¿La pérdida de una cuenta tiene una respuesta definida?
  • ¿Las demoras permiten una acción útil durante la espera?
  • ¿La interfaz explica qué se autoriza antes de solicitarlo?

Fuentes y documentación

Contenido elaborado con ayuda de IA. Consulta las fuentes, la fecha y el alcance de cada guía.

¿Qué necesita resolver tu proyecto Web3?

Cuéntanos su objetivo, sus usuarios y qué falta por definir. Podemos ayudarte a valorar el alcance técnico.

Hablemos de tu idea