လှိုင်းများတည်ဆောက်ပုံ၊ အသုံးချပြီး စမ်းသပ်နည်း RIDE dApp

မင်္ဂလာပါ! ဤဆောင်းပါးတွင် Waves node တစ်ခုပေါ်တွင် ပုံမှန် dApp ကို မည်သို့ရေးသားပြီး လုပ်ဆောင်ရမည်ကို သင့်အား ပြသပါမည်။ လိုအပ်သောကိရိယာများ၊ နည်းစနစ်များနှင့် ဖွံ့ဖြိုးတိုးတက်မှုဆိုင်ရာ ဥပမာကို ကြည့်ကြပါစို့။

dApps နှင့် ပုံမှန်အပလီကေးရှင်းများအတွက် ဖွံ့ဖြိုးတိုးတက်မှုအစီအစဉ်သည် အတူတူနီးပါးဖြစ်သည်-

• ကုဒ်ရေးသည်။
• အလိုအလျောက်စမ်းသပ်ရေးသားခြင်း။
• လျှောက်လွှာကိုဖွင့်ခြင်း။
• စမ်းသပ်ခြင်း။

တူရိယာ

1. docker node နှင့် Waves Explorer ကို run ရန်

node မစတင်လိုပါက ဤအဆင့်ကို ကျော်သွားနိုင်ပါသည်။ ပြီးနောက်ရှိသမျှတို့, စမ်းသပ်ခြင်းနှင့်စမ်းသပ်ကွန်ရက်ရှိပါတယ်။ သို့သော် သင့်ကိုယ်ပိုင် node ကို အသုံးမပြုဘဲ၊ စမ်းသပ်မှုလုပ်ငန်းစဉ်သည် ဆွဲယူသွားနိုင်သည်။

• စမ်းသပ်မှုတိုကင်များပါရှိသော အကောင့်အသစ်များကို အဆက်မပြတ် လိုအပ်ပါသည်။ စမ်းသပ်ကွန်ရက် faucet သည် 10 WAVES 10 မိနစ်တိုင်း လွှဲပြောင်းပေးသည်။
• စမ်းသပ်ကွန်ရက်ရှိ ပျမ်းမျှပိတ်ဆို့အချိန်သည် 1 မိနစ်ဖြစ်ပြီး node တွင် - 15 စက္ကန့်ဖြစ်သည်။ အရောင်းအ၀ယ်တစ်ခုတွင် အတည်ပြုချက်များစွာ လိုအပ်သည့်အခါ အထူးသဖြင့် သိသာသည်။
• ပြင်းထန်သော ကက်ရှ်သည် အများသူငှာ စမ်းသပ်မှု ခုံများပေါ်တွင် ဖြစ်နိုင်သည်။
• ပြုပြင်ထိန်းသိမ်းမှုကြောင့် ၎င်းတို့ကိုလည်း ယာယီ မရနိုင်ပါ။

ယခုမှစ၍ သင်သည် သင်၏ကိုယ်ပိုင် node နှင့် လုပ်ဆောင်နေသည်ဟု ကျွန်ုပ်ယူဆပါမည်။

2. Surfboard Command Line Tool

• ppa၊ homebrew သို့မဟုတ် exe ကို ဤနေရာတွင် အသုံးပြု၍ Node.js ကို ဒေါင်းလုဒ်လုပ်ပြီး ထည့်သွင်းပါ- https://nodejs.org/en/download/.
• ရှိပြီးသား node တစ်ခုပေါ်တွင် စမ်းသပ်မှုများကို လုပ်ဆောင်နိုင်စေမည့် ကိရိယာတစ်ခုဖြစ်သည့် Surfboard ကို ထည့်သွင်းပါ။

npm install -g @waves/surfboard

3. Visual Studio Code ပလပ်အင်

သင်သည် IDE များကို ဝါသနာရှင်မဟုတ်ကာ စာသားတည်းဖြတ်မှုများကို နှစ်သက်ပါက ဤအဆင့်သည် စိတ်ကြိုက်ရွေးချယ်နိုင်သည်။ လိုအပ်သောကိရိယာများအားလုံးသည် command line utilities များဖြစ်သည်။ vim ကိုအသုံးပြုပါက plugin ကိုအာရုံစိုက်ပါ။ vim-စီး.

Visual Studio Code ကိုဒေါင်းလုဒ်လုပ်ပြီး ထည့်သွင်းပါ- https://code.visualstudio.com/

