chore: initial commit for v0.0.1

DChain single-node blockchain + React Native messenger client.

Core:
- PBFT consensus with multi-sig validator admission + equivocation slashing
- BadgerDB + schema migration scaffold (CurrentSchemaVersion=0)
- libp2p gossipsub (tx/v1, blocks/v1, relay/v1, version/v1)
- Native Go contracts (username_registry) alongside WASM (wazero)
- WebSocket gateway with topic-based fanout + Ed25519-nonce auth
- Relay mailbox with NaCl envelope encryption (X25519 + Ed25519)
- Prometheus /metrics, per-IP rate limit, body-size cap

Deployment:
- Single-node compose (deploy/single/) with Caddy TLS + optional Prometheus
- 3-node dev compose (docker-compose.yml) with mocked internet topology
- 3-validator prod compose (deploy/prod/) for federation
- Auto-update from Gitea via /api/update-check + systemd timer
- Build-time version injection (ldflags → node --version)
- UI / Swagger toggle flags (DCHAIN_DISABLE_UI, DCHAIN_DISABLE_SWAGGER)

Client (client-app/):
- Expo / React Native / NativeWind
- E2E NaCl encryption, typing indicator, contact requests
- Auto-discovery of canonical contracts, chain_id aware, WS reconnect on node switch

Documentation:
- README.md, CHANGELOG.md, CONTEXT.md
- deploy/single/README.md with 6 operator scenarios
- deploy/UPDATE_STRATEGY.md with 4-layer forward-compat design
- docs/contracts/*.md per contract

docs/contracts/README.md

@@ -0,0 +1,59 @@
+# Production Smart Contracts
+
+DChain поставляется с четырьмя production-контрактами, задеплоенными из genesis-кошелька.
+
+## Обзор
+
+| Контракт | Назначение | Ключевые фичи |
+|---------|-----------|--------------|
+| [username_registry](username_registry.md) | Username ↔ адрес | Тарифная сетка, treasury fees, reverse lookup |
+| [governance](governance.md) | On-chain параметры | Propose/approve workflow, admin role |
+| [auction](auction.md) | English auction | Token escrow, автоматический refund, settle |
+| [escrow](escrow.md) | Двусторонний escrow | Dispute/resolve, admin arbitration |
+
+## Деплой
+
+```bash
+docker compose --profile deploy run --rm deploy
+```
+
+Все 4 контракта деплоятся автоматически. ID сохраняются в `/tmp/contracts.env`.
+
+## Вызов контракта
+
+```bash
+docker exec node1 client call-contract \
+  --key      /keys/node1.json \
+  --contract <CONTRACT_ID> \
+  --method   <METHOD> \
+  --arg      <STRING_ARG>     # строковый аргумент (можно несколько)
+  --arg64    <UINT64_ARG>     # числовой аргумент uint64
+  --gas      <GAS_LIMIT>      # рекомендуется 20000 для записи, 5000 для чтения
+  --node     http://node1:8080
+```
+
+## Contract Treasury
+
+У каждого контракта есть **ownerless treasury address** — `hex(sha256(contractID + ":treasury"))`.  
+Это эскроу-адрес без private key. Только сам контракт может снять с него деньги через host function `transfer`.
+
+Используется в `auction` и `escrow` для хранения заблокированных токенов.
+
+## Просмотр состояния
+
+```bash
+# Через REST API
+curl http://localhost:8081/api/contracts/<ID>/state/<key>
+
+# Через Explorer
+open http://localhost:8081/contract?id=<ID>
+```
+
+## Логи контракта
+
+```bash
+# REST
+curl "http://localhost:8081/api/contracts/<ID>/logs?limit=20"
+
+# Explorer → вкладка Logs
+```