Децентрализирана придружна програма со отворен код на блокчејнот Waves

Децентрализирана придружна програма на блокчејнот Waves, имплементирана како дел од грант на Waves Labs од тимот на Bettex.

Објавата не е реклама! Програмата е со отворен код, нејзината употреба и дистрибуција се бесплатни. Употребата на програмата го стимулира развојот на dApp апликациите и генерално промовира децентрализација, што е од корист за секој корисник на Интернет.

Презентираниот dApp за придружни програми е шаблон за проекти кои вклучуваат affiliate како дел од нивната функционалност. Кодот може да се користи како образец за копирање, како библиотека или како збир на идеи за техничка имплементација.

Во однос на функционалноста, ова е редовен affiliate систем кој имплементира регистрација со реферер, повеќестепена акумулација на награди за упати и мотивација за регистрација во системот (cashback). Системот е „чиста“ dApp, односно веб-апликацијата директно комуницира со блокчејнот, без да има свој заднина, база на податоци итн.

Користени техники кои можат да бидат корисни и во многу други проекти:

• Повикување паметна сметка во долг со итна отплата (во моментот на повикот нема токени на сметката за плаќање на повикот, но тие се појавуваат таму како резултат на повикот).
• PoW-captcha - заштита од високофреквентни автоматизирани повици до функции на паметна сметка - аналогно на captcha, но преку доказ за употреба на компјутерски ресурси.
• Побарајте клучеви за податоци користејќи шаблон.

Апликацијата се состои од:

• код за паметна сметка на јазикот ride4dapps (кој, како што е планирано, се спојува во главната паметна сметка за која треба да се имплементира функционалноста на филијалата);
• js обвивка што имплементира ниво на апстракција преку WAVES NODE REST API;
• код на рамката vuejs, што е пример за користење на библиотеката и кодот RIDE.

Дозволете ни да ги опишеме сите наведени карактеристики.

Повикување паметна сметка за долг со итна отплата

Повикувањето на InvokeScript бара плаќање на надомест од сметката што ја иницира трансакцијата. Ова не е проблем ако правите проект за блокчејн гикови кои имаат одредена количина WAVES токени на нивната сметка, но ако производот е наменет за употреба од пошироката јавност, ова станува сериозен проблем. На крајот на краиштата, корисникот мора да се грижи за купување на WAVES токени (или друго соодветно средство што може да се користи за плаќање за трансакции), што ја зголемува веќе значителната бариера за влез во проектот. Можеме да дистрибуираме средство на корисници кои ќе можат да платат за трансакции и ќе се соочат со ризикот од нивна злоупотреба кога ќе се создадат автоматски системи за испумпување на ликвидно средство од нашиот систем.

Би било многу погодно ако може да се повика InvokeScript „на сметка на примачот“ (паметната сметка на која е инсталирана скриптата), а таква можност, иако не на очигледен начин, постои.

Ако во InvokeScript направите ScriptTransfer на адресата на повикувачот, што ги компензира потрошените токени за надомест, тогаш таквиот повик ќе биде успешен, дури и ако во моментот на повикот немало средства на сметката за повикување. Ова е можно затоа што проверката за доволни токени се врши откако ќе се повика трансакцијата, а не пред неа, така што трансакциите може да се направат на кредит, што подлежи на итна отплата.

Трансфер на скрипта (i.caller, i.eee, единица)

Кодот подолу ја надоместува потрошената такса со помош на средства од паметна сметка. За да се заштитите од злоупотреба на оваа функција, неопходно е да се провери дали повикувачот ја троши таксата во бараното средство и во разумни граници:

func checkFee(i:Invocation) = {
if i.fee > maxFee then throw(“unreasonable large fee”) else
if i.feeAssetId != unit then throw(“fee must be in WAVES”) else true
}

Исто така, за заштита од злонамерно и бесмислено трошење средства, потребна е автоматска заштита од повици (PoW-captcha).

PoW-капча

Самата идеја за captcha за доказ за работа не е нова и веќе е имплементирана во различни проекти, вклучително и оние кои се имплементирани врз основа на WAVES. Идејата е дека за да се изврши дејство што ги троши ресурсите на нашиот проект, повикувачот мора да ги потроши и сопствените ресурси, што го прави нападот со трошење ресурси прилично скап. За многу лесна и евтина валидација дека испраќачот на трансакцијата го решил проблемот со PoW, постои проверка на идентификација на трансакцијата:

ако take(toBase58String(i.transactionId), 3) != „123“ потоа фрли („доказот за работа не успеа“) друго

За да изврши трансакција, повикувачот мора да избере такви параметри така што неговата основна шифра58 (ид) започнува со броевите 123, што во просек одговара на неколку десетици секунди од времето на процесорот и е генерално разумно за нашата задача. Ако е потребен поедноставен или покомплексен PoW, тогаш задачата може лесно да се измени на очигледен начин.

Побарајте клучеви за податоци користејќи шаблон

