वेव्स RIDE dApp का निर्माण, परिनियोजन और परीक्षण कैसे करें

नमस्ते! इस लेख में मैं आपको दिखाऊंगा कि वेव्स नोड पर नियमित डीएपी कैसे लिखें और चलाएं। आइए आवश्यक उपकरणों, विधियों और विकास के एक उदाहरण को देखें।

डीएपी और नियमित अनुप्रयोगों के लिए विकास योजना लगभग समान है:

• हम कोड लिखते हैं
• स्वचालित परीक्षण लिखना
• एप्लिकेशन लॉन्च करना
• परिक्षण

उपकरण

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

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

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

अब से मैं मान लूंगा कि आप अपने स्वयं के नोड के साथ काम कर रहे हैं।

2. सर्फ़बोर्ड कमांड लाइन टूल

• Ppa, Homebrew या exe का उपयोग करके Node.js को यहां डाउनलोड और इंस्टॉल करें: https://nodejs.org/en/download/.
• सर्फ़बोर्ड स्थापित करें, एक उपकरण जो आपको मौजूदा नोड पर परीक्षण चलाने की अनुमति देता है।

npm install -g @waves/surfboard

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

यदि आप आईडीई के प्रशंसक नहीं हैं और टेक्स्ट संपादक पसंद करते हैं तो यह चरण वैकल्पिक है। सभी आवश्यक उपकरण कमांड लाइन उपयोगिताएँ हैं। यदि आप विम का उपयोग करते हैं, तो प्लगइन पर ध्यान दें विम-सवारी.

विज़ुअल स्टूडियो कोड डाउनलोड और इंस्टॉल करें: https://code.visualstudio.com/

वीएस कोड खोलें और वेव्स-राइड प्लगइन इंस्टॉल करें:

वेव्स कीपर ब्राउज़र एक्सटेंशन: https://wavesplatform.com/products-keeper

हो गया!

नोड और वेव्स एक्सप्लोरर प्रारंभ करें

1. नोड प्रारंभ करें:

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

सुनिश्चित करें कि नोड को REST API के माध्यम से लॉन्च किया गया है http://localhost:6869:

नोड के लिए स्वैगर रेस्ट एपीआई

2. वेव्स एक्सप्लोरर का एक उदाहरण प्रारंभ करें:

docker run -d -e API_NODE_URL=http://localhost:6869 -e NODE_LIST=http://localhost:6869 -p 3000:8080 wavesplatform/explorer

एक ब्राउज़र खोलें और यहां जाएं http://localhost:3000. आप देखेंगे कि कितनी जल्दी एक खाली स्थानीय नोड सर्किट बनाया जाता है।

वेव्स एक्सप्लोरर एक स्थानीय नोड उदाहरण प्रदर्शित करता है

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

एक खाली निर्देशिका बनाएं और उसमें कमांड चलाएँ

surfboard init

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

Surfboard.config.json

• ./ride/ फ़ोल्डर के अंतर्गत आपको एक एकल फ़ाइल वॉलेट.राइड मिलेगी - वह निर्देशिका जहां dApp कोड स्थित है। हम अगले ब्लॉक में डीएपी का संक्षेप में विश्लेषण करेंगे।
• ./test/ फ़ोल्डर के अंतर्गत आपको एक *.js फ़ाइल मिलेगी। परीक्षण यहाँ संग्रहीत हैं.
• ./surfboard.config.json – परीक्षण चलाने के लिए कॉन्फ़िगरेशन फ़ाइल।

Envs एक महत्वपूर्ण अनुभाग है। प्रत्येक वातावरण इस प्रकार कॉन्फ़िगर किया गया है:

• नोड का REST API एंडपॉइंट जिसका उपयोग नेटवर्क के dApp और CHAIN_ID को लॉन्च करने के लिए किया जाएगा।
• टोकन वाले खाते के लिए एक गुप्त वाक्यांश जो आपके परीक्षण टोकन का स्रोत होगा।

जैसा कि आप देख सकते हैं, Surfboard.config.json डिफ़ॉल्ट रूप से कई वातावरणों का समर्थन करता है। डिफ़ॉल्ट स्थानीय वातावरण है (डिफ़ॉल्टEnv कुंजी एक परिवर्तनीय पैरामीटर है)।

वॉलेट-डेमो एप्लिकेशन

यह अनुभाग RIDE भाषा का संदर्भ नहीं है। बल्कि, उस एप्लिकेशन पर एक नज़र डालें जिसे हम ब्लॉकचेन में क्या हो रहा है, इसे बेहतर ढंग से समझने के लिए तैनात और परीक्षण करते हैं।

आइए एक साधारण वॉलेट-डेमो एप्लिकेशन देखें। कोई भी व्यक्ति डीएपी पते पर टोकन भेज सकता है। आप केवल अपनी तरंगें वापस ले सकते हैं। InvokeScriptTransaction के माध्यम से दो @Callable फ़ंक्शन उपलब्ध हैं:

• deposit()जिसके लिए WAVES में संलग्न भुगतान की आवश्यकता होती है
• withdraw(amount: Int)जो टोकन लौटाता है

पूरे डीएपी जीवनचक्र के दौरान, संरचना (पता → राशि) बनाए रखी जाएगी:

