NAME

NIST::Beacon::Record - A Record object used by NIST::Beacon to represent received data.

VERSION

version 1.002

SYNOPSIS

        use NIST::Beacon;

        my $beacon = NIST::Beacon->new;
        my $record = $beacon->latest_record;

        print "The latest sequence generated by the NIST beacon is: \n";
        print $record->current, "\n";

DESCRIPTION

NIST::Beacon::Record objects are returned by the record methods in NIST::Beacon. They contain a variety of data from each emittance, including version number, seed value, generation timestamp, and more.

methods

version

Returns the version of the beacon's schema.

frequency

Returns the interval, in seconds, between beacon emittances. For example, if $record->frequency is 60, new records are emitted every 60 seconds.

timestamp

Returns the Unix timestamp associated with the moment of generation.

seed

Returns a seed value represented as a 64 byte (512-bit) hex string value.

previous

Returns the SHA-512 hash value for the previous record, as a 64 byte hex string.

signature

Returns a digital signature (RSA) computed over (in order): version, frequency, timestamp, seed, previous, status Note: Except for version, the hash is on the byte representations and not the string representations of the data values.

current

The SHA-512 hash of the signature as a 64 byte hex string.

status

Returns the status of the beacon and value chain: 0 - Chain intact, values all good 1 - Start of a new chain of values, previous hash value will be all zeroes. 2 - Time between values is greater than the frequency, but the chain is still intact

NAME

NIST::Beacon::Record - An object for holding records emitted by the NIST randomness beacon.

SEE ALSO

NIST::Beacon

AUTHOR

William Woodruff <william@tuffbizz.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2015 by William Woodruff.

This is free software, licensed under:

  The MIT (X11) License