RIDE dApp लाटा कसे तयार करावे, उपयोजित करावे आणि चाचणी कशी करावी

नमस्कार! या लेखात मी तुम्हाला Waves नोडवर नियमित 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. व्हिज्युअल स्टुडिओ कोड प्लगइन

तुम्ही IDE चे चाहते नसल्यास आणि मजकूर संपादकांना प्राधान्य दिल्यास ही पायरी ऐच्छिक आहे. सर्व आवश्यक साधने कमांड लाइन युटिलिटीज आहेत. आपण vim वापरत असल्यास, प्लगइनकडे लक्ष द्या vim-राईड.

व्हिज्युअल स्टुडिओ कोड डाउनलोड आणि स्थापित करा: 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:

नोडसाठी स्वैगर 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 हा एक महत्त्वाचा विभाग आहे. प्रत्येक वातावरण याप्रमाणे कॉन्फिगर केले आहे:

• नोडचा REST API एंडपॉइंट जो नेटवर्कचा dApp आणि CHAIN_ID लाँच करण्यासाठी वापरला जाईल.
• टोकन असलेल्या खात्यासाठी गुप्त वाक्यांश जे तुमच्या चाचणी टोकनचे स्रोत असतील.

तुम्ही बघू शकता, surfboard.config.json डीफॉल्टनुसार एकाधिक वातावरणास समर्थन देते. डीफॉल्ट स्थानिक वातावरण आहे (डीफॉल्ट एनव्ही की बदलण्यायोग्य पॅरामीटर आहे).

वॉलेट-डेमो अनुप्रयोग

हा विभाग RIDE भाषेचा संदर्भ नाही. त्याऐवजी, ब्लॉकचेनमध्ये काय चालले आहे हे अधिक चांगल्या प्रकारे समजून घेण्यासाठी आम्ही उपयोजित केलेला अनुप्रयोग आणि चाचणी करतो.

चला एक साधा वॉलेट-डेमो ऍप्लिकेशन पाहू. dApp पत्त्यावर कोणीही टोकन पाठवू शकतो. तुम्ही फक्त तुमच्या WAVES मागे घेऊ शकता. दोन @Callable फंक्शन्स InvokeScriptTransaction द्वारे उपलब्ध आहेत:

• deposit()ज्यासाठी WAVES मध्ये संलग्न पेमेंट आवश्यक आहे
• withdraw(amount: Int)जे टोकन परत करते

संपूर्ण dApp लाइफसायकलमध्ये, रचना (पत्ता → रक्कम) राखली जाईल:

कृती
परिणामी राज्य

प्रारंभिक
रिक्त

अॅलिस 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 प्लगइन फाइल संपादित करताना सतत संकलनाला समर्थन देते. म्हणून, आपण नेहमी समस्या टॅबमधील त्रुटींचे परीक्षण करू शकता.

फाइल संकलित करताना तुम्हाला वेगळा टेक्स्ट एडिटर वापरायचा असल्यास, वापरा

surfboard compile ride/wallet.ride

हे बेस64 संकलित राइड कोडची मालिका आउटपुट करेल.

'wallet.ride' साठी चाचणी स्क्रिप्ट

बघूया चाचणी फाइल. JavaScript च्या मोचा फ्रेमवर्कद्वारे समर्थित. "पूर्वी" फंक्शन आणि तीन चाचण्या आहेत:

• "पूर्वी" MassTransferTransaction द्वारे एकाधिक खात्यांना निधी देते, स्क्रिप्ट संकलित करते आणि ब्लॉकचेनवर तैनात करते.
• "कॅन डिपॉझिट" नेटवर्कवर InvokeScriptTransaction पाठवते, दोन खात्यांपैकी प्रत्येकासाठी deposit() फंक्शन सक्रिय करते.
• कोणीही इतर लोकांचे टोकन चोरू शकत नाही अशा चाचण्या “जमा केल्यापेक्षा जास्त पैसे काढू शकत नाही”.
• पैसे काढण्याची प्रक्रिया योग्य प्रकारे केली जात असल्याचे धनादेश “जमा करू शकतात”.

सर्फबोर्डवरून चाचण्या चालवा आणि 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)

हुर्रे! चाचण्या पास झाल्या. आता वेव्ह्स एक्सप्लोरर वापरताना काय होते ते पाहू: ब्लॉक्स पहा किंवा वरील पत्त्यांपैकी एक शोध मध्ये पेस्ट करा (उदाहरणार्थ, संबंधित wallet#. तेथे तुम्हाला व्यवहार इतिहास, dApp स्थिती, डीकंपाइल बायनरी फाइल मिळू शकते.

लाटा एक्सप्लोरर. नुकताच उपयोजित केलेला अर्ज.

काही सर्फबोर्ड टिपा:

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. "ठेव" फील्डमध्ये एक लहान रक्कम प्रविष्ट करा आणि बटणावर क्लिक करा:

Waves Keeper 10 WAVES च्या पेमेंटसह InvokeScriptTransaction वर स्वाक्षरी करण्यासाठी परवानगीची विनंती करतो.

6. व्यवहाराची पुष्टी करा:

व्यवहार तयार केला जातो आणि नेटवर्कवर प्रसारित केला जातो. आता तुम्ही तिचा आयडी पाहू शकता

7. Waves Explorer वापरून व्यवहाराचे निरीक्षण करा. शोध क्षेत्रात ID प्रविष्ट करा

निष्कर्ष आणि अतिरिक्त माहिती

आम्ही Waves Platform वर साधे dApps विकसित करणे, चाचणी करणे, उपयोजित करणे आणि वापरणे यासाठी साधने पाहिली:

• राइड भाषा
• व्हीएस कोड एडिटर
• वेव्ह एक्सप्लोरर
• सर्फबोर्ड
• लाटा कीपर

ज्यांना RIDE शिकणे सुरू ठेवायचे आहे त्यांच्यासाठी लिंक्स:

अधिक उदाहरणे
उदाहरणांसह ऑनलाइन IDE
लाटा दस्तऐवजीकरण
टेलीग्राममध्ये विकसक चॅट
स्टॅकओव्हरफ्लोवर लाटा आणि राइड
नवीन! वेव्हज प्लॅटफॉर्मवर dApps तयार करण्यासाठी ऑनलाइन अभ्यासक्रम

RIDE विषयात जाणे सुरू ठेवा आणि तुमचे पहिले dApp तयार करा!

TL; डॉ: bit.ly/2YCFnwY

स्त्रोत: www.habr.com