VS Code ကိုဖွင့်ပြီး waves-ride plugin ကို ထည့်သွင်းပါ။

Waves Keeper ဘရောက်ဆာ တိုးချဲ့မှု- https://wavesplatform.com/products-keeper

Done!

node နှင့် Waves Explorer ကိုဖွင့်ပါ။

1. node ကို စတင်ပါ။

docker run -d -p 6869:6869 wavesplatform/waves-private-node

node ကို REST API မှတဆင့်စတင်ကြောင်းသေချာပါစေ။ http://localhost:6869:

node အတွက် 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

Browser ကိုဖွင့်ပြီးသွားပါ။ http://localhost:3000. ဗလာ local node circuit သည် မည်မျှ လျင်မြန်စွာ တည်ဆောက်ထားသည်ကို သင်တွေ့ရပါမည်။

Waves Explorer သည် ဒေသတွင်း node instance ကိုပြသသည်။

RIDE ဖွဲ့စည်းပုံနှင့် Surfboard ကိရိယာ

အချည်းနှီးသော လမ်းညွှန်တစ်ခုကို ဖန်တီးပြီး ၎င်းရှိ command ကို လုပ်ဆောင်ပါ။

surfboard init

ညွှန်ကြားချက်သည် ပရောဂျက်ဖွဲ့စည်းပုံ၊ "hello world" အက်ပ်များနှင့် စမ်းသပ်မှုများဖြင့် လမ်းညွှန်တစ်ခုကို စတင်သည်။ VS Code ဖြင့် ဤဖိုဒါကိုဖွင့်ပါက၊

Surfboard.config.json

• ./ride/ ဖိုဒါအောက်တွင် wallet.ride - dApp ကုဒ်တည်ရှိသည့် လမ်းညွှန်ဖိုင်တစ်ခုတည်းကို တွေ့ရပါမည်။ ကျွန်ုပ်တို့သည် လာမည့်ဘလောက်တွင် dApps ကို အတိုချုံးခွဲခြမ်းစိတ်ဖြာပါမည်။
• ./test/ ဖိုဒါအောက်မှာ *.js ဖိုင်ကို တွေ့လိမ့်မယ်။ စမ်းသပ်မှုများကို ဤနေရာတွင် သိမ်းဆည်းထားသည်။
• ./surfboard.config.json – စမ်းသပ်မှုများ လုပ်ဆောင်ရန်အတွက် ဖွဲ့စည်းမှုဖိုင်။

Envs သည် အရေးကြီးသောအပိုင်းဖြစ်သည်။ ပတ်ဝန်းကျင်တစ်ခုစီကို ဤကဲ့သို့ configure လုပ်ထားသည်-

• ကွန်ရက်၏ dApp နှင့် CHAIN_ID ကို စတင်ရန် အသုံးပြုမည့် node ၏ REST API အဆုံးမှတ်။
• သင်၏စမ်းသပ်မှုတိုကင်များ၏ရင်းမြစ်များဖြစ်မည့် တိုကင်များပါသည့် အကောင့်တစ်ခုအတွက် လျှို့ဝှက်စကားစု။

သင်တွေ့မြင်ရသည့်အတိုင်း၊ surfboard.config.json သည် ပုံမှန်အားဖြင့် ပတ်ဝန်းကျင်များစွာကို ပံ့ပိုးပေးသည်။ ပုံသေသည် ဒေသတွင်းပတ်ဝန်းကျင်ဖြစ်သည် (မူလEnv ကီးသည် ပြောင်းလဲနိုင်သော ကန့်သတ်ဘောင်တစ်ခုဖြစ်သည်)။

ပိုက်ဆံအိတ်-သရုပ်ပြလျှောက်လွှာ

ဤကဏ္ဍသည် RIDE ဘာသာစကားကို ရည်ညွှန်းခြင်းမဟုတ်ပါ။ ယင်းအစား၊ ကျွန်ုပ်တို့သည် blockchain တွင်ဖြစ်ပျက်နေသည်များကိုပိုမိုနားလည်ရန်ကျွန်ုပ်တို့အသုံးပြုပြီးစမ်းသပ်သည့် application ကိုကြည့်ရှုပါ။

ရိုးရှင်းသော Wallet-သရုပ်ပြ အပလီကေးရှင်းကို ကြည့်ကြပါစို့။ မည်သူမဆို dApp လိပ်စာသို့ တိုကင်များ ပေးပို့နိုင်ပါသည်။ သင်၏ WAVES ကိုသာ ရုပ်သိမ်းနိုင်သည်။ @Callable function နှစ်ခုကို InvokeScriptTransaction မှတဆင့် ရနိုင်သည်-

