Automatize seu fluxo de trabalho do Solidity usando o Buidler

Aprenda a criar uma tarefa para suas necessidades ad-hoc

O Buidler é uma ferramenta de desenvolvimento extensível que ajuda os desenvolvedores de contratos inteligentes a aumentar a produtividade, reunindo de maneira confiável as ferramentas que eles desejam. Dê uma olhada no nosso posto de visão ou acesse o Github para saber mais.

Neste guia, exploraremos a criação de tarefas no Buidler, que são o componente principal usado para automação. Para uma visão geral do uso do Buidler, consulte o Guia de primeiros passos.

O que exatamente são as tarefas no Buidler?

Tudo o que você pode fazer no Buidler é definido como uma tarefa. As ações padrão que saem da caixa são tarefas internas e são implementadas usando as mesmas APIs disponíveis para você como usuário.

A lista padrão de tarefas de uma nova instalação do Buidler.

Como alguns exemplos, você pode criar uma tarefa para redefinir o estado de um ambiente de desenvolvimento, interagir com seus contratos ou empacotar seu projeto.

Vamos passar pelo processo de criação de um para interagir com um contrato inteligente.

As tarefas no Buidler são funções JavaScript assíncronas que obtêm acesso ao Buidler Runtime Environment, através do qual você obtém acesso à configuração, parâmetros, acesso programático a outras tarefas e quaisquer plugins de objetos que possam ter sido injetados.

No nosso exemplo, usaremos o Web3.js para interagir com nossos contratos e, portanto, instalaremos o plug-in web3, que injeta uma instância da Web3 no ambiente Buidler:

npm install @ nomiclabs / buidler-web3
npm install --save-exact [email protected]

Dê uma olhada na lista de plugins Buidler para ver outras bibliotecas disponíveis.

Exigiremos o plug-in e adicionaremos nosso código de criação de tarefas ao arquivo de configuração do Buidler, que é sempre executado na inicialização antes que algo aconteça. É um bom lugar para criar tarefas simples. Se sua tarefa for mais complexa, você poderá colocá-la em um arquivo separado e solicitá-la ou, se estiver escrevendo um plug-in Buidler que adicione uma tarefa, poderá criá-la a partir de um pacote npm separado. Saiba mais sobre a criação de tarefas através de plug-ins no nosso guia Como criar um plug-in.

Vamos criar uma tarefa para obter o saldo de uma conta no terminal. Você pode fazer isso com o DSL de configuração do Buidler, disponível no escopo global de buidler.config.js:

Depois de salvar o arquivo, você já poderá ver a tarefa no Buidler:

Agora vamos implementar a funcionalidade que queremos. Precisamos obter o endereço da conta do usuário. Podemos fazer isso adicionando um parâmetro à nossa tarefa:

Quando você adiciona um parâmetro a uma tarefa, o Buidler manipula suas mensagens de ajuda para você:

Vamos agora obter o saldo da conta. O Buidler Runtime Environment estará disponível no escopo global. Ao usar o plug-in web3 da Buidler, obtemos acesso a uma instância web3:

Finalmente, podemos executá-lo:

E aí está. Sua primeira tarefa Buidler totalmente funcional, permitindo que você interaja com a blockchain Ethereum de uma maneira fácil.

Para qualquer dúvida ou comentário que possa ter, você pode encontrar-nos no grupo Telegrama de suporte da Buidler.

  • Confira o Buidler no Github.
  • Participe do nosso grupo Buidler News Telegram somente leitura para se manter atualizado sobre novos lançamentos, plugins e tutoriais.
  • Siga o Nomic Labs no Twitter e Medium.