Important

You are viewing a development version of the codebase.

Vault Bridge

Vault Bridge Token is the core of the Vault Bridge protocol. Built from the ground up to be reusable, it offers full Vault Bridge functionality out of the box, allowing you to create vbTokens in just a few lines of code.

Overview

The Vault Bridge protocol is comprised of:

• Layer X (the main network)
  • Vault Bridge Token
  • Migration Manager (singleton)
• Layer Y (other networks)
  • Custom Token
  • Native Converter

Vault Bridge Token ↗

A Vault Bridge Token is an

• ERC-20 token
• ERC-4626 vault
• LxLy Bridge extension

enabling bridging of select assets, such as WBTC, WETH, USDT, USDC, and USDS, while producing yield.

Migration Manager (singleton) ↗

The Migration Manager is a

• Vault Bridge Token dependency

handling migration of backing from Native Converters.

Custom Token ↗

A Custom Token is an

• ERC-20 token

an upgrade for LxLy Bridge's generic wrapped token.

Native Converter ↗

A Native Converter is a

• pseudo ERC-4626 vault
• LxLy Bridge extension

allowing conversion to, and deconversion of, Custom Token, as well as migration of backing to Vault Bridge Token.

Documentation

Please see NatSpec documentation inside of the files.

Please see @note documentation for important information.

Usage

Prerequisite

foundryup

Install

forge soldeer install & npm install

Build

forge build

Test

forge test

Coverage

forge coverage --ir-minimum --report lcov && genhtml -o coverage lcov.info

License

This codebase is licensed under Source Available License.

See LICENSE-SOURCE-AVAILABLE.

Your use of this software constitutes acceptance of these license terms.