Waves 블록체인의 오픈 소스 분산 제휴 프로그램

Bettex 팀이 Waves Labs 보조금의 일부로 구현한 Waves 블록체인 기반의 분산형 제휴 프로그램입니다.

게시물은 후원되지 않습니다! 이 프로그램은 오픈 소스이며 사용 및 배포는 무료입니다. 프로그램의 사용은 dApp 애플리케이션의 개발을 자극하고 일반적으로 네트워크의 모든 사용자에게 유익한 탈중앙화를 촉진합니다.

제시된 제휴 프로그램용 dApp은 기능의 일부로 제휴를 포함하는 프로젝트를 위한 템플릿입니다. 코드는 복사를 위한 템플릿, 라이브러리 또는 기술 구현을 위한 일련의 아이디어로 사용할 수 있습니다.

기능면에서 이것은 추천자 등록, 추천에 대한 다단계 보상 발생 및 시스템 등록 동기 부여 (캐시백)를 구현하는 일반적인 제휴 시스템입니다. 시스템은 "순수한" dApp입니다. 즉, 웹 애플리케이션은 자체 백엔드, 데이터베이스 등 없이 블록체인과 직접 상호 작용합니다.

다른 많은 프로젝트에서도 유용할 수 있는 기술이 사용됩니다.

• 즉시 상환되는 크레딧으로 스마트 계정을 호출합니다(통화 시점에는 계정에 통화 대금을 지불할 토큰이 없지만 통화 결과로 표시됨).
• PoW-captcha - 스마트 계정 기능의 고주파 자동 호출에 대한 보호 - captcha와 유사하지만 컴퓨팅 리소스 사용 증명을 통해.
• 템플릿으로 데이터 키를 요청합니다.

응용 프로그램은 다음으로 구성됩니다.

• ride4dapps 언어의 스마트 계정 코드(계획대로 제휴 기능을 구현해야 하는 기본 스마트 계정에 병합됨)
• WAVES NODE REST API를 통해 추상화 계층을 구현하는 js 래퍼;
• 라이브러리와 RIDE 코드를 사용한 예제인 vuejs 프레임워크의 코드입니다.

나열된 모든 기능을 설명하겠습니다.

즉각적인 상환으로 스마트 계정을 부채로 불러들입니다.

InvokeScript를 호출하려면 트랜잭션을 시작한 계정에서 수수료를 지불해야 합니다. 계정에 일정 수의 WAVES 토큰을 보유한 블록체인 괴짜를 위한 프로젝트를 수행하는 경우에는 문제가 되지 않지만 대중을 대상으로 하는 제품이라면 심각한 문제가 됩니다. 결국 사용자는 WAVES 토큰(또는 거래 비용을 지불하는 데 사용할 수 있는 다른 적절한 자산) 구매에 참석해야 하며, 이는 이미 프로젝트에 진입하기 위한 상당한 임계값을 증가시킵니다. 우리는 거래 비용을 지불할 수 있는 사용자에게 자산을 배포할 수 있으며 시스템에서 유동 자산을 펌핑하기 위해 자동화된 시스템이 생성될 때 오용의 위험에 직면할 수 있습니다.

InvokeScript를 "수취인 비용으로"(스크립트가 설치된 스마트 계정) 호출할 수 있다면 매우 편리할 것입니다. 이 가능성은 분명하지는 않지만 존재합니다.

InvokeScript 내부에서 호출자의 주소로 ScriptTransfer가 수행되어 수수료에 소비된 토큰을 보상하면 호출 당시 호출 계정에 자산이 없더라도 호출이 성공합니다. . 이는 충분한 토큰에 대한 확인이 트랜잭션 호출 이전이 아니라 트랜잭션 호출 이후에 이루어지기 때문에 가능합니다. 따라서 즉각적인 상환에 따라 신용으로 트랜잭션을 수행할 수 있습니다.

ScriptTransfer(i.caller, i.fee, 단위)

아래 코드는 스마트 어카운트 자금을 사용하여 사용한 수수료를 환불합니다. 이 기능의 오용을 방지하려면 발신자가 합리적인 한도 내에서 올바른 자산에 수수료를 지출했는지 확인하는 수표를 사용해야 합니다.

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 캡차

작업 증명 캡차의 아이디어는 새로운 것이 아니며 이미 WAVES 기반 프로젝트를 포함하여 다양한 프로젝트에서 구현되었습니다. 아이디어의 요점은 우리 프로젝트의 리소스를 낭비하는 작업을 수행하기 위해 호출자도 자신의 리소스를 소비해야 하므로 리소스 고갈 공격에 상당한 비용이 든다는 것입니다. 트랜잭션 발신자가 PoW 문제를 해결했는지 매우 쉽고 저렴한 검증을 위해 트랜잭션 ID 확인이 있습니다.

if take(toBase58String(i.transactionId), 3) != "123" then throw("작업 증명 실패") else

