ઓન્ટોલોજી નેટવર્ક પર વેબ એસેમ્બલી સ્માર્ટ કોન્ટ્રાક્ટ કેવી રીતે લખવો? ભાગ 1: રસ્ટ

ઑન્ટોલોજી Wasm ટેક્નોલોજી બ્લોકચેનમાં જટિલ બિઝનેસ લોજિક સાથે dApp સ્માર્ટ કોન્ટ્રાક્ટને સ્થાનાંતરિત કરવાની કિંમત ઘટાડે છે, જેનાથી dApp ઇકોસિસ્ટમને મોટા પ્રમાણમાં સમૃદ્ધ બનાવે છે.

В настоящее время ઓન્ટોલોજી વાસ્મ સાથે જ રસ્ટ અને C++ વિકાસ બંનેને સપોર્ટ કરે છે. રસ્ટ લેંગ્વેજ Wasm ને વધુ સારી રીતે સપોર્ટ કરે છે, અને જનરેટ થયેલ બાયટેકોડ સરળ છે, જે કોન્ટ્રાક્ટ કોલ્સનો ખર્ચ વધુ ઘટાડી શકે છે. તેથી, ઓન્ટોલોજી નેટવર્ક પર કરાર વિકસાવવા માટે રસ્ટનો ઉપયોગ કેવી રીતે કરવો?

રસ્ટ સાથે WASM કરાર વિકસાવવો

એક કરાર બનાવો

કાર્ગો રસ્ટ ડેવલપમેન્ટ માટે એક સારું પ્રોજેક્ટ બનાવટ અને પેકેજ મેનેજમેન્ટ ટૂલ છે, જે વિકાસકર્તાઓને કોડ અને તૃતીય-પક્ષ લાઇબ્રેરીઓની ક્રિયાપ્રતિક્રિયાને વધુ સારી રીતે ગોઠવવામાં મદદ કરે છે. નવો ઓન્ટોલોજી વાસ્મ કોન્ટ્રેક્ટ બનાવવા માટે, ફક્ત નીચેનો આદેશ ચલાવો:

પ્રોજેક્ટ માળખું તે બનાવે છે:

Cargo.toml ફાઇલનો ઉપયોગ મૂળભૂત પ્રોજેક્ટ માહિતી અને આશ્રિત લાઇબ્રેરી માહિતી સેટ કરવા માટે થાય છે. ફાઈલનો [lib] વિભાગ crate-type = ["cdylib"] પર સેટ હોવો જોઈએ. lib.rs ફાઇલનો ઉપયોગ કોન્ટ્રાક્ટ લોજિક કોડ લખવા માટે થાય છે. વધુમાં, તમારે Cargo.toml રૂપરેખાંકન ફાઇલના [નિર્ભરતા] વિભાગમાં નિર્ભરતા પરિમાણો ઉમેરવાની જરૂર છે:

આ નિર્ભરતા સાથે, વિકાસકર્તાઓ એવા ઈન્ટરફેસને કૉલ કરી શકે છે જે ઑન્ટોલોજી બ્લોકચેન અને ટૂલ્સ જેમ કે સીરિયલાઈઝેશન પેરામીટર સાથે ક્રિયાપ્રતિક્રિયા કરે છે.

કરાર પ્રવેશ કાર્ય

દરેક પ્રોગ્રામમાં ઇનપુટ ફંક્શન હોય છે, જેમ કે મુખ્ય ફંક્શન જે આપણે સામાન્ય રીતે જોઈએ છીએ, પરંતુ કોન્ટ્રાક્ટમાં મુખ્ય કાર્ય હોતું નથી. જ્યારે રસ્ટનો ઉપયોગ કરીને Wasm કોન્ટ્રાક્ટ વિકસાવવામાં આવે છે, ત્યારે ડિફોલ્ટ ઇન્વોક ફંક્શનનો ઉપયોગ કોન્ટ્રાક્ટનો ઉપયોગ કરવા માટે ઇનપુટ ફંક્શન તરીકે થાય છે. રસ્ટ સોર્સ કોડને બાઇટકોડમાં કમ્પાઇલ કરતી વખતે રસ્ટમાં ફંક્શનનું નામ અસ્પષ્ટ હશે જે વર્ચ્યુઅલ મશીન દ્વારા એક્ઝિક્યુટ કરી શકાય છે. કમ્પાઈલરને રીડન્ડન્ટ કોડ જનરેટ કરતા અટકાવવા અને કોન્ટ્રાક્ટનું કદ ઘટાડવા માટે, ઇન્વોક ફંક્શન #[no_mangle] એનોટેશન ઉમેરે છે.

ઇન્વોક ફંક્શન ટ્રાન્ઝેક્શન એક્ઝિક્યુટ કરવા માટે પેરામીટર્સ કેવી રીતે મેળવે છે?

