Kutumia WebSockets

Huu ni mwongozo wa kiwango cha mwanzo wa kutumia WebSockets na Alchemy kufanya maombi kwa mnyororo wa bloku wa Ethereum.

 (opens in a new tab)WebSockets dhidi ya HTTP

Tofauti na HTTP, ukiwa na WebSockets, huhitaji kuendelea kufanya maombi unapotaka taarifa maalum. WebSockets hudumisha muunganisho wa mtandao kwa ajili yako (ikifanywa ipasavyo) na husikiliza mabadiliko.

Kama ilivyo kwa muunganisho wowote wa mtandao, hupaswi kudhania kuwa WebSocket itabaki wazi milele bila kukatizwa, lakini kushughulikia ipasavyo miunganisho iliyokatika na kuunganisha upya kwa mikono kunaweza kuwa changamoto kupata usahihi. Upande mwingine mbaya wa WebSockets ni kwamba hupati misimbo ya hali ya HTTP katika jibu, bali ujumbe wa hitilafu pekee.

Alchemy Web3 (opens in a new tab) huongeza kiotomatiki ushughulikiaji wa hitilafu za WebSocket na hujaribu tena bila usanidi unaohitajika.

Ijaribu

Njia rahisi zaidi ya kujaribu WebSockets ni kusakinisha zana ya mstari wa amri ya kufanya maombi ya WebSocket kama vile wscat (opens in a new tab). Kwa kutumia wscat, unaweza kutuma maombi kama ifuatavyo:

