{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/get-started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["quickfacts","fact","howvilna","trust","trustcell","patternfinder","patterncard"]},"type":"markdown"},"seo":{"title":"Основные концепции - как устроена Vilna","projectTitle":"Vilna Docs","description":"Мониторинг Platform, доступ RPC, управление пространством и отдельный процесс подписи VKS.","siteUrl":"https://docs.vilna.io","lang":"en-US","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-core-concepts.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.7,"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":"Основные концепции"}]},{"@type":"TechArticle","headline":"Основные концепции - как устроена платформа Vilna","description":"Мониторинг Platform, доступ RPC, управление пространством и отдельный процесс подписи VKS.","url":"https://docs.vilna.io/ru/get-started/core-concepts","datePublished":"2025-09-17","dateModified":"2026-10-31","proficiencyLevel":"Beginner","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-core-concepts.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"основные-концепции","__idx":0},"children":["Основные концепции"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform API Vilna отслеживает адреса, кошельки и входящие платежи и возвращает нормализованные данные через REST API и уведомления о событиях. Он использует публичные данные блокчейна. Поддерживаемые основные и тестовые сети перечислены в разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/networks#table"},"children":["Сети"]},"; Solana поддерживает только регистрацию адресов и каталог токенов."]},{"$$mdtype":"Tag","name":"QuickFacts","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Fact","attributes":{"icon":"lock"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Некастодиальность"]}," в основе"]}," ",{"$$mdtype":"Tag","name":"Fact","attributes":{"icon":"globe"},"children":["Один API, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["9"]}," сетей"]}," ",{"$$mdtype":"Tag","name":"Fact","attributes":{"icon":"check-double"},"children":["Открытые ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["стандарты"]}]}," ",{"$$mdtype":"Tag","name":"Fact","attributes":{"icon":"scale"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Без процента"]}," с ваших средств"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"how","level":2,"__idx":1},"children":["Как работает Vilna "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Platform API предоставляет приложению нормализованные данные публичных блокчейнов. В зависимости от сети он регистрирует адреса, читает балансы и транзакции, отслеживает подтверждения и отправляет уведомления по выбранному условию подписки. Доступные возможности приведены в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/networks"},"children":["таблице сетей"]},"."]},{"$$mdtype":"Tag","name":"HowVilna","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Поскольку Platform API читает данные блокчейна, он работает исключительно с ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["публичной информацией"]},": адресами блокчейна и расширенными публичными ключами. Он никогда не запрашивает и не хранит приватные ключи или seed-фразы и не может подписать или транслировать транзакцию. Ваши ключи и средства остаются ровно там, где они есть."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Эти принципы мониторинга относятся к Platform API. VKS - отдельный сценарий подписи; см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#surfaces"},"children":["API для разных задач"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"principles","level":2,"__idx":2},"children":["Построено безопасно и открыто "]},{"$$mdtype":"Tag","name":"Trust","attributes":{"title":"Базовые гарантии","icon":"shield"},"children":[{"$$mdtype":"Tag","name":"TrustCell","attributes":{"title":"Некастодиальность","icon":"lock"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Мониторинг Platform использует публичные данные блокчейна: адреса и публичные ключи, никогда приватные ключи или seed-фразы. Он не может двигать ваши средства."]}]},{"$$mdtype":"Tag","name":"TrustCell","attributes":{"title":"Без процента с ваших средств","icon":"scale"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Поскольку мониторинг Platform не касается ваших денег, она не берёт процент ни с одного платежа или транзакции, за которыми наблюдает."]}]},{"$$mdtype":"Tag","name":"TrustCell","attributes":{"title":"Стандарты в основе","icon":"check-double"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Открытые спецификации повсюду: идентификаторы CAIP для сетей и активов, деривация BIP-32/44, ошибки RFC 7807. Никаких закрытых форматов."]}]},{"$$mdtype":"Tag","name":"TrustCell","attributes":{"title":"Вне зависимости от сети","icon":"globe"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Один REST API и единый формат ответа для каждой сети. Добавление сети не меняет вашу интеграцию."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"surfaces","level":2,"__idx":3},"children":["API для разных задач "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["У каждого сервиса свои ключи и область доступа. Создайте рабочее пространство и ключи в кабинете, затем используйте документированные публичные операции:"]},{"$$mdtype":"Tag","name":"PatternFinder","attributes":{},"children":[{"$$mdtype":"Tag","name":"PatternCard","attributes":{"to":"/ru/apis/platform","title":"Platform API","tags":"Адреса, Балансы, Транзакции, Счета, Вебхуки"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Следите за адресами и кошельками, читайте балансы и транзакции, сверяйте входящие платежи и получайте уведомления об активности."]}]},{"$$mdtype":"Tag","name":"PatternCard","attributes":{"to":"/ru/apis/rpc","title":"Blockchain RPC","tags":"JSON-RPC, gRPC, Любая сеть"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Обращайтесь к узлам блокчейна напрямую во всех поддерживаемых сетях через единый эндпоинт и один ключ, без своей инфраструктуры."]}]},{"$$mdtype":"Tag","name":"PatternCard","attributes":{"to":"/ru/apis/mgmt","title":"Management API","tags":"Пространства, Проекты, Участники, Ключи"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Используйте публичные операции пространств, проектов и участников; начальная настройка и часть действий с ключами требуют кабинета."]}]},{"$$mdtype":"Tag","name":"PatternCard","attributes":{"to":"/ru/apis/vks","title":"VKS API","tags":"Signer, Vault, Блокчейн-аккаунты, Подпись"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["VKS координирует настройку блокчейн-аккаунтов, согласование и совместную подпись через узлы подписи (signer). Готовую подписанную транзакцию можно отправить узлу блокчейна через VKS. Принятие узлом не означает подтверждения в блокчейне."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Впервые столкнулись с базовыми идеями - адреса, ключи и HD-деривация? Начните с ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/blockchain-basics"},"children":["Основ блокчейна"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"amounts","level":2,"__idx":4},"children":["Данные, на которые можно положиться "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Для событий Platform API, из какой бы сети ни пришло событие, формат ответа один и тот же, поэтому код пишется один раз, а не отдельно под каждую сеть."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Суммы."]}," Многие поля транзакций и балансов содержат ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]}," (строку целого числа в наименьших единицах токена) и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted"]}," (текст для отображения). В аутентифицированном счёте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["received_amount"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["confirmed_amount"]}," - строки базовых единиц; публичное представление содержит ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]}," и необязательный ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted"]},". Следуйте схеме конкретного поля. Для вычислений используйте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BigInt"]}," или библиотеку точной десятичной арифметики, для отображения - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["decimals"]}," из метаданных точного токена. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/invoices#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%B8%D1%82%D1%8C-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81-%D1%81%D1%87%D1%91%D1%82%D0%B0"},"children":["форматирование суммы счёта"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Связанные данные."]}," Ответы содержат объект ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["references"]}," со связанными токенами, сетями и адресами, так что результат можно отрисовать без дополнительных запросов."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Стабильные идентификаторы."]}," Сети, адреса в конкретных сетях и активы названы идентификаторами ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/standards#caip"},"children":["CAIP"]},", единая форма идентификатора везде."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Полный справочник ресурсов смотрите в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform"},"children":["Platform API"]},", а форматы идентификаторов - в ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/standards"},"children":["Стандартах"]},"."]}]},"headings":[{"value":"Основные концепции","id":"основные-концепции","depth":1},{"value":"Как работает Vilna","id":"how","depth":2},{"value":"Построено безопасно и открыто","id":"principles","depth":2},{"value":"API для разных задач","id":"surfaces","depth":2},{"value":"Данные, на которые можно положиться","id":"amounts","depth":2}],"frontmatter":{"seo":{"title":"Основные концепции - как устроена Vilna","description":"Мониторинг Platform, доступ RPC, управление пространством и отдельный процесс подписи VKS.","priority":0.7,"image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-core-concepts.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":"Основные концепции"}]},{"@type":"TechArticle","headline":"Основные концепции - как устроена платформа Vilna","description":"Мониторинг Platform, доступ RPC, управление пространством и отдельный процесс подписи VKS.","url":"https://docs.vilna.io/ru/get-started/core-concepts","datePublished":"2025-09-17","dateModified":"2026-10-31","proficiencyLevel":"Beginner","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-core-concepts.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}}},"lastModified":"2026-10-31T22:07:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/get-started/core-concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}