कसरी निर्माण गर्ने, परिनियोजन गर्ने र तरंगहरू RIDE dApp परीक्षण गर्ने

नमस्ते! यस लेखमा म तपाइँलाई कसरी लेख्ने र लहर नोडमा नियमित dApp चलाउने देखाउनेछु। आवश्यक उपकरणहरू, विधिहरू र विकासको उदाहरण हेरौं।

dApps र नियमित अनुप्रयोगहरूको लागि विकास योजना लगभग समान छ:

• कोड लेखन
• स्वचालित परीक्षण लेखन
• अनुप्रयोग सुरु गर्दै
• परीक्षण

उपकरणहरू

1. docker नोड र वेभ्स एक्सप्लोरर चलाउन

यदि तपाइँ नोड सुरु गर्न चाहनुहुन्न भने, तपाइँ यो चरण छोड्न सक्नुहुन्छ। आखिर, त्यहाँ एक परीक्षण र प्रयोगात्मक नेटवर्क छ। तर तपाईंको आफ्नै नोड तैनात नगरी, परीक्षण प्रक्रिया तान्न सक्छ।

• तपाईलाई निरन्तर परीक्षण टोकनहरूको साथ नयाँ खाताहरू चाहिन्छ। परीक्षण नेटवर्क नलले प्रत्येक 10 मिनेटमा 10 लहरहरू स्थानान्तरण गर्दछ।
• परीक्षण नेटवर्कमा औसत ब्लक समय 1 मिनेट हो, नोडमा - 15 सेकेन्ड। लेनदेनलाई धेरै पुष्टिकरणहरू आवश्यक पर्दा यो विशेष गरी ध्यान दिन सकिन्छ।
• सार्वजनिक परीक्षण नोडहरूमा आक्रामक क्यासिङ सम्भव छ।
• तिनीहरू पनि मर्मतसम्भारको कारणले अस्थायी रूपमा अनुपलब्ध हुन सक्छन्।

अब देखि म मान्छु कि तपाईं आफ्नो नोड संग काम गर्दै हुनुहुन्छ।

2. सर्फबोर्ड कमाण्ड लाइन उपकरण

• डाउनलोड गर्नुहोस् र यहाँ ppa, homebrew वा exe प्रयोग गरेर Node.js स्थापना गर्नुहोस्: https://nodejs.org/en/download/.
• सर्फबोर्ड स्थापना गर्नुहोस्, एउटा उपकरण जसले तपाईंलाई अवस्थित नोडमा परीक्षणहरू चलाउन अनुमति दिन्छ।

npm install -g @waves/surfboard

3. भिजुअल स्टुडियो कोड प्लगइन

यदि तपाईं IDEs को प्रशंसक हुनुहुन्न र पाठ सम्पादकहरूलाई प्राथमिकता दिनुहुन्छ भने यो चरण वैकल्पिक छ। सबै आवश्यक उपकरणहरू कमाण्ड लाइन उपयोगिताहरू हुन्। यदि तपाइँ vim प्रयोग गर्नुहुन्छ भने, प्लगइनमा ध्यान दिनुहोस् vim-सवारी.

भिजुअल स्टुडियो कोड डाउनलोड र स्थापना गर्नुहोस्: https://code.visualstudio.com/

VS कोड खोल्नुहोस् र तरंग-सवारी प्लगइन स्थापना गर्नुहोस्:

वेभ्स किपर ब्राउजर विस्तार: https://wavesplatform.com/products-keeper

भयो!

नोड र वेभ्स एक्सप्लोरर सुरु गर्नुहोस्

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 ले स्थानीय नोड उदाहरण देखाउँछ

सवारी संरचना र सर्फबोर्ड उपकरण

एउटा खाली डाइरेक्टरी सिर्जना गर्नुहोस् र यसमा आदेश चलाउनुहोस्

surfboard init

आदेशले परियोजना संरचना, "हेलो संसार" अनुप्रयोगहरू र परीक्षणहरूको साथ डाइरेक्टरी प्रारम्भ गर्दछ। यदि तपाईंले VS कोडको साथ यो फोल्डर खोल्नुभयो भने, तपाईंले देख्नुहुनेछ:

Surfboard.config.json

