Struct G1Pubkey

pub struct G1Pubkey(/* private fields */);

The pubkey type for drand networks with scheme ID pedersen-bls-chained or pedersen-bls-unchained.

Examples

Classic mainnet

use hex_literal::hex;
use drand_verify::{G1Pubkey, Pubkey};

/// Public key of classic League of Entropy Mainnet (curl -sS https://drand.cloudflare.com/info)
const PK_LEO_MAINNET: [u8; 48] = hex!("868f005eb8e6e4ca0a47c8a77ceaa5309a47978a7c71bc5cce96366b5d7a569937c529eeda66c7293784a9402801af31");

let pk = G1Pubkey::from_fixed(PK_LEO_MAINNET).unwrap();

// curl -sS https://drand.cloudflare.com/public/72785
let previous_signature = hex::decode("a609e19a03c2fcc559e8dae14900aaefe517cb55c840f6e69bc8e4f66c8d18e8a609685d9917efbfb0c37f058c2de88f13d297c7e19e0ab24813079efe57a182554ff054c7638153f9b26a60e7111f71a0ff63d9571704905d3ca6df0b031747").unwrap();
let signature = hex::decode("82f5d3d2de4db19d40a6980e8aa37842a0e55d1df06bd68bddc8d60002e8e959eb9cfa368b3c1b77d18f02a54fe047b80f0989315f83b12a74fd8679c4f12aae86eaf6ab5690b34f1fddd50ee3cc6f6cdf59e95526d5a5d82aaa84fa6f181e42").unwrap();
let round: u64 = 72785;

let result = pk.verify(round, &previous_signature, &signature).unwrap();
assert!(result);

Use empty previous_signature for unchained mode:

/// Public key League of Entropy Mainnet (curl -sS https://pl-us.testnet.drand.sh/7672797f548f3f4748ac4bf3352fc6c6b6468c9ad40ad456a397545c6e2df5bf/info)
const PK_UNCHAINED_TESTNET: [u8; 48] = hex!("8200fc249deb0148eb918d6e213980c5d01acd7fc251900d9260136da3b54836ce125172399ddc69c4e3e11429b62c11");
let pk = G1Pubkey::from_fixed(PK_UNCHAINED_TESTNET).unwrap();

// curl -sS https://pl-us.testnet.drand.sh/7672797f548f3f4748ac4bf3352fc6c6b6468c9ad40ad456a397545c6e2df5bf/public/223344
let signature = hex::decode("94f6b85df7cce7237e8e7df66d794ddad092de5d8bb6a791b97e905aa89852e506ac36a792eba7021e22eebf34891f8914bf9a8dd9233ea0a4c5ca00ef8404999f899073dd2eade61fe54077fee8168f83dcb61a758b6883b38904054e64a433").unwrap();
let round: u64 = 223344;

// Note empty argument here
let result = pk.verify(round, b"", &signature).unwrap();
assert!(result);

Trait Implementations

impl Pubkey for G1Pubkey

fn verify_step2( &self, signature: &[u8], msg_on_curve: &Self::Other, ) -> Result<bool, VerificationError>

Takes this public key and verifies the signature with it. The message has to be created with Self::msg_to_curve.

type This = G1

The curve (G1 or G2) on which the public key lives

type ThisCompressed = [u8; 48]

The type in which this point is expressed in binary data (either [u8; 48] or [u8; 96])

type Other = G2

The other curve (G2 or G1) on which the signature lives

fn msg_to_curve(msg: &[u8]) -> Self::Other

fn from_fixed(data: [u8; 48]) -> Result<Self, InvalidPoint>

fn from_fixed_unchecked(data: [u8; 48]) -> Result<Self, InvalidPoint>

fn from_variable(data: &[u8]) -> Result<Self, InvalidPoint>

fn verify( &self, round: u64, previous_signature: &[u8], signature: &[u8], ) -> Result<bool, VerificationError>

The high level verification method for a drand beacon.