Struct PayeeClaimStatus 

pub struct PayeeClaimStatus {
    pub subject: PayeeSubject,
    pub claim_log: ClaimLogObservation,
}

Result for dig.getPayeeRewardClaimStatus — the claim-side posture of the node answering, as a payee.

The subject is on the wire, not inferred from the endpoint

subject is required and is the literal "payee". It is not redundant with the method name: this epic shipped a defect in which a funder’s distributor-wide total was rendered to a payee as that operator’s own earnings, overstating by up to 250x, and it passed security review and a full green CI because no test asserted whose money the number was. A renderer that reads subject off the payload cannot make that substitution silently; one that infers the subject from which endpoint it thinks it called can.

No monetary amount, at all

There is deliberately no amount field here — not optional, not nullable, absent. A payload that carries no amount has nothing a UI can misrender as earnings, and that absence is the whole defence; an Option<u64> would not be, because the misrendering path is a present number attributed to the wrong party. A payee that wants its own settled history reads its own past InitiatePayout spends, which are on chain and are evidence (SPEC §12.5 clause 7). The payout puzzle hash is likewise absent and MUST NOT be added: it is the payee’s payment identity, and nothing here needs it.

No #[serde(default)], no skip_serializing_if

Every field is required on the wire in both directions. A defaulting field is a field a producer can omit and a consumer will invent — which for subject would restore exactly the inferred-subject hazard above, and for claim_log would manufacture a consultation nobody performed.

Fields

subject: PayeeSubject

Always PayeeSubject::Payee; serialises as the literal "subject": "payee".

claim_log: ClaimLogObservation

This node’s claim log: read, with the count it held, or not read at all.

The count lives inside the observation so it cannot be separated from the fact that something read the log. The reader derives staleness itself from the observation’s observed_at and its own clock (SPEC §2.4); no staleness is pre-computed here.

Trait Implementations

impl Clone for PayeeClaimStatus

fn clone(&self) -> PayeeClaimStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PayeeClaimStatus

impl Debug for PayeeClaimStatus

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PayeeClaimStatus

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PayeeClaimStatus

impl PartialEq for PayeeClaimStatus

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PayeeClaimStatus

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PayeeClaimStatus