Integration

This page is the integration reference for HODL tokens during the bonding phase. After graduation a HODL token is a standard Token-2022 token trading on Meteora DAMM v2, and nothing on this page applies to it.

Programs#

Identifying a HODL token#

HODL pools are DBC pools. Filtering by the DBC program ID alone matches every DBC pool. Use either method below.

Every launch creates its own DBC config. There is no shared HODL config to match against.

Transfer gate#

While the hook is attached to the mint, Token-2022 calls the hook on every transfer of the base token. The hook reads the transaction through the instructions sysvar, and the transfer succeeds only if one of the following holds:

Any other transfer fails with hook error 6000 UnauthorizedTransfer. The launchpad condition applies only to the instruction it is: a launchpad instruction elsewhere in the transaction does not authorize a transfer under another instruction.

The swap that completes the curve revokes the transfer hook and clears its authority. From then on the token transfers without the hook.

PDAs#

larger and smaller compare the two mints as 32-byte arrays. The extra account meta list resolves one extra account, the instructions sysvar.

Instructions#

Launchpad: create_launch#

Creates the launch's DBC config, the Token-2022 mint with the hook attached, the DBC pool, the mint's extra account meta list and the trading_fees account, then executes the opening buy. Permissionless. No Fomo signature is required.

Discriminator ef df ff 86 27 79 7f 3e

Changed 2026-09-27. Account 11 was creator_base_account, the creator's own token account, which received the opening buy. The tokens now go to recipient_wallet (11) through its token account (12), and every account after them moved down by one. The creator still pays and spends its own WSOL. Until graduation only a Fomo wallet can sell, because every curve trade needs Fomo's signature; tokens sent to any other wallet cannot be sold before the token graduates.

Arguments: CreateLaunchParams

Requirements:

• Fund and sync creator_quote_account with at least buy_amount WSOL before this instruction.
• Set a compute unit limit of at least 1,400,000.
• The creator pays about 0.0087 SOL of rent for the DBC config, which is not recoverable.
• Send the launch as a v0 transaction over the address lookup table named launchLookupTable in the cluster's manifest (mainnet: GdMdweWebDuHJi4ipAYpUGJM14zr51LeyvyukmCv9LbB). It holds the eleven accounts common to every launch: global_config, pool_authority, quote_mint, dbc_event_authority, dbc_program, hook_program, instructions_sysvar, token_base_program, token_quote_program, associated_token_program, system_program. The largest launch the program accepts (a 32 character name, a 10 character symbol, a 200 character uri, a separate recipient_wallet) is 1,183 bytes this way.
• This used to say a legacy transaction was enough for up to three or four fee recipients. That was wrong. It was counted with an empty uri. A real metadata URL and a separate recipient_wallet with a single recipient came to 1,241 bytes, over the 1,232 byte limit, and the site's launches failed until they moved to v0.

Launchpad: claim_fees#

Claims the launch's accrued DBC trading fees into trading_fees and pays them out in the same transaction: HODL's share to the HODL fee wallet and the remainder to the launch's recipients by share_bps, the last recipient receiving any rounding remainder. Payouts are in SOL. Permissionless: any wallet may crank it and pays only the transaction fee, since the temporary token accounts are closed and their rent returned to it.

Discriminator 52 fb e9 9c 0c 34 b8 ca

Remaining accounts, writable, in order:

No arguments. Claims apply to fees accrued on the bonding curve. Fees accrued after graduation belong to the DAMM v2 position and are claimed with claim_graduated_fees.

Launchpad: claim_graduated_fees#

Claims a graduated launch's fees from its DAMM v2 position and pays them out with the same split as claim_fees. At migration DBC gives the whole position, permanently locked, to trading_fees; the lock prevents withdrawing liquidity, not claiming fees. The migrated pool collects fees in SOL only (DAMM v2 OnlyB, token B being the quote mint), so the claim is SOL and the base account receives nothing. HODL's share is computed from the pool's own protocol_fee_percent. Permissionless, with the temporary token accounts closed and their rent returned to the cranker.

Discriminator d9 fc e2 00 bb 0a ed a3

Remaining accounts are the same as for claim_fees. No arguments. position_nft_mint is the first position NFT mint passed to migration_damm_v2.

DBC: swap2_with_transfer_hook (Fomo)#

Buys and sells on the bonding curve are DBC swaps executed by Fomo. The swap itself carries no Fomo account. The Fomo signer authorizes the transfer by being a signer account of another top-level instruction in the same transaction, for example the funding account of the trader's idempotent associated token account creation (see Transfer gate).

Discriminator b7 5d 99 28 18 e6 c2 97

Remaining accounts, in order:

Arguments

DBC permits exactly one remaining account ahead of the declared slices, and it must be the instructions sysvar at index 0.

DBC: migration_damm_v2#

Migrates a completed curve to DAMM v2. Permissionless and executed by Meteora's keeper on mainnet. Pass A8gMrEPJkacWkcb3DGwtJwTe16HktSEfvwtuDh2MCtck as remaining account 0. The migrated liquidity is permanently locked to the launch's trading_fees account. The migrated pool charges the launch's trading_fee_bps.

Launchpad: administrative#

initialize_global_config and update_global_config are signed by the launchpad admin and are not used by integrations. update_global_config sets, among others, minimum_opening_buy_lamports, which must be above 0.

Hook#

initialize_extra_account_meta_list is called by create_launch. execute is called by Token-2022 on each transfer. Neither is called directly.

Account layouts#

All HODL accounts are Anchor accounts serialized with Borsh: an 8-byte discriminator followed by the fields in order, without padding.

GlobalConfig#

Discriminator 95 08 9c ca a0 fc b0 d9, size 561 bytes, Borsh.

TradingFees#

Discriminator 43 f2 ce 1c 9b 83 9f 8d, size 213 bytes, Borsh.

LaunchTier (89 bytes)#

CurvePoint (32 bytes)#

FeeRecipient (34 bytes)#

Errors#

Launchpad errors#

Hook errors#

DBC errors specific to hooked pools#