How do aggregator swaps work?

Aggregator swaps work by routing transactions through external on-chain swap providers rather than using Rhino's own liquidity. Here's how they function:

Technical Implementation

When getting a quote for an aggregator swap, the system returns an additional field isAtomicSwap: true indicating that external aggregators are being used. This requires calling the swap function on the SameChainSwaps contract rather than the regular bridge contract flow.

Failure Handling

Aggregator swaps can fail due to market volatility and other external factors. When they fail, the system retries a few times and if it still fails, automatically refunds the user on the source chain. This shows up in bridge history as the SWAP_FAILED_REFUNDED state.

Limitations

Aggregator swaps are much less reliable than Rhino's own liquidity swaps and follow standard market rates with potential slippage. They're also more complex to support for SDAs, requiring additional development work.