Skip to main content

Wallet-Core Overview

Wallet-Core is the authoritative financial engine for OLIVE, managing accounts, executing payments and transfers, enforcing compliance, logging audits, and integrating with external processors.

Purpose

Ledger

Atomic transaction processing with database transactions and audit logs

Accounts

Multi-currency account management with balance tracking

Compliance

Transaction monitoring, alerts, and compliance rules

Reconciliation

External processor reconciliation with VULT

Who Uses It

Key Features

Atomic Transactions

All financial operations are atomic with database transactions:

Idempotency

All payments support idempotency via request_id:
If a duplicate request_id is received, the existing transaction is returned.

Account Model

Accounts are stored per user and currency:

gRPC Services

Wallet-Core exposes multiple gRPC services:

Quick Start

With Docker Compose

Build and Run Locally

Test gRPC Connectivity

Architecture

Project Structure

Data Model

Core Tables

Transaction Statuses

Security

  • gRPC TLS: Enable for production environments
  • mTLS: Mutual TLS between Gateway and Wallet-Core
  • Audit Logging: All operations logged
  • Access Control: Service-level authentication

Next Steps

Ledger

Transaction processing details

Architecture

Internal architecture

Configuration

config.yaml reference

API Reference

Complete endpoint docs