🥇Kuidas ehitada, juurutada ja testida Waves RIDE dApp'i

Tere! Käesolevas artiklis näitan, kuidas kirjutada ja käivitada Waves'i sõlmes tavaline dApp. Uurime vajalikke tööriistu, meetodeid ja arenduse näidet.

dApp-ide ja tavapäraste rakenduste arenduse skeem ei erine peaaegu üldse:

Kirjutame koodi
Kirjutame automatiseeritud testimise
Käivitame rakenduse
Testime

Tööriistad

1. docker sõlme ja Waves Explorer'i käivitamiseks

Kui te ei soovi sõlme käivitada, võite selle sammu vahele jätta. On olemas testimis- ja eksperimentaalvõrk. Kuid ilma oma sõlme seadistamata võib testimisprotsess venida.

Teil on pidevalt vaja uusi kontosid testitavate tokenitega. Testimisvõrgu kraan kannab üle 10 WAVES-i iga 10 minuti tagant.
Keskmine plokkide aeg testimisvõrgus on 1 minut, sõlmes 15 sekundit. See on eriti märgatav, kui tehing nõuab mitmeid kinnitusi.
Avalikes testimis-sõlmedes on võimalik agressiivne vahemälu.
Need võivad samuti ajutiselt olla kättesaamatud tehnilise hoolduse tõttu.

Edasi eelduse all, et töötate oma sõlmega.

2. Surfboard käsurea tööriist

Laadige alla ja installige Node.js, kasutades ppa, homebrew või exe siit: https://nodejs.org/en/download/.
Install Surfboard – a tool that will allow you to run tests on an existing node.

npm install -g @waves/surfboard

3. Visual Studio Code Plugin

This step is optional if you are not an IDE fan and prefer text editors. All necessary tools are command-line utilities. If you use vim, pay attention to the plugin vim-ride.

Download and install Visual Studio Code: https://code.visualstudio.com/

Open VS Code and install the waves-ride plugin:

Waves Keeper Browser Extension: https://wavesplatform.com/products-keeper

Valmis!

Run the node and Waves Explorer

1. Start the node:

docker run -d -p 6869:6869 wavesplatform/waves-private-node

Make sure the node is running via the REST API at http://localhost:6869:

Swagger REST API interface for the node

2. Start an instance of Waves Explorer:

docker run -d -e API_NODE_URL=http://localhost:6869 -e NODE_LIST=http://localhost:6869 -p 3000:8080 wavesplatform/explorer

Open your browser and go to http://localhost:3000. You will see how quickly an empty chain of the local node is built.

Waves Explorer displays the instance of the local node

RIDE Structure and Surfboard Tool

Create an empty directory and run the command in it

surfboard init

The command initializes the directory with the project structure, a "hello world" type application, and tests. If you open this folder with VS Code, you will see:

Surfboard.config.json

Kaust ./ride/ alt Leiate ühekordse faili wallet.ride – katalooge, kus asub dApp kood. Analüüsime dAppi lühidalt järgmises osas.
Kaust ./test/ alt Leiate faili *.js. Siin hoitakse teste.
./surfboard.config.json – konfiguratsioonifail testide käivitamiseks.

Envs – oluline sektsioon. Iga keskkond seadistatakse nii:

REST API lõpp-punkt, mida nodi kasutatakse dApp ja CHAIN_ID käivitamiseks.
Salajane fraas konto jaoks, millel on tokenid, mis saavad olema teie testi tokenite allikad.

Nagu näete, toetab surfboard.config.json vaikimisi mitmeid keskkondi. Vaikimisi on seadistatud lokaalne keskkond (võti defaultEnv – muudetav parameeter).

Rakendus Wallet-demo

See sektsioon ei ole RIDE keele käsiraamat. Pigem on see ülevaade rakendusest, mida arendame ja testime, et paremini mõista, mis plokiahelas toimub.

Vaadakem lihtsat rakendust Wallet-demo. Igaüks saab saata dAppi aadressile tokeneid. Väljavõtt võib toimuda ainult oma WAVES'e puhul. Kaks @Callable funktsiooni on saadaval läbi InvokeScriptTransaction:

deposit(), mis nõuab WAVES's kinnitatud makset
withdraw(amount: Int), mis tagastab tokenid

dApp kogu elutsükli jooksul säilitatakse struktuuri (aadress → summa):

Action
Tulemuslik olek

algne
tühi

Alice deponeerib 5 WAVES
alice-address → 500000000

Bob deponeerib 2 WAVES

alice-address → 500000000
bob-address → 200000000

Bob tõmbab välja 7 WAVES
KEELATUD!

Alice tõmbab välja 4 WAVES
alice-address → 100000000
bob-address → 200000000

Siin on kood, et olukorda täielikult mõista:

