⌬
STN™ DEVELOPER API · INTERFACE SPECIFICATION

STN™ Developer APIВерсия 1.1 (Agentic Trust Layer)

Интеграционный шлюз и спецификации сети STN™. Верификация DID-цепочки, валидация .solpdt, 4-фазная сессия ИИ-агентов. Все операции подчинены Каноническому стандарту STN™ v1.1.

Контур I (Infrastructure) обеспечивает вычислительную среду и криптографическую защиту данных (SHA3-256 / Ed25519 / SLA 99.99%). Контур V (Verification) — семантическую экспертизу и выпуск Цифровых паспортов. Взаимодействие между ними осуществляется через Compliance-Gateway (CGW).

API спроектировано как три независимых эндпоинта, соответствующих трём задачам: верификация цепочки DID (Приложение C), валидация актива .solpdt (Asset-Gold / Asset-Light) и 4-фазная сессия ИИ-агента (Приложение A).

StatusOPERATIONAL
API Versionv1.1
StandardSTN™ v1.1 (FINAL)
SLA99.99%
Base URLhttps://sol-trust.net/api/v1
// SECTION 1 // ARCHITECTURE

1. Архитектура интеграции

Сеть STN™ функционирует в режиме строгого разделения безлюдной машинной среды вычислительного консенсуса и авторизованной экспертной среды правовой капитализации активов. Модель исключает конфликт интересов между провайдерами вычислительной мощности и независимыми аудиторами семантической ценности.

// CONTOUR_IКонтур I — Infrastructure

Зона ответственности: вычислительная среда, криптографический консенсус, транспортный слой, SLA 99.99%, интероперабельность через SOL Multi-Gateway. Обеспечивает Bare-Metal ноды, хэширование SHA3-256, подписание Ed25519. Управляется Техническим комитетом STN Foundation.

// CONTOUR_VКонтур V — Verification

Зона ответственности: семантическая экспертиза, аудит E-E-A-T 2.0, выпуск Цифровых паспортов, экономическая оценка, агентское сопряжение. Только по результатам успешного прохождения процедур Контура V Лицензиар подписывает Цифровой паспорт актива (Claims → Asset).

Трёхуровневая DID-верификация (Приложение C) Каждый запрос к API проходит проверку DID-цепочки по схеме с обязательным fallback: L1 — Discovery (прямой HTTPS-запрос, таймаут 5 сек.) → L2 — CLAL-Fallback (кэшированная копия из Мастерчейн / BSN, нормализация по RFC 8785) → L3 — Grace Period (24 часа, статус Degraded Trust, периодический retry каждые 4 часа). Протокол динамического отзыва активируется только при доказанной криптографической компрометации, а не при сетевой недоступности.

1.1. Эндпоинты

API предоставляет три независимых эндпоинта, соответствующих трём задачам Контура V:

МетодЭндпоинтНазначениеСпецификация
POST/api/v1/verify-chainРекурсивная DID-верификация цепочки доверия до T0-AПриложение C
POST/api/v1/verify-assetВалидация актива .solpdt (Asset-Gold / Asset-Light)Приложение A, фазы III–IV
POST/api/v1/agent-session4-фазная сессия ИИ-агента: Handshake → TRL → PDT → sig.aПриложение A
// SECTION 2 // VERIFY_CHAIN

2. POST /api/v1/verify-chain

Рекурсивная верификация DID-цепочки от стартового идентификатора до Корневого узла did:web:sokolov-risk.com, предустановленного в Trust Store всех валидаторов. Соответствует Приложению C Канонического стандарта.

2.1. Формат запроса

application/json · Спецификация: Payload-V2 (SOLPDT 1.1, Приложение C)

// Пример входящего запроса: verify-chain { "protocol_version": "1.1", "method": "verify-chain", "target_did": "did:web:example.com", "issuer": { "organization": "ООО «СКАЙЛАЙН РИСК СОЛЮШЕНС», "dat_h_token": "did:web:skylinerisk.ru#dat-h" }, "trace": true }

2.2. Формат ответа

// Успешная верификация { "status": "VERIFIED_VIA_CLAL_FALLBACK", "chain_validation": { "hops": 3, "all_signatures_valid": true, "root_reached": "did:web:sokolov-risk.com" }, "verification_path": [ { "level": 1, "status": "timeout" }, { "level": 2, "source": "CLAL:masterchain:tx_hash_abc123", "status": "success" } ] }
// SECTION 3 // VERIFY_ASSET

3. POST /api/v1/verify-asset

Валидация актива .solpdt (Asset-Gold / Asset-Light) по схеме SOLPDT 1.1. Проверка синтаксиса, контроль целостности хэша (SHA3-256), верификация подписи Ed25519, проверка статуса эмитента в TRL, семантический анализ JSON-LD контекста.

3.1. Формат запроса

// Пример входящего запроса: verify-asset { "protocol_version": "1.1", "asset_type": "Asset-Gold", "issuer": { "organization": "ООО «СКАЙЛАЙН РИСК СОЛЮШЕНС», "dat_h_token": "did:web:skylinerisk.ru#dat-h" }, "content_credentials": { "domain": "example.com", "layer3_circuit": "Standard_v1.1", "payload_sha3_256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" }, "signature_block": { "algorithm": "Ed25519", "public_key": "8a4f9b2c...3d7e1f", "signature": "4f7a2b9e...cd8b2a1f" } }

3.2. Формат ответа

// Успешная валидация актива { "status": "VERIFIED", "verification_hash": "sha3-256:7f83b1657ff1fc53b92dc18148a1d65d...", "trl_status": "Active", "confidence_score": 0.94, "semantic_audit": { "scv_level": "SCV-3", "compliance_package": "SOL-3", "pdt_drift": 0.02 } }
// SECTION 4 // AGENT_SESSION

4. POST /api/v1/agent-session

4-фазная сессия ИИ-агента (Приложение A). Каждая фаза математически детерминирована. API возвращает промежуточные статусы по фазам.

4.1. Фазы сессии

  • Фаза I — Handshake. ИИ-агент передаёт Initial-Dossier. CGW производит Discovery-запрос did.json, строит рекурсивную DID-цепочку. При разрыве — HS_ERR_SIG_INVALID.
  • Фаза II — TRL. Атомарный запрос к CLAL-слою для проверки статуса в TRL. При флаге Cooldown / Revoked — CGW_ERR_TRL_BLACKLISTED (HTTP 403).
  • Фаза III — PDT. Семантический аудит. Расчёт Confidence Score и PDT-Drift. Определение SCV (SCV-1 / SCV-2 / SCV-3). Порог Hard Trust: Confidence Score ≥ 0.70.
  • Фаза IV — Signing. Генерация подписи sig.a (Ed25519) Уполномоченным Лицензиаром (DAT-A, T2-A). Упаковка в Payload-V2, фиксация хэша PAH (SHA3-256), трансляция в Jurisdictional Anchor.

4.2. Коды ошибок

Код ошибкиHTTPПричинаДействие ИИ-агента
HS_ERR_SIG_INVALID403 ForbiddenDID-цепочка разорванаЗавершение сессии, переключение на альтернативного DAT-A
CGW_ERR_TRL_BLACKLISTED403 ForbiddenСтатус Cooldown / Revoked в TRLБлокировка операции, логирование инцидента
CGW_ERR_AML_SCORE403 ForbiddenРиск-скоринг превышенНаправление пакета в CLO (юридический контур)
PDT_ERR_INSUFFICENT402 Payment RequiredЗалог ниже тарифаПополнение кошелька, retry через 48 ч.
CGW_ERR_JURIS_LOCK403 ForbiddenСанкционный IP-контурАварийное завершение, альтернативный союзный узел

4.3. Идемпотентность

TTL кэша валидных транзакций — 48 часов. При повторном идентичном запросе (совпадение Payload_Hash) шлюз возвращает X-Cache-Status: HIT без повторных вычислений. Время отклика — < 5 мс.

// SECTION 5 // ECONOMIC_PROTOCOL

5. Экономический протокол

Каждый вызов CGW оплачивается токенами STN (Verification Fee). Детальная токеномика — в Положении об экономическом протоколе (STN-ECO-2026-v1.2.1) и Приложении B к Каноническому стандарту.

  • Registration Fee — разовый платёж за первичный аудит и выпуск sig.a.
  • Verification Fee — плата за каждый вызов CGW.
  • Subscription Fee — поддержание статуса Active в TRL.
  • Success Royalty — % от прибыли ИИ-агента в контуре SOL-Escrow (30% в SLASHING_POOL_ADDRESS).

Дефляционное сжигание — по формуле Dynamic Burn Engine (Приложение B, раздел B.3): B_rate = B_base × (1 + (V_period / V_target) × (1 / (1 + feba_avg))). Нижний предел — 2.0%, верхний — 15.0%. Протокол слэшинга (Slashing) — при аудит-фальсификации или компрометации ключей (100% конфискация залога).

// SECTION 6 // DEVELOPER_TOOLS

6. Инструментарий разработчика

Готовые пакеты для развёртывания Bare-Metal узла и генерации ключей Ed25519. Тестовый контур — Testnet v1.1.

// NODE_DEPLOYMENT_GUIDE

STN Node Deployment Guide

Пошаговая инструкция по развёртыванию Bare-Metal узла на Ubuntu Server. Требования: SHA3-256, Ed25519, SLA 99.99%. Версия для Testnet v1.1.

docs/STN-Node-Deployment-v1.1.pdf Скачать PDF →
// CLI_TOOL

STN CLI Tool (Docker)

Генерация ключей Ed25519 и тестовых манифестов .solpdt из командной строки.

docker run --rm -v /opt/stn-node/keys:/keys soltrust/stn-cli:v1.1 keygen --algo ed25519 Скачать образ →