JBLOCK · JAVA-BLOCKCHAIN-API · BENCHMARK V5
5M de contas. 150 bi movimentados. 418 segundos.
Uma API blockchain em Java feita para carga financeira real. Não é demo.
O que é
Ledger e plano de settlement privados em Quarkus e Java 25: carteiras ECDSA, PostgreSQL como fonte da verdade e Kafka para fan-out entre nós. Licença Apache 2.0, com evidência de capacidade aberta, voltada a engenheiros e times de fintech que precisam de números medidos, não de slides.
- Java 25 e Quarkus LTS, com opção de imagem nativa GraalVM
- PostgreSQL 17 como fonte da verdade do ledger; Kafka para sincronização
- Único escritor root no settlement, com idempotência e chaves de API
- Licença Apache 2.0. Issues e merge requests apenas no GitLab
Arquitetura em quatro passos
- 1Carteiras e transações
Criação de wallets, funding autenticado e pool de transferências via REST.
- 2Accept
O aceite grava pendências e reservas no Postgres; as movimentações sobrevivem a reinícios.
- 3Mine / settle
Só o nó root faz batch settlement sob lock; métricas Micrometer expostas.
- 4Peers via Kafka
Nós peer sincronizam via Kafka + bootstrap HTTP a partir do root.
Do baseline à V5
1M contas · 100k coins
5.001.010 contas · 150.000.000.000 de volume · 418 s
Ver evidência aberta no GitLab
Próximos estágios de volume
- V10Não executado
- V50Não executado
- V100Não executado
Mesmo lab · mesma carga
Comparação operacional em laboratório próprio. Não certifica superioridade em todos os cenários.
| JBlock V5 | Fabric V5* | |
|---|---|---|
| Resultado | Passou · 418 s | Abortado · ~22 min |
| Contas | 5.001.010 | 890.208 (~18%) |
| Volume | 150 bi | 0 |
* Hyperledger Fabric (laboratório 3.1.5) abortou o populate a cerca de 666 contas/s; a projeção é de cerca de 2,1 h para 5M. Evidência própria, no mesmo hardware de referência. O JBlock não é substituto direto de Fabric, Corda ou Besu.
O que o V5 não prova
- Não certifica banco digital regulado nem core banking.
- Não prova SLA multi-região em nuvem.
- Números no host de referência (i7-1355U) não generalizam sem re-run dedicado.
Como contribuir
Contribuições sob licença Apache 2.0. O fluxo de trabalho ocorre apenas no GitLab (issues e merge requests). Antes do merge request: Docker com Postgres e Kafka, e `./mvnw test`.
- 1Leia o CONTRIBUTING.md no repositório
- 2Abra uma issue ou escolha uma já existente
- 3Prefira merge requests pequenos, com testes para mudanças de API ou persistência
Perguntas frequentes
Respostas diretas para quem busca, cita ou quer contribuir com o JBlock.
O que é o JBlock?
JBlock (java-blockchain-api) é uma API blockchain em Java e Quarkus para um ledger privado e um plano de settlement: carteiras ECDSA, PostgreSQL como fonte da verdade e Kafka para sincronização entre nós. É código aberto sob licença Apache 2.0.
É blockchain pública ou privada?
Privada e permissionada. Foi desenhada como plano de settlement interno, não como rede pública do tipo Bitcoin ou Ethereum.
O que o benchmark V5 prova?
No laboratório de referência, o estágio V5 passou com 5.001.010 contas presentes, 150 bilhões de unidades movimentadas em cerca de 418 s, latência de accept p50 de cerca de 75 ms e populate sustentado perto de 60 mil linhas SQL/s. A evidência em JSON está no repositório.
Como o JBlock se compara ao Hyperledger Fabric?
Não é um substituto direto do Fabric. Em um laboratório próprio, com a mesma carga de populate V5, o JBlock concluiu e o Fabric abortou perto de 890 mil contas. Trata-se de evidência operacional pontual, não de um ranking universal.
Como rodar localmente?
Clone o repositório no GitLab, suba Postgres e Kafka (docker compose), use Java 25 e siga o README (`./mvnw` / modos root e peer).
Como contribuir?
Issues e MRs apenas no GitLab, sob Apache 2.0. Rode os testes com a stack Docker antes de abrir o merge request. Detalhes em CONTRIBUTING.md.