DBC Program Instructions

The dynamic-bonding-curve IDL exposes many instructions. Integrators can choose to either use the TypeScript SDK for transaction construction or build through CPI.

Partner Instructions

Instruction	Args	SDK path	Purpose
`create_config`	`ConfigParameters`	`client.partner.createConfig`	Create a partner config for fees, curve, token behavior, DAMM v2 migration, pool creation fee, and graduated-pool settings. Rejects `BaseFeeMode::RateLimiter` and `MigrationOption::MeteoraDamm`. Pass a token badge at remaining account index `0` when the quote mint is not permissionless-supported.
`create_config_with_transfer_hook`	`ConfigParameters`	`client.partner.createConfigWithTransferHook`	Create a Token 2022 transfer-hook config with an executable transfer-hook program. Uses the same token-badge remaining account and deprecation rules as `create_config`.
`create_partner_metadata`	`CreatePartnerMetadataParameters`	`client.partner.createPartnerMetadata`	Create optional metadata for the partner fee claimer.
`claim_trading_fee`	`max_amount_a`, `max_amount_b`	`client.partner.claimPartnerTradingFee`, `claimPartnerTradingFeeToReceiver`	Claim partner trading fees from a standard virtual pool.
`claim_trading_fee2`	`max_amount_a`, `max_amount_b`, `TransferHookAccountsInfo`	`client.partner.claimPartnerTradingFee2`	Claim partner trading fees from a transfer-hook pool.
`claim_partner_pool_creation_fee`	None	`client.partner.claimPartnerPoolCreationFee`	Claim the partner share of pool creation fees.
`partner_withdraw_surplus`	None	`client.partner.partnerWithdrawSurplus`	Withdraw partner quote surplus after migration when allowed.

Creator And Pool Instructions

Instruction	Args	SDK path	Purpose
`initialize_virtual_pool_with_spl_token`	`InitializePoolParameters`	`client.creator.createPool`	Create a DBC pool with an SPL Token base mint and Metaplex metadata. Rejects rate-limiter and DAMM v1 configs. Pass a token badge at remaining account index `0` when the quote mint is not permissionless-supported.
`initialize_virtual_pool_with_token2022`	`InitializePoolParameters`	`client.creator.createPool`	Create a DBC pool with a Token 2022 base mint. Rejects rate-limiter configs and uses the same token-badge remaining account rule.
`initialize_virtual_pool_with_token2022_transfer_hook`	`InitializePoolParameters`	`client.creator.createPoolWithTransferHook`	Create a DBC transfer-hook pool with a Token 2022 base mint. Uses the same token-badge remaining account rule.
`create_virtual_pool_metadata`	`CreateVirtualPoolMetadataParameters`	`client.creator.createPoolMetadata`	Create optional metadata for a virtual pool.
`claim_creator_trading_fee`	`max_base_amount`, `max_quote_amount`	`client.creator.claimCreatorTradingFee`, `claimCreatorTradingFeeToReceiver`	Claim creator trading fees from a standard virtual pool.
`claim_creator_trading_fee2`	`max_base_amount`, `max_quote_amount`, `TransferHookAccountsInfo`	`client.creator.claimCreatorTradingFee2`	Claim creator trading fees from a transfer-hook pool.
`creator_withdraw_surplus`	None	`client.creator.creatorWithdrawSurplus`	Withdraw creator surplus after migration when allowed.
`transfer_pool_creator`	None	`client.creator.transferPoolCreator`	Transfer creator rights and creator fee claim authority to a new address.

Swap Instructions

Instruction	Args	Modes	Notes
`swap`	`SwapParameters`	Exact in	Legacy exact-in swap path for standard pools. It emits both `EvtSwap` and `EvtSwap2`.
`swap2`	`SwapParameters2`	Exact in, partial fill, exact out	Preferred for standard-pool trading integrations because the args map directly to `SwapMode`.
`swap2_with_transfer_hook`	`SwapParameters2`, `TransferHookAccountsInfo`	Exact in, partial fill, exact out	Transfer-hook pool swap path. SDK: `client.pool.swap2WithTransferHook`.

SwapParameters2 uses these fields:

Field	Meaning
`amount_0`	Input amount for exact-in and partial-fill, or requested output amount for exact-out.
`amount_1`	Minimum output for exact-in and partial-fill, or maximum input for exact-out.
`swap_mode`	`0` exact in, `1` partial fill, `2` exact out.

Existing rate-limiter pools, or configs with enable_first_swap_with_min_fee enabled, require the instructions sysvar in remaining accounts on swap instructions. The SDK adds SYSVAR_INSTRUCTIONS_PUBKEY when needed.

