# REST API

DChain-нода предоставляет HTTP API на порту `--stats-addr` (по умолчанию `:8080`).

## Базовые URL

| Окружение | URL |
|---------|-----|
| Локально | `http://localhost:8081` |
| Docker node1 | `http://node1:8080` |
| Docker node2 | `http://node2:8080` |
| Docker node3 | `http://node3:8080` |

## Разделы API

| Документ | Эндпоинты |
|---------|----------|
| [Chain API](chain.md) | Блоки, транзакции, балансы, адреса, stats |
| [Contracts API](contracts.md) | Деплой, вызов, state, логи |
| [Relay API](relay.md) | Отправка сообщений, inbox, контакты |

## Формат ошибок

```json
{"error": "описание ошибки"}
```

HTTP-статус: 400 для клиентских ошибок, 500 для серверных.

## Аутентификация

REST API не требует аутентификации. Транзакции подписываются на стороне клиента (CLI-командами) и отправляются как подписанные JSON-объекты. API не имеет admin-эндпоинтов требующих токенов.

## Пример

```bash
# Статистика сети
curl http://localhost:8081/api/stats

# Баланс адреса
curl http://localhost:8081/api/balance/03a1b2c3...

# Последние блоки
curl http://localhost:8081/api/blocks?limit=10
```