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` for curve progress. `EvtSwap3` for transfer-fee amounts.
Primary transfer-hook swap event	`EvtSwap2WithTransferHook` for curve progress. `EvtSwap3WithTransferHook` for transfer-fee amounts.
Config creation	`create_config` and `create_config2` emit `EvtCreateConfig3` and `EvtCreateConfigV2`. Prefer `EvtCreateConfig3`. `EvtCreateConfig` is no longer emitted.
Log-event exception	`EvtClaimProtocolFee2` is emitted with `emit!`, not event CPI.

Config And Metadata Events

Event	Emitted by	Important fields	Use
`EvtCreateConfig3`	`create_config`, `create_config2`	`config`, `quote_mint`, `fee_claimer`, `leftover_receiver`, `config_parameters`, `transfer_fee_parameters`	Config payload for both config instructions. `transfer_fee_parameters` is set only by `create_config2`. Prefer this event.
`EvtCreateConfigV2`	`create_config`, `create_config2`	`config`, `quote_mint`, `fee_claimer`, `leftover_receiver`, `config_parameters`	Still emitted with `EvtCreateConfig3`. Deprecated in favour of `EvtCreateConfig3`.
`EvtCreateConfigV2WithTransferHook`	`create_config_with_transfer_hook`	`config`, `quote_mint`, `fee_claimer`, `leftover_receiver`, `config_parameters`, `transfer_hook_program`	The only config event from the transfer-hook config instruction.
`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.
`EvtCreateTokenBadge`	`create_token_badge`	`token_mint`	Index a newly allowlisted quote mint.
`EvtCloseTokenBadge`	`close_token_badge`	`token_mint`	Index token badge closure.

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.
`EvtSwap3`	`swap`, `swap2`	`swap_mode`, `included_transfer_fee_amount_in`, `excluded_transfer_fee_amount_in`, `included_transfer_fee_amount_out`, `excluded_transfer_fee_amount_out`, `next_sqrt_price`, `quote_reserve`	Transfer-fee amounts for a standard swap. It does not embed `EvtSwap2`.
`EvtSwap3WithTransferHook`	`swap2_with_transfer_hook`	Same transfer-fee fields as `EvtSwap3`	Transfer-fee amounts for a transfer-hook swap.
`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 or EvtSwap3, quote helpers, and account state so trading fees, transfer fees, partial fills, and next_sqrt_price are handled correctly.

included_transfer_fee_amount_in is the amount the user pays. excluded_transfer_fee_amount_in is what the pool receives after the input mint’s transfer fee, and it matches swap_result.included_fee_input_amount. included_transfer_fee_amount_out matches swap_result.output_amount. excluded_transfer_fee_amount_out is what the user receives after the output mint’s transfer fee. EvtSwap.params.amount_in equals included_transfer_fee_amount_in in every swap mode. EvtSwap.params.minimum_amount_out equals excluded_transfer_fee_amount_out for exact-out and partial-fill. For exact-in it is the user’s minimum_amount_out, not the amount received.

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`	Removed `claim_protocol_fee`	`pool`, `token_base_amount`, `token_quote_amount`	Historical protocol trading fee claim. New claims use `EvtClaimProtocolFee2`.
`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. Read user-facing amounts from EvtSwap3.included_transfer_fee_amount_in and EvtSwap3.excluded_transfer_fee_amount_out. EvtSwap.params.amount_in includes the transfer fee.
Consume EvtCreateConfig3 for configs from create_config and create_config2. EvtCreateConfig is no longer emitted. create_config_with_transfer_hook still emits only EvtCreateConfigV2WithTransferHook.
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