{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Non-custodial Service Notice","projectTitle":"Vilna Docs","description":"How Vilna works as non-custodial blockchain infrastructure. Vilna never holds private keys or customer funds and does not move or settle crypto-assets.","siteUrl":"https://docs.vilna.io","keywords":["crypto asset management","blockchain monitoring","digital asset security","cryptocurrency API","wallet tracking","blockchain analytics","enterprise crypto","real-time blockchain","CAIP-19","BIP44"],"lang":"en-US","image":"https://cdn.vilna.io/docs/previews/preview.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"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna is a blockchain monitoring and wallet management platform. It provides a single unified REST API for tracking addresses, transactions, balances, and activity across top blockchains - Bitcoin, Ethereum, Solana, TRON, TON, Cosmos, and others. The API uses CAIP-2/CAIP-19 standards for cross-chain identification, HD wallet management (BIP-32/44) for address derivation, and RFC 7807 for error responses. Authentication is via API key in the X-Api-Key header.\n","excludeFiles":["legal/**/*.md","@l10n/**/*.md"],"sections":[{"title":"Overview","description":"What Vilna is, supported blockchains, and target audience","includeFiles":["overview.md"],"excludeFiles":[]},{"title":"Getting Started","description":"Quickstart guide and core API concepts","includeFiles":["guides/quickstart.md","guides/dashboard.md","guides/core-concepts.md","guides/authentication.md"],"excludeFiles":[]},{"title":"API Reference","description":"Platform API and Management API endpoint documentation","includeFiles":["apis/platform/index.md","apis/mgmt/index.md","apis/rpc/index.md","apis/platform/api.yaml","apis/mgmt/api.yaml"],"excludeFiles":[]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, SDK, and error handling","includeFiles":["guides/events.md","guides/channels.md","guides/integration-patterns.md","guides/sdk.md","guides/mcp.md","guides/errors.md","guides/simulation.md","guides/invoices.md"],"excludeFiles":[]},{"title":"Business","description":"Value proposition, use cases, and onboarding","includeFiles":["business/index.md","business/use-cases.md"],"excludeFiles":[]},{"title":"Optional","description":"Additional reference material","includeFiles":["guides/blockchain-basics.md","guides/faq.md","apis/mgmt/guide.md","guides/widget.md","guides/storage-client.md","apis/platform/caip-standards.md","apis/mgmt/authorization.md"],"excludeFiles":[]}],"hide":false},"priority":0.2},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"non-custodial-service-notice","__idx":0},"children":["Non-custodial service notice"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated: May 26, 2026"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page explains how the Vilna service works and where its boundaries are. It is part of our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/legal/terms"},"children":["Legal Terms"]}," and is meant to be read alongside them. It is not legal or financial advice."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-vilna-is","__idx":1},"children":["What Vilna is"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna is software and blockchain-data infrastructure. We watch public blockchains on your behalf and tell you what happened on them. Specifically, the service:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["imports the addresses or extended public keys (xPub) that you provide;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["derives addresses from your extended public key;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["monitors those addresses on public blockchains;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["detects incoming transactions, partial payments, overpayments, and confirmations;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["sends you webhooks and events, and helps you reconcile what you see on-chain."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-vilna-does-not-do","__idx":2},"children":["What Vilna does not do"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna is non-custodial. We never take possession or control of your crypto-assets or your keys. In plain terms:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not hold, store, or have access to your private keys, seed phrases, or recovery material."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not hold customer funds at any point."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not initiate, sign, route, relay, or broadcast transactions for you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not move, sweep, pool, convert, or settle crypto-assets."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["We do not issue refunds or payouts, and we do not act as an intermediary in any transfer."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Receiving wallets are yours. The addresses you monitor with Vilna are yours - addresses you provide, or derive from your own extended public key - and they stay under your control. When someone pays an invoice, they sign and broadcast that transaction from their own wallet, and the funds move directly to your wallet on the blockchain. Vilna observes that settlement. It does not carry it out."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-this-means-for-you","__idx":3},"children":["What this means for you"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because Vilna does not handle funds, you remain the operator of your own payment flow. That carries some responsibilities:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You control the wallet."]}," Keep your keys and extended public keys safe. We cannot recover funds, reverse a transaction, or regain access to a wallet for you."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You handle refunds and payouts"]}," from your own wallet, outside Vilna."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You are responsible for your own compliance"]}," with the laws that apply to your business, including any registration, licensing, tax, AML, or consumer-protection obligations. Whether and how a regulator treats your activity depends on what you do, not only on the tools you use."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"a-note-on-stablecoins","__idx":4},"children":["A note on stablecoins"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Support for specific tokens and networks can change. Some stablecoins are restricted or unavailable in certain regions, and rules in the EU and elsewhere continue to develop. Vilna does not guarantee the fiat value, redemption, or availability of any token. Check that a token and network suit your jurisdiction before relying on it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"questions","__idx":5},"children":["Questions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If anything here is unclear, write to us at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@vilna.io"},"children":["support@vilna.io"]}," before you build on assumptions about how the service works."]}]},"headings":[{"value":"Non-custodial service notice","id":"non-custodial-service-notice","depth":1},{"value":"What Vilna is","id":"what-vilna-is","depth":2},{"value":"What Vilna does not do","id":"what-vilna-does-not-do","depth":2},{"value":"What this means for you","id":"what-this-means-for-you","depth":2},{"value":"A note on stablecoins","id":"a-note-on-stablecoins","depth":2},{"value":"Questions","id":"questions","depth":2}],"frontmatter":{"seo":{"title":"Non-custodial Service Notice","description":"How Vilna works as non-custodial blockchain infrastructure. Vilna never holds private keys or customer funds and does not move or settle crypto-assets.","priority":0.2}},"lastModified":"2026-05-26T20:25:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/legal/non-custodial","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}