ტესტი კლიენტი TON (Telegram Open Network) და ახალი Fift ენა ჭკვიანი კონტრაქტებისთვის

ერთ წელზე მეტი ხნის წინ, ცნობილი გახდა Telegram მესინჯერის გეგმების შესახებ, გამოუშვას საკუთარი დეცენტრალიზებული ქსელი. ღია ქსელის ტელეგრამა. შემდეგ ხელმისაწვდომი გახდა მოცულობითი ტექნიკური დოკუმენტი, რომელიც, სავარაუდოდ, ნიკოლაი დუროვმა დაწერა და აღწერა მომავალი ქსელის სტრუქტურა. მათთვის, ვინც გამოტოვა, გირჩევთ წაიკითხოთ ჩემი გადმოცემა ამ დოკუმენტის შესახებ (ნაწილი 1, ნაწილი 2; მესამე ნაწილი, სამწუხაროდ, კვლავ აგროვებს მტვერს ნახაზებში).

მას შემდეგ, რამდენიმე დღის წინ TON-ის განვითარების სტატუსის შესახებ მნიშვნელოვანი სიახლე არ ყოფილა (ერთ-ერთში არაოფიციალური არხები) გვერდის ბმული არ გამოჩნდა https://test.ton.org/download.htmlსად მდებარეობს:
◦ ton-test-liteclient-full.tar.xz - მსუბუქი კლიენტის წყაროები TON ტესტის ქსელისთვის;
◦ ton-lite-client-test1.config.json — სატესტო ქსელთან დასაკავშირებლად კონფიგურაციის ფაილი;
◦ README - ინფორმაცია კლიენტის შეკრებისა და გაშვების შესახებ;
◦ ᲠᲝᲒᲝᲠ — ნაბიჯ-ნაბიჯ ინსტრუქციები, თუ როგორ უნდა შექმნათ ჭკვიანი კონტრაქტი კლიენტის გამოყენებით;
◦ ტონა.pdf — განახლებული დოკუმენტი (დათარიღებული 2 წლის 2019 მარტით) TON ქსელის ტექნიკური მიმოხილვით;
◦ tvm.pdf — TVM-ის ტექნიკური აღწერა (TON ვირტუალური მანქანა, TON ვირტუალური მანქანა);
◦ tblkch.pdf — TON ბლოკჩეინის ტექნიკური აღწერა;
◦ მეხუთე ბაზა.pdf — ახალი Fift ენის აღწერა, რომელიც შექმნილია ჭკვიანი კონტრაქტების შესაქმნელად TON-ში.

ვიმეორებ, გვერდის და ყველა ამ დოკუმენტის ოფიციალური დადასტურება Telegram-იდან არ ყოფილა, მაგრამ ამ მასალების მოცულობა მათ საკმაოდ დამაჯერებელს ხდის. გაუშვით გამოქვეყნებული კლიენტი საკუთარი რისკის ფასად.

სატესტო კლიენტის შექმნა

პირველი, მოდით ვცადოთ საცდელი კლიენტის შექმნა და გაშვება - საბედნიეროდ, README დეტალურად აღწერს ამ მარტივ პროცესს. მე ამას გავაკეთებ macOS 10.14.5-ის გამოყენებით, როგორც მაგალითი; მე ვერ დავდებ სხვა სისტემებზე აშენების წარმატებას.

1. ჩამოტვირთეთ და ამოალაგეთ წყაროს არქივი. მნიშვნელოვანია უახლესი ვერსიის ჩამოტვირთვა, რადგან ამ ეტაპზე უკან თავსებადობა გარანტირებული არ არის.

2. დარწმუნდით, რომ სისტემაზე დაინსტალირებულია make-ის უახლესი ვერსიები, cmake (ვერსია 3.0.2 ან უფრო მაღალი), OpenSSL (C header ფაილების ჩათვლით), g++ ან clang. არაფრის დაყენება არ დამჭირვებია, ყველაფერი მაშინვე გაერთიანდა.

3. დავუშვათ, რომ წყაროები საქაღალდეშია გახსნილი ~/lite-client. მისგან ცალკე შექმენით ცარიელი საქაღალდე აწყობილი პროექტისთვის (მაგალითად, ~/liteclient-build), და მისგან (cd ~/liteclient-build) გამოიძახეთ ბრძანებები:

   cmake ~/lite-client
   cmake --build . --target test-lite-client

   
   
   სმარტ კონტრაქტებისთვის Fift ენის თარჯიმნის შესაქმნელად (დაწვრილებით ამის შესახებ ქვემოთ), ჩვენ ასევე მოვუწოდებთ

   cmake --build . --target fift

