Web3j
Ir para notas que citam estaWeb3j é a biblioteca Java que conversa com um nó de uma blockchain compatível com a EVM, para criar carteiras, assinar e enviar transações e chamar funções de contratos inteligentes.
Ela é o meio de campo entre uma aplicação Java comum e a rede: de um lado fala com o código Java, do outro se conecta ao nó e executa as chamadas. Funciona com o Ethereum, a primeira blockchain a aceitar contratos inteligentes e base da maioria das que os suportam, e com derivados como o Hyperledger Besu, a rede usada por padrão na bancada Digital Assets. Como cada nó guarda uma cópia inteira da blockchain, a biblioteca pode se conectar a qualquer um deles, sem preferência.
O conceito é simples de entender pela documentação; a implementação é outra história, e sem um projeto de referência já pronto fica difícil acertar. Por isso a bancada encapsulou o uso da biblioteca no Survey Chain Client.
Mapear um método do contrato: nome, entradas e saída
Para o Web3j funcionar é preciso o cenário completo: o Contrato Inteligente escrito, com deploy feito numa blockchain. A partir daí, cada método que a aplicação vai chamar exige mapear três coisas:
- o nome exato da função no contrato;
- os parâmetros de entrada, com nome e tipo;
- o parâmetro de retorno, com nome e tipo.
Com esses três pontos a biblioteca faz a conversão entre Java e contrato. Num contrato de pesquisas, a criação recebe um bytes32 (o hash da pesquisa) e um uint256 (o prazo de encerramento) e devolve um endereço, o da transação. Antes de enviar, o método confere se o hash segue o formato que a blockchain espera. O mesmo raciocínio vale para as bibliotecas equivalentes: Web3.py em Python e Ethers.js em Node.
Escrita gera transação, leitura não
Escrever um dado na blockchain é uma transação: ela é assinada, replicada entre os nós e só termina quando a rede confirma, e a aplicação aguarda essa confirmação e pode buscar o recibo da transação. Ler é uma chamada comum, que não gera transação.
Toda escrita precisa de uma carteira. O Web3j tem um método pronto de criação que recebe uma senha (a secret) e um par de chaves e devolve um arquivo de carteira com o endereço gerado; esse conteúdo pode ser serializado e salvo criptografado no banco da aplicação. Para agir na rede, a aplicação descriptografa a carteira, extrai a chave privada e monta as credenciais com a classe Credentials. Senha errada faz a própria biblioteca recusar a carteira. Um nome amigável dado à carteira é só conveniência do banco local: a blockchain reconhece apenas endereços e chaves.
A biblioteca também decodifica o input bruto das transações, bastando informar os tipos esperados dos parâmetros, o que sustenta a Decodificação de Transações em serviços que espelham a rede num banco.
Peculiaridades conhecidas e seus contornos
Ao listar dados de um contrato diretamente, as primeiras posições retornadas chegam como dado inválido. O contorno adotado é guardar no contrato o tamanho da coleção, consultá-lo primeiro e então buscar item a item por índice, montando a lista no código Java.
A criação de transações é a parte mais trabalhosa; depois de implementada uma vez, criar novos métodos fica simples. O tratamento de carteiras também costuma exigir adaptação, a ponto de, em outro projeto, parte da lógica do contrato ter sido ajustada para contorná-lo.
Web3j ou Ethers.js
Ethers.js é a opção mais acessível: já oferece um jeito pronto de fazer transações, sem implementá-las à mão, e serve bem para um projeto rápido. Web3j se justifica quando se quer as vantagens do Java; na bancada, a escolha veio da experiência do time na linguagem, decidida coletivamente.