ഒന്റോളജി നെറ്റ്‌വർക്കിൽ ഒരു വെബ് അസംബ്ലി സ്‌മാർട്ട് കരാർ എങ്ങനെ എഴുതാം? ഭാഗം 1: തുരുമ്പ്

സങ്കീർണ്ണമായ ബിസിനസ് ലോജിക്കോടുകൂടിയ dApp സ്മാർട്ട് കരാറുകൾ ബ്ലോക്ക്ചെയിനിലേക്ക് മൈഗ്രേറ്റ് ചെയ്യുന്നതിനുള്ള ചെലവ് ഒന്റോളജി Wasm സാങ്കേതികവിദ്യ കുറയ്ക്കുന്നു, അതുവഴി dApp ആവാസവ്യവസ്ഥയെ വളരെയധികം സമ്പന്നമാക്കുന്നു.

നിലവിൽ ഒന്റോളജി വാസ്ം ഒരേസമയം റസ്റ്റും C++ വികസനവും പിന്തുണയ്ക്കുന്നു. റസ്റ്റ് ഭാഷ വാസ്മിനെ മികച്ച രീതിയിൽ പിന്തുണയ്ക്കുന്നു, കൂടാതെ ജനറേറ്റ് ചെയ്ത ബൈറ്റ്കോഡ് ലളിതമാണ്, ഇത് കരാർ കോളുകളുടെ വില ഇനിയും കുറയ്ക്കും. അതിനാൽ, ഒന്റോളജി നെറ്റ്‌വർക്കിൽ ഒരു കരാർ വികസിപ്പിക്കുന്നതിന് റസ്റ്റ് എങ്ങനെ ഉപയോഗിക്കാം?

റസ്റ്റുമായി ഒരു WASM കരാർ വികസിപ്പിക്കുന്നു

ഒരു കരാർ ഉണ്ടാക്കുക

കാർഗോ റസ്റ്റ് വികസനത്തിനായുള്ള ഒരു നല്ല പ്രോജക്റ്റ് സൃഷ്‌ടിക്കും പാക്കേജ് മാനേജുമെന്റ് ടൂളാണ്, ഇത് കോഡിന്റെയും മൂന്നാം കക്ഷി ലൈബ്രറികളുടെയും ആശയവിനിമയം മികച്ച രീതിയിൽ സംഘടിപ്പിക്കാൻ ഡവലപ്പർമാരെ സഹായിക്കുന്നു. ഒരു പുതിയ Ontology Wasm കരാർ സൃഷ്ടിക്കുന്നതിന്, ഇനിപ്പറയുന്ന കമാൻഡ് പ്രവർത്തിപ്പിക്കുക:

ഇത് സൃഷ്ടിക്കുന്ന പ്രോജക്റ്റ് ഘടന:

അടിസ്ഥാന പ്രോജക്റ്റ് വിവരങ്ങളും ആശ്രിത ലൈബ്രറി വിവരങ്ങളും സജ്ജീകരിക്കാൻ Cargo.toml ഫയൽ ഉപയോഗിക്കുന്നു. ഫയലിന്റെ [lib] വിഭാഗം crate-type = ["cdylib"] ആയി സജ്ജമാക്കിയിരിക്കണം. കരാർ ലോജിക് കോഡ് എഴുതാൻ lib.rs ഫയൽ ഉപയോഗിക്കുന്നു. കൂടാതെ, Cargo.toml കോൺഫിഗറേഷൻ ഫയലിന്റെ [ഡിപൻഡൻസി] വിഭാഗത്തിലേക്ക് നിങ്ങൾ ഡിപൻഡൻസി പാരാമീറ്ററുകൾ ചേർക്കേണ്ടതുണ്ട്:

ഈ ആശ്രിതത്വം ഉപയോഗിച്ച്, ഡെവലപ്പർമാർക്ക് ഓന്റോളജി ബ്ലോക്ക്ചെയിനുമായി സംവദിക്കുന്ന ഇന്റർഫേസുകളും സീരിയലൈസേഷൻ പാരാമീറ്റർ പോലുള്ള ഉപകരണങ്ങളും വിളിക്കാൻ കഴിയും.

കരാർ എൻട്രി പ്രവർത്തനം

