{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-apis/rpc/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","cards","card"]},"type":"markdown"},"seo":{"title":"Blockchain RPC - Node Access","projectTitle":"Vilna Docs","description":"Access blockchain nodes through a single endpoint. HTTP JSON-RPC and gRPC with one API key for all supported chains.","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/rpc.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.7,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Blockchain RPC"}]},{"@type":"TechArticle","headline":"Blockchain RPC - Node Access","description":"Access blockchain nodes through a single endpoint. HTTP JSON-RPC and gRPC with one API key for all supported chains.","url":"https://docs.vilna.io/apis/rpc","datePublished":"2025-09-17","proficiencyLevel":"Intermediate","dependencies":"Vilna RPC key","image":"https://cdn.vilna.io/docs/previews/rpc.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":"blockchain-rpc","__idx":0},"children":["Blockchain RPC"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna RPC provides access to blockchain nodes across multiple networks through a single endpoint. Send standard JSON-RPC requests over HTTP or gRPC calls - using one API key for all supported chains. No node infrastructure to manage, no per-chain configuration."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTP Base URL:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://rpc.vilna.io"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gRPC endpoint:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["grpc.vilna.io:443"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":1},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every request must include an RPC key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vilna_rpc_"]}," prefix) in the appropriate header. Create RPC keys in your workspace settings at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.vilna.io"},"children":["app.vilna.io"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Protocol"},"children":["Protocol"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HTTP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Api-Key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your API key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gRPC"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-api-key"]}," (metadata)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your API key"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-protocols","__idx":2},"children":["Supported protocols"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna RPC supports two protocols depending on the blockchain:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/rpc/json-rpc"},"children":["JSON-RPC over HTTP"]}]}," - for EVM chains, Solana, and Bitcoin. Standard JSON-RPC 2.0 format over HTTPS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/rpc/grpc"},"children":["gRPC"]}]}," - for Tron. Native gRPC protocol with metadata-based chain routing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-networks","__idx":3},"children":["Supported networks"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Network"},"children":["Network"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"CAIP-2 ID"},"children":["CAIP-2 ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Alias"},"children":["Alias"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Protocol"},"children":["Protocol"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum Mainnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ethereum"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BNB Smart Chain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:56"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bsc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BNB Smart Chain Testnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:97"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bsc-testnet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum Hoodi"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:560048"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hoodi"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ethereum Sepolia"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:11155111"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sepolia"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Solana Mainnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana:mainnet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Solana Testnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana:testnet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana-testnet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bitcoin Mainnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122:000000000019d6689c085ae165831e93"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bitcoin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bitcoin Testnet4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bip122:00000000da84f2bafbbc53dee25a72ae"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bitcoin-testnet4"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["JSON-RPC"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tron Mainnet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tron:mainnet"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tron"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gRPC"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The list of supported networks is expanding. Testnet networks are available for development and testing."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Chain identification"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can identify a chain by either its CAIP-2 ID or its alias - both are accepted in URLs (HTTP) and metadata (gRPC). See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/caip-standards"},"children":["CAIP Standards"]}," for details."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"health-check","__idx":4},"children":["Health check"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check service availability without authentication:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl https://rpc.vilna.io/health\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\"status\": \"ok\"}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":5},"children":["Further reading"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"JSON-RPC","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/rpc/json-rpc"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HTTP requests for Ethereum, Solana, Bitcoin, and other chains"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"gRPC","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/rpc/grpc"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["gRPC node access for Tron"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"CAIP Standards","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/platform/caip-standards"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Chain and asset identification formats"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Errors","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/errors"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common API error handling and troubleshooting"]}]}]}]},"headings":[{"value":"Blockchain RPC","id":"blockchain-rpc","depth":1},{"value":"Authentication","id":"authentication","depth":2},{"value":"Supported protocols","id":"supported-protocols","depth":2},{"value":"Supported networks","id":"supported-networks","depth":2},{"value":"Health check","id":"health-check","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"seo":{"title":"Blockchain RPC - Node Access","description":"Access blockchain nodes through a single endpoint. HTTP JSON-RPC and gRPC with one API key for all supported chains.","priority":0.7,"image":"https://cdn.vilna.io/docs/previews/rpc.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Blockchain RPC"}]},{"@type":"TechArticle","headline":"Blockchain RPC - Node Access","description":"Access blockchain nodes through a single endpoint. HTTP JSON-RPC and gRPC with one API key for all supported chains.","url":"https://docs.vilna.io/apis/rpc","datePublished":"2025-09-17","proficiencyLevel":"Intermediate","dependencies":"Vilna RPC key","image":"https://cdn.vilna.io/docs/previews/rpc.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}}},"lastModified":"2026-04-21T06:58:04.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/rpc","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}