Waves RIDE dApp を構築、デプロイ、テストする方法

こんにちは！ この記事では、Waves ノード上で通常の dApp を作成して実行する方法を説明します。 必要なツールや手法、開発例を見てみましょう。

dApp と通常のアプリケーションの開発スキームはほぼ同じです。

• コードを書く
• 自動テストの作成
• アプリケーションの起動
• テスト

ツール

1. docker ノードとWaves Explorerを実行するには

ノードを開始したくない場合は、この手順をスキップできます。 結局のところ、テストと実験のネットワークが存在します。 ただし、独自のノードをデプロイしないと、テスト プロセスが長引く可能性があります。

• テスト トークンを持つ新しいアカウントが常に必要になります。 テスト ネットワーク フォーセットは 10 分ごとに 10 WAVE を転送します。
• テスト ネットワークの平均ブロック時間は 1 分、ノードでは 15 秒です。 これは、トランザクションで複数の確認が必要な場合に特に顕著です。
• パブリック テスト ノードでは積極的なキャッシュが可能です。
• また、メンテナンス等により一時的にご利用いただけない場合もございます。

ここからは、独自のノードを使用して作業していることを前提とします。

2. サーフボードコマンドラインツール

• ここから、ppa、homebrew、または exe を使用して Node.js をダウンロードしてインストールします。 https://nodejs.org/en/download/.
• 既存のノードでテストを実行できるツールである Surfboard をインストールします。

npm install -g @waves/surfboard

3. Visual Studio コードプラグイン

IDE のファンではなく、テキスト エディタを好む場合、この手順はオプションです。 必要なツールはすべてコマンド ライン ユーティリティです。 vimを使用する場合はプラグインに注意してください ヴィムライド.

Visual Studio コードをダウンロードしてインストールします。 https://code.visualstudio.com/

VS Code を開いて、waves-ride プラグインをインストールします。

Waves Keeper ブラウザ拡張機能: https://wavesplatform.com/products-keeper

完了！

ノードとWaves Explorerを起動します。

1. ノードを起動します。

docker run -d -p 6869:6869 wavesplatform/waves-private-node

ノードが REST API 経由で起動されていることを確認してください。 http://localhost:6869:

ノード用の Swagger REST API

2. Waves Explorer のインスタンスを起動します。

docker run -d -e API_NODE_URL=http://localhost:6869 -e NODE_LIST=http://localhost:6869 -p 3000:8080 wavesplatform/explorer

ブラウザを開いて、 http://localhost:3000。 空のローカル ノード回路がいかに迅速に構築されるかがわかります。

Waves Explorer にローカル ノード インスタンスが表示される

RIDE構造とサーフボードツール

空のディレクトリを作成し、その中でコマンドを実行します

surfboard init

このコマンドは、プロジェクト構造、「hello world」アプリケーションおよびテストを含むディレクトリを初期化します。 VS Code でこのフォルダーを開くと、次の内容が表示されます。

サーフボード.config.json

• ./ride/ フォルダーの下に、dApp コードが配置されているディレクトリである、wallet.ride という単一のファイルがあります。 次のブロックでは dApp を簡単に分析します。
• ./test/ フォルダーの下に *.js ファイルがあります。 テストはここに保存されます。
• ./surfboard.config.json – テストを実行するための構成ファイル。

Envs は重要なセクションです。 各環境は次のように構成されています。

• dApp の起動に使用されるノードの REST API エンドポイントとネットワークの CHAIN_ID。
• テスト トークンのソースとなるトークンを持つアカウントの秘密のフレーズ。

ご覧のとおり、surfboard.config.json はデフォルトで複数の環境をサポートしています。 デフォルトはローカル環境です (defaultEnv キーは変更可能なパラメータです)。

ウォレットデモアプリケーション

このセクションは RIDE 言語への言及ではありません。 むしろ、ブロックチェーンで何が起こっているかをよりよく理解するために、デプロイおよびテストするアプリケーションに注目してください。

簡単な Wallet デモ アプリケーションを見てみましょう。 誰でも dApp アドレスにトークンを送信できます。 WAVES を引き出すことのみが可能です。 InvokeScriptTransaction 経由で XNUMX つの @Callable 関数を使用できます。

• deposit()WAVES での支払いが必要です
• withdraw(amount: Int)トークンを返す

dApp のライフサイクル全体を通じて、構造 (アドレス → 金額) が維持されます。

Action
結果の状態

初期
空の

アリスは 5 WAVES をデポジットします
アリスアドレス → 500000000

ボブが 2 WAVES をデポジット

アリスアドレス → 500000000
ボブアドレス → 200000000

ボブは7 WAVESを撤退する
拒否されました！

アリスは4 WAVESを撤退します
アリスアドレス → 100000000
ボブアドレス → 200000000

状況を完全に理解するためのコードは次のとおりです。

