Warp Routes: Yield Routes
The goal of this guide is to illustrate how you can use Hyperlane warp routes to create yield-generating bridges, ensuring idle bridged assets are still productive by compounding yield over time.
Primary Motives
- Enable yield-generating warp routes via yield-bearing collateral vaults.
Pre-Requisites
To complete the following walkthrough, you should have the following available:
- An origin and destination network of choice, between which you’d like to deploy the yield route.
- The address of a funded ERC-4626 vault on the origin network. This vault’s underlying asset will also be set as the collateral for the warp route (e.g. if vault is USDC funded, the warp route will also support USDC transfer).
- An installed instance of the Hyperlane CLI and a wallet private key set as the
HYP_KEY
env var funded on your origin and destination networks.
Walkthrough: Create a Yield Route
Concepts
- ERC-4626 Vault: The Ethereum standard for tokenized yield-bearing vaults, representing shares of an single ERC20 token of choice.
- EvmHypCollateralVault (HypERC20CollateralVaultDeposit): The Hyperlane representation of a yield-bearing EVM collateral token. Note that the yield route’s vault’s deposited asset address is used as the warp routes collateral token.
For the sake of this example, the “origin” network will refer to the network on which the vault is present (e.g. yourchain is the origin with a USDC vault).
Steps
Using the Hyperlane CLI, deploy a yourchain USDC
EvmHypCollateralVault ↔ ethereum USDC
EvmHypSynthetic warp route:
- Run
hyperlane warp init
and complete the following flow:- Select
yourchain
andethereum
using space, and hit enter. - For yourchain, select
collateralVault
, accept the mailbox, and enter the USDC vault address on yourchain. - For ethereum, select
synthetic
and accept the mailbox.
- Select
- Run
hyperlane warp deploy
and confirm the warp deploy config is as expected. - Your newly deployed yield route can now accomplish the following:
-
Transfer USDC: yourchain → ethereum
-
Transfer USDC: ethereum → yourchain
-
💡 Please note that (at the time of writing) it is only possible for the owner to collect vault generated yield, and pro-rata user claims on yield are coming to yield routes soon.
🎉 Congrats! You have now created a new yield route with your vault. Bridged user assets can now earn passive yield while present in the origin warp route.
Please note that this collateralization strategy takes on certain ISM trust assumptions, and there is inherent risk that the underlying ERC-4626 vault becomes under-collateralized.
Check out some additional information, published by the Hyperlane supporting team, Cheese Chain, and the Ethereum Foundation: