Scala-based trading engine for the Open Bank Project (OBP) ecosystem.

Current Version: 0.1.0-SNAPSHOT
Development Phase: Model Architecture Complete (85%)

• ✅ Scala project structure with SBT
• ✅ Core trading models with account integration
• ✅ Connector architecture (Redis, PostgreSQL, Kafka, RabbitMQ)
• ✅ RedisOfferConnector implementation
• ✅ Comprehensive validation framework
• ✅ OBP Account Holds integration design

• 🚧 HTTP API endpoints
• 🚧 Authentication middleware
• 🚧 Database migrations
• 🚧 OBP-API client integration
• 🚧 WebSocket streaming

Trading Engine (Scala + http4s) ├── Models: Offer, Trade, AccountReservation ├── Connectors: Redis, PostgreSQL, Kafka, RabbitMQ ├── Validation: Account, Permission, Business Rules └── OBP Integration: Account Holds + Transaction Requests 

1. Account-Linked Trading: Every offer/trade linked to OBP bank accounts
2. OBP Account Holds: Use OBP-API holds for fund reservation (no separate accounts)
3. Two-Layer Money: FIAT via OBP Transactions, trading via account holds
4. Audit Trail: user_id and consent_id on all operations
5. Fully Qualified IDs: offerId, tradeId, etc. (no generic "id" fields)

• Scala 2.13.15+
• SBT 1.9+
• Java 11+
• PostgreSQL 14+
• Redis 6+
• OBP-API instance

# Clone and build git clone https://github.com/OpenBankProject/OBP-Trading cd OBP-Trading sbt compile # Configure connectors cp src/main/resources/application.conf.example src/main/resources/application.conf # Edit connector sections (offer/trade/user) and OBP-API credentials # Run (when ready) sbt run

// See src/main/resources/application.conf.example for a full example. connectors { offer { type = "redis" host = "127.0.0.1" port = 6379 database = 0 } trade { type = "postgres" url = "jdbc:postgresql://127.0.0.1:5432/obptrading" username = "postgres" password = "postgres" } user { type = "obp-api" base_url = "https://api.openbankproject.com" client_id = "CHANGE_ME" client_secret = "CHANGE_ME" } }

• Redis offer: type=redis, host, port, database, [password]
• Postgres trade: type=postgres, url, username, password
• Kafka: type=kafka, bootstrap_servers, [offers_topic|trades_topic]
• RabbitMQ: type=rabbitmq, host, port, username, password, [offers_exchange|trades_exchange]
• OBP-API user: type=obp-api, base_url, client_id, client_secret

See ai.log for detailed development history and architectural decisions.

AGPL-3.0
Copyright (c) TESOBE 2025. All rights reserved.