🚵🏾 🚣 👃🏿 TON टेस्ट क्लाइंट (टेलीग्राम ओपन नेटवर्क) और स्मार्ट कॉन्ट्रैक्ट के लिए नई फ़िफ्ट लैंग्वेज 😐 📟 🎐

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

तब से, TON के विकास की स्थिति के बारे में कोई महत्वपूर्ण खबर नहीं थी, कुछ दिनों पहले तक ( अनौपचारिक चैनलों में से एक) पृष्ठ https://test.ton.org/download.html पर एक लिंक दिखाई दिया, जहां हैं:

◦ टन-परीक्षण- liteclient-full.tar.xz - TON परीक्षण नेटवर्क के लिए प्रकाश ग्राहक स्रोत कोड;
◦ ton-lite-client-test1.config.json - एक परीक्षण नेटवर्क से कनेक्ट करने के लिए कॉन्फ़िगरेशन फ़ाइल;
Client README - ग्राहक बनाने और शुरू करने के बारे में जानकारी;
On HOWTO - एक क्लाइंट का उपयोग करके स्मार्ट अनुबंध बनाने के लिए चरण-दर-चरण निर्देश;
◦ ton.pdf - अद्यतन दस्तावेज़ (दिनांक 2 मार्च, 2019) TON नेटवर्क के तकनीकी अवलोकन के साथ;
◦ tvm.pdf - TVM (TON वर्चुअल मशीन, TON वर्चुअल मशीन) का तकनीकी विवरण;
Of tblkch.pdf - TON ब्लॉकचेन का तकनीकी विवरण;
Of fiftbase.pdf - TON में स्मार्ट कॉन्ट्रैक्ट बनाने के लिए डिज़ाइन की गई नई Fift भाषा का विवरण।

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

टेस्ट क्लाइंट बिल्ड

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

स्रोत कोड के साथ संग्रह को डाउनलोड और अनपैक करें। नवीनतम संस्करण डाउनलोड करना महत्वपूर्ण है, क्योंकि इस स्तर पर पिछड़े संगतता की गारंटी नहीं है।
हम सुनिश्चित करते हैं कि सिस्टम पर मेक, सेमीके (संस्करण 3.0.2 या उच्चतर), ओपनएसएसएल (सी हेडर फाइलें सहित), जी ++ या क्लैंग के नवीनतम संस्करण स्थापित हैं। मुझे कुछ भी पुन: स्थापित नहीं करना है, सब कुछ तुरंत इकट्ठा हो गया।
सूत्रों की मानें तो ~/lite-client फ़ोल्डर में ~/lite-client । अलग-अलग, हम असेंबल किए गए प्रोजेक्ट के लिए एक खाली फ़ोल्डर बनाते हैं (उदाहरण के लिए, ~/liteclient-build ), और इसमें से ( cd ~/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 - सर्वर पर वर्तमान समय दिखाएं;
The 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

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

पचास भाषा

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

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

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

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

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

एक दरार कार्यक्रम का एक सरल उदाहरण:

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

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

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

 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 <bb{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 <bb{1000100} s, wc 8 i, wallet_addr 256 u, b{000010} s, swap <ss, b{0} s, swap B, swap <ss, 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 क्लाइंट और एक Fift दुभाषिया को एक साथ रखा, और भाषा से परिचित हो गए। अब स्मार्ट कॉन्ट्रैक्ट कैसे बनाएं? यह स्रोत से जुड़ी HOWTO फ़ाइल में वर्णित है।

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} -client.cpp: [ 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} F566005749C1B97F18EDE013EBA7A054B9014961BC1AD91F475B9082919A2296:: ब्लॉक के संबंध में (-1,8000000000000000,72355) के साथ 8156775B79325E5D62E742D9B96C30B6515A5CD2F1F64C5DA4B193C03F070E0D के लिए -1 1BD5DE54333164025EE39D389ECE2E93DA2871DA616D488253953E52B50DC03F और [ 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 , यदि आपने उपरोक्त निर्देशों ~/liteclient-build पालन किया है)। मैंने ऊपर अपनी सामग्री को उद्धृत किया, जैसे कि फ़िफ्ट पर कोड का एक उदाहरण।

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

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

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

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

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

 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) } 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 । 0f9PzVILj8yglrVn1zS-NSjtxr7QBfaTCp7JrBqnFPIR8nhZ । 0f9PzVILj8yglrVn1zS-NSjtxr7QBfaTCp7JrBqnFPIR8nhZ ) के साथ 0f9PzVILj8yglrVn1zS-NSjtxr7QBfaTCp7JrBqnFPIR8nhZ । इसके अनुरूप कोड new-wallet-query.boc , new-wallet-query.boc में इसका पता, और new-wallet.addr में निजी कुंजी (स्क्रिप्ट को पुनरारंभ करना - आपकी फ़ाइलों को फिर से लिखना होगा) में दिखाई देगा।

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

कार्य मोड में, एक्सचेंज पर ग्राम खरीदने से (या किसी अन्य वॉलेट से स्थानांतरित करके) यह समस्या हल हो जाएगी। ठीक है, वर्तमान परीक्षण मोड में, एक विशेष स्मार्ट अनुबंध स्थापित किया गया है, जिसमें से आप 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 // bx --> 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) <bb{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 <bb{1000100} s, wc 8 i, wallet_addr 256 u, 0 Gram, b{00} s, swap <ss, b> dup ."resulting external message: " <s csr. cr 2 boc+>B dup Bx. cr "wallet-query.boc" B>file

हम इसे constant dest_addr क्लाइंट के साथ फ़ोल्डर में भी सहेजते हैं, लेकिन पांचवीं पंक्ति को ठीक करते हैं - लाइन से पहले " 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.addr और new-wallet.pk , और प्राप्त संदेश को new-wallet-query.boc लिखें new-wallet-query.boc

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

खाता है

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

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