open-index/open-npm huggingface dataset:
npm package: @lotus-protocol/contracts
Description: Smart contracts package for the Lotus monorepo.
Latest version: 0.3.2

# @lotus-protocol/contracts

Smart contracts for the Lotus Protocol - a multi-tick lending protocol.

## Installation

```bash
npm install @lotus-protocol/contracts
# or
pnpm add @lotus-protocol/contracts
# or  
yarn add @lotus-protocol/contracts
```

## Usage

### Contract Addresses

The package exports deployed contract addresses and ABIs for easy integration.

```typescript
import { LOTUS_ADDRESSES, LOTUS_ABI } from '@lotus-protocol/contracts'

// Access deployed addresses by network
const lotusAddress = LOTUS_ADDRESSES[1] // Ethereum mainnet
const lotusABI = LOTUS_ABI
```

### TypeScript Types

```typescript
import type { LotusContract } from '@lotus-protocol/contracts'
```

### Contract ABIs

All contract ABIs are included for use with ethers, viem, or web3.js:

```typescript
import { 
  LOTUS_ABI,
  IRM_ABI,
  LENS_ABI 
} from '@lotus-protocol/contracts'
```

## Contract Overview

### Lotus Protocol
Multi-tick lending protocol where unutilized liquidity cascades from junior lenders to senior borrowers.

**Key Features:**
- Multi-tick market structure
- Automated interest rate models  
- Collateral-based lending
- Liquidation mechanisms

### Market Parameters
Each market is defined by:
- `loanToken`: The asset being lent
- `collateralToken`: The asset used as collateral  
- `oracle`: Price feed for collateral valuation
- `irm`: Interest rate model contract

## Documentation

For detailed protocol documentation and integration guides, visit our documentation portal.

## License

See LICENSE file for details.