Como instalar o Scaffold-ETH

Requisitos

É necessário ter instalado previamente o seguinte:

• Node (>= v18.17)

• Visual Studio Code

• Git

Nos pré-requisitos deste módulo, você pode encontrar as instruções para instalar esses componentes.

Além disso, é necessário instalar o Yarn.

• Yarn: é um gerenciador de pacotes de código aberto utilizado para gerenciar dependências em projetos JavaScript. Ele facilita o processo de instalação, atualização, configuração e remoção de pacotes.

Para instalar o Yarn, acesse seu site oficial e siga as instruções de instalação.

📦 Instalação do Scaffold-ETH

Você pode instalar o Scaffold-ETH de duas maneiras:

Opção 1: Clonar o repositório do GitHub

git clone https://github.com/scaffold-eth/scaffold-eth-2.git
cd scaffold-eth-2
yarn install

Opção 2: Instalação guiada via npx

npx create-eth@latest

Durante a instalação, você será guiado por algumas perguntas:

• Nome do projeto: insira o nome desejado.

• Framework Solidity: escolha entre Hardhat ou Foundry.

Depois de configurar:

cd project-name

Após entrar na pasta do projeto e abrir o VS Code com code ., você deve abrir 3 janelas de terminal para executar os seguintes comandos:

Terminal 1 – Inicializar a blockchain local.

yarn chain

Isso inicia uma blockchain Ethereum local com Hardhat ou Foundry (dependendo da escolha feita). Ela é usada para testes e desenvolvimento.

Terminal 2 – Desplegar o contrato inteligente.

yarn deploy

Esse comando faz o deploy de um contrato de teste na blockchain local. Os contratos estão localizados em:

• Hardhat: packages/hardhat/contracts

• Foundry: packages/foundry/contracts

Você pode personalizar o script de deploy em:

• Hardhat: packages/hardhat/deploy

• Foundry: packages/foundry/script

Terminal 3 – Iniciar o Front-End

yarn start

Você pode editar o Front-End no arquivo packages/nextjs/app/page.tsx

Se você acessar o endereço http://localhost:3000 , poderá ver o aplicativo em funcionamento.

Se você olhar no canto superior direito, verá que uma carteira foi gerada automaticamente. Essa é uma BurnerWallet, uma carteira temporária que é criada toda vez que a dapp é aberta em um navegador. A chave privada é armazenada em texto plano no LocalStorage do navegador — o que não é muito seguro, mas é muito prático para testar seus contratos e dapps.

Não é necessário aprovar transações ou confirmar assinaturas, o que torna mais rápido o teste de funcionalidades com essa carteira. Você também pode abrir a dapp em uma janela anônima do navegador ou com outro perfil, e uma nova carteira/endereço será atribuída, permitindo testar facilmente funcionalidades a partir de diferentes perfis de usuários.

Você pode interagir com seu smart contract usando o componente de contrato ou a interface de exemplo no Front-End.

A dapp de exemplo permite registrar saudações e contabiliza quantas saudações foram registradas a partir de um determinado endereço. Além disso, permite que o proprietário (owner) do contrato retire os fundos que estiverem armazenados no contrato.

Comece a fazer alterações no contrato de teste localizado em packages/hardhat/contracts, faça o deploy usando yarn deploy e observe como o Front-End é atualizado automaticamente em resposta às mudanças feitas no contrato. Se você não tiver ETH para executar as transações, use o faucet incorporado que fornecerá 1 ETH por solicitação. Você também pode usar o Block Explorer, acessível pelo link no canto inferior esquerdo. No Block Explorer, você poderá revisar as transações executadas na blockchain local, de forma semelhante ao que faria no Etherscan.

O Scaffold-ETH 2 também incorpora componentes e hooks muito úteis para um desenvolvimento ágil de dapps. Você pode encontrar mais informações sobre eles na documentação do Scaffold-ETH 2.