PHPackages finaegis/core-banking-prototype-laravel - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. finaegis/core-banking-prototype-laravel ActiveProject[Utility & Helpers](/categories/utility) finaegis/core-banking-prototype-laravel ======================================= Core Banking Prototype - Educational Demonstration v7.9.0(1mo ago)155029Apache-2.0PHPPHP ^8.4CI passing Since Dec 21Pushed 1mo ago5 watchersCompare [ Source](https://github.com/FinAegis/core-banking-prototype-laravel)[ Packagist](https://packagist.org/packages/finaegis/core-banking-prototype-laravel)[ Fund](https://www.buymeacoffee.com/finaegis)[ Fund](http://finaegis.org/cgo)[ RSS](/packages/finaegis-core-banking-prototype-laravel/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (121)Versions (272)Used By (0) FinAegis Core Banking Platform ============================== [](#finaegis-core-banking-platform) [![CI Pipeline](https://github.com/finaegis/core-banking-prototype-laravel/actions/workflows/ci-pipeline.yml/badge.svg)](https://github.com/finaegis/core-banking-prototype-laravel/actions/workflows/ci-pipeline.yml)[![Version](https://camo.githubusercontent.com/5380f96341bb2342ebbb446c39f05707277997c40b1d906add7a1f14795d7e07/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d362e352e302d626c75652e737667)](CHANGELOG.md)[![License: Apache-2.0](https://camo.githubusercontent.com/a549a7a30bacba7bfceebdc207a8e86c3f2c02995a2527640dca30048fd2b64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d417061636865253230322e302d626c75652e737667)](https://opensource.org/licenses/Apache-2.0)[![PHP Version](https://camo.githubusercontent.com/6e44ad49e5307c87d1393389feb52ab61c99956e2e5f8c77177b2501f1d3d47f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e342d3838393242462e737667)](https://php.net/)[![Laravel Version](https://camo.githubusercontent.com/c1e36135dc90c088df32bbaae6b87db4e188b46517e65bc3b6298300f39e8b52/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e782d4646324432302e737667)](https://laravel.com/)[![PRs Welcome](https://camo.githubusercontent.com/dd0b24c1e6776719edb2c273548a510d6490d8d25269a043dfabbd38419905da/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d627269676874677265656e2e737667)](CONTRIBUTING.md)[![Mobile Ready](https://camo.githubusercontent.com/b9ffa363a2502b6e44c6305df66688aed26bdd1669590059ceeb46543e160ffa/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6d6f62696c652d72656164792d677265656e2e737667)](docs/MOBILE_APP_SPECIFICATION.md) **An open-source core banking platform built with event sourcing, domain-driven design, and modern financial patterns.** FinAegis provides the foundation for building digital banking applications. The **Global Currency Unit (GCU)** serves as a complete reference implementation demonstrating how to build basket currencies, governance systems, and democratic financial instruments on this platform. [Live Demo](https://finaegis.org) | [Documentation](docs/README.md) | [Quick Start](#quick-start) | [Contributing](CONTRIBUTING.md) --- Why FinAegis? ------------- [](#why-finaegis) ChallengeFinAegis SolutionBuilding financial systems from scratch49 production-ready domain modulesAudit trail requirementsEvent sourcing with domain-specific event tablesComplex multi-step transactionsSaga pattern with automatic compensationRegulatory complianceBuilt-in KYC/AML, SOC 2, PCI DSS, GDPR (v3.5.0)Multi-tenant SaaS deploymentTeam-based tenant isolation (v2.0.0)Hardware wallet securityLedger/Trezor support with multi-sig (v2.1.0)Mobile wallet backendBiometric auth, passkeys, push notifications (v2.2.0+)Privacy-preserving transactionsZK-KYC, Merkle trees, ERC-4337 gas abstraction (v2.4.0-v2.6.0)Multi-jurisdiction RegTechMiFID II, MiCA, FATF Travel Rule, 4-jurisdiction adapters (v2.8.0)Cross-chain & DeFiBridge protocols, DEX aggregation, yield optimization (v3.0.0)Modular plugin architecture49 domains with manifests, enable/disable, dependency resolution (v3.2.0)Compliance certificationSOC 2 Type II, PCI DSS readiness, multi-region deployment (v3.5.0)GraphQL APISchema-first Lighthouse PHP, 39 domains, subscriptions (v4.0.0+)Event Store v2Domain routing (49 domains), upcasting, migration tooling (v4.0.0)Plugin MarketplaceManager, loader, sandbox, security scanner (v4.0.0)Event streamingRedis Streams publisher/consumer, live dashboard (v5.0.0)API monetizationx402 protocol: HTTP-native micropayments with USDC on Base (v5.2.0)Privacy protocolRAILGUN SDK integration: shield/unshield/transfer with Merkle proofs (v5.6.0)Mobile gamificationRewards system: quests, XP/levels, points shop, streaks (v5.7.0)Fiat on/off rampOnramper aggregator with provider-agnostic session management (v5.12.0)Design system v2Complete frontend overhaul with consistent typography, dark heroes (v5.12.0)Developer ecosystemPlugin marketplace, developer portal, 3 official SDKs (v6.0.0)Post-quantum cryptographyML-KEM-768, ML-DSA-65, hybrid encryption with key rotation (v6.1.0)Feature completenessCard sync webhooks, bank transfer state machine, tenant provisioning (v6.1.1)Distributed tracingOpenTelemetry, Zipkin, Jaeger, per-request trace propagation (v6.2.0)AI agent commerceA2A messaging, DID identity, escrow, reputation framework (v6.3.0)Machine paymentsMPP multi-rail (Stripe, USDC, Lightning), AP2 mandates, x402 Solana (v6.4.0)Payment orchestrationHyperSwitch 150+ connectors, smart routing, failover (v6.4.2)Mobile launch readinessQuest auto-triggers, device attestation, JIT funding, rewards (v6.5.0)SMS multi-rail paymentsVertexSMS integration, MPP-gated SMS, MCP tool for AI agents (v6.5.0)Learning modern architectureComplete DDD + CQRS + Event Sourcing example--- Plugin Architecture (v3.2.0) ---------------------------- [](#plugin-architecture-v320) FinAegis uses a modular plugin system where each domain is a self-contained module: ``` php artisan domain:list # List all 49 domain modules with status php artisan module:enable exchange # Enable a module php artisan module:disable exchange # Disable a module (preserves data) php artisan domain:verify exchange # Verify module health php artisan performance:report # Generate performance baseline ``` - **Module manifests** (`module.json`) define dependencies, interfaces, events, and commands - **Route isolation** — each domain loads its own `Routes/api.php` via `ModuleRouteLoader` - **Admin UI** — Filament page at `/admin/modules` with search, filters, enable/disable actions - **REST API** — `GET /api/v2/modules` for programmatic module management --- GraphQL API (v4.0.0-v4.3.0) --------------------------- [](#graphql-api-v400-v430) FinAegis provides a schema-first GraphQL API via [Lighthouse PHP](https://lighthouse-php.com/) covering 36 domains: ``` # Available at /graphql # Interactive playground at /graphql-playground # Example query curl -X POST http://localhost:8000/graphql \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"query": "{ accounts { id name balance currency } }"}' ``` - **39 domain schemas** — Account, AgentProtocol, AI, Asset, Banking, Basket, Batch, CardIssuance, Cgo, Commerce, Compliance, CrossChain, Custodian, DeFi, Exchange, FinancialInstitution, Fraud, Governance, KeyManagement, Lending, MachinePay, Mobile, MobilePayment, Payment, Privacy, Product, RegTech, Regulatory, Relayer, Stablecoin, Treasury, TrustCert, User, Wallet, X402 - **Subscriptions** — Real-time updates via WebSocket (account updates, wallet changes, compliance alerts, order matching) - **DataLoaders** — N+1 query prevention with batched loading - **Security** — `@guard(with: ["sanctum"])`, query cost analysis, introspection control --- Event Streaming (v5.0.0) ------------------------ [](#event-streaming-v500) Redis Streams-based event streaming for real-time data pipelines: ``` php artisan event-stream:monitor # Monitor stream health, lag, throughput ``` - **Event publisher** — Publishes domain events to 15 Redis Streams with XADD - **Consumer groups** — XREADGROUP-based consumers with acknowledgement and dead letter handling - **Live dashboard** — 5 REST endpoints for real-time metrics (projector lag, event throughput, domain health) - **Notification system** — Multi-channel notifications (email, push, in-app, webhook, SMS) - **API gateway** — Unified middleware with request ID tracing, timing headers --- GCU: The Reference Implementation --------------------------------- [](#gcu-the-reference-implementation) The **Global Currency Unit (GCU)** demonstrates FinAegis capabilities through a democratic basket currency: - **Multi-Asset Basket** - USD (40%), EUR (30%), GBP (15%), CHF (10%), JPY (3%), XAU (2%) - **Democratic Governance** - Community votes on basket composition - **Automatic Rebalancing** - Monthly adjustment to maintain target weights - **Transparent NAV** - Real-time Net Asset Value calculation - **Full Integration** - Uses Exchange, Governance, Compliance, and Treasury domains GCU shows how to build complex financial products using FinAegis primitives. ``` ┌─────────────────────┐ │ GCU Basket │ ├─────────────────────┤ │ USD ████████░░ 40% │ │ EUR ██████░░░░ 30% │ │ GBP ███░░░░░░░ 15% │ │ CHF ██░░░░░░░░ 10% │ │ JPY █░░░░░░░░░ 3% │ │ XAU █░░░░░░░░░ 2% │ └─────────────────────┘ ``` See [ADR-004: GCU Basket Design](docs/ADR/ADR-004-gcu-basket-design.md) for architecture details. --- Quick Start ----------- [](#quick-start) ### Demo Mode (Recommended) [](#demo-mode-recommended) No external dependencies - everything runs locally: ``` git clone https://github.com/finaegis/core-banking-prototype-laravel.git cd core-banking-prototype-laravel composer install cp .env.demo .env php artisan key:generate php artisan migrate --seed npm install && npm run build php artisan serve ``` Visit `http://localhost:8000` with demo credentials: - `demo.user@gcu.global` / `demo123` - `demo.business@gcu.global` / `demo123` - `demo.investor@gcu.global` / `demo123` ### Full Installation [](#full-installation) ``` git clone https://github.com/finaegis/core-banking-prototype-laravel.git cd core-banking-prototype-laravel composer install && npm install cp .env.example .env php artisan key:generate # Configure MySQL/PostgreSQL and Redis in .env php artisan migrate --seed npm run build php artisan serve php artisan queue:work --queue=events,ledger,transactions,transfers,webhooks ``` **Requirements**: PHP 8.4+, MySQL 8.0+ / MariaDB 10.3+ / PostgreSQL 13+, Redis 6.0+, Node.js 18+ ### Modular Installation (v1.3.0+) [](#modular-installation-v130) Install only the domains you need: ``` # List available domains php artisan domain:list # Install specific domains php artisan domain:install exchange php artisan domain:install lending # Check dependencies php artisan domain:dependencies exchange # Verify domain health php artisan domain:verify ``` Domain TypeExamplesInstallation**Core** (always installed)`account`, `user`, `compliance`, `shared`Automatic**Financial**`exchange`, `lending`, `treasury`, `wallet``domain:install`**AI/Agent**`ai`, `agent-protocol`, `governance``domain:install`**Infrastructure**`monitoring`, `fraud`, `batch``domain:install`See [Domain Management Guide](docs/06-DEVELOPMENT/DOMAIN_MANAGEMENT.md) for details. --- Platform Capabilities --------------------- [](#platform-capabilities) ### Core Banking [](#core-banking) DomainCapabilities**Account**Multi-asset accounts, deposits, withdrawals, statements**Banking**SEPA/SWIFT transfers, multi-bank routing, reconciliation**Compliance**3-tier KYC, AML screening, SAR/CTR reporting**Treasury**Portfolio management, cash allocation, yield optimization### Digital Assets [](#digital-assets) DomainCapabilities**Exchange**Order matching, liquidity pools, AMM, external connectors, WebSocket streaming**Stablecoin**Multi-collateral minting, burning, liquidation**Wallet**Multi-chain (BTC, ETH, Polygon, BSC), Hardware wallets (Ledger, Trezor), Multi-sig (M-of-N)**Basket (GCU)**Weighted currency basket, NAV calculation, rebalancing### Platform Services [](#platform-services) DomainCapabilities**Governance**Democratic voting, proposals, asset-weighted strategies**Lending**P2P loans, credit scoring, risk assessment**AI Framework**MCP server, 20+ banking tools, natural language queries, pattern analysis (v2.8.0)**Agent Protocol**A2A messaging, escrow, reputation system**RegTech**MiFID II reporting, MiCA compliance, FATF Travel Rule, 4-jurisdiction adapters (v2.8.0)**Multi-Tenancy**Team-based isolation, tenant-aware event sourcing### Mobile Backend (v2.4.0+) [](#mobile-backend-v240) DomainCapabilities**Key Management**Shamir's Secret Sharing (2-of-3), HSM integration**Privacy**ZK-KYC verification, Proof of Innocence, selective disclosure**Card Issuance**Virtual cards for Apple Pay/Google Pay, JIT funding**Gas Relayer**ERC-4337 meta-transactions, pay fees in USDC**TrustCert**W3C Verifiable Credentials, QR/deep link verification**Mobile**Biometric auth, push notifications, device management**Mobile Payments**Payment intents, activity feed, receipts, USDC on Solana/Tron (v2.7.0)**Passkey Auth**WebAuthn/FIDO2 with rpIdHash, UV/UP flags, COSE validation (v2.7.0+v5.7.0)**P2P Transfers**Address validation, name resolution, fee quotes (v2.7.0)**Rewards**Gamification: XP/levels, quests, points shop, streaks, race-safe redemption (v5.7.0)### API Monetization (v5.2.0) [](#api-monetization-v520) DomainCapabilities**X402 Protocol**HTTP 402 native micropayments, USDC on Base L2, EIP-3009/Permit2 payment schemes**Payment Gate**Middleware-based API monetization, per-endpoint pricing, automatic settlement**AI Agent Payments**Autonomous payments for AI agents, spending limits, MCP tool integration--- Architecture ------------ [](#architecture) ``` ┌─────────────────────────────────────────────────────────────────────┐ │ API / Admin Panel │ ├─────────────────────────────────────────────────────────────────────┤ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Account │ │ Exchange │ │ Basket │ │Compliance│ │ Treasury │ │ │ │ Domain │ │ Domain │ │ (GCU) │ │ Domain │ │ Domain │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ │ │ │ │ │ ┌────▼────────────▼────────────▼────────────▼────────────▼─────┐ │ │ │ CQRS + Event Sourcing │ │ │ │ Commands → Aggregates → Events → Projectors → Read Models │ │ │ └──────────────────────────────┬────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────────────▼────────────────────────────────┐ │ │ │ Saga / Workflow Engine │ │ │ │ Multi-step transactions with compensation │ │ │ └───────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────────┘ ``` **Key Patterns:** - **Event Sourcing** - Domain-specific event tables with Event Store v2, replay, and upcasting (v4.0.0) - **CQRS** - Separated read/write models for optimal performance - **Saga Pattern** - Distributed transactions with automatic rollback - **DDD** - 49 bounded contexts with clear boundaries - **Multi-Tenancy** - Team-based data isolation with stancl/tenancy v3.9 - **GraphQL** - Schema-first Lighthouse PHP across 39 domains with subscriptions (v4.0.0+) - **Event Streaming** - Redis Streams publisher/consumer with live dashboard (v5.0.0) See [Architecture Decision Records](docs/ADR/) for detailed design rationale. --- Documentation ------------- [](#documentation) CategoryLinks**Getting Started**[Quick Start](#quick-start) · [User Guides](docs/05-USER-GUIDES/)**Architecture**[Overview](docs/02-ARCHITECTURE/) · [ADRs](docs/ADR/) · [Roadmap](docs/ARCHITECTURAL_ROADMAP.md)**API**[REST Reference](docs/04-API/REST_API_REFERENCE.md) · [OpenAPI](/api/documentation) · [GraphQL](/graphql-playground)**Version History**[Changelog](CHANGELOG.md) · [Version Roadmap](docs/VERSION_ROADMAP.md)**Development**[Contributing](CONTRIBUTING.md) · [Dev Guides](docs/06-DEVELOPMENT/)**Reference**[GCU Design](docs/ADR/ADR-004-gcu-basket-design.md) · [Event Sourcing](docs/ADR/ADR-001-event-sourcing.md)--- Contributing ------------ [](#contributing) We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. ``` # Fork, clone, then: git checkout -b feature/your-feature # Make changes with tests ./bin/pre-commit-check.sh --fix # Submit PR ``` **Standards**: PSR-12 · PHPStan Level 8 · 50%+ Coverage · Conventional Commits This project supports AI coding assistants. Look for `AGENTS.md` files for context-aware guidance. --- Deployment ---------- [](#deployment) ### Kubernetes (v2.1.0+) [](#kubernetes-v210) Deploy to any Kubernetes cluster with Helm: ``` # Add Bitnami repo for dependencies helm repo add bitnami https://charts.bitnami.com/bitnami # Install with staging values helm upgrade --install finaegis ./helm/finaegis \ --values ./helm/finaegis/values-staging.yaml \ --namespace finaegis-staging \ --create-namespace # Install with production values helm upgrade --install finaegis ./helm/finaegis \ --values ./helm/finaegis/values-production.yaml \ --namespace finaegis ``` **Features:** - Multi-stage Docker build (PHP 8.4-fpm-alpine) - Horizontal Pod Autoscaler (CPU, memory, queue depth) - Istio service mesh compatible (mTLS, circuit breaker) - External Secrets for Vault/AWS integration - Prometheus ServiceMonitor for observability - Network Policies for pod isolation See [Kubernetes Deployment Guide](docs/06-DEVELOPMENT/KUBERNETES.md) for details. --- Tech Stack ---------- [](#tech-stack) LayerTechnology**Backend**Laravel 12, PHP 8.4+**Event Sourcing**Spatie Event Sourcing with Event Store v2 (domain routing, upcasting)**GraphQL**Lighthouse PHP (schema-first, 36 domains, subscriptions)**Workflows**Laravel Workflow (Waterline)**Multi-Tenancy**stancl/tenancy v3.9**Database**MySQL 8.0+ / MariaDB 10.3+ / PostgreSQL 13+**Cache/Queue/Streaming**Redis (cache, queues, Streams), Laravel Horizon**Real-time**Soketi (Pusher-compatible), Laravel Echo, Redis Streams**Testing**Pest PHP (parallel, 886 test files, 6,500+ tests), PHPStan Level 8**Admin**Filament v3**Frontend**Livewire, Tailwind CSS**Deployment**Docker, Kubernetes (Helm), Istio--- Project Status -------------- [](#project-status) This is a **demonstration platform** showcasing modern banking architecture. Use it for: - Learning event sourcing and DDD patterns - Understanding core banking concepts - Building proof-of-concepts - Contributing to open-source fintech - Studying GCU as a basket currency reference **Production Readiness**: The codebase includes production-grade infrastructure (CQRS, event sourcing, multi-tenancy, GraphQL API, event streaming, 50%+ test coverage, PHPStan Level 8, 6,300+ tests). However, **a security audit and compliance review are required** before any production deployment. See [Security Policy](SECURITY.md) for vulnerability reporting. --- Community --------- [](#community) - [GitHub Discussions](https://github.com/finaegis/core-banking-prototype-laravel/discussions) - Questions & Ideas - [GitHub Issues](https://github.com/finaegis/core-banking-prototype-laravel/issues) - Bug Reports - [Security Policy](SECURITY.md) - Vulnerability Reporting - [Code of Conduct](CODE_OF_CONDUCT.md) - Community Guidelines - [Changelog](CHANGELOG.md) - Version History --- License ------- [](#license) [Apache License 2.0](LICENSE) --- **Built for the open-source financial community** ### Health Score 52 — FairBetter than 96% of packages Maintenance91 Actively maintained with recent releases Popularity19 Limited adoption so far Community16 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 98.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 57 Last Release 38d ago Major Versions v1.4.1 → v2.0.02026-01-28 v2.10.0 → v3.0.02026-02-10 v3.0.0 → v5.1.02026-02-16 v5.14.0 → v6.0.02026-03-17 v6.7.0 → v7.8.02026-03-31 PHP version history (2 changes)v1.0.0PHP ^8.3 v5.1.0PHP ^8.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5859318?v=4)[Marijus Plančiūnas](/maintainers/YOzaz)[@YOzaz](https://github.com/YOzaz) --- Top Contributors [![YOzaz](https://avatars.githubusercontent.com/u/5859318?v=4)](https://github.com/YOzaz "YOzaz (1915 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (37 commits)") --- Tags laravelfintechcore banking ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/finaegis-core-banking-prototype-laravel/health.svg) ``` [![Health](https://phpackages.com/badges/finaegis-core-banking-prototype-laravel/health.svg)](https://phpackages.com/packages/finaegis-core-banking-prototype-laravel) ``` ### Alternatives [bagisto/bagisto Bagisto Laravel E-Commerce 26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim UnoPim Laravel PIM 9.4k1.8k](/packages/unopim-unopim)[grumpydictator/firefly-iii Firefly III: a personal finances manager. 22.8k69.3k](/packages/grumpydictator-firefly-iii)[blair2004/nexopos The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js. 1.2k2.3k](/packages/blair2004-nexopos)[microweber/microweber New generation CMS with drag and drop 3.4k13.8k1](/packages/microweber-microweber) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)