Introduction

Prizerail runs prize draws for apps. Your app picks the winners. Prizerail locks the list, decides each winner’s prize with a random value, and pays the prizes to your wallet in USDC. Every draw publishes a proof that anyone can check.

Onchain randomness is coming. Prizes will be decided by Pyth Entropy through the Prizerail contract on Base, so nobody, Prizerail included, can pick or predict the random value. The proof will show that the list was locked before it existed. See Verify a draw.

How a draw works

1. Prizerail gets the winners. Before each draw’s cutoff, Prizerail fetches the list from a URL you publish, or your backend posts it to the API.
2. The list locks. At the cutoff, Prizerail records a fingerprint of the list. It can’t change after that.
3. A random value is drawn. Only after the lock.
4. Each winner rolls. The random value, each winner’s position and their id decide their roll, and the roll picks a prize from your campaign’s prize table.
5. Prizes are paid. Small prizes go to your wallet as one USDC transfer per draw. Large prizes are paid by hand.
6. The proof is published, with every input and result.

Where to start

• New here? Read the Quickstart.
• Want the vocabulary first? See Concepts.
• Checking a draw? Go to Verify a draw.

Questions, or ready to set up a campaign? Get in touch.