标记分类框架的输入规范文件

Blockchain App Builder 初始化命令读取输入规范文件，并使用多个工具生成脚手架项目，以协助链代码开发过程。

您可以在同一规范文件中定义基于令牌分类框架的标准资产和令牌资产。无法根据同一规范文件中的多个标准定义标记资产。

有关在规范文件中包括标准资产的信息，请参阅输入规范文件。

Blockchain App Builder 程序包中提供了以下可替换令牌资产的示例规范文件：
  • FiatMoneyToken.yml
  • LoyaltyToken-Go.yml

除了标准属性和节之外，可替换标记资产还支持规范文件中的 behavior 和 anatomy 节。可替换的令牌资产也支持 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 Token Specification File 的参数说明和示例

进入 说明 示例
type:

必须在 assets 部分中指定 type: token。 

assets:
    - name: OBPTOK # Asset name
      type: token  # Asset type
standard: standard 属性表示在生成链代码期间要遵循的标记标准。可替换令牌仅支持 ttf+ 值。如果没有为可替换标记指定 standard 属性，则遵循标记分类框架 (Token Taxonomy Framework，TTF) 标准。 

      standard: ttf+ # Token standard
anatomy:
anatomy 部分具有两个可替换令牌的必需参数：
  • 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 参数，则缺省值为零个小数位。
  • burnable：此可选行为支持停用或刻录令牌。刻录不会删除令牌，而是将其置于无法使用的永久状态。燃烧是不可逆的。
  • holdable：此可选行为指示是否可以在付款人和收款人之间暂挂令牌余额。
  • roles：此可选行为将令牌行为限制为具有特定角色的用户。目前有三个角色可用：minter_role_name、burner_role_name 和 notary_role_name。如果不指定角色，则任何用户都可以充当矿工、燃烧器或公证人。例如，如果未指定刻录机角色，则任何帐户用户都隐式具有刻录机角色。如果指定了刻录器角色，则在标记设置过程中，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。