權杖分類架構的輸入規格檔案

區塊鏈 App 產生器初始化命令會讀取輸入規格檔案，並使用數個工具產生鷹架式專案，以協助鏈碼開發處理作業。

您可以在相同的規格檔案中，定義以「權杖分類架構」為基礎的標準資產和權杖資產。您無法根據相同規格檔案中的一個以上的標準來定義變數替代字資產。

如需在規格檔案中包含標準資產的資訊，請參閱輸入規格檔案。

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 可產生變數替代字規格檔案的參數描述與範例

進入 描述 範例
type:

您必須在 assets 區段中指定 type: token。 

assets:
    - name: OBPTOK # Asset name
      type: token  # Asset type
standard: standard 特性代表產生鏈碼時要遵循的記號標準。有趣的記號僅支援 ttf+ 值。如果未指定有趣的記號的 standard 特性，則會遵循「記號分類架構 (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。