🥇TON (टेलीग्राम ओपन नेटवर्क) टेस्ट क्लाइंट और स्मार्ट कॉन्ट्रैक्ट के लिए नई फिफ्ट भाषा

एक साल से भी अधिक समय पहले, टेलीग्राम मैसेंजर द्वारा अपना स्वयं का विकेन्द्रीकृत नेटवर्क जारी करने की योजना के बारे में पता चला टेलीग्राम ओपन नेटवर्क. फिर एक विशाल तकनीकी दस्तावेज़ उपलब्ध हुआ, जो कथित तौर पर निकोलाई डुरोव द्वारा लिखा गया था और भविष्य के नेटवर्क की संरचना का वर्णन किया गया था। जो लोग इसे देखने से चूक गए, उनके लिए मेरा सुझाव है कि आप इस दस्तावेज़ के बारे में मेरी दोबारा कही गई बातें पढ़ें (भाग 1, भाग 2; अफसोस, तीसरा भाग अभी भी ड्राफ्ट में धूल जमा कर रहा है)।

तब से, कुछ दिन पहले (एक में) तक TON विकास की स्थिति के बारे में कोई महत्वपूर्ण खबर नहीं आई है अनौपचारिक चैनल) पेज का लिंक दिखाई नहीं दिया https://test.ton.org/download.html, कहाँ स्थित हैं:
◦ टन-टेस्ट-लाइटक्लाइंट-फुल.टार.xz - TON परीक्षण नेटवर्क के लिए लाइट क्लाइंट के स्रोत;
◦ टन-लाइट-क्लाइंट-test1.config.json - परीक्षण नेटवर्क से कनेक्ट करने के लिए कॉन्फ़िगरेशन फ़ाइल;
◦ README — क्लाइंट बनाने और लॉन्च करने के बारे में जानकारी;
◦ कैसे — क्लाइंट का उपयोग करके स्मार्ट अनुबंध बनाने पर चरण-दर-चरण निर्देश;
◦ टन.पीडीएफ - TON नेटवर्क के तकनीकी अवलोकन के साथ अद्यतन दस्तावेज़ (दिनांक 2 मार्च, 2019);
◦ tvm.pdf - टीवीएम (टीओएन वर्चुअल मशीन, टीओएन वर्चुअल मशीन) का तकनीकी विवरण;
◦ tblkch.pdf - TON ब्लॉकचेन का तकनीकी विवरण;
◦ पांचवांबेस.पीडीएफ - TON में स्मार्ट कॉन्ट्रैक्ट बनाने के लिए डिज़ाइन की गई नई Fift भाषा का विवरण।

मैं दोहराता हूं, टेलीग्राम से पेज और इन सभी दस्तावेजों की कोई आधिकारिक पुष्टि नहीं हुई है, लेकिन इन सामग्रियों की मात्रा उन्हें काफी प्रशंसनीय बनाती है। प्रकाशित क्लाइंट लॉन्च करें अपने जोखिम पर.

एक परीक्षण ग्राहक का निर्माण

सबसे पहले, आइए एक परीक्षण क्लाइंट बनाने और चलाने का प्रयास करें - सौभाग्य से, README इस सरल प्रक्रिया का विस्तार से वर्णन करता है। मैं उदाहरण के तौर पर macOS 10.14.5 का उपयोग करके ऐसा करूंगा; मैं अन्य प्रणालियों पर निर्माण की सफलता की गारंटी नहीं दे सकता।

डाउनलोड करें और अनपैक करें स्रोत पुरालेख. नवीनतम संस्करण डाउनलोड करना महत्वपूर्ण है क्योंकि इस स्तर पर बैकवर्ड संगतता की गारंटी नहीं है।
सुनिश्चित करें कि मेक, सेमेक (संस्करण 3.0.2 या उच्चतर), ओपनएसएसएल (सी हेडर फ़ाइलों सहित), जी++ या क्लैंग के नवीनतम संस्करण सिस्टम पर स्थापित हैं। मुझे कुछ भी इंस्टॉल नहीं करना पड़ा, सब कुछ तुरंत एक साथ आ गया।
आइए मान लें कि स्रोत एक फ़ोल्डर में अनपॅक किए गए हैं ~/lite-client. इससे अलग, इकट्ठे प्रोजेक्ट के लिए एक खाली फ़ोल्डर बनाएं (उदाहरण के लिए, ~/liteclient-build), और इससे (cd ~/liteclient-build) आदेशों को कॉल करें:
```
cmake ~/lite-client
cmake --build . --target test-lite-client
```
स्मार्ट कॉन्ट्रैक्ट के लिए फिफ्ट भाषा दुभाषिया बनाने के लिए (इसके बारे में अधिक जानकारी नीचे दी गई है), हम भी कॉल करते हैं
```
cmake --build . --target fift
```
वर्तमान डाउनलोड करें विन्यास फाइल परीक्षण नेटवर्क से कनेक्ट करने और इसे असेंबल किए गए क्लाइंट वाले फ़ोल्डर में डालने के लिए।
अंत, आप क्लाइंट प्रारंभ कर सकते हैं:
```
./test-lite-client -C ton-lite-client-test1.config.json
```

