Menggunakan WebSockets

Alchemy

websockets

kueri

JavaScript

Pemula

Elan Halpern

Alchemy docs

1 Desember 2020

5 menit baca

Ini adalah panduan tingkat pemula untuk menggunakan WebSockets dan Alchemy untuk membuat permintaan ke blockchain Ethereum.

(opens in a new tab)WebSockets vs. HTTP

Berbeda dengan HTTP, dengan WebSockets, Anda tidak perlu terus-menerus membuat permintaan ketika Anda menginginkan informasi tertentu. WebSockets mempertahankan koneksi jaringan untuk Anda (jika dilakukan dengan benar) dan mendengarkan perubahan.

Seperti halnya koneksi jaringan apa pun, Anda tidak boleh berasumsi bahwa WebSocket akan tetap terbuka selamanya tanpa gangguan, tetapi menangani koneksi yang terputus dan penyambungan kembali secara manual dengan benar bisa menjadi tantangan tersendiri. Kelemahan lain dari WebSockets adalah Anda tidak mendapatkan kode status HTTP dalam respons, melainkan hanya pesan kesalahan.

Alchemy Web3 (opens in a new tab) secara otomatis menambahkan penanganan untuk kegagalan dan percobaan ulang WebSocket tanpa memerlukan konfigurasi.

Cobalah

Cara termudah untuk menguji WebSockets adalah dengan menginstal alat baris perintah untuk membuat permintaan WebSocket seperti wscat (opens in a new tab). Menggunakan wscat, Anda dapat mengirim permintaan sebagai berikut:

Catatan: jika Anda memiliki akun Alchemy, Anda dapat mengganti demo dengan kunci API Anda sendiri. Daftar untuk mendapatkan akun Alchemy gratis di sini! (opens in a new tab)

1wscat -c wss://eth-mainnet.ws.alchemyapi.io/ws/demo
2
3>  {"jsonrpc":  "2.0", "id": 0, "method":  "eth_gasPrice"}
4
5<  {"jsonrpc":  "2.0", "result":  "0xb2d05e00", "id": 0}
6

Cara menggunakan WebSockets

Untuk memulai, buka WebSocket menggunakan URL WebSocket untuk aplikasi Anda. Anda dapat menemukan URL WebSocket aplikasi Anda dengan membuka halaman aplikasi di dasbor Anda (opens in a new tab) dan mengklik "View Key". Perhatikan bahwa URL aplikasi Anda untuk WebSockets berbeda dari URL-nya untuk permintaan HTTP, tetapi keduanya dapat ditemukan dengan mengklik "View Key".

Salah satu API yang tercantum dalam Referensi API Alchemy (opens in a new tab) dapat digunakan melalui WebSocket. Untuk melakukannya, gunakan payload yang sama yang akan dikirim sebagai badan permintaan HTTP POST, tetapi alih-alih kirimkan payload tersebut melalui WebSocket.

Dengan Web3

Beralih ke WebSockets saat menggunakan pustaka klien seperti Web3 sangatlah mudah. Cukup berikan URL WebSocket alih-alih URL HTTP saat menginisiasi klien Web3 Anda. Misalnya:

1const web3 = new Web3("wss://eth-mainnet.ws.alchemyapi.io/ws/your-api-key")
2
3web3.eth.getBlockNumber().then(console.log) // -> 7946893 // -> 7946893

API Berlangganan

Saat terhubung melalui WebSocket, Anda dapat menggunakan dua metode tambahan: eth_subscribe dan eth_unsubscribe. Metode ini akan memungkinkan Anda untuk mendengarkan event tertentu dan segera diberi tahu.

`eth_subscribe`

Membuat langganan baru untuk event yang ditentukan. Pelajari lebih lanjut tentang eth_subscribe (opens in a new tab).

Parameter

Jenis langganan
Parameter opsional

Argumen pertama menentukan jenis event yang akan didengarkan. Argumen kedua berisi opsi tambahan yang bergantung pada argumen pertama. Berbagai jenis deskripsi, opsinya, dan payload event-nya dijelaskan di bawah ini.

Kembalian

ID langganan: ID ini akan dilampirkan ke setiap event yang diterima, dan juga dapat digunakan untuk membatalkan langganan menggunakan eth_unsubscribe.

Event langganan

Selama langganan aktif, Anda akan menerima event yang berupa objek dengan bidang berikut:

