ERC-721 的输入规范文件

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

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

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

非实物令牌资产的定制属性值可由令牌所有者更新。

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

ERC-721 令牌资产的以下示例规范文件在 Blockchain App Builder 软件包中可用：

• 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：此可选行为支持停用或刻录令牌。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