यदि सब कुछ सही ढंग से किया गया है, तो आपको कुछ इस तरह देखना चाहिए:

जैसा कि हम देख सकते हैं, कुछ ही कमांड उपलब्ध हैं:
◦ help - आदेशों की इस सूची को प्रदर्शित करें;
◦ quit - बाहर जाओ;
◦ time - सर्वर पर वर्तमान समय दिखाएं;
◦ status - कनेक्शन और स्थानीय डेटाबेस स्थिति दिखाएं;
◦ last - ब्लॉकचेन की स्थिति को अपडेट करें (अंतिम ब्लॉक डाउनलोड करें)। यह सुनिश्चित करने के लिए कि आप नेटवर्क की वर्तमान स्थिति देख रहे हैं, किसी भी अनुरोध से पहले इस कमांड को चलाना महत्वपूर्ण है।
◦ sendfile <filename> — TON नेटवर्क पर एक स्थानीय फ़ाइल अपलोड करें। इस प्रकार नेटवर्क के साथ इंटरेक्शन होता है - उदाहरण के लिए, नए स्मार्ट अनुबंधों का निर्माण और खातों के बीच धन हस्तांतरित करने का अनुरोध;
◦ getaccount <address> - वर्तमान दिखाएं (जिस समय कमांड निष्पादित किया गया था) last) निर्दिष्ट पते के साथ खाते की स्थिति;
◦ privkey <filename> - स्थानीय फ़ाइल से निजी कुंजी लोड करें।

यदि, क्लाइंट प्रारंभ करते समय, आप विकल्प का उपयोग करके उसमें एक फ़ोल्डर स्थानांतरित करते हैं -D, फिर वह इसमें मास्टरचेन का अंतिम ब्लॉक जोड़ देगा:

./test-lite-client -C ton-lite-client-test1.config.json -D ~/ton-db-dir

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

भाषा पाँचवीं

दस्तावेज़ से पांचवांबेस.पीडीएफ आप पा सकते हैं कि टेलीग्राम टीम ने स्मार्ट कॉन्ट्रैक्ट बनाने के लिए एक नई स्टैक भाषा बनाई है पाँचवाँ (जाहिरा तौर पर अंक से पांचवां, फोर्थ के समान, एक ऐसी भाषा जिसके साथ फिफ्थ में बहुत कुछ समानता है)।

दस्तावेज़ काफी बड़ा है, 87 पृष्ठ, और मैं इस लेख के ढांचे के भीतर इसकी सामग्री को विस्तार से दोबारा नहीं बताऊंगा (कम से कम इसलिए कि मैंने इसे स्वयं पढ़ना समाप्त नहीं किया है :)। मैं मुख्य बिंदुओं पर ध्यान केंद्रित करूंगा और इस भाषा में कुछ कोड उदाहरण दूंगा।

बुनियादी स्तर पर, फिफ्ट का सिंटैक्स काफी सरल है: इसके कोड में शामिल हैं शब्द, आमतौर पर रिक्त स्थान या लाइन ब्रेक द्वारा अलग किया जाता है (विशेष मामले: कुछ शब्दों को अपने बाद विभाजक की आवश्यकता नहीं होती है)। कोई शब्द वर्णों का एक केस-संवेदी अनुक्रम है जो एक निश्चित से मेल खाता है परिभाषा (मोटे तौर पर, जब दुभाषिया का सामना इस शब्द से होता है तो उसे क्या करना चाहिए)। यदि किसी शब्द की कोई परिभाषा नहीं है, तो दुभाषिया उसे एक संख्या के रूप में पार्स करने और स्टैक पर रखने का प्रयास करता है। वैसे, यहाँ संख्याएँ हैं - अचानक - 257-बिट पूर्णांक, और कोई भिन्न नहीं हैं - अधिक सटीक रूप से, वे तुरंत पूर्णांकों की एक जोड़ी में बदल जाते हैं, जिससे एक तर्कसंगत भिन्न का अंश और हर बनता है।

