Kuanza na Uendelezaji wa Ethereum

JavaScript

ethers.js

nodi

kuuliza

Alchemy

Mwanzilishi

Elan Halpern

Medium

30 Oktoba 2020

4 dakika za kusoma

Huu ni mwongozo wa wanaoanza kuanza na uendelezaji wa Ethereum. Kwa mafunzo haya tutatumia Alchemy (opens in a new tab), jukwaa linaloongoza la waendelezaji wa mnyororo wa vitalu linalowezesha mamilioni ya watumiaji kutoka 70% ya programu bora za mnyororo wa vitalu, ikiwa ni pamoja na Maker, 0x, MyEtherWallet, Dharma, na Kyber. Alchemy itatupa ufikiaji wa mwisho wa API kwenye mnyororo wa Ethereum ili tuweze kusoma na kuandika miamala.

Tutakuchukua kuanzia kujisajili na Alchemy hadi kuandika hati yako ya kwanza ya Web3! Hakuna uzoefu wa uendelezaji wa mnyororo wa vitalu unaohitajika!

Kufungua akaunti na Alchemy ni rahisi, jisajili bure hapa (opens in a new tab).

2. Unda Programu ya Alchemy

Ili kuwasiliana na mnyororo wa Ethereum na kutumia bidhaa za Alchemy, unahitaji ufunguo wa API ili kuthibitisha maombi yako.

Unaweza kuunda funguo za API kutoka kwenye dashibodi (opens in a new tab). Ili kutengeneza ufunguo mpya, nenda kwenye “Create App” kama inavyoonyeshwa hapa chini:

Shukrani za pekee kwa ShapeShift (opens in a new tab) kwa kuturuhusu kuonyesha dashibodi yao!

Jaza maelezo chini ya “Create App” ili kupata ufunguo wako mpya. Unaweza pia kuona programu ulizotengeneza hapo awali na zile zilizotengenezwa na timu yako hapa. Vuta funguo zilizopo kwa kubofya “View Key” kwa programu yoyote.

Unaweza pia kuvuta funguo za API zilizopo kwa kuelea juu ya “Apps” na kuchagua moja. Unaweza “View Key” hapa, pamoja na “Edit App” ili kuidhinisha vikoa maalum, kuona zana kadhaa za waendelezaji, na kutazama uchanganuzi.

3. Fanya Ombi kutoka kwenye Mstari wa Amri

Wasiliana na mnyororo wa vitalu wa Ethereum kupitia Alchemy ukitumia JSON-RPC na curl.

Kwa maombi ya mwongozo, tunapendekeza kuwasiliana na JSON-RPC kupitia maombi ya POST. Pitisha tu kichwa cha Content-Type: application/json na swali lako kama kiwiliwili cha POST chenye sehemu zifuatazo:

jsonrpc: Toleo la JSON-RPC—kwa sasa, ni 2.0 pekee linalotumika.
method: Mbinu ya API ya ETH. Tazama rejeleo la API. (opens in a new tab)
params: Orodha ya vigezo vya kupitisha kwenye mbinu.
id: Kitambulisho cha ombi lako. Kitarudishwa na jibu ili uweze kufuatilia jibu ni la ombi gani.

Huu hapa ni mfano unaoweza kuendesha kutoka kwenye mstari wa amri ili kupata bei ya gesi ya sasa:

curl https://eth-mainnet.alchemyapi.io/v2/demo \
-X POST \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'

KUMBUKA: Badilisha https://eth-mainnet.alchemyapi.io/v2/demo (opens in a new tab) na ufunguo wako wa API https://eth-mainnet.alchemyapi.io/v2/**your-api-key.

Matokeo:

{ "id": 73,"jsonrpc": "2.0","result": "0x09184e72a000" // 10000000000000 }

4. Sanidi Mteja wako wa Web3

Ikiwa una mteja aliyepo, badilisha URL ya mtoa huduma wako wa nodi wa sasa kuwa URL ya Alchemy yenye ufunguo wako wa API: “https://eth-mainnet.alchemyapi.io/v2/your-api-key"

KUMBUKA: Hati zilizo hapa chini zinahitaji kuendeshwa katika muktadha wa nodi au kuhifadhiwa kwenye faili, sio kuendeshwa kutoka kwenye mstari wa amri. Ikiwa bado hujasakinisha Node au npm, angalia mwongozo huu wa haraka wa usanidi kwa macs (opens in a new tab).

Kuna maktaba nyingi za Web3 (opens in a new tab) unazoweza kuunganisha na Alchemy, hata hivyo, tunapendekeza kutumia Alchemy Web3 (opens in a new tab), mbadala wa moja kwa moja wa Web3.js, iliyojengwa na kusanidiwa kufanya kazi bila mshono na Alchemy. Hii inatoa faida nyingi kama vile majaribio ya kiotomatiki na usaidizi thabiti wa WebSocket.

Ili kusakinisha AlchemyWeb3.js, nenda kwenye saraka ya mradi wako na uendeshe:

Kwa Yarn:

yarn add @alch/alchemy-web3

Kwa NPM:

npm install @alch/alchemy-web3

Ili kuwasiliana na miundombinu ya nodi ya Alchemy, endesha katika NodeJS au ongeza hii kwenye faili ya JavaScript:

const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
const web3 = createAlchemyWeb3(
  "https://eth-mainnet.alchemyapi.io/v2/your-api-key"
)

5. Andika Hati yako ya kwanza ya Web3!

Sasa ili kuanza kwa vitendo na programu kidogo ya Web3 tutaandika hati rahisi inayochapisha nambari ya kitalu cha hivi punde kutoka kwenye Mtandao Mkuu wa Ethereum.

1. Ikiwa bado hujafanya hivyo, kwenye terminal yako unda saraka mpya ya mradi na uingie ndani yake (cd):

mkdir web3-example
cd web3-example

2. Sakinisha utegemezi wa Alchemy Web3 (au Web3 yoyote) kwenye mradi wako ikiwa bado hujafanya hivyo:

npm install @alch/alchemy-web3

3. Unda faili inayoitwa index.js na uongeze yaliyomo yafuatayo:

Hatimaye unapaswa kubadilisha demo na ufunguo wako wa API ya HTTP ya Alchemy.

async function main() {
  const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
  const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo")
  const blockNumber = await web3.eth.getBlockNumber()
  console.log("The latest block number is " + blockNumber)
}
main()