Pustaka API JavaScript

Agar aplikasi web dapat berinteraksi dengan rantai blok Ethereum (yaitu, membaca data rantai blok dan/atau mengirim transaksi ke jaringan), aplikasi tersebut harus terhubung ke sebuah node Ethereum.

Untuk tujuan ini, setiap klien Ethereum mengimplementasikan spesifikasi JSON-RPC, sehingga terdapat serangkaian metode seragam yang dapat diandalkan oleh aplikasi.

Jika Anda ingin menggunakan JavaScript untuk terhubung dengan node Ethereum, Anda bisa menggunakan JavaScript murni, tetapi ada beberapa pustaka praktis di dalam ekosistem yang membuatnya jauh lebih mudah. Dengan pustaka-pustaka ini, pengembang dapat menulis metode satu baris yang intuitif untuk menginisialisasi permintaan JSON-RPC (secara internal) yang berinteraksi dengan Ethereum.

Harap perhatikan bahwa sejak The Merge, dua perangkat lunak Ethereum yang saling terhubung - klien eksekusi dan klien konsensus - diperlukan untuk menjalankan sebuah node. Pastikan node Anda mencakup klien eksekusi dan konsensus. Jika node Anda tidak berada di mesin lokal Anda (misalnya, node Anda berjalan di instans AWS), perbarui alamat IP dalam tutorial yang sesuai. Untuk informasi lebih lanjut, silakan lihat halaman kami tentang menjalankan node.

Prasyarat

Selain memahami JavaScript, mungkin akan membantu jika Anda memahami tumpukan Ethereum dan klien Ethereum.

Mengapa menggunakan pustaka?

Pustaka-pustaka ini mengabstraksi banyak kerumitan dalam berinteraksi langsung dengan node Ethereum. Pustaka ini juga menyediakan fungsi utilitas (misalnya, mengonversi ETH ke Gwei) sehingga sebagai pengembang, Anda dapat menghabiskan lebih sedikit waktu untuk menangani kerumitan klien Ethereum dan lebih banyak waktu berfokus pada fungsionalitas unik aplikasi Anda.

Fitur pustaka

Terhubung ke node Ethereum

Menggunakan penyedia (provider), pustaka-pustaka ini memungkinkan Anda untuk terhubung ke Ethereum dan membaca datanya, baik itu melalui JSON-RPC, Infura, Etherscan, Alchemy, atau MetaMask.

Peringatan: Web3.js telah diarsipkan pada 4 Maret 2025. Baca pengumumannya (opens in a new tab). Pertimbangkan untuk menggunakan pustaka alternatif seperti Ethers.js (opens in a new tab) atau Viem (opens in a new tab) untuk proyek baru.

Contoh Ethers

// Sebuah BrowserProvider membungkus penyedia Web3 standar, yaitu
// apa yang disuntikkan MetaMask sebagai window.ethereum ke setiap halaman
const provider = new ethers.BrowserProvider(window.ethereum)

// Plugin MetaMask juga memungkinkan penandatanganan transaksi untuk
// mengirim ether dan membayar untuk mengubah status di dalam rantai blok.
// Untuk ini, kita memerlukan penandatangan akun...
const signer = provider.getSigner()

Contoh Web3js

var web3 = new Web3("http://localhost:8545")
// or
var web3 = new Web3(new Web3.providers.HttpProvider("http://localhost:8545"))

// ubah penyedia
web3.setProvider("ws://localhost:8546")
// or
web3.setProvider(new Web3.providers.WebsocketProvider("ws://localhost:8546"))

// Menggunakan penyedia IPC di node.js
var net = require("net")
var web3 = new Web3("/Users/myuser/Library/Ethereum/geth.ipc", net) // jalur mac os
// or
var web3 = new Web3(
  new Web3.providers.IpcProvider("/Users/myuser/Library/Ethereum/geth.ipc", net)
) // jalur mac os
// di windows jalurnya adalah: "\\\\.\\pipe\\geth.ipc"
// di linux jalurnya adalah: "/users/myuser/.ethereum/geth.ipc"