शब्द स्टैक के शीर्ष पर मानों के साथ परस्पर क्रिया करते हैं। एक अलग प्रकार के शब्द - उपसर्ग - स्टैक का उपयोग नहीं करता है, लेकिन स्रोत फ़ाइल से बाद के वर्णों का उपयोग करता है। उदाहरण के लिए, स्ट्रिंग अक्षर इस प्रकार कार्यान्वित किए जाते हैं - उद्धरण वर्ण (") एक उपसर्ग शब्द है जो अगले (समापन) उद्धरण की तलाश करता है, और उनके बीच की स्ट्रिंग को स्टैक पर धकेलता है। वन-लाइनर उसी तरह व्यवहार करते हैं (//) और मल्टीलाइन (/*) टिप्पणियाँ।

यहीं पर भाषा की लगभग संपूर्ण आंतरिक संरचना समाप्त हो जाती है। बाकी सब कुछ (नियंत्रण संरचनाओं सहित) को शब्दों के रूप में परिभाषित किया गया है (या तो आंतरिक, जैसे अंकगणितीय संचालन और नए शब्दों की परिभाषा; या "मानक पुस्तकालय" में परिभाषित) Fift.fif, जो फ़ोल्डर में है crypto/fift सूत्रों में)

Fift में एक सरल उदाहरण प्रोग्राम:

{ dup =: x dup * =: y } : setxy
3 setxy x . y . x y + .
7 setxy x . y . x y + .

पहली पंक्ति एक नये शब्द को परिभाषित करती है setxy (उपसर्ग पर ध्यान दें {, जो समापन से पहले एक ब्लॉक बनाता है } और उपसर्ग :, जो वास्तव में शब्द को परिभाषित करता है)। setxy स्टैक के शीर्ष से एक संख्या लेता है, इसे वैश्विक के रूप में परिभाषित (या पुनः परिभाषित) करता है स्थिर x, और इस संख्या का वर्ग एक स्थिरांक के रूप में y (यह देखते हुए कि स्थिरांक के मूल्यों को फिर से परिभाषित किया जा सकता है, मैं उन्हें चर कहूंगा, लेकिन मैं भाषा में नामकरण परंपरा का पालन करता हूं)।

अगली दो पंक्तियों में स्टैक पर एक नंबर डालें और कॉल करें setxy, तो स्थिरांक के मान प्रदर्शित होते हैं x, y (यह शब्द आउटपुट के लिए प्रयोग किया जाता है .), दोनों स्थिरांक को स्टैक पर रखा जाता है, सारांशित किया जाता है, और परिणाम भी मुद्रित किया जाता है। परिणामस्वरूप हम देखेंगे:

3 9 12 ok
7 49 56 ok

(लाइन "ओके" इंटरैक्टिव इनपुट मोड में वर्तमान लाइन को संसाधित करने के बाद दुभाषिया द्वारा मुद्रित की जाती है)

खैर, एक पूर्ण कोड उदाहरण:

"Asm.fif" include

-1 constant wc  // create a wallet in workchain -1 (masterchain)

// Create new simple wallet
<{  SETCP0 DUP IFNOTRET INC 32 THROWIF  // return if recv_internal, fail unless recv_external
    512 INT LDSLICEX DUP 32 PLDU   // sign cs cnt
    c4 PUSHCTR CTOS 32 LDU 256 LDU ENDS  // sign cs cnt cnt' pubk
    s1 s2 XCPU            // sign cs cnt pubk cnt' cnt
    EQUAL 33 THROWIFNOT   // ( seqno mismatch? )
    s2 PUSH HASHSU        // sign cs cnt pubk hash
    s0 s4 s4 XC2PU        // pubk cs cnt hash sign pubk
    CHKSIGNU              // pubk cs cnt ?
    34 THROWIFNOT         // signature mismatch
    ACCEPT
    SWAP 32 LDU NIP 
    DUP SREFS IF:<{
      8 LDU LDREF         // pubk cnt mode msg cs
      s0 s2 XCHG SENDRAWMSG  // pubk cnt cs ; ( message sent )
    }>
    ENDS
    INC NEWC 32 STU 256 STU ENDC c4 POPCTR
}>c
// code
<b 0 32 u, 
   newkeypair swap dup constant wallet_pk 
   "new-wallet.pk" B>file
   B, 
