CryptoByLeo/Src/URandom/README.md

URandom

Este folder contiene las "fuentes" de números aleatorios que usa el resto de la librería: BigUInteger (generación de primos, FillRandom), RSA (generación de claves, IV de OAEP/PSS) y Fernet (generación de claves).

Cada fuente vive en su propio .mqh y envuelve un backend distinto:

• BCrypt.mqh (CURandom) — usa bcrypt.dll de Windows (BCryptGenRandom). Criptográficamente seguro, pero requiere DLLs habilitadas en el terminal.
• PRNG.mqh (CURandomPRNG<TBackend>) — usa PNRGByLeo puro MQL5, sin DLLs, mezclando el generador con fuentes de entropía del terminal (ping, memoria, ticks). No es criptográficamente seguro ni comparable a un /dev/urandom o BCryptGenRadom (win) real, pero es la única opción para quien no puede o no quiere usar DLLs en su EA.

Se mantienen ambas porque cada una responde a un trade-off distinto entre seguridad y dependencias: DLLs dan mejor entropía pero atan el proyecto al ecosistema de Windows/DLLs habilitadas (un problema si vas a vender en Market o publicar en CodeBase); PRNG puro evita esa dependencia a costa de seguridad criptográfica real. La librería no elige por ti — expone ambas bajo el mismo contrato y tú decides cuál usar según tu caso.

Contrato

Cualquier clase de esta carpeta (y cualquiera nueva que agregues) debe implementar estas 3 funciones estáticas con estas firmas exactas:

static void RandomCryptoBytes(uchar& out[], int oult, int o_s = 0);
static void RandomUlongArr(ulong& out[], int oult, int o_s = 0);
static void RandomUlongArrRange(ulong& out[], int oult, ulong last, int o_s = 0);

No hay una interfaz base ni un puntero de función: el resto de la librería consume estas clases vía template (template <typename TRandomFunc>), nunca por instancia o interfaz en tiempo de ejecución. Es una decisión de diseño deliberada — todo el binding se resuelve en tiempo de compilación, sin el costo ni la indirección de una resolución virtual. Por eso el contrato no se puede forzar con una interfaz; solo con la firma.

Verificar que tu clase cumple el contrato

Al ser duck typing por template, si te falta un método o la firma no coincide, el error de compilación puede aparecer varias capas adentro (p. ej. dentro de BigUInteger::FillRandom), lejos de tu clase nueva. Para evitarlo, incluye ContractVer.mqh y llama a _URandomContractCheck<TuClase>() una vez desde tu código de test/integración (no en producción) al terminar de escribir tu clase:

#include "ContractVer.mqh"
#include "PRNG.mqh"

void OnInit()
 {
  TSN::_URandomContractCheck<TSN::CURandomPRNG<CMiBackend>>();
 }

Si algo no cumple el contrato, el error sale ahí, con el nombre real de tu clase — no enterrado dentro de BigInteger o RSA.

Uso

No se llaman directamente en la mayoría de los casos: se pasan como parámetro de template a las funciones de la librería que requieren aleatoriedad, y son ellas quienes las invocan internamente. Por ejemplo, al cifrar con la clave pública RSA (que internamente necesita bytes aleatorios para el IV de OAEP):

#include "..\\RSA\\Keys\\Public.mqh"
#include "BCrypt.mqh"

TSN::CRsaPublicKey pub;
uchar mensaje[], out[];
// ...
pub.Cifrar<TSN::CURandom>(mensaje, out);

O usando el backend sin DLL, con un backend concreto de PNRGByLeo:

#include "PRNG.mqh"

pub.Cifrar<TSN::CURandomPRNG<CXoshiro256> >(mensaje, out);