Struct EncodedPostBundleFeedbackV1 

pub struct EncodedPostBundleFeedbackV1 {
    pub header: EncodedPostBundleFeedbackHeaderV1,
    pub feedbacks_bytes: Bytes,
}

Fields

header: EncodedPostBundleFeedbackHeaderV1

feedbacks_bytes: Bytes

Implementations

impl EncodedPostBundleFeedbackV1

pub fn to_bytes(&self) -> Result<Bytes>

pub fn from_bytes(bytes: Bytes) -> Result<Self>

pub fn verify(&self) -> Result<()>

Verifies that this bundle is legitimate enough to cache.

Checks:

1. The bundle header is valid and its signature verifies.
2. The feedback body is a valid multiple of ENTRY_SIZE (no partial entries).
3. The header’s hash is the same as the body’s
4. Each feedback entry’s proof-of-work is correct.

pub fn verify_for_location(&self, location_id: &Id) -> Result<()>

Verifies that this bundle is a legitimate feedback bundle for location_id, as received from the network.

On top of EncodedPostBundleFeedbackV1::verify:

1. The publishing peer is a genuine server identity (server-id PoW, id derived from its key, self-signed). EncodedPostBundleFeedbackHeaderV1::verify alone only checks the header against the key the header itself supplies.
2. The bundle is for this location_id.

pub fn verify_origin_for_location(&self, location_id: &Id) -> Result<()>

Self::verify_for_location minus the per-entry PoW check: proves a genuine server published this bundle for location_id, but tolerates individual entries with bad PoW, which Self::merge drops one at a time. For a server’s own (direct) copy, so that one bad entry it holds cannot erase all of its other feedback. Never forward a bundle that has only passed this check.

pub fn get_post_pow_for_feedback_type( &self, post_id: &Id, feedback_type: u8, ) -> Pow

pub fn merge(bundles: &[Self]) -> Option<Self>

Unions an array of bundles by taking the highest-pow entry for each (post_id, feedback_type) pair across all bundles. The header is taken from the most-recently-timestamped bundle. Returns None if bundles is empty.

Entries whose claimed pow does not match what their salt achieves are dropped individually. The bundle header signature only proves which server produced the bundle, not that its entries are honest, so a dishonest (or poisoned) server must not be able to plant pow=255 flags. Dropping per-entry rather than rejecting the whole bundle means one bad entry cannot erase all other feedback for the bucket.

pub fn get_post_pows(&self, post_id: &Id) -> [Pow; 256]

Trait Implementations

impl Clone for EncodedPostBundleFeedbackV1

fn clone(&self) -> EncodedPostBundleFeedbackV1

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EncodedPostBundleFeedbackV1

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

Formats the value using the given formatter.

impl Display for EncodedPostBundleFeedbackV1

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

Formats the value using the given formatter.

impl PartialEq for EncodedPostBundleFeedbackV1

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