​

Core Libraries

​

GPv2Order

​

Data Structure

struct Data {
    IERC20 sellToken;
    IERC20 buyToken;
    address receiver;
    uint256 sellAmount;
    uint256 buyAmount;
    uint32 validTo;
    bytes32 appData;
    uint256 feeAmount;
    bytes32 kind;
    bool partiallyFillable;
    bytes32 sellTokenBalance;
    bytes32 buyTokenBalance;
}

​

Key Functions

• hash(Data memory order) - Computes EIP-712 digest for signing
• actualReceiver(Data memory order) - Resolves recipient address (handles zero-address as owner)
• packOrderUidParams() - Encodes 56-byte UID (32-byte digest + 20-byte owner + 4-byte timestamp)
• extractOrderUidParams() - Decodes UID components

​

Pre-computed Constants

bytes32 constant KIND_SELL = keccak256("sell");
bytes32 constant KIND_BUY = keccak256("buy");
bytes32 constant BALANCE_ERC20 = keccak256("erc20");
bytes32 constant BALANCE_EXTERNAL = keccak256("external");
bytes32 constant BALANCE_INTERNAL = keccak256("internal");

​

GPv2Trade

​

Flag Encoding

​

Key Functions

• extractOrder() - Converts trade data into a full order struct
• extractFlags() - Unpacks flags into separate order parameters

​

GPv2Interaction

​

Data Structure

struct Data {
    address target;
    uint256 value;
    bytes callData;
}

​

Key Functions

• execute(Data calldata interaction) - Performs the contract interaction
• selector(Data calldata interaction) - Extracts 4-byte function selector

​

Settlement Phases

1. Pre-settlement - Setup operations like approvals
2. Intra-settlement - Liquidity transformations after input transfers
3. Post-settlement - Cleanup tasks like token unwrapping

​

GPv2Signing

​

Key Features

• Careful memory management to avoid unnecessary copies
• Extensive use of calldata instead of memory for read-only data
• Domain separator includes contract address for replay protection
• Pre-computed hash constants for common types