Appendix C: Initial-Dossier Schema

Настоящее приложение определяет процедуру Handshake (рукопожатия) — строго регламентированный процесс, в ходе которого Агент доказывает свою техническую и юридическую состоятельность Лицензиару для получения аттестата sig.a (Authoritative Attestation).

Initial-Dossier — это структурированный JSON-документ, который Агент передаёт Лицензиару при инициации процедуры верификации. Документ содержит все необходимые данные для проведения автоматизированного аудита в соответствии с методологией SOLPDT.

После успешного прохождения Handshake Лицензиар выдаёт цифровую подпись sig.a, которая встраивается в поле sig.a структуры Payload-V2 (см. раздел 2.1 основной спецификации). Без валидной sig.a транзакции Агента не признаются доверенными в экосистеме SOLPDT, а статус nma не может быть установлен в true.

Агент формирует Initial-Dossier в формате JSON согласно схеме, приведённой в разделе C.3, и отправляет его Лицензиару через API или защищённый канал связи. Запрос должен содержать уникальный request_id и криптографический nonce для защиты от повторного использования.

Лицензиар проводит автоматизированный аудит Агента, включающий:

• Проверку соответствия кода Агента стандарту Payload-V2
• Валидацию Compliance-Gateway Program ID в сети Solana
• Тестовый запрос к RPC-эндпоинту Агента
• Проверку наличия и суммы залогового депозита на stake_account

Агент проверяет Digital Access Token (DAT) Лицензиара, используя ссылку licensor_dat_ref из собственного досье. Проверка включает:

• Валидность подписи DAT (выдан Корневым узлом)
• Отсутствие DAT в реестре отозванного доверия (TRL)

Если DAT валиден, доверие между Агентом и Лицензиаром считается установленным.

После успешного прохождения всех проверок Лицензиар:

• Подписывает структуру данных Агента своим закрытым ключом Ed25519, привязанным к DAT
• Создаёт уникальную подпись sig.a (Authoritative Attestation)
• Отправляет sig.a на callback_url, указанный в Initial-Dossier
• Вносит запись об аттестации в распределённый реестр доверия

С этого момента Агент включает полученную sig.a в поле sig.a каждой транзакции Payload-V2. Любой участник экосистемы SOLPDT может мгновенно проверить подпись и убедиться, что Агент верифицирован аккредитованным Лицензиаром.

Ниже представлена эталонная структура Initial-Dossier. Все поля, отмеченные как required, обязательны к заполнению. Отсутствие любого обязательного поля приводит к отклонению запроса с кодом HS_ERR_MISSING_FIELDS.

{
  "dossier_header": {
    "version": "1.1",
    "request_id": "req-987456321",
    "timestamp": 1715856000,
    "nonce": "a7b8c9d0e1f2"
  },
  
  "identity_block": {
    "agent_pubkey": "A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q7r8S9t0U1v",
    "operator_id": "LLC-TECH-AGENT-01",
    "legal_jurisdiction": "RU",
    "controller_sig": "3z9x8c7v6b5n4m3l2k1j0h9g8f7e6d5c4b3a2"
  },
  
  "technical_manifest": {
    "payload_standard": "Payload-V2",
    "crypto_suite": "AES-GCM-256-Ed25519",
    "compliance_gateway_program_id": "CGW1111111111111111111111111111111111111",
    "rpc_endpoint_hash": "sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
  },
  
  "security_trust_layer": {
    "stake_account": "Stake99999999999999999999999999999999999999",
    "min_stake_amount": 50.0,
    "staking_token": "SOL",
    "slashing_consent": true,
    "trl_monitoring_enabled": true
  },
  
  "accounting_context": {
    "ias_38_compliance": true,
    "fsbu_14_2022_support": true,
    "asset_type": "Digital_Intangible_Asset",
    "valuation_oracle": "Pyth-Network-Mainnet",
    "base_currency": "RUB"
  },
  
  "attestation_meta": {
    "licensor_dat_ref": "DAT-888-REGIONAL-NODE-05",
    "callback_url": "https://agent-api.internal/solpdt/callback"
  }
}

После успешного Handshake, полученная sig.a встраивается в поле sig.a структуры Payload-V2 (см. раздел 2.1 основной спецификации).

Связь полей Initial-Dossier и Payload-V2

При успешной верификации Лицензиар отправляет на callback_url следующий JSON:

{
  "status": "approved",
  "request_id": "req-987456321",
  "agent_pubkey": "A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q7r8S9t0U1v",
  "sig_a": "5YtXz2M4pQ7rS9tU1vW3xY5zA7bC9dE1fG3hJ5kL7mN9pQ2rS5tU8vW2xYz4A6B8C0D",
  "licensor_dat_ref": "DAT-888-REGIONAL-NODE-05",
  "issued_at": 1715856300,
  "valid_until": 1747392300,
  "attestation_uri": "https://solpdt.com/verify/sig/5YtXz2M4pQ7..."
}

Агент обязан сохранить sig.a и включать её в каждую транзакцию Payload-V2. Срок действия аттестата (valid_until) составляет 365 дней с момента выдачи, после чего требуется повторное прохождение Handshake.

• Защита от replay-атак: Каждый request_id может быть использован только один раз. Лицензиар обязан вести реестр обработанных request_id с TTL не менее 7 дней.
• Валидация timestamp: Запросы с timestamp, отличающимся от серверного времени более чем на 300 секунд, должны отклоняться.
• Проверка controller_sig: Подпись должна верифицироваться публичным ключом agent_pubkey. Используется алгоритм Ed25519.
• Безопасность callback_url: Рекомендуется использовать HTTPS с валидным TLS-сертификатом. Лицензиар может требовать дополнительную аутентификацию (API key, mutual TLS).
• Хранение sig.a: Агент должен хранить sig.a в защищённом хранилище (HSM, секреты Kubernetes, Vault). Компрометация sig.a эквивалентна компрометации аттестации.