この記事は、こちらのチュートリアルをもとに進めていきます。

０　はじめに

今回は、thirdwebの「Engine」を作ってみます。

これにより、バックエンドウォレットを作れたり、コントラクトの実行ができるようになります。

１　Dockerの立ち上げ

１　PostgreSQL

まずは、DockerでPostgreSQLを起動します。

これは、「リレーショナルデータベース管理システム」です。
（ここでは説明は省きます。）

docker run -p 5432:5432 -e POSTGRES_PASSWORD=postgres -d postgres

ポートの設定と環境変数を設定しており、バックグラウンドで起動しています。

DockerHubはこちらをご確認ください。

ご不明の場合は、使い方なども書かれています。

念の為、「docker ps」でDockerが動作していることを確認します。

２　thirdweb/engine

次に、「thirdweb/engine」を起動します。

環境変数やポートなどを設定しています。

docker run \
  -e ENCRYPTION_PASSWORD="<encryption_password>" \
  -e THIRDWEB_API_SECRET_KEY="<thirdweb_secret_key>" \
  -e ADMIN_WALLET_ADDRESS="<admin_wallet_address>" \
  -e POSTGRES_CONNECTION_URL="<postgres_connection_url>" \
  -e ENABLE_HTTPS=true \
  -p 3005:3005 \
  --pull=always \
  --cpus="0.5" \
  thirdweb/engine:latest

なお、<postgres_connection_url>はこちらになります。

postgresql://postgres:postgres@host.docker.internal:5432/postgres?sslmode=disable

<thirdweb_secret_key>はAPIキーを取得する際に出てくるシークレットキーを使います。

やり方がご不明の場合は、こちらをご参照ください。

また、<admin_wallet_address>には、管理者に設定したいウォレットアドレスを設定します。

今回は、「ENABLE_HTTPS」を「true」にしています。

これはセルフサイニング証明書を許可する設定です。

そのため、本番環境では、この行は抜いてください。

なお、「thirdweb/engine」のDockerはこちらにあります。

実行を行い、このようになれば成功です。

２　Engineへのアクセス

では、立ち上がったサーバーにアクセスします。

https://localhost:3005/json

すると、このようにプライバシーが保護されていない旨が表示されます。

「詳細設定」に進みます。

次に、「localhostにアクセスする（安全ではありません）」を選択します。

（自分が今立ち上げたということを確認した上で進んでください。）

すると、このように表示されました。

このステップはブラウザがthirdweb エンジンにアクセスするために必要な工程になります。

続きまして、thirdwebのエンジンのページに行き、ウォレット接続をします。

「Set Engine instance URL to get started」を選択します。

ここで、起動しているインスタンスを設定します。

https://localhost:3005

すると、このように反映されました。

３　処理の実行

１　アクセストークンの発行

まずは、アクセストークンを発行します。

「Permissions」から「Create Access Token」を選択

すると、このようにアクセストークンが発行されました。

こちらは一度しか表示されないので、コピーして任意の場所に保管してから、「Done」

２　バックエンドウォレットの作成

次に、バックエンドウォレットを作成します。

エンジンはこのウォレットを通じて、ブロックチェーンとやりとりを行います。

「Overview」から「Create」を選択

「Create」で作成

これでできました。

なお、ガス代が必要なため、メタマスクなどからこちらのウォレットにガス代分を送付しました。

３　エクスプローラからの処理の実行

では「Explorer」から処理を行ってみましょう。

「Backend Wallet」の下の「get-balance」を開き、「Try it out」

チェーンとバックエンドウォレットのアドレスを入力し、「Execute」を実行

すると、下のように先ほどガス代として入れた残高が表示されました。

４　コマンドラインによる処理の実行

では、コマンドラインで操作を行ってみましょう。

１　git clone

こちらのGithubをクローンします。

また、こちらに書かせていただいたように、あくまでもローカルでのテスト用にご利用ください。

では、git cloneを行います。

git clone https://github.com/ytakahashi2020/thirdweb_engine_for_test.git

２　依存関係のインストール

依存関係をインストールします。

cd thirdweb_engine_for_test
yarn install

３　getBalanceの実行

先ほど取得したアクセストークンをこちらに貼り付けます。

また、アドレスの部分も変更します。

では、実行してみましょう。

node getBalance.js

すると、このように残高が取得できました。

では、コードを読んでみましょう。

まずは、「fetch」と「https」をインポートしています。

参考までに、「node-fetch」の公式はこちらです。

続いて、「rejectUnauthorized:false」のAgentを作成し、設定します。

今回は、ローカルのテストでやっているため、「SSL/TLS証明書」の検証をバイパスするために行っています。

ちなみにAgentについてはこの辺りをご確認ください。

実際の内容としては、「http.Agent」の方に書かれていました。

ちなみに、「https.request」を確認すると、オプションとして、「rejectUnauthorized」を受け取れることも確認できます。

では、「fetch」の部分も見てみましょう。

下のように、エンジンURLを設定し、やりたい操作を入力しています。

そして、ここにアクセストークンを設定します。

これにより、権限があることが確認できます。

４　コントラクトの読み取り

次は、コントラクトの値の読み取りを行ってみましょう。

例えば、事前にERC20のコントラクトを用意しました。

アクセストークンを入れた上で、次のコマンドを実行しました。

node readContract.js

すると、このようにコントラクトのバランスを取得することができました。

このように、コントラクトアドレスや実行したい関数名、引数を設定していることがわかります。

このように表記されています。

５　コントラクトの書き込み

では、書き込みも同様に行ってみました。

下の例では、トークンのバーンを実行しています。

公式はこちらになります。

なお、こちらの「function_name」も「functionName」にすることでうまく行きます。

JSON.stringify()などについてご不明の場合はこちらをご参照ください。

少し待つと、このように実行されていることがわかります。

今回は以上です。