Omega Quoter

Overview

OmegaQuoter is a stateless off-chain quoting contract that provides accurate price quotes for swaps on Algebra Integral, Uniswap V3, and Uniswap V2 protocols without executing actual trades. It simulates swap operations to determine expected output amounts, price impact, and gas estimates.

Functions

Main Execution

function execute(bytes calldata commands, bytes[] calldata inputs) 
    external 
    returns (bytes[] memory outputs)

Executes a sequence of quote commands and returns encoded results for each command.

Parameters:

• commands: Concatenated 1-byte command identifiers

• inputs: ABI-encoded parameters for each command

Returns:

• outputs: Array of ABI-encoded results (varies by command type)

Supported Commands

Algebra Integral Quotes

0x00 – INTEGRAL_SWAP_EXACT_IN

Parameters:

• uint256 amountIn

• bytes path

Returns:

• uint256 amountOut

• uint160[] sqrtPriceX96AfterList

• uint256 gasEstimate

Usage: Gets quote for exact input swap on Algebra Integral pools.

0x01 – INTEGRAL_SWAP_EXACT_OUT

Parameters:

• uint256 amountOut

• bytes path

Returns:

• uint256 amountIn

• uint160[] sqrtPriceX96AfterList

• uint256 gasEstimate

Usage: Gets quote for exact output swap on Algebra Integral pools with optional ERC4626 wrap/unwrap operations. For exactOut swaps, the path MUST use boosted encoding to specify wrap/unwrap actions.

Uniswap V3 Quotes

0x10 – UNISWAP_V3_SWAP_EXACT_IN

Parameters:

• uint256 amountIn

• bytes path

Returns:

• uint256 amountOut

• uint160[] sqrtPriceX96AfterList

• uint256 gasEstimate

0x11 – UNISWAP_V3_SWAP_EXACT_OUT

Parameters:

• uint256 amountOut

• bytes path

Returns:

• uint256 amountIn

• uint160[] sqrtPriceX96AfterList

• uint256 gasEstimate

Uniswap V2 Quotes

0x08 – V2_SWAP_EXACT_IN

Parameters:

• uint256 amountIn

• address[] path

Returns:

• uint256 amountOut

0x09 – V2_SWAP_EXACT_OUT

Parameters:

• uint256 amountOut

• address[] path

Returns:

• uint256 amountIn

ERC4626 Vault Quotes

0x07 – ERC4626_WRAP

Parameters:

• address vault

• uint256 amount

Returns:

• uint256 amountOut

Usage: Quotes the number of vault shares received when depositing assets.

0x0f – ERC4626_UNWRAP

Parameters:

• address vault

• uint256 amount

Returns:

• uint256 amountOut

Usage: Quotes the number of underlying assets received when redeeming vault shares.

Chain Execution with CONTRACT_BALANCE

The quoter supports chaining multiple operations by using CONTRACT_BALANCE (a special constant) as the amountIn parameter. When encountered, the quoter uses the output from the previous command as input to the current command.

References

• Source Code