תוכנית שותפים מבוזרת בקוד פתוח ב-Waves blockchain

תוכנית שותפים מבוזרת ב-Waves blockchain, המיושמת כחלק ממענק Waves Labs על ידי צוות Bettex.

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

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

מבחינת פונקציונליות, מדובר במערכת שותפים רגילה המיישמת רישום עם מפנה, צבירת תגמולים רב-שכבית להפניות והנעה לרישום במערכת (קאשבק). המערכת היא dApp "טהורה", כלומר, אפליקציית האינטרנט מקיימת אינטראקציה ישירה עם הבלוקצ'יין, ללא קצה אחורי משלה, מסד נתונים וכו'.

טכניקות בשימוש שיכולות להיות שימושיות גם בפרויקטים רבים אחרים:

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

הבקשה מורכבת מ:

• קוד חשבון חכם בשפת ride4dapps (אשר, כמתוכנן, מוזג לחשבון החכם הראשי שעבורו יש ליישם פונקציונליות שותפים);
• עטיפה js המיישמת רמת הפשטה על פני WAVES NODE REST API;
• קוד על המסגרת vuejs, שהיא דוגמה לשימוש בספרייה ובקוד RIDE.

הבה נתאר את כל התכונות המפורטות.

קריאה לחשבון חכם לחובות עם פירעון מיידי

קריאה ל-InvokeScript דורשת תשלום של עמלה מהחשבון שיזם את העסקה. זו לא בעיה אם אתה עושה פרויקט לגיקים של בלוקצ'יין שיש להם כמות מסוימת של אסימוני WAVES על חשבונם, אבל אם המוצר מכוון לשימוש על ידי הציבור הרחב, זה הופך לבעיה רצינית. הרי על המשתמש לדאוג לרכישת אסימוני WAVES (או נכס מתאים אחר שניתן להשתמש בו לתשלום עסקאות), מה שמגדיל את מחסום הכניסה הניכר ממילא לפרויקט. אנו יכולים להפיץ נכס למשתמשים שיוכלו לשלם עבור עסקאות ולהתמודד עם הסיכון של שימוש לרעה בהם כאשר נוצרות מערכות אוטומטיות לשאיבת נכס נזיל מהמערכת שלנו.

זה יהיה מאוד נוח אם אפשר היה לקרוא ל-InvokeScript "על חשבון הנמען" (החשבון החכם עליו מותקן הסקריפט), וקיימת אפשרות כזו, אם כי לא באופן ברור.

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

ScriptTransfer(i.caller, i.fee, unit)

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

func checkFee(i:Invocation) = {
if i.fee > maxFee then throw(“unreasonable large fee”) else
if i.feeAssetId != unit then throw(“fee must be in WAVES”) else true
}

כמו כן, כדי להגן מפני בזבוז כספים זדוני וחסר טעם, נדרשת הגנת שיחות אוטומטית (PoW-captcha).

PoW-captcha

עצם הרעיון של captcha הוכחת עבודה אינו חדש וכבר יושם בפרויקטים שונים, כולל אלו שיושמו על בסיס WAVES. הרעיון הוא שכדי לבצע פעולה שצורכת את המשאבים של הפרויקט שלנו, על המתקשר לבזבז גם את המשאבים שלו, מה שמייקר למדי התקפת דלדול משאבים. לאימות קלה מאוד ובעלות נמוכה ששולח העסקה פתר את בעיית PoW, יש בדיקת מזהה עסקה:

if take(toBase58String(i.transactionId), 3) != "123" then throw("הוכחת עבודה נכשלה") else

על מנת לבצע עסקה, על המתקשר לבחור פרמטרים כאלה כך שקוד ה-base58 (id) שלו יתחיל במספרים 123, המתאים בממוצע לכמה עשרות שניות של זמן מעבד ובדרך כלל סביר למשימה שלנו. אם נדרש PoW פשוט יותר או מורכב יותר, ניתן לשנות את המשימה בקלות בצורה ברורה.

שאילתה למפתחות נתונים באמצעות תבנית

על מנת להשתמש בבלוקצ'יין כמסד נתונים, חיוני שיהיו כלי API לשאילתת מסד הנתונים כמפתחות המבוססים על תבניות. ערכת כלים כזו הופיעה בתחילת יולי 2019 בצורת פרמטר ?התאמות בבקשת REST API /addresses/data?matches=regexp. כעת, אם אנחנו צריכים לקבל יותר ממפתח אחד מאפליקציית אינטרנט ולא את כל המפתחות בבת אחת, אלא רק קבוצה כלשהי, אז נוכל לבחור לפי שם מפתח. לדוגמה, בפרויקט זה, עסקאות משיכה מקודדות כ

withdraw_${userAddress}_${txid}

המאפשר לך לקבל רשימה של עסקאות למשיכת כספים עבור כל כתובת נתונה באמצעות התבנית:

