Block explorers são ferramentas importantes no arsenal de um entusiasta em blockchain. Eles provêm uma interface online para realizar pesquisas em uma blockchain e permitem ao usuário recuperar informações sobre transações, endereços, blocos, taxas e mais. Cada block explorer mostra informações sobre uma certa blockchain, e o tipo de informação incluída irá variar dependendo da arquitetura da rede.
Para aumentar a transparência da Rede Blockchain Brasil, e permitir acesso a seus dados, foram previstos em sua topologia nós conectores para observação da rede (observer boots), aos quais cidadãos podem se conectar ao instanciar um nó observador (observer) local em seu próprio computador. Conectados a estes nós observers, por sua vez, podem estar os block explorers, permitindo o acompanhamento da rede em tempo real.
Ao se conectar com a rede, o nó observer baixa os blocos e valida todas as transações perante as regras definidas pelos smart contracts, assim como perante as regras de permissionamento definidas nesses contratos. Em outras palavras, um nó verifica as permissões ao importar blocos – ou seja, ele importa apenas blocos nos quais todas as transações são de remetentes autorizados (fonte: documentação do Besu). Dessa forma, para que o observer consiga se conectar a um observer-boot (um dos nós públicos da rede), o smart contract "node rules" deverá estar desabilitado.
Note
O usuário final não precisa se preocupar com isso. O script para levantar um nó observer, disponível a seguir, já configura as permissões corretamente.
Important
Ainda assim, é incentivado que o usuário faça seu próprio script. É possível subir um nó observer e um block explorer de forma independente.
Todas as tecnologias e códigos utilizadas no script fornecido a seguir, salvo as configurações específicas para a RBB (como a pasta docker-compose do Blockscout), são produzidos por terceiros e podem ser conferidos nos links abaixo:
Redes blockchain podem variar em tamanhos e requisitos. Antes de subir um nó observer com block explorer, verifique se você atinge as seguintes condições mínimas:
- CPU: 6 core, 12 thread
- RAM: 16 GB
- Disco: 80 GB
- CPU: 2 core, 4 thread
- RAM: 4 GB
- Disco: 80 GB
Além dos requisitos de hardware, os seguintes softwares são necessários:
- Git
- Docker v20.10+
- Docker compose v2.24+
Note
Notamos que as as versões do compose 2.24.7, 2.25.0 e 2.26.0 não se mostraram compatíveis com o Blockscout a princípio. E a versão 1.x.x do docker-compose não é suportada.
👉 Para implantações no Windows, deve ser instalado o WSL2 (caso não esteja instalado) e, em seguida, o Docker. Vale ressaltar, entretanto, que o uso do WSL para este roteiro ainda tem caráter experimental, podendo ocorrer eventuais incompatibilidades ou problemas em sua execução.
Important
A data e hora do sistema devem estar devidamente atualizadas para que seja possível a sincronização de blocos.
Este roteiro considera duas opções de block explorer: o Chainlens e o Blockscout. Nenhuma delas é favorecida em relação à outra, de forma que o usuário pode verificar e analisar ambas.
Note
O usuário não é obrigado a ficar com qualquer das duas alternativas e, caso deseje, pode escolher outro entre as dezenas de block explorers que existem no mercado para explorar os dados da RBB. Este roteiro, entretanto, não abordará outras alternativas.
Este roteiro supõe que o usuário possui uma máquina Linux ou o WSL previamente configurado. Primeiro, faça o download do script referenciado no comando abaixo e conceda as permissões necessárias para sua execução:
curl -#sLO https://raw.githubusercontent.com/RBBNet/rbb/master/artefatos/observer/rbb-observer
chmod +x rbb-observerO script pode ser utilizado de mais de uma maneira, conforme descrito nas seções a abaixo, a depender das ferramentas que se deseja executar.
Para iniciar apenas o nó observer, sem um block explorer "acoplado", digite o seguinte comando:
./rbb-observer install -oPara iniciar o nó observer, com o Blockscout "acoplado", digite o seguinte comando:
./rbb-observer install -obSerá possível acompanhar as transações e visualização dos blocos acessando a URL informada ao final da instalação, usando um navegador web.
Para iniciar o nó observer, com o Chainlens "acoplado", digite o seguinte comando:
./rbb-observer install -ocSerá possível acompanhar as transações e visualização dos blocos acessando o endereço HTTP informado ao final da instalação via navegador web.
Ao acessar o dashboard do block explorer (Blockscout ou Chainlens), será possível observar os blocos sendo baixados e indexados. Nesta etapa inicial, é esperado que a sincronização com a RBB leve um tempo considerável para ocorrer, até que todos os blocos possam ser recebidos. O Chainlens tem a vantagem de mostrar ao usuário a percentagem de sincronização.
Após subir o Blockscout, não é necessário esperar até que todos os blocos estejam indexados. O processo de indexação é diferente do de baixar os blocos, e pode demorar de horas a dias. Mesmo quando a indexação estiver ainda no início, é possível verificar contratos. A verificação de um smart contract envolve a submissão de seu código fonte para garantir que o bytecode que se encontra na blockchain corresponde ao código fonte fornecido ao usuário.
Os contratos do permissionamento utilizado na RBB se encontram nesse link.
| Contrato | Endereço |
|---|---|
| Admin | 0xe6e9af633D886CB83d43C1Af10D5F7080c824a76 |
| NodeRules | 0xcE74Df8d10Bd8b81395A9b7BEfE09b2bBC868dfb |
| AccountRules | 0x8f568E67317457d4847813a9cc0d2E074c74e759 |
Para efetivamente verificar os contratos, entre no endereço do Blockscout disponibilizado pelo script e clique no seguinte botão:
Ao clicar no botão, aparecerá a tela de verificação de smart contracts. Alguns argumentos serão pedidos, como o endereço (incluindo 0x[...]), a licença e o tipo de verificação. A licença, no caso da RBB será None, e o tipo de verificação é à escolha do usuário. Caso seja necessário utilizar vários arquivos para a verificação, deve-se utilizar a opção Multi-part form files.
A versão do compilador deve ser 0.5.9+commit.e560f70d. A versão da EVM é a default, mas, caso dê erro, tente petersburg. Otimização desabilitada - sabe-se que ela muda o bytecode do código, o que impossibilita a verificação. Por fim, adicione na caixa pontilhada os arquivos dos smart contracts.
Por fim, clique em "verify & publish".
Caso tenha interesse em observar o fluxo de sincronização de blocos do observer ou mesmo investigar problemas, utilize o seguinte comando:
./rbb-observer logs -oCaso tenha interesse em observar o fluxo de indexação de blocos do block explorer ou mesmo investigar problemas, utilize o seguinte comando:
./rbb-observer logs -bPara remover completamente o nó observer e block explorer instalados, digite:
./rbb-observer remove --allEste comando removerá todos os arquivos e dados baixados, incluindo dados de blocos da blockchain, e removerá quaisquer imagens Docker criadas.
Verifique os logs do observer, conforme comando informado acima.
Verifique os logs de erro com o comando ./rbb-observer logs -b Caso não saiba como proceder, procure informações e ajuda na comunidade do Blockscout.
Talvez o observer não tenha conseguido se conectar com o nó de sincronização. Reinicie o nó e veja se volta a sincronizar:
./rbb-observer restart -oCaso deseje reiniciar o Chainlens, use o seguinte comando:
./rbb-observer restart -b