Kumbuka: ikiwa una akaunti ya Alchemy unaweza kubadilisha demo na ufunguo wako mwenyewe wa API. Jisajili kwa akaunti ya bure ya Alchemy hapa! (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

Jinsi ya kutumia WebSockets

Ili kuanza, fungua WebSocket kwa kutumia URL ya WebSocket kwa ajili ya programu yako. Unaweza kupata URL ya WebSocket ya programu yako kwa kufungua ukurasa wa programu katika dashibodi yako (opens in a new tab) na kubofya "Tazama Ufunguo". Kumbuka kwamba URL ya programu yako kwa WebSockets ni tofauti na URL yake kwa maombi ya HTTP, lakini zote zinaweza kupatikana kwa kubofya "Tazama Ufunguo".

API zozote zilizoorodheshwa katika Marejeleo ya API ya Alchemy (opens in a new tab) zinaweza kutumika kupitia WebSocket. Ili kufanya hivyo, tumia malipo yale yale ambayo yangetumwa kama sehemu kuu ya ombi la HTTP POST, lakini badala yake tuma malipo hayo kupitia WebSocket.

Na Web3

Kubadilisha na kuanza kutumia WebSockets unapotumia maktaba ya mteja kama Web3 ni rahisi. Peleka tu URL ya WebSocket badala ya ile ya HTTP unapounda mteja wako wa Web3. Kwa mfano:

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

API ya Usajili

Unapounganishwa kupitia WebSocket, unaweza kutumia mbinu mbili za ziada: eth_subscribe na eth_unsubscribe. Mbinu hizi zitakuruhusu kusikiliza matukio maalum na kuarifiwa mara moja.

eth_subscribe

Huunda usajili mpya kwa matukio maalum. Jifunze zaidi kuhusu eth_subscribe (opens in a new tab).

Vigezo

1. Aina za usajili
2. Vigezo vya hiari

Hoja ya kwanza inabainisha aina ya tukio la kusikiliza. Hoja ya pili ina chaguo za ziada ambazo hutegemea hoja ya kwanza. Aina tofauti za maelezo, chaguo zao, na malipo ya tukio zao yameelezwa hapa chini.

Inarejesha

Kitambulisho cha usajili: Kitambulisho hiki kitaambatanishwa na matukio yoyote yaliyopokelewa, na pia kinaweza kutumika kughairi usajili kwa kutumia eth_unsubscribe.

Matukio ya usajili

Wakati usajili unatumika, utapokea matukio ambayo ni vitu vyenye sehemu zifuatazo:

• jsonrpc: Daima "2.0"
• method: Daima "eth_subscription"
• params: Kitu chenye sehemu zifuatazo:
  • subscription: Kitambulisho cha usajili kilichorejeshwa na mwito wa eth_subscribe ambao uliunda usajili huu.
  • result: Kitu ambacho maudhui yake hutofautiana kulingana na aina ya usajili.

Aina za usajili

1. alchemy_newFullPendingTransactions

Hurejesha taarifa za muamala kwa miamala yote ambayo imeongezwa kwenye hali ya kusubiri. Aina hii ya usajili hujiandikisha kwa miamala inayosubiri, sawa na mwito wa kawaida wa Web3 web3.eth.subscribe("pendingTransactions"), lakini inatofautiana kwa kuwa inatoa taarifa kamili ya muamala badala ya hashi za muamala pekee.

Mfano:

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
Onyesha yote
Nakala

2. newHeads

Hutoa tukio wakati wowote kichwa kipya kinapoongezwa kwenye mnyororo, ikiwa ni pamoja na wakati wa upangaji upya wa mnyororo.

Wakati upangaji upya wa mnyororo unapotokea, usajili huu utatoa tukio lenye vichwa vyote vipya vya mnyororo mpya. Hasa, hii inamaanisha kuwa unaweza kuona vichwa vingi vikitolewa vikiwa na urefu sawa, na hili linapotokea kichwa cha baadaye kinapaswa kuchukuliwa kuwa ndicho sahihi baada ya upangaji upya.

Mfano:

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
Onyesha yote
Nakala

3. logs

Hutoa kumbukumbu ambazo ni sehemu ya bloku mpya zilizoongezwa zinazolingana na vigezo maalum vya kichujio.

Wakati upangaji upya wa mnyororo unapotokea, kumbukumbu ambazo ni sehemu ya bloku kwenye mnyororo wa zamani zitatolewa tena na sifa ya removed ikiwa imewekwa kuwa true. Zaidi ya hayo, kumbukumbu ambazo ni sehemu ya bloku kwenye mnyororo mpya hutolewa, ikimaanisha kwamba inawezekana kuona kumbukumbu za muamala uleule mara nyingi katika kisa cha upangaji upya.

Vigezo

1. Kitu chenye sehemu zifuatazo:
   • address (hiari): ama mfuatano unaowakilisha anwani au safu ya mifuatano kama hiyo.
     • Kumbukumbu zilizoundwa kutoka kwa mojawapo ya anwani hizi pekee ndizo zitatolewa.
   • topics: safu ya vibainishi vya mada.
     • Kila kibainishi cha mada ni ama null, mfuatano unaowakilisha mada, au safu ya mifuatano.
     • Kila nafasi katika safu ambayo si null inazuia kumbukumbu zinazotolewa kwa zile tu ambazo zina moja ya mada zilizotolewa katika nafasi hiyo.

Baadhi ya mifano ya vipimo vya mada:

• []: Mada zozote zinaruhusiwa.
• [A]: A katika nafasi ya kwanza (na chochote baada yake).
• [null, B]: Chochote katika nafasi ya kwanza na B katika nafasi ya pili (na chochote baada yake).
• [A, B]: A katika nafasi ya kwanza na B katika nafasi ya pili (na chochote baada yake).
• [[A, B], [A, B]]: (A au B) katika nafasi ya kwanza na (A au B) katika nafasi ya pili (na chochote baada yake).

Mfano:

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
Onyesha yote
Nakala

eth_unsubscribe

Hughairi usajili uliopo ili kusiwe na matukio zaidi yatakayotumwa.

Vigezo

1. Kitambulisho cha Usajili, kama ilivyorejeshwa awali kutoka kwa mwito wa eth_subscribe.

Inarejesha

true ikiwa usajili umeghairiwa kwa mafanikio, au false ikiwa hakuna usajili uliokuwepo na kitambulisho kilichotolewa.

Mfano:

Ombi

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

Matokeo

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

Jisajili na Alchemy (opens in a new tab) bila malipo, angalia nyaraka zetu (opens in a new tab), na kwa habari za hivi punde, tufuate kwenye Twitter (opens in a new tab).

Ukurasa ulihaririwa mwisho: 1 Oktoba 2025

w (opens in a new tab)

m (opens in a new tab)

p (opens in a new tab)

+9

Ona wachangiaji