🚧 Development Status: Transaction processing functionality is currently in active development and testing. This documentation describes the planned architecture and workflow. Features will be rolled out progressively as they become production-ready.
Transaction Processing module enables secure transaction creation, simulation, and signing orchestration. It acts as a bridge between transaction intent and blockchain execution, providing a hardware-wallet-like experience with comprehensive pre-execution analysis.
The Transaction Processing module separates transaction logic into three distinct phases:
- Creation - Build and validate transaction parameters
- Simulation - Preview exactly what will happen before signing
- Execution - Coordinate signing and broadcasting
This separation ensures users always understand transaction consequences before committing funds.
The most critical feature is transaction simulation - showing users exactly what will happen before they sign.
Balance Changes:
- Exact amounts leaving and entering each address
- Token movements including all affected tokens
- Gas costs in both native currency and USD
Contract Effects:
- Smart contract state changes
- Emitted events
- Token approvals being granted or consumed
Risk Assessment:
- Warnings about unusual activity
- Detection of potentially malicious contracts
- Slippage calculations for swaps
For a simple token swap, the simulation would show:
Before Transaction:
- Wallet: 10 ETH, 0 USDC
After Transaction:
- Wallet: 8.95 ETH, 3,500 USDC
- Gas cost: 0.05 ETH ($100)
- Price impact: 0.3%
- Route: ETH → WETH → USDC via Uniswap V3Simple sending of native tokens or ERC-20/BEP-20 tokens between addresses. The system will handle:
- Optimal gas calculation
- Nonce management
- Failed transaction recovery
Integration with major DEX protocols for token exchanges:
- Automatic routing for best prices
- Slippage protection
- MEV protection strategies
General purpose contract calls with:
- ABI decoding for human-readable actions
- State change predictions
- Gas optimization
Multiple actions in a single transaction for efficiency:
- Bulk transfers
- Complex DeFi strategies
- Gas cost optimization
Every transaction follows strict security protocols:
- Validation - All parameters verified before processing
- Simulation - Mandatory preview of effects
- User Confirmation - Explicit approval required
- Signing Isolation - Private keys never touch Vilna servers
External Wallets:
- Integration with MetaMask, WalletConnect
- Hardware wallet support (Ledger, Trezor)
- Mobile wallet connections
MPC Signing (Future):
- Threshold signatures using MPC module
- No single point of failure
- Audit trail for all signing operations
Exchanges can use the transaction module to process user withdrawals:
- User initiates withdrawal in exchange UI
- Exchange creates transaction via Vilna API
- Simulation shows exact fees and arrival amount
- Multi-signature approval from exchange operators
- Automatic broadcasting and confirmation tracking
DeFi platforms can offer safe interaction with protocols:
- User wants to add liquidity to a pool
- Platform simulates the transaction showing:
- Tokens being deposited
- LP tokens received
- Current pool APY
- Impermanent loss risks
- User approves with full understanding of outcomes
Payment gateways can offer refunds and payouts:
- Merchant initiates refund
- System calculates optimal gas settings
- Simulation confirms customer will receive exact refund amount
- Automatic execution with retry logic
All transaction operations are available through REST API:
- Transaction creation with type-specific parameters
- Simulation endpoint returning detailed previews
- Signing orchestration with multiple methods
- Status tracking and confirmation monitoring
Relevant endpoints (when available):
POST /transactions/create- Build new transactionPOST /transactions/simulate- Get simulation resultsPOST /transactions/sign- Initiate signing flowGET /transactions/{id}/status- Track execution
Real-time notifications for transaction lifecycle:
- Creation confirmation
- Simulation completion
- Signature collection progress
- Broadcasting status
- Blockchain confirmations
As the module is under development, certain features are not yet available:
- Direct smart contract interactions are limited
- Not all DEX protocols are integrated
- Hardware wallet support is being tested
- Batch transactions are on the roadmap
Define rules to prevent accidents and fraud:
- Daily spending limits
- Whitelist of allowed recipients
- Time-based restrictions
- Multi-approval requirements
Built-in protections without configuration:
- Insufficient balance detection
- Extremely high gas warnings
- Malicious contract detection
- Reentrancy attack prevention
- Build raw transaction manually
- Estimate gas (often incorrectly)
- Sign without knowing effects
- Hope transaction succeeds
- Handle failures manually
- Structured transaction creation
- Accurate gas optimization
- Preview exact outcomes
- Confident execution
- Automatic retry and recovery
- Basic transaction structure
- Simulation framework
- Simple transfers (testing)
- DEX integrations
- Enhanced simulation accuracy
- External wallet connections
- Full smart contract support
- Cross-chain transactions
- Advanced MEV protection
- Transaction bundling
While the full module is under development, you can:
- Contact [email protected] for beta access
- Test transaction simulation in sandbox environment
- Provide feedback on desired features
- Prepare your integration for upcoming release
- Safety First: Every transaction is simulated before execution
- User Control: Users always see and approve transaction effects
- No Private Keys: Vilna never has access to signing keys
- Progressive Release: Features released as they're production-ready
- Architecture Overview - Understand how transactions fit in the platform
- Core Platform - Learn about address monitoring and data access
- API Reference - Explore available endpoints