# Changelog

All notable changes to the Vilna API will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0-beta.2] - 2026-02-22

This release is a full redesign of the platform architecture and API surface. It represents a stable, production-ready beta ready for integration and early adoption.

**Access**: Available by request at [support@vilna.io](mailto:support@vilna.io)

### Platform

- **Added:** 31 blockchain networks - Ethereum, Bitcoin, Tron, Solana, TON, Cosmos, BSC, Polygon, Arbitrum, Optimism, Avalanche, Base, and 19 more. Each network supports address derivation, balance tracking, and transaction monitoring.
- **Added:** Core API resources - Public Keys, Addresses, Transactions, Balances, Tokens, and Notification Channels. Consistent REST interface across all resources with page-based pagination.
- **Added:** Transaction processing - Query transactions, simulate EVM calls. Pre-execution preview shows expected outcomes before broadcasting.
- **Improved:** Security model - API key authentication, rate limiting. All API calls are authenticated and auditable.


### Documentation

- **Added:** New documentation site - Built on Redocly Realm at [docs.vilna.io](https://docs.vilna.io). Covers platform overview, integration guides, and full API reference.
- **Added:** Interactive API reference - Generated from OpenAPI 3.1 spec with try-it-out functionality, request/response examples, and schema documentation.
- **Added:** Bilingual support - Full English and Russian localization for all documentation and UI.
- **Added:** Business documentation - Use cases, adoption guides, and access plans for non-technical stakeholders.


### Developer experience

- **Added:** TypeScript SDK - `@vilna/sdk` package with typed API client and automatic pagination.
- **Added:** OpenAPI 3.1 specification - 50+ endpoints fully documented. Machine-readable spec enables code generation for any language.
- **Added:** Standards compliance - CAIP-2 for chain identification, CAIP-10 for account addresses, CAIP-19 for asset types, BIP-44 for HD wallet derivation paths.
- **Improved:** Webhook system - Real-time notifications for balance changes, transaction confirmations, and address activity, with retry logic. HMAC signature verification is planned for an upcoming release.


### Migration from 1.0.0-beta

If you integrated with the initial beta, note the following changes:

- The API has been completely rebuilt. All endpoints have new request/response schemas.
- Base URL format changed to `https://{namespace}.vilna.app`.
- Authentication uses the `X-Api-Key` header.
- See the [Platform API](/apis/platform/) for the current specification.


## [1.0.0-beta] - 2025-09-17

Initial prototype release with core platform capabilities.

- **Blockchain monitoring** - Transaction and ERC-20/BEP-20 transfer tracking across Ethereum, BSC, Polygon, and Arbitrum
- **HD wallet support** - Wallet generation from xPub keys with BIP-44 derivation
- **Notification system** - Webhooks and email notifications for blockchain events
- **Beta access program** - Available by request at [support@vilna.io](mailto:support@vilna.io)


## Where to go next

Quickstart
Get started with the API in 10 minutes

Overview
High-level introduction to the Vilna platform