നമ്മൾ സാധാരണയായി കാണുന്ന പ്രധാന ഫംഗ്‌ഷൻ പോലെ ഓരോ പ്രോഗ്രാമിനും ഒരു ഇൻപുട്ട് ഫംഗ്‌ഷൻ ഉണ്ട്, എന്നാൽ കരാറിന് ഒരു പ്രധാന ഫംഗ്‌ഷൻ ഇല്ല. റസ്റ്റ് ഉപയോഗിച്ച് ഒരു Wasm കരാർ വികസിപ്പിക്കുമ്പോൾ, കരാർ ഉപയോഗിക്കുന്നതിനുള്ള ഇൻപുട്ട് ഫംഗ്‌ഷനായി ഡിഫോൾട്ട് ഇൻവോക്ക് ഫംഗ്‌ഷൻ ഉപയോഗിക്കുന്നു. ഒരു വെർച്വൽ മെഷീനിൽ എക്സിക്യൂട്ട് ചെയ്യാൻ കഴിയുന്ന ബൈറ്റ്കോഡിലേക്ക് റസ്റ്റ് സോഴ്സ് കോഡ് കംപൈൽ ചെയ്യുമ്പോൾ റസ്റ്റിലെ ഒരു ഫംഗ്ഷന്റെ പേര് വ്യക്തമല്ല. കംപൈലർ അനാവശ്യ കോഡ് സൃഷ്ടിക്കുന്നതിൽ നിന്ന് തടയുന്നതിനും കരാറിന്റെ വലുപ്പം കുറയ്ക്കുന്നതിനും, ഇൻവോക്ക് ഫംഗ്‌ഷൻ #[no_mangle] വ്യാഖ്യാനം ചേർക്കുന്നു.

ഒരു ഇടപാട് നടത്താൻ ഇൻവോക്ക് ഫംഗ്‌ഷന് എങ്ങനെയാണ് പാരാമീറ്ററുകൾ ലഭിക്കുന്നത്?

ഒരു ഇടപാട് നടത്തുന്നതിനുള്ള പരാമീറ്ററുകൾ ലഭിക്കുന്നതിന് ontio_std ലൈബ്രറി ഒരു റൺടൈം:: input() ഫംഗ്‌ഷൻ നൽകുന്നു. തത്ഫലമായുണ്ടാകുന്ന ബൈറ്റ് അറേയെ ഡിസീരിയലൈസ് ചെയ്യാൻ ഡവലപ്പർമാർക്ക് ZeroCopySource ഉപയോഗിക്കാം. ഇതിൽ ബൈറ്റുകളുടെ ആദ്യ ശ്രേണി വായിക്കുന്നത് ഇൻവോക്ക് രീതിയുടെ പേരാണ്, തുടർന്ന് രീതി പാരാമീറ്ററുകൾ.

കരാർ നിർവ്വഹണത്തിന്റെ ഫലം എങ്ങനെയാണ് തിരികെ ലഭിക്കുന്നത്?

ontio_std ലൈബ്രറി നൽകുന്ന റൺടൈം::ret ഫംഗ്ഷൻ ഒരു മെത്തേഡ് എക്സിക്യൂഷന്റെ ഫലം നൽകുന്നു.

പൂർത്തിയാക്കിയ ഇൻവോക്ക് ഫംഗ്ഷൻ ഇതുപോലെ കാണപ്പെടുന്നു:

കരാർ ഡാറ്റ സീരിയലൈസ് ചെയ്യുകയും ഡീസീരിയലൈസ് ചെയ്യുകയും ചെയ്യുന്നു

കരാറുകൾ വികസിപ്പിക്കുന്ന പ്രക്രിയയിൽ, ഡവലപ്പർമാർ എല്ലായ്പ്പോഴും സീരിയലൈസേഷനും ഡിസീരിയലൈസേഷനുമായി പ്രശ്നങ്ങൾ നേരിടും, പ്രത്യേകിച്ചും ഡാറ്റാബേസിൽ ഒരു സ്ട്രക്റ്റ് ഡാറ്റ തരം എങ്ങനെ സംഭരിക്കാം, ഒരു സ്ട്രക്റ്റ് ഡാറ്റാ തരം ലഭിക്കുന്നതിന് ഡാറ്റാബേസിൽ നിന്ന് വായിച്ച ഒരു ബൈറ്റ് അറേ എങ്ങനെ ഡിസീരിയലൈസ് ചെയ്യാം.

ontio_std ലൈബ്രറി ഡാറ്റ സീരിയലൈസേഷനും ഡീസിയലൈസേഷനും ഡീകോഡറും എൻകോഡറും ഇന്റർഫേസുകൾ നൽകുന്നു. ഒരു സ്ട്രക്റ്റിന്റെ ഫീൽഡുകൾ ഡീകോഡറും എൻകോഡർ ഇന്റർഫേസുകളും നടപ്പിലാക്കുന്നു, അങ്ങനെ ഘടനയെ സീരിയലൈസ് ചെയ്യാനും ഡീരിയലൈസ് ചെയ്യാനും കഴിയും. വിവിധ ഡാറ്റ തരങ്ങൾ സീരിയലൈസ് ചെയ്യുമ്പോൾ സിങ്ക് ക്ലാസിന്റെ ഉദാഹരണങ്ങൾ ആവശ്യമാണ്. സിങ്ക് ക്ലാസിന്റെ ഒരു ഉദാഹരണത്തിൽ ബൈറ്റ് തരം ഡാറ്റ സംഭരിക്കുന്ന ഒരു സെറ്റ്-ടൈപ്പ് ഫീൽഡ് ബഫ് ഉണ്ട്, കൂടാതെ എല്ലാ സീരിയലൈസ് ചെയ്ത ഡാറ്റയും ബഫിൽ സംഭരിക്കുന്നു.

