C Execute Contratos Inteligentes da Solidity com EVM no Oracle Blockchain Platform

Você pode executar contratos inteligentes da Solidity com uma Máquina Virtual Ethereum (EVM) implantada como um chaincode no Oracle Blockchain Platform.

A EVM executa contratos inteligentes Solidity em redes Ethereum. O EVM foi criado por meio do projeto Hyperledger Burrow e integrado ao Hyperledger Fabric. Este projeto permite que você use uma plataforma blockchain com permissão do Hyperledger Fabric para interagir com contratos inteligentes Ethereum escritos em uma linguagem compatível com EVM, como Solidity. Consulte: Hyperledger Fabric EVM chaincode.

As etapas a seguir descrevem o processo de execução de um contrato inteligente Solidity em uma instância provisionada do Oracle Blockchain Platform:

1. Faça upload do pacote chaincode EVM no Oracle Blockchain Platform.
2. Implante o chaincode EVM em um canal.
3. Gere código de bytes para um contrato inteligente da Solidity usando o IDE Remix.
4. Implante o código de bytes de contrato inteligente no chaincode EVM implantado. Use o endereço retornado da implantação para enviar transações.

As etapas deste tópico foram testadas com o fabric-chaincode-evm:release-0.4 e podem não funcionar com outras releases.

Configurar o pacote EVM Chaincode

Para poder implantar o contrato inteligente, configure o pacote chaincode EVM. Conclua as seguintes etapas para criar a pasta do pacote chaincode.

1. Faça download do pacote EVM chaincode (arquivo .zip) no seguinte repositório GitHub: Hyperledger Fabric EVM chaincode.
2. Extraia o arquivo baixado fabric-chaincode-evm-release-0.4.zip.
3. Nos arquivos extraídos, navegue até o diretório fabric-chaincode-evm-release-0.4/evmcc.
4. Exclua o arquivo go.sum e o diretório vendor.
5. Fornecer todos os módulos Go dependentes usando o comando go mod:

   go mod tidy
   go mod vendor

6. Navegue até o diretório fabric-chaincode-evm-release-0.4/emvcc/vendor/github.com/hyperledger.
7. Crie o diretório fabric-chaincode-evm/evmcc no diretório /hyperledger.
8. Mova as seguintes pastas do diretório fabric-chaincode-evm-release-0.4/evmcc para o diretório fabric-chaincode-evm-release-0.4/evmcc/vendor/github.com/hyperledger/fabric-chaincode-evm/evmcc:
   • /address
   • /event
   • /eventmanager
   • /mocks
   • /statemanager
   A estrutura do diretório é semelhante à seguinte captura de tela quando concluída:
   
   
   
   
9. Compacte a pasta fabric-chaincode-evm-release-0.4/evmcc de nível superior no formato .zip e renomeie-a. As etapas a seguir usam evmcc.zip como o nome do exemplo.

Implante o EVM Chaincode no Oracle Blockchain Platform

Depois de criar o pacote chaincode EVM, você o implanta no Oracle Blockchain Platform.

1. Faça log-in na console do Oracle Blockchain Platform.
2. Na guia Códigos de Cadeia, selecione Implantar um Novo Código de Cadeia.
3. Selecione Implantação Rápida e especifique as seguintes informações:
   • Label do Pacote: informe uma descrição do pacote chaincode.
   • Idioma do Codigo: GoLang.
   • Nome do Codigo: informe o nome do chaincode. Por exemplo, informe soliditycc.
   • Versão: v1.
   • Init-required: deixe esta opção desmarcada.
   • Canal: selecione os canais nos quais você deseja instalar o chaincode.
   • Origem de código-fonte: faça upload do pacote evmcc.zip que você criou nas etapas anteriores.
   Para obter mais detalhes sobre o assistente de Implantação Rápida e restrições em campos como Rótulo de Pacote e Nome do Código de Cadeia, consulte: Usar Implantação Rápida.

Depois que você submeter suas informações, o chaincode EVM ficará visível na página Chaincodes e será listado como um chaincode implantado em cada canal selecionado para instalação.

Crie e Compile Seu Contrato Inteligente Solidity

