diff --git a/docs/multi-hop-routing.md b/docs/multi-hop-routing.md new file mode 100644 index 0000000..f6ba743 --- /dev/null +++ b/docs/multi-hop-routing.md @@ -0,0 +1,14 @@ +# Multi-hop route discovery + +StableRoute discovers indirect paths when no direct pair exists between +source and destination assets. The engine walks the registered pair graph +to find feasible hops while respecting per-pair fees and liquidity ceilings. + +Operational notes: + +1. Register intermediate pairs before expecting multi-hop quotes. +2. Each hop applies its own `feeBps` and amount bounds. +3. Failed discovery returns `404 not_found` rather than a partial quote. + +Implementation lives in the quote handler within `src/index.ts`; extend +`docs/pricing.md` when changing hop selection heuristics.