Appearance
Integration Overview
This section provides a high-level overview for partners, exchanges, and developers who need to understand or integrate with the Liberix platform.
Architecture Overview
Key Integration Points
1. Authentication
- Method: JWT tokens via Directus authentication
- Session: 30 min default, 7 days with "remember me"
- 2FA: Optional OTP-based two-factor authentication
- Token Refresh: Automatic every 5 minutes
2. Custodian Service (Kryptodian)
- Purpose: Cryptocurrency custody, deposit address generation, withdrawal processing
- Communication: Webhooks for deposit/withdrawal confirmations
- Direction: Platform ← Kryptodian (webhook callbacks)
3. Exchanges (Bitazza & Bitkub)
| Exchange | Role | Communication |
|---|---|---|
| Bitazza | Primary — price feeds, liquidation orders, withdrawal processing | REST API + background service |
| Bitkub | Secondary — price feeds, liquidation orders | REST API polling |
- Price Feeds: Background service polls exchange APIs and writes to
price_feedcollection - Liquidation: When loan health reaches critical level (Risk LV.3+), collateral is sold via exchange
- Withdrawals: Bitazza processes crypto withdrawal requests from users
4. Email Service
- Purpose: Transactional emails (registration, loan events, notifications)
- Direction: Platform → Email service (outbound only)
Supported Cryptocurrencies
| Asset | Symbol | Networks |
|---|---|---|
| Bitcoin | BTC | Bitcoin mainnet |
| Ethereum | ETH | ERC20 |
| Tether | USDT | ERC20, TRC20, BEP20 |
| USD Coin | USDC | ERC20 |
| Cardano | ADA | Cardano |
| Ripple | XRP | Ripple |
| Avalanche | AVAX | Avalanche C-Chain |
| Toncoin | TON | TON |
| Polygon | POL | Polygon |
Data Flow: Loan Lifecycle
See Loan Lifecycle for the complete stage diagram and data exchange at each step.
Access Control: KYC Tiers
See KYC Tiers & Limits for tier requirements and feature access matrix.
Technology Stack
| Layer | Technology |
|---|---|
| Frontend | Vue 3, Quasar Framework, Pinia, Vue Router |
| CMS | Directus (headless CMS + user management) |
| Backend API | .NET (financial operations, calculations) |
| Database | PostgreSQL (via Directus) |
| Custody | Kryptodian (3rd party) |
| Exchange | Bitazza & Bitkub (price feeds, liquidation, withdrawals) |
| Hosting | Cloud Run (containerized) |
For Developers
This documentation is designed for understanding the system scope and integration patterns. Internal implementation details (code paths, database schemas) are intentionally omitted. Contact the engineering team for API specifications.