Документация JustTLD
JustTLD — децентрализованный реестр пользовательских TLD-зон. Блокчейн хранит владение, PostgreSQL ускоряет поиск и историю.
npm install npm run start:all # сеть + БД + контракт + indexer + web # или по шагам npm run chain # EVM :8545 npm run deploy # контракт npm run indexer # синхронизация npm run dev # приложение :3000
Остановка: Ctrl+C или npm run stop:all. Перезапуск: npm run start:all.
• Начинается с точки, длина 3–21 символ.
• Только a-z, 0-9 и дефис; без «--» и дефиса по краям.
• Приводится к нижнему регистру: .MyZone = .myzone.
• Резерв: .eth .com .net .org .gov .edu .io .ai .sol .local + настраиваемый список.
• Запрещённые подстроки (blacklist) задаются owner контракта.
• Срок 365 дней; истёкшую зону можно перехватить после 30 дней грейса (allowReclaim).
| Method | Path | Описание |
|---|---|---|
GET | /api/zones | Список зон: page, limit, status, owner, q, sort |
GET | /api/zones/:tld | Зона из кэша + состояние в контракте |
GET | /api/zones/:tld/history | История событий зоны |
GET | /api/stats | Аналитика реестра |
GET | /api/search?q= | Поиск + проверка доступности |
GET | /api/health | Здоровье БД, узла, контракта и индексатора |
POST | /api/zones/prepare-registration | Неподписанная tx registerTLD |
POST | /api/zones/prepare-transfer | Неподписанная tx transferTLD |
POST | /api/zones/prepare-renewal | Неподписанная tx renewTLD |
POST | /api/zones/prepare-metadata | Неподписанная tx setTLDMetadata |
POST | /api/zones/confirm | Проверка чек-рецепта + обновление кэша |
POST | /api/admin/zones/:tld/block | Блокировка зоны (только админ) |
POST | /api/admin/zones/:tld/unblock | Разблокировка зоны (только админ) |
POST | /api/auth/nonce | Nonce для входа по подписи |
POST | /api/auth/verify | Проверка подписи и выдача сессии |
POST | /api/admin/resync | Команда индексатору: переиндексация |
• Приватные ключи не хранятся на сервере: подписывает только кошелёк.
• Права проверяются в контракте (ownerOf, paused, isBlocked).
• Zod-валидация, rate limiting, CSP, CSRF, анти-replay nonce.
• Админ-панель: вход по подписи + CSRF-токен + аудит-лог.