Waves ブロックチェーン上の分散型オープンソース アフィリエイト プログラム

Waves ブロックチェーン上の分散型アフィリエイト プログラム。Bettex チームによる Waves Labs 助成金の一部として実装されています。

投稿は宣伝ではありません！ このプログラムはオープンソースであり、使用と配布は無料です。 このプログラムを使用すると、dApp アプリケーションの開発が促進され、一般に分散化が促進され、すべてのインターネット ユーザーに利益がもたらされます。

提示されたアフィリエイト プログラム用の dApp は、機能の一部としてアフィリエイトを含むプロジェクト用のテンプレートです。 コードは、コピー用のテンプレートとして、ライブラリとして、または技術的な実装のためのアイデアのセットとして使用できます。

機能面では、紹介者への登録、紹介に対する多段階の報酬獲得、システム登録動機（キャッシュバック）を実現した正規アフィリエイトシステムです。 このシステムは「純粋な」dApp です。つまり、Web アプリケーションは独自のバックエンドやデータベースなどを持たずに、ブロックチェーンと直接対話します。

他の多くのプロジェクトでも役立つテクニックが使用されています。

• スマート アカウントに即時返済付きの借金をコールします (コールの時点では、コールの支払いに必要なトークンがアカウントにありませんが、コールの結果としてトークンがそこに表示されます)。
• PoW-captcha - スマート アカウント機能への高頻度の自動呼び出しに対する保護 - キャプチャに似ていますが、コンピューティング リソースの使用の証明を通じて行われます。
• テンプレートを使用してデータキーをクエリします。

アプリケーションは次のもので構成されます。

• ride4dapps 言語のスマート アカウント コード (予定通り、アフィリエイト機能を実装する必要があるメインのスマート アカウントにマージされます)。
• WAVES NODE REST API の抽象化レベルを実装する js ラッパー。
• vuejs フレームワークのコード。ライブラリと RIDE コードの使用例です。

リストされたすべての機能について説明しましょう。

すぐに返済できる借金のスマートアカウントを呼び出す

InvokeScript を呼び出すには、トランザクションを開始するアカウントから料金を支払う必要があります。 これは、アカウントに一定量の WAVES トークンを保有しているブロックチェーンオタク向けのプロジェクトを作成する場合には問題ありませんが、製品が一般の人々による使用を目的としている場合、これは深刻な問題になります。 結局のところ、ユーザーは WAVES トークン (またはトランザクションの支払いに使用できる別の適切な資産) の購入を行う必要があり、プロジェクトへの参入に対するすでにかなりの障壁が高くなります。 当社のシステムから流動資産を汲み出す自動システムが作成されると、取引の支払いができるユーザーに資産を配布できますが、悪用のリスクに直面することになります。

「受信者 (スクリプトがインストールされているスマート アカウント) を犠牲にして」 InvokeScript を呼び出すことができれば非常に便利です。そのような可能性は、明らかな方法ではありませんが、存在します。

InvokeScript 内で呼び出し元のアドレスに ScriptTransfer を実行し、消費された料金トークンを補填する場合、呼び出し時に呼び出し側アカウントに資産がなかったとしても、そのような呼び出しは成功します。 これが可能になるのは、トランザクションが呼び出される前ではなく、呼び出し後に十分なトークンがあるかどうかのチェックが行われるためであり、即時返済の条件でクレジット上でトランザクションを行うことができます。

ScriptTransfer(i.caller、i.fee、unit)

以下のコードは、スマート アカウントの資金を使用して使用済み料金を払い戻します。 この機能の悪用を防ぐには、呼び出し元が必要な資産に、妥当な範囲内で料金を費やしたことを確認するチェックを使用する必要があります。

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キャプチャ

proof-of-work キャプチャのアイデア自体は新しいものではなく、WAVES に基づいて実装されたプロジェクトを含む、さまざまなプロジェクトですでに実装されています。 この考え方は、プロジェクトのリソースを消費するアクションを実行するには、呼び出し元も自分のリソースを消費する必要があるため、リソース枯渇攻撃は非常に高価になるということです。 トランザクションの送信者が PoW 問題を解決したことを非常に簡単かつ低コストで検証するには、トランザクション ID チェックがあります。

