Build on Lotus

Developer hub for building on Lotus protocol with flash actions, vault adapters, liquidation modules, hooks, market creation, and integration recipes.

Lotus is modular and composable. This section shows how to integrate safely and effectively, with concise guidance and links to the reference pages.

Quick links

• Flash actions → Flash Actions

• Vault allocations → Vaults Adapter

• Liquidations → Liquidation Modules

• Pre-liquidation → Pre-Liquidation

• Market creation → Market Creation

• Liquidation bot → Liquidation Bot

• IRM design → IRM Authoring

• Hooks → Hooks

• Patterns → Recipes

• Vault deployment → Vault Factory

• Contract entrypoints → Contract API

What you’ll find here:

• Flash actions: build atomic flows with flash loans and callbacks.

• Vaults adapter: allocate Vault V2 assets into Lotus tranches.

• Where to find addresses, audits, and glossary terms.

Before building:

• Contract addresses: see Reference → Contract Addresses.

• Audits and security model: see Reference → Audits.

• Key concepts: skim Learn → Lotus Markets then Learn → Advanced for mechanics.

┌─────────────────────────────────────────────────────────────────────┐
│                  High-Level Integration Map                         │
└─────────────────────────────────────────────────────────────────────┘

    ┌──────────┐     ┌──────────┐     ┌──────────┐
    │   SDK    │     │   dApp   │     │  Wallet  │
    │ (ethers) │     │    UI    │     │   Apps   │
    └────┬─────┘     └────┬─────┘     └────┬─────┘
         │                │                 │
         └────────────────┼─────────────────┘
                          │
                          ▼
              ┌───────────────────────┐
              │   Adapters/Wrappers   │
              │  - LotusV2Adapter     │
              │  - Custom Integrations│
              └──────────┬────────────┘
                         │
                         ▼
         ┌───────────────────────────────────┐
         │      LOTUS CORE CONTRACT          │
         │  ┌─────────────────────────────┐  │
         │  │  Markets & Tranches         │  │
         │  │  - Market registry          │  │
         │  │  - Tranche accounting       │  │
         │  │  - Supply/Borrow/Collateral │  │
         │  └─────────────────────────────┘  │
         └──────┬───────────┬────────┬───────┘
                │           │        │
       ┌────────▼──┐   ┌────▼────┐  ┌▼────────┐
       │   IRMs    │   │Liquidn  │  │ Oracles │
       │ (pluggable)│  │Modules  │  │(external)│
       │ - Adaptive│   │(pluggable)│ │ - Price │
       │ - Managed │   │ - Oracle│  │   feeds │
       │ - Fixed   │   │   Incent│  │         │
       └───────────┘   └─────────┘  └─────────┘

Next steps:

• Start with flash actions if you need atomic flows.

• Use the vaults adapter if you manage pooled liquidity.

• See Recipes for canonical flows.