Modern Banking Architecture
Built in the Open
A modern core banking platform with 41 DDD domains—featuring the Global Currency Unit, cross-chain bridges, DeFi protocols, privacy-preserving identity, mobile payments, RegTech compliance, and AI-powered analytics.
What Is FinAegis?
FinAegis is an open-source demonstration of how a modern core banking platform could work. It showcases 41 DDD domains with event sourcing, CQRS, cross-chain bridges, DeFi protocols, and AI integration.
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
41 DDD domains covering core banking, cross-chain DeFi, privacy, mobile payments, compliance, and AI
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, GraphQL & OpenAPI
Comprehensive REST APIs with Swagger documentation, GraphQL across 33 domains with subscriptions, and webhook examples.
View docs →AI Agent Protocol
Google's A2A protocol implementation for AI agent commerce with MCP tools.
Explore AI →Cross-Chain & DeFi
Bridge protocols (Wormhole, LayerZero, Axelar), DEX aggregation, lending, staking, and yield optimization.
Explore bridges →Privacy & Identity
ZK-KYC proofs, Merkle trees, soulbound tokens, verifiable credentials, and Shamir key sharding.
Learn more →Mobile Payments
Payment intents, passkey authentication, P2P transfers, activity feed, and ERC-4337 account abstraction.
View mobile →RegTech Compliance
MiFID II, MiCA, and Travel Rule compliance with jurisdiction-specific adapters and automated reporting.
View compliance →Banking-as-a-Service
Partner APIs, auto-generated SDKs, embeddable widgets, usage-based billing, and marketplace.
Explore BaaS →Multi-Tenancy
Team-based isolation with tenant data migration, enterprise features, and per-tenant configuration.
Learn more →Platform Architecture
41 bounded contexts built with domain-driven design, event sourcing, and CQRS. Each module 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 & GraphQL APIs
OpenAPI/Swagger docs, GraphQL (33 domains), 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.