How Ferry works
Ferry moves a Bitcoin-backed loan from Aave on Ethereum to a fixed-rate MUSD loan on Mezo. A solver fronts the money for both legs, so you don't need cash to repay Aave first, and you don't need gas on Mezo.
The flow
- You sign a migration intent (EIP-712) and a permit for your aWBTC on Sepolia. You sign Mezo's own OpenTrove message on Mezo testnet with the exact BTC and MUSD amounts.
- The solver checks your signatures, your Aave position, Mezo's Recovery Mode, your future collateral ratio and its own inventory, then simulates both legs.
- Sepolia:
FerryEscrow.executeEthLegrepays your Aave debt on your behalf with the solver's USDC, pulls your aWBTC with the permit, withdraws the WBTC and holds it in escrow. It reverts unless your Aave debt reaches zero. - Mezo:
FerryMezo.executeMezoLegsends the solver's BTC intoBorrowerOperationsSignatures.openTroveWithSignature. The trove opens in your address. The minted MUSD goes to the solver, and FerryMezo publishes a Wormhole message describing your trove. - Sepolia:
FerryEscrow.finalizeverifies the guardian-signed VAA, checks the emitter, your address, collateral and debt, and releases the escrowed WBTC to the solver. - If step 4 never happens,
refundafter the timeout pays the solver exactly the value it repaid and returns the rest to you.
Risks
| Risk | What it means | Mitigation |
|---|---|---|
| Your debt changes currency | You owe MUSD (Mezo's BTC-backed stablecoin) instead of USDC/USDT. MUSD aims for $1 but is a different asset. | Shown before signing; MUSD is redeemable against BTC on Mezo. |
| Liquidation at 110% | If BTC falls so that your collateral is worth less than 110% of your MUSD debt, your trove can be liquidated. | Ferry refuses migrations below 120% collateral ratio, warns below 150%, and shows your liquidation price. |
| Recovery Mode | If the whole Mezo system drops below 150% collateralisation, troves under 150% can be liquidated and withdrawals are blocked. | Ferry checks Recovery Mode before every Mezo leg and warns when your ratio is under 150%. |
| Promotional rate | Mezo's current 1% rate is promotional (range 1–5%). Your rate is fixed when your trove opens and stays until you refinance. | The live rate is read from InterestRateManager at quote time. |
| Minimum debt | A Mezo trove needs at least 1,800 MUSD of net debt, plus 200 MUSD gas compensation that you get back when you close. | Smaller Aave loans are rejected up front. |
| Bridge risk | The Sepolia escrow releases your WBTC to the solver only on a Wormhole guardian-signed proof that your trove exists. | If no proof arrives, the timeout refund returns all your equity. Anyone can republish a proof the guardians missed. |
| Solver liveness | A solver could repay your Aave loan and then never open your trove. | After the timeout, anyone can refund: the solver gets exactly what it repaid (Aave oracle price, rounded in your favour) and you get the rest. |
| One trove per address | Mezo allows one trove per address. If you already have one, Ferry can't open another. | Detected before signing. Adding to an existing trove is on the roadmap. |
| Testnet only, not audited | This is a hackathon prototype on Sepolia and Mezo testnet. | Do not use with real funds. |
Contracts (testnet)
| FerryEscrow (Sepolia) | 0x149089659d8320197acf6dc22033491343ec3afa |
| FerryMezo (Mezo testnet) | 0x7f2e244e2325d299d9c261a1f09c044f8d559ec3 |
| Aave V3 Pool (Sepolia) | 0x6Ae43d3271ff6888e7Fc43Fd7321a503ff738951 |
| Mezo BorrowerOperationsSignatures | 0xD757e3646AF370b15f32EB557F0F8380Df7D639e |
| Wormhole core (Mezo / Sepolia) | 0x268557122Ffd64c85750d630b716471118F323c8 / 0x4a8bc80Ed5a4067f1CCf107057b8270E0cC11A78 |