今回は、トークン配布のためのバッチ機能を実装してみました。
アドレスと送信するトークン数が記載された一覧を用意し、バッチ処理のなかで一覧を参照し連続的にトークンを送信するというものです。

動作確認環境

今回も、Genesys netwrok testnetを使用します。
Genesys netwrok testnetの環境はこちら。参考として執筆時点の情報を記載します。

区分	内容	補足事項
Fauset URL	https://faucet.genesys.network/	テスト用のトークンはこちらから入手できます
RPC URL	https://testnet-rpc.genesys.network/	リクエストのエンドポイントです
API URL	https://testnet-gchainexplorer.genesys.network/api	APIのエンドポイントです
Block Explorer	https://testnet-gchainexplorer.genesys.network	ブロック状態が確認できます
Network ID	0xa5c8(42440)
Decimals	18

用意するもの

配布に使用するトークンSolidityソースコード（デプロイ時にトークンを発行します）
バッチ処理をするSolidityソースコード
スマートコントラクトにバッチ処理をリクエストするJavaScriptソースコード

ソースコード

今回実装してみたソースコードはこちらに置いていますので、参照くださいませ。

セットアップと実行手順

1. トークンコントラクトのデプロイ

配布用のトークンコントラクトをデプロイします。

$ cd contracts/tokenContact
$ cp .env.example .env

.env ファイル内の各ディレクティブの値を変更します。

PARAM_ENDPOINT=<<RPC URLを設定してください。>>
PARAM_ENDPOINT_CHAINID=<<エンドポイントチェーンIDを設定してください。>>
PARAM_DEPLOY_PRIVATE_KEY=<<デプロイするアカウントの秘密キーを入力してください。>>

デプロイ先のチェーンのトークンを取得するには、特にテストネットにデプロイする場合に、Faucet からトークンを取得できます。

$ npm install
$ npm run deploy
Token code Address: 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

実行後、Token code Addressをメモします。

2. バッチコントラクトのデプロイ

バッチ処理を行うコントラクトをデプロイします。

$ cd contracts/batchContact
$ cp .env.example .env

.env ファイル内の各ディレクティブの値を変更します。

PARAM_ENDPOINT=<<RPC URLを設定してください。>>
PARAM_ENDPOINT_CHAINID=<<エンドポイントチェーンIDを設定してください。>>
PARAM_DEPLOY_PRIVATE_KEY=<<デプロイするアカウントの秘密キーを入力してください。>>
PARAM_DEPLOY_TOKEN_ADDRESS=<<トークンコントラクトのアドレスを入力してください。>>

次にコマンドを実行します。

$ npm install
$ npm run deploy
Batch code Address: 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

実行後、Batch code Addressをメモします。

3. トークン転送設定

cd <Navigate to the root directory of the cloned folder>
cp .env.example .env

.env ファイル内の各ディレクティブの値を変更します。

PRIVATE_KEY=<<ウォレットアカウント用の秘密キーを指定してください。>>
CONTRACT=<<バッチコードコントラクトのデプロイアドレスを指定してください。>>
RPC_NODE=<HTTPS://*****形式でRPCノードのURLを指定してください。>
BATCH_SIZE=<<1回のリクエストで送信するアドレス数を指定します。>>
GAS_PRICE=<<ガス価格の数を指定してください。>>
GAS=<<ガスの数を指定してください。>>

一括転送の実行方法

addressList.csvにアドレスと送金額をリストします。

$ vi src/addressList.csv

addressList.csv の内容は次のとおりです。

0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,2
0xYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY,3
0xZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ,5

addressList.csv を保存し、編集を終了します。

一括配信する合計トークン数をBatch code Addressに転送したら、実行してみましょう。

$ node src/token-transfer.js
From Token forwarding 0xXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Estimated Gas: 174184
Current Gas Price: 5000000000
Token forwarding started
------------------------
Allocation + transfer was successful. 174184 gas used. Spent: 870920000000000 wei
Token forwarding done.

「Token forwarding done.」と表示されたら転送は完了です。BlockExplorer で受信者のアドレスを確認できます。

さいごに

みんなでトークンを所持させたい場合などに利用できるかと思います。
参考までに見ていただければ幸いです。