Skip to main content

Settlement

The Settlement module provides utilities for encoding settlements, managing trades, and building settlement transactions within CoW Protocol.

SettlementEncoder Class

The primary tool for building settlement calldata. It manages order encoding, trade signatures, interactions, and clearing price calculations.

Constructor

Methods

encodeTrade

Converts a signed order into a settlement trade.

signEncodeTrade

Signs an order and encodes it simultaneously.

encodeInteraction

Adds interactions at specific execution stages.

encodedSettlement

Returns complete settlement parameters as a tuple.

clearingPrices

Converts a price map into an array aligned with the token registry.

TokenRegistry Class

Tracks tokens by maintaining indexed references. Tokens in settlements are referenced by index rather than address to optimize calldata and gas costs.

InteractionStage

TradeExecution

EncodedSettlement

Example

Last modified on March 4, 2026