{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/get-started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"FAQ - Часто задаваемые вопросы","projectTitle":"Vilna Docs","description":"Ответы на частые вопросы о Vilna API: поддерживаемые сети, некастодиальная модель, аутентификация, мониторинг, вебхуки, стандарты и ошибки.","siteUrl":"https://docs.vilna.io","lang":"en-US","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-faq.png","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Vilna Documentation"},{"name":"og:image:width","content":"1200"},{"name":"og:image:height","content":"630"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"max-image-preview:large"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna Platform API monitors public blockchain activity, balances and invoices and delivers signed webhooks. It does not sign or broadcast transactions. VKS separately coordinates account setup, signer approvals and signing, retains signed results and can submit a complete transaction to a node. Node acceptance is not blockchain confirmation. Each API uses its own scoped credential in X-Api-Key. Workspace setup and VKS-key issuance start in the Dashboard.\n","details":{"content":"**Platform monitoring.** Platform observes merchant-controlled addresses,\nsupplied directly or derived from the merchant's extended public key (xPub).\nInvoices report incoming on-chain activity; they do not initiate transfers.\n\n**APIs and their credentials.**\n\n- Platform API (api.vilna.io) - monitor addresses and extended public keys, read\n  balances and transactions, reconcile incoming payments, create invoices, and\n  receive events.\n- Blockchain RPC (rpc.vilna.io) - JSON-RPC and gRPC node access across every\n  supported network behind one key.\n- Management API (mgmt.vilna.io) - published workspace, project, member and key\n  operations, with Dashboard bootstrap and credential grant limits.\n- VKS API (vks.vilna.io) - workspace signers, vaults, accounts, signing requests,\n  signed results and optional asynchronous send. Uses a Dashboard-issued VKS key\n  with vks:access; the public Management API has no VKS-key issuance route.\n\n**Pages with no markdown source**, so they cannot be linked below:\n\n- Product overview: https://docs.vilna.io/\n- All guides: https://docs.vilna.io/guides\n"},"excludeFiles":["legal/terms.md","legal/privacy.md","legal/cookies.md","@l10n/ru/legal/terms.md","@l10n/ru/legal/privacy.md","@l10n/ru/legal/cookies.md"],"sections":[{"title":"Getting Started","description":"What the platform is, how to make a first call, and answers to common questions","includeFiles":["get-started/quickstart.md","get-started/dashboard.md","get-started/core-concepts.md","get-started/members.md","get-started/faq.md"]},{"title":"API Reference","description":"Authentication, permissions, idempotency, errors, standards, and per-service endpoint documentation","includeFiles":["apis/authentication.md","apis/permissions.md","apis/idempotency.md","apis/errors.md","apis/standards.md","apis/networks.md","apis/platform/@v2/index.md","apis/platform/@v2/webhooks.md","apis/platform/@v2/api.yaml","apis/mgmt/index.md","apis/mgmt/api.yaml","apis/vks/index.md","apis/vks/api.yaml","apis/rpc/index.md","apis/rpc/json-rpc.md","apis/rpc/grpc.md"]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, and tooling","includeFiles":["guides/events.md","guides/channels.md","guides/tokens.md","guides/integration-patterns.md","guides/mcp.md","guides/simulation.md","guides/invoices.md","guides/vks.md"]},{"title":"Trust and custody","description":"The non-custodial model in plain terms","includeFiles":["legal/non-custodial.md"]},{"title":"Optional","description":"Background reading and release history","includeFiles":["get-started/blockchain-basics.md","changelog.md"]}]},"priority":0.5,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Главная","item":"https://docs.vilna.io/ru/"},{"@type":"ListItem","position":2,"name":"Начало работы","item":"https://docs.vilna.io/ru/get-started"},{"@type":"ListItem","position":3,"name":"FAQ"}]},{"@type":"FAQPage","dateModified":"2026-11-01","mainEntity":[{"@type":"Question","name":"Какие блокчейны поддерживает Vilna?","acceptedAnswer":{"@type":"Answer","text":"Platform API поддерживает 5 основных и 4 тестовые сети. В 7 сетях доступен полный мониторинг; Solana Mainnet и Testnet поддерживают только адреса и каталог токенов. Идентификаторы CAIP-2 и возможности продуктов указаны в таблице сетей; GET /blockchains возвращает актуальный набор."}},{"@type":"Question","name":"Является ли Vilna кастодиальной? Хранит ли она ключи или средства?","acceptedAnswer":{"@type":"Answer","text":"Platform API наблюдает за публичной активностью и сверяет её; он не подписывает и не отправляет транзакции. VKS отдельно координирует создание блокчейн-аккаунтов, согласование и подпись с участием узлов подписи (signer); готовую транзакцию можно отправить узлу. Принятие узлом не означает подтверждения в блокчейне."}},{"@type":"Question","name":"В чем разница между Platform API, Management API, VKS и Blockchain RPC?","acceptedAnswer":{"@type":"Answer","text":"Platform API - для мониторинга блокчейна (адреса, балансы, транзакции, счета). Management API - для администрирования (рабочие пространства, проекты, участники, ключи). Blockchain RPC - прямой доступ к узлам по JSON-RPC и gRPC. VKS - настройка блокчейн-аккаунтов, согласование и совместная подпись. Для публичного API нужен отдельный VKS-ключ; сайт использует пользовательскую сессию."}},{"@type":"Question","name":"Как начать работу?","acceptedAnswer":{"@type":"Answer","text":"Зарегистрируйтесь на app.vilna.io, создайте рабочее пространство и проект, затем сгенерируйте API-ключ. Платформа бесплатна на этапе раннего доступа."}},{"@type":"Question","name":"Как пройти аутентификацию?","acceptedAnswer":{"@type":"Answer","text":"Передавайте API-ключ в заголовке X-Api-Key в каждом аутентифицированном API-запросе. Нет потока OAuth и нет токена, который нужно обновлять."}},{"@type":"Question","name":"Есть ли лимиты запросов?","acceptedAnswer":{"@type":"Answer","text":"Лимиты зависят от API и операции. Временное ограничение возвращает 429; соблюдайте правила повторов операции и Retry-After, если он есть. Формат ошибок RPC описан в разделе Ошибки."}},{"@type":"Question","name":"В чем разница между внешними и HD-адресами?","acceptedAnswer":{"@type":"Answer","text":"Внешние адреса импортируются указанием полной строки адреса. HD-адреса деривируются из расширенного публичного ключа (xPub) по стандартам BIP-32/44, что позволяет программно генерировать новые адреса без раскрытия приватных ключей."}},{"@type":"Question","name":"Можно ли отслеживать один адрес в нескольких сетях?","acceptedAnswer":{"@type":"Answer","text":"Да. Для EVM-совместимых сетей достаточно указать input.chain_family со значением evm при создании адреса, и он будет отслеживаться во всех активных EVM-сетях сразу."}},{"@type":"Question","name":"Как представлены суммы?","acceptedAnswer":{"@type":"Answer","text":"Многие суммы транзакций и балансов содержат base для точных вычислений и formatted для отображения. Поля счетов отличаются в аутентифицированных и публичных ответах; см. форматы сумм."}},{"@type":"Question","name":"Почему по токену, который я вижу в сети, нет баланса и уведомлений?","acceptedAnswer":{"@type":"Answer","text":"Балансы охватывают нативные монеты, проверенные и доверенные токены. Фильтр уведомлений о входящих переводах по умолчанию использует те же метки, но действие самого выбранного адреса тоже может дать основание; отключение фильтра допускает незнакомые токены. Разрешите контракт через POST /tokens/{chain_gid}/{asset_path}, затем POST .../actions/trust. Доверие к токену не создаёт уведомлений за прошлые транзакции."}},{"@type":"Question","name":"Насколько мониторинг приближен к реальному времени и когда срабатывает событие?","acceptedAnswer":{"@type":"Answer","text":"Подписка использует одно условие отправки уведомления (trigger): block ждёт фиксированное число блоков после включения, network ждёт собственной политики подтверждений сети, mempool (только Bitcoin) срабатывает до включения в блок. Для раннего сигнала и более позднего сигнала подтверждения создайте две подписки с разными условиями. Выполнение политики подтверждений не гарантирует необратимости."}},{"@type":"Question","name":"Какие методы уведомлений поддерживаются?","acceptedAnswer":{"@type":"Answer","text":"Два: вебхуки (подписанный HTTP POST на ваш эндпоинт) и Telegram (сообщения бота в чат)."}},{"@type":"Question","name":"Как проверить подлинность вебхука?","acceptedAnswer":{"@type":"Answer","text":"Проверьте заголовок X-Webhook-Signature (t=<unix>,v1=<hex>) - это HMAC-SHA256 от значения t, точки и сырых байтов тела запроса с ключом webhook_secret. Отбрасывайте доставки с устаревшей временной меткой и исключайте повторную обработку по X-Webhook-Event-Id. Пошаговый алгоритм есть на странице Webhooks."}},{"@type":"Question","name":"Можно ли тестировать вебхуки без реальных транзакций?","acceptedAnswer":{"@type":"Answer","text":"Да. Тест канала отправляет подписанный пример с is_test: true без реальной транзакции. Запрос возвращает 202 и notification_id; проверьте уведомление, чтобы подтвердить доставку. См. Проверка канала."}},{"@type":"Question","name":"Что произойдет, если мой эндпоинт для вебхуков недоступен?","acceptedAnswer":{"@type":"Answer","text":"Неудачные доставки (не 2xx или таймаут) повторяются по фиксированному расписанию с растущей задержкой. Повторы используют тот же event_id, поэтому обработчик может распознать повтор и не выполнять действие снова. Каждая попытка записывается в историю уведомлений. max_attempts ограничивает эти повторы; когда он исчерпан, канал отключается сам."}},{"@type":"Question","name":"Можно ли выключить автоматическое отключение канала?","acceptedAnswer":{"@type":"Answer","text":"Нет. Настройка - это max_attempts, от 1 до 10 на канал, повышается через PATCH /channels/{channel_id}. Когда уведомление исчерпало бюджет, канал отключается, а ожидающие уведомления отменяются; повторное включение принимает только новые транзакции."}},{"@type":"Question","name":"Мой канал отключился. Я потерял депозиты?","acceptedAnswer":{"@type":"Answer","text":"Нет. Транзакции, активность и балансы записываются независимо от того, ушло ли уведомление; отменены только доставки. Опрашивайте GET /channels по is_enabled. После включения запросите отменённые уведомления и активность за это окно и отправьте заново те, у которых ещё сохранено тело уведомления."}},{"@type":"Question","name":"Нужна ли клиентская библиотека для работы с API?","acceptedAnswer":{"@type":"Answer","text":"Нет. Vilna - это стандартный REST API, который можно вызывать из любого языка через HTTP. Если нужен типизированный клиент, сгенерируйте его из OpenAPI-спецификации."}},{"@type":"Question","name":"Можно ли ускорить интеграцию с помощью ИИ-ассистента?","acceptedAnswer":{"@type":"Answer","text":"Да. MCP-сервер документации Vilna позволяет Claude и другим MCP-клиентам читать полный справочник API в контексте и генерировать корректные вызовы. См. Интеграция с ИИ."}},{"@type":"Question","name":"Что такое CAIP?","acceptedAnswer":{"@type":"Answer","text":"Chain Agnostic Improvement Proposals - единая форма идентификатора для сетей (CAIP-2), адресов в конкретной сети (CAIP-10) и активов (CAIP-19) в разных сетях. Vilna использует их по всему API."}},{"@type":"Question","name":"Какой формат ошибок использует API?","acceptedAnswer":{"@type":"Answer","text":"Platform, Management и VKS HTTP API используют RFC 7807 Problem Details (application/problem+json). Проверяйте машинный code; для Blockchain RPC действует модель ошибок протокола. См. Ошибки."}}]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"faq","__idx":0},"children":["FAQ"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"общие-вопросы","__idx":1},"children":["Общие вопросы"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"какие-блокчейны-поддерживает-vilna","__idx":2},"children":["Какие блокчейны поддерживает Vilna?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform API поддерживает 5 основных и 4 тестовые сети. В 7 сетях доступен полный мониторинг; Solana Mainnet и Testnet поддерживают только адреса и каталог токенов. Идентификаторы CAIP-2 и возможности продуктов указаны в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/networks#table"},"children":["таблице сетей"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /blockchains"]}," возвращает актуальный набор."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"является-ли-vilna-кастодиальной-хранит-ли-она-ключи-или-средства","__idx":3},"children":["Является ли Vilna кастодиальной? Хранит ли она ключи или средства?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform API наблюдает за публичной активностью и сверяет её; он не подписывает и не отправляет транзакции. VKS отдельно координирует создание блокчейн-аккаунтов, согласование и подпись с участием узлов подписи (signer); готовую транзакцию можно отправить узлу. Принятие узлом не означает подтверждения в блокчейне."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"в-чем-разница-между-platform-api-management-api-vks-и-blockchain-rpc","__idx":4},"children":["В чем разница между Platform API, Management API, VKS и Blockchain RPC?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Для вызовов API используйте ключ соответствующего сервиса:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform"},"children":["Platform API"]}]}," - мониторинг блокчейна: адреса, балансы, транзакции, счета, уведомления."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/mgmt"},"children":["Management API"]}]}," - администрирование: пространства, проекты, участники и жизненный цикл API-ключей."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/vks"},"children":["VKS"]}]}," - настройка блокчейн-аккаунтов, согласование и совместная подпись транзакций."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/rpc"},"children":["Blockchain RPC"]}]}," - прямой доступ к узлам по JSON-RPC и gRPC, один ключ для каждой сети."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"как-начать-работу","__idx":5},"children":["Как начать работу?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.vilna.io"},"children":["Зарегистрируйтесь на app.vilna.io"]},", создайте рабочее пространство и проект, затем сгенерируйте API-ключ с нужными правами. Платформа бесплатна на этапе раннего доступа; см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/quickstart"},"children":["Быстрый старт"]},". Если нужна помощь, пишите на ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@vilna.io"},"children":["support@vilna.io"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"аутентификация-и-лимиты","__idx":6},"children":["Аутентификация и лимиты"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"как-пройти-аутентификацию","__idx":7},"children":["Как пройти аутентификацию?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Передавайте API-ключ в заголовке ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Api-Key"]}," в каждом аутентифицированном API-запросе. Без потока OAuth и без токена, который нужно обновлять. Типы ключей и права рассмотрены в разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/authentication"},"children":["Аутентификация"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"есть-ли-лимиты-запросов","__idx":8},"children":["Есть ли лимиты запросов?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Лимиты зависят от API и операции. Временное ограничение возвращает ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429"]},"; соблюдайте правила повторов операции и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]},", если он есть. У RPC свои форматы ошибок, заголовков ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RateLimit-*"]}," нет. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/errors#rate-limits"},"children":["Ошибки"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"адреса-и-мониторинг","__idx":9},"children":["Адреса и мониторинг"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"в-чем-разница-между-внешними-и-hd-адресами","__idx":10},"children":["В чем разница между внешними и HD-адресами?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Внешние адреса импортируются напрямую: вы указываете полную строку адреса. HD-адреса деривируются из расширенного публичного ключа (xPub) по стандартам BIP-32/44, что позволяет программно генерировать новые адреса без раскрытия приватных ключей. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/blockchain-basics"},"children":["Основы блокчейна"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"можно-ли-отслеживать-один-адрес-в-нескольких-сетях","__idx":11},"children":["Можно ли отслеживать один адрес в нескольких сетях?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Да. Для EVM-совместимых сетей достаточно указать ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input.chain_family"]}," со значением ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["evm"]}," при создании адреса, и он будет отслеживаться во всех активных EVM-сетях сразу."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"как-представлены-суммы","__idx":12},"children":["Как представлены суммы?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Многие суммы транзакций и балансов содержат ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]}," для точных вычислений и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted"]}," для отображения. Поля счетов отличаются в аутентифицированных и публичных ответах; см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/core-concepts#amounts"},"children":["форматы сумм"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"почему-по-токену-который-я-вижу-в-сети-нет-баланса-и-уведомлений","__idx":13},"children":["Почему по токену, который я вижу в сети, нет баланса и уведомлений?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Балансы охватывают нативные монеты и токены с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_verified"]}," (общий список) или ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_trusted"]}," (выбор проекта). Фильтр уведомлений о входящих переводах по умолчанию использует эти метки, но действие самого выбранного адреса тоже может дать основание; отключение фильтра допускает незнакомые токены без включения балансов. Разрешите контракт через ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /tokens/{chain_gid}/{asset_path}"]},", затем ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST …/actions/trust"]},"; прошлые транзакции остаются без уведомлений. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/tokens"},"children":["Токены и балансы"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"насколько-мониторинг-приближен-к-реальному-времени-и-когда-срабатывает-событие","__idx":14},"children":["Насколько мониторинг приближен к реальному времени и когда срабатывает событие?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Подписка использует одно условие отправки уведомления (trigger): ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["block"]}," ждёт фиксированное число блоков после включения, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["network"]}," ждёт собственной политики подтверждений сети, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mempool"]}," (только Bitcoin) срабатывает до включения в блок. Для раннего сигнала и более позднего сигнала подтверждения создайте две подписки с разными условиями. Выполнение политики подтверждений не гарантирует необратимости. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/events"},"children":["События и мониторинг"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"уведомления","__idx":15},"children":["Уведомления"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"какие-методы-уведомлений-поддерживает-vilna","__idx":16},"children":["Какие методы уведомлений поддерживает Vilna?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Два: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["вебхуки"]}," (подписанный HTTP POST на ваш эндпоинт) и ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Telegram"]}," (сообщения бота в чат). Настройка описана в разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels"},"children":["Каналы уведомлений"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"как-проверить-подлинность-вебхука","__idx":17},"children":["Как проверить подлинность вебхука?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Проверьте заголовок ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Webhook-Signature"]},": он содержит ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["t=<unix>,v1=<hex>"]},", HMAC-SHA256 от значения ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["t"]},", точки и сырых байтов тела запроса с ключом ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_secret"]},". Отбрасывайте доставки с устаревшей временной меткой (защита от повторов) и исключайте повторную обработку по ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Webhook-Event-Id"]},". Пошаговый алгоритм есть на ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/webhooks#verify"},"children":["странице Webhooks"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"можно-ли-тестировать-вебхуки-без-реальных-транзакций","__idx":18},"children":["Можно ли тестировать вебхуки без реальных транзакций?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Да. Тест канала отправляет подписанный пример с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_test: true"]}," без реальной транзакции. Запрос возвращает ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notification_id"]},"; проверьте уведомление, чтобы подтвердить доставку. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels#testing"},"children":["Проверка канала"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"что-произойдет-если-мой-эндпоинт-для-вебхуков-недоступен","__idx":19},"children":["Что произойдет, если мой эндпоинт для вебхуков недоступен?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Доставка, которая не вернула ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2xx"]}," (или истекла по таймауту), повторяется по фиксированному расписанию с растущей задержкой. Повторы используют тот же ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event_id"]},", поэтому обработчик может распознать повтор и не выполнять действие снова. Каждая попытка записывается в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels#logs"},"children":["историю уведомлений"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_attempts"]}," ограничивает эти повторы; когда он исчерпан, канал отключается сам - см. два следующих вопроса."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"можно-ли-выключить-автоматическое-отключение-канала","__idx":20},"children":["Можно ли выключить автоматическое отключение канала?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Нет. Настройка - это ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_attempts"]},", от 1 до 10 на канал, повышается через ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /channels/{channel_id}"]},". Когда уведомление исчерпало бюджет, канал отключается, а ожидающие уведомления отменяются; повторное включение принимает только новые транзакции. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels#disabled"},"children":["когда канал отключается сам"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"мой-канал-отключился-я-потерял-депозиты","__idx":21},"children":["Мой канал отключился. Я потерял депозиты?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Нет. Транзакции, активность и балансы записываются независимо от того, ушло ли уведомление; отменены только доставки. Опрашивайте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /channels"]}," по ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_enabled: false"]},". После включения запросите отменённые уведомления и активность за это окно и отправьте заново те, у которых ещё сохранено тело уведомления. Пошагово это разобрано в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels#payment-flow"},"children":["рецепте для платёжного потока"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"инструменты","__idx":22},"children":["Инструменты"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"нужна-ли-клиентская-библиотека-для-работы-с-vilna-api","__idx":23},"children":["Нужна ли клиентская библиотека для работы с Vilna API?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Нет. Vilna - это стандартный REST API, вызывайте его напрямую из любого языка через HTTP. Если нужен типизированный клиент, сгенерируйте его из ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api"},"children":["OpenAPI-спецификации"]}," с помощью инструмента вроде ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://openapi-generator.tech/"},"children":["openapi-generator"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"можно-ли-ускорить-интеграцию-с-помощью-ии-ассистента","__idx":24},"children":["Можно ли ускорить интеграцию с помощью ИИ-ассистента?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Да. MCP-сервер документации Vilna позволяет Claude и другим MCP-клиентам читать полный справочник API в контексте и генерировать корректные вызовы. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/mcp"},"children":["Интеграция с ИИ"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"стандарты-и-ошибки","__idx":25},"children":["Стандарты и ошибки"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"что-такое-caip","__idx":26},"children":["Что такое CAIP?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Chain Agnostic Improvement Proposals дают каждой сети, адресу в конкретной сети и активу единую форму идентификатора: CAIP-2 для сетей, CAIP-10 для адресов в конкретной сети, CAIP-19 для активов. Vilna использует их как идентификаторы по всему API. В разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/standards#caip"},"children":["Стандарты"]}," показано, как устроен каждый из них."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"какой-формат-ошибок-использует-vilna-api","__idx":27},"children":["Какой формат ошибок использует Vilna API?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform, Management и VKS HTTP API используют RFC 7807 Problem Details (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]},"). Проверяйте машинный ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]},"; для Blockchain RPC действует модель ошибок протокола. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/errors"},"children":["Ошибки"]},"."]}]},"headings":[{"value":"FAQ","id":"faq","depth":1},{"value":"Общие вопросы","id":"общие-вопросы","depth":2},{"value":"Какие блокчейны поддерживает Vilna?","id":"какие-блокчейны-поддерживает-vilna","depth":3},{"value":"Является ли Vilna кастодиальной? Хранит ли она ключи или средства?","id":"является-ли-vilna-кастодиальной-хранит-ли-она-ключи-или-средства","depth":3},{"value":"В чем разница между Platform API, Management API, VKS и Blockchain RPC?","id":"в-чем-разница-между-platform-api-management-api-vks-и-blockchain-rpc","depth":3},{"value":"Как начать работу?","id":"как-начать-работу","depth":3},{"value":"Аутентификация и лимиты","id":"аутентификация-и-лимиты","depth":2},{"value":"Как пройти аутентификацию?","id":"как-пройти-аутентификацию","depth":3},{"value":"Есть ли лимиты запросов?","id":"есть-ли-лимиты-запросов","depth":3},{"value":"Адреса и мониторинг","id":"адреса-и-мониторинг","depth":2},{"value":"В чем разница между внешними и HD-адресами?","id":"в-чем-разница-между-внешними-и-hd-адресами","depth":3},{"value":"Можно ли отслеживать один адрес в нескольких сетях?","id":"можно-ли-отслеживать-один-адрес-в-нескольких-сетях","depth":3},{"value":"Как представлены суммы?","id":"как-представлены-суммы","depth":3},{"value":"Почему по токену, который я вижу в сети, нет баланса и уведомлений?","id":"почему-по-токену-который-я-вижу-в-сети-нет-баланса-и-уведомлений","depth":3},{"value":"Насколько мониторинг приближен к реальному времени и когда срабатывает событие?","id":"насколько-мониторинг-приближен-к-реальному-времени-и-когда-срабатывает-событие","depth":3},{"value":"Уведомления","id":"уведомления","depth":2},{"value":"Какие методы уведомлений поддерживает Vilna?","id":"какие-методы-уведомлений-поддерживает-vilna","depth":3},{"value":"Как проверить подлинность вебхука?","id":"как-проверить-подлинность-вебхука","depth":3},{"value":"Можно ли тестировать вебхуки без реальных транзакций?","id":"можно-ли-тестировать-вебхуки-без-реальных-транзакций","depth":3},{"value":"Что произойдет, если мой эндпоинт для вебхуков недоступен?","id":"что-произойдет-если-мой-эндпоинт-для-вебхуков-недоступен","depth":3},{"value":"Можно ли выключить автоматическое отключение канала?","id":"можно-ли-выключить-автоматическое-отключение-канала","depth":3},{"value":"Мой канал отключился. Я потерял депозиты?","id":"мой-канал-отключился-я-потерял-депозиты","depth":3},{"value":"Инструменты","id":"инструменты","depth":2},{"value":"Нужна ли клиентская библиотека для работы с Vilna API?","id":"нужна-ли-клиентская-библиотека-для-работы-с-vilna-api","depth":3},{"value":"Можно ли ускорить интеграцию с помощью ИИ-ассистента?","id":"можно-ли-ускорить-интеграцию-с-помощью-ии-ассистента","depth":3},{"value":"Стандарты и ошибки","id":"стандарты-и-ошибки","depth":2},{"value":"Что такое CAIP?","id":"что-такое-caip","depth":3},{"value":"Какой формат ошибок использует Vilna API?","id":"какой-формат-ошибок-использует-vilna-api","depth":3}],"frontmatter":{"seo":{"title":"FAQ - Часто задаваемые вопросы","description":"Ответы на частые вопросы о Vilna API: поддерживаемые сети, некастодиальная модель, аутентификация, мониторинг, вебхуки, стандарты и ошибки.","priority":0.5,"image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-faq.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Главная","item":"https://docs.vilna.io/ru/"},{"@type":"ListItem","position":2,"name":"Начало работы","item":"https://docs.vilna.io/ru/get-started"},{"@type":"ListItem","position":3,"name":"FAQ"}]},{"@type":"FAQPage","dateModified":"2026-11-01","mainEntity":[{"@type":"Question","name":"Какие блокчейны поддерживает Vilna?","acceptedAnswer":{"@type":"Answer","text":"Platform API поддерживает 5 основных и 4 тестовые сети. В 7 сетях доступен полный мониторинг; Solana Mainnet и Testnet поддерживают только адреса и каталог токенов. Идентификаторы CAIP-2 и возможности продуктов указаны в таблице сетей; GET /blockchains возвращает актуальный набор."}},{"@type":"Question","name":"Является ли Vilna кастодиальной? Хранит ли она ключи или средства?","acceptedAnswer":{"@type":"Answer","text":"Platform API наблюдает за публичной активностью и сверяет её; он не подписывает и не отправляет транзакции. VKS отдельно координирует создание блокчейн-аккаунтов, согласование и подпись с участием узлов подписи (signer); готовую транзакцию можно отправить узлу. Принятие узлом не означает подтверждения в блокчейне."}},{"@type":"Question","name":"В чем разница между Platform API, Management API, VKS и Blockchain RPC?","acceptedAnswer":{"@type":"Answer","text":"Platform API - для мониторинга блокчейна (адреса, балансы, транзакции, счета). Management API - для администрирования (рабочие пространства, проекты, участники, ключи). Blockchain RPC - прямой доступ к узлам по JSON-RPC и gRPC. VKS - настройка блокчейн-аккаунтов, согласование и совместная подпись. Для публичного API нужен отдельный VKS-ключ; сайт использует пользовательскую сессию."}},{"@type":"Question","name":"Как начать работу?","acceptedAnswer":{"@type":"Answer","text":"Зарегистрируйтесь на app.vilna.io, создайте рабочее пространство и проект, затем сгенерируйте API-ключ. Платформа бесплатна на этапе раннего доступа."}},{"@type":"Question","name":"Как пройти аутентификацию?","acceptedAnswer":{"@type":"Answer","text":"Передавайте API-ключ в заголовке X-Api-Key в каждом аутентифицированном API-запросе. Нет потока OAuth и нет токена, который нужно обновлять."}},{"@type":"Question","name":"Есть ли лимиты запросов?","acceptedAnswer":{"@type":"Answer","text":"Лимиты зависят от API и операции. Временное ограничение возвращает 429; соблюдайте правила повторов операции и Retry-After, если он есть. Формат ошибок RPC описан в разделе Ошибки."}},{"@type":"Question","name":"В чем разница между внешними и HD-адресами?","acceptedAnswer":{"@type":"Answer","text":"Внешние адреса импортируются указанием полной строки адреса. HD-адреса деривируются из расширенного публичного ключа (xPub) по стандартам BIP-32/44, что позволяет программно генерировать новые адреса без раскрытия приватных ключей."}},{"@type":"Question","name":"Можно ли отслеживать один адрес в нескольких сетях?","acceptedAnswer":{"@type":"Answer","text":"Да. Для EVM-совместимых сетей достаточно указать input.chain_family со значением evm при создании адреса, и он будет отслеживаться во всех активных EVM-сетях сразу."}},{"@type":"Question","name":"Как представлены суммы?","acceptedAnswer":{"@type":"Answer","text":"Многие суммы транзакций и балансов содержат base для точных вычислений и formatted для отображения. Поля счетов отличаются в аутентифицированных и публичных ответах; см. форматы сумм."}},{"@type":"Question","name":"Почему по токену, который я вижу в сети, нет баланса и уведомлений?","acceptedAnswer":{"@type":"Answer","text":"Балансы охватывают нативные монеты, проверенные и доверенные токены. Фильтр уведомлений о входящих переводах по умолчанию использует те же метки, но действие самого выбранного адреса тоже может дать основание; отключение фильтра допускает незнакомые токены. Разрешите контракт через POST /tokens/{chain_gid}/{asset_path}, затем POST .../actions/trust. Доверие к токену не создаёт уведомлений за прошлые транзакции."}},{"@type":"Question","name":"Насколько мониторинг приближен к реальному времени и когда срабатывает событие?","acceptedAnswer":{"@type":"Answer","text":"Подписка использует одно условие отправки уведомления (trigger): block ждёт фиксированное число блоков после включения, network ждёт собственной политики подтверждений сети, mempool (только Bitcoin) срабатывает до включения в блок. Для раннего сигнала и более позднего сигнала подтверждения создайте две подписки с разными условиями. Выполнение политики подтверждений не гарантирует необратимости."}},{"@type":"Question","name":"Какие методы уведомлений поддерживаются?","acceptedAnswer":{"@type":"Answer","text":"Два: вебхуки (подписанный HTTP POST на ваш эндпоинт) и Telegram (сообщения бота в чат)."}},{"@type":"Question","name":"Как проверить подлинность вебхука?","acceptedAnswer":{"@type":"Answer","text":"Проверьте заголовок X-Webhook-Signature (t=<unix>,v1=<hex>) - это HMAC-SHA256 от значения t, точки и сырых байтов тела запроса с ключом webhook_secret. Отбрасывайте доставки с устаревшей временной меткой и исключайте повторную обработку по X-Webhook-Event-Id. Пошаговый алгоритм есть на странице Webhooks."}},{"@type":"Question","name":"Можно ли тестировать вебхуки без реальных транзакций?","acceptedAnswer":{"@type":"Answer","text":"Да. Тест канала отправляет подписанный пример с is_test: true без реальной транзакции. Запрос возвращает 202 и notification_id; проверьте уведомление, чтобы подтвердить доставку. См. Проверка канала."}},{"@type":"Question","name":"Что произойдет, если мой эндпоинт для вебхуков недоступен?","acceptedAnswer":{"@type":"Answer","text":"Неудачные доставки (не 2xx или таймаут) повторяются по фиксированному расписанию с растущей задержкой. Повторы используют тот же event_id, поэтому обработчик может распознать повтор и не выполнять действие снова. Каждая попытка записывается в историю уведомлений. max_attempts ограничивает эти повторы; когда он исчерпан, канал отключается сам."}},{"@type":"Question","name":"Можно ли выключить автоматическое отключение канала?","acceptedAnswer":{"@type":"Answer","text":"Нет. Настройка - это max_attempts, от 1 до 10 на канал, повышается через PATCH /channels/{channel_id}. Когда уведомление исчерпало бюджет, канал отключается, а ожидающие уведомления отменяются; повторное включение принимает только новые транзакции."}},{"@type":"Question","name":"Мой канал отключился. Я потерял депозиты?","acceptedAnswer":{"@type":"Answer","text":"Нет. Транзакции, активность и балансы записываются независимо от того, ушло ли уведомление; отменены только доставки. Опрашивайте GET /channels по is_enabled. После включения запросите отменённые уведомления и активность за это окно и отправьте заново те, у которых ещё сохранено тело уведомления."}},{"@type":"Question","name":"Нужна ли клиентская библиотека для работы с API?","acceptedAnswer":{"@type":"Answer","text":"Нет. Vilna - это стандартный REST API, который можно вызывать из любого языка через HTTP. Если нужен типизированный клиент, сгенерируйте его из OpenAPI-спецификации."}},{"@type":"Question","name":"Можно ли ускорить интеграцию с помощью ИИ-ассистента?","acceptedAnswer":{"@type":"Answer","text":"Да. MCP-сервер документации Vilna позволяет Claude и другим MCP-клиентам читать полный справочник API в контексте и генерировать корректные вызовы. См. Интеграция с ИИ."}},{"@type":"Question","name":"Что такое CAIP?","acceptedAnswer":{"@type":"Answer","text":"Chain Agnostic Improvement Proposals - единая форма идентификатора для сетей (CAIP-2), адресов в конкретной сети (CAIP-10) и активов (CAIP-19) в разных сетях. Vilna использует их по всему API."}},{"@type":"Question","name":"Какой формат ошибок использует API?","acceptedAnswer":{"@type":"Answer","text":"Platform, Management и VKS HTTP API используют RFC 7807 Problem Details (application/problem+json). Проверяйте машинный code; для Blockchain RPC действует модель ошибок протокола. См. Ошибки."}}]}]}}},"lastModified":"2026-10-31T22:26:19.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/get-started/faq","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}