4. ჩამოტვირთეთ მიმდინარე კონფიგურაციის ფაილი სატესტო ქსელთან დასაკავშირებლად და აწყობილ კლიენტთან საქაღალდეში ჩასმა.

5. დასრულების, შეგიძლიათ დაიწყოთ კლიენტი:

   ./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

ახლა ჩვენ შეგვიძლია გადავიდეთ უფრო საინტერესო საკითხებზე - ვისწავლოთ Fift ენა, შევეცადოთ შეადგინოთ ჭკვიანი კონტრაქტი (მაგალითად, შექმენით სატესტო საფულე), ატვირთოთ იგი ქსელში და სცადოთ თანხის გადარიცხვა ანგარიშებს შორის.

ენა მეხუთე

დოკუმენტიდან მეხუთე ბაზა.pdf შეგიძლიათ გაიგოთ, რომ Telegram-ის გუნდმა შექმნა ახალი სტეკის ენა ჭკვიანი კონტრაქტების შესაქმნელად მეხუთე (როგორც ჩანს, რიცხვიდან მეხუთე, Forth-ის მსგავსი, ენა, რომელთანაც Fifth-ს ბევრი საერთო აქვს).

დოკუმენტი საკმაოდ მოცულობითია, 87 გვერდიანი და მის შინაარსს დეტალურად არ ვიტყვი ამ სტატიის ფარგლებში (ყოველ შემთხვევაში იმიტომ, რომ მე თვითონ არ დამიმთავრებია მისი წაკითხვა :). მე ყურადღებას გავამახვილებ მთავარ საკითხებზე და მოვიყვან რამდენიმე კოდის მაგალითს ამ ენაზე.

საბაზისო დონეზე, Fift-ის სინტაქსი საკმაოდ მარტივია: მისი კოდი შედგება სიტყვები, ჩვეულებრივ გამოყოფილი შუალედებით ან ხაზების წყვეტებით (განსაკუთრებული შემთხვევა: ზოგიერთი სიტყვა არ საჭიროებს გამყოფს თავის შემდეგ). ნებისმიერი слово არის ასოების ასოების მიმდევრობა, რომელიც შეესაბამება გარკვეულს განსაზღვრა (დაახლოებით, რა უნდა გააკეთოს თარჯიმანმა, როცა ამ სიტყვას შეხვდება). თუ სიტყვის განმარტება არ არის, თარჯიმანი ცდილობს მისი რიცხვის გარჩევას და დასტაზე დაყენებას. სხვათა შორის, რიცხვები აქ არის - მოულოდნელად - 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

(სტრიქონი "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-ის ასამბლერი იწერება Fift-ში - ამ ასამბლერის წყაროები არის ფაილში crypto/fift/Asm.fif და დაკავშირებულია ზემოთ მოყვანილი კოდის დასაწყისში.

რა შემიძლია ვთქვა, როგორც ჩანს, ნიკოლაი დუროვს უბრალოდ უყვარს ახალი პროგრამირების ენების შექმნა :)

ჭკვიანი კონტრაქტის შექმნა და TON-თან ურთიერთობა

ასე რომ, დავუშვათ, რომ შევკრიბეთ TON კლიენტი და Fift თარჯიმანი, როგორც ზემოთ იყო აღწერილი და გავეცანით ენას. როგორ შევქმნათ ჭკვიანი კონტრაქტი ახლა? ეს აღწერილია ფაილში ᲠᲝᲒᲝᲠ, თან ერთვის წყაროებს.

ანგარიშები TON-ში

როგორც აღვწერე TON მიმოხილვა, ეს ქსელი შეიცავს ერთზე მეტ ბლოკჩეინს – არის ერთი საერთო, ე.წ. "სამაგისტრო ჯაჭვი", ისევე როგორც დამატებითი "სამუშაო ჯაჭვების" თვითნებური რაოდენობა, რომელიც იდენტიფიცირებულია 32-ბიტიანი ნომრით. მასტერჩეინს აქვს -1 იდენტიფიკატორი, გარდა ამისა, შეიძლება გამოყენებულ იქნას "ბაზის" სამუშაო ჯაჭვი 0 იდენტიფიკატორით. თითოეულ სამუშაო ჯაჭვს შეიძლება ჰქონდეს საკუთარი კონფიგურაცია. შინაგანად, თითოეული სამუშაო ჯაჭვი დაყოფილია ძაფებად, მაგრამ ეს არის განხორციელების დეტალი, რომლის გათვალისწინებაც არ არის საჭირო.

