Ekubo v3

[die-herdplatte]

This PR integrates Ekubo V3.

Changes to this integration from a technical perspective in comparison to v2:

• Many contract interfaces were changed to save gas
• Addition of the new stableswap pool type
• We now fetch pool keys once from a subgraph and then switch over to event-based pool creations

---

Note

Medium Risk
Large addition of new pricing/math and event-driven pool state logic that can affect quote correctness and runtime performance, though it is mostly additive and isolated behind a new EkuboV3 dex key.

Overview
Adds a full new EkuboV3 DEX integration (Mainnet + Arbitrum) including contract ABIs, network/config wiring, and a new EkuboV3 exchange implementation that produces quotes and builds router calldata via swapAllowPartialFill.

Introduces an EkuboV3PoolManager that bootstraps pool keys from a subgraph and then subscribes to on-chain logs to create/update/rollback pools on PoolInitialized and other events, with support for multiple pool/extension types (concentrated, stableswap/full-range, oracle, MEV-capture, TWAMM).

Adds substantial new pool state/quoting + math modules (ticks, sqrt ratios, swap steps, TVL) and a comprehensive test suite (unit, integration, events, e2e) to validate quoting accuracy against on-chain router quote and event-driven state updates; also bumps package version and upgrades jest/@types/jest dev deps.

^{Written by Cursor Bugbot for commit 6c9d387. This will update automatically on new commits. Configure here.}

[die-herdplatte]

There's one failing test for Arbitrum:

  ● Arbitrum One › BUY › swapExactAmountOut › ETH -> USDC

    expect(received).toBeLessThanOrEqual(expected)

    Expected: <= 10n
    Received:    333888393845427n

      314 |   const paraswapShare = decodedOutput.paraswapShare?.toNumber() ?? 0;
      315 |
    > 316 |   expect(amountDiff.toBigInt()).toBeLessThanOrEqual(10n); // 10 wei max allowed difference
          |                                 ^
      317 |   expect(paraswapShare).toEqual(0);
      318 | }
      319 |

      at testE2E (tests/utils-e2e.ts:316:33)

but the calculated srcAmount and the simulated calculated amount are exactly the same.
The shown difference is the exact difference between the approved and the used amount though, so decodedOutput.spentAmount may actually track the approved, not the spent, value.

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[cursor]

Subgraph query lacks pagination, silently truncates pool results

High Severity

The subgraph query for poolInitializations has no first parameter. The Graph API defaults to returning at most 100 results. For an active DEX with more than 100 initialized pools, the query silently omits pools beyond this limit, causing the integration to operate with an incomplete pool set and miss potential swap routes.