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

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

dAppide ja tavarakenduste arendusprotsess ei erine praktiliselt üldse:

Kirjutame koodi
Kirjutame automatiseeritud testimise
Käivitame rakenduse
Testime

Tööriistad

1. docker sõlme ja Waves Exploreri käivitamiseks

Kui te ei soovi sõlme käivitada, võite selle sammu vahele jätta. Lõppude lõpuks on olemas testimis- ja eksperimentaalsed võrgud. Kuid ilma oma sõlme üles seadmiseta võib testimisprotsess venida.

Teil on pidevalt vaja uusi kontosid koos testitokenitega. Testimisvõrgu kraan edastab iga 10 minuti tagant 10 WAVES-i.
Testimisvõrgus on plokkide keskmine aeg 1 minut, sõlmes – 15 sekundit. See on eriti märgatav, kui tehing nõuab mitu kinnitust.
Avalikes testimis sõlmedes on võimalik agressiivne vahemällu salvestamine.
Samuti võivad need olla ajutiselt kättesaamatud tehnilise hoolduse tõttu.

Oletame, et tööteete oma sõlme.

2. Käskude rea tööriist Surfboard

Laadige alla ja installige Node.js ppa, homebrew või exe abil siit: https://nodejs.org/en/download/.
Installige Surfboard – tööriist, mis võimaldab teil käivitada teste olemasolevas sõlmes.

npm install -g @waves/surfboard

3. Visual Studio Code'i plugin

Samm ei ole kohustuslik, kui te ei ole IDE fänn ja eelistate tekstiredaktoreid. Kõik vajalikud tööriistad on käsurea utiliidid. Kui kasutate vim-i, pange tähele pluginat vim-ride.

Laadige alla ja installige Visual Studio Code: https://code.visualstudio.com/

Avage VS Code ja installige plugin waves-ride:

Brauserilaiendus Waves Keeper: https://wavesplatform.com/products-keeper

Valmis!

Käivitage sõlm ja Waves Explorer

1. Käivitage sõlm:

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

Veenduge, et sõlm käivitub REST API kaudu http://localhost:6869:

Swagger REST API liides sõlmele

2. Käivitage Waves Exploreri eksemplar:

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

Avage brauser ja minge http://localhost:3000. Näete, kui kiiresti lokaalne sõlm tühja ahelat üles ehitab.

Waves Explorer kuvab lokaalse sõlme eksemplari

RIDE struktuur ja tööriist Surfboard

Looge tühi kataloog ja käivitage selles käsk

surfboard init

Käsk initsialiseerib katalooge, sealhulgas projektistruktuuri, "hello world" tüüpi rakenduse ja testid. Kui avate selle kausta VS Code'is, näete:

Surfboard.config.json

Kaustas .\/ride\/ leiate ühe faili wallet.ride – katalooge, kus asub dApp kood. Anname dAppi lühikese analüüsi järgmises blokis.
Kausta . /test/ leiate faili *.js. Siin hoitakse teste.
. /surfboard.config.json – konfigureerimisfail testide käivitamiseks.

Envs – oluline sektsioon. Iga keskkond on seadistatud järgmiselt:

REST API sõlme lõpp-punkt, mida kasutatakse dApp-i ja võrgu CHAIN_ID käivitamiseks.
Salajane fraas konto jaoks, kus on tokenid, mis saavad olema teie testi tokenite allikad.

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

Rakendus Wallet-demo

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

Vaadakem lihtsat rakendust Wallet-demo. Igaüks võib saata dApp-aadressile tokeneid. Saab välja võtta ainult oma WAVES-e. Kaks @Callable funktsiooni on saadaval InvokeScriptTransaction kaudu:

deposit(), mis nõuab WAVES-i külge kinnitatud makset
withdraw(amount: Int), mis tagastab tokenid

Terve dApp-i elu jooksul hoitakse struktuuri (aadress → summa):

Toiming
Tulemuslik seisund

algne
tühi

Alice deponeerib 5 WAVES-i
alice-address → 500000000

Bob deponeerib 2 WAVES-i

alice-address → 500000000
bob-address → 200000000

Bob taandab 7 WAVES-i
KEELATUD!

Alice taandab 4 WAVES-i
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äidud leiate ka GitHub.

VSCode'i pistikprogramm toetab pidevat kompileerimist faili redigeerimise ajal. Seetõttu saate alati jälgida vigu PROBLEEMID vahekaart.

Kui soovite kasutada muud tekstiredaktorit faili kompileerimise ajal, kasutage

surfboard compile ride/ wallet.ride

See kirjutab välja hulga base64 kompileeritud RIDE koodist.

Teststsenaarium ‘wallet.ride’ jaoks

Vaadake testifaili. Töötab JavaScripti Mocha raamistiku peal. On funktsioon „Before“ ja kolm testi:

„Before“ finantseerib mitu kontot läbi MassTransferTransaction, kompileerib skripti ja juurutab selle plokiahelas.
„Can deposit“ saadab võrgule InvokeScriptTransaction, aktiveerides deposit() funktsiooni iga kahe konto puhul.
„Can’t withdraw more than was deposited“ testib, et keegi ei suuda varastada teiste tokenit.
„Can deposit“ kontrollib, et väljavõtted töödeldakse õigesti.

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

Testi käivitamiseks täitke

surfboard test

Kui teil on mitu stsenaariumi (näiteks on vaja eraldi juurutamisskripti), saate jooksutada

surfboard test my-scenario.js

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

rahakoti testikomplekt
Konto genereerimise nonce: ce8d86ee
Konto genereeritud: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Konto genereeritud: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Konto genereeritud: rahakott#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Kontod on eduka rahastamise saanud
Skripti on seadistatud
   √ Saab deponeerida (4385ms)
   √ Ei saa välja võtta rohkem, kui on deponeeritud
   √ Saab välja võtta (108ms)
3 läbitud (15s)

Hurraa! Testid on läbitatud. Vaatame nüüd, mis juhtub, kui kasutame Waves Explorerit: vaatame plokke või sisestame ükskõik millisest ülaltoodud aadressilt otsingusse (näiteks vastav) rahakott#. Seal on võimalik leida tehingute ajalugu, dApp olek ning dekompileeritud binaarfail.

Waves Explorer. Rakendus, mis just käivitati.

Mõned soovitused Surfboardi kohta:

1. Testimiseks testnet keskkonnas kasutage:

surfboard test --env=testnet

Hankige testitooted

2. Kui soovite vaadata tehingute JSON-versioone ja kuidas need sõlmes töödeldakse, käivitage testiparameetriga -v (tähendab 'verbose'):

surfboard test -v

Rakenduste kasutamine koos Waves Keeperiga

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

Seadistamine Waves Keeperi jaoks töötama kohaliku sõlmega

2. Importige võti, millel on tokenid võrgu jaoks? Lihtsuse huvides kasutage oma sõlme algset seemet: waves private node seed with waves tokens. Aadress: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. Saate käivitada ühe lehega serveriteta rakenduse iseseisvalt, kasutades npm-i. Või minge olemasolevale: chrome-ext.wvservices.com/dapp-wallet.html

4. Sisestage testkäivitamise aadress (ülevalt rõhutatud) dApp aadressi tekstivälja

5. Sisestage väike summa väljale 'Deponeerida' ja klõpsake nuppu:

Waves Keeper küsib luba InvokeScriptTransaction allkirjastamiseks, mille makse on 10 WAVES.