• ./ride/ फोल्डर अन्तर्गत तपाईले एकल फाइल wallet.ride पाउनुहुनेछ - डाइरेक्टरी जहाँ dApp कोड अवस्थित छ। हामी अर्को ब्लकमा dApps को संक्षिप्त विश्लेषण गर्नेछौं।
• ./test/ फोल्डर अन्तर्गत तपाईंले *.js फाइल पाउनुहुनेछ। परीक्षणहरू यहाँ भण्डार गरिएका छन्।
• ./surfboard.config.json - चलिरहेको परीक्षणहरूको लागि कन्फिगरेसन फाइल।

Envs एक महत्त्वपूर्ण खण्ड हो। प्रत्येक वातावरण यसरी कन्फिगर गरिएको छ:

• नेटवर्कको dApp र CHAIN_ID सुरु गर्न प्रयोग गरिने नोडको REST API अन्त्य बिन्दु।
• टोकनहरू भएको खाताको लागि गोप्य वाक्यांश जुन तपाईंको परीक्षण टोकनहरूको स्रोत हुनेछ।

तपाईंले देख्न सक्नुहुने रूपमा, surfboard.config.json ले पूर्वनिर्धारित रूपमा धेरै वातावरणहरूलाई समर्थन गर्दछ। पूर्वनिर्धारित स्थानीय वातावरण हो (defaultEnv कुञ्जी परिवर्तन योग्य प्यारामिटर हो)।

वालेट-डेमो आवेदन

यो खण्ड RIDE भाषाको सन्दर्भ होइन। बरु, ब्लकचेनमा के भइरहेको छ भनेर राम्रोसँग बुझ्नको लागि हामीले प्रयोग गर्ने र परीक्षण गर्ने एप्लिकेसनमा एक नजर।

एक साधारण वालेट-डेमो अनुप्रयोग हेरौं। जो कोहीले dApp ठेगानामा टोकन पठाउन सक्छ। तपाईं आफ्नो WAVES मात्र फिर्ता लिन सक्नुहुन्छ। दुई @Callable प्रकार्यहरू InvokeScriptTransaction मार्फत उपलब्ध छन्:

• deposit()जसलाई WAVES मा संलग्न भुक्तानी चाहिन्छ
• withdraw(amount: Int)जसले टोकनहरू फर्काउँछ

dApp जीवनचक्र भरि, संरचना (ठेगाना → रकम) कायम रहनेछ:

कार्य
नतिजा राज्य

सुरुमा
खाली

एलिसले ५ तरङ्गहरू जम्मा गर्छ
एलिस-ठेगाना → 500000000

Bob जम्मा 2 WAVES

एलिस-ठेगाना → 500000000
bob-ठेगाना → 200000000

Bob 7 WAVES फिर्ता लिन्छ
अस्वीकार गरियो!

एलिसले ४ तरङ्गहरू फिर्ता लिन्छिन्
एलिस-ठेगाना → 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

यसले बेस64 कम्पाइल गरिएको RIDE कोडको श्रृंखला आउटपुट गर्नेछ।

'wallet.ride' को लागि परीक्षण लिपि

हेरौं परीक्षण फाइल। जाभास्क्रिप्टको मोचा फ्रेमवर्क द्वारा संचालित। त्यहाँ "पहिले" प्रकार्य र तीन परीक्षणहरू छन्:

• MassTransferTransaction मार्फत धेरै खाताहरूलाई "पहिले" कोष दिन्छ, स्क्रिप्ट कम्पाइल गर्छ र यसलाई ब्लकचेनमा प्रयोग गर्दछ।
• "जम्मा गर्न सक्छ" ले नेटवर्कमा InvokeScriptTransaction पठाउँछ, प्रत्येक दुई खाताको लागि deposit() प्रकार्य सक्रिय गर्दछ।
• "जमा गरिएको भन्दा बढी झिक्न सकिँदैन" परीक्षणहरू कि कसैले अरू मानिसहरूको टोकन चोरी गर्न सक्दैन।
• निकासी सही तरिकाले प्रशोधन गरिएको छ कि "जमा गर्न सक्नुहुन्छ" चेक।

सर्फबोर्डबाट परीक्षणहरू चलाउनुहोस् र वेभ्स एक्सप्लोररमा परिणामहरू विश्लेषण गर्नुहोस्

परीक्षण चलाउन, दौड्नुहोस्

surfboard test

