VEKTRA RESEARCH / 04

Route discovery

Four direct V3 candidates. One reference block. Maximum raw output among responding routes.

Implemented · direct V3 only

01Candidate construction

ETH normalizes to WETH. The server queries the configured factory at fee tiers 100, 500, 3000 and 10000. Missing pools are discarded; existing pools must expose the expected token pair, factory and unlocked slot0.

Pool identity, slot0 and QuoterV2 reads are pinned to the same latest block. quoteExactInputSingle simulates exact input with no explicit sqrt-price limit, accounting for liquidity and tick crossings. Pool existence does not guarantee enough depth for an amount.

f=\mathrm{feeTier}/10^6\in\{0.0001,0.0005,0.003,0.01\}

Fee fractions correspond to 0.01%, 0.05%, 0.3% and 1%. Gas is separate.

02What best means here

Among successful candidates, the largest raw amountOut wins. Candidates share an output token, so no unit conversion is needed. Ties do not imply a unique economically superior route.

This is not a global search. There is no multihop, splitting, aggregator, cross-chain or gas-adjusted objective. An RPC failure can exclude a better candidate; availability limits the comparison set.

r^*=\underset{r\in\mathcal R_{\mathrm{successful}}}{\arg\max}\;q_r

r is a direct candidate pool, q_r its positive raw output, and the set includes only successful reads and simulations.

03Spot comparison and impact

The spot comparator uses sqrtPriceX96, raw input and token ordering with integer arithmetic. Quoter output includes fees and liquidity traversal; the spot comparator deducts no fee. Displayed impact therefore includes fee effects, not only liquidity price impact.

Execution accepts impact from −1% to 5%, inclusive. Below −1% is inconsistent and above 5% blocks. A zero spot comparator yields a defensive 100% sentinel, not a measured market impact. Negative impact is not a guaranteed arbitrage.

04Unavailable routes and wrapping

If every candidate fails, the API returns 503. HTTP, timeout, network and rate-limit patterns can produce an RPC-unavailable reason; otherwise no liquid direct route is reported. This does not prove that no route exists elsewhere.

ETH/WETH wrapping bypasses pool discovery: exact 1:1 output, fee zero, zero-address pool and WETH target. Gas applies. Quote integrity, account, freshness and chain deadline checks remain required.

05Output and timing bounds

The browser recomputes minimumOut and binds chain, symbols, addresses, fee, amount, slippage and deadline. Schema checks and local encoding reduce response tampering risk but do not establish a trusted external price.

A route may disappear and state may change after quoting. A successful quote does not guarantee inclusion or prevent a later revert.