Modern Banking Architecture
Built in the Open
Explore the Global Currency Unit concept—a democratically governed basket currency with event-sourced architecture, AI agent integration, and real banking API patterns.
What Is FinAegis?
FinAegis is an open-source demonstration of how a modern core banking platform could work. It showcases event sourcing, CQRS, AI integration, and the Global Currency Unit concept.
Note: This is a prototype. All transactions are simulated. No real money is involved.
Who Is This For?
Developers & Architects
Learn how to build financial systems with event sourcing, CQRS, and domain-driven design patterns in Laravel.
Fintech Researchers
Study the Global Currency Unit concept—a basket currency with democratic composition voting.
AI/ML Engineers
Explore our Agent Protocol implementation for AI-to-AI financial transactions and MCP tool integration.
MIT Licensed. Contribute on GitHub
What's Implemented
A comprehensive demonstration of core banking patterns and modern architecture
Global Currency Unit
A basket currency concept with democratic composition voting. Explore how multi-asset backing could work.
Learn more →Multi-Asset Support
Account structures supporting multiple currencies and asset types with automatic conversions.
Explore assets →Event-Sourced Ledger
Complete transaction history with audit trails using Spatie Event Sourcing patterns.
See architecture →Democratic Governance
Weighted voting system for currency composition decisions. A working governance prototype.
Try voting →Banking API Patterns
Open Banking-style API structures with mock connectors showing integration patterns.
View APIs →REST & OpenAPI
Comprehensive REST APIs with Swagger documentation and webhook examples.
View docs →AI Agent Protocol
Google's A2A protocol implementation for AI agent commerce with MCP tools.
Explore AI →Platform Architecture
Explore different modules of the core banking prototype. Each demonstrates specific financial system patterns.
FinAegis Core Platform
Domain-driven design with event sourcing
Global Currency Unit (GCU)
DemoA concept for a democratically governed basket currency. Users vote on currency composition, and the system automatically rebalances holdings. Fully simulated in this prototype.
Currency Symbol
USD, EUR, GBP, CHF, JPY, XAU
Simulated bank connectors
Exchange Module
Order matching engine demo
DemoLending Module
P2P lending workflow
DemoStablecoin Module
Token minting patterns
DemoTreasury Module
Cash management demo
DemoAll modules are demonstrations. Explore the code to see how each pattern works.
The GCU Concept
A thought experiment in democratic monetary policy—what if users could vote on their currency's composition?
Democratic
Users vote on currency basket composition. Holdings determine voting weight in this governance model.
- Monthly voting cycles
- Transparent tallying
- Event-sourced audit trail
Multi-Asset Backed
Basket currency concept backed by multiple fiat currencies and gold for theoretical stability.
- 6 reserve assets
- Automatic rebalancing
- Simulated diversification
Technically Sound
Built with production-grade patterns even though it's a prototype. Learn from real architecture.
- Event sourcing
- CQRS pattern
- Domain-driven design
Built in the Open
Open Source & MIT Licensed
FinAegis is fully open source. Fork it, learn from it, contribute to it. Whether you're building a fintech startup, researching banking architecture, or just curious how these systems work—dive in.
Technology Stack
Built with modern, well-documented technologies. Easy to understand, extend, and deploy.
Laravel 12
PHP 8.4+ with strict types, event sourcing via Spatie, and DDD structure
Event Sourcing
Complete audit trails with Spatie Event Sourcing and CQRS patterns
AI Agent Protocol
Google A2A protocol implementation with MCP tool integration
REST APIs
OpenAPI/Swagger docs, webhooks, and comprehensive test coverage
See developer documentation for full stack details
Built for Developers
Learn banking architecture by exploring working code. Fork the repo, run it locally, and experiment with the APIs. Great for fintech research, education, or prototyping your own ideas.
RESTful APIs
Well-documented endpoints with OpenAPI specs
Comprehensive Tests
Pest PHP tests demonstrating usage patterns
Docker Ready
Laravel Sail for easy local development
cd core-banking-prototype-laravel
composer install
cp .env.demo .env
php artisan migrate --seed
php artisan serve
Ready to Explore?
Try the live demo, fork the repo, or dive into the documentation. FinAegis is a learning resource for anyone interested in banking architecture.