Token Badge Remaining Accounts

Config and pool creation read token_badge from remaining account index 0 when the quote mint is not permissionless-supported.

Instruction	Remaining account index `0`
`create_config`	Required token badge PDA when the quote mint is not permissionless-supported.
`create_config_with_transfer_hook`	Same rule.
`initialize_virtual_pool_with_spl_token`	Same rule.
`initialize_virtual_pool_with_token2022`	Same rule.
`initialize_virtual_pool_with_token2022_transfer_hook`	Same rule.

The token badge PDA is derived from ["token_badge", quote_mint]. It is read-only and not a signer. Permissionless-supported quote mints do not need this account. A missing or mismatched badge returns InvalidTokenBadge. A badge does not bypass the zero transfer-fee rule. Transfer-hook swaps also pass extra remaining accounts described by TransferHookAccountsInfo.

Remaining account slice	Meaning
`TransferHookBase`	Extra accounts for base-token transfer-hook CPIs.
`TransferHookBaseReferral`	Extra accounts for base-token referral transfers when a referral account is present.

Standard swap instructions reject TransferHookPool accounts, and swap2_with_transfer_hook rejects standard VirtualPool accounts with PoolTypeMismatch.

Migration Instructions

Instruction	Destination	SDK path	Purpose
`create_locker`	DAMM v1 or DAMM v2 support flow	`client.migration.createLocker`	Create the locker escrow when locked vesting is configured.
`withdraw_leftover`	DAMM v1 or DAMM v2	`client.migration.withdrawLeftover`	Withdraw leftover base tokens after migration.
`migration_meteora_damm_create_metadata`	DAMM v1	`client.migration.createDammV1MigrationMetadata`	Create metadata before DAMM v1 migration.
`migrate_meteora_damm`	DAMM v1	`client.migration.migrateToDammV1`	Migrate a completed DBC pool to DAMM v1.
`migrate_meteora_damm_lock_lp_token`	DAMM v1	`client.migration.lockDammV1LpToken`	Lock permanent LP allocation for partner or creator.
`migrate_meteora_damm_claim_lp_token`	DAMM v1	`client.migration.claimDammV1LpToken`	Claim partner or creator LP allocation.
`migration_damm_v2_create_metadata`	DAMM v2	Deprecated	Deprecated since program `0.1.7`; DAMM v2 migration no longer needs a separate metadata account.
`migration_damm_v2`	DAMM v2	`client.migration.migrateToDammV2`	Migrate a completed DBC pool to DAMM v2.
`withdraw_migration_fee`	DAMM v1 or DAMM v2	`client.partner.partnerWithdrawMigrationFee`, `client.creator.creatorWithdrawMigrationFee`	Withdraw partner or creator migration fee. Uses `flag` to select the fee side.

DAMM v1 migration instructions remain for existing pools. New configs and new pools cannot select MigrationOption::MeteoraDamm. DAMM v2 migration uses a DAMM v2 config with CreatePoolWithoutMintValidation so a DBC-badged quote mint can still graduate. DBC still requires the quote mint transfer fee to be zero at migration time.

Operator Instructions

Instruction	Args	Purpose
`create_token_badge`	None	Operator with `CreateTokenBadge` creates a `TokenBadge` PDA for a quote mint that is not permissionless-supported. Rejects permissionless-supported mints and quote mints with a non-zero transfer fee.
`close_token_badge`	None	Operator with `CloseTokenBadge` closes a token badge and returns rent. Existing pools that already use the mint keep working.
`create_operator_account`	Permission bitmask	Admin creates an operator account with a `u128` permission bitmap.
`close_operator_account`	None	Admin closes an operator account.
`claim_protocol_fee2`	Selected mint and max amount	Protocol fee authority claims one pool token per call. Replaces the removed `claim_protocol_fee` instruction.
`claim_protocol_pool_creation_fee`	None	Operator with `ClaimProtocolFee` claims the protocol share of pool creation fees.

claim_protocol_fee and zap_protocol_fee are removed. Use claim_protocol_fee2 through the protocol fee wrapper program.

Program

TypeScript SDK

Rust Integration

Go Integration

Partner Instructions

Creator And Pool Instructions

Swap Instructions

Token Badge Remaining Accounts

Migration Instructions

Operator Instructions

​Partner Instructions

​Creator And Pool Instructions

​Swap Instructions

​Token Badge Remaining Accounts

​Migration Instructions

​Operator Instructions

Partner Instructions

Creator And Pool Instructions

Swap Instructions

Token Badge Remaining Accounts

Migration Instructions

Operator Instructions