Documentation Index
Fetch the complete documentation index at: https://docs.meteora.ag/llms.txt
Use this file to discover all available pages before exploring further.
The dynamic_fee_sharing program emits Anchor events through event CPI. Indexers should decode these events from Dynamic Fee Sharing program logs and join them with FeeVault account reads when current aggregate state is needed.
Events
| Event | Fields | Emitted by | Use |
|---|
EvtInitializeFeeVault | fee_vault, token_mint, owner, base, params | initialize_fee_vault, initialize_fee_vault_pda | Index new fee vaults, token mints, owners, PDA bases, and configured user shares. |
EvtFundFee | source_program, fee_vault, funded_amount, fee_per_share, payload | fund_fee, fund_by_claiming_fee | Track fee vault funding and the updated accumulated fee per share. |
EvtClaimFee | fee_vault, user, index, claimed_fee | claim_fee | Track user claims by configured user index. |
Event Details
EvtInitializeFeeVault
| Field | Type | Notes |
|---|
fee_vault | Pubkey | Created fee vault account. |
token_mint | Pubkey | Mint accepted by the vault. |
owner | Pubkey | Owner recorded in the vault state. |
base | Pubkey | PDA base for initialize_fee_vault_pda; default public key for non-PDA vaults. |
params | InitializeFeeVaultParameters | Includes reserved padding and configured UserShare[]. |
EvtFundFee
| Field | Type | Notes |
|---|
source_program | Pubkey | Default public key for direct fund_fee; downstream program ID for fund_by_claiming_fee. |
fee_vault | Pubkey | Fee vault that received credited fees. |
funded_amount | u64 | Raw token amount credited to share accounting. For Token 2022 transfer-fee mints, this excludes the transfer fee on direct funding. |
fee_per_share | u128 | Vault’s accumulated Q64 fixed-point fee per share after funding. |
payload | Vec<u8> | Empty for direct fund_fee; downstream instruction data for source-program funding. |
fund_by_claiming_fee emits EvtFundFee only when the downstream invocation increases the fee vault token balance by more than zero.
EvtClaimFee
| Field | Type | Notes |
|---|
fee_vault | Pubkey | Fee vault being claimed from. |
user | Pubkey | Claiming shareholder. |
index | u8 | User index passed to claim_fee. |
claimed_fee | u64 | Raw token amount transferred to user_token_vault. |
claim_fee emits EvtClaimFee only when the computed claim amount is greater than zero.
Indexing Notes
| Topic | Note |
|---|
| Event CPI accounts | Generated Anchor clients add event_authority and program accounts for all event-emitting instructions. |
| Amount precision | Amounts are raw token units. Apply mint decimals off-chain for display. |
| Direct funding | source_program is the default public key and payload is empty. |
| Source-program funding | Store source_program and payload if you need to reconstruct which whitelisted DAMM v2 or DBC action funded the vault. |
| Current state | Events are append-only. Read FeeVault for current total_funded_fee, fee_per_share, and per-user fee_claimed counters. |
