Ruka hadi kwenye maudhui makuu

Kuanza na Uendelezaji wa Ethereum

JavaScript
ethers.js
nodi
kuuliza
Alchemy
Mwanzilishi
Elan Halpern
30 Oktoba 2020
4 dakika za kusoma

Ethereum and Alchemy logos

Huu ni mwongozo wa wanaoanza kuanza na uendelezaji wa Ethereum. Kwa mafunzo haya tutatumia Alchemy (inafunguka katika kichupo kipya), 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!

1. Jisajili kwa Akaunti ya Alchemy ya Bure

Kufungua akaunti na Alchemy ni rahisi, jisajili bure hapa (inafunguka katika kichupo kipya).

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 (inafunguka katika kichupo kipya). Ili kutengeneza ufunguo mpya, nenda kwenye “Create App” kama inavyoonyeshwa hapa chini:

Shukrani za pekee kwa ShapeShift (inafunguka katika kichupo kipya) kwa kuturuhusu kuonyesha dashibodi yao!

Alchemy dashboard

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.

Create app with Alchemy screenshot

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 hoja yako kama kiwiliwili cha POST chenye nyanja zifuatazo:

  • jsonrpc: Toleo la JSON-RPC—kwa sasa, ni 2.0 pekee inayotumika.
  • method: Mbinu ya API ya ETH. Tazama rejeleo la API.
  • params: Orodha ya vigezo vya kupitisha kwenye mbinu.
  • id: Kitambulisho cha ombi lako. Kitarudishwa na majibu ili uweze kufuatilia ni ombi lipi majibu yanahusiana nalo.

Hapa kuna 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 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 huna Node au npm iliyosakinishwa, fuata maagizo ya usakinishaji wa Node.js (inafunguka katika kichupo kipya).

Kuna maktaba nyingi za Web3 unazoweza kuunganisha na Alchemy, hata hivyo, tunapendekeza kutumia Alchemy Web3 (inafunguka katika kichupo kipya), 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:

Unapaswa hatimaye kubadilisha demo na ufunguo wako wa API wa HTTP wa 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()

Hujazoea mambo ya async? Angalia chapisho hili la Medium (inafunguka katika kichupo kipya).

4. Iendeshe kwenye terminal yako ukitumia node

node index.js

5. Sasa unapaswa kuona pato la nambari ya kitalu cha hivi punde kwenye kiweko chako!

The latest block number is 11043912

Hongera! Umeandika tu hati yako ya kwanza ya Web3 ukitumia Alchemy 🎉

Huna uhakika wa kufanya nini baadaye? Jaribu kusambaza mkataba mahiri wako wa kwanza na uanze kwa vitendo na programu ya Solidity katika Mwongozo wetu wa Mkataba Mahiri wa Hello World, au endelea kuchunguza nyaraka za Alchemy (inafunguka katika kichupo kipya) kwa mifano zaidi.

Jisajili na Alchemy bure (inafunguka katika kichupo kipya), angalia nyaraka (inafunguka katika kichupo kipya) zetu, na kwa habari za hivi punde, tufuate kwenye Twitter (inafunguka katika kichupo kipya).