Документация STN™ Developer API
Интеграционный шлюз и спецификации сети — версия 1.1 (Agentic Trust Layer)
1. Архитектура интеграции
Инфраструктура распределённого траста STN™ функционирует на базе разделения зон ответственности между Контуром смысловых стандартов (R&D-модуль) и Контуром распределённой Bare-Metal сети и смарт-контрактов токеномики.
Взаимодействие между децентрализованными валидаторами и семантическими узлами осуществляется через высоконагруженный шлюз Compliance-Gateway, поддерживающий распределённую маршрутизацию трафика, автоматический слэшинг (Slashing) за генерацию неверных криптографических подписей и аптайм на уровне SLA 99.9%.
Архитектурная зрелость сети достигается за счёт разделения логического и физического контуров, что обеспечивает цифровой суверенитет всех участников и защиту от монопольного давления.
2. Спецификация метода верификации манифестов
Метод: POST
Эндпоинт: https://sol-trust.net/api/v1/verify
Формат данных: application/json (Спецификация манифеста .solpdt)
Пример входящего JSON-пакета запроса:
{
"protocol_version": "1.1",
"asset_class": "HybridAsset",
"issuer": {
"organization": "ООО СКАЙЛАЙН РИСК СОЛЮШЕНС",
"dat_h_token": "DAT-H-7706777120-2026"
},
"content_credentials": {
"domain": "dental-expert-stn.ru",
"layer3_circuit": "Dental_Core_v1",
"payload_sha3_256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
"signature_block": {
"algorithm": "Ed25519",
"public_key": "8a4f9b2c...3d7e1f",
"signature": "4f7a2b9e...cd8b2a1f9e8d7c6b5a4f3e2d1c0b9a8f"
}
}
3. Алгоритм внутренней криптографической валидации нод
Инфраструктурный контур обрабатывает входящие запросы в соответствии со следующим протоколом:
- Валидация синтаксиса: Проверка структуры входящего JSON-пакета на соответствие схеме стандарта SOLPDT v1.1.
- Контроль целостности хэша: Вычисление хэш-суммы текстового блока payload «на лету» и сверка с заявленным payload_sha3_256.
- Верификация Ed25519: Математическая проверка подлинности цифровой подписи эмитента с использованием открытого ключа (public_key).
- Проверка статуса эмитента: Сверка DAT-H токена с актуальным реестром Головного Лицензиара.
- Семантический анализ: Проверка корректности JSON-LD контекста и пространства имён sol:.
При успешном прохождении всех этапов валидации нода возвращает статус VERIFIED и verification_hash для последующей привязки к реестру.
4. Контур Токеномики и Сплит-Транзакций
Каждая транзакция верификации списывает с баланса шлюза условный токен STN. Алгоритм автоматического «расщепления транзакции» (Split-fee) распределяет комиссию в следующих пропорциях:
| Доля | Назначение | Получатель |
|---|---|---|
| 70% | Награда оператору ноды | STAKING_WALLET (оператор Bare-Metal ноды) |
| 15% | Инфраструктурный фонд | Обеспечение хай-лоад сетей и резервирование |
| 10% | R&D-контур | Авторы методологии и стандартов (смысловой контур) |
| 5% | Дефляционный механизм | Безвозвратное уничтожение (сжигание) |
Примечание: Распределение комиссии автоматически выполняется смарт-контрактом на каждом этапе верификации и логируется в распределённом реестре.
5. Инструментарий разработчика
Скачайте готовые пакеты для быстрого развертывания тестового узла и генерации ключей.