# In this example multiple accounts can deposit their funds and safely take them back. No one can interfere with this.
# An inner state is maintained as mapping `address=>waves`.
{-# STDLIB_VERSION 3 #-}
{-# CONTENT_TYPE DAPP #-}
{-# SCRIPT_TYPE ACCOUNT #-}
@Callable(i)
func deposit() = {
 let pmt = extract(i.payment)
 if (isDefined(pmt.assetId))
    then throw("works with waves only")
    else {
     let currentKey = toBase58String(i.caller.bytes)
     let currentAmount = match getInteger(this, currentKey) {
       case a:Int => a
       case _ => 0
     }
     let newAmount = currentAmount + pmt.amount
     WriteSet([DataEntry(currentKey, newAmount)]) 
   }
 }
@Callable(i)
func withdraw(amount: Int) = {
 let currentKey = toBase58String(i.caller.bytes)
 let currentAmount = match getInteger(this, currentKey) {
   case a:Int => a
   case _ => 0
 }
 let newAmount = currentAmount - amount
 if (amount < 0)
   then throw("Can't withdraw negative amount")
   else if (newAmount < 0)
     then throw("Not enough balance")
     else ScriptResult(
       WriteSet([DataEntry(currentKey, newAmount)]),
       TransferSet([ScriptTransfer(i.caller, amount, unit)])
      )
 }
@Verifier(tx)
func verify() = false

Koodinäidet saab samuti leida GitHub.

VSCode plugina toetab pidevat kompileerimist faili redigeerimise ajal. Seega saate alati jälgida vigu VAHETUS.

Kui soovite faili kompileerimisel kasutada teist tekstiredaktorit, kasutage

surfboard compile ride/wallet.ride

See väljastab rida base64 kompileeritud RIDE-i koodist.

Teststsenaarium ‘wallet.ride’ jaoks

Vaatame testfaili. Töötab JavaScripti Mocha raamistikus. Seal on funktsioon «Before» ja kolm testi:

«Before» rahastab mitmeid kontosid MassTransferTransactioni kaudu, kompileerib skripti ja juurutab selle plokiahelasse.
«Can deposit» saadab võrku InvokeScriptTransactioni, aktiveerides funktsiooni deposit() iga kahe konto jaoks.
«Can’t withdraw more than was deposited» testib, et keegi ei saa varastada teiste tokenite.
«Can deposit» kontrollib, et väljamaksed töödeldakse korrektselt.

Testide käivitamine Surfboardiga ja tulemuste analüüs Waves Exploreris

Testi käivitamiseks täitke

surfboard test

Kui teil on mitu stsenaariumi (näiteks vajate eraldi projektiskripti), võite käivitada

surfboard test my-scenario.js

Surfboard kogub testifailid kausta ./test/ ja käivitab stsenaariumi nodis, mis on seadistatud surfboard.config.json failis. Mõne sekundi pärast näete midagi sellist:

rahakoti testikomplekt
Konto genereerimine nonce'iga: ce8d86ee
Konto genereeritud: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Konto genereeritud: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Konto genereeritud: wallet#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Kontod on edukalt rahastatud
Skript on seadistatud
   √ Saab sissemakse teha (4385ms)
   √ Ei saa välja võtta rohkem, kui on sisse pandud
   √ Saab välja võtta (108ms)
3 läbis (15s)

Häid uudiseid! Testid on läbitud. Vaadakem, mis toimub Waves Exploreris: vaatame plokke või sisestame ühte eelnevalt nimetatud aadressidest otsingusse (nt vastavat rahakotile#. Siit leiate tehingute ajalugu, dApp oleku, dekompileeritud binaarfaili.

Waves Explorer. Rakendus, mis just äsja juurutati.

Mõned soovitused Surfboardi jaoks:

1. Testimise jaoks testnet keskkonnas kasutage:

surfboard test --env=testnet

Saada testtokenid

2. Kui soovite vaadata JSON-versione tehingutest ja kuidas node neid töödelda, käivitage test -v (tähendab 'verbose'):

surfboard test -v

Rakenduste kasutamine Waves Keeperiga

1. Seadistage Waves Keeper töötamiseks: http://localhost:6869

Waves Keeperi seadistamine kohalikku node'iga tööle

2. Kas soovite importida salajase fraasi tokenitega võrgu jaoks? Lihtsuse huvides kasutage oma node'i algset seed'i: waves private node seed with waves tokens. Aadress: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. Saate käivitada ühe lehe serverita rakenduse ise, kasutades npm-i. Või minge olemasolevasse: chrome-ext.wvservices.com/dapp-wallet.html

4. Sisestage testimise käivitamise aadress (allpool kõrge) dAppi aadressi tekstivälja

5. Sisestage väike summa 'Deposit' väljade ja vajutage nuppu:

Waves Keeper küsib luba InvokeScriptTransactioni allkirjastamiseks 10 WAVES maksega.