Skip to main content

TypeScript SDK Overview

The CoW Protocol TypeScript SDK enables developers to interact with Gnosis Protocol v2 smart contracts. It allows you to:
  • Create and sign orders
  • Encode settlements
  • Manage interactions with the protocol
  • Handle order execution and validation

Installation

Core Modules

The SDK organizes functionality into four core areas:

Orders

Type-safe order creation and management with full validation

Signing

Multiple signing schemes: EIP-712, EthSign, EIP-1271, PreSign

Settlement

Trade execution encoding and clearing price management

Interactions

Pre, intra, and post-settlement contract interactions

Key Features

  • Full TypeScript support with type definitions for all interfaces, enums, and functions
  • Built on ethers.js v5 with integrated provider/signer support
  • EIP-712 domain configuration for replay attack prevention
  • Multiple balance types (ERC20, Vault External, Vault Internal)
  • Multiple order kinds (Sell, Buy, Fill-or-Kill, Partially Fillable)

Quick Example

The SDK is written in TypeScript and provides full type definitions for all interfaces, enums, and functions, ensuring IDE autocompletion and inline documentation.
Last modified on March 4, 2026