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

Настройка Web3.js для использования блокчейна Эфириума в JavaScript

web3.js
javascript
Для начинающих
jdourlens
11 апреля 2020 г.
3 минут на чтение

В этом руководстве мы рассмотрим, как начать работу с Web3.js (opens in a new tab) для взаимодействия с блокчейном Эфириума. Web3.js можно использовать как во фронтенде, так и в бэкенде для чтения данных из блокчейна, совершения транзакций и даже для того, чтобы развернуть смарт-контракты.

Первый шаг — подключить Web3.js к вашему проекту. Чтобы использовать его на веб-странице, вы можете импортировать библиотеку напрямую, используя CDN, например JSDeliver.

<script src="https://cdn.jsdelivr.net/npm/web3@latest/dist/web3.min.js"></script>

Если вы предпочитаете установить библиотеку для использования в бэкенде или фронтенд-проекте, использующем сборку, вы можете установить ее с помощью npm:

npm install web3 --save

Затем, чтобы импортировать Web3.js в скрипт Node.js или фронтенд-проект на Browserify, вы можете использовать следующую строку JavaScript:

const Web3 = require("web3")

Теперь, когда мы подключили библиотеку к проекту, нам нужно ее инициализировать. Ваш проект должен иметь возможность взаимодействовать с блокчейном. Большинство библиотек Эфириума взаимодействуют с узлом через RPC-вызовы. Чтобы инициировать нашего провайдера Web3, мы создадим экземпляр Web3, передав в конструктор URL-адрес провайдера. Если у вас на компьютере запущен узел или экземпляр ganache (opens in a new tab), это будет выглядеть так:

const web3 = new Web3("http://localhost:8545")

Если вы хотите получить прямой доступ к размещенному узлу, вы можете найти варианты в разделе узлы как услуга.

const web3 = new Web3("https://cloudflare-eth.com")

Чтобы проверить, правильно ли мы настроили наш экземпляр Web3, мы попытаемся получить номер последнего блока с помощью функции getBlockNumber. Эта функция принимает колбэк в качестве параметра и возвращает номер блока в виде целого числа.

var Web3 = require("web3")
const web3 = new Web3("https://cloudflare-eth.com")

web3.eth.getBlockNumber(function (error, result) {
  console.log(result)
})

Если вы выполните эту программу, она просто выведет номер последнего блока: вершину блокчейна. Вы также можете использовать вызовы функций await/async, чтобы избежать вложенных колбэков в вашем коде:

async function getBlockNumber() {
  const latestBlockNumber = await web3.eth.getBlockNumber()
  console.log(latestBlockNumber)
  return latestBlockNumber
}

getBlockNumber()

Вы можете посмотреть все функции, доступные в экземпляре Web3, в официальной документации Web3.js (opens in a new tab).

Большинство библиотек Web3 являются асинхронными, поскольку в фоновом режиме библиотека выполняет вызовы JSON-RPC к узлу, который отправляет обратно результат.

Если вы работаете в браузере, некоторые кошельки напрямую внедряют экземпляр Web3, и вам следует стараться использовать его при любой возможности, особенно если вы планируете взаимодействовать с адресом Эфириума пользователя для совершения транзакций.

Вот фрагмент кода для определения доступности кошелька МетаМаск и попытки его включить, если он доступен. В дальнейшем это позволит вам считывать баланс пользователя и даст ему возможность подтверждать транзакции, которые вы хотели бы, чтобы он совершил в блокчейне Эфириума:

Существуют и часто используются альтернативы Web3.js, такие как Ethers.js (opens in a new tab). В следующем руководстве мы рассмотрим, как легко отслеживать новые поступающие блоки в блокчейне и смотреть, что они содержат (opens in a new tab).