Conexão com Ethereum (Web3.js/Ethers.js)
Aprenda a usar bibliotecas JavaScript, como Web3.js e Ethers.js, para estabelecer conexões entre um front-end web e a rede Ethereum.
Conexão com Ethereum (Web3.js/Ethers.js) é uma aula grátis de Web3 & DApp Development Fundamentals no CoddyKit. Esta é a aula 2 de 3. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Web3 & DApp Development Fundamentals, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Web3 & DApp Development Fundamentals inclui 3 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
DApps & Ethereum Connection
Welcome to connecting your DApp's front-end to the Ethereum network! Just like traditional apps need to talk to a server, decentralized applications (DApps) need a way to communicate with the blockchain.
This communication allows your DApp to read data from the blockchain, like account balances, and send transactions, like transferring tokens or calling smart contract functions.
Web3.js & Ethers.js Libraries
To bridge the gap between your web front-end (written in JavaScript) and the Ethereum blockchain, we use specialized libraries.
- Web3.js: The original JavaScript library for interacting with Ethereum. It's widely used and robust.
- Ethers.js: A more modern, lightweight, and often preferred alternative, especially for front-end development, known for its clear API.
Both libraries serve the same core purpose: to make it easy to send and receive data from Ethereum.
Understanding Ethereum Providers
Before your DApp can talk to the blockchain, it needs a provider. A provider is an abstraction that connects your DApp to an Ethereum node.
- Browser Wallets (e.g., MetaMask): These inject a provider object (
window.ethereum) directly into your browser's JavaScript environment. - Node Providers (e.g., Infura, Alchemy): These are services that run Ethereum nodes and provide an API endpoint (URL) for your DApp to connect to, usually for read-only access or when a user doesn't have a browser wallet.
The provider handles the low-level network communication.
Setting Up with npm
To use Web3.js or Ethers.js in your project, you'll typically install them using a package manager like npm (Node Package Manager).
First, make sure you have Node.js and npm installed. Then, in your project directory, open your terminal and run one of these commands:
- For Web3.js:
npm install web3 - For Ethers.js:
npm install ethers
Once installed, you can import them into your JavaScript files.
Connecting via MetaMask (Web3.js)
When a user has MetaMask installed, it injects window.ethereum. You can use this object to create a Web3.js instance and request user permission to connect their wallet.
Here's how you'd typically initialize Web3.js:
async function connectWeb3() {
if (window.ethereum) {
const web3 = new Web3(window.ethereum);
try {
// Request account access if needed
await window.ethereum.request({ method: 'eth_requestAccounts' });
console.log('Web3.js connected!');
return web3;
} catch (error) {
console.error('User denied account access or error:', error);
}
} else {
console.log('MetaMask not detected! Install it or use a different provider.');
}
return null;
}
// To run this in a browser, you'd call connectWeb3()
// For this runnable example, we'll simulate the connection.
async function main() {
console.log('Simulating Web3.js connection...');
const web3Instance = await connectWeb3(); // This would be called in a browser
if (!web3Instance) {
console.log('Failed to connect Web3.js (simulated).');
} else {
console.log('Web3.js connection successful (simulated)!');
}
}
main();Connecting via MetaMask (Ethers.js)
Ethers.js also uses window.ethereum to connect to browser wallets. It uses the concept of a Web3Provider to wrap the injected provider.
This approach offers a clean way to interact with the user's wallet and the network.
const { ethers } = require('ethers'); // In browser, ethers is global
async function connectEthers() {
if (window.ethereum) {
const provider = new ethers.providers.Web3Provider(window.ethereum);
try {
// Request account access
await provider.send('eth_requestAccounts', []);
console.log('Ethers.js connected!');
return provider;
} catch (error) {
console.error('User denied account access or error:', error);
}
} else {
console.log('MetaMask not detected! Install it or use a different provider.');
}
return null;
}
// To run this in a browser, you'd call connectEthers()
// For this runnable example, we'll simulate the connection.
async function main() {
console.log('Simulating Ethers.js connection...');
const ethersProvider = await connectEthers(); // This would be called in a browser
if (!ethersProvider) {
console.log('Failed to connect Ethers.js (simulated).');
} else {
console.log('Ethers.js connection successful (simulated)!');
}
}
main();Reading Data: Get Block Number
Once connected, you can easily read information from the blockchain. A common first step is to get the current block number. This is a read-only operation, meaning it doesn't require a transaction or gas.
Both Web3.js and Ethers.js provide straightforward methods for this.
Get Block Number (Web3.js Example)
Here's how you'd fetch the latest block number using Web3.js after establishing a connection:
// This simulates interaction with a Web3 provider.
// In a real DApp, 'web3' would be an instance connected
// to MetaMask or another Ethereum node.
const web3 = {
eth: {
getBlockNumber: async () => {
// Simulate network call delay
await new Promise(resolve => setTimeout(resolve, 500));
return 12345678; // Example block number
}
}
};
async function main() {
console.log("Attempting to get block number with Web3.js...");
const blockNumber = await web3.eth.getBlockNumber();
console.log("Current Block Number (Web3.js):", blockNumber);
}
main();Get Block Number (Ethers.js Example)
And here's the equivalent operation using Ethers.js:
// This simulates interaction with an Ethers.js provider.
// In a real DApp, 'provider' would be connected to
// MetaMask or another Ethereum node.
const provider = {
getBlockNumber: async () => {
// Simulate network call delay
await new Promise(resolve => setTimeout(resolve, 500));
return 12345679; // Example block number
}
};
async function main() {
console.log("Attempting to get block number with Ethers.js...");
const blockNumber = await provider.getBlockNumber();
console.log("Current Block Number (Ethers.js):", blockNumber);
}
main();Quick Check: Provider Role
What is the primary role of an Ethereum provider (like MetaMask or Infura) in a DApp's architecture?
Recap: Connecting DApps
Great job! In this lesson, you learned how DApps connect to the Ethereum network.
- We explored Web3.js and Ethers.js as key JavaScript libraries for this interaction.
- We understood the concept of an Ethereum provider (e.g., MetaMask, Infura) as the essential link to the blockchain.
- You saw how to conceptually set up and initialize these libraries to read basic blockchain data like the current block number.
Next, we'll dive deeper into building a complete DApp!
Perguntas Frequentes
A aula “Conexão com Ethereum (Web3.js/Ethers.js)” é grátis?
Sim — o texto completo de “Conexão com Ethereum (Web3.js/Ethers.js)” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Web3 & DApp Development Fundamentals, atualize para CoddyKit PRO. O curso de Web3 & DApp Development Fundamentals inclui 3 aulas no total.
O que vou aprender em “Conexão com Ethereum (Web3.js/Ethers.js)”?
Aprenda a usar bibliotecas JavaScript, como Web3.js e Ethers.js, para estabelecer conexões entre um front-end web e a rede Ethereum. Você pratica Web3 & DApp Development Fundamentals com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Web3 & DApp Development Fundamentals?
Nenhuma experiência prévia é necessária. Web3 & DApp Development Fundamentals no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 3.
Quanto tempo leva a aula “Conexão com Ethereum (Web3.js/Ethers.js)”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Web3 & DApp Development Fundamentals?
Sim. Cada aula de Web3 & DApp Development Fundamentals inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Front-end e Back-end na Web3
- Conexão com Ethereum (Web3.js/Ethers.js)
- Exemplo Básico de DApp