Onchain Events

Events and public contract methods available for tracking and interacting with CoinFactory launchpad tokens.

The CoinFactory Launchpad contract emits onchain events throughout the complete token lifecycle—from creation and bonding curve trading to finalization and DEX migration.

Integrations can use these events to index launched tokens, trades, supply changes, collected liquidity, and migration status. Token addresses should always be used as the primary identifier because token names and symbols are not unique.

Lifecycle Overview

1

TokenCreated

2

Mint / Burn

3

BondFinalized

4

BondMigrated

Events

/**
 * @notice Emitted when a new bonding curve token is created.
 */
event TokenCreated( 
    address indexed token, 
    string name, 
    string symbol, 
    address indexed reserveToken, 
    string metadataUrl 
);

/**
 * @notice Emitted when tokens are purchased from the bonding curve.
 */
event Mint(
    address indexed token,
    address indexed user,
    address receiver,
    uint256 amountMinted,
    uint256 reserveAmount,
    uint256 supplyAfter,
    uint256 priceAfter,
    uint40 timestamp
);

/**
 * @notice Emitted when tokens are sold back to the bonding curve.
 */
event Burn(
    address indexed token,
    address indexed user,
    address receiver,
    uint256 amountBurned,
    uint256 refundAmount,
    uint256 supplyAfter,
    uint256 priceAfter,
    uint40 timestamp
);

/**
 * @notice Emitted when the bonding curve reaches its sale supply.
 */
event BondFinalized(
    address indexed token,
    uint256 saleSupply,
    uint256 reserveBalance,
    uint40 timestamp
);

/**
 * @notice Emitted when a finalized bonding curve is migrated to DEX liquidity.
 * @param token The address of the migrated token.
 * @param pair The address of the created liquidity pair.
 * @param tokenAmount The amount of tokens allocated to the liquidity pool.
 * @param reserveAmount The amount of reserve tokens allocated to the liquidity pool.
 * @param protocolFee The protocol fee deducted during migration.
 * @param lpAmount The amount of liquidity tokens created.
 * @param timestamp The migration timestamp.
 */
 event BondMigrated(
    address indexed token,
    address indexed pair,
    uint256 tokenAmount,
    uint256 reserveAmount,
    uint256 protocolFee,
    uint256 lpAmount,
    uint40 timestamp
);