finaegis / core-banking-prototype-laravel
Core Banking Prototype - Educational Demonstration
Package info
github.com/FinAegis/core-banking-prototype-laravel
Type:project
pkg:composer/finaegis/core-banking-prototype-laravel
Requires
- php: ^8.4
- ext-gmp: *
- ext-intl: *
- ext-mbstring: *
- ext-pdo: *
- aws/aws-sdk-php: ^3.369.35
- barryvdh/laravel-dompdf: ^3.1
- darkaonline/l5-swagger: ^11.0
- durable-workflow/waterline: ^1.0
- durable-workflow/workflow: ^1.0
- endroid/qr-code: ^6.0
- filament/filament: ^3.0
- http-interop/http-factory-guzzle: ^1.2.1
- juststeveking/laravel-data-object-tools: dev-main
- kornrunner/keccak: ^1.1
- kreait/laravel-firebase: ^7.0
- laravel/cashier: ^15.4
- laravel/framework: ^12.0
- laravel/horizon: ^5.44
- laravel/jetstream: ^5.4
- laravel/passport: ^13.0
- laravel/pennant: ^1.19
- laravel/pulse: ^1.5
- laravel/sanctum: ^4.0
- laravel/scout: ^11.2
- laravel/socialite: ^5.24
- laravel/telescope: ^5.2
- laravel/tinker: ^3.0
- league/commonmark: ^2.8.1
- livewire/livewire: ^3.6.4
- meilisearch/meilisearch-php: ^1.9
- nesbot/carbon: ^3.11.1
- nuwave/lighthouse: ^6.64
- open-telemetry/api: ^1.4
- open-telemetry/exporter-otlp: ^1.3
- open-telemetry/sdk: ^1.7
- predis/predis: ^2.2
- promphp/prometheus_client_php: ^2.14
- pusher/pusher-php-server: ^7.2
- resend/resend-php: ^1.0
- scrivo/highlight.php: ^9.18
- simplito/elliptic-php: ^1.0
- spatie/laravel-backup: ^10.3
- spatie/laravel-data: ^4.0
- spatie/laravel-event-sourcing: ^7.7
- spatie/laravel-permission: ^8.0
- stancl/tenancy: ^3.9
- symfony/clock: ^8.0
- symfony/http-client: ^7.3
Requires (Dev)
- behat/behat: ^3.22
- behat/mink: ^1.12
- behat/mink-browserkit-driver: ^2.3
- dmore/behat-chrome-extension: ^1.4
- fakerphp/faker: ^1.23
- friendsofphp/php-cs-fixer: ^3.80
- larastan/larastan: ^3.0
- laravel/dusk: ^8.3
- laravel/envoy: ^2.10
- laravel/pint: ^1.27
- laravel/sail: ^1.26
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.0
- pestphp/pest: 3.8.5
- pestphp/pest-plugin-laravel: ^3.0
- pestphp/pest-plugin-livewire: ^3.0
- phpstan/phpstan: ^2.1
- squizlabs/php_codesniffer: ^4.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-main
- v7.17.0
- v7.16.0
- v7.15.0
- v7.14.1
- v7.13.2
- v7.13.1
- v7.13.0
- v7.12.0
- v7.11.0
- v7.10.11
- v7.10.10
- v7.10.9
- v7.10.8
- v7.10.7
- v7.10.6
- v7.10.5
- v7.10.4
- v7.10.3
- v7.10.2
- v7.10.1
- v7.10.0
- v7.9.0
- v7.8.4
- v7.8.3
- v7.8.2
- v7.8.1
- v7.8.0
- v6.7.0
- v6.6.0
- v6.5.0
- v6.4.3
- v6.4.2
- v6.4.1
- v6.4.0
- v6.0.0
- v5.14.0
- v5.12.0
- v5.11.0
- v5.10.0
- v5.9.0
- v5.8.0
- v5.7.0
- v5.5.0
- v5.4.0
- v5.3.0
- v5.2.2
- v5.2.0
- v5.1.6
- v5.1.5
- v5.1.3
- v5.1.2
- v5.1.1
- v5.1.0
- v3.0.0
- v2.10.0
- v2.9.1
- v2.9.0
- v2.8.2
- v2.8.1
- v2.8.0
- v2.7.0
- v2.6.2
- v2.6.1
- v2.6.0
- v2.5.2
- v2.5.1
- v2.5.0
- v2.4.0
- v2.3.0
- v2.2.0
- v2.1.0
- v2.0.0
- v1.4.1
- v1.4.0
- v1.3.0
- v1.2.0
- v1.1.0
- v1.0.0
- dev-chore/backup-retention-env
- dev-fix/public-nav-register-route
- dev-fix/teamless-user-nav-500
- dev-chore/remove-partner-postman-collection
- dev-docs/regulatory-claims-cleanup
- dev-fix/ci-k6-install
- dev-chore/filament-3.3.57-assets
- dev-feat/followups-cli-surface-residuals
- dev-feat/dr-backups-mcp-read-tools
- dev-feat/admin-money-rail-resources
- dev-feat/sponsorship-cost-tracking
- dev-fix/cli-sdk-endpoint-drift
- dev-fix/openapi-regen-drift-gate
- dev-feat/gdpr-post-v713-coverage
- dev-docs/hygiene-v7.15
- dev-feat/prod-surface-reduction
- dev-fix/mcp-spending-limits-conformance
- dev-feat/ops-alerting-metrics-gate
- dev-chore/quick-wins-changelog-deps-throttle
- dev-feat/ops-verify-env
- dev-feat/mcp-consent-seo-noindex
- dev-fix/trustcert-free-verification-flag
- dev-fix/sponsored-send-guardrail
- dev-fix/mobile-build9-11-followups
- dev-chore/ci-action-version-consistency
- dev-fix/device-takeover-guard-credential-scoped
- dev-fix/notification-feed-device-independent
- dev-fix/privacy-merkle-root-disabled-guard
- dev-fix/receipt-solana-inbound
- dev-fix/wallet-prepare-network-casing
- dev-chore/v7.13.1-changelog
- dev-fix/payment-asset-usdt
- dev-chore/v7.13.0-release
- dev-fix/rewards-lockdown
- dev-chore/v7.13.0-docs
- dev-fix/device-takeover-409
- dev-feat/apple-jws-chain-validation
- dev-feat/invest-legal-entity-aegis-brightsmark
- dev-feat/invest-design-polish
- dev-feat/invest-landing-page
- dev-feat/mcp-public-server-docs
- dev-feat/mcp-public-server-design
- dev-chore/attestation-prelaunch-todo
- dev-fix/multi-connection-skip-empty-truncates
- dev-fix/multi-connection-test-bootstrap-bugs
- dev-fix/multi-connection-truncation-row-type
- dev-feat/multi-connection-test-infrastructure
- dev-feat/legal-delete-account-page
- dev-feat/ramp-stripe-bridge
- dev-feat/alchemy-webhook-manager
- dev-refactor/extract-solana-constants
- dev-docs/update-version-7.9.0
- dev-feature/alchemy-solana-migration
- dev-feat/alchemy-solana-webhook
- dev-feature/remaining-mobile-optimizations
- dev-feature/helius-webhook-transaction-storage
- dev-fix/preexisting-phpstan-ci-failures
- dev-feature/solana-address-auto-register
- dev-refactor/solana-address-review-fixes
- dev-feature/solana-real-addresses
- dev-fix/developer-portal-trust-issues
- dev-fix/gcu-platform-changelog
- dev-fix/website-comprehensive-audit
- dev-fix/website-content-v7.x-audit
- dev-fix/code-review-v7.2-v7.7
- dev-fix/post-phase-review-v7.2-v7.7
- dev-feat/v7.7.0-production-readiness
- dev-feat/v7.6.0-security-hardening
- dev-feat/v7.5.0-market-expansion-dx
- dev-feat/v7.4.0-accounting-infrastructure
- dev-feat/v7.3.0-payment-rails
- dev-feat/v7.2.0-standards-compliance-foundation
- dev-feat/mobile-attestation-recovery-wiring
- dev-fix/critical-security-findings
- dev-feat/v7.1.0-production-hardening
- dev-fix/graphql-integration-tests
- dev-feat/v7.0.0-production-release
- dev-fix/code-review-di-race-conditions-duplicates
- dev-fix/update-feature-page-badges-v6.12
- dev-feat/v6.12.0-privacy-zk-production
- dev-feat/v6.11.0-crosschain-defi-production
- dev-feat/v6.10.0-multi-tenancy-hardening
- dev-feat/v6.9.0-banking-integration-hardening
- dev-feat/v6.8.0-card-issuance-completion
- dev-feat/v6.7.0-a2a-developer-ecosystem
- dev-fix/code-review-critical-findings
- dev-feat/cli-distribution
- dev-feat/vertexsms-demo-completion
- dev-feat/vertexsms-mobile-rewards-completion
- dev-feat/solana-hsm-signer
- dev-feat/zelta-sdk-packagist
- dev-fix/developer-pages-quality-v2
- dev-feat/zelta-cli-landing-page
- dev-fix/remaining-review-items
- dev-fix/review-findings
- dev-fix/seo-audit-fixes
- dev-fix/ci-gitleaks-defi-test
- dev-fix/defi-portfolio-cache-race
- dev-fix/content-review-followup
- dev-feat/content-review-v650
- dev-feat/sms-phase2-security-hardening
- dev-feat/vertexsms-sms-integration
- dev-feat/mobile-launch-readiness
- dev-feat/machinepay-domain-foundation
- dev-feat/referral-registration-avatar-upload
- dev-fix/invitation-security-hardening
- dev-feat/admin-user-invitation
- dev-fix/filament-navigation-visibility
- dev-feat/admin-cli-registration-control
- dev-fix/virtuals-final-polish
- dev-fix/virtuals-agent-review-fixes
- dev-feat/virtuals-agent-phases-5-7
- dev-feat/virtuals-protocol-feature-page
- dev-fix/virtuals-agent-hardening
- dev-feat/virtuals-agent-integration
- dev-fix/website-content-accuracy
- dev-feat/well-known-passkey-files
- dev-feat/visacli-hardening-rewards-seeder-docs
- dev-feat/visacli-phases-2-through-6
- dev-feat/visacli-artisan-commands
- dev-feat/visacli-card-enrollment
- dev-feat/visacli-payment-gateway
- dev-feat/visacli-mcp-tools
- dev-feat/visacli-domain-foundation
- dev-test/visacli-test-suite
- dev-refactor/documentation-and-content-cleanup
- dev-feat/v6.1.1-deferred-items
- dev-fix/developer-portal-blade-syntax
- dev-fix/dependabot-vulnerabilities
- dev-fix/accurate-sdk-feature-claims
- dev-fix/aws-kms-hsm-test
- dev-feat/v6.1-roadmap-and-quantum-encryption
- dev-feat/zelta-landing-page-redesign
- dev-release/v5.12.0
- dev-fix/ci-pipeline-green
- dev-refactor/design-system-third-pass
- dev-refactor/design-system-consistency-pass
- dev-refactor/inner-pages-design-system-migration
- dev-fix/hero-purple-text-to-slate
- dev-design-system/inner-content-standardization
- dev-feature/design-system-feature-pages
- dev-feat/feature-detail-hero-dark-design
- dev-fix/ramp-design-consistency
- dev-fix/ramp-review-hardening
- dev-refactor/onramper-api-integration
- dev-feat/onramper-integration
- dev-refactor/foodo-frontend-review
- dev-feat/foodo-insights-dashboard
- dev-refactor/investor-feedback-mobile-ux-polish
- dev-refactor/investor-feedback-mobile-review
- dev-refactor/investor-feedback-professional-review
- dev-feature/investor-feedback-ramp
- dev-feature/investor-feedback-referrals
- dev-feature/investor-feedback-gas-sponsorship
- dev-feature/investor-feedback-banners
- dev-feature/investor-feedback-notifications
- dev-chore/v5.9.0-cleanup
- dev-docs/v5.9.0-version-refs
- dev-docs/v5.9.0-release
- dev-feat/v5.9.0-mobile-feedback-fixes
- dev-docs/v5.8.0-roadmap-update
- dev-docs/v5.8.0-release
- dev-feat/v5.8.0-privacy-calldata
- dev-feat/v5.8.0-websocket-card-transactions
- dev-feat/v5.8.0-recovery-shard-backup
- dev-feat/v5.8.0-commerce-cards-compliance
- dev-feat/v5.8.0-relayer-wallet-endpoints
- dev-feat/mobile-handover-response-v5.7
- dev-feat/rewards-graphql-filament-openapi
- dev-docs/v5.7.0-release
- dev-fix/mobile-v1.1-security-hardening
- dev-feat/mobile-v1.1-backend-compat
- dev-feat/railgun-privacy-protocol
- dev-feat/marqeta-webhook-auth
- dev-chore/env-zelta-sync-marqeta-relayer
- dev-chore/add-marqeta-env-vars
- dev-feat/relayer-production-integration
- dev-chore/dependabot-triage-round2
- dev-test/tenancy-isolation
- dev-test/e2e-banking-flows
- dev-feat/idempotency-wiring
- dev-fix/ci-reliability
- dev-chore/dependabot-triage
- dev-content/professional-copy-refresh
- dev-test/audit-coverage-gaps
- dev-fix/audit-remaining-items
- dev-fix/comprehensive-audit-fixes
- dev-feat/ondato-kyc-integration
- dev-fix/phpstan-ci-green
- dev-fix/phpstan-test-null-guards
- dev-refactor/mobile-backend-code-quality
- dev-fix/mobile-backend-runtime-fixes
- dev-feat/x402-integration-tests-and-response-verification
- dev-feat/marqeta-adapter-and-csp-fix
- dev-feat/chainalysis-sanctions-adapter
- dev-feat/firebase-fcm-v1-migration
- dev-feat/zelta-production-saas-deployment
- dev-fix/pusher-cloud-broadcasting
- dev-fix/phpstan-plugin-singleton-test
- dev-feature/plugin-marketplace-enhancement
- dev-fix/api-error-fixes
- dev-fix/x402-status-test-envelope
- dev-refactor/x402-round2-hardening
- dev-fix/security-and-config-defaults
- dev-fix/remove-dangerous-placeholders
- dev-chore/docs-v5.1.5-update
- dev-feat/card-api-enhancements
- dev-feat/refresh-token-mechanism
- dev-chore/release-v5.1.3
- dev-fix/mobile-api-compat-auth-relayer
- dev-chore/release-v5.1.2
- dev-fix/app-landing-csp-tailwind
- dev-fix/app-landing-standalone-css
- dev-chore/release-v5.1.1
- dev-fix/azure-hsm-flaky-test
- dev-feat/mobile-app-landing
- dev-chore/v5.1.0-release
- dev-fix/runtime-bugs-blockchain-roles-swagger
- dev-feat/mobile-api-gap-endpoints
- dev-docs/update-graphql-domain-counts-33
This package is auto-updated.
Last update: 2026-11-19 21:28:39 UTC
README
FinAegis is open-source software. Using it does not make a deployment compliant. Licensing and regulatory compliance are the responsibility of the operator of each deployment. Nothing here is legal advice.
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 GCU demo is a reference implementation of a basket-referenced unit built with FinAegis, showing how basket valuation and governance modules fit together.
FinAegis vs Zelta: FinAegis is this open-source core-banking platform. Zelta is the hosted product and mobile wallet built on top of it — so production and hosted surfaces (for example the MCP server at
mcp.zelta.app) carry the Zelta brand.
Live Demo | Documentation | Quick Start | Contributing
Why FinAegis?
| Challenge | FinAegis Solution |
|---|---|
| Building financial systems from scratch | 61 domain modules |
| Audit trail requirements | Event sourcing with domain-specific event tables |
| Complex multi-step transactions | Saga pattern with automatic compensation |
| Regulatory tooling | KYC/AML integration + GDPR export/erasure (real); SOC 2 / PCI-DSS readiness tooling — not third-party certified |
| Multi-tenant SaaS deployment | Team-based tenant isolation (v2.0.0) |
| Hardware wallet security | Ledger/Trezor support with multi-sig (v2.1.0) |
| Mobile wallet backend | Biometric auth, passkeys, push notifications (v2.2.0+) |
| Privacy-preserving transactions | ZK-KYC, Merkle trees, ERC-4337 gas abstraction (v2.4.0-v2.6.0) |
| Multi-jurisdiction RegTech | MiFID II / MiCA / FATF Travel Rule report-format validators & adapters — no live regulator connectivity; not a licensed CASP/ARM (v2.8.0) |
| Cross-chain & DeFi | Bridge protocol adapters, DEX aggregation, DeFi protocol adapters (v3.0.0) |
| Modular plugin architecture | 61 domains with manifests, enable/disable, dependency resolution (v3.2.0) |
| Compliance scaffolding | SOC 2 evidence helpers + a clean PCI-DSS SAQ-A footprint (tokenized cards, no PAN stored); no certification is held (v3.5.0) |
| GraphQL API | Schema-first Lighthouse PHP, 45 domains, subscriptions (v4.0.0+) |
| Event Store v2 | Domain routing (61 domains), upcasting, migration tooling (v4.0.0) |
| Plugin Marketplace | Manager, loader, sandbox, security scanner (v4.0.0) |
| Event streaming | Redis Streams publisher/consumer, live dashboard (v5.0.0) |
| API monetization | x402 protocol: HTTP-native micropayments with USDC on Base (v5.2.0) |
| Privacy protocol | RAILGUN shield/unshield/transfer with Merkle proofs (v5.6.0); non-custodial backend migration — public-address registration, on-device engine config, signed-URL RPC proxy (v7.16.0) |
| Mobile gamification | Rewards system: quests, XP/levels, points shop, streaks (v5.7.0) |
| Fiat on/off ramp adapter | Stripe Bridge with async webhook processing and provider-agnostic session management (v5.12.0) |
| Design system v2 | Complete frontend overhaul with consistent typography, dark heroes (v5.12.0) |
| Developer ecosystem | Plugin marketplace, developer portal, 3 official SDKs (v6.0.0) |
| Post-quantum cryptography | ML-KEM-768, ML-DSA-65, hybrid encryption with key rotation (v6.1.0) |
| Feature completeness | Card sync webhooks, bank transfer state machine, tenant provisioning (v6.1.1) |
| Distributed tracing | OpenTelemetry, Zipkin, Jaeger, per-request trace propagation (v6.2.0) |
| AI agent commerce | A2A messaging, DID identity, escrow, reputation framework (v6.3.0) |
| Machine payments | MPP multi-rail (Stripe, USDC, Lightning), AP2 mandates, x402 Solana (v6.4.0) |
| Payment orchestration (experimental, opt-in) | HyperSwitch routing for card deposits behind HYPERSWITCH_ENABLED (off by default — Stripe is the default rail); webhook-credited deposit completion (v6.4.2, wired in #1118) |
| Mobile launch readiness | Quest auto-triggers, device attestation, JIT funding, rewards (v6.5.0) |
| SMS multi-rail payments | VertexSMS integration, MPP-gated SMS, MCP tool for AI agents (v7.10.7) |
| Public MCP server | OAuth-secured Model Context Protocol server at mcp.zelta.app, @finaegis/mcp npm wrapper (v7.11.0) |
| Non-custodial wallet | Privy passkey/device-key signing, sponsored EVM + Solana sends, prepare/submit flow (v7.12.0) |
| Mobile subscriptions | Apple App Store + Google Play IAP verification, pseudonymised receipts, revenue outbox (v7.13.0) |
| Fiat ↔ stablecoin ramp adapter | Bridge.xyz API integration (bank-rail on-ramp, virtual accounts, USDC on Polygon), asymmetric webhook verification. Integration adapter for third-party APIs; no partnership or endorsement implied. (v7.15.0) |
| Learning modern architecture | Complete DDD + CQRS + Event Sourcing example |
Named third-party providers: Integration adapters for third-party APIs; no partnership or endorsement implied.
Plugin Architecture (v3.2.0)
FinAegis uses a modular plugin system where each domain is a self-contained module:
php artisan domain:list # List all 61 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.phpviaModuleRouteLoader - Admin UI — Filament page at
/admin/moduleswith search, filters, enable/disable actions - REST API —
GET /api/v2/modulesfor programmatic module management
GraphQL API (v4.0.0-v4.3.0)
FinAegis provides a schema-first GraphQL API via Lighthouse PHP covering 45 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 } }"}'
- 45 schema imports — 43 domain schemas (Account, AgentProtocol, AI, Asset, Banking, Basket, Exchange, Compliance, Governance, Lending, Treasury, Wallet, X402, …) plus
directivesandsubscriptions; seegraphql/schema.graphqlfor the authoritative list - 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)
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
The Global Currency Unit (GCU) is a software demonstration — a reference implementation built with FinAegis. It is not issued, offered or sold to anyone and has no monetary value. Any GCU balances, conversions or basket "votes" shown in the demo are simulated. Offering to the public in the EU a token that references a basket of currencies and/or commodities would require authorisation as an asset-referenced token issuer under MiCA (Title III); no such authorisation is held.
|
The GCU demo — a reference implementation of a basket-referenced unit built with FinAegis — exercises these modules:
The GCU demo shows how FinAegis primitives fit together. |
|
See ADR-0010: GCU Basket Design for architecture details.
Quick Start
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/demo123demo.business@gcu.global/demo123demo.investor@gcu.global/demo123
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+)
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 Type | Examples | Installation |
|---|---|---|
| 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 for details.
Platform Capabilities
Core Banking
| Domain | Capabilities |
|---|---|
| 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 and cash-allocation modelling |
Digital Assets
| Domain | Capabilities |
|---|---|
| Exchange | Order matching, liquidity pools, AMM, external connectors, WebSocket streaming |
| Stablecoin | Multi-collateral minting, burning, liquidation |
| Wallet | Non-custodial EVM sends (Polygon, Base, Arbitrum) + Solana; USDC receive on Solana/Tron; Ledger/Trezor hardware-wallet integration |
| Basket (GCU demo) | Weighted currency basket, basket value calculation, rebalancing (simulated demo) |
Platform Services
| Domain | Capabilities |
|---|---|
| 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 | Reporting and data-exchange modules modelled on MiFID II, MiCA and Travel Rule requirements; 4 jurisdiction report-format adapters — they do not by themselves make a deployment compliant (v2.8.0) |
| Multi-Tenancy | Team-based isolation, tenant-aware event sourcing |
Mobile Backend (v2.4.0+)
| Domain | Capabilities |
|---|---|
| Key Management | Shamir's Secret Sharing (2-of-3), HSM integration |
| Privacy | ZK-KYC verification, Proof of Innocence, selective disclosure |
| Card Issuance | Card-issuing integration adapter (e.g. Marqeta API): virtual card lifecycle, 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)
| Domain | Capabilities |
|---|---|
| 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
┌─────────────────────────────────────────────────────────────────────┐
│ 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 - 61 bounded contexts with clear boundaries
- Multi-Tenancy - Team-based data isolation with stancl/tenancy v3.9
- GraphQL - Schema-first Lighthouse PHP across 45 domains with subscriptions (v4.0.0+)
- Event Streaming - Redis Streams publisher/consumer with live dashboard (v5.0.0)
See Architecture Decision Records for detailed design rationale.
Documentation
| Category | Links |
|---|---|
| Getting Started | Quick Start · User Guides |
| Architecture | Overview · ADRs · Roadmap |
| API | REST Reference · OpenAPI · GraphQL |
| Version History | Changelog · Version Roadmap |
| Development | Contributing · Dev Guides |
| Reference | GCU Design · Event Sourcing |
Contributing
We welcome contributions! See 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
Kubernetes (v2.1.0+)
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 Infrastructure & Deployment Guide for details.
MCP (Model Context Protocol)
Connect Claude Desktop, Cursor, or Continue.dev to your Zelta account:
npx -y @finaegis/mcp
Or use the remote URL directly: https://mcp.zelta.app/mcp. See docs/13-AI-FRAMEWORK/03-MCP-Quickstart.md.
Tech Stack
| Layer | Technology |
|---|---|
| Backend | Laravel 12, PHP 8.4+ |
| Event Sourcing | Spatie Event Sourcing with Event Store v2 (domain routing, upcasting) |
| GraphQL | Lighthouse PHP (schema-first, 45 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, 1,170+ test files, 4,900+ tests), PHPStan Level 8 |
| Admin | Filament v3 |
| Frontend | Livewire, Tailwind CSS |
| Deployment | Docker, Kubernetes (Helm), Istio |
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 the GCU demo as a basket reference implementation
Before any production use: The codebase includes CQRS, event sourcing, multi-tenancy, a GraphQL API, event streaming, 50%+ test coverage, PHPStan Level 8 and 4,900+ tests. However, a security audit and compliance review are required before any production deployment, and licensing and regulatory compliance are the responsibility of the operator of each deployment. No third-party SOC 2 or PCI-DSS certification is held — the compliance modules are audit-readiness tooling, and the payment-standards domains (ISO 20022, ISO 8583, SWIFT, Open Banking, SEPA, US rails, Interledger) are reference implementations at the message/logic layer, not live scheme connectivity or settlement. See Security Policy for vulnerability reporting.
Community
- GitHub Discussions - Questions & Ideas
- GitHub Issues - Bug Reports
- Security Policy - Vulnerability Reporting
- Code of Conduct - Community Guidelines
- Changelog - Version History
License
Built for the open-source financial community