Skip to main content

evm_amm_search/
lib.rs

1//! Graph-based route and cycle search for [`evm-amm-state`](evm_amm_state).
2//!
3//! This crate does not discover, cold-start, or synchronize pools. Those jobs
4//! remain with `evm-amm-state`. `evm-amm-search` takes an already-populated
5//! [`AdapterRegistry`](evm_amm_state::adapters::AdapterRegistry), builds a token
6//! graph from its ready pool metadata, and evaluates candidate routes by calling
7//! each pool adapter's canonical `simulate_swap`.
8
9mod demo_router;
10mod graph;
11mod liquidity;
12#[cfg(feature = "live-runtime")]
13mod live_graph;
14#[cfg(feature = "live-runtime")]
15mod live_routes;
16mod overlay_cache;
17mod search;
18
19pub use demo_router::{
20    DEMO_ROUTER, DemoRouterConfig, DemoRouterHop, GenericExecution, SwapGasEstimate,
21    demo_router_hops_for_quote, demo_router_runtime, encode_demo_router_execute_calldata,
22    encode_demo_router_execute_from_calldata, install_demo_router, simulate_gas_hops,
23    simulate_route_gas, simulate_route_prefix_gas,
24};
25#[cfg(feature = "live-runtime")]
26pub use demo_router::{
27    prewarm_demo_router_token_transfer, simulate_versioned_route_gas,
28    simulate_versioned_route_gas_with_balance_mappings,
29};
30pub use graph::{
31    AmmGraph, EdgeData, GraphBuildOptions, GraphBuildReport, GraphBuildSummary, GraphPoolMutation,
32    GraphVersion, SkippedPool, SkippedPoolReason, StableAmmDiGraph,
33};
34pub use liquidity::{
35    BalanceState, LiquidityIndexScope, LiquidityPruneStats, LiquidityPruningConfig,
36    PoolLiquidityBuildReport, PoolLiquidityError, PoolLiquidityIndex, PoolLiquidityMutationReport,
37    PoolLiquidityRefreshFailure, PoolLiquidityRefreshReport, PoolLiquidityTracker,
38    TransferApplyReport, TransferEventSource,
39};
40#[cfg(feature = "live-runtime")]
41pub use live_graph::{
42    GraphDelta, GraphPoolDelta, GraphTopologyImpact, IndexedPool, LiveAmmGraph, LiveGraphError,
43};
44#[cfg(feature = "live-runtime")]
45pub use live_routes::{
46    LiveRouteObserver, LiveRouteObserverError, LiveRouteRuntime, LiveRouteRuntimeConfig,
47    LiveRouteRuntimeError, LiveRouteRuntimeEvent, LiveRouteRuntimeEventKind,
48    LiveRouteRuntimeFailure, LiveRouteRuntimeHandle, LiveRouteSubscription, RouteCancellationToken,
49    RouteInvalidationReason, RouteJobStamp, RouteProvenance, RouteSearchFailure, RouteSearchJobId,
50    RouteSearchTrigger, RouteSubscriptionId, RouteSubscriptionSnapshot, RouteSubscriptionSpec,
51    RouteSubscriptionState, VersionedRouteQuote,
52};
53#[cfg(feature = "live-runtime")]
54pub use search::LiveSearchView;
55pub use search::{
56    AdaptiveEdgeShortlistConfig, AffectedPools, AmmSearcher, BatchSearchReport, CycleQuote,
57    CycleRequest, FastLaneConfig, HeuristicSearchConfig, Hop, HopQuote,
58    IncrementalRouteUpdateReport, IncrementalRouteUpdateStatus, ParallelSearchConfig, PathFailure,
59    QuoteCacheStats, RecomputeReason, RoutePath, RouteQuote, RouteRequest, RouteSearchEvent,
60    RouteSearchPhase, RouteSearchProgress, RouteSearchSession, RouteUpdateEvent, SearchConfig,
61    SearchControl, SearchError, SearchFinality, SearchMode, StreamedRouteStatus,
62    StreamingCompletion, StreamingPhaseStats, StreamingSearchConfig, StreamingSearchReport,
63    StreamingThresholdMode, StreamingThresholdPolicy, UpperBoundPruningConfig,
64};