Updates to the APIs, dashboard and documentation. Entry dates use UTC. For questions, contact support@vilna.io.
- 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:readpermission; existing keys do not receive it automatically.
- Added
Balance summary amount filters - Balance summaries accept optional
min_amountandmax_amount. Bounds are inclusive integer strings in the asset's smallest unit. Setmin_amount=1to select known positive balances. Filtering applies before pagination and total counting; unknown amounts are excluded.
- 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.
- Improved
Separate access to activity - Reading activity in Platform API v2 requires
api:activity:read. Transaction lists and details continue to useapi: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.
- 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
422rather 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.
- Improved
Payment windows and confirmations - Invoice payment matching takes the block's timestamp into account. After the payment window ends,
processingkeeps pending checks and confirmations distinct from a completed invoice. Received and confirmed amounts remain separate. See Invoice lifecycle.
- 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.
- fixed
Version 1 payload compatibility - Channels with
payload_version: v1retain the earlier chain and asset identifiers. Webhook payload versions remain independent of the Platform API version. See Webhooks.
- 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.
- Improved
Quota responses - Platform API v2 and Management return structured
429responses 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.
- Added
Idempotency keys - Mutations in Platform API v2, Management and VKS use
Idempotency-Keyto 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.
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
- Added
Normalized blockchain data - Transactions use
chain_gid,txidand family-specificdetails; 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_syncdescribes freshness; an unknown amount is absent rather than zero. See Tokens and balances. - Added
Subscription triggers - Choose
block,networkor Bitcoinmempoolfor 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.
- 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
/v1stays 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.
- 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.
A full rebuild of the platform architecture and API surface - the first beta open for integration.
Platform API Documentation
- 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.
- 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.
- 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.
The first prototype release, with the platform's core capabilities.
- 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.