> ## Documentation Index
> Fetch the complete documentation index at: https://docs.multiliquid.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiliquid Protocol

> Decentralized infrastructure for atomic swaps between permissioned Real World Assets and stablecoins

## Overview

Multiliquid is a decentralized protocol that enables institutional-grade atomic swaps between multiple permissioned Real World Asset (RWA) tokens and multiple stablecoins. The protocol provides a secure, transparent, and efficient infrastructure for digital asset exchange in regulated markets.

<CardGroup cols={2}>
  <Card title="Architecture" icon="building" href="/evm/overview/architecture">
    Explore the protocol's modular design and core contracts
  </Card>

  <Card title="Security" icon="shield" href="/evm/overview/security">
    Review security measures and risk management controls
  </Card>

  <Card title="Integration" icon="code" href="/evm/guides/integration">
    Learn how to integrate with the Multiliquid Protocol
  </Card>
</CardGroup>

## Key Features

### Atomic Swap Execution

The protocol ensures complete transaction atomicity—either all conditions are fulfilled or none are. This eliminates partial executions and guarantees consistent state across all operations.

### Multi-Asset Support

* **Any RWA Token**: Support for multiple permissioned Real World Asset tokens
* **Any Stablecoin**: Integration with multiple institutional stablecoin liquidity providers and balance sheet providers
* **Extensible Design**: Modular architecture enables seamless onboarding of new assets

### Institutional-Grade Security

* **Upgradeable Contracts**: UUPS proxy pattern for secure evolution without disruption
* **Role-Based Access Control**: Granular permissions using OpenZeppelin's battle-tested framework
* **Risk Management**: Asset-specific controls including volume limits, discount rates, fees, pause mechanisms, and compliance checks
* **Emergency Controls**: Multi-signature governance and emergency pause capabilities

### Transparent Fee Structure

* **LP-Paid Protocol Fee**: Configurable per Liquidity Provider domain
* **Spread Fee**: Protocol participation in spreads configured by Liquidity Providers
* **LP Flexibility**: Liquidity Providers configure spreads and fees for each accepted asset independently

## How It Works

The protocol operates through a coordinated system of smart contracts:

1. **MultiliquidSwap Contract**: Central orchestrator managing all swap operations, fee calculations, and asset interactions
2. **Delegate Contracts**: Asset-specific modules handling:
   * Stablecoin minting/burning or external integration
   * RWA token risk management and custody
   * Compliance and volume controls
3. **Price Adapters**: Modular pricing for RWAs and optional stablecoin guardrails
4. **Whitelist Management**: Liquidity Provider asset acceptance and RWA-specific eligibility checks

### Swap Process

```mermaid theme={null}
sequenceDiagram
    actor User
    actor Operator
    participant MultiliquidSwap
    participant Pricing
    participant Policy
    participant StablecoinDelegate
    participant Assets

    User-->>Operator: Authorize transaction
    Operator->>MultiliquidSwap: Submit swap
    MultiliquidSwap->>Pricing: Resolve prices and fees
    MultiliquidSwap->>Policy: Check applicable controls
    MultiliquidSwap->>StablecoinDelegate: Request settlement
    StablecoinDelegate->>Assets: Transfer, mint, or burn
    MultiliquidSwap-->>Operator: Emit Swap event
```

## Supported Assets

The protocol is designed to support a growing ecosystem of institutional-grade digital assets:

### Real World Assets (RWAs)

* Permissioned tokenized securities
* Tokenized treasury products
* Institutional digital assets with compliance requirements

### Stablecoins

* Mint/burn stablecoins
* Pre-deposited liquidity provided by balance sheet providers without mint/burn integration

## Protocol Governance

The protocol employs a multi-tiered permission model:

* **Protocol Administrators**: Manage core system upgrades and global parameters
* **Operators**: Handle day-to-day operations including price updates and asset acceptance
* **Emergency Roles**: Pause capabilities for critical security scenarios
* **Liquidity Provider Admins**: Control all custody and risk management parameters for their Liquidity Provider

## Technology Stack

Built on industry-standard frameworks:

* **Solidity 0.8.30**: Checked arithmetic and modern language features
* **OpenZeppelin Upgradeable**: Audited proxy patterns and access control
* **Solady**: Gas-optimized mathematical operations
* **UUPS Proxies**: Minimal proxy overhead with secure upgrade mechanisms

## Integration Options

**EVM SDK**:
The official TypeScript SDK supports quoting, transaction construction, delegated authorization, simulation, protocol reads, and event monitoring.

**Direct Smart Contract Integration**:
Multiliquid allows for direct swap integration on Ethereum Mainnet.

<Info>
  For developer integration details, contract ABIs, and technical specifications, see the [Integration Guide](/evm/guides/integration).
</Info>

## Next Steps

<CardGroup cols={2}>
  <Card title="Understand the Architecture" icon="diagram-project" href="/evm/overview/architecture">
    Deep dive into the protocol's modular design, contract interactions, and swap mechanics
  </Card>

  <Card title="Review Security Model" icon="lock" href="/evm/overview/security">
    Examine security measures, audit results, and risk management frameworks
  </Card>

  <Card title="Explore Contract Reference" icon="file-code" href="/evm/contracts/multiliquid-swap">
    Browse detailed contract documentation and function specifications
  </Card>

  <Card title="Liquid Treasury" icon="building-columns" href="/applications/liquid-treasury">
    Yield-bearing institutional treasury token with cross-chain bridge support
  </Card>
</CardGroup>

***

<Warning>
  The Multiliquid Protocol handles significant value and operates in regulated markets. All integrations should undergo thorough testing and security review. Contact the Multiliquid team before production deployment.
</Warning>