Documentation

Guides & Docs

Integration guides and explainers for building with Provable.io. New here? Start with how the cryptography works or jump straight into a quickstart below.

Updated

Dice Roller API

The vertical landing page — NdM notation, verifiable rolls, drop-in integration snippet.

Use-case page

Raffle Picker API

Draw a winner from any list with weighted entries, commit-reveal, and a sharable verification permalink.

Use-case page

Card Shuffler API

One call returns a verifiable Fisher-Yates shuffled deck for poker, blackjack, TCGs, and more.

Use-case page

A/B Test Bucketing API

Deterministic variant assignment with a published serverHash — auditor-ready experimentation.

Use-case page

vs Random.org

How Provable.io's verifiable model compares to Random.org's hardware entropy.

Compare

vs Chainlink VRF

The off-chain alternative when you don't need randomness inside a smart contract.

Compare

vs crypto.randomUUID()

When the language CSPRNG is right, and when you need a publicly verifiable RNG instead.

Compare

How Provably Fair Works

The cryptographic technique behind verifiable randomness, explained without the jargon.

Concept

Quickstart with cURL

Make your first API call from the command line in under a minute.

Quickstart

Quickstart with Node.js

Generate and verify random outcomes from a Node.js server using fetch.

Quickstart

Quickstart with Python

Call the API from Python using the requests library, with verification examples.

Quickstart

Building Fair Raffles

A use-case walkthrough: how to run a transparent prize draw your community can audit.

Use case

Dice Rolls & Coin Flips

The hello-world of game mechanics — verifiable dice and coins in a few lines of code.

Use case

Shuffle a Deck of Cards

A Fisher-Yates shuffle driven by verifiable random integers — the foundation for any card game.

Use case

Weighted Loot Tables

Loot boxes, gacha pulls, prize wheels — drop rates your players can audit.

Use case

Deterministic A/B Buckets

Reproducible variant assignment an auditor — or your future self — can re-derive months later.

Use case

Streaming Outcomes in Real Time

Open a Server-Sent Events connection and consume a continuous drip of verifiable randomness for live games and simulators.

Guide

Webhooks

Receive outcome events on your server and verify the X-Provable-Signature HMAC — with Node.js, Python, and curl examples.

Guide

Generating NFT Traits

Mint-time trait assignment holders can independently verify — no "team got the rares."

Use case