b> // data
// no libraries
<b b{00110} s, rot ref, swap ref, b>  // create StateInit
dup ."StateInit: " <s csr. cr
dup hash dup constant wallet_addr
."new wallet address = " wc . .": " dup x. cr
wc over 7 smca>$ type cr
256 u>B "new-wallet.addr" B>file
<b 0 32 u, b>
dup ."signing message: " <s csr. cr
dup hash wallet_pk ed25519_sign_uint rot
<b b{1000100} s, wc 8 i, wallet_addr 256 u, b{000010} s, swap <s s, b{0} s, swap B, swap <s s, b>
dup ."External message for initialization is " <s csr. cr
2 boc+>B dup Bx. cr
"new-wallet-query.boc" tuck B>file
."(Saved to file " type .")" cr

यह डरावनी दिखने वाली फ़ाइल एक स्मार्ट अनुबंध बनाने के लिए है - इसे एक फ़ाइल में रखा जाएगा new-wallet-query.boc निष्पादन के बाद. कृपया ध्यान दें कि यहां TON वर्चुअल मशीन के लिए एक अन्य असेंबली भाषा का उपयोग किया जाता है (मैं इस पर विस्तार से ध्यान नहीं दूंगा), जिसके निर्देश ब्लॉकचेन पर रखे जाएंगे।

इस प्रकार, टीवीएम के लिए असेंबलर फिफ्ट में लिखा गया है - इस असेंबलर के स्रोत फ़ाइल में हैं crypto/fift/Asm.fif और कोड के उपरोक्त भाग की शुरुआत में जुड़े हुए हैं।

मैं क्या कह सकता हूं, जाहिर तौर पर निकोलाई ड्यूरोव को नई प्रोग्रामिंग भाषाएं बनाना पसंद है :)

एक स्मार्ट अनुबंध बनाना और TON के साथ बातचीत करना

तो, मान लीजिए कि हमने ऊपर वर्णित अनुसार TON क्लाइंट और फिफ्ट दुभाषिया को इकट्ठा कर लिया है और भाषा से परिचित हो गए हैं। अब स्मार्ट कॉन्ट्रैक्ट कैसे बनाएं? यह फ़ाइल में वर्णित है कैसे, सूत्रों से जुड़ा हुआ है।

TON में खाते

जैसा कि मैंने वर्णन किया है टन समीक्षा, इस नेटवर्क में एक से अधिक ब्लॉकचेन शामिल हैं - एक सामान्य ब्लॉकचेन है, तथाकथित। "मास्टर चेन", साथ ही अतिरिक्त "वर्क चेन" की एक मनमानी संख्या, जिसे 32-बिट संख्या द्वारा पहचाना जाता है। मास्टरचेन में -1 का एक पहचानकर्ता होता है; इसके अतिरिक्त, 0 के पहचानकर्ता के साथ एक "बेस" वर्कचेन का भी उपयोग किया जा सकता है। प्रत्येक वर्कचेन का अपना कॉन्फ़िगरेशन हो सकता है। आंतरिक रूप से, प्रत्येक वर्कचेन को शार्डचेन में विभाजित किया गया है, लेकिन यह एक कार्यान्वयन विवरण है जिसे ध्यान में रखने की आवश्यकता नहीं है।

एक कार्यश्रृंखला के भीतर, कई खाते संग्रहीत होते हैं जिनके अपने स्वयं के खाता_आईडी पहचानकर्ता होते हैं। मास्टर चेन और शून्य कार्य श्रृंखला के लिए, वे 256 बिट लंबे हैं। इस प्रकार, खाता पहचानकर्ता, उदाहरण के लिए, इस प्रकार लिखा जाता है:

-1:8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d

यह "कच्चा" प्रारूप है: पहले वर्कचेन आईडी, फिर एक कोलन, और हेक्साडेसिमल नोटेशन में खाता आईडी।

इसके अलावा, एक संक्षिप्त प्रारूप है - वर्कचेन नंबर और खाता पता बाइनरी फॉर्म में एन्कोड किया गया है, एक चेकसम जोड़ा गया है, और यह सब बेस 64 में एन्कोड किया गया है:

Ef+BVndbeTJeXWLnQtm5bDC2UVpc0vH2TF2ksZPAPwcODSkb

इस रिकॉर्ड प्रारूप को जानने के बाद, हम कमांड का उपयोग करके परीक्षण क्लाइंट के माध्यम से किसी खाते की वर्तमान स्थिति का अनुरोध कर सकते हैं

