Mockear oráculos en entornos de prueba

Introducción a Mockear Oráculos en Entornos de Prueba

En el ecosistema blockchain, los oráculos actúan como puentes entre el mundo real y los contratos inteligentes, proveyendo datos externos críticos (precios de activos, resultados de eventos, indicadores financieros, etc.). Sin embargo, durante la fase de desarrollo y validación, depender de oráculos en vivo puede incrementar costos, latencia y puntos de falla impredecibles. Por ello, surgen las técnicas de mocking o simulación de oráculos en entornos de prueba, garantizando:

Determinismo: Resultados predecibles en cada ejecución.
Aislamiento: Desacople de dependencias externas.
Rapidez: Ejecución veloz sin llamadas de red.
Economía: Cero gastos en gas por respuestas reales.

¿Qué es un Oráculo y por qué Mockearlo

Un oráculo es un servicio —centralizado o descentralizado— que firma y transmite información al blockchain. Proyectos populares como Chainlink ofrecen infraestructuras robustas, pero en pruebas unitarias o de integración:

Incertidumbre temporal: la llegada de datos no es instantánea.
Costos: interacción en testnets de Chainlink genera gastos.
Disponibilidad: los nodos de oráculo pueden estar inactivos.

Al mockear, simulamos el comportamiento —dirección, interfaz, respuesta— y nos aseguramos de que el contrato inteligente reaccione de forma correcta ante distintos escenarios (precios altos/bajos, retrasos, datos inválidos).

Estrategias de Mocking

Estrategia	Descripción	Casos de Uso
Contrato Mock en Solidity	Implementar un contrato que cumpla la misma interfaz del oráculo real y devuelva datos prefijados.	Pruebas unitarias de funciones que leen precios.
Stubs en JavaScript/TypeScript	Usar librerías como `sinon.js` o `jest.fn()` para emular respuestas de llamadas externos durante tests de integración.	Validar lógica off-chain previa a la transacción.
Simulación de Red Local	Herramientas como Hardhat Network o Foundry permiten interceptar y responder peticiones JSON-RPC.	Pruebas E2E sin nodos externos.

Implementación de un Oráculo Mock en Solidity

Supongamos que tu contrato utiliza la interfaz estándar de Chainlink:

interface AggregatorV3Interface {
    function latestRoundData()
        external
        view
        returns (
            uint80 roundId,
            int256 answer,
            uint256 startedAt,
            uint256 updatedAt,
            uint80 answeredInRound
        )
}

El mock:

contract MockV3Aggregator is AggregatorV3Interface {
    int256 private _answer
    constructor(int256 initialAnswer) {
        _answer = initialAnswer
    }
    function latestRoundData()
        external
        view
        override
        returns (
            uint80,
            int256 answer,
            uint256,
            uint256,
            uint80
        )
    {
        return (0, _answer, 0, block.timestamp, 0)
    }
    function updateAnswer(int256 newAnswer) external {
        _answer = newAnswer
    }
}

Con updateAnswer se configuran distintos escenarios (subida, caída, valores límite).

Escribir Tests con Hardhat y TypeScript

Instalación y configuración:

npm install --save-dev hardhat @nomiclabs/hardhat-ethers ethers chai

Deploy del Mock en tests:

const MockV3 = await ethers.getContractFactory(MockV3Aggregator)
const mock = await MockV3.deploy(ethers.utils.parseUnits(2000, wei))

Vincular al contrato principal:

const main = await MainContract.deploy(mock.address)

Simular comportamiento:

await mock.updateAnswer(ethers.utils.parseUnits(3000, wei))
const price = await main.getLatestPrice()
expect(price).to.equal(3000)

Buenas Prácticas y Consideraciones

Reutilización de Mocks: Centraliza contratos mock para múltiples proyectos.
Flexibilidad: Permite respuestas dinámicas (updateAnswer, retrasos intencionados).
Documentación: Describe en los readme cómo levantar el entorno de pruebas.
Validación de Fallbacks: Testea casos extremos (price feeds a cero, retrasos en actualización).
Control de versiones: Asegura que la interfaz del mock coincide con la del oráculo real (e.g., Chainlink).

Integración Continua y Mocking Automático

En pipelines CI/CD (GitHub Actions, GitLab CI, CircleCI) se puede:

Levantar hardhat node local con forking de mainnet para pruebas realistas.
Deploy de mocks al inicio del job y limpieza al final.
Ejecutar tests de cobertura y reportes con solidity-coverage.

Conclusión

El mocking de oráculos es una técnica indispensable para garantizar la calidad y robustez de contratos inteligentes que dependen de datos externos. Permite a los desarrolladores:

Acelerar ciclos de desarrollo.
Reducir costos en testnets y mainnets.
Obtener feedback inmediato sobre comportamientos críticos.

Adoptar frameworks como Hardhat, Truffle o Foundry y seguir las mejores prácticas aquí expuestas te llevará a un desarrollo más seguro y eficiente.