നിശ്ചിത ദൈർഘ്യമുള്ള ഡാറ്റയ്ക്ക് (ഉദാ: ബൈറ്റ്, u16, u32, u64, മുതലായവ), ഡാറ്റ നേരിട്ട് ഒരു ബൈറ്റ് അറേയിലേക്ക് പരിവർത്തനം ചെയ്യുകയും തുടർന്ന് ബഫിൽ സൂക്ഷിക്കുകയും ചെയ്യുന്നു; സ്ഥിരമല്ലാത്ത ദൈർഘ്യമുള്ള ഡാറ്റയ്ക്ക്, ദൈർഘ്യം ആദ്യം സീരിയലൈസ് ചെയ്യണം, തുടർന്ന് Ddata (ഉദാഹരണത്തിന്, u16, u32, അല്ലെങ്കിൽ u64 മുതലായവ ഉൾപ്പെടെ, അജ്ഞാത വലുപ്പത്തിലുള്ള ഒപ്പിടാത്ത പൂർണ്ണസംഖ്യകൾ).

ഡീസീരിയലൈസേഷൻ നേരെ വിപരീതമാണ്. ഓരോ സീരിയലൈസേഷൻ രീതിക്കും, അനുബന്ധമായ ഒരു ഡീസിയലൈസേഷൻ രീതിയുണ്ട്. ഡീസീരിയലൈസേഷന് സോഴ്സ് ക്ലാസിന്റെ ഉദാഹരണങ്ങൾ ഉപയോഗിക്കേണ്ടതുണ്ട്. ഈ ക്ലാസ് ഉദാഹരണത്തിന് ബഫ്, പോസ് എന്നീ രണ്ട് ഫീൽഡുകളുണ്ട്. ഡീരിയലൈസ് ചെയ്യേണ്ട ഡാറ്റ സംഭരിക്കുന്നതിന് Buf ഉപയോഗിക്കുന്നു, നിലവിലെ റീഡ് സ്ഥാനം സംഭരിക്കുന്നതിന് pos ഉപയോഗിക്കുന്നു. ഒരു പ്രത്യേക തരം ഡാറ്റ വായിക്കുമ്പോൾ, അതിന്റെ ദൈർഘ്യം നിങ്ങൾക്കറിയാമെങ്കിൽ, നിങ്ങൾക്ക് അത് നേരിട്ട് വായിക്കാം, അജ്ഞാത ദൈർഘ്യമുള്ള ഡാറ്റയ്ക്ക് - ആദ്യം ദൈർഘ്യം വായിക്കുക, തുടർന്ന് ഉള്ളടക്കം വായിക്കുക.

ചെയിനിലെ ഡാറ്റ ആക്‌സസ് ചെയ്യുകയും അപ്‌ഡേറ്റ് ചെയ്യുകയും ചെയ്യുക

ontology-wasm-cdt-rust - ശൃംഖലയിലെ ഡാറ്റയുമായി പ്രവർത്തിക്കുന്നതിനുള്ള ഒരു പ്രവർത്തന രീതി ഉൾക്കൊള്ളുന്നു, ഇത് ഡെവലപ്പർമാർക്ക് ചെയിനിൽ ഡാറ്റ ചേർക്കുന്നതും ഇല്ലാതാക്കുന്നതും മാറ്റുന്നതും അന്വേഷിക്കുന്നതും പോലുള്ള പ്രവർത്തനങ്ങൾ നടപ്പിലാക്കാൻ സൗകര്യപ്രദമാണ്:

• ഡാറ്റാബേസ്::get(കീ) - ശൃംഖലയിൽ നിന്ന് ഡാറ്റ അഭ്യർത്ഥിക്കാൻ ഉപയോഗിക്കുന്നു, കൂടാതെ AsRef ഇന്റർഫേസ് നടപ്പിലാക്കാൻ പ്രധാന അഭ്യർത്ഥനകൾ;
• ഡാറ്റാബേസ്::പുട്ട്(കീ, മൂല്യം) - നെറ്റ്‌വർക്കിൽ ഡാറ്റ സംഭരിക്കുന്നതിന് ഉപയോഗിക്കുന്നു. AsRef ഇന്റർഫേസ് നടപ്പിലാക്കാൻ കീ അഭ്യർത്ഥിക്കുന്നു, എൻകോഡർ ഇന്റർഫേസ് നടപ്പിലാക്കാൻ മൂല്യം അഭ്യർത്ഥിക്കുന്നു;
• ഡാറ്റാബേസ്::delete(കീ) - ചെയിനിൽ നിന്ന് ഡാറ്റ നീക്കംചെയ്യാൻ ഉപയോഗിക്കുന്നു, കൂടാതെ AsRef ഇന്റർഫേസ് നടപ്പിലാക്കാൻ കീ അഭ്യർത്ഥിക്കുന്നു.

