The Core Platform is the operational heart of Vilna, providing real-time blockchain monitoring, wallet generation, and comprehensive data analytics. It serves as the foundation for building any crypto-related application - from simple payment processors to complex DeFi platforms.
The Core Platform solves fundamental challenges in blockchain integration:
- Wallet Management: Generate and organize millions of addresses from a single xPub key
- Real-time Monitoring: Track blockchain activity across multiple networks simultaneously
- Data Access: Query historical transactions and current balances instantly
- Event Notifications: Receive alerts when specific blockchain events occur
Exchanges need to manage millions of user deposit addresses while tracking all incoming transactions:
Implementation approach:
- Import exchange's xPub key using
POST /xpubs - Generate unique addresses per user with
POST /addresses/generate/xpub/next - Set up webhook notifications for incoming transactions
- Process deposits automatically when confirmations reach threshold
Payment processors need to create unique addresses for each invoice and verify payments:
Key requirements:
- Generate payment addresses on demand
- Monitor for exact payment amounts
- Handle partial payments and overpayments
- Support multiple cryptocurrencies
Solution with Vilna:
- Use address generation API to create unique payment addresses
- Configure webhooks to receive payment notifications
- Query balance API to verify payment amounts
- Track transaction history for reconciliation
DeFi platforms need to aggregate user positions across multiple protocols:
Monitoring requirements:
- Track user wallet balances across chains
- Monitor liquidity pool positions
- Calculate total portfolio value
- Detect DeFi protocol interactions
Vilna enables:
- Bulk import user addresses for monitoring
- Real-time balance tracking across all supported tokens
- Historical data for portfolio performance analysis
- Event notifications for position changes
Generate HD wallet addresses following BIP32/44/84 standards. The system maintains:
- Sequential address generation with gap limit handling
- Address labeling and metadata storage
- Automatic monitoring of all generated addresses
- Support for multiple derivation paths
Relevant API endpoints:
POST /xpubs- Import xPub keysPOST /addresses/generate/xpub/next- Generate next addressGET /addresses- List all addresses
The monitoring engine continuously scans multiple blockchains for activity on tracked addresses:
Supported networks:
- EVM chains (Ethereum, BSC, Polygon, Arbitrum, Optimism)
- Bitcoin and Bitcoin-compatible chains
- Layer 2 solutions
- Alternative chains (Solana, TON, etc.)
Monitoring capabilities:
- Transaction detection (pending and confirmed)
- Token transfers (ERC-20, BEP-20, SPL)
- NFT movements
- Smart contract interactions
- Internal transactions
Configure real-time alerts for blockchain events:
Webhook notifications:
- HTTP POST requests to your endpoints
- HMAC signature for security
- Automatic retry with exponential backoff
- Delivery status tracking
Email alerts:
- Customizable templates
- Threshold-based triggers
- Daily summary reports
- Critical event notifications
Event types:
transaction.pending- Unconfirmed transaction detectedtransaction.confirmed- Transaction reached confirmation thresholdbalance.changed- Address balance updatedtoken.received- ERC-20/BEP-20 token transfer detected
Access comprehensive blockchain data through the API:
Balance queries:
- Current balance per address
- Multi-token balance aggregation
- USD value calculation
- Balance history snapshots
Transaction history:
- Complete transaction records
- Advanced filtering options
- Token transfer details
- Gas usage analytics
Relevant API endpoints:
GET /addresses/{address}/balances- Get current balancesGET /transactions- Query transaction history
For applications handling thousands of addresses:
- Use bulk import for existing addresses
- Implement webhook queuing for high-volume notifications
- Cache balance data locally with periodic updates
- Use pagination for large data queries
- No private keys: Core Platform operates in watch-only mode
- HMAC verification: Validate all webhook signatures
- Rate limiting: Implement appropriate throttling
- Idempotency: Handle duplicate notifications gracefully
- Batch operations: Group multiple requests when possible
- Webhook filtering: Subscribe only to needed events
- Local caching: Store frequently accessed data
- Efficient querying: Use appropriate filters and pagination
Advantages:
- No infrastructure maintenance required
- Multi-chain support without multiple nodes
- Built-in notification system
- Automatic token discovery
When to use Vilna:
- Need multi-chain support
- Want to focus on business logic
- Require reliable uptime without DevOps overhead
Unique features:
- xPub-based address generation
- Unified API across all blockchains
- Custom notification rules
- Enterprise-grade reliability
- Define your requirements: Identify which blockchains and events you need to monitor
- Import addresses: Use xPub keys for new addresses or bulk import existing ones
- Configure notifications: Set up webhooks or email alerts for relevant events
- Integrate API: Use the REST API for balance and transaction queries
For implementation details, refer to:
- Quick Start Guide - Step-by-step setup instructions
- API Reference - Complete API documentation
- Notification Channels - Webhook and email configuration
- Architecture Overview - Understand the complete platform
- Transaction Processing - Learn about transaction creation and signing
- MPC Key Management - Explore advanced security options