DBC Program Events

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.

Config And Metadata Events

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.

Program

TypeScript SDK

Rust Integration

Go Integration

Event CPI

Config And Metadata Events

Swap Events

EvtSwap2 Payload

Fee And Claim Events

Migration And Withdrawal Events

Operator Events

Indexing Notes

​Event CPI

​Config And Metadata Events

​Swap Events

​EvtSwap2 Payload

​Fee And Claim Events

​Migration And Withdrawal Events

​Operator Events

​Indexing Notes

Event CPI

Config And Metadata Events

Swap Events

EvtSwap2 Payload

Fee And Claim Events

Migration And Withdrawal Events

Operator Events

Indexing Notes