कार्य
परिणामी अवस्था

प्रारंभिक
खाली

ऐलिस 5 तरंगें जमा करती है
ऐलिस-पता → 500000000

बॉब 2 तरंगें जमा करता है

ऐलिस-पता → 500000000
बॉब-पता → 200000000

बॉब ने 7 तरंगें निकालीं
अस्वीकृत!

ऐलिस ने 4 तरंगें निकालीं
ऐलिस-पता → 100000000
बॉब-पता → 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

यह बेस64 संकलित RIDE कोड की एक श्रृंखला को आउटपुट करेगा।

'वॉलेट.राइड' के लिए टेस्ट स्क्रिप्ट

आइए देखें परीक्षण फ़ाइल. जावास्क्रिप्ट के मोचा फ्रेमवर्क द्वारा संचालित। एक "पहले" फ़ंक्शन और तीन परीक्षण हैं:

• "बिफोर" MassTransferTransaction के माध्यम से कई खातों को फंड करता है, स्क्रिप्ट संकलित करता है और इसे ब्लॉकचेन पर तैनात करता है।
• "जमा कर सकते हैं" नेटवर्क पर एक InvokeScriptTransaction भेजता है, दोनों खातों में से प्रत्येक के लिए जमा() फ़ंक्शन को सक्रिय करता है।
• "जमा की गई राशि से अधिक नहीं निकाल सकते" यह परीक्षण करता है कि कोई भी अन्य लोगों के टोकन चुरा नहीं सकता है।
• "जमा कर सकते हैं" चेक कि निकासी सही ढंग से संसाधित की गई है।

सर्फ़बोर्ड से परीक्षण चलाएँ और वेव्स एक्सप्लोरर में परिणामों का विश्लेषण करें

परीक्षण चलाने के लिए, चलाएँ

surfboard test

यदि आपके पास एकाधिक स्क्रिप्ट हैं (उदाहरण के लिए, आपको एक अलग परिनियोजन स्क्रिप्ट की आवश्यकता है), तो आप चला सकते हैं

surfboard test my-scenario.js

सर्फ़बोर्ड परीक्षण फ़ाइलों को ./test/ फ़ोल्डर में एकत्र करेगा और स्क्रिप्ट को सर्फ़बोर्ड.कॉन्फिग.जेसन में कॉन्फ़िगर किए गए नोड पर चलाएगा। कुछ सेकंड बाद आपको कुछ ऐसा दिखाई देगा:

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#. वहां आप लेनदेन इतिहास, डीएपी स्थिति, विघटित बाइनरी फ़ाइल पा सकते हैं।

तरंग एक्सप्लोरर. एक एप्लिकेशन जिसे अभी-अभी तैनात किया गया है।

कुछ सर्फ़बोर्ड युक्तियाँ:

1. टेस्टनेट वातावरण में परीक्षण करने के लिए, उपयोग करें:

surfboard test --env=testnet

परीक्षण टोकन प्राप्त करें

2. यदि आप लेनदेन के JSON संस्करण देखना चाहते हैं और उन्हें नोड द्वारा कैसे संसाधित किया जाता है, तो -v (मतलब 'वर्बोज़') के साथ परीक्षण चलाएं:

surfboard test -v

वेव्स कीपर के साथ ऐप्स का उपयोग करना

1. काम करने के लिए वेव्स कीपर सेट करें: http://localhost:6869

स्थानीय नोड के साथ काम करने के लिए वेव्स कीपर की स्थापना

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

3. आप npm का उपयोग करके स्वयं सर्वर रहित सिंगल पेज एप्लिकेशन चला सकते हैं। या मौजूदा पर जाएँ: chrome-ext.wvservices.com/dapp-wallet.html

4. परीक्षण रन (ऊपर रेखांकित) से वॉलेट पता डीएपी एड्रेस टेक्स्ट बॉक्स में दर्ज करें

5. "जमा" फ़ील्ड में एक छोटी राशि दर्ज करें और बटन पर क्लिक करें:

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

6. लेनदेन की पुष्टि करें:

लेन-देन बनाया जाता है और नेटवर्क पर प्रसारित किया जाता है। अब आप उसकी आईडी देख सकते हैं

7. वेव्स एक्सप्लोरर का उपयोग करके लेनदेन की निगरानी करें। खोज फ़ील्ड में आईडी दर्ज करें

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

हमने वेव्स प्लेटफ़ॉर्म पर सरल डीएपी के विकास, परीक्षण, तैनाती और उपयोग के लिए उपकरणों को देखा:

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

उन लोगों के लिए लिंक जो RIDE सीखना जारी रखना चाहते हैं:

और ज्यादा उदाहरण
उदाहरणों के साथ ऑनलाइन आईडीई
लहरें दस्तावेज़ीकरण
टेलीग्राम में डेवलपर चैट
स्टैकओवरफ़्लो पर लहरें और सवारी
नया! वेव्स प्लेटफ़ॉर्म पर डीएपी बनाने पर ऑनलाइन पाठ्यक्रम

RIDE विषय में गोता लगाना जारी रखें और अपना पहला dApp बनाएं!

टीएल, डॉ: bit.ly/2YCFnwY

स्रोत: www.habr.com