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 and What Is a Chainflip Broker?. Where an entry says what Broker as a Service requires or defaults to, it describes the REST /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). A deposit channel can be used more than once while it is open (Chainflip: Vault Swaps).
Broker as a Service opens a new channel for each /swap call and returns issuedBlock, network, channelId and sourceExpiryBlock (Starting a Swap); the swap status exposes sourceChainExpiryBlock, estimatedExpiryTime and isExpired (Get Swap Status).
See also: vault swap, retry duration, 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).
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).
See also: deposit channel, minimum price, 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); the total broker fee is the broker commission plus all affiliate fees (Chainflip: 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; Pricing). In a swap status, depositChannel.brokerCommissionBps is the operating fee, and your commission is an entry in affiliateBrokers (Get Swap Status).
See also: affiliate, What Is a Chainflip Broker?.
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). A deposit-channel request can carry up to 5 affiliate entries, each with its own rate (Chainflip: 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; migration guide). /swap accepts up to four extra affiliates, affiliate1 to affiliate4, each with its own commission (Starting a Swap).
See also: 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). If a boosted swap is refunded, the Boost fee is not refunded (Chainflip: 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). Quotes for Bitcoin swaps include a boostQuote with the estimated and maximum Boost fee (Asking for a Quote).
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.
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).
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; Asking for a Quote).
See also: minimum price, 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).
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; Vault Swap Transaction Payloads; AI Documentation (MCP)). Quotes return estimatedPrice and recommendedSlippageTolerancePercent to calculate it (Asking for a Quote).
See also: retry duration, 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).
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; Asking for a Quote).
See also: minimum price, 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).
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; Vault Swap Transaction Payloads).
See also: minimum price, retry duration.
Sources
All sources were accessed on 2026-11-18.
- Chainflip, Deposit Channel Swaps: deposit channels.
- Chainflip, Vault Swaps: vault swaps and deposit-channel reuse.
- Chainflip, Brokers: broker fees and the 1000 bps limit.
- Chainflip, Broker Affiliates: affiliates.
- Chainflip, Broker API requests: affiliate entries and the total broker fee.
- Chainflip, Boost: Boost pools and the fallback without enough collateral.
- Chainflip, Swapping Basics: minimum price, retry duration, refunds, DCA and Boost fees on refund.
- Broker as a Service: Starting a Swap, Asking for a Quote, Get Swap Status, Vault Swap Transaction Payloads, Pricing, Register Account, AI Documentation (MCP).