?matches=withdraw_${userAddress}_.*

עכשיו בואו נסתכל על המרכיבים של הפתרון המוגמר.

קוד Vuejs

הקוד הוא הדגמה עובדת קרובה לפרויקט האמיתי. הוא מיישם כניסה דרך Waves Keeper ועובד עם ספריית affiliate.js, איתה הוא רושם את המשתמש במערכת, מבצע שאילתות בנתוני עסקאות, וגם מאפשר לך למשוך כספים שהרוויחו לחשבון המשתמש.

קוד עבור RIDE

מורכב מפונקציות הרישום, המימון והמשיכה.

פונקציית הרישום רושמת משתמש במערכת. יש לו שני פרמטרים: מפנה (כתובת מפנה) ופרמטר salt, שאינו בשימוש בקוד הפונקציה, הדרוש לבחירת מזהה העסקה (משימה PoW-captcha).

הפונקציה (כמו פונקציות אחרות מפרויקט זה) משתמשת בטכניקת ה-debt call, התוצאה של הפונקציה היא מימון תשלום עמלה עבור קריאת פונקציה זו. הודות לפתרון זה, משתמש שזה עתה יצר ארנק יכול לעבוד מיד עם המערכת ואינו צריך לדאוג לרכישה או קבלת נכס המאפשר לו לשלם עמלת עסקה.

התוצאה של פונקציית הרישום היא שתי רשומות:

${owner)_referer = referer
${referer}_referral_${owner} = owner

זה מאפשר חיפוש קדימה ואחורה (המפנה של משתמש נתון וכל ההפניות של משתמש נתון).

פונקציית הקרן היא יותר תבנית לפיתוח פונקציונליות אמיתית. במתכונתו המוצגת, היא לוקחת את כל הכספים שהועברו בעסקה ומחלקה אותם לחשבונות של מפנים מדרגות 1, 2, 3, לחשבון ה"קאשבק" ולחשבון ה"שינוי" (כל מה שנשאר בחלוקה לקודמים). חשבונות נכנסים לכאן).

Cashback הוא אמצעי להנעת משתמש הקצה להשתתף במערכת הפניות. המשתמש יכול למשוך את חלק העמלה ששולם על ידי המערכת בצורה של "קאשבק" באותו אופן כמו תגמולים עבור הפניות.

בעת שימוש במערכת הפניות, יש לשנות את פונקציית הקרן ולשלב אותה בהיגיון הראשי של החשבון החכם עליו תעבוד המערכת. לדוגמה, אם משולם תגמול הפניה עבור הימור שבוצע, אזי פונקציית הקרן צריכה להיות מובנית בלוגיקה שבה מבצעים את ההימור (או מבוצעת פעולה ממוקדת אחרת שעבורה משולם התגמול). שלוש רמות של תגמולי הפניה מקודדות בפונקציה זו. אם אתה צריך לעשות יותר או פחות רמות, זה גם מתוקן בקוד. אחוז התגמול נקבע על ידי הקבועים level1-level3; בקוד הוא מחושב כ כמות * רמה / 1000, כלומר, הערך 1 מתאים ל-0,1% (ניתן לשנות זאת גם בקוד).

קריאה לפונקציה משנה את יתרת החשבון וגם יוצרת ערכים למטרות רישום של הטופס:

fund_address_txid = address:owner:inc:level:timestamp
Для получения timestamp (текущего времени) используется такая вот связка
func getTimestamp() = {
let block = extract(blockInfoByHeight(height))
toString(block.timestamp)
}

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

# withdraw log: withdraw_user_txid=amount:timestamp

יישום

החלק העיקרי של האפליקציה הוא ספריית affiliate.js, המהווה גשר בין מודלים של שותפים ל-WAVES NODE REST API. מיישמת רמת הפשטה בלתי תלויה במסגרת (ניתן להשתמש בכל אחת). פונקציות פעילות (רישום, נסיגה) מניחות ש-Waves Keeper מותקן במערכת; הספרייה עצמה לא בודקת זאת.

מיישם שיטות:

fetchReferralTransactions
fetchWithdrawTransactions
fetchMyBalance
fetchReferrals
fetchReferer
withdraw
register

הפונקציונליות של השיטות ברורה מהשמות; הפרמטרים והנתונים המוחזרים מתוארים בקוד. פונקציית הרישום דורשת הערות נוספות - היא מתחילה מחזור של בחירת מזהה העסקה כך שיתחיל ב-123 - זהו ה-PoW-captcha שתואר לעיל, שמגן מפני רישומים המוניים. הפונקציה מוצאת עסקה עם המזהה הנדרש, ולאחר מכן חותמת עליה דרך Waves Keeper.

תוכנית השותפים של DEX זמינה בכתובת GitHub.com.

מקור: www.habr.com