Struct iota_pow::PearlDiver

pub struct PearlDiver { /* fields omitted */ }

The PearlDiver struct allows you to start, stop, and check in on PoW while its working

 use iota_pow::{PearlDiver, PowOptions};
 use iota_crypto::{Curl, Sponge};
 use rand::{thread_rng, Rng};

 const HASH_SIZE: usize = 243;
 const MIN_WEIGHT_MAGNITUDE: usize = 9;

 let mut rng = thread_rng();
 let mut curl = Curl::default();
 let trits: Vec<i8> = (0..8019).map(|_| rng.gen_range(-1, 2)).collect();
 let mut pearl_diver = PearlDiver::default();
 let result_trits = pearl_diver
     .search(trits, PowOptions{min_weight_magnitude: 9, ..PowOptions::default()})
     .unwrap();
 let mut hash_trits = [0; HASH_SIZE];
 curl.reset();
 curl.absorb(&result_trits).unwrap();
 curl.squeeze(&mut hash_trits).unwrap();
 for j in (HASH_SIZE - MIN_WEIGHT_MAGNITUDE..HASH_SIZE - 1).rev() {
     assert_eq!(hash_trits[j], 0);
 }

Methods

impl PearlDiver

pub fn new() -> PearlDiver

Creates a new PearlDiver instance

pub fn cancel(&mut self)

If you have multiple references to the same PearlDriver, this will allow you to cancel the proof of work. For this to be useful, you'll probably need to wrap the PearlDiver in an Arc

 use iota_pow::PearlDiver;
 let mut pearl_diver = PearlDiver::new();
 // ... start running a pearl diver on another thread ...
 pearl_diver.cancel();

pub fn status(&self) -> PearlDiverState

Returns the current status of PoW.

pub fn search(
    &mut self,
    input: impl Trinary,
    options: PowOptions
) -> Result<Vec<Trit>, Error>

Performs proof of work in place

• input - Anything implementing the Trinary trait
• options - PoW options

Trait Implementations

impl Default for PearlDiver

fn default() -> Self

Returns the "default value" for a type.

impl Debug for PearlDiver

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.