1. Abra o IDE Remix baseado em browser: https://remix.ethereum.org/.
2. Se você já tem um contrato inteligente da Solidity escrito, importe-o para o Remix.
3. Se você não tiver um contrato inteligente do Solidity escrito, crie um arquivo do Solidity (arquivo .sol) no Remix e execute uma das seguintes etapas:
   • Se você está familiarizado com o Solidity, crie seu próprio arquivo de contrato inteligente.
   • Use o código de amostra SimpleStorage fornecido na documentação do Solidity: Solididade: Introdução a Contratos Inteligentes
   • Use o código de amostra que está sendo usado para este exemplo, que usa o valor string name como entrada e imprime o mesmo valor de uma string de saída usando as funções set(name) e get().

     pragma solidity ^0.4.0;
     contract Myname {
         string public yourName;
     
         function set(string name) public {
             yourName = name;
         }
         function get() public view returns (string) {
             return yourName;
         }
     }
     

   Talvez você veja uma mensagem de erro sobre a versão do compilador padrão que não corresponde à versão especificada no contrato inteligente.
4. Compile seu contrato inteligente. Abra o painel Compilador de Solidity no Remix, verifique se a guia do contrato inteligente está aberta para selecioná-lo como o arquivo que está sendo compilado e defina a versão do compilador como a 4 mais recente. Versão X e selecione Compilar.
   
   
   
   
5. Depois que o arquivo for compilado, selecione o ícone Bytecode para copiar o código de bytes como um documento JSON para sua área de transferência.
6. Cole o código de bytes copiado em um editor de texto e salve-o.

Implantar o Contrato Inteligente

No código de bytes copiado, a seção necessária é o campo "object". Este é o código de bytes EVM de um contrato inteligente de amostra.

"object": "608060405234801561001057600080fd5b50610410806100206000396000f30060
8060405260043610610057576000357c0100000000000000000000000000000000000000000000000000000000900463
ffffffff1680634ed3885e1461005c5780636d4ce63c146100c5578063d97d663014610155575b600080fd5b34801561
006857600080fd5b506100c3600480360381019080803590602001908201803590602001908080601f01602080910402
602001604051908101604052809392919081815260200183838082843782019150505050505091929192905050506101
e5565b005b3480156100d157600080fd5b506100da6101ff565b60405180806020018281038252838181518152602001
91508051906020019080838360005b8381101561011a5780820151818401526020810190506100ff565b505050509050
90810190601f1680156101475780820380516001836020036101000a031916815260200191505b509250505060405180
910390f35b34801561016157600080fd5b5061016a6102a1565b60405180806020018281038252838181518152602001
91508051906020019080838360005b838110156101aa57808201518184015260208101905061018f565b505050509050
90810190601f1680156101d75780820380516001836020036101000a031916815260200191505b509250505060405180
910390f35b80600090805190602001906101fb92919061033f565b5050565b6060600080546001816001161561010002
03166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615
6101000203166002900480156102975780601f1061026c57610100808354040283529160200191610297565b82019190
6000526020600020905b81548152906001019060200180831161027a57829003601f168201915b505050505090509056
5b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190
818152602001828054600181600116156101000203166002900480156103375780601f1061030c576101008083540402
83529160200191610337565b820191906000526020600020905b81548152906001019060200180831161031a57829003
601f168201915b505050505081565b828054600181600116156101000203166002900490600052602060002090601f01
6020900481019282601f1061038057805160ff19168380011785556103ae565b828001600101855582156103ae579182
015b828111156103ad578251825591602001919060010190610392565b5b5090506103bb91906103bf565b5090565b61
03e191905b808211156103dd5760008160009055506001016103c5565b5090565b905600a165627a7a72305820a990d4
0b57c66329a32a18e847b3c18d6c911487ffadfed2098e71e8cafa0c980029",

Em geral, o EVM espera dois argumentos:

• O endereço to.
• O código de bytes input necessário em transações Ethereum.

Para implantar contratos inteligentes, o campo to é o endereço zero e input é o código de bytes EVM compilado do contrato. Portanto, há dois argumentos fornecidos para o comando invoke. O primeiro, que tradicionalmente deveria ser um nome de função dentro do chaincode, agora é 0000000000000000000000000000000000000000, e o segundo argumento é o bytecode de contrato inteligente da Solidity.

1. Para implantar o contrato inteligente Solidity no Oracle Blockchain Platform, você pode fazer a seguinte chamada de proxy REST para enviar os dois argumentos ao EVM.

   {
       "chaincode": "<evmcc-ccid>",
       "args": [
           "0000000000000000000000000000000000000000",
           "<bytecode-of-the-smart-contract>"
       ],
       "timeout": 0,
       "sync": true
   }

   O exemplo a seguir usa o cURL para implantar o contrato inteligente Solidity no Oracle Blockchain Platform com o nome soliditycc.

   curl -L -X POST 'https://<hostname>:443/restproxy/api/v2/channels/<channelname>/transactions' \
   -H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
   -H 'Content-Type: application/json' \
   --data-raw '{"chaincode":"<evmcc-ccid>","args":["0000000000000000000000000000000000000000","<bytecode-of-the-smart-contract>"],"timeout":0,"sync":true}'

