Directrices de seguridad de contratos inteligentes

Siga estas recomendaciones generales para crear contratos inteligentes más seguros.

Directrices de diseño

El diseño del contrato debe ser verse con antelación, antes de escribir cualquier línea de código.

Documentación y especificaciones

La documentación se puede escribir en diferentes niveles y debe actualizarse al implementar los contratos:

• Una descripción sencilla del sistema que indique lo que hacen los contratos y cualquier suposición en la base de código.
• Esquema y diagramas arquitectónicos, incluyendo las interacciones con el contrato y la máquina de estado del sistema. Las impresoras de Slither(opens in a new tab) pueden ayudar a generar estos esquemas.
• Documentación de código minuciosa; el formato Natspec(opens in a new tab) puede usarse para Solidity.

Cálculo en cadena vs. fuera de cadena

• Mantenga todo el código que se pueda fuera de cadena. Mantenga una capa en cadena pequeña. Preprocese datos con código fuera de la cadena de tal manera que la verificación en cadena sea simple. ¿Necesito una lista ordenada? Ordene la lista fuera de la cadena y luego solo compruebe su orden dentro de la cadena.

Capacidad de mejora

Analizamos diferentes soluciones de mejora en nuestra entrada de blog(opens in a new tab). Tome una decisión deliberada de si admitir la capacidad de mejora o no antes de escribir cualquier código. La decisión influirá en cómo estructurar el código. En general, se recomienda:

• Favorecer la migración de contratos(opens in a new tab) sobre la mejora o actualización. El sistema de migración tiene muchas de las mismas ventajas que el sistema actualizable, sin sus desventajas o inconvenientes.
• Utilizar el patrón de separación de datos por sobre delegatecallproxy. Si el proyecto tiene una clara separación de abstracción, la mejora mediante la separación de datos requerirá solo de unos pocos ajustes. delegatecallproxy requiere conocimientos sobre la EVM y es altamente propenso a errores.
• Documentar el procedimiento de migración/actualización antes de la implementación. Si tiene que reaccionar bajo presión sin ninguna directriz, cometerá errores. Escriba el procedimiento a seguir con antelación. Debe incluir:
  • Las llamadas que inician los nuevos contratos
  • Dónde se almacenan las claves y cómo acceder a ellas
  • Cómo revisar la implementación. Desarrolle y pruebe un script posterior a la implementación.

Guías de implementación

Busque simplicidad ante todo. Use simpre la solución más simple que se adapte a su propósito. Cualquier miembro del equipo debería ser capaz de entender la solución.

Composición de funciones

La arquitectura del código base debería hacer que el código sea fácil de revisar. Evite opciones arquitectónicas que disminuyan la capacidad de razonar acerca de la corrección.

• Divida la lógica de su sistema, ya sea a través de múltiples contratos o agrupando funciones similares (por ejemplo, autenticación, aritmética, ...).
• Escriba pequeñas funciones con un propósito claro. Esto facilitará la revisión y permitirá la prueba de componentes individuales.

Herencia

• Mantenga la herencia manejable. La herencia debe utilizarse para dividir la lógica; sin embargo, el proyecto debe apuntar a minimizar la profundidad y el ancho del árbol de herencia.
• Use la impresora de herencia(opens in a new tab) de Slither para comprobar la jerarquía de los contratos. La impresora de herencia ayudará a revisar el tamaño de la jerarquía.

Eventos

• Registre todas las operaciones cruciales. Los eventos ayudarán a depurar el contrato durante el desarrollo y monitorearlo después de la implementación.

Evite inconvenientes conocidos

• Tenga presente los problemas de seguridad más comunes. Hay muchos recursos en línea para aprender sobre problemas comunes, tales como Ethernaut CTF(opens in a new tab), Capture the Ether(opens in a new tab) o Not so smart contracts(opens in a new tab).
• Tenga en cuenta las secciones de advertencias de la documentación de Solidity(opens in a new tab). Las secciones de advertencias lo informarán sobre el comportamiento no obvio del lenguaje.

Dependencias

• Use bibliotecas bien probadas. Importar código de bibliotecas bien probadas reducirá la probabilidad de escribir código con errores. Si desea escribir un contrato ERC20, use OpenZeppelin(opens in a new tab).
• Use un administrador de dependencias; evite copiar y pegar código. Si confía en una fuente externa, entonces debe mantenerla actualizada con la fuente original.

Pruebas y verificación

• Escriba pruebas unitarias minuciosas. Un amplio conjunto de pruebas es crucial para crear software de alta calidad.
• Escriba verificaciones y propiedades de Slither(opens in a new tab), Echidna(opens in a new tab) y Manticore(opens in a new tab) personalizadas. Las herramientas automatizadas ayudarán a garantizar la seguridad del contrato. Revise el resto de esta guía para aprender a escribir verificaciones y propiedades eficientes.
• Use crytic.io(opens in a new tab). Crytic se integra con Github y proporciona acceso a detectores privados de Slither, además de ejecutar comprobaciones de propiedades personalizadas desde Echidna.

Solidez

• Inclínese por Solidity 0.5 por sobre las versiones 0.4 y 0.6. Solidity 0.5 es más seguro y tiene mejores prácticas incorporadas que la versión 0.4. Solidity 0.6 ha demostrado ser demasiado inestable para la producción y necesita tiempo para madurar.
• Use una versión estable para compilar; use la última versión para comprobar si hay advertencias. Compruebe que el código no tenga problemas reportados con la última versión del compilador. Sin embargo, Solidity tiene un ciclo de liberación rápido y un historial de errores del compilador, así que no se recomienda la última versión para la implementación (ver recomendación de versión de solc(opens in a new tab) de Slither).
• No use ensamblado en línea. El ensamblado requiere conocimientos sobre la EVM. No escriba código de EVM si no domina el Yellow Paper.

Directrices para la implementación

Una vez que el contrato haya sido desarrollado e implementado:

• Monitoree sus contratos. Mire los registros y esté listo para reaccionar en caso de que un contrato o una billetera se vean comprometidos.
• Agregue la información de su contacto a blockchain-security-contacts(opens in a new tab). Esta lista ayuda a terceros a contactarlo si se descubre una falla de seguridad.
• Proteja las billeteras de usuarios privilegiados. Siga las mejores prácticas(opens in a new tab) si almacena llaves en billeteras de hardware.
• Tenga un plan de respuesta a incidentes. Considere que los contratos inteligentes pueden verse vulnerados. Incluso si los contratos están libres de fallas, un atacante puede tomar el control de las claves del propietario del contrato.