როგორ დავწეროთ WebAssembly ჭკვიანი კონტრაქტი Ontology ქსელში? ნაწილი 1: ჟანგი

Ontology Wasm ტექნოლოგია ამცირებს dApp ჭკვიანი კონტრაქტების მიგრაციის ღირებულებას ბლოკჩეინში რთული ბიზნეს ლოგიკით, რითაც მნიშვნელოვნად ამდიდრებს dApp ეკოსისტემას.

ახლა ონტოლოგია Wasm ერთდროულად მხარს უჭერს Rust და C++ განვითარებას. Rust ენა მხარს უჭერს Wasm-ს უკეთესად, ხოლო გენერირებული ბაიტეკოდი უფრო მარტივია, რამაც შეიძლება კიდევ უფრო შეამციროს კონტრაქტის ზარების ღირებულება. Ისე, როგორ გამოვიყენოთ Rust ონტოლოგიის ქსელზე კონტრაქტის შესაქმნელად?

WASM კონტრაქტის შემუშავება Rust-თან

შექმენით კონტრაქტი

Charge არის კარგი პროექტების შექმნისა და პაკეტების მართვის ინსტრუმენტი Rust-ის განვითარებისთვის, რომელიც ეხმარება დეველოპერებს უკეთ მოაწყონ კოდისა და მესამე მხარის ბიბლიოთეკების ურთიერთქმედება. ახალი Ontology Wasm კონტრაქტის შესაქმნელად, უბრალოდ გაუშვით შემდეგი ბრძანება:

პროექტის სტრუქტურა მას ქმნის:

Cargo.toml ფაილი გამოიყენება პროექტის ძირითადი ინფორმაციისა და დამოკიდებული ბიბლიოთეკის ინფორმაციის დასაყენებლად. ფაილის [lib] განყოფილება უნდა იყოს მითითებული crate-type = ["cdylib"]. lib.rs ფაილი გამოიყენება კონტრაქტის ლოგიკური კოდის დასაწერად. გარდა ამისა, თქვენ უნდა დაამატოთ დამოკიდებულების პარამეტრები Cargo.toml კონფიგურაციის ფაილის განყოფილებაში [dependencies]:

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

კონტრაქტის დადების ფუნქცია

ყველა პროგრამას აქვს შეყვანის ფუნქცია, როგორც მთავარი ფუნქცია, რომელსაც ჩვეულებრივ ვხედავთ, მაგრამ კონტრაქტს არ აქვს მთავარი ფუნქცია. როდესაც Wasm კონტრაქტი შემუშავებულია Rust-ის გამოყენებით, ნაგულისხმევი გამოძახების ფუნქცია გამოიყენება, როგორც შეყვანის ფუნქცია კონტრაქტის გამოსაყენებლად. Rust-ში ფუნქციის სახელი გაურკვეველი იქნება Rust-ის წყარო კოდის ბაიტიკოდში შედგენისას, რომელიც შეიძლება შესრულდეს ვირტუალური მანქანით. იმისათვის, რომ შემდგენელმა არ შექმნას ზედმეტი კოდი და შეამციროს კონტრაქტის ზომა, invoke ფუნქცია ამატებს #[no_mangle] ანოტაციას.

როგორ იღებს გამოძახების ფუნქცია პარამეტრებს ტრანზაქციის შესასრულებლად?

ontio_std ბიბლიოთეკა უზრუნველყოფს Runtime::input() ფუნქციას ტრანზაქციის შესასრულებელი პარამეტრების მისაღებად. დეველოპერებს შეუძლიათ გამოიყენონ ZeroCopySource მიღებული ბაიტის მასივის დესერიალიზაციისთვის. რომელშიც წაკითხული ბაიტების პირველი მასივი არის invoke მეთოდის სახელი, რასაც მოჰყვება მეთოდის პარამეტრები.

როგორ ბრუნდება ხელშეკრულების შესრულების შედეგი?

Runtime::ret ფუნქცია, რომელიც მოწოდებულია ontio_std ბიბლიოთეკის მიერ, აბრუნებს მეთოდის შესრულების შედეგს.

დასრულებული გამოძახების ფუნქცია ასე გამოიყურება:

კონტრაქტის მონაცემების სერიალიზაცია და დესერიალიზაცია

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

ontio_std ბიბლიოთეკა უზრუნველყოფს დეკოდერის და ენკოდერის ინტერფეისებს მონაცემთა სერიალიზაციისა და დესერიალიზაციისთვის. სტრუქტურის ველები ასევე ახორციელებს დეკოდერის და შიფრატორის ინტერფეისებს, რათა სტრუქტურის სერიალიზაცია და დესერიალიზება მოხდეს. Sink კლასის ინსტანციები საჭიროა სხვადასხვა ტიპის მონაცემთა სერიულობისას. Sink კლასის მაგალითს აქვს ნაკრების ტიპის ველის ბუფი, რომელიც ინახავს ბაიტის ტიპის მონაცემებს და ყველა სერიული მონაცემი ინახება buf-ში.

