Kurs Blockchain i Web3 · Moduł 4: ethers.js & viem
Ethers.js - Twój młot w Kuźni Narzędzi
W tej lekcji5
Witaj w Kuźni Narzędzi! Atlas tutaj. Dziś wykujemy Twój pierwszy młot - ethers.js - najpotężniejszą bibliotekę do interakcji z Ethereum.
Czym jest Ethers.js?
Ethers.js to biblioteka JavaScript/TypeScript do interakcji z blockchain Ethereum. Jest jak uniwersalny klucz do wszystkich tuneli i komór w Krypcie.
┌─────────────────────────────────────────────────────────────────┐
│ ETHERS.JS ARCHITECTURE │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Twoja │────▶│ Provider │────▶│ Ethereum │ │
│ │ Aplikacja │ │ (Brama) │ │ Network │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │
│ │ ┌─────────────┐ │
│ └───────────▶│ Signer │ (podpisywanie TX) │
│ │ (Wojownik) │ │
│ └─────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────┐ │
│ │ Wallet │ (Signer + Provider) │
│ │ (Skarbiec) │ │
│ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Instalacja
# npm
npm install ethers
# yarn
yarn add ethers
# pnpm
pnpm add ethersPodstawowe koncepty
1. Provider - Brama do sieci
Provider to połączenie z siecią Ethereum (read-only):
import { ethers } from "ethers";
// Połączenie przez publiczne RPC
const provider = new ethers.JsonRpcProvider("https://eth-mainnet.g.alchemy.com/v2/YOUR-API-KEY");
// Infura
const infuraProvider = new ethers.InfuraProvider("mainnet", "YOUR-API-KEY");
// Alchemy
const alchemyProvider = new ethers.AlchemyProvider("mainnet", "YOUR-API-KEY");
// Dla testnet Sepolia
const sepoliaProvider = new ethers.JsonRpcProvider("https://eth-sepolia.g.alchemy.com/v2/YOUR-API-KEY");2. Signer - Wojownik z pieczęcią
Signer może podpisywać transakcje:
// Signer z kluczem prywatnym
const privateKey = "0x...";
const signer = new ethers.Wallet(privateKey, provider);
// Adres signera
console.log("Address:", signer.address);3. Wallet - Skarbiec (Signer + Provider)
Wallet to kombinacja Signer + Provider:
// Tworzenie nowego portfela
const newWallet = ethers.Wallet.createRandom();
console.log("Address:", newWallet.address);
console.log("Private Key:", newWallet.privateKey);
console.log("Mnemonic:", newWallet.mnemonic.phrase);
// Import z klucza prywatnego
const wallet = new ethers.Wallet(privateKey, provider);
// Import z mnemonic
const walletFromMnemonic = ethers.Wallet.fromPhrase("word1 word2 word3...", provider);Podstawowe operacje
Sprawdzanie salda:
const balance = await provider.getBalance("0x742d35Cc6634C0532925a3b844Bc9e7595f8fE8c");
console.log("Balance:", ethers.formatEther(balance), "ETH");Pobieranie informacji o bloku:
const blockNumber = await provider.getBlockNumber();
const block = await provider.getBlock(blockNumber);
console.log("Block:", block);Wysyłanie ETH:
const tx = await wallet.sendTransaction({
to: "0x...",
value: ethers.parseEther("0.1")
});
await tx.wait();
console.log("TX Hash:", tx.hash);Podsumowanie
- Ethers.js - główna biblioteka Web3
- Provider - połączenie z siecią (read-only)
- Signer - podpisywanie transakcji
- Wallet - Provider + Signer
- Podstawowe operacje: balance, block, send
Kod do tej lekcji: index.js
// ethers.js - basics
// In a real project: import { ethers } from "ethers";
// ethers.js simulation
const ethers = {
// Formatowanie
formatEther: (wei) => (Number(wei) / 1e18).toString(),
parseEther: (eth) => BigInt(Math.floor(Number(eth) * 1e18)),
formatUnits: (value, decimals) => (Number(value) / Math.pow(10, decimals)).toString(),
parseUnits: (value, decimals) => BigInt(Math.floor(Number(value) * Math.pow(10, decimals))),
// Addresses
isAddress: (address) => /^0x[a-fA-F0-9]{40}$/.test(address),
getAddress: (address) => {
if (!ethers.isAddress(address)) throw new Error("Invalid address");
return address.toLowerCase();
},
// Utils
id: (text) => "0x" + Array.from(text).reduce((h, c) =>
((h << 5) - h + c.charCodeAt(0)) & 0xffffffff, 0
).toString(16).padStart(64, '0'),
keccak256: (data) => ethers.id(data)
};
console.log("=== ETHERS.JS BASICS ===\n");
// Formatting
console.log("Formatting:");
const weiAmount = "1500000000000000000"; // 1.5 ETH
console.log(` Wei: ${weiAmount}`);
console.log(` ETH: ${ethers.formatEther(weiAmount)}`);
const ethAmount = "2.5";
console.log(`\n ETH: ${ethAmount}`);
console.log(` Wei: ${ethers.parseEther(ethAmount).toString()}`);
// Tokens (USDC has 6 decimals)
console.log("\nTokens (USDC, 6 decimals):");
const usdcAmount = "1000000"; // 1 USDC
console.log(` Raw: ${usdcAmount}`);
console.log(` Formatted: ${ethers.formatUnits(usdcAmount, 6)} USDC`);
// Addresses
console.log("\nAddresses:");
const addr = "0x742d35Cc6634C0532925a3b844Bc9e7595f1dE3a";
console.log(` Address: ${addr}`);
console.log(` isAddress: ${ethers.isAddress(addr)}`);
console.log(` Checksummed: ${ethers.getAddress(addr)}`);
// Keccak256
console.log("\nKeccak256:");
console.log(` keccak256("hello"): ${ethers.keccak256("hello")}`);
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Która komenda prawidłowo instaluje ethers.js w projekcie?
2. Jaka jest główna rola Provider w ethers.js?
To 2 z 18 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w pionie
Ułóż kroki tworzenia połączenia z siecią Ethereum używając ethers.js:
- Edytor kodu
Zaimplementuj połączenie z siecią przez Infura lub Alchemy
- Klikanie w kolejności
Ułóż poprawny import biblioteki ethers.js
- Układanie w poziomie
Ułóż poprawną kolejność tworzenia JsonRpcProvider:
- Edytor kodu
Zaimplementuj funkcję odczytującą saldo konta
- Edytor kodu
Stwórz Wallet i połącz z siecią
- Układanie w pionie
Ułóż jednostki Ethereum od najmniejszej do największej:
- Edytor kodu
Zaimplementuj konwersje jednostek
- Klikanie w kolejności
Ułóż poprawne wywołanie parseEther dla 1 ETH
- Układanie w pionie
Ułóż kroki wysyłania transakcji ETH:
- Edytor kodu
Zaimplementuj wysyłanie ETH
- Układanie w poziomie
Ułóż elementy potrzebne do utworzenia instancji kontraktu:
- Edytor kodu
Zaimplementuj odczyt salda tokena
- Edytor kodu
Zaimplementuj transfer tokenów ERC20
- Klikanie w kolejności
Ułóż poprawne nasłuchiwanie na event Transfer
- Edytor kodu
Zaimplementuj listener dla eventu Transfer
- Układanie w pionie
Ułóż kroki queryowania przeszłych eventów:
- Edytor kodu
Zaimplementuj createPublicClient
- Układanie w poziomie
Co jest potrzebne do utworzenia Wallet Client w viem?
- Edytor kodu
Zaimplementuj getBalance w viem
- Układanie w pionie
Ułóż strukturę obsługi błędów w transakcji:
- Klikanie w kolejności
Ułóż warunek sprawdzający błąd braku funduszy
- Układanie w poziomie
Ułóż funkcję walidacji adresu Ethereum:
Zadania po tej lekcji
- PytanieInstalacja ethers.js
- PytanieRola Provider w ethers.js
- PytanieJsonRpcProvider
- PytanieRóżnica Provider i Signer
- Ułóż w kolejnościTworzenie Provider
- Zadanie z kodemPodstawowy Provider
- Kliknij w kolejnościImportowanie ethers.js
- Ułóż w kolejnościSkładnia JsonRpcProvider
- Zadanie z kodemOdczyt salda
- PytanieMetody Provider
- PytanieTworzenie Wallet
- Zadanie z kodemWallet z Private Key
- Ułóż w kolejnościKonwersja jednostek ETH
- PytanieparseEther
- Zadanie z kodemKonwersja jednostek
- Kliknij w kolejnościSkładnia parseEther
- PytanieWysyłanie transakcji
- Ułóż w kolejnościStruktura transakcji
- Zadanie z kodemWysyłanie ETH
- PytanieCzym jest ABI?
- Ułóż w kolejnościTworzenie instancji Contract
- Zadanie z kodemOdczyt z kontraktu
- PytanieRead vs Write funkcje
- Zadanie z kodemZapis do kontraktu
- PytanieNasłuchiwanie eventów
- Kliknij w kolejnościSkładnia nasłuchiwania
- Zadanie z kodemEvent listener
- Ułóż w kolejnościQueryowanie historycznych eventów
- PytanieWprowadzenie do viem
- PytanieClient w viem
- Zadanie z kodemTworzenie Public Client
- Ułóż w kolejnościWallet Client w viem
- Zadanie z kodemOdczyt salda w viem
- PytanieObsługa błędów
- Ułóż w kolejnościTry-catch w transakcjach
- Kliknij w kolejnościTypy błędów
- PytaniePorównanie bibliotek
- PytanieestimateGas
- Ułóż w kolejnościWalidacja adresów
- PytanieSigning wiadomości
- Projekt do wysłaniaProjekt końcowy
- PytanieBest practices
- RozmowaUkończenie Laboratorium