jsonrpc: Selalu "2.0"
method: Selalu "eth_subscription"
params: Sebuah objek dengan bidang berikut:
- subscription: ID langganan yang dikembalikan oleh panggilan eth_subscribe yang membuat langganan ini.
- result: Sebuah objek yang isinya bervariasi tergantung pada jenis langganan.

Jenis langganan

alchemy_newFullPendingTransactions

Mengembalikan informasi transaksi untuk semua transaksi yang ditambahkan ke status tertunda. Jenis langganan ini berlangganan ke transaksi yang tertunda, mirip dengan panggilan Web3 standar web3.eth.subscribe("pendingTransactions"), tetapi berbeda karena ia memancarkan informasi transaksi lengkap daripada hanya hash transaksi.

Contoh:

1>  {"jsonrpc":  "2.0",  "id":  1,  "method":  "eth_subscribe",  "params":  ["alchemy_newFullPendingTransactions"]}
2
3<  {"id":1,"result":"0x9a52eeddc2b289f985c0e23a7d8427c8","jsonrpc":"2.0"}
4<  {
5      "jsonrpc":"2.0",
6      "method":"eth_subscription",
7      "params":{
8          "result":{
9          "blockHash":null,
10          "blockNumber":null,
11          "from":"0xa36452fc31f6f482ad823cd1cf5515177d57667f",
12          "gas":"0x1adb0",
13          "gasPrice":"0x7735c4d40",
14          "hash":"0x50bff0736c713458c92dd1848d12f3354149be1363123dae35e94e0f2a9d56bf",
15"input":"0xa9059cbb0000000000000000000000000d0707963952f2fba59dd06f2b425ace40b492fe0000000000000000000000000000000000000000000015b1111266cfca100000",
16          "nonce":"0x0",
17          "to":"0xea38eaa3c86c8f9b751533ba2e562deb9acded40",
18          "transactionIndex":null,
19          "value":"0x0",
20          "v":"0x26",
21          "r":"0x195c2c1ed126088e12d290aa93541677d3e3b1d10f137e11f86b1b9227f01e3b",
22          "s":"0x60fc4edbf1527832a2a36dbc1e63ed6193a6eee654472fbebbf88ef1750b5344"},
23          "subscription":"0x9a52eeddc2b289f985c0e23a7d8427c8"
24      }
25  }
26
Tampilkan semua

newHeads

Memancarkan event setiap kali header baru ditambahkan ke rantai, termasuk selama reorganisasi rantai.

Ketika reorganisasi rantai terjadi, langganan ini akan memancarkan event yang berisi semua header baru untuk rantai baru. Secara khusus, ini berarti Anda mungkin melihat beberapa header dipancarkan dengan ketinggian yang sama, dan ketika ini terjadi, header yang lebih baru harus dianggap sebagai yang benar setelah reorganisasi.

Contoh:

1>  {"jsonrpc":  "2.0",  "id":  1,  "method":  "eth_subscribe",  "params":  ["newHeads"]}
2
3<  {"jsonrpc":"2.0","id":2,"result":"0x9ce59a13059e417087c02d3236a0b1cc"}
4<  {
5  "jsonrpc":  "2.0",
6  "method":  "eth_subscription",
7  "params":  {
8      "result":  {
9          "extraData":  "0xd983010305844765746887676f312e342e328777696e646f7773",
10          "gasLimit":  "0x47e7c4",
11          "gasUsed":  "0x38658",
12          "logsBloom":
13"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
14          "nonce":  "0x084149998194cc5f",
15          "number":  "0x1348c9",
16          "parentHash":  "0x7736fab79e05dc611604d22470dadad26f56fe494421b5b333de816ce1f25701",
17          "receiptRoot":  "0x2fab35823ad00c7bb388595cb46652fe7886e00660a01e867824d3dceb1c8d36",
18          "sha3Uncles":  "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
19          "stateRoot":  "0xb3346685172db67de536d8765c43c31009d0eb3bd9c501c9be3229203f15f378",
20          "timestamp":  "0x56ffeff8",
21          "transactionsRoot":  "0x0167ffa60e3ebc0b080cdb95f7c0087dd6c0e61413140e39d94d3468d7c9689f"
22      },
23  "subscription":  "0x9ce59a13059e417087c02d3236a0b1cc"
24  }
25}
26
Tampilkan semua

