Struct MerklePaymentCandidateNode 

pub struct MerklePaymentCandidateNode {
    pub pub_key: Vec<u8>,
    pub quoting_metrics: QuotingMetrics,
    pub reward_address: Address,
    pub merkle_payment_timestamp: u64,
    pub signature: Vec<u8>,
}

A node’s signed quote for potential reward eligibility

Nodes create this structure in response to a client’s quote request. The client provides a merkle_payment_timestamp, which nodes verify is not outdated (not in the future or expired). Nodes then sign their quoting metrics and payment address with this timestamp, establishing their candidacy to be selected for payment rewards. The client collects these from multiple nodes to build a MerklePaymentCandidatePool.

Fields

pub_key: Vec<u8>

Node’s libp2p public key PeerId can be derived from this: PeerId::from(PublicKey::try_decode_protobuf(pub_key))

quoting_metrics: QuotingMetrics

Node’s storage metrics at quote time

reward_address: Address

Node’s Ethereum address for payment

merkle_payment_timestamp: u64

Quote timestamp (provided by the client)

signature: Vec<u8>

Signature over hash(quoting_metrics || reward_address || timestamp)

Implementations

impl MerklePaymentCandidateNode

pub fn new( keypair: &Keypair, quoting_metrics: QuotingMetrics, reward_address: Address, merkle_payment_timestamp: u64, ) -> Result<MerklePaymentCandidateNode, SigningError>

Create a new candidate node with signed commitment

Arguments

• keypair - Node’s libp2p keypair for signing
• quoting_metrics - Node’s storage metrics at quote time
• reward_address - Node’s Ethereum address for payment
• timestamp - Quote timestamp

Returns

• Result<Self, MerklePaymentError> - Signed candidate node or signing error

pub fn bytes_to_sign( quoting_metrics: &QuotingMetrics, reward_address: &Address, timestamp: u64, ) -> Vec<u8>

Get the bytes to sign

pub fn peer_id(&self) -> Result<PeerId, DecodingError>

Derive PeerId from public key

pub fn verify_signature(&self) -> bool

Verify signature is valid for this node

Trait Implementations

impl Clone for MerklePaymentCandidateNode

fn clone(&self) -> MerklePaymentCandidateNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MerklePaymentCandidateNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MerklePaymentCandidateNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MerklePaymentCandidateNode

fn eq(&self, other: &MerklePaymentCandidateNode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for MerklePaymentCandidateNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for MerklePaymentCandidateNode

impl StructuralPartialEq for MerklePaymentCandidateNode