כיצד לבנות, לפרוס ולבדוק Waves RIDE dApp

שלום! במאמר זה אראה לכם כיצד לכתוב ולהפעיל dApp רגיל על צומת Waves. בואו נסתכל על הכלים, השיטות הדרושים ודוגמה לפיתוח.

ערכת הפיתוח עבור dApps ויישומים רגילים כמעט זהה:

• כתיבת קוד
• כתיבת בדיקות אוטומטיות
• הפעלת האפליקציה
• בדיקה

כלי עבודה

1. docker כדי להפעיל את הצומת ואת Waves Explorer

אם אינך רוצה להתחיל צומת, תוכל לדלג על שלב זה. הרי יש רשת בדיקה וניסוי. אבל מבלי לפרוס את הצומת שלך, תהליך הבדיקה עשוי להימשך.

• תצטרך כל הזמן חשבונות חדשים עם אסימוני בדיקה. ברז רשת הבדיקה מעביר 10 WAVES כל 10 דקות.
• זמן החסימה הממוצע ברשת הבדיקה הוא דקה אחת, בצומת - 1 שניות. הדבר בולט במיוחד כאשר עסקה דורשת אישורים מרובים.
• מטמון אגרסיבי אפשרי בצמתי בדיקה ציבוריים.
• ייתכן שהם גם לא יהיו זמינים זמנית עקב תחזוקה.

מעתה ואילך אניח שאתה עובד עם הצומת שלך.

2. כלי שורת הפקודה של גלשן

• הורד והתקן את Node.js באמצעות ppa, homebrew או exe כאן: https://nodejs.org/en/download/.
• התקן את Surfboard, כלי המאפשר לך להריץ בדיקות על צומת קיים.

npm install -g @waves/surfboard

3. תוסף Visual Studio Code

שלב זה הוא אופציונלי אם אינך חובב IDEs ומעדיף עורכי טקסט. כל הכלים הדרושים הם כלי עזר של שורת הפקודה. אם אתה משתמש ב-vim, שימו לב לפלאגין vim-ride.

הורד והתקן Visual Studio Code: https://code.visualstudio.com/

פתח את קוד VS והתקן את הפלאגין 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 init

הפקודה מאתחלת ספרייה עם מבנה הפרויקט, יישומי "שלום עולם" ובדיקות. אם תפתח תיקיה זו עם קוד VS, תראה:

Surfboard.config.json

• מתחת לתיקיה ./ride/ תמצא קובץ בודד wallet.ride - הספרייה שבה נמצא קוד dApp. ננתח בקצרה dApps בבלוק הבא.
• תחת התיקיה ./test/ תמצא קובץ *.js. בדיקות מאוחסנות כאן.
• ./surfboard.config.json – קובץ תצורה להפעלת בדיקות.

Envs הוא קטע חשוב. כל סביבה מוגדרת כך:

• נקודת קצה REST API של הצומת שתשמש להפעלת ה-dApp ו-CHAIN_ID של הרשת.
• ביטוי סודי לחשבון עם אסימונים שיהיו המקורות לאסימוני הבדיקה שלך.

כפי שאתה יכול לראות, surfboard.config.json תומך במספר סביבות כברירת מחדל. ברירת המחדל היא הסביבה המקומית (מקש defaultEnv הוא פרמטר שניתן לשינוי).

אפליקציית ארנק הדגמה

סעיף זה אינו התייחסות לשפת RIDE. במקום זאת, הסתכל על האפליקציה שאנו פורסים ובודקים כדי להבין טוב יותר מה קורה בבלוקצ'יין.

בואו נסתכל על יישום פשוט להדגמה של ארנק. כל אחד יכול לשלוח אסימונים לכתובת dApp. אתה יכול רק למשוך את ה-WAVES שלך. שתי פונקציות @Callable זמינות באמצעות InvokeScriptTransaction:

• deposit()מה שמצריך תשלום מצורף ב-WAVES
• withdraw(amount: Int)מה שמחזיר אסימונים

לאורך מחזור החיים של dApp, המבנה (כתובת ← כמות) יישמר:

פעולה
המצב המתקבל

בתחילה
ריק

אליס מפקידה 5 גלים
alice-address → 500000000

בוב מפקיד 2 גלים

alice-address → 500000000
bob-address → 200000000

בוב מושך 7 גלים
נדחה!

אליס מושכת 4 גלים
alice-address → 100000000
bob-address → 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 תומך בהידור רציף בזמן עריכת קובץ. לכן, אתה תמיד יכול לעקוב אחר שגיאות בלשונית בעיות.

אם ברצונך להשתמש בעורך טקסט אחר בעת הידור הקובץ, השתמש

surfboard compile ride/wallet.ride

זה יוציא סדרה של קוד RIDE מהידור base64.

סקריפט בדיקה עבור 'wallet.ride'

בוא נסתכל על קובץ בדיקה. מופעל על ידי מסגרת Mocha של JavaScript. יש פונקציה "לפני" ושלוש בדיקות:

• "לפני" מממן מספר חשבונות באמצעות MassTransferTransaction, מרכיב את הסקריפט ופורס אותו לבלוקצ'יין.
• "יכול להפקיד" שולח InvokeScriptTransaction לרשת, מפעיל את הפונקציה deposit() עבור כל אחד משני החשבונות.
• "לא יכול למשוך יותר ממה שהופקד" בדיקות שאף אחד לא יכול לגנוב אסימונים של אנשים אחרים.
• "יכול להפקיד" בודקת שהמשיכות מעובדות כהלכה.

הפעל בדיקות מ-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, קובץ בינארי מפורק.

גלים סייר. אפליקציה שזה עתה נפרסה.

כמה טיפים לגלשן:

1. כדי לבדוק בסביבת testnet, השתמש ב:

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. הזן מזהה בשדה החיפוש

מסקנות ומידע נוסף

בדקנו את הכלים לפיתוח, בדיקה, פריסה ושימוש ב-dApps פשוטים בפלטפורמת Waves:

• שפת RIDE
• עורך קוד VS
• גלים סייר
• גלשן
• שומר גלים

קישורים למי שרוצה להמשיך ללמוד RIDE:

דוגמאות נוספות
IDE מקוון עם דוגמאות
תיעוד גלים
צ'אט למפתחים בטלגרם
גלים ורכיבה על סטאק-overflow
חָדָשׁ! קורסים מקוונים ליצירת dApps בפלטפורמת Waves

המשך לצלול לנושא RIDE וצור את ה-dApp הראשון שלך!

TL; DR: bit.ly/2YCFnwY

מקור: www.habr.com