• deposit()WAVES တွင် ပူးတွဲပေးချေမှု လိုအပ်သည်။
• withdraw(amount: Int)တိုကင်များကို ပြန်ပေးသည်။

dApp ဘဝစက်ဝန်းတစ်လျှောက်တွင်၊ ဖွဲ့စည်းပုံ (လိပ်စာ → ပမာဏ) ကို ထိန်းသိမ်းထားမည်-

လှုပ်ရှားမှု
ရလဒ်အခြေအနေ

ကနဦး
အချည်းနှီးသော

အဲလစ်သိုက် 5 WAVES
alice-လိပ်စာ → 500000000

Bob သိုက် 2 WAVES

alice-လိပ်စာ → 500000000
bob-လိပ်စာ → 200000000

Bob သည် 7 Waves ကို ရုပ်သိမ်းလိုက်သည်။
ငြင်းခဲ့သည်!

Alice သည် လှိုင်း 4 ခုကို ရုပ်သိမ်းလိုက်သည်။
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 ပလပ်အင်သည် ဖိုင်တစ်ခုကို တည်းဖြတ်နေစဉ် ဆက်တိုက်စုစည်းမှုကို ပံ့ပိုးပေးသည်။ ထို့ကြောင့်၊ သင်သည် PROBLEMS တက်ဘ်တွင် အမှားများကို အမြဲစောင့်ကြည့်နိုင်သည်။

ဖိုင်ကို ပြုစုရာတွင် မတူညီသော စာသားတည်းဖြတ်သူအား အသုံးပြုလိုပါက၊ အသုံးပြုပါ။

surfboard compile ride/wallet.ride

၎င်းသည် base64 compiled RIDE ကုဒ်၏စီးရီးကိုထုတ်ပေးမည်ဖြစ်သည်။

'wallet.ride' အတွက် စမ်းသပ်မှု script

ကြည့်လိုက်ကြရအောင် စမ်းသပ်ဖိုင်. JavaScript ၏ Mocha မူဘောင်ဖြင့် ပံ့ပိုးထားသည်။ "Before" လုပ်ဆောင်ချက်နှင့် စမ်းသပ်မှု သုံးခုရှိသည်။

• MassTransferTransaction မှတစ်ဆင့် အကောင့်များစွာကို ငွေကြေးမထောက်ပံ့မီ၊ ဇာတ်ညွှန်းကို စုစည်းပြီး ၎င်းကို blockchain သို့ အသုံးချပါ။
• “ငွေသွင်းနိုင်သည်” သည် အကောင့်နှစ်ခုတစ်ခုစီအတွက် အပ်ငွေ() လုပ်ဆောင်ချက်ကို ကွန်ရက်သို့ InvokeScript Transaction ပေးပို့သည်။
• အခြားသူများ၏ တိုကင်များကို မည်သူမျှ မခိုးယူနိုင်သော "အပ်နှံထားသည်ထက် ပိုထုတ်ယူ၍မရပါ" စာမေးပွဲများ။
• "ငွေသွင်းနိုင်သည်" သည် ငွေထုတ်ခြင်းများကို မှန်ကန်စွာ လုပ်ဆောင်ကြောင်း စစ်ဆေးသည်။

Surfboard မှ စမ်းသပ်မှုများကို လုပ်ဆောင်ပြီး Waves Explorer တွင် ရလဒ်များကို ပိုင်းခြားစိတ်ဖြာပါ။

စမ်းသပ်မှုကို လုပ်ဆောင်ရန်၊ ပြေးပါ။

surfboard test

သင့်တွင် script အများအပြားရှိလျှင် (ဥပမာ၊ သီးခြားဖြန့်ကျက်မှု script တစ်ခု လိုအပ်သည်)၊ သင် run နိုင်ပါသည်။

surfboard test my-scenario.js

Surfboard သည် ./test/ ဖိုဒါရှိ စမ်းသပ်ဖိုင်များကို စုဆောင်းပြီး surfboard.config.json တွင် configure လုပ်ထားသော node ပေါ်တွင် script ကို run ပါမည်။ စက္ကန့်အနည်းငယ်ကြာပြီးနောက်တွင် ဤကဲ့သို့သောအရာတစ်ခုကို သင်တွေ့လိမ့်မည်-

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 အခြေအနေ၊ decompiled binary ဖိုင်ကို တွေ့နိုင်သည်။

