Implantação de um Contrato Inteligente na Blockchain - Exemplo com Web3 e Python

Repositório contendo os arquivos necessários para implantar um contrato inteligente em uma Blockchain, utilizando Python e a biblioteca Web3.

Requisitos

Recomenda-se a criação de um ambiente virtual em Python para evitar erros de versões ao executar este projeto. Com o ambiente virtual criado e ativado, execute o seguinte comando para instalar as dependências necessárias:

pip install -r requirements.txt --no-cache-dir

Após a instalação das dependências do código, é necessário instalar o compilador da linguagem Solidity, caso não esteja instalado. Instruções de instalação podem ser obtidas aqui.

OBS.: Para instalação e uso do compilador recomendo o WSL (Windows Subsystem for Linux) caso o sistema operacional for Windows, pois o método de instalação será o mesmo para o Linux (mais simples e prático).

Com o compilador instalado, execute os seguintes comandos para compilar o contrato inteligente de exemplo, obter seu Bytecode e ABI, respectivamente.

solc HelloWorld.sol # Compila o contrato inteligente
solc HelloWorld.sol --bin # Retorna o bytecode no terminal
solc HelloWorld.sol --abi # Retorna o ABI no terminal

Após isso, guarde tanto o Bytecode quanto o ABI para serem utilizados nas variáveis de ambiente em seguida.

Estrutura das variáveis de ambiente

As variáveis de ambiente são importantes, pois mascaram dados sensíveis ao invés de coloca-los diretamente no código. Crie um arquivo .env no mesmo local que o arquivo main.py e defina as seguintes variáveis:

URL_PROVIDER=... # URL de conexão RPC com a Blockchain
ACC_PUBLIC_KEY=... # Chave pública da conta
ACC_PRIVATE_KEY=... # Chave privada da conta (opcional para este exemplo)
CONTRACT_BYTECODE=... # Bytecode do contrato inteligente compilado
CONTRACT_ABI=... # ABI do contrato inteligente compilado

Execução

Para executar o código, basta executar o comando:

python main.py

Ao final da execução, será possível verificar que no arquivo .env foi gravado o endereço do contrato inteligente implantado na Blockchain. Além disso, no terminal será possível visualizar a saída esperada do teste de execução do mesmo:

Hello, World!
Olá, Mundo!

Caso esteja utilizando uma rede de teste como o Ganache, poderá visualizar o bloco de criação do contrato, assim como o bloco que grava a chamada do contrato para teste.