Notarchain - Instalação técnica

Modificado em Thu, 31 Aug 2023 na (o) 12:09 PM

ÍNDICE


Apresentação

Este documento apresenta os procedimentos que o cartório deverá providenciar para a ativação de um nó na rede Notarchain, o blockchain dos notários.



Arquitetura

O Notarchain foi desenvolvido utilizando a plataforma blockchain Hyperledger Fabric, uma rede permissionada exclusiva dos notários. Cada tabelionato de notas será um nó de validação da rede, armazenando os blocos recebidos dos serviços do e-Notariado.


Principais características da plataforma Hyperledger

  • Autoridade Certificadora: no credenciamento dos nós há a geração do par de chaves do e-notariado. Todas as transações também são assinadas com o certificado digital e-notariado, no padrão de curvas elípticas.
  • Subconjunto de nós com tarefas específicas para melhor performance da rede (concorrência e paralelismo)
  • Endossante: subconjunto de nós onde os contratos inteligentes residem e onde se decide se a transação é válida ou não de acordo com as regras de negócio do chaincode (contrato inteligente do hyperledger).
    Obs.: como são poucos nós que participam das transações de endosso, garante melhor escalabilidade e desempenho da rede.
  • Ordenamento: sequenciamento de transações e empacotamento nos blocos
  • Validação: antes de efetivar, cada nó verifica as políticas e concorrência do endosso


Esquema

Cada transação gerada pelo e-notariado para registro no Notarchain, passará pelos nós especialistas (endossantes e ordenadores) até ser replicado em blocos para todos os nós da rede (tabelionatos de notas).




Preparação do Ambiente

Para a instalação do nó da rede Notarchain, o cartório deverá providenciar o seguinte ambiente tecnológico:


Tamanho da Máquina


Ambiente com no mínimo 8 GB de memória e 60 GB de disco


Sistema Operacional  


Ubuntu 22.04.3 LTS 64 bits ou versão superior (acesse www.ubuntu.com)


Se o sistema operacional do computador onde será instalado o nó do Notarchain for Windows, criar a máquina virtual Ubuntu utilizando WSL, Hyper-V ou VirtualBox


IP Fixo


É necessário que a conexão seja com IP Fixo. 

Se o cartório não tiver IP fixo contratado de sua operadora de internet, pode-se utilizar serviços de DNS dinâmico, tais como, No-IP www.noip.com


Firewall
Configurar encaminhamento das portas 7051 e 7052.


Conforme o modelo e configuração das regras de firewall do cartório, poderá também ser necessário configurar a porta 7050. A configuração do DDNS deverá ser feita para o caso de ativação de serviços de DNS dinâmico (ex: No-IP)


Hostname


Para a instalação e execução do Notarchain, será necessário definir um hostname.



Padrão de nomenclatura do hostname: uf-cns.<domínio>

uf: unidade da federação onde se encontra o cartório
cns: código nacional de serventia do cartório com 6 dígitos. Acrescentar zeros à esquerda se necessário.

domínio: domínio definido pelo cartório ou padrão CNB

Exemplos: 
df-021712.notarchain.org.br
sc-109256.tabelionatoportobelo.com.br

df-021712.ddns.net

 
Caso a rede do cartório já seja IP Fixo e ainda não tenha um hostname configurado, o CNB poderá excepcionalmente criar o hostname em seu servidor cloud, vinculando ao IP fixo do cartório.


Se o cartório utilizar DNS dinâmico (Ex: No-IP), utilizar o hostname cadastrado neste serviço.


Instalação

  1. Solicite ao CNB o credenciamento do cartório para ser um nó da rede Notarchain.

  2. Executar a instrução curl enviada pelo CNB, como o exemplo abaixo:
  3. Então será feito o download do arquivo “peer.zip” no computador. Caso haja algum problema nesse comando, é possível copiar esta URL e acessar via navegador (p.ex. Google Chrome, Firefox, etc...) para realizar o download do arquivo.
  4. Descompacte um arquivo em uma pasta local. Entre nesta pasta e execute o script start-peer.sh para iniciar a execução do peer. Os seguintes comandos irão fazer estes passos:

    $> unzip peer.zip -d peer

    $> cd peer

    $> chmod +x *.sh

    $> ./start-peer.sh

  5. Para verificar se o nó está recebendo os blocos corretamente, execute os seguintes comandos:
    docker logs hostname

    O resultado esperado apresentará "peer entered RUNNING state"

    docker logs hostname-connector

    Esse comando permite verificar os blocos armazenados e registrados no nó.
    O resultado esperado é como esse exemplo:

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo