トークン・タクソノミ・フレームワークの入力仕様ファイル

ブロックチェーン・アプリケーション・ビルダー初期化コマンドは、入力仕様ファイルを読み取り、チェーンコード開発プロセスを支援する複数のツールを使用してスキャフォールディング済プロジェクトを生成します。

同じ仕様ファイルのトークン・タクソノミ・フレームワークに基づく標準アセットおよびトークン・アセットを定義できます。同じ仕様ファイルの複数の標準に基づいてトークン・アセットを定義することはできません。

仕様ファイルに標準アセットを含める方法の詳細は、「入力仕様ファイル」を参照してください。

ブロックチェーン・アプリケーション・ビルダー・パッケージでは、実行可能トークン・アセットのサンプル仕様ファイルを使用できます。

• FiatMoneyToken.yml
• LoyaltyToken-Go.yml

標準プロパティおよびセクションに加え、可変トークン・アセットは、仕様ファイルのbehaviorおよびanatomyセクションをサポートします。Fungibleトークン・アセットは、standardプロパティもサポートしています。次の例は、トークン・タクソノミ・フレームワークに基づく、実行可能なトークン・アセットの仕様ファイルの構造を示しています。

assets:
    - name: OBPTOK # Asset name
      type: token  # Asset type

      anatomy: 
          type: fungible # Token type
          unit: fractional # Token unit

      behavior: # Token behaviors
          - divisible: 
                decimal: 2  
          - mintable: 
                max_mint_quantity: 1000 
          - transferable
          - burnable 
          - roles: 
                minter_role_name: minter 

      properties:
          - name: currency_name # Custom attribute to represent the token in certain currency. This attribute is helpful for exchanging the tokens with fiat currency.
            type: string

          - name: token_to_currency_ratio # Custom attribute to specify the token to currency ratio. This attribute is helpful for exchanging the tokens with fiat currency.
            type: number

表7-5 Fungibleトークン仕様ファイルのパラメータの説明と例

開始時	説明	例
type:	assetsセクションでtype: tokenを指定する必要があります。	assets: - name: OBPTOK # Asset name type: token # Asset type
standard:	standardプロパティは、チェーンコード生成時に従うトークン標準を表します。ttf+値のみが、実行可能トークンに対してサポートされています。standardプロパティがファニブル・トークンに指定されていない場合、トークン・タクソノミ・フレームワーク(TTF)標準に従います。	standard: ttf+ # Token standard
anatomy:	anatomyセクションには、実行可能トークンの2つの必須パラメータがあります。 type: fungible 真菌性トークンの量は、同じクラスのトークンの別の量と同じ値を持ちます。 unit: fractional 小数トークンは、指定した小数点以下の桁数に基づいて小さい単位に分割できます。	anatomy: type: fungible # Token type unit: fractional # Token unit
behavior:	この項では、トークンの機能および制限について説明します。mintableおよびtransferableの動作は、実行可能トークンには必須です。 mintable: この必須動作では、新しいトークン・インスタンスの作成がサポートされます。オプションのmax_mint_quantityパラメータは、ミント可能なトークンの合計数を指定します。max_mint_quantityパラメータを指定しない場合、任意の数のトークンをミントできます。 transferable: この必須動作では、トークンの所有権の転送がサポートされます。 divisible: このオプション動作では、トークンを分割する方法について説明します。decimalパラメータは、使用できる小数点以下の桁数を指定します。小数点以下の桁数は、所有できるトークンの最小単位です。decimalパラメータが指定されていない場合、デフォルトは小数点以下0です。 burnable: このオプション動作では、トークンの非アクティブ化または書込みがサポートされます。Burningでは、トークンは削除されませんが、使用できない永続的な状態になります。燃焼は元に戻せない。 holdable: このオプション動作は、支払人と受取人の間でトークン残高を保留できるかどうかを示します。 roles: このオプション動作では、トークン動作が特定のロールを持つユーザーに制限されます。現在、minter_role_name、burner_role_nameおよびnotary_role_nameの3つのロールを使用できます。ロールを指定しない場合、すべてのユーザーがマイナー、バーナーまたは公証人として機能できます。たとえば、バーナ・ロールが指定されていない場合、アカウント・ユーザーは暗黙的にバーナ・ロールを持ちます。バーナ・ロールが指定されている場合、トークンの設定プロセス中に、Token Adminユーザーはバーナ・ロールを他のユーザーに明示的に割り当てる必要があります。	behavior: - mintable: max_mint_quantity: 20000 - transferable - divisible: decimal: 1 - burnable - holdable - roles: minter_role_name: minter burner_role_name: burner notary_role_name: notary

異なるmax_mint_quantityパラメータを使用する複数の実行可能なトークンIDを作成するには、仕様ファイルのトークンIDごとに個別のトークン・アセットを作成し、トークン・アセットとトークンIDとの間に1対1の関係を設定します。

同じmax_mint_quantityパラメータを使用する、またはmax_mint_quantityパラメータを使用しない複数の実行可能なトークンIDを作成するには、すべてのトークンIDに使用する単一のトークン・アセットを仕様ファイルに作成します。