🥇TON (टेलीग्राम ओपन नेटवर्क) परीक्षण ग्राहक र स्मार्ट अनुबंधहरूको लागि नयाँ फिफ्ट भाषा

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

त्यसबेलादेखि, केही दिन अघिसम्म TON विकासको स्थितिको बारेमा कुनै महत्त्वपूर्ण समाचार आएको छैन (एकमा अनौपचारिक च्यानलहरू) पृष्ठको लिङ्क देखा परेन https://test.ton.org/download.html, कहाँ अवस्थित छन्:
◦ ton-test-liteclient-full.tar.xz - TON परीक्षण नेटवर्क को लागी एक प्रकाश ग्राहक को स्रोत;
◦ ton-lite-client-test1.config.json — परीक्षण सञ्जाल जडान गर्नको लागि कन्फिगरेसन फाइल;
◦ पढ्नुहोस् - ग्राहक निर्माण र सुरुवात बारे जानकारी;
◦ कसरी - ग्राहक प्रयोग गरेर स्मार्ट अनुबंध सिर्जना गर्न चरण-दर-चरण निर्देशनहरू;
◦ ton.pdf — TON नेटवर्कको प्राविधिक सिंहावलोकनको साथ अद्यावधिक गरिएको कागजात (मार्च 2, 2019 मिति);
◦ tvm.pdf - TVM को प्राविधिक विवरण (TON भर्चुअल मेसिन, TON भर्चुअल मेसिन);
◦ tblkch.pdf - TON blockchain को प्राविधिक विवरण;
◦ fifthbase.pdf - नयाँ फिफ्ट भाषाको विवरण, TON मा स्मार्ट अनुबंधहरू सिर्जना गर्न डिजाइन गरिएको।

म दोहोर्याउँछु, टेलिग्रामबाट पृष्ठ र यी सबै कागजातहरूको कुनै आधिकारिक पुष्टिकरण थिएन, तर यी सामग्रीहरूको भोल्युमले तिनीहरूलाई धेरै प्रशंसनीय बनाउँछ। प्रकाशित ग्राहक सुरु गर्नुहोस् आफ्नै जोखिममा.

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

पहिले, एक परीक्षण ग्राहक निर्माण र चलाउन प्रयास गरौं - सौभाग्य देखि, पढ्नुहोस् यस सरल प्रक्रियालाई विस्तृत रूपमा वर्णन गर्दछ। म उदाहरणको रूपमा macOS 10.14.5 प्रयोग गरेर यो गर्नेछु; म अन्य प्रणालीहरूमा निर्माणको सफलताको लागि आश्वासन दिन सक्दिन।

डाउनलोड र अनप्याक गर्नुहोस् स्रोत अभिलेख। पछिल्लो संस्करण डाउनलोड गर्न महत्त्वपूर्ण छ किनकि यस चरणमा पछाडि अनुकूलताको ग्यारेन्टी छैन।
सुनिश्चित गर्नुहोस् कि मेक, cmake (संस्करण 3.0.2 वा माथिको संस्करण), OpenSSL (C हेडर फाइलहरू सहित), g++ वा clang प्रणालीमा स्थापना गरिएको छ। मैले केहि पनि स्थापना गर्नुपर्दैन, सबै कुरा तुरुन्तै सँगै आयो।
मानौं स्रोतहरू फोल्डरमा अनप्याक गरिएको छ ~/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

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

भाषा पाँच

कागजातबाट fifthbase.pdf तपाईंले पत्ता लगाउन सक्नुहुन्छ कि टेलिग्राम टोलीले स्मार्ट अनुबंधहरू सिर्जना गर्न नयाँ स्ट्याक भाषा सिर्जना गरेको छ पाँच (अंकबाट स्पष्ट रूपमा पाँचौं, Forth जस्तै, एक भाषा जससँग पाँचौंमा धेरै समानता छ)।

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

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

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

यहाँ भाषाको लगभग सम्पूर्ण आन्तरिक संरचना समाप्त हुन्छ। अरू सबै कुरा (नियन्त्रण निर्माणहरू सहित) शब्दहरूको रूपमा परिभाषित गरिएको छ (या त आन्तरिक, जस्तै अंकगणित सञ्चालन र नयाँ शब्दहरूको परिभाषा; वा "मानक पुस्तकालय" मा परिभाषित गरिएको छ। Fift.fif, जुन फोल्डरमा छ crypto/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 भर्चुअल मेसिनको लागि यहाँ अर्को एसेम्बली भाषा प्रयोग गरिएको छ (म यसमा विस्तृत रूपमा बस्ने छैन), जसका निर्देशनहरू ब्लकचेनमा राखिनेछ।

यसरी, TVM को लागि एसेम्बलर फिफ्टमा लेखिएको छ - यस एसेम्बलरका स्रोतहरू फाइलमा छन्। crypto/fift/Asm.fif र कोडको माथिको टुक्राको सुरुमा जडान गरिएको छ।

म के भन्न सक्छु, स्पष्ट रूपमा निकोलाई दुरोभले नयाँ प्रोग्रामिङ भाषाहरू सिर्जना गर्न मन पराउँछन् :)

