Cleber Lecheta
Conversar no LinkedIn

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.

5,0M
contas criadas
150 bi
volume transferido
75 ms
p50 por transfer (p95 175 ms)
~60k
linhas SQL/s sustentadas

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

  1. 1
    Carteiras e transações

    Criação de wallets, funding autenticado e pool de transferências via REST.

  2. 2
    Accept

    O aceite grava pendências e reservas no Postgres; as movimentações sobrevivem a reinícios.

  3. 3
    Mine / settle

    Só o nó root faz batch settlement sob lock; métricas Micrometer expostas.

  4. 4
    Peers via Kafka

    Nós peer sincronizam via Kafka + bootstrap HTTP a partir do root.

Do baseline à V5

Baseline

1M contas · 100k coins

V5

5.001.010 contas · 150.000.000.000 de volume · 418 s

5×contas
1,5M×volume

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 V5Fabric V5*
ResultadoPassou · 418 sAbortado · ~22 min
Contas5.001.010890.208 (~18%)
Volume150 bi0

* 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`.

  1. 1
    Leia o CONTRIBUTING.md no repositório
  2. 2
    Abra uma issue ou escolha uma já existente
  3. 3
    Prefira 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.

Voltar ao início