यदि तपाइँसँग धेरै स्क्रिप्टहरू छन् (उदाहरणका लागि, तपाइँलाई छुट्टै डिप्लोइमेन्ट लिपि चाहिन्छ), तपाइँ चलाउन सक्नुहुन्छ

surfboard test my-scenario.js

सर्फबोर्डले ./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)

हुर्रे! परीक्षा उत्तीर्ण भयो। अब वेभ्स एक्सप्लोरर प्रयोग गर्दा के हुन्छ भनेर हेरौं: ब्लकहरू हेर्नुहोस् वा खोजमा माथिको ठेगानाहरू मध्ये एउटा टाँस्नुहोस् (उदाहरणका लागि, सम्बन्धित wallet#। त्यहाँ तपाइँ लेनदेन इतिहास, dApp स्थिति, decompiled बाइनरी फाइल पाउन सक्नुहुन्छ।

वेभ्स एक्सप्लोरर। भर्खरै तैनाथ गरिएको एउटा अनुप्रयोग।

केहि सर्फबोर्ड सुझावहरू:

1. टेस्टनेट वातावरणमा परीक्षण गर्न, प्रयोग गर्नुहोस्:

surfboard test --env=testnet

परीक्षण टोकन प्राप्त गर्नुहोस्

2. यदि तपाइँ लेनदेनको JSON संस्करणहरू र नोडद्वारा कसरी प्रशोधन गरिन्छ भनेर हेर्न चाहनुहुन्छ भने, -v (अर्थात 'वर्बोज') को साथ परीक्षण चलाउनुहोस्:

surfboard test -v

Waves Keeper सँग एपहरू प्रयोग गर्दै

1. काम गर्न Waves Keeper सेट अप गर्नुहोस्: http://localhost:6869

स्थानीय नोडसँग काम गर्न Waves Keeper सेटअप गर्दै

2. नेटवर्कको लागि टोकनहरूको साथ गोप्य वाक्यांश आयात गर्ने? सरलताको लागि, तपाईंको नोडको प्रारम्भिक बीउ प्रयोग गर्नुहोस्: waves private node seed with waves tokens। ठेगाना: 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. तपाईले npm प्रयोग गरेर सर्भररहित एकल पृष्ठ अनुप्रयोग आफैं चलाउन सक्नुहुन्छ। वा अवस्थितमा जानुहोस्: chrome-ext.wvservices.com/dapp-wallet.html

4. dApp ठेगाना पाठ बाकसमा परीक्षण रन (माथि रेखाङ्कित) बाट वालेट ठेगाना प्रविष्ट गर्नुहोस्

5. "निक्षेप" फिल्डमा सानो रकम प्रविष्ट गर्नुहोस् र बटन क्लिक गर्नुहोस्:

वेभ्स किपरले 10 WAVES को भुक्तानीको साथ InvokeScriptTransaction मा हस्ताक्षर गर्न अनुमति अनुरोध गर्दछ।

6. लेनदेन पुष्टि गर्नुहोस्:

लेनदेन सिर्जना गरी नेटवर्कमा प्रसारण गरिन्छ। अब तपाईं उनको आईडी देख्न सक्नुहुन्छ

7. Waves Explorer को प्रयोग गरेर लेनदेन निगरानी गर्नुहोस्। खोज क्षेत्रमा आईडी प्रविष्ट गर्नुहोस्

निष्कर्ष र अतिरिक्त जानकारी

हामीले Waves प्लेटफर्ममा साधारण dApps को विकास, परीक्षण, डिप्लोइङ र प्रयोग गर्ने उपकरणहरू हेर्यौं:

• सवारी भाषा
• VS कोड सम्पादक
• वेभ्स एक्सप्लोरर
• सर्फबोर्ड
• तरंग रक्षक

RIDE सिक्न जारी राख्न चाहनेहरूका लागि लिङ्कहरू:

थप उदाहरणहरु
उदाहरणका साथ अनलाइन IDE
तरंग दस्तावेजीकरण
Telegram मा विकासकर्ता च्याट
स्ट्याकओभरफ्लोमा छालहरू र सवारी
नयाँ! वेभ्स प्लेटफर्ममा dApps सिर्जना गर्ने अनलाइन पाठ्यक्रमहरू

RIDE शीर्षकमा डाइभिङ जारी राख्नुहोस् र आफ्नो पहिलो dApp सिर्जना गर्नुहोस्!

TL; ड: bit.ly/2YCFnwY

स्रोत: www.habr.com