# In this example multiple accounts can deposit their funds and safely take them back. No one can interfere with this.
# An inner state is maintained as mapping `address=>waves`.
{-# STDLIB_VERSION 3 #-}
{-# CONTENT_TYPE DAPP #-}
{-# SCRIPT_TYPE ACCOUNT #-}
@Callable(i)
func deposit() = {
 let pmt = extract(i.payment)
 if (isDefined(pmt.assetId))
    then throw("works with waves only")
    else {
     let currentKey = toBase58String(i.caller.bytes)
     let currentAmount = match getInteger(this, currentKey) {
       case a:Int => a
       case _ => 0
     }
     let newAmount = currentAmount + pmt.amount
     WriteSet([DataEntry(currentKey, newAmount)]) 
   }
 }
@Callable(i)
func withdraw(amount: Int) = {
 let currentKey = toBase58String(i.caller.bytes)
 let currentAmount = match getInteger(this, currentKey) {
   case a:Int => a
   case _ => 0
 }
 let newAmount = currentAmount - amount
 if (amount < 0)
   then throw("Can't withdraw negative amount")
   else if (newAmount < 0)
     then throw("Not enough balance")
     else ScriptResult(
       WriteSet([DataEntry(currentKey, newAmount)]),
       TransferSet([ScriptTransfer(i.caller, amount, unit)])
      )
 }
@Verifier(tx)
func verify() = false

サンプルコードは次の場所にもあります。 GitHubの.

VSCode プラグインは、ファイル編集中の継続的なコンパイルをサポートしています。 したがって、[PROBLEMS] タブでいつでもエラーを監視できます。

ファイルのコンパイル時に別のテキスト エディタを使用したい場合は、次を使用します。

surfboard compile ride/wallet.ride

これにより、base64 でコンパイルされた一連の RIDE コードが出力されます。

「wallet.ride」のテストスクリプト

を見ようよ テストファイル。 JavaScript の Mocha フレームワークを利用しています。 「Before」関数と XNUMX つのテストがあります。

• 「前」は MassTransferTransaction 経由で複数のアカウントに資金を提供し、スクリプトをコンパイルしてブロックチェーンにデプロイします。
• 「デポジット可能」は、InvokeScriptTransaction をネットワークに送信し、XNUMX つのアカウントのそれぞれに対して Deposit() 関数をアクティブにします。
• 「入金された以上は引き出すことができない」は、誰も他人のトークンを盗むことができないことをテストします。
• 「入金可能」は、出金が正しく処理されていることを確認します。

Surfboard からテストを実行し、Waves Explorer で結果を分析する

テストを実行するには、次のコマンドを実行します。

surfboard test

複数のスクリプトがある場合 (たとえば、別の展開スクリプトが必要な場合)、次のコマンドを実行できます。

surfboard test my-scenario.js

Surfboard は、./test/ フォルダー内のテスト ファイルを収集し、surfboard.config.json で構成されているノード上でスクリプトを実行します。 数秒後、次のようなものが表示されます。

wallet test suite
Generating accounts with nonce: ce8d86ee
Account generated: foofoofoofoofoofoofoofoofoofoofoo#ce8d86ee - 3M763WgwDhmry95XzafZedf7WoBf5ixMwhX
Account generated: barbarbarbarbarbarbarbarbarbar#ce8d86ee - 3MAi9KhwnaAk5HSHmYPjLRdpCAnsSFpoY2v
Account generated: wallet#ce8d86ee - 3M5r6XYMZPUsRhxbwYf1ypaTB6MNs2Yo1Gb
Accounts successfully funded
Script has been set
   √ Can deposit (4385ms)
   √ Cannot withdraw more than was deposited
   √ Can withdraw (108ms)
3 passing (15s)

万歳！ テストは合格しました。 次に、Waves Explorer を使用するときに何が起こるかを見てみましょう。ブロックを確認するか、上記のアドレスの XNUMX つを検索に貼り付けます (たとえば、対応するアドレス wallet#。 そこでは、トランザクション履歴、dApp ステータス、逆コンパイルされたバイナリ ファイルを見つけることができます。

ウェーブエクスプローラー。 デプロイされたばかりのアプリケーション。

サーフボードのヒント:

1. テストネット環境でテストするには、以下を使用します。

surfboard test --env=testnet

テストトークンを取得する

2. トランザクションの JSON バージョンと、それらがノードによってどのように処理されるかを確認したい場合は、-v (「冗長」を意味します) を指定してテストを実行します。

surfboard test -v

Waves Keeper でアプリを使用する

1. Waves Keeper が動作するように設定します。 http://localhost:6869

ローカル ノードと連携するように Waves Keeper をセットアップする

2. ネットワークのトークンを含む秘密フレーズをインポートしますか? 簡単にするために、ノードの初期シードを使用します。 waves private node seed with waves tokens。 住所： 3M4qwDomRabJKLZxuXhwfqLApQkU592nWxF.

3. npm を使用して、サーバーレスのシングル ページ アプリケーションを自分で実行できます。 または、既存のものに移動します。 chrome-ext.wvservices.com/dapp-wallet.html

4. テスト実行で得たウォレット アドレス (上記の下線) を dApp アドレス テキスト ボックスに入力します。

5. 「入金」フィールドに少額を入力し、ボタンをクリックします。

Waves Keeper は、10 WAVES の支払いで InvokeScriptTransaction に署名する許可を要求します。

6. トランザクションを確認します。

トランザクションが作成され、ネットワークにブロードキャストされます。 これで彼女のIDが表示されます

7. Waves Explorer を使用してトランザクションを監視します。 検索フィールドにIDを入力してください

結論と追加情報

Waves プラットフォーム上でシンプルな dApps を開発、テスト、デプロイ、使用するためのツールを検討しました。

• RIDE言語
• VSコードエディタ
• ウェーブスエクスプローラー
• サーフボード
• ウェイブスキーパー

RIDE を学び続けたい人のためのリンク:

その他の例
サンプルを含むオンライン IDE
Waves のドキュメント
Telegram での開発者チャット
スタックオーバーフローの Waves と RIDE
新しい！ Waves プラットフォームでの dApp 作成に関するオンライン コース

引き続き RIDE トピックを掘り下げて、最初の dApp を作成してください。

TL; DR： bit.ly/2YCFnwY

出所： habr.com