Repositório contendo os arquivos necessários para implantar um contrato inteligente em uma Blockchain, utilizando Python e a biblioteca Web3.
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.
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
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.