Struct GetRewardDistributorResult 

pub struct GetRewardDistributorResult {

    pub launcher_id: HexId,
    pub store_id: HexId,
    pub root: HexId,
    pub epoch_seconds: u64,
    pub first_epoch_start: u64,
    pub payout_threshold: u64,
    pub fee_bps: u16,
    pub withdrawal_share_bps: u16,
    pub reserve_base_units: u64,
    pub entry_count: u64,
    pub current_distributor_epoch: u64,
    pub last_entry_write_at: Option<u64>,
    pub entry_set_stale: bool,
    pub observed_at: u64,
}

Result for dig.getRewardDistributor — SPEC §2.6, third method: chain-derived distributor state only, never the local prover loop’s own state (see RewardProverStatus for that).

entry_set_stale lives HERE, never on RewardProverStatus

This is the one boolean in the reward-distributor surface, and it belongs here specifically: per SPEC §12.4 it is computed by the responder from the distributor singleton’s on-chain spend history at read time, not self-reported by a possibly-wedged writer. Copying it onto RewardProverStatus would reintroduce exactly the self-reported-health failure that type’s doc comment forbids — see that type for the full argument.

Fields

launcher_id: HexId

The distributor singleton’s launcher id (64-hex).

store_id: HexId

The backing store’s launcher id (64-hex).

root: HexId

The store’s current generation root (64-hex).

epoch_seconds: u64

The payout epoch length, in seconds.

first_epoch_start: u64

Unix seconds the first epoch started.

payout_threshold: u64

The reserve threshold, in base units, that triggers a payout.

fee_bps: u16

The distributor’s fee, in basis points.

withdrawal_share_bps: u16

The share of a clawed-back commitment the committer recovers, in basis points — SPEC §7.5. withdrawal_share_bps = 9000 means a clawback returns 90% of the committed value; the remaining 10% is forfeited to the reserve as a deterrent against the funder (SPEC §7.5 clause 1: it is priced correctly and is not compensation to induced mirrors). Curried at launch and immutable, same as Self::fee_bps beside it.

reserve_base_units: u64

The current reserve, in base units.

entry_count: u64

The current entry-set size.

current_distributor_epoch: u64

The current epoch index (0-based from first_epoch_start).

last_entry_write_at: Option<u64>

Unix seconds of the most recent entry-set write on chain, if any. None together with a non-zero reserve_base_units implies stale: an entry set that has never been written is maximally stale, not unknown, and a consumer MUST NOT render it as blank or “unknown” (SPEC §2.4 cl. 1 — silence is not an acceptable representation of “not distributing”).

entry_set_stale: bool

true when the entry set has not changed in STALE_ENTRY_SET_SECONDS = 172_800 (48 h) while the reserve is non-zero — SPEC §12.4. A drained distributor with a frozen entry set is not stale, it is Unfunded; the non-zero-reserve conjunct exists to keep the two states distinct. The responder computes this at read time from the singleton’s own on-chain spend history — it is not self-reported, so a wedged prover cannot fake it. See the type doc for why this boolean is safe here and forbidden on RewardProverStatus.

observed_at: u64

Unix seconds this result was assembled.

Trait Implementations

impl Clone for GetRewardDistributorResult

fn clone(&self) -> GetRewardDistributorResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GetRewardDistributorResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GetRewardDistributorResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for GetRewardDistributorResult

impl PartialEq for GetRewardDistributorResult

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GetRewardDistributorResult

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 GetRewardDistributorResult