Skip to main content

​
Creating Orders

​
Key Concepts

Programmatic orders in ComposableCoW rely on the ConditionalOrderParams struct, which incorporates three essential components:
  1. A handler contract specifying the order type
  2. A unique salt identifier
  3. ABI-encoded order parameters (staticInput)
The combination of handler, salt, and staticInput must be unique for each order. This ensures each order has a distinct identifier through hashing these three elements together.

​
Core Order Structure

The framework supports multiple handler types:

​
Implementation Steps

The process involves four main phases:

​
1. Parameter Definition

Configure order-specific data based on your chosen handler type.

​
2. Struct Creation

Wrap parameters in ConditionalOrderParams with a unique salt.

​
3. Token Approval

Authorize the vault relayer (0xC92E8bdf79f0507f65a392b0ab4667716BFE0110) to access required tokens.

​
4. Order Submission

Execute the creation through ComposableCoW.create() from a Safe contract.

​
Advanced Features

  • createWithContext: Store on-chain values via value factories during order creation
  • Batch operations: Bundle multiple order creations together using MultiSend
  • Verification: Confirm successful order creation through the singleOrders mapping
Last modified on March 12, 2026