Skills Agentes

Solidity Security

Domina las mejores prácticas de seguridad en smart contracts para prevenir vulnerabilidades comunes e implementar patrones seguros en Solidity.

Estrellas
39.8k

en todo el repo

Actividad
43

0–100, la ruta de este skill

Actualizado
hace 4 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
891 tok

61 tok en reposo

Paquete
2 archivos

13 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add wshobson/agents --skill solidity-security --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Aplica patrones seguros de Solidity para prevenir reentrancy, overflow y fallos de control de acceso
  • Genera pruebas de seguridad en Hardhat (reentrancy, overflow, access control)
  • Añade documentación NatSpec y patrón CEI (Checks-Effects-Interactions) para preparar auditorías

Úsalo cuando

  • Escribir contratos inteligentes seguros
  • Auditar contratos existentes en busca de vulnerabilidades
  • Implementar protocolos DeFi seguros
  • Preparar contratos para una auditoría profesional

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • “Audita este contrato en busca de vulnerabilidades de reentrancy”
    • “Escribe un contrato Solidity seguro para depósitos y retiros”
    • “Prepara este smart contract para una auditoría profesional”

    SKILL.md

    En inglés

    Solidity Security

    Master smart contract security best practices, vulnerability prevention, and secure Solidity development patterns.

    When to Use This Skill

    • Writing secure smart contracts
    • Auditing existing contracts for vulnerabilities
    • Implementing secure DeFi protocols
    • Preventing reentrancy, overflow, and access control issues
    • Optimizing gas usage while maintaining security
    • Preparing contracts for professional audits
    • Understanding common attack vectors

    Detailed patterns and worked examples

    Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

    Testing for Security

    // Hardhat test example
    const { expect } = require("chai");
    const { ethers } = require("hardhat");
    
    describe("Security Tests", function () {
      it("Should prevent reentrancy attack", async function () {
        const [attacker] = await ethers.getSigners();
    
        const VictimBank = await ethers.getContractFactory("SecureBank");
        const bank = await VictimBank.deploy();
    
        const Attacker = await ethers.getContractFactory("ReentrancyAttacker");
        const attackerContract = await Attacker.deploy(bank.address);
    
        // Deposit funds
        await bank.deposit({ value: ethers.utils.parseEther("10") });
    
        // Attempt reentrancy attack
        await expect(
          attackerContract.attack({ value: ethers.utils.parseEther("1") }),
        ).to.be.revertedWith("ReentrancyGuard: reentrant call");
      });
    
      it("Should prevent integer overflow", async function () {
        const Token = await ethers.getContractFactory("SecureToken");
        const token = await Token.deploy();
    
        // Attempt overflow
        await expect(token.transfer(attacker.address, ethers.constants.MaxUint256))
          .to.be.reverted;
      });
    
      it("Should enforce access control", async function () {
        const [owner, attacker] = await ethers.getSigners();
    
        const Contract = await ethers.getContractFactory("SecureContract");
        const contract = await Contract.deploy();
    
        // Attempt unauthorized withdrawal
        await expect(contract.connect(attacker).withdraw(100)).to.be.revertedWith(
          "Ownable: caller is not the owner",
        );
      });
    });
    

    Audit Preparation

    contract WellDocumentedContract {
        /**
         * @title Well Documented Contract
         * @dev Example of proper documentation for audits
         * @notice This contract handles user deposits and withdrawals
         */
    
        /// @notice Mapping of user balances
        mapping(address => uint256) public balances;
    
        /**
         * @dev Deposits ETH into the contract
         * @notice Anyone can deposit funds
         */
        function deposit() public payable {
            require(msg.value > 0, "Must send ETH");
            balances[msg.sender] += msg.value;
        }
    
        /**
         * @dev Withdraws user's balance
         * @notice Follows CEI pattern to prevent reentrancy
         * @param amount Amount to withdraw in wei
         */
        function withdraw(uint256 amount) public {
            // CHECKS
            require(amount <= balances[msg.sender], "Insufficient balance");
    
            // EFFECTS
            balances[msg.sender] -= amount;
    
            // INTERACTIONS
            (bool success, ) = msg.sender.call{value: amount}("");
            require(success, "Transfer failed");
        }
    }
    

    Reproducido de wshobson/agents bajo licencia MIT. Leer esta página en markdown.

    Archivos

    2 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Detalles

    Creador
    wshobson
    Categoría
    Seguridad
    Licencia
    MIT
    Recursos incluidos
    referencias
    Repositorio
    wshobson/agents
    Código fuente
    Ver SKILL.md

    Etiquetas