Skip to main content

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.