getaccount -1:8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d

हमें कुछ इस तरह मिलेगा:

[ 3][t 2][1558746708.815218925][test-lite-client.cpp:631][!testnode]    requesting account state for -1:8156775B79325E5D62E742D9B96C30B6515A5CD2F1F64C5DA4B193C03F070E0D
[ 3][t 2][1558746708.858564138][test-lite-client.cpp:652][!testnode]    got account state for -1:8156775B79325E5D62E742D9B96C30B6515A5CD2F1F64C5DA4B193C03F070E0D with respect to blocks (-1,8000000000000000,72355):F566005749C1B97F18EDE013EBA7A054B9014961BC1AD91F475B9082919A2296:1BD5DE54333164025EE39D389ECE2E93DA2871DA616D488253953E52B50DC03F and (-1,8000000000000000,72355):F566005749C1B97F18EDE013EBA7A054B9014961BC1AD91F475B9082919A2296:1BD5DE54333164025EE39D389ECE2E93DA2871DA616D488253953E52B50DC03F
account state is (account
  addr:(addr_std
    anycast:nothing workchain_id:-1 address:x8156775B79325E5D62E742D9B96C30B6515A5CD2F1F64C5DA4B193C03F070E0D)
  storage_stat:(storage_info
    used:(storage_used
      cells:(var_uint len:1 value:3)
      bits:(var_uint len:2 value:539)
      public_cells:(var_uint len:0 value:0)) last_paid:0
    due_payment:nothing)
  storage:(account_storage last_trans_lt:74208000003
    balance:(currencies
      grams:(nanograms
        amount:(var_uint len:7 value:999928362430000))
      other:(extra_currencies
        dict:hme_empty))
    state:(account_active
      (
        split_depth:nothing
        special:nothing
        code:(just
          value:(raw@^Cell 
            x{}
             x{FF0020DDA4F260D31F01ED44D0D31FD166BAF2A1F80001D307D4D1821804A817C80073FB0201FB00A4C8CB1FC9ED54}
            ))
        data:(just
          value:(raw@^Cell 
            x{}
             x{0000000D}
            ))
        library:hme_empty))))
x{CFF8156775B79325E5D62E742D9B96C30B6515A5CD2F1F64C5DA4B193C03F070E0D2068086C000000000000000451C90E00DC0E35B7DB5FB8C134_}
 x{FF0020DDA4F260D31F01ED44D0D31FD166BAF2A1F80001D307D4D1821804A817C80073FB0201FB00A4C8CB1FC9ED54}
 x{0000000D}

हम वह संरचना देखते हैं जो निर्दिष्ट वर्कचेन के DHT में संग्रहीत है। उदाहरण के लिए, क्षेत्र में storage.balance चालू खाता शेष है, में storage.state.code - स्मार्ट कॉन्ट्रैक्ट कोड, और में storage.state.data - इसका वर्तमान डेटा. कृपया ध्यान दें कि TON डेटा स्टोरेज - सेल, सेल - पेड़ की तरह है, प्रत्येक सेल में अपना डेटा और चाइल्ड सेल दोनों हो सकते हैं। इसे अंतिम पंक्तियों में इंडेंटेशन के रूप में दिखाया गया है।

एक स्मार्ट अनुबंध का निर्माण

आइए अब ऐसी संरचना स्वयं बनाएं (इसे बीओसी कहा जाता है - कोशिकाओं का थैला) पाँचवीं भाषा का उपयोग करना। सौभाग्य से, आपको फ़ोल्डर में स्वयं एक स्मार्ट अनुबंध लिखने की ज़रूरत नहीं है crypto/block स्रोत संग्रह से एक फ़ाइल है new-wallet.fif, जो हमें एक नया वॉलेट बनाने में मदद करेगा। आइए इसे असेंबल किए गए क्लाइंट वाले फ़ोल्डर में कॉपी करें (~/liteclient-build, यदि आपने ऊपर दिए गए निर्देशों का पालन किया है)। मैंने उपरोक्त इसकी सामग्री को फिफ्ट पर कोड के उदाहरण के रूप में उद्धृत किया है।

इस फ़ाइल को इस प्रकार निष्पादित करें:

./crypto/fift -I"<source-directory>/crypto/fift" new-wallet.fif

