ERC-721 的輸入規格檔案

Blockchain App Builder 初始化命令會讀取輸入規格檔案，並產生具有數個工具的鷹架式專案，以協助鏈碼開發流程。

您可以在相同的規格檔案中，根據 ERC-721 標準來定義標準資產與變數替代字資產。下列限制適用於包含 ERC-721 權杖資產定義的規格檔案：

• 您無法根據相同規格檔案中的多個標準來定義變數替代字資產。
• 您無法在單一規格檔案中定義多個不可執行的變數替代字資產。

權杖擁有者可以更新不可變權杖資產的自訂屬性值。

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

「區塊鏈 App 產生器」套裝程式提供下列 ERC-721 權杖資產的規格檔案範例：

• NFTArtCollectionMarketPlace with ERC-721-Typescript.yml

除了標準特性和區段之外，不可變的記號資產還支援規格檔案中的 behavior、anatomy 和 metadata 區段。不可執行的記號資產也支援 standard 和 symbol 特性。下列範例顯示 ERC-721 權杖資產的規格檔案結構：

assets:
    - name: ArtCollection #Asset name
      type: token #Asset type
      symbol: ART # Token symbol
      standard: erc721+ # Token standard
      
      anatomy:
          type: nonfungible # Token type
          unit: whole #Token unit
      
      behavior:
        - indivisible
        - singleton
        - mintable:
            max_mint_quantity: 20000
        - transferable
        - burnable
        - lockable
        - roles:
            minter_role_name: minter
      
      properties: # Custom asset attributes for non-fungible tokens
          
          - name: price # Custom asset attribute to set the price of a non-fungible token in the marketplace
            type: number
          
          - name: on_sale_flag # Custom asset attribute maintains non-fungible token selling status in the marketplace
            type: boolean
      
      metadata: # Use this section to maintain the metadata on the blockchain. Only the user creating the non-fungible token can assign metadata attribute values, which cannot be updated later.
          
          - name: painting_name
            type: string
          
          - name: description
            type: string
          
          - name: image
            type: string
          
          - name: painter_name
            type: string

表格 4-2 ERC-721 權杖規格檔案的參數描述與範例

進入	描述	範例
type:	您必須在 assets 區段中指定 type: token。	assets: - name: ArtCollection #Asset name type: token #Asset type
symbol:	symbol 特性代表識別記號合約的符號，例如 ART。通常符號的長度為 3 到 4 個字元。	symbol: ART # Token symbol
standard:	standard 特性對於不可行的權杖是必要的。它代表產生鏈碼時要遵循的權杖標準。在 Blockchain App Builder 中，無法驗證的權杖遵循部分版本的 ERC-721 標準。如需詳細資訊，請參閱限制。	standard: erc721+ # Token standard
anatomy:	anatomy 區段具有兩個不可變記號的必要參數： type: nonfungible 不可執行的記號是唯一的。 unit: whole 無法將整個權杖細分為較小的分數單位。	anatomy: type: nonfungible # Token type unit: whole #Token unit
behavior:	本節說明權杖的功能與限制。mintable、transferable、singleton 及 indivisible 行為對不可行的記號而言是必要的。 singleton：此必要行為支援限制，因此類別中只能有一個無法分割的整個記號。 indivisible：此強制行為支援限制，因此無法將整個記號細分為分數。 mintable：此必要行為支援採礦新記號執行處理。選擇性的 max_mint_quantity 參數會指定可提示的記號總數。如果您未指定 max_mint_quantity 參數，則可以提示任意數目的記號。 transferable：此必要行為支援轉移權杖的所有權。 burnable：此選擇性行為支援停用或燒錄記號。燒錄並不會刪除記號，而是將它置於無法使用它的永久狀態。燃燒無法回復。 lockable：此行為是選擇性的，僅由不可變的記號支援。此行為可讓記號擁有者鎖定不可執行的記號。鎖定的記號無法傳輸給任何其他使用者或被燒錄。 roles：此選擇性行為會將記號行為限制為具有特定角色的使用者。目前有兩個可用的角色：minter_role_name 和 burner_role_name。如果您未指定角色，則任何使用者都可以做為礦工或燃燒器。例如，如果未指定燃燒器角色，則任何帳戶使用者隱含都具有燃燒器角色。如果已指定燃燒器角色，則在進行記號設定程序時，Token Admin 使用者必須明確地將燃燒器角色指派給其他使用者。	behavior: - indivisible - singleton - mintable: max_mint_quantity: 20000 - transferable - burnable - lockable - roles: minter_role_name: minter
metadata:	metadata 特性是選擇性的，僅由不可變的記號支援。此特性會針對不可變的權杖指定儲存在區塊鏈中的描述資料資訊。只能由會提示權杖的權杖擁有者指定描述資料屬性值，而且在權杖經過提示後便無法更新。 在範例中，name 是中繼資料屬性的名稱，而 type 是該屬性具有的值類型。	metadata: - name: painting_name type: string - name: description type: string - name: image type: string - name: painter_name type: string

限制

Blockchain App Builder 為 ERC-721 標準提供部分支援。目前不支援下列 ERC-721 事件與方法。

事件：

• event Transfer
• event Approval
• event ApprovalForAll

方法：

• approve
• getApproved
• setApprovalForAll
• isApprovedForAll