Skip to main content

Aqueducta

Aqueducta is a deterministic quote router for the Movement L1 ecosystem.

Its job is straightforward:

  • discover supported Movement DEX liquidity
  • build reproducible route candidates from a fixed chain snapshot
  • return a best route or ranked alternatives for an exact-in swap request
  • produce execution-ready route hints for the on-chain router path
    • with router_v3 as the intended public execution target

What Aqueducta Solves​

Wallets, trading apps, and integrations need a quote layer they can trust.

Aqueducta is designed to provide:

  • deterministic route ordering for the same request on the same snapshot_id
  • clear route quality and fallback diagnostics
  • Movement-native DEX coverage through one API surface
  • a clean separation between quote generation and on-chain execution

Current Scope​

Aqueducta currently focuses on:

  • exact-in quoting
  • single-route selection
  • Movement L1 liquidity
  • deterministic ranked alternatives

Integrated DEX coverage today:

  • yuzu
  • mosaic
  • meridian
  • warpgate

Product Surface​

For integrators, the main API surfaces are:

  • POST /v1/quote
    • returns the best route only
  • POST /v1/routes
    • returns ranked alternatives
  • GET /v1/status
    • exposes snapshot age, coverage, and route-cache health

Routing modes:

  • fast
    • lowest-latency best-route search
  • balanced
    • broader ranked alternatives
  • best_price
    • widest search budget, intended for slower power-user requests

Determinism Contract​

Aqueducta’s core guarantee is:

same request + same snapshot_id => same ranked output

That determinism is what makes the router useful for:

  • wallet previews
  • quote verification
  • route caching
  • execution handoff
  • production monitoring and regression gates

What Aqueducta Is Not Yet​

This milestone does not yet include:

  • split routing
  • exact-out quoting
  • cross-chain routing
  • a public execution product surface for end users

The current priority is a correct, fast, deterministic quote layer.

Next Docs​