트랜잭션을 수행하기 위해 호출자는 base58 코드(id)가 숫자 123으로 시작하도록 이러한 매개변수를 선택해야 합니다. 이는 프로세서 시간의 평균 수십 초에 해당하며 일반적으로 우리 작업에 합리적입니다. 더 간단하거나 더 복잡한 PoW가 필요한 경우 작업을 명백한 방식으로 쉽게 수정할 수 있습니다.

템플릿으로 쿼리 데이터 키

블록체인을 데이터베이스로 사용하기 위해서는 템플릿을 사용하여 데이터베이스를 key-val로 쿼리하는 API 도구가 있어야 합니다. 이러한 툴킷은 2019년 XNUMX월 초 매개 변수로 등장했습니다. ?성냥 REST API 요청시 /주소/데이터?일치=regexp. 이제 웹 애플리케이션에서 모든 키가 아닌 하나 이상의 키를 가져와야 하는 경우 일부 그룹만 가져와야 하는 경우 키 이름으로 선택할 수 있습니다. 예를 들어, 이 프로젝트에서 인출 거래는 다음과 같이 인코딩됩니다.

withdraw_${userAddress}_${txid}

템플릿을 사용하여 주어진 주소에 대한 자금 인출 거래 목록을 얻을 수 있습니다.

?matches=withdraw_${userAddress}_.*

이제 완성된 솔루션의 구성 요소를 분석해 보겠습니다.

vuejs 코드

코드는 실제 프로젝트에 가까운 작업 데모입니다. Waves Keeper를 통해 로그인을 구현하고 affiliate.js 라이브러리와 함께 작동하여 시스템에 사용자를 등록하고 트랜잭션 데이터를 쿼리하며 획득한 자금을 사용자 계정으로 인출할 수 있습니다.

RIDE의 코드

등록, 입금, 출금 기능으로 구성되어 있습니다.

등록 기능은 시스템에 사용자를 등록합니다. 여기에는 참조자(참조자의 주소)와 트랜잭션 ID(PoW-captcha 작업)를 선택하는 데 필요한 함수 코드에서 사용되지 않는 솔트 매개변수의 두 가지 매개변수가 있습니다.

함수(이 프로젝트의 나머지 함수와 마찬가지로)는 차용 기술을 사용하며, 함수의 결과는 이 함수를 호출하는 데 드는 비용을 지불하는 것입니다. 이 솔루션 덕분에 방금 지갑을 만든 사용자는 시스템에서 즉시 작업할 수 있으며 거래 수수료를 지불할 수 있는 자산을 획득하거나 받는 문제로 당황할 필요가 없습니다.

등록 기능의 결과는 두 개의 레코드입니다.

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

이를 통해 정방향 및 역방향 조회(지정된 사용자의 참조자 및 지정된 사용자의 모든 참조)가 가능합니다.

펀드 기능은 실제 기능을 개발하기 위한 템플릿에 가깝습니다. 제시된 형태로 거래에 의해 이체된 모든 자금을 가져 와서 1, 2, 3 수준의 추천자 계정, "캐시백" 계정 및 "변경" 계정으로 분배합니다. 계정이 여기에 표시됩니다).

캐쉬백은 최종 사용자가 추천 시스템에 참여하도록 장려하는 수단입니다. 시스템이 지급한 수수료 중 일부를 "캐시백" 형태로 사용자는 추천 보상과 동일한 방식으로 인출할 수 있습니다.

추천 시스템을 사용할 때 시스템이 작동할 스마트 계정의 기본 논리에 내장된 자금 기능을 수정해야 합니다. 예를 들어, 베팅에 대해 추천 보상이 지급되는 경우 베팅이 이루어진 로직에 자금 기능이 내장되어야 합니다(또는 보상이 지급되는 다른 대상 작업이 수행됨). 이 기능에는 세 가지 수준의 추천 보상이 코딩되어 있습니다. 더 많거나 적은 수준을 만들고 싶다면 코드에서도 수정됩니다. 보상 비율은 level1-level3 상수로 설정되며 코드에서 다음과 같이 계산됩니다. 금액 * 레벨 / 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

신청

애플리케이션의 주요 부분은 제휴 데이터 모델과 WAVES NODE REST API 사이의 다리 역할을 하는 affiliate.js 라이브러리입니다. 프레임워크 독립적인 추상화 계층을 구현합니다(아무거나 사용할 수 있음). 활성 기능(등록, 철회)은 Waves Keeper가 시스템에 설치되어 있다고 가정하며 라이브러리 자체는 이를 확인하지 않습니다.

구현 방법:

fetchReferralTransactions
fetchWithdrawTransactions
fetchMyBalance
fetchReferrals
fetchReferer
withdraw
register

메서드의 기능은 이름, 매개 변수 및 반환 데이터에서 명확하게 코드에 설명되어 있습니다. 등록 기능에는 추가 설명이 필요합니다. 트랜잭션 ID 선택 주기를 시작하여 123에서 시작합니다. 이것은 대량 등록을 방지하는 위에서 설명한 PoW 보안 문자입니다. 이 기능은 필요한 ID를 가진 트랜잭션을 찾은 다음 Waves Keeper를 통해 서명합니다.

DEX 제휴 프로그램은 다음에서 사용할 수 있습니다. GitHub.com.

출처 : habr.com