System Architecture
OLIVE is a three-tier payment processing system designed for high security, scalability, and AI-powered decision making.High-Level Architecture
Component Overview
Gateway (Go)
The public-facing REST API that handles all external requests.Wallet-Core (Go)
The secure financial engine that processes all transactions.Agent-TS (TypeScript)
AI-powered conversational agent for natural language interactions.Data Flow
Payment Flow
Agent Message Flow
Security Layers
Network Layer
Network Layer
- VPC isolation for internal services
- Firewall rules restricting access
- Network policies in Kubernetes
Transport Layer
Transport Layer
- TLS 1.3 for all external traffic
- mTLS for internal gRPC communication
- Certificate rotation policies
Application Layer
Application Layer
- JWT/OAuth2 authentication
- API key management with scopes
- Rate limiting per client
- Input validation and sanitization
Data Layer
Data Layer
- Encrypted database connections
- Comprehensive audit logging
- Idempotency keys for operations
Database Schema
Core Tables
Transaction Table Schema
Scalability
Gateway
Fully stateless, unlimited horizontal scaling behind load balancer
Agent
Stateless design with async request handling
Wallet-Core
Scale with read replicas, sharding by user_id for writes
Database
PostgreSQL with connection pooling and optimized indexes
Next Steps
Gateway Deep Dive
Explore the Gateway architecture in detail
Wallet-Core Ledger
Learn about the transaction processing engine