यहां <source-directory> अनपैक्ड स्रोतों के पथ के साथ प्रतिस्थापित किया जाना चाहिए (दुर्भाग्य से, "~" प्रतीक का उपयोग यहां नहीं किया जा सकता है, पूर्ण पथ की आवश्यकता है)। इसके बजाय एक कुंजी का उपयोग करें -I आप एक पर्यावरण चर परिभाषित कर सकते हैं FIFTPATH और इस पथ को इसमें डालें.

चूँकि हमने फ़ाइल नाम के साथ Fift लॉन्च किया है new-wallet.fif, यह इसे निष्पादित करेगा और बाहर निकल जाएगा। यदि आप फ़ाइल नाम छोड़ देते हैं, तो आप इंटरैक्टिव रूप से दुभाषिया के साथ खेल सकते हैं।

निष्पादन के बाद, कंसोल में कुछ इस तरह प्रदर्शित होना चाहिए:

StateInit: x{34_}
 x{FF0020DDA4F260810200D71820D70B1FED44D0D31FD3FFD15112BAF2A122F901541044F910F2A2F80001D31F3120D74A96D307D402FB00DED1A4C8CB1FCBFFC9ED54}
 x{0000000055375F730EDC2292E8CB15C42E8036EE9C25AA958EE002D2DE48A205E3A3426B}

new wallet address = -1 : 4fcd520b8fcca096b567d734be3528edc6bed005f6930a9ec9ac1aa714f211f2 
0f9PzVILj8yglrVn1zS-NSjtxr7QBfaTCp7JrBqnFPIR8nhZ
signing message: x{00000000}

External message for initialization is x{89FEE120E20C7E953E31546F64C23CD654002C1AA919ADD24DB12DDF85C6F3B58AE41198A28AD8DAF3B9588E7A629252BA3DB88F030D00BC1016110B2073359EAC3C13823C53245B65D056F2C070B940CDA09789585935C7ABA4D2AD4BED139281CFA1200000001_}
 x{FF0020DDA4F260810200D71820D70B1FED44D0D31FD3FFD15112BAF2A122F901541044F910F2A2F80001D31F3120D74A96D307D402FB00DED1A4C8CB1FCBFFC9ED54}
 x{0000000055375F730EDC2292E8CB15C42E8036EE9C25AA958EE002D2DE48A205E3A3426B}

B5EE9C724104030100000000D60002CF89FEE120E20C7E953E31546F64C23CD654002C1AA919ADD24DB12DDF85C6F3B58AE41198A28AD8DAF3B9588E7A629252BA3DB88F030D00BC1016110B2073359EAC3C13823C53245B65D056F2C070B940CDA09789585935C7ABA4D2AD4BED139281CFA1200000001001020084FF0020DDA4F260810200D71820D70B1FED44D0D31FD3FFD15112BAF2A122F901541044F910F2A2F80001D31F3120D74A96D307D402FB00DED1A4C8CB1FCBFFC9ED5400480000000055375F730EDC2292E8CB15C42E8036EE9C25AA958EE002D2DE48A205E3A3426B6290698B
(Saved to file new-wallet-query.boc)

इसका मतलब है कि आईडी वाला वॉलेट -1:4fcd520b8fcca096b567d734be3528edc6bed005f6930a9ec9ac1aa714f211f2 (या, वही क्या है, 0f9PzVILj8yglrVn1zS-NSjtxr7QBfaTCp7JrBqnFPIR8nhZ) सफलतापूर्वक बनाया गया. संबंधित कोड फ़ाइल में होगा new-wallet-query.boc, उसका पता है new-wallet.addr, और निजी कुंजी अंदर है new-wallet.pk (सावधान रहें - स्क्रिप्ट को दोबारा चलाने से ये फ़ाइलें ओवरराइट हो जाएंगी)।

बेशक, TON नेटवर्क को अभी तक इस वॉलेट के बारे में पता नहीं है; यह केवल इन फ़ाइलों के रूप में संग्रहीत है। अब इसे नेटवर्क पर अपलोड करना होगा। हालाँकि, समस्या यह है कि स्मार्ट अनुबंध बनाने के लिए आपको एक कमीशन का भुगतान करना होगा, और आपके खाते की शेष राशि अभी भी शून्य है।

कार्यशील मोड में, एक्सचेंज पर ग्राम खरीदकर (या किसी अन्य वॉलेट से ट्रांसफर करके) इस समस्या का समाधान किया जाएगा। खैर, वर्तमान परीक्षण मोड में, एक विशेष स्मार्ट अनुबंध बनाया गया है, जिससे आप ऐसे ही 20 ग्राम तक मांग सकते हैं।

