アセットとトランザクションの作成

BBcTransactionオブジェクトの構成概要は，第4回の図1でも示しました。

1つのトランザクションにはeventリストおよびrelationリストが含まれ，それぞれのリストの中には0個以上のBBcEventオブジェクトまたはBBcRelationオブジェクトが格納されます。そしてBBcEvent・BBcRelationオブジェクトはBBcAssetオブジェクトを1つ含みます。つまり，BBcEventおよびBBcRelationオブジェクトの個数分だけBBcAssetオブジェクトを作成することになります。実際には，「⁠登録したいBBcAssetオブジェクトの数だけBBcEvent・BBcRelationオブジェクトという器を用意する」と説明したほうが正しいのですが，プログラミングはどのような順番でも可能です。ユーティリティとして先に器となるBBcEvent・BBcRelationオブジェクトなどを作成する関数が用意されています。

では，具体的に見ていきましょう。

store_transaction = bbclib.make_transaction(relation_num=1, witness=True)
user_info = "Owner is %s" % user_name
bbclib.add_relation_asset(store_transaction, relation_idx=0, asset_group_id=asset_group_id,
                          user_id=user_id, asset_body=user_info, asset_file=data)
store_transaction.witness.add_witness(user_id)

これは第11回でも説明した関数の一部です。最初のbbclib.make_transaction関数でBBcRelationオブジェクトを1つ含むBBcTransactionオブジェクトを生成します。

user_infoは，アセット本体の文字列情報で，⁠”Owner is 〇〇⁠”という文字列を設定します。

そしてBBcAssetオブジェクトの生成とBBcRelationオブジェクトへの格納をbbclib.add_relation_asset関数というユーティリティ関数で実施します。第1引数は対象となるBBcTransactionオブジェクトを，第2引数はrelationリストの何番目の要素か（relation_idx=0：0が1番目を表します）を指定します。asset_group_idはBBcRelationオブジェクトにセットされる情報で，格納するアセットがどんな種類のアセットであるかを識別するための情報です（32バイトのバイナリ列です⁠）⁠。そして，user_id以降がBBcAssetオブジェクトに格納される情報で，user_idが所有者の識別子，asset_bodyがアセット本体（ここでは，⁠”Owner is 〇〇⁠”という文字列⁠）⁠，asset_fileが外部ファイルとして分離管理するファイルコンテンツ（ファイルの中身）です。なお，BBcAssetオブジェクトにasset_fileをセットすると，自動的にasset_file_sizeの値をセットし，またSHA256ダイジェストを計算してそのダイジェスト値をasset_file_digestにセットしてくれます。外部ファイルが不要な場合は，asset_file=という部分を省略します。同じくasset_bodyが不要な場合もasset_body=という部分を省略します。

このように，ユーティリティ関数を使うと，アセットの登録はとても簡単です。ユーティリティ関数は，本来1つずつオブジェクトを作って格納していく作業をまとめて実施しているだけですので，中でどのような処理をしているかを知りたい方は，以下のファイルを参照ください。

• bbc1/core/libs/bbclib_utils.py
• tests/test_bbclib.py

アセットの参照

アセットの参照方法は，BBcAssetオブジェクトのasset_bodyにアクセスする，および手に入れたファイルのSHA256ダイジェストを自分で計算して，BBcAssetオブジェクト内のasset_file_digestおよびasset_file_sizeと比較するだけです。一致していたら，確かにそのファイルはアセットとして登録されたファイルと一致しているといえます。具体的に見ていきましょう。

def pick_valid_transaction_info(received_data=None, bbc_app_client=None):
    transaction, fmt_type = bbclib.deserialize(received_data[KeyType.transaction_data])
    asset_files = received_data[KeyType.all_asset_files]
    asset_id = transaction.relations[0].asset.asset_id
    if asset_id not in asset_files:
        print("**** No valid file is received...")
        print(received_data)
        bbc_app_client.sendback_denial_of_sign(received_data[KeyType.source_user_id],
                                               transaction.transaction_id,
                                               "No valid file is received.")
        sys.exit(1)

    file_to_obtain = asset_files[asset_id]
    file_digest = hashlib.sha256(file_to_obtain).digest()
    print("--------------------------")
    print("File digest written in the transaction data:  ",
          binascii.b2a_hex(transaction.relations[0].asset.asset_file_digest).decode())
    print("File digest calculated from the received file:", binascii.b2a_hex(file_digest).decode())
    print("--------------------------")

この関数は所有権移転の処理で受信側のユーザで実行される関数です。はじめに受け取ったデータ（received_data[KeyType.transaction_data]）をデシリアライズ（deserialize）してBBcTransactionオブジェクトの形に復元します（transactionです⁠）⁠。またファイル本体も受け取っているので，asset_filesというdictionary型のオブジェクトに保存します。ここでは，{ファイル名: ファイルデータ}という形式で，ファイル名はasset_idを16進文字列で表記したものです。

その後，受け取ったファイル（file_to_obtain）のダイジェストを計算して，file_digestに代入しています。本来は比較すべきなのですが，比較処理の代わりに単に両方のダイジェスト値を表示するだけです（261～265行目⁠）⁠。transaction.relations[0].asset.asset_file_digestのようにすれば，BBcAssetオブジェクトのasset_file_digestを取得できます（263行目⁠）⁠。同じようにtransaction.relations[0].asset.asset_bodyと書き加えれば，asset_bodyも取得できます。なお，transaction.relations[0]という部分が，トランザクションのrelationリストの1番目のBBcRelationオブジェクトを表し，さらにtransaction.relations[0].assetでBBcAssetオブジェクトを指しています。

まとめ

今回は，アセットの記述方法についてfile_proof.pyに沿ってBBc-1プログラミングの概要を説明しました。アセットには文字列，バイナリデータおよび外部に分離したファイルのSHA256ダイジェストを設定することができますので，アプリケーションに応じて自由なアセットを定義することができます。

今回でプログラミングに関する解説は終わりです。次回は，BBc-1の今後の技術的な展望を紹介する予定です。