Provably Fair Framework
This library aims to provide a flexible but thorough provably fair framework.
Algorithms
randomInteger(algorithm, inputs, min, max)
randomSequence(algorithm, inputs, array)
Strategies (included)
- Crash
- Dice
- American Roulette
- European Roulette
Hash Functions
Accepted Hash Functions are currently sha256 and sha512.
Seeding Event
"A provably fair seeding event makes it possible to generate publicSeed using a trustless randomization service (e.g. the hash of a specific upcoming block in the blockchain of a cryptocurrency), disallowing participants to have a direct influence on in-game randomization"
Proof of Commitment
The default proof of commitment strategy is as follows:
Take an initial Server Seed (it could be a private key of Bitcoin wallet) and recusively sha256 hash it 10,000,000 times.
You can set your own custom Proof of Commitment strategy.
Proof of Existence
The default proof of existence strategy is as follows:
Broadcast via the Blockstream Satellite API a message containing the Terminating Hash, and chosen Block Height of future block. The blockhash of this will be used as a client seed.
You can set your own custom Proof of Existence strategy.
Usage
; // Default config; ; ; // A dice strategysystem.setStrategyDice;;console.logdice; // 1-6 // A european roulette examplesystem.setStrategyEuropeanRoulette;;console.logroulette; // 0-36 // A custom roulette example;// Set custom strategy programaticallysystem.setStrategynew CustomRouletteStrategy; ;console.logroulette; // 0-15 // default seeding eventsystem.seedingEvent; // Set custom seeding event programaticallysystem.setSeedingEventnew CustomSeedingEvent;system.seedingEvent; // default proof of existencesystem.proofOfExistence; // Set custom proof of existence programaticallysystem.setProofOfExistencenew CustomProofOfExistance;system.proofOfExistence; // default proof of commitmentsystem.proofOfCommitment; // Set custom proof of commitment programaticallysystem.setProofOfCommitmentnew CustomProofOfCommitment;system.proofOfCommitment;
Docs
https://matthewlilley.github.io/provably-fair-framework/
Contributing
Want to contribute? Awesome! Feel free to create an issue and/or pull request.
Licence
MIT