ວິທີການສ້າງ, ນຳໃຊ້ ແລະທົດສອບຄື້ນ RIDE dApp

ສະບາຍດີ! ໃນບົດຄວາມນີ້ຂ້ອຍຈະສະແດງວິທີການຂຽນແລະດໍາເນີນການ dApp ປົກກະຕິຢູ່ໃນ Waves node. ໃຫ້ເບິ່ງເຄື່ອງມືທີ່ຈໍາເປັນ, ວິທີການແລະຕົວຢ່າງຂອງການພັດທະນາ.

ໂຄງການພັດທະນາສໍາລັບ dApps ແລະຄໍາຮ້ອງສະຫມັກປົກກະຕິແມ່ນເກືອບຄືກັນ:

• ການຂຽນລະຫັດ
• ການຂຽນແບບທົດສອບອັດຕະໂນມັດ
• ການເປີດຕົວຄໍາຮ້ອງສະຫມັກ
• ການທົດສອບ

ເຄື່ອງມື

1. docker ເພື່ອດໍາເນີນການ node ແລະ Waves Explorer

ຖ້າທ່ານບໍ່ຕ້ອງການເລີ່ມຕົ້ນ node, ທ່ານສາມາດຂ້າມຂັ້ນຕອນນີ້. ຫຼັງຈາກທີ່ທັງຫມົດ, ມີເຄືອຂ່າຍການທົດສອບແລະການທົດລອງ. ແຕ່ໂດຍບໍ່ມີການ deploy node ຂອງທ່ານເອງ, ຂະບວນການທົດສອບອາດຈະ drag ສຸດ.

• ທ່ານຈະຈໍາເປັນຕ້ອງມີບັນຊີໃຫມ່ຢ່າງຕໍ່ເນື່ອງກັບ tokens ທົດສອບ. faucet ເຄືອຂ່າຍການທົດສອບຈະໂອນ 10 WAVES ທຸກໆ 10 ນາທີ.
• ເວລາບລັອກສະເລ່ຍໃນເຄືອຂ່າຍການທົດສອບແມ່ນ 1 ນາທີ, ໃນໂຫນດ – 15 ວິນາທີ. ນີ້ແມ່ນສັງເກດເຫັນໂດຍສະເພາະໃນເວລາທີ່ທຸລະກໍາຮຽກຮ້ອງໃຫ້ມີການຢືນຢັນຫຼາຍ.
• ການເກັບຂໍ້ມູນແບບຮຸກຮານແມ່ນເປັນໄປໄດ້ໃນຂໍ້ທົດສອບສາທາລະນະ.
• ພວກມັນອາດບໍ່ສາມາດໃຊ້ໄດ້ຊົ່ວຄາວເນື່ອງຈາກການບຳລຸງຮັກສາ.

ຈາກນີ້ໄປຂ້າພະເຈົ້າຈະສົມມຸດວ່າທ່ານກໍາລັງເຮັດວຽກກັບ node ຂອງທ່ານເອງ.

2. Surfboard Command Line Tool

• ດາວໂຫລດແລະຕິດຕັ້ງ Node.js ໂດຍໃຊ້ ppa, homebrew ຫຼື exe ທີ່ນີ້: https://nodejs.org/en/download/.
• ຕິດຕັ້ງ Surfboard, ເຄື່ອງມືທີ່ຊ່ວຍໃຫ້ທ່ານສາມາດດໍາເນີນການທົດສອບໃນ node ທີ່ມີຢູ່ແລ້ວ.

npm install -g @waves/surfboard

3. Visual Studio Code plugin

ຂັ້ນຕອນນີ້ແມ່ນທາງເລືອກຖ້າທ່ານບໍ່ແມ່ນແຟນຂອງ IDEs ແລະມັກຕົວແກ້ໄຂຂໍ້ຄວາມ. ເຄື່ອງມືທີ່ຈໍາເປັນທັງຫມົດແມ່ນເຄື່ອງໃຊ້ຄໍາສັ່ງ. ຖ້າທ່ານໃຊ້ vim, ເອົາໃຈໃສ່ກັບ plugin ຂີ່ລົດ.

ດາວໂຫຼດ ແລະຕິດຕັ້ງ Visual Studio Code: https://code.visualstudio.com/