किसी अन्य के स्मार्ट अनुबंध के लिए अनुरोध उत्पन्न करना

हम एक स्मार्ट अनुबंध से अनुरोध करते हैं जो ग्राम को इस तरह बाएँ और दाएँ वितरित करता है। उसी फ़ोल्डर में crypto/block फ़ाइल ढूंढे testgiver.fif:

// "testgiver.addr" file>B 256 B>u@ 
0x8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d
dup constant wallet_addr ."Test giver address = " x. cr

0x4fcd520b8fcca096b567d734be3528edc6bed005f6930a9ec9ac1aa714f211f2
constant dest_addr

-1 constant wc
0x00000011 constant seqno

1000000000 constant Gram
{ Gram swap */ } : Gram*/

6.666 Gram*/ constant amount

// b x --> b'  ( serializes a Gram amount )
{ -1 { 1+ 2dup 8 * ufits } until
  rot over 4 u, -rot 8 * u, } : Gram, 

// create a message (NB: 01b00.., b = bounce)
<b b{010000100} s, wc 8 i, dest_addr 256 u, amount Gram, 0 9 64 32 + + 1+ 1+ u, "GIFT" $, b>
<b seqno 32 u, 1 8 u, swap ref, b>
dup ."enveloping message: " <s csr. cr
<b b{1000100} s, wc 8 i, wallet_addr 256 u, 0 Gram, b{00} s,
   swap <s s, b>
dup ."resulting external message: " <s csr. cr
2 boc+>B dup Bx. cr
"wallet-query.boc" B>file

हम इसे असेंबल किए गए क्लाइंट के साथ फ़ोल्डर में भी सहेजेंगे, लेकिन हम पांचवीं पंक्ति को सही करेंगे - लाइन से पहले "constant dest_addr". आइए इसे आपके द्वारा पहले बनाए गए वॉलेट के पते से बदलें (पूर्ण, संक्षिप्त नहीं)। शुरुआत में "-1:" लिखने की जरूरत नहीं है, बल्कि शुरुआत में "0x" लिखें।

आप लाइन भी बदल सकते हैं 6.666 Gram*/ constant amount — यह ग्राम में वह मात्रा है जिसका आप अनुरोध कर रहे हैं (20 से अधिक नहीं)। भले ही आप पूर्ण संख्या निर्दिष्ट करें, दशमलव बिंदु छोड़ दें।

अंत में, आपको लाइन को सही करने की आवश्यकता है 0x00000011 constant seqno. यहां पहला नंबर वर्तमान अनुक्रम संख्या है, जो ग्राम जारी करने वाले खाते में संग्रहीत है। मैं इसे कहां से प्राप्त कर सकता हूं? जैसा कि ऊपर कहा गया है, क्लाइंट प्रारंभ करें और चलाएँ:

last
getaccount -1:8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d

सबसे अंत में, स्मार्ट अनुबंध डेटा शामिल होगा

...
x{FF0020DDA4F260D31F01ED44D0D31FD166BAF2A1F80001D307D4D1821804A817C80073FB0201FB00A4C8CB1FC9ED54}
 x{0000000D}

संख्या 0000000D (आपकी बड़ी होगी) अनुक्रम संख्या है जिसे प्रतिस्थापित किया जाना चाहिए testgiver.fif.

बस इतना ही, फ़ाइल को सहेजें और चलाएँ (./crypto/fift testgiver.fif). आउटपुट एक फ़ाइल होगी wallet-query.boc. इसी से बनता है сообщение किसी और के स्मार्ट अनुबंध के लिए - एक अनुरोध "इतने ग्राम को अमुक खाते में स्थानांतरित करें।"

क्लाइंट का उपयोग करके, हम इसे नेटवर्क पर अपलोड करते हैं:

> sendfile wallet-query.boc
[ 1][t 1][1558747399.456575155][test-lite-client.cpp:577][!testnode]    sending query from file wallet-query.boc
[ 3][t 2][1558747399.500236034][test-lite-client.cpp:587][!query]   external message status is 1

यदि आप अभी कॉल करते हैं last, और फिर उस खाते की स्थिति का अनुरोध करें जिससे हमने ग्राम मांगा था, फिर हमें देखना चाहिए कि इसकी अनुक्रम संख्या एक से बढ़ गई है - इसका मतलब है कि इसने हमारे खाते में पैसा भेजा है।

