Skip to content
Last updated

How Vilna Works

Vilna provides a comprehensive platform for enterprise-grade crypto asset management, combining cutting-edge security with powerful monitoring capabilities. The platform consists of three interconnected modules that work together to provide complete control over digital assets.

Platform Architecture

Module 3: Transaction Processing
Module 2: Vilna Core
External Sources
Module 1: MPC Key Management (Optional)
Transaction Initiation
Transaction Simulation
Secure Signing
Broadcasting
Address Monitoring
Wallet Generation
Real-time Notifications
Transaction History
Balance Tracking
Existing xPub Keys
Hardware Wallets
Software Wallets
Third-party Services
Key Generation with CGGMP
Key Shards Distribution
MPC Infrastructure
Extended Public Key Export

Key Integration Flexibility: Vilna supports multiple approaches for key management. While Module 1 provides enterprise-grade MPC key generation and management, you can also import existing xPub keys from any source - hardware wallets (Ledger, Trezor), software wallets, or third-party custody services. This flexibility allows organizations to integrate Vilna with their existing infrastructure while maintaining the option to upgrade to MPC-based security when needed.

Module 1: MPC Key Management

Secure Key Generation with Sharding

Vilna implements the CGGMP (Canetti-Gennaro-Goldfeder-Makriyannis-Peled) algorithm for threshold signature generation, providing institutional-grade security for private key management.

Key Generation Process
Generate Key Shards
Initialize CGGMP Protocol
Distribute to Parties
Derive xPub Key
Import to Vilna

Key Features:

  • Distributed Key Generation: Private keys are never assembled in one place
  • Threshold Signatures: Require m-of-n parties to sign transactions
  • No Single Point of Failure: Key shards stored across multiple secure locations
  • MPC Infrastructure: Vilna provides secure communication channels between shards

Use Cases:

  • Institutional custody solutions
  • Multi-party wallet management
  • High-security collection operations
  • Regulatory compliance requirements

Module 2: Vilna Core Platform

Comprehensive Asset Monitoring and Management

The core Vilna platform provides real-time blockchain monitoring, wallet generation, and comprehensive data analytics.

Your Access
Vilna Services
Your Input
REST API
Web Dashboard
Webhooks
Email Alerts
24/7 Monitoring
Address Generation
Alert System
Data Analytics
Extended Public Keys
Individual Addresses

Core Capabilities:

Wallet Generation

  • Generate unlimited addresses from xPub keys
  • Support for multiple blockchain networks
  • HD wallet standards compliance (BIP32/44/84)
  • Automatic address indexing and tracking

Real-time Monitoring

  • 24/7 blockchain monitoring
  • Instant detection of incoming/outgoing transactions
  • Multi-chain support
  • Custom alert thresholds

Notifications & Alerts

  • Webhook notifications for system integration
  • Email alerts for critical events
  • Customizable notification rules
  • Real-time push notifications

Data & Analytics

  • Complete transaction history
  • Real-time balance tracking
  • Advanced filtering and search
  • Export capabilities for reporting

Module 3: Transaction Processing & Signing

Secure Transaction Management

Vilna's transaction module provides a secure, hardware-wallet-like experience for initiating and signing transactions, with advanced simulation capabilities.

UserVilnaDeviceBlockchainInitiate TransactionBuild TransactionTransaction SimulationReview SimulationConfirm IntentSend Raw TransactionSign with Key ShardReturn SignatureBroadcast TransactionConfirmationTransaction CompleteUserVilnaDeviceBlockchain

Transaction Types:

  • Simple Transfers: Send assets to addresses
  • Swap Operations: Exchange between tokens
  • Smart Contract Interactions: DeFi operations
  • Batch Transactions: Multiple operations in one transaction

Security Features:

  • Transaction Simulation: Preview exactly what will happen before signing
  • Secure Transport: Encrypted communication channels
  • Hardware-like Security: Similar to Ledger/Trezor cold wallet approach
  • Multi-signature Support: Require multiple approvals for high-value transactions

Simulation Details: Before any transaction is signed, Vilna provides:

  • Exact gas/fee calculations
  • Balance changes preview
  • Smart contract effects visualization
  • Risk assessment and warnings
  • Approval requirements display

Integration Scenarios

Scenario 1: Exchange Platform

1. Generate deposit addresses for users (Module 2)
2. Monitor all addresses for deposits (Module 2)
3. Aggregate funds to hot wallet (Module 3)
4. Process withdrawals with MPC signing (Modules 1 & 3)

Scenario 2: Corporate Fund Management

1. Create multi-sig collection system with CGGMP (Module 1)
2. Track all corporate wallets (Module 2)
3. Execute approved transactions (Module 3)
4. Generate compliance reports (Module 2)

Scenario 3: Payment Processor

1. Generate unique invoice addresses (Module 2)
2. Monitor for customer payments (Module 2)
3. Automatic settlement processing (Module 3)
4. Real-time payment notifications (Module 2)

Getting Started

Step 1: Key Management Setup

Choose your key management approach:

  • MPC Setup: Initialize CGGMP protocol for maximum security (Module 1)
  • Import Existing xPub: Use extended public keys from hardware wallets, software wallets, or any other source
  • Add Individual Addresses: Monitor existing blockchain addresses without xPub

Step 2: Configure Monitoring

  • Set up notification channels (webhooks, email)
  • Configure alert thresholds
  • Define monitoring rules

Step 3: Transaction Processing

  • Set up signing devices/services
  • Configure transaction policies
  • Test with simulation mode

Security Architecture

Security Layers
MPC Key Sharding - Never expose full private key
Encrypted Communication - All data in transit encrypted
Transaction Simulation - Preview before signing
Multi-signature Support - Multiple approvals required
Audit Logging - Complete transaction history

API Integration

All three modules are accessible through our unified REST API:

# Module 1: MPC Operations
POST /api/v1/mpc/initialize
GET  /api/v1/mpc/status

# Module 2: Core Platform
POST /api/v1/wallets/generate
GET  /api/v1/addresses/{address}/balance
GET  /api/v1/addresses/{address}/transactions
POST /api/v1/webhooks/configure

# Module 3: Transaction Processing
POST /api/v1/transactions/create
POST /api/v1/transactions/simulate
POST /api/v1/transactions/sign
POST /api/v1/transactions/broadcast

Next Steps

Previous page
Next page