logs

Memancarkan log yang merupakan bagian dari blok yang baru ditambahkan yang cocok dengan kriteria filter yang ditentukan.

Ketika reorganisasi rantai terjadi, log yang merupakan bagian dari blok pada rantai lama akan dipancarkan lagi dengan properti removed diatur ke true. Selanjutnya, log yang merupakan bagian dari blok pada rantai baru dipancarkan, yang berarti dimungkinkan untuk melihat log untuk transaksi yang sama beberapa kali dalam kasus reorganisasi.

Parameter

Sebuah objek dengan bidang berikut:
- address (opsional): baik string yang mewakili alamat atau array dari string tersebut.
  - Hanya log yang dibuat dari salah satu alamat ini yang akan dipancarkan.
- topics: array penentu topik.
  - Setiap penentu topik adalah null, string yang mewakili topik, atau array string.
  - Setiap posisi dalam array yang bukan null membatasi log yang dipancarkan hanya pada mereka yang memiliki salah satu topik yang diberikan di posisi tersebut.

Beberapa contoh spesifikasi topik:

[]: Topik apa pun diizinkan.
[A]: A di posisi pertama (dan apa pun setelahnya).
[null, B]: Apa pun di posisi pertama dan B di posisi kedua (dan apa pun setelahnya).
[A, B]: A di posisi pertama dan B di posisi kedua (dan apa pun setelahnya).
[[A, B], [A, B]]: (A atau B) di posisi pertama dan (A atau B) di posisi kedua (dan apa pun setelahnya).

Contoh:

1>  {"jsonrpc":  "2.0",  "id":  1,  "method":  "eth_subscribe",  "params":  ["logs",  {"address":  "0x8320fe7702b96808f7bbc0d4a888ed1468216cfd",  "topics":  ["0xd78a0cb8bb633d06981248b816e7bd33c2a35a6089241d099fa519e361cab902"]}]}
2
3<  {"jsonrpc":"2.0","id":2,"result":"0x4a8a4c0517381924f9838102c5a4dcb7"}
4<  {
5  "jsonrpc":  "2.0",
6  "method":  "eth_subscription",
7  "params":  {
8      "subscription":  "0x4a8a4c0517381924f9838102c5a4dcb7",
9      "result":  {
10          "address":  "0x8320fe7702b96808f7bbc0d4a888ed1468216cfd",
11          "blockHash":  "0x61cdb2a09ab99abf791d474f20c2ea89bf8de2923a2d42bb49944c8c993cbf04",
12          "blockNumber":  "0x29e87",
13          "data": "0x00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000003",
14          "logIndex":"0x0",
15          "topics":["0xd78a0cb8bb633d06981248b816e7bd33c2a35a6089241d099fa519e361cab902"],
16          "transactionHash":  "0xe044554a0a55067caafd07f8020ab9f2af60bdfe337e395ecd84b4877a3d1ab4",
17          "transactionIndex":  "0x0"
18      }
19  }
20}
21
Tampilkan semua

`eth_unsubscribe`

Membatalkan langganan yang ada sehingga tidak ada event lebih lanjut yang dikirim.

Parameter

ID Langganan, seperti yang sebelumnya dikembalikan dari panggilan eth_subscribe.

Kembalian

true jika langganan berhasil dibatalkan, atau false jika tidak ada langganan dengan ID yang diberikan.

Contoh:

Permintaan

1curl https://eth-mainnet.alchemyapi.io/v2/your-api-key
2-X POST
3-H "Content-Type: application/json"
4-d '{"id": 1, "method": "eth_unsubscribe", "params": ["0x9cef478923ff08bf67fde6c64013158d"]}'
5
6

Hasil

1{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "result": true
5}

Daftar dengan Alchemy (opens in a new tab) secara gratis, periksa dokumentasi kami (opens in a new tab), dan untuk berita terbaru, ikuti kami di Twitter (opens in a new tab).

Pembaruan terakhir halaman: 1 Oktober 2025

+10

Menggunakan WebSockets

(opens in a new tab)WebSockets vs. HTTP

Cobalah

Cara menggunakan WebSockets

Dengan Web3

API Berlangganan

eth_subscribe

Parameter

Kembalian

Event langganan

Jenis langganan

eth_unsubscribe

Apakah tutorial ini membantu?

`eth_subscribe`

`eth_unsubscribe`