CCIP v2.0.0 BurnMintTokenPoolAbstract API Reference

Summary

BurnMintTokenPoolAbstract is an abstract base contract for burn/mint-style CCIP token pools.

It provides the shared mint-on-destination implementation used by burn/mint pool variants.

All validation, rate limiting, fee handling, and routing logic is inherited from [TokenPool](/ccip/evm/api-reference/v2.0.0/token-pool).

Concrete implementations supply the source-chain burn behavior while reusing the shared mint logic implemented here.

chains/evm/contracts/pools/BurnMintTokenPoolAbstract.sol

import {BurnMintTokenPoolAbstract} from "chainlink-ccip/chains/evm/contracts/pools/BurnMintTokenPoolAbstract.sol";

Marked abstract.

Burn/mint pools follow this hierarchy:

TokenPool
   └─ BurnMintTokenPoolAbstract
        ├─ BurnMintTokenPool
        ├─ BurnFromMintTokenPool
        └─ BurnWithFromMintTokenPool

Responsibility split:

TokenPool
- OffRamp validation
- RMN checks
- Rate limiting
- Fee logic
- Pool routing
- Preflight/postflight hooks
BurnMintTokenPoolAbstract
- Shared mint logic on destination chain
Concrete implementations
- Define source-chain burn semantics (burn, burnFrom, or other variations)

Concrete contracts must implement or override:

Defined in TokenPool as abstract.

Concrete burn/mint pools implement source-chain burn semantics.

Examples:

function _releaseOrMint(
  address receiver,
  uint256 amount,
  uint64
) internal virtual override

Implements mint-on-destination logic:

IBurnMintERC20(address(i_token)).mint(receiver, amount);

Behavior:

Upstream invariants guaranteed before this function executes:

This function assumes all validation is complete.