Amount of value the user got above the order's limit price denominated in the surplus token.

Creates the default [`SignatureValidating`] instance.

Polls `/pools?limit=1` every [`WAIT_UNTIL_POLL_INTERVAL`] until the envelope reports `block_number >= target_block`. Returns immediately if already th

Builds a web3 client based on the ethrpc args config.

Convert a U256 wei amount to a decimal string using the token's decimals. e.g., 1000000000000000000 with 18 decimals → "1"

Adjusts the quote fee to include arbitrary additional costs.

Returns `self` with eligible interactions internalized using the Settlement contract buffers. Currently, this internalizes all interactions with inpu

Clones self and returns an instance that captures metrics extended with the provided label.

Scales order buy amount to the specified sell amount. This allows scaling the quoted amounts to some lower sell amount accounting for fees (for quote

Set the sell amount for the order.

Creates a context for vendoring only the contract ABI for generating bindings. This is preferred over [`Vendor::full`] for contracts that do not need

The account which should be used to sign settlements for this solver.

Returns the inner pool data if it is active, `None` otherwise.

Returns a materialized valid-to value for the specified validity.

Adds slippage to the specified amount.

Registers all maintenance tasks that are necessary to correctly support CoW AMMs.

Registers all maintenance tasks that are necessary to correctly support ethflow orders.

Adds an order trade using the uniform clearing prices for sell and buy token. Fails if any used token doesn't have a price or if executed amount is im

Increase the specified amount by the constant slippage.

Returns the additional gas amount associated with a signing scheme.

Builds the query forwarded to the inner estimator, substituting the native token for an ETH side and reporting the gas adjustment that has to be appli

This function adjusts quote amounts to directly compare them with the order's limits, ensuring a meaningful comparison for potential price improvement

Adjust quote amounts to be comparable with order limits.

Restores reserve_b value from the given reserve_a and the quote. Reverse operation for the `blockchain::Pool::out` function <https://en.wikipedia.org/

The simulation requires the settlement contract to have enough buy tokens to pay out the order directly. But it's also possible that we fail to comput

PreSign orders are currently the only ones that are allowed to be placed without any balance at all. If we detect a revert of the sell token transfer

Fetch the ERC20 allowance for the spender. See the allowance method in EIP-20. https://eips.ethereum.org/EIPS/eip-20#allowance

Return the allowances in a normalized form, where there is only one allowance per [`eth::allowance::Spender`], and they're ordered deterministically.

Returns the ERC20 approvals required for executing this interaction onchain.

Returns the order swapped amount as an asset. The token associated with the asset is dependent on the side of the DEX order.

Returns (sell_amount, buy_amount).

Runs the simulation, handles errors caused by fundamental limitations of the simulation approach and returns a comprehensive report in case of an erro

Parse the `pool_indexer_api_requests` Prometheus counter for a given route from the indexer's /metrics endpoint.

Apply all the events to the given CoW AMM registry and update the internal registry

Applies `new` to the override map for `address`. If `address` already has an entry, the overrides are merged via [`merge_account_override`]. Returns

Applies the solver's gas fee override if present. When a replacement transaction is pending, the solver's values are raised to at least the replacemen

Applies slippage to the specified AMM execution.

Archives the auction body to S3 (fire and forget). The body is gzip-compressed while streaming to the solver; the compressed bytes arrive through `com

Whether auction archival to S3 is configured.

If the token is native, return the ERC20 wrapped version.

Returns the slippage as a decimal factor.

Return JIT order if it's a JIT order.

Returns the slippage as a percentage. e.g. 0.01 → 1.0.

Builds a fake order that has the expected sell and buy token but has a limit price that is trivial to achieve. We do this to avoid reverts in case the