កម្មវិធីសម្ព័ន្ធប្រភពបើកចំហរវិមជ្ឈការនៅលើ Waves blockchain

កម្មវិធីសម្ព័ន្ធវិមជ្ឈការនៅលើ Waves blockchain ដែលត្រូវបានអនុវត្តជាផ្នែកមួយនៃជំនួយឥតសំណងរបស់ Waves Labs ដោយក្រុម Betex ។

ប្រកាសមិនមែនជាការផ្សាយពាណិជ្ជកម្មទេ។! កម្មវិធីនេះគឺជាប្រភពបើកចំហ ការប្រើប្រាស់ និងការចែកចាយរបស់វាគឺមិនគិតថ្លៃទេ។ ការប្រើប្រាស់កម្មវិធីជំរុញការអភិវឌ្ឍន៍កម្មវិធី dApp ហើយជាទូទៅលើកកម្ពស់វិមជ្ឈការ ដែលផ្តល់អត្ថប្រយោជន៍ដល់អ្នកប្រើប្រាស់អ៊ីនធឺណិតគ្រប់រូប។

dApp ដែលបានបង្ហាញសម្រាប់កម្មវិធីសម្ព័ន្ធគឺជាគំរូសម្រាប់គម្រោងដែលរួមបញ្ចូលសម្ព័ន្ធភាពជាផ្នែកនៃមុខងាររបស់ពួកគេ។ កូដអាចត្រូវបានប្រើជាគំរូសម្រាប់ការចម្លង ជាបណ្ណាល័យ ឬជាសំណុំនៃគំនិតសម្រាប់ការអនុវត្តបច្ចេកទេស។

នៅក្នុងលក្ខខណ្ឌនៃមុខងារ នេះគឺជាប្រព័ន្ធសាខាធម្មតាដែលអនុវត្តការចុះឈ្មោះជាមួយអ្នកបញ្ជូន ការបង្កើនរង្វាន់ច្រើនកម្រិតសម្រាប់ការបញ្ជូន និងការលើកទឹកចិត្តសម្រាប់ការចុះឈ្មោះក្នុងប្រព័ន្ធ (សាច់ប្រាក់ត្រឡប់មកវិញ)។ ប្រព័ន្ធនេះគឺជា dApp "សុទ្ធ" ពោលគឺកម្មវិធីបណ្តាញធ្វើអន្តរកម្មដោយផ្ទាល់ជាមួយ blockchain ដោយមិនចាំបាច់មាន backend ផ្ទាល់ខ្លួន មូលដ្ឋានទិន្នន័យ។ល។

បច្ចេកទេសដែលបានប្រើដែលអាចមានប្រយោជន៍ក្នុងគម្រោងផ្សេងទៀតជាច្រើន៖

• ការហៅគណនីឆ្លាតវៃទៅក្នុងបំណុលជាមួយនឹងការសងភ្លាមៗ (នៅពេលនៃការហៅទូរស័ព្ទមិនមានសញ្ញាសម្ងាត់នៅលើគណនីដែលត្រូវបង់សម្រាប់ការហៅនោះទេ ប៉ុន្តែពួកគេលេចឡើងនៅទីនោះ ជាលទ្ធផលនៃការហៅទូរស័ព្ទ) ។
• PoW-captcha - ការការពារប្រឆាំងនឹងការហៅដោយស្វ័យប្រវត្តិដែលមានប្រេកង់ខ្ពស់ទៅកាន់មុខងារគណនីឆ្លាតវៃ - ស្រដៀងទៅនឹង captcha ប៉ុន្តែតាមរយៈភស្តុតាងនៃការប្រើប្រាស់ធនធានកុំព្យូទ័រ។
• សំណួរសម្រាប់សោទិន្នន័យដោយប្រើគំរូ។

កម្មវិធីរួមមានៈ

• លេខកូដគណនីឆ្លាតវៃជាភាសា ride4dapps (ដែលតាមការគ្រោងទុក ត្រូវបានដាក់បញ្ចូលទៅក្នុងគណនីឆ្លាតវៃចម្បង ដែលមុខងារសម្ព័ន្ធត្រូវអនុវត្ត);
• js wrapper ដែលអនុវត្តកម្រិត abstraction លើ WAVES NODE REST API;
• code នៅលើ vuejs framework ដែលជាឧទាហរណ៍នៃការប្រើប្រាស់បណ្ណាល័យ និងកូដ RIDE ។

ចូរ​យើង​ពណ៌នា​អំពី​លក្ខណៈ​ពិសេស​ទាំងអស់​ដែល​បាន​រាយ​បញ្ជី។

ហៅគណនីឆ្លាតវៃសម្រាប់បំណុលជាមួយនឹងការសងភ្លាមៗ

ការហៅទៅកាន់ InvokeScript ទាមទារការទូទាត់ថ្លៃសេវាពីគណនីដែលចាប់ផ្តើមប្រតិបត្តិការ។ នេះមិនមែនជាបញ្ហាទេ ប្រសិនបើអ្នកកំពុងបង្កើតគម្រោងសម្រាប់ blockchain geeks ដែលមានចំនួនជាក់លាក់នៃ WAVES tokens នៅក្នុងគណនីរបស់ពួកគេ ប៉ុន្តែប្រសិនបើផលិតផលនេះមានគោលបំណងប្រើប្រាស់ដោយសាធារណជនទូទៅ វានឹងក្លាយជាបញ្ហាធ្ងន់ធ្ងរ។ យ៉ាងណាមិញ អ្នកប្រើប្រាស់ត្រូវតែយកចិត្តទុកដាក់លើការទិញ WAVES tokens (ឬទ្រព្យសម្បត្តិសមរម្យផ្សេងទៀតដែលអាចប្រើដើម្បីទូទាត់សម្រាប់ប្រតិបត្តិការ) ដែលបង្កើនរបាំងសន្ធឹកសន្ធាប់ក្នុងការចូលទៅក្នុងគម្រោង។ យើងអាចចែកចាយទ្រព្យសកម្មមួយដល់អ្នកប្រើប្រាស់ដែលនឹងអាចបង់ប្រាក់សម្រាប់ប្រតិបត្តិការ និងប្រឈមមុខនឹងហានិភ័យនៃការប្រើប្រាស់ខុសរបស់ពួកគេ នៅពេលដែលប្រព័ន្ធស្វ័យប្រវត្តិត្រូវបានបង្កើតឡើង ដើម្បីបូមយកទ្រព្យសកម្មរាវចេញពីប្រព័ន្ធរបស់យើង។

វានឹងមានភាពងាយស្រួលប្រសិនបើអាចហៅទៅ 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 មានការពិនិត្យលេខសម្គាល់ប្រតិបត្តិការ៖

ប្រសិនបើ take(toBase58String(i.transactionId), 3) != "123" បន្ទាប់មកបោះ("ភស្តុតាងនៃការងារបានបរាជ័យ") ផ្សេងទៀត

ដើម្បីអនុវត្តប្រតិបត្តិការ អ្នកហៅចូលត្រូវតែជ្រើសរើសប៉ារ៉ាម៉ែត្របែបនេះ ដូច្នេះលេខកូដ base58 (id) របស់វាចាប់ផ្តើមដោយលេខ 123 ដែលត្រូវនឹងជាមធ្យមពីរបីដប់វិនាទីនៃពេលវេលាដំណើរការ ហើយជាទូទៅសមហេតុផលសម្រាប់កិច្ចការរបស់យើង។ ប្រសិនបើ PoW សាមញ្ញជាង ឬស្មុគ្រស្មាញច្រើនត្រូវបានទាមទារ នោះភារកិច្ចអាចត្រូវបានកែប្រែយ៉ាងងាយស្រួលតាមវិធីជាក់ស្តែង។

សំណួរសម្រាប់សោទិន្នន័យដោយប្រើគំរូ

ដើម្បីប្រើ blockchain ជាមូលដ្ឋានទិន្នន័យ វាមានសារៈសំខាន់ណាស់ក្នុងការមានឧបករណ៍ API សម្រាប់ការសាកសួរមូលដ្ឋានទិន្នន័យជា key-val ដោយផ្អែកលើគំរូ។ កញ្ចប់ឧបករណ៍បែបនេះបានបង្ហាញខ្លួននៅដើមខែកក្កដា ឆ្នាំ 2019 ក្នុងទម្រង់ជាប៉ារ៉ាម៉ែត្រ ?ការប្រកួត តាមសំណើ REST API /addresses/data?match=regexp. ឥឡូវនេះ ប្រសិនបើយើងត្រូវការយកកូនសោច្រើនជាងមួយពីកម្មវិធីគេហទំព័រ ហើយមិនមែនគ្រប់សោទាំងអស់ក្នុងពេលតែមួយនោះទេ ប៉ុន្តែមានតែក្រុមមួយចំនួនប៉ុណ្ណោះ នោះយើងអាចធ្វើការជ្រើសរើសតាមឈ្មោះគន្លឹះ។ ឧទាហរណ៍ នៅក្នុងគម្រោងនេះ ប្រតិបត្តិការដកប្រាក់ត្រូវបានអ៊ិនកូដជា

withdraw_${userAddress}_${txid}

ដែលអនុញ្ញាតឱ្យអ្នកទទួលបានបញ្ជីប្រតិបត្តិការសម្រាប់ការដកប្រាក់សម្រាប់អាសយដ្ឋានដែលបានផ្តល់ឱ្យណាមួយដោយប្រើគំរូ៖

?matches=withdraw_${userAddress}_.*

ឥឡូវនេះសូមក្រឡេកមើលសមាសធាតុនៃដំណោះស្រាយដែលបានបញ្ចប់។

កូដ Vuejs

កូដគឺជាការបង្ហាញដែលធ្វើការនៅជិតគម្រោងពិត។ វាអនុវត្តការចូលតាមរយៈ Waves Keeper និងធ្វើការជាមួយបណ្ណាល័យ affiliate.js ដែលវាចុះឈ្មោះអ្នកប្រើប្រាស់នៅក្នុងប្រព័ន្ធ សាកសួរទិន្នន័យប្រតិបត្តិការ និងអនុញ្ញាតឱ្យអ្នកដកប្រាក់ដែលរកបានទៅគណនីរបស់អ្នកប្រើប្រាស់ផងដែរ។

កូដសម្រាប់ RIDE

មានមុខងារចុះឈ្មោះ មូលនិធិ និងដកប្រាក់។

មុខងារចុះឈ្មោះចុះឈ្មោះអ្នកប្រើប្រាស់នៅលើប្រព័ន្ធ។ វាមានប៉ារ៉ាម៉ែត្រពីរ៖ referer (អាសយដ្ឋានយោង) និងប៉ារ៉ាម៉ែត្រអំបិលដែលមិនត្រូវបានប្រើនៅក្នុងកូដមុខងារដែលត្រូវការដើម្បីជ្រើសរើសលេខសម្គាល់ប្រតិបត្តិការ (ភារកិច្ច PoW-captcha) ។

មុខងារ (ដូចជាមុខងារផ្សេងទៀតពីគម្រោងនេះ) ប្រើបច្ចេកទេសហៅបំណុល លទ្ធផលនៃមុខងារគឺផ្តល់ហិរញ្ញប្បទានដល់ការទូទាត់ថ្លៃសេវាសម្រាប់ការហៅមុខងារនេះ។ សូមអរគុណចំពោះដំណោះស្រាយនេះ អ្នកប្រើប្រាស់ដែលទើបតែបង្កើតកាបូបអាចធ្វើការភ្លាមៗជាមួយប្រព័ន្ធ ហើយមិនចាំបាច់ព្រួយបារម្ភអំពីការទិញ ឬទទួលបានទ្រព្យសម្បត្តិដែលអនុញ្ញាតឱ្យគាត់បង់ថ្លៃប្រតិបត្តិការ។

លទ្ធផលនៃមុខងារចុះឈ្មោះគឺកំណត់ត្រាពីរ៖

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

នេះអនុញ្ញាតឱ្យមានការស្វែងរកទៅមុខ និងបញ្ច្រាស (អ្នកបញ្ជូនអ្នកប្រើប្រាស់ដែលបានផ្តល់ឱ្យ និងការបញ្ជូនទាំងអស់របស់អ្នកប្រើប្រាស់ដែលបានផ្តល់ឱ្យ)។

មុខងារមូលនិធិគឺជាគំរូសម្រាប់ការអភិវឌ្ឍមុខងារជាក់ស្តែង។ នៅក្នុងទម្រង់បង្ហាញរបស់វា វាយកថវិកាទាំងអស់ដែលបានផ្ទេរដោយប្រតិបត្តិការ ហើយចែកចាយវាទៅគណនីរបស់អ្នកបញ្ជូនកម្រិត 1, 2, 3 ទៅគណនី "ដកប្រាក់" និងគណនី "ផ្លាស់ប្តូរ" (អ្វីគ្រប់យ៉ាងដែលនៅសេសសល់នៅពេលចែកចាយទៅមុន គណនីនៅទីនេះ) ។

Cashback គឺជាមធ្យោបាយនៃការលើកទឹកចិត្តអ្នកប្រើប្រាស់ចុងក្រោយឱ្យចូលរួមក្នុងប្រព័ន្ធបញ្ជូន។ អ្នកប្រើប្រាស់អាចដកផ្នែកនៃកម្រៃជើងសារដែលបង់ដោយប្រព័ន្ធក្នុងទម្រង់ជា “សាច់ប្រាក់វិញ” តាមរបៀបដូចគ្នានឹងរង្វាន់សម្រាប់ការបញ្ជូនបន្ត។

នៅពេលប្រើប្រព័ន្ធបញ្ជូន មុខងារមូលនិធិគួរតែត្រូវបានកែប្រែ និងបញ្ចូលទៅក្នុងតក្កវិជ្ជាចម្បងនៃគណនីឆ្លាតវៃដែលប្រព័ន្ធនឹងដំណើរការ។ ឧទាហរណ៍ ប្រសិនបើរង្វាន់បង្អែកត្រូវបានបង់សម្រាប់ការភ្នាល់ដែលធ្វើឡើង នោះមុខងារមូលនិធិគួរតែត្រូវបានបង្កើតឡើងតាមតក្កវិជ្ជាដែលការភ្នាល់ត្រូវបានដាក់ (ឬសកម្មភាពគោលដៅផ្សេងទៀតត្រូវបានអនុវត្តដែលរង្វាន់ត្រូវបានបង់)។ រង្វាន់យោងបីកម្រិតត្រូវបានសរសេរកូដទៅក្នុងមុខងារនេះ។ ប្រសិនបើអ្នកត្រូវការបង្កើតកម្រិតច្រើន ឬតិចជាងនេះ នោះក៏ត្រូវបានកែនៅក្នុងកូដផងដែរ។ ភាគរយរង្វាន់ត្រូវបានកំណត់ដោយកម្រិត 1 កម្រិត 3 នៅក្នុងកូដដែលវាត្រូវបានគណនា ចំនួន * កម្រិត / 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