# Chainflip and Cross-Chain Swap Glossary

These are the terms used across Chainflip and Broker as a Service documentation. Each entry links its primary source and the BaaS page that uses it. This is a descriptive glossary, not a substitute for the API reference: the feature pages document each parameter.

For the bigger picture, see [How Cross-Chain Swaps Work](https://docs.chainflip-broker.io/reference/cross-chain-swaps/) and [What Is a Chainflip Broker?](https://docs.chainflip-broker.io/reference/chainflip-brokers/). Where an entry says what Broker as a Service requires or defaults to, it describes the REST [`/swap`](https://docs.chainflip-broker.io/features/start-swap/) endpoint unless it names another one.

## Deposit channel

A Chainflip address reserved for a swap request. A broker opens it on the State Chain with the destination address and swap parameters; the user sends the source asset to the address, and validators witness the deposit. The channel has an expiry block and remains open until that block; Chainflip advises opening a new channel and depositing immediately for each swap ([Chainflip: Deposit Channel Swaps](https://docs.chainflip.io/brokers/broker-deposit-channels-swaps)). A deposit channel can be used more than once while it is open ([Chainflip: Vault Swaps](https://docs.chainflip.io/brokers/broker-vault-swaps)).

Broker as a Service opens a new channel for each `/swap` call and returns `issuedBlock`, `network`, `channelId` and `sourceExpiryBlock` ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/)); the swap status exposes `sourceChainExpiryBlock`, `estimatedExpiryTime` and `isExpired` ([Get Swap Status](https://docs.chainflip-broker.io/features/get-status/)).

See also: [vault swap](https://docs.chainflip-broker.io/reference/glossary/#vault-swap), [retry duration](https://docs.chainflip-broker.io/reference/glossary/#retry-duration), [refund address](https://docs.chainflip-broker.io/reference/glossary/#refund-address).

## Vault swap

A swap that sends the source asset directly to a Chainflip vault, or calls the vault contract or program, with the swap parameters encoded in the transaction, instead of using a deposit channel. A vault swap transaction is single-use, is more complex to build than a transfer to a deposit channel, and has chain-specific limitations ([Chainflip: Vault Swaps](https://docs.chainflip.io/brokers/broker-vault-swaps)).

Broker as a Service returns unsigned vault swap payloads for Bitcoin, EVM chains, Solana and Tron, which your application or wallet signs and submits ([Vault Swap Transaction Payloads](https://docs.chainflip-broker.io/features/tx-payload/)).

See also: [deposit channel](https://docs.chainflip-broker.io/reference/glossary/#deposit-channel), [minimum price](https://docs.chainflip-broker.io/reference/glossary/#minimum-price), [refund address](https://docs.chainflip-broker.io/reference/glossary/#refund-address).

## Broker fee

The commission a broker charges for routing a swap, in basis points (1 bps = 0.01%). Chainflip limits the broker commission (`broker_commission`) to 1000 bps, or 10% ([Chainflip: Brokers](https://docs.chainflip.io/brokers)); the total broker fee is the broker commission plus all affiliate fees ([Chainflip: Broker API requests](https://docs.chainflip.io/brokers/broker-api/requests)).

In Broker as a Service, the broker fee a quote reports in `includedFees` is your commission plus the 5 bps operating fee ([Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/); [Pricing](https://docs.chainflip-broker.io/resources/pricing/)). In a swap status, `depositChannel.brokerCommissionBps` is the operating fee, and your commission is an entry in `affiliateBrokers` ([Get Swap Status](https://docs.chainflip-broker.io/features/get-status/)).

See also: [affiliate](https://docs.chainflip-broker.io/reference/glossary/#affiliate), [What Is a Chainflip Broker?](https://docs.chainflip-broker.io/reference/chainflip-brokers/).

## Affiliate

A service provider that offers swaps through a broker and shares the broker's commission. Chainflip affiliates are registered on-chain with an Ethereum withdrawal address for their earned commission, and a broker can have up to 256 affiliates registered at once ([Chainflip: Broker Affiliates](https://docs.chainflip.io/brokers/broker-affiliates)). A deposit-channel request can carry up to 5 affiliate entries, each with its own rate ([Chainflip: Broker API requests](https://docs.chainflip.io/brokers/broker-api/requests)).

In Broker as a Service, signup registers an affiliate of the Broker as a Service broker for you, paying out to the Ethereum address you register; your commission is credited to that affiliate account ([Register Account](https://docs.chainflip-broker.io/register/register-account/); [migration guide](https://docs.chainflip-broker.io/features/migration/)). `/swap` accepts up to four extra affiliates, `affiliate1` to `affiliate4`, each with its own commission ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#extra-affiliates)).

See also: [broker fee](https://docs.chainflip-broker.io/reference/glossary/#broker-fee).

## Boost

A Chainflip feature that lets a deposit be credited early, against collateral in Boost pools, so the swap completes sooner, for a fee. If there is not enough collateral in the Boost pools, the deposit is witnessed with regular block confirmations and no Boost fee is applied ([Chainflip: Boost](https://docs.chainflip.io/protocol/boost)). If a boosted swap is refunded, the Boost fee is not refunded ([Chainflip: Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics)).

Broker as a Service offers Boost for Bitcoin deposits: `boostFee` is the maximum accepted Boost fee in basis points, between `0` and `100` ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#boost)). Quotes for Bitcoin swaps include a `boostQuote` with the estimated and maximum Boost fee ([Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/#boost)).

Boost liquidity sits in pools, each with its own fee tier. `boostFee` is a ceiling: the deposit is boosted at the lowest tier that can fill it, and a ceiling below every tier means no boost. When checked on 18 November 2026 with Chainflip's `cf_boost_pools_depth` RPC, mainnet had a single Boost pool, for BTC at 5 bps, so a boosted deposit paid 5 bps, whether `boostFee` was `5` or `30`. Pools change over time: the quote's `boostQuote` (`estimatedBoostFeeBps`, `maxBoostFeeBps`) gives the current values.

See also: [DCA](https://docs.chainflip-broker.io/reference/glossary/#dca).

## DCA

Dollar-cost averaging (DCA) splits a swap into chunks executed one after another, each checked against the minimum price. Chainflip sets a minimum amount per chunk and may reduce the number of chunks to respect it ([Chainflip: Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics)).

Broker as a Service takes `numberOfChunks` and `chunkIntervalBlocks`, the delay between chunks in State Chain blocks of 6 seconds; `chunkIntervalBlocks` requires `numberOfChunks`. Quotes return suggested DCA parameters ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#dca); [Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/#dca)).

See also: [minimum price](https://docs.chainflip-broker.io/reference/glossary/#minimum-price), [retry duration](https://docs.chainflip-broker.io/reference/glossary/#retry-duration).

## Minimum price

The lowest price, in destination units per source unit, at which a swap may execute. Chainflip only swaps if the available liquidity gives at least that price; otherwise it retries until the retry duration ends and then refunds the deposit to the refund address ([Chainflip: Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics)).

Broker as a Service requires `minimumPrice`, in human-readable form, on `/swap` and on the EVM, Solana and Tron vault swap payloads. The MCP `start_swap` and `start_dca_swap` tools make it optional and derive it from current pool prices with a 2% tolerance when it is omitted. The Bitcoin vault swap payload takes `destinationMinimumAmount`, a minimum output amount in native units, instead ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#slippage-protection); [Vault Swap Transaction Payloads](https://docs.chainflip-broker.io/features/tx-payload/); [AI Documentation (MCP)](https://docs.chainflip-broker.io/resources/ai-documentation/)). Quotes return `estimatedPrice` and `recommendedSlippageTolerancePercent` to calculate it ([Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/)).

See also: [retry duration](https://docs.chainflip-broker.io/reference/glossary/#retry-duration), [refund address](https://docs.chainflip-broker.io/reference/glossary/#refund-address).

## Retry duration

The window, in State Chain blocks of about 6 seconds, during which Chainflip retries a swap that has not met its minimum price before refunding the deposit ([Chainflip: Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics)).

On `/swap`, `retryDurationInBlocks` is optional: omitted or negative, it is `150` blocks (15 minutes), and a value above Chainflip's current runtime limit is lowered to that limit. The MCP start tools always use `150`. Quotes return `recommendedRetryDurationInBlocks`: `300` when BTC is on either side of the swap and `50` otherwise ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#slippage-protection); [Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/)).

See also: [minimum price](https://docs.chainflip-broker.io/reference/glossary/#minimum-price), [refund address](https://docs.chainflip-broker.io/reference/glossary/#refund-address).

## Refund address

The address on the source chain where Chainflip returns the deposited asset if the swap cannot meet its minimum price within the retry duration. In a DCA swap that stops part way, the chunks already swapped go to the destination address and the unswapped remainder goes to the refund address ([Chainflip: Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics)).

Broker as a Service requires `refundAddress` on `/swap` and on the EVM, Solana and Tron vault swap payloads, and checks that it is a valid address on the source chain. The Bitcoin vault swap payload does not take one: the change output of the Bitcoin transaction is the refund address ([Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/#slippage-protection); [Vault Swap Transaction Payloads](https://docs.chainflip-broker.io/features/tx-payload/)).

See also: [minimum price](https://docs.chainflip-broker.io/reference/glossary/#minimum-price), [retry duration](https://docs.chainflip-broker.io/reference/glossary/#retry-duration).

## Sources

All sources were accessed on 2026-11-18.

* Chainflip, [Deposit Channel Swaps](https://docs.chainflip.io/brokers/broker-deposit-channels-swaps): deposit channels.
* Chainflip, [Vault Swaps](https://docs.chainflip.io/brokers/broker-vault-swaps): vault swaps and deposit-channel reuse.
* Chainflip, [Brokers](https://docs.chainflip.io/brokers): broker fees and the 1000 bps limit.
* Chainflip, [Broker Affiliates](https://docs.chainflip.io/brokers/broker-affiliates): affiliates.
* Chainflip, [Broker API requests](https://docs.chainflip.io/brokers/broker-api/requests): affiliate entries and the total broker fee.
* Chainflip, [Boost](https://docs.chainflip.io/protocol/boost): Boost pools and the fallback without enough collateral.
* Chainflip, [Swapping Basics](https://docs.chainflip.io/protocol/swapping-basics): minimum price, retry duration, refunds, DCA and Boost fees on refund.
* Broker as a Service: [Starting a Swap](https://docs.chainflip-broker.io/features/start-swap/), [Asking for a Quote](https://docs.chainflip-broker.io/features/ask-quote/), [Get Swap Status](https://docs.chainflip-broker.io/features/get-status/), [Vault Swap Transaction Payloads](https://docs.chainflip-broker.io/features/tx-payload/), [Pricing](https://docs.chainflip-broker.io/resources/pricing/), [Register Account](https://docs.chainflip-broker.io/register/register-account/), [AI Documentation (MCP)](https://docs.chainflip-broker.io/resources/ai-documentation/).
