Skip to main content

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

  • VPC isolation for internal services
  • Firewall rules restricting access
  • Network policies in Kubernetes
  • TLS 1.3 for all external traffic
  • mTLS for internal gRPC communication
  • Certificate rotation policies
  • JWT/OAuth2 authentication
  • API key management with scopes
  • Rate limiting per client
  • Input validation and sanitization
  • 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