可分性を考慮したSymbolプログラミング


ここでは、可分性について説明します。

可分性とは何か

可分性(divisibility)とは小数点以下の桁数のことです。
XYMの場合、可分性は6です。つまり、小数点以下は6けたです。つまり、小数点以下の0の数は6つあることになりますので、
1,000,000μXYM(マイクロXYM) = 1XYM
ということになります。
もし、可分性が3の場合、
1,000 mMosaic(ミリモザイク) = 1 Mosaic

になります。

ここで、可分性に関する部分に注目して、以下のコードを見ていきます。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="UTF-8">
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/uikit.min.css" />
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/uikit.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/uikit-icons.min.js"></script>
    <script src="symbol-sdk-0.21.0.js"></script>
    <title>Symbol mosaicの可分性を確認する</title>
  </head>
  <body style="margin:30px;">
    <h1>Symbolを触ってみる</h1>
    
    <h2>可分性(モザイクが小数点以下何桁で表現されるか)</h2>
    <div style="margin-top:10px;">Mosaic ID:<input type="text" id="mosaic_id" class="uk-input"></div>
    <div style="margin-top:10px;">可分性:<span id="divisibility">0</span>桁</div>
    <div id="issue_tx" class="uk-button uk-button-primary" style="margin-top:10px;">可分性確認</div>

    <script>
      const symbol=require("/node_modules/symbol-sdk");
      const nodeAddress='http://api-01.ap-northeast-1.0.10.0.x.symboldev.network:3000';
      const mosaicHttp = new symbol.MosaicHttp(nodeAddress);

      $('#issue_tx').click(function(){
        mosaicHttp.getMosaic(new symbol.MosaicId($('#mosaic_id').val()))
        .subscribe(mosaicInfo=>$('#divisibility').text(mosaicInfo.divisibility),err=>console.error(err));
      });
    </script>
  </body>
</html>

まず、以下のコードを見ます。

const mosaicHttp = new symbol.MosaicHttp(nodeAddress);

MosaicHttpというオブジェクトを定数mosaicHttpに代入します。
この定数を用いて以下のコードを考えます。

mosaicHttp.getMosaic(new symbol.MosaicId($('#mosaic_id').val()))
.subscribe(mosaicInfo=>$('#divisibility').text(mosaicInfo.divisibility),err=>console.error(err));

mosaicHttpの中にあるgetMosaic(new symbol.MosaicId($('#mosaic_id').val()))に入力したモザイクIDを入れます。

すると、mosaicInfoというやつに、mosaicHttp.getMosaic(new symbol.MosaicId($('#mosaic_id').val()))を実行した結果が非同期処理(subscribe)として返ってきて、そして、

mosaicInfoの中のdivisibilityをIDがdivisibilityと名付けた以下の要素内のテキストに書き込みなさいという事になります。

   <div style="margin-top:10px;">可分性:<span id="divisibility">0</span>桁</div>

そうなると、ボタンをクリックして実行すると、0という数字が変わります。

こうして、調べたいモザイクの可分性がわかります。

なぜ可分性を考えるのか

XYMの場合は可分性は6と決められているので、それに合わせてコードを組めばいいのですが、実際のモザイクは可分性が必ずしも6とは限りません。そこで可分性を考慮した柔軟なプログラムを組む必要があり、以上のコードはその時に役に立ちます。

 

※この記事は、nemlogで企画されたイベントであるしゅうさんの勉強会「しゅうさんといっしょ!」の内容の一部をまとめたものです。