if take(toBase58String(i.transactionId), 3) != “123” then throw(“proof of work failed”) else

トランザクションを実行するには、呼び出し元は、base58 コード (id) が数字 123 で始まるようにパラメーターを選択する必要があります。これは、平均して数十秒のプロセッサー時間に相当し、一般にこのタスクにとって妥当な値です。 より単純な、またはより複雑な PoW が必要な場合、タスクは明らかな方法で簡単に変更できます。

テンプレートを使用してデータキーをクエリする

ブロックチェーンをデータベースとして使用するには、テンプレートに基づいてデータベースを key-val としてクエリするための API ツールが不可欠です。 このようなツールキットは、パラメーターの形式で 2019 年 XNUMX 月初めに登場しました。 ?一致 REST APIリクエスト時 /addresses/data?matches=regexp。 ここで、Web アプリケーションから複数のキーを取得する必要があり、すべてのキーを一度に取得するのではなく、一部のグループのみを取得する必要がある場合は、キー名で選択できます。 たとえば、このプロジェクトでは、出金トランザクションは次のようにエンコードされます。

withdraw_${userAddress}_${txid}

これにより、テンプレートを使用して、特定のアドレスの資金を引き出すためのトランザクションのリストを取得できます。

?matches=withdraw_${userAddress}_.*

次に、完成したソリューションのコンポーネントを見てみましょう。

Vuejsコード

このコードは、実際のプロジェクトに近い動作デモです。 Waves Keeper を介してログインを実装し、affiliate.js ライブラリと連携して、システムへのユーザーの登録、トランザクション データのクエリを実行し、獲得した資金をユーザーのアカウントに引き出すこともできます。

RIDEのコード

登録、入金、出金の機能で構成されます。

register 関数は、システムにユーザーを登録します。 これには、referer (参照元アドレス) と、トランザクション ID (PoW-captcha タスク) を選択するために必要な関数コードでは使用されない Salt パラメーターの XNUMX つのパラメーターがあります。

この関数は (このプロジェクトの他の関数と同様に) デット コール手法を使用しており、関数の結果として、この関数を呼び出すための料金の支払いに資金を提供します。 このソリューションのおかげで、ウォレットを作成したばかりのユーザーはすぐにシステムを操作できるようになり、取引手数料を支払うための資産の購入や受け取りについて心配する必要がなくなります。

登録関数の結果は XNUMX つのレコードになります。

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

これにより、前方および逆方向の検索 (特定のユーザーの参照元および特定のユーザーのすべての紹介) が可能になります。

ファンド機能は、実際の機能を開発するためのテンプレートのようなものです。 提示されているように、トランザクションによって転送されたすべての資金が取得され、レベル 1、2、3 の紹介者のアカウント、「キャッシュバック」アカウントおよび「変更」アカウントに分配されます (以前のアカウントへの分配中に残ったすべての資金が送られてきます)ここ）。

キャッシュバックは、エンドユーザーに紹介システムへの参加を促す手段です。 ユーザーは紹介報酬と同様に、システムが支払った手数料の一部を「キャッシュバック」の形で引き出すことができます。

紹介システムを使用する場合、ファンド機能を変更し、システムが動作するスマート アカウントのメイン ロジックに統合する必要があります。 たとえば、行われた賭けに対して紹介報酬が支払われる場合、賭けが行われるロジックにファンド関数を組み込む必要があります (または、報酬が支払われる別の対象アクションが実行されます)。 この関数には、1 レベルの紹介報酬がコード化されています。 作成するレベルを増減する必要がある場合は、これもコード内で修正されます。 報酬のパーセンテージはレベル 3 ～ レベル XNUMX の定数によって設定され、コードでは次のように計算されます。 量 * レベル / 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

メソッドの機能は名前から明らかであり、パラメーターと返されるデータはコードで説明されています。 register 関数には追加のコメントが必要です。123 から始まるようにトランザクション ID を選択するサイクルが開始されます。これは、大量の登録から保護する前述の PoW-captcha です。 この関数は、必要な ID を持つトランザクションを検索し、Waves Keeper を通じてそれに署名します。

DEX アフィリエイト プログラムは次の場所で利用できます。 GitHub.com.

出所： habr.com