अंतिम चरण शेष है - हमारे वॉलेट का कोड डाउनलोड करें (इसकी शेष राशि पहले ही भर दी गई है, लेकिन स्मार्ट अनुबंध कोड के बिना हम इसे प्रबंधित नहीं कर पाएंगे)। हम निभाते हैं sendfile new-wallet-query.boc - और बस, आपके पास TON नेटवर्क पर अपना खुद का वॉलेट है (भले ही यह अभी के लिए केवल एक परीक्षण हो)।

आउटगोइंग लेनदेन बनाना

बनाए गए अकाउंट के बैलेंस से पैसे ट्रांसफर करने के लिए एक फाइल होती है crypto/block/wallet.fif, जिसे असेंबल किए गए क्लाइंट के साथ फ़ोल्डर में भी रखना होगा।

पिछले चरणों के समान, आपको आपके द्वारा स्थानांतरित की जा रही राशि, प्राप्तकर्ता का पता (dest_addr), और आपके वॉलेट का seqno समायोजित करने की आवश्यकता है (यह वॉलेट प्रारंभ करने के बाद 1 के बराबर है और प्रत्येक आउटगोइंग लेनदेन के बाद 1 बढ़ जाता है - आप ऐसा कर सकते हैं) अपने खाते की स्थिति का अनुरोध करके इसे देखें)। परीक्षणों के लिए, आप उपयोग कर सकते हैं, उदाहरण के लिए, मेरा बटुआ - 0x4fcd520b8fcca096b567d734be3528edc6bed005f6930a9ec9ac1aa714f211f2.

चालू होने पर (./crypto/fift wallet.fif) स्क्रिप्ट आपके वॉलेट का पता (जहां से आप ट्रांसफर करते हैं) और फाइलों से उसकी निजी कुंजी लेगी new-wallet.addr и new-wallet.pk, और प्राप्त संदेश को लिखा जाएगा new-wallet-query.boc.

पहले की तरह, सीधे लेनदेन करने के लिए कॉल करें sendfile new-wallet-query.boc ग्राहक में. इसके बाद ब्लॉकचेन की स्थिति को अपडेट करना न भूलें (last) और जांचें कि हमारे वॉलेट का बैलेंस और सेकनो बदल गया है (getaccount <account_id>).

बस इतना ही, अब हम TON में स्मार्ट कॉन्ट्रैक्ट बना सकते हैं और उन्हें अनुरोध भेज सकते हैं। जैसा कि आप देख सकते हैं, वर्तमान कार्यक्षमता पहले से ही पर्याप्त है, उदाहरण के लिए, ग्राफिकल इंटरफ़ेस के साथ एक अधिक अनुकूल वॉलेट बनाएं (हालांकि, यह उम्मीद की जाती है कि यह पहले से ही मैसेंजर के हिस्से के रूप में उपलब्ध हो जाएगा)।

केवल पंजीकृत उपयोगकर्ता ही सर्वेक्षण में भाग ले सकते हैं। साइन इन करेंकृपया।

क्या आप TON, TVM, Fift के विश्लेषण के साथ लेख जारी रखने में रुचि रखते हैं?

हां, मैं TON के सामान्य अवलोकन के साथ लेखों की श्रृंखला के पूरा होने की प्रतीक्षा कर रहा हूं
हां, फिफ्ट भाषा के बारे में और अधिक पढ़ना दिलचस्प है
हां, मैं TON वर्चुअल मशीन और इसके लिए असेंबलर के बारे में अधिक जानना चाहता हूं
नहीं, इनमें से कुछ भी दिलचस्प नहीं है

39 उपयोगकर्ताओं ने मतदान किया। 12 उपयोगकर्ता अनुपस्थित रहे।

TON लॉन्च करने की टेलीग्राम की योजना के बारे में आप क्या सोचते हैं?

मुझे इस प्रोजेक्ट से बहुत उम्मीदें हैं
मैं बस रुचि के साथ इसके विकास का अनुसरण कर रहा हूं।
मैं सशंकित हूं और इसकी सफलता पर संदेह करता हूं।
मैं इस पहल को व्यापक जनता के लिए असफल और अनावश्यक मानने को इच्छुक हूं

47 उपयोगकर्ताओं ने मतदान किया। 12 उपयोगकर्ता अनुपस्थित रहे।

स्रोत: www.habr.com

स्मार्ट कॉन्ट्रैक्ट के लिए टेस्ट क्लाइंट TON (टेलीग्राम ओपन नेटवर्क) और नई फिफ्ट भाषा