როგორ ავაშენოთ, განათავსოთ და შეამოწმოთ ტალღები RIDE dApp

გამარჯობა! ამ სტატიაში მე გაჩვენებთ, თუ როგორ უნდა დაწეროთ და გაუშვათ ჩვეულებრივი dApp Waves კვანძზე. მოდით შევხედოთ საჭირო ინსტრუმენტებს, მეთოდებს და განვითარების მაგალითს.

dApps და რეგულარული აპლიკაციების განვითარების სქემა თითქმის იგივეა:

• კოდის დაწერა
• ავტომატური ტესტირების წერა
• აპლიკაციის გაშვება
• ტესტირება

ინსტრუმენტები

1. docker კვანძისა და Waves Explorer-ის გასაშვებად

თუ არ გსურთ კვანძის დაწყება, შეგიძლიათ გამოტოვოთ ეს ნაბიჯი. ყოველივე ამის შემდეგ, არსებობს სატესტო და ექსპერიმენტული ქსელი. მაგრამ თქვენი საკუთარი კვანძის განლაგების გარეშე, ტესტირების პროცესი შეიძლება გაჭიანურდეს.

• მუდმივად დაგჭირდებათ ახალი ანგარიშები სატესტო ნიშნებით. სატესტო ქსელის ონკანი გადასცემს 10 ტალღას ყოველ 10 წუთში.
• სატესტო ქსელში დაბლოკვის საშუალო დრო 1 წუთია, კვანძში – 15 წამი. ეს განსაკუთრებით შესამჩნევია, როდესაც ტრანზაქცია მოითხოვს მრავალჯერად დადასტურებას.
• საჯარო სატესტო კვანძებზე შესაძლებელია აგრესიული ქეშირება.
• ისინი ასევე შეიძლება დროებით მიუწვდომელი იყოს ტექნიკური მომსახურების გამო.

ამიერიდან ვივარაუდებ, რომ თქვენ მუშაობთ საკუთარ კვანძთან.

2. Surfboard Command Line Tool

• ჩამოტვირთეთ და დააინსტალირეთ Node.js ppa, homebrew ან exe გამოყენებით აქ: https://nodejs.org/en/download/.
• დააინსტალირეთ Surfboard, ინსტრუმენტი, რომელიც საშუალებას გაძლევთ განახორციელოთ ტესტები არსებულ კვანძზე.

npm install -g @waves/surfboard

3. Visual Studio Code მოდული

ეს ნაბიჯი არჩევითია, თუ არ ხართ IDE-ების გულშემატკივარი და უპირატესობას ანიჭებთ ტექსტურ რედაქტორებს. ყველა საჭირო ინსტრუმენტი არის ბრძანების ხაზის კომუნალური პროგრამა. თუ იყენებთ vim-ს, ყურადღება მიაქციეთ დანამატს vim-ride.

ჩამოტვირთეთ და დააინსტალირეთ Visual Studio Code: https://code.visualstudio.com/

გახსენით VS Code და დააინსტალირეთ waves-ride მოდული:

Waves Keeper ბრაუზერის გაფართოება: https://wavesplatform.com/products-keeper

შესრულებულია!

დაიწყეთ კვანძი და Waves Explorer

1. დაიწყეთ კვანძი:

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

დარწმუნდით, რომ კვანძი გაშვებულია REST API-ში http://localhost:6869:

Swagger REST API კვანძისთვის

2. დაიწყეთ Waves Explorer-ის მაგალითი:

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

გახსენით ბრაუზერი და გადადით http://localhost:3000. თქვენ ნახავთ, რამდენად სწრაფად იქმნება ცარიელი ადგილობრივი კვანძის წრე.

Waves Explorer აჩვენებს ლოკალური კვანძის მაგალითს

RIDE სტრუქტურა და Surfboard ინსტრუმენტი

შექმენით ცარიელი დირექტორია და გაუშვით ბრძანება მასში

surfboard init

ბრძანება ახდენს დირექტორიას ინიციალიზაციას პროექტის სტრუქტურით, "hello world" აპლიკაციებითა და ტესტებით. თუ ამ საქაღალდეს გახსნით VS Code-ით, ნახავთ:

Surfboard.config.json

• ./ride/ საქაღალდეში ნახავთ ერთ ფაილს wallet.ride - დირექტორია, სადაც მდებარეობს dApp კოდი. ჩვენ მოკლედ გავაანალიზებთ dApps-ს შემდეგ ბლოკში.
• ./test/ საქაღალდეში ნახავთ *.js ფაილს. ტესტები აქ ინახება.
• ./surfboard.config.json – კონფიგურაციის ფაილი ტესტების გასაშვებად.

