Struct MerklePaymentProof 

pub struct MerklePaymentProof {
    pub address: XorName,
    pub data_proof: MerkleBranch,
    pub winner_pool: MerklePaymentCandidatePool,
}

Data package sent from client to node for data storage and payment verification

Contains everything a node needs to verify:

1. The data belongs to a paid Merkle tree (via proof)
2. Payment was made to the correct pool (via winner pool proof and smart contract query)
3. The node is eligible to store this data (if they’re in the winner pool)

Fields

address: XorName

The data’s XorName

data_proof: MerkleBranch

Merkle proof that this data belongs to the paid tree

winner_pool: MerklePaymentCandidatePool

The winner pool selected by the smart contract Contains the full candidate pool with signatures and intersection proof

Implementations

impl MerklePaymentProof

pub fn new( address: XorName, data_proof: MerkleBranch, winner_pool: MerklePaymentCandidatePool, ) -> MerklePaymentProof

Create a new Merkle payment proof

pub fn winner_pool_hash(&self) -> [u8; 32]

Get the hash of the winner pool (used to query smart contract for payment info)

pub fn corresponding_peer_ids( &self, paid_nodes: &[(Address, usize)], ) -> Result<Vec<PeerId>, MerklePaymentVerificationError>

Get the corresponding peer ids for the paid nodes using their indices in the winner pool

This uses the indices from the smart contract to identify exactly which nodes were paid. This is necessary because multiple nodes can share the same reward address.

Arguments

• paid_nodes - The (address, index) pairs from the smart contract

Returns

• Ok(Vec<PeerId>) - PeerIds of the paid nodes, in the same order as the input
• Err(PaidNodeIndexOutOfBounds) - If any index is out of bounds
• Err(InvalidNodePeerId) - If any paid node has an invalid public key
• Err(PaidAddressMismatch) - If address at index doesn’t match expected address

pub fn verify( &self, smart_contract_depth: u8, smart_contract_timestamp: u64, smart_contract_pool_hash: &[u8; 32], smart_contract_paid_nodes: &[(Address, usize)], ) -> Result<(), MerklePaymentVerificationError>

Verify the payment proof against the smart contract payment info

Arguments

• smart_contract_depth - The depth value stored in the smart contract
• smart_contract_timestamp - The merkle payment timestamp stored in the smart contract
• smart_contract_pool_hash - The hash of the winner pool stored in the smart contract
• smart_contract_paid_nodes - The (address, index) pairs of paid nodes from the smart contract

Trait Implementations

impl Clone for MerklePaymentProof

fn clone(&self) -> MerklePaymentProof

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MerklePaymentProof

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MerklePaymentProof

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MerklePaymentProof

fn eq(&self, other: &MerklePaymentProof) -> 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 MerklePaymentProof

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 MerklePaymentProof

impl StructuralPartialEq for MerklePaymentProof