ÍNDICE

• Apresentação
• Arquitetura
  • Principais características da plataforma Hyperledger
  • Esquema
• Preparação do Ambiente
• Instalação

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: