chore(release): clean up repo for v0.0.1 release

Excluded from release bundle:
- CONTEXT.md, CHANGELOG.md (agent/project working notes)
- client-app/ (React Native messenger — tracked separately)
- contracts/hello_go/ (unused standalone example)

Kept contracts/counter/ and contracts/name_registry/ as vm-test fixtures
(referenced by vm/vm_test.go; NOT production contracts).

Docs refactor:
- docs/README.md — new top-level index with cross-references
- docs/quickstart.md — rewrite around single-node as primary path
- docs/node/README.md — full rewrite, all CLI flags, schema table
- docs/api/README.md — add /api/well-known-version, /api/update-check
- docs/contracts/README.md — split native (Go) vs WASM (user-deployable)
- docs/update-system.md — new, full 5-layer update system design
- README.md — link into docs/, drop CHANGELOG/client-app references

Build-time version system (inherited from earlier commits this branch):
- node --version / client --version with ldflags-injected metadata
- /api/well-known-version with {build, protocol_version, features[]}
- Peer-version gossip on dchain/version/v1
- /api/update-check against Gitea release API
- deploy/single/update.sh with semver guard + 15-min systemd jitter

docs/api/README.md

@@ -1,45 +1,72 @@
-# REST API
+# REST + WebSocket API
 
-DChain-нода предоставляет HTTP API на порту `--stats-addr` (по умолчанию `:8080`).
+DChain-нода обслуживает HTTP + WebSocket на `--stats-addr` (по умолчанию `:8080`).
+JSON везде; ошибки в формате `{"error": "описание"}`, с 4xx для клиентских
+проблем и 5xx для серверных.
 
-## Базовые URL
+Полная OpenAPI-спека живёт в бинаре (`/swagger/openapi.json`) и рендерится
+Swagger UI на `/swagger`. Эти два эндпоинта можно выключить через
+`DCHAIN_DISABLE_SWAGGER=true` — см. [deploy/single/README.md](../../deploy/single/README.md).
 
-| Окружение | 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, контакты |
+| [chain.md](chain.md) | Блоки, транзакции, балансы, адреса, netstats, validators |
+| [contracts.md](contracts.md) | Деплой, вызов, state, логи контрактов |
+| [relay.md](relay.md) | Relay-mailbox: отправка/приём encrypted envelopes |
 
-## Формат ошибок
+## Discovery / metadata (always on)
 
-```json
-{"error": "описание ошибки"}
-```
+| Endpoint | Возврат |
+|----------|---------|
+| `GET /api/netstats` | height, total_txs, supply, validator_count |
+| `GET /api/network-info` | chain_id, genesis_hash, peers[], validators[], contracts |
+| `GET /api/well-known-version` | node_version, build{}, protocol_version, features[], chain_id |
+| `GET /api/well-known-contracts` | canonical contract_id → name mapping |
+| `GET /api/update-check` | comparison with upstream Gitea release (см. [../update-system.md](../update-system.md)) |
+| `GET /api/peers` | connected peer IDs + их версии (из gossip `dchain/version/v1`) |
+| `GET /api/validators` | active validator set |
+| `GET /metrics` | Prometheus exposition |
 
-HTTP-статус: 400 для клиентских ошибок, 500 для серверных.
+## Real-time (push)
+
+- **`GET /api/ws`** — WebSocket, рекомендованный транспорт. Поддерживает
+  `submit_tx`, `subscribe`, `unsubscribe`, `typing`, `ping`. Push-события:
+  `block`, `tx`, `inbox`, `typing`, `submit_ack`.
+- `GET /api/events` — SSE, legacy одностороннее streaming (для старых клиентов).
+
+Protocol reference — `node/ws.go` + [../architecture.md](../architecture.md).
 
 ## Аутентификация
 
-REST API не требует аутентификации. Транзакции подписываются на стороне клиента (CLI-командами) и отправляются как подписанные JSON-объекты. API не имеет admin-эндпоинтов требующих токенов.
+По умолчанию API **публичен**. Три режима access-control настраиваются через
+env:
 
-## Пример
+| Режим | `DCHAIN_API_TOKEN` | `DCHAIN_API_PRIVATE` | Эффект |
+|-------|:------------------:|:--------------------:|--------|
+| Public | не задан | — | Все могут читать и submit'ить tx |
+| Token writes | задан | `false` | Читать — любой; `POST /api/tx` и WS `submit_tx` — только с `Authorization: Bearer <token>` |
+| Fully private | задан | `true` | Все эндпоинты требуют token (включая `/api/netstats`) |
+
+WebSocket: токен передаётся query-параметром `?token=<...>`.
+
+## Примеры
 
 ```bash
-# Статистика сети
-curl http://localhost:8081/api/stats
+# Базовый health
+curl -s http://localhost:8080/api/netstats | jq .
 
-# Баланс адреса
-curl http://localhost:8081/api/balance/03a1b2c3...
+# Версия ноды
+curl -s http://localhost:8080/api/well-known-version | jq '{tag: .build.tag, features: .features}'
 
-# Последние блоки
-curl http://localhost:8081/api/blocks?limit=10
+# Список пиров с их версиями
+curl -s http://localhost:8080/api/peers | jq '.peers[].version'
+
+# С токеном (private-режим)
+curl -s -H "Authorization: Bearer $TOKEN" http://localhost:8080/api/netstats
+
+# Submit tx (public-режим)
+curl -s -X POST -H "Content-Type: application/json" \
+  -d @tx.json http://localhost:8080/api/tx
 ```