🥇Hur man bygger, distribuerar och testar Waves RIDE dApp

Hej! I denna artikel visar jag hur man skriver och kör en vanlig dApp på Waves-noden. Vi kommer att titta på nödvändiga verktyg, metoder och ett exempel på utveckling.

Utvecklingsschemat för dApps och vanliga applikationer skiljer sig nästan inte åt:

Skriv kod
Skriv automatiserade tester
Startar applikationen
Testa

Verktyg

1. docker för att starta noden och Waves Explorer

Om du inte vill starta noden kan du hoppa över detta steg. Det finns ändå test- och experimentnätverk. Men utan att driftsätta din egen nod kan testprocessen dra ut på tiden.

Du kommer ständigt att behöva nya konton med testtillgångar. Kranen för testnätverket överför 10 WAVES var tionde minut.
Genomsnittlig blocktid i testnätverket är 1 minut, medan det i noden är 15 sekunder. Detta är särskilt påtagligt när en transaktion kräver flera bekräftelser.
I offentliga testnoder kan aggressiv caching förekomma.
De kan också vara tillfälligt otillgängliga på grund av tekniskt underhåll.

Jag kommer fortsätta att utgå ifrån att du arbetar med din egen nod.

2. Kommandoradsverktyget Surfboard

Ladda ner och installera Node.js med hjälp av ppa, homebrew eller exe här: https://nodejs.org/en/download/.
Installera Surfboard – verktyget som låter dig köra tester på en befintlig nod.

npm install -g @waves/surfboard

3. Visual Studio Code-tillägget

Detta steg är valfritt om du inte är en fan av IDE och föredrar textredigerare. Alla nödvändiga verktyg är kommandoradsverktyg. Om du använder vim, var uppmärksam på tillägget vim-ride.

Ladda ner och installera Visual Studio Code: https://code.visualstudio.com/

Öppna VS Code och installera tillägget waves-ride:

Webbläsartillägget Waves Keeper: https://wavesplatform.com/products-keeper

Klart!

Starta noden och Waves Explorer

1. Starta noden:

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

Se till att noden körs via REST API på http://localhost:6869:

Swagger REST API-gränssnittet för noden

2. Starta en instans av Waves Explorer:

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

Öppna din webbläsare och gå till http://localhost:3000. Du kommer att se hur snabbt en tom kedja från den lokala noden byggs.

Waves Explorer visar en instans av den lokala noden

Strukturen för RIDE och verktyget Surfboard

Skapa en tom katalog och kör kommandot

surfboard init

Kommandot initierar katalogen med projektstruktur, en "hello world"-applikation och tester. Om du öppnar den här mappen med VS Code ser du:

Surfboard.config.json

Under mappen .\/ride\/ hittar du en ensam fil wallet.ride – katalogen där dApp-koden ligger. Vi kommer kort att analysera dApp:en i nästa avsnitt.
I mappen . /test/ hittar du filen *.js. Här lagras tester.
. /surfboard.config.json – konfigurationsfilen för att köra tester.

Envs – en viktig sektion. Varje miljö konfigureras så här:

REST API-endpointen för noden som kommer att användas för att köra dApp och CHAIN_ID för nätverket.
Hemlig fras för kontot med tokens som kommer att vara källor till dina testtokens.

Som du ser stödjer surfboard.config.json flera miljöer som standard. Standardinställningen är lokal miljö (nyckel defaultEnv – en ändringsbar parameter).

Applikationen Wallet-demo

Denna sektion är inte en handbok för RIDE-språket. Snarare en översikt över applikationen som vi implementerar och testar för att bättre förstå vad som händer i blockchain.

Låt oss titta på det enkla Wallet-demo-applikationen. Vem som helst kan skicka tokens till dApp-adressen. Man kan bara ta ut sina egna WAVES. Två @Callable-funktioner är tillgängliga via InvokeScriptTransaction:

deposit(), som kräver en bifogad betalning i WAVES
withdraw(amount: Int), som returnerar tokens

Under hela livscykeln för dApp kommer strukturen (address → amount) att upprätthållas:

Action
Resultant tillstånd

initial
tom

Alice sätter in 5 WAVES
alice-address → 500000000

Bob sätter in 2 WAVES

alice-address → 500000000
bob-address → 200000000

Bob tar ut 7 WAVES
NEKAS!

Alice tar ut 4 WAVES
alice-address → 100000000
bob-address → 200000000

Här är koden för att fullt förstå situationen:

# 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

Exempelkoden kan även hittas på GitHub.

VSCode-pluginet stödjer kontinuerlig kompilering när du redigerar filen. Så du kan alltid hålla koll på fel i fliken PROBLEMS.

Om du vill använda en annan textredigerare vid kompilering av filen, använd

surfboard compile ride /wallet.ride

Detta kommer att ge dig en rad base64-kompilerad RIDE-kod.

Testscenariot för 'wallet.ride'

Låt oss titta på testfilen. Det fungerar på JavaScript-ramverket Mocha. Det finns en "Before"-funktion och tre tester:

"Before" finansierar flera konton via MassTransferTransaction, kompilerar skriptet och distribuerar det i blockchain.
"Can deposit" skickar en InvokeScriptTransaction till nätverket och aktiverar deposit() för var och en av de två kontona.
"Can’t withdraw more than was deposited" testar att ingen kan stjäla andras tokens.
"Can deposit" kontrollerar att uttagen hanteras korrekt.

Kör tester med Surfboard och analysera resultaten i Waves Explorer

För att köra testet, kör

surfboard test

Om du har flera scenarier (till exempel behöver en separat distributionsskript) kan du köra

surfboard test my-scenario.js

Surfboard samlar testfiler i mappen ./test/ och kör skriptet i noden som är inställd i surfboard.config.json. Efter några sekunder kommer du att se något liknande:

wallet test suite
Genererar konton med nonce: ce8d86ee
Konto genererat: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Konto genererat: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Konto genererat: wallet#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Konton har framgångsrikt finansierats
Skriptet har ställts in
   √ Kan sätta in (4385ms)
   √ Kan inte ta ut mer än vad som har satts in
   √ Kan ta ut (108ms)
3 godkända (15s)

Hurra! Tester lyckades. Nu ska vi ta en titt på vad som händer när man använder Waves Explorer: vi kan granska block eller klistra in någon av adresserna ovan i sökfältet (till exempel, motsvarande wallet#. Här kan man hitta transaktionshistorik, dApps tillstånd, dekompilerad binärfil.

Waves Explorer. Applikationen som just har distribuerats.

Några tips för Surfboard:

1. För att testa i testnet-miljö, använd:

surfboard test --env=testnet

Få testtokens

2. Om du vill se JSON-versionerna av transaktionerna och hur de bearbetas av noden, kör testet med -v (betyder 'verbose'):

surfboard test -v

Använda applikationer med Waves Keeper

1. Ställ in Waves Keeper för att fungera: http://localhost:6869

Inställning av Waves Keeper för att fungera med lokal nod

2. Importera den hemliga frasen med tokens för nätverket? För enkelhetens skull, använd seed från din nod: waves private node seed with waves tokens. Adress: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. Du kan köra en one-page serverless applikation själv, använda npm. Eller gå till den befintliga: chrome-ext.wvservices.com/dapp-wallet.html

4. Skriv in adressen från testlanseringen (understruken ovan) i textfältet för dApp-adress

5. Skriv ett litet belopp i fältet "Deposit" och tryck på knappen:

Waves Keeper begär tillstånd att signera InvokeScriptTransaction med en betalning av 10 WAVES.