Skip to content
Last updated

Changelog

Updates to the APIs, dashboard and documentation. Entry dates use UTC. For questions, contact support@vilna.io.

LatestPlatform API · Management API · VKS
Resource limits
  • Added

    Resource usage and limits - Read current usage and effective maxima through the Platform, Management and VKS APIs. Platform reads require the new api:limits:read permission; existing keys do not receive it automatically.

Platform API
  • Added

    Balance summary amount filters - Balance summaries accept optional min_amount and max_amount. Bounds are inclusive integer strings in the asset's smallest unit. Set min_amount=1 to select known positive balances. Filtering applies before pagination and total counting; unknown amounts are excluded.

VKS
  • Improved

    Typed transaction actions - Transaction parameters identify the blockchain family and action, including Tron resource actions. Responses include normalized transaction parameters. See the VKS reference for the available actions and their requirements.

Platform API · Management API
API permissions
  • Improved

    Separate access to activity - Reading activity in Platform API v2 requires api:activity:read. Transaction lists and details continue to use api:transaction:read. Existing keys retained their activity access when this permission was introduced; new keys select the two permissions separately. See Permissions.

  • Improved

    Management-key permissions - Management keys can create and revoke API/RPC keys within their assigned permissions. Listing, reading, creating or revoking Management keys requires a user session with the appropriate workspace permissions.

Platform API
Invoices
  • fixed

    Cancellation based on recorded payments - An open or processing invoice can be cancelled when none of its recorded valid payments is awaiting confirmation and the confirmed amount is below the requested amount. A confirmed partial payment does not prevent cancellation. An unmet cancellation condition returns 422 rather than an internal server error.

  • Improved

    Payment links after cancellation - No new payments are linked to a cancelled invoice, including payments discovered later with an earlier block time. Existing links remain, and the address can be reused for another invoice. See Cancel an invoice.

Platform API
Invoices
  • Improved

    Payment windows and confirmations - Invoice payment matching takes the block's timestamp into account. After the payment window ends, processing keeps pending checks and confirmations distinct from a completed invoice. Received and confirmed amounts remain separate. See Invoice lifecycle.

Platform API
Addresses
  • fixed

    EVM address matching - EVM addresses are normalized when supplied to the API, so letter case does not prevent matching an address to its recorded data.

Platform API
Webhooks
  • fixed

    Version 1 payload compatibility - Channels with payload_version: v1 retain the earlier chain and asset identifiers. Webhook payload versions remain independent of the Platform API version. See Webhooks.

Management API · VKS
VKS access
  • Added

    Workspace access and keys - VKS has a workspace-scoped key with vks:access. Authorized users manage member access in the dashboard; related changes appear in the workspace audit history. See VKS permissions.

Platform API · Management API
Limits
  • Improved

    Quota responses - Platform API v2 and Management return structured 429 responses for resource quotas and action limits. Error codes distinguish quota exhaustion from action-rate limits; recovery depends on the reported limit. See Rate limits and quotas.

Platform API · Management API · VKS
Request retries
  • Added

    Idempotency keys - Mutations in Platform API v2, Management and VKS use Idempotency-Key to identify an operation. Keep the same key and request when retrying an unknown outcome; a new key represents a new intent. Replay windows and recovery steps are described in Idempotency.

Platform API · Documentation · Dashboard

This entry records the Platform API v2 changes. The reference describes https://api.vilna.io/v2. Platform API v1 retires on November 1, 2026; its deprecated reference remains at /apis/platform/v1 after retirement.

Platform API Documentation Dashboard

Platform API
  • Added

    Normalized blockchain data - Transactions use chain_gid, txid and family-specific details; decoded events and per-address activity share the current Platform data model. See Events.

  • Added

    Balances by chain family - Search and summarize balances within a selected family. is_sync describes freshness; an unknown amount is absent rather than zero. See Tokens and balances.

  • Added

    Subscription triggers - Choose block, network or Bitcoin mempool for each subscription. Trigger choice, filtering and reorganization handling are described in Events.

  • Added

    Delivery history and recovery - Notification history includes delivery attempts and manual resend outcomes. Channels expose their enabled state and retry budget. See Notification channels.

  • Added

    Token catalog and trust - Token metadata distinguishes catalog support, shared verification and project trust. See Tokens and balances.

  • Added

    Invoice reconciliation - Invoice lifecycle and received/confirmed amounts are separate facts. See Invoices for partial payments, cancellation and the public view.

  • Added

    Network coverage - 7 networks provide full monitoring; Solana supports addresses and the token catalog. See the network matrix for capabilities by product.

  • Added

    EVM simulation - Preview calls, decoded events, balance effects and execution errors without broadcasting. See Transaction simulation.

Documentation
  • Improved

    Rebuilt information architecture - Get Started, Guides and API Reference are now three focused sections, each with its own sidebar and built-in previous/next navigation.

  • Added

    New navigation - a mega-menu across the top and an All guides index so you can find any guide at a glance.

  • Improved

    Every guide redesigned - integration patterns, events, notification channels, invoices, transaction simulation and AI integration now lead with visual, scannable layouts.

  • Improved

    API Reference refreshed - Authentication, Permissions, Errors and Standards rewritten with clearer examples and a consistent layout.

  • Added

    Brand refresh - new colors, typography and components throughout, with full English and Russian across the site.

  • Added

    Versioned reference - v2 is the default, and /v1 stays available at /apis/platform/v1 with a version picker in the sidebar.

  • Added

    A reimagined homepage - a clearer introduction to what Vilna does, with an animated sample API preview.

  • Added

    Interactive quickstart - explore a fixed sample request and response, then use the guides and reference to make a request from your own terminal. The sample does not send a request or validate credentials.

Dashboard
  • Improved

    Redesigned interface - manage workspaces, projects, API keys and members from a cleaner, faster dashboard.

  • Improved

    Reworked navigation matched to the new brand, with light and dark themes.

Platform API · Documentation

A full rebuild of the platform architecture and API surface - the first beta open for integration.

Platform API Documentation

Platform API
  • Added

    Core resources - the first set of REST resources: public keys, addresses, transactions, balances, tokens and notification channels, with consistent pagination.

  • Added

    EVM simulation - preview an EVM call's outcome before broadcasting it.

  • Improved

    API-key authentication and rate limits - every call is authenticated and rate-limited.

Documentation
  • Added

    A documentation site - the first version of docs.vilna.io, with an interactive API reference.

  • Added

    English and Russian - full bilingual coverage across the docs.

Developer experience
  • Added

    OpenAPI 3.1 spec - the contract published as a machine-readable spec.

  • Added

    CAIP and BIP-44 standards - CAIP-2, CAIP-10 and CAIP-19 for chain and asset identifiers, BIP-44 for derivation paths.

  • Improved

    Webhooks with retries - a failed delivery retries automatically.

Platform API

The first prototype release, with the platform's core capabilities.

Platform API
  • Added

    Transaction and transfer monitoring - track transactions and transfers as they happen on chain.

  • Added

    HD wallets - wallet generation from an extended public key, derived by BIP-44.

  • Added

    Webhooks and email - notifications for blockchain events, delivered as webhooks or email.

  • Added

    Access by request - through support@vilna.io.