CowSwap Settlement Simulator

WHAT IT DOES

CowSwap Settlement Simulator provides read-only access to GPv2 settlement contract state on EVM-compatible blockchains. It simulates settlement execution by reading current contract state, order status, filled amounts, pre-signatures, vault balances, and auction data. The tool reads settlement contract state, token balances, allowances, order data, trade history, gas price, chain ID, block timestamp, solver data, auction state, GPv2 contract state, native token wrapper address, and settlement logs. All data is read directly from the chain through your connected provider — no funds are ever at risk.

HOW TO USE

Connect your EVM-compatible wallet (MetaMask, WalletConnect, or similar) to establish a provider connection. Select the network that matches the GPv2 settlement contract you wish to inspect (Ethereum Mainnet, Gnosis Chain, or other supported networks). Paste the settlement contract address — the tool does not hardcode any address, giving you full flexibility to inspect official CowSwap deployments or fork contracts. Optionally enter an order ID or order hash to check specific order status. Specify a block range to scan for settlement events, or use "latest" for current state. Click "Simulate settlement" to fetch and display the current settlement state, including domain separator, vault address, order fill status, and pre-signature information. The tool shows progress as it reads contract state and validates the settlement configuration.

HOW IT WORKS UNDER THE HOOD

The tool uses a multi-step read strategy to assemble a complete settlement simulation. First, it connects to the provider and validates the contract address. It then reads the domain separator and vault address from the GPv2 settlement contract. If an order ID is provided, the tool reads the filled amount and pre-signature status for that specific order using the appropriate view functions. The tool also attempts to read vault balances for the connected wallet if available. For settlement logs, the tool scans the specified block range using eth_getLogs with automatic chunking — if the provider rejects a large range, the tool halves the chunk size and retries, preventing the scan from failing on public RPCs with strict block range limits. The tool displays all results in a clear, readable format with status tags for order verification.

WHAT IT CANNOT SEE

The tool cannot verify that the simulated settlement will match the actual on-chain settlement due to mempool changes, solver behavior changes, or auction timing shifts; it reads current state but cannot predict future state changes. It cannot detect if the settlement will be frontrun or MEV-extracted; the tool simulates settlement execution but does not monitor mempool activity. It cannot guarantee that the solver will include the user's order in the next batch; order inclusion depends on solver selection and auction dynamics. It cannot verify that the quoted price will match the final settlement price due to order book dynamics; the tool reads the current state but cannot predict clearing prices. It cannot predict which solver will win the auction or at what clearing price; solver selection is determined by the off-chain auction mechanism.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchains (Ethereum, Gnosis Chain, and similar). It does not support non-EVM chains. The tool is read-only — it never signs transactions or moves funds. Always verify the settlement contract address against official CowSwap documentation before use. The tool is provided as-is with no warranty of any kind.