Kurs Blockchain i Web3 · Moduł 4: ethers.js & viem

Ethers.js - Twój młot w Kuźni Narzędzi

2 min czytania ·
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 ethers

Podstawowe 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. 1. Która komenda prawidłowo instaluje ethers.js w projekcie?

  2. 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:

  1. PytanieInstalacja ethers.js
  2. PytanieRola Provider w ethers.js
  3. PytanieJsonRpcProvider
  4. PytanieRóżnica Provider i Signer
  5. Ułóż w kolejnościTworzenie Provider
  6. Zadanie z kodemPodstawowy Provider
  7. Kliknij w kolejnościImportowanie ethers.js
  8. Ułóż w kolejnościSkładnia JsonRpcProvider
  9. Zadanie z kodemOdczyt salda
  10. PytanieMetody Provider
  11. PytanieTworzenie Wallet
  12. Zadanie z kodemWallet z Private Key
  13. Ułóż w kolejnościKonwersja jednostek ETH
  14. PytanieparseEther
  15. Zadanie z kodemKonwersja jednostek
  16. Kliknij w kolejnościSkładnia parseEther
  17. PytanieWysyłanie transakcji
  18. Ułóż w kolejnościStruktura transakcji
  19. Zadanie z kodemWysyłanie ETH
  20. PytanieCzym jest ABI?
  21. Ułóż w kolejnościTworzenie instancji Contract
  22. Zadanie z kodemOdczyt z kontraktu
  23. PytanieRead vs Write funkcje
  24. Zadanie z kodemZapis do kontraktu
  25. PytanieNasłuchiwanie eventów
  26. Kliknij w kolejnościSkładnia nasłuchiwania
  27. Zadanie z kodemEvent listener
  28. Ułóż w kolejnościQueryowanie historycznych eventów
  29. PytanieWprowadzenie do viem
  30. PytanieClient w viem
  31. Zadanie z kodemTworzenie Public Client
  32. Ułóż w kolejnościWallet Client w viem
  33. Zadanie z kodemOdczyt salda w viem
  34. PytanieObsługa błędów
  35. Ułóż w kolejnościTry-catch w transakcjach
  36. Kliknij w kolejnościTypy błędów
  37. PytaniePorównanie bibliotek
  38. PytanieestimateGas
  39. Ułóż w kolejnościWalidacja adresów
  40. PytanieSigning wiadomości
  41. Projekt do wysłaniaProjekt końcowy
  42. PytanieBest practices
  43. RozmowaUkończenie Laboratorium