ເປີດລະຫັດ VS ແລະຕິດຕັ້ງ plugin waves-ride:

ສ່ວນຂະຫຍາຍຂອງຕົວທ່ອງເວັບ Waves Keeper: https://wavesplatform.com/products-keeper

ແລ້ວ!

ເລີ່ມ node ແລະ Waves Explorer

1. ເລີ່ມ node:

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

ໃຫ້ແນ່ໃຈວ່າ node ຖືກເປີດຕົວໂດຍຜ່ານ REST API ໃນ http://localhost:6869:

Swagger REST API ສໍາລັບ node

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. ທ່ານຈະເຫັນວິທີການສ້າງວົງຈອນ node ທ້ອງຖິ່ນຫວ່າງເປົ່າໄວເທົ່າໃດ.

Waves Explorer ສະແດງຕົວຢ່າງ node ທ້ອງຖິ່ນ

ໂຄງສ້າງ RIDE ແລະເຄື່ອງມື Surfboard

ສ້າງໄດເລກະທໍລີຫວ່າງເປົ່າແລະດໍາເນີນການຄໍາສັ່ງໃນມັນ

surfboard init

ຄໍາສັ່ງເລີ່ມຕົ້ນໄດເລກະທໍລີທີ່ມີໂຄງສ້າງໂຄງການ, ຄໍາຮ້ອງສະຫມັກແລະການທົດສອບ "ສະບາຍດີໂລກ". ຖ້າທ່ານເປີດໂຟນເດີນີ້ດ້ວຍລະຫັດ VS, ທ່ານຈະເຫັນ:

Surfboard.config.json

• ພາຍໃຕ້ໂຟນເດີ ./ride/ ທ່ານຈະພົບເຫັນໄຟລ໌ດຽວ wallet.ride - ໄດເລກະທໍລີທີ່ລະຫັດ dApp ຕັ້ງຢູ່. ພວກເຮົາຈະວິເຄາະ dApps ສັ້ນໆໃນບລັອກຕໍ່ໄປ.
• ພາຍໃຕ້ໂຟນເດີ ./test/ ທ່ານຈະພົບເຫັນໄຟລ໌ *.js. ການທົດສອບຖືກເກັບໄວ້ທີ່ນີ້.
• ./surfboard.config.json – ໄຟລ໌ການຕັ້ງຄ່າສຳລັບການແລ່ນການທົດສອບ.

Envs ແມ່ນພາກສ່ວນທີ່ສໍາຄັນ. ສະ​ພາບ​ແວດ​ລ້ອມ​ແຕ່​ລະ​ແມ່ນ​ໄດ້​ຮັບ​ການ​ຕັ້ງ​ຄ່າ​ດັ່ງ​ນີ້​:

• REST API endpoint ຂອງ node ທີ່ຈະໃຊ້ເພື່ອເປີດ dApp ແລະ CHAIN_ID ຂອງເຄືອຂ່າຍ.
• ປະໂຫຍກລັບສໍາລັບບັນຊີທີ່ມີ tokens ທີ່ຈະເປັນແຫຼ່ງຂອງ tokens ການທົດສອບຂອງທ່ານ.

ດັ່ງທີ່ເຈົ້າສາມາດເຫັນໄດ້, surfboard.config.json ຮອງຮັບຫຼາຍສະພາບແວດລ້ອມໂດຍຄ່າເລີ່ມຕົ້ນ. ຄ່າເລີ່ມຕົ້ນແມ່ນສະພາບແວດລ້ອມທ້ອງຖິ່ນ (ປຸ່ມ defaultEnv ແມ່ນຕົວກໍານົດການທີ່ສາມາດປ່ຽນແປງໄດ້).

ແອັບພລິເຄຊັນ Wallet-demo

ພາກນີ້ບໍ່ໄດ້ອ້າງອີງເຖິງພາສາ RIDE. ແທນທີ່ຈະ, ເບິ່ງຄໍາຮ້ອງສະຫມັກທີ່ພວກເຮົານໍາໃຊ້ແລະທົດສອບເພື່ອໃຫ້ເຂົ້າໃຈດີຂຶ້ນກ່ຽວກັບສິ່ງທີ່ເກີດຂື້ນໃນ blockchain.