ერთი სამუშაო ჯაჭვის ფარგლებში ინახება მრავალი ანგარიში, რომლებსაც აქვთ საკუთარი account_id იდენტიფიკატორები. ძირითადი ჯაჭვისა და ნულოვანი სამუშაო ჯაჭვისთვის, ისინი 256 ბიტიანია. ამრიგად, ანგარიშის იდენტიფიკატორი იწერება, მაგალითად, ასე:

-1:8156775b79325e5d62e742d9b96c30b6515a5cd2f1f64c5da4b193c03f070e0d

ეს არის „ნედლეული“ ფორმატი: ჯერ სამუშაო ჯაჭვის ID, შემდეგ ორწერტილი და ანგარიშის ID თექვსმეტობითი აღნიშვნით.

გარდა ამისა, არსებობს შემცირებული ფორმატი - სამუშაო ჯაჭვის ნომერი და ანგარიშის მისამართი დაშიფრულია ორობითი ფორმით, მათ ემატება გამშვები ჯამი და ეს ყველაფერი დაშიფრულია 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}

ჩვენ ვხედავთ სტრუქტურას, რომელიც ინახება მითითებული სამუშაო ჯაჭვის DHT-ში. მაგალითად, მინდორში storage.balance არის მიმდინარე ანგარიშის ნაშთი, ქ storage.state.code - ჭკვიანი კონტრაქტის კოდი და ში storage.state.data - მისი ამჟამინდელი მონაცემები. გთხოვთ გაითვალისწინოთ, რომ TON მონაცემთა საცავი - უჯრედი, უჯრედები - ხის მსგავსია, თითოეულ უჯრედს შეიძლება ჰქონდეს როგორც საკუთარი მონაცემები, ასევე შვილობილი უჯრედები. ეს ნაჩვენებია როგორც შეწევა ბოლო სტრიქონებში.

ჭკვიანი კონტრაქტის შექმნა

ახლა ჩვენ თვითონ შევქმნათ ასეთი სტრუქტურა (მას BOC ჰქვია - უჯრედების ტომარა) Fift ენის გამოყენებით. საბედნიეროდ, თქვენ არ გჭირდებათ თავად დაწეროთ ჭკვიანი კონტრაქტი - საქაღალდეში crypto/block არის ფაილი წყაროს არქივიდან new-wallet.fif, რომელიც დაგვეხმარება ახალი საფულის შექმნაში. მოდით დავაკოპიროთ ის საქაღალდეში აწყობილი კლიენტით (~/liteclient-buildთუ მიჰყევით ზემოთ მოცემულ მითითებებს). მე მოვიყვანე მისი შინაარსი ზემოთ, როგორც კოდის მაგალითი Fift-ზე.

შეასრულეთ ეს ფაილი შემდეგნაირად:

./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) და თქვენი საფულის თანმიმდევრობა (ის უდრის 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-ის ზოგადი მიმოხილვით

• დიახ, საინტერესოა მეტის წაკითხვა Fift ენის შესახებ

• დიახ, მსურს მეტი ვისწავლო TON-ის ვირტუალური აპარატისა და მისი ასამბლერის შესახებ

• არა, არცერთი არ არის საინტერესო

მისცა ხმა 39 მომხმარებელმა. 12-მა მომხმარებელმა თავი შეიკავა.

რას ფიქრობთ Telegram-ის TON-ის გაშვების გეგმებზე?

• ამ პროექტზე დიდი იმედი მაქვს

• უბრალოდ ინტერესით ვადევნებ თვალს მის განვითარებას.

• სკეპტიკურად ვარ განწყობილი და მეეჭვება მისი წარმატება.

• მიდრეკილი ვარ, რომ ეს ინიციატივა ჩავარდნილი და ფართო მასებისთვის არასაჭიროდ მივიჩნიო

მისცა ხმა 47 მომხმარებელმა. 12-მა მომხმარებელმა თავი შეიკავა.

წყარო: www.habr.com