Вызов смарт-контракта из JavaScript

В этом руководстве мы рассмотрим, как вызвать функцию смарт-контракта из JavaScript. Сначала мы прочитаем состояние смарт-контракта (например, баланс владельца ERC-20), а затем изменим состояние блокчейна, выполнив перевод токенов. Вы уже должны быть знакомы с настройкой JS-окружения для взаимодействия с блокчейном.

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

ganache-cli -f https://mainnet.infura.io/v3/[YOUR INFURA KEY] -d -i 66 1 --unlock 0x4d10ae710Bd8D1C31bd7465c8CBC3add6F279E81

Для взаимодействия со смарт-контрактом нам понадобятся его адрес и ABI:

const ERC20TransferABI = [
  {
    constant: false,
    inputs: [
      {
        name: "_to",
        type: "address",
      },
      {
        name: "_value",
        type: "uint256",
      },
    ],
    name: "transfer",
    outputs: [
      {
        name: "",
        type: "bool",
      },
    ],
    payable: false,
    stateMutability: "nonpayable",
    type: "function",
  },
  {
    constant: true,
    inputs: [
      {
        name: "_owner",
        type: "address",
      },
    ],
    name: "balanceOf",
    outputs: [
      {
        name: "balance",
        type: "uint256",
      },
    ],
    payable: false,
    stateMutability: "view",
    type: "function",
  },
]

const DAI_ADDRESS = "0x6b175474e89094c44da98b954eedeac495271d0f"

Для этого проекта мы сократили полный ABI ERC-20, оставив только функции balanceOf и transfer, но вы можете найти полный ABI ERC-20 здесь (opens in a new tab).

Затем нам нужно создать экземпляр нашего смарт-контракта:

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

const daiToken = new web3.eth.Contract(ERC20TransferABI, DAI_ADDRESS)

Мы также настроим два адреса:

• тот, который получит перевод, и
• тот, который мы уже разблокировали и который будет его отправлять:

const senderAddress = "0x4d10ae710Bd8D1C31bd7465c8CBC3add6F279E81"
const receiverAddress = "0x19dE91Af973F404EDF5B4c093983a7c6E3EC8ccE"

В следующей части мы вызовем функцию balanceOf, чтобы получить текущее количество токенов, хранящихся на обоих адресах.

Вызов: Чтение значения из смарт-контракта

В первом примере мы вызовем «константный» метод и выполним метод смарт-контракта в EVM без отправки транзакции. Для этого мы прочитаем баланс ERC-20 адреса. Прочитайте нашу статью о токенах ERC-20.

Вы можете получить доступ к методам созданного экземпляра смарт-контракта, для которого вы предоставили ABI, следующим образом: yourContract.methods.methodname. Используя функцию call, вы получите результат выполнения функции.

daiToken.methods.balanceOf(senderAddress).call(function (err, res) {
  if (err) {
    console.log("An error occurred", err)
    return
  }
  console.log("The balance is: ", res)
})

Помните, что токен DAI стандарта ERC-20 имеет 18 десятичных знаков, что означает, что вам нужно убрать 18 нулей, чтобы получить правильную сумму. Значения uint256 возвращаются в виде строк, поскольку JavaScript не обрабатывает большие числовые значения. Если вы не уверены, как работать с большими числами в JS, ознакомьтесь с нашим руководством по bignumber.js (opens in a new tab).

Отправка: Отправка транзакции в функцию смарт-контракта

Во втором примере мы вызовем функцию перевода смарт-контракта DAI, чтобы отправить 10 DAI на наш второй адрес. Функция перевода принимает два параметра: адрес получателя и количество токенов для перевода:

daiToken.methods
  .transfer(receiverAddress, "100000000000000000000")
  .send({ from: senderAddress }, function (err, res) {
    if (err) {
      console.log("An error occurred", err)
      return
    }
    console.log("Hash of the transaction: " + res)
  })

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

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