ມາເບິ່ງແອັບພລິເຄຊັນ Wallet-demo ງ່າຍໆ. ທຸກຄົນສາມາດສົ່ງ tokens ໄປຫາທີ່ຢູ່ dApp. ທ່ານສາມາດຖອນ WAVES ຂອງທ່ານໄດ້ເທົ່ານັ້ນ. ສອງຟັງຊັນ @Callable ສາມາດໃຊ້ໄດ້ຜ່ານ InvokeScriptTransaction:

• deposit()ເຊິ່ງຕ້ອງການການຈ່າຍເງິນທີ່ຕິດຄັດມາໃນ WAVES
• withdraw(amount: Int)ເຊິ່ງສົ່ງຄືນ tokens

ຕະຫຼອດວົງຈອນຊີວິດຂອງ dApp, ໂຄງສ້າງ (ທີ່ຢູ່ → ຈໍານວນ) ຈະຖືກຮັກສາໄວ້:

ການປະຕິບັດ
ສະຖານະຜົນໄດ້ຮັບ

ໃນເບື້ອງຕົ້ນ
ຫວ່າງເປົ່າ

Alice ຝາກ 5 WAVES
alice-address → 500000000

Bob ຝາກ 2 WAVES

alice-address → 500000000
bob-ທີ່ຢູ່ → 200000000

Bob ຖອນ 7 WAVES
ປະຕິເສດ!

Alice ຖອນ 4 WAVES
alice-address → 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.

plugin VSCode ສະຫນັບສະຫນູນການລວບລວມຢ່າງຕໍ່ເນື່ອງໃນຂະນະທີ່ແກ້ໄຂໄຟລ໌. ດັ່ງນັ້ນ, ທ່ານສາມາດຕິດຕາມຄວາມຜິດພາດໃນແຖບບັນຫາໄດ້ຕະຫຼອດເວລາ.

ຖ້າທ່ານຕ້ອງການໃຊ້ຕົວແກ້ໄຂຂໍ້ຄວາມທີ່ແຕກຕ່າງກັນໃນເວລາລວບລວມໄຟລ໌, ໃຫ້ໃຊ້

surfboard compile ride/wallet.ride

ນີ້ຈະອອກຊຸດຂອງລະຫັດ RIDE ທີ່ລວບລວມຈາກ base64.

ທົດສອບສະຄຣິບສຳລັບ 'wallet.ride'

ໃຫ້ເບິ່ງຢູ່ ໄຟລ​໌​ທົດ​ສອບ​. ຂັບເຄື່ອນໂດຍກອບ Mocha ຂອງ JavaScript. ມີຫນ້າທີ່ "ກ່ອນ" ແລະສາມການທົດສອບ:

• "ກ່ອນ" ສະຫນອງທຶນຫຼາຍບັນຊີຜ່ານ MassTransferTransaction, ລວບລວມສະຄິບແລະນໍາໄປໃຊ້ໃນ blockchain.
• "ສາມາດຝາກເງິນໄດ້" ສົ່ງ InvokeScriptTransaction ໄປຫາເຄືອຂ່າຍ, ເປີດໃຊ້ຫນ້າທີ່ເງິນຝາກ () ສໍາລັບແຕ່ລະບັນຊີທັງສອງ.
• "ບໍ່ສາມາດຖອນໄດ້ຫຼາຍກ່ວາເງິນຝາກ" ການທົດສອບທີ່ບໍ່ມີໃຜສາມາດລັກ tokens ຂອງຄົນອື່ນ.
• “ສາມາດຝາກເງິນໄດ້” ກວດເບິ່ງວ່າການຖອນເງິນໄດ້ຖືກປະມວນຜົນຢ່າງຖືກຕ້ອງ.

ດໍາເນີນການທົດສອບຈາກ 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, ໄຟລ໌ຖານສອງທີ່ແຕກຫັກ.

Waves Explorer. ແອັບພລິເຄຊັນທີ່ຫາກໍ່ຖືກນຳໃຊ້.

ບາງຄໍາແນະນໍາ Surfboard:

1. ເພື່ອທົດສອບໃນສະພາບແວດລ້ອມ testnet, ໃຊ້:

surfboard test --env=testnet

ຮັບໂທເຄັນທົດສອບ

2. ຖ້າທ່ານຕ້ອງການເບິ່ງສະບັບ JSON ຂອງການເຮັດທຸລະກໍາແລະວິທີການທີ່ພວກມັນຖືກປຸງແຕ່ງໂດຍ node, ດໍາເນີນການທົດສອບດ້ວຍ -v (ຫມາຍຄວາມວ່າ 'verbose'):

surfboard test -v

ໃຊ້ແອັບກັບ Waves Keeper

1. ຕັ້ງຄ່າ Waves Keeper ເພື່ອເຮັດວຽກ: http://localhost:6869

ຕັ້ງຄ່າ Waves Keeper ເພື່ອເຮັດວຽກກັບ node ທ້ອງຖິ່ນ

2. ນໍາເຂົ້າປະໂຫຍກລັບທີ່ມີ tokens ສໍາລັບເຄືອຂ່າຍ? ເພື່ອຄວາມງ່າຍດາຍ, ໃຫ້ໃຊ້ແກ່ນເບື້ອງຕົ້ນຂອງ node ຂອງທ່ານ: waves private node seed with waves tokens. ທີ່ຢູ່: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. ທ່ານສາມາດດໍາເນີນການຄໍາຮ້ອງສະຫມັກຫນ້າດຽວ serverless ຕົວທ່ານເອງໂດຍໃຊ້ npm. ຫຼືໄປທີ່ອັນທີ່ມີຢູ່ແລ້ວ: chrome-ext.wvservices.com/dapp-wallet.html

4. ໃສ່ທີ່ຢູ່ wallet ຈາກການທົດສອບ (ຂີດກ້ອງຂ້າງເທິງ) ໃສ່ໃນກ່ອງຂໍ້ຄວາມທີ່ຢູ່ dApp

5. ໃສ່ຈໍານວນນ້ອຍໆໃນຊ່ອງ "ເງິນຝາກ" ແລະຄລິກໃສ່ປຸ່ມ:

Waves Keeper ຮ້ອງຂໍການອະນຸຍາດເພື່ອເຊັນຊື່ InvokeScriptTransaction ດ້ວຍການຈ່າຍເງິນ 10 WAVES.

6. ຢືນຢັນການເຮັດທຸລະກໍາ:

ການເຮັດທຸລະກໍາຖືກສ້າງຂື້ນແລະອອກອາກາດໄປສູ່ເຄືອຂ່າຍ. ໃນປັດຈຸບັນທ່ານສາມາດເບິ່ງ ID ຂອງນາງ

7. ຕິດຕາມກວດກາການເຮັດທຸລະກໍາໂດຍໃຊ້ Waves Explorer. ໃສ່ ID ໃນຊ່ອງຊອກຫາ

ບົດສະຫຼຸບແລະຂໍ້ມູນເພີ່ມເຕີມ

ພວກເຮົາໄດ້ເບິ່ງເຄື່ອງມືໃນການພັດທະນາ, ທົດສອບ, ນຳໃຊ້ ແລະນຳໃຊ້ dApps ງ່າຍໆໃນເວທີ Waves:

• ພາສາ RIDE
• VS Code Editor
• Waves Explorer
• ເຮືອໃບ
• ຜູ້ຮັກສາຄື້ນ

ລິ້ງສຳລັບຜູ້ທີ່ຕ້ອງການສືບຕໍ່ການຮຽນຮູ້ RIDE:

ຕົວຢ່າງເພີ່ມເຕີມ
Online IDE ມີຕົວຢ່າງ
ເອກະສານຄື້ນ
ນັກພັດທະນາສົນທະນາໃນ Telegram
ຄື້ນຟອງແລະ RIDE ສຸດ stackoverflow
ໃຫມ່! ຫຼັກສູດອອນໄລນ໌ກ່ຽວກັບການສ້າງ dApps ໃນ Waves Platform

ສືບຕໍ່ເຂົ້າໄປໃນຫົວຂໍ້ RIDE ແລະສ້າງ dApp ທໍາອິດຂອງທ່ານ!

TL; DR: bit.ly/2YCFnwY

ແຫຼ່ງຂໍ້ມູນ: www.habr.com