# DChain documentation

Справочник по блокчейн-ноде DChain. Читается в любом порядке, но если в первый
раз — идите по разделам сверху вниз.

## Оглавление

| Документ | О чём |
|----------|-------|
| [quickstart.md](quickstart.md) | Поднять ноду локально за 5 минут |
| [architecture.md](architecture.md) | 4 слоя стека: network / chain / transport / app |
| [node/README.md](node/README.md) | Запуск ноды (docker, native, deployment) |
| [update-system.md](update-system.md) | Версионирование, `/api/update-check`, auto-update от Gitea |
| [api/README.md](api/README.md) | REST + WebSocket API endpoints |
| [cli/README.md](cli/README.md) | CLI `client` — команды, флаги, примеры |
| [contracts/README.md](contracts/README.md) | Системные контракты (native + WASM) |
| [development/README.md](development/README.md) | SDK для написания своих контрактов (TinyGo) |
| [node/governance.md](node/governance.md) | On-chain governance, голосование параметров |
| [node/multi-server.md](node/multi-server.md) | Multi-validator federation deploy |

## Внешние ссылки из репо

- [README.md](../README.md) — обзор проекта
- [deploy/single/README.md](../deploy/single/README.md) — operator runbook для single-node
- [deploy/prod/README.md](../deploy/prod/README.md) — operator runbook для multi-validator
- [deploy/UPDATE_STRATEGY.md](../deploy/UPDATE_STRATEGY.md) — дизайн forward-compat обновлений (4 слоя)

## Соглашения

- **Единицы:** микро-токены (`µT`). 1 T = 1,000,000 µT. MinFee = 1000 µT = 0.001 T.
- **Pubkey:** 32-байтный Ed25519 (hex, 64 символа).
- **Address:** `DC` + первые 24 hex-символа SHA-256(pubkey).
- **ChainID:** `dchain-` + первые 12 hex-символов SHA-256 genesis-блока.
- **Времена:** RFC 3339 (UTC) везде, кроме internal-счётчиков в Prometheus (unix seconds).