ontio_std લાઇબ્રેરી ટ્રાન્ઝેક્શન ચલાવવા માટે પરિમાણો મેળવવા માટે રનટાઇમ::ઇનપુટ() ફંક્શન પ્રદાન કરે છે. ડેવલપર્સ પરિણામી બાઈટ એરેને ડીસીરિયલાઈઝ કરવા માટે ZeroCopySource નો ઉપયોગ કરી શકે છે. જેમાં વાંચવામાં આવેલ બાઈટ્સની પ્રથમ એરે ઇન્વોક મેથડનું નામ છે, ત્યારબાદ મેથડ પેરામીટર્સ.

કરાર અમલનું પરિણામ કેવી રીતે પરત આવે છે?

ontio_std લાઇબ્રેરી દ્વારા આપવામાં આવેલ રનટાઈમ::રેટ ફંક્શન મેથડ એક્ઝેક્યુશનનું પરિણામ આપે છે.

પૂર્ણ ઇન્વોક ફંક્શન આના જેવું દેખાય છે:

કોન્ટ્રેક્ટ ડેટાને સીરીયલાઇઝિંગ અને ડીસીરિયલાઇઝ કરવું

કોન્ટ્રેક્ટ વિકસાવવાની પ્રક્રિયામાં, વિકાસકર્તાઓ હંમેશા સીરીયલાઈઝેશન અને ડીસીરીલાઈઝેશનની સમસ્યાઓનો સામનો કરે છે, ખાસ કરીને ડેટાબેઝમાં સ્ટ્રક્ટ ડેટા પ્રકાર કેવી રીતે સંગ્રહિત કરવો અને સ્ટ્રક્ચર ડેટા પ્રકાર મેળવવા માટે ડેટાબેઝમાંથી વાંચેલા બાઈટ એરેને કેવી રીતે ડીસીરિયલાઈઝ કરવું.

ontio_std લાઇબ્રેરી ડેટા સીરીયલાઇઝેશન અને ડીસીરીયલાઇઝેશન માટે ડીકોડર અને એન્કોડર ઇન્ટરફેસ પૂરા પાડે છે. સ્ટ્રક્ચરના ક્ષેત્રો ડીકોડર અને એન્કોડર ઈન્ટરફેસને પણ અમલમાં મૂકે છે જેથી સ્ટ્રક્ચરને સીરીયલાઈઝ અને ડીસીરિયલાઈઝ કરી શકાય. જ્યારે વિવિધ ડેટા પ્રકારોને ક્રમાંકિત કરવામાં આવે ત્યારે સિંક વર્ગના ઉદાહરણો જરૂરી છે. સિંક ક્લાસના ઉદાહરણમાં સેટ-ટાઈપ ફીલ્ડ બફ હોય છે જે બાઈટ ટાઈપ ડેટા સ્ટોર કરે છે અને તમામ સીરીલાઈઝ્ડ ડેટા બફમાં સ્ટોર થાય છે.

નિશ્ચિત લંબાઈના ડેટા માટે (દા.ત.: બાઈટ, u16, u32, u64, વગેરે), ડેટા સીધો બાઈટ એરેમાં રૂપાંતરિત થાય છે અને પછી buf માં સંગ્રહિત થાય છે; બિન-નિશ્ચિત લંબાઈના ડેટા માટે, લંબાઈ પહેલા ક્રમાંકિત હોવી જોઈએ, પછી Ddata (ઉદાહરણ તરીકે, u16, u32, અથવા u64, વગેરે સહિત અજાણ્યા કદના સહી ન કરેલા પૂર્ણાંકો).

ડિસિરિયલાઈઝેશન બરાબર વિરુદ્ધ છે. દરેક સીરીયલાઈઝેશન પદ્ધતિ માટે, અનુરૂપ ડીસીરીલાઈઝેશન પદ્ધતિ છે. ડીસીરિયલાઈઝેશન માટે સ્ત્રોત વર્ગના ઉદાહરણોનો ઉપયોગ જરૂરી છે. આ વર્ગના દાખલામાં બે ફીલ્ડ buf અને pos છે. બફનો ઉપયોગ ડેટાને ડીસીરિયલાઈઝ કરવા માટે સંગ્રહિત કરવા માટે થાય છે અને પોઝનો ઉપયોગ વર્તમાન વાંચવાની સ્થિતિને સંગ્રહિત કરવા માટે થાય છે. જ્યારે કોઈ ચોક્કસ પ્રકારનો ડેટા વાંચવામાં આવે છે, જો તમે તેની લંબાઈ જાણો છો, તો તમે તેને સીધો વાંચી શકો છો, અજાણ્યા લંબાઈના ડેટા માટે - પહેલા લંબાઈ વાંચો, પછી સામગ્રીઓ વાંચો.

