Перейти до основного контенту

Початок розробки на Ethereum

JavaScript
ethers.js
вузли
запити
Alchemy
Початківець
Elan Halpern
30 жовтня 2020 р.
4 читається за хвилину

Логотипи Ethereum та Alchemy

Це посібник для початківців із початку розробки Ethereum. У цьому посібнику ми будемо використовувати Alchemy (opens in a new tab), провідну платформу для розробників на блокчейні, яка підтримує мільйони користувачів із 70% провідних блокчейн-додатків, зокрема Maker, 0x, MyEtherWallet, Dharma та Kyber. Alchemy надасть нам доступ до кінцевої точки API в блокчейні Ethereum, щоб ми могли читати й записувати транзакції.

Ми проведемо вас від реєстрації в Alchemy до написання вашого першого скрипту web3! Досвід розробки на блокчейні не є обов'язковим!

1. Зареєструйте безкоштовний обліковий запис Alchemy

Створити обліковий запис в Alchemy легко, зареєструйтеся безкоштовно тут (opens in a new tab).

2. Створіть додаток Alchemy

Щоб взаємодіяти з блокчейном Ethereum і використовувати продукти Alchemy, вам потрібен ключ API для автентифікації ваших запитів.

Ви можете створити ключі API на інформаційній панелі (opens in a new tab). Щоб створити новий ключ, перейдіть до розділу «Створити додаток», як показано нижче:

Особлива подяка ShapeShift (opens in a new tab) за те, що дозволили нам показати їхню інформаційну панель!

Інформаційна панель Alchemy

Заповніть дані в розділі «Створити додаток», щоб отримати свій новий ключ. Тут ви також можете побачити додатки, створені вами раніше, і ті, що були створені вашою командою. Отримайте наявні ключі, натиснувши на кнопку «Переглянути ключ» для будь-якого додатка.

Знімок екрана створення додатка в Alchemy

Ви також можете отримати наявні ключі API, навівши курсор на «Додатки» та вибравши один із них. Тут можна «Переглянути ключ», а також «Редагувати додаток», щоб додати певні домени до білого списку, переглянути кілька інструментів для розробників і переглянути аналітику.

GIF-анімація, що показує, як користувач може отримати ключі API

3. Створення запиту з командного рядка

Взаємодійте з блокчейном Ethereum через Alchemy за допомогою JSON-RPC і curl.

Для запитів вручну ми рекомендуємо взаємодіяти з JSON-RPC через POST-запити. Просто передайте заголовок Content-Type: application/json і ваш запит як тіло POST-запиту з такими полями:

  • jsonrpc: версія JSON-RPC — наразі підтримується лише 2.0.
  • method: метод ETH API. Див. довідник з API. (opens in a new tab)
  • params: список параметрів для передачі в метод.
  • id: ідентифікатор вашого запиту. Він буде повернутий у відповіді, щоб ви могли відстежувати, до якого запиту належить відповідь.

Ось приклад, який можна запустити з командного рядка, щоб отримати поточну ціну на газ:

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}'

ПРИМІТКА: замініть https://eth-mainnet.alchemyapi.io/v2/demo (opens in a new tab) на власний ключ API https://eth-mainnet.alchemyapi.io/v2/**your-api-key.

Результати:

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

4. Налаштуйте свій клієнт Web3

Якщо у вас уже є клієнт, змініть URL-адресу вашого поточного постачальника вузлів на URL-адресу Alchemy з вашим ключем API: “https://eth-mainnet.alchemyapi.io/v2/your-api-key\"

ПРИМІТКА: Наведені нижче скрипти потрібно запускати в контексті вузла або зберігати у файлі, а не запускати з командного рядка. Якщо у вас ще не встановлено Node або npm, перегляньте цей короткий посібник із налаштування для Mac (opens in a new tab).

Існує безліч бібліотек Web3 (opens in a new tab), які можна інтегрувати з Alchemy, однак ми рекомендуємо використовувати Alchemy Web3 (opens in a new tab), пряму заміну для web3.js, створену та налаштовану для безперебійної роботи з Alchemy. Це надає численні переваги, як-от автоматичні повторні спроби та надійна підтримка WebSocket.

Щоб установити AlchemyWeb3.js, перейдіть до каталогу вашого проєкту та виконайте:

За допомогою Yarn:

1yarn add @alch/alchemy-web3

За допомогою NPM:

1npm install @alch/alchemy-web3

Щоб взаємодіяти з інфраструктурою вузлів Alchemy, запустіть у NodeJS або додайте це до файлу JavaScript:

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

5. Напишіть свій перший скрипт Web3!

Тепер, щоб попрактикуватися в програмуванні на web3, ми напишемо простий скрипт, який виводить номер останнього блоку з основної мережі Ethereum.

1. Якщо ви ще цього не зробили, створіть у своєму терміналі новий каталог проєкту та перейдіть до нього:

1mkdir web3-example
2cd web3-example

2. Якщо ви ще цього не зробили, установіть залежність Alchemy web3 (або будь-яку іншу web3) у свій проєкт:

1npm install @alch/alchemy-web3

3. Створіть файл з іменем index.js та додайте до нього такий вміст:

Зрештою, ви повинні замінити demo своїм ключем Alchemy HTTP API.

1async function main() {
2 const { createAlchemyWeb3 } = require("@alch/alchemy-web3")
3 const web3 = createAlchemyWeb3("https://eth-mainnet.alchemyapi.io/v2/demo")
4 const blockNumber = await web3.eth.getBlockNumber()
5 console.log("Номер останнього блоку: " + blockNumber)
6}
7main()

Не знайомі з асинхронним програмуванням? Перегляньте цю статтю на Medium (opens in a new tab).

4. Запустіть його у своєму терміналі за допомогою node

1node index.js

5. Тепер ви побачите виведений в консолі номер останнього блоку!

1Номер останнього блоку: 11043912

Чудово! Вітаємо! Ви щойно написали свій перший скрипт web3 за допомогою Alchemy 🎉

Не знаєте, що робити далі? Спробуйте розгорнути свій перший смарт-контракт і попрактикуватися в програмуванні на Solidity в нашому Посібнику зі створення смарт-контракту «Привіт, світе» (opens in a new tab) або перевірте свої знання інформаційної панелі за допомогою Демо-додатка панелі інструментів (opens in a new tab)!

Зареєструйтеся в Alchemy безкоштовно (opens in a new tab), перегляньте нашу документацію (opens in a new tab) і, щоб дізнаватися останні новини, підписуйтеся на нас у Twitter (opens in a new tab).

Останні оновлення сторінки: 25 вересня 2025 р.

Чи була ця інструкція корисною?