Skip to main content

RewardPayout

Trait RewardPayout 

Source
pub trait RewardPayout {
    // Required method
    fn pay(&mut self, principal_ph: Bytes32, amount_mojos: u64);
}
Expand description

Reward-payout routing surface.

Traces to SPEC §12.1, catalogue row DSL-141.

§Consumers

  • SlashingManager::submit_evidence (DSL-025) routes the whistleblower + proposer rewards through this trait.
  • Appeal adjudication (DSL-067 / DSL-068 / DSL-071) credits the winning party’s reward account.

§Semantics

pay(ph, amount) creates-or-credits a pay-to-puzzle-hash account at the consensus layer. amount == 0 is legal and MUST still be recorded — the call pattern is the protocol-observable side effect (auditors rely on the two-call pattern per admission).

Required Methods§

Source

fn pay(&mut self, principal_ph: Bytes32, amount_mojos: u64)

Create or credit the reward account for principal_ph by amount_mojos. Idempotent w.r.t. the account’s running balance — consensus aggregates repeated credits.

Implementors§