Meteora DBC

This document describes the output structure for the Meteora DBC (Dynamic Bond Curve) decoder functions. The decoder handles four main event types: INITIALIZE_VIRTUAL_POOL_WITH_SPL_TOKEN, SWAP, MIGRATE_METEORA_DAMM, and MIGRATE_METEORA_DAMM_V2.

Common Properties

All decoded events include the following base properties from BaseTransactionRecord:

Property	Type	JSON Type	Description
uuid	bigint	string	Unique identifier for the transaction record
instructionPath	string	string	Path to the instruction within the transaction
parentProgramId	string | null	string | null	ID of the parent program if applicable
txSignature	string	string	Transaction signature
blockTime	number	number	Block timestamp
programId	string	string	Meteora DBC program ID
eventType	string	string	Type of event (INITIALIZE_VIRTUAL_POOL_WITH_SPL_TOKEN, SWAP, MIGRATE_METEORA_DAMM, MIGRATE_METEORA_DAMM_V2)
decoderType	DecoderType	string	Decoder type identifier
blockHeight	number	number	Block height
slot	number	number	Blockchain slot number
txFee	number	number	Transaction fee in lamports
txFeeUiAmount	PreciseDecimal	string	UI-formatted transaction fee

INITIALIZE_VIRTUAL_POOL_WITH_SPL_TOKEN Event

Virtual pool initialization event with SPL token.

Property	Type	JSON Type	Description
name	string	string	Token name
symbol	string	string	Token symbol
uri	string	string	Token metadata URI
creator	string	string	Pool creator address
mint	string	string	Token mint address
pool	string	string	Virtual pool address
quoteMint	string	string	Quote token mint address
baseVault	string	string	Base token vault address
quoteVault	string	string	Quote token vault address

SWAP Event

Token swap event on Meteora DBC virtual pool.

Property	Type	JSON Type	Description
isBuy	boolean	boolean	True for buy orders, false for sell orders
pool	string	string	Virtual pool address
config	string	string	Pool configuration address
hasReferral	boolean	boolean	Whether the swap has a referral
inputTokenAccount	string	string	Input token account address
outputTokenAccount	string	string	Output token account address
baseVault	string	string	Base token vault address
quoteVault	string	string	Quote token vault address
baseMint	string	string	Base token mint address
quoteMint	string	string	Quote token mint address
price	bigint	string	Current swap price
priceUiAmount	PreciseDecimal	string	UI-formatted current price
pricePre	bigint	string	Price before swap
pricePreUiAmount	PreciseDecimal	string	UI-formatted price before swap
pricePost	bigint	string	Price after swap
pricePostUiAmount	PreciseDecimal	string	UI-formatted price after swap
minimumAmountOut	bigint	string	Minimum acceptable output amount
minimumAmountOutUiAmount	PreciseDecimal	string	UI-formatted minimum output amount
nextSqrtPrice	bigint	string	Next square root price
nextSqrtPriceUiAmount	PreciseDecimal	string	UI-formatted next square root price
tradingFee	bigint	string	Trading fee amount
tradingFeeUiAmount	PreciseDecimal	string	UI-formatted trading fee
protocolFee	bigint	string	Protocol fee amount
protocolFeeUiAmount	PreciseDecimal	string	UI-formatted protocol fee
referralFee	bigint	string	Referral fee amount
referralFeeUiAmount	PreciseDecimal	string	UI-formatted referral fee
currentTimestamp	number	number	Current timestamp
baseVaultPreBalance	bigint	string	Base vault balance before swap
baseVaultPreBalanceUiAmount	PreciseDecimal	string	UI-formatted base vault pre-balance
quoteVaultPreBalance	bigint	string	Quote vault balance before swap
quoteVaultPreBalanceUiAmount	PreciseDecimal	string	UI-formatted quote vault pre-balance
inputAccountAmountPreBalance	bigint	string	Input account balance before swap
inputAccountAmountPreBalanceUiAmount	PreciseDecimal	string	UI-formatted input account pre-balance
outputAccountAmountPreBalance	bigint	string	Output account balance before swap
outputAccountAmountPreBalanceUiAmount	PreciseDecimal	string	UI-formatted output account pre-balance
baseVaultPostBalance	bigint	string	Base vault balance after swap
baseVaultPostBalanceUiAmount	PreciseDecimal	string	UI-formatted base vault post-balance
quoteVaultPostBalance	bigint	string	Quote vault balance after swap
quoteVaultPostBalanceUiAmount	PreciseDecimal	string	UI-formatted quote vault post-balance
inputAccountAmountPostBalance	bigint	string	Input account balance after swap
inputAccountAmountPostBalanceUiAmount	PreciseDecimal	string	UI-formatted input account post-balance
outputAccountAmountPostBalance	bigint	string	Output account balance after swap
outputAccountAmountPostBalanceUiAmount	PreciseDecimal	string	UI-formatted output account post-balance
amountIn	bigint	string	Input token amount
amountInUiAmount	PreciseDecimal	string	UI-formatted input amount
amountOut	bigint	string	Output token amount
amountOutUiAmount	PreciseDecimal	string	UI-formatted output amount
sqrtStartPrice	bigint	string	Starting square root price
sqrtPricePre	bigint	string	Square root price before swap
sqrtPricePreUiAmount	PreciseDecimal	string	UI-formatted sqrt price before swap
sqrtPricePost	bigint	string	Square root price after swap
sqrtPricePostUiAmount	PreciseDecimal	string	UI-formatted sqrt price after swap
virtualLiquidity	bigint	string	Virtual liquidity amount
virtualLiquidityUiAmount	PreciseDecimal	string	UI-formatted virtual liquidity

MIGRATE_METEORA_DAMM Event

Migration event from DBC to Meteora DAMM.

Property	Type	JSON Type	Description
virtualPool	string	string	Source virtual pool address
migrationMetadata	string	string	Migration metadata account
pool	string	string	Destination pool address
lpMint	string	string	LP token mint address
tokenAMint	string	string	Token A mint address
tokenBMint	string	string	Token B mint address
AVault	string	string	Token A vault address
BVault	string	string	Token B vault address
ATokenVault	string	string	Token A token vault address
BTokenVault	string	string	Token B token vault address
AlpVault	string	string	Token A LP vault address
BlPVault	string	string	Token B LP vault address

MIGRATE_METEORA_DAMM_V2 Event

Migration event from DBC to Meteora DAMM V2.

Property	Type	JSON Type	Description
virtualPool	string	string	Source virtual pool address
migrationMetadata	string	string	Migration metadata account
pool	string	string	Destination pool address
firstPositionNftMint	string	string	First position NFT mint address
firstPositionNftAccount	string	string	First position NFT account address
firstPosition	string	string	First position account address
secondPositionNftMint	string	string	Second position NFT mint address
secondPositionNftAccount	string	string	Second position NFT account address
secondPosition	string	string	Second position account address
baseMint	string	string	Base token mint address
quoteMint	string	string	Quote token mint address

Data Types

• bigint: Large integer values for token amounts and prices

• string: Text values for addresses and identifiers

• number: Numeric values for timestamps and other integer values

• boolean: True/false values for swap direction and referral indicators

• PreciseDecimal: High-precision decimal representation for UI display

• DecoderType: Enum indicating the decoder type (METEORA_DBC)

Usage

The decoder automatically determines the event type and returns the appropriate structure. All monetary values are provided in both raw (bigint) and UI-formatted (PreciseDecimal) versions for flexibility in different use cases. The DBC decoder handles dynamic bonding curve mechanics with comprehensive price tracking, fee calculation, and migration capabilities to other Meteora protocols.