ფიქსირებული სიგრძის მონაცემებისთვის (მაგ.: ბაიტი, u16, u32, u64 და ა.შ.), მონაცემები პირდაპირ გარდაიქმნება ბაიტის მასივში და შემდეგ ინახება buf-ში; არაფიქსირებული სიგრძის მონაცემებისთვის ჯერ სიგრძე უნდა იყოს სერიული, შემდეგ Ddata (მაგალითად, უცნობი ზომის ხელმოუწერელი მთელი რიცხვები, მათ შორის u16, u32, ან u64 და ა.შ.).

დესერიალიზაცია არის ზუსტად საპირისპირო. ყველა სერიული მეთოდისთვის არსებობს შესაბამისი დესერიალიზაციის მეთოდი. დესერიალიზაცია მოითხოვს Source კლასის ინსტანციების გამოყენებას. ამ კლასის მაგალითს აქვს ორი ველი buf და pos. Buf გამოიყენება დესერიალიზებული მონაცემების შესანახად და pos გამოიყენება წაკითხვის მიმდინარე პოზიციის შესანახად. როდესაც კონკრეტული ტიპის მონაცემები იკითხება, თუ იცით მისი სიგრძე, შეგიძლიათ პირდაპირ წაიკითხოთ, უცნობი სიგრძის მონაცემებისთვის — ჯერ წაიკითხეთ სიგრძე, შემდეგ წაიკითხეთ შინაარსი.

წვდომა და განაახლეთ მონაცემები ჯაჭვში

ონტოლოგია-wasm-cdt-rust - ჩასმულია ჯაჭვში მონაცემებთან მუშაობის ოპერატიული მეთოდი, რომელიც მოსახერხებელია დეველოპერებისთვის, რათა განახორციელონ ოპერაციები, როგორიცაა ჯაჭვში მონაცემების დამატება, წაშლა, შეცვლა და მოთხოვნა შემდეგნაირად:

• მონაცემთა ბაზა::get(გასაღები) - გამოიყენება ჯაჭვიდან მონაცემების გამოსათხოვად და გასაღები ითხოვს AsRef ინტერფეისის განხორციელებას;
• მონაცემთა ბაზა::put (გასაღები, მნიშვნელობა) - გამოიყენება ქსელში მონაცემების შესანახად. Key ითხოვს AsRef ინტერფეისის განხორციელებას და მნიშვნელობა ითხოვს Encoder ინტერფეისის განხორციელებას;
• მონაცემთა ბაზა:: წაშლა (გასაღები) - გამოიყენება ჯაჭვიდან მონაცემების ამოსაღებად და გასაღები ითხოვს AsRef ინტერფეისის განხორციელებას.

კონტრაქტის ტესტირება

როდესაც ხელშეკრულების მეთოდები დანერგილია, ჩვენ გვჭირდება წვდომა ჯაჭვზე არსებულ მონაცემებზე და გვჭირდება შესაბამისი ვირტუალური მანქანა ხელშეკრულების ბაიტეკოდის შესასრულებლად, ამიტომ ზოგადად აუცილებელია ხელშეკრულების განლაგება ჯაჭვზე ტესტირებისთვის. მაგრამ ტესტირების ეს მეთოდი პრობლემურია. დეველოპერებისთვის კონტრაქტების ტესტირების გასაადვილებლად, ontio_std ბიბლიოთეკა გთავაზობთ იმიტირებულ მოდულს ტესტირებისთვის. ეს მოდული უზრუნველყოფს მიკროსქემის მონაცემების სიმულაციას, რაც აადვილებს დეველოპერებს კონტრაქტში მოცემული მეთოდების ერთეული ტესტირებას. კონკრეტული მაგალითები შეიძლება მოიძებნოს აქ.

ხელშეკრულების გამართვა

კონსოლი::debug(msg) აჩვენებს გამართვის ინფორმაციას კონტრაქტის გამართვისას. msg ინფორმაცია დაემატება კვანძის ჟურნალის ფაილს. წინაპირობაა ჟურნალის ფაილის დონის დაყენება გამართვის რეჟიმში, როდესაც მუშაობს ადგილობრივი ონტოლოგიის ტესტის კვანძი.

runtime::notify(msg) გამოაქვს შესაბამისი გამართვის ინფორმაცია, სანამ ხელშეკრულება გამართულია. ეს მეთოდი შეინახავს ჯაჭვში შეყვანილ ინფორმაციას და შეიძლება მოითხოვოს ჯაჭვიდან getSmartCodeEvent მეთოდის გამოყენებით.

სტატია თარგმნეს Hashrate&Shares-ის რედაქტორებმა სპეციალურად OntologyRussia-სთვის. ტირილი

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

Ontology

• ონტოლოგიის საიტი
• GitHub / უთანხმოება
• დეპეშა ინგლისური / რუსული
• Twitter / Reddit

წყარო: www.habr.com