Struct RewardClaimedEvent 

#[repr(C)]
pub struct RewardClaimedEvent {
    pub customer_wallet: Pubkey,
    pub epoch: u64,
    pub reward_amount: u64,
    pub customer_reward_pool: u64,
    pub activity_count: u32,
    pub total_customer_activity: u32,
    pub merkle_root: [u8; 32],
    pub timestamp: i64,
    pub participant_type: u8,
    pub _padding: [u8; 7],
}

Event emitted when a customer claims rewards.

This event provides complete transparency for reward calculations, allowing off-chain systems to verify that the on-chain calculation matches the expected transparent formula.

Formula Verification

The event includes all data needed to verify the calculation: reward = (activity_count * customer_reward_pool) / total_customer_activity

Usage

• Verify reward calculations match off-chain estimates
• Track reward distribution patterns
• Monitor claim activity and frequency
• Build reward transparency dashboards
• Audit reward distribution fairness

Memory Layout

80 bytes total for complete transparency data.

Fields

customer_wallet: Pubkey

Customer wallet that claimed the reward.

epoch: u64

Epoch number for the claim.

reward_amount: u64

Final reward amount claimed in smallest token units. This is calculated on-chain using the transparent formula.

customer_reward_pool: u64

Customer reward pool for this epoch. Used in the calculation: reward = (activity_count * customer_reward_pool) / total_customer_activity

activity_count: u32

Number of activities performed by the customer. This is extracted from the Merkle proof and used in reward calculation.

total_customer_activity: u32

Total customer activity for this epoch. Used in the calculation: reward = (activity_count * customer_reward_pool) / total_customer_activity

merkle_root: [u8; 32]

Merkle root used for proof verification.

timestamp: i64

Event timestamp (Unix timestamp).

participant_type: u8

Participant type: 0 for customer, 1 for merchant. Used to distinguish between customer and merchant claims.

_padding: [u8; 7]

Padding to ensure proper alignment (7 bytes to maintain 88-byte total size)

Implementations

impl RewardClaimedEvent

pub fn to_bytes(&self) -> &[u8]

impl RewardClaimedEvent

pub fn from_bytes(data: &[u8]) -> &Self

Trait Implementations

impl Clone for RewardClaimedEvent

fn clone(&self) -> RewardClaimedEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RewardClaimedEvent

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

Formats the value using the given formatter.

impl Loggable for RewardClaimedEvent

fn log(&self)

fn log_return(&self)

impl PartialEq for RewardClaimedEvent

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

fn zeroed() -> Self

Calls zeroed.

impl Copy for RewardClaimedEvent

impl Pod for RewardClaimedEvent

impl StructuralPartialEq for RewardClaimedEvent