Pular para o conteúdo principal

Introdução ao Desenvolvimento na Ethereum

JavaScript
ethers.js
nós
consultando
Alchemy
Iniciante
Elan Halpern
30 de outubro de 2020
5 minutos de leitura

Logos do Ethereum e da Alchemy

Este é um guia para iniciantes para começar o desenvolvimento na Ethereum. Para este tutorial, usaremos a Alchemy (opens in a new tab), a plataforma líder para desenvolvedores de cadeia de blocos que atende a milhões de usuários de 70% dos principais aplicativos de cadeia de blocos, incluindo Maker, 0x, MyEtherWallet, Dharma e Kyber. A Alchemy nos dará acesso a um ponto de extremidade de API na cadeia Ethereum para que possamos ler e escrever transações.

Vamos guiar você desde a inscrição na Alchemy até a escrita do seu primeiro script web3! Não é necessária experiência em desenvolvimento de cadeia de blocos!

1. Inscreva-se para obter uma conta gratuita da Alchemy

Criar uma conta na Alchemy é fácil, inscreva-se gratuitamente aqui (opens in a new tab).

2. Crie um aplicativo da Alchemy

Para se comunicar com a cadeia Ethereum e usar os produtos da Alchemy, você precisa de uma chave de API para autenticar suas solicitações.

Você pode criar chaves de API a partir do painel (opens in a new tab). Para criar uma nova chave, navegue até "Create App", como mostrado abaixo:

Agradecimentos especiais à ShapeShift (opens in a new tab) por nos permitir mostrar o painel deles!

Painel da Alchemy

Preencha os detalhes em "Create App" para obter sua nova chave. Você também pode ver aqui os aplicativos que criou anteriormente e os que foram feitos pela sua equipe. Obtenha chaves existentes clicando em "View Key" para qualquer aplicativo.

Captura de tela da criação de um aplicativo com a Alchemy

Você também pode obter chaves de API existentes passando o mouse sobre "Apps" e selecionando uma. Você pode usar o "View Key" aqui, bem como o "Edit App" para adicionar domínios específicos à lista de permissões, ver várias ferramentas de desenvolvedor e visualizar as análises.

Gif mostrando um usuário obtendo chaves de API

3. Faça uma solicitação a partir da linha de comando

Interaja com a cadeia de blocos Ethereum através da Alchemy usando JSON-RPC e curl.

Para solicitações manuais, recomendamos interagir com o JSON-RPC por meio de solicitações POST. Basta passar o cabeçalho Content-Type: application/json e sua consulta como o corpo do POST com os seguintes campos:

  • jsonrpc: a versão do JSON-RPC — atualmente, apenas a 2.0 é suportada.
  • method: o método da API ETH. Consulte a referência da API. (opens in a new tab)
  • params: uma lista de parâmetros a serem passados para o método.
  • id: o ID da sua solicitação. Ele será retornado pela resposta para que você possa rastrear a qual solicitação uma resposta pertence.

Aqui está um exemplo que você pode executar na linha de comando para obter o preço atual do gás:

curl https://eth-mainnet.alchemyapi.io/v2/demo \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'

OBSERVAÇÃO: substitua https://eth-mainnet.alchemyapi.io/v2/demo (opens in a new tab) pela sua própria chave de API https://eth-mainnet.alchemyapi.io/v2/**your-api-key.

Resultados:

1{ "id": 73,"jsonrpc": "2.0","result": "0x09184e72a000" // 10000000000000 }

4. Configure seu cliente Web3

Se você já tiver um cliente, altere o URL do provedor do nó atual para um URL da Alchemy com sua chave de API: "https://eth-mainnet.alchemyapi.io/v2/your-api-key"

OBSERVAÇÃO: os scripts abaixo precisam ser executados em um contexto de nó ou salvos em um arquivo, e não executados a partir da linha de comando. Se você ainda não tiver o Node ou o npm instalado, confira este guia de configuração rápida para Macs (opens in a new tab).

Existem inúmeras bibliotecas Web3 (opens in a new tab) que você pode integrar com a Alchemy. No entanto, recomendamos o uso da Alchemy Web3 (opens in a new tab), um substituto direto para web3.js, criado e configurado para funcionar perfeitamente com a Alchemy. Isso oferece várias vantagens, como novas tentativas automáticas e suporte robusto a WebSocket.

Para instalar o AlchemyWeb3.js, navegue até o diretório do seu projeto e execute:

Com Yarn:

1yarn add @alch/alchemy-web3

Com NPM:

1npm install @alch/alchemy-web3

Para interagir com a infraestrutura de nós da Alchemy, execute no NodeJS ou adicione isto a um arquivo JavaScript:

1const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
2const web3 = createAlchemyWeb3(
3 "https://eth-mainnet.alchemyapi.io/v2/your-api-key"
4)

5. Escreva seu primeiro Script Web3!

Agora, para pôr a mão na massa com um pouco de programação web3, escreveremos um script simples que imprime o número do bloco mais recente da Mainnet do Ethereum.

1. Se ainda não o fez, crie um novo diretório de projeto em seu terminal e acesse-o com o comando cd:

1mkdir web3-example
2cd web3-example

2. Instale a dependência do Alchemy web3 (ou qualquer web3) em seu projeto, caso ainda não o tenha feito:

1npm install @alch/alchemy-web3

3. Crie um arquivo chamado index.js e adicione o seguinte conteúdo:

Você deve, por fim, substituir demo por sua chave de API HTTP da Alchemy.

1async function main() {
2 const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
3 const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo")
4 const blockNumber = await web3.eth.getBlockNumber()
5 console.log("O número do bloco mais recente é " + blockNumber)
6}
7main()

Não está familiarizado com programação assíncrona? Confira esta publicação no Medium (opens in a new tab).

**4. Execute-o no seu terminal usando node

1node index.js

5. Agora você deve ver o número do bloco mais recente exibido em seu console!

1O número do bloco mais recente é 11043912

Eba! Parabéns! Você acabou de escrever seu primeiro script web3 usando a Alchemy 🎉**

Não sabe o que fazer a seguir? Tente implantar seu primeiro contrato inteligente e se aventurar um pouco na programação em Solidity com nosso Guia de Contrato Inteligente Hello World (opens in a new tab), ou teste seus conhecimentos sobre o painel com o Aplicativo de Demonstração do Painel (opens in a new tab)!

Inscreva-se na Alchemy gratuitamente (opens in a new tab), confira nossa documentação (opens in a new tab) e, para receber as notícias mais recentes, siga-nos no Twitter (opens in a new tab).

Última atualização da página: 25 de setembro de 2025

Este tutorial foi útil?