കരാർ പരിശോധന

ഒരു കരാറിന്റെ രീതികൾ നടപ്പിലാക്കുമ്പോൾ, ഞങ്ങൾക്ക് ശൃംഖലയിലെ ഡാറ്റയിലേക്ക് ആക്‌സസ് ആവശ്യമാണ്, കരാറിന്റെ ബൈറ്റ്‌കോഡ് എക്‌സിക്യൂട്ട് ചെയ്യുന്നതിന് ഞങ്ങൾക്ക് ഉചിതമായ ഒരു വെർച്വൽ മെഷീൻ ആവശ്യമാണ്, അതിനാൽ പരിശോധനയ്ക്കായി കരാർ ചെയിനിൽ വിന്യസിക്കേണ്ടത് പൊതുവെ ആവശ്യമാണ്. എന്നാൽ ഈ പരിശോധന രീതി പ്രശ്നകരമാണ്. കരാറുകൾ പരിശോധിക്കുന്നത് ഡവലപ്പർമാർക്ക് എളുപ്പമാക്കുന്നതിന്, ontio_std ലൈബ്രറി ടെസ്റ്റിംഗിനായി ഒരു മോക്ക് മൊഡ്യൂൾ നൽകുന്നു. ഈ മൊഡ്യൂൾ സർക്യൂട്ടിലെ ഡാറ്റയുടെ ഒരു സിമുലേഷൻ നൽകുന്നു, ഇത് കരാറിലെ രീതികൾ യൂണിറ്റ് ടെസ്റ്റ് ചെയ്യുന്നത് ഡവലപ്പർമാർക്ക് എളുപ്പമാക്കുന്നു. പ്രത്യേക ഉദാഹരണങ്ങൾ കണ്ടെത്താം ഇവിടെ.

കരാർ ഡീബഗ്ഗിംഗ്

console::debug(msg) ഒരു കരാർ ഡീബഗ് ചെയ്യുമ്പോൾ ഡീബഗ് വിവരങ്ങൾ പ്രദർശിപ്പിക്കുന്നു. msg വിവരങ്ങൾ നോഡ് ലോഗ് ഫയലിലേക്ക് ചേർക്കും. ലോക്കൽ ഓന്റോളജി ടെസ്റ്റ് നോഡ് പ്രവർത്തിക്കുമ്പോൾ ലോഗ് ഫയൽ ലെവൽ ഡീബഗ് മോഡിലേക്ക് സജ്ജമാക്കുക എന്നതാണ് ഒരു മുൻവ്യവസ്ഥ.

runtime::notify(msg) കരാർ ഡീബഗ് ചെയ്യുമ്പോൾ ഉചിതമായ ഡീബഗ് വിവരങ്ങൾ ഔട്ട്പുട്ട് ചെയ്യുന്നു. ഈ രീതി ചെയിനിൽ നൽകിയ വിവരങ്ങൾ സംഭരിക്കും കൂടാതെ getSmartCodeEvent രീതി ഉപയോഗിച്ച് ചെയിനിൽ നിന്ന് അന്വേഷിക്കാനും കഴിയും.

ഹഷ്‌റേറ്റ് ആൻഡ് ഷെയേഴ്‌സിന്റെ എഡിറ്റർമാരാണ് ലേഖനം വിവർത്തനം ചെയ്തത്, പ്രത്യേകിച്ച് ഒന്റോളജി റഷ്യയ്ക്ക് വേണ്ടി. കരയുക

നിങ്ങൾ ഒരു ഡെവലപ്പർ ആണോ? ഞങ്ങളുടെ ടെക് കമ്മ്യൂണിറ്റിയിൽ ചേരുക നിരസിക്കുക. കൂടാതെ, ഒന്നു നോക്കൂ ഡെവലപ്പർ സെന്റർ ഞങ്ങളുടെ വെബ്‌സൈറ്റിൽ, നിങ്ങൾക്ക് ഡെവലപ്പർ ടൂളുകളും ഡോക്യുമെന്റേഷനും മറ്റും കണ്ടെത്താനാകും.

ഓണ്ടിളജി

• ഒന്റോളജി വെബ്സൈറ്റ്
• സാമൂഹികം / നിരസിക്കുക
• കന്വിസന്ദേശം ഇംഗ്ലീഷ് / റഷ്യൻ
• ട്വിറ്റർ / റെഡ്ഡിറ്റ്

അവലംബം: www.habr.com