સાંકળમાં ડેટા ઍક્સેસ અને અપડેટ કરો

ઓન્ટોલોજી-wasm-cdt-રસ્ટ - સાંકળમાં ડેટા સાથે કામ કરવા માટેની એક ઓપરેશનલ પદ્ધતિને સમાવિષ્ટ કરી, જે વિકાસકર્તાઓ માટે નીચે પ્રમાણે ડેટા ઉમેરવા, કાઢી નાખવા, બદલવા અને ક્વેરી કરવા જેવી કામગીરી અમલમાં મૂકવા માટે અનુકૂળ છે:

• ડેટાબેઝ::ગેટ(કી) - તેનો ઉપયોગ સાંકળમાંથી ડેટાની વિનંતી કરવા માટે થાય છે, અને કી AsRef ઇન્ટરફેસના અમલીકરણની વિનંતી કરે છે;
• ડેટાબેઝ::પુટ(કી, મૂલ્ય) - નેટવર્ક પર ડેટા સ્ટોર કરવા માટે વપરાય છે. કી AsRef ઇન્ટરફેસના અમલીકરણની વિનંતી કરે છે, અને મૂલ્ય એન્કોડર ઇન્ટરફેસના અમલીકરણની વિનંતી કરે છે;
• ડેટાબેઝ::ડિલીટ(કી) - નો ઉપયોગ સાંકળમાંથી ડેટાને દૂર કરવા માટે થાય છે, અને કી AsRef ઈન્ટરફેસના અમલીકરણની વિનંતી કરે છે.

કરાર પરીક્ષણ

જ્યારે કરારની પદ્ધતિઓ લાગુ કરવામાં આવે છે, ત્યારે અમને સાંકળ પરના ડેટાની ઍક્સેસની જરૂર હોય છે અને કરારના બાઇટકોડને એક્ઝિક્યુટ કરવા માટે અમને યોગ્ય વર્ચ્યુઅલ મશીનની જરૂર હોય છે, તેથી સામાન્ય રીતે પરીક્ષણ માટે સાંકળ પર કરારનો ઉપયોગ કરવો જરૂરી છે. પરંતુ પરીક્ષણની આ પદ્ધતિ સમસ્યારૂપ છે. વિકાસકર્તાઓ માટે કરારનું પરીક્ષણ કરવાનું સરળ બનાવવા માટે, ontio_std લાઇબ્રેરી પરીક્ષણ માટે મોક મોડ્યુલ પ્રદાન કરે છે. આ મોડ્યુલ સર્કિટમાં ડેટાનું સિમ્યુલેશન પ્રદાન કરે છે, જે વિકાસકર્તાઓ માટે કરારમાંની પદ્ધતિઓનું એકમ પરીક્ષણ કરવાનું સરળ બનાવે છે. ચોક્કસ ઉદાહરણો મળી શકે છે અહીં.

કોન્ટ્રાક્ટ ડીબગીંગ

કોન્ટ્રાક્ટ ડીબગ કરતી વખતે console::debug(msg) ડીબગ માહિતી દર્શાવે છે. નોડ લોગ ફાઈલમાં msg માહિતી ઉમેરવામાં આવશે. જ્યારે સ્થાનિક ઓન્ટોલોજી ટેસ્ટ નોડ ચાલી રહ્યું હોય ત્યારે લોગ ફાઇલ લેવલને ડીબગ મોડ પર સેટ કરવાની પૂર્વશરત છે.

runtime::notify(msg) યોગ્ય ડીબગ માહિતી આઉટપુટ કરે છે જ્યારે કોન્ટ્રાક્ટ ડીબગ કરવામાં આવે છે. આ પદ્ધતિ સાંકળમાં દાખલ કરેલી માહિતીને સંગ્રહિત કરશે અને getSmartCodeEvent પદ્ધતિનો ઉપયોગ કરીને સાંકળમાંથી પૂછપરછ કરી શકાય છે.

લેખનો અનુવાદ હશરતે એન્ડ શેર્સના સંપાદકો દ્વારા ખાસ કરીને ઑન્ટોલોજી રશિયા માટે કરવામાં આવ્યો હતો. રડવું

શું તમે વિકાસકર્તા છો? પર અમારા ટેક સમુદાયમાં જોડાઓ વિરામ. પણ, પર એક નજર વિકાસકર્તા કેન્દ્ર અમારી વેબસાઇટ પર, જ્યાં તમે વિકાસકર્તા સાધનો, દસ્તાવેજીકરણ અને વધુ શોધી શકો છો.

ઑન્ટોલોજી

• ઓન્ટોલોજી વેબસાઇટ
• GitHub / વિરામ
• Telegram અંગ્રેજી / રશિયન
• Twitter / Reddit

સોર્સ: www.habr.com