The dynamic-bonding-curve program emits most Anchor events through event CPI. Use this page when building indexers, analytics pipelines, charting systems, or low-level clients that need to map transactions back to DBC pool activity.
Event CPI
| Item | Value |
|---|
| Event authority seed | __event_authority |
| SDK helper | deriveDbcEventAuthority() |
| Primary standard swap event | EvtSwap2 |
| Primary transfer-hook swap event | EvtSwap2WithTransferHook |
| Deprecated compatibility event | EvtCreateConfig is deprecated; prefer EvtCreateConfigV2. |
| Log-event exception | EvtClaimProtocolFee2 is emitted with emit!, not event CPI. |
| Event | Emitted by | Important fields | Use |
|---|
EvtCreateConfig | create_config | config, quote_mint, fee_claimer, fee and curve fields | Deprecated config payload kept for compatibility. |
EvtCreateConfigV2 | create_config | config, quote_mint, fee_claimer, leftover_receiver, config_parameters | Preferred config creation payload. |
EvtCreateConfigV2WithTransferHook | create_config_with_transfer_hook | config, quote_mint, fee_claimer, leftover_receiver, config_parameters, transfer_hook_program | Index transfer-hook configs. |
EvtPartnerMetadata | create_partner_metadata | partner_metadata, fee_claimer | Link partner metadata to a fee claimer. |
EvtVirtualPoolMetadata | create_virtual_pool_metadata | virtual_pool_metadata, virtual_pool | Link pool metadata to a virtual pool. |
EvtInitializePool | initialize_virtual_pool_with_spl_token, initialize_virtual_pool_with_token2022 | pool, config, creator, base_mint, pool_type, activation_point | Index new DBC pools. |
EvtInitializePoolWithTransferHook | initialize_virtual_pool_with_token2022_transfer_hook | pool, config, creator, base_mint, pool_type, activation_point | Index new transfer-hook DBC pools. |
EvtUpdatePoolCreator | transfer_pool_creator | pool, creator, new_creator | Track creator authority transfer. |
Swap Events
| Event | Emitted by | Important fields | Use |
|---|
EvtSwap | swap, swap2 | pool, config, trade_direction, has_referral, params, swap_result, amount_in, current_timestamp | Legacy/simple swap payload. |
EvtSwap2 | swap, swap2 | pool, config, trade_direction, has_referral, swap_parameters, swap_result, quote_reserve_amount, migration_threshold, current_timestamp | Preferred swap payload for charting, progress, fees, and exact-out or partial-fill support. |
EvtCurveComplete | swap, swap2 when the threshold is reached | pool, config, base_reserve, quote_reserve | Mark bonding curve completion and migration readiness. |
EvtSwap2WithTransferHook | swap2_with_transfer_hook | pool, config, trade_direction, has_referral, swap_parameters, swap_result, quote_reserve_amount, migration_threshold, current_timestamp | Preferred transfer-hook swap payload. |
EvtCurveCompleteWithTransferHook | swap2_with_transfer_hook when the threshold is reached | pool, config, base_reserve, quote_reserve | Mark transfer-hook bonding curve completion and hook revocation. |
EvtSwap2 Payload
| Field | Meaning |
|---|
trade_direction | 0 base to quote, 1 quote to base. |
has_referral | Whether referral fee was included in the fee split. |
swap_parameters.amount_0 | Input for exact-in and partial-fill, or requested output for exact-out. |
swap_parameters.amount_1 | Minimum output for exact-in and partial-fill, or maximum input for exact-out. |
swap_parameters.swap_mode | 0 exact in, 1 partial fill, 2 exact out. |
swap_result.included_fee_input_amount | Input amount before excluded-fee adjustment. |
swap_result.excluded_fee_input_amount | Amount that moved the curve after fee handling. |
swap_result.amount_left | Unused amount in partial-fill mode. |
swap_result.output_amount | Output token amount. |
swap_result.next_sqrt_price | Post-swap sqrt price. |
swap_result.trading_fee, protocol_fee, referral_fee | Fee split for the swap. |
quote_reserve_amount | Quote reserve after the swap. Use this for progress charts. |
migration_threshold | Configured quote threshold for migration readiness. |
Do not reconstruct DBC price from token transfer logs. Use EvtSwap2, quote helpers, and account state so fee-adjusted amounts, partial fills, and next_sqrt_price are handled correctly.
Fee And Claim Events
| Event | Emitted by | Important fields | Use |
|---|
EvtClaimTradingFee | claim_trading_fee, claim_trading_fee2 | pool, token_base_amount, token_quote_amount | Partner trading fee claim. |
EvtClaimCreatorTradingFee | claim_creator_trading_fee, claim_creator_trading_fee2 | pool, token_base_amount, token_quote_amount | Creator trading fee claim. |
EvtClaimProtocolFee | claim_protocol_fee | pool, token_base_amount, token_quote_amount | Deprecated protocol trading fee claim. |
EvtClaimProtocolFee2 | claim_protocol_fee2 | pool, receiver_token_account, token_mint, amount | Protocol fee claim through the newer single-mint claim path. |
EvtClaimPoolCreationFee | claim_protocol_pool_creation_fee | pool, receiver, creation_fee | Protocol share of pool creation fee. |
EvtPartnerClaimPoolCreationFee | claim_partner_pool_creation_fee | pool, partner, creation_fee, fee_receiver | Partner share of pool creation fee. |
Migration And Withdrawal Events
| Event | Emitted by | Important fields | Use |
|---|
EvtCreateMeteoraMigrationMetadata | migration_meteora_damm_create_metadata | virtual_pool | DAMM v1 migration metadata creation. |
EvtPartnerWithdrawSurplus | partner_withdraw_surplus | pool, surplus_amount | Partner surplus withdrawal. |
EvtCreatorWithdrawSurplus | creator_withdraw_surplus | pool, surplus_amount | Creator surplus withdrawal. |
EvtWithdrawLeftover | withdraw_leftover | pool, leftover_receiver, leftover_amount | Leftover base-token withdrawal. |
EvtWithdrawMigrationFee | withdraw_migration_fee | pool, fee, flag | Migration fee withdrawal with role flag. |
Operator Events
| Event | Emitted by | Important fields | Use |
|---|
EvtCloseClaimFeeOperator | close_claim_protocol_fee_operator | claim_fee_operator, operator | Track protocol fee operator closure. |
Indexing Notes
- Treat
EvtSwap2.quote_reserve_amount / EvtSwap2.migration_threshold as the event-side progress signal.
- Reconcile event-derived progress with
VirtualPool.quote_reserve from account state.
- Index both
EvtInitializePool and EvtInitializePoolWithTransferHook, plus pool accounts, so pools created before your indexer starts are still discoverable.
- Store raw
swap_result values for analytics; rounded UI values can lose fee and partial-fill detail.
- For migrated pools, use DBC events to identify completion and destination AMM state to track post-migration trading.
