Kurs Blockchain i Web3 · Moduł 7: Contract Interaction
Interakcja ze Smart Contracts
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. ABI (Application Binary Interface) to:
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:
Zadania po tej lekcji
- PytanieQuiz: ABI
- PytanieQuiz: Contract instance
- PytanieQuiz: View functions
- PytanieQuiz: Write functions
- PytanieQuiz: contract.connect()
- PytanieQuiz: Events
- PytanieQuiz: contract.on()
- PytanieQuiz: queryFilter
- PytanieQuiz: Function selector
- PytanieQuiz: Event topics
- PytanieQuiz: Interface
- PytanieQuiz: contract.interface.parseLog()
- PytanieQuiz: estimateGas
- PytanieQuiz: Custom errors
- Ułóż w kolejnościSortowanie: Parsowanie eventu z receipt
- Ułóż w kolejnościSortowanie: Obsługa błędu z kontraktu
- Ułóż w kolejnościSortowanie: Gas estimation przed transakcją
- Ułóż w kolejnościSortowanie: Filtrowanie eventów z historii
- Zadanie z kodemGap: Odczyt z kontraktu
- Zadanie z kodemGap: Wysyłanie transakcji do kontraktu
- Zadanie z kodemGap: Nasłuchiwanie eventów
- Zadanie z kodemGap: Parsowanie logów z receipt
- Ułóż w kolejnościSortowanie poziome: Sygnatura funkcji
- Ułóż w kolejnościSortowanie poziome: Event signature
- Ułóż w kolejnościSortowanie poziome: Wywołanie z overrides
- Ułóż w kolejnościSortowanie poziome: Interface encoding
- Zadanie z kodemGap: QueryFilter - pobieranie historii
- Zadanie z kodemGap: Gas estimation
- Zadanie z kodemGap: Custom error handling
- Zadanie z kodemGap: ABI encoding parameters
- Kliknij w kolejnościSortowanie: Budowanie interface
- Kliknij w kolejnościSortowanie: Budowanie contract instance
- Kliknij w kolejnościSortowanie: Budowanie event filter
- Kliknij w kolejnościSortowanie: Parsowanie log
- Ułóż w kolejnościSortowanie: Multicall preparation
- Ułóż w kolejnościSortowanie poziome: Fragment ABI funkcji
- Zadanie z kodemGap: Multicall pattern
- Zadanie z kodemGap: Dekodowanie return values
- Kliknij w kolejnościSortowanie: Dekodowanie błędu
- Projekt do wysłaniaWyślij projekt do mentora
- RozmowaZakończenie modułu 7