2. A resposta payload da transação é o endereço do contrato implantado. Copie este endereço e salve-o. O endereço do contrato é usado quando você executa funções de contrato inteligente.
   
   Neste exemplo, o endereço do contrato inteligente é 66b92979bb66d645371b3247177e4b2513cb9834.

Existem duas maneiras de interagir com um contrato inteligente implantado.

1. Interaja usando um valor hash do método e dos parâmetros de entrada.
2. Interaja usando diretamente o nome do método e os parâmetros de entrada.

Interagindo com o Contrato Inteligente Usando Valores de Hash

Depois de ter o endereço do contrato inteligente, você poderá usar as chamadas a seguir para interagir com o contrato inteligente implantado por meio do proxy REST.

Para executar funções, você usa transações de chamada e consulta, mas com parâmetros diferentes. O contrato de amostra contém duas funções: get e set.

Nessas transações, o campo to é o endereço do contrato e o campo input é o hash de execução da função concatenado com qualquer um dos argumentos necessários.

Você deve adquirir o hash da execução da função para executar uma transação. Uma maneira simples de fazer isso é executar as funções no IDE Remix e, em seguida, copiar o hash dos logs de transação:

1. No Remix IDE, abra o painel Implantar e Executar Transações. Certifique-se de que seu contrato esteja selecionado no campo Contrato e selecione Implantar.
   
   
   
   Após a conclusão da implantação, o contrato será listado na lista Contratos Implantados.
2. Expanda o contrato na lista Contratos Implantados. As funções do contrato inteligente são listadas.
3. Executar uma transação. Para o exemplo fornecido, informe oracle e selecione set.
4. A janela Terminal mostra os logs de transação. Se os logs de transação forem minimizados, expanda-os selecionando o log. Copie o valor do campo input (que é o hash de execução de função) selecionando o ícone ao lado dele. Salve esse valor no mesmo local que o endereço do contrato, removendo o 0x à esquerda.
   
   
   
   
5. Depois de ter o hash de execução da função e o endereço do contrato, você poderá executar a transação definida no Oracle Blockchain Platform usando o hash e o endereço como argumentos de dados brutos.

   
   --data-raw '{"chaincode":"<chaincodename>","args":["<contractaddress>","<setfunctionexecutionhash>"]}'
   

   O exemplo a seguir mostra como executar a transação usando o cURL:

   curl -L -X POST 'https://<hostname>:443/restproxy/api/v2/channels/<channelname>/transactions' \
   -H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
   -H 'Content-Type: application/json' \
   --data-raw '{"chaincode":"soliditycc","args":["66b92979bb66d645371b3247177e4b2513cb9834","4ed3885e000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000066f7261636c650000000000000000000000000000000000000000000000000000"]}'
   

6. Abra a console do Oracle Blockchain Platform e verifique se a transação está listada no razão.

Para executar outra transação, como uma consulta, usando a função get do contrato inteligente, você pode gerar o hash de execução da função no Remix e combiná-lo com o endereço do contrato:

1. Em Remix no painel Implantar e Executar Transações, certifique-se de que seu contrato ainda esteja listado em Contratos Implantados. Caso contrário, reimplante-o.
2. Selecione get. Recupere e salve a entrada da transação como fez com a transação set, removendo o 0x à esquerda.
   
   
   
   
3. Use esse hash de transação e o endereço do contrato para executar uma transação de consulta no chaincode implantado no Oracle Blockchain Platform.

   
   --data-raw '{"chaincode":"<chaincodename>","args":["<contractaddress>","<getfunctionexecutionhash>"]}'
   

   O exemplo a seguir mostra como executar a transação usando o cURL:

   curl -L -X POST 'https://<hostname>:443/restproxy/api/v2/channels/<channelname>/chaincode-queries' \
   -H 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
   -H 'Content-Type: application/json' \
   --data-raw '{"chaincode":"soliditycc","args":["66b92979bb66d645371b3247177e4b2513cb9834","6d4ce63c"]}'
   

   O payload retornado conterá o ativo que está sendo consultado, que no caso de exemplo é a string oracle.