Kurs Blockchain i Web3 · Moduł 7: Contract Interaction

Interakcja ze Smart Contracts

2 min czytania ·
W tej lekcji7

Witaj w Centrum Komunikacji! Atlas tutaj. Dziś nauczysz się komunikować z automatycznymi mechanizmami (smart contracts) za pomocą ethers.js.

ABI - Instrukcja obsługi mechanizmu

ABI (Application Binary Interface) to "instrukcja obsługi" kontraktu - opisuje jakie funkcje są dostępne:

const abi = [
  // Funkcja view (tylko odczyt)
  "function balanceOf(address owner) view returns (uint256)",

  // Funkcja modyfikująca stan
  "function transfer(address to, uint256 amount) returns (bool)",

  // Event
  "event Transfer(address indexed from, address indexed to, uint256 amount)"
];

Tworzenie instancji kontraktu

import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://...");
const contractAddress = "0x...";
const abi = [...];

// Read-only (z provider)
const contract = new ethers.Contract(contractAddress, abi, provider);

// Read-write (z signer)
const wallet = new ethers.Wallet(privateKey, provider);
const contractWithSigner = new ethers.Contract(contractAddress, abi, wallet);
// lub
const contractConnected = contract.connect(wallet);

Odczyt danych (view functions)

// Wywołanie funkcji view - nie kosztuje gas
const balance = await contract.balanceOf("0x...");
console.log("Balance:", ethers.formatUnits(balance, 18));

// Funkcje view są darmowe!
const name = await contract.name();
const symbol = await contract.symbol();
const totalSupply = await contract.totalSupply();

Zapis danych (transakcje)

// Wywołanie funkcji modyfikującej - kosztuje gas
const tx = await contractWithSigner.transfer(
  "0x...", // to
  ethers.parseUnits("100", 18) // amount
);

console.log("TX Hash:", tx.hash);

// Czekamy na potwierdzenie
const receipt = await tx.wait();
console.log("Confirmed in block:", receipt?.blockNumber);

Nasłuchiwanie eventów

// Nasłuchuj nowych eventów
contract.on("Transfer", (from, to, amount, event) => {
  console.log(`Transfer: ${from} → ${to}: ${ethers.formatUnits(amount, 18)}`);
});

// Pobierz historyczne eventy
const filter = contract.filters.Transfer(null, "0x..."); // to = 0x...
const events = await contract.queryFilter(filter, -1000); // ostatnie 1000 bloków

events.forEach(event => {
  console.log("Historical transfer:", event.args);
});

Error handling

try {
  const tx = await contract.transfer("0x...", amount);
  await tx.wait();
} catch (error) {
  if (error.code === "CALL_EXCEPTION") {
    console.log("Kontrakt zwrócił błąd:", error.reason);
  } else if (error.code === "INSUFFICIENT_FUNDS") {
    console.log("Brak środków na gas");
  } else {
    console.log("Inny błąd:", error);
  }
}

Podsumowanie

  • ABI - interfejs kontraktu
  • Contract instance z ethers.js
  • View functions - darmowe odczyty
  • Write functions - transakcje (kosztują gas)
  • Events - nasłuchiwanie i historia
  • Error handling
Kod do tej lekcji: index.js
// ABI - Application Binary Interface

