Bibliotecas de contratos inteligentes

No es necesario escribir cada contrato inteligente de su proyecto desde cero. Hay muchas bibliotecas de contratos inteligentes de código abierto disponibles que proporcionan bloques de construcción reutilizables para su proyecto, lo que puede evitarle tener que reinventar la rueda.

Requisitos previos

Antes de adentrarse en las bibliotecas de contratos inteligentes, es una buena idea tener una buena comprensión de la estructura de un contrato inteligente. Diríjase a la anatomía de los contratos inteligentes si aún no lo ha hecho.

Qué hay en una biblioteca

Por lo general, puede encontrar dos tipos de bloques de construcción en las bibliotecas de contratos inteligentes: comportamientos reutilizables que puede agregar a sus contratos e implementaciones de varios estándares.

Comportamientos

Al escribir contratos inteligentes, es muy probable que se encuentre escribiendo patrones similares una y otra vez, como asignar una dirección de administrador para llevar a cabo operaciones protegidas en un contrato, o agregar un botón de pausa de emergencia en caso de un problema inesperado.

Las bibliotecas de contratos inteligentes suelen proporcionar implementaciones reutilizables de estos comportamientos como bibliotecas (opens in a new tab) o mediante herencia (opens in a new tab) en Solidity.

Como ejemplo, a continuación se muestra una versión simplificada del contrato Ownable (opens in a new tab) de la biblioteca de contratos de OpenZeppelin (opens in a new tab), que designa una dirección como propietaria de un contrato y proporciona un modificador para restringir el acceso a un método solo a ese propietario.

contract Ownable {
    address public owner;

    constructor() internal {
        owner = msg.sender;
    }

    modifier onlyOwner() {
        require(owner == msg.sender, "Ownable: caller is not the owner");
        _;
    }
}

Para usar un bloque de construcción como este en su contrato, primero tendría que importarlo y luego extenderlo en sus propios contratos. Esto le permitirá usar el modificador proporcionado por el contrato base Ownable para asegurar sus propias funciones.

import ".../Ownable.sol"; // Ruta a la biblioteca importada

contract MyContract is Ownable {
    // La siguiente función solo puede ser llamada por el propietario
    function secured() onlyOwner public {
        msg.sender.transfer(1 ether);
    }
}

Otro ejemplo popular es SafeMath (opens in a new tab) o DsMath (opens in a new tab). Estas son bibliotecas (a diferencia de los contratos base) que proporcionan funciones aritméticas con comprobaciones de desbordamiento, las cuales no son proporcionadas por el lenguaje. ¡Es una buena práctica usar cualquiera de estas bibliotecas en lugar de operaciones aritméticas nativas para proteger su contrato contra desbordamientos, que pueden tener consecuencias desastrosas!

Estándares

Para facilitar la composabilidad e interoperabilidad, la comunidad de Ethereum ha definido varios estándares en forma de ERC. Puede leer más sobre ellos en la sección de estándares.

Al incluir un ERC como parte de sus contratos, es una buena idea buscar implementaciones estándar en lugar de intentar desarrollar la suya propia. Muchas bibliotecas de contratos inteligentes incluyen implementaciones para los ERC más populares. Por ejemplo, el omnipresente estándar de token fungible ERC-20 se puede encontrar en HQ20 (opens in a new tab), DappSys (opens in a new tab) y OpenZeppelin (opens in a new tab). Además, algunos ERC también proporcionan implementaciones canónicas como parte del propio ERC.

Vale la pena mencionar que algunos ERC no son independientes, sino que son adiciones a otros ERC. Por ejemplo, ERC-2612 (opens in a new tab) añade una extensión a ERC-20 para mejorar su usabilidad.

Cómo añadir una biblioteca

Consulte siempre la documentación de la biblioteca que está incluyendo para obtener instrucciones específicas sobre cómo incluirla en su proyecto. Varias bibliotecas de contratos de Solidity se empaquetan usando npm, por lo que simplemente puede hacer npm install con ellas. La mayoría de las herramientas para la compilación de contratos buscarán en su node_modules las bibliotecas de contratos inteligentes, por lo que puede hacer lo siguiente:

// Esto cargará la biblioteca @openzeppelin/contracts de tus node_modules
import "@openzeppelin/contracts/token/ERC721/ERC721.sol";

contract MyNFT is ERC721 {
    constructor() ERC721("MyNFT", "MNFT") public { }
}

Independientemente del método que utilice, al incluir una biblioteca, preste siempre atención a la versión del lenguaje. Por ejemplo, no puede usar una biblioteca para Solidity 0.6 si está escribiendo sus contratos en Solidity 0.5.

Cuándo usarlas

El uso de una biblioteca de contratos inteligentes para su proyecto tiene varios beneficios. En primer lugar, le ahorra tiempo al proporcionarle bloques de construcción listos para usar que puede incluir en su sistema, en lugar de tener que programarlos usted mismo.

La seguridad también es una gran ventaja. Las bibliotecas de contratos inteligentes de código abierto también suelen ser examinadas minuciosamente. Dado que muchos proyectos dependen de ellas, existe un fuerte incentivo por parte de la comunidad para mantenerlas bajo revisión constante. Es mucho más común encontrar errores en el código de la aplicación que en las bibliotecas de contratos reutilizables. Algunas bibliotecas también se someten a auditorías externas (opens in a new tab) para mayor seguridad.

Sin embargo, el uso de bibliotecas de contratos inteligentes conlleva el riesgo de incluir código con el que no está familiarizado en su proyecto. Es tentador importar un contrato e incluirlo directamente en su proyecto, pero sin una buena comprensión de lo que hace ese contrato, puede estar introduciendo inadvertidamente un problema en su sistema debido a un comportamiento inesperado. ¡Asegúrese siempre de leer la documentación del código que está importando y luego revise el código en sí antes de hacerlo parte de su proyecto!

Por último, al decidir si incluir una biblioteca, considere su uso general. Una que sea ampliamente adoptada tiene los beneficios de tener una comunidad más grande y más ojos buscando problemas. ¡La seguridad debe ser su enfoque principal al construir con contratos inteligentes!

Contratos de OpenZeppelin: La biblioteca más popular para el desarrollo seguro de contratos inteligentes.

DappSys: Bloques de construcción seguros, simples y flexibles para contratos inteligentes.

HQ20: Un proyecto de Solidity con contratos, bibliotecas y ejemplos para ayudarle a construir aplicaciones distribuidas con todas las funciones para el mundo real.

GitHub (opens in a new tab)

SDK de Solidity de thirdweb: Proporciona las herramientas necesarias para construir contratos inteligentes personalizados de manera eficiente.

Consideraciones de seguridad para desarrolladores de Ethereum – Un tutorial sobre consideraciones de seguridad al construir contratos inteligentes, incluido el uso de bibliotecas.
Comprender el contrato inteligente del token ERC-20 - Tutorial sobre el estándar ERC-20, proporcionado por múltiples bibliotecas.

Lecturas adicionales

¿Conoce algún recurso de la comunidad que le haya ayudado? ¡Edite esta página y añádalo!