Документация JustTLD

JustTLD — децентрализованный реестр пользовательских TLD-зон. Блокчейн хранит владение, PostgreSQL ускоряет поиск и историю.

RPC
http://127.0.0.1:8545
chainId
31337
Contract
не развёрнут
Админ
—
Быстрый старт
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).

API
MethodPathОписание
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/nonceNonce для входа по подписи
POST
/api/auth/verifyПроверка подписи и выдача сессии
POST
/api/admin/resyncКоманда индексатору: переиндексация
JustTLDRegistry.sol
registerTLD(string tld, string metadata)Регистрация: владелец = msg.sender, срок 365 дней
transferTLD(string tld, address newOwner)Передача только владельцем зоны
renewTLD(string tld)+365 дней только владельцем
setTLDMetadata(string tld, string metadata)Обновление метаданных владельцем
getTLD(string tld)Полная информация о зоне
ownerOf(string tld)Адрес владельца
exists(string tld)Наличие зоны
totalZones()Количество зон
blockTLD / unblockTLDТолько owner контракта
pause / unpausePausable: блокирует мутации
Безопасность

• Приватные ключи не хранятся на сервере: подписывает только кошелёк.

• Права проверяются в контракте (ownerOf, paused, isBlocked).

• Zod-валидация, rate limiting, CSP, CSRF, анти-replay nonce.

• Админ-панель: вход по подписи + CSRF-токен + аудит-лог.