#pallet #randomness #frame #flip #random #collective #block

no-std pallet-randomness-collective-flip

FRAME randomness collective flip pallet

27 releases (13 major breaking)

15.0.0 Feb 5, 2023
14.0.0 Feb 1, 2023
13.0.0 Jan 22, 2023
12.0.0 Jan 16, 2023
2.0.0-alpha.5 Mar 24, 2020

#12 in #collective

Download history 1057/week @ 2024-07-19 917/week @ 2024-07-26 766/week @ 2024-08-02 1335/week @ 2024-08-09 1033/week @ 2024-08-16 981/week @ 2024-08-23 930/week @ 2024-08-30 877/week @ 2024-09-06 828/week @ 2024-09-13 1125/week @ 2024-09-20 995/week @ 2024-09-27 319/week @ 2024-10-04 464/week @ 2024-10-11 648/week @ 2024-10-18 807/week @ 2024-10-25 718/week @ 2024-11-01

2,641 downloads per month
Used in 8 crates (6 directly)

Apache-2.0

14KB
183 lines

Randomness Module

The Randomness Collective Flip module provides a random function that generates low-influence random values based on the block hashes from the previous 81 blocks. Low-influence randomness can be useful when defending against relatively weak adversaries. Using this pallet as a randomness source is advisable primarily in low-security situations like testing.

Public Functions

See the Module struct for details of publicly available functions.

Usage

Prerequisites

Import the Randomness Collective Flip module and derive your module's configuration trait from the system trait.

Example - Get random seed for the current block

use frame_support::traits::Randomness;

#[frame_support::pallet]
pub mod pallet {
    use super::*;
    use frame_support::pallet_prelude::*;
    use frame_system::pallet_prelude::*;

    #[pallet::pallet]
    pub struct Pallet<T>(_);

    #[pallet::config]
    pub trait Config: frame_system::Config + pallet_randomness_collective_flip::Config {}

    #[pallet::call]
    impl<T: Config> Pallet<T> {
        #[pallet::weight(0)]
        pub fn random_module_example(origin: OriginFor<T>) -> DispatchResult {
            let _random_value = <pallet_randomness_collective_flip::Pallet<T>>::random(&b"my context"[..]);
            Ok(())
        }
    }
}

License: Apache-2.0

Dependencies

~12–28MB
~442K SLoC