# Учебные руководства

Изучите использование Vilna через практические пошаговые руководства. Каждое руководство фокусируется на конкретном случае использования и предоставляет полные примеры кода.

## Руководства для начинающих

Примите ваш первый платеж
Узнайте, как сгенерировать платежный адрес, отслеживать входящие транзакции и подтверждать получение платежа. Идеально для интеграции с электронной коммерцией.
**Скоро будет доступно**

Мониторинг казначейского кошелька
Настройте комплексный мониторинг казначейского кошелька вашей компании с email оповещениями о крупных переводах и ежедневными отчетами о балансах.
**Скоро будет доступно**

## Руководства по интеграции

Создание депозитной системы
Создайте полноценную депозитную систему для биржи или сервиса кошельков, используя xpub ключи для генерации уникальных адресов для каждого пользователя.
**Скоро будет доступно**

Мульти-чейн трекер портфеля
Отслеживайте активы через множество блокчейнов, агрегируйте балансы и рассчитывайте общую стоимость портфеля в реальном времени.
**Скоро будет доступно**

## Продвинутые руководства

Автоматизированная отчетность для соответствия требованиям
Генерируйте автоматизированные отчеты о соответствии требованиям с историей транзакций, анализом источников средств и аудиторскими следами.
**Скоро будет доступно**

Мониторинг DeFi позиций
Отслеживайте DeFi позиции, включая пулы ликвидности, кредитные протоколы и yield farming через множество протоколов.
**Скоро будет доступно**

## Быстрые примеры

### Генерация депозитного адреса


```javascript
// Генерация следующего адреса из xpub
const response = await fetch('https://api.vilna.io/v1/addresses/generate/xpub/next', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    xpub_id: 'your-xpub-id',
    label: 'Клиент #12345'
  })
});

const { address } = await response.json();
console.log('Депозитный адрес:', address);
```

### Проверка баланса адреса


```python
import requests

def get_balance(address):
    url = f"https://api.vilna.io/v1/addresses/{address}/balances"
    headers = {"Authorization": "Bearer YOUR_API_KEY"}
    
    response = requests.get(url, headers=headers)
    balances = response.json()
    
    for balance in balances['items']:
        print(f"{balance['asset_name']}: {balance['balance']}")
```

### Настройка Webhook уведомлений


```bash
# Создание webhook канала
curl -X POST https://api.vilna.io/v1/channels \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "type": "webhook",
  "name": "Обработчик платежей",
  "webhook_url": "https://your-app.com/webhook"
}'

# Подписка на события депозитов
curl -X POST https://api.vilna.io/v1/subscriptions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "channel_id": "channel-id",
  "address_ids": ["address-id"],
  "event_types": ["transaction.confirmed"],
  "min_confirmations": 6
}'
```

## Выберите ваш путь

### Для продавцов

Начните с основ обработки платежей, чтобы изучить прием криптовалютных платежей с Vilna.

### Для бирж

Узнайте, как реализовать масштабируемую депозитную инфраструктуру для вашей биржи.

### Для казначейских команд

Начните с мониторинга кошельков для настройки комплексного отслеживания активов.

### Для разработчиков

Изучите все руководства и ознакомьтесь с нашим **[API Справочником](/apis/spec)** для полной технической документации.

## Нужна помощь?

- 📚 Читайте [Обзор архитектуры](/guides/architecture-overview) для подробной документации
- 🚀 Начните с [Руководства по быстрому старту](/guides/quickstart)
- 💬 Свяжитесь с нашей командой поддержки через официальные каналы