概要
- ハーベスト報酬の内ノード報酬をハーベスターに還元するノード運営者向けツールを開発してOSSとして公開しました
- 本記事では、実際のツールの導入・設定・実行について解説します。
- Symbol投げ銭プラットホームのQUESTも実施しました。
ノード宣伝
- 「symbol-node.takagi-tech.com」
- 本ツールを利用してノード報酬の 75% をハーベストした方へ還元します
- 残り 25% はSymbol関連の開発や技術記事の執筆活動に充てます
- 還元による高効率なハーベストをしたい方、自分の活動を応援してくださる方のハーベスト委任お待ちしております
このツールでできること
自分のノード委任者に対して、「ノード報酬の〇〇%を還元します」や「ハーベスト時にボーナスで〇〇XYMをプレゼントします」といったハーベスターへの還元作業を自動で行えます。
具体的な機能としては、下記の通りです。
- 指定範囲のブロック高でハーベストしたアドレスへの送金
- 送金額に関して、ノード報酬に対する割合、または絶対値を任意に設定可能
- 送金あたりの限度額が設定でき、その金額以上の送金をプログラムが行おうとした場合、送金作業を停止
- 実際には送金しないが、どのアドレスにいくら送金するか事前に確認できるドライラン機能
事前準備
実行環境の準備
Python3.7以降でsymbol SDKをインストールします。
pip install symbol-sdk-core-python
ツールのダウンロード
githubリポジトリからダウンロードします。
gitを使い慣れている方はcloneして使ってください。
gitが使えない方は、下記の画像の赤枠「Code -> Download ZIP」からzipでダウンロードして任意の場所で解凍してください。
ツールの実行
設定方法
まずは config.ini.example ファイルをコピーして config.ini という名前に変更します。
次に、ご自身のノード情報や還元ルールに沿ってファイルの設定値を変更してください。
各項目の詳細はこのようになっています。
| 設定変数 | 概要 | 入力値 |
|---|---|---|
| dryrun | 実際には送金処理を行わない確認モード Falseで実際に送金まで行います |
True or False |
| private_key | ノード報酬の受け取りウォレットの秘密鍵 このウォレットで受け取った報酬が発生したハーベストが対象になります |
英数文字列 |
| limit_xym_amount | 1送金あたりの最大XYM数量 これ以上の送金を検知した場合、処理を停止します 右の例「50.0」の場合、50XYM以上の送金が1件以上あれば送金を中止します |
例) 50.0 |
| from_block_height | 還元対象のブロック高の最低値 (このブロック数以上のハーベストが対象) |
例) 40000 |
| to_block_height | 還元対象のブロック高の最大値。0の場合は最新ブロック高 (このブロック数以下のハーベストが対象) |
例) 50000 |
| autoupdate_from_block_height |
from_block_heightの自動更新 （前回実行時の最終ハーベストブロック高+1に更新） |
True or False |
| fixed_kickback | 固定の還元XYM数量 (0より大きい値の場合、次項のkickback_rateは無視されます) |
例) 0 例) 30.0 |
| kickback_rate | ノード報酬の還元レート(fixed_kickbackが0以下の場合のみ有効) （75%還元の場合、0.75） |
例) 0.75 |
| max_txfee | 還元トランザクションの最大手数料XYM数量 | 例) 1.0 |
| message | 還元トランザクションに添えるメッセージ (#BLOCK# というワードがハーベストブロック高に置換されます) |
例) node fee kickback [block:#BLOCK#] |
| node | ハーベスト還元対象のノード （このノードに委任しているハーベスターのハーベストが還元対象になります） |
例) http://xxx.yyy.zzz:3000 |
| receipt_type_enum | ハーベストのシステム定数 （メインネットの場合は 0x2143 から変更不要） |
0x2143 |
| birth_time | Symbol誕生のUTC秒 (メインネットの場合は1615853185から変更不要) |
1615853185 |
| exp_time | トランザクションの有効期限 (単位はhour。右の例だと2時間) |
例) 2 |
| mosaic_id | XYMのモザイクID (メインネットの場合は0x6BED913FA20223F8から変更不要) |
0x6BED913FA20223F8 |
設定例
「自身のノードでハーベストした人にノード報酬の50%を還元する」という場合は下記のような設定になります。
dryrun = False
private_key = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
limit_xym_amount = 30
from_block_height = 470000
to_block_height = 0
autoupdate_from_block_height = True
fixed_kickback = 0
kickback_rate = 0.5
max_txfee = 5
message = !!!開発テスト!!! node fee kickback [#BLOCK#]
node = http://symbol-node.takagi-tech.com:3000
receipt_type_enum = 0x2143
birth_time = 1615853185
exp_time = 2
mosaic_id = 0x6BED913FA20223F8
また、 autoupdate_from_block_height = True とすることで、実行完了時に from_block_height に還元が完了したブロック高+1が設定されるので、1日1回定期的に自動実行するだけで重複なく毎日のハーベストに対して還元送金ができます。
実行例
python nodefee-kickback.py
前項の設定例を確認モード dryrun = True で実行した際の出力はこのようになります。
> python nodefee-kickback.py
2021-09-05 01:41:31,300 INFO My public key: 10943DCA976F8C17433F759400B9AF0257D1B36E7D69859B31250039E771004D
2021-09-05 01:41:31,300 INFO My wallet address: NDJIK24FC643NUR3TMJ5LXALE3ZHDEUNX2VLE4Y
2021-09-05 01:41:35,512 INFO Harvesters address: 8
2021-09-05 01:41:39,835 INFO Harvest history from height: 470000
2021-09-05 01:41:39,835 INFO Harvest history to height: 0
2021-09-05 01:41:39,836 INFO ### block height, harvest address, node fee amount ###
2021-09-05 01:41:39,838 INFO ['490580', 'NCVQALLK55BPRMYEE4RTOFKDRTZEAQY63OW2FJA', '43.971249']
2021-09-05 01:41:39,838 INFO ['484878', 'NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', '43.971249']
2021-09-05 01:41:39,839 INFO ['481815', 'NDO4JAQV63NWMJRVYAPVT3ZM3EYCI7M5LV6YL5A', '43.972679']
2021-09-05 01:41:39,840 INFO ['472798', 'NC6KUFYNSAJPGHSEKDU4F3DFP2IBWCOAID76NEQ', '44.221161']
2021-09-05 01:41:39,841 INFO ['471447', 'NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', '43.971249']
2021-09-05 01:41:39,841 INFO Kickback transactions
2021-09-05 01:41:39,844 INFO ### target address, XYM amount, message ###
2021-09-05 01:41:39,844 INFO ['NCVQALLK55BPRMYEE4RTOFKDRTZEAQY63OW2FJA', 21.985624, '!!!開発テスト!!! node fee kickback [490580]']
2021-09-05 01:41:39,845 INFO ['NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', 21.985624, '!!!開発テスト!!! node fee kickback [484878]']
2021-09-05 01:41:39,846 INFO ['NDO4JAQV63NWMJRVYAPVT3ZM3EYCI7M5LV6YL5A', 21.986339, '!!!開発テスト!!! node fee kickback [481815]']
2021-09-05 01:41:39,846 INFO ['NC6KUFYNSAJPGHSEKDU4F3DFP2IBWCOAID76NEQ', 22.11058, '!!!開発テスト!!! node fee kickback [472798]']
2021-09-05 01:41:39,847 INFO ['NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', 21.985624, '!!!開発テスト!!! node fee kickback [471447]']
2021-09-05 01:41:39,849 INFO Total transfer XYM amount: 110.053791 + 5.0(Max fee)
2021-09-05 01:41:39,849 INFO ドライランのため送金を行わずに処理を終了します (config.ini -> dryrun)
ブロック高470000以降の5回のハーベスト（このハーベストで得られたノード報酬は43.971249～44.221161XYM）に対して、それぞれのハーベスターに対してノード報酬の50%（21.985624～22.11058XYM）を送金するリストの確認ができました。
この実行では 110.053791 + 5.0(Max fee) で最大115XYMを送金します。
確認して問題なければ、 dryrun = False にして、実際に送金処理を行います。
（次はテストのため、0.001XYMの固定還元（ fixed_kickback = 0.001 ）にて送金しています）
> python nodefee-kickback.py
2021-09-05 01:51:30,396 INFO My public key: 10943DCA976F8C17433F759400B9AF0257D1B36E7D69859B31250039E771004D
2021-09-05 01:51:30,397 INFO My wallet address: NDJIK24FC643NUR3TMJ5LXALE3ZHDEUNX2VLE4Y
2021-09-05 01:51:34,614 INFO Harvesters address: 8
2021-09-05 01:51:39,004 INFO Harvest history from height: 470000
2021-09-05 01:51:39,005 INFO Harvest history to height: 0
2021-09-05 01:51:39,006 INFO ### block height, harvest address, node fee amount ###
2021-09-05 01:51:39,007 INFO ['490580', 'NCVQALLK55BPRMYEE4RTOFKDRTZEAQY63OW2FJA', '43.971249']
2021-09-05 01:51:39,007 INFO ['484878', 'NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', '43.971249']
2021-09-05 01:51:39,008 INFO ['481815', 'NDO4JAQV63NWMJRVYAPVT3ZM3EYCI7M5LV6YL5A', '43.972679']
2021-09-05 01:51:39,009 INFO ['472798', 'NC6KUFYNSAJPGHSEKDU4F3DFP2IBWCOAID76NEQ', '44.221161']
2021-09-05 01:51:39,011 INFO ['471447', 'NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', '43.971249']
2021-09-05 01:51:39,012 INFO Kickback transactions
2021-09-05 01:51:39,012 INFO ### target address, XYM amount, message ###
2021-09-05 01:51:39,013 INFO ['NCVQALLK55BPRMYEE4RTOFKDRTZEAQY63OW2FJA', 0.001, '!!!開発テスト!!! node fee kickback [490580]']
2021-09-05 01:51:39,014 INFO ['NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', 0.001, '!!!開発テスト!!! node fee kickback [484878]']
2021-09-05 01:51:39,014 INFO ['NDO4JAQV63NWMJRVYAPVT3ZM3EYCI7M5LV6YL5A', 0.001, '!!!開発テスト!!! node fee kickback [481815]']
2021-09-05 01:51:39,015 INFO ['NC6KUFYNSAJPGHSEKDU4F3DFP2IBWCOAID76NEQ', 0.001, '!!!開発テスト!!! node fee kickback [472798]']
2021-09-05 01:51:39,015 INFO ['NBWMZU7G7FUYOHVYEWOTKDYUX7KM6FNRBFFJU2Q', 0.001, '!!!開発テスト!!! node fee kickback [471447]']
2021-09-05 01:51:39,016 INFO Total transfer XYM amount: 0.005 + 0.02(Max fee)
2021-09-05 01:51:39,017 INFO Transaction hash: A92BE029BA9A0D5AAB87A4F6F7EB2F85DF007FAA5F0A7144CE7E9249382BA878
2021-09-05 01:51:39,034 INFO Published : http://explorer.symbolblockchain.io/transactions/A92BE029BA9A0D5AAB87A4F6F7EB2F85DF007FAA5F0A7144CE7E9249382BA878
2021-09-05 01:51:39,034 INFO from_block_height update to 490581
2021-09-05 01:51:39,035 INFO Node fee kickback is completed
トランザクションハッシュと確認のURLが出力されています。
5件のトランザクションを含むアグリゲートトランザクションとなっており、ウォレットからも還元が確認できます。
from_block_height update to 490581 という出力の通り、 config.ini の from_block_height 項目が更新されており、そのまま再度実行しても、新しいハーベストが発生していないので下記の通りエラーで終了になります。
> python nodefee-kickback.py
2021-09-05 01:59:42,190 INFO My public key: 10943DCA976F8C17433F759400B9AF0257D1B36E7D69859B31250039E771004D
2021-09-05 01:59:42,190 INFO My wallet address: NDJIK24FC643NUR3TMJ5LXALE3ZHDEUNX2VLE4Y
2021-09-05 01:59:46,413 INFO Harvesters address: 8
2021-09-05 01:59:50,640 INFO Harvest history from height: 490581
2021-09-05 01:59:50,640 INFO Harvest history to height: 0
2021-09-05 01:59:50,641 INFO ### block height, harvest address, node fee amount ###
2021-09-05 01:59:50,642 INFO Kickback transactions
2021-09-05 01:59:50,643 INFO ### target address, XYM amount, message ###
2021-09-05 01:59:50,644 INFO Total transfer XYM amount: 0.0 + 0.02(Max fee)
2021-09-05 01:59:50,644 INFO There is no transfer
Traceback (most recent call last):
File "nodefee-kickback.py", line 103, in <module>
main()
File "nodefee-kickback.py", line 81, in main
raise Exception("送金対象がありません、送金処理を終了します")
Exception: 送金対象がありません、送金処理を終了します
定期的にプログラムを実行することで、ハーベストが発生したときに正しく還元処理が動きます。
自動実行について
Linux系であれば cron など、Windowsであれば Windowsタスクスケジューラ に登録するなどすれば、還元処理を完全自動化できます。
具体的な設定方法についてはここでは割愛いたします。
実行ログについて
プログラム実行時に出力されている情報はそのまま logs ディレクトリに実行日時のファイルとして出力されています。
本ツールのライセンスについて
MIT LicenseでOSSとして公開しています。
MIT Licenseはざっくりと言うと
- 改変・再配布・商用利用・有料販売どんなことにでも自由に無料で使えます
- ただし、「著作権表示」と「MITライセンスの全文」を記載する必要があります
- MITライセンスの全文が記載されているウェブページのURLでもOK
- 本プログラムの場合、githubのライセンスファイルのURLでOK
- なんの保証もありません、万一損害が発生しても作者は責任を負いません
というところです。
ライセンスを守って利用いただければ何も問題ないですが、TwitterやQiitaで一報いただけたらとても嬉しいです。
さいごに
使いたいけどイマイチ導入の仕方が分からないというノード運営者の方、サポートしますのでお気軽にTwitterにてご連絡ください。
また、こんな機能を追加してほしいというアイデアや、バグを見つけた方はコメントやTwitterにてにてご連絡ください。
自分の活動で少しでもSymbolコミュニティがより活性化しますように。