Certifique-se de instalar todos os requisitos necessários para iniciar o desenvolvimento:
- Sistemas operacionais: Ubuntu 14.04 +, ou Mac OS 10.12
- Ao menos 4GB de RAM
- Docker Engine: versão 17.03 +
- Docker-Compose: versão 1.8 +
- Node: 8.9 +
- npm: v5.x +
- git: 2.9.x +
- Python: 2.7.x +
- Um editor de texto de sua escolha, nós recomendamos o VSCode
Caso esteja utilizando o ubuntu 16.04, utilize o seguinte script para instalar os pre-requisitos:
curl -O https://hyperledger.github.io/composer/latest/prereqs-ubuntu.sh
chmod u+x prereqs-ubuntu.sh
Em seguida rode o script. O mesmo fara o uso do sudo em sua execução e você precisará autorizar com sua senha:
./prereqs-ubuntu.sh
- Ferramentas essenciais CLI:
npm install -g composer-cli@0.20
- Utilitário para gerar um servidor REST na sua máquina e tornar a rede uma API REST.
npm install -g composer-rest-server@0.20
- Útil para gerar ativos da aplicação.
npm install -g generator-hyperledger-composer@0.20
- Yeoman é uma ferramenta para gerar aplicações. A mesma utiliza o
generator-hyperledger-composer
npm install -g yo
- Aplicação de navegador para editar e testar uma rede de negócios.
npm install -g composer-rest-server@0.20
Enquanto podemos utilizar o navegador para trabalhar na aplicação, muitos usuários preferem utilizar uma IDE. Nós recomendamos o uso do VSCode pois o mesmo tem uma extensão do Composer disponível.
- Baixe e instale o VSCode por este link.
- Abra-o, vá em extensões e procure por
Hyperledger Composere em seguida instale-o.
Em seguida faremos a instalação de um runtime do Hyperledger Fabric para que seja possível dar deploy em suas redes de negócios.
- Em um diretório de sua escolha, baixe e faça a extração do arquivo
.tar.gzque contem os arquivos necessários para a instalação:
mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers
curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz
- Use os scripts que você acabou de baixar e extrair para adquirir uma versão local do Hyperledger Fabric 1.2:
cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./downloadFabric.sh
O Hyperledger Composer fornece uma opção mais amigável para o desenvolvimento de aplicações blockchain. Nesse tutorial iremos definir todos os elementos da nossa rede e, por último, iremos gerar uma API REST que pode servir de ponte entre a rede blockchain e aplicações externas. Para definir todos os elementos dessa rede, iremos seguir os passos fornecidos pela documentação oficial do Hyperledger Composer, que são:
- Criar a estrutura da rede;
- Definir os elementos da rede de negócios;
- Gerar um arquivo de rede;
- Implantar a rede de negócios;
- Gerar um servidor REST;
Essa estrutura conterá alguns arquivos de definições de uma Rede de Negócios básica, distribuídos em alguns diretórios como por exemplo:
- O arquivo de modelos
models.ctoque conterá as informações pertinentes aos participantes, ativos e transações da rede. - O arquivo de controle de acessos
permissions.aclque conterá regras para definir a quais ativos de uma rede os participantes terão acesso e sob quais condições.
Para isso, executamos o seguinte comando no terminal:
yo hyperledger-composer:businessnetwork
Ao executar esse comando, serão solicitadas algumas informações para criar a estrutura de rede. A primeira será o nome da rede que definiremos como blockchain-teste. Depois colocaremos a descrição da rede, o nome e e-mail do autor. O campo “Licence” podemos deixar com a opção default (Apache-2.0). No campo “Namespace”, colocaremos org.teste.blockchain. E por último, a ferramenta pergunta se queremos gerar uma rede vazia ou não. Selecionaremos “Sim”.
Se a geração for bem sucedida, deverão ser exibidos no terminal os arquivos e diretórios criados pela ferramenta:
create package.json
create README.md
create models/org.test.blockchain.cto
create permissions.acl
create .eslitrc.yml
Depois de executado esse comando devemos ter uma pasta criada com o mesmo nome da rede. Vá até o diretório do projeto. Como selecionamos a opção “Sim” para gerar uma rede vazia, o gerador Yo gerou o mínimo de arquivos e diretórios necessários para uma rede de negócios Hyperledger Composer. Para o nosso tutorial precisaremos de mais que isso, portanto devemos criar na raiz do projeto um arquivo chamado “logic.js”.
Aqui você irá definir os elementos da rede de negócios seguindo como base os templates de cada arquivo que foi gerado no passo 1.
Para isso utilize a IDE VSCode que foi sugerida como um dos pré-requisitos.
Basta navegar até o diretório do projeto /blockchain-teste e digitar o seguinte comando no terminal:
code .
Nesse tutorial definiremos uma rede blockchain bem simples, que simulará um mercado imobiliário, onde teremos como ativos fazendas, e teremos como participantes os proprietários das fazendas.
Na IDE, abra o arquivo org.teste.blockchain.cto contido no diretório models/ e substitua o conteúdo do arquivo pelo seguinte:
namespace org.test.blockchain
participant Proprietario identified by cpf {
o String cpf
o String nomeProprietario
}
asset Fazenda identified by nomeFazenda {
o String nomeFazenda
o Double valor
--> Proprietario proprietario
}
transaction Transferencia {
--> Fazenda fazenda
--> Proprietario novoProprietario
}Aqui temos definido um modelo de participante cujas instâncias serão identificadas pelo cpf e possuirão um nomeProprietario como atributo, um modelo de ativo cujas instâncias são identificadas pelo nomeFazenda e possuem um atributo valor e um relacionamento com um participante da rede.
Por último um modelo de transação que possui um relacionamento com um ativo e um relacionamento para uma instância que representa o novo proprietário da fazenda. O código desse arquivo é escrito na linguagem orientada a objetos: Hyperledger Composer Modeling Language.
Agora que temos os modelos definidos, devemos implementar a lógica que irá de fato processar a transação e modificar a blockchain, utilizando as definições contidas no arquivo de modelos.
Na IDE, abra o arquivo logic.js que criamos e substitua o conteúdo do arquivo pelo seguinte:
/**
* @param {org.teste.blockchain.Transferencia} tr
* @transaction
*/
async function transferenciaDeProprietario(tr) {
tr.fazenda.proprietario = tr.novoProprietario;
let assetRegistros = await getAssetRegistry('org.blockchain.Fazenda');
await assetRegistros.update(tr.fazenda)
}Considerando as linhas do arquivo logic.js:
-
2: nós criamos um objeto do tipo parâmetro, que representa qual dos modelos de transação iremos implementar;
-
5: passamos esse objeto como parâmetro para a função JavaScript em questão. Na linha 6 substituímos o relacionamento do asset fazenda contido do objeto parâmetro diretamente pelo relacionamento também contido no objeto parâmetro;
-
7: recuperamos todos os “registros” do asset “Fazenda” contido na blockchain e salvamos na variável “assetRegistros”;
-
8: nós atualizamos esses registros diretamente na blockchain passando como parâmetro para a função “update” o próprio objeto que modificamos nessa transação.
O código desse arquivo é escrito em Javascript.
Nesse tutorial não iremos especificar como funciona o permissionamento numa rede de negócios Hyperledger Composer, portanto não iremos modificar o arquivo permissions.acl.
rule NetworkAdminUser {
description: "Grant business network administrators full access to user resources"
participant: "org.hyperledger.composer.system.NetworkAdmin"
operation: ALL
resource: "**"
action: ALLOW
}
rule NetworkAdminSystem {
description: "Grant business network administrators full access to system resources"
participant: "org.hyperledger.composer.system.NetworkAdmin"
operation: ALL
resource: "org.hyperledger.composer.system.**"
action: ALLOW
}
Para entender um pouco a função desse arquivo, nele nós escrevemos regras que especificam o que cada tipo de usuário terá acesso na rede. As duas regras criadas pelo gerador Yo basicamente fornecem aos administradores da rede de negócios acesso total aos recursos.
Para mais informações sobre como é implementado o permissionamento numa rede de negócios Hyperledger Composer, acesse o tutorial.
Nesse arquivo serão empacotados todas as informações e todos os elementos da rede, necessários para a Implantação da rede no próximo passo.
Uma observação que deve ser considerada é que a rede instanciada nesse tutorial roda apenas em uma máquina local.
Execute no terminal:
composer archive create -t dir -n .
Esse comando irá gerar um arquivo com o nome da rede e extensão .bna. É esse arquivo que iremos passar como argumento no próximo passo a fim de implantar nossa rede.
Nesse passo a rede blockchain desenvolvida com o conjunto de ferramentas Hyperledger Composer será implantada em uma instância de rede do framework Hyperledger Fabric.
Primeiro, execute as instâncias Fabric navegando até o diretório /fabric-dev-servers e executando o script startFabric.sh com o seguinte comando no terminal:
./startFabric.sh
Com as instâncias Fabric em execução, navegue de volta até a pasta do projeto e execute no terminal:
composer network install --card PeerAdmin@hlfv1 --archiveFile blockchain-teste@0.0.1.bna
O comando composer network install basicamente utiliza todas as permissões de administrador de rede Fabric fornecidas pelas credenciais presentes no card PeerAdmin@hlfv1, para instalar a rede de negócios definida no arquivo blockchain-teste@0.0.1.bna na rede Fabric em questão. Essas credenciais são criadas na instalação do Hyperledger Fabric na máquina local.
Depois de instalar, você deve iniciar a rede de negócios. Execute no terminal:
composer network start --networkName blockchain-teste --networkVersion 0.0.1 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card
Com a rede iniciada, importe a identidade do administrador da rede com o seguinte comando:
composer card import --file networkadmin.card
Verifique se a rede foi implantada. Execute no terminal:
composer network ping --card admin@blockchain-teste
Utilizando a ferramenta HyperLedger Compose, poderemos criar uma API REST sob medida baseada em uma rede comercial. Nela é contida uma camada útil de abstração neutra de linguagem.
Execute no terminal:
composer-rest-server -c admin@blockchain-teste -n never
Agora, podemos acessar as funcionalidades da blockchain através da API contida no endereço: http://localhost:3000/explorer/