# VKS в личном кабинете

Руководство описывает работу с VKS через [сайт Vilna](https://app.vilna.io). Модель ресурсов описана в [обзоре VKS](/ru/apis/vks).

Пользователь Vilna

Подключает узлы подписи, задаёт правила согласования в хранилищах и запрашивает подпись транзакций в личном кабинете Vilna.

Оператор signer

Signer - программный узел, участвующий в подписи. Оператор управляет узлом и рассматривает запросы согласования через интерфейс управления signer.

VKS поддерживает основные и тестовые сети. Доступные операции зависят от формата адреса, выбранных узлов и сети. Перед использованием адреса проверьте [совместимость сетей](/ru/apis/networks#vks).

## 1. Откройте VKS в Vilna

Войдите в личный кабинет, выберите рабочее пространство и откройте **VKS**. У вашей учётной записи должен быть доступ к VKS в этом пространстве. Если раздел недоступен, обратитесь к администратору. Для работы через сайт VKS API-ключ не нужен.

Доступ к Beta и демо
ПО signer предоставляется с открытым исходным кодом и находится в Beta. Исходный код и инструкции по установке предоставляются по запросу; также доступен демо-режим. Для получения доступа напишите на [support@vilna.io](mailto:support@vilna.io).

Узлы подписи

Подготовьте минимум 2 узла подписи и договоритесь с их операторами. Руководство предполагает, что ПО signer уже установлено. Операторы могут управлять своими узлами через [signer.vilna.io](https://signer.vilna.io). Этот интерфейс также предоставляется с открытым исходным кодом, и его можно разместить на своей инфраструктуре.

Доступ к проекту

Для последующего выбора сетей и активов нужны права `api:blockchain:read` и `api:asset:read` в проекте, в каталоге которого они доступны. Для перевода Bitcoin также зарегистрируйте адрес отправителя в нужной сети в этом проекте и убедитесь, что у вас есть `api:address:read` для чтения его неизрасходованных выходов (UTXO).

## 2. Подключите узлы подписи

1. Откройте **Узлы**, нажмите **Подключить узел**, затем **Создать токен подключения**.
2. По доверенному каналу сверьте с оператором идентификатор и отпечаток центра, показанные в Vilna. Передайте токен этому оператору конфиденциально и сохраните его до закрытия диалога.
3. Оператор подключает узел через его интерфейс управления. Вернитесь в **Узлы**, проверьте регистрацию и состояние подключения, сверьте отпечаток зарегистрированного узла с оператором.
4. Повторите для второго узла. Уже зарегистрированные узлы можно использовать повторно, проверив их подлинность и возможности.


Защищайте токены подключения
Не размещайте токены подключения в общих каналах переписки, журналах или скриншотах.

## 3. Создайте хранилище и дождитесь принятия

Откройте **Хранилища** и нажмите **Создать хранилище**. В этом разделе каждый vault задаёт состав узлов и правило согласования.

Для первого подключения выберите 2 зарегистрированных узла и потребуйте участие обоих. Для другой конфигурации можно выбрать 2–5 узлов и нужное число согласований; **Расширенное правило** позволяет также назначить обязательные узлы. Проверьте итоговое правило перед созданием.

Каждый оператор проверяет и принимает или отклоняет конфигурацию через интерфейс управления своим signer. В Vilna отображаются полученные решения. Продолжайте после перехода хранилища в активное состояние. Если запрос отклонён или срок принятия истёк, разберитесь с этим до создания адреса.

## 4. Создайте адрес

В активном хранилище нажмите **Создать адрес** или воспользуйтесь тем же действием в разделе **Адреса**. Выберите назначение и формат адреса, проверьте настройки и подтвердите создание.

Дождитесь состояния **Адрес готов**. Ход создания виден на сайте: готовить API-запросы и следить за этапами протокола вручную не нужно. Если создание завершилось ошибкой или срок истёк, откройте адрес и проверьте его состояние перед новой попыткой.

Адрес представляет блокчейн-аккаунт VKS, отдельный от учётной записи пользователя Vilna. Сеть выбирается при использовании адреса; форматы Bitcoin-адресов также различают основную и тестовую сеть.

## 5. Подготовьте операцию и запросите подпись

1. Откройте готовый адрес и нажмите **Отправить**.
2. Выберите проект каталога, сеть и актив, затем укажите получателя и сумму. Форма предлагает операции, поддерживаемые этим адресом и сетью. Для первого запроса выберите обычный перевод с оплатой комиссии с адреса отправителя.
3. Нажмите **Рассчитать операцию** и проверьте отправителя, сеть, актив, получателя, сумму и оценку комиссии. На адресе должно быть достаточно средств для операции и комиссии.
4. Выберите группу подписи, которая соответствует правилу хранилища, затем нажмите **Запросить подпись**.


Выбранные операторы проверяют запрос и принимают или отклоняют его через интерфейсы управления своими signer. Следите за результатом в разделе **Запросы подписи** в Vilna. Созданный запрос ещё не означает готовую подпись: он может быть отклонён, завершиться ошибкой или истечь.

## 6. При необходимости отправьте подписанную транзакцию

Откройте запрос подписи и проверьте результат. Для готовой подписанной транзакции нажмите **Отправить**, когда захотите передать её узлу блокчейна через VKS. Получение подписи не отправляет транзакцию автоматически.

После запроса отправки VKS может автоматически повторить попытку при временной ошибке или неизвестном результате, используя ту же подписанную транзакцию. Проверьте **Попытки отправки VKS**.

Проверяйте подтверждение в блокчейне отдельно
Состояние **Принято узлом блокчейна** означает принятие узлом, а не подтверждение в блокчейне. VKS не отслеживает подтверждения; для проверки результата в сети используйте мониторинг блокчейна.

Если принятие неизвестно, сначала проверьте существующий запрос и историю отправки. Транзакция уже могла попасть в сеть.

## Если действие не завершилось

Откройте существующее хранилище, адрес или запрос подписи и проверьте его текущее состояние. Прерванная загрузка страницы или сообщение об ошибке сами по себе не доказывают отмену действия. Перед созданием замены проверьте результат исходного запроса.

Истечение срока запроса подписи не стирает уже готовую подпись. Хранение результатов и ограничения удаления описаны в [обзоре VKS](/ru/apis/vks#%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C-%D0%B8-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0).

Для собственной интеграции используйте [справочник VKS API](/ru/apis/vks/api).