技術的な質問
- ネットワーク手数料について
- トランザクション発行時に基軸通貨は必要ですか？
- トランザクション手数料無料の場合のトランザクション発行方法を教えてください
- トランザクション発行のサンプルコードはありますか？
- 使用できるSDKについて教えてください。
- 使用できるCLIツールについて教えてください。
- まず初めに、最初に何をするといいですか？
- エンドポイントについて
- 接続許可IPアドレスについて
- 接続許可IPアドレスを設定してもすぐに反映されません。
- GenerationHashSeedを教えてください。
- mijin BOD ブロックチェーンエクスプローラーについて教えてください。
- mijin BOD で使用する mijin Catapult (v.2) のバージョンを教えてください。
- mijin BOD で使用する mijin Catapult (v.2) のrestバージョンを教えてください。
- mijinでエラーが拾えないことがあります。どうすればいいでしょうか？
- mijin BOD ERROR Codes
ネットワーク手数料について
手数料とは、以下の項目で発行するトランザクションによって手数料が発生し、基軸通貨(cat.currency)にて支払う必要があります。
-
トランザクション手数料
-
Mosaicレンタル手数料
-
Namespaceレンタル手数料
-
ロック保証金
mijin BOD / AWSマーケットプレイスで提供する mijin では手数料モードは標準で 手数料なし に設定されています。
手数料なしモードでは、アカウントに基軸通貨の残高を持つ必要がありませんので特に意識することはありませんが、sdkなどで手数料設定を都度 0 を設定する必要があります。
本サンプルではcatapult/javascript/config/local.json
private1.minfeemultiplierを0にすることにより
手数料設定を0にしています。
{
"private1": {
"url": "https://xxxxxxxx.mijin.io",
"minfeemultiplier": 0, //手数料なし 0 設定
本サンプル集を手数料ありのmijinで利用する場合は、private1.minfeemultiplierの値を 0 -> 100 に設定してください。
本サンプル集の記述は注記がない限り、手数料なしモード時 のサンプルとなります。
トランザクション発行時に基軸通貨は必要ですか？
mijin BODプランで使用している mijin ブロックチェーンは
- トランザクション手数料無料
の設定にしています。 トランザクション発行時に、基軸通貨を保持している必要はありません。
トランザクション手数料無料の場合のトランザクション発行方法を教えてください。
本サンプルはトランザクション手数料無料でのサンプルコードとなっています。
トランザクション発行のサンプルコードはありますか？
本サンプルを参照ください。
使用できるSDKについて教えてください。
以下のSDKを提供しています。
Typescript/Javasript
install
npm i @tech-bureau/symbol-sdk
(yarn add @tech-bureau/symbol-sdk)
Python
install
pip install techbureau-symbol-sdk-python
使用できるCLIツールについて教えてください。
以下のCLIツールを提供しています。
@tech-bureau/mijin-catapult-tools
install
npm i @tech-bureau/mijin-catapult-tools
(yarn add @tech-bureau/mijin-catapult-tools)
まず初めに、最初に何をするといいですか？
本サンプルにてインストールからアドレス発行までをお試しください。
エンドポイントについて
mijin BOD ブロックチェーンへアクセスするURLになります。
mijin BOD サイト ダッシュボード 契約情報 -> mijin エンドポイント
にて確認ができます。
接続許可IPアドレスについて
mijin BODへアクセスするIPアドレスを設定します。最大6IPアドレスとなります。
mijin BOD サイト 契約情報 > 接続許可IPアドレス
にて設定ができます。
IP v4 の形式にのみ対応しています。
IP v6 の形式には対応していません。
接続許可IPアドレスを設定してもすぐに反映されません。
接続許可IPアドレスが問題ないかをチェックを行ってから接続許可を行うため、
許可されるまで数分程度時間がかかることがあります。
削除においても同様です。
GenerationHashSeedを教えてください。
お客様が契約時に割り当てられたエンドポイント毎に違います。
https://<エンドポイントURL>/node/info
networkGenerationHashSeed の値で確認することができます。
mijin BOD ブロックチェーンエクスプローラーについて教えてください。
mijin BODのトランザクションやアドレスが確認できるブロックチェーンエクスプローラーです。
mijin BOD サイト 契約情報 > 契約中のサービス > mijin Blockchain エクスプローラー
にてURLが確認できます。
接続許可IPアドレスからのアクセスのみ、許可しています。
mijin BOD で使用する mijin Catapult (v.2) のバージョンを教えてください。
catapult: 1.0.3.6
mijin BOD で使用する mijin Catapult (v.2) のrestバージョンを教えてください。
rest: mijin-2.4.3
https://<エンドポイントURL>/node/server
でも確認することができます。
mijinでエラーが拾えないことがあります。どうすればいいでしょうか？
mijin BODはアプリケーションロードバランサ(L7)を使用しているため、スティッキーセッションを有効にしています。
sdkを使う場合、トランザクション発行したノードと同じCookieを使用することでエラー取得が可能です。
本サンプルではトランザクション発行したノードと同じCookieを使用しています。
ERROR: Access Denied or Unauthorized
Q.指定されたエンドポイントにアクセスしたが[Access Denied or Unauthorized]エラーが出てしまい、アクセスできません。
{ "nodename": "mijin1", "code": "Forbidden", "message": "Access Denied or Unauthorized" }
A.mijin BODへアクセスするIPアドレスを設定する必要があります。
mijin BODサイト 契約情報 > 接続許可IPアドレス
から、mijin BODエンドポイントへアクセスするIPアドレスを設定してください。
ERROR: Rate Limited
Q.指定されたエンドポイントにアクセスしたが[Rate Limited]エラーが出てしまい、アクセスできません。
{ "nodename": "mijin1", "code": "Restict", "message": "Rate Limited" }
A.アクセス数制限を設けています。
トランザクション発行 100tx/5分
APIアクセス 10,000/5分
30秒毎に集計し、総アクセス数が閾値を下回った段階で制限が解除されます。
ERROR: DENY
Q.指定されたエンドポイントにアクセスしたが[DENY]エラーが出てしまい、アクセスできません。
{ "code": "Forbidden", "message": "DENY" }
A.基本プランの契約がされていません
クレジットカード情報を登録し、基本プランの契約を行ってください。
ERROR: LIMIT
Q.指定されたエンドポイントにアクセスしたが[LIMIT]エラーが出てしまい、アクセスできません。
{ "code": "Forbidden", "message": "LIMIT" }
A.使用できるtxサイズ残高不足です。
追加オプションの購入が必要です。
ERROR: PENDING
Q.指定されたエンドポイントにアクセスしたが[PENDING]エラーが出てしまい、アクセスできません。
{ "code": "Forbidden", "message": "PENDING" }
A.基本プランがサブスクリプション解約されています。
BODサイトログイン後、再登録画面が表示されます。
クレジットカード情報を登録し、再度基本プランの契約を行ってください。
ERROR: Gateway-Error
Q.指定されたエンドポイントにアクセスしたが[Gateway-Error]エラーが出てしまい、アクセスできません。
{ "code": "Forbidden", "message": "Gateway-Error" }
A.mijinやDB障害があった場合の内部エラーです。
障害メンテナンス情報にて状況を通知します。