DBC Program Events

Understand DBC dynamic_bonding_curve events emitted by config, transfer-hook, pool, swap, fee claim, migration, metadata, and operator flows.

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

1. 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.
2. Consume EvtCreateConfig3 for configs from create_config and create_config2. EvtCreateConfig is no longer emitted. create_config_with_transfer_hook still emits only EvtCreateConfigV2WithTransferHook.
3. Reconcile event-derived progress with VirtualPool.quote_reserve from account state.
4. Index both EvtInitializePool and EvtInitializePoolWithTransferHook, plus pool accounts, so pools created before your indexer starts are still discoverable.
5. Store raw swap_result values for analytics; rounded UI values can lose fee and partial-fill detail.
6. For migrated pools, use DBC events to identify completion and destination AMM state to track post-migration trading.