Wywoływanie inteligentnego kontraktu z poziomu JavaScript

W tym samouczku zobaczymy, jak wywołać funkcję inteligentnego kontraktu z poziomu JavaScript. Najpierw odczytamy stan inteligentnego kontraktu (np. saldo posiadacza tokenów ERC-20), a następnie zmodyfikujemy stan blockchaina, wykonując transfer tokenów. Powinieneś już wiedzieć, jak skonfigurować środowisko JS do interakcji z blockchainem.

W tym przykładzie pobawimy się tokenem DAI. W celach testowych wykonamy rozwidlenie blockchaina za pomocą ganache-cli i odblokujemy adres, który ma już dużo DAI:

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

Aby wejść w interakcję z inteligentnym kontraktem, będziemy potrzebować jego adresu oraz 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"

Na potrzeby tego projektu okroiliśmy pełne ABI ERC-20, aby zachować tylko funkcje balanceOf i transfer, ale możesz znaleźć pełne ABI ERC-20 tutaj (opens in a new tab).

Następnie musimy utworzyć instancję naszego inteligentnego kontraktu:

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

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

Skonfigurujemy również dwa adresy:

• ten, który otrzyma transfer, oraz
• ten, który już odblokowaliśmy i który go wyśle:

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

W następnej części wywołamy funkcję balanceOf, aby pobrać aktualną liczbę tokenów, które posiadają oba adresy.

Call: Odczytywanie wartości z inteligentnego kontraktu

Pierwszy przykład wywoła metodę „stałą” (constant) i wykona metodę inteligentnego kontraktu w EVM bez wysyłania żadnej transakcji. W tym celu odczytamy saldo ERC-20 danego adresu. Przeczytaj nasz artykuł o tokenach ERC-20.

Możesz uzyskać dostęp do metod utworzonej instancji inteligentnego kontraktu, dla którego dostarczyłeś ABI, w następujący sposób: yourContract.methods.methodname. Używając funkcji call, otrzymasz wynik wykonania tej funkcji.

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

Pamiętaj, że token DAI ERC-20 ma 18 miejsc po przecinku, co oznacza, że musisz usunąć 18 zer, aby uzyskać prawidłową kwotę. Wartości uint256 są zwracane jako ciągi znaków (string), ponieważ JavaScript nie radzi sobie z dużymi wartościami liczbowymi. Jeśli nie jesteś pewien, jak radzić sobie z dużymi liczbami w JS, sprawdź nasz samouczek o bignumber.js (opens in a new tab).

Send: Wysyłanie transakcji do funkcji inteligentnego kontraktu

W drugim przykładzie wywołamy funkcję transferu inteligentnego kontraktu DAI, aby wysłać 10 DAI na nasz drugi adres. Funkcja transferu przyjmuje dwa parametry: adres odbiorcy oraz kwotę tokenów do przetransferowania:

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

Funkcja wywołania zwraca hash transakcji, która zostanie wydobyta i dodana do blockchaina. W Ethereum hashe transakcji są przewidywalne – dzięki temu możemy uzyskać hash transakcji przed jej wykonaniem (dowiedz się, jak obliczane są hashe tutaj (opens in a new tab)).

Ponieważ funkcja jedynie przesyła transakcję do blockchaina, nie możemy zobaczyć wyniku, dopóki nie dowiemy się, kiedy zostanie ona wydobyta i włączona do blockchaina. W następnym samouczku dowiemy się, jak czekać na wykonanie transakcji w blockchainie, znając jej hash (opens in a new tab).