A production-ready cross-chain vault system built on the Valence Protocol that enables users to deposit selected denoms on Ethereum while generating yield on Neutron through Mars Protocol lending and Supervaults.
The system operates across three blockchain networks:
- Ethereum: User-facing ERC-4626 vault where users deposit collateral
- Neutron: CosmWasm-based liquidity provision via Mars Protocol, Supervaults, and MaxBTC strategy vaults
- Cosmos Hub: IBC/ICA bridging/messaging between Ethereum and Neutron
- IBC Eureka: Ethereum ↔ Cosmos Hub bridging
- ZK Co-processor: Generating proofs for IBC Eureka route queries and withdrawal obligations
packages/
: Common utility types and functions used across different vaultsstrategies/
: Directory for storing different strategies, each of which contain:deploy/
: Deployment automation for Neutron (CosmWasm) and Ethereum (Solidity) contractsstrategist/
: Automated off-chain solver orchestrating cross-chain operationstypes/
: Shared type definitions and configuration management
The following strategies are currently implemented:
- Lombard BTC:
lbtc
strategy that deploys user deposits into a Mars lending position and a Supervault - USDC:
usdc
strategy that deploys user deposits into a Supervault - WBTC:
wbtc
strategy that deploys user deposits into a Mars lending position and multiple Supervaults
Strategies below allow the Vault owner to perform a phase shift. This means that any wBTC
held by the strategy will be migrated into maxBTC
, and the assets will get redeployed according to the Neutron authorizations:
- Lombard BTC
- WBTC
- Users deposit collateral tokens into Ethereum ERC-4626 vault, receive vault shares
- Strategist monitors user deposits and bridges the funds: Ethereum → Cosmos Hub/Noble → Neutron The IBC Eureka route fetched from the Skip API is validated by the co-processor
- Strategist deploys bridged assets into Mars Protocol and Neutron Supervaults
- Users issue withdraw requests into Ethereum ERC-4626 vault, immediately burning their shares
- Strategist picks up user withdraw requests from the indexer and posts them to the co-processor for validation
- Strategist posts co-processor withdraw request proofs to the Neutron Authorizations contract which turns them into withdrawal obligations that get enqueued into the Clearing Queue contract
- Strategist withdraws the funds necessary to cover the outstanding withdraw obligations and clears them
- The Strategist calculates the new redemption rate and posts it to the ERC-4626 vault, concluding the cycle
Role | Description | Responsible Entity | Network |
---|---|---|---|
Strategist | Orchestrates cross-chain operations with highly constrained actions limited to pre-defined routes. Critical responsibility is to update the redemption rate regularly. Failure to update the rate automatically pauses the vault, requiring the owner to unpause | Hadron Labs | Both Neutron and Ethereum |
Vault Owner | Controls the vault contract parameters and emergency functions. Only the owner can upgrade and pause the contracts | Neutron DAO (multisig) on Ethereum, Neutron Valence-specific security DAO on Neutron | Both Neutron and Ethereum |
Verification Gateway Owner | Manages the verification gateway for cross-chain state verification | Valency Security Committee | Both Neutron and Ethereum |
The co-processor and light client services are trustless services managed by Valence.