Со цел да се користи blockchain како база на податоци, од витално значење е да се имаат API алатки за пребарување на базата на податоци како key-val врз основа на шаблони. Таков комплет алатки се појави на почетокот на јули 2019 година во форма на параметар ? натпревари на барање REST API /адреси/податоци?matches=regexp. Сега, ако треба да добиеме повеќе од еден клуч од веб апликација и не сите клучеви одеднаш, туку само некоја група, тогаш можеме да направиме избор по име на клучот. На пример, во овој проект, трансакциите за повлекување се кодирани како

withdraw_${userAddress}_${txid}

што ви овозможува да добиете список на трансакции за повлекување средства за која било дадена адреса користејќи го шаблонот:

?matches=withdraw_${userAddress}_.*

Сега да ги погледнеме компонентите на готовиот раствор.

Vuejs код

Кодот е работна демо блиска до вистинскиот проект. Имплементира најавување преку Waves Keeper и работи со библиотеката affiliate.js, со која го регистрира корисникот во системот, бара податоци за трансакциите, а исто така ви овозможува да ги повлечете заработените средства на сметката на корисникот.

Код за RIDE

Се состои од функции за регистрација, финансирање и повлекување.

Функцијата за регистрација регистрира корисник на системот. Има два параметри: реферер (адреса на реферер) и параметар сол, кој не се користи во функцискиот код, кој е потребен за избор на идентификација на трансакцијата (задача PoW-captcha).

Функцијата (како и другите функции од овој проект) ја користи техниката на повик на долг, резултатот од функцијата е да се финансира плаќањето на надоместокот за повикување на оваа функција. Благодарение на ова решение, корисникот кој штотуку креирал паричник може веднаш да работи со системот и не мора да се грижи за купување или примање средство кое му овозможува да плати провизија за трансакција.

Резултатот од функцијата за регистрација е два записи:

${owner)_referer = referer
${referer}_referral_${owner} = owner

Ова овозможува пребарување напред и назад (упатувач на даден корисник и сите упатувања на даден корисник).

Функцијата фонд е повеќе шаблон за развој на вистинска функционалност. Во својата претставена форма, ги зема сите средства префрлени од трансакцијата и ги дистрибуира на сметките на упатувачите од нивоа 1, 2, 3, на сметката „cashback“ и сметката „change“ (сè што останува кога се дистрибуира на претходните сметките одат овде).

Cashback е средство за мотивирање на крајниот корисник да учествува во системот за упатување. Корисникот може да го повлече делот од провизијата што ја плаќа системот во форма на „кешбек“ на ист начин како и наградите за упатувања.

При користење на систем за упатување, функцијата на фондот треба да биде изменета и интегрирана во главната логика на паметната сметка на која ќе работи системот. На пример, ако се плаќа награда за упатување за направен облог, тогаш функцијата на фондот треба да биде вградена во логиката каде што се става облогот (или се врши друго насочено дејство за кое се плаќа наградата). Три нивоа на награди за упатување се кодирани во оваа функција. Ако треба да направите повеќе или помалку нивоа, тогаш ова е исто така поправено во кодот. Процентот на награда е поставен со константите на ниво1-ниво3 во кодот како што се пресметува износ * ниво / 1000, односно вредноста 1 одговара на 0,1% (ова може да се смени и во кодот).

Повикувањето на функцијата го менува салдото на сметката и исто така создава записи за потребите на евиденција на формуларот:

fund_address_txid = address:owner:inc:level:timestamp
Для получения timestamp (текущего времени) используется такая вот связка
func getTimestamp() = {
let block = extract(blockInfoByHeight(height))
toString(block.timestamp)
}

Односно, времето на трансакцијата е времето на блокот во кој се наоѓа. Ова е посигурно од користењето на временскиот печат од самата трансакција, особено затоа што не е достапен од повикувачот.
Функцијата за повлекување ги прикажува сите акумулирани награди на сметката на корисникот. Создава записи за цели на евиденција:

# withdraw log: withdraw_user_txid=amount:timestamp

Апликација

Главниот дел од апликацијата е библиотеката affiliate.js, која е мост помеѓу моделите на affiliate податоци и WAVES NODE REST API. Спроведува ниво на апстракција независно од рамката (може да се користи кое било). Активните функции (регистрирај се, повлечеш) претпоставуваат дека Waves Keeper е инсталиран на системот самата библиотека не го проверува тоа;

Спроведува методи:

fetchReferralTransactions
fetchWithdrawTransactions
fetchMyBalance
fetchReferrals
fetchReferer
withdraw
register

Функционалноста на методите е очигледна од имињата на параметрите и вратените податоци се опишани во кодот. Регистрираната функција бара дополнителни коментари - започнува циклус на избирање на идентификација на трансакцијата, така што започнува на 123 - ова е PoW-captcha опишана погоре, која штити од масовни регистрации. Функцијата наоѓа трансакција со потребната идентификација, а потоа ја потпишува преку Waves Keeper.

DEX affiliate програма е достапна на GitHub.com.

Извор: www.habr.com