> For the complete documentation index, see [llms.txt](https://docs.clovis.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clovis.network/clovis/architecture.md).

# Architecture

Clovis uses a hub-and-spoke architecture to coordinate Earn, Borrow, and Bridge across supported networks.

The architecture separates where underlying assets are managed from where positions and cross-network activity are coordinated.

## The Hub-and-Spoke Model

#### Sei Is the Liquidity Hub

Sei is the liquidity hub for Clovis. It is where supported liquidity is concentrated and coordinated across Clovis products.

This shared-liquidity model helps Clovis support product activity across connected networks without requiring users to move assets to Sei themselves.

#### Base Is the Settlement Layer

Base is the settlement layer for Clovis. It records settlement and coordinates supported cross-network actions and destination releases.

The source transaction and destination result can occur on different networks and at different times. The app shows the current state of each action.

#### Connected Networks

Connected networks provide local access to supported assets and routes. Users select the source or destination network in the app, while Clovis coordinates the required processing.

Connection to Clovis does not mean every asset or product is available on every network. The app shows the combinations currently supported.

## Assets, Positions, and Vaults

Clovis separates the underlying asset from the position a user holds.

| Component                         | What It Does                                                                                     | What the User Sees                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------- |
| Underlying asset                  | The asset supplied, withdrawn, borrowed, repaid, or bridged, such as USDC, USDT, WETH, or cbBTC. | The asset and amount selected in the app.                                                           |
| Connected-network liquidity vault | Receives, manages, and releases supported underlying assets on a connected network.              | Users select an asset and network but do not normally interact with this vault directly.            |
| Earn Vault                        | Creates an Earn position and determines how many `cloToken` shares the user receives.            | The `cloToken` position and estimated underlying value shown in Portfolio.                          |
| `cloToken`                        | Represents the user's share of an Earn Vault.                                                    | A Flexible, locked, or collateral position whose underlying value depends on the Vault share price. |
| Cross-network message             | Coordinates instructions, confirmations, and settlement updates between networks.                | Processing and completion information shown in the app.                                             |

A cross-network message coordinates an action. It does not contain the underlying asset itself.

## How Earn Works

When you Supply an asset:

1. You select a supported asset, network, and Earn Vault.
2. Clovis receives the underlying asset through its connected-network liquidity infrastructure.
3. The selected Earn Vault creates the corresponding position.
4. You receive `cloToken` shares representing your share of the Vault.
5. The position appears in Portfolio.

For a cross-network Supply, the source transaction and resulting Earn position may complete at different times.

## How Withdraw Works

When you Withdraw:

1. You select the Flexible `cloToken` shares you want to redeem.
2. Clovis calculates their underlying value using the current Vault share price.
3. The Earn position is reduced by the selected shares.
4. Clovis coordinates the release of the corresponding underlying asset on the selected supported network.

The source transaction can confirm before the underlying asset arrives. Timing depends on the selected route, network, and available liquidity.

## How Borrow Works

Borrow uses collateral accepted by the selected market. An eligible Earn position can be one form of collateral.

The Borrow market determines:

* which collateral assets are accepted;
* which asset can be borrowed;
* whether the market uses a Single-collateral or Multi-collateral model;
* the applicable risk limits; and
* the available liquidity.

The borrowed asset can be released on an enabled destination network shown by the app.

## How Bridge Works

Bridge moves a supported underlying asset between connected networks.

The process generally includes:

1. The source network receives the asset.
2. Clovis coordinates the cross-network instruction and settlement.
3. The destination network releases the corresponding asset.

Bridge moves the underlying asset itself. It does not create an Earn position unless the user chooses a separate flow that includes Earn.

### Cross-Network Processing

A cross-network action generally includes these stages:

1. You select the product, asset, amount, and available networks.
2. You confirm the required transaction in your wallet.
3. The source network confirms the transaction.
4. Clovis coordinates cross-network processing and settlement.
5. The destination network releases the asset or records the resulting position.
6. You follow the status in Portfolio or Transaction History.

The source transaction and destination result may complete at different times.

### What This Means for Users

* You can interact with supported Clovis products through one interface.
* You do not need to coordinate every cross-network step yourself.
* The asset, network, route, product, and current liquidity determine which actions are available.
* A cross-network action may take longer than its source transaction.
* The app shows the current status and any available next action.