ღია კოდის დეცენტრალიზებული შვილობილი პროგრამა Waves ბლოკჩეინზე

Waves ბლოკჩეინზე დაფუძნებული დეცენტრალიზებული შვილობილი პროგრამა, რომელიც განხორციელებულია Waves Labs-ის გრანტის ფარგლებში Bettex-ის გუნდის მიერ.

პოსტი არ არის დაფინანსებული! პროგრამა არის ღია, მისი გამოყენება და გავრცელება უფასოა. პროგრამის გამოყენება ასტიმულირებს dApp აპლიკაციების განვითარებას და, ზოგადად, ხელს უწყობს დეცენტრალიზაციას, რაც მომგებიანია ქსელის ყველა მომხმარებლისთვის.

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

ფუნქციონალური თვალსაზრისით ეს არის ჩვეულებრივი შვილობილი სისტემა, რომელიც ახორციელებს რეფერერთან რეგისტრაციას, რეფერალებისთვის ანაზღაურების მრავალდონიანი დარიცხვისა და სისტემაში რეგისტრაციის მოტივაციას (ქეშბექი). სისტემა არის „სუფთა“ dApp, ანუ ვებ აპლიკაცია უშუალოდ ურთიერთქმედებს ბლოკჩეინთან, საკუთარი ბექენდის, მონაცემთა ბაზის და ა.შ.

გამოიყენება ტექნიკები, რომლებიც ასევე შეიძლება სასარგებლო იყოს ბევრ სხვა პროექტში:

• სმარტ ანგარიშზე დარეკვა კრედიტით დაუყონებლივ დაფარვით (ზარის დროს ანგარიშზე არ არის ტოკენები ზარის გადასახდელად, მაგრამ ისინი იქ ჩნდება ზარის შედეგად).
• PoW-captcha - დაცვა ჭკვიანი ანგარიშის ფუნქციების მაღალი სიხშირის ავტომატური გამოძახებისგან - captcha-ს მსგავსი, მაგრამ გამოთვლითი რესურსების გამოყენების მტკიცებულებით.
• მონაცემთა გასაღებების მოთხოვნა შაბლონის მიხედვით.

განაცხადი შედგება:

• სმარტ ანგარიშის კოდი ride4dapps ენაზე (რომელიც, როგორც დაგეგმილია, გაერთიანებულია მთავარ სმარტ ანგარიშში, რისთვისაც საჭიროა შვილობილი ფუნქციის დანერგვა);
• js wrapper, რომელიც ახორციელებს აბსტრაქციის ფენას 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-ს იდეა ახალი არ არის და უკვე განხორციელდა სხვადასხვა პროექტებში, მათ შორის WAVES-ზე დაფუძნებულ პროექტებში. იდეის აზრი იმაში მდგომარეობს, რომ იმ მოქმედების შესასრულებლად, რომელიც ხარჯავს ჩვენი პროექტის რესურსებს, აბონენტმა ასევე უნდა დახარჯოს საკუთარი რესურსები, რაც რესურსების ამოწურვის შეტევას საკმაოდ ძვირად აქცევს. ძალიან მარტივი და იაფი ვალიდაციისთვის, რომ ტრანზაქციის გამგზავნმა გადაჭრა PoW პრობლემა, არის ტრანზაქციის ID შემოწმება:

თუ take(toBase58String(i.transactionId), 3) != „123“ მაშინ გადააგდე („სამუშაოს დადასტურება ვერ მოხერხდა“) სხვა

ტრანზაქციის განსახორციელებლად, აბონენტმა უნდა აირჩიოს ისეთი პარამეტრები, რომ მისი საბაზისო კოდი (id) დაიწყოს 58 რიცხვებით, რაც შეესაბამება საშუალოდ რამდენიმე ათეულ წამს პროცესორის დროს და ზოგადად გონივრული იყოს ჩვენი ამოცანისთვის. თუ საჭიროა უფრო მარტივი ან რთული PoW, მაშინ ამოცანა შეიძლება ადვილად შეიცვალოს აშკარა გზით.

მოითხოვეთ მონაცემთა გასაღებები შაბლონის მიხედვით

იმისათვის, რომ გამოიყენოთ ბლოკჩეინი, როგორც მონაცემთა ბაზა, სასიცოცხლოდ მნიშვნელოვანია გქონდეთ API ინსტრუმენტები მონაცემთა ბაზის შეკითხვისთვის, როგორც key-val შაბლონების გამოყენებით. ასეთი ხელსაწყოების ნაკრები გამოჩნდა 2019 წლის ივლისის დასაწყისში, როგორც პარამეტრი მატჩები REST API მოთხოვნით /მისამართები/მონაცემები?matches=regexp. ახლა, თუ ჩვენ გვჭირდება ერთზე მეტი გასაღების მიღება და არა ყველა გასაღების ერთდროულად ვებ აპლიკაციიდან, არამედ მხოლოდ ზოგიერთი ჯგუფის, მაშინ ჩვენ შეგვიძლია გავაკეთოთ არჩევანი გასაღების სახელით. მაგალითად, ამ პროექტში გატანის ტრანზაქციები დაშიფრულია როგორც

withdraw_${userAddress}_${txid}

რომელიც საშუალებას გაძლევთ მიიღოთ ტრანზაქციების სია ნებისმიერი მოცემული მისამართისთვის თანხის ამოღებისთვის შაბლონის გამოყენებით:

?matches=withdraw_${userAddress}_.*

ახლა მოდით გავაანალიზოთ მზა ხსნარის კომპონენტები.

vuejs კოდი

კოდი სამუშაო დემო ვერსიაა, რეალურ პროექტთან ახლოს. ის ახორციელებს შესვლას Waves Keeper-ის მეშვეობით და მუშაობს affiliate.js ბიბლიოთეკასთან, რომლის დახმარებით სისტემაში არეგისტრირებს მომხმარებელს, იკითხავს ტრანზაქციის მონაცემებს და ასევე გაძლევთ საშუალებას გამოიტანოთ მიღებული თანხები მომხმარებლის ანგარიშზე.

კოდი RIDE-ზე

შედგება რეგისტრაციის, დაფინანსებისა და ამოღების ფუნქციებისგან.

რეგისტრაციის ფუნქცია სისტემაში არეგისტრირებს მომხმარებელს. მას აქვს ორი პარამეტრი: რეფერენტი (რეფერენტის მისამართი) და salt პარამეტრი, რომელიც არ გამოიყენება ფუნქციის კოდში, რომელიც საჭიროა ტრანზაქციის ID-ის შესარჩევად (PoW-captcha ამოცანა).

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

რეგისტრაციის ფუნქციის შედეგი არის ორი ჩანაწერი:

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

ეს საშუალებას აძლევს მოძებნოს წინ და უკან (ამ მომხმარებლის მითითება და ამ მომხმარებლის ყველა მიმართვა).

ფონდის ფუნქცია უფრო რეალური ფუნქციონირების განვითარების შაბლონია. წარმოდგენილ ფორმაში იღებს ტრანზაქციის შედეგად გადარიცხულ ყველა თანხას და ანაწილებს 1-ლი, მე-2, მე-3 დონის რეფერენტ ანგარიშებზე, "ქეშბექი" და "ცვლის" ანგარიშზე (ყველაფერი, რაც რჩება წინა დისტრიბუციის დროს. ანგარიშები აქ მოდის).

ქეშბექი არის საბოლოო მომხმარებლის წახალისების საშუალება რეფერალურ სისტემაში მონაწილეობის მისაღებად. სისტემის მიერ გადახდილი საკომისიო ნაწილი „ქეშბექი“-ს სახით მომხმარებელს შეუძლია გამოიტანოს ისევე, როგორც რეფერალებისთვის ჯილდო.

რეფერალური სისტემის გამოყენებისას ფონდის ფუნქცია უნდა იყოს მოდიფიცირებული, ჩაშენებული ჭკვიანი ანგარიშის ძირითად ლოგიკაში, რომელზეც სისტემა იმუშავებს. მაგალითად, თუ რეფერალური ჯილდო გადახდილია დადებული ფსონისთვის, მაშინ ფონდის ფუნქცია უნდა იყოს ჩაშენებული იმ ლოგიკაში, სადაც დადებულია ფსონი (ან შესრულებულია სხვა სამიზნე ქმედება, რისთვისაც ჯილდო გადახდილია). ამ ფუნქციაში კოდირებული რეფერალური ჯილდოს სამი დონეა. თუ გსურთ მეტ-ნაკლებად დონეების გაკეთება, მაშინ ეს ასევე შესწორებულია კოდში. ჯილდოს პროცენტი დგინდება 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

მეთოდების ფუნქციონირება აშკარაა სახელებიდან, პარამეტრები და დაბრუნების მონაცემები აღწერილია კოდში. რეგისტრის ფუნქცია მოითხოვს დამატებით კომენტარს - ის იწყებს ტრანზაქციის id შერჩევის ციკლს ისე, რომ იწყება 123-დან - ეს არის ზემოთ აღწერილი PoW captcha, რომელიც იცავს მასობრივი რეგისტრაციებისგან. ფუნქცია პოულობს ტრანზაქციას საჭირო id-ით და შემდეგ ხელს აწერს მას Waves Keeper-ის მეშვეობით.

DEX შვილობილი პროგრამა ხელმისაწვდომია საიტზე GitHub.com.

წყარო: www.habr.com