Envs მნიშვნელოვანი განყოფილებაა. თითოეული გარემო კონფიგურირებულია შემდეგნაირად:

• კვანძის REST API ბოლო წერტილი, რომელიც გამოყენებული იქნება ქსელის dApp-ისა და CHAIN_ID-ის გასაშვებად.
• საიდუმლო ფრაზა ტოკენებით ანგარიშისთვის, რომელიც იქნება თქვენი სატესტო ნიშნების წყარო.

როგორც ხედავთ, surfboard.config.json მხარს უჭერს მრავალ გარემოს ნაგულისხმევად. ნაგულისხმევი არის ლოკალური გარემო (defaultEnv გასაღები არის ცვალებადი პარამეტრი).

საფულე-დემო აპლიკაცია

ეს განყოფილება არ არის მითითება RIDE ენაზე. პირიქით, გადახედეთ აპლიკაციას, რომელსაც ჩვენ ვაყენებთ და ვამოწმებთ, რომ უკეთ გავიგოთ რა ხდება ბლოკჩეინში.

მოდით შევხედოთ უბრალო Wallet-დემო აპლიკაციას. ნებისმიერს შეუძლია ტოკენების გაგზავნა dApp მისამართზე. თქვენ შეგიძლიათ მხოლოდ თქვენი ტალღების ამოღება. ორი @Callable ფუნქცია ხელმისაწვდომია InvokeScriptTransaction-ის საშუალებით:

• deposit()რომელიც საჭიროებს თანდართულ გადახდას WAVES-ში
• withdraw(amount: Int)რომელიც აბრუნებს ჟეტონებს

dApp სასიცოცხლო ციკლის განმავლობაში, სტრუქტურა (მისამართი → თანხა) შენარჩუნდება:

აქცია
შედეგად მიღებული მდგომარეობა

საწყისი
ცარიელი

ალისის დეპოზიტები 5 ტალღა
ალისა-მისამართი → 500000000

ბობ დეპოზიტები 2 ტალღა

ალისა-მისამართი → 500000000
ბობ-მისამართი → 200000000

ბობ ამოიღებს 7 ტალღას
ᲣᲐᲠᲧᲝᲤᲘᲚᲘ!

ალისა ამოიღებს 4 ტალღას
ალისა-მისამართი → 100000000
ბობ-მისამართი → 200000000

აქ არის კოდი სიტუაციის სრულად გასაგებად:

# 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

კოდის ნიმუში ასევე შეგიძლიათ იხილოთ აქ GitHub.

VSCode მოდული მხარს უჭერს უწყვეტ კომპილაციას ფაილის რედაქტირებისას. ამიტომ, ყოველთვის შეგიძლიათ აკონტროლოთ შეცდომები ჩანართში PROBLEM.

თუ გსურთ გამოიყენოთ სხვა ტექსტური რედაქტორი ფაილის შედგენისას, გამოიყენეთ

surfboard compile ride/wallet.ride

ეს გამოიტანს base64 შედგენილი RIDE კოდის სერიას.

სატესტო სკრიპტი 'wallet.ride'-ისთვის

მოდით შევხედოთ სატესტო ფაილი. უზრუნველყოფილია JavaScript-ის Mocha-ის ფრეიმვორით. არის ფუნქცია "ადრე" და სამი ტესტი:

• „Before“ აფინანსებს მრავალ ანგარიშს MassTransferTransaction-ის საშუალებით, ადგენს სკრიპტს და ავრცელებს მას ბლოკჩეინში.
• „შეიძლება ჩარიცხვა“ აგზავნის InvokeScriptTransaction-ს ქსელში, ააქტიურებს დეპოზიტის() ფუნქციას თითოეული ორი ანგარიშისთვის.
• „ვერ ამოღებს იმაზე მეტი, ვიდრე დეპონირებული იყო“ ტესტები, რომლითაც ვერავინ მოიპარავს სხვა ადამიანების ტოკენებს.
• „შეიძლება ჩარიცხვა“ ამოწმებს, რომ თანხები სწორად არის დამუშავებული.

ჩაატარეთ ტესტები Surfboard-დან და გააანალიზეთ შედეგები Waves Explorer-ში

ტესტის გასაშვებად, გაუშვით

surfboard test

