Feature/0.1.33 events

[Alann27]

Summary

• Add settlement aggregation fields to EventClaimSettled (settled/minted/overservicing/deflation amounts, mint ratio, supplier owner)
• Add optional fields to EventApplicationOverserviced (service, session end block height, spend limit exceeded)
• Extend SettlementOpReason enum with new relay burn-equals-mint and global mint TLM distribution reasons
• Fix burns/mints derivation for reward_distribution_detailed path by reading values directly from chain op_reason entries instead of broken math
• Handle EventSettlementBatch to save batched validator/delegator rewards as ModToAcctTransfer records
• Refactor _handleEventClaimSettled into smaller, focused functions

Detail

schema.graphql:

• Add settlement aggregation fields to EventClaimSettled: settledAmount, settledDenom, mintRatio, supplierOwner, mintedAmount, mintedDenom, overservicingLossAmount, overservicingLossDenom, deflationLossAmount, deflationLossDenom
• Add optional fields to EventApplicationOverserviced: service, sessionEndBlockHeight, spendLimitExceeded
• Extend SettlementOpReason enum with relay burn-equals-mint and global mint TLM distribution reasons (DAO, source owner, application, validator, delegator, tokenomics mint)

proto/pocket/tokenomics/event.proto:

• Add proto definitions for new settlement aggregation event attributes
• Add RewardDistributionDetail message
• Add EventSettlementBatch message

src/mappings/pocket/relays.ts:

• Parse new event attributes: reward_distribution_detailed, settled_upokt, minted_upokt, mint_ratio, supplier_owner_address, overservicing_loss_upokt, deflation_loss_upokt, num_estimated_relays
• Refactor _handleEventClaimSettled into smaller functions:
  • _resolveSettlementParts
  • _buildClaimSettledProps
  • _buildSettlementFromResult
  • _buildSettlementFromDetailedDistribution
  • _buildSettlementFromDistribution
  • _computeNumEstimatedRelays
  • _computeDeflationLoss
  • _computeOverservicingLoss
• Build burns/mints from chain-provided values and reward_distribution_detailed op_reason entries instead of deriving them mathematically
• Add handleEventSettlementBatch to save batched validator/delegator rewards as ModToAcctTransfer records

src/mappings/handlers.ts:

• Wire handleEventSettlementBatch to pocket.tokenomics.EventSettlementBatch

src/mappings/indexer.manager.ts:

• Subscribe to pocket.tokenomics.EventSettlementBatch event type

project.ts:

• Register EventSettlementBatch event handler

Issue

The previous implementation derived inflation and reimbursement mint amounts by computing sum(reward_distribution) - (effectiveBurn × mintRatio). This broke at height 153753 (beta) because reward_distribution_detailed excludes proposer/validator rewards (they are batched separately via EventSettlementBatch), making the total less than minted_upokt and producing a negative value.

The fix:

• Extracts inflation and reimbursement directly from reward_distribution_detailed entries by op_reason (TLM_GLOBAL_MINT_DAO_REWARD_DISTRIBUTION and TLM_GLOBAL_MINT_REIMBURSEMENT_REQUEST_ESCROW_DAO_TRANSFER)
• Saves the batched validator/delegator rewards from EventSettlementBatch as ModToAcctTransfer records

Type of change

Select one or more:

• New feature, functionality or library
• Bug fix
• Code health or cleanup
• Documentation
• Other (specify)

Sanity Checklist

• I have tested my changes using the available tooling
• I have commented my code
• I have performed a self-review of my own code; both comments & source code
• I create and reference any new tickets, if applicable
• I have left TODOs throughout the codebase, if applicable