const ERC20_ABI = [
  // Read functions (view/pure)
  {
    "type": "function",
    "name": "name",
    "inputs": [],
    "outputs": [{ "type": "string" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "symbol",
    "inputs": [],
    "outputs": [{ "type": "string" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "decimals",
    "inputs": [],
    "outputs": [{ "type": "uint8" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "totalSupply",
    "inputs": [],
    "outputs": [{ "type": "uint256" }],
    "stateMutability": "view"
  },
  {
    "type": "function",
    "name": "balanceOf",
    "inputs": [{ "name": "account", "type": "address" }],
    "outputs": [{ "type": "uint256" }],
    "stateMutability": "view"
  },

  // Write functions
  {
    "type": "function",
    "name": "transfer",
    "inputs": [
      { "name": "to", "type": "address" },
      { "name": "amount", "type": "uint256" }
    ],
    "outputs": [{ "type": "bool" }],
    "stateMutability": "nonpayable"
  },
  {
    "type": "function",
    "name": "approve",
    "inputs": [
      { "name": "spender", "type": "address" },
      { "name": "amount", "type": "uint256" }
    ],
    "outputs": [{ "type": "bool" }],
    "stateMutability": "nonpayable"
  },

  // Events
  {
    "type": "event",
    "name": "Transfer",
    "inputs": [
      { "name": "from", "type": "address", "indexed": true },
      { "name": "to", "type": "address", "indexed": true },
      { "name": "value", "type": "uint256", "indexed": false }
    ]
  }
];

console.log("=== ABI - APPLICATION BINARY INTERFACE ===\n");

console.log("ABI to JSON opisujący jak komunikować się z kontraktem:");
console.log("  - Jakie funkcje są dostępne");
console.log("  - Jakie przyjmują parametry");
console.log("  - Co zwracają");
console.log("  - Jakie eventy emitują\n");

console.log("=== STRUKTURA FUNKCJI W ABI ===\n");

const transferFn = ERC20_ABI.find(item => item.name === "transfer");
console.log("Funkcja transfer:");
console.log(JSON.stringify(transferFn, null, 2));

console.log("\n=== FUNCTION SELECTOR ===\n");

// Symulacja obliczania selectora
function getFunctionSelector(signature) {
  // W rzeczywistości: keccak256(signature).slice(0,4)
  const hash = signature.split('').reduce((h, c) =>
    ((h << 5) - h) + c.charCodeAt(0), 0);
  return "0x" + Math.abs(hash).toString(16).slice(0, 8);
}

console.log("Sygnatura funkcji → 4-bajtowy selector:");
console.log(`  transfer(address,uint256) → ${getFunctionSelector("transfer(address,uint256)")}`);
console.log(`  approve(address,uint256) → ${getFunctionSelector("approve(address,uint256)")}`);
console.log(`  balanceOf(address) → ${getFunctionSelector("balanceOf(address)")}`);

console.log("\nABI jest generowane automatycznie przy kompilacji Solidity");

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. ABI (Application Binary Interface) to:

  2. 2. Aby stworzyć instancję kontraktu w ethers.js potrzebujesz:

To 2 z 14 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż kroki parsowania eventu z transaction receipt:

  • Układanie w pionie

    Ułóż kroki obsługi custom error z kontraktu:

  • Układanie w pionie

    Ułóż kroki optymalizacji gas przed wysłaniem transakcji:

  • Układanie w pionie

    Ułóż kroki pobierania historycznych eventów:

  • Edytor kodu

    Uzupełnij kod odczytu salda tokena

  • Edytor kodu

    Uzupełnij kod transferu tokenów

  • Edytor kodu

    Uzupełnij listener dla eventu Transfer

  • Edytor kodu

    Uzupełnij kod parsowania eventów z receipt

  • Układanie w poziomie

    Ułóż poprawną sygnaturę funkcji transfer:

  • Układanie w poziomie

    Ułóż poprawną sygnaturę eventu Transfer:

  • Układanie w poziomie

    Ułóż wywołanie funkcji z custom gas limit:

  • Układanie w poziomie

    Ułóż wywołanie encodowania danych funkcji:

  • Edytor kodu

    Uzupełnij kod queryFilter dla historycznych eventów

  • Edytor kodu

    Uzupełnij kod estimate gas

  • Edytor kodu

    Uzupełnij kod obsługi custom error

  • Edytor kodu

    Uzupełnij kod ABI encoding

  • Klikanie w kolejności

    Kliknij w elementy w kolejności tworzenia Interface:

  • Klikanie w kolejności

    Kliknij w elementy w kolejności tworzenia instancji kontraktu:

  • Klikanie w kolejności

    Kliknij w elementy w kolejności tworzenia filtra eventów:

  • Klikanie w kolejności

    Kliknij w elementy w kolejności parsowania logu:

  • Układanie w pionie

    Ułóż kroki przygotowania multicall:

  • Układanie w poziomie

    Ułóż fragment ABI dla funkcji balanceOf:

  • Edytor kodu

    Uzupełnij kod multicall

  • Edytor kodu

    Uzupełnij kod dekodowania wyników

  • Klikanie w kolejności

    Kliknij w elementy w kolejności dekodowania custom error:

  1. PytanieQuiz: ABI
  2. PytanieQuiz: Contract instance
  3. PytanieQuiz: View functions
  4. PytanieQuiz: Write functions
  5. PytanieQuiz: contract.connect()
  6. PytanieQuiz: Events
  7. PytanieQuiz: contract.on()
  8. PytanieQuiz: queryFilter
  9. PytanieQuiz: Function selector
  10. PytanieQuiz: Event topics
  11. PytanieQuiz: Interface
  12. PytanieQuiz: contract.interface.parseLog()
  13. PytanieQuiz: estimateGas
  14. PytanieQuiz: Custom errors
  15. Ułóż w kolejnościSortowanie: Parsowanie eventu z receipt
  16. Ułóż w kolejnościSortowanie: Obsługa błędu z kontraktu
  17. Ułóż w kolejnościSortowanie: Gas estimation przed transakcją
  18. Ułóż w kolejnościSortowanie: Filtrowanie eventów z historii
  19. Zadanie z kodemGap: Odczyt z kontraktu
  20. Zadanie z kodemGap: Wysyłanie transakcji do kontraktu
  21. Zadanie z kodemGap: Nasłuchiwanie eventów
  22. Zadanie z kodemGap: Parsowanie logów z receipt
  23. Ułóż w kolejnościSortowanie poziome: Sygnatura funkcji
  24. Ułóż w kolejnościSortowanie poziome: Event signature
  25. Ułóż w kolejnościSortowanie poziome: Wywołanie z overrides
  26. Ułóż w kolejnościSortowanie poziome: Interface encoding
  27. Zadanie z kodemGap: QueryFilter - pobieranie historii
  28. Zadanie z kodemGap: Gas estimation
  29. Zadanie z kodemGap: Custom error handling
  30. Zadanie z kodemGap: ABI encoding parameters
  31. Kliknij w kolejnościSortowanie: Budowanie interface
  32. Kliknij w kolejnościSortowanie: Budowanie contract instance
  33. Kliknij w kolejnościSortowanie: Budowanie event filter
  34. Kliknij w kolejnościSortowanie: Parsowanie log
  35. Ułóż w kolejnościSortowanie: Multicall preparation
  36. Ułóż w kolejnościSortowanie poziome: Fragment ABI funkcji
  37. Zadanie z kodemGap: Multicall pattern
  38. Zadanie z kodemGap: Dekodowanie return values
  39. Kliknij w kolejnościSortowanie: Dekodowanie błędu
  40. Projekt do wysłaniaWyślij projekt do mentora
  41. RozmowaZakończenie modułu 7