Waves Explorer အသုံးချပြီးသော အက်ပ်တစ်ခု။

Surfboard Tips အချို့

1. testnet ပတ်ဝန်းကျင်တွင် စမ်းသပ်ရန်၊ အသုံးပြုပါ-

surfboard test --env=testnet

စမ်းသပ်မှုတိုကင်များရယူပါ။

2. ငွေပေးငွေယူများ၏ JSON ဗားရှင်းများနှင့် ၎င်းတို့ကို node မှ မည်သို့လုပ်ဆောင်သည်ကို သင်မြင်လိုပါက -v ဖြင့် စမ်းသပ်မှုကို လုပ်ဆောင်ပါ (အဓိပ္ပာယ် 'verbose')

surfboard test -v

Waves Keeper ဖြင့် အက်ပ်များကို အသုံးပြုခြင်း။

1. အလုပ်လုပ်ရန် Waves Keeper ကို သတ်မှတ်ပါ- http://localhost:6869

ဒေသခံ node တစ်ခုနှင့်အလုပ်လုပ်ရန် Waves Keeper ကို စနစ်ထည့်သွင်းခြင်း။

2. ကွန်ရက်အတွက် တိုကင်များပါသော လျှို့ဝှက်စာစုကို တင်သွင်းမလား။ ရိုးရှင်းရန်အတွက် သင့် node ၏ ကနဦးမျိုးစေ့ကို အသုံးပြုပါ- waves private node seed with waves tokens. လိပ်စာ- 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. npm ကို အသုံးပြု၍ serverless single page application ကို သင်ကိုယ်တိုင် run နိုင်ပါသည်။ သို့မဟုတ် ရှိပြီးသားတစ်ခုသို့ သွားပါ- chrome-ext.wvservices.com/dapp-wallet.html

4. စမ်းသပ်လည်ပတ်မှု (အထက်ဖော်ပြပါ) မှ ပိုက်ဆံအိတ်လိပ်စာကို dApp လိပ်စာစာသားအကွက်ထဲသို့ ထည့်ပါ။

5. "အပ်ငွေ" အကွက်တွင် ပမာဏအနည်းငယ်ကို ထည့်သွင်းပြီး ခလုတ်ကို နှိပ်ပါ-

Waves Keeper သည် 10 WAVES ငွေပေးချေမှုဖြင့် InvokeScriptTransaction လက်မှတ်ရေးထိုးရန် ခွင့်ပြုချက်တောင်းခံပါသည်။

6. ငွေပေးငွေယူကို အတည်ပြုပါ-

ငွေပေးငွေယူကို ဖန်တီးပြီး ကွန်ရက်သို့ ထုတ်လွှင့်သည်။ ယခုသူမ၏ ID ကိုသင်မြင်နိုင်သည်။

7. Waves Explorer ကို အသုံးပြု၍ ငွေပေးငွေယူကို စောင့်ကြည့်ပါ။ ရှာဖွေမှုအကွက်တွင် ID ထည့်ပါ။

ကောက်ချက်များနှင့် ထပ်လောင်းအချက်အလက်များ

Waves Platform ပေါ်ရှိ ရိုးရှင်းသော dApps များကို ဖန်တီးခြင်း၊ စမ်းသပ်ခြင်း၊ အသုံးပြုခြင်းနှင့် အသုံးပြုခြင်းအတွက် ကိရိယာများကို ကျွန်ုပ်တို့ ကြည့်ရှုခဲ့သည်-

• RIDE ဘာသာစကား
• VS ကုဒ်တည်းဖြတ်သူ
• Waves Explorer
• ။
• Waves Keeper

ဆက်လက်လေ့လာလိုသူများအတွက် RIDE လင့်ခ်များ

နောက်ထပ်ဥပမာများ
ဥပမာများဖြင့် အွန်လိုင်း IDE
လှိုင်းမှတ်တမ်း
Telegram တွင် developer chat
လှိုင်းလုံးကြီးများပေါ်တွင် စီးနင်းလိုက်ပါ
အသစ်။ Waves Platform တွင် dApps ဖန်တီးခြင်းဆိုင်ရာ အွန်လိုင်းသင်တန်းများ

RIDE ခေါင်းစဉ်သို့ ဆက်လက်ဝင်ရောက်ပြီး သင်၏ပထမဆုံး dApp ကိုဖန်တီးပါ။

TL; DR: bit.ly/2YCFnwY

source: www.habr.com