Programación segura con SafeMath
Aprenda a utilizar librerías como SafeMath para prevenir ataques de desbordamiento y subdesbordamiento de enteros en operaciones aritméticas.
Programación segura con SafeMath es una lección gratuita de Blockchain Smart Contracts with Solidity en CoddyKit. Esta es la lección 3 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Blockchain Smart Contracts with Solidity, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Blockchain Smart Contracts with Solidity incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
The Integer Problem
In Solidity, integer types like uint256 have a fixed size. This means they can only store numbers up to a certain maximum value and down to a minimum (usually 0 for unsigned integers).
When an arithmetic operation exceeds these limits, it can lead to critical vulnerabilities called integer overflows and underflows.
Unchecked Math Dangers
Solidity's default arithmetic operations (+, -, *, /) do not automatically check for overflows or underflows. Instead, the number 'wraps around'.
This behavior can be exploited by attackers, leading to incorrect token balances, unexpected contract state, and financial losses.
Overflow in Action
Consider a uint8 variable, which can hold values from 0 to 255. What happens if we try to add 1 to 255? Run this code and call incrementUnsafely(). You'll see the value reset to 0!
/*
This contract demonstrates an integer overflow.
A uint8 can only hold values from 0 to 255.
Adding 1 to 255 will cause it to wrap around to 0.
*/
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract UnsafeCounter {
uint8 public count = 255; // Max value for uint8
// Function to increment the counter unsafely
function incrementUnsafely() public {
count = count + 1;
}
}Underflow Example
Similarly, an underflow occurs when a number goes below its minimum value. For a uint (unsigned integer), the minimum is 0.
If you subtract 1 from 0, it wraps around to the maximum value (255 for uint8, or 2^256 - 1 for uint256).
/*
This contract demonstrates an integer underflow.
A uint8 can only hold values from 0 to 255.
Subtracting 1 from 0 will cause it to wrap around to 255.
*/
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract UnderflowDemo {
uint8 public value = 0; // Min value for uint8
// Function to decrement the value unsafely
function decrementUnsafely() public {
value = value - 1;
}
}Introducing SafeMath
To prevent these critical errors, we use libraries like SafeMath. SafeMath provides functions for arithmetic operations (addition, subtraction, multiplication, division) that revert the transaction if an overflow or underflow would occur.
This ensures your contract's state remains consistent and secure, preventing malicious exploits.
Solidity Libraries Explained
A Solidity Library is a special type of contract that contains reusable code. Unlike regular contracts, libraries are stateless (they don't store data directly) and cannot hold Ether.
- They are deployed once and their functions are called via
DELEGATECALL. - This means the library's code runs in the context of the calling contract.
- Libraries are perfect for shared utility functions like SafeMath.
Integrating SafeMath
To use SafeMath, you typically import it from a trusted source like OpenZeppelin. Then, you tell Solidity to apply SafeMath's functions to a specific integer type using the using A for B; directive.
This makes SafeMath's functions available as member functions on type B.
/*
This contract demonstrates how to integrate and use SafeMath.
We're including a simplified mock SafeMath library for demonstration.
*/
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
// A simplified mock SafeMath library for demonstration
library SafeMath {
function add(uint256 a, uint256 b) internal pure returns (uint256) {
uint256 c = a + b;
require(c >= a, "SafeMath: addition overflow");
return c;
}
}
contract MySafeContract {
// Use SafeMath functions for all uint256 variables
using SafeMath for uint256;
uint256 public balance = 100;
function deposit(uint256 amount) public {
// Now you can call .add() directly on balance
balance = balance.add(amount);
}
function getBalance() public view returns (uint256) {
return balance;
}
}Safe Addition in Action
With SafeMath integrated, you use .add() instead of the standard + operator. If the addition would overflow, the transaction will revert, preventing incorrect state changes.
Call safeAdd() with a value like 10. Try calling it with a value that would cause an overflow (e.g., if total was max uint8 and you added 1).
/*
This contract uses SafeMath for secure addition.
If the addition causes an overflow, the transaction will revert.
*/
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
library SafeMath {
function add(uint256 a, uint256 b) internal pure returns (uint256) {
uint256 c = a + b;
require(c >= a, "SafeMath: addition overflow");
return c;
}
}
contract SafeAdder {
using SafeMath for uint256;
uint256 public total = 0;
function safeAdd(uint256 _value) public {
total = total.add(_value); // Uses SafeMath.add
}
}Safe Subtraction in Action
Similarly, use .sub() for subtraction. This prevents underflows, ensuring that a subtraction operation will revert if the result would be negative (below zero for unsigned integers).
Call safeSubtract() with a value like 10. Try calling it with a value larger than balance (e.g., 101) to see it revert.
/*
This contract uses SafeMath for secure subtraction.
If the subtraction causes an underflow, the transaction will revert.
*/
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
library SafeMath {
function sub(uint256 a, uint256 b) internal pure returns (uint256) {
require(b <= a, "SafeMath: subtraction underflow");
uint256 c = a - b;
return c;
}
}
contract SafeSubtractor {
using SafeMath for uint256;
uint256 public balance = 100;
function safeSubtract(uint256 _value) public {
balance = balance.sub(_value); // Uses SafeMath.sub
}
}Multiply, Divide, Modulo
SafeMath also provides .mul(), .div(), and .mod() for multiplication, division, and modulo operations, respectively.
.mul()checks for overflow..div()checks for division by zero and overflow..mod()checks for division by zero.
Always use these safe versions for critical arithmetic in your contracts.
Quick Check on SafeMath
You've learned about the importance of SafeMath. Let's test your understanding.
Recap: Secure Math
You've learned about the critical vulnerabilities of integer overflows and underflows in Solidity and how SafeMath provides a robust solution.
- Always use SafeMath (or similar audited libraries) for arithmetic operations on unsigned integers in your smart contracts.
- This prevents unexpected behavior and protects your contract's integrity.
Keep practicing secure coding! The next lessons will dive deeper into advanced security patterns.
Aprende Blockchain Smart Contracts with Solidity con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 12
- Lecciones
- 48
Preguntas frecuentes
¿La lección «Programación segura con SafeMath» es gratis?
Sí — el texto completo de «Programación segura con SafeMath» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Blockchain Smart Contracts with Solidity, actualiza a CoddyKit PRO. El curso de Blockchain Smart Contracts with Solidity incluye 4 lecciones en total.
¿Qué aprenderé en «Programación segura con SafeMath»?
Aprenda a utilizar librerías como SafeMath para prevenir ataques de desbordamiento y subdesbordamiento de enteros en operaciones aritméticas. Practicas Blockchain Smart Contracts with Solidity con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Blockchain Smart Contracts with Solidity?
No se requiere experiencia previa. Blockchain Smart Contracts with Solidity en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 3 de 4.
¿Cuánto tiempo toma la lección «Programación segura con SafeMath»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Blockchain Smart Contracts with Solidity?
Sí. Cada lección de Blockchain Smart Contracts with Solidity incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Vulnerabilidades comunes (reentrancy, etc.)
- Patrones de control de acceso
- Programación segura con SafeMath
- Auditoría, pruebas y bug bounties