თუ თქვენ გაქვთ მრავალი სკრიპტი (მაგალითად, გჭირდებათ ცალკე განლაგების სკრიპტი), შეგიძლიათ გაუშვათ

surfboard test my-scenario.js

Surfboard შეაგროვებს სატესტო ფაილებს ./test/ საქაღალდეში და გაუშვებს სკრიპტს კვანძზე, რომელიც კონფიგურირებულია surfboard.config.json-ში. რამდენიმე წამის შემდეგ დაინახავთ მსგავს რაღაცას:

wallet test suite
Generating accounts with nonce: ce8d86ee
Account generated: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Account generated: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Account generated: wallet#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Accounts successfully funded
Script has been set
   √ Can deposit (4385ms)
   √ Cannot withdraw more than was deposited
   √ Can withdraw (108ms)
3 passing (15s)

ჰოო! ტესტები ჩააბარა. ახლა მოდით შევხედოთ რა ხდება Waves Explorer-ის გამოყენებისას: შეხედეთ ბლოკებს ან ჩასვით ზემოთ მოცემული ერთ-ერთი მისამართი ძიებაში (მაგალითად, შესაბამისი wallet#. აქ შეგიძლიათ იპოვოთ ტრანზაქციის ისტორია, dApp სტატუსი, დეკომპილირებული ბინარული ფაილი.

Waves Explorer. აპლიკაცია, რომელიც ახლახან განლაგდა.

სერფინგის დაფის რამდენიმე რჩევა:

1. ტესტის ქსელის გარემოში შესამოწმებლად გამოიყენეთ:

surfboard test --env=testnet

მიიღეთ ტესტის ნიშნები

2. თუ გსურთ იხილოთ ტრანზაქციების JSON ვერსიები და როგორ მუშავდება ისინი კვანძის მიერ, ჩაატარეთ ტესტი -v-ით (იგულისხმება „სიტყვიერი“):

surfboard test -v

აპლიკაციების გამოყენება Waves Keeper-ით

1. დააყენეთ Waves Keeper სამუშაოდ: http://localhost:6869

Waves Keeper-ის დაყენება ადგილობრივ კვანძთან მუშაობისთვის

2. იმპორტირებული საიდუმლო ფრაზა ტოკენებით ქსელისთვის? სიმარტივისთვის გამოიყენეთ თქვენი კვანძის საწყისი თესლი: waves private node seed with waves tokens. მისამართი: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. თქვენ შეგიძლიათ გაუშვათ სერვერის გარეშე ერთი გვერდიანი აპლიკაცია npm-ის გამოყენებით. ან გადადით არსებულზე: chrome-ext.wvservices.com/dapp-wallet.html

4. შეიყვანეთ საფულის მისამართი სატესტო გაშვებიდან (ზემოთ ხაზგასმული) dApp მისამართის ტექსტურ ველში

5. „დეპოზიტის“ ველში შეიყვანეთ მცირე თანხა და დააჭირეთ ღილაკს:

Waves Keeper ითხოვს ნებართვას ხელი მოაწეროს InvokeScriptTransaction-ს 10 WAVES გადახდით.

6. დაადასტურეთ გარიგება:

ტრანზაქცია იქმნება და გადაიცემა ქსელში. ახლა თქვენ შეგიძლიათ ნახოთ მისი პირადობის მოწმობა

7. ტრანზაქციის მონიტორინგი Waves Explorer-ის გამოყენებით. შეიყვანეთ ID საძიებო ველში

დასკვნები და დამატებითი ინფორმაცია

ჩვენ გადავხედეთ ინსტრუმენტებს Waves პლატფორმაზე მარტივი dApps-ის შემუშავების, ტესტირების, განლაგებისა და გამოყენებისთვის:

• RIDE ენა
• VS კოდების რედაქტორი
• Waves Explorer
• Surfboard
• ტალღების მეკარე

ლინკები მათთვის, ვისაც სურს გააგრძელოს RIDE-ს სწავლა:

მეტი მაგალითები
ონლაინ IDE მაგალითებით
ტალღების დოკუმენტაცია
დეველოპერის ჩატი Telegram-ში
Waves და RIDE on stackoverflow
ახალი! ონლაინ კურსები Waves პლატფორმაზე dApps-ის შექმნის შესახებ

განაგრძეთ ჩაძირვა RIDE თემაში და შექმენით თქვენი პირველი dApp!

TL; DR: bit.ly/2YCFnwY

წყარო: www.habr.com