Setelah disiapkan, Anda akan dapat meminta data (query) dari rantai blok untuk:

nomor blok
estimasi gas
peristiwa kontrak pintar
id jaringan
dan banyak lagi...

Fungsionalitas dompet

Pustaka-pustaka ini memberi Anda fungsionalitas untuk membuat dompet, mengelola kunci, dan menandatangani transaksi.

Berikut adalah contoh dari Ethers

// Buat instans dompet dari mnemonik...
mnemonic =
  "announce room limb pattern dry unit scale effort smooth jazz weasel alcohol"
walletMnemonic = Wallet.fromPhrase(mnemonic)

// ...atau dari kunci privat
walletPrivateKey = new Wallet(walletMnemonic.privateKey)

walletMnemonic.address === walletPrivateKey.address
// true

// Alamat sebagai Promise sesuai API Signer
walletMnemonic.getAddress()
// { Promise: '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1' }

// Alamat Dompet juga tersedia secara sinkron
walletMnemonic.address
// '0x71CB05EE1b1F506fF321Da3dac38f25c0c9ce6E1'

// Komponen kriptografi internal
walletMnemonic.privateKey
// '0x1da6847600b0ee25e9ad9a52abbd786dd2502fa4005dd5af9310b7cc7a3b25db'
walletMnemonic.publicKey
// '0x04b9e72dfd423bcf95b3801ac93f4392be5ff22143f9980eb78b3a860c4843bfd04829ae61cdba4b3b1978ac5fc64f5cc2f4350e35a108a9c9a92a81200a60cd64'

// Mnemonik dompet
walletMnemonic.mnemonic
// {
//   locale: 'en',
//   path: 'm/44\'/60\'/0\'/0/0',
//   phrase: 'announce room limb pattern dry unit scale effort smooth jazz weasel alcohol'
// }

// Catatan: Sebuah dompet yang dibuat dengan kunci privat tidak
//       memiliki mnemonik (derivasi mencegahnya)
walletPrivateKey.mnemonic
// null

// Menandatangani pesan
walletMnemonic.signMessage("Hello World")
// { Promise: '0x14280e5885a19f60e536de50097e96e3738c7acae4e9e62d67272d794b8127d31c03d9cd59781d4ee31fb4e1b893bd9b020ec67dfa65cfb51e2bdadbb1de26d91c' }

tx = {
  to: "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
  value: utils.parseEther("1.0"),
}

// Menandatangani transaksi
walletMnemonic.signTransaction(tx)
// { Promise: '0xf865808080948ba1f109551bd432803012645ac136ddd64dba72880de0b6b3a7640000801ca0918e294306d177ab7bd664f5e141436563854ebe0a3e523b9690b4922bbb52b8a01181612cec9c431c4257a79b8c9f0c980a2c49bb5a0e6ac52949163eeb565dfc' }

// Metode connect mengembalikan instans baru dari
// Dompet yang terhubung ke penyedia
wallet = walletMnemonic.connect(provider)

// Mengekueri jaringan
wallet.getBalance()
// { Promise: { BigNumber: "42" } }
wallet.getTransactionCount()
// { Promise: 0 }

// Mengirim ether
wallet.sendTransaction(tx)

Baca dokumentasi lengkapnya (opens in a new tab)

Setelah disiapkan, Anda akan dapat:

membuat akun
mengirim transaksi
menandatangani transaksi
dan banyak lagi...

Berinteraksi dengan fungsi kontrak pintar

Pustaka klien JavaScript memungkinkan aplikasi Anda untuk memanggil fungsi kontrak pintar dengan membaca Antarmuka Biner Aplikasi (Application Binary Interface/ABI) dari kontrak yang telah dikompilasi.

ABI pada dasarnya menjelaskan fungsi-fungsi kontrak dalam format JSON dan memungkinkan Anda untuk menggunakannya seperti objek JavaScript biasa.

Jadi, kontrak Solidity berikut:

contract Test {
    uint a;
    address d = 0x12345678901234567890123456789012;

    constructor(uint testInt)  { a = testInt;}

    event Event(uint indexed b, bytes32 c);

    event Event2(uint indexed b, bytes32 c);

    function foo(uint b, bytes32 c) returns(address) {
        Event(b, c);
        return d;
    }
}

Akan menghasilkan JSON berikut:

[{
    "type":"constructor",
    "payable":false,
    "stateMutability":"nonpayable"
    "inputs":[{"name":"testInt","type":"uint256"}],
  },{
    "type":"function",
    "name":"foo",
    "constant":false,
    "payable":false,
    "stateMutability":"nonpayable",
    "inputs":[{"name":"b","type":"uint256"}, {"name":"c","type":"bytes32"}],
    "outputs":[{"name":"","type":"address"}]
  },{
    "type":"event",
    "name":"Event",
    "inputs":[{"indexed":true,"name":"b","type":"uint256"}, {"indexed":false,"name":"c","type":"bytes32"}],
    "anonymous":false
  },{
    "type":"event",
    "name":"Event2",
    "inputs":[{"indexed":true,"name":"b","type":"uint256"},{"indexed":false,"name":"c","type":"bytes32"}],
    "anonymous":false
}]

Ini berarti Anda dapat:

Mengirim transaksi ke kontrak pintar dan mengeksekusi metodenya
Memanggil untuk mengestimasi gas yang akan dibutuhkan oleh eksekusi metode saat dijalankan di EVM
Menyebarkan kontrak
Dan banyak lagi...

Fungsi utilitas

Fungsi utilitas memberi Anda pintasan praktis yang membuat proses membangun dengan Ethereum menjadi sedikit lebih mudah.

Nilai ETH secara bawaan berada dalam Wei. 1 ETH = 1.000.000.000.000.000.000 WEI – ini berarti Anda berurusan dengan banyak angka! web3.utils.toWei mengonversi Ether ke Wei untuk Anda.

Dan di Ethers tampilannya seperti ini:

// Dapatkan saldo akun (berdasarkan alamat atau nama ENS)
balance = await provider.getBalance("ethers.eth")
// { BigNumber: "2337132817842795605" }

// Sering kali Anda perlu memformat keluaran untuk pengguna
// yang lebih suka melihat nilai dalam ether (alih-alih Wei)
ethers.utils.formatEther(balance)
// '2.337132817842795605'

Pustaka yang tersedia

Web3.js - API JavaScript Ethereum.

Ethers.js - Implementasi dompet Ethereum lengkap dan utilitas dalam JavaScript dan TypeScript.

The Graph - Sebuah protokol untuk mengindeks data Ethereum dan IPFS serta melakukan kueri menggunakan GraphQL.

Alchemy SDK - Pembungkus (wrapper) untuk Ethers.js dengan API yang ditingkatkan.

viem - Antarmuka TypeScript untuk Ethereum.

Codex - API data rantai blok yang diperkaya dan waktu nyata (real-time) di puluhan rantai.

Drift - Meta-pustaka TypeScript dengan caching bawaan, hooks, dan mock pengujian.

Bacaan lebih lanjut

Tahu tentang sumber daya komunitas yang membantu Anda? Edit halaman ini dan tambahkan!

Menyiapkan Web3js untuk menggunakan rantai blok Ethereum dalam JavaScript – Instruksi untuk menyiapkan Web3.js di proyek Anda.
Memanggil kontrak pintar dari JavaScript – Menggunakan token DAI, lihat cara memanggil fungsi kontrak menggunakan JavaScript.
Mengirim transaksi menggunakan Web3 dan Alchemy – Panduan langkah demi langkah untuk mengirim transaksi dari backend.

Tutorial: API JavaScript & WebSocket di Ethereum

Menggunakan WebSocket – Cara menggunakan WebSocket dengan Alchemy untuk berlangganan peristiwa Ethereum dan membuat permintaan JSON-RPC secara waktu nyata.