Skip to content

Ekubo v3.3

Choose a tag to compare

View all tags
@moodysalem moodysalem released this 13 Sep 02:42
v3.3.0
944b488
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Ekubo v3.3.0

This release adds per-pool owner fee sharing to SignedExclusiveSwap, retains its timestamp-gated LP fee donation model, and fixes exact-output input overflow. It also includes the STONX configuration and deployment-record changes since v3.2.0.

SignedExclusiveSwap

  • Added an owner-controlled share of each signed swap fee, set initially through initializePool(PoolKey,int32,ControllerAddress,uint64) and updated per pool with setOwnerFee(PoolKey,uint64).
  • Packed the Q0.64 owner-share rate into the existing pool-state word, avoiding an additional state read during swaps.
  • Added owner-only fee withdrawals. Owner shares round up using computeFee, are saved separately under salt zero for each ordered token pair, and leave the swapper's total fee unchanged. The remainder enters the pool's deferred LP-fee balance.
  • Fixed exact-output fee addition: the total input including the signed fee must fit int128, otherwise the swap reverts.
  • Retained timestamp-gated LP fee donation, including on position updates and fee collection. The proposed same-timestamp lifecycle flush was reverted after review: it does not provide exact attribution across swaps, while the controller has an arbitrage incentive to leave the pool at the correct end-of-block price. This is an economic expectation rather than an enforced invariant. Liquidity changes before donation can affect who receives pending fees, and donations with zero active liquidity are burned. Perfect attribution throughout the swap path requires a Core change.

Integration change: SignedExclusiveSwap initialization now requires the owner-share argument. Pass zero to configure no owner share. Update integrations that construct or decode the packed pool state to use the new owner-fee field.

STONX configuration

  • Replaced the standalone Ve33EmissionRateScheduler with direct funding and scheduling through Ve33Periphery; removed the scheduler contract, packed configuration type, and associated tests.
  • Updated the configuration script to schedule the exact 333,333 STONX allocation with buffered, valid timestamps targeting approximately 100 days, and print the effective schedule and emission rate.
  • Added launch-liquidity checks against hostile permissionless pool initialization, required a pre-funded deployer, retained an initial zero voted fee, and transferred remaining deployer STONX and token ownership to governance.
  • The scheduling transaction must be mined before its printed start timestamp; see PR #367 for the operational precondition and review history.

Deployment records and documentation

  • Added and refreshed multi-chain deployment broadcast artifacts.
  • Corrected the SignedExclusiveSwap integration guide and documented the accepted deferred-fee attribution behavior.
  • Deployment addresses and chain support remain documented in EVM Contracts (V3). Publishing this source release does not deploy or upgrade existing immutable contracts.

Review and validation

  • PR #373
  • V12 review: exact-output overflow fixed; deferred LP-fee attribution acknowledged.
  • Foundry v1.5.1: full forge snapshot --offline passed with 981 tests and zero failures.
  • Formatting and complexity lint passed locally; PR CI passed formatting, build, deployment simulation, tests, gas-snapshot checks, and Halmos.

Full changelog: v3.2.0...v3.3.0

Assets 2
Loading