{"id":28950101,"url":"https://github.com/lerianstudio/midaz","last_synced_at":"2026-04-01T19:50:59.339Z","repository":{"id":233906607,"uuid":"788009998","full_name":"LerianStudio/midaz","owner":"LerianStudio","description":"Open-source, cloud-native ledger platform for building financial infrastructure — multi-currency, multi-asset, double-entry accounting with n:n transaction support.","archived":false,"fork":false,"pushed_at":"2026-03-27T00:06:44.000Z","size":224336,"stargazers_count":364,"open_issues_count":18,"forks_count":83,"subscribers_count":27,"default_branch":"main","last_synced_at":"2026-03-27T00:35:45.532Z","etag":null,"topics":["accounting","cloud-native","core-banking","cqrs","double-entry-accounting","financial-infrastructure","fintech","golang","hexagonal-architecture","ledger","microservices","multi-currency","open-source","transactions"],"latest_commit_sha":null,"homepage":"https://docs.lerian.studio","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LerianStudio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["LerianStudio"]}},"created_at":"2024-04-17T15:53:11.000Z","updated_at":"2026-03-23T00:57:26.000Z","dependencies_parsed_at":"2025-12-18T23:05:02.963Z","dependency_job_id":null,"html_url":"https://github.com/LerianStudio/midaz","commit_stats":null,"previous_names":["lerianstudio/midaz"],"tags_count":754,"template":false,"template_full_name":null,"purl":"pkg:github/LerianStudio/midaz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LerianStudio%2Fmidaz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LerianStudio%2Fmidaz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LerianStudio%2Fmidaz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LerianStudio%2Fmidaz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LerianStudio","download_url":"https://codeload.github.com/LerianStudio/midaz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LerianStudio%2Fmidaz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291246,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accounting","cloud-native","core-banking","cqrs","double-entry-accounting","financial-infrastructure","fintech","golang","hexagonal-architecture","ledger","microservices","multi-currency","open-source","transactions"],"created_at":"2025-06-23T13:05:19.595Z","updated_at":"2026-04-01T19:50:59.322Z","avatar_url":"https://github.com/LerianStudio.png","language":"Go","funding_links":["https://github.com/sponsors/LerianStudio"],"categories":[],"sub_categories":[],"readme":"![banner](image/README/midaz-banner.png)\n\n\u003cdiv align=\"center\"\u003e\n\n[![Latest Release](https://img.shields.io/github/v/release/LerianStudio/midaz?include_prereleases)](https://github.com/LerianStudio/midaz/v3/releases)\n[![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/LerianStudio/midaz/v3/blob/main/LICENSE)\n[![Go Report](https://goreportcard.com/badge/github.com/lerianstudio/midaz)](https://goreportcard.com/report/github.com/lerianstudio/midaz)\n[![Discord](https://img.shields.io/badge/Discord-Lerian%20Studio-%237289da.svg?logo=discord)](https://discord.gg/DnhqKwkGv3)\n\n\u003c/div\u003e\n\n# Lerian Midaz: Enterprise-Grade Open-Source Ledger System\n\nLerian Midaz is a modern, open-source ledger system designed for building financial infrastructure that can scale from fintech startups to enterprise banking solutions. With a robust and flexible architecture, Midaz empowers developers to create sophisticated financial applications that can handle complex transactional requirements.\n\n## Why Midaz?\n\n- **Enterprise-Ready**: Built with the reliability, scalability, and security needed for mission-critical financial systems\n- **Developer-Friendly**: Clean architecture and comprehensive API documentation for rapid integration and development\n- **Future-Proof Design**: Multi-asset and multi-currency support to handle both traditional and digital assets in a single system\n- **Community-Backed**: Growing open-source community with commercial support options available from Lerian\n\n## Core Banking\n\nAt Lerian, we view a core banking system as a comprehensive platform consisting of four main components:\n\n1. **Ledger**: The central database that manages all transactions and accounts. This is where Midaz plays a crucial role, serving as the foundation of the core banking system. We implemented our ledger with two main services:\n\n   - **Onboarding Service**: Manages organizations, ledgers, assets, portfolios, segments, and accounts.\n   - **Transaction Service**: Handles complex n:n transactions with double-entry accounting.\n2. **Transactional Messaging Integrations**: These are responsible for integrating with external systems to generate debits and credits in the ledger. Examples include instant payments (like PIX in Brazil), card transactions, and wire transfers.\n3. **Governance Integrations**: These are responsible for enhancing the core banking capabilities with KYC, anti-fraud/AML measures, management reporting, regulatory compliance, and accounting reporting.\n\nOur open-source approach allows for the integration of Midaz with other components, like transactional messaging and governance, creating a complete core banking solution tailored to your specific needs. We also provide a marketplace with different plugins that streamline the integration of these messaging systems and governance players. These plugins are built by both Lerian and the community/partners.\n\nIf you are interested in contributing to the development of these plugins or have any questions, please feel free to reach out to us in the Discussions tab or at [contact@lerian.studio](mailto:contact@lerian.studio).\n\nWe will also provide soon a list of potential new plugins that could be built, to help you get started. More to come!\n\n## Core Architecture\n\nLerian Midaz is built as a modern, cloud-native platform with a modular microservices architecture:\n\n### Domains\n\nLerian Midaz implements a comprehensive financial hierarchy:\n\n- **Organizations**: Top-level entities, optionally with parent-child relationships\n- **Ledgers**: Financial record-keeping systems belonging to organizations\n- **Assets**: Different types of value (currencies, securities, etc.) with specific codes\n- **Portfolios**: Collections of accounts for organizational purposes\n- **Segments**: Categories for grouping accounts (e.g., by department, product line)\n- **Accounts**: Basic units for tracking financial resources, linked to assets with specific types\n- **Transactions**: Financial transactions with debits and credits\n- **Balances**: Account balance tracking with available funds management and transaction capabilities\n\n### Services\n\n1. **Onboarding Service**: Core entity management system.\n\n   - Implements hexagonal architecture with CQRS pattern\n   - RESTful API with OpenAPI documentation\n   - PostgreSQL for primary data, MongoDB for flexible metadata\n   - Manages the full financial hierarchy from organizations to accounts\n2. **Transaction Service**: Financial transaction processing system.\n\n   - Handles complex n:n transactions with double-entry accounting\n   - Supports multiple transaction creation methods (JSON, DSL, templates)\n   - Asset rate management and balance tracking with optimistic concurrency\n   - Event-driven architecture using RabbitMQ for transaction lifecycle\n3. **Infrastructure Layer**: Containerized infrastructure services.\n\n   - PostgreSQL with primary-replica setup for high availability\n   - MongoDB replica set for metadata storage\n   - RabbitMQ for message queuing with predefined exchanges\n   - Valkey for caching and message passing\n   - Grafana/OpenTelemetry for comprehensive monitoring\n\n### Transaction Processing\n\nLerian Midaz implements true double-entry accounting with sophisticated transaction capabilities:\n\n- **Double-Entry Engine**: Every credit has a corresponding debit, ensuring financial integrity\n- **Multi-Asset Support**: Handle transactions across different currencies with automatic rate conversion\n- **Complex Transactions**: Support for n:n operations (multiple sources to multiple destinations)\n- **Domain-Specific Language**: Proprietary DSL for modeling complex transactions\n- **Immutable Records**: Every transaction is permanently recorded for audit purposes\n- **Async Processing**: Event-driven architecture for scalable transaction handling\n- **Balance Management**: Sophisticated balance tracking with available and on-hold amounts\n\n### Technical Highlights\n\n- **Hexagonal Architecture**: Clear separation between domain logic and external dependencies\n- **CQRS Pattern**: Separate command and query responsibilities for optimized performance\n- **Event-Driven Design**: Asynchronous processing using message queues for scalability\n- **Domain-Specific Language**: Specialized grammar for defining complex transactions\n- **Optimistic Concurrency**: Version-based concurrency control for balance updates\n- **Comprehensive APIs**: RESTful endpoints with OpenAPI documentation\n- **Testing**: Extensive unit and integration tests with mocking support\n\n## Getting Started\n\nTo start using Lerian Midaz, please follow our [Getting Started Guide](https://docs.lerian.studio/docs/getting-started). For comprehensive documentation on Midaz features, API references, and best practices, visit our [Official Documentation](https://docs.lerian.studio).\n\n## Community \u0026 Support\n\n- Join our [Discord community](https://discord.gg/DnhqKwkGv3) for discussions, support, and updates.\n- For bug reports and feature requests, please use our [GitHub Issues](https://github.com/LerianStudio/midaz/v3/issues).\n- If you want to raise anything to the attention of the community, open a Discussion in our [GitHub](https://github.com/LerianStudio/midaz/v3/discussions).\n- Follow us on [Twitter](https://twitter.com/LerianStudio) for the latest news and announcements.\n\n## Repo Activity\n\n![Alt](https://repobeats.axiom.co/api/embed/827f95068c3eb21900ed6a7191a53639481cbc75.svg \"Repobeats analytics image\")\n\n## Contributing \u0026 License\n\nWe welcome contributions from the community! Please read our [Contributing Guidelines](CONTRIBUTING.md) to get started. Lerian Midaz is released under the Apache License 2.0. See [LICENSE](LICENSE) for more information. In a nutshell, this means you can use, modify, and distribute Midaz as you see fit, as long as you include the original copyright and license notice.\n\n## About Lerian\n\nMidaz is developed by Lerian, a tech company founded in 2024, led by a team with a track record in developing ledger and core banking solutions. For any inquiries or support, please reach out to us at [contact@lerian.studio](mailto:contact@lerian.studio) or simply open a Discussion in our [GitHub repository](https://github.com/LerianStudio/midaz/v3/discussions).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flerianstudio%2Fmidaz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flerianstudio%2Fmidaz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flerianstudio%2Fmidaz/lists"}