एक स्मार्ट अनुबंध सिर्जना गर्दै र TON सँग अन्तरक्रिया गर्दै

त्यसोभए, मानौं कि हामीले माथि वर्णन गरिए अनुसार TON ग्राहक र फिफ्ट दोभाषेलाई भेला गरेका छौं र भाषासँग परिचित भएका छौं। अब स्मार्ट सम्झौता कसरी बनाउने? यो फाइलमा वर्णन गरिएको छ कसरी, स्रोतहरु संग संलग्न।

TON मा खाताहरू

मैले मा वर्णन गरे अनुसार TON समीक्षा, यो नेटवर्कले एक भन्दा बढी ब्लकचेन समावेश गर्दछ - त्यहाँ एक साझा छ, तथाकथित। "मास्टर चेन", साथै 32-बिट नम्बर द्वारा पहिचान गरिएको अतिरिक्त "वर्क चेन" को एक स्वेच्छाचारी संख्या। मास्टरचेनमा -१ को पहिचानकर्ता छ; यसको अतिरिक्त, ० को पहिचानकर्ता भएको "आधार" वर्कचेन पनि प्रयोग गर्न सकिन्छ। प्रत्येक वर्कचेनको आफ्नै कन्फिगरेसन हुन सक्छ। आन्तरिक रूपमा, प्रत्येक वर्कचेन शार्डचेनहरूमा विभाजित छ, तर यो एक कार्यान्वयन विवरण हो जुन दिमागमा राख्न आवश्यक छैन।

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

-1:8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d

यो "कच्चा" ढाँचा हो: पहिले workchain ID, त्यसपछि एउटा कोलोन, र हेक्साडेसिमल नोटेशनमा खाता ID।

थप रूपमा, त्यहाँ छोटो ढाँचा छ - workchain नम्बर र खाता ठेगाना बाइनरी फारममा इन्कोड गरिएको छ, तिनीहरूमा एक चेकसम थपिएको छ, र यो सबै Base64 मा इन्कोड गरिएको छ:

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}

हामीले तोकिएको workchain को DHT मा भण्डारण गरिएको संरचना देख्छौं। उदाहरणका लागि, क्षेत्रमा storage.balance हालको खाता ब्यालेन्स हो, मा storage.state.code - स्मार्ट अनुबंध कोड, र मा storage.state.data - यसको वर्तमान डाटा। कृपया ध्यान दिनुहोस् कि TON डाटा भण्डारण - कक्ष, कक्षहरू - रूख जस्तै छ, प्रत्येक कक्षको आफ्नै डेटा र बाल कक्षहरू दुवै हुन सक्छ। यो अन्तिम रेखाहरूमा इन्डेन्टेसनको रूपमा देखाइएको छ।

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

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

यस फाइललाई निम्नानुसार कार्यान्वयन गर्नुहोस्:

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

यो छ <source-directory> अनप्याक गरिएको स्रोतहरूको मार्गमा प्रतिस्थापन गर्नुपर्छ ("~" प्रतीक, दुर्भाग्यवश, यहाँ प्रयोग गर्न सकिँदैन, पूर्ण मार्ग आवश्यक छ)। कुञ्जी प्रयोग गर्नुको सट्टा -I तपाईं वातावरण चर परिभाषित गर्न सक्नुहुन्छ FIFTPATH र यो बाटो यसमा राख्नुहोस्।

हामीले फाइल नामको साथ फिफ्ट सुरू गरेका छौं 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 — यो ग्राममा भएको रकम हो जुन तपाईंले अनुरोध गरिरहनुभएको छ (२० भन्दा बढी होइन)। यदि तपाइँ पूर्ण संख्या निर्दिष्ट गर्नुहुन्छ भने, दशमलव बिन्दु छोड्नुहोस्।

अन्तमा, तपाईंले लाइन सच्याउन आवश्यक छ 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 ग्राहक मा। यस पछि, blockchain को स्थिति अद्यावधिक गर्न नबिर्सनुहोस् (last) र जाँच गर्नुहोस् कि हाम्रो वालेटको ब्यालेन्स र सेक्नो परिवर्तन भएको छ (getaccount <account_id>).

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

दर्ता भएका प्रयोगकर्ताहरूले मात्र सर्वेक्षणमा भाग लिन सक्छन्। साइन इन गर्नुहोस्कृपया

के तपाइँ TON, TVM, Fift को विश्लेषण संग लेखहरू जारी राख्न इच्छुक हुनुहुन्छ?

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

39 प्रयोगकर्ताहरूले मतदान गरे। 12 प्रयोगकर्ताहरू रोकिए।

TON सुरु गर्ने टेलिग्रामको योजना बारे तपाइँ के सोच्नुहुन्छ?

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

47 प्रयोगकर्ताहरूले मतदान गरे। 12 प्रयोगकर्ताहरू रोकिए।

स्रोत: www.habr.com

स्मार्ट अनुबंधहरूको लागि ग्राहक TON (टेलीग्राम खुला नेटवर्क) र नयाँ फिफ्ट भाषा परीक्षण गर्नुहोस्