RealisticRNG
Documentation · RealisticRNG Engine

How the RealisticRNG engine works

RealisticRNG is an engine for audit-ready raffles that combines participant lists, cryptographic hash functions and deterministic rules to produce results that anyone can verify afterwards.

In other words: instead of relying on opaque “random pickers” or screenshots, you rely on a clear mathematical process that produces a technical receipt with verifiable hashes and the same rules applied to everyone.

1. The problem with non-auditable raffles

In many traditional raffles — on social networks, communities, companies or even institutions — the outcome depends on someone clicking a “pick a winner” button that nobody really understands. There is no proof of what was processed, which list was used or how names were ordered.

This creates several trust issues:

RealisticRNG was created precisely to address this: turning raffles into an audit-ready, reproducible and verifiable process based on math and cryptography.

2. High-level overview of the RealisticRNG engine

RealisticRNG acts as a raffle engine: it takes a participant list, draw parameters (for example, how many winners) and applies a combination of hash functions and deterministic rules to generate the result.

The core idea is simple:

With that in place, you do not need to rely solely on a human operator or a visual interface. Anyone with the same list and the same rules can recompute the result and see if it matches.

3. From the name list to the final result

While the internal implementation may be optimized over time, the logical design of the engine follows a clear flow. In short:

3.1. Preparing the list

The list of participants is provided by the user (for example, a text file with one name per line). The system:

3.2. Computing the list hash

With the list prepared, the engine computes a list hash. This hash is a code generated from the entire list content using a cryptographic hash function (for example, SHA-256-style functions).

If any name is changed, removed or added afterwards, the hash changes completely. That is why the list hash works as a mathematical snapshot of the participant set at draw time.

3.3. Generating the raffle seed

Next, the engine generates or receives a seed that will be used as the basis for the draw. This seed may combine:

The goal is to ensure that, with the same seed and the same list, the outcome can be reproduced exactly.

3.4. Deterministic draw

From the seed, the engine applies a sequence of mathematical transformations to generate pseudo-random numbers within the range of the participant count. These numbers are used to pick indices in the name list, respecting the configured rules (for example, no repeated winners).

The process is deterministic: given the same list and the same seed, the sequence of numbers will always be the same, producing the same set of winners.

3.5. Raffle hash and technical receipt

At the end, the engine also computes a raffle hash. It takes into account:

This raffle hash is displayed on the technical receipt together with the list hash and other relevant information. Any attempt to change the outcome afterwards will be detectable, as the hash will not match.

4. How to verify a RealisticRNG raffle

Verification is the core of the proposal. In general, an audit workflow may look like this:

If everything is consistent, you know that:

5. Where the engine is used today

The RealisticRNG engine is the core behind different raffle applications with different languages, currencies and payment methods, but the same demand: transparency and auditability.

Other integrations can be built on top of the same engine, either as APIs or custom solutions.

6. Frequently asked questions about the RealisticRNG engine

Is RealisticRNG a cryptographic random number generator?

RealisticRNG acts as a raffle engine based on deterministic rules and hash functions. It is not meant to be a general-purpose cryptographic random number generator, but a transparent way to conduct raffles that can be verified afterwards.

Does RealisticRNG replace human auditors?

It does not replace legal or regulatory requirements, but it reduces subjective trust. A human auditor can use the technical receipt and hashes to verify whether the raffle was conducted according to the rules.

Can I integrate the RealisticRNG engine into other systems?

Yes. The engine can be integrated into other raffle flows, with different interfaces, rules and payment methods. For partnerships or integrations, use the official contact channels of RealisticRNG.

Does this engine solve all legal aspects of raffles?

No. RealisticRNG focuses on the mathematical transparency and auditability of the process. Legal and regulatory requirements depend on each country's jurisdiction and the type of campaign being run.

7. Try the engine in real applications

To see the RealisticRNG engine in action, use one of the official applications already built on top of it: