របៀបបង្កើត ដាក់ពង្រាយ និងសាកល្បងរលក RIDE dApp

សួស្តី! នៅក្នុងអត្ថបទនេះខ្ញុំនឹងបង្ហាញអ្នកពីរបៀបសរសេរ និងដំណើរការ dApp ធម្មតានៅលើថ្នាំង Waves ។ សូមក្រឡេកមើលឧបករណ៍ចាំបាច់ វិធីសាស្រ្ត និងឧទាហរណ៍នៃការអភិវឌ្ឍន៍។

គ្រោងការណ៍អភិវឌ្ឍន៍សម្រាប់ dApps និងកម្មវិធីធម្មតាគឺស្ទើរតែដូចគ្នា៖

• ការសរសេរកូដ
• ការសរសេរការធ្វើតេស្តស្វ័យប្រវត្តិ
• ការបើកដំណើរការកម្មវិធី
• ការធ្វើតេស្ត

ឧបករណ៍

1. docker ដើម្បីដំណើរការ node និង Waves Explorer

ប្រសិនបើអ្នកមិនចង់ចាប់ផ្តើមថ្នាំងទេ អ្នកអាចរំលងជំហាននេះ។ យ៉ាងណាមិញមានបណ្តាញសាកល្បងនិងពិសោធន៍។ ប៉ុន្តែ​ដោយ​គ្មាន​ការ​ដាក់​ពង្រាយ​ថ្នាំង​ផ្ទាល់​ខ្លួន​របស់​អ្នក​ទេ ដំណើរ​ការ​សាកល្បង​អាច​នឹង​អូស​បន្លាយ។

• អ្នកនឹងត្រូវការគណនីថ្មីជានិច្ចជាមួយនឹងសញ្ញាសម្ងាត់សាកល្បង។ faucet បណ្តាញសាកល្បងផ្ទេរ 10 WAVES រៀងរាល់ 10 នាទីម្តង។
• ពេលវេលាប្លុកជាមធ្យមនៅក្នុងបណ្តាញសាកល្បងគឺ 1 នាទីក្នុងថ្នាំង - 15 វិនាទី។ នេះគឺជាការកត់សម្គាល់ជាពិសេសនៅពេលដែលប្រតិបត្តិការទាមទារការបញ្ជាក់ច្រើន។
• ឃ្លាំងសម្ងាត់ឈ្លានពានគឺអាចធ្វើទៅបាននៅលើថ្នាំងសាកល្បងសាធារណៈ។
• ពួកគេក៏អាចមិនអាចប្រើបានជាបណ្ដោះអាសន្ន ដោយសារការថែទាំ។

ចាប់ពីពេលនេះតទៅ ខ្ញុំនឹងសន្មត់ថាអ្នកកំពុងធ្វើការជាមួយថ្នាំងផ្ទាល់ខ្លួនរបស់អ្នក។

2. ឧបករណ៍បន្ទាត់ពាក្យបញ្ជា Surfboard

• ទាញយក និងដំឡើង Node.js ដោយប្រើ ppa, homebrew ឬ exe នៅទីនេះ៖ https://nodejs.org/en/download/.
• ដំឡើង Surfboard ដែលជាឧបករណ៍ដែលអនុញ្ញាតឱ្យអ្នកដំណើរការការធ្វើតេស្តនៅលើថ្នាំងដែលមានស្រាប់។

npm install -g @waves/surfboard

3. កម្មវិធីជំនួយ Visual Studio Code

ជំហាននេះគឺស្រេចចិត្ត ប្រសិនបើអ្នកមិនមែនជាអ្នកគាំទ្រ IDEs ហើយចូលចិត្តអ្នកកែអត្ថបទ។ ឧបករណ៍ចាំបាច់ទាំងអស់គឺជាឧបករណ៍ប្រើប្រាស់បន្ទាត់ពាក្យបញ្ជា។ ប្រសិនបើអ្នកប្រើ vim សូមយកចិត្តទុកដាក់លើកម្មវិធីជំនួយ vim-ជិះ.

ទាញយក និងដំឡើង 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

ពាក្យបញ្ជាចាប់ផ្តើមថតជាមួយរចនាសម្ព័ន្ធគម្រោង កម្មវិធី និងការធ្វើតេស្ត "ជំរាបសួរពិភពលោក" ។ ប្រសិនបើអ្នកបើក Folder នេះដោយប្រើ 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 គឺជា​ប៉ារ៉ាម៉ែត្រ​ដែល​អាច​ផ្លាស់ប្តូរ​បាន)។

កម្មវិធី Wallet-demo

ផ្នែកនេះមិនមែនជាឯកសារយោងទៅភាសា RIDE ទេ។ ផ្ទុយទៅវិញ សូមក្រឡេកមើលកម្មវិធីដែលយើងដាក់ពង្រាយ និងសាកល្បង ដើម្បីយល់កាន់តែច្បាស់អំពីអ្វីដែលកំពុងកើតឡើងនៅក្នុង blockchain ។

សូមក្រឡេកមើលកម្មវិធី Wallet-demo ដ៏សាមញ្ញមួយ។ នរណាម្នាក់អាចផ្ញើសញ្ញាសម្ងាត់ទៅកាន់អាសយដ្ឋាន dApp ។ អ្នកអាចដក WAVES របស់អ្នកតែប៉ុណ្ណោះ។ មុខងារ @Callable ពីរមានតាមរយៈ InvokeScriptTransaction៖

• deposit()ដែលទាមទារការទូទាត់ភ្ជាប់ជាមួយ WAVES
• withdraw(amount: Int)ដែលត្រឡប់សញ្ញាសម្ងាត់

ពេញមួយវដ្តជីវិតរបស់ dApp រចនាសម្ព័ន្ធ (អាសយដ្ឋាន → ចំនួន) នឹងត្រូវបានរក្សាទុក៖

សកម្មភាព
ស្ថានភាពលទ្ធផល

ដំបូង
ទទេ

Alice ដាក់ប្រាក់ 5 WAVES
អាស័យដ្ឋាន alice → 500000000

Bob ដាក់ប្រាក់ 2 WAVES

អាស័យដ្ឋាន alice → 500000000
bob-អាសយដ្ឋាន → 200000000

លោក Bob ដក 7 WAVES
បដិសេធ!

អាលីសដក 4 WAVES
អាស័យដ្ឋាន alice → 100000000
bob-អាសយដ្ឋាន → 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 ចងក្រងស្គ្រីបហើយដាក់ពង្រាយវាទៅ blockchain ។
• “អាចដាក់ប្រាក់” ផ្ញើ 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 ឯកសារគោលពីរដែលបានបំបែក។

រលក Explorer ។ កម្មវិធី​ដែល​ទើប​តែ​ត្រូវ​បាន​ដាក់​ឱ្យ​ប្រើ។

គន្លឹះខ្លះៗសម្រាប់ Surfboard៖

1. ដើម្បីសាកល្បងនៅក្នុងបរិយាកាស testnet សូមប្រើ៖

surfboard test --env=testnet

ទទួលបាននិមិត្តសញ្ញាសាកល្បង

2. ប្រសិនបើអ្នកចង់ឃើញកំណែ JSON នៃប្រតិបត្តិការ និងរបៀបដែលពួកគេត្រូវបានដំណើរការដោយថ្នាំង សូមដំណើរការការសាកល្បងជាមួយ -v (មានន័យថា 'verbose'):

surfboard test -v

ការប្រើប្រាស់កម្មវិធីជាមួយ Waves Keeper

1. ដំឡើង Waves Keeper ដើម្បីធ្វើការ៖ http://localhost:6869

ការដំឡើង Waves Keeper ដើម្បីធ្វើការជាមួយថ្នាំងមូលដ្ឋាន

2. នាំចូលឃ្លាសម្ងាត់ជាមួយសញ្ញាសម្ងាត់សម្រាប់បណ្តាញ? សម្រាប់ភាពសាមញ្ញ ប្រើគ្រាប់ពូជដំបូងនៃថ្នាំងរបស់អ្នក៖ waves private node seed with waves tokens. អាស័យដ្ឋាន៖ 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. អ្នកអាចដំណើរការកម្មវិធី serverless single page ដោយខ្លួនឯងដោយប្រើ npm។ ឬចូលទៅកាន់កន្លែងដែលមានស្រាប់៖ chrome-ext.wvservices.com/dapp-wallet.html

4. បញ្ចូលអាសយដ្ឋានកាបូបពីដំណើរការសាកល្បង (គូសបន្ទាត់ពីខាងលើ) ទៅក្នុងប្រអប់អត្ថបទអាសយដ្ឋាន dApp

5. បញ្ចូលចំនួនតិចតួចនៅក្នុងវាល "ដាក់ប្រាក់" ហើយចុចប៊ូតុង:

Waves Keeper ស្នើសុំការអនុញ្ញាតដើម្បីចុះហត្ថលេខាលើ InvokeScriptTransaction ជាមួយនឹងការទូទាត់ 10 WAVES ។

6. បញ្ជាក់ប្រតិបត្តិការ៖

ប្រតិបត្តិការត្រូវបានបង្កើត និងផ្សាយទៅកាន់បណ្តាញ។ ឥឡូវនេះអ្នកអាចឃើញលេខសម្គាល់របស់នាង

7. ត្រួតពិនិត្យប្រតិបត្តិការដោយប្រើ Waves Explorer ។ បញ្ចូលលេខសម្គាល់ក្នុងវាលស្វែងរក

សេចក្តីសន្និដ្ឋាន និងព័ត៌មានបន្ថែម

យើងបានពិនិត្យមើលឧបករណ៍សម្រាប់បង្កើត សាកល្បង ការដាក់ពង្រាយ និងប្រើប្រាស់ dApps សាមញ្ញនៅលើវេទិកា Waves៖

• ភាសាជិះ
• VS កម្មវិធីនិពន្ធកូដ
• រលក Explorer
• ជិះបន្ទះក្តារ
• អ្នករក្សារលក

តំណភ្ជាប់សម្រាប់អ្នកដែលចង់បន្តរៀន RIDE៖

ឧទាហរណ៍បន្ថែមទៀត
IDE លើបណ្តាញជាមួយឧទាហរណ៍
ឯកសាររលក
អ្នកអភិវឌ្ឍន៍ជជែកនៅក្នុង Telegram
រលកនិងជិះលើជង់
ថ្មី! វគ្គសិក្សាតាមអ៊ិនធរណេតស្តីពីការបង្កើត dApps នៅលើ Waves Platform

បន្តចូលទៅក្នុងប្រធានបទ RIDE ហើយបង្កើត dApp ដំបូងរបស់អ្នក!

TL; កុង: bit.ly/2YCFnwY

ប្រភព: www.habr.com