Struct pbd::dtc::Tracker

pub struct Tracker { /* fields omitted */ }

Represents a Tacker (a.k.a. MarkerChain)

Methods

impl Tracker

pub fn new(dat_id: String) -> Tracker

Constructs a Tracker (a.k.a. MarkerChain)

Arguments

• dat_id: String - The unique identifier of the the data being tracked.
  

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let tracker = Tracker::new("order~clothing~iStore~15150".to_string());
     
    // The genesis Marker is automaically created for you
    assert_eq!(tracker.len(), 1);
}

pub fn add(&mut self, tmstp: u64, act_id: String, dat_id: String)

Appends a new Marker to the end of the Marker Chain. The index of the Marker and hash from the previous Marker are automatically defined when added.

Arguments

• tmstp: String - The date and time (Unix timestamp) the data came into posession of the Actor.
  
• act_id: String - The Unix Epoch time when the DUA was agreed to.
  
• dat_id: String - The unique identifier of the the data being tracked.
  

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let mut tracker = Tracker::new("order~clothing~iStore~15150".to_string());
    tracker.add(1578071239, "notifier~billing~receipt~email".to_string(), "order~clothing~iStore~15150".to_string());
     
    println!("There are {} items in the Marker Chain.", tracker.len());
}

pub fn get(&self, index: usize) -> Option<Marker>

Returns the Marker from the Marker Chain at the specified index.

Arguments

• index: usize - The index of the Marker.
  

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let mut tracker = Tracker::new("order~clothing~iStore~15150".to_string());
    let marker = tracker.get(0).unwrap();
     
    println!("{}", marker.identifier.data_id);
}

pub fn is_valid(&self) -> bool

Determines if the Tracker has a valid Marker Chain, (a.k.a. not been tampered with).

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let mut mkrchn = Tracker::new("order~clothing~iStore~15150".to_string());
    mkrchn.add(1578071239, "notifier~billing~receipt~email".to_string(), "order~clothing~iStore~15150".to_string());

    assert!(Tracker::is_valid(&mkrchn));
}

pub fn len(&self) -> usize

Returns the length of the Tracker's Marker Chain.

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let mut tracker = Tracker::new("order~clothing~iStore~15150".to_string());
    tracker.add(1578071239, "notifier~billing~receipt~email".to_string(), "order~clothing~iStore~15150".to_string());
     
    // The Tracker has two Markers: the genesis Marker when new() was called, and the one that was added
    assert_eq!(tracker.len(), 2);
}

pub fn serialize(&self) -> String

Serializes the Tracker's Marker Chain.

#Example

extern crate pbd;

use pbd::dtc::Tracker;

fn main() {
    let mut tracker = Tracker::new("order~clothing~iStore~15150".to_string());
    tracker.add(1578071239, "notifier~billing~receipt~email".to_string(), "order~clothing~iStore~15150".to_string());
     
    println!("{}", tracker.serialize());
}

Trait Implementations

impl Clone for Tracker

fn clone(&self) -> Tracker

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Tracker

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Tracker

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Serialize for Tracker

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.