ERC-721 的输入规范文件

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

您可以在同一规范文件中定义基于 ERC-721 标准的标准资产和令牌资产。以下限制适用于包括 ERC-721 标记资产定义的规范文件：

• 不能根据同一规范文件中的多个标准定义标记资产。
• 不能在单个规范文件中定义多个不可替换的标记资产。

令牌所有者可以更新不可替换令牌资产的定制属性值。

有关在规范文件中包括标准资产的信息，请参见 Input Specification File 。

区块链应用程序构建器包中提供了以下 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

表 7-6 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 标准的部分版本。有关更多信息，请参见 Limitations 。	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：此可选行为支持停用或刻录令牌。Burning 不会删除令牌，而是将其置于无法使用的永久状态。燃烧是不可逆转的。 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